harness-mcp-v2 3.2.4 → 3.2.6

package/build/search/manager.d.ts

@@ -0,0 +1,39 @@
+import type { Config } from "../config.js";
+import type { Registry } from "../registry/index.js";
+import type { HarnessClient } from "../client/harness-client.js";
+import type { SearchCorpus, SearchProvider, SearchReadiness, IndexableItem } from "./types.js";
+import "../data/examples/load-all.js";
+export declare class SearchManager {
+    private provider;
+    private readonly mcpMode;
+    private readonly configuredProvider;
+    private readiness;
+    private loggedResourcesCorpusDisabled;
+    constructor(config: Config);
+    /**
+     * Whether live customer data may be indexed into the given corpus.
+     * In multi-user mode the local in-process store must not hold per-account entity data
+     * (no isolation between accounts). The remote provider handles this correctly via tenant_id.
+     */
+    canIndexCorpus(corpus: SearchCorpus): boolean;
+    /**
+     * Index a single item, enforcing corpus/mode policy before delegating to the provider.
+     */
+    indexItem(item: IndexableItem): Promise<void>;
+    getProvider(): SearchProvider;
+    getReadiness(): SearchReadiness;
+    initialize(): Promise<void>;
+    /**
+     * Index all static, account-agnostic content into mcp_resources corpus.
+     * Safe to call in any mode — no account context needed.
+     * Items are permanent (ttlMs=0) since they're bundled with the server.
+     */
+    indexStaticContent(registry: Registry): Promise<void>;
+    /**
+     * Pre-index tier-1 Harness resources for a specific account.
+     * Only call in stdio (single-user) mode where client.account is known.
+     */
+    initializeIndex(registry: Registry, client: HarnessClient): Promise<void>;
+    private loadProvider;
+}
+//# sourceMappingURL=manager.d.ts.map

package/build/search/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/search/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAsB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKnH,OAAO,8BAA8B,CAAC;AAUtC,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,6BAA6B,CAAS;gBAElC,MAAM,EAAE,MAAM;IAS1B;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAO7C;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,WAAW,IAAI,cAAc;IAI7B,YAAY,IAAI,eAAe;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCjC;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA8G3D;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/E,OAAO,CAAC,YAAY;CAoBrB"}

package/build/search/manager.js

