@kaelio/ktx 0.4.0 → 0.5.0

package/node_modules/@ktx/context/dist/tools/context-evidence-tools.test.js

@@ -1,486 +0,0 @@
-import { createHash } from 'node:crypto';
-import { mkdtemp, rm } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { SqliteContextEvidenceStore } from '../ingest/context-evidence/sqlite-context-evidence-store.js';
-import { ContextCandidateMarkTool } from './context-candidate-mark.tool.js';
-import { ContextCandidateWriteTool } from './context-candidate-write.tool.js';
-import { ContextEvidenceNeighborsTool } from './context-evidence-neighbors.tool.js';
-import { ContextEvidenceReadTool } from './context-evidence-read.tool.js';
-import { ContextEvidenceSearchTool } from './context-evidence-search.tool.js';
-import { createTouchedSlSources } from './index.js';
-const ingestContext = () => ({
-    sourceId: 'ingest',
-    messageId: 'job-1-wu-unit-1',
-    userId: 'system',
-    connectionId: '00000000-0000-0000-0000-000000000001',
-    ingest: {
-        runId: '10000000-0000-0000-0000-000000000001',
-        jobId: 'job-1',
-        syncId: 'sync-1',
-        sourceKey: 'notion',
-    },
-    session: {
-        connectionId: '00000000-0000-0000-0000-000000000001',
-        isWorktreeScoped: true,
-        preHead: 'abc123',
-        touchedSlSources: createTouchedSlSources(),
-        actions: [],
-        ingest: {
-            runId: '10000000-0000-0000-0000-000000000001',
-            jobId: 'job-1',
-            syncId: 'sync-1',
-            sourceKey: 'notion',
-        },
-    },
-});
-const makeEmbeddingService = (overrides = {}) => ({
-    computeEmbedding: vi.fn().mockResolvedValue([0.25, 0.5, 0.75]),
-    ...overrides,
-});
-describe('context evidence tools', () => {
-    it('searches context evidence with ingest defaults', async () => {
-        const repository = {
-            searchRRF: vi.fn().mockResolvedValue([
-                {
-                    chunkId: 'chunk-1',
-                    documentId: 'doc-1',
-                    externalId: 'page-1',
-                    title: 'Revenue Recognition',
-                    path: 'Company Handbook / Finance / Revenue Recognition',
-                    url: 'https://notion.example/page-1',
-                    snippet: 'Booked revenue excludes refunds and test accounts.',
-                    score: 0.35,
-                    citation: { source: 'notion', pageId: 'page-1', rawPath: 'pages/page-1/page.md' },
-                    stableCitationKey: 'notion:page-1:policy:abc',
-                    syncId: 'sync-1',
-                    lastEditedAt: new Date('2026-04-12T10:15:00.000Z'),
-                    matchReasons: ['lexical', 'semantic'],
-                    lanes: [
-                        {
-                            lane: 'lexical',
-                            status: 'available',
-                            requestedCandidatePoolLimit: 25,
-                            effectiveCandidatePoolLimit: 25,
-                            returnedCandidateCount: 1,
-                            weight: 1.5,
-                        },
-                        {
-                            lane: 'semantic',
-                            status: 'available',
-                            requestedCandidatePoolLimit: 25,
-                            effectiveCandidatePoolLimit: 25,
-                            returnedCandidateCount: 1,
-                            weight: 2,
-                        },
-                    ],
-                },
-            ]),
-        };
-        const embeddings = {
-            computeEmbedding: vi.fn().mockResolvedValue([0.1, ...Array.from({ length: 383 }, () => 0)]),
-        };
-        const tool = new ContextEvidenceSearchTool(repository, embeddings);
-        const result = await tool.call({ query: 'revenue refunds', limit: 5, includeDeleted: false }, ingestContext());
-        expect(repository.searchRRF).toHaveBeenCalledWith({
-            connectionId: '00000000-0000-0000-0000-000000000001',
-            sourceKey: 'notion',
-            queryEmbedding: [0.1, ...Array.from({ length: 383 }, () => 0)],
-            queryText: 'revenue refunds',
-            limit: 5,
-            includeDeleted: false,
-            currentRunId: '10000000-0000-0000-0000-000000000001',
-        });
-        expect(result.markdown).toContain('Revenue Recognition');
-        expect(result.markdown).toContain('matchReasons: lexical, semantic');
-        expect(result.structured.success).toBe(true);
-        if (result.structured.success) {
-            expect(result.structured.results[0]).toMatchObject({
-                chunkId: 'chunk-1',
-                stableCitationKey: 'notion:page-1:policy:abc',
-                matchReasons: ['lexical', 'semantic'],
-                lanes: expect.arrayContaining([expect.objectContaining({ lane: 'lexical', status: 'available' })]),
-            });
-        }
-    });
-    it('returns a structured ingest metadata error outside ingest sessions', async () => {
-        const tool = new ContextEvidenceSearchTool({ searchRRF: vi.fn() }, { computeEmbedding: vi.fn() });
-        const result = await tool.call({ query: 'revenue', limit: 5, includeDeleted: false }, { sourceId: 'research', messageId: 'm1', userId: 'user-1' });
-        expect(result.structured).toMatchObject({ success: false, error: 'INGEST_METADATA_REQUIRED' });
-    });
-    it('reads a full document by external id', async () => {
-        const repository = {
-            readDocumentByExternalId: vi.fn().mockResolvedValue({
-                document: {
-                    id: 'doc-1',
-                    title: 'Onboarding SOP',
-                    path: 'Ops / Onboarding SOP',
-                    external_id: 'page-ops',
-                    raw_path: 'pages/page-ops/page.md',
-                    url: 'https://notion.example/page-ops',
-                },
-                chunks: [
-                    {
-                        id: 'chunk-1',
-                        heading_path: ['Onboarding SOP', 'Checklist'],
-                        content: 'Create account, invite to workspace, confirm dashboard access.',
-                        citation: { source: 'notion', pageId: 'page-ops' },
-                    },
-                ],
-            }),
-        };
-        const tool = new ContextEvidenceReadTool(repository);
-        const result = await tool.call({ externalId: 'page-ops', includeNeighborChunks: false }, ingestContext());
-        expect(repository.readDocumentByExternalId).toHaveBeenCalledWith('00000000-0000-0000-0000-000000000001', 'notion', 'page-ops', '10000000-0000-0000-0000-000000000001');
-        expect(result.markdown).toContain('## Onboarding SOP');
-        expect(result.markdown).toContain('Create account');
-        expect(result.structured.success).toBe(true);
-        if (result.structured.success) {
-            expect(result.structured.found).toBe(true);
-        }
-    });
-    it('reads documents and chunks by id with connection and source scope', async () => {
-        const repository = {
-            readDocumentById: vi.fn().mockResolvedValue({
-                document: {
-                    id: '00000000-0000-0000-0000-000000000201',
-                    title: 'Scoped Document',
-                    path: 'Scoped Document',
-                    external_id: 'page-scoped',
-                    url: null,
-                },
-                chunks: [{ id: 'chunk-1', content: 'Scoped content.' }],
-            }),
-            readChunkById: vi.fn().mockResolvedValue({
-                document: {
-                    id: '00000000-0000-0000-0000-000000000201',
-                    title: 'Scoped Document',
-                    path: 'Scoped Document',
-                    external_id: 'page-scoped',
-                    url: null,
-                },
-                chunk: {
-                    id: '00000000-0000-0000-0000-000000000301',
-                    content: 'Scoped chunk.',
-                    citation: { source: 'notion' },
-                },
-            }),
-        };
-        const tool = new ContextEvidenceReadTool(repository);
-        await tool.call({ documentId: '00000000-0000-0000-0000-000000000201', includeNeighborChunks: false }, ingestContext());
-        await tool.call({ chunkId: '00000000-0000-0000-0000-000000000301', includeNeighborChunks: false }, ingestContext());
-        expect(repository.readDocumentById).toHaveBeenCalledWith('00000000-0000-0000-0000-000000000201', '00000000-0000-0000-0000-000000000001', 'notion', '10000000-0000-0000-0000-000000000001');
-        expect(repository.readChunkById).toHaveBeenCalledWith('00000000-0000-0000-0000-000000000301', '00000000-0000-0000-0000-000000000001', 'notion', '10000000-0000-0000-0000-000000000001');
-    });
-    it('lists evidence neighbors', async () => {
-        const repository = {
-            findNeighborDocuments: vi.fn().mockResolvedValue([
-                {
-                    documentId: 'doc-child',
-                    externalId: 'page-child',
-                    title: 'Revenue Caveats',
-                    path: 'Company Handbook / Finance / Revenue Caveats',
-                    relation: 'children',
-                    url: null,
-                    lastEditedAt: null,
-                },
-            ]),
-        };
-        const tool = new ContextEvidenceNeighborsTool(repository);
-        const result = await tool.call({ documentId: 'doc-1', relation: 'children', limit: 10 }, ingestContext());
-        expect(repository.findNeighborDocuments).toHaveBeenCalledWith({
-            connectionId: '00000000-0000-0000-0000-000000000001',
-            sourceKey: 'notion',
-            documentId: 'doc-1',
-            relation: 'children',
-            limit: 10,
-            currentRunId: '10000000-0000-0000-0000-000000000001',
-        });
-        expect(result.markdown).toContain('Revenue Caveats');
-    });
-    it('writes a cited candidate with durable evidence refs', async () => {
-        const repository = {
-            readChunksByIds: vi.fn().mockResolvedValue([
-                {
-                    chunkId: '00000000-0000-0000-0000-000000000101',
-                    documentId: 'doc-1',
-                    externalId: 'page-1',
-                    title: 'Revenue Recognition',
-                    path: 'Company Handbook / Finance / Revenue Recognition',
-                    url: 'https://notion.example/page-1',
-                    rawPath: 'pages/page-1/page.md',
-                    content: 'Booked revenue excludes refunds and test accounts.',
-                    citation: { source: 'notion', pageId: 'page-1', rawPath: 'pages/page-1/page.md' },
-                    stableCitationKey: 'notion:page-1:policy:abc',
-                    syncId: 'sync-1',
-                    lastEditedAt: new Date('2026-04-12T10:15:00.000Z'),
-                },
-            ]),
-            insertCandidate: vi.fn().mockResolvedValue({
-                id: 'candidate-1',
-                candidate_key: 'revenue-definition',
-                promotion_score: 10,
-                status: 'pending',
-            }),
-        };
-        const embeddings = makeEmbeddingService();
-        const tool = new ContextCandidateWriteTool(repository, embeddings);
-        const result = await tool.call({
-            candidateKey: 'revenue-definition',
-            topic: 'Revenue Recognition',
-            assertion: 'Booked revenue excludes refunds and test accounts.',
-            rationale: 'Finance handbook is the source of truth and describes the reusable revenue rule.',
-            evidenceChunkIds: ['00000000-0000-0000-0000-000000000101'],
-            suggestedPageKey: 'revenue-definition',
-            actionHint: 'create',
-            durabilityScore: 3,
-            authorityScore: 3,
-            reuseScore: 3,
-            noveltyScore: 2,
-            riskScore: 1,
-        }, ingestContext());
-        expect(repository.readChunksByIds).toHaveBeenCalledWith(['00000000-0000-0000-0000-000000000101'], '00000000-0000-0000-0000-000000000001', 'notion', '10000000-0000-0000-0000-000000000001');
-        expect(repository.insertCandidate).toHaveBeenCalledWith(expect.objectContaining({
-            runId: '10000000-0000-0000-0000-000000000001',
-            connectionId: '00000000-0000-0000-0000-000000000001',
-            sourceKey: 'notion',
-            candidateKey: 'revenue-definition',
-            promotionScore: 10,
-            status: 'pending',
-            evidenceRefs: [
-                expect.objectContaining({
-                    chunkId: '00000000-0000-0000-0000-000000000101',
-                    stableCitationKey: 'notion:page-1:policy:abc',
-                    snippetHash: createHash('sha256')
-                        .update('Booked revenue excludes refunds and test accounts.')
-                        .digest('hex'),
-                }),
-            ],
-        }));
-        expect(embeddings.computeEmbedding).toHaveBeenCalledWith('Revenue Recognition - Booked revenue excludes refunds and test accounts.');
-        expect(repository.insertCandidate).toHaveBeenCalledWith(expect.objectContaining({
-            embedding: [0.25, 0.5, 0.75],
-        }));
-        expect(result.structured).toMatchObject({ success: true, candidateKey: 'revenue-definition', promotionScore: 10 });
-    });
-    it('saves candidate writes with a null embedding when embedding generation fails', async () => {
-        const repository = {
-            readChunksByIds: vi.fn().mockResolvedValue([
-                {
-                    chunkId: '00000000-0000-0000-0000-000000000101',
-                    documentId: 'doc-1',
-                    externalId: 'page-1',
-                    title: 'Revenue Recognition',
-                    path: 'Company Handbook / Finance / Revenue Recognition',
-                    url: 'https://notion.example/page-1',
-                    rawPath: 'pages/page-1/page.md',
-                    content: 'Booked revenue excludes refunds and test accounts.',
-                    citation: { source: 'notion', pageId: 'page-1', rawPath: 'pages/page-1/page.md' },
-                    stableCitationKey: 'notion:page-1:policy:abc',
-                    syncId: 'sync-1',
-                    lastEditedAt: new Date('2026-04-12T10:15:00.000Z'),
-                },
-            ]),
-            insertCandidate: vi.fn().mockResolvedValue({
-                id: 'candidate-1',
-                candidate_key: 'revenue-definition',
-                promotion_score: 10,
-                status: 'pending',
-            }),
-        };
-        const embeddings = makeEmbeddingService({
-            computeEmbedding: vi.fn().mockRejectedValue(new Error('embedding provider unavailable')),
-        });
-        const tool = new ContextCandidateWriteTool(repository, embeddings);
-        const result = await tool.call({
-            candidateKey: 'revenue-definition',
-            topic: 'Revenue Recognition',
-            assertion: 'Booked revenue excludes refunds and test accounts.',
-            rationale: 'Finance handbook is the source of truth and describes the reusable revenue rule.',
-            evidenceChunkIds: ['00000000-0000-0000-0000-000000000101'],
-            suggestedPageKey: 'revenue-definition',
-            actionHint: 'create',
-            durabilityScore: 3,
-            authorityScore: 3,
-            reuseScore: 3,
-            noveltyScore: 2,
-            riskScore: 1,
-        }, ingestContext());
-        expect(embeddings.computeEmbedding).toHaveBeenCalledWith('Revenue Recognition - Booked revenue excludes refunds and test accounts.');
-        expect(repository.insertCandidate).toHaveBeenCalledWith(expect.objectContaining({
-            embedding: null,
-        }));
-        expect(result.structured).toMatchObject({ success: true, candidateKey: 'revenue-definition', promotionScore: 10 });
-    });
-    it('rejects candidate writes without evidence chunks', async () => {
-        const embeddings = makeEmbeddingService();
-        const tool = new ContextCandidateWriteTool({
-            insertCandidate: vi.fn(),
-        }, embeddings);
-        const result = await tool.call({
-            candidateKey: 'uncited',
-            topic: 'Uncited',
-            assertion: 'This has no evidence.',
-            rationale: 'No evidence was provided.',
-            evidenceChunkIds: [],
-            actionHint: 'create',
-            durabilityScore: 1,
-            authorityScore: 1,
-            reuseScore: 1,
-            noveltyScore: 1,
-            riskScore: 1,
-        }, ingestContext());
-        expect(result.structured).toMatchObject({ success: false, error: 'EVIDENCE_REQUIRED' });
-        expect(embeddings.computeEmbedding).not.toHaveBeenCalled();
-    });
-    it('marks a candidate status during reconciliation', async () => {
-        const repository = {
-            updateCandidateStatus: vi.fn().mockResolvedValue({
-                id: 'candidate-1',
-                candidate_key: 'revenue-definition',
-                status: 'promoted',
-            }),
-        };
-        const tool = new ContextCandidateMarkTool(repository);
-        const result = await tool.call({ candidateKey: 'revenue-definition', status: 'promoted', rejectionReason: null }, ingestContext());
-        expect(repository.updateCandidateStatus).toHaveBeenCalledWith({
-            runId: '10000000-0000-0000-0000-000000000001',
-            candidateKey: 'revenue-definition',
-            status: 'promoted',
-            rejectionReason: null,
-        });
-        expect(result.structured).toMatchObject({ success: true, candidateKey: 'revenue-definition', status: 'promoted' });
-    });
-});
-describe('context evidence tools against real SqliteContextEvidenceStore', () => {
-    let tempDir;
-    let dbPath;
-    beforeEach(async () => {
-        tempDir = await mkdtemp(join(tmpdir(), 'ktx-context-tools-sqlite-'));
-        dbPath = join(tempDir, '.ktx', 'db.sqlite');
-    });
-    afterEach(async () => {
-        await rm(tempDir, { recursive: true, force: true });
-    });
-    const realStoreContext = () => ({
-        sourceId: 'ingest',
-        messageId: 'job-1-wu-unit-1',
-        userId: 'system',
-        connectionId: 'conn-1',
-        ingest: {
-            runId: 'run-1',
-            jobId: 'job-1',
-            syncId: 'sync-1',
-            sourceKey: 'notion',
-        },
-        session: {
-            connectionId: 'conn-1',
-            isWorktreeScoped: true,
-            preHead: 'abc123',
-            touchedSlSources: createTouchedSlSources(),
-            actions: [],
-            ingest: {
-                runId: 'run-1',
-                jobId: 'job-1',
-                syncId: 'sync-1',
-                sourceKey: 'notion',
-            },
-        },
-    });
-    async function seedChunk(store) {
-        const doc = await store.upsertDocument({
-            runId: 'run-1',
-            connectionId: 'conn-1',
-            sourceKey: 'notion',
-            externalId: 'page-1',
-            externalParentId: null,
-            databaseId: null,
-            dataSourceId: null,
-            title: 'Revenue Recognition',
-            path: 'Company Handbook / Finance / Revenue Recognition',
-            url: 'https://notion.test/page-1',
-            objectType: 'page',
-            lastEditedAt: new Date('2026-04-30T10:00:00.000Z'),
-            lastEditedBy: 'user-1',
-            rawPath: 'pages/page-1/page.md',
-            syncId: 'sync-1',
-            contentHash: 'hash-page-1',
-            publishState: 'published',
-            metadata: {},
-        });
-        await store.replaceChunks(doc.id, [
-            {
-                chunkKey: 'intro',
-                headingPath: ['Revenue'],
-                ordinal: 0,
-                content: 'Booked revenue excludes refunds and test accounts.',
-                searchText: 'booked revenue excludes refunds test accounts',
-                embedding: [1, 0, 0],
-                tokenCount: 8,
-                citation: { source: 'notion', pageId: 'page-1', rawPath: 'pages/page-1/page.md' },
-                stableCitationKey: 'notion:page-1:intro',
-                syncId: 'sync-1',
-                contentHash: 'chunk-page-1',
-            },
-        ]);
-        const read = await store.readDocumentByExternalId('conn-1', 'notion', 'page-1', 'run-1');
-        if (!read) {
-            throw new Error('seeded chunk not readable');
-        }
-        return read.chunks[0].id;
-    }
-    it('candidate write accepts the prefixed chunkId returned by the real store and persists', async () => {
-        const store = new SqliteContextEvidenceStore({ dbPath });
-        const chunkId = await seedChunk(store);
-        expect(chunkId).toMatch(/^ctxchunk-[0-9a-f-]{36}$/);
-        const tool = new ContextCandidateWriteTool(store, {
-            computeEmbedding: vi.fn().mockResolvedValue([0.1, 0.2, 0.3]),
-        });
-        const parsed = tool.parseInput({
-            candidateKey: 'revenue-definition',
-            topic: 'Revenue Recognition',
-            assertion: 'Booked revenue excludes refunds and test accounts.',
-            rationale: 'The Finance handbook is the source of truth.',
-            evidenceChunkIds: [chunkId],
-            actionHint: 'create',
-            durabilityScore: 3,
-            authorityScore: 3,
-            reuseScore: 3,
-            noveltyScore: 2,
-            riskScore: 1,
-        });
-        const result = await tool.call(parsed, realStoreContext());
-        expect(result.structured).toMatchObject({
-            success: true,
-            candidateKey: 'revenue-definition',
-            promotionScore: 10,
-            status: 'pending',
-        });
-    });
-    it('candidate write schema rejects a bare UUID without the ctxchunk- prefix', () => {
-        const tool = new ContextCandidateWriteTool({}, { computeEmbedding: vi.fn() });
-        expect(() => tool.parseInput({
-            candidateKey: 'revenue-definition',
-            topic: 'Revenue Recognition',
-            assertion: 'Booked revenue excludes refunds and test accounts.',
-            rationale: 'Finance handbook is the source of truth.',
-            evidenceChunkIds: ['00000000-0000-0000-0000-000000000101'],
-            actionHint: 'create',
-            durabilityScore: 3,
-            authorityScore: 3,
-            reuseScore: 3,
-            noveltyScore: 2,
-            riskScore: 1,
-        })).toThrow(/ctxchunk/);
-    });
-    it('evidence read schema rejects bare UUIDs for chunkId and documentId', () => {
-        const tool = new ContextEvidenceReadTool({});
-        expect(() => tool.parseInput({ chunkId: '00000000-0000-0000-0000-000000000301', includeNeighborChunks: false })).toThrow(/ctxchunk/);
-        expect(() => tool.parseInput({ documentId: '00000000-0000-0000-0000-000000000201', includeNeighborChunks: false })).toThrow(/ctxdoc/);
-    });
-    it('evidence neighbors schema rejects bare UUIDs for documentId', () => {
-        const tool = new ContextEvidenceNeighborsTool({});
-        expect(() => tool.parseInput({ documentId: '00000000-0000-0000-0000-000000000201', relation: 'children', limit: 10 })).toThrow(/ctxdoc/);
-    });
-});

