@namzu/sdk 0.4.2 → 0.4.3

package/dist/registry/plugin/index.test.js

@@ -0,0 +1,69 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `PluginRegistry` extends `ManagedRegistry<PluginDefinition>`
+ *     with `idField: 'id'`.
+ *   - `listByScope(scope)` filters by `def.scope`.
+ *   - `listByStatus(status)` filters by `def.status`.
+ *   - `findByName(name)` does a linear scan through `getAll()` and
+ *     returns the first match by `manifest.name`, or undefined.
+ */
+import { describe, expect, it } from 'vitest';
+import { PluginRegistry } from './index.js';
+function makeDef(id, scope, status, name = id) {
+    return {
+        id: id,
+        manifest: {
+            name,
+            version: '1.0.0',
+            description: `${name} plugin`,
+        },
+        scope,
+        status,
+        rootDir: `/plugins/${id}`,
+        installedAt: Date.now(),
+    };
+}
+describe('PluginRegistry', () => {
+    it('keys by top-level id', () => {
+        const r = new PluginRegistry();
+        r.register(makeDef('plugin_a', 'project', 'installed'));
+        expect(r.get('plugin_a')).toBeDefined();
+    });
+    it('listByScope filters by scope', () => {
+        const r = new PluginRegistry();
+        r.register(makeDef('a', 'project', 'installed'));
+        r.register(makeDef('b', 'user', 'enabled'));
+        r.register(makeDef('c', 'project', 'disabled'));
+        expect(r.listByScope('project').map((d) => d.id)).toEqual(['a', 'c']);
+        expect(r.listByScope('user').map((d) => d.id)).toEqual(['b']);
+    });
+    it('listByStatus filters by status', () => {
+        const r = new PluginRegistry();
+        r.register(makeDef('a', 'project', 'installed'));
+        r.register(makeDef('b', 'project', 'enabled'));
+        r.register(makeDef('c', 'project', 'enabled'));
+        expect(r.listByStatus('enabled').map((d) => d.id)).toEqual(['b', 'c']);
+        expect(r.listByStatus('error')).toEqual([]);
+    });
+    describe('findByName', () => {
+        it('returns the first def with matching manifest.name', () => {
+            const r = new PluginRegistry();
+            r.register(makeDef('id_1', 'project', 'installed', 'alpha'));
+            r.register(makeDef('id_2', 'project', 'installed', 'beta'));
+            expect(r.findByName('beta')?.id).toBe('id_2');
+        });
+        it('returns undefined when no match', () => {
+            const r = new PluginRegistry();
+            r.register(makeDef('id_1', 'project', 'installed', 'alpha'));
+            expect(r.findByName('missing')).toBeUndefined();
+        });
+        it('is case-sensitive (exact string match)', () => {
+            const r = new PluginRegistry();
+            r.register(makeDef('id_1', 'project', 'installed', 'Alpha'));
+            expect(r.findByName('alpha')).toBeUndefined();
+            expect(r.findByName('Alpha')?.id).toBe('id_1');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/registry/plugin/index.test.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `ToolRegistry` extends `ManagedRegistry<ToolDefinition>` with
+ *     `idField: 'name'` and an additional `availability` map keyed by
+ *     tool name.
+ *   - `register(tool)` defaults availability to 'active'; the array
+ *     overload uses the second arg (if it's a string) as the initial
+ *     state for all tools.
+ *   - Tier validation: if `tool.tier` is set AND `tierConfig` is
+ *     configured, the tier id must be in `tierConfig.tiers`; otherwise
+ *     register throws. Tools without a tier (even with tierConfig
+ *     configured) are always accepted.
+ *   - `unregister` + `clear` drop both the Registry entry and the
+ *     availability entry.
+ *   - `activate` / `defer` take a list of names; each throws (via
+ *     `getOrThrow`) if the name is unknown, then toggles availability.
+ *   - `suspendAll` flips every `active` tool to `suspended`;
+ *     `deferred` / `suspended` tools are left alone. `hasSuspended`
+ *     reports true iff at least one tool is suspended.
+ *   - `getAvailability(name)` returns 'active' as a default even for
+ *     unknown names (this is non-obvious but is the current behavior).
+ *   - `searchDeferred(q)` is a case-insensitive filter against name OR
+ *     description of every DEFERRED tool.
+ *   - `assignTiers(mapping)` mutates `tool.tier` on existing tools;
+ *     throws via `getOrThrow` on unknown name; throws if the tier id
+ *     is not in `tierConfig.tiers`.
+ *   - `toTierGuidance` returns null without a guidanceTemplate; calls
+ *     the template with every defined tier otherwise.
+ *   - `toPromptSection`: returns '' when no active or deferred tools;
+ *     otherwise produces `<available_tools>` + `<deferred_tools>`
+ *     fragments.
+ *   - `toLLMTools`: converts active + suspended tools (filtered by
+ *     `toolNames` if provided) into LLM tool schemas via
+ *     `zodToJsonSchema`. When `tierConfig.labelInDescription` is true,
+ *     the description is prefixed with the tier label.
+ *   - `execute`: validates availability → permissionMode plan gate →
+ *     zod.safeParse → calls tool.execute inside an OTEL span; wraps
+ *     thrown errors as `{success:false, error}`.
+ */
+export {};
+//# sourceMappingURL=execute.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.test.d.ts","sourceRoot":"","sources":["../../../src/registry/tool/execute.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}

package/dist/registry/tool/execute.test.js

@@ -0,0 +1,281 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `ToolRegistry` extends `ManagedRegistry<ToolDefinition>` with
+ *     `idField: 'name'` and an additional `availability` map keyed by
+ *     tool name.
+ *   - `register(tool)` defaults availability to 'active'; the array
+ *     overload uses the second arg (if it's a string) as the initial
+ *     state for all tools.
+ *   - Tier validation: if `tool.tier` is set AND `tierConfig` is
+ *     configured, the tier id must be in `tierConfig.tiers`; otherwise
+ *     register throws. Tools without a tier (even with tierConfig
+ *     configured) are always accepted.
+ *   - `unregister` + `clear` drop both the Registry entry and the
+ *     availability entry.
+ *   - `activate` / `defer` take a list of names; each throws (via
+ *     `getOrThrow`) if the name is unknown, then toggles availability.
+ *   - `suspendAll` flips every `active` tool to `suspended`;
+ *     `deferred` / `suspended` tools are left alone. `hasSuspended`
+ *     reports true iff at least one tool is suspended.
+ *   - `getAvailability(name)` returns 'active' as a default even for
+ *     unknown names (this is non-obvious but is the current behavior).
+ *   - `searchDeferred(q)` is a case-insensitive filter against name OR
+ *     description of every DEFERRED tool.
+ *   - `assignTiers(mapping)` mutates `tool.tier` on existing tools;
+ *     throws via `getOrThrow` on unknown name; throws if the tier id
+ *     is not in `tierConfig.tiers`.
+ *   - `toTierGuidance` returns null without a guidanceTemplate; calls
+ *     the template with every defined tier otherwise.
+ *   - `toPromptSection`: returns '' when no active or deferred tools;
+ *     otherwise produces `<available_tools>` + `<deferred_tools>`
+ *     fragments.
+ *   - `toLLMTools`: converts active + suspended tools (filtered by
+ *     `toolNames` if provided) into LLM tool schemas via
+ *     `zodToJsonSchema`. When `tierConfig.labelInDescription` is true,
+ *     the description is prefixed with the tier label.
+ *   - `execute`: validates availability → permissionMode plan gate →
+ *     zod.safeParse → calls tool.execute inside an OTEL span; wraps
+ *     thrown errors as `{success:false, error}`.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { ToolRegistry } from './execute.js';
+function makeTool(name, overrides = {}) {
+    return {
+        name,
+        description: `${name} tool`,
+        inputSchema: z.object({ k: z.string().optional() }),
+        async execute() {
+            return { success: true, output: `${name}-ran` };
+        },
+        ...overrides,
+    };
+}
+function makeContext(overrides = {}) {
+    return {
+        runId: 'run_1',
+        workingDirectory: '/tmp',
+        abortSignal: new AbortController().signal,
+        env: {},
+        log: () => { },
+        ...overrides,
+    };
+}
+describe('ToolRegistry — register + availability', () => {
+    it('single-tool register: default availability is active', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('read'));
+        expect(r.getAvailability('read')).toBe('active');
+    });
+    it('array-register: second arg sets availability for all', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('a'), makeTool('b')], 'deferred');
+        expect(r.getAvailability('a')).toBe('deferred');
+        expect(r.getAvailability('b')).toBe('deferred');
+    });
+    it('getAvailability returns active for unknown names (current default)', () => {
+        const r = new ToolRegistry();
+        expect(r.getAvailability('never-registered')).toBe('active');
+    });
+    it('unregister drops both the tool + the availability entry', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        expect(r.unregister('a')).toBe(true);
+        expect(r.get('a')).toBeUndefined();
+        expect(r.listIds()).toEqual([]);
+    });
+    it('clear empties both maps', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        r.clear();
+        expect(r.listIds()).toEqual([]);
+    });
+});
+describe('ToolRegistry — tier validation', () => {
+    const tierConfig = {
+        tiers: [
+            { id: 'safe', label: 'Safe', priority: 1 },
+            { id: 'danger', label: 'Danger', priority: 10 },
+        ],
+    };
+    it('accepts tools without a tier even when tierConfig is configured', () => {
+        const r = new ToolRegistry({ tierConfig });
+        expect(() => r.register(makeTool('a'))).not.toThrow();
+    });
+    it('accepts tools whose tier is in the config', () => {
+        const r = new ToolRegistry({ tierConfig });
+        expect(() => r.register(makeTool('a', { tier: 'safe' }))).not.toThrow();
+    });
+    it('throws when tier id is unknown', () => {
+        const r = new ToolRegistry({ tierConfig });
+        expect(() => r.register(makeTool('a', { tier: 'bogus' }))).toThrow(/not defined/);
+    });
+});
+describe('ToolRegistry — activate / defer / suspend', () => {
+    it('activate + defer throw via getOrThrow on unknown name', () => {
+        const r = new ToolRegistry();
+        expect(() => r.activate(['unknown'])).toThrow(/Not found/);
+        expect(() => r.defer(['unknown'])).toThrow(/Not found/);
+    });
+    it('activate sets state to active', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('a')], 'deferred');
+        r.activate(['a']);
+        expect(r.getAvailability('a')).toBe('active');
+    });
+    it('defer sets state to deferred', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        r.defer(['a']);
+        expect(r.getAvailability('a')).toBe('deferred');
+    });
+    it('suspendAll flips active → suspended; leaves deferred / suspended alone', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        r.register(makeTool('b'));
+        r.register([makeTool('c')], 'deferred');
+        r.suspendAll();
+        expect(r.getAvailability('a')).toBe('suspended');
+        expect(r.getAvailability('b')).toBe('suspended');
+        expect(r.getAvailability('c')).toBe('deferred');
+        expect(r.hasSuspended()).toBe(true);
+    });
+    it('hasSuspended returns false when none are suspended', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        expect(r.hasSuspended()).toBe(false);
+    });
+});
+describe('ToolRegistry — searchDeferred', () => {
+    it('filters only deferred tools by name OR description (case-insensitive)', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('alpha', { description: 'does alpha' })], 'deferred');
+        r.register([makeTool('beta', { description: 'does BETA' })], 'deferred');
+        r.register(makeTool('gamma'));
+        expect(r.searchDeferred('alpha').map((t) => t.name)).toEqual(['alpha']);
+        expect(r.searchDeferred('beta').map((t) => t.name)).toEqual(['beta']);
+        expect(r.searchDeferred('does').map((t) => t.name)).toEqual(['alpha', 'beta']);
+        expect(r.searchDeferred('gamma')).toEqual([]);
+    });
+});
+describe('ToolRegistry — tier mutation + guidance', () => {
+    const tierConfig = {
+        tiers: [
+            { id: 'safe', label: 'Safe', priority: 1 },
+            { id: 'danger', label: 'Danger', priority: 10 },
+        ],
+        guidanceTemplate: (tiers) => `tiers: ${tiers.map((t) => t.id).join(',')}`,
+        labelInDescription: true,
+    };
+    it('assignTiers sets the tier on each mapped tool', () => {
+        const r = new ToolRegistry({ tierConfig });
+        r.register(makeTool('a'));
+        r.assignTiers({ a: 'safe' });
+        expect(r.get('a')?.tier).toBe('safe');
+    });
+    it('assignTiers throws when the tier is unknown', () => {
+        const r = new ToolRegistry({ tierConfig });
+        r.register(makeTool('a'));
+        expect(() => r.assignTiers({ a: 'bogus' })).toThrow(/not defined/);
+    });
+    it('toTierGuidance returns null without a template', () => {
+        const r = new ToolRegistry();
+        expect(r.toTierGuidance()).toBeNull();
+    });
+    it('toTierGuidance renders via the template', () => {
+        const r = new ToolRegistry({ tierConfig });
+        expect(r.toTierGuidance()).toBe('tiers: safe,danger');
+    });
+});
+describe('ToolRegistry — toPromptSection + toLLMTools', () => {
+    it('toPromptSection returns empty when the registry is empty', () => {
+        const r = new ToolRegistry();
+        expect(r.toPromptSection()).toBe('');
+    });
+    it('toPromptSection renders available + deferred fragments', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        r.register([makeTool('b')], 'deferred');
+        const s = r.toPromptSection();
+        expect(s).toContain('<available_tools>');
+        expect(s).toContain('- a: a tool');
+        expect(s).toContain('<deferred_tools>');
+        expect(s).toContain('- b');
+    });
+    it('toLLMTools: converts active + suspended tools', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('a'));
+        r.register([makeTool('b')], 'deferred');
+        r.register([makeTool('c')], 'suspended');
+        const schemas = r.toLLMTools();
+        const names = schemas.map((t) => t.function.name).sort();
+        expect(names).toEqual(['a', 'c']);
+    });
+    it('toLLMTools: prefixes description with tier label when labelInDescription is true', () => {
+        const tierConfig = {
+            tiers: [{ id: 'safe', label: 'Safe', priority: 1 }],
+            labelInDescription: true,
+        };
+        const r = new ToolRegistry({ tierConfig });
+        r.register(makeTool('a', { tier: 'safe' }));
+        const schemas = r.toLLMTools();
+        expect(schemas[0]?.function.description).toBe('[Safe] a tool');
+    });
+});
+describe('ToolRegistry — execute', () => {
+    it('returns error when tool is not active (e.g. deferred)', async () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('a')], 'deferred');
+        const result = await r.execute('a', {}, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/deferred and cannot be executed/);
+    });
+    it('blocks non-read-only tools in plan mode', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('write', { isReadOnly: () => false }));
+        const result = await r.execute('write', {}, makeContext({
+            permissionContext: { mode: 'plan', runId: 'run_1', workingDirectory: '/tmp' },
+        }));
+        expect(result.success).toBe(false);
+        expect(result.permissionDenied).toBe(true);
+    });
+    it('allows read-only tools in plan mode', async () => {
+        const r = new ToolRegistry();
+        const execute = vi.fn(async () => ({ success: true, output: 'ok' }));
+        r.register(makeTool('read', { isReadOnly: () => true, execute }));
+        const result = await r.execute('read', {}, makeContext({
+            permissionContext: { mode: 'plan', runId: 'run_1', workingDirectory: '/tmp' },
+        }));
+        expect(result.success).toBe(true);
+        expect(execute).toHaveBeenCalled();
+    });
+    it('returns error when input fails zod validation', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('strict', {
+            inputSchema: z.object({ required: z.string() }),
+        }));
+        const result = await r.execute('strict', { required: 123 }, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/Invalid input/);
+    });
+    it('wraps thrown errors in the execute function', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('bad', {
+            async execute() {
+                throw new Error('boom');
+            },
+        }));
+        const result = await r.execute('bad', {}, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/execution failed: boom/);
+    });
+    it('returns the tool result on happy path', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('good'));
+        const result = await r.execute('good', {}, makeContext());
+        expect(result.success).toBe(true);
+        expect(result.output).toBe('good-ran');
+    });
+});
+//# sourceMappingURL=execute.test.js.map