@@ -0,0 +1,287 @@
+import { NullSearchProvider } from "./null-provider.js";
+import { LocalSearchProvider } from "./local-provider.js";
+import { RemoteSearchProvider } from "./remote-provider.js";
+import { createLogger } from "../utils/logger.js";
+import "../data/examples/load-all.js";
+import { getAllExamples } from "../data/examples/index.js";
+import { SCHEMAS } from "../data/schemas/index.js";
+import { ENTITY_BUNDLED_SCHEMAS } from "../data/schemas/entities/index.js";
+import { buildResourceIndexContent } from "./embedding-content.js";
+const log = createLogger("search-manager");
+const TIER1_TYPES = ["pipeline", "service", "environment", "connector"];
+export class SearchManager {
+    provider;
+    mcpMode;
+    configuredProvider;
+    readiness;
+    loggedResourcesCorpusDisabled = false;
+    constructor(config) {
+        this.mcpMode = config.HARNESS_MCP_MODE;
+        this.configuredProvider = resolveConfiguredProvider(config);
+        this.provider = this.loadProvider(config);
+        this.readiness = this.configuredProvider === "none"
+            ? { state: "disabled", configured: "none" }
+            : { state: "initializing", configured: this.configuredProvider };
+    }
+    /**
+     * Whether live customer data may be indexed into the given corpus.
+     * In multi-user mode the local in-process store must not hold per-account entity data
+     * (no isolation between accounts). The remote provider handles this correctly via tenant_id.
+     */
+    canIndexCorpus(corpus) {
+        if (corpus === "entities" && this.mcpMode === "multi-user" && this.configuredProvider === "local") {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Index a single item, enforcing corpus/mode policy before delegating to the provider.
+     */
+    async indexItem(item) {
+        if (!this.provider.isAvailable())
+            return;
+        if (!this.canIndexCorpus(item.corpus)) {
+            if (!this.loggedResourcesCorpusDisabled) {
+                this.loggedResourcesCorpusDisabled = true;
+                log.warn("resources corpus disabled in multi-user mode — requires HarnessSearchProvider");
+            }
+            return;
+        }
+        await this.provider.index(item);
+    }
+    getProvider() {
+        return this.provider;
+    }
+    getReadiness() {
+        return this.readiness;
+    }
+    async initialize() {
+        if (this.configuredProvider === "none") {
+            this.readiness = { state: "disabled", configured: "none" };
+            return;
+        }
+        this.readiness = { state: "initializing", configured: this.configuredProvider };
+        try {
+            await this.provider.initialize();
+            if (this.provider.isAvailable()) {
+                this.readiness = {
+                    state: "ready",
+                    configured: this.configuredProvider,
+                    provider: this.provider.constructor.name,
+                };
+                log.info(`Search provider initialized: ${this.provider.constructor.name}, available=true`);
+                return;
+            }
+            const error = getProviderInitError(this.provider) ?? "provider unavailable after initialization";
+            this.readiness = { state: "failed", configured: this.configuredProvider, error };
+            log.error("Semantic search unavailable — configured provider failed to initialize", {
+                configured: this.configuredProvider,
+                provider: this.provider.constructor.name,
+                error,
+            });
+        }
+        catch (err) {
+            const error = String(err);
+            log.error("Search provider initialization failed — falling back to null provider", { error });
+            this.provider = new NullSearchProvider();
+            this.readiness = { state: "failed", configured: this.configuredProvider, error };
+        }
+    }
+    /**
+     * Index all static, account-agnostic content into mcp_resources corpus.
+     * Safe to call in any mode — no account context needed.
+     * Items are permanent (ttlMs=0) since they're bundled with the server.
+     */
+    async indexStaticContent(registry) {
+        if (!this.provider.isAvailable())
+            return;
+        // 1. Resource type definitions from registry
+        const resourceTypes = registry.getAllResourceTypes();
+        await Promise.all(resourceTypes.map(rt => {
+            try {
+                const def = registry.getResource(rt);
+                const ops = Object.keys(def.operations ?? {}).join(", ");
+                return this.provider.index({
+                    id: `resource-def:${rt}`,
+                    content: [rt.replace(/_/g, " "), def.displayName, def.description, ops].filter(Boolean).join(" "),
+                    corpus: "knowledge",
+                    ttlMs: 0,
+                    metadata: {
+                        type: "resource_definition",
+                        resource_type: rt,
+                        display_name: def.displayName ?? rt,
+                        operations: ops,
+                        scope: def.scope ?? "",
+                    },
+                });
+            }
+            catch {
+                return Promise.resolve();
+            }
+        }));
+        log.info(`Indexed ${resourceTypes.length} resource definitions`);
+        // 2. Examples (YAML templates)
+        const examples = getAllExamples();
+        await Promise.all(examples.map(ex => this.provider.index({
+            id: `example:${ex.name}`,
+            content: [ex.resourceType.replace(/_/g, " "), ex.name.replace(/-/g, " "), ex.description, ex.tags.join(" ")].join(" "),
+            corpus: "knowledge",
+            ttlMs: 0,
+            metadata: {
+                type: "example",
+                resource_type: ex.resourceType,
+                name: ex.name,
+                description: ex.description,
+                tags: ex.tags.join(","),
+            },
+        })));
+        log.info(`Indexed ${examples.length} examples`);
+        // 3. Bundled pipeline/template/trigger schemas
+        // Display-only mapping: comma-separated resource types for schemas that span multiple types.
+        // NOT used for routing (comma values won't match any single type in extractRoutingTypes).
+        const SCHEMA_RESOURCE_TYPES = {
+            "pipeline": "pipeline",
+            "pipeline_v1": "pipeline_v1",
+            "template": "template,pipeline,template_v1",
+            "template_v1": "template_v1,template",
+            "trigger": "trigger,pipeline",
+            "inputSet_v1": "input_set",
+            "overlayInputSet_v1": "input_set",
+            "agent-pipeline": "pipeline,pipeline_v1",
+        };
+        const schemaEntries = Object.entries(SCHEMAS);
+        await Promise.all(schemaEntries.map(([name, schema]) => {
+            const resourceType = SCHEMA_RESOURCE_TYPES[name] ?? name;
+            return this.provider.index({
+                id: `schema:${name}`,
+                content: [
+                    name.replace(/_/g, " ").replace(/-/g, " "),
+                    "schema",
+                    "yaml structure",
+                    schema?.title ?? "",
+                    schema?.description ?? "",
+                ].filter(Boolean).join(" "),
+                corpus: "knowledge",
+                ttlMs: 0,
+                metadata: {
+                    type: "schema",
+                    resource_type: resourceType,
+                    schema_name: name,
+                    uri: `schema:///${name}`,
+                    action: `call harness_schema with resource_type="${name.replace("_v1", "").replace("-", "_")}"`,
+                },
+            });
+        }));
+        // 4. Entity schemas (connector, environment, service, secret, infrastructure)
+        const entityEntries = Object.entries(ENTITY_BUNDLED_SCHEMAS);
+        await Promise.all(entityEntries.map(([name, schema]) => this.provider.index({
+            id: `entity-schema:${name}`,
+            content: [
+                name.replace(/[._]/g, " "),
+                "schema",
+                "yaml structure",
+                schema?.title ?? "",
+                schema?.description ?? "",
+            ].filter(Boolean).join(" "),
+            corpus: "knowledge",
+            ttlMs: 0,
+            metadata: {
+                type: "entity_schema",
+                schema_name: name,
+                resource_type: name.split(".")[0] ?? name,
+                scope: name.split(".")[1] ?? "",
+                action: `call harness_schema with resource_type="${name.split(".")[0] ?? name}"`,
+            },
+        })));
+        log.info(`Indexed ${schemaEntries.length} bundled schemas, ${entityEntries.length} entity schemas`);
+    }
+    /**
+     * Pre-index tier-1 Harness resources for a specific account.
+     * Only call in stdio (single-user) mode where client.account is known.
+     */
+    async initializeIndex(registry, client) {
+        if (!this.provider.isAvailable())
+            return;
+        if (!this.canIndexCorpus("entities")) {
+            if (!this.loggedResourcesCorpusDisabled) {
+                this.loggedResourcesCorpusDisabled = true;
+                log.warn("resources corpus disabled in multi-user mode — requires HarnessSearchProvider");
+            }
+            return;
+        }
+        const accountId = client.account;
+        const types = TIER1_TYPES.filter(t => registry.supportsOperation(t, "list"));
+        for (const resourceType of types) {
+            try {
+                const result = await registry.dispatch(client, resourceType, "list", {
+                    size: 50, limit: 50, page: 0,
+                }, { tool: "search-init" });
+                const items = result?.items ?? [];
+                await Promise.all(items.filter(item => item["identifier"] ?? item["id"]).map(item => this.indexItem({
+                    id: `${resourceType}:${String(item["identifier"] ?? item["id"] ?? "")}`,
+                    content: buildResourceIndexContent(resourceType, item),
+                    corpus: "entities",
+                    accountId,
+                    metadata: {
+                        resource_type: resourceType,
+                        identifier: String(item["identifier"] ?? item["id"] ?? ""),
+                        name: String(item["name"] ?? ""),
+                    },
+                })));
+                log.info(`Pre-indexed ${items.length} ${resourceType} items`);
+            }
+            catch (err) {
+                log.warn(`Failed to pre-index ${resourceType}`, { error: String(err) });
+            }
+        }
+    }
+    loadProvider(config) {
+        if (this.configuredProvider === "local") {
+            return new LocalSearchProvider({
+                cacheDir: config.HARNESS_HF_CACHE_DIR,
+                model: process.env.HARNESS_SEARCH_MODEL,
+            });
+        }
+        if (this.configuredProvider === "remote") {
+            if (!config.HARNESS_SEARCH_SERVICE_URL) {
+                log.error("HARNESS_SEARCH_PROVIDER=remote requires HARNESS_SEARCH_SERVICE_URL to be set");
+                return new NullSearchProvider();
+            }
+            return new RemoteSearchProvider({
+                baseUrl: config.HARNESS_SEARCH_SERVICE_URL,
+                headers: parseSearchServiceHeaders(config.HARNESS_SEARCH_SERVICE_HEADERS),
+                timeoutMs: config.HARNESS_API_TIMEOUT_MS,
+            });
+        }
+        return new NullSearchProvider();
+    }
+}
+function resolveConfiguredProvider(config) {
+    return config.HARNESS_SEARCH_PROVIDER ?? "none";
+}
+function parseSearchServiceHeaders(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const dropped = Object.entries(parsed).filter(([, v]) => typeof v !== "string").map(([k]) => k);
+            if (dropped.length > 0) {
+                log.warn("HARNESS_SEARCH_SERVICE_HEADERS: non-string values ignored", { keys: dropped });
+            }
+            return Object.fromEntries(Object.entries(parsed).filter(([, v]) => typeof v === "string"));
+        }
+        log.warn("HARNESS_SEARCH_SERVICE_HEADERS is not a JSON object — ignoring");
+    }
+    catch {
+        log.warn("HARNESS_SEARCH_SERVICE_HEADERS is not valid JSON — ignoring");
+    }
+    return undefined;
+}
+function getProviderInitError(provider) {
+    if ("getInitError" in provider && typeof provider.getInitError === "function") {
+        return provider.getInitError();
+    }
+    return undefined;
+}
+//# sourceMappingURL=manager.js.map

