@namzu/cli 29.1.0 → 32.0.0

package/dist/skills/directory.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The directory the model can open for a skill, in this CLI.
+ *
+ * The `skill` tool loads a body from the path the CLI discovered it at, and a
+ * body that says "run scripts/render.sh" needs a directory the model's own
+ * tools can open. On the host that is the same path. Inside the sandbox it
+ * is only sometimes: the local sandbox mounts its root (the working directory,
+ * or a disposable directory for an `ephemeral` workspace) and, with the
+ * working directory, the added directories, each at its own canonical path,
+ * and nothing else. The sandbox's file API refuses every other path, links
+ * followed. So:
+ *
+ *   - a project skill (`<cwd>/.namzu/skills`, `<cwd>/.agents/skills`,
+ *     `<cwd>/skills`) is reachable, and so is one under an added directory;
+ *   - a user skill (`~/.namzu/skills`, `~/.agents/skills`), a built-in skill
+ *     (inside the installed package), a plugin skill outside the project, one
+ *     in `.agents/skills` above `<cwd>`, and a project skill whose directory
+ *     is a link to somewhere unmounted are not, and are answered `undefined`
+ *     rather than with a path that would fail;
+ *   - under an `ephemeral` workspace nothing of the host is mounted, so every
+ *     skill is `undefined`.
+ *
+ * The bwrap tier also binds `/usr`, `/opt` and the Node prefix read-only for
+ * commands to run. A built-in skill of a CLI installed under one of them can
+ * be `cat` from `bash` there, but the `read` tool refuses it and the macOS
+ * and namespace tiers differ again, so it is not offered as reachable.
+ */
+import { type SkillDirectoryResolver } from '@namzu/sdk';
+export interface SkillDirectoryResolverOptions {
+    /**
+     * The directories the sandbox mounts at their own paths besides its root,
+     * read on every call so `/add-dir` counts. Empty for an `ephemeral`
+     * workspace, which mounts none of them.
+     */
+    readonly sandboxMounts: () => readonly string[];
+}
+export declare function createSkillDirectoryResolver(options: SkillDirectoryResolverOptions): SkillDirectoryResolver;
+//# sourceMappingURL=directory.d.ts.map

package/dist/skills/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/skills/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,KAAK,sBAAsB,EAAqB,MAAM,YAAY,CAAA;AAE3E,MAAM,WAAW,6BAA6B;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,SAAS,MAAM,EAAE,CAAA;CAC/C;AAED,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,6BAA6B,GACpC,sBAAsB,CAkBxB"}

package/dist/skills/directory.js

