@namzu/sdk 27.1.0 → 29.0.0

package/dist/registry/{Registry.js → BaseRegistry.js}

@@ -1,4 +1,4 @@
-export class Registry {
+export class BaseRegistry {
     items = new Map();
     register(id, item) {
         this.items.set(id, item);
@@ -25,4 +25,4 @@ export class Registry {
         return this.items.size;
     }
 }
-//# sourceMappingURL=Registry.js.map
+//# sourceMappingURL=BaseRegistry.js.map

package/dist/registry/BaseRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseRegistry.js","sourceRoot":"","sources":["../../src/registry/BaseRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACd,KAAK,GAA6B,IAAI,GAAG,EAAE,CAAA;IAErD,QAAQ,CAAC,EAAU,EAAE,IAAiB;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,MAAM;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,OAAO;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,UAAU,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;IAED,IAAI;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACvB,CAAC;CACD"}

package/dist/registry/ManagedRegistry.d.ts

@@ -1,5 +1,5 @@
 import { type Logger } from '../utils/logger.js';
-import { Registry } from './Registry.js';
+import { BaseRegistry } from './BaseRegistry.js';
 export interface ManagedRegistryConfig<TDefinition> {
     componentName: string;
     idField?: keyof TDefinition & string;
@@ -10,7 +10,7 @@ export interface ManagedRegistryConfig<TDefinition> {
     computeId?: (item: TDefinition) => string;
     logger?: Logger;
 }
-export declare class ManagedRegistry<TDefinition> extends Registry<TDefinition> {
+export declare class ManagedRegistry<TDefinition> extends BaseRegistry<TDefinition> {
     protected log: Logger;
     private idField?;
     private computeId?;

package/dist/registry/ManagedRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManagedRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/ManagedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,WAAW,qBAAqB,CAAC,WAAW;IACjD,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,CAAA;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,MAAM,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAe,CAAC,WAAW,CAAE,SAAQ,QAAQ,CAAC,WAAW,CAAC;IACtE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,OAAO,CAAC,CAA4B;IAC5C,OAAO,CAAC,SAAS,CAAC,CAA+B;gBAErC,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;IAS7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAwC7C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;CAOnC"}
+{"version":3,"file":"ManagedRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/ManagedRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,WAAW,qBAAqB,CAAC,WAAW;IACjD,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,CAAA;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,MAAM,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAe,CAAC,WAAW,CAAE,SAAQ,YAAY,CAAC,WAAW,CAAC;IAC1E,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,OAAO,CAAC,CAA4B;IAC5C,OAAO,CAAC,SAAS,CAAC,CAA+B;gBAErC,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;IAU7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAsD7C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;CAOnC"}

package/dist/registry/ManagedRegistry.js

@@ -1,6 +1,8 @@
-import { getRootLogger } from '../utils/logger.js';
-import { Registry } from './Registry.js';
-export class ManagedRegistry extends Registry {
+import { NAMZU } from '../constants/telemetry/index.js';
+import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
+import { resolveLogger } from '../utils/logger.js';
+import { BaseRegistry } from './BaseRegistry.js';
+export class ManagedRegistry extends BaseRegistry {
     log;
     idField;
     computeId;
@@ -8,8 +10,9 @@ export class ManagedRegistry extends Registry {
         super();
         this.idField = config.idField;
         this.computeId = config.computeId;
-        this.log = (config.logger ?? getRootLogger()).child({
-            component: config.componentName,
+        this.log = resolveLogger(config.logger).child({
+            [SCOPE_ATTRIBUTE]: 'registry',
+            [NAMZU.REGISTRY_NAME]: config.componentName,
         });
     }
     register(idOrItem, maybeItem) {
@@ -26,10 +29,10 @@ export class ManagedRegistry extends Registry {
             const id = idOrItem;
             const item = maybeItem;
             if (this.has(id)) {
-                this.log.warn(`"${id}" already registered, overwriting.`);
+                this.log.warn('Already registered, overwriting', { 'namzu.registry.item_id': id });
             }
             super.register(id, item);
-            this.log.info(`Registered: ${id}`);
+            this.log.debug('Registered', { 'namzu.registry.item_id': id });
             return;
         }
         const item = idOrItem;
@@ -42,10 +45,24 @@ export class ManagedRegistry extends Registry {
             throw new Error('register(item) requires idField or computeId to be configured');
         }
         if (this.has(id)) {
-            this.log.warn(`"${id}" already registered, overwriting.`);
+            this.log.warn('Already registered, overwriting', { 'namzu.registry.item_id': id });
         }
         super.register(id, item);
-        this.log.info(`Registered: ${id}`);
+        // `debug`, not `info`. Registration is the startup path doing exactly
+        // what it is supposed to do, once per item, and there are dozens: a
+        // default-level run opened with twenty `Registered` lines, one per
+        // tool, before anything an operator could act on. That is the same
+        // failure as silence with the sign flipped — the interesting lines are
+        // there, and nobody can find them.
+        //
+        // The overwrite case above stays at `warn`, because a second
+        // registration under a live id IS news.
+        //
+        // Found by running the CLI against a real provider rather than a mock.
+        // Every unit test here asserts on a logger stub, so the LEVEL was
+        // invisible to all of them: what a start actually reads like is not a
+        // property any of them measure.
+        this.log.debug('Registered', { 'namzu.registry.item_id': id });
     }
     getOrThrow(id) {
         const item = this.get(id);

package/dist/registry/ManagedRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ManagedRegistry.js","sourceRoot":"","sources":["../../src/registry/ManagedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAaxC,MAAM,OAAO,eAA6B,SAAQ,QAAqB;IAC5D,GAAG,CAAQ;IACb,OAAO,CAA6B;IACpC,SAAS,CAAgC;IAEjD,YAAY,MAA0C;QACrD,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;QACjC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC;YACnD,SAAS,EAAE,MAAM,CAAC,aAAa;SAC/B,CAAC,CAAA;IACH,CAAC;IAKQ,QAAQ,CAAC,QAA8C,EAAE,SAAuB;QACxF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACpB,CAAC;YACD,OAAM;QACP,CAAC;QAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YAChE,CAAC;YACD,MAAM,EAAE,GAAG,QAAQ,CAAA;YACnB,MAAM,IAAI,GAAG,SAAS,CAAA;YACtB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAA;YAC1D,CAAC;YACD,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;YAClC,OAAM;QACP,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAA;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS;YACxB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACtB,CAAC,CAAC,IAAI,CAAC,OAAO;gBACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;QACjF,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAA;QAC1D,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;IACnC,CAAC;IAED,UAAU,CAAC,EAAU;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;CACD"}
+{"version":3,"file":"ManagedRegistry.js","sourceRoot":"","sources":["../../src/registry/ManagedRegistry.ts"],"names":[],"mappings":"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"}

package/dist/registry/command/index-exports.d.ts

@@ -0,0 +1,3 @@
+export { HostCommandNameCollisionError, HostCommandRegistry } from './index.js';
+export { kernelHostCommands } from './kernel-commands.js';
+//# sourceMappingURL=index-exports.d.ts.map

package/dist/registry/command/index-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-exports.d.ts","sourceRoot":"","sources":["../../../src/registry/command/index-exports.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/registry/command/index-exports.js

@@ -0,0 +1,5 @@
+// One import site for the public barrel, so `registry/index.ts` stays the
+// package-internal entry and `public-runtime.ts` does not reach past it.
+export { HostCommandNameCollisionError, HostCommandRegistry } from './index.js';
+export { kernelHostCommands } from './kernel-commands.js';
+//# sourceMappingURL=index-exports.js.map

package/dist/registry/command/index-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-exports.js","sourceRoot":"","sources":["../../../src/registry/command/index-exports.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/registry/command/index.d.ts

@@ -0,0 +1,53 @@
+import type { HostCommandContext, HostCommandDescriptor, HostCommandOutcome, SerializableHostCommand } from '../../types/command/index.js';
+import { ManagedRegistry } from '../ManagedRegistry.js';
+/**
+ * A second command claiming a name that is already taken.
+ *
+ * Its own class rather than a bare `Error`, for the reason
+ * `ToolNameCollisionError` gives: a host that wants to decide what to do —
+ * skip, rename, refuse to boot — has to catch it narrowly instead of
+ * matching on message text.
+ */
+export declare class HostCommandNameCollisionError extends Error {
+    readonly commandName: string;
+    constructor(commandName: string);
+}
+/**
+ * The commands a host offers its operator, held where the kernel can fill
+ * them.
+ *
+ * `ManagedRegistry` for the id handling and the logging, with the
+ * collision policy tightened: the base class WARNS and overwrites, which is
+ * right for a tool roster a host assembles deliberately and wrong here.
+ * These are operator-facing, and a shadowed command is invisible — it does
+ * not fail, it simply never runs, and the one that wins depends on
+ * registration order. `ToolRegistry` reaches the same conclusion for the
+ * same reason one directory over.
+ */
+export declare class HostCommandRegistry extends ManagedRegistry<HostCommandDescriptor> {
+    constructor(logger?: ConstructorParameters<typeof ManagedRegistry>[0]['logger']);
+    register(id: string, item: HostCommandDescriptor): void;
+    register(item: HostCommandDescriptor): void;
+    register(items: HostCommandDescriptor[]): void;
+    /**
+     * Run a command line, or say this is not one of ours.
+     *
+     * `undefined` for an unknown name, and that is not the same as
+     * `refused`. A host layers its own commands under the kernel's — an
+     * operator's `.md` files, a TUI's `/clear` — and needs "not mine, keep
+     * looking" to be distinguishable from "mine, and no". Collapsing the two
+     * makes every host command below this registry unreachable.
+     */
+    dispatch(raw: string, ctx?: Partial<HostCommandContext>): Promise<HostCommandOutcome | undefined>;
+    /**
+     * Every command, without its handler.
+     *
+     * Stripped rather than merely "not usually read": this is what crosses a
+     * process boundary, and a function-valued key survives neither
+     * `JSON.stringify` nor `structuredClone` — the first drops it silently,
+     * the second throws. Removing it here means a host gets the same
+     * descriptor either way.
+     */
+    describe(): readonly SerializableHostCommand[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/command/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;;;GAOG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,WAAW,EAAE,MAAM;CAO/B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,eAAe,CAAC,qBAAqB,CAAC;gBAClE,MAAM,CAAC,EAAE,qBAAqB,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAItE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI;IACvD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAC3C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAmBvD;;;;;;;;OAQG;IACG,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAC/B,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAY1C;;;;;;;;OAQG;IACH,QAAQ,IAAI,SAAS,uBAAuB,EAAE;CAK9C"}

package/dist/registry/command/index.js

@@ -0,0 +1,87 @@
+import { ManagedRegistry } from '../ManagedRegistry.js';
+/**
+ * A second command claiming a name that is already taken.
+ *
+ * Its own class rather than a bare `Error`, for the reason
+ * `ToolNameCollisionError` gives: a host that wants to decide what to do —
+ * skip, rename, refuse to boot — has to catch it narrowly instead of
+ * matching on message text.
+ */
+export class HostCommandNameCollisionError extends Error {
+    commandName;
+    constructor(commandName) {
+        super(`Host command "/${commandName}" is already registered. Two commands answering to one name shadow each other silently, and which one wins depends on registration order.`);
+        this.name = 'HostCommandNameCollisionError';
+        this.commandName = commandName;
+    }
+}
+/**
+ * The commands a host offers its operator, held where the kernel can fill
+ * them.
+ *
+ * `ManagedRegistry` for the id handling and the logging, with the
+ * collision policy tightened: the base class WARNS and overwrites, which is
+ * right for a tool roster a host assembles deliberately and wrong here.
+ * These are operator-facing, and a shadowed command is invisible — it does
+ * not fail, it simply never runs, and the one that wins depends on
+ * registration order. `ToolRegistry` reaches the same conclusion for the
+ * same reason one directory over.
+ */
+export class HostCommandRegistry extends ManagedRegistry {
+    constructor(logger) {
+        super({ componentName: 'host-commands', idField: 'name', ...(logger ? { logger } : {}) });
+    }
+    register(idOrItem, maybeItem) {
+        if (Array.isArray(idOrItem)) {
+            for (const item of idOrItem)
+                this.register(item);
+            return;
+        }
+        const name = typeof idOrItem === 'string' ? idOrItem : idOrItem.name;
+        if (this.has(name))
+            throw new HostCommandNameCollisionError(name);
+        if (typeof idOrItem === 'string') {
+            if (!maybeItem)
+                throw new Error('register(id, item) requires an item argument');
+            super.register(idOrItem, maybeItem);
+            return;
+        }
+        super.register(idOrItem);
+    }
+    /**
+     * Run a command line, or say this is not one of ours.
+     *
+     * `undefined` for an unknown name, and that is not the same as
+     * `refused`. A host layers its own commands under the kernel's — an
+     * operator's `.md` files, a TUI's `/clear` — and needs "not mine, keep
+     * looking" to be distinguishable from "mine, and no". Collapsing the two
+     * makes every host command below this registry unreachable.
+     */
+    async dispatch(raw, ctx) {
+        const trimmed = raw.trim();
+        if (!trimmed.startsWith('/'))
+            return undefined;
+        const [name, ...args] = trimmed.slice(1).split(/\s+/);
+        if (!name)
+            return undefined;
+        const command = this.get(name);
+        if (!command)
+            return undefined;
+        return command.handler({ args: ctx?.args ?? args });
+    }
+    /**
+     * Every command, without its handler.
+     *
+     * Stripped rather than merely "not usually read": this is what crosses a
+     * process boundary, and a function-valued key survives neither
+     * `JSON.stringify` nor `structuredClone` — the first drops it silently,
+     * the second throws. Removing it here means a host gets the same
+     * descriptor either way.
+     */
+    describe() {
+        return this.getAll()
+            .map(({ handler: _handler, ...rest }) => rest)
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/registry/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/command/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC9C,WAAW,CAAQ;IAE5B,YAAY,WAAmB;QAC9B,KAAK,CACJ,kBAAkB,WAAW,2IAA2I,CACxK,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAA;QAC3C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAC/B,CAAC;CACD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAsC;IAC9E,YAAY,MAAmE;QAC9E,KAAK,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1F,CAAC;IAKQ,QAAQ,CAChB,QAAkE,EAClE,SAAiC;QAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChD,OAAM;QACP,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAA;QACpE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,6BAA6B,CAAC,IAAI,CAAC,CAAA;QACjE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YAC/E,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YACnC,OAAM;QACP,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CACb,GAAW,EACX,GAAiC;QAEjC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAA;QAC9C,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACrD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAA;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAE9B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;QACP,OAAO,IAAI,CAAC,MAAM,EAAE;aAClB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;aAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/C,CAAC;CACD"}

package/dist/registry/command/kernel-commands.d.ts

@@ -0,0 +1,32 @@
+import type { HostCommandDescriptor } from '../../types/command/index.js';
+import type { Skill } from '../../types/skills/index.js';
+import type { TaskStore } from '../../types/task/index.js';
+/**
+ * The commands whose facts the kernel already owns.
+ *
+ * A registry with nothing in it is a declaration, and this repo has a rule
+ * about those. These two are the ones a host currently has to reach into
+ * kernel internals to answer: what work is tracked, and who this run may
+ * delegate to. Both were already computed here and had no way out that did
+ * not go through a specific host's UI code.
+ *
+ * Deliberately NOT here: anything that would need a decision the kernel
+ * cannot make. `/clear` is about a transcript a host owns, `/login` about
+ * credentials a host stores, `/model` about a picker a host draws. Adding
+ * them would mean the SDK either rendering or refusing, and both are worse
+ * than leaving the command with the host that can actually do it.
+ */
+export interface KernelCommandOptions {
+    /** Absent is a real state — not every run tracks tasks. */
+    readonly taskStore?: TaskStore;
+    readonly allowedAgentIds?: readonly string[];
+    /**
+     * The run's skills, for the operator-facing half of the listing.
+     *
+     * Absent is a real state: a run with no skills registry has none, which
+     * is different from having none registered.
+     */
+    readonly skills?: readonly Skill[];
+}
+export declare function kernelHostCommands(options: KernelCommandOptions): HostCommandDescriptor[];
+//# sourceMappingURL=kernel-commands.d.ts.map

package/dist/registry/command/kernel-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-commands.d.ts","sourceRoot":"","sources":["../../../src/registry/command/kernel-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,oBAAoB;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAA;CAClC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,EAAE,CA2EzF"}

package/dist/registry/command/kernel-commands.js

@@ -0,0 +1,78 @@
+import { isInvocableBy, skillInvocation } from '../../types/skills/index.js';
+export function kernelHostCommands(options) {
+    return [
+        {
+            name: 'tasks',
+            description: 'List the work this run is tracking.',
+            hint: 'id, status, owner and subject for every task in the store',
+            async handler() {
+                // REFUSED rather than an empty report. "There are no tasks" and
+                // "this run has no task store" are different answers, and a host
+                // that shows the first for the second gives an operator a
+                // confident zero nobody computed.
+                if (!options.taskStore) {
+                    return {
+                        kind: 'refused',
+                        reason: 'This run has no task store, so there is nothing to list.',
+                    };
+                }
+                const tasks = await options.taskStore.list();
+                return {
+                    kind: 'report',
+                    title: 'Tasks',
+                    rows: tasks.map((task) => ({
+                        id: task.id,
+                        status: task.status,
+                        owner: task.owner ?? null,
+                        subject: task.subject,
+                    })),
+                };
+            },
+        },
+        {
+            name: 'skills',
+            description: 'List the skills an operator may invoke.',
+            hint: 'name, description and policy for every operator-invocable skill',
+            handler() {
+                // Operator-invocable only, which is the point of the split: the
+                // model's manifest and the operator's menu are different lists
+                // drawn from one registry, and a `/skills` that showed
+                // model-only guidance would offer an operator something there
+                // is no way to run.
+                if (!options.skills) {
+                    return {
+                        kind: 'refused',
+                        reason: 'This run has no skills registry, so there is nothing to list.',
+                    };
+                }
+                return {
+                    kind: 'report',
+                    title: 'Skills',
+                    rows: options.skills
+                        .filter((skill) => isInvocableBy(skill, 'operator'))
+                        .map((skill) => ({
+                        name: skill.metadata.name,
+                        description: skill.metadata.description,
+                        invocation: skillInvocation(skill),
+                    })),
+                };
+            },
+        },
+        {
+            name: 'agents',
+            description: 'List the agents this run may delegate to.',
+            hint: 'the roster, as the delegation tools see it',
+            handler() {
+                // An empty roster IS the answer here, unlike the store above: the
+                // question is "who may I call", and "nobody" is a complete and
+                // correct reply that a run with delegation off should get.
+                return {
+                    kind: 'report',
+                    title: 'Agents',
+                    rows: (options.allowedAgentIds ?? []).map((id) => ({ id })),
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=kernel-commands.js.map

package/dist/registry/command/kernel-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-commands.js","sourceRoot":"","sources":["../../../src/registry/command/kernel-commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAgC5E,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC/D,OAAO;QACN;YACC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,qCAAqC;YAClD,IAAI,EAAE,2DAA2D;YACjE,KAAK,CAAC,OAAO;gBACZ,gEAAgE;gBAChE,iEAAiE;gBACjE,0DAA0D;gBAC1D,kCAAkC;gBAClC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBACxB,OAAO;wBACN,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,0DAA0D;qBAClE,CAAA;gBACF,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;gBAC5C,OAAO;oBACN,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;wBACX,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;wBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;qBACrB,CAAC,CAAC;iBACH,CAAA;YACF,CAAC;SACD;QACD;YACC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,IAAI,EAAE,iEAAiE;YACvE,OAAO;gBACN,gEAAgE;gBAChE,+DAA+D;gBAC/D,uDAAuD;gBACvD,8DAA8D;gBAC9D,oBAAoB;gBACpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACrB,OAAO;wBACN,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,+DAA+D;qBACvE,CAAA;gBACF,CAAC;gBACD,OAAO;oBACN,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,OAAO,CAAC,MAAM;yBAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;yBACnD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBAChB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;wBACzB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;wBACvC,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC;qBAClC,CAAC,CAAC;iBACJ,CAAA;YACF,CAAC;SACD;QACD;YACC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2CAA2C;YACxD,IAAI,EAAE,4CAA4C;YAClD,OAAO;gBACN,kEAAkE;gBAClE,+DAA+D;gBAC/D,2DAA2D;gBAC3D,OAAO;oBACN,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;iBAC3D,CAAA;YACF,CAAC;SACD;KACD,CAAA;AACF,CAAC"}

package/dist/registry/connector/scoped.d.ts

@@ -1,9 +1,10 @@
 import type { ResolvedConnectorConfig, ScopeChain, ScopeRef, ScopedConnectorConfig } from '../../types/connector/index.js';
 import type { ConnectorId } from '../../types/ids/index.js';
+import { type Logger } from '../../utils/logger.js';
 export declare class ScopedConnectorRegistry {
     private configs;
     private log;
-    constructor();
+    constructor(log?: Logger);
     set(config: ScopedConnectorConfig): void;
     remove(scope: ScopeRef, connectorId: ConnectorId): boolean;
     getAt(scope: ScopeRef, connectorId: ConnectorId): ScopedConnectorConfig | undefined;

package/dist/registry/connector/scoped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoped.d.ts","sourceRoot":"","sources":["../../../src/registry/connector/scoped.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIX,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,qBAAqB,EACrB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAO3D,qBAAa,uBAAuB;IACnC,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,GAAG,CAAQ;;IAMnB,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAMxC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO;IAS1D,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,qBAAqB,GAAG,SAAS;IAInF,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,uBAAuB,GAAG,SAAS;IAkBzF,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,qBAAqB,EAAE;IAUnE,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,qBAAqB,EAAE;IAWrD,OAAO,CAAC,WAAW;CA8CnB"}
+{"version":3,"file":"scoped.d.ts","sourceRoot":"","sources":["../../../src/registry/connector/scoped.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIX,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,qBAAqB,EACrB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAMlE,qBAAa,uBAAuB;IACnC,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,GAAG,CAAQ;gBAEP,GAAG,CAAC,EAAE,MAAM;IAIxB,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAMxC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO;IAS1D,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,qBAAqB,GAAG,SAAS;IAInF,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,uBAAuB,GAAG,SAAS;IAkBzF,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,qBAAqB,EAAE;IAUnE,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,qBAAqB,EAAE;IAWrD,OAAO,CAAC,WAAW;CA8CnB"}

package/dist/registry/connector/scoped.js

@@ -1,24 +1,25 @@
 import { CONNECTOR_SCOPE_ORDER } from '../../types/connector/index.js';
-import { getRootLogger } from '../../utils/logger.js';
+import { SCOPE_ATTRIBUTE } from '../../utils/log/types.js';
+import { resolveLogger } from '../../utils/logger.js';
 function scopeKey(scope, scopeId, connectorId) {
     return `${scope}:${scopeId}:${connectorId}`;
 }
 export class ScopedConnectorRegistry {
     configs = new Map();
     log;
-    constructor() {
-        this.log = getRootLogger().child({ component: 'ScopedConnectorRegistry' });
+    constructor(log) {
+        this.log = resolveLogger(log).child({ [SCOPE_ATTRIBUTE]: 'registry/connector/scoped' });
     }
     set(config) {
         const key = scopeKey(config.scope.scope, config.scope.scopeId, config.connectorId);
         this.configs.set(key, config);
-        this.log.info(`Scoped config set: ${key}`);
+        this.log.info('Scoped config set', { 'namzu.connector.scope_key': key });
     }
     remove(scope, connectorId) {
         const key = scopeKey(scope.scope, scope.scopeId, connectorId);
         const removed = this.configs.delete(key);
         if (removed) {
-            this.log.info(`Scoped config removed: ${key}`);
+            this.log.info('Scoped config removed', { 'namzu.connector.scope_key': key });
         }
         return removed;
     }

package/dist/registry/connector/scoped.js.map

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

package/dist/registry/index.d.ts

@@ -1,4 +1,4 @@
-export { Registry } from './Registry.js';
+export { BaseRegistry } from './BaseRegistry.js';
 export { ManagedRegistry } from './ManagedRegistry.js';
 export type { ManagedRegistryConfig } from './ManagedRegistry.js';
 export { ToolNameCollisionError, ToolRegistry } from './tool/execute.js';
@@ -9,4 +9,7 @@ export { ConnectorRegistry } from './connector/definitions.js';
 export { ScopedConnectorRegistry } from './connector/scoped.js';
 export { AgentRegistry } from './agent/definitions.js';
 export { PluginRegistry } from './plugin/index.js';
+export { HostCommandNameCollisionError, HostCommandRegistry } from './command/index.js';
+export { kernelHostCommands } from './command/kernel-commands.js';
+export type { KernelCommandOptions } from './command/kernel-commands.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EACN,WAAW,EACX,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EACN,WAAW,EACX,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIlD,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/registry/index.js

@@ -1,4 +1,4 @@
-export { Registry } from './Registry.js';
+export { BaseRegistry } from './BaseRegistry.js';
 export { ManagedRegistry } from './ManagedRegistry.js';
 export { ToolNameCollisionError, ToolRegistry } from './tool/execute.js';
 export { ToolCatalog, createToolCatalogFromRegistry, loadingFromAvailability, toolDefinitionToCatalogEntry, } from './toolset/catalog.js';
@@ -6,4 +6,8 @@ export { ConnectorRegistry } from './connector/definitions.js';
 export { ScopedConnectorRegistry } from './connector/scoped.js';
 export { AgentRegistry } from './agent/definitions.js';
 export { PluginRegistry } from './plugin/index.js';
+// Commands a HOST offers its operator — never model-visible, and not tools.
+// The whole vocabulary used to be a literal array in one host's TUI module.
+export { HostCommandNameCollisionError, HostCommandRegistry } from './command/index.js';
+export { kernelHostCommands } from './command/kernel-commands.js';
 //# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAExE,OAAO,EACN,WAAW,EACX,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAExE,OAAO,EACN,WAAW,EACX,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,4EAA4E;AAC5E,4EAA4E;AAC5E,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/registry/tool/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/registry/tool/execute.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAElB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIvD,YAAY,EAAE,mBAAmB,EAAE,CAAA;AAmCnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAA;AAExD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASjD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAO7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC/C,MAAM,CAGR;AAED,qBAAa,YAAa,SAAQ,eAAe,CAAC,cAAc,CAAC;IAChE,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAoC;gBAEjD,MAAM,CAAC,EAAE,kBAAkB;IAM9B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI;IACrE,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI;IA2BjF,OAAO,CAAC,WAAW;IAsCV,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK/B,KAAK,IAAI,IAAI;IAKtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ/B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ5B,UAAU,IAAI,IAAI;IASlB,YAAY,IAAI,OAAO;IAOvB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAI/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAkC/C,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAelD,cAAc,IAAI,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM,EAAE;IAIrB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAuC7C,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAwBjD,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAIlD,OAAO,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC;IAuP/B,OAAO,CAAC,iBAAiB;CAIzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAO9E"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/registry/tool/execute.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAElB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIvD,YAAY,EAAE,mBAAmB,EAAE,CAAA;AAmCnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAA;AAExD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASjD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAO7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC/C,MAAM,CAGR;AAED,qBAAa,YAAa,SAAQ,eAAe,CAAC,cAAc,CAAC;IAChE,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAoC;gBAEjD,MAAM,CAAC,EAAE,kBAAkB;IAM9B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI;IACrE,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI;IA2BjF,OAAO,CAAC,WAAW;IAsCV,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK/B,KAAK,IAAI,IAAI;IAKtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ/B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ5B,UAAU,IAAI,IAAI;IASlB,YAAY,IAAI,OAAO;IAOvB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAI/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAkC/C,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAelD,cAAc,IAAI,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM,EAAE;IAIrB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAuC7C,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAwBjD,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAIlD,OAAO,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC;IA0P/B,OAAO,CAAC,iBAAiB;CAIzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAO9E"}

package/dist/registry/tool/execute.js

@@ -179,14 +179,14 @@ export class ToolRegistry extends ManagedRegistry {
         for (const name of names) {
             this.getOrThrow(name);
             this.availability.set(name, 'active');
-            this.log.debug(`Tool activated: ${name}`);
+            this.log.debug('Tool activated', { 'namzu.tool.name': name });
         }
     }
     defer(names) {
         for (const name of names) {
             this.getOrThrow(name);
             this.availability.set(name, 'deferred');
-            this.log.debug(`Tool deferred: ${name}`);
+            this.log.debug('Tool deferred', { 'namzu.tool.name': name });
         }
     }
     suspendAll() {
@@ -403,8 +403,8 @@ Executable tool names, descriptions, and JSON input schemas are attached through
                 if (allowed !== undefined && !allowed.includes(toolName)) {
                     const msg = `Tool "${toolName}" is not available on this step. Available: ${allowed.length > 0 ? allowed.join(', ') : '(none)'}`;
                     this.log.warn('Blocked a tool outside the step allow-list', {
-                        tool: toolName,
-                        allowed: allowed.length,
+                        [GENAI.TOOL_NAME]: toolName,
+                        'namzu.registry.allowed': allowed.length,
                     });
                     span.setAttributes({
                         [NAMZU.TOOL_SUCCESS]: false,
@@ -468,9 +468,10 @@ Executable tool names, descriptions, and JSON input schemas are attached through
                     const enrichedMessage = isEmptyInput
                         ? `Tool "${toolName}" was called with no arguments. ${requiredHint}${recoveryHint} Retry the call with the required parameters populated.`
                         : `Validation failed for "${toolName}": ${errorMessage}. ${requiredHint}${recoveryHint}`;
-                    this.log.error(`Tool input validation failed: ${toolName}`, {
-                        errors: errorMessage,
-                        empty: isEmptyInput,
+                    this.log.error('Tool input validation failed', {
+                        'namzu.tool.name': toolName,
+                        'namzu.registry.errors': errorMessage,
+                        'namzu.registry.empty': isEmptyInput,
                     });
                     span.setAttributes({
                         [NAMZU.TOOL_SUCCESS]: false,
@@ -485,7 +486,7 @@ Executable tool names, descriptions, and JSON input schemas are attached through
                 }
                 const finalInput = parseResult.data;
                 try {
-                    this.log.debug(`Executing tool: ${toolName}`);
+                    this.log.debug('Executing tool', { 'namzu.tool.name': toolName });
                     const startedAt = Date.now();
                     const produced = await tool.execute(finalInput, context);
                     // Screened here, which is the only place a result can be
@@ -502,8 +503,9 @@ Executable tool names, descriptions, and JSON input schemas are attached through
                         ...(tool.provenance ? { provenance: tool.provenance } : {}),
                     }, this.log);
                     const durationMs = Date.now() - startedAt;
-                    this.log.debug(`Tool completed: ${toolName}`, {
-                        success: result.success,
+                    this.log.debug('Tool completed', {
+                        'namzu.tool.name': toolName,
+                        'namzu.registry.success': result.success,
                     });
                     span.setAttribute(NAMZU.TOOL_SUCCESS, result.success);
                     recordToolCall(toolName, result.success, result.success ? undefined : result.error, durationMs);
@@ -532,8 +534,9 @@ Executable tool names, descriptions, and JSON input schemas are attached through
                         throw err;
                     }
                     const errorMessage = toErrorMessage(err);
-                    this.log.error(`Tool execution error: ${toolName}`, {
-                        error: errorMessage,
+                    this.log.error('Tool execution error', {
+                        'namzu.tool.name': toolName,
+                        'exception.message': errorMessage,
                     });
                     span.setAttributes({
                         [NAMZU.TOOL_SUCCESS]: false,