@xopcai/xopc 0.0.137 → 0.0.138

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

@@ -1,4 +1,5 @@
-import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
+import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setLatestMemoryInjectFeedback, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
+import { listKnowledgeSourceItems, listKnowledgeSyncRuns } from "../../../storage/sqlite/knowledge-repository.js";
 import "../../../storage/sqlite/index.js";
 import { MemoryPolicySchema, init_schema } from "../../../agent-manifest/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
@@ -7,12 +8,23 @@ import { resolveBuiltinMemoryStoreConfig } from "../../../agent/memory/memory-co
 import { BuiltinMemoryStore } from "../../../agent/memory/builtin-memory-store.js";
 import { discoverMemoryPlugins } from "../../../agent/memory/plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "../../../agent/memory/create-memory-manager.js";
+import { resolveAdaptiveUnderstandingCadence } from "../../../agent/memory/understanding/quality.js";
 import { prepareUpdateAgent } from "../../agents-admin.js";
 //#region src/gateway/hono/routes/memory.ts
 init_schema();
 init_agent_scope();
 const MEMORY_KINDS = new Set([
 	"user_profile",
+	"preference",
+	"boundary",
+	"relationship",
+	"project_context",
+	"commitment",
+	"routine",
+	"personal_logistics",
+	"open_question",
+	"milestone",
+	"current_state",
 	"agent_note",
 	"workspace_fact",
 	"daily_note",
@@ -22,6 +34,21 @@ const MEMORY_KINDS = new Set([
 	"tool_preference",
 	"long_term_goal"
 ]);
+const MEMORY_EXPLICITNESS = new Set([
+	"explicit",
+	"observed",
+	"inferred"
+]);
+const MEMORY_DURABILITY = new Set([
+	"ephemeral",
+	"durable",
+	"recurring"
+]);
+const MEMORY_DISCLOSURE_POLICIES = new Set([
+	"silent",
+	"referenceable",
+	"ask_before_reference"
+]);
 const MEMORY_STATUSES = new Set([
 	"candidate",
 	"active",
@@ -42,6 +69,13 @@ const MEMORY_TRACE_FEEDBACK_OUTCOMES = new Set([
 	"mixed",
 	"irrelevant"
 ]);
+const KNOWLEDGE_SYNTHESIS_STATUSES = new Set([
+	"pending",
+	"processing",
+	"completed",
+	"failed",
+	"ignored"
+]);
 function parseLimit(raw, fallback = 100) {
 	const parsed = raw ? Number.parseInt(raw, 10) : fallback;
 	return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;
@@ -50,6 +84,10 @@ function parseFeedbackSummaryLimit(raw) {
 	const parsed = raw ? Number.parseInt(raw, 10) : 1e3;
 	return Number.isFinite(parsed) ? Math.max(1, Math.min(5e3, parsed)) : 1e3;
 }
+function parseWindowDays(raw) {
+	const parsed = raw ? Number.parseInt(raw, 10) : 30;
+	return Number.isFinite(parsed) ? Math.max(1, Math.min(365, parsed)) : 30;
+}
 function parseKind(raw) {
 	return typeof raw === "string" && MEMORY_KINDS.has(raw) ? raw : void 0;
 }
@@ -59,13 +97,16 @@ function parseStatus(raw) {
 function parseSensitivity(raw) {
 	return typeof raw === "string" && MEMORY_SENSITIVITIES.has(raw) ? raw : void 0;
 }
+function parseEnum(raw, allowed) {
+	return typeof raw === "string" && allowed.has(raw) ? raw : void 0;
+}
 function registerMemoryRoutes(authenticated, deps) {
 	authenticated.get("/api/memory/providers", async (c) => {
 		const cfg = deps.service.currentConfig;
 		const plugins = await discoverMemoryPlugins(cfg);
 		return c.json({ providers: [{
 			id: "local",
-			displayName: "Local Markdown Memory",
+			displayName: "Local Knowledge Store",
 			available: true,
 			configured: true,
 			capabilities: {
@@ -163,9 +204,18 @@ function registerMemoryRoutes(authenticated, deps) {
 			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : void 0,
 			status: parseStatus(body.status),
 			sensitivity: parseSensitivity(body.sensitivity),
+			canonicalKey: typeof body.canonicalKey === "string" ? body.canonicalKey : void 0,
+			explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS),
+			durability: parseEnum(body.durability, MEMORY_DURABILITY),
+			importance: typeof body.importance === "number" ? body.importance : void 0,
+			disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES),
 			evidence: Array.isArray(body.evidence) ? body.evidence.filter((item) => Boolean(item) && typeof item === "object") : void 0,
 			reviewAfter: typeof body.reviewAfter === "string" ? body.reviewAfter : void 0,
-			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : void 0
+			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : void 0,
+			validFrom: typeof body.validFrom === "string" ? body.validFrom : void 0,
+			validTo: typeof body.validTo === "string" ? body.validTo : void 0,
+			supersedesRecordId: typeof body.supersedesRecordId === "string" ? body.supersedesRecordId : void 0,
+			conflictGroupId: typeof body.conflictGroupId === "string" ? body.conflictGroupId : void 0
 		});
 		return c.json({ record }, 201);
 	});
@@ -187,9 +237,18 @@ function registerMemoryRoutes(authenticated, deps) {
 			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : existing.tags,
 			status: parseStatus(body.status) ?? existing.status,
 			sensitivity: parseSensitivity(body.sensitivity) ?? existing.sensitivity,
+			canonicalKey: typeof body.canonicalKey === "string" ? body.canonicalKey : existing.canonicalKey,
+			explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS) ?? existing.explicitness,
+			durability: parseEnum(body.durability, MEMORY_DURABILITY) ?? existing.durability,
+			importance: typeof body.importance === "number" ? body.importance : existing.importance,
+			disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES) ?? existing.disclosurePolicy,
 			evidence: Array.isArray(body.evidence) ? body.evidence.filter((item) => Boolean(item) && typeof item === "object") : existing.evidence,
 			reviewAfter: typeof body.reviewAfter === "string" ? body.reviewAfter : existing.reviewAfter,
-			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : existing.expiresAt
+			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : existing.expiresAt,
+			validFrom: typeof body.validFrom === "string" ? body.validFrom : existing.validFrom,
+			validTo: typeof body.validTo === "string" ? body.validTo : existing.validTo,
+			supersedesRecordId: typeof body.supersedesRecordId === "string" ? body.supersedesRecordId : existing.supersedesRecordId,
+			conflictGroupId: typeof body.conflictGroupId === "string" ? body.conflictGroupId : existing.conflictGroupId
 		});
 		return c.json({ record });
 	});
@@ -207,6 +266,23 @@ function registerMemoryRoutes(authenticated, deps) {
 		});
 		return c.json({ signals });
 	});
+	authenticated.get("/api/knowledge/source-items", (c) => {
+		const sourceItems = listKnowledgeSourceItems({
+			sourceInstanceId: c.req.query("sourceInstanceId") || void 0,
+			synthesisStatus: parseEnum(c.req.query("synthesisStatus"), KNOWLEDGE_SYNTHESIS_STATUSES),
+			includeDeleted: c.req.query("includeDeleted") === "true",
+			limit: parseLimit(c.req.query("limit")),
+			offset: c.req.query("offset") ? Number.parseInt(c.req.query("offset"), 10) : 0
+		});
+		return c.json({ sourceItems });
+	});
+	authenticated.get("/api/knowledge/sync-runs", (c) => {
+		const syncRuns = listKnowledgeSyncRuns({
+			sourceInstanceId: c.req.query("sourceInstanceId") || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({ syncRuns });
+	});
 	authenticated.get("/api/memory/traces", (c) => {
 		const traces = listMemoryTraceEvents({
 			providerId: c.req.query("providerId") || void 0,
@@ -242,6 +318,55 @@ function registerMemoryRoutes(authenticated, deps) {
 		});
 		return c.json({ summaries });
 	});
+	authenticated.get("/api/memory/understanding/quality", (c) => {
+		const cfg = deps.service.currentConfig;
+		const manifest = resolveEffectiveAgentManifestForAgent(cfg, c.req.query("agentId") || resolveDefaultAgentId(cfg));
+		const metrics = summarizeUserUnderstandingQuality({
+			agentId: manifest.id,
+			windowDays: parseWindowDays(c.req.query("windowDays"))
+		});
+		const cadence = resolveAdaptiveUnderstandingCadence(manifest.memory.understanding?.reviewIntervalTurns ?? 10, metrics, manifest.memory.understanding?.adaptiveCadence ?? true);
+		return c.json({
+			metrics,
+			cadence
+		});
+	});
+	authenticated.patch("/api/memory/understanding/response-feedback", deps.strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const sessionKey = typeof body.sessionKey === "string" ? body.sessionKey.trim() : "";
+		const assistantTimestamp = typeof body.assistantTimestamp === "number" ? body.assistantTimestamp : NaN;
+		const outcome = body.outcome === "helpful" || body.outcome === "not_helpful" ? body.outcome : void 0;
+		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0 || !outcome) return c.json({ error: "sessionKey, assistantTimestamp, and a valid outcome are required" }, 400);
+		const trace = setLatestMemoryInjectFeedback({
+			sessionKey,
+			beforeMs: assistantTimestamp,
+			feedback: {
+				outcome,
+				source: "user",
+				reason: "assistant_response_feedback"
+			}
+		});
+		return c.json({
+			matched: Boolean(trace),
+			attributedRecordCount: trace?.selectedRecordIds.length ?? 0,
+			feedback: trace?.feedback ?? null,
+			remediation: trace?.remediation ?? null
+		});
+	});
+	authenticated.get("/api/memory/understanding/response-feedback", (c) => {
+		const sessionKey = c.req.query("sessionKey")?.trim() ?? "";
+		const assistantTimestamp = Number(c.req.query("assistantTimestamp"));
+		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0) return c.json({ error: "sessionKey and assistantTimestamp are required" }, 400);
+		const trace = findLatestMemoryInjectTrace({
+			sessionKey,
+			beforeMs: assistantTimestamp
+		});
+		return c.json({
+			matched: Boolean(trace),
+			attributedRecordCount: trace?.selectedRecordIds.length ?? 0,
+			feedback: trace?.feedback ?? null
+		});
+	});
 	authenticated.post("/api/memory/signals", async (c) => {
 		const body = await c.req.json().catch(() => ({}));
 		const source = typeof body.source === "string" ? body.source : "";

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

@@ -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 type {\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 { prepareUpdateAgent } from '../../agents-admin.js';\nimport {\n  appendMemorySignal,\n  appendMemoryTraceEvent,\n  deleteMemoryRecord,\n  getMemoryRecord,\n  listMemoryRecords,\n  listMemorySignals,\n  listMemoryTraceEvents,\n  searchMemoryRecords,\n  setMemoryTraceFeedback,\n  summarizeMemoryRecallFeedback,\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  '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_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\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 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\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 Markdown Memory',\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      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    });\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      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    });\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/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.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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"}
+{"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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"}

package/dist/src/knowledge/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './ingestion-service.js';

package/dist/src/knowledge/index.js

@@ -0,0 +1,2 @@
+import { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore } from "./ingestion-service.js";
+export { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore };

package/dist/src/knowledge/ingestion-service.d.ts

@@ -0,0 +1,20 @@
+import type { KnowledgeSourceAdapter, KnowledgeSyncRun } from './types.js';
+export interface KnowledgeSourceStateStore {
+    getCursor(instanceId: string): string | undefined;
+    setCursor(instanceId: string, cursor: string | undefined): void;
+}
+export declare class SqliteKnowledgeSourceStateStore implements KnowledgeSourceStateStore {
+    getCursor(instanceId: string): string | undefined;
+    setCursor(instanceId: string, cursor: string | undefined): void;
+}
+export declare class KnowledgeIngestionService {
+    private readonly adapters;
+    private readonly state;
+    constructor(adapters: ReadonlyMap<string, KnowledgeSourceAdapter>, state?: KnowledgeSourceStateStore);
+    sync(params: {
+        adapterKind: string;
+        instanceId: string;
+        windowStart?: string;
+        signal?: AbortSignal;
+    }): Promise<KnowledgeSyncRun>;
+}

package/dist/src/knowledge/ingestion-service.js

@@ -0,0 +1,75 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { finishKnowledgeSyncRun, getKnowledgeSourceCursor, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
+//#region src/knowledge/ingestion-service.ts
+init_logger();
+const log = createLogger("KnowledgeIngestion");
+var SqliteKnowledgeSourceStateStore = class {
+	getCursor(instanceId) {
+		return getKnowledgeSourceCursor(instanceId);
+	}
+	setCursor(instanceId, cursor) {
+		setKnowledgeSourceCursor(instanceId, cursor);
+	}
+};
+var KnowledgeIngestionService = class {
+	constructor(adapters, state = new SqliteKnowledgeSourceStateStore()) {
+		this.adapters = adapters;
+		this.state = state;
+	}
+	async sync(params) {
+		const adapter = this.adapters.get(params.adapterKind);
+		if (!adapter) throw new Error(`Knowledge source adapter not found: ${params.adapterKind}`);
+		const cursorBefore = this.state.getCursor(params.instanceId);
+		const run = startKnowledgeSyncRun({
+			sourceInstanceId: params.instanceId,
+			cursorBefore
+		});
+		const controller = params.signal ? null : new AbortController();
+		const signal = params.signal ?? controller.signal;
+		try {
+			const pulled = await adapter.pull({
+				instanceId: params.instanceId,
+				cursor: cursorBefore,
+				windowStart: params.windowStart,
+				signal
+			});
+			const stored = upsertKnowledgeSourceItems(pulled.items);
+			this.state.setCursor(params.instanceId, pulled.nextCursor);
+			const completed = finishKnowledgeSyncRun({
+				runId: run.id,
+				status: pulled.warnings.length > 0 ? "partial" : "succeeded",
+				cursorAfter: pulled.nextCursor,
+				itemsSeen: pulled.items.length,
+				itemsCreated: stored.created,
+				itemsUpdated: stored.updated,
+				warnings: pulled.warnings
+			});
+			log.info({
+				runId: run.id,
+				sourceInstanceId: params.instanceId,
+				itemsSeen: pulled.items.length,
+				itemsCreated: stored.created,
+				itemsUpdated: stored.updated
+			}, "Knowledge source sync completed");
+			return completed;
+		} catch (err) {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			const status = signal.aborted ? "cancelled" : "failed";
+			log.warn({
+				err,
+				runId: run.id,
+				sourceInstanceId: params.instanceId
+			}, `Knowledge source sync ${status}: ${errorMessage}`);
+			return finishKnowledgeSyncRun({
+				runId: run.id,
+				status,
+				error: errorMessage
+			});
+		}
+	}
+};
+//#endregion
+export { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore };
+
+//# sourceMappingURL=ingestion-service.js.map

package/dist/src/knowledge/ingestion-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion-service.js","names":[],"sources":["../../../src/knowledge/ingestion-service.ts"],"sourcesContent":["import { createLogger } from '../utils/logger.js';\nimport {\n  finishKnowledgeSyncRun,\n  getKnowledgeSourceCursor,\n  setKnowledgeSourceCursor,\n  startKnowledgeSyncRun,\n  upsertKnowledgeSourceItems,\n} from '../storage/sqlite/knowledge-repository.js';\nimport type { KnowledgeSourceAdapter, KnowledgeSyncRun } from './types.js';\n\nconst log = createLogger('KnowledgeIngestion');\n\nexport interface KnowledgeSourceStateStore {\n  getCursor(instanceId: string): string | undefined;\n  setCursor(instanceId: string, cursor: string | undefined): void;\n}\n\nexport class SqliteKnowledgeSourceStateStore implements KnowledgeSourceStateStore {\n  getCursor(instanceId: string): string | undefined {\n    return getKnowledgeSourceCursor(instanceId);\n  }\n\n  setCursor(instanceId: string, cursor: string | undefined): void {\n    setKnowledgeSourceCursor(instanceId, cursor);\n  }\n}\n\nexport class KnowledgeIngestionService {\n  constructor(\n    private readonly adapters: ReadonlyMap<string, KnowledgeSourceAdapter>,\n    private readonly state: KnowledgeSourceStateStore = new SqliteKnowledgeSourceStateStore(),\n  ) {}\n\n  async sync(params: {\n    adapterKind: string;\n    instanceId: string;\n    windowStart?: string;\n    signal?: AbortSignal;\n  }): Promise<KnowledgeSyncRun> {\n    const adapter = this.adapters.get(params.adapterKind);\n    if (!adapter) {\n      throw new Error(`Knowledge source adapter not found: ${params.adapterKind}`);\n    }\n    const cursorBefore = this.state.getCursor(params.instanceId);\n    const run = startKnowledgeSyncRun({\n      sourceInstanceId: params.instanceId,\n      cursorBefore,\n    });\n    const controller = params.signal ? null : new AbortController();\n    const signal = params.signal ?? controller!.signal;\n\n    try {\n      const pulled = await adapter.pull({\n        instanceId: params.instanceId,\n        cursor: cursorBefore,\n        windowStart: params.windowStart,\n        signal,\n      });\n      const stored = upsertKnowledgeSourceItems(pulled.items);\n      this.state.setCursor(params.instanceId, pulled.nextCursor);\n      const completed = finishKnowledgeSyncRun({\n        runId: run.id,\n        status: pulled.warnings.length > 0 ? 'partial' : 'succeeded',\n        cursorAfter: pulled.nextCursor,\n        itemsSeen: pulled.items.length,\n        itemsCreated: stored.created,\n        itemsUpdated: stored.updated,\n        warnings: pulled.warnings,\n      });\n      log.info(\n        {\n          runId: run.id,\n          sourceInstanceId: params.instanceId,\n          itemsSeen: pulled.items.length,\n          itemsCreated: stored.created,\n          itemsUpdated: stored.updated,\n        },\n        'Knowledge source sync completed',\n      );\n      return completed;\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      const status = signal.aborted ? 'cancelled' : 'failed';\n      log.warn(\n        { err, runId: run.id, sourceInstanceId: params.instanceId },\n        `Knowledge source sync ${status}: ${errorMessage}`,\n      );\n      return finishKnowledgeSyncRun({\n        runId: run.id,\n        status,\n        error: errorMessage,\n      });\n    }\n  }\n}\n"],"mappings":";;;;aAAkD;AAUlD,MAAM,MAAM,aAAa,qBAAqB;AAO9C,IAAa,kCAAb,MAAkF;CAChF,UAAU,YAAwC;AAChD,SAAO,yBAAyB,WAAW;;CAG7C,UAAU,YAAoB,QAAkC;AAC9D,2BAAyB,YAAY,OAAO;;;AAIhD,IAAa,4BAAb,MAAuC;CACrC,YACE,UACA,QAAoD,IAAI,iCAAiC,EACzF;AAFiB,OAAA,WAAA;AACA,OAAA,QAAA;;CAGnB,MAAM,KAAK,QAKmB;EAC5B,MAAM,UAAU,KAAK,SAAS,IAAI,OAAO,YAAY;AACrD,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,uCAAuC,OAAO,cAAc;EAE9E,MAAM,eAAe,KAAK,MAAM,UAAU,OAAO,WAAW;EAC5D,MAAM,MAAM,sBAAsB;GAChC,kBAAkB,OAAO;GACzB;GACD,CAAC;EACF,MAAM,aAAa,OAAO,SAAS,OAAO,IAAI,iBAAiB;EAC/D,MAAM,SAAS,OAAO,UAAU,WAAY;AAE5C,MAAI;GACF,MAAM,SAAS,MAAM,QAAQ,KAAK;IAChC,YAAY,OAAO;IACnB,QAAQ;IACR,aAAa,OAAO;IACpB;IACD,CAAC;GACF,MAAM,SAAS,2BAA2B,OAAO,MAAM;AACvD,QAAK,MAAM,UAAU,OAAO,YAAY,OAAO,WAAW;GAC1D,MAAM,YAAY,uBAAuB;IACvC,OAAO,IAAI;IACX,QAAQ,OAAO,SAAS,SAAS,IAAI,YAAY;IACjD,aAAa,OAAO;IACpB,WAAW,OAAO,MAAM;IACxB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,UAAU,OAAO;IAClB,CAAC;AACF,OAAI,KACF;IACE,OAAO,IAAI;IACX,kBAAkB,OAAO;IACzB,WAAW,OAAO,MAAM;IACxB,cAAc,OAAO;IACrB,cAAc,OAAO;IACtB,EACD,kCACD;AACD,UAAO;WACA,KAAK;GACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GACrE,MAAM,SAAS,OAAO,UAAU,cAAc;AAC9C,OAAI,KACF;IAAE;IAAK,OAAO,IAAI;IAAI,kBAAkB,OAAO;IAAY,EAC3D,yBAAyB,OAAO,IAAI,eACrC;AACD,UAAO,uBAAuB;IAC5B,OAAO,IAAI;IACX;IACA,OAAO;IACR,CAAC"}

package/dist/src/knowledge/types.d.ts

@@ -0,0 +1,70 @@
+import type { MemorySensitivity } from '../agent/memory/types.js';
+export type KnowledgeSyncRunStatus = 'running' | 'succeeded' | 'partial' | 'failed' | 'cancelled';
+export type KnowledgeSynthesisStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'ignored';
+export type KnowledgeRetentionClass = 'ephemeral' | 'bounded' | 'durable';
+export type KnowledgeAuthorRole = 'user' | 'assistant' | 'third_party' | 'system' | 'unknown';
+export interface KnowledgeSourceItem {
+    id: string;
+    sourceInstanceId: string;
+    externalId: string;
+    itemType: string;
+    authorRole?: KnowledgeAuthorRole;
+    occurredAt?: string;
+    sourceUpdatedAt?: string;
+    contentHash: string;
+    normalizedText?: string;
+    payloadRef?: string;
+    metadata: Record<string, unknown>;
+    sensitivity: MemorySensitivity;
+    retentionClass: KnowledgeRetentionClass;
+    synthesisStatus: KnowledgeSynthesisStatus;
+    deletedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeSourceItemInput {
+    id?: string;
+    sourceInstanceId: string;
+    externalId: string;
+    itemType: string;
+    authorRole?: KnowledgeAuthorRole;
+    occurredAt?: string;
+    sourceUpdatedAt?: string;
+    contentHash: string;
+    normalizedText?: string;
+    payloadRef?: string;
+    metadata?: Record<string, unknown>;
+    sensitivity?: MemorySensitivity;
+    retentionClass?: KnowledgeRetentionClass;
+    synthesisStatus?: KnowledgeSynthesisStatus;
+    deletedAt?: string;
+}
+export interface KnowledgeSyncRun {
+    id: string;
+    sourceInstanceId: string;
+    status: KnowledgeSyncRunStatus;
+    cursorBefore?: string;
+    cursorAfter?: string;
+    itemsSeen: number;
+    itemsCreated: number;
+    itemsUpdated: number;
+    warnings: string[];
+    error?: string;
+    startedAt: string;
+    finishedAt?: string;
+}
+export interface KnowledgePullInput {
+    instanceId: string;
+    cursor?: string;
+    windowStart?: string;
+    signal: AbortSignal;
+}
+export interface KnowledgePullResult {
+    items: KnowledgeSourceItemInput[];
+    nextCursor?: string;
+    warnings: string[];
+}
+export interface KnowledgeSourceAdapter {
+    readonly kind: string;
+    pull(input: KnowledgePullInput): Promise<KnowledgePullResult>;
+}

package/dist/src/knowledge/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/presentation.js

@@ -5,6 +5,7 @@ import { getDomesticProviderPreset, getDomesticProviderPresetIds } from "./domes
 init_providers();
 init_plugin_registry();
 const FEATURED_PROVIDER_ORDER = [
+	"deepseek",
 	"openai",
 	"anthropic",
 	"xai",
@@ -15,7 +16,6 @@ const FEATURED_PROVIDER_ORDER = [
 	"volcengine-ark",
 	"volcengine-plan",
 	"byteplus-plan",
-	"deepseek",
 	"moonshotai",
 	"moonshotai-cn",
 	"kimi-coding",