@@ -0,0 +1,51 @@
+/**
+ * The directory the model can open for a skill, in this CLI.
+ *
+ * The `skill` tool loads a body from the path the CLI discovered it at, and a
+ * body that says "run scripts/render.sh" needs a directory the model's own
+ * tools can open. On the host that is the same path. Inside the sandbox it
+ * is only sometimes: the local sandbox mounts its root (the working directory,
+ * or a disposable directory for an `ephemeral` workspace) and, with the
+ * working directory, the added directories, each at its own canonical path,
+ * and nothing else. The sandbox's file API refuses every other path, links
+ * followed. So:
+ *
+ *   - a project skill (`<cwd>/.namzu/skills`, `<cwd>/.agents/skills`,
+ *     `<cwd>/skills`) is reachable, and so is one under an added directory;
+ *   - a user skill (`~/.namzu/skills`, `~/.agents/skills`), a built-in skill
+ *     (inside the installed package), a plugin skill outside the project, one
+ *     in `.agents/skills` above `<cwd>`, and a project skill whose directory
+ *     is a link to somewhere unmounted are not, and are answered `undefined`
+ *     rather than with a path that would fail;
+ *   - under an `ephemeral` workspace nothing of the host is mounted, so every
+ *     skill is `undefined`.
+ *
+ * The bwrap tier also binds `/usr`, `/opt` and the Node prefix read-only for
+ * commands to run. A built-in skill of a CLI installed under one of them can
+ * be `cat` from `bash` there, but the `read` tool refuses it and the macOS
+ * and namespace tiers differ again, so it is not offered as reachable.
+ */
+import { resolveWithinReal } from '@namzu/sdk';
+export function createSkillDirectoryResolver(options) {
+    return async (skill, context) => {
+        if (skill.directory === undefined)
+            return undefined;
+        // On the host the model's tools open the path the CLI read the skill
+        // from: a path outside the working directory is a permission question,
+        // not a wall.
+        if (!context.sandbox)
+            return skill.directory;
+        for (const root of [context.sandbox.rootDir, ...options.sandboxMounts()]) {
+            try {
+                // Canonical, because that is the path each root is mounted at;
+                // a link out of the root throws, and its target is not mounted.
+                return await resolveWithinReal(root, skill.directory);
+            }
+            catch {
+                // Not under this root; try the next.
+            }
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=directory.js.map

package/dist/skills/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/skills/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAA+B,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAW3E,MAAM,UAAU,4BAA4B,CAC3C,OAAsC;IAEtC,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACnD,qEAAqE;QACrE,uEAAuE;QACvE,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,SAAS,CAAA;QAC5C,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACJ,+DAA+D;gBAC/D,gEAAgE;gBAChE,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;YACtD,CAAC;YAAC,MAAM,CAAC;gBACR,qCAAqC;YACtC,CAAC;QACF,CAAC;QACD,OAAO,SAAS,CAAA;IACjB,CAAC,CAAA;AACF,CAAC"}

package/dist/test-support/toolset.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Test-only toolset builders, replacing the pattern CLI tests used to repeat
+ * by hand: `const registry = new ToolRegistry(); registry.register(a);
+ * registry.register(b)`.
+ *
+ * `ToolRegistry` is gone (plan.md v3 §2); a test that only wants to hand
+ * `createAgentSession`/a mocked `query()`/a sub-agent's `buildTools` a fixed
+ * set of tools now builds a `Toolset` (or a `ToolManager` over one, when the
+ * test also needs `.get`/`.has`/`.sourceOf`/`.execute`) instead. Mirrors
+ * `@namzu/sdk`'s own `test-support/toolset.ts`, kept as a separate file here
+ * because this package cannot import the SDK's `src/test-support` (it is not
+ * part of the published package).
+ */
+import { type ToolDefinition, ToolManager, type Toolset } from '@namzu/sdk';
+/** A plain, all-active `Toolset` named `'test'`, from a fixed list of tools. */
+export declare function testToolset(...tools: readonly ToolDefinition[]): Toolset;
+/**
+ * A `ToolManager` over a single `'test'` toolset — for a test that needs the
+ * execution pipeline (`.execute`/`.prepareExecution`) or the read surface
+ * (`.get`/`.has`/`.sourceOf`/`.listNames`) a bare `Toolset` does not have.
+ */
+export declare function testToolManager(...tools: readonly ToolDefinition[]): ToolManager;
+//# sourceMappingURL=toolset.d.ts.map

package/dist/test-support/toolset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../../src/test-support/toolset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAE,WAAW,EAAE,KAAK,OAAO,EAAW,MAAM,YAAY,CAAA;AAEpF,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,CAEhF"}

package/dist/test-support/toolset.js

@@ -0,0 +1,27 @@
+/**
+ * Test-only toolset builders, replacing the pattern CLI tests used to repeat
+ * by hand: `const registry = new ToolRegistry(); registry.register(a);
+ * registry.register(b)`.
+ *
+ * `ToolRegistry` is gone (plan.md v3 §2); a test that only wants to hand
+ * `createAgentSession`/a mocked `query()`/a sub-agent's `buildTools` a fixed
+ * set of tools now builds a `Toolset` (or a `ToolManager` over one, when the
+ * test also needs `.get`/`.has`/`.sourceOf`/`.execute`) instead. Mirrors
+ * `@namzu/sdk`'s own `test-support/toolset.ts`, kept as a separate file here
+ * because this package cannot import the SDK's `src/test-support` (it is not
+ * part of the published package).
+ */
+import { ToolManager, toolset } from '@namzu/sdk';
+/** A plain, all-active `Toolset` named `'test'`, from a fixed list of tools. */
+export function testToolset(...tools) {
+    return toolset('test', tools);
+}
+/**
+ * A `ToolManager` over a single `'test'` toolset — for a test that needs the
+ * execution pipeline (`.execute`/`.prepareExecution`) or the read surface
+ * (`.get`/`.has`/`.sourceOf`/`.listNames`) a bare `Toolset` does not have.
+ */
+export function testToolManager(...tools) {
+    return new ToolManager({ toolsets: [testToolset(...tools)], messages: () => [] });
+}
+//# sourceMappingURL=toolset.js.map

package/dist/test-support/toolset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset.js","sourceRoot":"","sources":["../../src/test-support/toolset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAuB,WAAW,EAAgB,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpF,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,GAAG,KAAgC;IAC9D,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAG,KAAgC;IAClE,OAAO,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AAClF,CAAC"}

package/dist/tui/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/tui/App.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAON,KAAK,OAAO,EAmBZ,MAAM,YAAY,CAAA;AAkMnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AA8DvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAa/D,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IAC1D,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAA;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,CAAA;CAC3D;AASD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC5B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAmSrB,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,MAAM,EAAE,CAM7F;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,EAAE,MAAM,MAAM,EACpB,iBAAiB,GAAE,SAAS,MAAM,EAAO,GACvC,SAAS,iBAAiB,EAAE,CAqE9B;AAsHD,wBAAgB,GAAG,CAAC,EACnB,GAAG,EAAE,UAAU,EACf,aAAa,EACb,cAAsC,EACtC,eAAe,GACf,EAAE,QAAQ,2CA4oQV"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/tui/App.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAON,KAAK,OAAO,EAmBZ,MAAM,YAAY,CAAA;AAsNnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AA8DvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAa/D,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IAC1D,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAA;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,CAAA;CAC3D;AASD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC5B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAuSrB,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,MAAM,EAAE,CAM7F;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,EAAE,MAAM,MAAM,EACpB,iBAAiB,GAAE,SAAS,MAAM,EAAO,GACvC,SAAS,iBAAiB,EAAE,CAqE9B;AA2HD,wBAAgB,GAAG,CAAC,EACnB,GAAG,EAAE,UAAU,EACf,aAAa,EACb,cAAsC,EACtC,eAAe,GACf,EAAE,QAAQ,2CA88QV"}