@namzu/sdk 0.4.2 → 0.4.4

package/dist/bridge/tools/connector/definitions.test.js

@@ -0,0 +1,158 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `createConnectorExecuteTool(config)` returns a `defineTool`-wrapped
+ *     tool named `connector_execute` that:
+ *     - Returns `{success: false, error: '... not found'}` when instance
+ *       is missing.
+ *     - Returns `{success: false, error: '... not connected'}` when the
+ *       instance exists but `status !== 'connected'`.
+ *     - Returns `{success: false, error: ...}` when `manager.execute`
+ *       itself reports failure; falls back to 'Connector execution
+ *       failed' when the execute error is undefined.
+ *     - On success, stringifies non-string outputs to JSON; strings pass
+ *       through as-is.
+ *     - Attaches `data: { durationMs, metadata }` on success.
+ *   - `createConnectorListTool(config)` returns a tool named
+ *     `connector_list` that:
+ *     - Emits "No connector instances configured." when none exist.
+ *     - Lists each instance with `- <id> (<connectorId>): <name> [<status>]`.
+ *   - `createConnectorTools(config)` returns the pair of tools above.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { createConnectorExecuteTool, createConnectorListTool, createConnectorTools, } from './definitions.js';
+const CID = 'conn_http';
+const IID = 'ci_abc123';
+function makeInstance(overrides = {}) {
+    return {
+        id: IID,
+        connectorId: CID,
+        config: { connectorId: CID, name: 'default' },
+        status: 'connected',
+        createdAt: Date.now(),
+        ...overrides,
+    };
+}
+function makeManager(overrides = {}) {
+    return {
+        getInstance: vi.fn(() => makeInstance()),
+        listInstances: vi.fn(() => [makeInstance()]),
+        execute: vi.fn(),
+        ...overrides,
+    };
+}
+const ctx = {};
+describe('createConnectorExecuteTool', () => {
+    it('is named connector_execute', () => {
+        const tool = createConnectorExecuteTool({ manager: makeManager() });
+        expect(tool.name).toBe('connector_execute');
+    });
+    it('returns error when instance is missing', async () => {
+        const manager = makeManager({
+            getInstance: vi.fn(() => undefined),
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/not found/);
+    });
+    it('returns error when instance status is not "connected"', async () => {
+        const manager = makeManager({
+            getInstance: vi.fn(() => makeInstance({ status: 'disconnected' })),
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/not connected/);
+        expect(result.error).toMatch(/disconnected/);
+    });
+    it('wraps manager.execute failure; falls back to "Connector execution failed" on undefined error', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: false,
+            output: undefined,
+            durationMs: 1,
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Connector execution failed');
+    });
+    it('carries the explicit error message when provided by manager.execute', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: false,
+            output: undefined,
+            durationMs: 1,
+            error: 'timeout',
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.error).toBe('timeout');
+    });
+    it('passes through string outputs as-is', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: 'hi there',
+            durationMs: 10,
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.success).toBe(true);
+        expect(result.output).toBe('hi there');
+    });
+    it('stringifies non-string outputs + attaches durationMs + metadata to data', async () => {
+        const manager = makeManager();
+        vi.mocked(manager.execute).mockResolvedValueOnce({
+            success: true,
+            output: { answer: 42 },
+            durationMs: 15,
+            metadata: { region: 'us-east-1' },
+        });
+        const tool = createConnectorExecuteTool({ manager });
+        const result = await tool.execute({ instance_id: IID, method: 'request', input: {} }, ctx);
+        expect(result.output).toBe(JSON.stringify({ answer: 42 }, null, 2));
+        expect(result.data).toEqual({ durationMs: 15, metadata: { region: 'us-east-1' } });
+    });
+});
+describe('createConnectorListTool', () => {
+    it('is named connector_list + read-only', () => {
+        const tool = createConnectorListTool({ manager: makeManager() });
+        expect(tool.name).toBe('connector_list');
+        expect(tool.isReadOnly?.({})).toBe(true);
+    });
+    it('emits "No connector instances configured." when none', async () => {
+        const manager = makeManager({
+            listInstances: vi.fn(() => []),
+        });
+        const tool = createConnectorListTool({ manager });
+        const result = await tool.execute({}, ctx);
+        expect(result.success).toBe(true);
+        expect(result.output).toBe('No connector instances configured.');
+    });
+    it('lists every instance with id / connectorId / name / status', async () => {
+        const manager = makeManager({
+            listInstances: vi.fn(() => [
+                makeInstance({ id: IID }),
+                makeInstance({
+                    id: 'ci_def',
+                    status: 'disconnected',
+                }),
+            ]),
+        });
+        const tool = createConnectorListTool({ manager });
+        const result = await tool.execute({}, ctx);
+        expect(result.success).toBe(true);
+        expect(result.output).toContain(`- ${IID} (${CID}): default [connected]`);
+        expect(result.output).toContain(`- ci_def (${CID}): default [disconnected]`);
+        expect(result.data).toBeDefined();
+    });
+});
+describe('createConnectorTools', () => {
+    it('returns both execute + list tools', () => {
+        const tools = createConnectorTools({ manager: makeManager() });
+        expect(tools.map((t) => t.name)).toEqual(['connector_execute', 'connector_list']);
+    });
+});
+//# sourceMappingURL=definitions.test.js.map