package/build/search/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/search/manager.ts"],"names":[],"mappings":"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"}

package/build/search/null-provider.d.ts

@@ -0,0 +1,9 @@
+import type { SearchProvider, SearchResult, SearchOptions, IndexableItem } from "./types.js";
+export declare class NullSearchProvider implements SearchProvider {
+    initialize(): Promise<void>;
+    isAvailable(): boolean;
+    search(_query: string, _options?: SearchOptions): Promise<SearchResult[]>;
+    index(_item: IndexableItem): Promise<void>;
+    evictExpired(): void;
+}
+//# sourceMappingURL=null-provider.d.ts.map

package/build/search/null-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-provider.d.ts","sourceRoot":"","sources":["../../src/search/null-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7F,qBAAa,kBAAmB,YAAW,cAAc;IACjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,WAAW,IAAI,OAAO;IAChB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACzE,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD,YAAY,IAAI,IAAI;CACrB"}

package/build/search/null-provider.js

@@ -0,0 +1,8 @@
+export class NullSearchProvider {
+    async initialize() { }
+    isAvailable() { return false; }
+    async search(_query, _options) { return []; }
+    async index(_item) { }
+    evictExpired() { }
+}
+//# sourceMappingURL=null-provider.js.map

package/build/search/null-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-provider.js","sourceRoot":"","sources":["../../src/search/null-provider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,UAAU,KAAmB,CAAC;IACpC,WAAW,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,QAAwB,IAA6B,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9F,KAAK,CAAC,KAAK,CAAC,KAAoB,IAAkB,CAAC;IACnD,YAAY,KAAU,CAAC;CACxB"}

