@namzu/sdk 14.0.6 → 15.0.0

package/dist/rag/knowledge-base.test.js

@@ -1,77 +0,0 @@
-/**
- * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
- *
- *   - `DefaultKnowledgeBase` is a composition layer: it builds an
- *     ingestion pipeline + a retriever from its config and delegates
- *     `ingest` / `query` / `remove` / `clear` to them.
- *   - `id` is set from `config.id` if provided, else generated once
- *     via `generateKnowledgeBaseId` — never regenerated later.
- *   - `ingest(content, metadata)` invokes the ingestion pipeline with
- *     the configured scope + kb id; returns whatever the pipeline
- *     returns.
- *   - `query(query)` invokes the retriever with scope + kb id.
- *   - `clear()` calls `vectorStore.deleteByKnowledgeBase(id, tenantId)`.
- *   - `remove(documentId)` calls `vectorStore.deleteByDocument`.
- */
-import { describe, expect, it, vi } from 'vitest';
-import { DefaultKnowledgeBase } from './knowledge-base.js';
-const TENANT = 't_1';
-function makeVectorStore() {
-    return {
-        upsert: vi.fn(),
-        search: vi.fn(async () => []),
-        delete: vi.fn(),
-        deleteByDocument: vi.fn(),
-        deleteByKnowledgeBase: vi.fn(),
-    };
-}
-function makeEmbedder() {
-    return {
-        id: 'mock',
-        model: 'x',
-        dimensions: 3,
-        embed: vi.fn(async (texts) => texts.map(() => [1, 0, 0])),
-        embedQuery: vi.fn(async () => [1, 0, 0]),
-    };
-}
-describe('DefaultKnowledgeBase', () => {
-    it('uses the id provided in config when set', () => {
-        const kb = new DefaultKnowledgeBase({ id: 'kb_fixed', name: 'kb', tenantId: TENANT }, makeVectorStore(), makeEmbedder());
-        expect(kb.id).toBe('kb_fixed');
-        expect(kb.config.id).toBe('kb_fixed');
-    });
-    it('generates an id when none is provided', () => {
-        const kb = new DefaultKnowledgeBase({ name: 'kb', tenantId: TENANT }, makeVectorStore(), makeEmbedder());
-        expect(kb.id).toMatch(/^kb_/);
-    });
-    it('ingest delegates to the ingestion pipeline and carries metadata through', async () => {
-        const vs = makeVectorStore();
-        const kb = new DefaultKnowledgeBase({ id: 'kb_fixed', name: 'kb', tenantId: TENANT }, vs, makeEmbedder());
-        const result = await kb.ingest('hello world', { source: 'readme' });
-        expect(result.documentId).toMatch(/^doc_/);
-        expect(vs.upsert).toHaveBeenCalled();
-        const chunks = vi.mocked(vs.upsert).mock.calls[0]?.[0] ?? [];
-        expect(chunks[0]?.knowledgeBaseId).toBe('kb_fixed');
-        expect(chunks[0]?.tenantId).toBe(TENANT);
-    });
-    it('remove delegates to vectorStore.deleteByDocument', async () => {
-        const vs = makeVectorStore();
-        const kb = new DefaultKnowledgeBase({ name: 'kb', tenantId: TENANT }, vs, makeEmbedder());
-        await kb.remove('doc_1');
-        expect(vs.deleteByDocument).toHaveBeenCalledWith('doc_1');
-    });
-    it('clear delegates to vectorStore.deleteByKnowledgeBase with id + tenantId', async () => {
-        const vs = makeVectorStore();
-        const kb = new DefaultKnowledgeBase({ id: 'kb_fixed', name: 'kb', tenantId: TENANT }, vs, makeEmbedder());
-        await kb.clear();
-        expect(vs.deleteByKnowledgeBase).toHaveBeenCalledWith('kb_fixed', TENANT);
-    });
-    it('query delegates to retriever', async () => {
-        const vs = makeVectorStore();
-        const kb = new DefaultKnowledgeBase({ name: 'kb', tenantId: TENANT }, vs, makeEmbedder());
-        const out = await kb.query({ text: 'hi' });
-        expect(out.mode).toBeDefined();
-        expect(vs.search).toHaveBeenCalled();
-    });
-});
-//# sourceMappingURL=knowledge-base.test.js.map