package/dist/registry/tool/execute.test.js.map

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

package/dist/runtime/query/iteration/phases/advisory.test.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 6 follow-up):
+ *
+ *   This file pins the live mutation boundary that `src/advisory/*` tests
+ *   intentionally do NOT cover: the advisory phase IS where advisories
+ *   inject user messages into the run via `ctx.runMgr.pushMessage(...)`
+ *   (Codex #6). A regression that drops the `pushMessage` call — silently
+ *   dropping all advisor output — would pass `src/advisory` tests,
+ *   typecheck, and lint. This file is the only thing that catches it.
+ *
+ *   - **Early-return paths** (no side effects):
+ *     - No `advisoryCtx` on the iteration ctx → returns immediately.
+ *     - `advisoryCtx.checkBudget()` denies → returns; NO pushMessage.
+ *     - Evaluator fires no triggers → returns; NO pushMessage.
+ *     - Trigger fires but advisor not found in registry → warn log +
+ *       return; NO pushMessage.
+ *     - Executor throws → warn log + return; NO pushMessage (partial
+ *       work NOT persisted).
+ *   - **Happy path** — trigger fires + advisor resolves + executor
+ *     succeeds:
+ *     - Calls `executor.consult(advisor, request, callCtx)` exactly once.
+ *     - Calls `evaluator.recordFiring(trigger.id, iteration)`.
+ *     - Calls `advisoryCtx.recordCall(...)` with the full call record.
+ *     - Calls `runMgr.pushMessage(createUserMessage(wrapped))` exactly
+ *       once.
+ *     - The wrapped message includes `<advisory-result advisor="..."
+ *       trigger="...">` + the advice text + closing tag.
+ *     - When the result carries `warnings`, they appear under a
+ *       "Warnings:" section.
+ *     - When the result carries `decisions`, they appear under a
+ *       "Decisions:" section AND each decision is pushed to
+ *       `workingStateManager.addDecision` (if a workingStateManager is
+ *       present on ctx).
+ *   - **Trigger selection**: only the first trigger from
+ *     `evaluator.evaluate(state)[0]` is used per iteration; other fired
+ *     triggers are discarded this round.
+ *   - **Question resolution**: `trigger.questionTemplate` is used when
+ *     set; otherwise the phase uses a default
+ *     "Iteration N: Review the current progress..." string.
+ */
+export {};
+//# sourceMappingURL=advisory.test.d.ts.map

package/dist/runtime/query/iteration/phases/advisory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory.test.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/advisory.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}