@xopcai/xopc 0.0.180 → 0.0.188

package/dist/src/agent/memory/dreaming/utils.d.ts

@@ -1,52 +1,3 @@
 import type { DreamingDeepConfig } from './config.js';
-type DreamingStoreEntryScoringView = {
-    recallCount: number;
-    totalScore: number;
-    lastRecalledAt?: string;
-    queryHashes?: readonly string[];
-    sourceCount: number;
-    groundedCount: number;
-    lightHits: number;
-    remHits: number;
-};
-/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
-export declare function normalizeMemoryPath(rel: string): string;
-/**
- * Stable id for a short-term store entry (path + line range).
- * Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).
- */
-export declare function buildEntryKey(parts: {
-    path: string;
-    startLine: number;
-    endLine: number;
-}): string;
-/** YYYY-MM-DD in local time. */
-export declare function isoDay(d: Date): string;
-export declare function clamp01(value: number): number;
-/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */
-export declare function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig;
-export declare function computeCandidateScore(entry: DreamingStoreEntryScoringView, nowMs: number, recencyHalfLifeDays: number): {
-    avgScore: number;
-    score: number;
-    recencyDecay: number;
-};
-export declare function compareCandidatesByScore(a: {
-    score: number;
-    key: string;
-}, b: {
-    score: number;
-    key: string;
-}): number;
-export declare function readFileLines(fullPath: string): Promise<string[] | null>;
-/** 1-based inclusive line range. Joins with newlines. */
-export declare function sliceRange(lines: string[], startLine: number, endLine: number): string;
-export declare function isExpiredEntry(lastRecalledAt: string | undefined, nowMs: number, maxAgeDays: number): boolean;
-/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */
-export declare function isContaminatedSnippet(snippet: string): boolean;
-export declare function normalizeSnippetForHash(text: string): string;
-export declare function snippetHash(text: string): string;
-export declare function extractPromotionMarkers(markdown: string): {
-    keys: Set<string>;
-    hashes: Set<string>;
-};
-export {};
+export type DeepExecutionConfig = Omit<DreamingDeepConfig, 'schedule'>;
+export declare function resolveDeepDefaults(overrides?: Partial<DeepExecutionConfig>): DeepExecutionConfig;

package/dist/src/agent/memory/dreaming/utils.js

@@ -1,39 +1,13 @@
-import { DEFAULT_DEEP_CRON, DIVERSITY_WEIGHT, MS_PER_DAY, REINFORCEMENT_WEIGHT } from "./constants.js";
-import path from "node:path";
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
+import "./constants.js";
 //#region src/agent/memory/dreaming/utils.ts
