@namzu/sdk 0.4.2 → 0.4.4

package/dist/rag/vector-store.test.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   This file doubles as the VectorStore contract — the tests here run
+ *   against `InMemoryVectorStore` as the reference implementation, and
+ *   are the spec a future `@namzu/vector-store-conformance` package will
+ *   be built around (D4 ratification + Q5 refinement: contract first,
+ *   not "whatever the reference happens to do").
+ *
+ *   **VectorStore contract (derived from current code, 2026-04-21):**
+ *
+ *   - `upsert(chunks[])`: stores each chunk keyed by `chunk.id`. Re-upsert
+ *     of a chunk with the same id REPLACES — no merge, no error. Tenant
+ *     scoping is carried on each chunk, not enforced at upsert (the
+ *     caller is trusted).
+ *   - `search(query)`: returns `VectorSearchResult[]`:
+ *     - Filters by `tenantId` (EXACT match).
+ *     - If `knowledgeBaseId` is set, filters by that too.
+ *     - Skips chunks with `embedding === undefined`.
+ *     - Applies `filter` as metadata-equality AND across the whole
+ *       filter object.
+ *     - Computes similarity via `cosineSimilarity(query, chunk.embedding)`.
+ *     - If `minScore` is set, drops scores below it.
+ *     - Sorts descending by score and returns the top `topK` results.
+ *   - `delete(chunkIds[])`: deletes by exact chunk id. Unknown ids are
+ *     silently ignored.
+ *   - `deleteByDocument(documentId)`: NOT tenant-scoped in the
+ *     current API — deletes every chunk with matching `documentId`
+ *     ACROSS tenants. This is an asymmetry with `search` /
+ *     `deleteByKnowledgeBase` and is intentional to pin (Codex #9 flag).
+ *   - `deleteByKnowledgeBase(kbId, tenantId)`: tenant-scoped deletion
+ *     by knowledge base.
+ *   - `cosineSimilarity(a, b)`: returns 0 when arrays differ in length
+ *     OR when either has zero norm. Otherwise returns the standard
+ *     dot-product / (‖a‖·‖b‖) result.
+ */
+export {};
+//# sourceMappingURL=vector-store.test.d.ts.map

package/dist/rag/vector-store.test.d.ts.map

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

package/dist/rag/vector-store.test.js

@@ -0,0 +1,175 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   This file doubles as the VectorStore contract — the tests here run
+ *   against `InMemoryVectorStore` as the reference implementation, and
+ *   are the spec a future `@namzu/vector-store-conformance` package will
+ *   be built around (D4 ratification + Q5 refinement: contract first,
+ *   not "whatever the reference happens to do").
+ *
+ *   **VectorStore contract (derived from current code, 2026-04-21):**
+ *
+ *   - `upsert(chunks[])`: stores each chunk keyed by `chunk.id`. Re-upsert
+ *     of a chunk with the same id REPLACES — no merge, no error. Tenant
+ *     scoping is carried on each chunk, not enforced at upsert (the
+ *     caller is trusted).
+ *   - `search(query)`: returns `VectorSearchResult[]`:
+ *     - Filters by `tenantId` (EXACT match).
+ *     - If `knowledgeBaseId` is set, filters by that too.
+ *     - Skips chunks with `embedding === undefined`.
+ *     - Applies `filter` as metadata-equality AND across the whole
+ *       filter object.
+ *     - Computes similarity via `cosineSimilarity(query, chunk.embedding)`.
+ *     - If `minScore` is set, drops scores below it.
+ *     - Sorts descending by score and returns the top `topK` results.
+ *   - `delete(chunkIds[])`: deletes by exact chunk id. Unknown ids are
+ *     silently ignored.
+ *   - `deleteByDocument(documentId)`: NOT tenant-scoped in the
+ *     current API — deletes every chunk with matching `documentId`
+ *     ACROSS tenants. This is an asymmetry with `search` /
+ *     `deleteByKnowledgeBase` and is intentional to pin (Codex #9 flag).
+ *   - `deleteByKnowledgeBase(kbId, tenantId)`: tenant-scoped deletion
+ *     by knowledge base.
+ *   - `cosineSimilarity(a, b)`: returns 0 when arrays differ in length
+ *     OR when either has zero norm. Otherwise returns the standard
+ *     dot-product / (‖a‖·‖b‖) result.
+ */
+import { describe, expect, it } from 'vitest';
+import { InMemoryVectorStore, cosineSimilarity } from './vector-store.js';
+const T1 = 'tenant_1';
+const T2 = 'tenant_2';
+const KB1 = 'kb_1';
+const KB2 = 'kb_2';
+const D1 = 'doc_1';
+const D2 = 'doc_2';
+function chunk(id, overrides = {}) {
+    return {
+        id: id,
+        documentId: D1,
+        knowledgeBaseId: KB1,
+        tenantId: T1,
+        content: `content of ${id}`,
+        index: 0,
+        tokenCount: 10,
+        embedding: [1, 0, 0],
+        metadata: {},
+        createdAt: Date.now(),
+        ...overrides,
+    };
+}
+const baseQuery = {
+    embedding: [1, 0, 0],
+    topK: 10,
+    tenantId: T1,
+};
+describe('InMemoryVectorStore — upsert', () => {
+    it('stores chunks by id; re-upsert replaces', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([chunk('c1', { content: 'v1' })]);
+        await s.upsert([chunk('c1', { content: 'v2' })]);
+        const results = await s.search(baseQuery);
+        expect(results).toHaveLength(1);
+        expect(results[0]?.chunk.content).toBe('v2');
+    });
+});
+describe('InMemoryVectorStore — search', () => {
+    it('enforces tenant isolation on the query path', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('a', { tenantId: T1, embedding: [1, 0, 0] }),
+            chunk('b', { tenantId: T2, embedding: [1, 0, 0] }),
+        ]);
+        const results = await s.search({ ...baseQuery, tenantId: T1 });
+        expect(results.map((r) => r.chunk.id)).toEqual(['a']);
+    });
+    it('filters by knowledgeBaseId when provided', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([chunk('a', { knowledgeBaseId: KB1 }), chunk('b', { knowledgeBaseId: KB2 })]);
+        const results = await s.search({ ...baseQuery, knowledgeBaseId: KB1 });
+        expect(results.map((r) => r.chunk.id)).toEqual(['a']);
+    });
+    it('skips chunks with no embedding', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([chunk('a', { embedding: [1, 0, 0] }), chunk('b', { embedding: undefined })]);
+        const results = await s.search(baseQuery);
+        expect(results.map((r) => r.chunk.id)).toEqual(['a']);
+    });
+    it('applies AND-of-equalities across filter keys', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('a', { metadata: { lang: 'en', year: 2026 } }),
+            chunk('b', { metadata: { lang: 'en', year: 2024 } }),
+            chunk('c', { metadata: { lang: 'tr', year: 2026 } }),
+        ]);
+        const results = await s.search({
+            ...baseQuery,
+            filter: { lang: 'en', year: 2026 },
+        });
+        expect(results.map((r) => r.chunk.id)).toEqual(['a']);
+    });
+    it('applies minScore cutoff', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('same', { embedding: [1, 0, 0] }),
+            chunk('orthogonal', { embedding: [0, 1, 0] }),
+        ]);
+        const results = await s.search({ ...baseQuery, minScore: 0.5 });
+        expect(results.map((r) => r.chunk.id)).toEqual(['same']);
+    });
+    it('sorts descending by score and slices to topK', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('strong', { embedding: [1, 0, 0] }),
+            chunk('medium', { embedding: [0.5, 0.5, 0] }),
+            chunk('weak', { embedding: [0.1, 0.9, 0] }),
+        ]);
+        const results = await s.search({ ...baseQuery, topK: 2 });
+        expect(results.map((r) => r.chunk.id)).toEqual(['strong', 'medium']);
+    });
+});
+describe('InMemoryVectorStore — delete', () => {
+    it('delete(chunkIds) removes each id; unknown ids are silent', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([chunk('a'), chunk('b')]);
+        await s.delete(['a', 'missing']);
+        expect((await s.search(baseQuery)).map((r) => r.chunk.id)).toEqual(['b']);
+    });
+    it('deleteByDocument removes every chunk of the document ACROSS tenants (asymmetry per Codex #9)', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('a', { documentId: D1, tenantId: T1 }),
+            chunk('b', { documentId: D1, tenantId: T2 }),
+            chunk('c', { documentId: D2, tenantId: T1 }),
+        ]);
+        await s.deleteByDocument(D1);
+        // Both D1 chunks gone even though we didn't pass a tenant.
+        expect((await s.search({ ...baseQuery, tenantId: T1 })).map((r) => r.chunk.id)).toEqual(['c']);
+        expect(await s.search({ ...baseQuery, tenantId: T2 })).toEqual([]);
+    });
+    it('deleteByKnowledgeBase is tenant-scoped', async () => {
+        const s = new InMemoryVectorStore();
+        await s.upsert([
+            chunk('a', { knowledgeBaseId: KB1, tenantId: T1 }),
+            chunk('b', { knowledgeBaseId: KB1, tenantId: T2 }),
+        ]);
+        await s.deleteByKnowledgeBase(KB1, T1);
+        expect(await s.search({ ...baseQuery, tenantId: T1 })).toEqual([]);
+        expect((await s.search({ ...baseQuery, tenantId: T2 })).map((r) => r.chunk.id)).toEqual(['b']);
+    });
+});
+describe('cosineSimilarity', () => {
+    it('is 1 for identical non-zero vectors', () => {
+        expect(cosineSimilarity([1, 2, 3], [1, 2, 3])).toBeCloseTo(1);
+    });
+    it('is 0 for orthogonal vectors', () => {
+        expect(cosineSimilarity([1, 0], [0, 1])).toBe(0);
+    });
+    it('is 0 when vectors differ in length', () => {
+        expect(cosineSimilarity([1, 0], [1, 0, 0])).toBe(0);
+    });
+    it('is 0 when either vector has zero norm', () => {
+        expect(cosineSimilarity([0, 0], [1, 1])).toBe(0);
+        expect(cosineSimilarity([1, 1], [0, 0])).toBe(0);
+    });
+});
+//# sourceMappingURL=vector-store.test.js.map

