@steno-ai/engine 0.1.0 → 0.1.2

package/src/retrieval/types.d.ts

@@ -12,6 +12,7 @@ export interface SearchOptions {
         asOf?: Date;
     };
     weights?: FusionWeights;
+    tokenBudget?: number;
 }
 /** Configurable fusion weights (should sum to 1.0 — normalized if not) */
 export interface FusionWeights {
@@ -20,6 +21,7 @@ export interface FusionWeights {
     graph: number;
     recency: number;
     salience: number;
+    temporal: number;
 }
 /** A single search result with all signal scores */
 export interface SearchResult {
@@ -31,6 +33,7 @@ export interface SearchResult {
         graphScore: number;
         recencyScore: number;
         salienceScore: number;
+        temporalScore: number;
     };
     triggeredBy?: string;
     contradiction?: {
@@ -59,6 +62,7 @@ export interface Candidate {
     graphScore: number;
     recencyScore: number;
     salienceScore: number;
+    temporalScore: number;
     source: 'vector' | 'keyword' | 'graph' | 'trigger';
     triggeredBy?: string;
 }

package/src/retrieval/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,IAAI,CAAC;KACb,CAAC;IACF,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,WAAW,EAAE,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC;IACF,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,IAAI,CAAC;KACb,CAAC;IACF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,WAAW,EAAE,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC;IACF,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAOpC,CAAC"}

package/src/retrieval/types.js

@@ -0,0 +1,9 @@
+export const DEFAULT_FUSION_WEIGHTS = {
+    vector: 0.30,
+    keyword: 0.15,
+    graph: 0.15,
+    recency: 0.10,
+    salience: 0.10,
+    temporal: 0.20,
+};
+//# sourceMappingURL=types.js.map

package/src/retrieval/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAsEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;CACf,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AA0EA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;CACf,CAAC"}

package/src/retrieval/vector-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["vector-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,IAAI,GACV,OAAO,CAAC,SAAS,EAAE,CAAC,CAuBtB"}
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["vector-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,IAAI,GACV,OAAO,CAAC,SAAS,EAAE,CAAC,CAwBtB"}

package/src/retrieval/vector-search.js

@@ -0,0 +1,24 @@
+export async function vectorSearch(storage, embedding, query, tenantId, scope, scopeId, limit, asOf) {
+    const queryEmbedding = await embedding.embed(query);
+    const results = await storage.vectorSearch({
+        embedding: queryEmbedding,
+        tenantId,
+        scope,
+        scopeId,
+        limit,
+        minSimilarity: 0.0,
+        validOnly: true,
+        asOf,
+    });
+    return results.map((r) => ({
+        fact: r.fact,
+        vectorScore: r.similarity,
+        keywordScore: 0,
+        graphScore: 0,
+        recencyScore: 0,
+        salienceScore: 0,
+        temporalScore: 0,
+        source: 'vector',
+    }));
+}
+//# sourceMappingURL=vector-search.js.map

package/src/retrieval/vector-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-search.js","sourceRoot":"","sources":["vector-search.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,SAA2B,EAC3B,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,KAAa,EACb,IAAW;IAEX,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;QACzC,SAAS,EAAE,cAAc;QACzB,QAAQ;QACR,KAAK;QACL,OAAO;QACP,KAAK;QACL,aAAa,EAAE,GAAG;QAClB,SAAS,EAAE,IAAI;QACf,IAAI;KACL,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,QAAiB;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"vector-search.js","sourceRoot":"","sources":["vector-search.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,SAA2B,EAC3B,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,KAAa,EACb,IAAW;IAEX,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;QACzC,SAAS,EAAE,cAAc;QACzB,QAAQ;QACR,KAAK;QACL,OAAO;QACP,KAAK;QACL,aAAa,EAAE,GAAG;QAClB,SAAS,EAAE,IAAI;QACf,IAAI;KACL,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,QAAiB;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/src/salience/decay.js

@@ -0,0 +1,15 @@
+export function calculateDecayScore(input) {
+    const { importance, frequency, lastAccessed, halfLifeDays, normalizationK } = input;
+    if (lastAccessed === null)
+        return 0;
+    // Recency factor: exponential decay using Ebbinghaus forgetting curve
+    const daysSinceAccess = (Date.now() - lastAccessed.getTime()) / (1000 * 60 * 60 * 24);
+    const lambda = Math.LN2 / halfLifeDays;
+    const recencyFactor = Math.exp(-lambda * daysSinceAccess);
+    // Frequency factor: logarithmic scaling with fixed normalization constant K
+    const frequencyFactor = Math.min(1.0, Math.log(1 + frequency) / Math.log(1 + normalizationK));
+    // Final score: clamped to [0, 1]
+    const score = importance * recencyFactor * frequencyFactor;
+    return Math.max(0, Math.min(1, score));
+}
+//# sourceMappingURL=decay.js.map

package/src/scratchpad/scratchpad.js

@@ -0,0 +1,107 @@
+const SCRATCHPAD_MAX_CHARS = 5000;
+const SCRATCHPAD_COMPRESSED_CHARS = 2500;
+/**
+ * Get or create a scratchpad for a scope.
+ * The scratchpad is stored as a special fact with tag 'scratchpad'.
+ */
+export async function getScratchpad(storage, tenantId, scope, scopeId) {
+    const facts = await storage.getFactsByScope(tenantId, scope, scopeId, { limit: 100 });
+    const scratchpadFact = facts.data.find(f => f.tags?.includes('scratchpad'));
+    return scratchpadFact?.content ?? '';
+}
+/**
+ * Update the scratchpad after an extraction.
+ * Appends new facts to the existing scratchpad, compresses if too long.
+ */
+export async function updateScratchpad(storage, llm, tenantId, scope, scopeId, newFacts) {
+    if (newFacts.length === 0)
+        return;
+    // Get existing scratchpad
+    const existing = await getScratchpad(storage, tenantId, scope, scopeId);
+    // Append new facts
+    const newSection = newFacts.join('\n');
+    let updated = existing ? `${existing}\n\n--- New information ---\n${newSection}` : newSection;
+    // Compress if too long
+    if (updated.length > SCRATCHPAD_MAX_CHARS) {
+        updated = await compressScratchpad(llm, updated);
+    }
+    // Find existing scratchpad fact and invalidate it
+    const facts = await storage.getFactsByScope(tenantId, scope, scopeId, { limit: 200 });
+    const existingScratchpad = facts.data.find(f => f.tags?.includes('scratchpad'));
+    if (existingScratchpad) {
+        await storage.invalidateFact(tenantId, existingScratchpad.id);
+    }
+    // Create new scratchpad fact (no embedding needed — it's retrieved by tag, not vector search)
+    const id = crypto.randomUUID();
+    await storage.createFact({
+        id,
+        lineageId: existingScratchpad?.lineageId ?? crypto.randomUUID(),
+        tenantId,
+        scope,
+        scopeId,
+        content: updated,
+        embeddingModel: 'none',
+        embeddingDim: 1,
+        importance: 1.0,
+        confidence: 1.0,
+        operation: existingScratchpad ? 'update' : 'create',
+        sourceType: 'api',
+        modality: 'text',
+        tags: ['scratchpad'],
+        metadata: { type: 'scratchpad', updatedAt: new Date().toISOString() },
+        contradictionStatus: 'none',
+    });
+}
+/**
+ * Compress the scratchpad using an LLM.
+ * Preserves the most important information while reducing size.
+ */
+export async function compressScratchpad(llm, content) {
+    const response = await llm.complete([
+        {
+            role: 'system',
+            content: `Compress the following user profile/scratchpad into a concise summary of ~${SCRATCHPAD_COMPRESSED_CHARS} characters.
+
+Preserve:
+- Names of people and their relationships
+- Key facts (job, location, health, allergies)
+- Strong preferences and personality traits
+- Important events with dates
+- Goals and future plans
+- Contradictions or changes in opinion
+
+Remove:
+- Duplicate information
+- Trivial details
+- Repetitive emotional expressions
+
+Output ONLY the compressed summary, no explanation.`
+        },
+        { role: 'user', content }
+    ], { temperature: 0 });
+    return response.content;
+}
+/**
+ * Get filtered scratchpad content relevant to a query.
+ */
+export async function getRelevantScratchpad(storage, llm, tenantId, scope, scopeId, query) {
+    const scratchpad = await getScratchpad(storage, tenantId, scope, scopeId);
+    if (!scratchpad || scratchpad.length < 50)
+        return '';
+    // If scratchpad is short, return all of it
+    if (scratchpad.length < 1000)
+        return scratchpad;
+    // Filter scratchpad for relevant content
+    const response = await llm.complete([
+        {
+            role: 'system',
+            content: 'Extract ONLY the parts of this user profile that are relevant to answering the given question. Return the relevant excerpts. If nothing is relevant, return empty string.'
+        },
+        {
+            role: 'user',
+            content: `Profile:\n${scratchpad}\n\nQuestion: ${query}`
+        }
+    ], { temperature: 0 });
+    return response.content;
+}
+//# sourceMappingURL=scratchpad.js.map

package/src/sessions/manager.d.ts

@@ -0,0 +1,11 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { LLMAdapter } from '../adapters/llm.js';
+import type { Session } from '../models/session.js';
+import type { SessionScope } from '../config.js';
+/**
+ * Find an active (not ended) session for the given scope, or create a new one.
+ */
+export declare function getOrCreateActiveSession(storage: StorageAdapter, tenantId: string, scope: SessionScope, scopeId: string): Promise<Session>;
+export declare function startSession(storage: StorageAdapter, tenantId: string, scope: SessionScope, scopeId: string, metadata?: Record<string, unknown>): Promise<Session>;
+export declare function endSession(storage: StorageAdapter, llm: LLMAdapter, tenantId: string, sessionId: string): Promise<Session>;
+//# sourceMappingURL=manager.d.ts.map

package/src/sessions/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CA0ClB"}

package/src/sessions/manager.js

@@ -0,0 +1,63 @@
+/**
+ * Find an active (not ended) session for the given scope, or create a new one.
+ */
+export async function getOrCreateActiveSession(storage, tenantId, scope, scopeId) {
+    // Fetch a few recent sessions — the active one (if any) is likely the most recent,
+    // but we check a small batch in case the latest was already ended.
+    const sessions = await storage.getSessionsByScope(tenantId, scope, scopeId, { limit: 5 });
+    const active = sessions.data.find(s => !s.endedAt);
+    if (active)
+        return active;
+    return startSession(storage, tenantId, scope, scopeId);
+}
+export async function startSession(storage, tenantId, scope, scopeId, metadata) {
+    const id = crypto.randomUUID();
+    return storage.createSession({
+        id,
+        tenantId,
+        scope,
+        scopeId,
+        metadata: metadata ?? {},
+    });
+}
+export async function endSession(storage, llm, tenantId, sessionId) {
+    // 1. Get session
+    const session = await storage.getSession(tenantId, sessionId);
+    if (!session)
+        throw new Error(`Session ${sessionId} not found`);
+    if (session.endedAt)
+        throw new Error(`Session ${sessionId} already ended`);
+    // 2. Get facts created during this session
+    const facts = await storage.getFactsByScope(tenantId, session.scope, session.scopeId, { limit: 100 });
+    const sessionFacts = facts.data.filter(f => f.sessionId === sessionId);
+    // 3. Generate summary if there are facts
+    let summary;
+    let topics;
+    if (sessionFacts.length > 0) {
+        const factContents = sessionFacts.map(f => f.content).join('\n');
+        const response = await llm.complete([
+            {
+                role: 'system',
+                content: 'Summarize the following facts from a conversation session in 2-3 sentences. Also extract the main topics (as a JSON array of strings). Return JSON: {"summary": "...", "topics": ["..."]}',
+            },
+            {
+                role: 'user',
+                content: factContents,
+            },
+        ], { temperature: 0, responseFormat: 'json' });
+        try {
+            const parsed = JSON.parse(response.content);
+            summary = typeof parsed.summary === 'string' ? parsed.summary : undefined;
+            topics = Array.isArray(parsed.topics)
+                ? parsed.topics.filter((t) => typeof t === 'string')
+                : undefined;
+        }
+        catch {
+            // If JSON parse fails, use raw content as summary
+            summary = response.content;
+        }
+    }
+    // 4. End the session
+    return storage.endSession(tenantId, sessionId, summary, topics);
+}
+//# sourceMappingURL=manager.js.map

package/src/sessions/manager.js.map

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