package/build/search/remote-provider.d.ts

@@ -0,0 +1,28 @@
+import type { SearchProvider, SearchResult, SearchOptions, IndexableItem } from "./types.js";
+export interface RemoteSearchProviderOptions {
+    baseUrl: string;
+    /**
+     * Extra headers sent with every request. Supports any auth scheme:
+     *   { "Authorization": "Bearer <token>" }           — standard bearer
+     *   { "x-api-key": "key" }                          — API key header
+     *   { "x-harness-token": "svc", "x-tenant": "..." } — internal service mesh
+     */
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}
+export declare class RemoteSearchProvider implements SearchProvider {
+    private available;
+    private initError;
+    private readonly baseUrl;
+    private readonly extraHeaders;
+    private readonly timeoutMs;
+    constructor(options: RemoteSearchProviderOptions);
+    initialize(): Promise<void>;
+    getInitError(): string | undefined;
+    isAvailable(): boolean;
+    evictExpired(): void;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    index(item: IndexableItem): Promise<void>;
+    private doFetch;
+}
+//# sourceMappingURL=remote-provider.d.ts.map

package/build/search/remote-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-provider.d.ts","sourceRoot":"","sources":["../../src/search/remote-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAoB3G,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,2BAA2B;IAM1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,IAAI;IAId,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwD3E,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/C,OAAO,CAAC,OAAO;CAWhB"}

