@xopcai/xopc 0.0.117 → 0.0.118

package/dist/src/agent/bootstrap/bootstrap-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-files.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_HEARTBEAT_FILENAME } from '../context/workspace.js';\nimport {\n  getOrLoadBootstrapFiles,\n  markBootstrapContextInjected,\n  wasBootstrapContextInjected,\n} from './bootstrap-cache.js';\nimport {\n  buildBootstrapContextFiles,\n  resolveBootstrapMaxChars,\n  resolveBootstrapTotalMaxChars,\n} from './bootstrap-context.js';\nimport { filterBootstrapFilesForSession } from './filter-bootstrap-files.js';\nimport { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';\n\nfunction filterHeartbeatBootstrapFile(\n  files: WorkspaceBootstrapFile[],\n  exclude: boolean,\n): WorkspaceBootstrapFile[] {\n  if (!exclude) {\n    return files;\n  }\n  return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);\n}\n\nexport function resolveBootstrapFilesSync(params: {\n  profileDir: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): WorkspaceBootstrapFile[] {\n  const rawFiles = loadProfileBootstrapFiles(params.profileDir);\n  const filtered = filterBootstrapFilesForSession(rawFiles, params.sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport async function resolveBootstrapFilesForRun(params: {\n  profileDir: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  warn?: (message: string) => void;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const sessionKey = params.sessionKey;\n  const rawFiles = sessionKey\n    ? await getOrLoadBootstrapFiles({\n        profileDir: params.profileDir,\n        sessionKey,\n      })\n    : loadProfileBootstrapFiles(params.profileDir);\n  const filtered = filterBootstrapFilesForSession(rawFiles, sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport function resolveBootstrapContextSync(params: {\n  profileDir: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n}): {\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n} {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = resolveBootstrapFilesSync(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n\nexport async function resolveBootstrapContextForRun(params: {\n  profileDir: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n  warn?: (message: string) => void;\n}): Promise<{\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n}> {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = await resolveBootstrapFilesForRun(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n    warn: params.warn,\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n"],"mappings":";;;;;;AAkBA,SAAS,6BACP,OACA,SAC0B;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,KAAK,SAAS,2BAA2B;;AAGzE,SAAgB,0BAA0B,QAIb;AAG3B,QAAO,6BADU,+BADA,0BAA0B,OAAO,WACM,EAAE,OAAO,WACrB,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,eAAsB,4BAA4B,QAKZ;CACpC,MAAM,aAAa,OAAO;AAQ1B,QAAO,6BADU,+BANA,aACb,MAAM,wBAAwB;EAC5B,YAAY,OAAO;EACnB;EACD,CAAC,GACF,0BAA0B,OAAO,WAAW,EACU,WACd,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,SAAgB,4BAA4B,QAS1C;CACA,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,0BAA0B,OAAO;CACxD,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC5D,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc;;AAGzC,eAAsB,8BAA8B,QAUjD;CACD,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,MAAM,4BAA4B,OAAO;CAChE,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC3D,MAAM,OAAO;EACd,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc"}
+{"version":3,"file":"bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-files.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_HEARTBEAT_FILENAME } from '../context/workspace.js';\nimport {\n  getOrLoadBootstrapFiles,\n  markBootstrapContextInjected,\n  wasBootstrapContextInjected,\n} from './bootstrap-cache.js';\nimport {\n  buildBootstrapContextFiles,\n  resolveBootstrapMaxChars,\n  resolveBootstrapTotalMaxChars,\n} from './bootstrap-context.js';\nimport { filterBootstrapFilesForSession } from './filter-bootstrap-files.js';\nimport { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from './load-bootstrap-files.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';\n\nfunction filterHeartbeatBootstrapFile(\n  files: WorkspaceBootstrapFile[],\n  exclude: boolean,\n): WorkspaceBootstrapFile[] {\n  if (!exclude) {\n    return files;\n  }\n  return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);\n}\n\nexport function resolveBootstrapFilesSync(params: {\n  profileDir: string;\n  userProfilePath?: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): WorkspaceBootstrapFile[] {\n  const rawFiles = [\n    ...loadUserProfileBootstrapFile(params.userProfilePath),\n    ...loadProfileBootstrapFiles(params.profileDir),\n  ];\n  const filtered = filterBootstrapFilesForSession(rawFiles, params.sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport async function resolveBootstrapFilesForRun(params: {\n  profileDir: string;\n  userProfilePath?: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  warn?: (message: string) => void;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const sessionKey = params.sessionKey;\n  const rawFiles = sessionKey\n    ? await getOrLoadBootstrapFiles({\n        profileDir: params.profileDir,\n        userProfilePath: params.userProfilePath,\n        sessionKey,\n      })\n    : [\n        ...loadUserProfileBootstrapFile(params.userProfilePath),\n        ...loadProfileBootstrapFiles(params.profileDir),\n      ];\n  const filtered = filterBootstrapFilesForSession(rawFiles, sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport function resolveBootstrapContextSync(params: {\n  profileDir: string;\n  userProfilePath?: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n}): {\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n} {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = resolveBootstrapFilesSync(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n\nexport async function resolveBootstrapContextForRun(params: {\n  profileDir: string;\n  userProfilePath?: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n  warn?: (message: string) => void;\n}): Promise<{\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n}> {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = await resolveBootstrapFilesForRun(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n    warn: params.warn,\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n"],"mappings":";;;;;;AAkBA,SAAS,6BACP,OACA,SAC0B;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,KAAK,SAAS,2BAA2B;;AAGzE,SAAgB,0BAA0B,QAKb;AAM3B,QAAO,6BADU,+BAA+B,CAH9C,GAAG,6BAA6B,OAAO,gBAAgB,EACvD,GAAG,0BAA0B,OAAO,WAAW,CAEO,EAAE,OAAO,WACrB,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,eAAsB,4BAA4B,QAMZ;CACpC,MAAM,aAAa,OAAO;AAY1B,QAAO,6BADU,+BAVA,aACb,MAAM,wBAAwB;EAC5B,YAAY,OAAO;EACnB,iBAAiB,OAAO;EACxB;EACD,CAAC,GACF,CACE,GAAG,6BAA6B,OAAO,gBAAgB,EACvD,GAAG,0BAA0B,OAAO,WAAW,CAChD,EACqD,WACd,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,SAAgB,4BAA4B,QAU1C;CACA,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,0BAA0B,OAAO;CACxD,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC5D,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc;;AAGzC,eAAsB,8BAA8B,QAWjD;CACD,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,MAAM,4BAA4B,OAAO;CAChE,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC3D,MAAM,OAAO;EACd,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc"}

package/dist/src/agent/bootstrap/filter-bootstrap-files.js

@@ -1,14 +1,16 @@
 import { isCronSessionKey, isSubagentSessionKey } from "../../routing/session-key-utils.js";
 import { init_session_key } from "../../routing/session-key.js";
-import { DEFAULT_AGENTS_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, DEFAULT_USER_FILENAME } from "../context/workspace.js";
+import { USER_PROFILE_FILENAME, init_paths } from "../../config/paths.js";
+import { DEFAULT_AGENTS_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME } from "../context/workspace.js";
 //#region src/agent/bootstrap/filter-bootstrap-files.ts