-/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
-function normalizeMemoryPath(rel) {
-	if (typeof rel !== "string" || !rel.trim()) return "";
-	const s = rel.trim().replace(/\\/g, "/");
-	return path.posix.normalize(s).replace(/^(\.\/)+/, "").replace(/\/+/g, "/");
-}
-/**
-* Stable id for a short-term store entry (path + line range).
-* Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).
-*/
-function buildEntryKey(parts) {
-	const p = normalizeMemoryPath(parts.path);
-	const a = Math.max(1, Math.floor(parts.startLine));
-	return `${p}#${a}-${Math.max(a, Math.floor(parts.endLine))}`;
-}
-/** YYYY-MM-DD in local time. */
-function isoDay(d) {
-	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
-}
-function clamp01(value) {
-	if (!Number.isFinite(value)) return 0;
-	return Math.max(0, Math.min(1, value));
-}
 function toPositiveInt(value, fallback) {
-	const num = typeof value === "string" ? Number(value) : Number(value);
+	const num = Number(value);
 	if (!Number.isFinite(num)) return fallback;
 	const floored = Math.floor(num);
 	return floored > 0 ? floored : fallback;
 }
 function toNonNegInt(value, fallback) {
-	const num = typeof value === "string" ? Number(value) : Number(value);
+	const num = Number(value);
 	if (!Number.isFinite(num)) return fallback;
 	const floored = Math.floor(num);
 	return floored >= 0 ? floored : fallback;
@@ -42,14 +16,9 @@ function clampScore(value, fallback) {
 	if (!Number.isFinite(value)) return fallback;
 	return Math.max(0, Math.min(1, value));
 }
-function trimmedCron(value, fallback) {
-	return typeof value === "string" && value.trim() ? value.trim() : fallback;
-}
-/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */
 function resolveDeepDefaults(overrides) {
 	return {
 		enabled: overrides?.enabled !== false,
-		cron: trimmedCron(overrides?.cron, DEFAULT_DEEP_CRON),
 		minScore: clampScore(Number(overrides?.minScore), .8),
 		minRecallCount: toPositiveInt(overrides?.minRecallCount, 3),
 		minUniqueQueries: toPositiveInt(overrides?.minUniqueQueries, 3),
@@ -58,82 +27,5 @@ function resolveDeepDefaults(overrides) {
 		maxAgeDays: toPositiveInt(overrides?.maxAgeDays, 30)
 	};
 }
-function computeCandidateScore(entry, nowMs, recencyHalfLifeDays) {
-	const recall = Math.max(0, entry.recallCount);
-	const avgScore = clamp01(recall > 0 ? entry.totalScore / recall : 0);
-	let recencyDecay = 1;
-	if (entry.lastRecalledAt) {
-		const last = Date.parse(entry.lastRecalledAt);
-		if (Number.isFinite(last)) recencyDecay = .5 ** (Math.max(0, (nowMs - last) / MS_PER_DAY) / Math.max(.1, recencyHalfLifeDays));
-	}
-	const logRecall = Math.log(1 + recall);
-	const reinforcement = REINFORCEMENT_WEIGHT * Math.min(logRecall, 3);
-	const qCount = entry.queryHashes?.length ?? 0;
-	const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;
-	const signalDiversity = [
-		entry.sourceCount,
-		entry.groundedCount,
-		entry.lightHits,
-		entry.remHits
-	].filter((n) => n > 0).length / 4 * DIVERSITY_WEIGHT / 2;
-	return {
-		avgScore,
-		score: clamp01(avgScore * recencyDecay + reinforcement * .25 + uniqueQueryTerm + signalDiversity),
-		recencyDecay
-	};
-}
-function compareCandidatesByScore(a, b) {
-	if (b.score !== a.score) return b.score - a.score;
-	return a.key.localeCompare(b.key);
-}
-async function readFileLines(fullPath) {
-	try {
-		return (await fs.readFile(fullPath, "utf-8")).split(/\r?\n/);
-	} catch (err) {
-		if (err?.code === "ENOENT") return null;
-		throw err;
-	}
-}
-/** 1-based inclusive line range. Joins with newlines. */
-function sliceRange(lines, startLine, endLine) {
-	const a = Math.max(1, Math.floor(startLine));
-	const b = Math.max(a, Math.floor(endLine));
-	return lines.slice(a - 1, b).join("\n").trimEnd();
-}
-function isExpiredEntry(lastRecalledAt, nowMs, maxAgeDays) {
-	if (!lastRecalledAt) return true;
-	const t = Date.parse(lastRecalledAt);
-	if (!Number.isFinite(t)) return true;
-	return (nowMs - t) / MS_PER_DAY > maxAgeDays;
-}
-/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */
-function isContaminatedSnippet(snippet) {
-	const s = snippet.trim();
-	if (s.length < 3) return true;
-	if (s.length > 12e3) return true;
-	if (!/\p{L}/u.test(s) && !/\d/.test(s)) return true;
-	return false;
-}
-function normalizeSnippetForHash(text) {
-	return text.toLowerCase().replace(/\s+/g, " ").replace(/['"`]/g, "").trim();
-}
-function snippetHash(text) {
-	const n = normalizeSnippetForHash(text);
-	return createHash("sha1").update(n, "utf8").digest("hex").slice(0, 20);
-}
-function extractPromotionMarkers(markdown) {
-	const keys = /* @__PURE__ */ new Set();
-	const hashes = /* @__PURE__ */ new Set();
-	let m;
-	const re = /<!--\s*xopc-memory-promotion\s+key="([^"]*)"\s+hash="([^"]*)"\s*-->/g;
-	while ((m = re.exec(markdown)) !== null) {
-		if (m[1]) keys.add(m[1]);
-		if (m[2]) hashes.add(m[2]);
-	}
-	return {
-		keys,
-		hashes
-	};
-}
 //#endregion
-export { buildEntryKey, clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, normalizeMemoryPath, normalizeSnippetForHash, readFileLines, resolveDeepDefaults, sliceRange, snippetHash };
+export { resolveDeepDefaults };

package/dist/src/agent/memory/index.d.ts

@@ -1,10 +1,9 @@
-export { BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, scanForThreats } from './builtin-memory-store.js';
 export { BuiltinMemoryProvider } from './builtin-provider.js';
 export { buildUserContextBlock, sanitizeUserContextFenceEscapes, } from './context-fence.js';
 export { UserContextPlanner } from './context/planner.js';
 export type { UserContextPlan } from './context/types.js';
 export { createMemoryManagerFromConfig } from './create-memory-manager.js';
-export { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldPlanUserContextThisTurn, shouldRegisterCuratedMemoryTool, } from './memory-config.js';
+export { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn, } from './memory-config.js';
 export { MemoryManager } from './manager.js';
 export { UserUnderstandingService, extractExplicitUnderstandingCandidates } from './understanding/service.js';
 export type { UnderstandingCandidate, UnderstandingReviewResult } from './understanding/types.js';
@@ -12,5 +11,4 @@ export { discoverMemoryPlugins } from './plugin-discovery.js';
 export type { MemoryPluginMetadata } from './plugin-discovery.js';
 export type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 export { StubMemoryProvider } from './stub-memory-provider.js';
-export type { MemorySnapshot, MemoryStoreConfig } from './types.js';
 export { extractAgentUserPlainText } from './user-message-text.js';

package/dist/src/agent/memory/index.js

@@ -1,12 +1,11 @@
-import { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldPlanUserContextThisTurn, shouldRegisterCuratedMemoryTool } from "./memory-config.js";
+import { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn } from "./memory-config.js";
 import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { UserContextPlanner } from "./context/planner.js";
 import { extractAgentUserPlainText } from "./user-message-text.js";
-import { BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, scanForThreats } from "./builtin-memory-store.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { UserUnderstandingService, extractExplicitUnderstandingCandidates } from "./understanding/service.js";
 import { MemoryManager } from "./manager.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";
 import { StubMemoryProvider } from "./stub-memory-provider.js";
-export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryManager, StubMemoryProvider, UserContextPlanner, UserUnderstandingService, buildUserContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, extractExplicitUnderstandingCandidates, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeUserContextFenceEscapes, scanForThreats, shouldPlanUserContextThisTurn, shouldRegisterCuratedMemoryTool };
+export { BuiltinMemoryProvider, MemoryManager, StubMemoryProvider, UserContextPlanner, UserUnderstandingService, buildUserContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, extractExplicitUnderstandingCandidates, isMemorySubsystemEnabled, sanitizeUserContextFenceEscapes, shouldPlanUserContextThisTurn };

package/dist/src/agent/memory/manager.d.ts

@@ -17,7 +17,6 @@ export interface MemoryWritePolicy {
     allowExternalWrites?: boolean;
     allowedProviderIds?: string[];
     autoWriteKinds?: MemoryKind[];
-    requireUserProfileApproval?: boolean;
 }
 export declare class MemoryManager {
     private providers;
@@ -32,9 +31,7 @@ export declare class MemoryManager {
     constructor(options?: MemoryManagerOptions);
     addProvider(provider: MemoryProvider): void;
     get providersList(): MemoryProvider[];
-    /**
-     * Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).
-     */
+    /** Static instructions contributed by external memory providers. */
     buildExternalSystemPrompt(): string;
     queuePrefetchAll(query: string, options?: {
         sessionId?: string;
@@ -59,7 +56,10 @@ export declare class MemoryManager {
         source?: MemoryRecord['source'];
         reviewSource?: 'turn' | 'background';
     }): Promise<import('./understanding/types.js').UnderstandingReviewResult>;
-    getAdditionalTools(): AgentTool[];
+    getExternalToolEntries(): Array<{
+        providerId: string;
+        tool: AgentTool;
+    }>;
     handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string>;
     search(request: MemorySearchRequest): Promise<MemorySearchResult[]>;
     read(request: MemoryReadRequest): Promise<MemoryReadResult | null>;
@@ -69,7 +69,6 @@ export declare class MemoryManager {
     update(request: MemoryUpdateRequest): Promise<MemoryWriteResult>;
     delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult>;
     private canReadRecord;
-    onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void;
     recordSignal(signal: MemorySignal): void;
     initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void>;
     private loadPluginProvidersOnce;

package/dist/src/agent/memory/manager.js

@@ -26,7 +26,6 @@ var MemoryManager = class {
 		this.loadProviders = options.loadProviders;
 		this.writePolicy = {
 			allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,
-			requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,
 			allowedProviderIds: options.writePolicy?.allowedProviderIds,
 			autoWriteKinds: options.writePolicy?.autoWriteKinds
 		};
@@ -56,9 +55,7 @@ var MemoryManager = class {
 	get providersList() {
 		return [...this.providers];
 	}
-	/**
-	* Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).
-	*/
+	/** Static instructions contributed by external memory providers. */
 	buildExternalSystemPrompt() {
 		const blocks = [];
 		for (const p of this.providers) {
@@ -143,7 +140,7 @@ var MemoryManager = class {
 			...sourceItemId ? { sourceItemId } : {}
 		};
 	}
-	getAdditionalTools() {
+	getExternalToolEntries() {
 		const out = [];
 		const seen = /* @__PURE__ */ new Set();
 		for (const p of this.providers) {
@@ -151,7 +148,10 @@ var MemoryManager = class {
 			try {
 				for (const t of p.getToolSchemas?.() ?? []) if (t.name && !seen.has(t.name)) {
 					seen.add(t.name);
-					out.push(t);
+					out.push({
+						providerId: p.id,
+						tool: t
+					});
 				}
 			} catch (err) {
 				log.warn({
@@ -274,24 +274,6 @@ var MemoryManager = class {
 	canReadRecord(record, scope) {
 		return true;
 	}
-	onMemoryWrite(action, target, content) {
-		for (const p of this.providers) {
-			if (p.capabilities.local) continue;
-			try {
-				p.sync?.({
-					type: "write",
-					action,
-					target,
-					content
-				});
-			} catch (err) {
-				log.debug({
-					err,
-					id: p.id
-				}, "memory write sync failed");
-			}
-		}
-	}
 	recordSignal(signal) {
 		for (const p of this.providers) {
 			const started = Date.now();
@@ -440,11 +422,6 @@ var MemoryManager = class {
 			const writeRequest = request;
 			if (writeRequest.status === "candidate" && !provider.capabilities.local) return false;
 			if (this.writePolicy.autoWriteKinds && this.writePolicy.autoWriteKinds.length > 0 && !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)) return false;
-			if (this.writePolicy.requireUserProfileApproval && writeRequest.kind === "user_profile" && !writeRequest.approved) return false;
-		}
-		if (operation === "update" && this.writePolicy.requireUserProfileApproval) {
-			const updateRequest = request;
-			if (updateRequest.target === "user" && !updateRequest.approved) return false;
 		}
 		return true;
 	}

package/dist/src/agent/memory/memory-config.d.ts

@@ -1,13 +1,8 @@
 import type { Config } from '../../config/schema.js';
-import type { MemoryStoreConfig } from './types.js';
-/** When false, shared curated memory and external memory providers are off. */
+/** When false, structured user understanding and external memory providers are off. */
 export declare function isMemorySubsystemEnabled(config: Config | undefined): boolean;
-/** Curated memory tool + shared user `memories/` store (not injected into system prompt). */
-export declare function isCuratedMemoryInPrompt(config: Config | undefined): boolean;
-export declare function resolveBuiltinMemoryStoreConfig(workspaceDir: string, config: Config | undefined, _requestedAgentId?: string): MemoryStoreConfig;
 /**
  * Whether to prefix the user message with prefetched external memory this turn.
  * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …
  */
 export declare function shouldPlanUserContextThisTurn(_config: Config | undefined, turnNumber: number): boolean;
-export declare function shouldRegisterCuratedMemoryTool(config: Config | undefined): boolean;

package/dist/src/agent/memory/memory-config.js

@@ -1,27 +1,9 @@
-import { init_paths, resolveUserDir, resolveUserMemoryPath } from "../../config/paths.js";
-import { join } from "node:path";
 //#region src/agent/memory/memory-config.ts
-init_paths();
-/** When false, shared curated memory and external memory providers are off. */
+/** When false, structured user understanding and external memory providers are off. */
 function isMemorySubsystemEnabled(config) {
 	if (!config) return true;
 	return config.userContext.enabled && config.userContext.memory.mode !== "off";
 }
-/** Curated memory tool + shared user `memories/` store (not injected into system prompt). */
-function isCuratedMemoryInPrompt(config) {
-	if (!config) return true;
-	return config.userContext.enabled && config.userContext.memory.sources.includes("curated");
-}
-function resolveBuiltinMemoryStoreConfig(workspaceDir, config, _requestedAgentId) {
-	return {
-		workspaceDir,
-		memoriesDir: config != null ? join(resolveUserDir(), "memories") : join(workspaceDir, "memories"),
-		userMemoryPath: config != null ? resolveUserMemoryPath() : join(workspaceDir, "user", "MEMORY.md"),
-		memoryCharLimit: config?.userContext.memory.retention?.maxChars ?? 2200,
-		userCharLimit: 1375,
-		userProfileEnabled: config?.userContext.memory.sources.includes("userProfile") ?? true
-	};
-}
 /**
 * Whether to prefix the user message with prefetched external memory this turn.
 * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …
@@ -29,8 +11,5 @@ function resolveBuiltinMemoryStoreConfig(workspaceDir, config, _requestedAgentId
 function shouldPlanUserContextThisTurn(_config, turnNumber) {
 	return turnNumber >= 1;
 }
-function shouldRegisterCuratedMemoryTool(config) {
-	return isCuratedMemoryInPrompt(config);
-}
 //#endregion
-export { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldPlanUserContextThisTurn, shouldRegisterCuratedMemoryTool };
+export { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn };

package/dist/src/agent/memory/summary-generator.d.ts

@@ -4,7 +4,7 @@
  * Creates structured summaries that preserve:
  * - User requests and intents
  * - Tool call history (deduplicated by file path)
- * - Key decisions and outcomes
+ * - Key decisions and tasks
  * - Modified files list
  * - Usage statistics
  */

package/dist/src/agent/memory/types.d.ts

@@ -1,27 +1,4 @@
-/**
- * Curated Markdown compatibility store:
- * - shared memories: `~/.xopc/user/memories/MEMORY.md`
- * - user profile: `~/.xopc/user/MEMORY.md`
- */
-export interface MemoryStoreConfig {
-    workspaceDir: string;
-    /** Absolute path to the shared user memories directory. */
-    memoriesDir: string;
-    /** Absolute path to global user memory (`~/.xopc/user/MEMORY.md`). */
-    userMemoryPath: string;
-    /** Max chars for MEMORY.md entries (excluding delimiter overhead in limit check uses joined body). */
-    memoryCharLimit: number;
-    /** Max chars for global user memory entries. */
-    userCharLimit: number;
-    /** When false, global user memory is not loaded into the snapshot or shown in the system prompt. */
-    userProfileEnabled?: boolean;
-}
-/** Frozen at session start; not updated when tools mutate disk mid-session. */
-export interface MemorySnapshot {
-    memory: string;
-    user: string;
-}
-export type MemoryKind = 'user_profile' | 'preference' | 'boundary' | 'relationship' | 'project_context' | 'commitment' | 'routine' | 'personal_logistics' | 'open_question' | 'milestone' | 'current_state' | 'curated_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight' | 'task_lesson' | 'tool_preference' | 'long_term_goal';
+export type MemoryKind = 'user_profile' | 'preference' | 'boundary' | 'relationship' | 'project_context' | 'commitment' | 'routine' | 'personal_logistics' | 'open_question' | 'milestone' | 'current_state' | 'user_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight' | 'task_lesson' | 'tool_preference' | 'long_term_goal';
 export type MemoryStatus = 'candidate' | 'active' | 'needs_review' | 'stale' | 'archived' | 'rejected';
 export type MemorySensitivity = 'normal' | 'personal' | 'secret' | 'regulated';
 export type MemoryExplicitness = 'explicit' | 'observed' | 'inferred';
@@ -57,6 +34,8 @@ export interface MemoryCitation {
 }
 export interface MemoryRecord {
     id: string;
+    /** Memory provider that owns storage and retrieval for this record. */
+    providerId: string;
     kind: MemoryKind;
     status?: MemoryStatus;
     canonicalKey?: string;
@@ -104,24 +83,16 @@ export interface MemorySearchResult {
     citation: MemoryCitation;
 }
 export interface MemoryReadRequest {
-    id?: string;
-    path?: string;
-    from?: number;
-    lines?: number;
+    id: string;
     scope?: Partial<MemoryScope>;
 }
 export interface MemoryReadResult {
     record: MemoryRecord;
-    lineNumbers?: {
-        start: number;
-        end: number;
-    };
 }
 export interface MemoryListRequest {
     kind?: MemoryKind;
     status?: MemoryStatus;
     canonicalKey?: string;
-    target?: 'memory' | 'user';
     scope?: Partial<MemoryScope>;
 }
 export interface MemoryWriteRequest {
@@ -129,7 +100,6 @@ export interface MemoryWriteRequest {
     content: string;
     canonicalKey?: string;
     scope?: Partial<MemoryScope>;
-    target?: 'memory' | 'user';
     tags?: string[];
     source?: MemoryRecord['source'];
     confidence?: number;
@@ -146,21 +116,15 @@ export interface MemoryWriteRequest {
     expiresAt?: string;
     supersedesRecordId?: string;
     conflictGroupId?: string;
-    approved?: boolean;
 }
 export interface MemoryUpdateRequest {
-    id?: string;
-    matchText?: string;
+    id: string;
     content: string;
     scope?: Partial<MemoryScope>;
-    target?: 'memory' | 'user';
-    approved?: boolean;
 }
 export interface MemoryDeleteRequest {
-    id?: string;
-    matchText?: string;
+    id: string;
     scope?: Partial<MemoryScope>;
-    target?: 'memory' | 'user';
 }
 export interface MemoryWriteResult {
     success: boolean;
@@ -194,17 +158,12 @@ export type MemorySyncEvent = {
     userContent: string;
     assistantContent: string;
     sessionId?: string;
-} | {
-    type: 'write';
-    action: 'add' | 'replace' | 'remove';
-    target?: 'memory' | 'user';
-    content: string;
 } | {
     type: 'signal';
     signal: MemorySignal;
 };
 export interface MemorySignal {
-    source: 'search_recall' | 'session_summary' | 'explicit_remember' | 'background_review' | 'dreaming';
+    source: 'search_recall' | 'context_injection' | 'session_summary' | 'explicit_remember' | 'background_review' | 'dreaming';
     recordId?: string;
     score?: number;
     content?: string;

package/dist/src/agent/memory/understanding/service.js

@@ -28,7 +28,7 @@ function inferKind(content) {
 	if (/\b(project|repo|codebase|workspace)\b/i.test(content) || /项目|仓库|代码库/.test(content)) return "project_context";
 	if (/\b(goal|plan|commit|deadline)\b/i.test(content) || /目标|计划|承诺|截止/.test(content)) return "commitment";
 	if (/\b(next time|lesson|failed|error)\b/i.test(content) || /下次|教训|失败|错误/.test(content)) return "task_lesson";
-	return "curated_note";
+	return "user_note";
 }
 const SENSITIVITY_RANK = {
 	normal: 0,
@@ -166,7 +166,6 @@ var UserUnderstandingService = class {
 					userId: "local-owner",
 					sessionKey: context.sessionKey
 				} : void 0,
-				target: candidate.kind === "preference" ? "user" : "memory",
 				tags: [...new Set(["user-understanding", ...candidate.tags ?? []])],
 				source: context.source ?? { provider: "user-understanding" },
 				confidence: candidate.confidence,

package/dist/src/agent/memory/user-context-coordinator.d.ts

@@ -12,12 +12,13 @@ export interface UserContextCoordinatorOptions {
 export declare class UserContextCoordinator {
     private readonly options;
     private readonly userTurn;
+    private readonly lastTurnId;
     private readonly correctionTargets;
     private readonly planner;
     private readonly contextCompiler;
     constructor(options: UserContextCoordinatorOptions);
     forgetSession(sessionKey: string): void;
     clear(): void;
-    prepare(userMessage: AgentMessage, sessionKey: string): Promise<UserContextPlan>;
+    prepare(userMessage: AgentMessage, sessionKey: string, turnId: string): Promise<UserContextPlan>;
     afterTurn(sessionKey: string, userPlainText: string): Promise<import('./understanding/types.js').UnderstandingReviewResult | undefined>;
 }

package/dist/src/agent/memory/user-context-coordinator.js

@@ -1,9 +1,10 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { setLatestMemoryInjectFeedback } from "../../storage/sqlite/memory-records-repository.js";
+import { setMemoryTurnFeedback } from "../../storage/sqlite/memory-records-repository.js";
 import "../../storage/sqlite/index.js";
-import { ContextCompiler } from "../../user-context/context-compiler.js";
+import { assembleTaskContext } from "../../tasks/task-context-assembler.js";
 import { shouldPlanUserContextThisTurn } from "./memory-config.js";
+import { ContextCompiler } from "../../user-context/context-compiler.js";
 import { UserContextPlanner } from "./context/planner.js";
 import { isExplicitUnderstandingCorrection } from "./understanding/correction.js";
 import { extractAgentUserPlainText } from "./user-message-text.js";
@@ -12,6 +13,7 @@ init_logger();
 const log = createLogger("UserContextCoordinator");
 var UserContextCoordinator = class {
 	userTurn = /* @__PURE__ */ new Map();
+	lastTurnId = /* @__PURE__ */ new Map();
 	correctionTargets = /* @__PURE__ */ new Map();
 	planner = new UserContextPlanner();
 	contextCompiler = new ContextCompiler();
@@ -20,13 +22,15 @@ var UserContextCoordinator = class {
 	}
 	forgetSession(sessionKey) {
 		this.userTurn.delete(sessionKey);
+		this.lastTurnId.delete(sessionKey);
 		this.correctionTargets.delete(sessionKey);
 	}
 	clear() {
 		this.userTurn.clear();
+		this.lastTurnId.clear();
 		this.correctionTargets.clear();
 	}
-	async prepare(userMessage, sessionKey) {
+	async prepare(userMessage, sessionKey, turnId) {
 		const empty = () => ({
 			traceId: "",
 			modelMessage: userMessage,
@@ -37,22 +41,34 @@ var UserContextCoordinator = class {
 		});
 		const config = this.options.getConfig();
 		if (!this.options.isEnabledForSession(sessionKey)) return empty();
-		const query = extractAgentUserPlainText(userMessage);
+		const userQuery = extractAgentUserPlainText(userMessage);
+		const taskContext = assembleTaskContext(sessionKey, userQuery);
+		const query = taskContext.retrievalQuery;
+		const previousTurnId = this.lastTurnId.get(sessionKey);
+		this.lastTurnId.set(sessionKey, turnId);
 		this.correctionTargets.delete(sessionKey);
 		let excludedRecordIds;
-		if (isExplicitUnderstandingCorrection(query)) try {
-			const trace = setLatestMemoryInjectFeedback({
-				sessionKey,
-				requireSelectedRecords: true,
-				feedback: {
-					outcome: "not_helpful",
-					source: "system",
-					reason: "detected_explicit_user_correction"
-				}
+		if (previousTurnId && isExplicitUnderstandingCorrection(userQuery)) try {
+			const trace = setMemoryTurnFeedback({
+				turnId: previousTurnId,
+				rating: "incorrect",
+				source: "system",
+				reasonCode: "detected_explicit_user_correction"
 			});
 			if (trace?.selectedRecordIds.length) {
 				this.correctionTargets.set(sessionKey, trace.selectedRecordIds);
 				excludedRecordIds = trace.selectedRecordIds;
+				if (trace.selectedRecordIds.length === 1) setMemoryTurnFeedback({
+					turnId: previousTurnId,
+					rating: "incorrect",
+					source: "system",
+					reasonCode: "detected_explicit_user_correction",
+					records: [{
+						recordId: trace.selectedRecordIds[0],
+						rating: "incorrect",
+						reasonCode: "detected_explicit_user_correction"
+					}]
+				});
 			}
 		} catch (err) {
 			log.debug({
@@ -67,9 +83,11 @@ var UserContextCoordinator = class {
 			memoryManager: this.options.getMemoryManagerForSession(sessionKey),
 			agentId: this.options.getAgentIdForSession(sessionKey),
 			sessionKey,
+			turnId,
 			query,
 			userMessage,
-			excludedRecordIds
+			excludedRecordIds,
+			allocation: taskContext.allocation
 		});
 		if (plan.traceId) try {
 			this.contextCompiler.capture({