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

package/lib/visibility.js

@@ -0,0 +1,305 @@
+// Per-agent visibility: an allowlist installed with `agent.ctx.tools.restrict`.
+//
+//   allow(agent) = (pinned ∪ loaded tools ∪ tools of subscribed groups) − excluded
+//                  ∩ names the host currently lets this agent's scope restrict
+//
+// An allowlist (not a denylist) means a tool that appears later — an MCP server
+// reconnecting, a plugin installed, a tool renamed — stays hidden until loaded.
+// Restrictions from other plugins (connector governance deny) intersect with
+// ours, so a hard deny always wins.
+const STATE_KEYS = ['loaded', 'groups', 'excluded', 'handoffGroups', 'handoffTools'];
+function emptyState() {
+    return {
+        loaded: new Set(), // individual tool names
+        groups: new Set(), // subscribed group names (future tools included)
+        excluded: new Set(), // tools unloaded from inside a subscribed group
+        handoffGroups: new Set(),
+        handoffTools: new Set(),
+    };
+}
+/** Plain JSON form of one agent's state (sorted arrays). */
+export function serializeState(state) {
+    const out = {};
+    for (const key of STATE_KEYS)
+        out[key] = [...state[key]].sort();
+    return out;
+}
+/** Inverse of serializeState; unknown keys are ignored, values coerced to strings. */
+export function deserializeState(raw) {
+    const state = emptyState();
+    for (const key of STATE_KEYS)
+        for (const value of raw?.[key] ?? [])
+            state[key].add(String(value));
+    return state;
+}
+export function createVisibilityController(ctx, { pinned, entryTools = [], getFilters = () => [], getCatalog, invalidate, onStateChange, isExempt = () => false, logger }) {
+    const states = new Map();
+    const installed = new Map();
+    const providers = []; // state providers (persistence plugins)
+    const touched = new Set(); // agents mutated by a load/unload
+    let agentsApi = null;
+    let syncing = false;
+    let disposed = false;
+    // --- names the host will accept in restrict() for this agent ------------
+    function restrictableNames(agent) {
+        try {
+            if (typeof ctx.tools.view === 'function')
+                return new Set(ctx.tools.view(agent).restrictableNames);
+        }
+        catch (error) {
+            logger?.debug?.(`tool-manager: view() unavailable: ${error.message}`);
+        }
+        return new Set(ctx.tools.schemas().map((s) => s.name));
+    }
+    function allowFor(agent) {
+        const state = states.get(agent);
+        const catalog = getCatalog(agent);
+        const wanted = new Set(pinned());
+        for (const name of state.loaded)
+            wanted.add(name);
+        for (const group of state.groups) {
+            for (const tool of catalog.groups.get(group)?.tools ?? []) {
+                if (!tool.highRisk && !state.excluded.has(tool.name))
+                    wanted.add(tool.name);
+            }
+        }
+        const known = restrictableNames(agent);
+        let allow = [...wanted].filter((name) => known.has(name));
+        // Extension filters may only narrow, and never hide the entry tools (the
+        // model's way back to the directory).
+        for (const { name, filter } of getFilters()) {
+            try {
+                const kept = new Set(filter(agent, [...allow]) ?? allow);
+                allow = allow.filter((n) => kept.has(n) || entryTools.includes(n));
+            }
+            catch (error) {
+                logger?.warn?.(`tool-manager: visibility filter ${name} failed: ${error.message}`);
+            }
+        }
+        return allow.sort();
+    }
+    // restrict() emits tools/change synchronously, which re-enters install()
+    // for the same agent before the outer call has recorded its disposer. A
+    // nested install must not stack a second restriction (restrictions
+    // intersect, and an orphan would hide every later load), so it only marks
+    // the agent dirty and the outer call loops.
+    const busy = new Set();
+    const dirty = new Set();
+    function install(agent) {
+        if (!states.has(agent) || agent?.ctx?.tools?.restrict === undefined)
+            return;
+        if (busy.has(agent)) {
+            dirty.add(agent);
+            return;
+        }
+        busy.add(agent);
+        try {
+            do {
+                dirty.delete(agent);
+                installOnce(agent);
+            } while (dirty.has(agent));
+        }
+        finally {
+            busy.delete(agent);
+        }
+    }
+    function installOnce(agent) {
+        // An exempt agent (e.g. a Claude Code route, whose tool list is handed over
+        // once at session start and never refreshed) gets no restriction at all; a
+        // restriction installed before it switched route is lifted.
+        if (isExempt(agent)) {
+            installed.get(agent)?.dispose?.();
+            installed.delete(agent);
+            return;
+        }
+        const allow = allowFor(agent);
+        const key = allow.join('\n');
+        const current = installed.get(agent);
+        if (current?.key === key)
+            return;
+        try {
+            // New restriction first, then release the old one, so there is never a
+            // moment with no restriction (which would expose every tool).
+            const dispose = agent.ctx.tools.restrict({ allow });
+            installed.set(agent, { key, dispose });
+            current?.dispose?.();
+        }
+        catch (error) {
+            logger?.warn?.(`tool-manager: restrict agent ${String(agent?.id)} failed: ${error.message}`);
+        }
+    }
+    function syncAll() {
+        if (disposed || !agentsApi || syncing)
+            return;
+        // restrict() emits tools/change synchronously; the nested event would only
+        // rescan the same state.
+        syncing = true;
+        try {
+            for (const agent of agentsApi.list()) {
+                if (!states.has(agent))
+                    adopt(agent);
+                install(agent);
+            }
+            const live = agentsApi.list();
+            for (const agent of [...states.keys()])
+                if (!live.includes(agent))
+                    forget(agent);
+        }
+        finally {
+            syncing = false;
+        }
+    }
+    function parentOf(agent) {
+        const api = agentsApi;
+        if (typeof api?.isOwnedBy !== 'function')
+            return undefined;
+        return api.list().find((candidate) => candidate !== agent && api.isOwnedBy(agent.id, candidate));
+    }
+    /** State handed back by a provider, or null when none has any. */
+    function stateFromProviders(agent) {
+        for (const { name, load } of providers) {
+            try {
+                const raw = load(agent);
+                if (raw)
+                    return deserializeState(raw);
+            }
+            catch (error) {
+                logger?.warn?.(`tool-manager: state provider ${name} failed to load: ${error.message}`);
+            }
+        }
+        return null;
+    }
+    /** What an agent starts from: pinned tools plus the parent's handoff. */
+    function fallbackState(agent) {
+        const state = emptyState();
+        const parent = parentOf(agent);
+        const parentState = parent && states.get(parent);
+        if (parentState) {
+            for (const group of parentState.handoffGroups)
+                state.groups.add(group);
+            for (const tool of parentState.handoffTools)
+                state.loaded.add(tool);
+        }
+        return state;
+    }
+    function adopt(agent) {
+        states.set(agent, stateFromProviders(agent) ?? fallbackState(agent));
+    }
+    /** Save a state change through every provider (fire and forget). */
+    function broadcast(agent, state) {
+        for (const { name, save } of providers) {
+            try {
+                save(agent, state);
+            }
+            catch (error) {
+                logger?.warn?.(`tool-manager: state provider ${name} failed to save: ${error.message}`);
+            }
+        }
+    }
+    /**
+     * Register a state provider so loaded state can outlive the process (DSH
+     * restart). `load(agent)` returns a serialized state or null; `save(agent,
+     * state)` receives plain JSON. Returns a disposer.
+     */
+    function registerStateProvider(provider = {}) {
+        const entry = { name: provider.name ?? 'anonymous', load: provider.load ?? (() => null), save: provider.save ?? (() => { }) };
+        providers.push(entry);
+        // A persistence plugin normally mounts after this controller's first sync,
+        // so agents already adopted from the fallback state (nothing loaded yet)
+        // get one more chance to restore. An agent the user already changed is
+        // never overwritten.
+        for (const agent of [...states.keys()]) {
+            if (touched.has(agent))
+                continue;
+            const restored = stateFromProviders(agent);
+            if (restored) {
+                states.set(agent, restored);
+                install(agent);
+            }
+        }
+        return () => {
+            const i = providers.indexOf(entry);
+            if (i >= 0)
+                providers.splice(i, 1);
+        };
+    }
+    function forget(agent) {
+        states.delete(agent);
+        touched.delete(agent);
+        installed.get(agent)?.dispose?.();
+        installed.delete(agent);
+    }
+    function mount(agentCtx) {
+        agentsApi = agentCtx.agents;
+        const stops = [
+            agentCtx.on('agent/created', ({ agent }) => {
+                invalidate?.();
+                if (!states.has(agent))
+                    adopt(agent);
+                install(agent);
+            }),
+            agentCtx.on('agent/disposed', ({ agent }) => forget(agent)),
+            agentCtx.on('tools/change', () => { invalidate?.(); syncAll(); }),
+            // A route switch (model/selection) can make an agent exempt or not; it is
+            // appended before the next request, so re-evaluate right away.
+            agentCtx.on('session/event', (session, event) => {
+                if (event?.type !== 'model/selection' && event?.type !== 'request/context')
+                    return;
+                const agent = agentsApi?.get?.(session?.id);
+                if (agent && states.has(agent))
+                    install(agent);
+            }),
+        ];
+        // Agents that already exist (resumed before this plugin mounted).
+        syncAll();
+        return () => {
+            for (const stop of stops)
+                stop?.();
+            for (const agent of [...installed.keys()])
+                forget(agent);
+            agentsApi = null;
+        };
+    }
+    function stateOf(agent) {
+        if (!states.has(agent))
+            adopt(agent);
+        return states.get(agent);
+    }
+    /** Apply a mutation to one agent's state, reinstall, and notify listeners. */
+    function update(agent, mutate) {
+        const state = stateOf(agent);
+        touched.add(agent);
+        const result = mutate(state);
+        install(agent);
+        const plain = serializeState(state);
+        broadcast(agent, plain);
+        onStateChange?.(agent, plain);
+        return result;
+    }
+    /** Replace one agent's state (e.g. restored by a persistence plugin). */
+    function importState(agent, raw) {
+        states.set(agent, deserializeState(raw));
+        install(agent);
+    }
+    return {
+        mount,
+        update,
+        agents: () => agentsApi?.list() ?? [],
+        parentOf,
+        stateOf,
+        registerStateProvider,
+        stateProviders: () => providers.map((p) => p.name),
+        exportState: (agent) => serializeState(stateOf(agent)),
+        importState,
+        // null for an agent this plugin does not restrict (untracked or exempt).
+        allowFor: (agent) => (states.has(agent) && !isExempt(agent) ? allowFor(agent) : null),
+        isExempt: (agent) => isExempt(agent),
+        refresh: syncAll,
+        dispose() {
+            disposed = true;
+            for (const agent of [...installed.keys()])
+                forget(agent);
+        },
+    };
+}
+//# sourceMappingURL=visibility.js.map

package/lib/visibility.js.map

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

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@lvy-jsd/dsh-tool-manager",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Browse every DeepSeek Harness tool as a directory (category -> group -> tool) and load tools on demand per agent. Provides the toolCatalog service for classifier, metadata, hook and visibility extensions.",
+  "license": "MIT",
+  "author": "lvy-jsd",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "!lib/.tsbuildinfo",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "prepack": "tsc -b ."
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "tools",
+    "mcp",
+    "lazy-loading"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2 <0.3.0-0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lvy-jsd/dsh-tool-manager.git",
+    "directory": "packages/dsh-tool-manager"
+  }
+}