package/dist/rag/vector-store.test.js.map

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

package/dist/registry/ManagedRegistry.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `ManagedRegistry` extends `Registry` with a component-named
+ *     logger + two optional id-extraction strategies: `idField` or
+ *     `computeId`. `computeId` takes precedence when both are set.
+ *   - `register(id, item)` (2-arg): throws when `item` is missing;
+ *     warn-logs + overwrites on duplicate id (no typed error).
+ *   - `register(item)` (1-arg): extracts id via computeId/idField;
+ *     throws when neither is configured.
+ *   - `register(items[])`: batch-registers (recursively calls the
+ *     single-arg path for each). Any failure in a single register
+ *     throws and aborts the batch (no partial-success semantics).
+ *   - `getOrThrow(id)`: returns the item; throws
+ *     `new Error("Not found: <id>. Available: <csv of known ids>")`
+ *     — a plain `Error`, NOT a typed `XYZNotFoundError` (Codex #1).
+ *   - No start / stop lifecycle exists (design §2.3 claim was
+ *     fictional).
+ */
+export {};
+//# sourceMappingURL=ManagedRegistry.test.d.ts.map

package/dist/registry/ManagedRegistry.test.d.ts.map

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

package/dist/registry/ManagedRegistry.test.js

@@ -0,0 +1,98 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `ManagedRegistry` extends `Registry` with a component-named
+ *     logger + two optional id-extraction strategies: `idField` or
+ *     `computeId`. `computeId` takes precedence when both are set.
+ *   - `register(id, item)` (2-arg): throws when `item` is missing;
+ *     warn-logs + overwrites on duplicate id (no typed error).
+ *   - `register(item)` (1-arg): extracts id via computeId/idField;
+ *     throws when neither is configured.
+ *   - `register(items[])`: batch-registers (recursively calls the
+ *     single-arg path for each). Any failure in a single register
+ *     throws and aborts the batch (no partial-success semantics).
+ *   - `getOrThrow(id)`: returns the item; throws
+ *     `new Error("Not found: <id>. Available: <csv of known ids>")`
+ *     — a plain `Error`, NOT a typed `XYZNotFoundError` (Codex #1).
+ *   - No start / stop lifecycle exists (design §2.3 claim was
+ *     fictional).
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { ManagedRegistry } from './ManagedRegistry.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;
+}
+describe('ManagedRegistry', () => {
+    describe('register (2-arg form)', () => {
+        it('throws when called with (id) only', () => {
+            const r = new ManagedRegistry({ componentName: 't' });
+            // biome-ignore lint/suspicious/noExplicitAny: exercises the no-item-arg path
+            expect(() => r.register('a')).toThrow(/requires an item argument/);
+        });
+        it('warn-logs then overwrites on duplicate id', () => {
+            const logger = makeLogger();
+            const r = new ManagedRegistry({ componentName: 't', logger });
+            const a = { id: 'a', info: { id: 'a' }, value: 1 };
+            const b = { id: 'a', info: { id: 'a' }, value: 2 };
+            r.register('a', a);
+            r.register('a', b);
+            expect(r.get('a')?.value).toBe(2);
+            expect(logger.warn).toHaveBeenCalledWith(expect.stringContaining('"a" already registered'));
+        });
+    });
+    describe('register (single-item form)', () => {
+        it('uses idField when computeId is not set', () => {
+            const r = new ManagedRegistry({ componentName: 't', idField: 'id' });
+            r.register({ id: 'a', info: { id: 'nested' }, value: 1 });
+            expect(r.get('a')).toBeDefined();
+            expect(r.get('nested')).toBeUndefined();
+        });
+        it('computeId takes precedence over idField when both are set', () => {
+            const r = new ManagedRegistry({
+                componentName: 't',
+                idField: 'id',
+                computeId: (item) => item.info.id,
+            });
+            r.register({ id: 'top', info: { id: 'nested' }, value: 1 });
+            expect(r.get('nested')).toBeDefined();
+            expect(r.get('top')).toBeUndefined();
+        });
+        it('throws when neither idField nor computeId is configured', () => {
+            const r = new ManagedRegistry({ componentName: 't' });
+            expect(() => r.register({ id: 'a', info: { id: 'a' }, value: 1 })).toThrow(/requires idField or computeId/);
+        });
+    });
+    describe('register (array form)', () => {
+        it('batch-registers via the single-item path', () => {
+            const r = new ManagedRegistry({ componentName: 't', idField: 'id' });
+            r.register([
+                { id: 'a', info: { id: 'a' }, value: 1 },
+                { id: 'b', info: { id: 'b' }, value: 2 },
+            ]);
+            expect(r.listIds()).toEqual(['a', 'b']);
+        });
+    });
+    describe('getOrThrow', () => {
+        it('returns the item when present', () => {
+            const r = new ManagedRegistry({ componentName: 't', idField: 'id' });
+            const a = { id: 'a', info: { id: 'a' }, value: 1 };
+            r.register(a);
+            expect(r.getOrThrow('a')).toBe(a);
+        });
+        it('throws a plain Error naming the missing id + available ids', () => {
+            const r = new ManagedRegistry({ componentName: 't', idField: 'id' });
+            r.register({ id: 'a', info: { id: 'a' }, value: 1 });
+            r.register({ id: 'b', info: { id: 'b' }, value: 2 });
+            expect(() => r.getOrThrow('missing')).toThrow(/Not found: "missing"\. Available: a, b/);
+        });
+    });
+});
+//# sourceMappingURL=ManagedRegistry.test.js.map

package/dist/registry/ManagedRegistry.test.js.map

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

package/dist/registry/Registry.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `register(id, item)` silently overwrites an existing entry —
+ *     NO duplicate-error is thrown (Codex #1 verified the design
+ *     §2.3 "typed DuplicateRegistrationError" claim was fiction).
+ *   - `get(id)` returns `undefined` for an unknown id (NOT a typed
+ *     error). `getAll`, `listIds`, `has`, `size` reflect the current
+ *     `Map` state; iteration order follows insertion order.
+ *   - `unregister(id)` returns true if the entry existed (and was
+ *     deleted), false otherwise.
+ *   - `clear()` empties the map.
+ *   - The generic `Registry<T>` has no component name, no logger, no
+ *     lifecycle. All enrichment (logs, idField inference, lifecycle)
+ *     happens in `ManagedRegistry`, not here.
+ */
+export {};
+//# sourceMappingURL=Registry.test.d.ts.map

package/dist/registry/Registry.test.d.ts.map

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

package/dist/registry/Registry.test.js

@@ -0,0 +1,79 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `register(id, item)` silently overwrites an existing entry —
+ *     NO duplicate-error is thrown (Codex #1 verified the design
+ *     §2.3 "typed DuplicateRegistrationError" claim was fiction).
+ *   - `get(id)` returns `undefined` for an unknown id (NOT a typed
+ *     error). `getAll`, `listIds`, `has`, `size` reflect the current
+ *     `Map` state; iteration order follows insertion order.
+ *   - `unregister(id)` returns true if the entry existed (and was
+ *     deleted), false otherwise.
+ *   - `clear()` empties the map.
+ *   - The generic `Registry<T>` has no component name, no logger, no
+ *     lifecycle. All enrichment (logs, idField inference, lifecycle)
+ *     happens in `ManagedRegistry`, not here.
+ */
+import { describe, expect, it } from 'vitest';
+import { Registry } from './Registry.js';
+describe('Registry', () => {
+    it('register + get + has roundtrip', () => {
+        const r = new Registry();
+        const a = { id: 'a', value: 1 };
+        r.register('a', a);
+        expect(r.get('a')).toBe(a);
+        expect(r.has('a')).toBe(true);
+        expect(r.get('b')).toBeUndefined();
+        expect(r.has('b')).toBe(false);
+    });
+    it('register silently overwrites an existing key', () => {
+        const r = new Registry();
+        r.register('a', { id: 'a', value: 1 });
+        r.register('a', { id: 'a', value: 2 });
+        expect(r.get('a')?.value).toBe(2);
+        expect(r.size()).toBe(1);
+    });
+    it('listIds reflects insertion order', () => {
+        const r = new Registry();
+        r.register('x', { id: 'x', value: 1 });
+        r.register('y', { id: 'y', value: 2 });
+        r.register('z', { id: 'z', value: 3 });
+        expect(r.listIds()).toEqual(['x', 'y', 'z']);
+    });
+    it('getAll returns every item in insertion order', () => {
+        const r = new Registry();
+        const items = [
+            { id: 'a', value: 1 },
+            { id: 'b', value: 2 },
+        ];
+        for (const item of items)
+            r.register(item.id, item);
+        expect(r.getAll()).toEqual(items);
+    });
+    it('unregister returns true iff the key existed', () => {
+        const r = new Registry();
+        r.register('a', { id: 'a', value: 1 });
+        expect(r.unregister('a')).toBe(true);
+        expect(r.unregister('a')).toBe(false);
+        expect(r.get('a')).toBeUndefined();
+    });
+    it('clear empties the map', () => {
+        const r = new Registry();
+        r.register('a', { id: 'a', value: 1 });
+        r.register('b', { id: 'b', value: 2 });
+        r.clear();
+        expect(r.size()).toBe(0);
+        expect(r.getAll()).toEqual([]);
+    });
+    it('size matches the map size', () => {
+        const r = new Registry();
+        expect(r.size()).toBe(0);
+        r.register('a', { id: 'a', value: 1 });
+        expect(r.size()).toBe(1);
+        r.register('a', { id: 'a', value: 2 }); // overwrite
+        expect(r.size()).toBe(1);
+        r.register('b', { id: 'b', value: 3 });
+        expect(r.size()).toBe(2);
+    });
+});
+//# sourceMappingURL=Registry.test.js.map

package/dist/registry/Registry.test.js.map

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

package/dist/registry/agent/definitions.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `AgentRegistry` extends `ManagedRegistry<AgentDefinition>` and
+ *     keys by `def.info.id` via `computeId` (NOT by the top-level id
+ *     field — there isn't one on AgentDefinition).
+ *   - `resolve(agentId)` returns `.typedAgent`; delegates to
+ *     `getOrThrow` and therefore throws a plain `Error` when missing.
+ *   - `listByType(type)` filters by `typedAgent.type`.
+ *   - `search({category?, query?})` filters by info.category then by
+ *     case-insensitive match against name OR description. An empty
+ *     query matches all.
+ */
+export {};
+//# sourceMappingURL=definitions.test.d.ts.map

package/dist/registry/agent/definitions.test.d.ts.map

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

package/dist/registry/agent/definitions.test.js

@@ -0,0 +1,84 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `AgentRegistry` extends `ManagedRegistry<AgentDefinition>` and
+ *     keys by `def.info.id` via `computeId` (NOT by the top-level id
+ *     field — there isn't one on AgentDefinition).
+ *   - `resolve(agentId)` returns `.typedAgent`; delegates to
+ *     `getOrThrow` and therefore throws a plain `Error` when missing.
+ *   - `listByType(type)` filters by `typedAgent.type`.
+ *   - `search({category?, query?})` filters by info.category then by
+ *     case-insensitive match against name OR description. An empty
+ *     query matches all.
+ */
+import { describe, expect, it } from 'vitest';
+import { AgentRegistry } from './definitions.js';
+function makeDef(id, type, overrides = {}) {
+    const info = {
+        id,
+        name: `Agent ${id}`,
+        version: '1.0.0',
+        category: 'general',
+        description: `agent ${id} does stuff`,
+        tools: [],
+        defaults: { model: 'opus', tokenBudget: 1000 },
+        ...overrides,
+    };
+    const typedAgent = { type };
+    return { info, typedAgent };
+}
+describe('AgentRegistry', () => {
+    it('keys by info.id (computeId), not by a top-level id field', () => {
+        const r = new AgentRegistry();
+        r.register(makeDef('coder', 'reactive'));
+        expect(r.get('coder')).toBeDefined();
+    });
+    it('resolve returns typedAgent', () => {
+        const r = new AgentRegistry();
+        const def = makeDef('coder', 'reactive');
+        r.register(def);
+        expect(r.resolve('coder')).toBe(def.typedAgent);
+    });
+    it('resolve throws (plain Error) on unknown agentId', () => {
+        const r = new AgentRegistry();
+        expect(() => r.resolve('nope')).toThrow(/Not found/);
+    });
+    it('listByType filters by typedAgent.type', () => {
+        const r = new AgentRegistry();
+        r.register(makeDef('a', 'reactive'));
+        r.register(makeDef('b', 'pipeline'));
+        r.register(makeDef('c', 'reactive'));
+        expect(r.listByType('reactive').map((d) => d.info.id)).toEqual(['a', 'c']);
+        expect(r.listByType('pipeline').map((d) => d.info.id)).toEqual(['b']);
+    });
+    describe('search', () => {
+        it('empty query returns all', () => {
+            const r = new AgentRegistry();
+            r.register(makeDef('a', 'reactive'));
+            r.register(makeDef('b', 'pipeline'));
+            expect(r.search({})).toHaveLength(2);
+        });
+        it('category filter is strict-equal', () => {
+            const r = new AgentRegistry();
+            r.register(makeDef('coder', 'reactive', { category: 'coding' }));
+            r.register(makeDef('writer', 'reactive', { category: 'writing' }));
+            expect(r.search({ category: 'coding' }).map((d) => d.info.id)).toEqual(['coder']);
+        });
+        it('query matches name OR description case-insensitively', () => {
+            const r = new AgentRegistry();
+            r.register(makeDef('alpha', 'reactive', { name: 'CoderBot', description: 'writes code' }));
+            r.register(makeDef('beta', 'reactive', { name: 'Other', description: 'tests CODE' }));
+            r.register(makeDef('gamma', 'reactive', { name: 'Third', description: 'documentation' }));
+            const hits = r.search({ query: 'code' }).map((d) => d.info.id);
+            expect(hits).toEqual(['alpha', 'beta']);
+        });
+        it('combines category + query', () => {
+            const r = new AgentRegistry();
+            r.register(makeDef('alpha', 'reactive', { category: 'coding', name: 'CoderBot' }));
+            r.register(makeDef('beta', 'reactive', { category: 'writing', name: 'CoderWriter' }));
+            const hits = r.search({ category: 'coding', query: 'coder' }).map((d) => d.info.id);
+            expect(hits).toEqual(['alpha']);
+        });
+    });
+});
+//# sourceMappingURL=definitions.test.js.map

package/dist/registry/agent/definitions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.test.js","sourceRoot":"","sources":["../../../src/registry/agent/definitions.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAO7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,SAAS,OAAO,CAAC,EAAU,EAAE,IAAe,EAAE,YAAgC,EAAE;IAC/E,MAAM,IAAI,GAAc;QACvB,EAAE;QACF,IAAI,EAAE,SAAS,EAAE,EAAE;QACnB,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,SAAS,EAAE,aAAa;QACrC,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE;QAC9C,GAAG,SAAS;KACZ,CAAA;IACD,MAAM,UAAU,GAAG,EAAE,IAAI,EAAwD,CAAA;IACjF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC5B,CAAC;AAED,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;QAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;QACxC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACf,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;QAC7B,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;QAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QAC1E,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YAClC,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;YAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;YACpC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;YACpC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;YAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;YAChE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;YAClE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAClF,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC/D,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;YAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;YAC1F,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAA;YACrF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC,CAAA;YAEzF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9D,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;YAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;YAClF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;YACrF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnF,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAChC,CAAC,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/registry/connector/definitions.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 3):
+ *
+ *   - `ConnectorRegistry` extends `ManagedRegistry<ConnectorDefinition>`
+ *     with `idField: 'id'` — it keys by the top-level `id` field, NOT
+ *     a nested path.
+ *   - `listByType(connectionType)` filters by `connectionType`.
+ *   - As a global (non-tenant-scoped) registry, ConnectorRegistry is
+ *     shared across tenants; tenant isolation lives in
+ *     `TenantConnectorManager` per Codex #5.
+ */
+export {};
+//# sourceMappingURL=definitions.test.d.ts.map

package/dist/registry/connector/definitions.test.d.ts.map

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