@namzu/sdk 5.0.0 → 5.2.0

package/dist/directory/__tests__/load-directory.test.js

@@ -0,0 +1,196 @@
+import { mkdirSync, mkdtempSync, symlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { loadDirectory } from '../load.js';
+/**
+ * Every case builds a real directory and reads it. A fixture object standing
+ * in for the filesystem would pass while the scan, the import and the
+ * containment check all did the wrong thing — and the whole package is those
+ * three things.
+ *
+ * `.js` is used for tool files rather than `.ts`. Node's type stripping is
+ * real and the loader accepts both, but a test that depends on it would be
+ * testing Node's version rather than this code.
+ */
+const CAN_SYMLINK = (() => {
+    try {
+        const probe = mkdtempSync(join(tmpdir(), 'namzu-proj-sym-'));
+        symlinkSync(probe, join(probe, 'self'), 'dir');
+        return true;
+    }
+    catch {
+        return false;
+    }
+})();
+function project(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-proj-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+const TOOL = (name) => `
+export default {
+  name: ${JSON.stringify(name)},
+  description: 'a tool',
+  inputSchema: { parse: (v) => v, safeParse: (v) => ({ success: true, data: v }) },
+  execute: async () => ({ success: true, output: 'ok' }),
+}
+`;
+describe('reading a project directory', () => {
+    it('loads instructions, config and tools', async () => {
+        const root = project({
+            'instructions.md': 'You are helpful.\n',
+            'agent.js': 'export default { model: "m", temperature: 0.2 }',
+            'tools/search.js': TOOL('search'),
+        });
+        const { manifest, ok, diagnostics } = await loadDirectory(root);
+        expect(ok, JSON.stringify(diagnostics)).toBe(true);
+        expect(manifest.instructions).toBe('You are helpful.');
+        expect(manifest.config).toMatchObject({ model: 'm', temperature: 0.2 });
+        expect(manifest.tools.map((t) => t.definition.name)).toEqual(['search']);
+    });
+    it('reports a broken tool instead of dropping it', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/good.js': TOOL('good'),
+            'tools/broken.js': 'this is not valid javascript !!!',
+        });
+        const { manifest, ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        // The good one still loaded — one bad file does not lose the rest.
+        expect(manifest.tools.map((t) => t.definition.name)).toEqual(['good']);
+        const failure = diagnostics.find((d) => d.code === 'module_load_failed');
+        expect(failure?.path).toContain('broken');
+        expect(manifest.sources.find((s) => s.id === 'broken')?.outcome).toBe('failed');
+    });
+    it('refuses both files when two tools claim one name', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/a.js': TOOL('search'),
+            'tools/b.js': TOOL('search'),
+        });
+        const { manifest, ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.some((d) => d.code === 'duplicate_tool_name')).toBe(true);
+        // Picking a winner silently is what hides the mistake.
+        expect(manifest.tools).toHaveLength(1);
+    });
+    it('rejects a default export that is not a tool', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/x.js': 'export default { hello: 1 }',
+        });
+        const { ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.some((d) => d.code === 'not_a_tool')).toBe(true);
+    });
+    it('warns rather than errors when instructions are absent', async () => {
+        // `runAgent` treats instructions as optional; this package does not get
+        // to overrule the kernel about what a valid agent is.
+        const root = project({ 'tools/a.js': TOOL('a') });
+        const { ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(true);
+        expect(diagnostics.find((d) => d.code === 'instructions_missing')?.severity).toBe('warning');
+    });
+    it('errors on an instructions file that says nothing', async () => {
+        const root = project({ 'instructions.md': '   \n' });
+        const { ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.find((d) => d.code === 'instructions_empty')?.severity).toBe('error');
+    });
+    it('reports a malformed config field by name', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: 42 }',
+        });
+        const { ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.find((d) => d.code === 'invalid_config')?.message).toContain('"model"');
+    });
+    it('ignores dot- and underscore-prefixed entries silently', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/real.js': TOOL('real'),
+            'tools/_helpers/util.js': 'export const x = 1',
+            'tools/.hidden.js': TOOL('hidden'),
+        });
+        const { manifest, ok, diagnostics } = await loadDirectory(root);
+        expect(ok).toBe(true);
+        expect(manifest.tools.map((t) => t.definition.name)).toEqual(['real']);
+        expect(diagnostics.some((d) => d.code === 'unscanned_directory')).toBe(false);
+    });
+    it('warns about a subdirectory it did not scan', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/nested/deep.js': TOOL('deep'),
+        });
+        const { diagnostics } = await loadDirectory(root);
+        expect(diagnostics.find((d) => d.code === 'unscanned_directory')?.message).toContain('nested');
+    });
+    it('reports a missing directory rather than throwing', async () => {
+        const { ok, diagnostics } = await loadDirectory(join(tmpdir(), 'namzu-does-not-exist-xyz'));
+        expect(ok).toBe(false);
+        expect(diagnostics[0]?.code).toBe('root_missing');
+    });
+    it('throws only on programmer error', async () => {
+        await expect(loadDirectory('')).rejects.toThrow(TypeError);
+    });
+});
+describe('modules: skip', () => {
+    it('gives full structure without importing anything', async () => {
+        // The proof is the side effect: a module that would throw on import is
+        // listed, and nothing runs.
+        const root = project({
+            'instructions.md': 'You are helpful.',
+            'agent.js': 'throw new Error("agent.js executed")',
+            'tools/a.js': 'throw new Error("tool executed")',
+        });
+        const { manifest, ok } = await loadDirectory(root, { modules: 'skip' });
+        expect(ok).toBe(true);
+        expect(manifest.instructions).toBe('You are helpful.');
+        expect(manifest.sources.map((s) => s.id).sort()).toEqual(['a', 'agent', 'instructions']);
+        expect(manifest.sources
+            .filter((s) => s.slot !== 'instructions')
+            .every((s) => s.outcome === 'not_loaded')).toBe(true);
+        expect(manifest.tools).toHaveLength(0);
+    });
+});
+describe('include is an allow-list', () => {
+    it('scans only what was asked for', async () => {
+        const root = project({ 'instructions.md': 'hi', 'tools/a.js': TOOL('a') });
+        const { manifest } = await loadDirectory(root, { include: ['tools'] });
+        expect(manifest.included).toEqual(['tools']);
+        expect(manifest.instructions).toBe('');
+        expect(manifest.tools).toHaveLength(1);
+    });
+    it('scans nothing when the list is empty', async () => {
+        // An allow-list that admits everything when empty is the fail-open
+        // shape this estate removed elsewhere.
+        const root = project({ 'instructions.md': 'hi', 'tools/a.js': TOOL('a') });
+        const { manifest } = await loadDirectory(root, {
+            include: [],
+        });
+        expect(manifest.sources).toHaveLength(0);
+        expect(manifest.tools).toHaveLength(0);
+    });
+});
+describe('symlinks are refused, not followed', () => {
+    it.skipIf(!CAN_SYMLINK)('does not import a linked tool file', async () => {
+        const outside = mkdtempSync(join(tmpdir(), 'namzu-outside-'));
+        writeFileSync(join(outside, 'evil.js'), TOOL('evil'));
+        const root = project({
+            'instructions.md': 'hi',
+            'tools/real.js': TOOL('real'),
+        });
+        symlinkSync(join(outside, 'evil.js'), join(root, 'tools', 'linked.js'), 'file');
+        const { manifest, diagnostics } = await loadDirectory(root);
+        // The file that would be imported is not the file that was listed.
+        expect(manifest.tools.map((t) => t.definition.name)).toEqual(['real']);
+        expect(diagnostics.some((d) => d.code === 'symlink_refused')).toBe(true);
+    });
+});
+//# sourceMappingURL=load-directory.test.js.map