+init_paths();
 init_session_key();
 const MINIMAL_BOOTSTRAP_ALLOWLIST = new Set([
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_TOOLS_FILENAME,
 	DEFAULT_SOUL_FILENAME,
 	DEFAULT_IDENTITY_FILENAME,
-	DEFAULT_USER_FILENAME
+	USER_PROFILE_FILENAME
 ]);
 /** Subagent and cron sessions omit MEMORY.md and other heavy profile files. */
 function filterBootstrapFilesForSession(files, sessionKey) {

package/dist/src/agent/bootstrap/filter-bootstrap-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/filter-bootstrap-files.ts"],"sourcesContent":["import { isCronSessionKey, isSubagentSessionKey } from '../../routing/session-key.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_USER_FILENAME,\n} from '../context/workspace.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\nconst MINIMAL_BOOTSTRAP_ALLOWLIST = new Set<string>([\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_USER_FILENAME,\n]);\n\n/** Subagent and cron sessions omit MEMORY.md and other heavy profile files. */\nexport function filterBootstrapFilesForSession(\n  files: WorkspaceBootstrapFile[],\n  sessionKey?: string,\n): WorkspaceBootstrapFile[] {\n  if (!sessionKey || (!isSubagentSessionKey(sessionKey) && !isCronSessionKey(sessionKey))) {\n    return files;\n  }\n  return files.filter((file) => MINIMAL_BOOTSTRAP_ALLOWLIST.has(file.name));\n}\n"],"mappings":";;;;kBAAsF;AAUtF,MAAM,8BAA8B,IAAI,IAAY;CAClD;CACA;CACA;CACA;CACA;CACD,CAAC;;AAGF,SAAgB,+BACd,OACA,YAC0B;AAC1B,KAAI,CAAC,cAAe,CAAC,qBAAqB,WAAW,IAAI,CAAC,iBAAiB,WAAW,CACpF,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,4BAA4B,IAAI,KAAK,KAAK,CAAC"}
+{"version":3,"file":"filter-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/filter-bootstrap-files.ts"],"sourcesContent":["import { USER_PROFILE_FILENAME } from '../../config/paths.js';\nimport { isCronSessionKey, isSubagentSessionKey } from '../../routing/session-key.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n} from '../context/workspace.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\nconst MINIMAL_BOOTSTRAP_ALLOWLIST = new Set<string>([\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  USER_PROFILE_FILENAME,\n]);\n\n/** Subagent and cron sessions omit MEMORY.md and other heavy profile files. */\nexport function filterBootstrapFilesForSession(\n  files: WorkspaceBootstrapFile[],\n  sessionKey?: string,\n): WorkspaceBootstrapFile[] {\n  if (!sessionKey || (!isSubagentSessionKey(sessionKey) && !isCronSessionKey(sessionKey))) {\n    return files;\n  }\n  return files.filter((file) => MINIMAL_BOOTSTRAP_ALLOWLIST.has(file.name));\n}\n"],"mappings":";;;;;YAA8D;kBACwB;AAStF,MAAM,8BAA8B,IAAI,IAAY;CAClD;CACA;CACA;CACA;CACA;CACD,CAAC;;AAGF,SAAgB,+BACd,OACA,YAC0B;AAC1B,KAAI,CAAC,cAAe,CAAC,qBAAqB,WAAW,IAAI,CAAC,iBAAiB,WAAW,CACpF,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,4BAA4B,IAAI,KAAK,KAAK,CAAC"}

package/dist/src/agent/bootstrap/load-bootstrap-files.d.ts

@@ -1,6 +1,7 @@
 import type { WorkspaceBootstrapFile } from './types.js';
+export declare function loadUserProfileBootstrapFile(userProfilePath: string | undefined): WorkspaceBootstrapFile[];
 /**
  * Load bootstrap profile Markdown from `agents/<id>/profile/`.
- * MEMORY.md is omitted when absent; other slots emit missing markers.
+ * Required files emit missing markers; optional files are omitted when absent.
  */
 export declare function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[];

package/dist/src/agent/bootstrap/load-bootstrap-files.js

@@ -1,13 +1,14 @@
-import { DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_MEMORY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, DEFAULT_USER_FILENAME, stripFrontMatter } from "../context/workspace.js";
+import { USER_PROFILE_FILENAME, init_paths } from "../../config/paths.js";
+import { DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_MEMORY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET, stripFrontMatter } from "../context/workspace.js";
 import { join, resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/bootstrap/load-bootstrap-files.ts
+init_paths();
 const PROFILE_LOAD_ORDER = [
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_SOUL_FILENAME,
 	DEFAULT_TOOLS_FILENAME,
 	DEFAULT_IDENTITY_FILENAME,
-	DEFAULT_USER_FILENAME,
 	DEFAULT_HEARTBEAT_FILENAME,
 	DEFAULT_MEMORY_FILENAME
 ];
@@ -19,26 +20,26 @@ function readProfileFile(filePath) {
 		return null;
 	}
 }