package/build/search/remote-provider.js

@@ -0,0 +1,148 @@
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("remote-search-provider");
+const CORPORA = ["entities", "docs", "knowledge"];
+/**
+ * Each corpus maps to its own collection in the search service.
+ * Static corpora (docs, knowledge) are shared across all tenants — no tenant_id filter needed.
+ * Entity corpus is per-account — tenant_id scopes results to the requesting account.
+ */
+const STATIC_CORPORA = new Set(["docs", "knowledge"]);
+/** Collection name in the search service for each corpus. */
+const CORPUS_COLLECTION = {
+    knowledge: "mcp_knowledge",
+    docs: "mcp_docs",
+    entities: "mcp_entities",
+};
+export class RemoteSearchProvider {
+    available = false;
+    initError;
+    baseUrl;
+    extraHeaders;
+    timeoutMs;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, "");
+        this.extraHeaders = options.headers ?? {};
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    async initialize() {
+        try {
+            const res = await this.doFetch("/v1/health");
+            if (res.ok) {
+                this.available = true;
+                log.info("RemoteSearchProvider initialized", { baseUrl: this.baseUrl });
+            }
+            else {
+                this.initError = `Health check returned HTTP ${res.status}`;
+                log.error("RemoteSearchProvider health check failed", { status: res.status });
+            }
+        }
+        catch (err) {
+            this.initError = String(err);
+            log.error("RemoteSearchProvider initialization failed", { error: this.initError });
+        }
+    }
+    getInitError() {
+        return this.initError;
+    }
+    isAvailable() {
+        return this.available;
+    }
+    evictExpired() {
+        // The search service owns TTL — nothing to do locally
+    }
+    async search(query, options = {}) {
+        if (!this.available)
+            return [];
+        try {
+            const { corpus = "all", accountId, k = 10 } = options;
+            const corpora = corpus === "all" ? CORPORA : [corpus];
+            // One request per corpus — each targets its own collection.
+            // Use hybrid search (vector + BM25); the service gracefully degrades to
+            // vector-only when the collection is not hybrid-capable.
+            // Static corpora omit tenant_id (whole collection is shared).
+            // Entities corpus passes accountId as tenant_id for per-account scoping.
+            const { filters } = options;
+            const allResults = await Promise.all(corpora.map(async (c) => {
+                const params = new URLSearchParams({
+                    q: query,
+                    k: String(k),
+                    collection_name: CORPUS_COLLECTION[c],
+                });
+                if (!STATIC_CORPORA.has(c) && accountId) {
+                    params.set("tenant_id", accountId);
+                }
+                if (filters) {
+                    for (const [key, value] of Object.entries(filters)) {
+                        params.set(key, value);
+                    }
+                }
+                const res = await this.doFetch(`/v1/hybrid?${params}`);
+                if (!res.ok) {
+                    log.warn("Remote search request failed", { status: res.status, corpus: c });
+                    await res.text().catch(() => undefined);
+                    return [];
+                }
+                const body = await res.json();
+                const results = body?.results ?? [];
+                return results.map(r => ({
+                    id: r.id,
+                    content: r.content,
+                    score: r.score,
+                    corpus: c,
+                    metadata: r.metadata,
+                }));
+            }));
+            return allResults
+                .flat()
+                .sort((a, b) => b.score - a.score)
+                .slice(0, k);
+        }
+        catch (err) {
+            log.error("RemoteSearchProvider search failed", { error: String(err) });
+            return [];
+        }
+    }
+    async index(item) {
+        if (!this.available)
+            return;
+        try {
+            const body = {
+                content: item.content,
+                metadata: {
+                    ...item.metadata,
+                    ...(item.ttlMs !== undefined ? { ttl_ms: String(item.ttlMs) } : {}),
+                },
+                collection_name: CORPUS_COLLECTION[item.corpus],
+                document_id: item.id,
+                // Entities are per-account; static corpora have no tenant scoping.
+                ...(!STATIC_CORPORA.has(item.corpus) && item.accountId
+                    ? { tenant_id: item.accountId }
+                    : {}),
+            };
+            const res = await this.doFetch("/v1/ingest", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                log.warn("Remote index request failed", { id: item.id, status: res.status });
+                await res.text().catch(() => undefined);
+            }
+        }
+        catch (err) {
+            log.error("RemoteSearchProvider index failed", { id: item.id, error: String(err) });
+        }
+    }
+    doFetch(pathOrUrl, init) {
+        const url = pathOrUrl.startsWith("http") ? pathOrUrl : `${this.baseUrl}${pathOrUrl}`;
+        const headers = {
+            ...this.extraHeaders,
+            ...(init?.headers ?? {}),
+        };
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        return fetch(url, { ...init, headers, signal: controller.signal })
+            .finally(() => clearTimeout(timer));
+    }
+}
+//# sourceMappingURL=remote-provider.js.map