package/node_modules/@ktx/context/dist/tools/index.d.ts

@@ -1,19 +0,0 @@
-export type { GitAuthor, GitAuthorResolverPort } from './authors.js';
-export { SYSTEM_GIT_AUTHOR } from './authors.js';
-export type { MethodologyEntry, ToolContext, ToolOutput, ToolProgressRelayPort, ToolTimingTrackerPort, } from './base-tool.js';
-export { BaseTool } from './base-tool.js';
-export { ContextCandidateMarkTool } from './context-candidate-mark.tool.js';
-export { ContextCandidateWriteTool } from './context-candidate-write.tool.js';
-export { ContextEvidenceNeighborsTool } from './context-evidence-neighbors.tool.js';
-export { ContextEvidenceReadTool } from './context-evidence-read.tool.js';
-export { ContextEvidenceSearchTool } from './context-evidence-search.tool.js';
-export type { ContextCandidateInsertResult, ContextCandidateStatusResult, ContextEvidenceChunkForCandidate, ContextEvidenceChunkForRead, ContextEvidenceChunkReadResult, ContextEvidenceDocumentForRead, ContextEvidenceNeighborResult, ContextEvidenceReadResult, ContextEvidenceSearchArgs, ContextEvidenceSearchResult, ContextEvidenceToolStorePort, } from './context-evidence-tool-store.js';
-export type { ToolFailure } from './context-ingest-metadata.js';
-export { ingestMetadataRequired, resolveIngestMetadata } from './context-ingest-metadata.js';
-export type { SqlEdit } from './sql-edit-replacer.js';
-export { applySqlEdits } from './sql-edit-replacer.js';
-export type { IngestToolMetadata, MemoryAction, ToolSession } from './tool-session.js';
-export { validateActionRawPaths } from './action-raw-paths.js';
-export { validateActionTargetConnection } from './action-target-connection.js';
-export type { TouchedSlSource, TouchedSlSourceSet } from './touched-sl-sources.js';
-export { addTouchedSlSource, createTouchedSlSources, deleteTouchedSlSource, hasTouchedSlSource, listTouchedSlSources, touchedSlSourceCount, touchedSlSourceNamesForConnection, } from './touched-sl-sources.js';

