@lvy-jsd/dsh-tool-manager 0.0.0-stage → 0.4.0

package/lib/types.d.ts

@@ -0,0 +1,453 @@
+/** A tool schema as the host lists it. */
+export interface ToolSchema {
+    name: string;
+    description?: string;
+    parameters?: unknown;
+    [key: string]: unknown;
+}
+/** Metadata a plugin can attach to tools (package.json `dsh.toolCatalog` or annotate()). */
+export interface ToolMeta {
+    group?: string;
+    category?: string;
+    risk?: string;
+    summary?: string;
+}
+export interface Annotation {
+    source?: string;
+    match: string | RegExp;
+    meta: ToolMeta;
+}
+export interface ToolEntry {
+    name: string;
+    /** Name inside its group (MCP routing prefix dropped). */
+    short: string;
+    group: string;
+    /** Where the structural fallback alone would have put the tool. */
+    fallbackGroup: string;
+    category: string;
+    summary: string;
+    description: string;
+    tokens: number;
+    highRisk: boolean;
+    annotation: ToolMeta;
+}
+export interface Group {
+    name: string;
+    category: string;
+    tools: ToolEntry[];
+}
+export interface Category {
+    name: string;
+    description: string;
+    groups: Group[];
+    /** Set on a synthetic alias node (several targets behind one name). */
+    alias?: string[];
+    /** The exact tools an alias stands for; load these, never their whole groups. */
+    aliasTools?: ToolEntry[];
+}
+export interface Catalog {
+    tools: Map<string, ToolEntry>;
+    groups: Map<string, Group>;
+    categories: Map<string, Category>;
+}
+export type CatalogNode = {
+    kind: 'root';
+} | {
+    kind: 'category';
+    category: Category;
+} | {
+    kind: 'group';
+    group: Group;
+} | {
+    kind: 'tool';
+    tool: ToolEntry;
+} | {
+    kind: 'missing';
+    target: string;
+};
+/** What a classifier sees of one tool. */
+export interface ToolProbe {
+    name: string;
+    description: string;
+    annotation: ToolMeta;
+}
+/** What a classifier sees of one group. */
+export interface GroupProbe {
+    name: string;
+    tools: ToolProbe[];
+}
+export interface Classifier {
+    name?: string;
+    priority?: number;
+    /** Group name for a tool, or undefined to pass. */
+    group?(tool: ToolProbe): string | undefined;
+    /** Category for a group, or undefined to pass. */
+    categorize?(group: GroupProbe): string | undefined;
+}
+export interface VisibilityFilter {
+    name?: string;
+    /** Names to keep out of `names`; may only narrow. */
+    filter(agent: Agent, names: string[]): Iterable<string> | undefined | null;
+}
+export interface TargetResolver {
+    name?: string;
+    /** Targets starting with this prefix are offered to `resolve` first. */
+    prefix?: string;
+    /** One or more ordinary targets to resolve instead, or undefined to pass. */
+    resolve(target: string): string | string[] | undefined | null;
+}
+/** A registry entry after registration (defaults filled in). */
+export interface RegisteredResolver {
+    name: string;
+    prefix: string;
+    resolve: TargetResolver['resolve'];
+}
+export type Disposer = () => void;
+export interface LoadState {
+    /** Individual tool names. */
+    loaded: Set<string>;
+    /** Subscribed group names (tools the group gains later included). */
+    groups: Set<string>;
+    /** Tools unloaded from inside a subscribed group. */
+    excluded: Set<string>;
+    /** Groups handed to subagents started later. */
+    handoffGroups: Set<string>;
+    /** Tools handed to subagents started later. */
+    handoffTools: Set<string>;
+}
+/** Plain JSON form of a LoadState (sorted arrays). */
+export type SerializedState = {
+    [K in keyof LoadState]: string[];
+};
+export interface StateProvider {
+    name?: string;
+    /** A serialized state for the agent, or null when there is none. */
+    load?(agent: Agent): Partial<SerializedState> | null | undefined;
+    save?(agent: Agent, state: SerializedState): void;
+}
+export interface RiskGate {
+    name?: string;
+}
+export interface Logger {
+    debug?(message: string): void;
+    info?(message: string): void;
+    warn?(message: string): void;
+}
+export interface SessionEvent {
+    type?: string;
+    data?: {
+        provider?: string;
+        [key: string]: unknown;
+    };
+}
+export interface Session {
+    id?: unknown;
+    seq?: number;
+    eventAt?(seq: number): SessionEvent | undefined;
+    requestHeader?(): {
+        provider?: string;
+    } | undefined;
+}
+/** An agent as this plugin uses it. */
+export interface Agent {
+    id: unknown;
+    options?: {
+        provider?: string;
+    };
+    session?: Session;
+    ctx?: {
+        tools?: {
+            restrict?(spec: {
+                allow?: string[];
+                deny?: string[];
+            }): Disposer;
+        };
+    };
+}
+export interface AgentsApi {
+    list(): Agent[];
+    get?(id: unknown): Agent | undefined;
+    isOwnedBy?(childId: unknown, candidate: Agent): boolean;
+}
+/** Context a plugin receives once `agents` is injected. */
+export interface AgentContext {
+    agents: AgentsApi;
+    effect(fn: () => Disposer | void, label?: string): void;
+    on(event: string, handler: (...args: any[]) => unknown): Disposer;
+}
+export interface ToolLayer {
+    tools: Map<string, {
+        description?: string;
+        parameters?: unknown;
+    }>;
+}
+export interface HostTools {
+    schemas(agent?: Agent): ToolSchema[];
+    register(definition: unknown): Disposer | void;
+    /** `visible` is what the agent ends up with after every layer's restrictions. */
+    view?(agent: Agent): {
+        restrictableNames: Iterable<string>;
+        visible?: {
+            has(name: string): boolean;
+        };
+    };
+    schemaOf?(definition: unknown, deferred: boolean): ToolSchema;
+    layers?: {
+        chainLayers?(agent: Agent): Iterable<ToolLayer>;
+        peek?(agent: Agent): ToolLayer | undefined;
+    };
+}
+export interface LoaderEntry {
+    options?: {
+        name?: unknown;
+        disabled?: boolean;
+    };
+}
+export interface Loader {
+    entries?(): Iterable<LoaderEntry>;
+    baseUrl?: string;
+    ctx?: {
+        baseUrl?: string;
+    };
+}
+/** The host context the core plugin is applied to. */
+export interface HostContext {
+    tools: HostTools;
+    logger?: ((name: string) => Logger) | Logger;
+    baseUrl?: string;
+    get?(name: string): unknown;
+    emit(event: string, ...args: unknown[]): void;
+    serial(event: string, ...args: unknown[]): Promise<unknown>;
+    on(event: string, handler: (...args: any[]) => unknown): Disposer;
+    effect(fn: () => Disposer | void, label?: string): void;
+    inject?(deps: string[], fn: (ctx: AgentContext) => void): void;
+    provide(name: string, service: unknown): void;
+}
+/**
+ * Settings a UI may edit at runtime. Each key is an independent list, so two
+ * writers editing different keys cannot clobber each other.
+ */
+export interface ToolManagerSettings {
+    /** Extra always-on tools. */
+    pinned?: string[];
+    /** Tools removed from the default always-on list. */
+    unpin?: string[];
+    /** Tool names treated as high risk. */
+    highRisk?: string[];
+}
+/** Configuration of the core plugin. */
+export interface CoreConfig {
+    /** Extra always-on tools. */
+    pinned?: string[];
+    /** Tools removed from the default always-on list. */
+    unpin?: string[];
+    /** Tool names treated as high risk. */
+    highRisk?: string[];
+    /** Model routes never narrowed (default ["claude-code"]). */
+    exemptProviders?: string[];
+    /**
+     * Where UI-edited settings are persisted (default
+     * <DSH_HOME>/tool-manager/config.json). Those values win over the fields
+     * above, per key.
+     */
+    settingsFile?: string;
+    /**
+     * Where UI-edited tool metadata is persisted (default
+     * <DSH_HOME>/tool-manager/metadata.json).
+     */
+    metadataFile?: string;
+    /**
+     * Where the plain-text tool manifest is written (default
+     * ~/.claude/dsh-tool-catalog.md). Set to '' to turn it off.
+     */
+    manifestFile?: string;
+    /**
+     * Where the exemption list is read from (default
+     * <DSH_HOME>/tool-manager/exempt.json). When the file exists its `providers`
+     * and `sessions` win over `exemptProviders` above; when it does not, the
+     * config list is used.
+     */
+    exemptFile?: string;
+    /** Model used to re-rank tools_route / skills_route candidates. */
+    model?: {
+        provider?: string;
+        model?: string;
+    };
+    /** Max tokens for the re-rank call. */
+    maxTokens?: number;
+    /** Default number of results for the find/route tools. */
+    topK?: number;
+    /** Token budget for loaded tool schemas, reported by tools_route. */
+    maxBudget?: number;
+    /** BM25 parameters (JS fallback index). */
+    k1?: number;
+    b?: number;
+    /** Rust sidecar overrides. */
+    sidecar?: {
+        bin?: string;
+        socket?: string;
+        timeoutMs?: number;
+    };
+}
+/** A plugin package the host loader knows. */
+export interface PluginPackage {
+    name: string;
+    dir: string;
+    manifest: string;
+}
+/** A search hit from toolCatalog.find(). */
+export interface FoundTool {
+    name: string;
+    short: string;
+    path: string;
+    category: string;
+    group: string;
+    summary: string;
+    tokens: number;
+    highRisk: boolean;
+}
+/** The service the core provides as `toolCatalog` (inject it to extend the catalog). */
+export interface ToolCatalogService {
+    registerClassifier(classifier: Classifier): Disposer;
+    annotate(match: string | RegExp, meta: ToolMeta): Disposer;
+    defineCategory(name: string, description?: string): Disposer;
+    registerVisibilityFilter(filter: VisibilityFilter): Disposer;
+    /** Own a target prefix (`"cap:"`) in tools_load / tools_ls / tools_unload. */
+    registerTargetResolver(resolver: TargetResolver): Disposer;
+    /** Let loaded state outlive the process (see dsh-tool-manager-persist). */
+    registerStateProvider(provider?: StateProvider): Disposer;
+    /** Declare that a plugin confirms high-risk loads; without one they are refused. */
+    registerRiskGate(gate?: RiskGate): Disposer;
+    riskGates(): string[];
+    /** Re-read package declarations and rebuild. */
+    refresh(): void;
+    /** Catalog as one agent sees it, or the union over live agents. */
+    get(agent?: Agent): Catalog;
+    resolve(target: string, agent?: Agent): CatalogNode;
+    stateOf(agent: Agent): LoadState;
+    exportState(agent: Agent): SerializedState;
+    importState(agent: Agent, state: Partial<SerializedState>): void;
+    /** Names visible to the agent, or null when this plugin does not restrict it. */
+    allowFor(agent: Agent): string[] | null;
+    /**
+     * Names this plugin lets the agent see (pinned or loaded) that another layer
+     * still hides: an MCP connector governance `deny` rule, the connector's
+     * per-session injection, or any other plugin's `restrict()`. Empty when the
+     * host cannot report the agent's final view.
+     */
+    deniedFor(agent: Agent): string[];
+    /** True when the agent is never narrowed, by route or by its session id. */
+    isExempt(agent: Agent): boolean;
+    /**
+     * Why the agent is exempt, so the UI can tell a route-wide exemption from one
+     * session: { exempt, source } with source 'file:provider' | 'file:session' |
+     * 'config:provider' | ''.
+     */
+    exemptionOf(agent: Agent): {
+        exempt: boolean;
+        source: string;
+    };
+    /** Load through the same path as tools_load; returns the model-facing text. */
+    load(agent: Agent, targets: readonly string[], options?: {
+        forSubagents?: boolean;
+    }): Promise<string>;
+    unload(agent: Agent, targets: readonly string[]): Promise<string>;
+    /** Live agents, each with its parent when it is a subagent. */
+    agents(): {
+        agent: Agent;
+        id: string;
+        parentId: string | null;
+    }[];
+    /** Effective configuration, for UI display. */
+    config(): {
+        pinned: string[];
+        entryTools: string[];
+        extraPinned: string[];
+        unpinned: string[];
+        highRisk: string[];
+        exemptProviders: string[];
+        /** Session ids exempted for their own lifetime by the exemption file. */
+        exemptSessions: string[];
+        defaults: string[];
+        /** Where UI edits are persisted. */
+        settingsFile: string;
+        /** True when a settings file exists and overrides the plugin config. */
+        hasSettings: boolean;
+        /** Where the exemption list is read from. */
+        exemptFile: string;
+        /** True when the exemption file exists and overrides `exemptProviders`. */
+        hasExemptFile: boolean;
+    };
+    /**
+     * Add or remove one session id in the exemption file and apply it at once.
+     * The first call creates the file from the lists already in force, so entries
+     * visible in the UI are never dropped by a write.
+     */
+    setExemptSession(sessionId: string, exempt: boolean): ReturnType<ToolCatalogService['config']>;
+    /** Re-read the exemption file, for after an external edit. */
+    reloadExempt(): ReturnType<ToolCatalogService['config']>;
+    /**
+     * Persist UI-edited settings (merged per key) and apply them at once. The
+     * values win over the plugin config from the next call on. Returns the new
+     * effective configuration, in the same shape as config().
+     */
+    updateConfig(patch: ToolManagerSettings): ReturnType<ToolCatalogService['config']>;
+    /** Re-read the settings file, for after an external edit. */
+    reloadConfig(): ReturnType<ToolCatalogService['config']>;
+    /**
+     * Metadata of one tool as the catalog currently shows it, including which
+     * layer decided each field (`manifest`, `runtime`, `metadata` or `classifier`).
+     */
+    toolMeta(name: string): {
+        name: string;
+        found: boolean;
+        /** Effective values after every layer. */
+        effective: ToolMeta;
+        /** Values edited from the panel, which win over the layers above. */
+        edited: ToolMeta;
+        /** Values from package.json and runtime annotate() calls. */
+        declared: ToolMeta;
+        group: string;
+        category: string;
+        summary: string;
+        highRisk: boolean;
+        /** The tool's directory path, for linking back to the Directory tab. */
+        path: string;
+        /** True when the tool is not in the catalog (unregistered or pinned away). */
+        missing: boolean;
+    };
+    /**
+     * Replace the editable metadata of one tool. Fields left out are dropped, so
+     * an emptied field falls back to the package declaration; an empty object
+     * removes the override entirely.
+     */
+    updateToolMeta(name: string, meta: ToolMeta): ReturnType<ToolCatalogService['toolMeta']>;
+    /** Drop every edited field of one tool, falling back to its declaration. */
+    clearToolMeta(name: string): ReturnType<ToolCatalogService['toolMeta']>;
+    /** Where edited metadata is persisted. */
+    metadataFile(): string;
+    packages(): PluginPackage[];
+    extensions(): {
+        classifiers: {
+            name: string;
+            priority: number;
+        }[];
+        filters: string[];
+        annotations: {
+            source: string | undefined;
+            match: string;
+        }[];
+        categories: string[];
+        riskGates: string[];
+        stateProviders: string[];
+    };
+    /** Structured cross-directory search (same matching as tools_ls with a query). */
+    find(query: string, path?: string): FoundTool[];
+    /** Schema tokens actually sent for an agent: pinned tools plus its loaded set. */
+    wireTokens(agent: Agent): number;
+}
+/** What an extension plugin uses of its context after `inject: ['toolCatalog']`. */
+export interface ExtensionContext extends Pick<HostContext, 'logger' | 'effect' | 'on'> {
+    toolCatalog: ToolCatalogService;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/types.js

@@ -0,0 +1,7 @@
+// Types shared by the core modules and exported for extension plugins.
+//
+// The host surface is described structurally (only what this plugin touches)
+// instead of importing the host's Cordis types, so the package type-checks
+// without the host packages installed next to it.
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,kDAAkD"}

package/lib/visibility.d.ts

@@ -0,0 +1,33 @@
+import type { Agent, AgentContext, Catalog, Disposer, HostContext, LoadState, Logger, SerializedState, StateProvider } from './types.js';
+import type { RegisteredFilter } from './service.js';
+/** Plain JSON form of one agent's state (sorted arrays). */
+export declare function serializeState(state: LoadState): SerializedState;
+/** Inverse of serializeState; unknown keys are ignored, values coerced to strings. */
+export declare function deserializeState(raw: Partial<Record<keyof LoadState, Iterable<unknown>>> | null | undefined): LoadState;
+export interface VisibilityOptions {
+    pinned: () => Iterable<string>;
+    entryTools?: readonly string[];
+    getFilters?: () => readonly RegisteredFilter[];
+    getCatalog: (agent?: Agent) => Catalog;
+    invalidate?: () => void;
+    onStateChange?: (agent: Agent, state: SerializedState) => void;
+    isExempt?: (agent: Agent) => boolean;
+    logger?: Logger;
+}
+export type VisibilityController = ReturnType<typeof createVisibilityController>;
+export declare function createVisibilityController(ctx: Pick<HostContext, 'tools'>, { pinned, entryTools, getFilters, getCatalog, invalidate, onStateChange, isExempt, logger }: VisibilityOptions): {
+    mount: (agentCtx: AgentContext) => Disposer;
+    update: <R>(agent: Agent, mutate: (state: LoadState) => R) => R;
+    agents: () => Agent[];
+    parentOf: (agent: Agent) => Agent | undefined;
+    stateOf: (agent: Agent) => LoadState;
+    registerStateProvider: (provider?: StateProvider) => Disposer;
+    stateProviders: () => string[];
+    exportState: (agent: Agent) => SerializedState;
+    importState: (agent: Agent, raw: Parameters<typeof deserializeState>[0]) => void;
+    allowFor: (agent: Agent) => string[] | null;
+    isExempt: (agent: Agent) => boolean;
+    refresh: () => void;
+    dispose(): void;
+};
+//# sourceMappingURL=visibility.d.ts.map

package/lib/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../src/visibility.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACxI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAcpD,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAIhE;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAIvH;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,SAAS,gBAAgB,EAAE,CAAA;IAC9C,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,OAAO,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IAC9D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAQD,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEhF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAe,EAAE,UAAqB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,QAAsB,EAAE,MAAM,EAAE,EAAE,iBAAiB;sBA6L7L,YAAY,KAAG,QAAQ;aAiChC,CAAC,SAAS,KAAK,UAAU,CAAC,KAAK,EAAE,SAAS,KAAK,CAAC,KAAG,CAAC;kBAoBtD,KAAK,EAAE;sBApII,KAAK,KAAG,KAAK,GAAG,SAAS;qBA0G1B,KAAK,KAAG,SAAS;uCAvDA,aAAa,KAAQ,QAAQ;;yBAsF/C,KAAK;yBAbA,KAAK,OAAO,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC;sBAgB1D,KAAK,KAAG,MAAM,EAAE,GAAG,IAAI;sBACvB,KAAK;;;EAO1B"}