@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/agent/background-review/settings.d.ts

@@ -7,4 +7,4 @@ export interface BackgroundReviewSettings {
     maxHistoryMessages: number;
     maxDurationMs: number;
 }
-export declare function resolveBackgroundReviewSettings(config: Config | undefined): BackgroundReviewSettings;
+export declare function resolveBackgroundReviewSettings(_config: Config | undefined): BackgroundReviewSettings;

package/dist/src/agent/background-review/settings.js

@@ -1,13 +1,13 @@
 //#region src/agent/background-review/settings.ts
-function resolveBackgroundReviewSettings(config) {
-	const br = config?.agents?.defaults?.backgroundReview;
+function resolveBackgroundReviewSettings(_config) {
+	const numberOrDefault = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallback;
 	return {
-		enabled: br?.enabled === true,
-		memoryNudgeInterval: br?.memoryNudgeInterval ?? 10,
-		skillNudgeInterval: br?.skillNudgeInterval ?? 10,
-		maxToolRounds: br?.maxToolRounds ?? 8,
-		maxHistoryMessages: br?.maxHistoryMessages ?? 80,
-		maxDurationMs: br?.maxDurationMs ?? 12e4
+		enabled: false,
+		memoryNudgeInterval: numberOrDefault(void 0, 10),
+		skillNudgeInterval: numberOrDefault(void 0, 10),
+		maxToolRounds: numberOrDefault(void 0, 8),
+		maxHistoryMessages: numberOrDefault(void 0, 80),
+		maxDurationMs: numberOrDefault(void 0, 12e4)
 	};
 }
 //#endregion

package/dist/src/agent/background-review/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","names":[],"sources":["../../../../src/agent/background-review/settings.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\n\nexport interface BackgroundReviewSettings {\n  enabled: boolean;\n  memoryNudgeInterval: number;\n  skillNudgeInterval: number;\n  maxToolRounds: number;\n  maxHistoryMessages: number;\n  maxDurationMs: number;\n}\n\nexport function resolveBackgroundReviewSettings(config: Config | undefined): BackgroundReviewSettings {\n  const br = config?.agents?.defaults?.backgroundReview;\n  return {\n    enabled: br?.enabled === true,\n    memoryNudgeInterval: br?.memoryNudgeInterval ?? 10,\n    skillNudgeInterval: br?.skillNudgeInterval ?? 10,\n    maxToolRounds: br?.maxToolRounds ?? 8,\n    maxHistoryMessages: br?.maxHistoryMessages ?? 80,\n    maxDurationMs: br?.maxDurationMs ?? 120_000,\n  };\n}\n"],"mappings":";AAWA,SAAgB,gCAAgC,QAAsD;CACpG,MAAM,KAAK,QAAQ,QAAQ,UAAU;AACrC,QAAO;EACL,SAAS,IAAI,YAAY;EACzB,qBAAqB,IAAI,uBAAuB;EAChD,oBAAoB,IAAI,sBAAsB;EAC9C,eAAe,IAAI,iBAAiB;EACpC,oBAAoB,IAAI,sBAAsB;EAC9C,eAAe,IAAI,iBAAiB;EACrC"}
+{"version":3,"file":"settings.js","names":[],"sources":["../../../../src/agent/background-review/settings.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\n\nexport interface BackgroundReviewSettings {\n  enabled: boolean;\n  memoryNudgeInterval: number;\n  skillNudgeInterval: number;\n  maxToolRounds: number;\n  maxHistoryMessages: number;\n  maxDurationMs: number;\n}\n\nexport function resolveBackgroundReviewSettings(_config: Config | undefined): BackgroundReviewSettings {\n  const numberOrDefault = (value: unknown, fallback: number): number =>\n    typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallback;\n\n  return {\n    enabled: false,\n    memoryNudgeInterval: numberOrDefault(undefined, 10),\n    skillNudgeInterval: numberOrDefault(undefined, 10),\n    maxToolRounds: numberOrDefault(undefined, 8),\n    maxHistoryMessages: numberOrDefault(undefined, 80),\n    maxDurationMs: numberOrDefault(undefined, 120_000),\n  };\n}\n"],"mappings":";AAWA,SAAgB,gCAAgC,SAAuD;CACrG,MAAM,mBAAmB,OAAgB,aACvC,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM,IAAI,QAAQ,IAAI,KAAK,MAAM,MAAM,GAAG;AAEzF,QAAO;EACL,SAAS;EACT,qBAAqB,gBAAgB,KAAA,GAAW,GAAG;EACnD,oBAAoB,gBAAgB,KAAA,GAAW,GAAG;EAClD,eAAe,gBAAgB,KAAA,GAAW,EAAE;EAC5C,oBAAoB,gBAAgB,KAAA,GAAW,GAAG;EAClD,eAAe,gBAAgB,KAAA,GAAW,KAAQ;EACnD"}

package/dist/src/agent/bootstrap/bootstrap-cache.d.ts

@@ -3,6 +3,7 @@ export declare function wasBootstrapContextInjected(sessionKey: string): boolean
 export declare function markBootstrapContextInjected(sessionKey: string): void;
 export declare function getOrLoadBootstrapFiles(params: {
     profileDir: string;
+    userProfilePath?: string;
     sessionKey: string;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function clearBootstrapSnapshot(sessionKey: string): void;

package/dist/src/agent/bootstrap/bootstrap-cache.js

@@ -1,4 +1,4 @@
-import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
+import { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from "./load-bootstrap-files.js";
 //#region src/agent/bootstrap/bootstrap-cache.ts
 const cache = /* @__PURE__ */ new Map();
 const bootstrapContextInjected = /* @__PURE__ */ new Set();
@@ -17,10 +17,11 @@ function markBootstrapContextInjected(sessionKey) {
 }
 async function getOrLoadBootstrapFiles(params) {
 	const existing = cache.get(params.sessionKey);
-	const files = loadProfileBootstrapFiles(params.profileDir);
-	if (existing && existing.profileDir === params.profileDir && bootstrapFilesEqual(existing.files, files)) return existing.files;
+	const files = [...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)];
+	if (existing && existing.profileDir === params.profileDir && existing.userProfilePath === params.userProfilePath && bootstrapFilesEqual(existing.files, files)) return existing.files;
 	cache.set(params.sessionKey, {
 		profileDir: params.profileDir,
+		userProfilePath: params.userProfilePath,
 		files
 	});
 	return files;

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

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-cache.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-cache.ts"],"sourcesContent":["import { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\ntype BootstrapSnapshot = {\n  profileDir: string;\n  files: WorkspaceBootstrapFile[];\n};\n\nconst cache = new Map<string, BootstrapSnapshot>();\nconst bootstrapContextInjected = new Set<string>();\n\nfunction bootstrapFilesEqual(\n  previous: WorkspaceBootstrapFile[],\n  next: WorkspaceBootstrapFile[],\n): boolean {\n  if (previous.length !== next.length) {\n    return false;\n  }\n  return previous.every((file, index) => {\n    const updated = next[index];\n    return (\n      updated !== undefined &&\n      file.name === updated.name &&\n      file.path === updated.path &&\n      file.content === updated.content &&\n      file.missing === updated.missing\n    );\n  });\n}\n\nexport function wasBootstrapContextInjected(sessionKey: string): boolean {\n  return bootstrapContextInjected.has(sessionKey);\n}\n\nexport function markBootstrapContextInjected(sessionKey: string): void {\n  bootstrapContextInjected.add(sessionKey);\n}\n\nexport async function getOrLoadBootstrapFiles(params: {\n  profileDir: string;\n  sessionKey: string;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const existing = cache.get(params.sessionKey);\n  const files = loadProfileBootstrapFiles(params.profileDir);\n  if (existing && existing.profileDir === params.profileDir && bootstrapFilesEqual(existing.files, files)) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, {\n    profileDir: params.profileDir,\n    files,\n  });\n  return files;\n}\n\nexport function clearBootstrapSnapshot(sessionKey: string): void {\n  cache.delete(sessionKey);\n  bootstrapContextInjected.delete(sessionKey);\n}\n\nexport function clearAllBootstrapSnapshots(): void {\n  cache.clear();\n  bootstrapContextInjected.clear();\n}\n"],"mappings":";;AAQA,MAAM,wBAAQ,IAAI,KAAgC;AAClD,MAAM,2CAA2B,IAAI,KAAa;AAElD,SAAS,oBACP,UACA,MACS;AACT,KAAI,SAAS,WAAW,KAAK,OAC3B,QAAO;AAET,QAAO,SAAS,OAAO,MAAM,UAAU;EACrC,MAAM,UAAU,KAAK;AACrB,SACE,YAAY,KAAA,KACZ,KAAK,SAAS,QAAQ,QACtB,KAAK,SAAS,QAAQ,QACtB,KAAK,YAAY,QAAQ,WACzB,KAAK,YAAY,QAAQ;GAE3B;;AAGJ,SAAgB,4BAA4B,YAA6B;AACvE,QAAO,yBAAyB,IAAI,WAAW;;AAGjD,SAAgB,6BAA6B,YAA0B;AACrE,0BAAyB,IAAI,WAAW;;AAG1C,eAAsB,wBAAwB,QAGR;CACpC,MAAM,WAAW,MAAM,IAAI,OAAO,WAAW;CAC7C,MAAM,QAAQ,0BAA0B,OAAO,WAAW;AAC1D,KAAI,YAAY,SAAS,eAAe,OAAO,cAAc,oBAAoB,SAAS,OAAO,MAAM,CACrG,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAC3B,YAAY,OAAO;EACnB;EACD,CAAC;AACF,QAAO;;AAGT,SAAgB,uBAAuB,YAA0B;AAC/D,OAAM,OAAO,WAAW;AACxB,0BAAyB,OAAO,WAAW;;AAG7C,SAAgB,6BAAmC;AACjD,OAAM,OAAO;AACb,0BAAyB,OAAO"}
+{"version":3,"file":"bootstrap-cache.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-cache.ts"],"sourcesContent":["import { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from './load-bootstrap-files.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\ntype BootstrapSnapshot = {\n  profileDir: string;\n  userProfilePath?: string;\n  files: WorkspaceBootstrapFile[];\n};\n\nconst cache = new Map<string, BootstrapSnapshot>();\nconst bootstrapContextInjected = new Set<string>();\n\nfunction bootstrapFilesEqual(\n  previous: WorkspaceBootstrapFile[],\n  next: WorkspaceBootstrapFile[],\n): boolean {\n  if (previous.length !== next.length) {\n    return false;\n  }\n  return previous.every((file, index) => {\n    const updated = next[index];\n    return (\n      updated !== undefined &&\n      file.name === updated.name &&\n      file.path === updated.path &&\n      file.content === updated.content &&\n      file.missing === updated.missing\n    );\n  });\n}\n\nexport function wasBootstrapContextInjected(sessionKey: string): boolean {\n  return bootstrapContextInjected.has(sessionKey);\n}\n\nexport function markBootstrapContextInjected(sessionKey: string): void {\n  bootstrapContextInjected.add(sessionKey);\n}\n\nexport async function getOrLoadBootstrapFiles(params: {\n  profileDir: string;\n  userProfilePath?: string;\n  sessionKey: string;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const existing = cache.get(params.sessionKey);\n  const files = [\n    ...loadUserProfileBootstrapFile(params.userProfilePath),\n    ...loadProfileBootstrapFiles(params.profileDir),\n  ];\n  if (\n    existing &&\n    existing.profileDir === params.profileDir &&\n    existing.userProfilePath === params.userProfilePath &&\n    bootstrapFilesEqual(existing.files, files)\n  ) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, {\n    profileDir: params.profileDir,\n    userProfilePath: params.userProfilePath,\n    files,\n  });\n  return files;\n}\n\nexport function clearBootstrapSnapshot(sessionKey: string): void {\n  cache.delete(sessionKey);\n  bootstrapContextInjected.delete(sessionKey);\n}\n\nexport function clearAllBootstrapSnapshots(): void {\n  cache.clear();\n  bootstrapContextInjected.clear();\n}\n"],"mappings":";;AASA,MAAM,wBAAQ,IAAI,KAAgC;AAClD,MAAM,2CAA2B,IAAI,KAAa;AAElD,SAAS,oBACP,UACA,MACS;AACT,KAAI,SAAS,WAAW,KAAK,OAC3B,QAAO;AAET,QAAO,SAAS,OAAO,MAAM,UAAU;EACrC,MAAM,UAAU,KAAK;AACrB,SACE,YAAY,KAAA,KACZ,KAAK,SAAS,QAAQ,QACtB,KAAK,SAAS,QAAQ,QACtB,KAAK,YAAY,QAAQ,WACzB,KAAK,YAAY,QAAQ;GAE3B;;AAGJ,SAAgB,4BAA4B,YAA6B;AACvE,QAAO,yBAAyB,IAAI,WAAW;;AAGjD,SAAgB,6BAA6B,YAA0B;AACrE,0BAAyB,IAAI,WAAW;;AAG1C,eAAsB,wBAAwB,QAIR;CACpC,MAAM,WAAW,MAAM,IAAI,OAAO,WAAW;CAC7C,MAAM,QAAQ,CACZ,GAAG,6BAA6B,OAAO,gBAAgB,EACvD,GAAG,0BAA0B,OAAO,WAAW,CAChD;AACD,KACE,YACA,SAAS,eAAe,OAAO,cAC/B,SAAS,oBAAoB,OAAO,mBACpC,oBAAoB,SAAS,OAAO,MAAM,CAE1C,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAC3B,YAAY,OAAO;EACnB,iBAAiB,OAAO;EACxB;EACD,CAAC;AACF,QAAO;;AAGT,SAAgB,uBAAuB,YAA0B;AAC/D,OAAM,OAAO,WAAW;AACxB,0BAAyB,OAAO,WAAW;;AAG7C,SAAgB,6BAAmC;AACjD,OAAM,OAAO;AACb,0BAAyB,OAAO"}

package/dist/src/agent/bootstrap/bootstrap-context.d.ts

@@ -2,8 +2,8 @@ import type { Config } from '../../config/schema.js';
 import type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';
 export declare const DEFAULT_BOOTSTRAP_MAX_CHARS = 12000;
 export declare const DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS = 60000;
-export declare function resolveBootstrapMaxChars(config?: Config): number;
-export declare function resolveBootstrapTotalMaxChars(config?: Config): number;
+export declare function resolveBootstrapMaxChars(_config?: Config): number;
+export declare function resolveBootstrapTotalMaxChars(_config?: Config): number;
 export declare function buildBootstrapContextFiles(files: WorkspaceBootstrapFile[], opts?: {
     warn?: (message: string) => void;
     maxChars?: number;

package/dist/src/agent/bootstrap/bootstrap-context.js

@@ -4,11 +4,11 @@ const DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS = 6e4;
 const MIN_BOOTSTRAP_FILE_BUDGET_CHARS = 64;
 const BOOTSTRAP_HEAD_RATIO = .75;
 const BOOTSTRAP_TAIL_RATIO = .25;
-function resolveBootstrapMaxChars(config) {
-	return config?.agents?.defaults?.bootstrapMaxChars ?? 12e3;
+function resolveBootstrapMaxChars(_config) {
+	return DEFAULT_BOOTSTRAP_MAX_CHARS;
 }
-function resolveBootstrapTotalMaxChars(config) {
-	return config?.agents?.defaults?.bootstrapTotalMaxChars ?? 6e4;
+function resolveBootstrapTotalMaxChars(_config) {
+	return DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS;
 }
 function clampToBudget(content, budget) {
 	if (budget <= 0) return "";

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

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-context.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-context.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport const DEFAULT_BOOTSTRAP_MAX_CHARS = 12_000;\nexport const DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS = 60_000;\nconst MIN_BOOTSTRAP_FILE_BUDGET_CHARS = 64;\nconst BOOTSTRAP_HEAD_RATIO = 0.75;\nconst BOOTSTRAP_TAIL_RATIO = 0.25;\n\nexport function resolveBootstrapMaxChars(config?: Config): number {\n  return config?.agents?.defaults?.bootstrapMaxChars ?? DEFAULT_BOOTSTRAP_MAX_CHARS;\n}\n\nexport function resolveBootstrapTotalMaxChars(config?: Config): number {\n  return config?.agents?.defaults?.bootstrapTotalMaxChars ?? DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS;\n}\n\nfunction clampToBudget(content: string, budget: number): string {\n  if (budget <= 0) {\n    return '';\n  }\n  if (content.length <= budget) {\n    return content;\n  }\n  if (budget <= 3) {\n    return content.slice(0, budget);\n  }\n  return `${content.slice(0, budget - 1)}…`;\n}\n\nfunction trimBootstrapContent(\n  content: string,\n  fileName: string,\n  maxChars: number,\n): { content: string; truncated: boolean; originalLength: number; maxChars: number } {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return { content: trimmed, truncated: false, originalLength: trimmed.length, maxChars };\n  }\n\n  const markerTemplate = (head: number, tail: number) =>\n    `\\n\\n[...truncated ${fileName}: kept ${head}+${tail} of ${trimmed.length} chars...]\\n\\n`;\n  let headChars = Math.floor(maxChars * BOOTSTRAP_HEAD_RATIO);\n  let tailChars = Math.floor(maxChars * BOOTSTRAP_TAIL_RATIO);\n  let marker = markerTemplate(headChars, tailChars);\n  let renderedLength = headChars + tailChars + marker.length;\n\n  while (renderedLength > maxChars && (headChars > 0 || tailChars > 0)) {\n    if (tailChars >= headChars && tailChars > 0) {\n      tailChars -= 1;\n    } else if (headChars > 0) {\n      headChars -= 1;\n    } else {\n      break;\n    }\n    marker = markerTemplate(headChars, tailChars);\n    renderedLength = headChars + tailChars + marker.length;\n  }\n\n  const head = trimmed.slice(0, headChars);\n  const tail = tailChars > 0 ? trimmed.slice(-tailChars) : '';\n  const bounded = `${head}${marker}${tail}`;\n  return {\n    content: bounded.length > maxChars ? bounded.slice(0, maxChars) : bounded,\n    truncated: true,\n    originalLength: trimmed.length,\n    maxChars,\n  };\n}\n\nexport function buildBootstrapContextFiles(\n  files: WorkspaceBootstrapFile[],\n  opts?: { warn?: (message: string) => void; maxChars?: number; totalMaxChars?: number },\n): EmbeddedContextFile[] {\n  const maxChars = opts?.maxChars ?? DEFAULT_BOOTSTRAP_MAX_CHARS;\n  const totalMaxChars = Math.max(\n    1,\n    Math.floor(opts?.totalMaxChars ?? Math.max(maxChars, DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS)),\n  );\n  let remainingTotalChars = totalMaxChars;\n  const result: EmbeddedContextFile[] = [];\n\n  for (const file of files) {\n    if (remainingTotalChars <= 0) {\n      break;\n    }\n    const pathValue = file.path.trim();\n    if (!pathValue) {\n      opts?.warn?.(`skipping bootstrap file \"${file.name}\" — missing path`);\n      continue;\n    }\n\n    if (file.missing) {\n      const missingText = `[MISSING] Expected at: ${pathValue}`;\n      const capped = clampToBudget(missingText, remainingTotalChars);\n      if (!capped) {\n        break;\n      }\n      remainingTotalChars = Math.max(0, remainingTotalChars - capped.length);\n      result.push({ path: pathValue, content: capped });\n      continue;\n    }\n\n    if (remainingTotalChars < MIN_BOOTSTRAP_FILE_BUDGET_CHARS) {\n      opts?.warn?.(\n        `remaining bootstrap budget is ${remainingTotalChars} chars (<${MIN_BOOTSTRAP_FILE_BUDGET_CHARS}); skipping additional bootstrap files`,\n      );\n      break;\n    }\n\n    const fileMaxChars = Math.max(1, Math.min(maxChars, remainingTotalChars));\n    const trimmed = trimBootstrapContent(file.content ?? '', file.name, fileMaxChars);\n    const contentWithinBudget = clampToBudget(trimmed.content, remainingTotalChars);\n    if (!contentWithinBudget) {\n      continue;\n    }\n    if (trimmed.truncated || contentWithinBudget.length < trimmed.content.length) {\n      opts?.warn?.(\n        `profile bootstrap file ${file.name} is ${trimmed.originalLength} chars (limit ${trimmed.maxChars}); truncating in injected context`,\n      );\n    }\n    remainingTotalChars = Math.max(0, remainingTotalChars - contentWithinBudget.length);\n    result.push({ path: pathValue, content: contentWithinBudget });\n  }\n\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"bootstrap-context.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-context.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport const DEFAULT_BOOTSTRAP_MAX_CHARS = 12_000;\nexport const DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS = 60_000;\nconst MIN_BOOTSTRAP_FILE_BUDGET_CHARS = 64;\nconst BOOTSTRAP_HEAD_RATIO = 0.75;\nconst BOOTSTRAP_TAIL_RATIO = 0.25;\n\nexport function resolveBootstrapMaxChars(_config?: Config): number {\n  return DEFAULT_BOOTSTRAP_MAX_CHARS;\n}\n\nexport function resolveBootstrapTotalMaxChars(_config?: Config): number {\n  return DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS;\n}\n\nfunction clampToBudget(content: string, budget: number): string {\n  if (budget <= 0) {\n    return '';\n  }\n  if (content.length <= budget) {\n    return content;\n  }\n  if (budget <= 3) {\n    return content.slice(0, budget);\n  }\n  return `${content.slice(0, budget - 1)}…`;\n}\n\nfunction trimBootstrapContent(\n  content: string,\n  fileName: string,\n  maxChars: number,\n): { content: string; truncated: boolean; originalLength: number; maxChars: number } {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return { content: trimmed, truncated: false, originalLength: trimmed.length, maxChars };\n  }\n\n  const markerTemplate = (head: number, tail: number) =>\n    `\\n\\n[...truncated ${fileName}: kept ${head}+${tail} of ${trimmed.length} chars...]\\n\\n`;\n  let headChars = Math.floor(maxChars * BOOTSTRAP_HEAD_RATIO);\n  let tailChars = Math.floor(maxChars * BOOTSTRAP_TAIL_RATIO);\n  let marker = markerTemplate(headChars, tailChars);\n  let renderedLength = headChars + tailChars + marker.length;\n\n  while (renderedLength > maxChars && (headChars > 0 || tailChars > 0)) {\n    if (tailChars >= headChars && tailChars > 0) {\n      tailChars -= 1;\n    } else if (headChars > 0) {\n      headChars -= 1;\n    } else {\n      break;\n    }\n    marker = markerTemplate(headChars, tailChars);\n    renderedLength = headChars + tailChars + marker.length;\n  }\n\n  const head = trimmed.slice(0, headChars);\n  const tail = tailChars > 0 ? trimmed.slice(-tailChars) : '';\n  const bounded = `${head}${marker}${tail}`;\n  return {\n    content: bounded.length > maxChars ? bounded.slice(0, maxChars) : bounded,\n    truncated: true,\n    originalLength: trimmed.length,\n    maxChars,\n  };\n}\n\nexport function buildBootstrapContextFiles(\n  files: WorkspaceBootstrapFile[],\n  opts?: { warn?: (message: string) => void; maxChars?: number; totalMaxChars?: number },\n): EmbeddedContextFile[] {\n  const maxChars = opts?.maxChars ?? DEFAULT_BOOTSTRAP_MAX_CHARS;\n  const totalMaxChars = Math.max(\n    1,\n    Math.floor(opts?.totalMaxChars ?? Math.max(maxChars, DEFAULT_BOOTSTRAP_TOTAL_MAX_CHARS)),\n  );\n  let remainingTotalChars = totalMaxChars;\n  const result: EmbeddedContextFile[] = [];\n\n  for (const file of files) {\n    if (remainingTotalChars <= 0) {\n      break;\n    }\n    const pathValue = file.path.trim();\n    if (!pathValue) {\n      opts?.warn?.(`skipping bootstrap file \"${file.name}\" — missing path`);\n      continue;\n    }\n\n    if (file.missing) {\n      const missingText = `[MISSING] Expected at: ${pathValue}`;\n      const capped = clampToBudget(missingText, remainingTotalChars);\n      if (!capped) {\n        break;\n      }\n      remainingTotalChars = Math.max(0, remainingTotalChars - capped.length);\n      result.push({ path: pathValue, content: capped });\n      continue;\n    }\n\n    if (remainingTotalChars < MIN_BOOTSTRAP_FILE_BUDGET_CHARS) {\n      opts?.warn?.(\n        `remaining bootstrap budget is ${remainingTotalChars} chars (<${MIN_BOOTSTRAP_FILE_BUDGET_CHARS}); skipping additional bootstrap files`,\n      );\n      break;\n    }\n\n    const fileMaxChars = Math.max(1, Math.min(maxChars, remainingTotalChars));\n    const trimmed = trimBootstrapContent(file.content ?? '', file.name, fileMaxChars);\n    const contentWithinBudget = clampToBudget(trimmed.content, remainingTotalChars);\n    if (!contentWithinBudget) {\n      continue;\n    }\n    if (trimmed.truncated || contentWithinBudget.length < trimmed.content.length) {\n      opts?.warn?.(\n        `profile bootstrap file ${file.name} is ${trimmed.originalLength} chars (limit ${trimmed.maxChars}); truncating in injected context`,\n      );\n    }\n    remainingTotalChars = Math.max(0, remainingTotalChars - contentWithinBudget.length);\n    result.push({ path: pathValue, content: contentWithinBudget });\n  }\n\n  return result;\n}\n"],"mappings":"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"}

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

@@ -3,17 +3,20 @@ import type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';
 export { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';
 export declare function resolveBootstrapFilesSync(params: {
     profileDir: string;
+    userProfilePath?: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
 }): WorkspaceBootstrapFile[];
 export declare function resolveBootstrapFilesForRun(params: {
     profileDir: string;
+    userProfilePath?: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
     warn?: (message: string) => void;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function resolveBootstrapContextSync(params: {
     profileDir: string;
+    userProfilePath?: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
@@ -24,6 +27,7 @@ export declare function resolveBootstrapContextSync(params: {
 };
 export declare function resolveBootstrapContextForRun(params: {
     profileDir: string;
+    userProfilePath?: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;

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

@@ -1,5 +1,5 @@
 import { DEFAULT_HEARTBEAT_FILENAME } from "../context/workspace.js";
-import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
+import { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from "./load-bootstrap-files.js";
 import { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles, markBootstrapContextInjected, wasBootstrapContextInjected } from "./bootstrap-cache.js";
 import { buildBootstrapContextFiles, resolveBootstrapMaxChars, resolveBootstrapTotalMaxChars } from "./bootstrap-context.js";
 import { filterBootstrapFilesForSession } from "./filter-bootstrap-files.js";
@@ -9,14 +9,15 @@ function filterHeartbeatBootstrapFile(files, exclude) {
 	return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);
 }
 function resolveBootstrapFilesSync(params) {
-	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(loadProfileBootstrapFiles(params.profileDir), params.sessionKey), params.excludeHeartbeat ?? false);
+	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession([...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)], params.sessionKey), params.excludeHeartbeat ?? false);
 }
 async function resolveBootstrapFilesForRun(params) {
 	const sessionKey = params.sessionKey;
 	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(sessionKey ? await getOrLoadBootstrapFiles({
 		profileDir: params.profileDir,
+		userProfilePath: params.userProfilePath,
 		sessionKey
-	}) : loadProfileBootstrapFiles(params.profileDir), sessionKey), params.excludeHeartbeat ?? false);
+	}) : [...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)], sessionKey), params.excludeHeartbeat ?? false);
 }
 function resolveBootstrapContextSync(params) {
 	const mode = params.contextInjection ?? "always";

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 { existsSync, readFileSync } from "node:fs";
+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/project-agents-context.js

@@ -1,6 +1,6 @@
 import { DEFAULT_AGENTS_FILENAME, stripFrontMatter } from "../context/workspace.js";
-import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/bootstrap/project-agents-context.ts
 const PROJECT_AGENTS_MAX_CHARS = 2e4;
 function truncateProjectAgentsContent(content) {

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-seed.js

@@ -1,12 +1,12 @@
 import { init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent-scope.js";
-import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "./workspace.js";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 //#region src/agent/context/workspace-seed.ts
 /**
 * Seed profile Markdown files into `agents/<agentId>/profile/` (and optionally `git init` the Markdown workspace).

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

@@ -1,6 +1,6 @@
 import { FILENAMES, init_paths, resolveWorkspaceStatePath } from "../../config/paths.js";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 //#region src/agent/context/workspace-state.ts
 /**
 * Workspace setup metadata in `<markdownWorkspace>/.xopc/workspace.json`

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { existsSync, readFileSync } from "fs";
 import { join, resolve } from "path";
+import { existsSync, readFileSync } from "fs";
 //#region src/agent/context/workspace.ts
 /**
 * Agent profile Markdown (filenames, load order, system prompt assembly) and
@@ -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":"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"}
+{"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);