package/node_modules/@ktx/context/dist/tools/index.js

@@ -1,12 +0,0 @@
-export { SYSTEM_GIT_AUTHOR } from './authors.js';
-export { BaseTool } from './base-tool.js';
-export { ContextCandidateMarkTool } from './context-candidate-mark.tool.js';
-export { ContextCandidateWriteTool } from './context-candidate-write.tool.js';
-export { ContextEvidenceNeighborsTool } from './context-evidence-neighbors.tool.js';
-export { ContextEvidenceReadTool } from './context-evidence-read.tool.js';
-export { ContextEvidenceSearchTool } from './context-evidence-search.tool.js';
-export { ingestMetadataRequired, resolveIngestMetadata } from './context-ingest-metadata.js';
-export { applySqlEdits } from './sql-edit-replacer.js';
-export { validateActionRawPaths } from './action-raw-paths.js';
-export { validateActionTargetConnection } from './action-target-connection.js';
-export { addTouchedSlSource, createTouchedSlSources, deleteTouchedSlSource, hasTouchedSlSource, listTouchedSlSources, touchedSlSourceCount, touchedSlSourceNamesForConnection, } from './touched-sl-sources.js';

package/node_modules/@ktx/context/dist/tools/tool-session.d.ts

@@ -1,54 +0,0 @@
-import type { GitService, KtxFileStorePort } from '../core/index.js';
-import type { SemanticLayerService } from '../sl/index.js';
-import type { KnowledgeWikiService } from '../wiki/index.js';
-import type { TouchedSlSourceSet } from './touched-sl-sources.js';
-export interface IngestToolMetadata {
-    runId: string;
-    jobId: string;
-    syncId: string;
-    sourceKey: string;
-}
-export interface MemoryAction {
-    target: 'wiki' | 'sl';
-    type: 'created' | 'updated' | 'removed';
-    key: string;
-    detail: string;
-    targetConnectionId?: string | null;
-    rawPaths?: string[];
-}
-interface EvictionDecisionRecord {
-    rawPath: string;
-    artifactKind: 'wiki' | 'sl';
-    artifactKey: string;
-    action: 'removed';
-    reason: string;
-}
-/**
- * Per-WU (or per-memory-agent) state threaded through ToolContext. When present,
- * SL/wiki tools read session-scoped services and emit touched-set entries / actions
- * instead of hitting shared services. When absent, tools behave as they do for
- * interactive research/workshop callers.
- */
-export interface ToolSession {
-    /**
-     * Warehouse connection targeted by SL tools. `null` when the session has no
-     * warehouse connection (wiki-only memory-agent turns) — SL tools must guard
-     * for this and return a structured error rather than execute against a
-     * blank connection.
-     */
-    connectionId: string | null;
-    /** When true, worktree-scoped service writes bypass DB index updates. */
-    isWorktreeScoped: boolean;
-    preHead: string | null;
-    touchedSlSources: TouchedSlSourceSet;
-    actions: MemoryAction[];
-    allowedRawPaths?: ReadonlySet<string>;
-    allowedConnectionNames?: ReadonlySet<string>;
-    semanticLayerService: SemanticLayerService;
-    wikiService: KnowledgeWikiService;
-    configService: KtxFileStorePort;
-    gitService: GitService;
-    ingest?: IngestToolMetadata;
-    evictionDecisions?: EvictionDecisionRecord[];
-}
-export {};

