# cyt-indexer-sdk

TypeScript/Node bindings for the [cyt-indexer](https://crates.io/crates/cyt-indexer) Rust library.

## Development

```bash
cd sdk/typescript
npm install
npm run build
npm test
```

Requires a Rust toolchain (same as the Python SDK maturin flow).

Local `npm run build:native` produces a binding for the current platform only.
Release builds that ship all platforms run in GitHub Actions (`.github/workflows/publish-npm-sdk.yml`).

## Publishing

The npm package `cyt-indexer-sdk` is a **single fat package**: all platform `.node` files are included in one tarball (~30MB).
Only one [trusted publisher](https://docs.npmjs.com/trusted-publishers/) entry is required on npm.

Do not run `napi create-npm-dirs`, `napi artifacts`, or `napi prepublish` for releases;
CI stages every `cyt-indexer-sdk.*.node` into the package root and runs `npm publish` once.

## Usage

```typescript
import {
  anthropicToolsToCatalogEntries,
  buildCatalogFromTools,
  buildCatalogIndex,
  loadCatalog,
  removedChunks,
  retrieveTools,
} from "cyt-indexer-sdk";

const full = loadCatalog(".catalog");
const surviving = /* survivors.json */;
const removed = removedChunks(full, surviving);
```

### Pipeline composites

```typescript
import {
  batchToolPassThrough,
  buildSkillNodeCatalog,
  classifyAndCountCatalog,
  PolicyContext,
  pruneCatalogBm25AndRetrieve,
  searchSkillsAndSelect,
} from "cyt-indexer-sdk";

const ctx = new PolicyContext("always_include", "always_include");
const flags = batchToolPassThrough(["Agent", "grep"], ctx);

const counts = classifyAndCountCatalog(catalogData);
const nodes = buildSkillNodeCatalog([]);
```

Composite APIs mirror the Python `cyt_indexer.pipeline` module and Go `cytindexer` pipeline helpers.

### Policy context (`PolicyContext`)

Native `PolicyContext` exposes `systemPolicy`, `mcpPolicy`, `perTool`,
and optional `toolKind` (`"system"` | `"mcp"`). The `toolKind` field is a runtime batch override
(not loaded from YAML config); set it to `"mcp"` so bare executor-style tool ids use MCP policies
without an `mcp__` prefix.

```typescript
import {
  PolicyContext,
  applyToolKind,
  effectivePolicy,
  scoringPolicyContext,
} from "cyt-indexer-sdk";

const ctx = new PolicyContext("prune_optional", "prune_all");
applyToolKind(ctx, "mcp");
effectivePolicy("tools.demo.org.search", ctx); // => "prune_all"

const scoring = scoringPolicyContext(ctx); // copies toolKind, maps description variants
```

### Skills cache (`ensureSkillsRegistry`)

Accepts filesystem paths or inline hook/client skill objects (`path`, optional `content`, optional `content_sha256`):

```typescript
import { ensureSkillsRegistry } from "cyt-indexer-sdk";

ensureSkillsRegistry(
  [{ path: "/virtual/skill.md", content: "---\nname: x\n---\nBody" }],
  catalogRoot,
  pageindexConfig,
  "bm25",
  indexParamsHash,
);
```