package/dist/rag/knowledge-base.test.js.map

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

package/dist/rag/rag-tool.test.d.ts

@@ -1,21 +0,0 @@
-/**
- * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
- *
- *   - `createRAGTool(config)` returns a `defineTool`-wrapped
- *     `knowledge_search` tool with `category: 'analysis'`,
- *     `permissions: ['network_access']`, read-only.
- *   - Knowledge base selection:
- *     - If `input.knowledge_base_id` is set, looks up by it.
- *     - Else uses `config.defaultKnowledgeBaseId`.
- *     - Else picks the first value from
- *       `config.knowledgeBases.values().next()`.
- *   - Returns `{success: false, error: ...}` if no knowledge base is
- *     resolved.
- *   - When the query returns no chunks, returns the literal
- *     "No relevant information found..." message.
- *   - When chunks exist, assembles them via `assembleRAGContext` and
- *     returns `{success: true, output: content, data: {sources, mode, durationMs}}`.
- *   - `top_k` override precedence: input > config.topK > 5.
- */
-export {};
-//# sourceMappingURL=rag-tool.test.d.ts.map

package/dist/rag/rag-tool.test.d.ts.map

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

package/dist/rag/rag-tool.test.js

@@ -1,149 +0,0 @@
-/**
- * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
- *
- *   - `createRAGTool(config)` returns a `defineTool`-wrapped
- *     `knowledge_search` tool with `category: 'analysis'`,
- *     `permissions: ['network_access']`, read-only.
- *   - Knowledge base selection:
- *     - If `input.knowledge_base_id` is set, looks up by it.
- *     - Else uses `config.defaultKnowledgeBaseId`.
- *     - Else picks the first value from
- *       `config.knowledgeBases.values().next()`.
- *   - Returns `{success: false, error: ...}` if no knowledge base is
- *     resolved.
- *   - When the query returns no chunks, returns the literal
- *     "No relevant information found..." message.
- *   - When chunks exist, assembles them via `assembleRAGContext` and
- *     returns `{success: true, output: content, data: {sources, mode, durationMs}}`.
- *   - `top_k` override precedence: input > config.topK > 5.
- */
-import { describe, expect, it, vi } from 'vitest';
-import { createRAGTool } from './rag-tool.js';
-const TENANT = 't_1';
-const KB_A = 'kb_a';
-const KB_B = 'kb_b';
-function makeKB(retrievalResult) {
-    const kb = {
-        id: KB_A,
-        config: { id: KB_A, tenantId: TENANT },
-        ingest: vi.fn(),
-        remove: vi.fn(),
-        query: vi.fn(async () => retrievalResult),
-        clear: vi.fn(),
-    };
-    return kb;
-}
-function searchResult(content) {
-    return {
-        chunk: {
-            id: 'c_1',
-            documentId: 'd_1',
-            knowledgeBaseId: KB_A,
-            tenantId: TENANT,
-            content,
-            index: 0,
-            tokenCount: 0,
-            metadata: {},
-            createdAt: 0,
-        },
-        score: 0.9,
-    };
-}
-const ctx = {};
-describe('createRAGTool', () => {
-    it('is named knowledge_search + read-only', () => {
-        const tool = createRAGTool({ knowledgeBases: new Map() });
-        expect(tool.name).toBe('knowledge_search');
-        expect(tool.isReadOnly?.({ query: 'x' })).toBe(true);
-    });
-    it('returns an error when no knowledge base is resolved', async () => {
-        const tool = createRAGTool({ knowledgeBases: new Map() });
-        const result = await tool.execute({ query: 'hi' }, ctx);
-        expect(result.success).toBe(false);
-        expect(result.error).toMatch(/Knowledge base not found/);
-    });
-    it('picks KB by explicit input.knowledge_base_id when set', async () => {
-        const kbA = makeKB({
-            chunks: [searchResult('from A')],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 1,
-        });
-        const kbB = makeKB({
-            chunks: [searchResult('from B')],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 1,
-        });
-        const tool = createRAGTool({
-            knowledgeBases: new Map([
-                [KB_A, kbA],
-                [KB_B, kbB],
-            ]),
-        });
-        const out = await tool.execute({ query: 'hi', knowledge_base_id: KB_B }, ctx);
-        expect(out.success).toBe(true);
-        expect(kbB.query).toHaveBeenCalled();
-        expect(kbA.query).not.toHaveBeenCalled();
-    });
-    it('falls back to defaultKnowledgeBaseId when input.knowledge_base_id is absent', async () => {
-        const kbA = makeKB({
-            chunks: [searchResult('from A')],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 1,
-        });
-        const kbB = makeKB({
-            chunks: [],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 1,
-        });
-        const tool = createRAGTool({
-            knowledgeBases: new Map([
-                [KB_A, kbA],
-                [KB_B, kbB],
-            ]),
-            defaultKnowledgeBaseId: KB_B,
-        });
-        await tool.execute({ query: 'hi' }, ctx);
-        expect(kbB.query).toHaveBeenCalled();
-        expect(kbA.query).not.toHaveBeenCalled();
-    });
-    it('returns "No relevant information..." when the query returns zero chunks', async () => {
-        const kb = makeKB({ chunks: [], query: 'hi', mode: 'vector', durationMs: 1 });
-        const tool = createRAGTool({ knowledgeBases: new Map([[KB_A, kb]]) });
-        const result = await tool.execute({ query: 'hi' }, ctx);
-        expect(result.success).toBe(true);
-        expect(result.output).toBe('No relevant information found in the knowledge base for this query.');
-    });
-    it('returns assembled content + metadata on hit', async () => {
-        const kb = makeKB({
-            chunks: [searchResult('answer text')],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 42,
-        });
-        const tool = createRAGTool({ knowledgeBases: new Map([[KB_A, kb]]) });
-        const result = await tool.execute({ query: 'hi' }, ctx);
-        expect(result.success).toBe(true);
-        expect(result.output).toContain('answer text');
-        expect(result.data?.mode).toBe('vector');
-        expect(result.data?.durationMs).toBe(42);
-    });
-    it('top_k override: input > config.topK > 5 default', async () => {
-        const kb = makeKB({
-            chunks: [searchResult('x')],
-            query: 'hi',
-            mode: 'vector',
-            durationMs: 1,
-        });
-        const tool = createRAGTool({
-            knowledgeBases: new Map([[KB_A, kb]]),
-            topK: 8,
-        });
-        await tool.execute({ query: 'hi', top_k: 3 }, ctx);
-        expect(kb.query).toHaveBeenCalledWith(expect.objectContaining({ config: { topK: 3 } }));
-    });
-});
-//# sourceMappingURL=rag-tool.test.js.map