package/build/search/remote-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-provider.js","sourceRoot":"","sources":["../../src/search/remote-provider.ts"],"names":[],"mappings":"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"}

package/build/search/routing-eval.d.ts

@@ -0,0 +1,49 @@
+export type SearchRoutingMode = "specific" | "cross_domain" | "ambiguous";
+export interface SearchRoutingGoldenCase {
+    id: string;
+    query: string;
+    mode: SearchRoutingMode;
+    expectedTypes: string[];
+    acceptableTypes?: string[];
+    description?: string;
+}
+export interface SearchRoutingObservation {
+    id: string;
+    query: string;
+    mode: SearchRoutingMode;
+    expectedTypes: string[];
+    acceptableTypes: string[];
+    routedTypes: string[];
+    semanticRouted: boolean;
+    searchedTypes: number;
+    candidateTypes: number;
+    topScore: number;
+    latencyMs: number;
+}
+export interface SearchRoutingCaseResult extends SearchRoutingObservation {
+    matchedExpectedTypes: string[];
+    missingExpectedTypes: string[];
+    extraRoutedTypes: string[];
+    expectedRecall: number;
+    passed: boolean;
+}
+export interface SearchRoutingSummary {
+    totalCases: number;
+    passedCases: number;
+    failedCases: number;
+    expectedTypeRecall: number;
+    falseNegativeCount: number;
+    averageRoutedTypes: number;
+    averageSearchedTypes: number;
+    averageLatencyMs: number;
+    averageTopScore: number;
+}
+export interface SearchRoutingEvaluation {
+    cases: SearchRoutingCaseResult[];
+    summary: SearchRoutingSummary;
+}
+export declare function validateGoldenCases(cases: readonly SearchRoutingGoldenCase[], knownResourceTypes: readonly string[]): string[];
+export declare function evaluateRoutingCase(observation: SearchRoutingObservation): SearchRoutingCaseResult;
+export declare function summarizeRoutingEvaluation(cases: readonly SearchRoutingCaseResult[]): SearchRoutingSummary;
+export declare function evaluateRouting(observations: readonly SearchRoutingObservation[]): SearchRoutingEvaluation;
+//# sourceMappingURL=routing-eval.d.ts.map

package/build/search/routing-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-eval.d.ts","sourceRoot":"","sources":["../../src/search/routing-eval.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAMD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,uBAAuB,EAAE,EACzC,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,MAAM,EAAE,CAsBV;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,wBAAwB,GAAG,uBAAuB,CA4BlG;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,oBAAoB,CAkBtB;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,SAAS,wBAAwB,EAAE,GAChD,uBAAuB,CAMzB"}