ai-memory-layer 2.0.0

package/dist/core/runtime.js

@@ -0,0 +1,84 @@
+import { formatBootstrapForPrompt, formatContextAsMessages, formatContextForPrompt, } from './formatter.js';
+function resolveRuntimeInput(input) {
+    return typeof input === 'string'
+        ? {
+            input,
+        }
+        : input;
+}
+export function createMemoryRuntime(manager, options = {}) {
+    async function getBootstrapPayload(relevanceQuery, format) {
+        const bootstrap = await manager.getSessionBootstrap(relevanceQuery);
+        const bootstrapPrompt = formatBootstrapForPrompt(bootstrap, format ?? options.format);
+        return {
+            bootstrap,
+            bootstrapPrompt,
+        };
+    }
+    return {
+        async startSession(relevanceQuery, format) {
+            return getBootstrapPayload(relevanceQuery, format);
+        },
+        async resumeSession(relevanceQuery, format) {
+            return getBootstrapPayload(relevanceQuery, format);
+        },
+        async beforeModelCall(input) {
+            const resolved = resolveRuntimeInput(input);
+            const resolvedFormat = {
+                ...(options.format ?? {}),
+                ...(resolved.format ?? {}),
+                includeProvisionalKnowledge: resolved.includeProvisionalKnowledge ??
+                    resolved.format?.includeProvisionalKnowledge ??
+                    options.format?.includeProvisionalKnowledge,
+                includeDisputedKnowledge: resolved.includeDisputedKnowledge ??
+                    resolved.format?.includeDisputedKnowledge ??
+                    options.format?.includeDisputedKnowledge,
+            };
+            const [bootstrapPayload, context] = await Promise.all([
+                getBootstrapPayload(resolved.relevanceQuery ?? resolved.input, resolvedFormat),
+                resolved.asOf != null
+                    ? manager.getContextAt(resolved.asOf, resolved.relevanceQuery ?? resolved.input)
+                    : manager.getContext(resolved.relevanceQuery ?? resolved.input),
+            ]);
+            const contextPrompt = formatContextForPrompt(context, resolvedFormat);
+            return {
+                bootstrap: bootstrapPayload.bootstrap,
+                context,
+                bootstrapPrompt: bootstrapPayload.bootstrapPrompt,
+                prompt: [bootstrapPayload.bootstrapPrompt, contextPrompt].join('\n\n'),
+                messages: formatContextAsMessages(context, resolvedFormat),
+            };
+        },
+        async afterModelCall(input) {
+            const exchange = await manager.processExchange(input.userInput, input.assistantOutput, input.actors);
+            const inferred = options.inferWorkItems
+                ? await options.inferWorkItems({
+                    userInput: input.userInput,
+                    assistantOutput: input.assistantOutput,
+                })
+                : [];
+            const trackedWorkItems = await Promise.all([...(input.workItems ?? []), ...inferred].map((item) => manager.trackWorkItem(item.title, item.kind, item.status, item.detail)));
+            return {
+                exchange,
+                trackedWorkItems,
+            };
+        },
+        async wrapModelCall(modelCall, input, actors) {
+            const runtime = await this.beforeModelCall(input);
+            const result = await modelCall(runtime);
+            const resolved = resolveRuntimeInput(input);
+            const after = await this.afterModelCall({
+                userInput: resolved.input,
+                assistantOutput: result,
+                actors,
+            });
+            return {
+                result,
+                runtime,
+                exchange: after.exchange,
+                trackedWorkItems: after.trackedWorkItems,
+            };
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

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

package/dist/core/streaming.d.ts

@@ -0,0 +1,37 @@
+import type { Turn, TurnRole } from '../contracts/types.js';
+import type { MemoryManager } from './manager.js';
+/**
+ * A collector that accumulates streamed text chunks and commits them
+ * as a single turn when finalized.
+ */
+export interface StreamCollector {
+    /** Append a chunk of text to the buffer. */
+    write(chunk: string): void;
+    /** Get the current accumulated text. */
+    getText(): string;
+    /** Finalize the stream and commit the full content as a turn. */
+    finalize(): Promise<Turn>;
+}
+/**
+ * Creates a StreamCollector that buffers streamed model output and commits
+ * the full response as a single turn when the stream ends.
+ *
+ * ```typescript
+ * const collector = createStreamCollector(manager, 'assistant');
+ * for await (const chunk of modelStream) {
+ *   collector.write(chunk);
+ * }
+ * const turn = await collector.finalize();
+ * ```
+ */
+export declare function createStreamCollector(manager: MemoryManager, role: TurnRole, actor?: string): StreamCollector;
+/**
+ * Processes an async iterable stream as a single turn.
+ * Collects all chunks, then commits the full content.
+ *
+ * ```typescript
+ * const turn = await processStreamingTurn(manager, 'assistant', modelStream);
+ * ```
+ */
+export declare function processStreamingTurn(manager: MemoryManager, role: TurnRole, stream: AsyncIterable<string>, actor?: string): Promise<Turn>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/core/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/core/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wCAAwC;IACxC,OAAO,IAAI,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,QAAQ,EACd,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAyBjB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/core/streaming.js

@@ -0,0 +1,51 @@
+/**
+ * Creates a StreamCollector that buffers streamed model output and commits
+ * the full response as a single turn when the stream ends.
+ *
+ * ```typescript
+ * const collector = createStreamCollector(manager, 'assistant');
+ * for await (const chunk of modelStream) {
+ *   collector.write(chunk);
+ * }
+ * const turn = await collector.finalize();
+ * ```
+ */
+export function createStreamCollector(manager, role, actor) {
+    const chunks = [];
+    let finalized = false;
+    return {
+        write(chunk) {
+            if (finalized) {
+                throw new Error('StreamCollector: cannot write after finalize()');
+            }
+            chunks.push(chunk);
+        },
+        getText() {
+            return chunks.join('');
+        },
+        async finalize() {
+            if (finalized) {
+                throw new Error('StreamCollector: already finalized');
+            }
+            finalized = true;
+            const content = chunks.join('');
+            return manager.processTurn(role, content, actor);
+        },
+    };
+}
+/**
+ * Processes an async iterable stream as a single turn.
+ * Collects all chunks, then commits the full content.
+ *
+ * ```typescript
+ * const turn = await processStreamingTurn(manager, 'assistant', modelStream);
+ * ```
+ */
+export async function processStreamingTurn(manager, role, stream, actor) {
+    const collector = createStreamCollector(manager, role, actor);
+    for await (const chunk of stream) {
+        collector.write(chunk);
+    }
+    return collector.finalize();
+}
+//# sourceMappingURL=streaming.js.map

package/dist/core/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/core/streaming.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAsB,EACtB,IAAc,EACd,KAAc;IAEd,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO;QACL,KAAK,CAAC,KAAa;YACjB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,OAAO;YACL,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAsB,EACtB,IAAc,EACd,MAA6B,EAC7B,KAAc;IAEd,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/sync.d.ts

@@ -0,0 +1,13 @@
+import type { ScopeLevel } from '../contracts/identity.js';
+import type { KnowledgeMemory } from '../contracts/types.js';
+import type { MemoryManager } from './manager.js';
+export declare function createMemorySync(options: {
+    manager: MemoryManager;
+    scopeLevel?: ScopeLevel;
+    pollIntervalMs?: number;
+}): {
+    onKnowledgeChange(handler: (knowledge: KnowledgeMemory[]) => void): () => boolean;
+    startPolling(): void;
+    stopPolling(): void;
+};
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;+BAyB8B,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,IAAI;;;EAiBpE"}

package/dist/core/sync.js

@@ -0,0 +1,46 @@
+export function createMemorySync(options) {
+    const handlers = new Set();
+    const pollIntervalMs = options.pollIntervalMs ?? 5000;
+    let timer = null;
+    let lastSeen = new Date(0);
+    let inFlight = false;
+    async function pollOnce() {
+        if (inFlight)
+            return;
+        inFlight = true;
+        try {
+            const changes = await options.manager.pollForChanges(lastSeen, {
+                scopeLevel: options.scopeLevel,
+            });
+            if (changes.length > 0) {
+                const newest = Math.max(...changes.map((item) => item.created_at));
+                lastSeen = new Date(newest * 1000);
+                handlers.forEach((handler) => handler(changes));
+            }
+        }
+        finally {
+            inFlight = false;
+        }
+    }
+    return {
+        onKnowledgeChange(handler) {
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        startPolling() {
+            if (timer)
+                return;
+            timer = setInterval(() => {
+                void pollOnce();
+            }, pollIntervalMs);
+            void pollOnce();
+        },
+        stopPolling() {
+            if (!timer)
+                return;
+            clearInterval(timer);
+            timer = null;
+        },
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,gBAAgB,CAAC,OAIhC;IACC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0C,CAAC;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,IAAI,KAAK,GAA0C,IAAI,CAAC;IACxD,IAAI,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,UAAU,QAAQ;QACrB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE;gBAC7D,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBACnE,QAAQ,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;gBACnC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,iBAAiB,CAAC,OAA+C;YAC/D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,YAAY;YACV,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,KAAK,QAAQ,EAAE,CAAC;YAClB,CAAC,EAAE,cAAc,CAAC,CAAC;YACnB,KAAK,QAAQ,EAAE,CAAC;QAClB,CAAC;QACD,WAAW;YACT,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/telemetry.d.ts

@@ -0,0 +1,8 @@
+import { type MemoryScope } from '../contracts/identity.js';
+import type { EventHook, Logger, MemoryEvent } from '../contracts/observability.js';
+export interface TelemetryOptions {
+    logger?: Logger;
+    onEvent?: EventHook;
+}
+export declare function emitMemoryEvent(type: MemoryEvent['type'], scope: MemoryScope, options: TelemetryOptions | undefined, durationMs: number, meta?: Record<string, unknown>): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/core/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,IAAI,CAYN"}

package/dist/core/telemetry.js

@@ -0,0 +1,14 @@
+import { normalizeScope } from '../contracts/identity.js';
+export function emitMemoryEvent(type, scope, options, durationMs, meta = {}) {
+    const normalizedScope = normalizeScope(scope);
+    const event = {
+        type,
+        scope: normalizedScope,
+        timestamp: Date.now(),
+        durationMs,
+        meta,
+    };
+    options?.onEvent?.(event);
+    options?.logger?.debug(`memory.${type}`, event.meta);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/core/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,0BAA0B,CAAC;AAQ5E,MAAM,UAAU,eAAe,CAC7B,IAAyB,EACzB,KAAkB,EAClB,OAAqC,EACrC,UAAkB,EAClB,OAAgC,EAAE;IAElC,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAgB;QACzB,IAAI;QACJ,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU;QACV,IAAI;KACL,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/core/tokens.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryScope } from '../contracts/identity.js';
+export type TokenEstimator = (text: string) => number;
+export declare function createCharacterRatioTokenEstimator(charsPerToken?: number, multiplier?: number): TokenEstimator;
+export declare function createModelTokenEstimator(model?: string): TokenEstimator;
+export declare function createTiktokenEstimator(model?: string): Promise<TokenEstimator>;
+export declare function estimateTokens(text: string): number;
+export declare function createSessionId(scope: MemoryScope): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/core/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAW5D,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAGtD,wBAAgB,kCAAkC,CAChD,aAAa,SAAkB,EAC/B,UAAU,SAAmB,GAC5B,cAAc,CAKhB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAQxE;AAED,wBAAsB,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BrF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK1D"}

package/dist/core/tokens.js

@@ -0,0 +1,59 @@
+import { randomBytes } from 'crypto';
+import { normalizeScope } from '../contracts/identity.js';
+const TOKEN_MULTIPLIER = 1.15;
+const CHARS_PER_TOKEN = 4;
+const MODEL_CHAR_RATIOS = [
+    { match: /gpt-4|gpt-5|o1|o3|o4/i, charsPerToken: 3.3 },
+    { match: /claude/i, charsPerToken: 3.5 },
+    { match: /llama|mistral|mixtral/i, charsPerToken: 3.7 },
+];
+const defaultTokenEstimator = createCharacterRatioTokenEstimator();
+export function createCharacterRatioTokenEstimator(charsPerToken = CHARS_PER_TOKEN, multiplier = TOKEN_MULTIPLIER) {
+    return (text) => {
+        if (text.length === 0)
+            return 0;
+        return Math.max(1, Math.ceil((text.length / charsPerToken) * multiplier));
+    };
+}
+export function createModelTokenEstimator(model) {
+    if (!model) {
+        return createCharacterRatioTokenEstimator();
+    }
+    const resolved = MODEL_CHAR_RATIOS.find((entry) => entry.match.test(model))?.charsPerToken ?? CHARS_PER_TOKEN;
+    return createCharacterRatioTokenEstimator(resolved);
+}
+export async function createTiktokenEstimator(model) {
+    try {
+        const moduleName = 'tiktoken';
+        const tiktokenModule = await import(moduleName);
+        const encodingForModel = tiktokenModule.encoding_for_model ??
+            tiktokenModule.encodingForModel ??
+            tiktokenModule.getEncodingForModel;
+        const getEncoding = tiktokenModule.get_encoding ?? tiktokenModule.getEncoding;
+        const encoding = (typeof encodingForModel === 'function' && model
+            ? encodingForModel(model)
+            : undefined) ??
+            (typeof getEncoding === 'function' ? getEncoding('cl100k_base') : undefined);
+        if (!encoding || typeof encoding.encode !== 'function') {
+            return createModelTokenEstimator(model);
+        }
+        return (text) => {
+            if (text.length === 0)
+                return 0;
+            return Math.max(1, encoding.encode(text).length);
+        };
+    }
+    catch {
+        return createModelTokenEstimator(model);
+    }
+}
+export function estimateTokens(text) {
+    return defaultTokenEstimator(text);
+}
+export function createSessionId(scope) {
+    normalizeScope(scope);
+    const date = new Date().toISOString().slice(0, 10);
+    const rand = randomBytes(4).toString('hex');
+    return ['session', date, rand].join('_');
+}
+//# sourceMappingURL=tokens.js.map

package/dist/core/tokens.js.map

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

package/dist/core/trust.d.ts

@@ -0,0 +1,23 @@
+import type { ExtractionPolicy } from '../contracts/policy.js';
+import type { KnowledgeCandidate, KnowledgeConflict, KnowledgeEvidence, KnowledgeMemory, KnowledgeTrustAssessment } from '../contracts/types.js';
+export declare function computeContradictionScore(evidence: KnowledgeEvidence[]): number;
+export declare function assessCandidateTrust(input: {
+    candidate: KnowledgeCandidate;
+    evidence: KnowledgeEvidence[];
+    policy: Required<ExtractionPolicy>;
+    existingKnowledge?: KnowledgeMemory | null;
+    relation?: KnowledgeConflict['relation'] | 'created';
+}): KnowledgeTrustAssessment;
+export declare function assessKnowledgeReverification(input: {
+    knowledge: KnowledgeMemory;
+    evidence: KnowledgeEvidence[];
+    policy: Required<ExtractionPolicy>;
+}): KnowledgeTrustAssessment;
+export declare function buildKnowledgeConflict(input: {
+    existing: KnowledgeMemory;
+    candidateId: number | null;
+    relation: KnowledgeConflict['relation'];
+    contradictionScore: number;
+    policy: Required<ExtractionPolicy>;
+}): KnowledgeConflict;
+//# sourceMappingURL=trust.d.ts.map

package/dist/core/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/core/trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAuB/B,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAQ/E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACnC,iBAAiB,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CACtD,GAAG,wBAAwB,CAoG3B;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CACpC,GAAG,wBAAwB,CAqC3B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CACpC,GAAG,iBAAiB,CAcpB"}

package/dist/core/trust.js

@@ -0,0 +1,164 @@
+function average(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function clamp(value, min = 0, max = 1) {
+    return Math.max(min, Math.min(max, value));
+}
+function contradictionPenalty(score, policy) {
+    if (score >= policy.contradictionSeverityHighThreshold)
+        return 'high';
+    if (score >= policy.contradictionSeverityMediumThreshold)
+        return 'medium';
+    return 'low';
+}
+export function computeContradictionScore(evidence) {
+    const supporting = evidence.filter((item) => item.support_polarity === 'supports');
+    const contradicting = evidence.filter((item) => item.support_polarity === 'contradicts');
+    if (supporting.length === 0 && contradicting.length === 0)
+        return 0;
+    const supportWeight = supporting.reduce((sum, item) => sum + item.explicitness_score, 0);
+    const contradictionWeight = contradicting.reduce((sum, item) => sum + item.explicitness_score, 0);
+    const total = supportWeight + contradictionWeight;
+    return total <= 0 ? 0 : contradictionWeight / total;
+}
+export function assessCandidateTrust(input) {
+    const { candidate, evidence, policy } = input;
+    const relation = input.relation ?? 'created';
+    const supporting = evidence.filter((item) => item.support_polarity === 'supports');
+    const contradicting = evidence.filter((item) => item.support_polarity === 'contradicts');
+    const assistantSupport = supporting.filter((item) => item.source_type === 'assistant_turn').length;
+    const toolSupport = supporting.filter((item) => ['tool_output', 'execution_result'].includes(item.source_type)).length;
+    const humanFeedbackSupport = supporting.filter((item) => item.source_type === 'human_feedback').length;
+    const explicitSupport = supporting.filter((item) => item.is_explicit).length;
+    const protectedSingleSourceSupport = supporting.some((item) => ['user_turn', 'system_turn', 'human_feedback', 'tool_output'].includes(item.source_type));
+    const successSupport = supporting.filter((item) => item.outcome === 'success').length;
+    const failureSupport = supporting.filter((item) => item.outcome === 'failure').length;
+    const contradictionScore = computeContradictionScore(evidence);
+    const reasons = [];
+    let trustScore = candidate.trust_score;
+    if (policy.requireGroundingForTrusted && supporting.length === 0) {
+        trustScore -= policy.noGroundingPenalty;
+        reasons.push('no_raw_turn_grounding');
+    }
+    if (assistantSupport > 0) {
+        trustScore -= policy.assistantClaimPenalty * assistantSupport;
+        reasons.push('assistant_claim_penalty');
+    }
+    if (toolSupport > 0) {
+        trustScore += policy.toolEvidenceBoost * toolSupport;
+        reasons.push('tool_or_feedback_evidence');
+    }
+    if (humanFeedbackSupport > 0) {
+        trustScore += policy.humanFeedbackBoost * humanFeedbackSupport;
+        reasons.push('human_feedback_evidence');
+    }
+    if (explicitSupport > 0) {
+        trustScore += policy.explicitStatementBoost * explicitSupport;
+        reasons.push('explicit_support');
+    }
+    if (successSupport > 0) {
+        trustScore += policy.executionSuccessBoost * successSupport;
+        reasons.push('successful_outcome_support');
+    }
+    if (failureSupport > 0) {
+        trustScore -= policy.executionFailurePenalty * failureSupport;
+        reasons.push('failure_outcome_penalty');
+    }
+    trustScore -= contradictionScore * policy.contradictionTrustPenalty;
+    if (contradictionScore > 0) {
+        reasons.push('contradictory_evidence_present');
+    }
+    trustScore = clamp(trustScore);
+    if (contradictionScore >= policy.contradictionDisputeThreshold) {
+        return {
+            trust_score: trustScore,
+            state: 'disputed',
+            decision: input.existingKnowledge ? 'mark_disputed' : 'reject_candidate',
+            reasons,
+        };
+    }
+    if ((supporting.length >= policy.minimumEvidenceCountForTrusted ||
+        ((candidate.knowledge_class === 'constraint' || candidate.knowledge_class === 'identity') &&
+            protectedSingleSourceSupport &&
+            explicitSupport > 0 &&
+            contradicting.length === 0 &&
+            relation !== 'conflict' &&
+            relation !== 'update')) &&
+        trustScore >= policy.trustPromotionThreshold) {
+        return {
+            trust_score: trustScore,
+            state: 'trusted',
+            decision: input.relation === 'update' || input.relation === 'conflict'
+                ? 'supersede_existing'
+                : 'promote_candidate',
+            reasons,
+        };
+    }
+    if (trustScore >= policy.trustProvisionalThreshold && supporting.length > 0) {
+        return {
+            trust_score: trustScore,
+            state: 'provisional',
+            decision: 'keep_provisional',
+            reasons,
+        };
+    }
+    return {
+        trust_score: trustScore,
+        state: 'candidate',
+        decision: 'reject_candidate',
+        reasons,
+    };
+}
+export function assessKnowledgeReverification(input) {
+    const contradictionScore = computeContradictionScore(input.evidence);
+    const explicitness = average(input.evidence.map((item) => item.explicitness_score));
+    const baseCandidate = {
+        id: input.knowledge.id,
+        tenant_id: input.knowledge.tenant_id,
+        system_id: input.knowledge.system_id,
+        workspace_id: input.knowledge.workspace_id,
+        collaboration_id: input.knowledge.collaboration_id,
+        scope_id: input.knowledge.scope_id,
+        working_memory_id: input.knowledge.source_working_memory_id ?? 0,
+        fact: input.knowledge.fact,
+        fact_type: input.knowledge.fact_type,
+        knowledge_class: input.knowledge.knowledge_class,
+        normalized_fact: input.knowledge.normalized_fact ?? input.knowledge.fact.toLowerCase(),
+        slot_key: input.knowledge.slot_key,
+        confidence: input.knowledge.confidence,
+        source_summary: true,
+        source_turns: input.evidence.some((item) => item.support_polarity === 'supports'),
+        grounding_strength: input.knowledge.grounding_strength,
+        evidence_count: input.evidence.filter((item) => item.support_polarity === 'supports').length,
+        trust_score: clamp(input.knowledge.trust_score +
+            explicitness * input.policy.reverificationExplicitnessBoost -
+            contradictionScore * input.policy.reverificationContradictionPenalty),
+        state: input.knowledge.knowledge_state === 'provisional' ? 'provisional' : 'candidate',
+        created_at: input.knowledge.created_at,
+        promoted_knowledge_id: input.knowledge.id,
+    };
+    return assessCandidateTrust({
+        candidate: baseCandidate,
+        evidence: input.evidence,
+        policy: input.policy,
+        existingKnowledge: input.knowledge,
+        relation: 'created',
+    });
+}
+export function buildKnowledgeConflict(input) {
+    const severity = contradictionPenalty(input.contradictionScore, input.policy);
+    return {
+        existing_knowledge_id: input.existing.id,
+        candidate_id: input.candidateId,
+        relation: input.relation,
+        severity,
+        resolution: input.relation === 'update'
+            ? 'supersede'
+            : input.contradictionScore >= input.policy.contradictionDisputeThreshold
+                ? 'dispute'
+                : 'ignore',
+    };
+}
+//# sourceMappingURL=trust.js.map

package/dist/core/trust.js.map

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

package/dist/core/validation.d.ts

@@ -0,0 +1,36 @@
+import { type MemoryScope, type NormalizedMemoryScope } from '../contracts/identity.js';
+import type { CompactionState, CompactionTrigger, ContextMonitorUpsert, EvidenceSourceType, FactConfidence, FactSource, FactType, GroundingStrength, KnowledgeAuditDecision, KnowledgeClass, KnowledgeState, NewKnowledgeCandidate, NewKnowledgeEvidence, NewCompactionLog, NewKnowledgeMemoryAudit, NewKnowledgeMemory, NewWorkItem, NewTurn, NewWorkingMemory, TimeRange, TurnRole, WorkItemKind, WorkItemStatus } from '../contracts/types.js';
+export declare function nowSeconds(): number;
+export declare function assertNonEmpty(value: string, name: string): void;
+export declare function assertEnum<T>(value: T, allowed: readonly T[], name: string): void;
+export declare function assertStringArray(value: string[], name: string): void;
+export declare function assertMaxEntries(value: string[], name: string, max: number): void;
+export declare function assertNumberRange(value: number, name: string, min: number, max: number): void;
+export declare function assertTurnRange(startId: number, endId: number): void;
+export declare function assertScope(scope: MemoryScope): NormalizedMemoryScope;
+export declare function assertTurnRole(role: TurnRole): void;
+export declare function assertCompactionTrigger(trigger: CompactionTrigger, name?: string): void;
+export declare function assertFactType(factType: FactType): void;
+export declare function assertFactSource(source: FactSource): void;
+export declare function assertFactConfidence(confidence: FactConfidence): void;
+export declare function assertKnowledgeState(state: KnowledgeState): void;
+export declare function assertKnowledgeClass(knowledgeClass: KnowledgeClass): void;
+export declare function assertEvidenceSourceType(sourceType: EvidenceSourceType): void;
+export declare function assertGroundingStrength(strength: GroundingStrength): void;
+export declare function assertSupportPolarity(polarity: 'supports' | 'contradicts'): void;
+export declare function assertKnowledgeAuditDecision(decision: KnowledgeAuditDecision): void;
+export declare function assertCompactionState(state: CompactionState): void;
+export declare function assertWorkItemKind(kind: WorkItemKind): void;
+export declare function assertWorkItemStatus(status: WorkItemStatus): void;
+export declare function validateNewTurn(input: NewTurn): NormalizedMemoryScope;
+export declare function validateNewWorkingMemory(input: NewWorkingMemory): NormalizedMemoryScope;
+export declare function validateNewKnowledgeMemory(input: NewKnowledgeMemory): NormalizedMemoryScope;
+export declare function validateNewKnowledgeMemoryAudit(input: NewKnowledgeMemoryAudit): NormalizedMemoryScope;
+export declare function validateNewKnowledgeCandidate(input: NewKnowledgeCandidate): NormalizedMemoryScope;
+export declare function validateNewKnowledgeEvidence(input: NewKnowledgeEvidence): NormalizedMemoryScope;
+export declare function validateContextMonitorUpsert(input: ContextMonitorUpsert): NormalizedMemoryScope;
+export declare function validateNewCompactionLog(input: NewCompactionLog): NormalizedMemoryScope;
+export declare function validateTimeRange(range: TimeRange): void;
+export declare function validateNewWorkItem(input: NewWorkItem): NormalizedMemoryScope;
+export declare function assertArchiveInput(id: number, archivedAt: number, compactionLogId: number): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,KAAK,EAEV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,EACf,MAAM,uBAAuB,CAAC;AAkB/B,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMjF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMjF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAM7F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMpE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAErE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEnD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,SAAuB,GAAG,IAAI,CAErG;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAErE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAEzE;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAE7E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEzE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAEhF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAEnF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAElE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAUrE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAUvF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,qBAAqB,CAgB3F;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,uBAAuB,GAC7B,qBAAqB,CAOvB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CASjG;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAS/F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAI/F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAMvF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAQxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAM7E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAchG"}