package/dist/rag/rag-tool.test.js.map

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

package/dist/rag/retriever.test.d.ts

@@ -1,26 +0,0 @@
-/**
- * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
- *
- *   - `DefaultRetriever.retrieve(query, scope, kbId)` dispatches by
- *     `effectiveConfig.mode` (query.config overrides instance config).
- *   - Query expansion: if `recentMessages` is present and non-empty,
- *     appends the last 3 messages joined with spaces after a
- *     `\n\nContext: ` marker. Otherwise passes `query.text` verbatim.
- *   - `vector` mode: embeds the (expanded) query once, forwards
- *     `{embedding, topK, tenantId, knowledgeBaseId, minScore}` to the
- *     store, returns store results unchanged.
- *   - `keyword` mode: fetches `topK * 2` results from vector search with
- *     `minScore: 0`, then rescores via BM25 against the query's
- *     tokenized form. Filters score > 0, sorts desc, slices to topK.
- *     Tokenization: lowercase, strip non-`\w\s`, split by whitespace,
- *     drop tokens length ≤ 1.
- *   - `hybrid` mode: runs vector + keyword in parallel, merges by
- *     `chunk.id`, weights vector by `alpha` and keyword by `1 - alpha`
- *     (default alpha = 0.7). Sorts desc, slices to topK.
- *   - Result shape: `{chunks, query, expandedQuery?, mode, durationMs}`.
- *     `expandedQuery` is omitted when equal to original `query.text`.
- *   - Unknown mode would hit the exhaustive throw (unreachable via
- *     types; not asserted).
- */
-export {};
-//# sourceMappingURL=retriever.test.d.ts.map