package/node_modules/@ktx/context/dist/tools/touched-sl-sources.d.ts

@@ -1,12 +0,0 @@
-export interface TouchedSlSource {
-    connectionId: string;
-    sourceName: string;
-}
-export type TouchedSlSourceSet = Map<string, Set<string>>;
-export declare function createTouchedSlSources(entries?: TouchedSlSource[]): TouchedSlSourceSet;
-export declare function addTouchedSlSource(touched: TouchedSlSourceSet, connectionId: string, sourceName: string): void;
-export declare function deleteTouchedSlSource(touched: TouchedSlSourceSet, connectionId: string, sourceName: string): void;
-export declare function hasTouchedSlSource(touched: TouchedSlSourceSet, connectionId: string, sourceName: string): boolean;
-export declare function listTouchedSlSources(touched: TouchedSlSourceSet): TouchedSlSource[];
-export declare function touchedSlSourceCount(touched: TouchedSlSourceSet): number;
-export declare function touchedSlSourceNamesForConnection(touched: TouchedSlSourceSet, connectionId: string): string[];

package/node_modules/@ktx/context/dist/tools/touched-sl-sources.js

@@ -1,47 +0,0 @@
-export function createTouchedSlSources(entries = []) {
-    const touched = new Map();
-    for (const entry of entries) {
-        addTouchedSlSource(touched, entry.connectionId, entry.sourceName);
-    }
-    return touched;
-}
-export function addTouchedSlSource(touched, connectionId, sourceName) {
-    const bucket = touched.get(connectionId) ?? new Set();
-    bucket.add(sourceName);
-    touched.set(connectionId, bucket);
-}
-export function deleteTouchedSlSource(touched, connectionId, sourceName) {
-    const bucket = touched.get(connectionId);
-    if (!bucket) {
-        return;
-    }
-    bucket.delete(sourceName);
-    if (bucket.size === 0) {
-        touched.delete(connectionId);
-    }
-}
-export function hasTouchedSlSource(touched, connectionId, sourceName) {
-    return touched.get(connectionId)?.has(sourceName) ?? false;
-}
-export function listTouchedSlSources(touched) {
-    const out = [];
-    for (const [connectionId, sources] of touched) {
-        for (const sourceName of sources) {
-            out.push({ connectionId, sourceName });
-        }
-    }
-    return out.sort((left, right) => {
-        const byConnection = left.connectionId.localeCompare(right.connectionId);
-        return byConnection === 0 ? left.sourceName.localeCompare(right.sourceName) : byConnection;
-    });
-}
-export function touchedSlSourceCount(touched) {
-    let total = 0;
-    for (const sources of touched.values()) {
-        total += sources.size;
-    }
-    return total;
-}
-export function touchedSlSourceNamesForConnection(touched, connectionId) {
-    return [...(touched.get(connectionId) ?? [])].sort();
-}

