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

package/lib/service.d.ts

@@ -0,0 +1,51 @@
+import type { Annotation, Classifier, Disposer, HostContext, Logger, PluginPackage, RegisteredResolver, TargetResolver, ToolMeta, VisibilityFilter } from './types.js';
+/** A classifier after registration (defaults filled in). */
+export interface RegisteredClassifier extends Classifier {
+    name: string;
+    priority: number;
+}
+/** A visibility filter after registration (defaults filled in). */
+export interface RegisteredFilter {
+    name: string;
+    filter: VisibilityFilter['filter'];
+}
+/** Package name of a loader specifier: "@scope/pkg/sub" -> "@scope/pkg", "pkg/sub" -> "pkg". */
+export declare function packageNameOf(specifier: string): string;
+/**
+ * Read `dsh.toolCatalog` declarations from every plugin package the host loader
+ * knows. Declaration format (package.json):
+ *
+ *   "dsh": { "toolCatalog": {
+ *     "match": "^adb_",                 // regex over tool names (optional)
+ *     "group": "adb", "category": "device",
+ *     "tools": { "adb_install": { "risk": "high", "summary": "..." } }
+ *   } }
+ *
+ * `group`/`category`/`risk`/`summary` at the top level apply to `match`;
+ * entries under `tools` apply to exact names and win over the top level.
+ */
+export declare function readManifestAnnotations(ctx: Pick<HostContext, 'get' | 'baseUrl'>, logger?: Logger): Annotation[];
+/**
+ * Every enabled plugin package the host loader knows, as
+ * `{ name, dir, manifest }`. Relative (local) entries are skipped.
+ */
+export declare function listPluginPackages(ctx: Pick<HostContext, 'get' | 'baseUrl'>): PluginPackage[];
+/** Registries behind the service. `onChange` rebuilds the catalog. */
+export declare function createRegistries(onChange: () => void): {
+    classifiers: Set<RegisteredClassifier>;
+    annotations: Annotation[];
+    categories: Map<string, string>;
+    filters: Set<RegisteredFilter>;
+    resolvers: Set<RegisteredResolver>;
+    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 in tools_load / tools_ls / tools_unload. `resolve` gets
+     * the raw target and returns one or more ordinary targets (paths, group or
+     * tool names), or undefined to pass.
+     */
+    registerTargetResolver(resolver: TargetResolver): Disposer;
+};
+//# sourceMappingURL=service.d.ts.map

package/lib/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAU,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE9K,4DAA4D;AAC5D,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;CACnC;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvD;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAgBhH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,SAAS,CAAC,GAAG,aAAa,EAAE,CAsB7F;AAcD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI;;;;;;mCAuBlB,UAAU,GAAG,QAAQ;oBASpC,MAAM,GAAG,MAAM,QAAQ,QAAQ,GAAG,QAAQ;yBAMrC,MAAM,yBAAqB,QAAQ;qCAMvB,gBAAgB,GAAG,QAAQ;IAO5D;;;;OAIG;qCAC8B,cAAc,GAAG,QAAQ;EAQ7D"}

package/lib/service.js

