@anionex/dsh-tool-search 0.1.0

package/lib/runtime.js

@@ -0,0 +1,286 @@
+/** Agent-local selected sets and model-visible tool filtering. */
+import { defineTool, } from '@deepseek-ai/dsh-tools';
+import { Bm25Index } from "./bm25.js";
+import { buildCatalog } from "./catalog.js";
+import { ToolPolicyResolver, normalizeSettings } from "./settings.js";
+import { MAX_RESULT_LIMIT, TOOL_SEARCH_NAME, } from "./shared.js";
+const RESULT_SCHEMA_VERSION = 1;
+const MAX_QUERY_LENGTH = 4096;
+const MAX_DESCRIPTION_LENGTH = 240;
+function compareNames(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function summarize(description) {
+    const normalized = description.replace(/\s+/gu, ' ').trim();
+    if (normalized.length <= MAX_DESCRIPTION_LENGTH)
+        return normalized;
+    return `${normalized.slice(0, MAX_DESCRIPTION_LENGTH - 3)}...`;
+}
+function parseSelectionResult(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return [];
+    const record = value;
+    if (record['schemaVersion'] !== RESULT_SCHEMA_VERSION || !Array.isArray(record['tools']))
+        return [];
+    const names = [];
+    for (const candidate of record['tools']) {
+        if (typeof candidate !== 'object' || candidate === null || Array.isArray(candidate))
+            continue;
+        const name = candidate['name'];
+        if (typeof name === 'string' && name.length > 0)
+            names.push(name);
+    }
+    return names;
+}
+function sessionEvents(agent) {
+    const session = agent.session;
+    if (typeof session.snapshotEvents === 'function')
+        return session.snapshotEvents();
+    return Array.isArray(session.events) ? session.events : [];
+}
+function selectedFromSession(agent) {
+    const searchCalls = new Set();
+    const selected = new Set();
+    for (const rawEvent of sessionEvents(agent)) {
+        if (typeof rawEvent !== 'object' || rawEvent === null || Array.isArray(rawEvent))
+            continue;
+        const event = rawEvent;
+        if (event.type === 'tool/call' && event.data?.['name'] === TOOL_SEARCH_NAME) {
+            searchCalls.add(String(event.data['callId']));
+            continue;
+        }
+        if (event.type !== 'tool/result' || typeof event.data?.['message'] !== 'object' || event.data['message'] === null)
+            continue;
+        const content = event.data['message'].content;
+        const result = Array.isArray(content) ? content[0] : undefined;
+        if (typeof result !== 'object' || result === null || Array.isArray(result))
+            continue;
+        const resultRecord = result;
+        if (!searchCalls.has(String(resultRecord['toolCallId'])) || resultRecord['isError'] === true)
+            continue;
+        const blocks = resultRecord['content'];
+        if (!Array.isArray(blocks))
+            continue;
+        const text = blocks
+            .filter((block) => (typeof block === 'object'
+            && block !== null
+            && !Array.isArray(block)
+            && block['type'] === 'text'
+            && typeof block['text'] === 'string'))
+            .map(block => block.text)
+            .join('');
+        try {
+            for (const name of parseSelectionResult(JSON.parse(text)))
+                selected.add(name);
+        }
+        catch {
+            // Failed and legacy tool results are not successful selection transitions.
+        }
+    }
+    return selected;
+}
+function toolSectionName(sectionName) {
+    if (!sectionName.startsWith('tool:'))
+        return undefined;
+    const name = sectionName.slice('tool:'.length);
+    return name.length > 0 ? name : undefined;
+}
+export class ToolSearchRuntime {
+    ctx;
+    definition;
+    states = new Map();
+    policy;
+    settings;
+    generation = 0;
+    constructor(ctx, settings) {
+        this.ctx = ctx;
+        this.settings = normalizeSettings(settings);
+        this.policy = new ToolPolicyResolver(this.settings);
+        this.definition = this.createDefinition();
+    }
+    install() {
+        const disposers = [
+            this.ctx.on('agent/created', ({ agent }) => { this.attach(agent); }),
+            this.ctx.on('agent/disposed', ({ agent }) => { this.detach(agent); }),
+            this.ctx.on('tools/result', (exec, result) => { this.commitSelection(exec, result); }),
+            this.ctx.on('tools/change', () => { this.generation += 1; }),
+            this.ctx.on('system-prompt/change', () => { this.generation += 1; }),
+        ];
+        for (const agent of this.ctx.agents.list())
+            this.attach(agent);
+        return () => {
+            for (const state of this.states.values())
+                state.disposeAssembly();
+            this.states.clear();
+            for (const dispose of disposers.reverse())
+                dispose();
+        };
+    }
+    updateSettings(value) {
+        this.settings = normalizeSettings(value);
+        this.policy.update(this.settings);
+    }
+    snapshot() {
+        const tools = new Map();
+        for (const entry of buildCatalog(this.ctx.tools.schemas()))
+            tools.set(entry.name, entry);
+        for (const state of this.states.values()) {
+            this.refreshCatalog(state);
+            for (const entry of state.catalog)
+                tools.set(entry.name, entry);
+        }
+        return {
+            schemaVersion: 1,
+            generation: this.generation,
+            tools: [...tools.values()].sort((left, right) => compareNames(left.name, right.name)).map(tool => ({
+                name: tool.name,
+                description: summarize(tool.description),
+                policy: this.policy.classify(tool.name),
+                selectedBy: [...this.states.values()]
+                    .filter(state => state.selected.has(tool.name))
+                    .map(state => String(state.agent.id))
+                    .sort(compareNames),
+            })),
+        };
+    }
+    selectedFor(agent) {
+        return this.requireState(agent).selected;
+    }
+    createDefinition() {
+        return defineTool({
+            name: TOOL_SEARCH_NAME,
+            description: 'Search deferred tool metadata with deterministic local BM25. Matching tools become available by their real names on the next model call. Results contain summaries, not full schemas.',
+            parameters: {
+                query: {
+                    type: 'string',
+                    required: true,
+                    description: 'Search query for deferred tools.',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of tools to return. Defaults to 5.',
+                },
+            },
+            output: {
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        schemaVersion: { type: 'integer', const: RESULT_SCHEMA_VERSION, required: true },
+                        query: { type: 'string', required: true },
+                        tools: {
+                            type: 'array',
+                            required: true,
+                            items: {
+                                type: 'object',
+                                additionalProperties: false,
+                                properties: {
+                                    name: { type: 'string', required: true },
+                                    description: { type: 'string', required: true },
+                                    score: { type: 'number', required: true },
+                                },
+                            },
+                        },
+                    },
+                },
+                render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+            },
+            execute: (args, exec) => Promise.resolve(this.search(args, exec)),
+            finalizeContent: (_exec, result) => result.isError
+                ? undefined
+                : [{ type: 'text', text: JSON.stringify(result.value) }],
+            presentCall: args => ({
+                card: 'generic',
+                title: 'Search deferred tools',
+                kind: 'read',
+                rawInput: typeof args === 'object' && args !== null && 'query' in args
+                    ? String(args.query)
+                    : undefined,
+            }),
+        });
+    }
+    search(args, exec) {
+        const agent = exec.agent;
+        if (agent === undefined)
+            throw new Error(`${TOOL_SEARCH_NAME}: an Agent Session is required`);
+        const query = args.query.trim();
+        if (query.length === 0)
+            throw new Error(`${TOOL_SEARCH_NAME}: query must not be empty`);
+        if (query.length > MAX_QUERY_LENGTH)
+            throw new Error(`${TOOL_SEARCH_NAME}: query exceeds ${MAX_QUERY_LENGTH} characters`);
+        if (args.limit !== undefined && (!Number.isSafeInteger(args.limit) || args.limit < 1 || args.limit > MAX_RESULT_LIMIT)) {
+            throw new Error(`${TOOL_SEARCH_NAME}: limit must be an integer between 1 and ${MAX_RESULT_LIMIT}`);
+        }
+        const state = this.requireState(agent);
+        this.refreshCatalog(state);
+        const deferred = state.catalog.filter(tool => this.policy.classify(tool.name, state.selected) === 'deferred');
+        const index = new Bm25Index(deferred.map(tool => ({ id: tool, name: tool.name, text: tool.searchText })));
+        const limit = args.limit ?? this.settings.defaultLimit;
+        const tools = index.search(query, limit).map(match => ({
+            name: match.id.name,
+            description: summarize(match.id.description),
+            score: Number(match.score.toFixed(6)),
+        }));
+        return { schemaVersion: RESULT_SCHEMA_VERSION, query, tools };
+    }
+    commitSelection(exec, result) {
+        if (exec.name !== TOOL_SEARCH_NAME || exec.agent === undefined || result.isError)
+            return;
+        const state = this.requireState(exec.agent);
+        for (const name of parseSelectionResult(result.value))
+            state.selected.add(name);
+    }
+    attach(agent) {
+        if (this.states.has(agent))
+            return;
+        const selected = selectedFromSession(agent);
+        const state = {
+            agent,
+            selected,
+            catalog: [],
+            catalogGeneration: -1,
+            disposeAssembly: () => { },
+        };
+        state.disposeAssembly = agent.ctx.on('system-prompt/assemble', async (_assembly, _context, next) => this.filterAssembly(state, await next()), { prepend: true });
+        this.states.set(agent, state);
+    }
+    detach(agent) {
+        const state = this.states.get(agent);
+        if (state === undefined)
+            return;
+        this.states.delete(agent);
+    }
+    requireState(agent) {
+        this.attach(agent);
+        const state = this.states.get(agent);
+        if (state === undefined)
+            throw new Error(`${TOOL_SEARCH_NAME}: Agent state could not be initialized`);
+        return state;
+    }
+    refreshCatalog(state) {
+        if (state.catalogGeneration === this.generation)
+            return;
+        state.catalog = buildCatalog(this.ctx.tools.schemas(state.agent));
+        state.catalogGeneration = this.generation;
+    }
+    filterAssembly(state, assembly) {
+        if (assembly.sections.some(section => section.name === 'tools:sdk' && section.text.trim().length > 0)) {
+            throw new Error('dsh-tool-search requires native tool presentation; code/PTC and both modes are unsupported');
+        }
+        state.catalog = buildCatalog(assembly.tools);
+        state.catalogGeneration = this.generation;
+        const visible = new Set(assembly.tools
+            .map(tool => tool.name)
+            .filter(name => this.policy.classify(name, state.selected) === 'always'));
+        const hidden = new Set(assembly.tools.map(tool => tool.name).filter(name => !visible.has(name)));
+        return {
+            ...assembly,
+            tools: assembly.tools.filter(tool => visible.has(tool.name)),
+            sections: assembly.sections.filter(section => {
+                const name = toolSectionName(section.name);
+                return name === undefined || !hidden.has(name);
+            }),
+        };
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

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

package/lib/settings.js

@@ -0,0 +1,50 @@
+/** Validated Host settings and policy resolution. */
+import z from '@deepseek-ai/schemastery';
+import { DEFAULT_CORE_TOOLS, DEFAULT_RESULT_LIMIT, MAX_RESULT_LIMIT, TOOL_SEARCH_NAME, TOOL_SEARCH_SETTINGS_NAMESPACE, } from "./shared.js";
+export const TOOL_SEARCH_SETTINGS_NS = TOOL_SEARCH_SETTINGS_NAMESPACE;
+export const Config = z.object({
+    defaultLimit: z.number().step(1).min(1).max(MAX_RESULT_LIMIT).default(DEFAULT_RESULT_LIMIT),
+    alwaysVisible: z.array(z.string()).default([]),
+    neverSearch: z.array(z.string()).default([]),
+});
+function normalizeNames(names) {
+    const normalized = new Set();
+    for (const value of names) {
+        const name = value.trim();
+        if (name.length > 0)
+            normalized.add(name);
+    }
+    return [...normalized].sort();
+}
+export function normalizeSettings(value) {
+    const defaultLimit = Number.isSafeInteger(value.defaultLimit)
+        ? Math.min(MAX_RESULT_LIMIT, Math.max(1, value.defaultLimit))
+        : DEFAULT_RESULT_LIMIT;
+    return {
+        defaultLimit,
+        alwaysVisible: normalizeNames(value.alwaysVisible),
+        neverSearch: normalizeNames(value.neverSearch).filter(name => name !== TOOL_SEARCH_NAME),
+    };
+}
+export class ToolPolicyResolver {
+    core = new Set(DEFAULT_CORE_TOOLS);
+    always = new Set();
+    blocked = new Set();
+    constructor(settings) {
+        this.update(settings);
+    }
+    update(settings) {
+        this.always = new Set(settings.alwaysVisible);
+        this.blocked = new Set(settings.neverSearch);
+    }
+    classify(name, selected) {
+        if (name === TOOL_SEARCH_NAME)
+            return 'always';
+        if (this.blocked.has(name))
+            return 'blocked';
+        if (this.core.has(name) || this.always.has(name) || selected?.has(name) === true)
+            return 'always';
+        return 'deferred';
+    }
+}
+//# sourceMappingURL=settings.js.map

package/lib/settings.js.map

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

package/lib/shared.js

@@ -0,0 +1,40 @@
+/** Values shared by the Host runtime and Web settings client. */
+export const TOOL_SEARCH_NAME = 'tool_search';
+export const TOOL_SEARCH_SETTINGS_NAMESPACE = 'tool-search';
+export const TOOL_SEARCH_CATALOG_ROUTE = '/_dsh/tool-search/catalog';
+export const DEFAULT_RESULT_LIMIT = 5;
+export const MAX_RESULT_LIMIT = 20;
+/**
+ * Stable bootstrap surface for current DSH releases. Unknown future first-party
+ * names are deferred until this list or the user allowlist is updated because
+ * ToolDefinition does not expose package provenance.
+ */
+export const DEFAULT_CORE_TOOLS = Object.freeze([
+    'apply_patch',
+    'ask_user_question',
+    'bash',
+    'create_goal',
+    'dsh_im_return_file',
+    'exit_plan_mode',
+    'get_goal',
+    'interrupt_agent',
+    'job_kill',
+    'job_list',
+    'job_output',
+    'list_agents',
+    'ralph',
+    'report',
+    'send_message',
+    'skill',
+    'subagent',
+    'subagent_fork',
+    'todo_write',
+    'update_goal',
+    'workflow',
+]);
+export const DEFAULT_SETTINGS = Object.freeze({
+    defaultLimit: DEFAULT_RESULT_LIMIT,
+    alwaysVisible: [],
+    neverSearch: [],
+});
+//# sourceMappingURL=shared.js.map

package/lib/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAA;AAC7C,MAAM,CAAC,MAAM,8BAA8B,GAAG,aAAa,CAAA;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAA;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,aAAa;IACb,mBAAmB;IACnB,MAAM;IACN,aAAa;IACb,oBAAoB;IACpB,gBAAgB;IAChB,UAAU;IACV,iBAAiB;IACjB,UAAU;IACV,UAAU;IACV,YAAY;IACZ,aAAa;IACb,OAAO;IACP,QAAQ;IACR,cAAc;IACd,OAAO;IACP,UAAU;IACV,eAAe;IACf,YAAY;IACZ,aAAa;IACb,UAAU;CACF,CAAC,CAAA;AAQX,MAAM,CAAC,MAAM,gBAAgB,GAAiC,MAAM,CAAC,MAAM,CAAC;IAC1E,YAAY,EAAE,oBAAoB;IAClC,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;CAChB,CAAC,CAAA"}

package/lib/types/bm25.d.ts

@@ -0,0 +1,20 @@
+/** Deterministic local BM25, aligned with Codex's bm25 2.3.2 defaults. */
+export declare function tokenize(value: string): string[];
+export interface Bm25Document<T> {
+    id: T;
+    name: string;
+    text: string;
+}
+export interface Bm25Match<T> {
+    id: T;
+    name: string;
+    score: number;
+}
+export declare class Bm25Index<T> {
+    private readonly documents;
+    private readonly frequencies;
+    private readonly averageLength;
+    constructor(documents: readonly Bm25Document<T>[]);
+    search(query: string, limit: number): Bm25Match<T>[];
+}
+//# sourceMappingURL=bm25.d.ts.map

package/lib/types/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/bm25.ts"],"names":[],"mappings":"AAAA,0EAA0E;AA8B1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAQD,qBAAa,SAAS,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAE1B,SAAS,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE;IAajD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE;CAgCrD"}

package/lib/types/catalog.d.ts

@@ -0,0 +1,26 @@
+/** Codex-compatible tool search document construction. */
+export interface JsonSchemaLike {
+    description?: unknown;
+    properties?: unknown;
+    items?: unknown;
+    anyOf?: unknown;
+}
+export interface ToolSchemaLike {
+    name: string;
+    description?: string;
+    parameters: unknown;
+}
+export interface ToolCatalogEntry {
+    name: string;
+    description: string;
+    parameters: unknown;
+    searchText: string;
+}
+/**
+ * Append descriptions and property names in the same recursive shape used by
+ * Codex: description, sorted object properties, array items, then anyOf.
+ */
+export declare function appendSchemaSearchText(schema: unknown, parts: string[]): void;
+export declare function toolSearchText(tool: ToolSchemaLike): string;
+export declare function buildCatalog(tools: readonly ToolSchemaLike[]): ToolCatalogEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/lib/types/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/catalog.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAQD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAgB7E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAO3D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAYjF"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,65 @@
+/** DSH Web settings surface for deferred tool policy. */
+import { type ReactNode } from 'react';
+import { type ToolSearchSettings } from '../shared.ts';
+interface SettingsScopeSnapshot<T> {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: T | undefined;
+    writable: boolean;
+}
+interface SettingsScope<T> {
+    getSnapshot(): SettingsScopeSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<void>;
+}
+type Disposer = () => void;
+interface ClientContext {
+    effect(setup: () => Disposer | void, label: string): void;
+    locale: {
+        register(namespace: string, catalogs: Record<string, Record<string, string>>): Disposer;
+        bind(namespace: string): (key: string) => string;
+    };
+    settingsScope: {
+        bind<T>(options: {
+            namespace: string;
+        }): SettingsScope<T>;
+    };
+    slots: {
+        inject(name: string, callback: () => Disposer): Disposer;
+        register<P>(options: {
+            name: string;
+            id: string;
+            order: number;
+            label: () => string;
+            inject: () => P;
+        }, component: (props: P) => ReactNode): Disposer;
+    };
+}
+type Translate = (key: keyof typeof en) => string;
+declare const en: {
+    nav: string;
+    topK: string;
+    alwaysVisible: string;
+    neverSearch: string;
+    catalog: string;
+    filter: string;
+    refresh: string;
+    tool: string;
+    policy: string;
+    selected: string;
+    defaultPolicy: string;
+    alwaysPolicy: string;
+    blockedPolicy: string;
+    loading: string;
+    empty: string;
+    saved: string;
+    onePerLine: string;
+};
+type SettingsProps = {
+    scope?: SettingsScope<ToolSearchSettings>;
+    t?: Translate;
+};
+export declare function ToolSearchSettingsSection({ scope, t }: SettingsProps): ReactNode;
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.tsx"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AACd,OAAO,EASL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAA;AAErB,UAAU,qBAAqB,CAAC,CAAC;IAC/B,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAA;IAC3C,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,aAAa,CAAC,CAAC;IACvB,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACvC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC3C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAA;AAE1B,UAAU,aAAa;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACzD,MAAM,EAAE;QACN,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAA;QACvF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KACjD,CAAA;IACD,aAAa,EAAE;QACb,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;KAC1D,CAAA;IACD,KAAK,EAAE;QACL,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,GAAG,QAAQ,CAAA;QACxD,QAAQ,CAAC,CAAC,EACR,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAA;YACZ,EAAE,EAAE,MAAM,CAAA;YACV,KAAK,EAAE,MAAM,CAAA;YACb,KAAK,EAAE,MAAM,MAAM,CAAA;YACnB,MAAM,EAAE,MAAM,CAAC,CAAA;SAChB,EACD,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,GACjC,QAAQ,CAAA;KACZ,CAAA;CACF;AAED,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,OAAO,EAAE,KAAK,MAAM,CAAA;AAEjD,QAAA,MAAM,EAAE;;;;;;;;;;;;;;;;;;CAkBP,CAAA;AAsED,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IACzC,CAAC,CAAC,EAAE,SAAS,CAAA;CACd,CAAA;AAED,wBAAgB,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,CAqKhF;AAED,eAAO,MAAM,MAAM,UAAuC,CAAA;AAE1D,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmB9C"}

