@namzu/sdk 0.4.2 → 0.4.3

package/dist/runtime/query/iteration/phases/advisory.test.js

@@ -0,0 +1,334 @@
+/**
+ * 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.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { runAdvisoryPhase } from './advisory.js';
+function makeLogger() {
+    const self = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+        child: vi.fn(),
+    };
+    self.child = vi.fn(() => self);
+    return self;
+}
+function makeAdvisoryCtx(options = {}) {
+    const { budgetAllowed = true, firedTriggers = [], advisor, consultResult = { advice: 'do the thing' }, consultThrows, } = options;
+    const consult = vi.fn(async () => {
+        if (consultThrows)
+            throw consultThrows;
+        return {
+            result: consultResult,
+            usage: {
+                promptTokens: 0,
+                completionTokens: 0,
+                totalTokens: 0,
+                cachedTokens: 0,
+                cacheWriteTokens: 0,
+            },
+            cost: { inputCostPer1M: 0, outputCostPer1M: 0, totalCost: 0, cacheDiscount: 0 },
+            durationMs: 1,
+        };
+    });
+    const evaluate = vi.fn(() => firedTriggers);
+    const recordFiring = vi.fn();
+    const resolve = vi.fn(() => advisor);
+    const checkBudget = vi.fn(() => ({
+        allowed: budgetAllowed,
+        reason: budgetAllowed ? undefined : 'exhausted',
+    }));
+    const recordCall = vi.fn();
+    return {
+        ctx: {
+            registry: { resolve },
+            executor: { consult },
+            evaluator: { evaluate, recordFiring },
+            checkBudget,
+            recordCall,
+            callHistory: [],
+        },
+        mocks: { consult, evaluate, recordFiring, resolve, checkBudget, recordCall },
+    };
+}
+function makeCtx(options = {}) {
+    const pushMessage = vi.fn();
+    const addDecision = vi.fn();
+    const ctx = {
+        advisoryCtx: options.advisoryCtx,
+        runConfig: { tokenBudget: 100_000, costLimitUsd: undefined },
+        tools: {
+            get: vi.fn(() => undefined),
+            toLLMTools: vi.fn(() => []),
+        },
+        runMgr: {
+            id: 'run_1',
+            messages: [],
+            tokenUsage: {
+                promptTokens: 0,
+                completionTokens: 0,
+                totalTokens: 0,
+                cachedTokens: 0,
+                cacheWriteTokens: 0,
+            },
+            costInfo: {
+                inputCostPer1M: 0,
+                outputCostPer1M: 0,
+                totalCost: 0,
+                cacheDiscount: 0,
+            },
+            pushMessage,
+        },
+        log: makeLogger(),
+        workingStateManager: options.withWorkingState
+            ? {
+                getState: vi.fn(() => ({
+                    task: '',
+                    plan: [],
+                    files: new Map(),
+                    decisions: [],
+                    failures: [],
+                    discoveries: [],
+                    environment: [],
+                    toolResults: [],
+                    userRequirements: [],
+                    assistantNotes: [],
+                })),
+                addDecision,
+            }
+            : undefined,
+    };
+    return { ctx, pushMessage, addDecision };
+}
+const response = {
+    id: 'r',
+    model: 'm',
+    message: { role: 'assistant', content: 'text' },
+    usage: {
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0,
+        cachedTokens: 0,
+        cacheWriteTokens: 0,
+    },
+    finishReason: 'stop',
+};
+const advisor = {
+    id: 'adv',
+    name: 'Advisor',
+    provider: {},
+    model: 'opus',
+};
+const trigger = {
+    id: 'trig',
+    condition: { type: 'on_iteration', everyN: 1 },
+    advisorId: 'adv',
+};
+describe('runAdvisoryPhase — early-return paths (no pushMessage)', () => {
+    it('returns immediately when advisoryCtx is absent', async () => {
+        const { ctx, pushMessage } = makeCtx();
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(pushMessage).not.toHaveBeenCalled();
+    });
+    it('returns when budget is denied', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({ budgetAllowed: false });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(mocks.checkBudget).toHaveBeenCalled();
+        expect(mocks.evaluate).not.toHaveBeenCalled();
+        expect(pushMessage).not.toHaveBeenCalled();
+    });
+    it('returns when evaluator fires no triggers', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({ firedTriggers: [] });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(mocks.evaluate).toHaveBeenCalled();
+        expect(mocks.resolve).not.toHaveBeenCalled();
+        expect(pushMessage).not.toHaveBeenCalled();
+    });
+    it('returns (warn) when trigger fires but advisor is not resolved', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor: undefined,
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(mocks.resolve).toHaveBeenCalledWith('adv');
+        expect(mocks.consult).not.toHaveBeenCalled();
+        expect(pushMessage).not.toHaveBeenCalled();
+    });
+    it('returns when executor.consult throws — does NOT pushMessage partial work', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultThrows: new Error('provider timeout'),
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(mocks.consult).toHaveBeenCalled();
+        expect(mocks.recordFiring).not.toHaveBeenCalled();
+        expect(mocks.recordCall).not.toHaveBeenCalled();
+        expect(pushMessage).not.toHaveBeenCalled();
+    });
+});
+describe('runAdvisoryPhase — happy path', () => {
+    it('calls executor + recordFiring + recordCall + pushMessage exactly once', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultResult: { advice: 'do the thing' },
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 3, response);
+        expect(mocks.consult).toHaveBeenCalledTimes(1);
+        expect(mocks.recordFiring).toHaveBeenCalledWith('trig', 3);
+        expect(mocks.recordCall).toHaveBeenCalledTimes(1);
+        expect(pushMessage).toHaveBeenCalledTimes(1);
+    });
+    it('pushMessage wraps advice in <advisory-result> envelope with role user', async () => {
+        const { ctx: advCtx } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultResult: { advice: 'specific advice text' },
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        const pushed = pushMessage.mock.calls[0]?.[0];
+        expect(pushed.role).toBe('user');
+        expect(pushed.content).toContain('<advisory-result advisor="Advisor" trigger="trig">');
+        expect(pushed.content).toContain('specific advice text');
+        expect(pushed.content).toContain('</advisory-result>');
+    });
+    it('includes Warnings section when the result carries warnings', async () => {
+        const { ctx: advCtx } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultResult: {
+                advice: 'proceed',
+                warnings: ['slow response', 'retry likely'],
+            },
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        const pushed = pushMessage.mock.calls[0]?.[0];
+        expect(pushed.content).toContain('Warnings:');
+        expect(pushed.content).toContain('- slow response');
+        expect(pushed.content).toContain('- retry likely');
+    });
+    it('includes Decisions section + pushes each decision to workingStateManager', async () => {
+        const { ctx: advCtx } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultResult: {
+                advice: 'go',
+                decisions: ['use sqlite', 'skip migration'],
+            },
+        });
+        const { ctx, pushMessage, addDecision } = makeCtx({
+            advisoryCtx: advCtx,
+            withWorkingState: true,
+        });
+        await runAdvisoryPhase(ctx, 1, response);
+        const pushed = pushMessage.mock.calls[0]?.[0];
+        expect(pushed.content).toContain('Decisions:');
+        expect(pushed.content).toContain('- use sqlite');
+        expect(pushed.content).toContain('- skip migration');
+        expect(addDecision).toHaveBeenCalledTimes(2);
+        expect(addDecision).toHaveBeenCalledWith('use sqlite');
+        expect(addDecision).toHaveBeenCalledWith('skip migration');
+    });
+    it('does NOT attempt to addDecision when no workingStateManager is present', async () => {
+        const { ctx: advCtx } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+            consultResult: {
+                advice: 'go',
+                decisions: ['a'],
+            },
+        });
+        const { ctx, pushMessage } = makeCtx({ advisoryCtx: advCtx, withWorkingState: false });
+        await runAdvisoryPhase(ctx, 1, response);
+        // pushMessage still carries the Decisions section in content
+        expect((pushMessage.mock.calls[0]?.[0]).content).toContain('- a');
+    });
+});
+describe('runAdvisoryPhase — trigger selection + question', () => {
+    it('uses only the first fired trigger per iteration', async () => {
+        const other = {
+            id: 'other',
+            condition: { type: 'on_iteration', everyN: 1 },
+            advisorId: 'adv',
+        };
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [trigger, other],
+            advisor,
+        });
+        const { ctx } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 1, response);
+        expect(mocks.recordFiring).toHaveBeenCalledTimes(1);
+        expect(mocks.recordFiring).toHaveBeenCalledWith('trig', 1);
+    });
+    it('uses trigger.questionTemplate when present', async () => {
+        const custom = {
+            ...trigger,
+            questionTemplate: 'Custom question',
+        };
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [custom],
+            advisor,
+        });
+        const { ctx } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 7, response);
+        const consultArgs = mocks.consult.mock.calls[0];
+        expect(consultArgs?.[1].question).toBe('Custom question');
+    });
+    it('falls back to the default "Iteration N: ..." question when no template', async () => {
+        const { ctx: advCtx, mocks } = makeAdvisoryCtx({
+            firedTriggers: [trigger],
+            advisor,
+        });
+        const { ctx } = makeCtx({ advisoryCtx: advCtx });
+        await runAdvisoryPhase(ctx, 7, response);
+        const consultArgs = mocks.consult.mock.calls[0];
+        expect(consultArgs?.[1].question).toContain('Iteration 7');
+    });
+});
+//# sourceMappingURL=advisory.test.js.map

package/dist/runtime/query/iteration/phases/advisory.test.js.map

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

package/dist/test-setup.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Vitest `setupFiles` entry for `@namzu/sdk`.
+ *
+ * Silences the root logger for the entire test run. Tests that assert on
+ * log output use their own mocked Logger instances (constructed via the
+ * `makeLogger()` helpers colocated with each test) — those are not
+ * affected by the root-level silence.
+ *
+ * The only thing this suppresses is the stderr spam produced by
+ * production code paths that fall through to `getRootLogger()` — e.g.
+ * `ToolRegistry.execute`'s zod-validation and thrown-error branches,
+ * `ConnectorToolRouter.getTools`' per-instance error catch, the
+ * AgentBus listener-throw handler, and every connector's `connect()`
+ * info log. GitHub Actions annotates any `[ERROR]` stderr line as a
+ * workflow error; silencing the root logger during tests keeps the CI
+ * log clean.
+ *
+ * This is test-only configuration. It runs before every test file and
+ * does not affect consumers.
+ */
+export {};
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

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