@@ -0,0 +1,199 @@
+// The `toolCatalog` service: the extension surface other plugins build on.
+//
+//   registerClassifier({ name, priority, group?(tool), categorize?(group) })
+//   annotate(match, { group?, category?, risk?, summary? })
+//   defineCategory(name, description)
+//   registerVisibilityFilter({ name, filter(agent, names) })
+//   refresh(), get(), resolve(target), stateOf(agent)
+//
+// Every register/annotate/define call returns a disposer. Extension plugins
+// should register inside an effect so unloading them undoes the registration:
+//   ctx.effect(() => ctx.toolCatalog.registerClassifier({...}))
+//
+// Hooks are plain Cordis events on the host context:
+//   tool-catalog/before-load    (serial; throw to veto)   { agent, targets, names }
+//                               also fired by the auto-load of a directly called
+//                               hidden tool, with `rescue: true` in the payload
+//   tool-catalog/after-load     (emit)                    { agent, targets, added }
+//   tool-catalog/before-unload  (serial; throw to veto)   { agent, targets }
+//   tool-catalog/after-unload   (emit)                    { agent, targets, removed }
+//   tool-catalog/before-rebuild (emit)                    { }
+//   tool-catalog/after-rebuild  (emit)                    { catalog }
+import { readFileSync, existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { DEFAULT_CATEGORIES } from './catalog.js';
+/** Package name of a loader specifier: "@scope/pkg/sub" -> "@scope/pkg", "pkg/sub" -> "pkg". */
+export function packageNameOf(specifier) {
+    const parts = String(specifier).split('/');
+    return specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0] ?? specifier;
+}
+/** Find a package's package.json starting from a resolvable entry file. */
+function findManifest(requireFrom, pkg) {
+    try {
+        return requireFrom.resolve(`${pkg}/package.json`);
+    }
+    catch {
+        // exports may hide package.json; walk up from the main entry instead.
+    }
+    try {
+        let dir = dirname(requireFrom.resolve(pkg));
+        while (dir !== dirname(dir)) {
+            const candidate = join(dir, 'package.json');
+            if (existsSync(candidate)) {
+                const json = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (json.name === pkg)
+                    return candidate;
+            }
+            dir = dirname(dir);
+        }
+    }
+    catch {
+        // unresolvable from here
+    }
+    return undefined;
+}
+/**
+ * Read `dsh.toolCatalog` declarations from every plugin package the host loader
+ * knows. Declaration format (package.json):
+ *
+ *   "dsh": { "toolCatalog": {
+ *     "match": "^adb_",                 // regex over tool names (optional)
+ *     "group": "adb", "category": "device",
+ *     "tools": { "adb_install": { "risk": "high", "summary": "..." } }
+ *   } }
+ *
+ * `group`/`category`/`risk`/`summary` at the top level apply to `match`;
+ * entries under `tools` apply to exact names and win over the top level.
+ */
+export function readManifestAnnotations(ctx, logger) {
+    const annotations = [];
+    for (const { name: pkg, manifest: manifestPath } of listPluginPackages(ctx)) {
+        try {
+            const declared = JSON.parse(readFileSync(manifestPath, 'utf8'))?.dsh?.toolCatalog;
+            if (!declared)
+                continue;
+            const top = pick(declared);
+            if (declared.match && Object.keys(top).length)
+                annotations.push({ source: pkg, match: new RegExp(declared.match), meta: top });
+            for (const [name, meta] of Object.entries((declared.tools ?? {}))) {
+                annotations.push({ source: pkg, match: name, meta: { ...top, ...pick(meta) } });
+            }
+        }
+        catch (error) {
+            logger?.warn?.(`tool-manager: bad dsh.toolCatalog in ${pkg}: ${error.message}`);
+        }
+    }
+    return annotations;
+}
+/**
+ * Every enabled plugin package the host loader knows, as
+ * `{ name, dir, manifest }`. Relative (local) entries are skipped.
+ */
+export function listPluginPackages(ctx) {
+    const loader = ctx.get?.('loader');
+    if (!loader?.entries)
+        return [];
+    const bases = [loader.baseUrl, loader.ctx?.baseUrl, ctx.baseUrl, pathToFileURL(join(process.cwd(), 'noop.js')).href].filter((b) => Boolean(b));
+    const seen = new Set();
+    const out = [];
+    for (const entry of loader.entries()) {
+        const spec = entry?.options?.name;
+        if (typeof spec !== 'string' || spec.startsWith('.') || entry.options?.disabled === true)
+            continue;
+        const pkg = packageNameOf(spec);
+        if (seen.has(pkg))
+            continue;
+        seen.add(pkg);
+        for (const base of bases) {
+            const from = createRequire(base.startsWith('file:') ? fileURLToPath(base) : join(base, 'noop.js'));
+            const manifest = findManifest(from, pkg);
+            if (manifest) {
+                out.push({ name: pkg, dir: dirname(manifest), manifest });
+                break;
+            }
+        }
+    }
+    return out;
+}
+const META_KEYS = ['group', 'category', 'risk', 'summary'];
+function pick(meta = {}) {
+    const out = {};
+    if (typeof meta !== 'object' || meta === null)
+        return out;
+    for (const key of META_KEYS) {
+        const value = meta[key];
+        if (typeof value === 'string' && value)
+            out[key] = value;
+    }
+    return out;
+}
+/** Registries behind the service. `onChange` rebuilds the catalog. */
+export function createRegistries(onChange) {
+    const classifiers = new Set();
+    const annotations = [];
+    const categories = new Map(Object.entries(DEFAULT_CATEGORIES));
+    const filters = new Set();
+    const resolvers = new Set();
+    const remover = (fn) => {
+        let done = false;
+        return () => {
+            if (done)
+                return;
+            done = true;
+            fn();
+            onChange();
+        };
+    };
+    return {
+        classifiers,
+        annotations,
+        categories,
+        filters,
+        resolvers,
+        registerClassifier(classifier) {
+            if (!classifier || (typeof classifier.group !== 'function' && typeof classifier.categorize !== 'function')) {
+                throw new TypeError('registerClassifier: provide group(tool) and/or categorize(group)');
+            }
+            const entry = { name: classifier.name ?? 'anonymous', priority: Number(classifier.priority ?? 0), group: classifier.group, categorize: classifier.categorize };
+            classifiers.add(entry);
+            onChange();
+            return remover(() => classifiers.delete(entry));
+        },
+        annotate(match, meta) {
+            const entry = { source: 'runtime', match: typeof match === 'string' ? match : new RegExp(match), meta: pick(meta) };
+            annotations.push(entry);
+            onChange();
+            return remover(() => annotations.splice(annotations.indexOf(entry), 1));
+        },
+        defineCategory(name, description = '') {
+            const previous = categories.get(name);
+            categories.set(name, description);
+            onChange();
+            return remover(() => (previous === undefined ? categories.delete(name) : categories.set(name, previous)));
+        },
+        registerVisibilityFilter(filter) {
+            if (typeof filter?.filter !== 'function')
+                throw new TypeError('registerVisibilityFilter: provide filter(agent, names)');
+            const entry = { name: filter.name ?? 'anonymous', filter: filter.filter };
+            filters.add(entry);
+            onChange();
+            return remover(() => filters.delete(entry));
+        },
+        /**
+         * Own a target prefix in tools_load / tools_ls / tools_unload. `resolve` gets
+         * the raw target and returns one or more ordinary targets (paths, group or
+         * tool names), or undefined to pass.
+         */
+        registerTargetResolver(resolver) {
+            if (typeof resolver?.resolve !== 'function')
+                throw new TypeError('registerTargetResolver: provide resolve(target)');
+            const entry = { name: resolver.name ?? 'anonymous', prefix: String(resolver.prefix ?? ''), resolve: resolver.resolve };
+            resolvers.add(entry);
+            onChange();
+            return remover(() => resolvers.delete(entry));
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,317 @@
+/** 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;
+    view?(agent: Agent): {
+        restrictableNames: Iterable<string>;
+    };
+    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;
+}
+/** 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[];
+}
+/** 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;
+    /** True when the agent's model route is in `exemptProviders` (never narrowed). */
+    isExempt(agent: Agent): boolean;
+    /** 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;
+    }[];
+    config(): {
+        pinned: string[];
+        entryTools: string[];
+        extraPinned: string[];
+        unpinned: string[];
+        highRisk: 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"}