package/dist/directory/__tests__/load-directory.test.js.map

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

package/dist/directory/__tests__/subagents.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subagents.test.d.ts.map

package/dist/directory/__tests__/subagents.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.test.d.ts","sourceRoot":"","sources":["../../../src/directory/__tests__/subagents.test.ts"],"names":[],"mappings":""}

package/dist/directory/__tests__/subagents.test.js

@@ -0,0 +1,117 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { deriveSupervisorOptions } from '../derive-supervisor.js';
+import { loadDirectory } from '../load.js';
+/**
+ * `SupervisorAgent` needs an `agentIds` roster and a manager that can spawn
+ * them. Nothing led from a directory to either, so a multi-agent system could
+ * be described on disk and not run.
+ *
+ * Delegates are loaded by recursion — a delegate directory has the same shape
+ * as its parent — capped at one level, because how deep a system may fan out
+ * is a topology decision and a directory layout should not make it by default.
+ */
+const provider = { id: 'mock', name: 'Mock' };
+const agentManager = { sendMessage: async () => ({}) };
+function tree(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-sub-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+const TOOL = (name) => `
+export default {
+  name: ${JSON.stringify(name)},
+  description: 'a tool',
+  inputSchema: { parse: (v) => v, safeParse: (v) => ({ success: true, data: v }) },
+  execute: async () => ({ success: true, output: 'ok' }),
+}
+`;
+const SYSTEM = {
+    'instructions.md': 'You coordinate.',
+    'agent.js': 'export default { model: "coordinator-model" }',
+    'agents/researcher/instructions.md': 'You research.',
+    'agents/researcher/agent.js': 'export default { model: "cheap-model" }',
+    'agents/researcher/tools/search.js': TOOL('search'),
+    'agents/writer/instructions.md': 'You write.',
+};
+describe('a project that declares delegates', () => {
+    it('loads each one as a project in its own right', async () => {
+        const { manifest, ok, diagnostics } = await loadDirectory(tree(SYSTEM));
+        expect(ok, JSON.stringify(diagnostics)).toBe(true);
+        expect(manifest.agents.map((a) => a.id).sort()).toEqual(['researcher', 'writer']);
+        const researcher = manifest.agents.find((a) => a.id === 'researcher');
+        expect(researcher?.manifest.instructions).toBe('You research.');
+        expect(researcher?.manifest.tools.map((t) => t.definition.name)).toEqual(['search']);
+        expect(researcher?.manifest.config.model).toBe('cheap-model');
+    });
+    it('surfaces a delegate failure in the parent list', async () => {
+        // A delegate that could not load is a fact about THIS project. A caller
+        // reading one list should not have to walk the tree to discover the run
+        // will be short a specialist.
+        const { manifest, ok, diagnostics } = await loadDirectory(tree({ ...SYSTEM, 'agents/writer/tools/bad.js': 'this is not valid !!!' }));
+        expect(ok).toBe(false);
+        expect(diagnostics.some((d) => d.message.startsWith('agents/writer:'))).toBe(true);
+        // The broken one is not offered as a delegate.
+        expect(manifest.agents.map((a) => a.id)).toEqual(['researcher']);
+    });
+    it('refuses to read a second level of delegates', async () => {
+        const { manifest, diagnostics } = await loadDirectory(tree({
+            ...SYSTEM,
+            'agents/researcher/agents/deeper/instructions.md': 'You are too deep.',
+        }));
+        const researcher = manifest.agents.find((a) => a.id === 'researcher');
+        expect(researcher?.manifest.agents).toHaveLength(0);
+        expect(diagnostics.some((d) => d.code === 'subagent_too_deep')).toBe(true);
+    });
+    it('imports nothing under modules: skip, delegates included', async () => {
+        const { manifest, ok } = await loadDirectory(tree({
+            'instructions.md': 'hi',
+            'agents/x/instructions.md': 'hi',
+            'agents/x/tools/boom.js': 'throw new Error("executed")',
+        }), { modules: 'skip' });
+        expect(ok).toBe(true);
+        expect(manifest.sources.some((s) => s.slot === 'agents')).toBe(true);
+    });
+});
+describe('deriving supervisor options', () => {
+    it('builds the roster from the directory', async () => {
+        const { manifest } = await loadDirectory(tree(SYSTEM));
+        const { config, delegates } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        expect(config.agentIds.sort()).toEqual(['researcher', 'writer']);
+        expect(config.systemPrompt).toBe('You coordinate.');
+        expect(config.model).toBe('coordinator-model');
+        expect(delegates).toHaveLength(2);
+    });
+    it('lets a delegate keep its own model and inherit when it has none', async () => {
+        // A cheap model for a narrow job is the common case; inheriting
+        // unconditionally would bill every specialist at the coordinator rate.
+        const { manifest } = await loadDirectory(tree(SYSTEM));
+        const { delegates } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        expect(delegates.find((d) => d.id === 'researcher')?.model).toBe('cheap-model');
+        expect(delegates.find((d) => d.id === 'writer')?.model).toBe('coordinator-model');
+    });
+    it('carries each delegate its own instructions and tools', async () => {
+        const { manifest } = await loadDirectory(tree(SYSTEM));
+        const { delegates } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        const researcher = delegates.find((d) => d.id === 'researcher');
+        expect(researcher?.systemPrompt).toBe('You research.');
+        expect(researcher?.tools.has('search')).toBe(true);
+    });
+    it('refuses a project with no delegates', async () => {
+        // An empty roster makes create_task unmountable, so the result would be
+        // a coordinator that cannot coordinate — and the caller asked for one.
+        const { manifest } = await loadDirectory(tree({ 'instructions.md': 'hi', 'agent.js': 'export default { model: "m" }' }));
+        expect(() => deriveSupervisorOptions(manifest, { provider, agentManager })).toThrow(/declares no delegates/);
+    });
+    it('refuses a manifest whose modules were never loaded', async () => {
+        const { manifest } = await loadDirectory(tree(SYSTEM), { modules: 'skip' });
+        expect(() => deriveSupervisorOptions(manifest, { provider, agentManager })).toThrow(/modules: "skip"/);
+    });
+});
+//# sourceMappingURL=subagents.test.js.map

package/dist/directory/__tests__/subagents.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.test.js","sourceRoot":"","sources":["../../../src/directory/__tests__/subagents.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;;;;;GAQG;AAEH,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAA;AACtD,MAAM,YAAY,GAAG,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAW,CAAA;AAE/D,SAAS,IAAI,CAAC,KAA6B;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAA;IACtD,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACjC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC1B,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;;UAErB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;CAK7B,CAAA;AAED,MAAM,MAAM,GAAG;IACd,iBAAiB,EAAE,iBAAiB;IACpC,UAAU,EAAE,+CAA+C;IAC3D,mCAAmC,EAAE,eAAe;IACpD,4BAA4B,EAAE,yCAAyC;IACvE,mCAAmC,EAAE,IAAI,CAAC,QAAQ,CAAC;IACnD,+BAA+B,EAAE,YAAY;CAC7C,CAAA;AAED,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAEvE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAA;QAEjF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAA;QACrE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC/D,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpF,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC/D,wEAAwE;QACxE,wEAAwE;QACxE,8BAA8B;QAC9B,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,MAAM,aAAa,CACxD,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,CAAC,CAC1E,CAAA;QAED,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACtB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClF,+CAA+C;QAC/C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,aAAa,CACpD,IAAI,CAAC;YACJ,GAAG,MAAM;YACT,iDAAiD,EAAE,mBAAmB;SACtE,CAAC,CACF,CAAA;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAA;QACrE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,MAAM,aAAa,CAC3C,IAAI,CAAC;YACJ,iBAAiB,EAAE,IAAI;YACvB,0BAA0B,EAAE,IAAI;YAChC,wBAAwB,EAAE,6BAA6B;SACvD,CAAC,EACF,EAAE,OAAO,EAAE,MAAM,EAAE,CACnB,CAAA;QAED,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAEtD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,uBAAuB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;QAE3F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAA;QAChE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC9C,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAChF,gEAAgE;QAChE,uEAAuE;QACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QACtD,MAAM,EAAE,SAAS,EAAE,GAAG,uBAAuB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;QAEnF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC/E,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAClF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QACtD,MAAM,EAAE,SAAS,EAAE,GAAG,uBAAuB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;QAEnF,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAA;QAC/D,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACtD,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACpD,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CACvC,IAAI,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE,+BAA+B,EAAE,CAAC,CAC9E,CAAA;QAED,MAAM,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAClF,uBAAuB,CACvB,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAE3E,MAAM,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAClF,iBAAiB,CACjB,CAAA;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/directory/__tests__/supervisor-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supervisor-budget.test.d.ts.map

package/dist/directory/__tests__/supervisor-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-budget.test.d.ts","sourceRoot":"","sources":["../../../src/directory/__tests__/supervisor-budget.test.ts"],"names":[],"mappings":""}

package/dist/directory/__tests__/supervisor-budget.test.js

@@ -0,0 +1,97 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { deriveSupervisorOptions } from '../derive-supervisor.js';
+import { loadDirectory } from '../load.js';
+/**
+ * `BaseAgentConfig` declares `tokenBudget` and `timeoutMs` as REQUIRED, and
+ * `deriveSupervisorOptions` supplied them only when `agent.ts` happened to
+ * name them — which is the uncommon case. An `as SupervisorAgentConfig` made
+ * that compile, so the returned object was typed `tokenBudget: number` while
+ * holding `undefined`.
+ *
+ * The consequence is not a type-level nicety. `buildLimitConfig` defaults only
+ * `maxIterations`, so an undefined budget and timeout disable BOTH hard stops
+ * — a project-derived supervisor ran with no token cap and no wall clock. And
+ * the child-spawn guard computes a delegate's allocation from the parent
+ * budget, so `undefined` became `NaN`, and `NaN <= 0` is false: the refusal
+ * that exists to stop an unfunded child let it through.
+ *
+ * The cast is now `satisfies`, which is what keeps this from recurring — but
+ * a type check is not a test, so the values are asserted here too.
+ */
+const provider = { id: 'mock', name: 'Mock' };
+const agentManager = { sendMessage: async () => ({}) };
+function tree(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-budget-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+const MINIMAL = {
+    'agent.js': 'export default { model: "m" }',
+    'agents/researcher/agent.js': 'export default { model: "m2" }',
+    'agents/researcher/instructions.md': 'Research things.',
+};
+describe('a derived supervisor always has a budget and a clock', () => {
+    it('defaults both when agent.ts names neither', async () => {
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // The exact numbers matter less than that they are finite: a NaN or an
+        // undefined here is what silently disabled the limits.
+        expect(Number.isFinite(config.tokenBudget)).toBe(true);
+        expect(Number.isFinite(config.timeoutMs)).toBe(true);
+        expect(config.tokenBudget).toBeGreaterThan(0);
+        expect(config.timeoutMs).toBeGreaterThan(0);
+    });
+    it('uses the same defaults the SDK front door uses', async () => {
+        // Imported from the module that owns them rather than through the
+        // package entry: this file now lives inside that package, and a
+        // self-import resolves to the built `dist`, not to the source under
+        // test — which is how a stale build reads as a passing test.
+        const { DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_BUDGET } = await import('../../agents/runAgent.js');
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // Two front doors that default differently is a difference nobody would
+        // find until a run behaved unlike its sibling.
+        expect(config.tokenBudget).toBe(DEFAULT_TOKEN_BUDGET);
+        expect(config.timeoutMs).toBe(DEFAULT_TIMEOUT_MS);
+    });
+    it('still honours what agent.ts declares', async () => {
+        const { manifest } = await loadDirectory(tree({
+            ...MINIMAL,
+            'agent.js': 'export default { model: "m", tokenBudget: 1234, timeoutMs: 5678 }',
+        }));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        expect(config.tokenBudget).toBe(1234);
+        expect(config.timeoutMs).toBe(5678);
+    });
+    it('lets an override win over both', async () => {
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, {
+            provider,
+            agentManager,
+            overrides: { tokenBudget: 42 },
+        });
+        expect(config.tokenBudget).toBe(42);
+    });
+});
+describe('a derived supervisor carries the skills it loaded', () => {
+    it('passes skills through instead of dropping them', async () => {
+        const { manifest } = await loadDirectory(tree({
+            ...MINIMAL,
+            'skills/plan-a-trip/SKILL.md': '---\nname: plan-a-trip\ndescription: Plan a trip\n---\n\nAsk for dates.',
+        }));
+        expect(manifest.skills).toHaveLength(1);
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // Loaded from disk, put on the manifest, and then — before this — left
+        // out of the config the supervisor actually runs with.
+        expect(config.skills).toHaveLength(1);
+        expect(config.skills?.[0]?.metadata.name).toBe('plan-a-trip');
+    });
+});
+//# sourceMappingURL=supervisor-budget.test.js.map

package/dist/directory/__tests__/supervisor-budget.test.js.map

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

package/dist/directory/derive-supervisor.d.ts

@@ -0,0 +1,58 @@
+import type { AgentIdentity } from '../agents/runAgent.js';
+import { ToolRegistry } from '../registry/tool/execute.js';
+import type { SupervisorAgentConfig } from '../types/agent/supervisor.js';
+import type { LLMProvider } from '../types/provider/index.js';
+import type { DirectoryManifest } from './types.js';
+export interface DeriveSupervisorInput {
+    readonly provider: LLMProvider;
+    /** Wins over `agent.ts`. Required when `agent.ts` names no model. */
+    readonly model?: string;
+    readonly identity?: Required<AgentIdentity>;
+    /**
+     * The lifecycle object that actually spawns delegates.
+     *
+     * Supplied by the host and never built here. An `AgentManager` owns
+     * running processes, budgets and cancellation — it is a thing with a
+     * lifetime, not a description of one, and this package's whole boundary is
+     * that it describes and does not run. Handing back options that carry a
+     * manager we constructed would make it a runner wearing a loader's name.
+     */
+    readonly agentManager: SupervisorAgentConfig['agentManager'];
+    readonly overrides?: Partial<SupervisorAgentConfig>;
+}
+export interface SupervisorPlan {
+    /** Ready for `new SupervisorAgent(...).run(input, config)`. */
+    readonly config: SupervisorAgentConfig;
+    /**
+     * What the host must register with its `AgentManager` before running,
+     * one per delegate, keyed by the id the supervisor will name.
+     *
+     * Returned rather than registered: registration is a mutation of the
+     * host's manager, and a function that quietly mutates an object it was
+     * handed for reference is the kind of surprise this package exists to
+     * avoid. The host does it, in one loop it can see.
+     */
+    readonly delegates: readonly DelegatePlan[];
+}
+export interface DelegatePlan {
+    readonly id: string;
+    readonly manifest: DirectoryManifest;
+    /** The delegate's own instructions, tools and model, already assembled. */
+    readonly systemPrompt: string;
+    readonly tools: ToolRegistry;
+    readonly model: string;
+}
+/**
+ * Turn a project that declares delegates into a supervisor configuration.
+ *
+ * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * same contract: it converts, it does not run. `SupervisorAgent` needs an
+ * `agentIds` roster and a manager that can spawn them; this supplies the
+ * roster from the directory and leaves the manager to the host.
+ *
+ * The delegates come back as plans rather than registered agents because
+ * registration mutates the host's manager. Two lines in the host, and the host
+ * can see exactly what it just gained.
+ */
+export declare function deriveSupervisorOptions(manifest: DirectoryManifest, input: DeriveSupervisorInput): SupervisorPlan;
+//# sourceMappingURL=derive-supervisor.d.ts.map

package/dist/directory/derive-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-supervisor.d.ts","sourceRoot":"","sources":["../../src/directory/derive-supervisor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAA;AAElE,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IAC3C;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,cAAc;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,qBAAqB,GAC1B,cAAc,CA+DhB"}

package/dist/directory/derive-supervisor.js

@@ -0,0 +1,88 @@
+import { DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_BUDGET } from '../agents/runAgent.js';
+import { ToolRegistry } from '../registry/tool/execute.js';
+function toolsOf(manifest) {
+    const tools = new ToolRegistry();
+    for (const entry of manifest.tools)
+        tools.register(entry.definition);
+    return tools;
+}
+function delegatePlan(entry, fallbackModel) {
+    return {
+        id: entry.id,
+        manifest: entry.manifest,
+        systemPrompt: entry.manifest.instructions,
+        tools: toolsOf(entry.manifest),
+        // A delegate may name its own model — a cheap one for a narrow job is
+        // the common case — and inherits the supervisor's only when it does
+        // not. Inheriting unconditionally would silently bill every specialist
+        // at the coordinator's rate.
+        model: entry.manifest.config.model ?? fallbackModel,
+    };
+}
+/**
+ * Turn a project that declares delegates into a supervisor configuration.
+ *
+ * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * same contract: it converts, it does not run. `SupervisorAgent` needs an
+ * `agentIds` roster and a manager that can spawn them; this supplies the
+ * roster from the directory and leaves the manager to the host.
+ *
+ * The delegates come back as plans rather than registered agents because
+ * registration mutates the host's manager. Two lines in the host, and the host
+ * can see exactly what it just gained.
+ */
+export function deriveSupervisorOptions(manifest, input) {
+    if (manifest.modules === 'skip') {
+        throw new Error('This manifest was loaded with modules: "skip", so no tool was imported and no delegate was evaluated. Load with modules: "evaluate" before deriving supervisor options.');
+    }
+    if (manifest.agents.length === 0) {
+        // Not a warning that degrades into a supervisor with nobody to call.
+        // An empty roster makes `create_task` unmountable by design, so the
+        // result would be a coordinator that cannot coordinate — and the
+        // caller asked for a supervisor, which means they expected delegates.
+        throw new Error(`${manifest.root} declares no delegates, so there is nothing for a supervisor to coordinate. Add directories under agents/, or use deriveRunOptions for a single agent.`);
+    }
+    const model = input.model ?? manifest.config.model;
+    if (!model) {
+        throw new Error(`No model. Declare one in ${manifest.root}/agent.ts as \`export default { model: "…" }\`, or pass \`model\` here.`);
+    }
+    const delegates = manifest.agents.map((entry) => delegatePlan(entry, model));
+    const config = {
+        provider: input.provider,
+        model,
+        agentManager: input.agentManager,
+        agentIds: delegates.map((d) => d.id),
+        systemPrompt: manifest.instructions,
+        tools: toolsOf(manifest),
+        // Skills were loaded and then dropped. The manifest reads a whole
+        // `skills/` directory and `SupervisorAgentConfig` takes them, and the
+        // cast that used to close this object meant nobody was told the field
+        // had never been supplied.
+        ...(manifest.skills.length > 0 ? { skills: manifest.skills.map((s) => s.skill) } : {}),
+        // `tokenBudget` and `timeoutMs` are REQUIRED by `BaseAgentConfig`, and
+        // this object supplied them only when `agent.ts` happened to declare
+        // them — which is the uncommon case. The `as SupervisorAgentConfig`
+        // below made that compile, so a directory that named no budget produced
+        // a config typed `tokenBudget: number` holding `undefined`, and
+        // `buildLimitConfig` then disabled BOTH hard stops: no token cap, no
+        // wall clock. Worse, the child-spawn refusal computes its allocation
+        // from the parent budget, so `undefined` became `NaN`, and `NaN <= 0`
+        // is false — the guard that exists to refuse an unfunded child let it
+        // through with a NaN budget.
+        //
+        // Defaulted to the same numbers `runAgent` uses rather than to a local
+        // guess, so the two front doors cannot drift.
+        tokenBudget: manifest.config.tokenBudget ?? DEFAULT_TOKEN_BUDGET,
+        timeoutMs: manifest.config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        ...(manifest.config.temperature !== undefined
+            ? { temperature: manifest.config.temperature }
+            : {}),
+        ...(manifest.config.maxIterations !== undefined
+            ? { maxIterations: manifest.config.maxIterations }
+            : {}),
+        ...(input.identity ?? {}),
+        ...(input.overrides ?? {}),
+    };
+    return { config, delegates };
+}
+//# sourceMappingURL=derive-supervisor.js.map

package/dist/directory/derive-supervisor.js.map

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