package/dist/test-setup.js

@@ -0,0 +1,23 @@
+/**
+ * Vitest `setupFiles` entry for `@namzu/sdk`.
+ *
+ * Silences the root logger for the entire test run. Tests that assert on
+ * log output use their own mocked Logger instances (constructed via the
+ * `makeLogger()` helpers colocated with each test) — those are not
+ * affected by the root-level silence.
+ *
+ * The only thing this suppresses is the stderr spam produced by
+ * production code paths that fall through to `getRootLogger()` — e.g.
+ * `ToolRegistry.execute`'s zod-validation and thrown-error branches,
+ * `ConnectorToolRouter.getTools`' per-instance error catch, the
+ * AgentBus listener-throw handler, and every connector's `connect()`
+ * info log. GitHub Actions annotates any `[ERROR]` stderr line as a
+ * workflow error; silencing the root logger during tests keeps the CI
+ * log clean.
+ *
+ * This is test-only configuration. It runs before every test file and
+ * does not affect consumers.
+ */
+import { configureLogger } from './utils/logger.js';
+configureLogger({ level: 'silent' });
+//# sourceMappingURL=test-setup.js.map

package/dist/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA"}

package/dist/utils/logger.d.ts

@@ -1,4 +1,4 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 export type LogContext = Record<string, unknown>;
 export interface Logger {
     debug(message: string, data?: LogContext): void;

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAShD,MAAM,WAAW,MAAM;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAA;CAClC;AAsCD,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GAAG,IAAI,CAEnE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAchD,MAAM,WAAW,MAAM;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAA;CAClC;AAsCD,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GAAG,IAAI,CAEnE"}

package/dist/utils/logger.js

@@ -3,6 +3,11 @@ const LOG_LEVELS = {
     info: 1,
     warn: 2,
     error: 3,
+    // `silent` sits above every emit level so the `level < minLevelNum`
+    // guard in `log()` always short-circuits when configured. Used by
+    // test harnesses to suppress unmocked `getRootLogger()` stderr
+    // writes; see packages/sdk/src/test-setup.ts.
+    silent: 4,
 };
 function createLoggerImpl(name, minLevel, parentContext) {
     const minLevelNum = LOG_LEVELS[minLevel];

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACR,CAAA;AAUD,SAAS,gBAAgB,CAAC,IAAY,EAAE,QAAkB,EAAE,aAAyB;IACpF,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAExC,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAiB;QAC/D,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,WAAW;YAAE,OAAM;QAE3C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,GAAG,CAAA;QAClE,MAAM,MAAM,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,IAAI,EAAE,CAAA;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;QAEjD,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzE,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,CAAC,CAAA;QAC/C,CAAC;IACF,CAAC;IAED,SAAS,KAAK,CAAC,OAAmB;QACjC,OAAO,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE;YACvF,GAAG,aAAa;YAChB,GAAG,OAAO;SACV,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,KAAK;KACL,CAAA;AACF,CAAC;AAED,IAAI,WAAW,GAAkB,IAAI,CAAA;AAErC,MAAM,UAAU,aAAa;IAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IACpD,CAAC;IACD,OAAO,WAAW,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC5D,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,EAAE,CAAC,CAAA;AACrE,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,oEAAoE;IACpE,kEAAkE;IAClE,+DAA+D;IAC/D,8CAA8C;IAC9C,MAAM,EAAE,CAAC;CACT,CAAA;AAUD,SAAS,gBAAgB,CAAC,IAAY,EAAE,QAAkB,EAAE,aAAyB;IACpF,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAExC,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAiB;QAC/D,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,WAAW;YAAE,OAAM;QAE3C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,GAAG,CAAA;QAClE,MAAM,MAAM,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,IAAI,EAAE,CAAA;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;QAEjD,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzE,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,CAAC,CAAA;QAC/C,CAAC;IACF,CAAC;IAED,SAAS,KAAK,CAAC,OAAmB;QACjC,OAAO,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE;YACvF,GAAG,aAAa;YAChB,GAAG,OAAO;SACV,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,KAAK;KACL,CAAA;AACF,CAAC;AAED,IAAI,WAAW,GAAkB,IAAI,CAAA;AAErC,MAAM,UAAU,aAAa;IAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IACpD,CAAC;IACD,OAAO,WAAW,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC5D,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,EAAE,CAAC,CAAA;AACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namzu/sdk",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Open-source AI agent SDK with a built-in runtime. Nothing between you and your agents.",
   "license": "FSL-1.1-MIT",
   "type": "module",
@@ -43,6 +43,8 @@
     "@biomejs/biome": "^1.9.4",
     "@opentelemetry/api": "^1.9.0",
     "@types/node": "^22.19.17",
+    "@vitest/coverage-v8": "^2.1.9",
+    "fast-check": "^4.7.0",
     "knip": "^6.4.1",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0",
@@ -56,6 +58,7 @@
     "lint:fix": "biome check --write src/",
     "format": "biome format --write src/",
     "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --passWithNoTests --coverage",
     "typecheck": "tsc --noEmit",
     "knip": "knip",
     "knip:production": "knip --production"

package/src/advisory/context.test.ts

@@ -0,0 +1,109 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 6):
+ *
+ *   - `AdvisoryContext` composes a registry + executor + evaluator +
+ *     optional budget. It is a dumb container + a call-history log.
+ *   - `recordCall(record)` appends to `callHistory` in call order.
+ *   - `getBudgetStatus()`:
+ *     - `used` = `callHistory.length`.
+ *     - `total` = `budget?.maxCallsPerRun` (undefined when no budget).
+ *     - `remaining` = total − used when total defined; undefined else.
+ *   - `checkBudget()`:
+ *     - Allowed when no budget OR remaining > 0.
+ *     - Denied with reason when remaining ≤ 0.
+ */
+
+import { describe, expect, it } from 'vitest'
+
+import type { AdvisoryCallRecord } from '../types/advisory/index.js'
+
+import { AdvisoryContext } from './context.js'
+import type { TriggerEvaluator } from './evaluator.js'
+import type { AdvisoryExecutor } from './executor.js'
+import type { AdvisorRegistry } from './registry.js'
+
+function stubRegistry(): AdvisorRegistry {
+	return {} as unknown as AdvisorRegistry
+}
+
+function stubExecutor(): AdvisoryExecutor {
+	return {} as unknown as AdvisoryExecutor
+}
+
+function stubEvaluator(): TriggerEvaluator {
+	return {} as unknown as TriggerEvaluator
+}
+
+function callRecord(id: string): AdvisoryCallRecord {
+	return {
+		advisorId: id,
+		request: { question: 'q' },
+		result: { advice: 'a' },
+		usage: {
+			promptTokens: 0,
+			completionTokens: 0,
+			totalTokens: 0,
+			cachedTokens: 0,
+			cacheWriteTokens: 0,
+		},
+		cost: { inputCostPer1M: 0, outputCostPer1M: 0, totalCost: 0, cacheDiscount: 0 },
+		durationMs: 0,
+		iteration: 0,
+		timestamp: Date.now(),
+	}
+}
+
+describe('AdvisoryContext', () => {
+	it('starts with empty callHistory', () => {
+		const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator())
+		expect(ctx.callHistory).toEqual([])
+	})
+
+	it('recordCall appends in order', () => {
+		const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator())
+		ctx.recordCall(callRecord('a'))
+		ctx.recordCall(callRecord('b'))
+		expect(ctx.callHistory.map((r) => r.advisorId)).toEqual(['a', 'b'])
+	})
+
+	describe('getBudgetStatus', () => {
+		it('no budget → total + remaining undefined; used reflects history length', () => {
+			const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator())
+			ctx.recordCall(callRecord('a'))
+			expect(ctx.getBudgetStatus()).toEqual({ used: 1, total: undefined, remaining: undefined })
+		})
+
+		it('with budget → total + remaining computed', () => {
+			const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator(), {
+				maxCallsPerRun: 3,
+			})
+			ctx.recordCall(callRecord('a'))
+			expect(ctx.getBudgetStatus()).toEqual({ used: 1, total: 3, remaining: 2 })
+		})
+	})
+
+	describe('checkBudget', () => {
+		it('allowed when no budget', () => {
+			const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator())
+			expect(ctx.checkBudget()).toEqual({ allowed: true })
+		})
+
+		it('allowed when remaining > 0', () => {
+			const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator(), {
+				maxCallsPerRun: 2,
+			})
+			ctx.recordCall(callRecord('a'))
+			expect(ctx.checkBudget()).toEqual({ allowed: true })
+		})
+
+		it('denied when remaining <= 0', () => {
+			const ctx = new AdvisoryContext(stubRegistry(), stubExecutor(), stubEvaluator(), {
+				maxCallsPerRun: 1,
+			})
+			ctx.recordCall(callRecord('a'))
+			const result = ctx.checkBudget()
+			expect(result.allowed).toBe(false)
+			expect(result.reason).toMatch(/budget exhausted/)
+		})
+	})
+})