npm - @xopcai/xopc - Versions diffs - 0.0.140 → 0.0.141 - Mend

@xopcai/xopc 0.0.140 → 0.0.141

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

package/dist/src/gateway/hono/routes/memory.js CHANGED Viewed

@@ -155,9 +155,10 @@ function registerMemoryRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.get("/api/memory/records", (c) => {
+		const agentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
 		const records = listMemoryRecords({
 			providerId: c.req.query("providerId") || void 0,
-			agentId: c.req.query("agentId") || void 0,
+			agentId,
 			workspaceId: c.req.query("workspaceId") || void 0,
 			projectId: c.req.query("projectId") || void 0,
 			kind: parseKind(c.req.query("kind")),
@@ -171,10 +172,11 @@ function registerMemoryRoutes(authenticated, deps) {
 		const body = await c.req.json().catch(() => ({}));
 		const query = typeof body.query === "string" ? body.query.trim() : "";
 		if (!query) return c.json({ error: "Missing required field: query" }, 400);
+		const agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim() : resolveDefaultAgentId(deps.service.currentConfig);
 		const records = searchMemoryRecords({
 			query,
 			providerId: typeof body.providerId === "string" ? body.providerId : void 0,
-			agentId: typeof body.agentId === "string" ? body.agentId : void 0,
+			agentId,
 			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : void 0,
 			projectId: typeof body.projectId === "string" ? body.projectId : void 0,
 			kinds: Array.isArray(body.kinds) ? body.kinds.map(parseKind).filter((v) => Boolean(v)) : void 0,
@@ -188,7 +190,7 @@ function registerMemoryRoutes(authenticated, deps) {
 		const body = await c.req.json().catch(() => ({}));
 		const kind = parseKind(body.kind);
 		const content = typeof body.content === "string" ? body.content.trim() : "";
-		const agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim() : "main";
+		const agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim() : resolveDefaultAgentId(deps.service.currentConfig);
 		if (!kind || !content) return c.json({ error: "Missing required fields: kind, content" }, 400);
 		const record = upsertMemoryRecord({
 			id: typeof body.id === "string" && body.id.trim() ? body.id.trim() : void 0,
@@ -222,6 +224,8 @@ function registerMemoryRoutes(authenticated, deps) {
 	authenticated.patch("/api/memory/records/:id", async (c) => {
 		const existing = getMemoryRecord(c.req.param("id"));
 		if (!existing) return c.json({ error: "Memory record not found" }, 404);
+		const selectedAgentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
+		if (existing.scope.agentId !== selectedAgentId) return c.json({ error: "Memory record not found for selected agent" }, 404);
 		const body = await c.req.json().catch(() => ({}));
 		const record = upsertMemoryRecord({
 			id: existing.id,
@@ -253,14 +257,18 @@ function registerMemoryRoutes(authenticated, deps) {
 		return c.json({ record });
 	});
 	authenticated.delete("/api/memory/records/:id", (c) => {
+		const existing = getMemoryRecord(c.req.param("id"));
+		const selectedAgentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
+		if (!existing || existing.scope.agentId !== selectedAgentId) return c.json({ error: "Memory record not found for selected agent" }, 404);
 		if (!deleteMemoryRecord(c.req.param("id"))) return c.json({ error: "Memory record not found" }, 404);
 		return c.json({ ok: true });
 	});
 	authenticated.get("/api/memory/signals", (c) => {
+		const agentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
 		const signals = listMemorySignals({
 			recordId: c.req.query("recordId") || void 0,
 			providerId: c.req.query("providerId") || void 0,
-			agentId: c.req.query("agentId") || void 0,
+			agentId,
 			workspaceId: c.req.query("workspaceId") || void 0,
 			limit: parseLimit(c.req.query("limit"))
 		});
@@ -284,8 +292,10 @@ function registerMemoryRoutes(authenticated, deps) {
 		return c.json({ syncRuns });
 	});
 	authenticated.get("/api/memory/traces", (c) => {
+		const agentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
 		const traces = listMemoryTraceEvents({
 			providerId: c.req.query("providerId") || void 0,
+			agentId,
 			sessionKey: c.req.query("sessionKey") || void 0,
 			phase: c.req.query("phase") || void 0,
 			limit: parseLimit(c.req.query("limit"))
@@ -310,9 +320,11 @@ function registerMemoryRoutes(authenticated, deps) {
 		return c.json({ trace });
 	});
 	authenticated.get("/api/memory/feedback-summary", (c) => {
+		const agentId = c.req.query("agentId") || resolveDefaultAgentId(deps.service.currentConfig);
 		const summaries = summarizeMemoryRecallFeedback({
 			recordId: c.req.query("recordId") || void 0,
 			providerId: c.req.query("providerId") || void 0,
+			agentId,
 			sessionKey: c.req.query("sessionKey") || void 0,
 			limit: parseFeedbackSummaryLimit(c.req.query("limit"))
 		});

package/dist/src/gateway/hono/routes/memory.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"memory.js","names":[],"sources":["../../../../../src/gateway/hono/routes/memory.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { BuiltinMemoryStore } from '../../../agent/memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from '../../../agent/memory/create-memory-manager.js';\nimport { resolveBuiltinMemoryStoreConfig } from '../../../agent/memory/memory-config.js';\nimport { discoverMemoryPlugins } from '../../../agent/memory/plugin-discovery.js';\nimport { resolveAdaptiveUnderstandingCadence } from '../../../agent/memory/understanding/quality.js';\nimport type {\n MemoryDisclosurePolicy,\n MemoryDurability,\n MemoryExplicitness,\n MemoryKind,\n MemorySensitivity,\n MemoryStatus,\n} from '../../../agent/memory/types.js';\nimport { MemoryPolicySchema } from '../../../agent-manifest/schema.js';\nimport { resolveDefaultAgentId } from '../../../agent/agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport type { Config } from '../../../config/schema.js';\nimport type { KnowledgeSynthesisStatus } from '../../../knowledge/types.js';\nimport { prepareUpdateAgent } from '../../agents-admin.js';\nimport {\n appendMemorySignal,\n appendMemoryTraceEvent,\n deleteMemoryRecord,\n findLatestMemoryInjectTrace,\n getMemoryRecord,\n listKnowledgeSourceItems,\n listKnowledgeSyncRuns,\n listMemoryRecords,\n listMemorySignals,\n listMemoryTraceEvents,\n searchMemoryRecords,\n setMemoryTraceFeedback,\n setLatestMemoryInjectFeedback,\n summarizeMemoryRecallFeedback,\n summarizeUserUnderstandingQuality,\n upsertMemoryRecord,\n} from '../../../storage/sqlite/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst MEMORY_KINDS = new Set<MemoryKind>([\n 'user_profile',\n 'preference',\n 'boundary',\n 'relationship',\n 'project_context',\n 'commitment',\n 'routine',\n 'personal_logistics',\n 'open_question',\n 'milestone',\n 'current_state',\n 'agent_note',\n 'workspace_fact',\n 'daily_note',\n 'session_summary',\n 'derived_insight',\n 'task_lesson',\n 'tool_preference',\n 'long_term_goal',\n]);\n\nconst MEMORY_EXPLICITNESS = new Set<MemoryExplicitness>(['explicit', 'observed', 'inferred']);\nconst MEMORY_DURABILITY = new Set<MemoryDurability>(['ephemeral', 'durable', 'recurring']);\nconst MEMORY_DISCLOSURE_POLICIES = new Set<MemoryDisclosurePolicy>([\n 'silent', 'referenceable', 'ask_before_reference',\n]);\n\nconst MEMORY_STATUSES = new Set<MemoryStatus>([\n 'candidate',\n 'active',\n 'needs_review',\n 'stale',\n 'archived',\n 'rejected',\n]);\n\nconst MEMORY_SENSITIVITIES = new Set<MemorySensitivity>([\n 'normal',\n 'personal',\n 'secret',\n 'regulated',\n]);\n\nconst MEMORY_TRACE_FEEDBACK_OUTCOMES = new Set([\n 'helpful',\n 'not_helpful',\n 'mixed',\n 'irrelevant',\n]);\n\nconst KNOWLEDGE_SYNTHESIS_STATUSES = new Set<KnowledgeSynthesisStatus>([\n 'pending', 'processing', 'completed', 'failed', 'ignored',\n]);\n\nfunction parseLimit(raw: string \| undefined, fallback = 100): number {\n const parsed = raw ? Number.parseInt(raw, 10) : fallback;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;\n}\n\nfunction parseFeedbackSummaryLimit(raw: string \| undefined): number {\n const parsed = raw ? Number.parseInt(raw, 10) : 1000;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(5000, parsed)) : 1000;\n}\n\nfunction parseWindowDays(raw: string \| undefined): number {\n const parsed = raw ? Number.parseInt(raw, 10) : 30;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(365, parsed)) : 30;\n}\n\nfunction parseKind(raw: unknown): MemoryKind \| undefined {\n return typeof raw === 'string' && MEMORY_KINDS.has(raw as MemoryKind)\n ? (raw as MemoryKind)\n : undefined;\n}\n\nfunction parseStatus(raw: unknown): MemoryStatus \| undefined {\n return typeof raw === 'string' && MEMORY_STATUSES.has(raw as MemoryStatus)\n ? (raw as MemoryStatus)\n : undefined;\n}\n\nfunction parseSensitivity(raw: unknown): MemorySensitivity \| undefined {\n return typeof raw === 'string' && MEMORY_SENSITIVITIES.has(raw as MemorySensitivity)\n ? (raw as MemorySensitivity)\n : undefined;\n}\n\nfunction parseEnum<T extends string>(raw: unknown, allowed: Set<T>): T \| undefined {\n return typeof raw === 'string' && allowed.has(raw as T) ? raw as T : undefined;\n}\n\nexport function registerMemoryRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n authenticated.get('/api/memory/providers', async (c) => {\n const cfg = deps.service.currentConfig as Config;\n const plugins = await discoverMemoryPlugins(cfg);\n return c.json({\n providers: [\n {\n id: 'local',\n displayName: 'Local Knowledge Store',\n available: true,\n configured: true,\n capabilities: {\n search: true,\n read: true,\n write: true,\n update: true,\n delete: true,\n keywordSearch: true,\n semanticSearch: false,\n hybridSearch: false,\n citations: true,\n sync: false,\n local: true,\n },\n },\n ...plugins.map((plugin) => ({\n id: plugin.manifest?.id ?? plugin.name,\n displayName: plugin.manifest?.displayName ?? plugin.name,\n available: plugin.available,\n configured: false,\n capabilities: plugin.manifest?.capabilities ?? {},\n })),\n ],\n });\n });\n\n authenticated.get('/api/memory/config', (c) => {\n const cfg = deps.service.currentConfig as Config;\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(cfg);\n const manifest = resolveEffectiveAgentManifestForAgent(cfg, agentId);\n return c.json({ agentId: manifest.id, memory: manifest.memory });\n });\n\n authenticated.patch('/api/memory/config', deps.strictRateLimitMiddleware, async (c) => {\n const cfg = deps.service.currentConfig as Config;\n const body = await c.req.json().catch(() => ({}));\n const agentId = typeof body.agentId === 'string' && body.agentId.trim()\n ? body.agentId.trim()\n : resolveDefaultAgentId(cfg);\n const parsed = MemoryPolicySchema.safeParse(body.memory);\n if (!parsed.success) {\n return c.json({ error: `memory ${parsed.error.issues[0]?.message ?? 'is invalid'}` }, 400);\n }\n const prep = prepareUpdateAgent(cfg, agentId, { memory: parsed.data });\n if (prep.ok === false) {\n return c.json({ error: prep.error }, prep.status ?? 400);\n }\n const save = await deps.service.saveConfig(prep.data.nextConfig);\n if (!save.saved) return c.json({ error: save.error ?? 'save failed' }, 500);\n const manifest = resolveEffectiveAgentManifestForAgent(deps.service.currentConfig as Config, agentId);\n return c.json({ agentId: manifest.id, memory: manifest.memory });\n });\n\n authenticated.get('/api/memory/records', (c) => {\n const records = listMemoryRecords({\n providerId: c.req.query('providerId') \|\| undefined,\n agentId: c.req.query('agentId') \|\| undefined,\n workspaceId: c.req.query('workspaceId') \|\| undefined,\n projectId: c.req.query('projectId') \|\| undefined,\n kind: parseKind(c.req.query('kind')),\n status: parseStatus(c.req.query('status')),\n limit: parseLimit(c.req.query('limit')),\n offset: c.req.query('offset') ? Number.parseInt(c.req.query('offset')!, 10) : 0,\n });\n return c.json({ records });\n });\n\n authenticated.post('/api/memory/search', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const query = typeof body.query === 'string' ? body.query.trim() : '';\n if (!query) {\n return c.json({ error: 'Missing required field: query' }, 400);\n }\n const records = searchMemoryRecords({\n query,\n providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n agentId: typeof body.agentId === 'string' ? body.agentId : undefined,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n projectId: typeof body.projectId === 'string' ? body.projectId : undefined,\n kinds: Array.isArray(body.kinds)\n ? body.kinds.map(parseKind).filter((v): v is MemoryKind => Boolean(v))\n : undefined,\n statuses: Array.isArray(body.statuses)\n ? body.statuses.map(parseStatus).filter((v): v is MemoryStatus => Boolean(v))\n : undefined,\n maxResults: typeof body.maxResults === 'number' ? body.maxResults : undefined,\n minScore: typeof body.minScore === 'number' ? body.minScore : undefined,\n });\n return c.json({ results: records });\n });\n\n authenticated.post('/api/memory/records', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const kind = parseKind(body.kind);\n const content = typeof body.content === 'string' ? body.content.trim() : '';\n const agentId = typeof body.agentId === 'string' && body.agentId.trim() ? body.agentId.trim() : 'main';\n if (!kind \|\| !content) {\n return c.json({ error: 'Missing required fields: kind, content' }, 400);\n }\n const record = upsertMemoryRecord({\n id: typeof body.id === 'string' && body.id.trim() ? body.id.trim() : undefined,\n providerId: typeof body.providerId === 'string' && body.providerId.trim() ? body.providerId.trim() : 'local',\n kind,\n agentId,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : deps.service.currentWorkspacePath,\n sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n projectId: typeof body.projectId === 'string' ? body.projectId : undefined,\n content,\n source: body.source && typeof body.source === 'object' ? body.source : undefined,\n confidence: typeof body.confidence === 'number' ? body.confidence : undefined,\n tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : undefined,\n status: parseStatus(body.status),\n sensitivity: parseSensitivity(body.sensitivity),\n canonicalKey: typeof body.canonicalKey === 'string' ? body.canonicalKey : undefined,\n explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS),\n durability: parseEnum(body.durability, MEMORY_DURABILITY),\n importance: typeof body.importance === 'number' ? body.importance : undefined,\n disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES),\n evidence: Array.isArray(body.evidence)\n ? body.evidence.filter((item: unknown): item is NonNullable<Parameters<typeof upsertMemoryRecord>[0]['evidence']>[number] =>\n Boolean(item) && typeof item === 'object',\n )\n : undefined,\n reviewAfter: typeof body.reviewAfter === 'string' ? body.reviewAfter : undefined,\n expiresAt: typeof body.expiresAt === 'string' ? body.expiresAt : undefined,\n validFrom: typeof body.validFrom === 'string' ? body.validFrom : undefined,\n validTo: typeof body.validTo === 'string' ? body.validTo : undefined,\n supersedesRecordId: typeof body.supersedesRecordId === 'string' ? body.supersedesRecordId : undefined,\n conflictGroupId: typeof body.conflictGroupId === 'string' ? body.conflictGroupId : undefined,\n });\n return c.json({ record }, 201);\n });\n\n authenticated.patch('/api/memory/records/:id', async (c) => {\n const existing = getMemoryRecord(c.req.param('id'));\n if (!existing) return c.json({ error: 'Memory record not found' }, 404);\n const body = await c.req.json().catch(() => ({}));\n const record = upsertMemoryRecord({\n id: existing.id,\n providerId: existing.source.provider ?? 'local',\n kind: parseKind(body.kind) ?? existing.kind,\n agentId: existing.scope.agentId,\n workspaceId: existing.scope.workspaceId,\n sessionKey: existing.scope.sessionKey,\n projectId: typeof body.projectId === 'string' ? body.projectId : existing.scope.projectId,\n content: typeof body.content === 'string' ? body.content : existing.content,\n source: body.source && typeof body.source === 'object' ? body.source : existing.source,\n confidence: typeof body.confidence === 'number' ? body.confidence : existing.confidence,\n tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : existing.tags,\n status: parseStatus(body.status) ?? existing.status,\n sensitivity: parseSensitivity(body.sensitivity) ?? existing.sensitivity,\n canonicalKey: typeof body.canonicalKey === 'string' ? body.canonicalKey : existing.canonicalKey,\n explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS) ?? existing.explicitness,\n durability: parseEnum(body.durability, MEMORY_DURABILITY) ?? existing.durability,\n importance: typeof body.importance === 'number' ? body.importance : existing.importance,\n disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES) ?? existing.disclosurePolicy,\n evidence: Array.isArray(body.evidence)\n ? body.evidence.filter((item: unknown): item is NonNullable<Parameters<typeof upsertMemoryRecord>[0]['evidence']>[number] =>\n Boolean(item) && typeof item === 'object',\n )\n : existing.evidence,\n reviewAfter: typeof body.reviewAfter === 'string' ? body.reviewAfter : existing.reviewAfter,\n expiresAt: typeof body.expiresAt === 'string' ? body.expiresAt : existing.expiresAt,\n validFrom: typeof body.validFrom === 'string' ? body.validFrom : existing.validFrom,\n validTo: typeof body.validTo === 'string' ? body.validTo : existing.validTo,\n supersedesRecordId: typeof body.supersedesRecordId === 'string' ? body.supersedesRecordId : existing.supersedesRecordId,\n conflictGroupId: typeof body.conflictGroupId === 'string' ? body.conflictGroupId : existing.conflictGroupId,\n });\n return c.json({ record });\n });\n\n authenticated.delete('/api/memory/records/:id', (c) => {\n const deleted = deleteMemoryRecord(c.req.param('id'));\n if (!deleted) return c.json({ error: 'Memory record not found' }, 404);\n return c.json({ ok: true });\n });\n\n authenticated.get('/api/memory/signals', (c) => {\n const signals = listMemorySignals({\n recordId: c.req.query('recordId') \|\| undefined,\n providerId: c.req.query('providerId') \|\| undefined,\n agentId: c.req.query('agentId') \|\| undefined,\n workspaceId: c.req.query('workspaceId') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ signals });\n });\n\n authenticated.get('/api/knowledge/source-items', (c) => {\n const sourceItems = listKnowledgeSourceItems({\n sourceInstanceId: c.req.query('sourceInstanceId') \|\| undefined,\n synthesisStatus: parseEnum(c.req.query('synthesisStatus'), KNOWLEDGE_SYNTHESIS_STATUSES),\n includeDeleted: c.req.query('includeDeleted') === 'true',\n limit: parseLimit(c.req.query('limit')),\n offset: c.req.query('offset') ? Number.parseInt(c.req.query('offset')!, 10) : 0,\n });\n return c.json({ sourceItems });\n });\n\n authenticated.get('/api/knowledge/sync-runs', (c) => {\n const syncRuns = listKnowledgeSyncRuns({\n sourceInstanceId: c.req.query('sourceInstanceId') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ syncRuns });\n });\n\n authenticated.get('/api/memory/traces', (c) => {\n const traces = listMemoryTraceEvents({\n providerId: c.req.query('providerId') \|\| undefined,\n sessionKey: c.req.query('sessionKey') \|\| undefined,\n phase: c.req.query('phase') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ traces });\n });\n\n authenticated.patch('/api/memory/traces/:traceId/feedback', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const outcome = typeof body.outcome === 'string' && MEMORY_TRACE_FEEDBACK_OUTCOMES.has(body.outcome)\n ? body.outcome\n : undefined;\n if (!outcome) {\n return c.json({ error: 'Missing or invalid required field: outcome' }, 400);\n }\n const source = body.source === 'user' \|\| body.source === 'evaluator' \|\| body.source === 'system'\n ? body.source\n : undefined;\n const trace = setMemoryTraceFeedback({\n traceId: c.req.param('traceId'),\n feedback: {\n outcome,\n ...(typeof body.score === 'number' ? { score: body.score } : {}),\n ...(typeof body.reason === 'string' ? { reason: body.reason } : {}),\n ...(source ? { source } : {}),\n },\n });\n if (!trace) return c.json({ error: 'Memory trace not found' }, 404);\n return c.json({ trace });\n });\n\n authenticated.get('/api/memory/feedback-summary', (c) => {\n const summaries = summarizeMemoryRecallFeedback({\n recordId: c.req.query('recordId') \|\| undefined,\n providerId: c.req.query('providerId') \|\| undefined,\n sessionKey: c.req.query('sessionKey') \|\| undefined,\n limit: parseFeedbackSummaryLimit(c.req.query('limit')),\n });\n return c.json({ summaries });\n });\n\n authenticated.get('/api/memory/understanding/quality', (c) => {\n const cfg = deps.service.currentConfig as Config;\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(cfg);\n const manifest = resolveEffectiveAgentManifestForAgent(cfg, agentId);\n const metrics = summarizeUserUnderstandingQuality({\n agentId: manifest.id,\n windowDays: parseWindowDays(c.req.query('windowDays')),\n });\n const baseIntervalTurns = manifest.memory.understanding?.reviewIntervalTurns ?? 10;\n const cadence = resolveAdaptiveUnderstandingCadence(\n baseIntervalTurns,\n metrics,\n manifest.memory.understanding?.adaptiveCadence ?? true,\n );\n return c.json({ metrics, cadence });\n });\n\n authenticated.patch(\n '/api/memory/understanding/response-feedback',\n deps.strictRateLimitMiddleware,\n async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const sessionKey = typeof body.sessionKey === 'string' ? body.sessionKey.trim() : '';\n const assistantTimestamp = typeof body.assistantTimestamp === 'number'\n ? body.assistantTimestamp\n : Number.NaN;\n const outcome = body.outcome === 'helpful' \|\| body.outcome === 'not_helpful'\n ? body.outcome\n : undefined;\n if (!sessionKey \|\| !Number.isFinite(assistantTimestamp) \|\| assistantTimestamp <= 0 \|\| !outcome) {\n return c.json({ error: 'sessionKey, assistantTimestamp, and a valid outcome are required' }, 400);\n }\n const trace = setLatestMemoryInjectFeedback({\n sessionKey,\n beforeMs: assistantTimestamp,\n feedback: {\n outcome,\n source: 'user',\n reason: 'assistant_response_feedback',\n },\n });\n return c.json({\n matched: Boolean(trace),\n attributedRecordCount: trace?.selectedRecordIds.length ?? 0,\n feedback: trace?.feedback ?? null,\n remediation: trace?.remediation ?? null,\n });\n },\n );\n\n authenticated.get('/api/memory/understanding/response-feedback', (c) => {\n const sessionKey = c.req.query('sessionKey')?.trim() ?? '';\n const assistantTimestamp = Number(c.req.query('assistantTimestamp'));\n if (!sessionKey \|\| !Number.isFinite(assistantTimestamp) \|\| assistantTimestamp <= 0) {\n return c.json({ error: 'sessionKey and assistantTimestamp are required' }, 400);\n }\n const trace = findLatestMemoryInjectTrace({\n sessionKey,\n beforeMs: assistantTimestamp,\n });\n return c.json({\n matched: Boolean(trace),\n attributedRecordCount: trace?.selectedRecordIds.length ?? 0,\n feedback: trace?.feedback ?? null,\n });\n });\n\n authenticated.post('/api/memory/signals', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const source = typeof body.source === 'string' ? body.source : '';\n if (!source) return c.json({ error: 'Missing required field: source' }, 400);\n const signalId = appendMemorySignal({\n providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n agentId: typeof body.agentId === 'string' ? body.agentId : undefined,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n signal: {\n source: source as never,\n recordId: typeof body.recordId === 'string' ? body.recordId : undefined,\n score: typeof body.score === 'number' ? body.score : undefined,\n content: typeof body.content === 'string' ? body.content : undefined,\n metadata: body.metadata && typeof body.metadata === 'object' ? body.metadata : undefined,\n },\n });\n return c.json({ signalId }, 201);\n });\n\n authenticated.post('/api/memory/providers/:id/test', deps.strictRateLimitMiddleware, async (c) => {\n const providerId = c.req.param('id');\n const cfg = deps.service.currentConfig as Config;\n const workspace = deps.service.currentWorkspacePath;\n const store = new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(workspace, cfg));\n const manager = createMemoryManagerFromConfig(workspace, store, cfg);\n await manager.initializeAll(`memory-provider-test-${Date.now()}`, { workspace, agentId: resolveDefaultAgentId(cfg) });\n const provider = manager.providersList.find((p) => p.id === providerId);\n if (!provider) return c.json({ providerId, available: false, checks: [{ name: 'load', ok: false, message: 'Provider not loaded' }] }, 404);\n\n const token = `xopc-memory-smoke-${Date.now()}`;\n const checks: Array<{ name: string; ok: boolean; message?: string; resultCount?: number }> = [\n { name: 'load', ok: true },\n { name: 'available', ok: provider.isAvailable() },\n ];\n const started = Date.now();\n try {\n const write = await manager.write({\n kind: 'workspace_fact',\n content: `Smoke test record for ${providerId}: ${token}`,\n scope: { agentId: resolveDefaultAgentId(cfg) },\n tags: ['xopc-smoke-test'],\n });\n checks.push({ name: 'write', ok: write.success, message: write.error ?? write.message });\n const results = await manager.search({ query: token, scope: { agentId: resolveDefaultAgentId(cfg) }, maxResults: 10 });\n const ownResults = results.filter((result) => result.citation.providerId === providerId);\n checks.push({ name: 'search', ok: ownResults.length > 0, resultCount: ownResults.length });\n const recordId = ownResults[0]?.record.id ?? write.record?.id;\n if (recordId) {\n const read = await manager.read({ id: recordId, scope: { agentId: resolveDefaultAgentId(cfg) } });\n checks.push({ name: 'read', ok: Boolean(read), message: read ? undefined : 'Record was not readable' });\n } else {\n checks.push({ name: 'read', ok: false, message: 'No record id available' });\n }\n manager.recordSignal({ source: 'search_recall', content: `Smoke signal for ${providerId}: ${token}` });\n checks.push({ name: 'sync', ok: true });\n } catch (err) {\n checks.push({ name: 'error', ok: false, message: err instanceof Error ? err.message : String(err) });\n } finally {\n appendMemoryTraceEvent({\n phase: 'test',\n providerId,\n request: { token },\n resultCount: checks.filter((check) => check.ok).length,\n error: checks.some((check) => !check.ok) ? 'one or more checks failed' : undefined,\n durationMs: Date.now() - started,\n });\n await manager.shutdownAll();\n }\n return c.json({ providerId, available: provider.isAvailable(), checks });\n });\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"memory.js","names":[],"sources":["../../../../../src/gateway/hono/routes/memory.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { BuiltinMemoryStore } from '../../../agent/memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from '../../../agent/memory/create-memory-manager.js';\nimport { resolveBuiltinMemoryStoreConfig } from '../../../agent/memory/memory-config.js';\nimport { discoverMemoryPlugins } from '../../../agent/memory/plugin-discovery.js';\nimport { resolveAdaptiveUnderstandingCadence } from '../../../agent/memory/understanding/quality.js';\nimport type {\n MemoryDisclosurePolicy,\n MemoryDurability,\n MemoryExplicitness,\n MemoryKind,\n MemorySensitivity,\n MemoryStatus,\n} from '../../../agent/memory/types.js';\nimport { MemoryPolicySchema } from '../../../agent-manifest/schema.js';\nimport { resolveDefaultAgentId } from '../../../agent/agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport type { Config } from '../../../config/schema.js';\nimport type { KnowledgeSynthesisStatus } from '../../../knowledge/types.js';\nimport { prepareUpdateAgent } from '../../agents-admin.js';\nimport {\n appendMemorySignal,\n appendMemoryTraceEvent,\n deleteMemoryRecord,\n findLatestMemoryInjectTrace,\n getMemoryRecord,\n listKnowledgeSourceItems,\n listKnowledgeSyncRuns,\n listMemoryRecords,\n listMemorySignals,\n listMemoryTraceEvents,\n searchMemoryRecords,\n setMemoryTraceFeedback,\n setLatestMemoryInjectFeedback,\n summarizeMemoryRecallFeedback,\n summarizeUserUnderstandingQuality,\n upsertMemoryRecord,\n} from '../../../storage/sqlite/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst MEMORY_KINDS = new Set<MemoryKind>([\n 'user_profile',\n 'preference',\n 'boundary',\n 'relationship',\n 'project_context',\n 'commitment',\n 'routine',\n 'personal_logistics',\n 'open_question',\n 'milestone',\n 'current_state',\n 'agent_note',\n 'workspace_fact',\n 'daily_note',\n 'session_summary',\n 'derived_insight',\n 'task_lesson',\n 'tool_preference',\n 'long_term_goal',\n]);\n\nconst MEMORY_EXPLICITNESS = new Set<MemoryExplicitness>(['explicit', 'observed', 'inferred']);\nconst MEMORY_DURABILITY = new Set<MemoryDurability>(['ephemeral', 'durable', 'recurring']);\nconst MEMORY_DISCLOSURE_POLICIES = new Set<MemoryDisclosurePolicy>([\n 'silent', 'referenceable', 'ask_before_reference',\n]);\n\nconst MEMORY_STATUSES = new Set<MemoryStatus>([\n 'candidate',\n 'active',\n 'needs_review',\n 'stale',\n 'archived',\n 'rejected',\n]);\n\nconst MEMORY_SENSITIVITIES = new Set<MemorySensitivity>([\n 'normal',\n 'personal',\n 'secret',\n 'regulated',\n]);\n\nconst MEMORY_TRACE_FEEDBACK_OUTCOMES = new Set([\n 'helpful',\n 'not_helpful',\n 'mixed',\n 'irrelevant',\n]);\n\nconst KNOWLEDGE_SYNTHESIS_STATUSES = new Set<KnowledgeSynthesisStatus>([\n 'pending', 'processing', 'completed', 'failed', 'ignored',\n]);\n\nfunction parseLimit(raw: string \| undefined, fallback = 100): number {\n const parsed = raw ? Number.parseInt(raw, 10) : fallback;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;\n}\n\nfunction parseFeedbackSummaryLimit(raw: string \| undefined): number {\n const parsed = raw ? Number.parseInt(raw, 10) : 1000;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(5000, parsed)) : 1000;\n}\n\nfunction parseWindowDays(raw: string \| undefined): number {\n const parsed = raw ? Number.parseInt(raw, 10) : 30;\n return Number.isFinite(parsed) ? Math.max(1, Math.min(365, parsed)) : 30;\n}\n\nfunction parseKind(raw: unknown): MemoryKind \| undefined {\n return typeof raw === 'string' && MEMORY_KINDS.has(raw as MemoryKind)\n ? (raw as MemoryKind)\n : undefined;\n}\n\nfunction parseStatus(raw: unknown): MemoryStatus \| undefined {\n return typeof raw === 'string' && MEMORY_STATUSES.has(raw as MemoryStatus)\n ? (raw as MemoryStatus)\n : undefined;\n}\n\nfunction parseSensitivity(raw: unknown): MemorySensitivity \| undefined {\n return typeof raw === 'string' && MEMORY_SENSITIVITIES.has(raw as MemorySensitivity)\n ? (raw as MemorySensitivity)\n : undefined;\n}\n\nfunction parseEnum<T extends string>(raw: unknown, allowed: Set<T>): T \| undefined {\n return typeof raw === 'string' && allowed.has(raw as T) ? raw as T : undefined;\n}\n\nexport function registerMemoryRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n authenticated.get('/api/memory/providers', async (c) => {\n const cfg = deps.service.currentConfig as Config;\n const plugins = await discoverMemoryPlugins(cfg);\n return c.json({\n providers: [\n {\n id: 'local',\n displayName: 'Local Knowledge Store',\n available: true,\n configured: true,\n capabilities: {\n search: true,\n read: true,\n write: true,\n update: true,\n delete: true,\n keywordSearch: true,\n semanticSearch: false,\n hybridSearch: false,\n citations: true,\n sync: false,\n local: true,\n },\n },\n ...plugins.map((plugin) => ({\n id: plugin.manifest?.id ?? plugin.name,\n displayName: plugin.manifest?.displayName ?? plugin.name,\n available: plugin.available,\n configured: false,\n capabilities: plugin.manifest?.capabilities ?? {},\n })),\n ],\n });\n });\n\n authenticated.get('/api/memory/config', (c) => {\n const cfg = deps.service.currentConfig as Config;\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(cfg);\n const manifest = resolveEffectiveAgentManifestForAgent(cfg, agentId);\n return c.json({ agentId: manifest.id, memory: manifest.memory });\n });\n\n authenticated.patch('/api/memory/config', deps.strictRateLimitMiddleware, async (c) => {\n const cfg = deps.service.currentConfig as Config;\n const body = await c.req.json().catch(() => ({}));\n const agentId = typeof body.agentId === 'string' && body.agentId.trim()\n ? body.agentId.trim()\n : resolveDefaultAgentId(cfg);\n const parsed = MemoryPolicySchema.safeParse(body.memory);\n if (!parsed.success) {\n return c.json({ error: `memory ${parsed.error.issues[0]?.message ?? 'is invalid'}` }, 400);\n }\n const prep = prepareUpdateAgent(cfg, agentId, { memory: parsed.data });\n if (prep.ok === false) {\n return c.json({ error: prep.error }, prep.status ?? 400);\n }\n const save = await deps.service.saveConfig(prep.data.nextConfig);\n if (!save.saved) return c.json({ error: save.error ?? 'save failed' }, 500);\n const manifest = resolveEffectiveAgentManifestForAgent(deps.service.currentConfig as Config, agentId);\n return c.json({ agentId: manifest.id, memory: manifest.memory });\n });\n\n authenticated.get('/api/memory/records', (c) => {\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n const records = listMemoryRecords({\n providerId: c.req.query('providerId') \|\| undefined,\n agentId,\n workspaceId: c.req.query('workspaceId') \|\| undefined,\n projectId: c.req.query('projectId') \|\| undefined,\n kind: parseKind(c.req.query('kind')),\n status: parseStatus(c.req.query('status')),\n limit: parseLimit(c.req.query('limit')),\n offset: c.req.query('offset') ? Number.parseInt(c.req.query('offset')!, 10) : 0,\n });\n return c.json({ records });\n });\n\n authenticated.post('/api/memory/search', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const query = typeof body.query === 'string' ? body.query.trim() : '';\n if (!query) {\n return c.json({ error: 'Missing required field: query' }, 400);\n }\n const agentId = typeof body.agentId === 'string' && body.agentId.trim()\n ? body.agentId.trim()\n : resolveDefaultAgentId(deps.service.currentConfig as Config);\n const records = searchMemoryRecords({\n query,\n providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n agentId,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n projectId: typeof body.projectId === 'string' ? body.projectId : undefined,\n kinds: Array.isArray(body.kinds)\n ? body.kinds.map(parseKind).filter((v): v is MemoryKind => Boolean(v))\n : undefined,\n statuses: Array.isArray(body.statuses)\n ? body.statuses.map(parseStatus).filter((v): v is MemoryStatus => Boolean(v))\n : undefined,\n maxResults: typeof body.maxResults === 'number' ? body.maxResults : undefined,\n minScore: typeof body.minScore === 'number' ? body.minScore : undefined,\n });\n return c.json({ results: records });\n });\n\n authenticated.post('/api/memory/records', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const kind = parseKind(body.kind);\n const content = typeof body.content === 'string' ? body.content.trim() : '';\n const agentId = typeof body.agentId === 'string' && body.agentId.trim()\n ? body.agentId.trim()\n : resolveDefaultAgentId(deps.service.currentConfig as Config);\n if (!kind \|\| !content) {\n return c.json({ error: 'Missing required fields: kind, content' }, 400);\n }\n const record = upsertMemoryRecord({\n id: typeof body.id === 'string' && body.id.trim() ? body.id.trim() : undefined,\n providerId: typeof body.providerId === 'string' && body.providerId.trim() ? body.providerId.trim() : 'local',\n kind,\n agentId,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : deps.service.currentWorkspacePath,\n sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n projectId: typeof body.projectId === 'string' ? body.projectId : undefined,\n content,\n source: body.source && typeof body.source === 'object' ? body.source : undefined,\n confidence: typeof body.confidence === 'number' ? body.confidence : undefined,\n tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : undefined,\n status: parseStatus(body.status),\n sensitivity: parseSensitivity(body.sensitivity),\n canonicalKey: typeof body.canonicalKey === 'string' ? body.canonicalKey : undefined,\n explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS),\n durability: parseEnum(body.durability, MEMORY_DURABILITY),\n importance: typeof body.importance === 'number' ? body.importance : undefined,\n disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES),\n evidence: Array.isArray(body.evidence)\n ? body.evidence.filter((item: unknown): item is NonNullable<Parameters<typeof upsertMemoryRecord>[0]['evidence']>[number] =>\n Boolean(item) && typeof item === 'object',\n )\n : undefined,\n reviewAfter: typeof body.reviewAfter === 'string' ? body.reviewAfter : undefined,\n expiresAt: typeof body.expiresAt === 'string' ? body.expiresAt : undefined,\n validFrom: typeof body.validFrom === 'string' ? body.validFrom : undefined,\n validTo: typeof body.validTo === 'string' ? body.validTo : undefined,\n supersedesRecordId: typeof body.supersedesRecordId === 'string' ? body.supersedesRecordId : undefined,\n conflictGroupId: typeof body.conflictGroupId === 'string' ? body.conflictGroupId : undefined,\n });\n return c.json({ record }, 201);\n });\n\n authenticated.patch('/api/memory/records/:id', async (c) => {\n const existing = getMemoryRecord(c.req.param('id'));\n if (!existing) return c.json({ error: 'Memory record not found' }, 404);\n const selectedAgentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n if (existing.scope.agentId !== selectedAgentId) {\n return c.json({ error: 'Memory record not found for selected agent' }, 404);\n }\n const body = await c.req.json().catch(() => ({}));\n const record = upsertMemoryRecord({\n id: existing.id,\n providerId: existing.source.provider ?? 'local',\n kind: parseKind(body.kind) ?? existing.kind,\n agentId: existing.scope.agentId,\n workspaceId: existing.scope.workspaceId,\n sessionKey: existing.scope.sessionKey,\n projectId: typeof body.projectId === 'string' ? body.projectId : existing.scope.projectId,\n content: typeof body.content === 'string' ? body.content : existing.content,\n source: body.source && typeof body.source === 'object' ? body.source : existing.source,\n confidence: typeof body.confidence === 'number' ? body.confidence : existing.confidence,\n tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : existing.tags,\n status: parseStatus(body.status) ?? existing.status,\n sensitivity: parseSensitivity(body.sensitivity) ?? existing.sensitivity,\n canonicalKey: typeof body.canonicalKey === 'string' ? body.canonicalKey : existing.canonicalKey,\n explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS) ?? existing.explicitness,\n durability: parseEnum(body.durability, MEMORY_DURABILITY) ?? existing.durability,\n importance: typeof body.importance === 'number' ? body.importance : existing.importance,\n disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES) ?? existing.disclosurePolicy,\n evidence: Array.isArray(body.evidence)\n ? body.evidence.filter((item: unknown): item is NonNullable<Parameters<typeof upsertMemoryRecord>[0]['evidence']>[number] =>\n Boolean(item) && typeof item === 'object',\n )\n : existing.evidence,\n reviewAfter: typeof body.reviewAfter === 'string' ? body.reviewAfter : existing.reviewAfter,\n expiresAt: typeof body.expiresAt === 'string' ? body.expiresAt : existing.expiresAt,\n validFrom: typeof body.validFrom === 'string' ? body.validFrom : existing.validFrom,\n validTo: typeof body.validTo === 'string' ? body.validTo : existing.validTo,\n supersedesRecordId: typeof body.supersedesRecordId === 'string' ? body.supersedesRecordId : existing.supersedesRecordId,\n conflictGroupId: typeof body.conflictGroupId === 'string' ? body.conflictGroupId : existing.conflictGroupId,\n });\n return c.json({ record });\n });\n\n authenticated.delete('/api/memory/records/:id', (c) => {\n const existing = getMemoryRecord(c.req.param('id'));\n const selectedAgentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n if (!existing \|\| existing.scope.agentId !== selectedAgentId) {\n return c.json({ error: 'Memory record not found for selected agent' }, 404);\n }\n const deleted = deleteMemoryRecord(c.req.param('id'));\n if (!deleted) return c.json({ error: 'Memory record not found' }, 404);\n return c.json({ ok: true });\n });\n\n authenticated.get('/api/memory/signals', (c) => {\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n const signals = listMemorySignals({\n recordId: c.req.query('recordId') \|\| undefined,\n providerId: c.req.query('providerId') \|\| undefined,\n agentId,\n workspaceId: c.req.query('workspaceId') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ signals });\n });\n\n authenticated.get('/api/knowledge/source-items', (c) => {\n const sourceItems = listKnowledgeSourceItems({\n sourceInstanceId: c.req.query('sourceInstanceId') \|\| undefined,\n synthesisStatus: parseEnum(c.req.query('synthesisStatus'), KNOWLEDGE_SYNTHESIS_STATUSES),\n includeDeleted: c.req.query('includeDeleted') === 'true',\n limit: parseLimit(c.req.query('limit')),\n offset: c.req.query('offset') ? Number.parseInt(c.req.query('offset')!, 10) : 0,\n });\n return c.json({ sourceItems });\n });\n\n authenticated.get('/api/knowledge/sync-runs', (c) => {\n const syncRuns = listKnowledgeSyncRuns({\n sourceInstanceId: c.req.query('sourceInstanceId') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ syncRuns });\n });\n\n authenticated.get('/api/memory/traces', (c) => {\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n const traces = listMemoryTraceEvents({\n providerId: c.req.query('providerId') \|\| undefined,\n agentId,\n sessionKey: c.req.query('sessionKey') \|\| undefined,\n phase: c.req.query('phase') \|\| undefined,\n limit: parseLimit(c.req.query('limit')),\n });\n return c.json({ traces });\n });\n\n authenticated.patch('/api/memory/traces/:traceId/feedback', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const outcome = typeof body.outcome === 'string' && MEMORY_TRACE_FEEDBACK_OUTCOMES.has(body.outcome)\n ? body.outcome\n : undefined;\n if (!outcome) {\n return c.json({ error: 'Missing or invalid required field: outcome' }, 400);\n }\n const source = body.source === 'user' \|\| body.source === 'evaluator' \|\| body.source === 'system'\n ? body.source\n : undefined;\n const trace = setMemoryTraceFeedback({\n traceId: c.req.param('traceId'),\n feedback: {\n outcome,\n ...(typeof body.score === 'number' ? { score: body.score } : {}),\n ...(typeof body.reason === 'string' ? { reason: body.reason } : {}),\n ...(source ? { source } : {}),\n },\n });\n if (!trace) return c.json({ error: 'Memory trace not found' }, 404);\n return c.json({ trace });\n });\n\n authenticated.get('/api/memory/feedback-summary', (c) => {\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(deps.service.currentConfig as Config);\n const summaries = summarizeMemoryRecallFeedback({\n recordId: c.req.query('recordId') \|\| undefined,\n providerId: c.req.query('providerId') \|\| undefined,\n agentId,\n sessionKey: c.req.query('sessionKey') \|\| undefined,\n limit: parseFeedbackSummaryLimit(c.req.query('limit')),\n });\n return c.json({ summaries });\n });\n\n authenticated.get('/api/memory/understanding/quality', (c) => {\n const cfg = deps.service.currentConfig as Config;\n const agentId = c.req.query('agentId') \|\| resolveDefaultAgentId(cfg);\n const manifest = resolveEffectiveAgentManifestForAgent(cfg, agentId);\n const metrics = summarizeUserUnderstandingQuality({\n agentId: manifest.id,\n windowDays: parseWindowDays(c.req.query('windowDays')),\n });\n const baseIntervalTurns = manifest.memory.understanding?.reviewIntervalTurns ?? 10;\n const cadence = resolveAdaptiveUnderstandingCadence(\n baseIntervalTurns,\n metrics,\n manifest.memory.understanding?.adaptiveCadence ?? true,\n );\n return c.json({ metrics, cadence });\n });\n\n authenticated.patch(\n '/api/memory/understanding/response-feedback',\n deps.strictRateLimitMiddleware,\n async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const sessionKey = typeof body.sessionKey === 'string' ? body.sessionKey.trim() : '';\n const assistantTimestamp = typeof body.assistantTimestamp === 'number'\n ? body.assistantTimestamp\n : Number.NaN;\n const outcome = body.outcome === 'helpful' \|\| body.outcome === 'not_helpful'\n ? body.outcome\n : undefined;\n if (!sessionKey \|\| !Number.isFinite(assistantTimestamp) \|\| assistantTimestamp <= 0 \|\| !outcome) {\n return c.json({ error: 'sessionKey, assistantTimestamp, and a valid outcome are required' }, 400);\n }\n const trace = setLatestMemoryInjectFeedback({\n sessionKey,\n beforeMs: assistantTimestamp,\n feedback: {\n outcome,\n source: 'user',\n reason: 'assistant_response_feedback',\n },\n });\n return c.json({\n matched: Boolean(trace),\n attributedRecordCount: trace?.selectedRecordIds.length ?? 0,\n feedback: trace?.feedback ?? null,\n remediation: trace?.remediation ?? null,\n });\n },\n );\n\n authenticated.get('/api/memory/understanding/response-feedback', (c) => {\n const sessionKey = c.req.query('sessionKey')?.trim() ?? '';\n const assistantTimestamp = Number(c.req.query('assistantTimestamp'));\n if (!sessionKey \|\| !Number.isFinite(assistantTimestamp) \|\| assistantTimestamp <= 0) {\n return c.json({ error: 'sessionKey and assistantTimestamp are required' }, 400);\n }\n const trace = findLatestMemoryInjectTrace({\n sessionKey,\n beforeMs: assistantTimestamp,\n });\n return c.json({\n matched: Boolean(trace),\n attributedRecordCount: trace?.selectedRecordIds.length ?? 0,\n feedback: trace?.feedback ?? null,\n });\n });\n\n authenticated.post('/api/memory/signals', async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const source = typeof body.source === 'string' ? body.source : '';\n if (!source) return c.json({ error: 'Missing required field: source' }, 400);\n const signalId = appendMemorySignal({\n providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n agentId: typeof body.agentId === 'string' ? body.agentId : undefined,\n workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n signal: {\n source: source as never,\n recordId: typeof body.recordId === 'string' ? body.recordId : undefined,\n score: typeof body.score === 'number' ? body.score : undefined,\n content: typeof body.content === 'string' ? body.content : undefined,\n metadata: body.metadata && typeof body.metadata === 'object' ? body.metadata : undefined,\n },\n });\n return c.json({ signalId }, 201);\n });\n\n authenticated.post('/api/memory/providers/:id/test', deps.strictRateLimitMiddleware, async (c) => {\n const providerId = c.req.param('id');\n const cfg = deps.service.currentConfig as Config;\n const workspace = deps.service.currentWorkspacePath;\n const store = new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(workspace, cfg));\n const manager = createMemoryManagerFromConfig(workspace, store, cfg);\n await manager.initializeAll(`memory-provider-test-${Date.now()}`, { workspace, agentId: resolveDefaultAgentId(cfg) });\n const provider = manager.providersList.find((p) => p.id === providerId);\n if (!provider) return c.json({ providerId, available: false, checks: [{ name: 'load', ok: false, message: 'Provider not loaded' }] }, 404);\n\n const token = `xopc-memory-smoke-${Date.now()}`;\n const checks: Array<{ name: string; ok: boolean; message?: string; resultCount?: number }> = [\n { name: 'load', ok: true },\n { name: 'available', ok: provider.isAvailable() },\n ];\n const started = Date.now();\n try {\n const write = await manager.write({\n kind: 'workspace_fact',\n content: `Smoke test record for ${providerId}: ${token}`,\n scope: { agentId: resolveDefaultAgentId(cfg) },\n tags: ['xopc-smoke-test'],\n });\n checks.push({ name: 'write', ok: write.success, message: write.error ?? write.message });\n const results = await manager.search({ query: token, scope: { agentId: resolveDefaultAgentId(cfg) }, maxResults: 10 });\n const ownResults = results.filter((result) => result.citation.providerId === providerId);\n checks.push({ name: 'search', ok: ownResults.length > 0, resultCount: ownResults.length });\n const recordId = ownResults[0]?.record.id ?? write.record?.id;\n if (recordId) {\n const read = await manager.read({ id: recordId, scope: { agentId: resolveDefaultAgentId(cfg) } });\n checks.push({ name: 'read', ok: Boolean(read), message: read ? undefined : 'Record was not readable' });\n } else {\n checks.push({ name: 'read', ok: false, message: 'No record id available' });\n }\n manager.recordSignal({ source: 'search_recall', content: `Smoke signal for ${providerId}: ${token}` });\n checks.push({ name: 'sync', ok: true });\n } catch (err) {\n checks.push({ name: 'error', ok: false, message: err instanceof Error ? err.message : String(err) });\n } finally {\n appendMemoryTraceEvent({\n phase: 'test',\n providerId,\n request: { token },\n resultCount: checks.filter((check) => check.ok).length,\n error: checks.some((check) => !check.ok) ? 'one or more checks failed' : undefined,\n durationMs: Date.now() - started,\n });\n await manager.shutdownAll();\n }\n return c.json({ providerId, available: provider.isAvailable(), checks });\n });\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/fts.d.ts CHANGED Viewed

@@ -1,2 +1,8 @@
 /** Quote a user query for FTS5 phrase/prefix-safe matching. */
 export declare function escapeFts5Query(raw: string): string;
+/** Build a syntax-safe, recall-oriented query for natural-language memory search. */
+export declare function buildFts5SearchQuery(raw: string): string;
+/** Normalize FTS5 BM25 ranks, where a more-negative rank is a better match. */
+export declare function fts5RankToScore(rank: number, bestRank: number, worstRank: number): number;
+/** Bounded lexical fallback for reformulations unsupported by unicode61 tokenization. */
+export declare function memoryLexicalSimilarity(query: string, content: string): number;

package/dist/src/storage/sqlite/fts.js CHANGED Viewed

@@ -5,7 +5,76 @@ function escapeFts5Query(raw) {
 	if (!trimmed) return "";
 	return `"${trimmed.replace(/"/g, "\"\"")}"`;
 }
+const FTS_SEARCH_STOP_WORDS = new Set([
+	"a",
+	"an",
+	"and",
+	"are",
+	"can",
+	"did",
+	"do",
+	"does",
+	"for",
+	"how",
+	"i",
+	"in",
+	"is",
+	"it",
+	"me",
+	"my",
+	"of",
+	"on",
+	"or",
+	"the",
+	"to",
+	"was",
+	"what",
+	"when",
+	"where",
+	"which",
+	"who",
+	"why",
+	"with",
+	"you",
+	"your"
+]);
+/** Build a syntax-safe, recall-oriented query for natural-language memory search. */
+function buildFts5SearchQuery(raw) {
+	const terms = raw.normalize("NFKC").match(/[\p{L}\p{N}_]+/gu)?.map((term) => term.toLocaleLowerCase()).filter((term) => term.length > 1 && !FTS_SEARCH_STOP_WORDS.has(term));
+	if (!terms?.length) return escapeFts5Query(raw);
+	return [...new Set(terms)].slice(0, 12).map((term) => escapeFts5Query(term)).join(" OR ");
+}
+/** Normalize FTS5 BM25 ranks, where a more-negative rank is a better match. */
+function fts5RankToScore(rank, bestRank, worstRank) {
+	if (![
+		rank,
+		bestRank,
+		worstRank
+	].every(Number.isFinite)) return 0;
+	if (bestRank === worstRank) return .75;
+	const normalized = (worstRank - rank) / (worstRank - bestRank);
+	return .5 + .5 * Math.max(0, Math.min(1, normalized));
+}
+function lexicalFeatures(raw) {
+	const normalized = raw.normalize("NFKC").toLocaleLowerCase();
+	const features = /* @__PURE__ */ new Set();
+	for (const term of normalized.match(/[\p{L}\p{N}_]+/gu) ?? []) if (term.length > 1 && !FTS_SEARCH_STOP_WORDS.has(term)) features.add(`word:${term}`);
+	for (const sequence of normalized.match(/\p{Script=Han}+/gu) ?? []) {
+		const chars = [...sequence];
+		for (let index = 0; index < chars.length - 1; index += 1) features.add(`han:${chars[index]}${chars[index + 1]}`);
+	}
+	return features;
+}
+/** Bounded lexical fallback for reformulations unsupported by unicode61 tokenization. */
+function memoryLexicalSimilarity(query, content) {
+	const queryFeatures = lexicalFeatures(query);
+	const contentFeatures = lexicalFeatures(content);
+	if (queryFeatures.size === 0 || contentFeatures.size === 0) return 0;
+	let shared = 0;
+	for (const feature of queryFeatures) if (contentFeatures.has(feature)) shared += 1;
+	return 2 * shared / (queryFeatures.size + contentFeatures.size);
+}
 //#endregion
-export { escapeFts5Query };
+export { buildFts5SearchQuery, escapeFts5Query, fts5RankToScore, memoryLexicalSimilarity };
 //# sourceMappingURL=fts.js.map

package/dist/src/storage/sqlite/fts.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"fts.js","names":[],"sources":["../../../../src/storage/sqlite/fts.ts"],"sourcesContent":["/** Quote a user query for FTS5 phrase/prefix-safe matching. */\nexport function escapeFts5Query(raw: string): string {\n const trimmed = raw.trim();\n if (!trimmed) {\n return '';\n }\n return `\"${trimmed.replace(/\"/g, '\"\"')}\"`;\n}\n"],"mappings":";;AACA,SAAgB,gBAAgB,KAAqB;CACnD,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,IAAI,QAAQ,QAAQ,MAAM,OAAK,CAAC"}
1	+ {"version":3,"file":"fts.js","names":[],"sources":["../../../../src/storage/sqlite/fts.ts"],"sourcesContent":["/** Quote a user query for FTS5 phrase/prefix-safe matching. /\nexport function escapeFts5Query(raw: string): string {\n const trimmed = raw.trim();\n if (!trimmed) {\n return '';\n }\n return `\"${trimmed.replace(/\"/g, '\"\"')}\"`;\n}\n\nconst FTS_SEARCH_STOP_WORDS = new Set([\n 'a', 'an', 'and', 'are', 'can', 'did', 'do', 'does', 'for', 'how', 'i', 'in', 'is',\n 'it', 'me', 'my', 'of', 'on', 'or', 'the', 'to', 'was', 'what', 'when', 'where',\n 'which', 'who', 'why', 'with', 'you', 'your',\n]);\n\n/* Build a syntax-safe, recall-oriented query for natural-language memory search. /\nexport function buildFts5SearchQuery(raw: string): string {\n const terms = raw\n .normalize('NFKC')\n .match(/[\\p{L}\\p{N}_]+/gu)\n ?.map((term) => term.toLocaleLowerCase())\n .filter((term) => term.length > 1 && !FTS_SEARCH_STOP_WORDS.has(term));\n if (!terms?.length) return escapeFts5Query(raw);\n return [...new Set(terms)]\n .slice(0, 12)\n .map((term) => escapeFts5Query(term))\n .join(' OR ');\n}\n\n/* Normalize FTS5 BM25 ranks, where a more-negative rank is a better match. /\nexport function fts5RankToScore(rank: number, bestRank: number, worstRank: number): number {\n if (![rank, bestRank, worstRank].every(Number.isFinite)) return 0;\n if (bestRank === worstRank) return 0.75;\n const normalized = (worstRank - rank) / (worstRank - bestRank);\n return 0.5 + 0.5 Math.max(0, Math.min(1, normalized));\n}\n\nfunction lexicalFeatures(raw: string): Set<string> {\n const normalized = raw.normalize('NFKC').toLocaleLowerCase();\n const features = new Set<string>();\n for (const term of normalized.match(/[\\p{L}\\p{N}_]+/gu) ?? []) {\n if (term.length > 1 && !FTS_SEARCH_STOP_WORDS.has(term)) features.add(`word:${term}`);\n }\n for (const sequence of normalized.match(/\\p{Script=Han}+/gu) ?? []) {\n const chars = [...sequence];\n for (let index = 0; index < chars.length - 1; index += 1) {\n features.add(`han:${chars[index]}${chars[index + 1]}`);\n }\n }\n return features;\n}\n\n/** Bounded lexical fallback for reformulations unsupported by unicode61 tokenization. /\nexport function memoryLexicalSimilarity(query: string, content: string): number {\n const queryFeatures = lexicalFeatures(query);\n const contentFeatures = lexicalFeatures(content);\n if (queryFeatures.size === 0 \|\| contentFeatures.size === 0) return 0;\n let shared = 0;\n for (const feature of queryFeatures) {\n if (contentFeatures.has(feature)) shared += 1;\n }\n return (2 shared) / (queryFeatures.size + contentFeatures.size);\n}\n"],"mappings":";;AACA,SAAgB,gBAAgB,KAAqB;CACnD,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,IAAI,QAAQ,QAAQ,MAAM,OAAK,CAAC;;AAGzC,MAAM,wBAAwB,IAAI,IAAI;CACpC;CAAK;CAAM;CAAO;CAAO;CAAO;CAAO;CAAM;CAAQ;CAAO;CAAO;CAAK;CAAM;CAC9E;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAO;CAAM;CAAO;CAAQ;CAAQ;CACxE;CAAS;CAAO;CAAO;CAAQ;CAAO;CACvC,CAAC;;AAGF,SAAgB,qBAAqB,KAAqB;CACxD,MAAM,QAAQ,IACX,UAAU,OAAO,CACjB,MAAM,mBAAmB,EACxB,KAAK,SAAS,KAAK,mBAAmB,CAAC,CACxC,QAAQ,SAAS,KAAK,SAAS,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC;AACxE,KAAI,CAAC,OAAO,OAAQ,QAAO,gBAAgB,IAAI;AAC/C,QAAO,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CACvB,MAAM,GAAG,GAAG,CACZ,KAAK,SAAS,gBAAgB,KAAK,CAAC,CACpC,KAAK,OAAO;;;AAIjB,SAAgB,gBAAgB,MAAc,UAAkB,WAA2B;AACzF,KAAI,CAAC;EAAC;EAAM;EAAU;EAAU,CAAC,MAAM,OAAO,SAAS,CAAE,QAAO;AAChE,KAAI,aAAa,UAAW,QAAO;CACnC,MAAM,cAAc,YAAY,SAAS,YAAY;AACrD,QAAO,KAAM,KAAM,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,WAAW,CAAC;;AAGzD,SAAS,gBAAgB,KAA0B;CACjD,MAAM,aAAa,IAAI,UAAU,OAAO,CAAC,mBAAmB;CAC5D,MAAM,2BAAW,IAAI,KAAa;AAClC,MAAK,MAAM,QAAQ,WAAW,MAAM,mBAAmB,IAAI,EAAE,CAC3D,KAAI,KAAK,SAAS,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAE,UAAS,IAAI,QAAQ,OAAO;AAEvF,MAAK,MAAM,YAAY,WAAW,MAAM,oBAAoB,IAAI,EAAE,EAAE;EAClE,MAAM,QAAQ,CAAC,GAAG,SAAS;AAC3B,OAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,SAAS,GAAG,SAAS,EACrD,UAAS,IAAI,OAAO,MAAM,SAAS,MAAM,QAAQ,KAAK;;AAG1D,QAAO;;;AAIT,SAAgB,wBAAwB,OAAe,SAAyB;CAC9E,MAAM,gBAAgB,gBAAgB,MAAM;CAC5C,MAAM,kBAAkB,gBAAgB,QAAQ;AAChD,KAAI,cAAc,SAAS,KAAK,gBAAgB,SAAS,EAAG,QAAO;CACnE,IAAI,SAAS;AACb,MAAK,MAAM,WAAW,cACpB,KAAI,gBAAgB,IAAI,QAAQ,CAAE,WAAU;AAE9C,QAAQ,IAAI,UAAW,cAAc,OAAO,gBAAgB"}

package/dist/src/storage/sqlite/memory-index-repository.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { escapeFts5Query } from "./fts.js";
+import { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from "./fts.js";
 import { join, relative } from "node:path";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
@@ -50,9 +50,6 @@ function displayPath(baseDir, memoriesDir, userMemoryPath, absPath) {
 function contentHash(content) {
 	return createHash("sha256").update(content).digest("hex");
 }
-function bm25ToScore(rank) {
-	return 1 / (1 + Math.max(0, -rank));
-}
 function indexFile(db, agentId, baseDir, memoriesDir, userMemoryPath, absPath) {
 	const content = readFileSync(absPath, "utf-8");
 	const mtimeMs = statSync(absPath).mtimeMs;
@@ -106,16 +103,28 @@ function syncMemoryIndex(params) {
 }
 function searchMemoryIndex(params) {
 	const { agentId, query, maxResults = 5, minScore = .3 } = params;
-	const ftsQuery = escapeFts5Query(query);
+	const ftsQuery = buildFts5SearchQuery(query);
 	if (!ftsQuery) return [];
-	const rows = getSqliteDatabase().prepare(`SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank
+	const db = getSqliteDatabase();
+	const rows = db.prepare(`SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank
        FROM memory_fts
        WHERE memory_fts MATCH ? AND agent_id = ?
        ORDER BY rank
        LIMIT ?`).all(ftsQuery, agentId, maxResults * 3);
+	if (rows.length === 0) return db.prepare(`SELECT chunk_id, path, start_line, end_line, content
+       FROM memory_fts
+       WHERE agent_id = ?
+       LIMIT 500`).all(agentId).map((row) => ({
+		path: row.path,
+		lines: row.content,
+		score: memoryLexicalSimilarity(query, row.content),
+		lineNumbers: [row.start_line]
+	})).filter((result) => result.score >= minScore).sort((a, b) => b.score - a.score).slice(0, maxResults);
+	const bestRank = Math.min(...rows.map((row) => row.rank));
+	const worstRank = Math.max(...rows.map((row) => row.rank));
 	const results = [];
 	for (const row of rows) {
-		const score = bm25ToScore(row.rank);
+		const score = fts5RankToScore(row.rank, bestRank, worstRank);
 		if (score < minScore) continue;
 		results.push({
 			path: row.path,

package/dist/src/storage/sqlite/memory-index-repository.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"memory-index-repository.js","names":[],"sources":["../../../../src/storage/sqlite/memory-index-repository.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, statSync } from 'node:fs';\nimport { join, relative } from 'node:path';\n\nimport { escapeFts5Query } from './fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\nexport type MemorySearchHit = {\n path: string;\n lines: string;\n score: number;\n lineNumbers: number[];\n};\n\nconst AGENT_MEMORY_FILENAME = 'MEMORY.md';\nconst USER_MEMORY_DISPLAY_PATH = 'user/MEMORY.md';\nconst MEMORY_SYNC_CACHE_TTL_MS = 30_000;\n\ntype MemorySyncCache = {\n timestamp: number;\n paths: string[];\n};\n\nconst memorySyncCache = new Map<string, MemorySyncCache>();\n\nexport function resolveAgentIdFromMemoriesDir(memoriesDir: string \| undefined): string {\n if (!memoriesDir) return 'main';\n const normalized = memoriesDir.replace(/\\\\/g, '/');\n const match = normalized.match(/\\/agents\\/([^/]+)\\/memories\\/?$/);\n return match?.[1] ?? 'main';\n}\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n const d = date \|\| new Date();\n const year = d.getFullYear();\n const month = String(d.getMonth() + 1).padStart(2, '0');\n const day = String(d.getDate()).padStart(2, '0');\n return join(baseDir, 'memory', `${year}-${month}-${day}.md`);\n}\n\nfunction getCuratedMemoryPaths(memoriesDir: string \| undefined, userMemoryPath: string \| undefined): string[] {\n return [\n ...(memoriesDir ? [join(memoriesDir, AGENT_MEMORY_FILENAME)] : []),\n ...(userMemoryPath ? [userMemoryPath] : []),\n ].filter((p) => existsSync(p));\n}\n\nfunction collectMemoryPaths(baseDir: string, memoriesDir?: string, userMemoryPath?: string): string[] {\n const paths: string[] = [];\n paths.push(...getCuratedMemoryPaths(memoriesDir, userMemoryPath));\n\n const longTermPath = join(baseDir, 'MEMORY.md');\n if (existsSync(longTermPath)) {\n paths.push(longTermPath);\n }\n\n const memoryDir = join(baseDir, 'memory');\n if (existsSync(memoryDir)) {\n const today = new Date();\n for (let i = 0; i < 30; i++) {\n const date = new Date(today);\n date.setDate(date.getDate() - i);\n const path = getDailyMemoryPath(baseDir, date);\n if (existsSync(path)) {\n paths.push(path);\n }\n }\n }\n\n return paths;\n}\n\nfunction displayPath(\n baseDir: string,\n memoriesDir: string \| undefined,\n userMemoryPath: string \| undefined,\n absPath: string,\n): string {\n const normalized = absPath.replace(/\\\\/g, '/');\n if (userMemoryPath && normalized === userMemoryPath.replace(/\\\\/g, '/')) {\n return USER_MEMORY_DISPLAY_PATH;\n }\n if (memoriesDir) {\n const memoriesRoot = memoriesDir.replace(/\\\\/g, '/');\n if (normalized.startsWith(memoriesRoot)) {\n const filename = normalized.slice(memoriesRoot.length).replace(/^\\//, '');\n if (filename === AGENT_MEMORY_FILENAME) {\n return filename;\n }\n }\n }\n return relative(baseDir, absPath).replace(/\\\\/g, '/');\n}\n\nfunction contentHash(content: string): string {\n return createHash('sha256').update(content).digest('hex');\n}\n\nfunction bm25ToScore(rank: number): number {\n return 1 / (1 + Math.max(0, -rank));\n}\n\nfunction indexFile(\n db: ReturnType<typeof getSqliteDatabase>,\n agentId: string,\n baseDir: string,\n memoriesDir: string \| undefined,\n userMemoryPath: string \| undefined,\n absPath: string,\n): void {\n const content = readFileSync(absPath, 'utf-8');\n const mtimeMs = statSync(absPath).mtimeMs;\n const hash = contentHash(content);\n const relPath = displayPath(baseDir, memoriesDir, userMemoryPath, absPath);\n const fileId = `${agentId}:${relPath}`;\n\n const existing = db\n .prepare(`SELECT content_hash, mtime_ms FROM memory_files WHERE file_id = ?`)\n .get(fileId) as { content_hash: string; mtime_ms: number } \| undefined;\n if (existing && existing.content_hash === hash && existing.mtime_ms === mtimeMs) {\n return;\n }\n\n db.prepare(`DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`).run(\n fileId,\n );\n db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(fileId);\n db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(fileId);\n\n db.prepare(\n `INSERT INTO memory_files (file_id, agent_id, path, mtime_ms, content_hash)\n VALUES (?, ?, ?, ?, ?)`,\n ).run(fileId, agentId, relPath, mtimeMs, hash);\n\n const lines = content.split('\\n');\n const insertChunk = db.prepare(\n `INSERT INTO memory_chunks (chunk_id, file_id, start_line, end_line, content)\n VALUES (?, ?, ?, ?, ?)`,\n );\n const insertFts = db.prepare(\n `INSERT INTO memory_fts (content, chunk_id, agent_id, path, start_line, end_line)\n VALUES (?, ?, ?, ?, ?, ?)`,\n );\n\n for (let i = 0; i < lines.length; i++) {\n const line = lines[i];\n if (!line.trim()) continue;\n const lineNo = i + 1;\n const chunkId = `${fileId}:${lineNo}`;\n insertChunk.run(chunkId, fileId, lineNo, lineNo, line);\n insertFts.run(line, chunkId, agentId, relPath, lineNo, lineNo);\n }\n}\n\nexport function syncMemoryIndex(params: {\n agentId: string;\n workspaceDir: string;\n memoriesDir?: string;\n userMemoryPath?: string;\n}): void {\n const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ''}:${params.userMemoryPath ?? ''}`;\n const now = Date.now();\n const cached = memorySyncCache.get(cacheKey);\n if (cached && now - cached.timestamp < MEMORY_SYNC_CACHE_TTL_MS) {\n return;\n }\n\n const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir, params.userMemoryPath);\n memorySyncCache.set(cacheKey, { timestamp: now, paths });\n runSqliteWriteTransaction((db) => {\n const seen = new Set<string>();\n for (const absPath of paths) {\n seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath)}`);\n indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath);\n }\n\n const stale = db\n .prepare(`SELECT file_id FROM memory_files WHERE agent_id = ?`)\n .all(params.agentId) as Array<{ file_id: string }>;\n for (const row of stale) {\n if (!seen.has(row.file_id)) {\n db.prepare(\n `DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`,\n ).run(row.file_id);\n db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(row.file_id);\n db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(row.file_id);\n }\n }\n });\n}\n\nexport function searchMemoryIndex(params: {\n agentId: string;\n query: string;\n maxResults?: number;\n minScore?: number;\n}): MemorySearchHit[] {\n const { agentId, query, maxResults = 5, minScore = 0.3 } = params;\n const ftsQuery = escapeFts5Query(query);\n if (!ftsQuery) {\n return [];\n }\n\n const db = getSqliteDatabase();\n const rows = db\n .prepare(\n `SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank\n FROM memory_fts\n WHERE memory_fts MATCH ? AND agent_id = ?\n ORDER BY rank\n LIMIT ?`,\n )\n .all(ftsQuery, agentId, maxResults * 3) as Array<{\n chunk_id: string;\n path: string;\n start_line: number;\n end_line: number;\n content: string;\n rank: number;\n }>;\n\n const results: MemorySearchHit[] = [];\n for (const row of rows) {\n const score = bm25ToScore(row.rank);\n if (score < minScore) continue;\n results.push({\n path: row.path,\n lines: row.content,\n score,\n lineNumbers: [row.start_line],\n });\n }\n\n results.sort((a, b) => b.score - a.score);\n return results.slice(0, maxResults);\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"memory-index-repository.js","names":[],"sources":["../../../../src/storage/sqlite/memory-index-repository.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, statSync } from 'node:fs';\nimport { join, relative } from 'node:path';\n\nimport { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from './fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\nexport type MemorySearchHit = {\n path: string;\n lines: string;\n score: number;\n lineNumbers: number[];\n};\n\nconst AGENT_MEMORY_FILENAME = 'MEMORY.md';\nconst USER_MEMORY_DISPLAY_PATH = 'user/MEMORY.md';\nconst MEMORY_SYNC_CACHE_TTL_MS = 30_000;\n\ntype MemorySyncCache = {\n timestamp: number;\n paths: string[];\n};\n\nconst memorySyncCache = new Map<string, MemorySyncCache>();\n\nexport function resolveAgentIdFromMemoriesDir(memoriesDir: string \| undefined): string {\n if (!memoriesDir) return 'main';\n const normalized = memoriesDir.replace(/\\\\/g, '/');\n const match = normalized.match(/\\/agents\\/([^/]+)\\/memories\\/?$/);\n return match?.[1] ?? 'main';\n}\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n const d = date \|\| new Date();\n const year = d.getFullYear();\n const month = String(d.getMonth() + 1).padStart(2, '0');\n const day = String(d.getDate()).padStart(2, '0');\n return join(baseDir, 'memory', `${year}-${month}-${day}.md`);\n}\n\nfunction getCuratedMemoryPaths(memoriesDir: string \| undefined, userMemoryPath: string \| undefined): string[] {\n return [\n ...(memoriesDir ? [join(memoriesDir, AGENT_MEMORY_FILENAME)] : []),\n ...(userMemoryPath ? [userMemoryPath] : []),\n ].filter((p) => existsSync(p));\n}\n\nfunction collectMemoryPaths(baseDir: string, memoriesDir?: string, userMemoryPath?: string): string[] {\n const paths: string[] = [];\n paths.push(...getCuratedMemoryPaths(memoriesDir, userMemoryPath));\n\n const longTermPath = join(baseDir, 'MEMORY.md');\n if (existsSync(longTermPath)) {\n paths.push(longTermPath);\n }\n\n const memoryDir = join(baseDir, 'memory');\n if (existsSync(memoryDir)) {\n const today = new Date();\n for (let i = 0; i < 30; i++) {\n const date = new Date(today);\n date.setDate(date.getDate() - i);\n const path = getDailyMemoryPath(baseDir, date);\n if (existsSync(path)) {\n paths.push(path);\n }\n }\n }\n\n return paths;\n}\n\nfunction displayPath(\n baseDir: string,\n memoriesDir: string \| undefined,\n userMemoryPath: string \| undefined,\n absPath: string,\n): string {\n const normalized = absPath.replace(/\\\\/g, '/');\n if (userMemoryPath && normalized === userMemoryPath.replace(/\\\\/g, '/')) {\n return USER_MEMORY_DISPLAY_PATH;\n }\n if (memoriesDir) {\n const memoriesRoot = memoriesDir.replace(/\\\\/g, '/');\n if (normalized.startsWith(memoriesRoot)) {\n const filename = normalized.slice(memoriesRoot.length).replace(/^\\//, '');\n if (filename === AGENT_MEMORY_FILENAME) {\n return filename;\n }\n }\n }\n return relative(baseDir, absPath).replace(/\\\\/g, '/');\n}\n\nfunction contentHash(content: string): string {\n return createHash('sha256').update(content).digest('hex');\n}\n\nfunction indexFile(\n db: ReturnType<typeof getSqliteDatabase>,\n agentId: string,\n baseDir: string,\n memoriesDir: string \| undefined,\n userMemoryPath: string \| undefined,\n absPath: string,\n): void {\n const content = readFileSync(absPath, 'utf-8');\n const mtimeMs = statSync(absPath).mtimeMs;\n const hash = contentHash(content);\n const relPath = displayPath(baseDir, memoriesDir, userMemoryPath, absPath);\n const fileId = `${agentId}:${relPath}`;\n\n const existing = db\n .prepare(`SELECT content_hash, mtime_ms FROM memory_files WHERE file_id = ?`)\n .get(fileId) as { content_hash: string; mtime_ms: number } \| undefined;\n if (existing && existing.content_hash === hash && existing.mtime_ms === mtimeMs) {\n return;\n }\n\n db.prepare(`DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`).run(\n fileId,\n );\n db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(fileId);\n db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(fileId);\n\n db.prepare(\n `INSERT INTO memory_files (file_id, agent_id, path, mtime_ms, content_hash)\n VALUES (?, ?, ?, ?, ?)`,\n ).run(fileId, agentId, relPath, mtimeMs, hash);\n\n const lines = content.split('\\n');\n const insertChunk = db.prepare(\n `INSERT INTO memory_chunks (chunk_id, file_id, start_line, end_line, content)\n VALUES (?, ?, ?, ?, ?)`,\n );\n const insertFts = db.prepare(\n `INSERT INTO memory_fts (content, chunk_id, agent_id, path, start_line, end_line)\n VALUES (?, ?, ?, ?, ?, ?)`,\n );\n\n for (let i = 0; i < lines.length; i++) {\n const line = lines[i];\n if (!line.trim()) continue;\n const lineNo = i + 1;\n const chunkId = `${fileId}:${lineNo}`;\n insertChunk.run(chunkId, fileId, lineNo, lineNo, line);\n insertFts.run(line, chunkId, agentId, relPath, lineNo, lineNo);\n }\n}\n\nexport function syncMemoryIndex(params: {\n agentId: string;\n workspaceDir: string;\n memoriesDir?: string;\n userMemoryPath?: string;\n}): void {\n const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ''}:${params.userMemoryPath ?? ''}`;\n const now = Date.now();\n const cached = memorySyncCache.get(cacheKey);\n if (cached && now - cached.timestamp < MEMORY_SYNC_CACHE_TTL_MS) {\n return;\n }\n\n const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir, params.userMemoryPath);\n memorySyncCache.set(cacheKey, { timestamp: now, paths });\n runSqliteWriteTransaction((db) => {\n const seen = new Set<string>();\n for (const absPath of paths) {\n seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath)}`);\n indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath);\n }\n\n const stale = db\n .prepare(`SELECT file_id FROM memory_files WHERE agent_id = ?`)\n .all(params.agentId) as Array<{ file_id: string }>;\n for (const row of stale) {\n if (!seen.has(row.file_id)) {\n db.prepare(\n `DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`,\n ).run(row.file_id);\n db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(row.file_id);\n db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(row.file_id);\n }\n }\n });\n}\n\nexport function searchMemoryIndex(params: {\n agentId: string;\n query: string;\n maxResults?: number;\n minScore?: number;\n}): MemorySearchHit[] {\n const { agentId, query, maxResults = 5, minScore = 0.3 } = params;\n const ftsQuery = buildFts5SearchQuery(query);\n if (!ftsQuery) {\n return [];\n }\n\n const db = getSqliteDatabase();\n const rows = db\n .prepare(\n `SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank\n FROM memory_fts\n WHERE memory_fts MATCH ? AND agent_id = ?\n ORDER BY rank\n LIMIT ?`,\n )\n .all(ftsQuery, agentId, maxResults * 3) as Array<{\n chunk_id: string;\n path: string;\n start_line: number;\n end_line: number;\n content: string;\n rank: number;\n }>;\n\n if (rows.length === 0) {\n const fallbackRows = db.prepare(\n `SELECT chunk_id, path, start_line, end_line, content\n FROM memory_fts\n WHERE agent_id = ?\n LIMIT 500`,\n ).all(agentId) as Array<{\n chunk_id: string;\n path: string;\n start_line: number;\n end_line: number;\n content: string;\n }>;\n return fallbackRows\n .map((row) => ({\n path: row.path,\n lines: row.content,\n score: memoryLexicalSimilarity(query, row.content),\n lineNumbers: [row.start_line],\n }))\n .filter((result) => result.score >= minScore)\n .sort((a, b) => b.score - a.score)\n .slice(0, maxResults);\n }\n\n const bestRank = Math.min(...rows.map((row) => row.rank));\n const worstRank = Math.max(...rows.map((row) => row.rank));\n const results: MemorySearchHit[] = [];\n for (const row of rows) {\n const score = fts5RankToScore(row.rank, bestRank, worstRank);\n if (score < minScore) continue;\n results.push({\n path: row.path,\n lines: row.content,\n score,\n lineNumbers: [row.start_line],\n });\n }\n\n results.sort((a, b) => b.score - a.score);\n return results.slice(0, maxResults);\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/memory-records-repository.d.ts CHANGED Viewed

@@ -32,6 +32,14 @@ export interface ListMemoryRecordsOptions {
     agentId?: string;
     workspaceId?: string;
     projectId?: string;
+    /** Include unscoped records plus records visible to this session. */
+    visibleToSessionKey?: string;
+    /** Return only records that are not scoped to a session. */
+    unscopedSessionOnly?: boolean;
+    /** Include unscoped records plus records visible to this project. */
+    visibleToProjectId?: string;
+    /** Return only records that are not scoped to a project. */
+    unscopedProjectOnly?: boolean;
     kind?: MemoryKind;
     status?: MemoryStatus;
     canonicalKey?: string;
@@ -43,6 +51,14 @@ export interface SearchMemoryRecordsOptions {
     agentId?: string;
     workspaceId?: string;
     projectId?: string;
+    /** Include unscoped records plus records visible to this session. */
+    visibleToSessionKey?: string;
+    /** Return only records that are not scoped to a session. */
+    unscopedSessionOnly?: boolean;
+    /** Include unscoped records plus records visible to this project. */
+    visibleToProjectId?: string;
+    /** Return only records that are not scoped to a project. */
+    unscopedProjectOnly?: boolean;
     providerId?: string;
     kinds?: MemoryKind[];
     statuses?: MemoryStatus[];
@@ -204,6 +220,7 @@ export declare function setMemoryProviderState(providerId: string, scopeKey: str
 export declare function appendMemoryTraceEvent(input: AppendMemoryTraceEventInput): string;
 export declare function listMemoryTraceEvents(options?: {
     providerId?: string;
+    agentId?: string;
     sessionKey?: string;
     phase?: string;
     limit?: number;
@@ -214,6 +231,7 @@ export declare function setLatestMemoryInjectFeedback(input: SetLatestMemoryInje
 export declare function summarizeMemoryRecallFeedback(options?: {
     recordId?: string;
     providerId?: string;
+    agentId?: string;
     sessionKey?: string;
     limit?: number;
 }): MemoryRecallFeedbackSummary[];