@caupulican/pi-adaptative 0.80.85 → 0.80.88

package/dist/core/context/sqlite-runtime-index.js

@@ -0,0 +1,344 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+export const SQLITE_RUNTIME_INDEX_SCHEMA_VERSION = 1;
+export const SQLITE_CONTEXT_INDEX_TABLES = [
+    "context_items",
+    "artifact_metadata",
+    "policy_score_cache",
+    "policy_decisions",
+    "retrieval_records",
+    "memory_index",
+];
+function prepareDatabasePath(databasePath) {
+    if (databasePath === ":memory:")
+        return;
+    mkdirSync(dirname(databasePath), { recursive: true });
+}
+function openDatabase(options) {
+    prepareDatabasePath(options.databasePath);
+    const database = new DatabaseSync(options.databasePath, {
+        enableForeignKeyConstraints: true,
+        timeout: options.busyTimeoutMs ?? 5_000,
+    });
+    database.exec(`
+		PRAGMA foreign_keys = ON;
+		PRAGMA busy_timeout = ${options.busyTimeoutMs ?? 5_000};
+		PRAGMA journal_mode = WAL;
+	`);
+    migrateSqliteRuntimeIndex(database);
+    return database;
+}
+function currentSchemaVersion(database) {
+    const row = database.prepare("PRAGMA user_version").get();
+    const value = row?.user_version;
+    return typeof value === "number" ? value : 0;
+}
+export function migrateSqliteRuntimeIndex(database) {
+    const version = currentSchemaVersion(database);
+    if (version > SQLITE_RUNTIME_INDEX_SCHEMA_VERSION) {
+        throw new Error(`Unsupported Pi context runtime-index schema version ${version}; current runtime supports ${SQLITE_RUNTIME_INDEX_SCHEMA_VERSION}`);
+    }
+    try {
+        database.exec(`
+			BEGIN IMMEDIATE;
+
+			CREATE TABLE IF NOT EXISTS context_items (
+				id TEXT PRIMARY KEY NOT NULL,
+				kind TEXT NOT NULL,
+				retention_class TEXT NOT NULL,
+				source TEXT NOT NULL,
+				created_at_turn INTEGER NOT NULL,
+				last_used_at_turn INTEGER,
+				token_estimate INTEGER NOT NULL,
+				byte_estimate INTEGER NOT NULL,
+				payload_json TEXT NOT NULL
+			) STRICT;
+
+			CREATE TABLE IF NOT EXISTS artifact_metadata (
+				id TEXT PRIMARY KEY NOT NULL,
+				kind TEXT NOT NULL,
+				storage_path TEXT,
+				session_entry_id TEXT,
+				tool_name TEXT,
+				command TEXT,
+				path TEXT,
+				byte_length INTEGER NOT NULL,
+				line_count INTEGER,
+				created_at_turn INTEGER NOT NULL,
+				reproducible INTEGER NOT NULL CHECK (reproducible IN (0, 1)),
+				payload_exists INTEGER NOT NULL DEFAULT 1 CHECK (payload_exists IN (0, 1)),
+				payload_json TEXT NOT NULL
+			) STRICT;
+
+			CREATE TABLE IF NOT EXISTS policy_score_cache (
+				cache_key TEXT PRIMARY KEY NOT NULL,
+				created_at_turn INTEGER NOT NULL,
+				payload_json TEXT NOT NULL
+			) STRICT;
+
+			CREATE TABLE IF NOT EXISTS policy_decisions (
+				id TEXT PRIMARY KEY NOT NULL,
+				context_item_id TEXT,
+				recorded_at_turn INTEGER NOT NULL,
+				decision_kind TEXT NOT NULL,
+				selected_action TEXT NOT NULL,
+				mode TEXT NOT NULL,
+				applied INTEGER NOT NULL CHECK (applied IN (0, 1)),
+				payload_json TEXT NOT NULL
+			) STRICT;
+
+			CREATE INDEX IF NOT EXISTS idx_policy_decisions_context_item_id
+				ON policy_decisions(context_item_id, recorded_at_turn);
+
+			CREATE TABLE IF NOT EXISTS retrieval_records (
+				id TEXT PRIMARY KEY NOT NULL,
+				context_item_id TEXT NOT NULL,
+				requested_at_turn INTEGER NOT NULL,
+				slice_kind TEXT NOT NULL,
+				result_summary TEXT NOT NULL,
+				payload_json TEXT NOT NULL
+			) STRICT;
+
+			CREATE INDEX IF NOT EXISTS idx_retrieval_records_context_item_id
+				ON retrieval_records(context_item_id, requested_at_turn);
+
+			CREATE TABLE IF NOT EXISTS memory_index (
+				provider_id TEXT NOT NULL,
+				item_id TEXT NOT NULL,
+				scope TEXT NOT NULL,
+				kind TEXT NOT NULL,
+				title TEXT,
+				summary TEXT NOT NULL,
+				indexed_at_turn INTEGER NOT NULL,
+				stale INTEGER NOT NULL CHECK (stale IN (0, 1)),
+				payload_json TEXT NOT NULL,
+				PRIMARY KEY (provider_id, item_id)
+			) STRICT;
+
+			CREATE INDEX IF NOT EXISTS idx_memory_index_scope
+				ON memory_index(scope, provider_id, item_id);
+
+			PRAGMA user_version = ${SQLITE_RUNTIME_INDEX_SCHEMA_VERSION};
+			COMMIT;
+		`);
+    }
+    catch (error) {
+        if (database.isTransaction)
+            database.exec("ROLLBACK;");
+        throw error;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseJsonRecord(json, isValid) {
+    try {
+        const parsed = JSON.parse(json);
+        return isValid(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function textColumn(row, column) {
+    const value = row?.[column];
+    return typeof value === "string" ? value : undefined;
+}
+function isContextItem(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.id === "string" &&
+        typeof value.kind === "string" &&
+        typeof value.retentionClass === "string" &&
+        typeof value.source === "string" &&
+        typeof value.createdAtTurn === "number" &&
+        typeof value.tokenEstimate === "number" &&
+        typeof value.byteEstimate === "number");
+}
+function isPolicyDecision(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.kind === "string" &&
+        typeof value.selectedAction === "string" &&
+        typeof value.mode === "string" &&
+        typeof value.applied === "boolean" &&
+        Array.isArray(value.hardConstraints) &&
+        Array.isArray(value.candidates) &&
+        Array.isArray(value.selectedReasonCodes) &&
+        typeof value.estimatedCostTokens === "number" &&
+        typeof value.estimatedSavingsTokens === "number" &&
+        typeof value.estimatedReliabilityRisk === "number" &&
+        typeof value.cacheImpactTokens === "number" &&
+        typeof value.reworkRiskTokens === "number" &&
+        Array.isArray(value.artifactRefs) &&
+        Array.isArray(value.evidenceRefs));
+}
+function isPolicyDecisionRecord(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.id === "string" &&
+        (value.contextItemId === undefined || typeof value.contextItemId === "string") &&
+        typeof value.recordedAtTurn === "number" &&
+        isPolicyDecision(value.decision));
+}
+function isRetrievalRecord(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.id === "string" &&
+        typeof value.contextItemId === "string" &&
+        typeof value.requestedAtTurn === "number" &&
+        typeof value.sliceKind === "string" &&
+        typeof value.resultSummary === "string");
+}
+function isMemoryIndexRecord(value) {
+    if (!isRecord(value) || !isRecord(value.ref))
+        return false;
+    return (typeof value.ref.providerId === "string" &&
+        typeof value.ref.itemId === "string" &&
+        typeof value.ref.scope === "string" &&
+        typeof value.ref.kind === "string" &&
+        (value.title === undefined || typeof value.title === "string") &&
+        typeof value.summary === "string" &&
+        typeof value.indexedAtTurn === "number" &&
+        typeof value.stale === "boolean");
+}
+function contextItemFromRow(row) {
+    const payload = textColumn(row, "payload_json");
+    return payload === undefined ? undefined : parseJsonRecord(payload, isContextItem);
+}
+function policyDecisionRecordFromRow(row) {
+    const payload = textColumn(row, "payload_json");
+    return payload === undefined ? undefined : parseJsonRecord(payload, isPolicyDecisionRecord);
+}
+function retrievalRecordFromRow(row) {
+    const payload = textColumn(row, "payload_json");
+    return payload === undefined ? undefined : parseJsonRecord(payload, isRetrievalRecord);
+}
+function memoryIndexRecordFromRow(row) {
+    const payload = textColumn(row, "payload_json");
+    return payload === undefined ? undefined : parseJsonRecord(payload, isMemoryIndexRecord);
+}
+export function createSqliteContextStore(options) {
+    const database = openDatabase(options);
+    const upsertItem = database.prepare(`
+		INSERT INTO context_items (
+			id, kind, retention_class, source, created_at_turn, last_used_at_turn, token_estimate, byte_estimate, payload_json
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+		ON CONFLICT(id) DO UPDATE SET
+			kind = excluded.kind,
+			retention_class = excluded.retention_class,
+			source = excluded.source,
+			created_at_turn = excluded.created_at_turn,
+			last_used_at_turn = excluded.last_used_at_turn,
+			token_estimate = excluded.token_estimate,
+			byte_estimate = excluded.byte_estimate,
+			payload_json = excluded.payload_json
+	`);
+    const getItem = database.prepare("SELECT payload_json FROM context_items WHERE id = ?");
+    const listItems = database.prepare("SELECT payload_json FROM context_items ORDER BY created_at_turn, id");
+    const removeItem = database.prepare("DELETE FROM context_items WHERE id = ?");
+    const recordPolicyDecision = database.prepare(`
+		INSERT INTO policy_decisions (
+			id, context_item_id, recorded_at_turn, decision_kind, selected_action, mode, applied, payload_json
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+    const listAllPolicyDecisions = database.prepare("SELECT payload_json FROM policy_decisions ORDER BY recorded_at_turn, id");
+    const listPolicyDecisionsByItem = database.prepare("SELECT payload_json FROM policy_decisions WHERE context_item_id = ? ORDER BY recorded_at_turn, id");
+    const recordRetrieval = database.prepare(`
+		INSERT INTO retrieval_records (
+			id, context_item_id, requested_at_turn, slice_kind, result_summary, payload_json
+		) VALUES (?, ?, ?, ?, ?, ?)
+	`);
+    const listAllRetrievals = database.prepare("SELECT payload_json FROM retrieval_records ORDER BY requested_at_turn, id");
+    const listRetrievalsByItem = database.prepare("SELECT payload_json FROM retrieval_records WHERE context_item_id = ? ORDER BY requested_at_turn, id");
+    return {
+        upsertItem(item) {
+            upsertItem.run(item.id, item.kind, item.retentionClass, item.source, item.createdAtTurn, item.lastUsedAtTurn ?? null, item.tokenEstimate, item.byteEstimate, JSON.stringify(item));
+        },
+        getItem(id) {
+            return contextItemFromRow(getItem.get(id));
+        },
+        listItems() {
+            return listItems.all().flatMap((row) => {
+                const item = contextItemFromRow(row);
+                return item === undefined ? [] : [item];
+            });
+        },
+        removeItem(id) {
+            removeItem.run(id);
+        },
+        recordPolicyDecision(record) {
+            recordPolicyDecision.run(record.id, record.contextItemId ?? null, record.recordedAtTurn, record.decision.kind, record.decision.selectedAction, record.decision.mode, record.decision.applied ? 1 : 0, JSON.stringify(record));
+        },
+        listPolicyDecisions(contextItemId) {
+            const rows = contextItemId === undefined ? listAllPolicyDecisions.all() : listPolicyDecisionsByItem.all(contextItemId);
+            return rows.flatMap((row) => {
+                const record = policyDecisionRecordFromRow(row);
+                return record === undefined ? [] : [record];
+            });
+        },
+        recordRetrieval(record) {
+            recordRetrieval.run(record.id, record.contextItemId, record.requestedAtTurn, record.sliceKind, record.resultSummary, JSON.stringify(record));
+        },
+        listRetrievals(contextItemId) {
+            const rows = contextItemId === undefined ? listAllRetrievals.all() : listRetrievalsByItem.all(contextItemId);
+            return rows.flatMap((row) => {
+                const record = retrievalRecordFromRow(row);
+                return record === undefined ? [] : [record];
+            });
+        },
+        close() {
+            database[Symbol.dispose]();
+        },
+    };
+}
+export function createSqliteMemoryIndexStore(options) {
+    const database = openDatabase(options);
+    const upsert = database.prepare(`
+		INSERT INTO memory_index (
+			provider_id, item_id, scope, kind, title, summary, indexed_at_turn, stale, payload_json
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+		ON CONFLICT(provider_id, item_id) DO UPDATE SET
+			scope = excluded.scope,
+			kind = excluded.kind,
+			title = excluded.title,
+			summary = excluded.summary,
+			indexed_at_turn = excluded.indexed_at_turn,
+			stale = excluded.stale,
+			payload_json = excluded.payload_json
+	`);
+    const get = database.prepare("SELECT payload_json FROM memory_index WHERE provider_id = ? AND item_id = ?");
+    const listAll = database.prepare("SELECT payload_json FROM memory_index ORDER BY provider_id, item_id");
+    const listByScope = database.prepare("SELECT payload_json FROM memory_index WHERE scope = ? ORDER BY provider_id, item_id");
+    const markStale = database.prepare("UPDATE memory_index SET stale = 1, payload_json = ? WHERE provider_id = ? AND item_id = ?");
+    const remove = database.prepare("DELETE FROM memory_index WHERE provider_id = ? AND item_id = ?");
+    return {
+        upsert(record) {
+            upsert.run(record.ref.providerId, record.ref.itemId, record.ref.scope, record.ref.kind, record.title ?? null, record.summary, record.indexedAtTurn, record.stale ? 1 : 0, JSON.stringify(record));
+        },
+        get(providerId, itemId) {
+            return memoryIndexRecordFromRow(get.get(providerId, itemId));
+        },
+        list(scope) {
+            const rows = scope === undefined ? listAll.all() : listByScope.all(scope);
+            return rows.flatMap((row) => {
+                const record = memoryIndexRecordFromRow(row);
+                return record === undefined ? [] : [record];
+            });
+        },
+        markStale(providerId, itemId) {
+            const existing = memoryIndexRecordFromRow(get.get(providerId, itemId));
+            if (existing === undefined)
+                return;
+            markStale.run(JSON.stringify({ ...existing, stale: true }), providerId, itemId);
+        },
+        remove(providerId, itemId) {
+            remove.run(providerId, itemId);
+        },
+        close() {
+            database[Symbol.dispose]();
+        },
+    };
+}
+//# sourceMappingURL=sqlite-runtime-index.js.map

package/dist/core/context/sqlite-runtime-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-runtime-index.js","sourceRoot":"","sources":["../../../src/core/context/sqlite-runtime-index.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport type { ContextItem } from \"./context-item.ts\";\nimport type { ContextStore, PolicyDecisionRecord, RetrievalRecord } from \"./context-store.ts\";\nimport type { MemoryIndexRecord, MemoryIndexStore } from \"./memory-index-store.ts\";\nimport type { PolicyDecision } from \"./policy-types.ts\";\n\nexport const SQLITE_RUNTIME_INDEX_SCHEMA_VERSION = 1;\n\nexport const SQLITE_CONTEXT_INDEX_TABLES = [\n\t\"context_items\",\n\t\"artifact_metadata\",\n\t\"policy_score_cache\",\n\t\"policy_decisions\",\n\t\"retrieval_records\",\n\t\"memory_index\",\n] as const;\n\nexport interface SqliteRuntimeIndexOptions {\n\tdatabasePath: string;\n\tbusyTimeoutMs?: number;\n}\n\nexport interface SqliteContextStore extends ContextStore {\n\tclose(): void;\n}\n\nexport interface SqliteMemoryIndexStore extends MemoryIndexStore {\n\tclose(): void;\n}\n\nfunction prepareDatabasePath(databasePath: string): void {\n\tif (databasePath === \":memory:\") return;\n\tmkdirSync(dirname(databasePath), { recursive: true });\n}\n\nfunction openDatabase(options: SqliteRuntimeIndexOptions): DatabaseSync {\n\tprepareDatabasePath(options.databasePath);\n\tconst database = new DatabaseSync(options.databasePath, {\n\t\tenableForeignKeyConstraints: true,\n\t\ttimeout: options.busyTimeoutMs ?? 5_000,\n\t});\n\tdatabase.exec(`\n\t\tPRAGMA foreign_keys = ON;\n\t\tPRAGMA busy_timeout = ${options.busyTimeoutMs ?? 5_000};\n\t\tPRAGMA journal_mode = WAL;\n\t`);\n\tmigrateSqliteRuntimeIndex(database);\n\treturn database;\n}\n\nfunction currentSchemaVersion(database: DatabaseSync): number {\n\tconst row = database.prepare(\"PRAGMA user_version\").get();\n\tconst value = row?.user_version;\n\treturn typeof value === \"number\" ? value : 0;\n}\n\nexport function migrateSqliteRuntimeIndex(database: DatabaseSync): void {\n\tconst version = currentSchemaVersion(database);\n\tif (version > SQLITE_RUNTIME_INDEX_SCHEMA_VERSION) {\n\t\tthrow new Error(\n\t\t\t`Unsupported Pi context runtime-index schema version ${version}; current runtime supports ${SQLITE_RUNTIME_INDEX_SCHEMA_VERSION}`,\n\t\t);\n\t}\n\n\ttry {\n\t\tdatabase.exec(`\n\t\t\tBEGIN IMMEDIATE;\n\n\t\t\tCREATE TABLE IF NOT EXISTS context_items (\n\t\t\t\tid TEXT PRIMARY KEY NOT NULL,\n\t\t\t\tkind TEXT NOT NULL,\n\t\t\t\tretention_class TEXT NOT NULL,\n\t\t\t\tsource TEXT NOT NULL,\n\t\t\t\tcreated_at_turn INTEGER NOT NULL,\n\t\t\t\tlast_used_at_turn INTEGER,\n\t\t\t\ttoken_estimate INTEGER NOT NULL,\n\t\t\t\tbyte_estimate INTEGER NOT NULL,\n\t\t\t\tpayload_json TEXT NOT NULL\n\t\t\t) STRICT;\n\n\t\t\tCREATE TABLE IF NOT EXISTS artifact_metadata (\n\t\t\t\tid TEXT PRIMARY KEY NOT NULL,\n\t\t\t\tkind TEXT NOT NULL,\n\t\t\t\tstorage_path TEXT,\n\t\t\t\tsession_entry_id TEXT,\n\t\t\t\ttool_name TEXT,\n\t\t\t\tcommand TEXT,\n\t\t\t\tpath TEXT,\n\t\t\t\tbyte_length INTEGER NOT NULL,\n\t\t\t\tline_count INTEGER,\n\t\t\t\tcreated_at_turn INTEGER NOT NULL,\n\t\t\t\treproducible INTEGER NOT NULL CHECK (reproducible IN (0, 1)),\n\t\t\t\tpayload_exists INTEGER NOT NULL DEFAULT 1 CHECK (payload_exists IN (0, 1)),\n\t\t\t\tpayload_json TEXT NOT NULL\n\t\t\t) STRICT;\n\n\t\t\tCREATE TABLE IF NOT EXISTS policy_score_cache (\n\t\t\t\tcache_key TEXT PRIMARY KEY NOT NULL,\n\t\t\t\tcreated_at_turn INTEGER NOT NULL,\n\t\t\t\tpayload_json TEXT NOT NULL\n\t\t\t) STRICT;\n\n\t\t\tCREATE TABLE IF NOT EXISTS policy_decisions (\n\t\t\t\tid TEXT PRIMARY KEY NOT NULL,\n\t\t\t\tcontext_item_id TEXT,\n\t\t\t\trecorded_at_turn INTEGER NOT NULL,\n\t\t\t\tdecision_kind TEXT NOT NULL,\n\t\t\t\tselected_action TEXT NOT NULL,\n\t\t\t\tmode TEXT NOT NULL,\n\t\t\t\tapplied INTEGER NOT NULL CHECK (applied IN (0, 1)),\n\t\t\t\tpayload_json TEXT NOT NULL\n\t\t\t) STRICT;\n\n\t\t\tCREATE INDEX IF NOT EXISTS idx_policy_decisions_context_item_id\n\t\t\t\tON policy_decisions(context_item_id, recorded_at_turn);\n\n\t\t\tCREATE TABLE IF NOT EXISTS retrieval_records (\n\t\t\t\tid TEXT PRIMARY KEY NOT NULL,\n\t\t\t\tcontext_item_id TEXT NOT NULL,\n\t\t\t\trequested_at_turn INTEGER NOT NULL,\n\t\t\t\tslice_kind TEXT NOT NULL,\n\t\t\t\tresult_summary TEXT NOT NULL,\n\t\t\t\tpayload_json TEXT NOT NULL\n\t\t\t) STRICT;\n\n\t\t\tCREATE INDEX IF NOT EXISTS idx_retrieval_records_context_item_id\n\t\t\t\tON retrieval_records(context_item_id, requested_at_turn);\n\n\t\t\tCREATE TABLE IF NOT EXISTS memory_index (\n\t\t\t\tprovider_id TEXT NOT NULL,\n\t\t\t\titem_id TEXT NOT NULL,\n\t\t\t\tscope TEXT NOT NULL,\n\t\t\t\tkind TEXT NOT NULL,\n\t\t\t\ttitle TEXT,\n\t\t\t\tsummary TEXT NOT NULL,\n\t\t\t\tindexed_at_turn INTEGER NOT NULL,\n\t\t\t\tstale INTEGER NOT NULL CHECK (stale IN (0, 1)),\n\t\t\t\tpayload_json TEXT NOT NULL,\n\t\t\t\tPRIMARY KEY (provider_id, item_id)\n\t\t\t) STRICT;\n\n\t\t\tCREATE INDEX IF NOT EXISTS idx_memory_index_scope\n\t\t\t\tON memory_index(scope, provider_id, item_id);\n\n\t\t\tPRAGMA user_version = ${SQLITE_RUNTIME_INDEX_SCHEMA_VERSION};\n\t\t\tCOMMIT;\n\t\t`);\n\t} catch (error) {\n\t\tif (database.isTransaction) database.exec(\"ROLLBACK;\");\n\t\tthrow error;\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction parseJsonRecord<T>(json: string, isValid: (value: unknown) => value is T): T | undefined {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(json);\n\t\treturn isValid(parsed) ? parsed : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction textColumn(row: Record<string, unknown> | undefined, column: string): string | undefined {\n\tconst value = row?.[column];\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nfunction isContextItem(value: unknown): value is ContextItem {\n\tif (!isRecord(value)) return false;\n\treturn (\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.kind === \"string\" &&\n\t\ttypeof value.retentionClass === \"string\" &&\n\t\ttypeof value.source === \"string\" &&\n\t\ttypeof value.createdAtTurn === \"number\" &&\n\t\ttypeof value.tokenEstimate === \"number\" &&\n\t\ttypeof value.byteEstimate === \"number\"\n\t);\n}\n\nfunction isPolicyDecision(value: unknown): value is PolicyDecision {\n\tif (!isRecord(value)) return false;\n\treturn (\n\t\ttypeof value.kind === \"string\" &&\n\t\ttypeof value.selectedAction === \"string\" &&\n\t\ttypeof value.mode === \"string\" &&\n\t\ttypeof value.applied === \"boolean\" &&\n\t\tArray.isArray(value.hardConstraints) &&\n\t\tArray.isArray(value.candidates) &&\n\t\tArray.isArray(value.selectedReasonCodes) &&\n\t\ttypeof value.estimatedCostTokens === \"number\" &&\n\t\ttypeof value.estimatedSavingsTokens === \"number\" &&\n\t\ttypeof value.estimatedReliabilityRisk === \"number\" &&\n\t\ttypeof value.cacheImpactTokens === \"number\" &&\n\t\ttypeof value.reworkRiskTokens === \"number\" &&\n\t\tArray.isArray(value.artifactRefs) &&\n\t\tArray.isArray(value.evidenceRefs)\n\t);\n}\n\nfunction isPolicyDecisionRecord(value: unknown): value is PolicyDecisionRecord {\n\tif (!isRecord(value)) return false;\n\treturn (\n\t\ttypeof value.id === \"string\" &&\n\t\t(value.contextItemId === undefined || typeof value.contextItemId === \"string\") &&\n\t\ttypeof value.recordedAtTurn === \"number\" &&\n\t\tisPolicyDecision(value.decision)\n\t);\n}\n\nfunction isRetrievalRecord(value: unknown): value is RetrievalRecord {\n\tif (!isRecord(value)) return false;\n\treturn (\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.contextItemId === \"string\" &&\n\t\ttypeof value.requestedAtTurn === \"number\" &&\n\t\ttypeof value.sliceKind === \"string\" &&\n\t\ttypeof value.resultSummary === \"string\"\n\t);\n}\n\nfunction isMemoryIndexRecord(value: unknown): value is MemoryIndexRecord {\n\tif (!isRecord(value) || !isRecord(value.ref)) return false;\n\treturn (\n\t\ttypeof value.ref.providerId === \"string\" &&\n\t\ttypeof value.ref.itemId === \"string\" &&\n\t\ttypeof value.ref.scope === \"string\" &&\n\t\ttypeof value.ref.kind === \"string\" &&\n\t\t(value.title === undefined || typeof value.title === \"string\") &&\n\t\ttypeof value.summary === \"string\" &&\n\t\ttypeof value.indexedAtTurn === \"number\" &&\n\t\ttypeof value.stale === \"boolean\"\n\t);\n}\n\nfunction contextItemFromRow(row: Record<string, unknown> | undefined): ContextItem | undefined {\n\tconst payload = textColumn(row, \"payload_json\");\n\treturn payload === undefined ? undefined : parseJsonRecord(payload, isContextItem);\n}\n\nfunction policyDecisionRecordFromRow(row: Record<string, unknown> | undefined): PolicyDecisionRecord | undefined {\n\tconst payload = textColumn(row, \"payload_json\");\n\treturn payload === undefined ? undefined : parseJsonRecord(payload, isPolicyDecisionRecord);\n}\n\nfunction retrievalRecordFromRow(row: Record<string, unknown> | undefined): RetrievalRecord | undefined {\n\tconst payload = textColumn(row, \"payload_json\");\n\treturn payload === undefined ? undefined : parseJsonRecord(payload, isRetrievalRecord);\n}\n\nfunction memoryIndexRecordFromRow(row: Record<string, unknown> | undefined): MemoryIndexRecord | undefined {\n\tconst payload = textColumn(row, \"payload_json\");\n\treturn payload === undefined ? undefined : parseJsonRecord(payload, isMemoryIndexRecord);\n}\n\nexport function createSqliteContextStore(options: SqliteRuntimeIndexOptions): SqliteContextStore {\n\tconst database = openDatabase(options);\n\tconst upsertItem = database.prepare(`\n\t\tINSERT INTO context_items (\n\t\t\tid, kind, retention_class, source, created_at_turn, last_used_at_turn, token_estimate, byte_estimate, payload_json\n\t\t) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n\t\tON CONFLICT(id) DO UPDATE SET\n\t\t\tkind = excluded.kind,\n\t\t\tretention_class = excluded.retention_class,\n\t\t\tsource = excluded.source,\n\t\t\tcreated_at_turn = excluded.created_at_turn,\n\t\t\tlast_used_at_turn = excluded.last_used_at_turn,\n\t\t\ttoken_estimate = excluded.token_estimate,\n\t\t\tbyte_estimate = excluded.byte_estimate,\n\t\t\tpayload_json = excluded.payload_json\n\t`);\n\tconst getItem = database.prepare(\"SELECT payload_json FROM context_items WHERE id = ?\");\n\tconst listItems = database.prepare(\"SELECT payload_json FROM context_items ORDER BY created_at_turn, id\");\n\tconst removeItem = database.prepare(\"DELETE FROM context_items WHERE id = ?\");\n\tconst recordPolicyDecision = database.prepare(`\n\t\tINSERT INTO policy_decisions (\n\t\t\tid, context_item_id, recorded_at_turn, decision_kind, selected_action, mode, applied, payload_json\n\t\t) VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n\t`);\n\tconst listAllPolicyDecisions = database.prepare(\n\t\t\"SELECT payload_json FROM policy_decisions ORDER BY recorded_at_turn, id\",\n\t);\n\tconst listPolicyDecisionsByItem = database.prepare(\n\t\t\"SELECT payload_json FROM policy_decisions WHERE context_item_id = ? ORDER BY recorded_at_turn, id\",\n\t);\n\tconst recordRetrieval = database.prepare(`\n\t\tINSERT INTO retrieval_records (\n\t\t\tid, context_item_id, requested_at_turn, slice_kind, result_summary, payload_json\n\t\t) VALUES (?, ?, ?, ?, ?, ?)\n\t`);\n\tconst listAllRetrievals = database.prepare(\n\t\t\"SELECT payload_json FROM retrieval_records ORDER BY requested_at_turn, id\",\n\t);\n\tconst listRetrievalsByItem = database.prepare(\n\t\t\"SELECT payload_json FROM retrieval_records WHERE context_item_id = ? ORDER BY requested_at_turn, id\",\n\t);\n\n\treturn {\n\t\tupsertItem(item: ContextItem): void {\n\t\t\tupsertItem.run(\n\t\t\t\titem.id,\n\t\t\t\titem.kind,\n\t\t\t\titem.retentionClass,\n\t\t\t\titem.source,\n\t\t\t\titem.createdAtTurn,\n\t\t\t\titem.lastUsedAtTurn ?? null,\n\t\t\t\titem.tokenEstimate,\n\t\t\t\titem.byteEstimate,\n\t\t\t\tJSON.stringify(item),\n\t\t\t);\n\t\t},\n\n\t\tgetItem(id: string): ContextItem | undefined {\n\t\t\treturn contextItemFromRow(getItem.get(id));\n\t\t},\n\n\t\tlistItems(): ContextItem[] {\n\t\t\treturn listItems.all().flatMap((row) => {\n\t\t\t\tconst item = contextItemFromRow(row);\n\t\t\t\treturn item === undefined ? [] : [item];\n\t\t\t});\n\t\t},\n\n\t\tremoveItem(id: string): void {\n\t\t\tremoveItem.run(id);\n\t\t},\n\n\t\trecordPolicyDecision(record: PolicyDecisionRecord): void {\n\t\t\trecordPolicyDecision.run(\n\t\t\t\trecord.id,\n\t\t\t\trecord.contextItemId ?? null,\n\t\t\t\trecord.recordedAtTurn,\n\t\t\t\trecord.decision.kind,\n\t\t\t\trecord.decision.selectedAction,\n\t\t\t\trecord.decision.mode,\n\t\t\t\trecord.decision.applied ? 1 : 0,\n\t\t\t\tJSON.stringify(record),\n\t\t\t);\n\t\t},\n\n\t\tlistPolicyDecisions(contextItemId?: string): PolicyDecisionRecord[] {\n\t\t\tconst rows =\n\t\t\t\tcontextItemId === undefined ? listAllPolicyDecisions.all() : listPolicyDecisionsByItem.all(contextItemId);\n\t\t\treturn rows.flatMap((row) => {\n\t\t\t\tconst record = policyDecisionRecordFromRow(row);\n\t\t\t\treturn record === undefined ? [] : [record];\n\t\t\t});\n\t\t},\n\n\t\trecordRetrieval(record: RetrievalRecord): void {\n\t\t\trecordRetrieval.run(\n\t\t\t\trecord.id,\n\t\t\t\trecord.contextItemId,\n\t\t\t\trecord.requestedAtTurn,\n\t\t\t\trecord.sliceKind,\n\t\t\t\trecord.resultSummary,\n\t\t\t\tJSON.stringify(record),\n\t\t\t);\n\t\t},\n\n\t\tlistRetrievals(contextItemId?: string): RetrievalRecord[] {\n\t\t\tconst rows = contextItemId === undefined ? listAllRetrievals.all() : listRetrievalsByItem.all(contextItemId);\n\t\t\treturn rows.flatMap((row) => {\n\t\t\t\tconst record = retrievalRecordFromRow(row);\n\t\t\t\treturn record === undefined ? [] : [record];\n\t\t\t});\n\t\t},\n\n\t\tclose(): void {\n\t\t\tdatabase[Symbol.dispose]();\n\t\t},\n\t};\n}\n\nexport function createSqliteMemoryIndexStore(options: SqliteRuntimeIndexOptions): SqliteMemoryIndexStore {\n\tconst database = openDatabase(options);\n\tconst upsert = database.prepare(`\n\t\tINSERT INTO memory_index (\n\t\t\tprovider_id, item_id, scope, kind, title, summary, indexed_at_turn, stale, payload_json\n\t\t) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n\t\tON CONFLICT(provider_id, item_id) DO UPDATE SET\n\t\t\tscope = excluded.scope,\n\t\t\tkind = excluded.kind,\n\t\t\ttitle = excluded.title,\n\t\t\tsummary = excluded.summary,\n\t\t\tindexed_at_turn = excluded.indexed_at_turn,\n\t\t\tstale = excluded.stale,\n\t\t\tpayload_json = excluded.payload_json\n\t`);\n\tconst get = database.prepare(\"SELECT payload_json FROM memory_index WHERE provider_id = ? AND item_id = ?\");\n\tconst listAll = database.prepare(\"SELECT payload_json FROM memory_index ORDER BY provider_id, item_id\");\n\tconst listByScope = database.prepare(\n\t\t\"SELECT payload_json FROM memory_index WHERE scope = ? ORDER BY provider_id, item_id\",\n\t);\n\tconst markStale = database.prepare(\n\t\t\"UPDATE memory_index SET stale = 1, payload_json = ? WHERE provider_id = ? AND item_id = ?\",\n\t);\n\tconst remove = database.prepare(\"DELETE FROM memory_index WHERE provider_id = ? AND item_id = ?\");\n\n\treturn {\n\t\tupsert(record: MemoryIndexRecord): void {\n\t\t\tupsert.run(\n\t\t\t\trecord.ref.providerId,\n\t\t\t\trecord.ref.itemId,\n\t\t\t\trecord.ref.scope,\n\t\t\t\trecord.ref.kind,\n\t\t\t\trecord.title ?? null,\n\t\t\t\trecord.summary,\n\t\t\t\trecord.indexedAtTurn,\n\t\t\t\trecord.stale ? 1 : 0,\n\t\t\t\tJSON.stringify(record),\n\t\t\t);\n\t\t},\n\n\t\tget(providerId: string, itemId: string): MemoryIndexRecord | undefined {\n\t\t\treturn memoryIndexRecordFromRow(get.get(providerId, itemId));\n\t\t},\n\n\t\tlist(scope?: MemoryIndexRecord[\"ref\"][\"scope\"]): MemoryIndexRecord[] {\n\t\t\tconst rows = scope === undefined ? listAll.all() : listByScope.all(scope);\n\t\t\treturn rows.flatMap((row) => {\n\t\t\t\tconst record = memoryIndexRecordFromRow(row);\n\t\t\t\treturn record === undefined ? [] : [record];\n\t\t\t});\n\t\t},\n\n\t\tmarkStale(providerId: string, itemId: string): void {\n\t\t\tconst existing = memoryIndexRecordFromRow(get.get(providerId, itemId));\n\t\t\tif (existing === undefined) return;\n\t\t\tmarkStale.run(JSON.stringify({ ...existing, stale: true }), providerId, itemId);\n\t\t},\n\n\t\tremove(providerId: string, itemId: string): void {\n\t\t\tremove.run(providerId, itemId);\n\t\t},\n\n\t\tclose(): void {\n\t\t\tdatabase[Symbol.dispose]();\n\t\t},\n\t};\n}\n"]}

package/dist/core/context/storage-authority.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Storage authority/rebuildability metadata for SQLite runtime-index table design (Phase M0/M3).
+ *
+ * This module records, per runtime-index table, whether its rows are the only copy of
+ * something (canonical_local_state), rebuildable from another canonical source
+ * (derived_rebuildable), disposable performance data
+ * (runtime_cache_disposable), or audit/calibration telemetry whose loss does not affect
+ * current task truth (append_only_telemetry). Per memory-architecture.md: cleanup and
+ * prompt safety must never depend only on disposable/derived rows.
+ */
+export type StorageAuthorityClass = "derived_rebuildable" | "runtime_cache_disposable" | "append_only_telemetry" | "canonical_local_state";
+export interface StorageTableAuthority {
+    table: string;
+    authorityClass: StorageAuthorityClass;
+    /** Canonical sources this table can be rebuilt from, if authorityClass is derived_rebuildable. */
+    rebuildableFrom?: string[];
+    notes: string;
+}
+export declare const CONTEXT_STORAGE_TABLE_AUTHORITY: readonly StorageTableAuthority[];
+//# sourceMappingURL=storage-authority.d.ts.map

package/dist/core/context/storage-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-authority.d.ts","sourceRoot":"","sources":["../../../src/core/context/storage-authority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,qBAAqB,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,uBAAuB,GACvB,uBAAuB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,qBAAqB,CAAC;IACtC,kGAAkG;IAClG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,+BAA+B,EAAE,SAAS,qBAAqB,EA0C3E,CAAC","sourcesContent":["/**\n * Storage authority/rebuildability metadata for SQLite runtime-index table design (Phase M0/M3).\n *\n * This module records, per runtime-index table, whether its rows are the only copy of\n * something (canonical_local_state), rebuildable from another canonical source\n * (derived_rebuildable), disposable performance data\n * (runtime_cache_disposable), or audit/calibration telemetry whose loss does not affect\n * current task truth (append_only_telemetry). Per memory-architecture.md: cleanup and\n * prompt safety must never depend only on disposable/derived rows.\n */\n\nexport type StorageAuthorityClass =\n\t| \"derived_rebuildable\"\n\t| \"runtime_cache_disposable\"\n\t| \"append_only_telemetry\"\n\t| \"canonical_local_state\";\n\nexport interface StorageTableAuthority {\n\ttable: string;\n\tauthorityClass: StorageAuthorityClass;\n\t/** Canonical sources this table can be rebuilt from, if authorityClass is derived_rebuildable. */\n\trebuildableFrom?: string[];\n\tnotes: string;\n}\n\nexport const CONTEXT_STORAGE_TABLE_AUTHORITY: readonly StorageTableAuthority[] = [\n\t{\n\t\ttable: \"context_items\",\n\t\tauthorityClass: \"derived_rebuildable\",\n\t\trebuildableFrom: [\"transcript\", \"artifacts\"],\n\t\tnotes: \"Working-memory context item metadata; rebuildable from transcript/artifacts if the index is lost.\",\n\t},\n\t{\n\t\ttable: \"artifact_metadata\",\n\t\tauthorityClass: \"canonical_local_state\",\n\t\tnotes:\n\t\t\t\"Artifact id/path/byte-length/reproducibility metadata. The artifact payload file is canonical raw \" +\n\t\t\t\"evidence, but this row is the only index to it; loss here can strand a payload as unreachable, so \" +\n\t\t\t\"treat as canonical_local_state and mirror writes into a durable journal before treating a ref as live.\",\n\t},\n\t{\n\t\ttable: \"policy_score_cache\",\n\t\tauthorityClass: \"runtime_cache_disposable\",\n\t\tnotes:\n\t\t\t\"Cached break-even score computations for context-retention candidates; safe to drop and \" +\n\t\t\t\"recompute on demand, and never consulted for a safety/retention decision by itself.\",\n\t},\n\t{\n\t\ttable: \"policy_decisions\",\n\t\tauthorityClass: \"append_only_telemetry\",\n\t\tnotes: \"Policy decision shadow/enforcement log for calibration and review; loss affects calibration, not current task truth.\",\n\t},\n\t{\n\t\ttable: \"retrieval_records\",\n\t\tauthorityClass: \"append_only_telemetry\",\n\t\tnotes: \"Retrieval/rehydration audit trail; loss affects observability, not current task truth.\",\n\t},\n\t{\n\t\ttable: \"memory_index\",\n\t\tauthorityClass: \"derived_rebuildable\",\n\t\trebuildableFrom: [\"okf_bundle\", \"external_provider\"],\n\t\tnotes:\n\t\t\t\"Index over durable memory sources; rebuildable by re-indexing the OKF bundle/provider content. \" +\n\t\t\t\"Rebuild from an external_provider source is conditional on that provider being enabled, reachable, \" +\n\t\t\t\"and permitted by egress/redaction policy at rebuild time; it is not unconditionally rebuildable \" +\n\t\t\t\"the way the OKF-bundle-backed portion is.\",\n\t},\n];\n"]}

package/dist/core/context/storage-authority.js

@@ -0,0 +1,51 @@
+/**
+ * Storage authority/rebuildability metadata for SQLite runtime-index table design (Phase M0/M3).
+ *
+ * This module records, per runtime-index table, whether its rows are the only copy of
+ * something (canonical_local_state), rebuildable from another canonical source
+ * (derived_rebuildable), disposable performance data
+ * (runtime_cache_disposable), or audit/calibration telemetry whose loss does not affect
+ * current task truth (append_only_telemetry). Per memory-architecture.md: cleanup and
+ * prompt safety must never depend only on disposable/derived rows.
+ */
+export const CONTEXT_STORAGE_TABLE_AUTHORITY = [
+    {
+        table: "context_items",
+        authorityClass: "derived_rebuildable",
+        rebuildableFrom: ["transcript", "artifacts"],
+        notes: "Working-memory context item metadata; rebuildable from transcript/artifacts if the index is lost.",
+    },
+    {
+        table: "artifact_metadata",
+        authorityClass: "canonical_local_state",
+        notes: "Artifact id/path/byte-length/reproducibility metadata. The artifact payload file is canonical raw " +
+            "evidence, but this row is the only index to it; loss here can strand a payload as unreachable, so " +
+            "treat as canonical_local_state and mirror writes into a durable journal before treating a ref as live.",
+    },
+    {
+        table: "policy_score_cache",
+        authorityClass: "runtime_cache_disposable",
+        notes: "Cached break-even score computations for context-retention candidates; safe to drop and " +
+            "recompute on demand, and never consulted for a safety/retention decision by itself.",
+    },
+    {
+        table: "policy_decisions",
+        authorityClass: "append_only_telemetry",
+        notes: "Policy decision shadow/enforcement log for calibration and review; loss affects calibration, not current task truth.",
+    },
+    {
+        table: "retrieval_records",
+        authorityClass: "append_only_telemetry",
+        notes: "Retrieval/rehydration audit trail; loss affects observability, not current task truth.",
+    },
+    {
+        table: "memory_index",
+        authorityClass: "derived_rebuildable",
+        rebuildableFrom: ["okf_bundle", "external_provider"],
+        notes: "Index over durable memory sources; rebuildable by re-indexing the OKF bundle/provider content. " +
+            "Rebuild from an external_provider source is conditional on that provider being enabled, reachable, " +
+            "and permitted by egress/redaction policy at rebuild time; it is not unconditionally rebuildable " +
+            "the way the OKF-bundle-backed portion is.",
+    },
+];
+//# sourceMappingURL=storage-authority.js.map

package/dist/core/context/storage-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-authority.js","sourceRoot":"","sources":["../../../src/core/context/storage-authority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,MAAM,CAAC,MAAM,+BAA+B,GAAqC;IAChF;QACC,KAAK,EAAE,eAAe;QACtB,cAAc,EAAE,qBAAqB;QACrC,eAAe,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;QAC5C,KAAK,EAAE,mGAAmG;KAC1G;IACD;QACC,KAAK,EAAE,mBAAmB;QAC1B,cAAc,EAAE,uBAAuB;QACvC,KAAK,EACJ,oGAAoG;YACpG,oGAAoG;YACpG,wGAAwG;KACzG;IACD;QACC,KAAK,EAAE,oBAAoB;QAC3B,cAAc,EAAE,0BAA0B;QAC1C,KAAK,EACJ,0FAA0F;YAC1F,qFAAqF;KACtF;IACD;QACC,KAAK,EAAE,kBAAkB;QACzB,cAAc,EAAE,uBAAuB;QACvC,KAAK,EAAE,sHAAsH;KAC7H;IACD;QACC,KAAK,EAAE,mBAAmB;QAC1B,cAAc,EAAE,uBAAuB;QACvC,KAAK,EAAE,wFAAwF;KAC/F;IACD;QACC,KAAK,EAAE,cAAc;QACrB,cAAc,EAAE,qBAAqB;QACrC,eAAe,EAAE,CAAC,YAAY,EAAE,mBAAmB,CAAC;QACpD,KAAK,EACJ,iGAAiG;YACjG,qGAAqG;YACrG,kGAAkG;YAClG,2CAA2C;KAC5C;CACD,CAAC","sourcesContent":["/**\n * Storage authority/rebuildability metadata for SQLite runtime-index table design (Phase M0/M3).\n *\n * This module records, per runtime-index table, whether its rows are the only copy of\n * something (canonical_local_state), rebuildable from another canonical source\n * (derived_rebuildable), disposable performance data\n * (runtime_cache_disposable), or audit/calibration telemetry whose loss does not affect\n * current task truth (append_only_telemetry). Per memory-architecture.md: cleanup and\n * prompt safety must never depend only on disposable/derived rows.\n */\n\nexport type StorageAuthorityClass =\n\t| \"derived_rebuildable\"\n\t| \"runtime_cache_disposable\"\n\t| \"append_only_telemetry\"\n\t| \"canonical_local_state\";\n\nexport interface StorageTableAuthority {\n\ttable: string;\n\tauthorityClass: StorageAuthorityClass;\n\t/** Canonical sources this table can be rebuilt from, if authorityClass is derived_rebuildable. */\n\trebuildableFrom?: string[];\n\tnotes: string;\n}\n\nexport const CONTEXT_STORAGE_TABLE_AUTHORITY: readonly StorageTableAuthority[] = [\n\t{\n\t\ttable: \"context_items\",\n\t\tauthorityClass: \"derived_rebuildable\",\n\t\trebuildableFrom: [\"transcript\", \"artifacts\"],\n\t\tnotes: \"Working-memory context item metadata; rebuildable from transcript/artifacts if the index is lost.\",\n\t},\n\t{\n\t\ttable: \"artifact_metadata\",\n\t\tauthorityClass: \"canonical_local_state\",\n\t\tnotes:\n\t\t\t\"Artifact id/path/byte-length/reproducibility metadata. The artifact payload file is canonical raw \" +\n\t\t\t\"evidence, but this row is the only index to it; loss here can strand a payload as unreachable, so \" +\n\t\t\t\"treat as canonical_local_state and mirror writes into a durable journal before treating a ref as live.\",\n\t},\n\t{\n\t\ttable: \"policy_score_cache\",\n\t\tauthorityClass: \"runtime_cache_disposable\",\n\t\tnotes:\n\t\t\t\"Cached break-even score computations for context-retention candidates; safe to drop and \" +\n\t\t\t\"recompute on demand, and never consulted for a safety/retention decision by itself.\",\n\t},\n\t{\n\t\ttable: \"policy_decisions\",\n\t\tauthorityClass: \"append_only_telemetry\",\n\t\tnotes: \"Policy decision shadow/enforcement log for calibration and review; loss affects calibration, not current task truth.\",\n\t},\n\t{\n\t\ttable: \"retrieval_records\",\n\t\tauthorityClass: \"append_only_telemetry\",\n\t\tnotes: \"Retrieval/rehydration audit trail; loss affects observability, not current task truth.\",\n\t},\n\t{\n\t\ttable: \"memory_index\",\n\t\tauthorityClass: \"derived_rebuildable\",\n\t\trebuildableFrom: [\"okf_bundle\", \"external_provider\"],\n\t\tnotes:\n\t\t\t\"Index over durable memory sources; rebuildable by re-indexing the OKF bundle/provider content. \" +\n\t\t\t\"Rebuild from an external_provider source is conditional on that provider being enabled, reachable, \" +\n\t\t\t\"and permitted by egress/redaction policy at rebuild time; it is not unconditionally rebuildable \" +\n\t\t\t\"the way the OKF-bundle-backed portion is.\",\n\t},\n];\n"]}

package/dist/core/context/tool-output-packer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Tool output digesting and packing (Phase 3): "measure -> digest/preview/artifact ->
+ * prompt item", per tool-output-artifacts.md's boundary rule. Large raw tool output is
+ * captured to an artifact BEFORE truncation, so the artifact holds the exact raw payload;
+ * the model only ever sees the bounded preview plus an artifact reference.
+ *
+ * This module is pure with respect to wiring: it takes an `ArtifactStore` by dependency
+ * injection and does not know about sessions, transcripts, or prompt construction. A tool
+ * (grep/find) that never passes an `ArtifactStore` gets byte-for-byte its prior behavior --
+ * packing is opt-in per call site, not a global switch.
+ */
+import { type TruncationOptions, type TruncationResult } from "../tools/truncate.ts";
+import type { ArtifactStore } from "./context-artifacts.ts";
+export interface PackToolOutputRequest {
+    toolName: string;
+    command?: string;
+    path?: string;
+    rawContent: string;
+    sessionEntryId?: string;
+    /**
+     * Turn number for artifact capture identity. Real session-turn wiring lands in a later
+     * slice; callers that don't track turns yet may pass 0.
+     */
+    createdAtTurn?: number;
+    /** Whether re-running the same tool call would reproduce this content. Default: true. */
+    reproducible?: boolean;
+    truncation?: TruncationOptions;
+}
+export interface PackedToolOutput {
+    /**
+     * Bounded preview content -- exactly what `truncateHead` alone would have produced.
+     * No footer/notice text is appended here; callers already have their own per-tool
+     * footer conventions (grep's vs. find's bracket ordering differ) and own formatting
+     * the artifact notice into their own notice list via `formatArtifactNotice`.
+     */
+    content: string;
+    truncation: TruncationResult;
+    /** Present only if packing succeeded and the artifact is protected from cleanup. */
+    artifactId?: string;
+    packed: boolean;
+}
+/** Footer notice text for a packed artifact, for callers to fold into their own notices. */
+export declare function formatArtifactNotice(artifactId: string): string;
+/**
+ * Measure `request.rawContent`; if it fits within the caps, return it unchanged (small
+ * output stays exactly as readable as before this module existed). If it's oversized and
+ * an `ArtifactStore` is provided, capture the exact raw payload as an artifact first, then
+ * return the same bounded preview `truncateHead` would have produced anyway.
+ *
+ * Fails closed: if the artifact write succeeds but registering `holderId` as a reference
+ * fails (`addReference` returns false), the artifact is not claimed in the result at all --
+ * the caller falls back to the bounded/truncated content exactly as if no store had been
+ * provided, since an unprotected artifact could be cleaned up at any time.
+ */
+export declare function packToolOutput(request: PackToolOutputRequest, artifactStore: ArtifactStore | undefined, holderId: string): PackedToolOutput;
+export interface BroadQueryTracker {
+    /** Record one more broad occurrence of `key`; returns the cumulative count including this one. */
+    recordBroadQuery(key: string): number;
+}
+export declare function createInMemoryBroadQueryTracker(): BroadQueryTracker;
+/** Normalize a search-tool call into a stable repetition key: same query, same broadness. */
+export declare function normalizeBroadQueryKey(input: {
+    toolName: string;
+    pattern?: string;
+    path?: string;
+    glob?: string;
+}): string;
+/**
+ * When a broad-query condition (match/result limit hit, or byte truncation) repeats for
+ * the same normalized query, produce a compact "do not repeat" style note. This is only
+ * the Phase 3 signal; the durable invalidation ledger (supersession/expiry rules) is
+ * Phase 6 per implementation-phases.md.
+ */
+export declare function broadQueryInvalidationNote(tracker: BroadQueryTracker | undefined, key: string, humanQueryDescription: string): string | undefined;
+//# sourceMappingURL=tool-output-packer.d.ts.map

package/dist/core/context/tool-output-packer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-packer.d.ts","sourceRoot":"","sources":["../../../src/core/context/tool-output-packer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAgB,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAChC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,QAAQ,EAAE,MAAM,GACd,gBAAgB,CAuBlB;AAED,MAAM,WAAW,iBAAiB;IACjC,kGAAkG;IAClG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,wBAAgB,+BAA+B,IAAI,iBAAiB,CASnE;AAED,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAET;AAID;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,EACX,qBAAqB,EAAE,MAAM,GAC3B,MAAM,GAAG,SAAS,CAKpB","sourcesContent":["/**\n * Tool output digesting and packing (Phase 3): \"measure -> digest/preview/artifact ->\n * prompt item\", per tool-output-artifacts.md's boundary rule. Large raw tool output is\n * captured to an artifact BEFORE truncation, so the artifact holds the exact raw payload;\n * the model only ever sees the bounded preview plus an artifact reference.\n *\n * This module is pure with respect to wiring: it takes an `ArtifactStore` by dependency\n * injection and does not know about sessions, transcripts, or prompt construction. A tool\n * (grep/find) that never passes an `ArtifactStore` gets byte-for-byte its prior behavior --\n * packing is opt-in per call site, not a global switch.\n */\n\nimport { type TruncationOptions, type TruncationResult, truncateHead } from \"../tools/truncate.ts\";\nimport type { ArtifactStore } from \"./context-artifacts.ts\";\n\nexport interface PackToolOutputRequest {\n\ttoolName: string;\n\tcommand?: string;\n\tpath?: string;\n\trawContent: string;\n\tsessionEntryId?: string;\n\t/**\n\t * Turn number for artifact capture identity. Real session-turn wiring lands in a later\n\t * slice; callers that don't track turns yet may pass 0.\n\t */\n\tcreatedAtTurn?: number;\n\t/** Whether re-running the same tool call would reproduce this content. Default: true. */\n\treproducible?: boolean;\n\ttruncation?: TruncationOptions;\n}\n\nexport interface PackedToolOutput {\n\t/**\n\t * Bounded preview content -- exactly what `truncateHead` alone would have produced.\n\t * No footer/notice text is appended here; callers already have their own per-tool\n\t * footer conventions (grep's vs. find's bracket ordering differ) and own formatting\n\t * the artifact notice into their own notice list via `formatArtifactNotice`.\n\t */\n\tcontent: string;\n\ttruncation: TruncationResult;\n\t/** Present only if packing succeeded and the artifact is protected from cleanup. */\n\tartifactId?: string;\n\tpacked: boolean;\n}\n\n/** Footer notice text for a packed artifact, for callers to fold into their own notices. */\nexport function formatArtifactNotice(artifactId: string): string {\n\treturn `Full output: artifact tool-output:${artifactId}`;\n}\n\n/**\n * Measure `request.rawContent`; if it fits within the caps, return it unchanged (small\n * output stays exactly as readable as before this module existed). If it's oversized and\n * an `ArtifactStore` is provided, capture the exact raw payload as an artifact first, then\n * return the same bounded preview `truncateHead` would have produced anyway.\n *\n * Fails closed: if the artifact write succeeds but registering `holderId` as a reference\n * fails (`addReference` returns false), the artifact is not claimed in the result at all --\n * the caller falls back to the bounded/truncated content exactly as if no store had been\n * provided, since an unprotected artifact could be cleaned up at any time.\n */\nexport function packToolOutput(\n\trequest: PackToolOutputRequest,\n\tartifactStore: ArtifactStore | undefined,\n\tholderId: string,\n): PackedToolOutput {\n\tconst truncation = truncateHead(request.rawContent, request.truncation);\n\n\tif (!truncation.truncated || !artifactStore) {\n\t\treturn { content: truncation.content, truncation, packed: false };\n\t}\n\n\tconst { ref } = artifactStore.write({\n\t\tkind: \"tool_output\",\n\t\tcontent: request.rawContent,\n\t\ttoolName: request.toolName,\n\t\tcommand: request.command,\n\t\tpath: request.path,\n\t\tsessionEntryId: request.sessionEntryId,\n\t\tcreatedAtTurn: request.createdAtTurn ?? 0,\n\t\treproducible: request.reproducible ?? true,\n\t});\n\n\tif (!artifactStore.addReference(ref.id, holderId)) {\n\t\treturn { content: truncation.content, truncation, packed: false };\n\t}\n\n\treturn { content: truncation.content, truncation, artifactId: ref.id, packed: true };\n}\n\nexport interface BroadQueryTracker {\n\t/** Record one more broad occurrence of `key`; returns the cumulative count including this one. */\n\trecordBroadQuery(key: string): number;\n}\n\nexport function createInMemoryBroadQueryTracker(): BroadQueryTracker {\n\tconst counts = new Map<string, number>();\n\treturn {\n\t\trecordBroadQuery(key: string): number {\n\t\t\tconst next = (counts.get(key) ?? 0) + 1;\n\t\t\tcounts.set(key, next);\n\t\t\treturn next;\n\t\t},\n\t};\n}\n\n/** Normalize a search-tool call into a stable repetition key: same query, same broadness. */\nexport function normalizeBroadQueryKey(input: {\n\ttoolName: string;\n\tpattern?: string;\n\tpath?: string;\n\tglob?: string;\n}): string {\n\treturn [input.toolName, input.pattern ?? \"\", input.path ?? \"\", input.glob ?? \"\"].join(\"␟\");\n}\n\nconst REPEATED_BROAD_QUERY_THRESHOLD = 2;\n\n/**\n * When a broad-query condition (match/result limit hit, or byte truncation) repeats for\n * the same normalized query, produce a compact \"do not repeat\" style note. This is only\n * the Phase 3 signal; the durable invalidation ledger (supersession/expiry rules) is\n * Phase 6 per implementation-phases.md.\n */\nexport function broadQueryInvalidationNote(\n\ttracker: BroadQueryTracker | undefined,\n\tkey: string,\n\thumanQueryDescription: string,\n): string | undefined {\n\tif (!tracker) return undefined;\n\tconst count = tracker.recordBroadQuery(key);\n\tif (count < REPEATED_BROAD_QUERY_THRESHOLD) return undefined;\n\treturn `Do not repeat: ${humanQueryDescription} has produced broad/truncated results ${count} times in this session. Narrow the path/glob/pattern.`;\n}\n"]}