+function loadUserProfileBootstrapFile(userProfilePath) {
+	if (!userProfilePath) return [];
+	const filePath = resolve(userProfilePath);
+	const content = readProfileFile(filePath);
+	return content !== null ? [{
+		name: USER_PROFILE_FILENAME,
+		path: filePath,
+		content,
+		missing: false
+	}] : [];
+}
 /**
 * Load bootstrap profile Markdown from `agents/<id>/profile/`.
-* MEMORY.md is omitted when absent; other slots emit missing markers.
+* Required files emit missing markers; optional files are omitted when absent.
 */
 function loadProfileBootstrapFiles(profileDir) {
 	const resolvedDir = resolve(profileDir);
 	const result = [];
 	for (const name of PROFILE_LOAD_ORDER) {
 		const filePath = join(resolvedDir, name);
-		if (name === "MEMORY.md") {
-			const content = readProfileFile(filePath);
-			if (content === null) continue;
-			result.push({
-				name,
-				path: filePath,
-				content,
-				missing: false
-			});
-			continue;
-		}
 		const content = readProfileFile(filePath);
 		if (content !== null) result.push({
 			name,
@@ -46,7 +47,7 @@ function loadProfileBootstrapFiles(profileDir) {
 			content,
 			missing: false
 		});
-		else result.push({
+		else if (REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET.has(name)) result.push({
 			name,
 			path: filePath,
 			missing: true
@@ -55,6 +56,6 @@ function loadProfileBootstrapFiles(profileDir) {
 	return result;
 }
 //#endregion
-export { loadProfileBootstrapFiles };
+export { loadProfileBootstrapFiles, loadUserProfileBootstrapFile };
 
 //# sourceMappingURL=load-bootstrap-files.js.map

package/dist/src/agent/bootstrap/load-bootstrap-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/load-bootstrap-files.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { stripFrontMatter } from '../context/workspace.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_USER_FILENAME,\n} from '../context/workspace.js';\nimport type { BootstrapFileName, WorkspaceBootstrapFile } from './types.js';\n\nconst PROFILE_LOAD_ORDER: BootstrapFileName[] = [\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n];\n\nfunction readProfileFile(filePath: string): string | null {\n  if (!existsSync(filePath)) {\n    return null;\n  }\n  try {\n    return stripFrontMatter(readFileSync(filePath, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * MEMORY.md is omitted when absent; other slots emit missing markers.\n */\nexport function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[] {\n  const resolvedDir = resolve(profileDir);\n  const result: WorkspaceBootstrapFile[] = [];\n\n  for (const name of PROFILE_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    if (name === DEFAULT_MEMORY_FILENAME) {\n      const content = readProfileFile(filePath);\n      if (content === null) {\n        continue;\n      }\n      result.push({ name, path: filePath, content, missing: false });\n      continue;\n    }\n\n    const content = readProfileFile(filePath);\n    if (content !== null) {\n      result.push({ name, path: filePath, content, missing: false });\n    } else {\n      result.push({ name, path: filePath, missing: true });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;AAeA,MAAM,qBAA0C;CAC9C;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAS,gBAAgB,UAAiC;AACxD,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;AAET,KAAI;AACF,SAAO,iBAAiB,aAAa,UAAU,QAAQ,CAAC;SAClD;AACN,SAAO;;;;;;;AAQX,SAAgB,0BAA0B,YAA8C;CACtF,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,oBAAoB;EACrC,MAAM,WAAW,KAAK,aAAa,KAAK;AAExC,MAAI,SAAA,aAAkC;GACpC,MAAM,UAAU,gBAAgB,SAAS;AACzC,OAAI,YAAY,KACd;AAEF,UAAO,KAAK;IAAE;IAAM,MAAM;IAAU;IAAS,SAAS;IAAO,CAAC;AAC9D;;EAGF,MAAM,UAAU,gBAAgB,SAAS;AACzC,MAAI,YAAY,KACd,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU;GAAS,SAAS;GAAO,CAAC;MAE9D,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU,SAAS;GAAM,CAAC;;AAIxD,QAAO"}
+{"version":3,"file":"load-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/load-bootstrap-files.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { USER_PROFILE_FILENAME } from '../../config/paths.js';\nimport { stripFrontMatter } from '../context/workspace.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET,\n} from '../context/workspace.js';\nimport type { BootstrapFileName, WorkspaceBootstrapFile } from './types.js';\n\nconst PROFILE_LOAD_ORDER: BootstrapFileName[] = [\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n];\n\nfunction readProfileFile(filePath: string): string | null {\n  if (!existsSync(filePath)) {\n    return null;\n  }\n  try {\n    return stripFrontMatter(readFileSync(filePath, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nexport function loadUserProfileBootstrapFile(userProfilePath: string | undefined): WorkspaceBootstrapFile[] {\n  if (!userProfilePath) {\n    return [];\n  }\n  const filePath = resolve(userProfilePath);\n  const content = readProfileFile(filePath);\n  return content !== null\n    ? [{ name: USER_PROFILE_FILENAME, path: filePath, content, missing: false }]\n    : [];\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * Required files emit missing markers; optional files are omitted when absent.\n */\nexport function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[] {\n  const resolvedDir = resolve(profileDir);\n  const result: WorkspaceBootstrapFile[] = [];\n\n  for (const name of PROFILE_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    const content = readProfileFile(filePath);\n    if (content !== null) {\n      result.push({ name, path: filePath, content, missing: false });\n    } else if (REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET.has(name)) {\n      result.push({ name, path: filePath, missing: true });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;YAG8D;AAa9D,MAAM,qBAA0C;CAC9C;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAS,gBAAgB,UAAiC;AACxD,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;AAET,KAAI;AACF,SAAO,iBAAiB,aAAa,UAAU,QAAQ,CAAC;SAClD;AACN,SAAO;;;AAIX,SAAgB,6BAA6B,iBAA+D;AAC1G,KAAI,CAAC,gBACH,QAAO,EAAE;CAEX,MAAM,WAAW,QAAQ,gBAAgB;CACzC,MAAM,UAAU,gBAAgB,SAAS;AACzC,QAAO,YAAY,OACf,CAAC;EAAE,MAAM;EAAuB,MAAM;EAAU;EAAS,SAAS;EAAO,CAAC,GAC1E,EAAE;;;;;;AAOR,SAAgB,0BAA0B,YAA8C;CACtF,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,oBAAoB;EACrC,MAAM,WAAW,KAAK,aAAa,KAAK;EAExC,MAAM,UAAU,gBAAgB,SAAS;AACzC,MAAI,YAAY,KACd,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU;GAAS,SAAS;GAAO,CAAC;WACrD,yCAAyC,IAAI,KAAK,CAC3D,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU,SAAS;GAAM,CAAC;;AAIxD,QAAO"}

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

@@ -1,5 +1,5 @@
 import type { AgentProfileMarkdownFilename } from '../context/workspace.js';
-export type BootstrapFileName = AgentProfileMarkdownFilename;
+export type BootstrapFileName = AgentProfileMarkdownFilename | 'PROFILE.md';
 export type WorkspaceBootstrapFile = {
     name: BootstrapFileName;
     path: string;

package/dist/src/agent/context/workspace-templates/AGENTS.md

@@ -11,7 +11,7 @@ This workspace is the agent's working area. Treat it as user-owned state.
 
 ## Startup Context
 
-Use runtime-provided startup context first. It may already include profile files such as `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, `AGENTS.md`, `HEARTBEAT.md`, and `MEMORY.md`.
+Use runtime-provided startup context first. It may already include the global user profile and profile files such as `SOUL.md`, `IDENTITY.md`, `TOOLS.md`, `AGENTS.md`, `HEARTBEAT.md`, and `MEMORY.md`.
 
 Do not manually reread startup files unless:
 

package/dist/src/agent/context/workspace.d.ts

@@ -8,14 +8,16 @@ export declare const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
 export declare const DEFAULT_SOUL_FILENAME = "SOUL.md";
 export declare const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
 export declare const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
-export declare const DEFAULT_USER_FILENAME = "USER.md";
 export declare const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
 export declare const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
-export type AgentProfileMarkdownFilename = typeof DEFAULT_AGENTS_FILENAME | typeof DEFAULT_SOUL_FILENAME | typeof DEFAULT_TOOLS_FILENAME | typeof DEFAULT_IDENTITY_FILENAME | typeof DEFAULT_USER_FILENAME | typeof DEFAULT_HEARTBEAT_FILENAME | typeof DEFAULT_MEMORY_FILENAME;
+export type AgentProfileMarkdownFilename = typeof DEFAULT_AGENTS_FILENAME | typeof DEFAULT_SOUL_FILENAME | typeof DEFAULT_TOOLS_FILENAME | typeof DEFAULT_IDENTITY_FILENAME | typeof DEFAULT_HEARTBEAT_FILENAME | typeof DEFAULT_MEMORY_FILENAME;
 /**
  * Order for loading profile Markdown files into the system prompt (persona / user before repo guide, etc.).
  */
 export declare const AGENT_PROFILE_MARKDOWN_SYSTEM_FILES: readonly AgentProfileMarkdownFilename[];
+/** Files that should be surfaced when missing. Other profile files are optional overlays. */
+export declare const REQUIRED_AGENT_PROFILE_MARKDOWN_FILES: readonly AgentProfileMarkdownFilename[];
+export declare const REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET: ReadonlySet<string>;
 export interface WorkspaceProfileMarkdownFile {
     name: AgentProfileMarkdownFilename;
     path: string;

package/dist/src/agent/context/workspace.js

@@ -16,7 +16,6 @@ const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
 const DEFAULT_SOUL_FILENAME = "SOUL.md";
 const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
 const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
-const DEFAULT_USER_FILENAME = "USER.md";
 const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
 const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 /**
@@ -25,12 +24,14 @@ const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 const AGENT_PROFILE_MARKDOWN_SYSTEM_FILES = [
 	DEFAULT_SOUL_FILENAME,
 	DEFAULT_IDENTITY_FILENAME,
-	DEFAULT_USER_FILENAME,
 	DEFAULT_TOOLS_FILENAME,
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_HEARTBEAT_FILENAME,
 	DEFAULT_MEMORY_FILENAME
 ];
+/** Files that should be surfaced when missing. Other profile files are optional overlays. */
+const REQUIRED_AGENT_PROFILE_MARKDOWN_FILES = [DEFAULT_SOUL_FILENAME, DEFAULT_IDENTITY_FILENAME];
+const REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET = new Set(REQUIRED_AGENT_PROFILE_MARKDOWN_FILES);
 /**
 * Strip YAML front matter from markdown content.
 */
@@ -118,7 +119,7 @@ function loadProfileMarkdownFiles(profileDir) {
 				err
 			}, "Failed to load profile Markdown file");
 		}
-		else {
+		else if (REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET.has(filename)) {
 			const hint = join(profileDir, filename);
 			files.push({
 				name: filename,
@@ -165,6 +166,6 @@ function extractThinkingFromAssistantMessage(message) {
 	return typeof t === "string" ? t : "";
 }
 //#endregion
-export { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_MEMORY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, DEFAULT_USER_FILENAME, PROFILE_MARKDOWN_MAX_CHARS, extractTextContent, extractThinkingContent, extractThinkingFromAssistantMessage, loadProfileMarkdownFiles, stripFrontMatter, toWorkspaceProfileMarkdownFile, truncateProfileMarkdownContent };
+export { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_MEMORY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, PROFILE_MARKDOWN_MAX_CHARS, REQUIRED_AGENT_PROFILE_MARKDOWN_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET, extractTextContent, extractThinkingContent, extractThinkingFromAssistantMessage, loadProfileMarkdownFiles, stripFrontMatter, toWorkspaceProfileMarkdownFile, truncateProfileMarkdownContent };
 
 //# sourceMappingURL=workspace.js.map

package/dist/src/agent/context/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","names":[],"sources":["../../../../src/agent/context/workspace.ts"],"sourcesContent":["/**\n * Agent profile Markdown (filenames, load order, system prompt assembly) and\n * small helpers for message content extraction.\n *\n * Canonical on-disk root: `agents/<agentId>/profile/`.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport { join, resolve } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\n\nconst log = createLogger('Workspace');\n\n// =============================================================================\n// Profile Markdown filenames & types (SOUL.md, IDENTITY.md, … under `profile/`)\n// =============================================================================\n\nexport const DEFAULT_AGENTS_FILENAME = 'AGENTS.md';\nexport const DEFAULT_SOUL_FILENAME = 'SOUL.md';\nexport const DEFAULT_TOOLS_FILENAME = 'TOOLS.md';\nexport const DEFAULT_IDENTITY_FILENAME = 'IDENTITY.md';\nexport const DEFAULT_USER_FILENAME = 'USER.md';\nexport const DEFAULT_HEARTBEAT_FILENAME = 'HEARTBEAT.md';\nexport const DEFAULT_MEMORY_FILENAME = 'MEMORY.md';\n\nexport type AgentProfileMarkdownFilename =\n  | typeof DEFAULT_AGENTS_FILENAME\n  | typeof DEFAULT_SOUL_FILENAME\n  | typeof DEFAULT_TOOLS_FILENAME\n  | typeof DEFAULT_IDENTITY_FILENAME\n  | typeof DEFAULT_USER_FILENAME\n  | typeof DEFAULT_HEARTBEAT_FILENAME\n  | typeof DEFAULT_MEMORY_FILENAME;\n\n/**\n * Order for loading profile Markdown files into the system prompt (persona / user before repo guide, etc.).\n */\nexport const AGENT_PROFILE_MARKDOWN_SYSTEM_FILES: readonly AgentProfileMarkdownFilename[] = [\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n];\n\nexport interface WorkspaceProfileMarkdownFile {\n  name: AgentProfileMarkdownFilename;\n  path: string;\n  content?: string;\n  missing: boolean;\n}\n\n/**\n * Strip YAML front matter from markdown content.\n */\nexport function stripFrontMatter(content: string): string {\n  return parseFrontmatter(content).content;\n}\n\n// =============================================================================\n// Load & truncate profile Markdown for system prompt\n// =============================================================================\n\n/** Maximum characters to inject from workspace files into system prompt */\nexport const PROFILE_MARKDOWN_MAX_CHARS = 20_000;\n\n/** Profile Markdown truncation: fraction of `maxChars` kept from the start of the file */\nconst HEAD_TRUNCATION_RATIO = 0.7;\n/** Profile Markdown truncation: fraction of `maxChars` kept from the end of the file */\nconst TAIL_TRUNCATION_RATIO = 0.2;\n\nexport interface TruncateResult {\n  content: string;\n  truncated: boolean;\n  originalLength: number;\n}\n\n/**\n * Truncate workspace file content to prevent token overflow.\n * Keeps head (HEAD_TRUNCATION_RATIO, 70%) and tail (TAIL_TRUNCATION_RATIO, 20%) with a\n * truncation marker in between; the remainder is reserved for the marker.\n */\nexport function truncateProfileMarkdownContent(content: string, maxChars: number): TruncateResult {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return {\n      content: trimmed,\n      truncated: false,\n      originalLength: trimmed.length,\n    };\n  }\n\n  const headChars = Math.floor(maxChars * HEAD_TRUNCATION_RATIO);\n  const tailChars = Math.floor(maxChars * TAIL_TRUNCATION_RATIO);\n  const head = trimmed.slice(0, headChars);\n  const tail = trimmed.slice(-tailChars);\n\n  const marker = [\n    '',\n    '[...content truncated, read the full file for complete content...]',\n    `...(truncated: kept ${headChars}+${tailChars} chars of ${trimmed.length})...`,\n    '',\n  ].join('\\n');\n\n  return {\n    content: head + marker + tail,\n    truncated: true,\n    originalLength: trimmed.length,\n  };\n}\n\nexport interface ProfileMarkdownFile {\n  name: AgentProfileMarkdownFilename;\n  path?: string;\n  content: string;\n  missing?: boolean;\n}\n\n/**\n * Convert {@link ProfileMarkdownFile} to {@link WorkspaceProfileMarkdownFile} (adds required path field).\n * @param pathFallbackDir — used when `file.path` is absent (e.g. canonical `profile/` root).\n */\nexport function toWorkspaceProfileMarkdownFile(file: ProfileMarkdownFile, pathFallbackDir: string): {\n  name: AgentProfileMarkdownFilename;\n  path: string;\n  content?: string;\n  missing: boolean;\n} {\n  return {\n    name: file.name,\n    path: file.path || join(pathFallbackDir, file.name),\n    content: file.missing ? undefined : file.content,\n    missing: file.missing ?? false,\n  };\n}\n\n/**\n * Load profile Markdown from `profileDir` (`agents/<agentId>/profile/`).\n */\nexport function loadProfileMarkdownFiles(profileDir: string): ProfileMarkdownFile[] {\n  const files: ProfileMarkdownFile[] = [];\n  let loadedCount = 0;\n  let missingCount = 0;\n\n  for (const filename of AGENT_PROFILE_MARKDOWN_SYSTEM_FILES) {\n    const filePath = join(profileDir, filename);\n\n    if (existsSync(filePath)) {\n      try {\n        let content = readFileSync(filePath, 'utf-8');\n\n        content = stripFrontMatter(content);\n\n        const result = truncateProfileMarkdownContent(content, PROFILE_MARKDOWN_MAX_CHARS);\n\n        if (result.content) {\n          files.push({\n            name: filename,\n            content: result.content,\n            path: resolve(filePath),\n          });\n          loadedCount++;\n\n          if (result.truncated) {\n            log.warn(\n              {\n                file: filename,\n                originalLength: result.originalLength,\n                keptLength: result.content.length,\n              },\n              'Profile Markdown truncated in system prompt (too long)',\n            );\n          } else {\n            log.debug({ file: filename, path: filePath }, 'Profile Markdown file loaded');\n          }\n        }\n      } catch (err) {\n        log.warn({ file: filename, err }, 'Failed to load profile Markdown file');\n      }\n    } else {\n      const hint = join(profileDir, filename);\n      files.push({\n        name: filename,\n        content: `[MISSING] Create this file at: ${hint}`,\n        missing: true,\n        path: resolve(hint),\n      });\n      missingCount++;\n      log.debug({ file: filename }, 'Profile Markdown file missing');\n    }\n  }\n\n  log.debug({ loaded: loadedCount, missing: missingCount, profileDir }, 'Profile Markdown scan done');\n\n  return files;\n}\n\n// =============================================================================\n// Message content helpers\n// =============================================================================\n\n/**\n * Extract text content from agent message content array\n */\nexport function extractTextContent(\n  content: Array<{ type: string; text?: string }>\n): string {\n  return content\n    .filter((c) => c.type === 'text')\n    .map((c) => c.text || '')\n    .join('');\n}\n\nconst THINKING_BLOCK_TYPES = new Set(['thinking', 'thinking_delta', 'redacted_thinking']);\n\n/**\n * Concatenate thinking / reasoning content blocks from assistant message.content.\n * pi-ai may use `thinking` or `text` on `type: \"thinking\"` blocks.\n */\nexport function extractThinkingContent(\n  content: Array<{ type: string; thinking?: string; text?: string }> | undefined\n): string {\n  if (!Array.isArray(content)) return '';\n  return content\n    .filter((c) => THINKING_BLOCK_TYPES.has(c.type))\n    .map((c) => (typeof c.thinking === 'string' ? c.thinking : c.text) || '')\n    .join('');\n}\n\n/**\n * Extended thinking on the assistant message (e.g. Anthropic reasoning / pi-ai reasoning_details).\n */\nexport function extractThinkingFromAssistantMessage(\n  message: { role?: string; reasoning_details?: { thinking?: string } } | undefined\n): string {\n  if (!message || message.role !== 'assistant') return '';\n  const t = message.reasoning_details?.thinking;\n  return typeof t === 'string' ? t : '';\n}\n"],"mappings":";;;;;;;;;;;;aASqD;AAGrD,MAAM,MAAM,aAAa,YAAY;AAMrC,MAAa,0BAA0B;AACvC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB;AACtC,MAAa,4BAA4B;AACzC,MAAa,wBAAwB;AACrC,MAAa,6BAA6B;AAC1C,MAAa,0BAA0B;;;;AAcvC,MAAa,sCAA+E;CAC1F;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAYD,SAAgB,iBAAiB,SAAyB;AACxD,QAAO,iBAAiB,QAAQ,CAAC;;;AAQnC,MAAa,6BAA6B;;AAG1C,MAAM,wBAAwB;;AAE9B,MAAM,wBAAwB;;;;;;AAa9B,SAAgB,+BAA+B,SAAiB,UAAkC;CAChG,MAAM,UAAU,QAAQ,SAAS;AACjC,KAAI,QAAQ,UAAU,SACpB,QAAO;EACL,SAAS;EACT,WAAW;EACX,gBAAgB,QAAQ;EACzB;CAGH,MAAM,YAAY,KAAK,MAAM,WAAW,sBAAsB;CAC9D,MAAM,YAAY,KAAK,MAAM,WAAW,sBAAsB;CAC9D,MAAM,OAAO,QAAQ,MAAM,GAAG,UAAU;CACxC,MAAM,OAAO,QAAQ,MAAM,CAAC,UAAU;AAStC,QAAO;EACL,SAAS,OARI;GACb;GACA;GACA,uBAAuB,UAAU,GAAG,UAAU,YAAY,QAAQ,OAAO;GACzE;GACD,CAAC,KAAK,KAGiB,GAAG;EACzB,WAAW;EACX,gBAAgB,QAAQ;EACzB;;;;;;AAcH,SAAgB,+BAA+B,MAA2B,iBAKxE;AACA,QAAO;EACL,MAAM,KAAK;EACX,MAAM,KAAK,QAAQ,KAAK,iBAAiB,KAAK,KAAK;EACnD,SAAS,KAAK,UAAU,KAAA,IAAY,KAAK;EACzC,SAAS,KAAK,WAAW;EAC1B;;;;;AAMH,SAAgB,yBAAyB,YAA2C;CAClF,MAAM,QAA+B,EAAE;CACvC,IAAI,cAAc;CAClB,IAAI,eAAe;AAEnB,MAAK,MAAM,YAAY,qCAAqC;EAC1D,MAAM,WAAW,KAAK,YAAY,SAAS;AAE3C,MAAI,WAAW,SAAS,CACtB,KAAI;GACF,IAAI,UAAU,aAAa,UAAU,QAAQ;AAE7C,aAAU,iBAAiB,QAAQ;GAEnC,MAAM,SAAS,+BAA+B,SAAS,2BAA2B;AAElF,OAAI,OAAO,SAAS;AAClB,UAAM,KAAK;KACT,MAAM;KACN,SAAS,OAAO;KAChB,MAAM,QAAQ,SAAS;KACxB,CAAC;AACF;AAEA,QAAI,OAAO,UACT,KAAI,KACF;KACE,MAAM;KACN,gBAAgB,OAAO;KACvB,YAAY,OAAO,QAAQ;KAC5B,EACD,yDACD;QAED,KAAI,MAAM;KAAE,MAAM;KAAU,MAAM;KAAU,EAAE,+BAA+B;;WAG1E,KAAK;AACZ,OAAI,KAAK;IAAE,MAAM;IAAU;IAAK,EAAE,uCAAuC;;OAEtE;GACL,MAAM,OAAO,KAAK,YAAY,SAAS;AACvC,SAAM,KAAK;IACT,MAAM;IACN,SAAS,kCAAkC;IAC3C,SAAS;IACT,MAAM,QAAQ,KAAK;IACpB,CAAC;AACF;AACA,OAAI,MAAM,EAAE,MAAM,UAAU,EAAE,gCAAgC;;;AAIlE,KAAI,MAAM;EAAE,QAAQ;EAAa,SAAS;EAAc;EAAY,EAAE,6BAA6B;AAEnG,QAAO;;;;;AAUT,SAAgB,mBACd,SACQ;AACR,QAAO,QACJ,QAAQ,MAAM,EAAE,SAAS,OAAO,CAChC,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,GAAG;;AAGb,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAY;CAAkB;CAAoB,CAAC;;;;;AAMzF,SAAgB,uBACd,SACQ;AACR,KAAI,CAAC,MAAM,QAAQ,QAAQ,CAAE,QAAO;AACpC,QAAO,QACJ,QAAQ,MAAM,qBAAqB,IAAI,EAAE,KAAK,CAAC,CAC/C,KAAK,OAAO,OAAO,EAAE,aAAa,WAAW,EAAE,WAAW,EAAE,SAAS,GAAG,CACxE,KAAK,GAAG;;;;;AAMb,SAAgB,oCACd,SACQ;AACR,KAAI,CAAC,WAAW,QAAQ,SAAS,YAAa,QAAO;CACrD,MAAM,IAAI,QAAQ,mBAAmB;AACrC,QAAO,OAAO,MAAM,WAAW,IAAI"}
+{"version":3,"file":"workspace.js","names":[],"sources":["../../../../src/agent/context/workspace.ts"],"sourcesContent":["/**\n * Agent profile Markdown (filenames, load order, system prompt assembly) and\n * small helpers for message content extraction.\n *\n * Canonical on-disk root: `agents/<agentId>/profile/`.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport { join, resolve } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\n\nconst log = createLogger('Workspace');\n\n// =============================================================================\n// Profile Markdown filenames & types (SOUL.md, IDENTITY.md, … under `profile/`)\n// =============================================================================\n\nexport const DEFAULT_AGENTS_FILENAME = 'AGENTS.md';\nexport const DEFAULT_SOUL_FILENAME = 'SOUL.md';\nexport const DEFAULT_TOOLS_FILENAME = 'TOOLS.md';\nexport const DEFAULT_IDENTITY_FILENAME = 'IDENTITY.md';\nexport const DEFAULT_HEARTBEAT_FILENAME = 'HEARTBEAT.md';\nexport const DEFAULT_MEMORY_FILENAME = 'MEMORY.md';\n\nexport type AgentProfileMarkdownFilename =\n  | typeof DEFAULT_AGENTS_FILENAME\n  | typeof DEFAULT_SOUL_FILENAME\n  | typeof DEFAULT_TOOLS_FILENAME\n  | typeof DEFAULT_IDENTITY_FILENAME\n  | typeof DEFAULT_HEARTBEAT_FILENAME\n  | typeof DEFAULT_MEMORY_FILENAME;\n\n/**\n * Order for loading profile Markdown files into the system prompt (persona / user before repo guide, etc.).\n */\nexport const AGENT_PROFILE_MARKDOWN_SYSTEM_FILES: readonly AgentProfileMarkdownFilename[] = [\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n];\n\n/** Files that should be surfaced when missing. Other profile files are optional overlays. */\nexport const REQUIRED_AGENT_PROFILE_MARKDOWN_FILES: readonly AgentProfileMarkdownFilename[] = [\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n];\n\nexport const REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET: ReadonlySet<string> = new Set(\n  REQUIRED_AGENT_PROFILE_MARKDOWN_FILES,\n);\n\nexport interface WorkspaceProfileMarkdownFile {\n  name: AgentProfileMarkdownFilename;\n  path: string;\n  content?: string;\n  missing: boolean;\n}\n\n/**\n * Strip YAML front matter from markdown content.\n */\nexport function stripFrontMatter(content: string): string {\n  return parseFrontmatter(content).content;\n}\n\n// =============================================================================\n// Load & truncate profile Markdown for system prompt\n// =============================================================================\n\n/** Maximum characters to inject from workspace files into system prompt */\nexport const PROFILE_MARKDOWN_MAX_CHARS = 20_000;\n\n/** Profile Markdown truncation: fraction of `maxChars` kept from the start of the file */\nconst HEAD_TRUNCATION_RATIO = 0.7;\n/** Profile Markdown truncation: fraction of `maxChars` kept from the end of the file */\nconst TAIL_TRUNCATION_RATIO = 0.2;\n\nexport interface TruncateResult {\n  content: string;\n  truncated: boolean;\n  originalLength: number;\n}\n\n/**\n * Truncate workspace file content to prevent token overflow.\n * Keeps head (HEAD_TRUNCATION_RATIO, 70%) and tail (TAIL_TRUNCATION_RATIO, 20%) with a\n * truncation marker in between; the remainder is reserved for the marker.\n */\nexport function truncateProfileMarkdownContent(content: string, maxChars: number): TruncateResult {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return {\n      content: trimmed,\n      truncated: false,\n      originalLength: trimmed.length,\n    };\n  }\n\n  const headChars = Math.floor(maxChars * HEAD_TRUNCATION_RATIO);\n  const tailChars = Math.floor(maxChars * TAIL_TRUNCATION_RATIO);\n  const head = trimmed.slice(0, headChars);\n  const tail = trimmed.slice(-tailChars);\n\n  const marker = [\n    '',\n    '[...content truncated, read the full file for complete content...]',\n    `...(truncated: kept ${headChars}+${tailChars} chars of ${trimmed.length})...`,\n    '',\n  ].join('\\n');\n\n  return {\n    content: head + marker + tail,\n    truncated: true,\n    originalLength: trimmed.length,\n  };\n}\n\nexport interface ProfileMarkdownFile {\n  name: AgentProfileMarkdownFilename;\n  path?: string;\n  content: string;\n  missing?: boolean;\n}\n\n/**\n * Convert {@link ProfileMarkdownFile} to {@link WorkspaceProfileMarkdownFile} (adds required path field).\n * @param pathFallbackDir — used when `file.path` is absent (e.g. canonical `profile/` root).\n */\nexport function toWorkspaceProfileMarkdownFile(file: ProfileMarkdownFile, pathFallbackDir: string): {\n  name: AgentProfileMarkdownFilename;\n  path: string;\n  content?: string;\n  missing: boolean;\n} {\n  return {\n    name: file.name,\n    path: file.path || join(pathFallbackDir, file.name),\n    content: file.missing ? undefined : file.content,\n    missing: file.missing ?? false,\n  };\n}\n\n/**\n * Load profile Markdown from `profileDir` (`agents/<agentId>/profile/`).\n */\nexport function loadProfileMarkdownFiles(profileDir: string): ProfileMarkdownFile[] {\n  const files: ProfileMarkdownFile[] = [];\n  let loadedCount = 0;\n  let missingCount = 0;\n\n  for (const filename of AGENT_PROFILE_MARKDOWN_SYSTEM_FILES) {\n    const filePath = join(profileDir, filename);\n\n    if (existsSync(filePath)) {\n      try {\n        let content = readFileSync(filePath, 'utf-8');\n\n        content = stripFrontMatter(content);\n\n        const result = truncateProfileMarkdownContent(content, PROFILE_MARKDOWN_MAX_CHARS);\n\n        if (result.content) {\n          files.push({\n            name: filename,\n            content: result.content,\n            path: resolve(filePath),\n          });\n          loadedCount++;\n\n          if (result.truncated) {\n            log.warn(\n              {\n                file: filename,\n                originalLength: result.originalLength,\n                keptLength: result.content.length,\n              },\n              'Profile Markdown truncated in system prompt (too long)',\n            );\n          } else {\n            log.debug({ file: filename, path: filePath }, 'Profile Markdown file loaded');\n          }\n        }\n      } catch (err) {\n        log.warn({ file: filename, err }, 'Failed to load profile Markdown file');\n      }\n    } else if (REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET.has(filename)) {\n      const hint = join(profileDir, filename);\n      files.push({\n        name: filename,\n        content: `[MISSING] Create this file at: ${hint}`,\n        missing: true,\n        path: resolve(hint),\n      });\n      missingCount++;\n      log.debug({ file: filename }, 'Profile Markdown file missing');\n    }\n  }\n\n  log.debug({ loaded: loadedCount, missing: missingCount, profileDir }, 'Profile Markdown scan done');\n\n  return files;\n}\n\n// =============================================================================\n// Message content helpers\n// =============================================================================\n\n/**\n * Extract text content from agent message content array\n */\nexport function extractTextContent(\n  content: Array<{ type: string; text?: string }>\n): string {\n  return content\n    .filter((c) => c.type === 'text')\n    .map((c) => c.text || '')\n    .join('');\n}\n\nconst THINKING_BLOCK_TYPES = new Set(['thinking', 'thinking_delta', 'redacted_thinking']);\n\n/**\n * Concatenate thinking / reasoning content blocks from assistant message.content.\n * pi-ai may use `thinking` or `text` on `type: \"thinking\"` blocks.\n */\nexport function extractThinkingContent(\n  content: Array<{ type: string; thinking?: string; text?: string }> | undefined\n): string {\n  if (!Array.isArray(content)) return '';\n  return content\n    .filter((c) => THINKING_BLOCK_TYPES.has(c.type))\n    .map((c) => (typeof c.thinking === 'string' ? c.thinking : c.text) || '')\n    .join('');\n}\n\n/**\n * Extended thinking on the assistant message (e.g. Anthropic reasoning / pi-ai reasoning_details).\n */\nexport function extractThinkingFromAssistantMessage(\n  message: { role?: string; reasoning_details?: { thinking?: string } } | undefined\n): string {\n  if (!message || message.role !== 'assistant') return '';\n  const t = message.reasoning_details?.thinking;\n  return typeof t === 'string' ? t : '';\n}\n"],"mappings":"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"}

package/dist/src/agent/embedded/run-for-session.js

@@ -1,3 +1,4 @@
+import { resolveEffectiveAgentManifestForSession } from "../../config/agent-profile.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
@@ -74,7 +75,9 @@ async function runEmbeddedTurnForSession(params) {
 }
 async function maybeAutoCompactBeforeTurn(opts) {
 	const { sessionKey, sessionStore, agentManager, model, config, onEvent } = opts;
-	if (((config?.agents)?.defaults?.compaction)?.enabled === false) return;
+	if (config) try {
+		if (resolveEffectiveAgentManifestForSession(config, sessionKey).memory.retention?.compaction === false) return;
+	} catch {}
 	const contextWindow = model.contextWindow ?? 128e3;
 	const messages = await sessionStore.load(sessionKey);
 	const prep = sessionStore.prepareCompaction(sessionKey, messages, contextWindow);

package/dist/src/agent/embedded/run-for-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-for-session.js","names":[],"sources":["../../../../src/agent/embedded/run-for-session.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { runXopcEmbeddedTurn } from './run-turn.js';\nimport type { EmbeddedStreamEvent, RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport { applyStartupContextToUserMessage } from '../reply/apply-turn-user-enrichment.js';\nimport {\n  mergeTurnTools,\n  resolveEmbeddedMcpToolsForTurn,\n} from '../mcp/resolve-embedded-mcp-tools.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('EmbeddedTurnForSession');\n\nexport type RunEmbeddedForSessionParams = {\n  sessionKey: string;\n  runId?: string;\n  userMessage: AgentMessage;\n  llmImages?: import('@earendil-works/pi-ai').ImageContent[];\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n  thinkingOverride?: string | null;\n  abortSignal?: AbortSignal;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n  getConfig?: () => Config | undefined;\n  beforeTurn?: () => void | Promise<void>;\n  afterTurn?: (userPlain: string) => void | Promise<void>;\n  startupAction?: 'new' | 'reset';\n  forceStartupContext?: boolean;\n  applyStartupContext?: boolean;\n  /** When true, dispose session MCP runtime after this turn completes. */\n  cleanupBundleMcpOnRunEnd?: boolean;\n};\n\nexport async function runEmbeddedTurnForSession(\n  params: RunEmbeddedForSessionParams,\n): Promise<RunXopcEmbeddedTurnResult> {\n  const { sessionKey, agentManager, modelManager, sessionStore, userMessage } = params;\n  const runId = params.runId ?? crypto.randomUUID();\n\n  await params.beforeTurn?.();\n\n  const agent = (agentManager as any).getOrCreateAgent(sessionKey) as {\n    state: {\n      tools: RunXopcEmbeddedTurnParams['tools'];\n      systemPrompt?: string;\n      thinkingLevel?: ThinkingLevel;\n    };\n  };\n  const mm = modelManager as any;\n  await mm.applyModelForSession(agent, sessionKey);\n\n  const modelRef = String(mm.getModelForSession(sessionKey));\n  agentManager.setModelForSession(sessionKey, modelRef);\n  const model = mm.getResolvedModelForSession(sessionKey) as RunXopcEmbeddedTurnParams['model'];\n  const tools = agent.state.tools;\n  const systemPrompt = agent.state.systemPrompt ?? '';\n  const thinkingLevel = (params.thinkingOverride as ThinkingLevel | undefined) ?? agent.state.thinkingLevel;\n  const workspaceDir = agentManager.getResolvedWorkspaceForSession(sessionKey);\n  const config = params.getConfig?.();\n\n  // --- Pre-turn automatic compaction ---\n  await maybeAutoCompactBeforeTurn({\n    sessionKey,\n    sessionStore,\n    agentManager,\n    model,\n    config,\n    onEvent: params.onEvent,\n  });\n\n  let userMessageForTurn = userMessage;\n  if (params.applyStartupContext !== false) {\n    userMessageForTurn = await applyStartupContextToUserMessage({\n      userMessage,\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      sessionStore,\n      startupAction: params.startupAction,\n      force: params.forceStartupContext,\n    });\n  }\n\n  const result = await (async () => {\n    const mcpResolved = await resolveEmbeddedMcpToolsForTurn({\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      baseTools: tools,\n      cleanupOnTurnEnd: params.cleanupBundleMcpOnRunEnd === true,\n    });\n    const turnTools = mergeTurnTools(tools, mcpResolved.tools);\n    try {\n      return await runXopcEmbeddedTurn({\n        sessionKey,\n        runId,\n        userMessage: userMessageForTurn,\n        images: params.llmImages,\n        model,\n        modelRef,\n        tools: turnTools,\n        systemPrompt,\n        thinkingLevel,\n        workspaceDir,\n        sessionStore,\n        timeoutMs: resolveAgentTurnTimeoutMs(config),\n        abortSignal: params.abortSignal,\n        onEvent: params.onEvent,\n      });\n    } finally {\n      await mcpResolved.dispose().catch(() => {});\n    }\n  })();\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Pre-turn automatic compaction\n// ---------------------------------------------------------------------------\n\nasync function maybeAutoCompactBeforeTurn(opts: {\n  sessionKey: string;\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  model: RunXopcEmbeddedTurnParams['model'];\n  config: Config | undefined;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n}): Promise<void> {\n  const { sessionKey, sessionStore, agentManager, model, config, onEvent } = opts;\n  const compaction = (config?.agents as unknown as {\n    defaults?: { compaction?: { enabled?: boolean } };\n  } | undefined)?.defaults?.compaction;\n  if (compaction?.enabled === false) {\n    return;\n  }\n\n  const contextWindow = (model as { contextWindow?: number }).contextWindow ?? 128_000;\n  const messages = await sessionStore.load(sessionKey);\n  const prep = sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n\n  if (!prep.needsCompaction) {\n    return;\n  }\n\n  log.info(\n    { sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent, contextWindow },\n    'Pre-turn auto-compaction triggered',\n  );\n\n  onEvent?.({\n    type: 'compaction',\n    status: 'started',\n    tokensBefore: prep.stats?.usagePercent != null\n      ? Math.round((prep.stats.usagePercent as number) * contextWindow)\n      : undefined,\n  });\n\n  try {\n    const result = await sessionStore.compact(sessionKey, messages, contextWindow);\n\n    if (result.compacted) {\n      // Evict the cached agent so the next turn reloads from the compacted transcript\n      agentManager.removeAgent(sessionKey);\n\n      log.info(\n        { sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter },\n        'Pre-turn auto-compaction completed',\n      );\n\n      onEvent?.({\n        type: 'compaction',\n        status: 'completed',\n        tokensBefore: result.tokensBefore,\n        tokensAfter: result.tokensAfter,\n        summary: result.summary.length > 200 ? `${result.summary.slice(0, 200)}…` : result.summary,\n      });\n    } else {\n      onEvent?.({ type: 'compaction', status: 'skipped' });\n    }\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, sessionKey }, `Pre-turn auto-compaction failed: ${errorMessage}`);\n    // Non-fatal: let the turn proceed even if compaction fails\n    onEvent?.({ type: 'compaction', status: 'skipped' });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"run-for-session.js","names":[],"sources":["../../../../src/agent/embedded/run-for-session.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { runXopcEmbeddedTurn } from './run-turn.js';\nimport type { EmbeddedStreamEvent, RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport { applyStartupContextToUserMessage } from '../reply/apply-turn-user-enrichment.js';\nimport { resolveEffectiveAgentManifestForSession } from '../../config/agent-profile.js';\nimport {\n  mergeTurnTools,\n  resolveEmbeddedMcpToolsForTurn,\n} from '../mcp/resolve-embedded-mcp-tools.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('EmbeddedTurnForSession');\n\nexport type RunEmbeddedForSessionParams = {\n  sessionKey: string;\n  runId?: string;\n  userMessage: AgentMessage;\n  llmImages?: import('@earendil-works/pi-ai').ImageContent[];\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n  thinkingOverride?: string | null;\n  abortSignal?: AbortSignal;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n  getConfig?: () => Config | undefined;\n  beforeTurn?: () => void | Promise<void>;\n  afterTurn?: (userPlain: string) => void | Promise<void>;\n  startupAction?: 'new' | 'reset';\n  forceStartupContext?: boolean;\n  applyStartupContext?: boolean;\n  /** When true, dispose session MCP runtime after this turn completes. */\n  cleanupBundleMcpOnRunEnd?: boolean;\n};\n\nexport async function runEmbeddedTurnForSession(\n  params: RunEmbeddedForSessionParams,\n): Promise<RunXopcEmbeddedTurnResult> {\n  const { sessionKey, agentManager, modelManager, sessionStore, userMessage } = params;\n  const runId = params.runId ?? crypto.randomUUID();\n\n  await params.beforeTurn?.();\n\n  const agent = (agentManager as any).getOrCreateAgent(sessionKey) as {\n    state: {\n      tools: RunXopcEmbeddedTurnParams['tools'];\n      systemPrompt?: string;\n      thinkingLevel?: ThinkingLevel;\n    };\n  };\n  const mm = modelManager as any;\n  await mm.applyModelForSession(agent, sessionKey);\n\n  const modelRef = String(mm.getModelForSession(sessionKey));\n  agentManager.setModelForSession(sessionKey, modelRef);\n  const model = mm.getResolvedModelForSession(sessionKey) as RunXopcEmbeddedTurnParams['model'];\n  const tools = agent.state.tools;\n  const systemPrompt = agent.state.systemPrompt ?? '';\n  const thinkingLevel = (params.thinkingOverride as ThinkingLevel | undefined) ?? agent.state.thinkingLevel;\n  const workspaceDir = agentManager.getResolvedWorkspaceForSession(sessionKey);\n  const config = params.getConfig?.();\n\n  // --- Pre-turn automatic compaction ---\n  await maybeAutoCompactBeforeTurn({\n    sessionKey,\n    sessionStore,\n    agentManager,\n    model,\n    config,\n    onEvent: params.onEvent,\n  });\n\n  let userMessageForTurn = userMessage;\n  if (params.applyStartupContext !== false) {\n    userMessageForTurn = await applyStartupContextToUserMessage({\n      userMessage,\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      sessionStore,\n      startupAction: params.startupAction,\n      force: params.forceStartupContext,\n    });\n  }\n\n  const result = await (async () => {\n    const mcpResolved = await resolveEmbeddedMcpToolsForTurn({\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      baseTools: tools,\n      cleanupOnTurnEnd: params.cleanupBundleMcpOnRunEnd === true,\n    });\n    const turnTools = mergeTurnTools(tools, mcpResolved.tools);\n    try {\n      return await runXopcEmbeddedTurn({\n        sessionKey,\n        runId,\n        userMessage: userMessageForTurn,\n        images: params.llmImages,\n        model,\n        modelRef,\n        tools: turnTools,\n        systemPrompt,\n        thinkingLevel,\n        workspaceDir,\n        sessionStore,\n        timeoutMs: resolveAgentTurnTimeoutMs(config),\n        abortSignal: params.abortSignal,\n        onEvent: params.onEvent,\n      });\n    } finally {\n      await mcpResolved.dispose().catch(() => {});\n    }\n  })();\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Pre-turn automatic compaction\n// ---------------------------------------------------------------------------\n\nasync function maybeAutoCompactBeforeTurn(opts: {\n  sessionKey: string;\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  model: RunXopcEmbeddedTurnParams['model'];\n  config: Config | undefined;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n}): Promise<void> {\n  const { sessionKey, sessionStore, agentManager, model, config, onEvent } = opts;\n  if (config) {\n    try {\n      const manifest = resolveEffectiveAgentManifestForSession(config, sessionKey);\n      if (manifest.memory.retention?.compaction === false) {\n        return;\n      }\n    } catch {\n      // Keep compaction enabled when manifest resolution is unavailable.\n    }\n  }\n\n  const contextWindow = (model as { contextWindow?: number }).contextWindow ?? 128_000;\n  const messages = await sessionStore.load(sessionKey);\n  const prep = sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n\n  if (!prep.needsCompaction) {\n    return;\n  }\n\n  log.info(\n    { sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent, contextWindow },\n    'Pre-turn auto-compaction triggered',\n  );\n\n  onEvent?.({\n    type: 'compaction',\n    status: 'started',\n    tokensBefore: prep.stats?.usagePercent != null\n      ? Math.round((prep.stats.usagePercent as number) * contextWindow)\n      : undefined,\n  });\n\n  try {\n    const result = await sessionStore.compact(sessionKey, messages, contextWindow);\n\n    if (result.compacted) {\n      // Evict the cached agent so the next turn reloads from the compacted transcript\n      agentManager.removeAgent(sessionKey);\n\n      log.info(\n        { sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter },\n        'Pre-turn auto-compaction completed',\n      );\n\n      onEvent?.({\n        type: 'compaction',\n        status: 'completed',\n        tokensBefore: result.tokensBefore,\n        tokensAfter: result.tokensAfter,\n        summary: result.summary.length > 200 ? `${result.summary.slice(0, 200)}…` : result.summary,\n      });\n    } else {\n      onEvent?.({ type: 'compaction', status: 'skipped' });\n    }\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, sessionKey }, `Pre-turn auto-compaction failed: ${errorMessage}`);\n    // Non-fatal: let the turn proceed even if compaction fails\n    onEvent?.({ type: 'compaction', status: 'skipped' });\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/fallback/candidates.js

@@ -3,16 +3,15 @@ import { normalizeProviderId, parseModelRef as parseModelRef$1 } from "../models
 //#region src/agent/fallback/candidates.ts
 init_providers();
 function getDefaultModelParts(config) {
-	const parts = getDefaultModelSync(config).split("/");
+	const defaultModel = getDefaultModelSync(config);
+	if (!defaultModel) return null;
+	const parts = defaultModel.split("/");
+	if (!parts[0] || !parts[1]) return null;
 	return {
-		provider: parts[0] || "anthropic",
-		model: parts[1] || "claude-sonnet-4-5"
+		provider: parts[0],
+		model: parts[1]
 	};
 }
-function getConfiguredFallbackRefs(config) {
-	const legacyModel = (config?.agents)?.defaults?.model;
-	if (legacyModel && typeof legacyModel === "object" && Array.isArray(legacyModel.fallbacks)) return legacyModel.fallbacks.filter((value) => typeof value === "string");
-}
 /**
 * Parse model reference string into provider/model parts.
 * Uses the unified implementation from selection.ts.
@@ -28,11 +27,11 @@ function parseModelRef(raw, defaultProvider) {
 function resolveFallbackCandidates(params) {
 	const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;
 	const primaryRef = getDefaultModelSync(cfg);
-	const fallbacks = fallbacksOverride ?? getConfiguredFallbackRefs(cfg);
+	const fallbacks = fallbacksOverride;
 	const defaultParts = getDefaultModelParts(cfg);
 	const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));
-	const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;
-	const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;
+	const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts?.provider || "";
+	const model = inputModel.trim() || primaryResolved?.model || defaultParts?.model || "";
 	const candidates = [];
 	const seen = /* @__PURE__ */ new Set();
 	const addCandidate = (c) => {
@@ -42,7 +41,7 @@ function resolveFallbackCandidates(params) {
 		seen.add(key);
 		candidates.push(c);
 	};
-	addCandidate({
+	if (provider && model) addCandidate({
 		provider,
 		model
 	});

package/dist/src/agent/fallback/candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\n// Get default model dynamically\nfunction getDefaultModelParts(config?: Config): { provider: string; model: string } {\n  const defaultModel = getDefaultModelSync(config);\n  const parts = defaultModel.split('/');\n  return {\n    provider: parts[0] || 'anthropic',\n    model: parts[1] || 'claude-sonnet-4-5',\n  };\n}\n\nfunction getConfiguredFallbackRefs(config?: Config): string[] | undefined {\n  const legacyModel = (config?.agents as unknown as {\n    defaults?: { model?: { fallbacks?: unknown } };\n  } | undefined)?.defaults?.model;\n  if (\n    legacyModel &&\n    typeof legacyModel === 'object' &&\n    Array.isArray(legacyModel.fallbacks)\n  ) {\n    return legacyModel.fallbacks.filter((value): value is string => typeof value === 'string');\n  }\n  return undefined;\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const primaryRef = getDefaultModelSync(cfg);\n  const fallbacks = fallbacksOverride ?? getConfiguredFallbackRefs(cfg);\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  addCandidate({ provider, model });\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAmBpE,SAAS,qBAAqB,QAAsD;CAElF,MAAM,QADe,oBAAoB,OACf,CAAC,MAAM,IAAI;AACrC,QAAO;EACL,UAAU,MAAM,MAAM;EACtB,OAAO,MAAM,MAAM;EACpB;;AAGH,SAAS,0BAA0B,QAAuC;CACxE,MAAM,eAAe,QAAQ,SAEb,UAAU;AAC1B,KACE,eACA,OAAO,gBAAgB,YACvB,MAAM,QAAQ,YAAY,UAAU,CAEpC,QAAO,YAAY,UAAU,QAAQ,UAA2B,OAAO,UAAU,SAAS;;;;;;AAS9F,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,aAAa,oBAAoB,IAAI;CAC3C,MAAM,YAAY,qBAAqB,0BAA0B,IAAI;CAErE,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,aAAa;CACnF,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,aAAa;CAE1E,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,cAAa;EAAE;EAAU;EAAO,CAAC;AAEjC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}
+{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\nfunction getDefaultModelParts(config?: Config): ModelCandidate | null {\n  const defaultModel = getDefaultModelSync(config);\n  if (!defaultModel) return null;\n  const parts = defaultModel.split('/');\n  if (!parts[0] || !parts[1]) return null;\n  return { provider: parts[0], model: parts[1] };\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const primaryRef = getDefaultModelSync(cfg);\n  const fallbacks = fallbacksOverride;\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts?.provider || '';\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts?.model || '';\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  if (provider && model) {\n    addCandidate({ provider, model });\n  }\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAkBpE,SAAS,qBAAqB,QAAwC;CACpE,MAAM,eAAe,oBAAoB,OAAO;AAChD,KAAI,CAAC,aAAc,QAAO;CAC1B,MAAM,QAAQ,aAAa,MAAM,IAAI;AACrC,KAAI,CAAC,MAAM,MAAM,CAAC,MAAM,GAAI,QAAO;AACnC,QAAO;EAAE,UAAU,MAAM;EAAI,OAAO,MAAM;EAAI;;;;;;AAOhD,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,aAAa,oBAAoB,IAAI;CAC3C,MAAM,YAAY;CAElB,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,cAAc,YAAY;CAChG,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,cAAc,SAAS;CAEpF,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,KAAI,YAAY,MACd,cAAa;EAAE;EAAU;EAAO,CAAC;AAGnC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}

package/dist/src/agent/memory/builtin-memory-store.d.ts

@@ -1,5 +1,5 @@
 /**
- * Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.
+ * Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.
  * Snapshot for system prompt is captured at load time and not mutated until next load.
  */
 import type { MemorySnapshot, MemoryStoreConfig } from './types.js';
@@ -10,10 +10,12 @@ export declare class BuiltinMemoryStore {
     private userEntries;
     private snapshot;
     constructor(config: MemoryStoreConfig);
-    /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */
+    /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */
     isUserProfileEnabled(): boolean;
     /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */
     get memoriesDir(): string;
+    /** Global user memory file (`~/.xopc/user/MEMORY.md`). */
+    get userMemoryPath(): string;
     /** Workspace whose MEMORY.md and daily notes participate in local memory search. */
     get workspaceDir(): string;
     pathFor(target: 'memory' | 'user'): string;

package/dist/src/agent/memory/builtin-memory-store.js

@@ -1,10 +1,10 @@
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import lockfile from "proper-lockfile";
 //#region src/agent/memory/builtin-memory-store.ts
 /**
-* Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.
+* Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.
 * Snapshot for system prompt is captured at load time and not mutated until next load.
 */
 const MEMORY_ENTRY_DELIMITER = "\n§\n";
@@ -20,7 +20,7 @@ var BuiltinMemoryStore = class {
 	constructor(config) {
 		this.config = config;
 	}
-	/** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */
+	/** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */
 	isUserProfileEnabled() {
 		return this.config.userProfileEnabled !== false;
 	}
@@ -28,12 +28,16 @@ var BuiltinMemoryStore = class {
 	get memoriesDir() {
 		return this.config.memoriesDir;
 	}
+	/** Global user memory file (`~/.xopc/user/MEMORY.md`). */
+	get userMemoryPath() {
+		return this.config.userMemoryPath;
+	}
 	/** Workspace whose MEMORY.md and daily notes participate in local memory search. */
 	get workspaceDir() {
 		return this.config.workspaceDir;
 	}
 	pathFor(target) {
-		return join(this.memoriesDir, target === "memory" ? "MEMORY.md" : "USER.md");
+		return target === "memory" ? join(this.memoriesDir, "MEMORY.md") : this.userMemoryPath;
 	}
 	/**
 	* Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).
@@ -41,7 +45,7 @@ var BuiltinMemoryStore = class {
 	loadFromDiskSync() {
 		mkdirSync(this.memoriesDir, { recursive: true });
 		this.memoryEntries = this.parseFileContent(this.readPathSync(join(this.memoriesDir, "MEMORY.md")));
-		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(join(this.memoriesDir, "USER.md")));
+		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(this.userMemoryPath));
 		this.memoryEntries = dedupePreserveOrder(this.memoryEntries);
 		this.userEntries = dedupePreserveOrder(this.userEntries);
 		this.snapshot = {
@@ -185,7 +189,7 @@ var BuiltinMemoryStore = class {
 	}
 	async withFileLock(target, fn) {
 		const filePath = this.pathFor(target);
-		await mkdir(this.memoriesDir, { recursive: true });
+		await mkdir(dirname(filePath), { recursive: true });
 		if (!existsSync(filePath)) await writeFile(filePath, "", "utf-8");
 		await lockfile.lock(filePath, {
 			retries: 3,
@@ -214,6 +218,7 @@ var BuiltinMemoryStore = class {
 		const filePath = this.pathFor(target);
 		const content = entries.join(MEMORY_ENTRY_DELIMITER);
 		const tmpPath = `${filePath}.tmp.${Date.now()}`;
+		await mkdir(dirname(filePath), { recursive: true });
 		await writeFile(tmpPath, content, "utf-8");
 		await rename(tmpPath, filePath);
 	}