package/lib/types/index.d.ts

@@ -0,0 +1,14 @@
+/** DSH bundle entry for Codex-style deferred tool loading. */
+import type { Context } from '@deepseek-ai/cordis';
+import { Config } from './settings.ts';
+import type { ToolSearchSettings } from './shared.ts';
+export declare const name = "@anionex/dsh-tool-search";
+export declare const inject: string[];
+export { Config };
+export declare function apply(ctx: Context, config: ToolSearchSettings): void;
+export { Bm25Index, tokenize } from './bm25.ts';
+export { appendSchemaSearchText, buildCatalog, toolSearchText } from './catalog.ts';
+export { ToolSearchRuntime } from './runtime.ts';
+export { normalizeSettings, ToolPolicyResolver } from './settings.ts';
+export * from './shared.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAAE,MAAM,EAA2B,MAAM,eAAe,CAAA;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,eAAO,MAAM,IAAI,6BAA6B,CAAA;AAC9C,eAAO,MAAM,MAAM,UAAkD,CAAA;AACrE,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAUpE;AAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACrE,cAAc,aAAa,CAAA"}

package/lib/types/runtime.d.ts

@@ -0,0 +1,37 @@
+/** Agent-local selected sets and model-visible tool filtering. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { type CatalogSnapshot, type ToolSearchSettings } from './shared.ts';
+export interface ToolSearchMatch {
+    name: string;
+    description: string;
+    score: number;
+}
+export interface ToolSearchResult {
+    schemaVersion: 1;
+    query: string;
+    tools: ToolSearchMatch[];
+}
+export declare class ToolSearchRuntime {
+    private readonly ctx;
+    readonly definition: ToolDefinition;
+    private readonly states;
+    private readonly policy;
+    private settings;
+    private generation;
+    constructor(ctx: Context, settings: ToolSearchSettings);
+    install(): () => void;
+    updateSettings(value: ToolSearchSettings): void;
+    snapshot(): CatalogSnapshot;
+    selectedFor(agent: Agent): ReadonlySet<string>;
+    private createDefinition;
+    private search;
+    private commitSelection;
+    private attach;
+    private detach;
+    private requireState;
+    private refreshCatalog;
+    private filterAssembly;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/lib/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAA;AAMpB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,eAAe,EAAE,CAAA;CACzB;AAqFD,qBAAa,iBAAiB;IAQ1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAI;gBAGH,GAAG,EAAE,OAAO,EAC7B,QAAQ,EAAE,kBAAkB;IAO9B,OAAO,IAAI,MAAM,IAAI;IAgBrB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK/C,QAAQ,IAAI,eAAe;IAsB3B,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;IAI9C,OAAO,CAAC,gBAAgB;IAsDxB,OAAO,CAAC,MAAM;IAuBd,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;CAqBvB"}

package/lib/types/settings.d.ts

@@ -0,0 +1,16 @@
+/** Validated Host settings and policy resolution. */
+import z from '@deepseek-ai/schemastery';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
+import { type ToolPolicy, type ToolSearchSettings } from './shared.ts';
+export declare const TOOL_SEARCH_SETTINGS_NS: SettingsNamespace;
+export declare const Config: z<ToolSearchSettings>;
+export declare function normalizeSettings(value: ToolSearchSettings): ToolSearchSettings;
+export declare class ToolPolicyResolver {
+    private readonly core;
+    private always;
+    private blocked;
+    constructor(settings: ToolSearchSettings);
+    update(settings: ToolSearchSettings): void;
+    classify(name: string, selected?: ReadonlySet<string>): ToolPolicy;
+}
+//# sourceMappingURL=settings.d.ts.map

package/lib/types/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAML,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,uBAAuB,EAAqC,iBAAiB,CAAA;AAE1F,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAIvC,CAAA;AAWF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAS/E;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAoB;gBAEvB,QAAQ,EAAE,kBAAkB;IAIxC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAK1C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,UAAU;CAMnE"}