package/node_modules/@ktx/context/dist/wiki/index.d.ts

@@ -1,9 +0,0 @@
-export { buildKnowledgeSearchText } from './knowledge-search-text.js';
-export { assertFlatWikiKey, invalidFlatWikiKeyMessage, isFlatWikiKey, suggestFlatWikiKey, validateFlatWikiKey, } from './keys.js';
-export { KnowledgeWikiService } from './knowledge-wiki.service.js';
-export * from './local-knowledge.js';
-export type { KnowledgeEventPort, KnowledgeGitDiffPort, KnowledgeIndexPort, KnowledgeIndexPageListing, UpsertPageParams, WikiFileStorePort, } from './ports.js';
-export type { ExistingKnowledgeIndexPage, SqliteKnowledgeIndexOptions, SqliteKnowledgeIndexPage, SqliteKnowledgeIndexSearchResult, WikiSqliteLaneCandidate, } from './sqlite-knowledge-index.js';
-export { SqliteKnowledgeIndex } from './sqlite-knowledge-index.js';
-export * from './tools/index.js';
-export type { HistoricSqlWikiUsageFrontmatter, WikiFrontmatter, WikiPage, WikiPageWithScope, WikiScope, WikiSearchLaneSummary, WikiSearchMatchReason, WikiSearchMetadata, } from './types.js';

package/node_modules/@ktx/context/dist/wiki/index.js

@@ -1,6 +0,0 @@
-export { buildKnowledgeSearchText } from './knowledge-search-text.js';
-export { assertFlatWikiKey, invalidFlatWikiKeyMessage, isFlatWikiKey, suggestFlatWikiKey, validateFlatWikiKey, } from './keys.js';
-export { KnowledgeWikiService } from './knowledge-wiki.service.js';
-export * from './local-knowledge.js';
-export { SqliteKnowledgeIndex } from './sqlite-knowledge-index.js';
-export * from './tools/index.js';

package/node_modules/@ktx/context/dist/wiki/keys.d.ts

@@ -1,11 +0,0 @@
-export declare function suggestFlatWikiKey(key: string): string;
-export declare function invalidFlatWikiKeyMessage(key: string): string;
-export declare function isFlatWikiKey(key: string): boolean;
-export declare function validateFlatWikiKey(key: string): {
-    ok: true;
-    key: string;
-} | {
-    ok: false;
-    error: string;
-};
-export declare function assertFlatWikiKey(key: string): string;