package/dist/bridge/tools/connector/definitions.test.js.map

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

package/dist/bridge/tools/connector/router.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `new ConnectorToolRouter({ manager })` defaults strategy to
+ *     `'per-method'`.
+ *   - `getTools()` with strategy `'router'`:
+ *     - Returns `[]` when there are no connected instances.
+ *     - Returns a single `connector_execute` routing tool otherwise.
+ *   - `getTools()` with strategy `'per-method'`:
+ *     - Emits one tool per method per connected instance.
+ *     - Catches errors per-instance (logs + skips) — a broken instance
+ *       does not poison the entire tool list.
+ *   - `registerTools(registry)` delegates to `registry.register` for
+ *     every tool and returns the list of names.
+ *   - `unregisterTools(registry, names)` calls `registry.unregister`
+ *     for each name.
+ *   - `refreshTools(registry, previous)` is unregister-then-register in
+ *     one call; returns the new names list.
+ */
+export {};
+//# sourceMappingURL=router.test.d.ts.map

package/dist/bridge/tools/connector/router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/tools/connector/router.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/bridge/tools/connector/router.test.js

@@ -0,0 +1,139 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 2):
+ *
+ *   - `new ConnectorToolRouter({ manager })` defaults strategy to
+ *     `'per-method'`.
+ *   - `getTools()` with strategy `'router'`:
+ *     - Returns `[]` when there are no connected instances.
+ *     - Returns a single `connector_execute` routing tool otherwise.
+ *   - `getTools()` with strategy `'per-method'`:
+ *     - Emits one tool per method per connected instance.
+ *     - Catches errors per-instance (logs + skips) — a broken instance
+ *       does not poison the entire tool list.
+ *   - `registerTools(registry)` delegates to `registry.register` for
+ *     every tool and returns the list of names.
+ *   - `unregisterTools(registry, names)` calls `registry.unregister`
+ *     for each name.
+ *   - `refreshTools(registry, previous)` is unregister-then-register in
+ *     one call; returns the new names list.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { ConnectorToolRouter } from './router.js';
+const CID = 'conn_http';
+const IID1 = 'ci_a';
+const IID2 = 'ci_b';
+function makeDefinition() {
+    return {
+        id: CID,
+        name: 'HTTP',
+        description: 'x',
+        connectionType: 'http',
+        configSchema: z.object({}),
+        methods: [
+            { name: 'request', description: 'd', inputSchema: z.object({}) },
+            { name: 'send', description: 'd', inputSchema: z.object({}) },
+        ],
+    };
+}
+function makeInstance(id) {
+    return {
+        id,
+        connectorId: CID,
+        config: { connectorId: CID, name: 'x' },
+        status: 'connected',
+        createdAt: Date.now(),
+    };
+}
+function makeManager(instances) {
+    const def = makeDefinition();
+    const registry = {
+        getOrThrow: vi.fn(() => def),
+        get: vi.fn(() => def),
+    };
+    return {
+        getInstance: vi.fn((id) => instances.find((i) => i.id === id)),
+        getRegistry: vi.fn(() => registry),
+        listConnectedInstances: vi.fn(() => instances),
+        listInstances: vi.fn(() => instances),
+        execute: vi.fn(),
+    };
+}
+function makeToolRegistry() {
+    return {
+        register: vi.fn(),
+        unregister: vi.fn(() => true),
+        clear: vi.fn(),
+    };
+}
+describe('ConnectorToolRouter', () => {
+    it('defaults strategy to per-method', () => {
+        const router = new ConnectorToolRouter({ manager: makeManager([makeInstance(IID1)]) });
+        const tools = router.getTools();
+        expect(tools.map((t) => t.name)).toEqual([`${CID}_request`, `${CID}_send`]);
+    });
+    it('router strategy with connected instances emits one connector_execute tool', () => {
+        const router = new ConnectorToolRouter({
+            manager: makeManager([makeInstance(IID1)]),
+            strategy: 'router',
+        });
+        const tools = router.getTools();
+        expect(tools).toHaveLength(1);
+        expect(tools[0]?.name).toBe('connector_execute');
+    });
+    it('router strategy with no connected instances returns empty array', () => {
+        const router = new ConnectorToolRouter({
+            manager: makeManager([]),
+            strategy: 'router',
+        });
+        expect(router.getTools()).toEqual([]);
+    });
+    it('per-method strategy with multiple instances emits methods per-instance', () => {
+        const router = new ConnectorToolRouter({
+            manager: makeManager([makeInstance(IID1), makeInstance(IID2)]),
+        });
+        const tools = router.getTools();
+        expect(tools).toHaveLength(4); // 2 methods * 2 instances
+    });
+    it('per-method strategy skips a broken instance + continues with others', () => {
+        const good = makeInstance(IID1);
+        const bad = makeInstance(IID2);
+        const manager = makeManager([good, bad]);
+        // make instance IID2 "not found" by overriding getInstance
+        vi.mocked(manager.getInstance).mockImplementation((id) => (id === IID1 ? good : undefined));
+        const router = new ConnectorToolRouter({ manager });
+        const tools = router.getTools();
+        // 2 from IID1; IID2 threw + got caught
+        expect(tools.map((t) => t.name)).toEqual([`${CID}_request`, `${CID}_send`]);
+    });
+});
+describe('ConnectorToolRouter.registerTools', () => {
+    it('registers every tool and returns the names', () => {
+        const router = new ConnectorToolRouter({ manager: makeManager([makeInstance(IID1)]) });
+        const reg = makeToolRegistry();
+        const names = router.registerTools(reg);
+        expect(names).toEqual([`${CID}_request`, `${CID}_send`]);
+        expect(reg.register).toHaveBeenCalledTimes(2);
+    });
+});
+describe('ConnectorToolRouter.unregisterTools', () => {
+    it('unregisters each named tool', () => {
+        const router = new ConnectorToolRouter({ manager: makeManager([]) });
+        const reg = makeToolRegistry();
+        router.unregisterTools(reg, ['a', 'b']);
+        expect(reg.unregister).toHaveBeenCalledWith('a');
+        expect(reg.unregister).toHaveBeenCalledWith('b');
+        expect(reg.unregister).toHaveBeenCalledTimes(2);
+    });
+});
+describe('ConnectorToolRouter.refreshTools', () => {
+    it('unregisters previous names then registers new ones', () => {
+        const router = new ConnectorToolRouter({ manager: makeManager([makeInstance(IID1)]) });
+        const reg = makeToolRegistry();
+        const newNames = router.refreshTools(reg, [`${CID}_old_method`]);
+        expect(reg.unregister).toHaveBeenCalledWith(`${CID}_old_method`);
+        expect(newNames).toEqual([`${CID}_request`, `${CID}_send`]);
+        expect(reg.register).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=router.test.js.map

package/dist/bridge/tools/connector/router.test.js.map

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

package/dist/bus/breaker.test.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 1):
+ *
+ *   - `canExecute(runId)` on an unknown runId returns true (no breaker
+ *     means no constraint).
+ *   - `recordFailure(runId)` lazily creates a breaker entry in `closed`
+ *     state for unknown runIds; `recordSuccess(runId)` is a no-op when
+ *     no entry exists.
+ *   - Consecutive failures: after `failureThreshold` calls in a row
+ *     without intervening success, `state` → `open`, `trippedAt` set,
+ *     single `breaker_tripped` event.
+ *   - In `open` state, `canExecute` returns false until `resetTimeoutMs`
+ *     has elapsed since `trippedAt`; at that point it transitions to
+ *     `half_open`, emits `breaker_half_open`, and returns true.
+ *   - In `half_open`, `canExecute` keeps returning true (the probe is
+ *     allowed more than once) until the next `recordSuccess` closes the
+ *     breaker or the next `recordFailure` re-trips it.
+ *   - `recordSuccess` in `half_open` → `closed`; emits
+ *     `breaker_probe_success` then `breaker_reset` (two events, in
+ *     that order).
+ *   - `recordFailure` in `half_open` → `open`; emits
+ *     `breaker_probe_failure` then `breaker_tripped` (two events).
+ *     The `consecutiveFailures` count carries over (not reset by the
+ *     half-open probe cycle).
+ *   - `recordSuccess` in `closed` resets `consecutiveFailures` to 0 and
+ *     updates `lastSuccessAt`; emits nothing.
+ *   - `recordSuccess` while `open`: logs a warning, does NOT change
+ *     state (behaviour is "discarded"); emits nothing.
+ *   - `recordFailure` while `open`: no additional events; state stays
+ *     open (consecutive counter does NOT advance from `recordFailure`
+ *     while open in the current implementation either — see test).
+ *   - `reset(runId)` forces the breaker to `closed` regardless of prior
+ *     state; emits `breaker_reset`; clears `consecutiveFailures` and
+ *     `trippedAt` but preserves `lastFailureAt` / `lastSuccessAt`.
+ *   - `listTripped()` returns snapshots for every breaker in `open` or
+ *     `half_open`; closed breakers are excluded.
+ *   - Breaker entries are keyed per-`RunId`; state does not leak across
+ *     runs. No per-tenant dimension (design.md §2.1 aspirational).
+ */
+export {};
+//# sourceMappingURL=breaker.test.d.ts.map

package/dist/bus/breaker.test.d.ts.map

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

package/dist/bus/breaker.test.js

@@ -0,0 +1,242 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 1):
+ *
+ *   - `canExecute(runId)` on an unknown runId returns true (no breaker
+ *     means no constraint).
+ *   - `recordFailure(runId)` lazily creates a breaker entry in `closed`
+ *     state for unknown runIds; `recordSuccess(runId)` is a no-op when
+ *     no entry exists.
+ *   - Consecutive failures: after `failureThreshold` calls in a row
+ *     without intervening success, `state` → `open`, `trippedAt` set,
+ *     single `breaker_tripped` event.
+ *   - In `open` state, `canExecute` returns false until `resetTimeoutMs`
+ *     has elapsed since `trippedAt`; at that point it transitions to
+ *     `half_open`, emits `breaker_half_open`, and returns true.
+ *   - In `half_open`, `canExecute` keeps returning true (the probe is
+ *     allowed more than once) until the next `recordSuccess` closes the
+ *     breaker or the next `recordFailure` re-trips it.
+ *   - `recordSuccess` in `half_open` → `closed`; emits
+ *     `breaker_probe_success` then `breaker_reset` (two events, in
+ *     that order).
+ *   - `recordFailure` in `half_open` → `open`; emits
+ *     `breaker_probe_failure` then `breaker_tripped` (two events).
+ *     The `consecutiveFailures` count carries over (not reset by the
+ *     half-open probe cycle).
+ *   - `recordSuccess` in `closed` resets `consecutiveFailures` to 0 and
+ *     updates `lastSuccessAt`; emits nothing.
+ *   - `recordSuccess` while `open`: logs a warning, does NOT change
+ *     state (behaviour is "discarded"); emits nothing.
+ *   - `recordFailure` while `open`: no additional events; state stays
+ *     open (consecutive counter does NOT advance from `recordFailure`
+ *     while open in the current implementation either — see test).
+ *   - `reset(runId)` forces the breaker to `closed` regardless of prior
+ *     state; emits `breaker_reset`; clears `consecutiveFailures` and
+ *     `trippedAt` but preserves `lastFailureAt` / `lastSuccessAt`.
+ *   - `listTripped()` returns snapshots for every breaker in `open` or
+ *     `half_open`; closed breakers are excluded.
+ *   - Breaker entries are keyed per-`RunId`; state does not leak across
+ *     runs. No per-tenant dimension (design.md §2.1 aspirational).
+ */
+import fc from 'fast-check';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { CircuitBreaker } from './breaker.js';
+function makeLogger() {
+    const stub = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() };
+    return { ...stub, child: vi.fn(() => ({ ...stub, child: vi.fn() })) };
+}
+function runId(n) {
+    return `run_${n}`;
+}
+const THRESHOLD = 5;
+const RESET_MS = 30_000;
+describe('CircuitBreaker', () => {
+    let events;
+    let breaker;
+    beforeEach(() => {
+        events = [];
+        breaker = new CircuitBreaker(makeLogger(), (e) => events.push(e), THRESHOLD, RESET_MS);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('canExecute', () => {
+        it('returns true for an unknown runId (no breaker entry yet)', () => {
+            expect(breaker.canExecute(runId(1))).toBe(true);
+        });
+    });
+    describe('recordFailure', () => {
+        it('lazily creates a closed breaker entry for unknown runIds', () => {
+            breaker.recordFailure(runId(1));
+            const snap = breaker.getSnapshot(runId(1));
+            expect(snap?.state).toBe('closed');
+            expect(snap?.consecutiveFailures).toBe(1);
+        });
+        it('trips after exactly `failureThreshold` consecutive failures', () => {
+            for (let i = 0; i < THRESHOLD - 1; i++) {
+                breaker.recordFailure(runId(1));
+            }
+            expect(breaker.getSnapshot(runId(1))?.state).toBe('closed');
+            expect(events.filter((e) => e.type === 'breaker_tripped')).toHaveLength(0);
+            breaker.recordFailure(runId(1));
+            expect(breaker.getSnapshot(runId(1))?.state).toBe('open');
+            const trippedEvents = events.filter((e) => e.type === 'breaker_tripped');
+            expect(trippedEvents).toHaveLength(1);
+            if (trippedEvents[0]?.type === 'breaker_tripped') {
+                expect(trippedEvents[0].consecutiveFailures).toBe(THRESHOLD);
+            }
+        });
+        it('trips exactly once — further failures in `open` emit no new breaker_tripped', () => {
+            for (let i = 0; i < THRESHOLD; i++)
+                breaker.recordFailure(runId(1));
+            events.length = 0;
+            breaker.recordFailure(runId(1));
+            breaker.recordFailure(runId(1));
+            expect(events).toEqual([]);
+        });
+        it('property: any N ≥ threshold consecutive failures trips exactly once', () => {
+            fc.assert(fc.property(fc.integer({ min: THRESHOLD, max: THRESHOLD * 4 }), (n) => {
+                const local = new CircuitBreaker(makeLogger(), () => { }, THRESHOLD, RESET_MS);
+                for (let i = 0; i < n; i++)
+                    local.recordFailure(runId(999));
+                expect(local.getSnapshot(runId(999))?.state).toBe('open');
+            }), { numRuns: 25 });
+        });
+        it('property: any N < threshold keeps the breaker closed', () => {
+            fc.assert(fc.property(fc.integer({ min: 0, max: THRESHOLD - 1 }), (n) => {
+                const local = new CircuitBreaker(makeLogger(), () => { }, THRESHOLD, RESET_MS);
+                for (let i = 0; i < n; i++)
+                    local.recordFailure(runId(888));
+                const snap = local.getSnapshot(runId(888));
+                if (n === 0) {
+                    expect(snap).toBeUndefined();
+                }
+                else {
+                    expect(snap?.state).toBe('closed');
+                }
+            }), { numRuns: 25 });
+        });
+    });
+    describe('recordSuccess', () => {
+        it('is a no-op on an unknown runId — no breaker entry created', () => {
+            breaker.recordSuccess(runId(42));
+            expect(breaker.getSnapshot(runId(42))).toBeUndefined();
+            expect(events).toEqual([]);
+        });
+        it('resets consecutiveFailures to 0 without changing closed state', () => {
+            breaker.recordFailure(runId(1));
+            breaker.recordFailure(runId(1));
+            breaker.recordSuccess(runId(1));
+            const snap = breaker.getSnapshot(runId(1));
+            expect(snap?.state).toBe('closed');
+            expect(snap?.consecutiveFailures).toBe(0);
+            expect(snap?.lastSuccessAt).toBeDefined();
+        });
+        it('is discarded (warned, no state change) when called while breaker is open', () => {
+            for (let i = 0; i < THRESHOLD; i++)
+                breaker.recordFailure(runId(1));
+            events.length = 0;
+            breaker.recordSuccess(runId(1));
+            expect(breaker.getSnapshot(runId(1))?.state).toBe('open');
+            expect(events).toEqual([]);
+        });
+    });
+    describe('open → half_open transition', () => {
+        it('transitions to half_open after resetTimeoutMs elapsed; emits breaker_half_open', () => {
+            vi.useFakeTimers();
+            const trip = new CircuitBreaker(makeLogger(), (e) => events.push(e), THRESHOLD, RESET_MS);
+            for (let i = 0; i < THRESHOLD; i++)
+                trip.recordFailure(runId(1));
+            events.length = 0;
+            expect(trip.canExecute(runId(1))).toBe(false);
+            vi.advanceTimersByTime(RESET_MS - 1);
+            expect(trip.canExecute(runId(1))).toBe(false);
+            vi.advanceTimersByTime(1);
+            expect(trip.canExecute(runId(1))).toBe(true);
+            expect(trip.getSnapshot(runId(1))?.state).toBe('half_open');
+            expect(events).toEqual([{ type: 'breaker_half_open', agentRunId: runId(1) }]);
+        });
+        it('canExecute in half_open keeps returning true until success or failure resolves', () => {
+            vi.useFakeTimers();
+            const trip = new CircuitBreaker(makeLogger(), () => { }, THRESHOLD, RESET_MS);
+            for (let i = 0; i < THRESHOLD; i++)
+                trip.recordFailure(runId(1));
+            vi.advanceTimersByTime(RESET_MS);
+            trip.canExecute(runId(1)); // flip to half_open
+            expect(trip.canExecute(runId(1))).toBe(true);
+            expect(trip.canExecute(runId(1))).toBe(true);
+        });
+    });
+    describe('half_open → closed / open resolution', () => {
+        function setupHalfOpen() {
+            vi.useFakeTimers();
+            const b = new CircuitBreaker(makeLogger(), (e) => events.push(e), THRESHOLD, RESET_MS);
+            for (let i = 0; i < THRESHOLD; i++)
+                b.recordFailure(runId(1));
+            vi.advanceTimersByTime(RESET_MS);
+            b.canExecute(runId(1)); // flip
+            events.length = 0;
+            return b;
+        }
+        it('recordSuccess in half_open closes the breaker + emits probe_success then reset', () => {
+            const b = setupHalfOpen();
+            b.recordSuccess(runId(1));
+            expect(b.getSnapshot(runId(1))?.state).toBe('closed');
+            expect(b.getSnapshot(runId(1))?.consecutiveFailures).toBe(0);
+            expect(events).toEqual([
+                { type: 'breaker_probe_success', agentRunId: runId(1) },
+                { type: 'breaker_reset', agentRunId: runId(1) },
+            ]);
+        });
+        it('recordFailure in half_open re-trips + emits probe_failure then tripped', () => {
+            const b = setupHalfOpen();
+            b.recordFailure(runId(1));
+            expect(b.getSnapshot(runId(1))?.state).toBe('open');
+            expect(events).toEqual([
+                { type: 'breaker_probe_failure', agentRunId: runId(1) },
+                {
+                    type: 'breaker_tripped',
+                    agentRunId: runId(1),
+                    consecutiveFailures: THRESHOLD + 1,
+                },
+            ]);
+        });
+    });
+    describe('reset', () => {
+        it('forces a tripped breaker back to closed + emits breaker_reset', () => {
+            for (let i = 0; i < THRESHOLD; i++)
+                breaker.recordFailure(runId(1));
+            events.length = 0;
+            breaker.reset(runId(1));
+            const snap = breaker.getSnapshot(runId(1));
+            expect(snap?.state).toBe('closed');
+            expect(snap?.consecutiveFailures).toBe(0);
+            expect(snap?.trippedAt).toBeUndefined();
+            expect(events).toEqual([{ type: 'breaker_reset', agentRunId: runId(1) }]);
+        });
+        it('is a no-op on an unknown runId (no event)', () => {
+            breaker.reset(runId(999));
+            expect(events).toEqual([]);
+        });
+    });
+    describe('per-runId isolation', () => {
+        it('tripping one runId does not affect another', () => {
+            for (let i = 0; i < THRESHOLD; i++)
+                breaker.recordFailure(runId(1));
+            expect(breaker.getSnapshot(runId(1))?.state).toBe('open');
+            expect(breaker.canExecute(runId(2))).toBe(true);
+            expect(breaker.getSnapshot(runId(2))).toBeUndefined();
+        });
+    });
+    describe('listTripped', () => {
+        it('returns only open + half_open breakers; excludes closed', () => {
+            for (let i = 0; i < THRESHOLD; i++)
+                breaker.recordFailure(runId(1));
+            breaker.recordFailure(runId(2));
+            const tripped = breaker.listTripped();
+            expect(tripped).toHaveLength(1);
+            expect(tripped[0]?.agentRunId).toBe(runId(1));
+            expect(tripped[0]?.state).toBe('open');
+        });
+    });
+});
+//# sourceMappingURL=breaker.test.js.map