package/dist/rag/retriever.test.d.ts.map

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

package/dist/rag/retriever.test.js

@@ -1,180 +0,0 @@
-/**
- * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
- *
- *   - `DefaultRetriever.retrieve(query, scope, kbId)` dispatches by
- *     `effectiveConfig.mode` (query.config overrides instance config).
- *   - Query expansion: if `recentMessages` is present and non-empty,
- *     appends the last 3 messages joined with spaces after a
- *     `\n\nContext: ` marker. Otherwise passes `query.text` verbatim.
- *   - `vector` mode: embeds the (expanded) query once, forwards
- *     `{embedding, topK, tenantId, knowledgeBaseId, minScore}` to the
- *     store, returns store results unchanged.
- *   - `keyword` mode: fetches `topK * 2` results from vector search with
- *     `minScore: 0`, then rescores via BM25 against the query's
- *     tokenized form. Filters score > 0, sorts desc, slices to topK.
- *     Tokenization: lowercase, strip non-`\w\s`, split by whitespace,
- *     drop tokens length ≤ 1.
- *   - `hybrid` mode: runs vector + keyword in parallel, merges by
- *     `chunk.id`, weights vector by `alpha` and keyword by `1 - alpha`
- *     (default alpha = 0.7). Sorts desc, slices to topK.
- *   - Result shape: `{chunks, query, expandedQuery?, mode, durationMs}`.
- *     `expandedQuery` is omitted when equal to original `query.text`.
- *   - Unknown mode would hit the exhaustive throw (unreachable via
- *     types; not asserted).
- */
-import { describe, expect, it, vi } from 'vitest';
-import { DefaultRetriever } from './retriever.js';
-const TENANT = 't_1';
-const KB = 'kb_1';
-const scope = { tenantId: TENANT };
-function chunk(id, content) {
-    return {
-        id: id,
-        documentId: 'doc_1',
-        knowledgeBaseId: KB,
-        tenantId: TENANT,
-        content,
-        index: 0,
-        tokenCount: 0,
-        embedding: [1, 0, 0],
-        metadata: {},
-        createdAt: 0,
-    };
-}
-function r(id, content, score) {
-    return { chunk: chunk(id, content), score };
-}
-function makeStore(searchResults) {
-    return {
-        search: vi.fn(async () => searchResults),
-        upsert: vi.fn(),
-        delete: vi.fn(),
-        deleteByDocument: vi.fn(),
-        deleteByKnowledgeBase: vi.fn(),
-    };
-}
-function makeEmbedder() {
-    return {
-        id: 'mock',
-        model: 'x',
-        dimensions: 3,
-        embed: vi.fn(async (texts) => texts.map(() => [1, 0, 0])),
-        embedQuery: vi.fn(async () => [1, 0, 0]),
-    };
-}
-describe('DefaultRetriever — vector mode', () => {
-    it('forwards embedded query + topK + tenant + minScore to store', async () => {
-        const store = makeStore([r('a', 'x', 0.9)]);
-        const emb = makeEmbedder();
-        const retriever = new DefaultRetriever(store, emb, {
-            mode: 'vector',
-            topK: 3,
-            minScore: 0.2,
-        });
-        await retriever.retrieve({ text: 'hi' }, scope, KB);
-        expect(store.search).toHaveBeenCalledWith(expect.objectContaining({
-            embedding: [1, 0, 0],
-            topK: 3,
-            tenantId: TENANT,
-            knowledgeBaseId: KB,
-            minScore: 0.2,
-        }));
-    });
-    it('returns mode + durationMs + chunks without mutation', async () => {
-        const results = [r('a', 'x', 0.9)];
-        const store = makeStore(results);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'vector',
-            topK: 5,
-        });
-        const out = await retriever.retrieve({ text: 'hi' }, scope);
-        expect(out.mode).toBe('vector');
-        expect(out.chunks).toEqual(results);
-        expect(typeof out.durationMs).toBe('number');
-    });
-});
-describe('DefaultRetriever — query expansion', () => {
-    it('when recentMessages exists, appends "Context: " + last 3 joined', async () => {
-        const store = makeStore([]);
-        const emb = makeEmbedder();
-        const retriever = new DefaultRetriever(store, emb, { mode: 'vector', topK: 3 });
-        const out = await retriever.retrieve({ text: 'query', recentMessages: ['m1', 'm2', 'm3', 'm4'] }, scope);
-        expect(out.expandedQuery).toBe('query\n\nContext: m2 m3 m4');
-        expect(emb.embedQuery).toHaveBeenCalledWith('query\n\nContext: m2 m3 m4');
-    });
-    it('when no recentMessages, expandedQuery is undefined (original == expanded)', async () => {
-        const store = makeStore([]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'vector',
-            topK: 3,
-        });
-        const out = await retriever.retrieve({ text: 'plain' }, scope);
-        expect(out.expandedQuery).toBeUndefined();
-    });
-});
-describe('DefaultRetriever — keyword mode', () => {
-    it('fetches 2*topK from store, rescores via BM25, slices to topK', async () => {
-        // 6 candidate chunks (topK * 2 with topK=3) — retriever requests 2*topK with minScore 0.
-        const store = makeStore([
-            r('a', 'apple orange', 0.1),
-            r('b', 'banana apple apple', 0.1),
-            r('c', 'unrelated text', 0.1),
-            r('d', 'apple apple apple', 0.1),
-            r('e', 'nothing here', 0.1),
-            r('f', 'apple', 0.1),
-        ]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'keyword',
-            topK: 3,
-        });
-        const out = await retriever.retrieve({ text: 'apple' }, scope);
-        expect(out.chunks.length).toBeLessThanOrEqual(3);
-        expect(out.chunks.every((c) => c.score > 0)).toBe(true);
-        // Tokenization: 'nothing' + 'here' — doesn't contain 'apple' → score 0 → filtered.
-        expect(out.chunks.every((c) => c.chunk.id !== 'e')).toBe(true);
-    });
-    it('query store is called with minScore: 0 + topK*2', async () => {
-        const store = makeStore([r('a', 'apple', 0.5)]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'keyword',
-            topK: 2,
-        });
-        await retriever.retrieve({ text: 'apple' }, scope);
-        expect(store.search).toHaveBeenCalledWith(expect.objectContaining({ topK: 4, minScore: 0 }));
-    });
-});
-describe('DefaultRetriever — hybrid mode', () => {
-    it('merges by chunk.id, weighted by alpha (default 0.7)', async () => {
-        const store = makeStore([r('a', 'apple', 1), r('b', 'banana', 0.5)]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'hybrid',
-            topK: 5,
-        });
-        const out = await retriever.retrieve({ text: 'apple' }, scope);
-        // Vector side: a=0.7, b=0.35. Keyword side (BM25): a matches → >0; b=0.
-        // Hybrid: a stays high; b gets only vector weight.
-        expect(out.chunks[0]?.chunk.id).toBe('a');
-    });
-    it('chunks in only one side still appear with partial weight', async () => {
-        const store = makeStore([r('a', 'apple', 1)]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'hybrid',
-            topK: 5,
-        });
-        const out = await retriever.retrieve({ text: 'apple' }, scope);
-        expect(out.chunks.length).toBe(1);
-        expect(out.chunks[0]?.score).toBeGreaterThan(0);
-    });
-});
-describe('DefaultRetriever — config merge', () => {
-    it('query.config overrides instance config per-call', async () => {
-        const store = makeStore([r('a', 'x', 0.9)]);
-        const retriever = new DefaultRetriever(store, makeEmbedder(), {
-            mode: 'vector',
-            topK: 5,
-        });
-        await retriever.retrieve({ text: 'hi', config: { topK: 1 } }, scope);
-        expect(store.search).toHaveBeenCalledWith(expect.objectContaining({ topK: 1 }));
-    });
-});
-//# sourceMappingURL=retriever.test.js.map

package/dist/rag/retriever.test.js.map

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

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

@@ -1,38 +0,0 @@
-/**
- * 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.
- *   - `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

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