@xopcai/xopc 0.0.95 → 0.0.96

package/dist/src/agent/agent-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-scope.js","names":[],"sources":["../../../src/agent/agent-scope.ts"],"sourcesContent":["/**\n * Agent path and list resolution (config is the single source of truth).\n */\n\nimport fs from 'node:fs';\nimport { basename, join, relative, resolve, isAbsolute } from 'node:path';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport const DEFAULT_AGENT_ID = 'main';\n\nconst VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\nconst INVALID_CHARS_RE = /[^a-z0-9_-]+/g;\nconst LEADING_DASH_RE = /^-+/;\nconst TRAILING_DASH_RE = /-+$/;\n\n/** Normalized id segment safe for directory names under `agents/<id>/`. */\nexport const STRICT_AGENT_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;\n\nconst WINDOWS_RESERVED_AGENT_IDS = new Set<string>([\n  'con',\n  'prn',\n  'aux',\n  'nul',\n  'com1',\n  'com2',\n  'com3',\n  'com4',\n  'com5',\n  'com6',\n  'com7',\n  'com8',\n  'com9',\n  'lpt1',\n  'lpt2',\n  'lpt3',\n  'lpt4',\n  'lpt5',\n  'lpt6',\n  'lpt7',\n  'lpt8',\n  'lpt9',\n]);\n\nfunction normalizeLowercaseStringOrEmpty(s: string): string {\n  return s.trim().toLowerCase();\n}\n\n/** Path-safe agent id. */\nexport function normalizeAgentId(value: string | undefined | null): string {\n  const trimmed = (value ?? '').trim();\n  if (!trimmed) {\n    return DEFAULT_AGENT_ID;\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(trimmed);\n  if (VALID_ID_RE.test(trimmed)) {\n    return normalized;\n  }\n  return (\n    normalized\n      .replace(INVALID_CHARS_RE, '-')\n      .replace(LEADING_DASH_RE, '')\n      .replace(TRAILING_DASH_RE, '')\n      .slice(0, 64) || DEFAULT_AGENT_ID\n  );\n}\n\n/**\n * Validate agent id for new agents (folder-safe path segment).\n * When `explicitId` is set, it must already match {@link STRICT_AGENT_ID_RE} (case-insensitive input, stored lowercase).\n * When omitted, id is derived from `displayNameForDerivation` via {@link normalizeAgentId}.\n */\nexport function validateAgentIdForNewAgent(\n  explicitId: string | undefined | null,\n  displayNameForDerivation: string,\n): { ok: true; agentId: string } | { ok: false; error: string } {\n  const explicit = explicitId?.trim();\n  if (explicit) {\n    const id = explicit.toLowerCase();\n    if (!STRICT_AGENT_ID_RE.test(id)) {\n      return {\n        ok: false,\n        error:\n          'Invalid agent id: use 1–64 characters; letters, digits, underscores, and hyphens only; start with a letter or digit.',\n      };\n    }\n    if (id === DEFAULT_AGENT_ID) {\n      return { ok: false, error: `\"${DEFAULT_AGENT_ID}\" is reserved` };\n    }\n    if (WINDOWS_RESERVED_AGENT_IDS.has(id)) {\n      return { ok: false, error: `Agent id \"${id}\" is reserved (Windows device name).` };\n    }\n    return { ok: true, agentId: id };\n  }\n\n  const agentId = normalizeAgentId(displayNameForDerivation.trim());\n  if (agentId === DEFAULT_AGENT_ID) {\n    return {\n      ok: false,\n      error:\n        'Display name cannot produce a valid agent folder id. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  if (WINDOWS_RESERVED_AGENT_IDS.has(agentId)) {\n    return {\n      ok: false,\n      error: `That display name resolves to \"${agentId}\", which is reserved. Use a different display name or set an explicit Agent id.`,\n    };\n  }\n  if (!STRICT_AGENT_ID_RE.test(agentId)) {\n    return {\n      ok: false,\n      error:\n        'Could not derive a folder-safe agent id from the display name. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  return { ok: true, agentId };\n}\n\n/** Expand `~` and resolve to an absolute path. */\nexport function resolveUserPath(raw: string): string {\n  const expanded = expandWorkspacePathString(raw.trim());\n  return resolve(expanded);\n}\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport function listAgentEntries(cfg: Config): AgentEntry[] {\n  const list = cfg.agents?.list;\n  if (!Array.isArray(list)) {\n    return [];\n  }\n  return list.filter((e): e is AgentEntry => Boolean(e && typeof e === 'object'));\n}\n\nexport function resolveDefaultAgentId(cfg: Config): string {\n  const explicit = cfg.agents?.default?.trim();\n  if (explicit) {\n    return normalizeAgentId(explicit);\n  }\n  const agents = listAgentEntries(cfg);\n  if (agents.length === 0) {\n    return DEFAULT_AGENT_ID;\n  }\n  const defaults = agents.filter((a) => a?.default === true);\n  const chosen = (defaults[0] ?? agents[0])?.id?.trim();\n  return chosen ? normalizeAgentId(chosen) : DEFAULT_AGENT_ID;\n}\n\nfunction resolveAgentEntry(cfg: Config, agentId: string): AgentEntry | undefined {\n  const id = normalizeAgentId(agentId);\n  return listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);\n}\n\n/**\n * Markdown workspace root for an agent.\n */\nexport function resolveAgentWorkspaceDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.workspace?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const defaultAgentId = resolveDefaultAgentId(cfg);\n  const fallback = cfg.agents?.defaults?.workspace?.trim();\n  if (fallback) {\n    return join(resolveUserPath(fallback), id);\n  }\n  if (id === defaultAgentId) {\n    return resolveDefaultAgentWorkspaceDir(process.env);\n  }\n  const stateDir = resolveStateDir(process.env);\n  return join(stateDir, `workspace-${id}`);\n}\n\n/**\n * Internal agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`).\n */\nexport function resolveAgentDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.agentDir?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const root = resolveStateDir(process.env);\n  return join(root, 'agents', id, 'agent');\n}\n\n/** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */\nexport function resolveAgentHomeDir(cfg: Config, agentId: string): string {\n  return join(resolveStateDir(process.env), 'agents', normalizeAgentId(agentId));\n}\n\n/** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'profile');\n}\n\n/** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */\nexport function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string {\n  const base = basename(filename.trim().replace(/\\\\/g, '/'));\n  return join(resolveAgentProfileDir(cfg, agentId), base);\n}\n\nexport function resolveSessionsDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'sessions');\n}\n\nfunction normalizePathForComparison(input: string): string {\n  const resolved = resolve(resolveUserPath(input));\n  let normalized = resolved;\n  try {\n    normalized = fs.realpathSync.native(resolved);\n  } catch {\n    // Keep lexical path for non-existent directories.\n  }\n  if (process.platform === 'win32') {\n    return normalized.toLowerCase();\n  }\n  return normalized;\n}\n\nfunction isPathWithinRoot(candidatePath: string, rootPath: string): boolean {\n  const rel = relative(rootPath, candidatePath);\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));\n}\n\n/** Agent ids whose workspace root contains `workspacePath` (longest match first). */\nexport function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[] {\n  const normalizedWorkspacePath = normalizePathForComparison(workspacePath);\n  const entries = listAgentEntries(cfg);\n  const matches: Array<{ id: string; workspaceDir: string; order: number }> = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index]!;\n    const id = normalizeAgentId(entry.id);\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, id));\n    if (!isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      continue;\n    }\n    matches.push({ id, workspaceDir, order: index });\n  }\n\n  const defaultId = resolveDefaultAgentId(cfg);\n  if (!entries.some((e) => normalizeAgentId(e.id) === defaultId)) {\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, defaultId));\n    if (isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      matches.push({ id: defaultId, workspaceDir, order: entries.length });\n    }\n  }\n\n  matches.sort((left, right) => {\n    const workspaceLengthDelta = right.workspaceDir.length - left.workspaceDir.length;\n    if (workspaceLengthDelta !== 0) {\n      return workspaceLengthDelta;\n    }\n    return left.order - right.order;\n  });\n\n  return matches.map((entry) => entry.id);\n}\n\n/** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */\nexport function resolveAgentIdByWorkspacePath(\n  cfg: Config,\n  workspacePath: string,\n): string | undefined {\n  return resolveAgentIdsByWorkspacePath(cfg, workspacePath)[0];\n}\n\n/**\n * Find the agent id whose resolved markdown workspace matches `resolvedWorkspacePath`.\n * Falls back to {@link resolveDefaultAgentId} when no list entry matches.\n */\nexport function resolveAgentIdForWorkspacePath(cfg: Config, resolvedWorkspacePath: string): string {\n  return (\n    resolveAgentIdByWorkspacePath(cfg, resolvedWorkspacePath) ??\n    resolveDefaultAgentId(cfg)\n  );\n}\n\nexport function getDefaultWorkspacePath(cfg: Config): string {\n  return resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg));\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-scope.js","names":[],"sources":["../../../src/agent/agent-scope.ts"],"sourcesContent":["/**\n * Agent path and list resolution (config is the single source of truth).\n */\n\nimport fs from 'node:fs';\nimport { basename, join, relative, resolve, isAbsolute } from 'node:path';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport const DEFAULT_AGENT_ID = 'main';\n\nconst VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\nconst INVALID_CHARS_RE = /[^a-z0-9_-]+/g;\nconst LEADING_DASH_RE = /^-+/;\nconst TRAILING_DASH_RE = /-+$/;\n\n/** Normalized id segment safe for directory names under `agents/<id>/`. */\nexport const STRICT_AGENT_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;\n\nconst WINDOWS_RESERVED_AGENT_IDS = new Set<string>([\n  'con',\n  'prn',\n  'aux',\n  'nul',\n  'com1',\n  'com2',\n  'com3',\n  'com4',\n  'com5',\n  'com6',\n  'com7',\n  'com8',\n  'com9',\n  'lpt1',\n  'lpt2',\n  'lpt3',\n  'lpt4',\n  'lpt5',\n  'lpt6',\n  'lpt7',\n  'lpt8',\n  'lpt9',\n]);\n\nfunction normalizeLowercaseStringOrEmpty(s: string): string {\n  return s.trim().toLowerCase();\n}\n\n/** Path-safe agent id. */\nexport function normalizeAgentId(value: string | undefined | null): string {\n  const trimmed = (value ?? '').trim();\n  if (!trimmed) {\n    return DEFAULT_AGENT_ID;\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(trimmed);\n  if (VALID_ID_RE.test(trimmed)) {\n    return normalized;\n  }\n  return (\n    normalized\n      .replace(INVALID_CHARS_RE, '-')\n      .replace(LEADING_DASH_RE, '')\n      .replace(TRAILING_DASH_RE, '')\n      .slice(0, 64) || DEFAULT_AGENT_ID\n  );\n}\n\n/**\n * Validate agent id for new agents (folder-safe path segment).\n * When `explicitId` is set, it must already match {@link STRICT_AGENT_ID_RE} (case-insensitive input, stored lowercase).\n * When omitted, id is derived from `displayNameForDerivation` via {@link normalizeAgentId}.\n */\nexport function validateAgentIdForNewAgent(\n  explicitId: string | undefined | null,\n  displayNameForDerivation: string,\n): { ok: true; agentId: string } | { ok: false; error: string } {\n  const explicit = explicitId?.trim();\n  if (explicit) {\n    const id = explicit.toLowerCase();\n    if (!STRICT_AGENT_ID_RE.test(id)) {\n      return {\n        ok: false,\n        error:\n          'Invalid agent id: use 1–64 characters; letters, digits, underscores, and hyphens only; start with a letter or digit.',\n      };\n    }\n    if (id === DEFAULT_AGENT_ID) {\n      return { ok: false, error: `\"${DEFAULT_AGENT_ID}\" is reserved` };\n    }\n    if (WINDOWS_RESERVED_AGENT_IDS.has(id)) {\n      return { ok: false, error: `Agent id \"${id}\" is reserved (Windows device name).` };\n    }\n    return { ok: true, agentId: id };\n  }\n\n  const agentId = normalizeAgentId(displayNameForDerivation.trim());\n  if (agentId === DEFAULT_AGENT_ID) {\n    return {\n      ok: false,\n      error:\n        'Display name cannot produce a valid agent folder id. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  if (WINDOWS_RESERVED_AGENT_IDS.has(agentId)) {\n    return {\n      ok: false,\n      error: `That display name resolves to \"${agentId}\", which is reserved. Use a different display name or set an explicit Agent id.`,\n    };\n  }\n  if (!STRICT_AGENT_ID_RE.test(agentId)) {\n    return {\n      ok: false,\n      error:\n        'Could not derive a folder-safe agent id from the display name. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  return { ok: true, agentId };\n}\n\n/** Expand `~` and resolve to an absolute path. */\nexport function resolveUserPath(raw: string): string {\n  const expanded = expandWorkspacePathString(raw.trim());\n  return resolve(expanded);\n}\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport function listAgentEntries(cfg: Config): AgentEntry[] {\n  const list = cfg.agents?.list;\n  if (!Array.isArray(list)) {\n    return [];\n  }\n  return list.filter((e): e is AgentEntry => Boolean(e && typeof e === 'object'));\n}\n\nexport function resolveDefaultAgentId(cfg: Config): string {\n  const explicit = cfg.agents?.default?.trim();\n  if (explicit) {\n    return normalizeAgentId(explicit);\n  }\n  const agents = listAgentEntries(cfg);\n  if (agents.length === 0) {\n    return DEFAULT_AGENT_ID;\n  }\n  const defaults = agents.filter((a) => a?.default === true);\n  const chosen = (defaults[0] ?? agents[0])?.id?.trim();\n  return chosen ? normalizeAgentId(chosen) : DEFAULT_AGENT_ID;\n}\n\nfunction resolveAgentEntry(cfg: Config, agentId: string): AgentEntry | undefined {\n  const id = normalizeAgentId(agentId);\n  return listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);\n}\n\n/**\n * Markdown workspace root for an agent.\n */\nexport function resolveAgentWorkspaceDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.workspace?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const defaultAgentId = resolveDefaultAgentId(cfg);\n  const fallback = cfg.agents?.defaults?.workspace?.trim();\n  if (fallback) {\n    return join(resolveUserPath(fallback), id);\n  }\n  if (id === defaultAgentId) {\n    return resolveDefaultAgentWorkspaceDir(process.env);\n  }\n  const stateDir = resolveStateDir(process.env);\n  return join(stateDir, `workspace-${id}`);\n}\n\n/**\n * Internal agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`).\n */\nexport function resolveAgentDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.agentDir?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const root = resolveStateDir(process.env);\n  return join(root, 'agents', id, 'agent');\n}\n\n/** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */\nexport function resolveAgentHomeDir(cfg: Config, agentId: string): string {\n  return join(resolveStateDir(process.env), 'agents', normalizeAgentId(agentId));\n}\n\n/** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'profile');\n}\n\n/** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */\nexport function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string {\n  const base = basename(filename.trim().replace(/\\\\/g, '/'));\n  return join(resolveAgentProfileDir(cfg, agentId), base);\n}\n\nfunction normalizePathForComparison(input: string): string {\n  const resolved = resolve(resolveUserPath(input));\n  let normalized = resolved;\n  try {\n    normalized = fs.realpathSync.native(resolved);\n  } catch {\n    // Keep lexical path for non-existent directories.\n  }\n  if (process.platform === 'win32') {\n    return normalized.toLowerCase();\n  }\n  return normalized;\n}\n\nfunction isPathWithinRoot(candidatePath: string, rootPath: string): boolean {\n  const rel = relative(rootPath, candidatePath);\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));\n}\n\n/** Agent ids whose workspace root contains `workspacePath` (longest match first). */\nexport function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[] {\n  const normalizedWorkspacePath = normalizePathForComparison(workspacePath);\n  const entries = listAgentEntries(cfg);\n  const matches: Array<{ id: string; workspaceDir: string; order: number }> = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index]!;\n    const id = normalizeAgentId(entry.id);\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, id));\n    if (!isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      continue;\n    }\n    matches.push({ id, workspaceDir, order: index });\n  }\n\n  const defaultId = resolveDefaultAgentId(cfg);\n  if (!entries.some((e) => normalizeAgentId(e.id) === defaultId)) {\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, defaultId));\n    if (isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      matches.push({ id: defaultId, workspaceDir, order: entries.length });\n    }\n  }\n\n  matches.sort((left, right) => {\n    const workspaceLengthDelta = right.workspaceDir.length - left.workspaceDir.length;\n    if (workspaceLengthDelta !== 0) {\n      return workspaceLengthDelta;\n    }\n    return left.order - right.order;\n  });\n\n  return matches.map((entry) => entry.id);\n}\n\n/** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */\nexport function resolveAgentIdByWorkspacePath(\n  cfg: Config,\n  workspacePath: string,\n): string | undefined {\n  return resolveAgentIdsByWorkspacePath(cfg, workspacePath)[0];\n}\n\n/**\n * Find the agent id whose resolved markdown workspace matches `resolvedWorkspacePath`.\n * Falls back to {@link resolveDefaultAgentId} when no list entry matches.\n */\nexport function resolveAgentIdForWorkspacePath(cfg: Config, resolvedWorkspacePath: string): string {\n  return (\n    resolveAgentIdByWorkspacePath(cfg, resolvedWorkspacePath) ??\n    resolveDefaultAgentId(cfg)\n  );\n}\n\nexport function getDefaultWorkspacePath(cfg: Config): string {\n  return resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg));\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,9 @@
 import type { WorkspaceBootstrapFile } from './types.js';
+export declare function wasBootstrapContextInjected(sessionKey: string): boolean;
+export declare function markBootstrapContextInjected(sessionKey: string): void;
 export declare function getOrLoadBootstrapFiles(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey: string;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function clearBootstrapSnapshot(sessionKey: string): void;

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

@@ -1,6 +1,7 @@
 import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
 //#region src/agent/bootstrap/bootstrap-cache.ts
 const cache = /* @__PURE__ */ new Map();
+const bootstrapContextInjected = /* @__PURE__ */ new Set();
 function bootstrapFilesEqual(previous, next) {
 	if (previous.length !== next.length) return false;
 	return previous.every((file, index) => {
@@ -8,23 +9,32 @@ function bootstrapFilesEqual(previous, next) {
 		return updated !== void 0 && file.name === updated.name && file.path === updated.path && file.content === updated.content && file.missing === updated.missing;
 	});
 }
+function wasBootstrapContextInjected(sessionKey) {
+	return bootstrapContextInjected.has(sessionKey);
+}
+function markBootstrapContextInjected(sessionKey) {
+	bootstrapContextInjected.add(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 = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);
+	if (existing && existing.profileDir === params.profileDir && existing.workspaceStatePath === params.workspaceStatePath && bootstrapFilesEqual(existing.files, files)) return existing.files;
 	cache.set(params.sessionKey, {
 		profileDir: params.profileDir,
+		workspaceStatePath: params.workspaceStatePath,
 		files
 	});
 	return files;
 }
 function clearBootstrapSnapshot(sessionKey) {
 	cache.delete(sessionKey);
+	bootstrapContextInjected.delete(sessionKey);
 }
 function clearAllBootstrapSnapshots() {
 	cache.clear();
+	bootstrapContextInjected.clear();
 }
 //#endregion
-export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles };
+export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles, markBootstrapContextInjected, wasBootstrapContextInjected };
 
 //# sourceMappingURL=bootstrap-cache.js.map

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>();\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 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 (\n    existing &&\n    existing.profileDir === params.profileDir &&\n    bootstrapFilesEqual(existing.files, files)\n  ) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, { profileDir: params.profileDir, files });\n  return files;\n}\n\nexport function clearBootstrapSnapshot(sessionKey: string): void {\n  cache.delete(sessionKey);\n}\n\nexport function clearAllBootstrapSnapshots(): void {\n  cache.clear();\n}\n"],"mappings":";;AAQA,MAAM,wBAAQ,IAAI,KAAgC;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,eAAsB,wBAAwB,QAGR;CACpC,MAAM,WAAW,MAAM,IAAI,OAAO,WAAW;CAC7C,MAAM,QAAQ,0BAA0B,OAAO,WAAW;AAC1D,KACE,YACA,SAAS,eAAe,OAAO,cAC/B,oBAAoB,SAAS,OAAO,MAAM,CAE1C,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAAE,YAAY,OAAO;EAAY;EAAO,CAAC;AACtE,QAAO;;AAGT,SAAgB,uBAAuB,YAA0B;AAC/D,OAAM,OAAO,WAAW;;AAG1B,SAAgB,6BAAmC;AACjD,OAAM,OAAO"}
+{"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  workspaceStatePath: 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  workspaceStatePath: string;\n  sessionKey: string;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const existing = cache.get(params.sessionKey);\n  const files = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\n  if (\n    existing &&\n    existing.profileDir === params.profileDir &&\n    existing.workspaceStatePath === params.workspaceStatePath &&\n    bootstrapFilesEqual(existing.files, files)\n  ) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, {\n    profileDir: params.profileDir,\n    workspaceStatePath: params.workspaceStatePath,\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,0BAA0B,OAAO,YAAY,OAAO,mBAAmB;AACrF,KACE,YACA,SAAS,eAAe,OAAO,cAC/B,SAAS,uBAAuB,OAAO,sBACvC,oBAAoB,SAAS,OAAO,MAAM,CAE1C,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAC3B,YAAY,OAAO;EACnB,oBAAoB,OAAO;EAC3B;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-files.d.ts

@@ -4,29 +4,35 @@ export { isProfileBootstrapPending } from './load-bootstrap-files.js';
 export { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';
 export declare function resolveBootstrapFilesSync(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
 }): WorkspaceBootstrapFile[];
 export declare function resolveBootstrapFilesForRun(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
     warn?: (message: string) => void;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function resolveBootstrapContextSync(params: {
     profileDir: string;
+    workspaceStatePath: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
+    contextInjection?: 'always' | 'continuation-skip' | 'never';
 }): {
     bootstrapFiles: WorkspaceBootstrapFile[];
     contextFiles: EmbeddedContextFile[];
 };
 export declare function resolveBootstrapContextForRun(params: {
     profileDir: string;
+    workspaceStatePath: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
+    contextInjection?: 'always' | 'continuation-skip' | 'never';
     warn?: (message: string) => void;
 }): Promise<{
     bootstrapFiles: WorkspaceBootstrapFile[];

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

@@ -1,6 +1,6 @@
 import { DEFAULT_HEARTBEAT_FILENAME } from "../context/workspace.js";
 import { isProfileBootstrapPending, loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
-import { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles } from "./bootstrap-cache.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";
 //#region src/agent/bootstrap/bootstrap-files.ts
@@ -9,34 +9,57 @@ 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(loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath), params.sessionKey), params.excludeHeartbeat ?? false);
 }
 async function resolveBootstrapFilesForRun(params) {
 	const sessionKey = params.sessionKey;
 	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(sessionKey ? await getOrLoadBootstrapFiles({
 		profileDir: params.profileDir,
+		workspaceStatePath: params.workspaceStatePath,
 		sessionKey
-	}) : loadProfileBootstrapFiles(params.profileDir), sessionKey), params.excludeHeartbeat ?? false);
+	}) : loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath), sessionKey), params.excludeHeartbeat ?? false);
 }
 function resolveBootstrapContextSync(params) {
+	const mode = params.contextInjection ?? "always";
+	if (mode === "never") return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
+	if (mode === "continuation-skip" && params.sessionKey && wasBootstrapContextInjected(params.sessionKey)) return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
 	const bootstrapFiles = resolveBootstrapFilesSync(params);
+	const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {
+		maxChars: resolveBootstrapMaxChars(params.config),
+		totalMaxChars: resolveBootstrapTotalMaxChars(params.config)
+	});
+	if (mode === "continuation-skip" && params.sessionKey && contextFiles.length > 0) markBootstrapContextInjected(params.sessionKey);
 	return {
 		bootstrapFiles,
-		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
-			maxChars: resolveBootstrapMaxChars(params.config),
-			totalMaxChars: resolveBootstrapTotalMaxChars(params.config)
-		})
+		contextFiles
 	};
 }
 async function resolveBootstrapContextForRun(params) {
+	const mode = params.contextInjection ?? "always";
+	if (mode === "never") return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
+	if (mode === "continuation-skip" && params.sessionKey && wasBootstrapContextInjected(params.sessionKey)) return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
 	const bootstrapFiles = await resolveBootstrapFilesForRun(params);
+	const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {
+		maxChars: resolveBootstrapMaxChars(params.config),
+		totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
+		warn: params.warn
+	});
+	if (mode === "continuation-skip" && params.sessionKey && contextFiles.length > 0) markBootstrapContextInjected(params.sessionKey);
 	return {
 		bootstrapFiles,
-		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
-			maxChars: resolveBootstrapMaxChars(params.config),
-			totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
-			warn: params.warn
-		})
+		contextFiles
 	};
 }
 //#endregion

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 { getOrLoadBootstrapFiles } 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 { isProfileBootstrapPending } from './load-bootstrap-files.js';\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({ profileDir: params.profileDir, sessionKey })\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}): {\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n} {\n  const bootstrapFiles = resolveBootstrapFilesSync(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\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  warn?: (message: string) => void;\n}): Promise<{\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\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  return { bootstrapFiles, contextFiles };\n}\n"],"mappings":";;;;;;AAeA,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;AAK1B,QAAO,6BADU,+BAHA,aACb,MAAM,wBAAwB;EAAE,YAAY,OAAO;EAAY;EAAY,CAAC,GAC5E,0BAA0B,OAAO,WAAW,EACU,WACd,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,SAAgB,4BAA4B,QAQ1C;CACA,MAAM,iBAAiB,0BAA0B,OAAO;AAKxD,QAAO;EAAE;EAAgB,cAJJ,2BAA2B,gBAAgB;GAC9D,UAAU,yBAAyB,OAAO,OAAO;GACjD,eAAe,8BAA8B,OAAO,OAAO;GAC5D,CACoC;EAAE;;AAGzC,eAAsB,8BAA8B,QASjD;CACD,MAAM,iBAAiB,MAAM,4BAA4B,OAAO;AAMhE,QAAO;EAAE;EAAgB,cALJ,2BAA2B,gBAAgB;GAC9D,UAAU,yBAAyB,OAAO,OAAO;GACjD,eAAe,8BAA8B,OAAO,OAAO;GAC3D,MAAM,OAAO;GACd,CACoC;EAAE"}
+{"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 { isProfileBootstrapPending } from './load-bootstrap-files.js';\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  workspaceStatePath: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): WorkspaceBootstrapFile[] {\n  const rawFiles = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\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  workspaceStatePath: 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        workspaceStatePath: params.workspaceStatePath,\n        sessionKey,\n      })\n    : loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\n  const filtered = filterBootstrapFilesForSession(rawFiles, sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport function resolveBootstrapContextSync(params: {\n  profileDir: string;\n  workspaceStatePath: 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  workspaceStatePath: 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":";;;;;;AAmBA,SAAS,6BACP,OACA,SAC0B;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,KAAK,SAAS,2BAA2B;;AAGzE,SAAgB,0BAA0B,QAKb;AAG3B,QAAO,6BADU,+BADA,0BAA0B,OAAO,YAAY,OAAO,mBACb,EAAE,OAAO,WACrB,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,eAAsB,4BAA4B,QAMZ;CACpC,MAAM,aAAa,OAAO;AAS1B,QAAO,6BADU,+BAPA,aACb,MAAM,wBAAwB;EAC5B,YAAY,OAAO;EACnB,oBAAoB,OAAO;EAC3B;EACD,CAAC,GACF,0BAA0B,OAAO,YAAY,OAAO,mBAAmB,EACjB,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/load-bootstrap-files.d.ts

@@ -1,7 +1,10 @@
 import type { WorkspaceBootstrapFile } from './types.js';
-export declare function isProfileBootstrapPending(profileDir: string): boolean;
+export declare function isProfileBootstrapPending(profileDir: string, workspaceStatePath: string): boolean;
 /**
  * Load bootstrap profile Markdown from `agents/<id>/profile/`.
  * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.
+ *
+ * BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,
+ * to prevent re-injection of the bootstrap script after setup is done.
  */
-export declare function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[];
+export declare function loadProfileBootstrapFiles(profileDir: string, workspaceStatePath: string): WorkspaceBootstrapFile[];

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

@@ -1,7 +1,8 @@
 import { WORKSPACE_FILES, 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, DEFAULT_USER_FILENAME, stripFrontMatter } from "../context/workspace.js";
-import { join, resolve } from "node:path";
+import { isWorkspaceSetupCompleted, syncBootstrapSetupCompletion } from "../context/workspace-state.js";
 import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 //#region src/agent/bootstrap/load-bootstrap-files.ts
 init_paths();
 const BOOTSTRAP_LOAD_ORDER = [
@@ -22,18 +23,26 @@ function readProfileFile(filePath) {
 		return null;
 	}
 }
-function isProfileBootstrapPending(profileDir) {
+function isProfileBootstrapPending(profileDir, workspaceStatePath) {
+	syncBootstrapSetupCompletion(workspaceStatePath, profileDir);
+	if (isWorkspaceSetupCompleted(workspaceStatePath)) return false;
 	return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));
 }
 /**
 * Load bootstrap profile Markdown from `agents/<id>/profile/`.
 * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.
+*
+* BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,
+* to prevent re-injection of the bootstrap script after setup is done.
 */
-function loadProfileBootstrapFiles(profileDir) {
+function loadProfileBootstrapFiles(profileDir, workspaceStatePath) {
+	syncBootstrapSetupCompletion(workspaceStatePath, profileDir);
 	const resolvedDir = resolve(profileDir);
 	const result = [];
+	const setupCompleted = isWorkspaceSetupCompleted(workspaceStatePath);
 	for (const name of BOOTSTRAP_LOAD_ORDER) {
 		const filePath = join(resolvedDir, name);
+		if (name === WORKSPACE_FILES.BOOTSTRAP && setupCompleted) continue;
 		if (name === "MEMORY.md" || name === WORKSPACE_FILES.BOOTSTRAP) {
 			const content = readProfileFile(filePath);
 			if (content === null) continue;

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 { WORKSPACE_FILES } 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  DEFAULT_USER_FILENAME,\n} from '../context/workspace.js';\nimport type { BootstrapFileName, WorkspaceBootstrapFile } from './types.js';\n\nconst BOOTSTRAP_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  WORKSPACE_FILES.BOOTSTRAP,\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 isProfileBootstrapPending(profileDir: string): boolean {\n  return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * MEMORY.md and BOOTSTRAP.md are 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 BOOTSTRAP_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    if (name === DEFAULT_MEMORY_FILENAME || name === WORKSPACE_FILES.BOOTSTRAP) {\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":";;;;;YAGwD;AAaxD,MAAM,uBAA4C;CAChD;CACA;CACA;CACA;CACA;CACA;CACA,gBAAgB;CAChB;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,0BAA0B,YAA6B;AACrE,QAAO,WAAW,KAAK,YAAY,gBAAgB,UAAU,CAAC;;;;;;AAOhE,SAAgB,0BAA0B,YAA8C;CACtF,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,sBAAsB;EACvC,MAAM,WAAW,KAAK,aAAa,KAAK;AAExC,MAAI,SAAA,eAAoC,SAAS,gBAAgB,WAAW;GAC1E,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 { WORKSPACE_FILES } from '../../config/paths.js';\nimport { stripFrontMatter } from '../context/workspace.js';\nimport {\n  isWorkspaceSetupCompleted,\n  syncBootstrapSetupCompletion,\n} from '../context/workspace-state.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 BOOTSTRAP_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  WORKSPACE_FILES.BOOTSTRAP,\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 isProfileBootstrapPending(profileDir: string, workspaceStatePath: string): boolean {\n  syncBootstrapSetupCompletion(workspaceStatePath, profileDir);\n  if (isWorkspaceSetupCompleted(workspaceStatePath)) {\n    return false;\n  }\n  return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.\n *\n * BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,\n * to prevent re-injection of the bootstrap script after setup is done.\n */\nexport function loadProfileBootstrapFiles(\n  profileDir: string,\n  workspaceStatePath: string,\n): WorkspaceBootstrapFile[] {\n  syncBootstrapSetupCompletion(workspaceStatePath, profileDir);\n  const resolvedDir = resolve(profileDir);\n  const result: WorkspaceBootstrapFile[] = [];\n  const setupCompleted = isWorkspaceSetupCompleted(workspaceStatePath);\n\n  for (const name of BOOTSTRAP_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    // Skip BOOTSTRAP.md entirely when setup is already completed\n    if (name === WORKSPACE_FILES.BOOTSTRAP && setupCompleted) {\n      continue;\n    }\n\n    if (name === DEFAULT_MEMORY_FILENAME || name === WORKSPACE_FILES.BOOTSTRAP) {\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":";;;;;;YAGwD;AAiBxD,MAAM,uBAA4C;CAChD;CACA;CACA;CACA;CACA;CACA;CACA,gBAAgB;CAChB;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,0BAA0B,YAAoB,oBAAqC;AACjG,8BAA6B,oBAAoB,WAAW;AAC5D,KAAI,0BAA0B,mBAAmB,CAC/C,QAAO;AAET,QAAO,WAAW,KAAK,YAAY,gBAAgB,UAAU,CAAC;;;;;;;;;AAUhE,SAAgB,0BACd,YACA,oBAC0B;AAC1B,8BAA6B,oBAAoB,WAAW;CAC5D,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;CAC3C,MAAM,iBAAiB,0BAA0B,mBAAmB;AAEpE,MAAK,MAAM,QAAQ,sBAAsB;EACvC,MAAM,WAAW,KAAK,aAAa,KAAK;AAGxC,MAAI,SAAS,gBAAgB,aAAa,eACxC;AAGF,MAAI,SAAA,eAAoC,SAAS,gBAAgB,WAAW;GAC1E,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"}

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

@@ -1,12 +1,13 @@
-import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "./workspace.js";
-import { dirname, join } from "node:path";
+import { markBootstrapSeeded, resolveWorkspaceStatePathForMarkdownWorkspace } from "./workspace-state.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { execFileSync } from "node:child_process";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { execFileSync } from "node:child_process";
 //#region src/agent/context/workspace-seed.ts
 /**
 * Seed profile Markdown files into `agents/<agentId>/profile/` (and optionally `git init` the Markdown workspace).
@@ -80,7 +81,10 @@ function seedAgentProfileMarkdownFiles(profileDir, markdownWorkspaceDir, options
 			log.warn({ name }, "Missing workspace template file; skip seeding");
 			continue;
 		}
-		if (writeFileIfMissing(targetPath, name === WORKSPACE_FILES.IDENTITY ? personalizeIdentityTemplate(tpl, options?.displayName) : tpl)) seeded++;
+		if (writeFileIfMissing(targetPath, name === WORKSPACE_FILES.IDENTITY ? personalizeIdentityTemplate(tpl, options?.displayName) : tpl)) {
+			seeded++;
+			if (name === WORKSPACE_FILES.BOOTSTRAP) markBootstrapSeeded(resolveWorkspaceStatePathForMarkdownWorkspace(markdownWorkspaceDir));
+		}
 	}
 	if (seeded > 0) log.info({
 		profileDir,

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

@@ -1 +1 @@
-{"version":3,"file":"workspace-seed.js","names":[],"sources":["../../../../src/agent/context/workspace-seed.ts"],"sourcesContent":["/**\n * Seed profile Markdown files into `agents/<agentId>/profile/` (and optionally `git init` the Markdown workspace).\n * Resolution order per file: `XOPC_TEMPLATE_PATH` or repo `docs/reference/templates`, then bundled `./workspace-templates/`.\n */\n\nimport { execFileSync } from 'node:child_process';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { Config } from '../../config/schema.js';\nimport { DEFAULT_AGENT_ID, resolveAgentProfileDir, resolveAgentWorkspaceDir } from '../agent-scope.js';\nimport { WORKSPACE_FILES } from '../../config/paths.js';\nimport { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from './workspace.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('WorkspaceSeed');\n\n/** Marker in bundled/reference `IDENTITY.md` templates; replaced on agent creation when a display name is known. */\nexport const IDENTITY_NAME_PLACEHOLDER = '_(pick something you like)_';\n\nexport type SeedWorkspaceProfileMarkdownOptions = {\n  /** Fills the **Name** line in `IDENTITY.md` when the template still contains the placeholder. */\n  displayName?: string;\n};\n\n/** Files to copy when seeding a new agent (includes `BOOTSTRAP.md`, not part of system-prompt load order). */\nconst SEED_FILENAMES: readonly string[] = [...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, WORKSPACE_FILES.BOOTSTRAP];\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nfunction resolveBundledTemplatesDir(): string {\n  return join(__dirname, 'workspace-templates');\n}\n\n/** Walk ancestors for `docs/reference/templates` (dev checkout or local install with docs). */\nfunction resolveDocsTemplatesDirFromWalk(): string | null {\n  let dir = __dirname;\n  for (let i = 0; i < 12; i++) {\n    const candidate = join(dir, 'docs', 'reference', 'templates');\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/** Same convention as CLI `templates.ts`: env override, then docs tree, else null. */\nfunction resolvePrimaryTemplatesBaseDir(): string | null {\n  const envPath = process.env.XOPC_TEMPLATE_PATH?.trim();\n  if (envPath && existsSync(envPath)) {\n    return envPath;\n  }\n  return resolveDocsTemplatesDirFromWalk();\n}\n\nfunction readTemplate(name: string): string | null {\n  const primary = resolvePrimaryTemplatesBaseDir();\n  if (primary) {\n    const p = join(primary, name);\n    if (existsSync(p)) {\n      return readFileSync(p, 'utf-8');\n    }\n  }\n  const bundled = join(resolveBundledTemplatesDir(), name);\n  if (existsSync(bundled)) {\n    return readFileSync(bundled, 'utf-8');\n  }\n  return null;\n}\n\nfunction writeFileIfMissing(targetPath: string, content: string): boolean {\n  if (existsSync(targetPath)) {\n    return false;\n  }\n  writeFileSync(targetPath, content, 'utf-8');\n  return true;\n}\n\nfunction personalizeIdentityTemplate(content: string, displayName?: string): string {\n  const n = displayName?.trim();\n  if (!n || !content.includes(IDENTITY_NAME_PLACEHOLDER)) {\n    return content;\n  }\n  return content.replaceAll(IDENTITY_NAME_PLACEHOLDER, n);\n}\n\n/**\n * Seed profile Markdown into `profileDir` (`agents/<id>/profile/`).\n * When `markdownWorkspaceDir` is set, runs `git init` on a brand-new Markdown workspace only (never under `profile/`).\n * Does not overwrite existing files.\n */\nexport function seedAgentProfileMarkdownFiles(\n  profileDir: string,\n  markdownWorkspaceDir: string,\n  options?: SeedWorkspaceProfileMarkdownOptions,\n): void {\n  const wsPreExisted = existsSync(markdownWorkspaceDir);\n  mkdirSync(profileDir, { recursive: true });\n  mkdirSync(markdownWorkspaceDir, { recursive: true });\n\n  const isBrandNewWorkspace = !wsPreExisted;\n\n  let seeded = 0;\n  for (const name of SEED_FILENAMES) {\n    const targetPath = join(profileDir, name);\n    const tpl = readTemplate(name);\n    if (!tpl) {\n      log.warn({ name }, 'Missing workspace template file; skip seeding');\n      continue;\n    }\n    const body =\n      name === WORKSPACE_FILES.IDENTITY ? personalizeIdentityTemplate(tpl, options?.displayName) : tpl;\n    if (writeFileIfMissing(targetPath, body)) {\n      seeded++;\n    }\n  }\n\n  if (seeded > 0) {\n    log.info({ profileDir, seeded }, 'Seeded profile Markdown files');\n  }\n\n  ensureGitRepo(markdownWorkspaceDir, isBrandNewWorkspace);\n}\n\n/** Attempt `git init` on a brand-new Markdown workspace; silently skip on failure. */\nfunction ensureGitRepo(markdownWorkspaceDir: string, isBrandNew: boolean): void {\n  if (!isBrandNew) {\n    return;\n  }\n  if (existsSync(join(markdownWorkspaceDir, '.git'))) {\n    return;\n  }\n  try {\n    execFileSync('git', ['init'], { cwd: markdownWorkspaceDir, stdio: 'ignore', timeout: 5_000 });\n    log.info({ markdownWorkspaceDir }, 'Initialized git repo in Markdown workspace');\n  } catch {\n    log.debug({ markdownWorkspaceDir }, 'git init skipped (git not available or failed)');\n  }\n}\n\n/**\n * Ensure default (`main`) agent has reference profile Markdown templates (missing files only).\n */\nexport function seedMainAgentProfileMarkdown(cfg: Config): void {\n  seedAgentProfileMarkdownFiles(\n    resolveAgentProfileDir(cfg, DEFAULT_AGENT_ID),\n    resolveAgentWorkspaceDir(cfg, DEFAULT_AGENT_ID),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;kBAWuG;YAC/C;aAEH;AAErD,MAAM,MAAM,aAAa,gBAAgB;;AAGzC,MAAa,4BAA4B;;AAQzC,MAAM,iBAAoC,CAAC,GAAG,qCAAqC,gBAAgB,UAAU;AAE7G,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAEzD,SAAS,6BAAqC;AAC5C,QAAO,KAAK,WAAW,sBAAsB;;;AAI/C,SAAS,kCAAiD;CACxD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,YAAY,KAAK,KAAK,QAAQ,aAAa,YAAY;AAC7D,MAAI,WAAW,UAAU,CACvB,QAAO;EAET,MAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,WAAW,IAAK;AACpB,QAAM;;AAER,QAAO;;;AAIT,SAAS,iCAAgD;CACvD,MAAM,UAAU,QAAQ,IAAI,oBAAoB,MAAM;AACtD,KAAI,WAAW,WAAW,QAAQ,CAChC,QAAO;AAET,QAAO,iCAAiC;;AAG1C,SAAS,aAAa,MAA6B;CACjD,MAAM,UAAU,gCAAgC;AAChD,KAAI,SAAS;EACX,MAAM,IAAI,KAAK,SAAS,KAAK;AAC7B,MAAI,WAAW,EAAE,CACf,QAAO,aAAa,GAAG,QAAQ;;CAGnC,MAAM,UAAU,KAAK,4BAA4B,EAAE,KAAK;AACxD,KAAI,WAAW,QAAQ,CACrB,QAAO,aAAa,SAAS,QAAQ;AAEvC,QAAO;;AAGT,SAAS,mBAAmB,YAAoB,SAA0B;AACxE,KAAI,WAAW,WAAW,CACxB,QAAO;AAET,eAAc,YAAY,SAAS,QAAQ;AAC3C,QAAO;;AAGT,SAAS,4BAA4B,SAAiB,aAA8B;CAClF,MAAM,IAAI,aAAa,MAAM;AAC7B,KAAI,CAAC,KAAK,CAAC,QAAQ,SAAA,8BAAmC,CACpD,QAAO;AAET,QAAO,QAAQ,WAAW,2BAA2B,EAAE;;;;;;;AAQzD,SAAgB,8BACd,YACA,sBACA,SACM;CACN,MAAM,eAAe,WAAW,qBAAqB;AACrD,WAAU,YAAY,EAAE,WAAW,MAAM,CAAC;AAC1C,WAAU,sBAAsB,EAAE,WAAW,MAAM,CAAC;CAEpD,MAAM,sBAAsB,CAAC;CAE7B,IAAI,SAAS;AACb,MAAK,MAAM,QAAQ,gBAAgB;EACjC,MAAM,aAAa,KAAK,YAAY,KAAK;EACzC,MAAM,MAAM,aAAa,KAAK;AAC9B,MAAI,CAAC,KAAK;AACR,OAAI,KAAK,EAAE,MAAM,EAAE,gDAAgD;AACnE;;AAIF,MAAI,mBAAmB,YADrB,SAAS,gBAAgB,WAAW,4BAA4B,KAAK,SAAS,YAAY,GAAG,IACvD,CACtC;;AAIJ,KAAI,SAAS,EACX,KAAI,KAAK;EAAE;EAAY;EAAQ,EAAE,gCAAgC;AAGnE,eAAc,sBAAsB,oBAAoB;;;AAI1D,SAAS,cAAc,sBAA8B,YAA2B;AAC9E,KAAI,CAAC,WACH;AAEF,KAAI,WAAW,KAAK,sBAAsB,OAAO,CAAC,CAChD;AAEF,KAAI;AACF,eAAa,OAAO,CAAC,OAAO,EAAE;GAAE,KAAK;GAAsB,OAAO;GAAU,SAAS;GAAO,CAAC;AAC7F,MAAI,KAAK,EAAE,sBAAsB,EAAE,6CAA6C;SAC1E;AACN,MAAI,MAAM,EAAE,sBAAsB,EAAE,iDAAiD;;;;;;AAOzF,SAAgB,6BAA6B,KAAmB;AAC9D,+BACE,uBAAuB,KAAK,iBAAiB,EAC7C,yBAAyB,KAAK,iBAAiB,CAChD"}
+{"version":3,"file":"workspace-seed.js","names":[],"sources":["../../../../src/agent/context/workspace-seed.ts"],"sourcesContent":["/**\n * Seed profile Markdown files into `agents/<agentId>/profile/` (and optionally `git init` the Markdown workspace).\n * Resolution order per file: `XOPC_TEMPLATE_PATH` or repo `docs/reference/templates`, then bundled `./workspace-templates/`.\n */\n\nimport { execFileSync } from 'node:child_process';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { Config } from '../../config/schema.js';\nimport { DEFAULT_AGENT_ID, resolveAgentProfileDir, resolveAgentWorkspaceDir } from '../agent-scope.js';\nimport { WORKSPACE_FILES } from '../../config/paths.js';\nimport { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from './workspace.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  markBootstrapSeeded,\n  resolveWorkspaceStatePathForMarkdownWorkspace,\n} from './workspace-state.js';\n\nconst log = createLogger('WorkspaceSeed');\n\n/** Marker in bundled/reference `IDENTITY.md` templates; replaced on agent creation when a display name is known. */\nexport const IDENTITY_NAME_PLACEHOLDER = '_(pick something you like)_';\n\nexport type SeedWorkspaceProfileMarkdownOptions = {\n  /** Fills the **Name** line in `IDENTITY.md` when the template still contains the placeholder. */\n  displayName?: string;\n};\n\n/** Files to copy when seeding a new agent (includes `BOOTSTRAP.md`, not part of system-prompt load order). */\nconst SEED_FILENAMES: readonly string[] = [...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, WORKSPACE_FILES.BOOTSTRAP];\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nfunction resolveBundledTemplatesDir(): string {\n  return join(__dirname, 'workspace-templates');\n}\n\n/** Walk ancestors for `docs/reference/templates` (dev checkout or local install with docs). */\nfunction resolveDocsTemplatesDirFromWalk(): string | null {\n  let dir = __dirname;\n  for (let i = 0; i < 12; i++) {\n    const candidate = join(dir, 'docs', 'reference', 'templates');\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/** Same convention as CLI `templates.ts`: env override, then docs tree, else null. */\nfunction resolvePrimaryTemplatesBaseDir(): string | null {\n  const envPath = process.env.XOPC_TEMPLATE_PATH?.trim();\n  if (envPath && existsSync(envPath)) {\n    return envPath;\n  }\n  return resolveDocsTemplatesDirFromWalk();\n}\n\nfunction readTemplate(name: string): string | null {\n  const primary = resolvePrimaryTemplatesBaseDir();\n  if (primary) {\n    const p = join(primary, name);\n    if (existsSync(p)) {\n      return readFileSync(p, 'utf-8');\n    }\n  }\n  const bundled = join(resolveBundledTemplatesDir(), name);\n  if (existsSync(bundled)) {\n    return readFileSync(bundled, 'utf-8');\n  }\n  return null;\n}\n\nfunction writeFileIfMissing(targetPath: string, content: string): boolean {\n  if (existsSync(targetPath)) {\n    return false;\n  }\n  writeFileSync(targetPath, content, 'utf-8');\n  return true;\n}\n\nfunction personalizeIdentityTemplate(content: string, displayName?: string): string {\n  const n = displayName?.trim();\n  if (!n || !content.includes(IDENTITY_NAME_PLACEHOLDER)) {\n    return content;\n  }\n  return content.replaceAll(IDENTITY_NAME_PLACEHOLDER, n);\n}\n\n/**\n * Seed profile Markdown into `profileDir` (`agents/<id>/profile/`).\n * When `markdownWorkspaceDir` is set, runs `git init` on a brand-new Markdown workspace only (never under `profile/`).\n * Does not overwrite existing files.\n */\nexport function seedAgentProfileMarkdownFiles(\n  profileDir: string,\n  markdownWorkspaceDir: string,\n  options?: SeedWorkspaceProfileMarkdownOptions,\n): void {\n  const wsPreExisted = existsSync(markdownWorkspaceDir);\n  mkdirSync(profileDir, { recursive: true });\n  mkdirSync(markdownWorkspaceDir, { recursive: true });\n\n  const isBrandNewWorkspace = !wsPreExisted;\n\n  let seeded = 0;\n  for (const name of SEED_FILENAMES) {\n    const targetPath = join(profileDir, name);\n    const tpl = readTemplate(name);\n    if (!tpl) {\n      log.warn({ name }, 'Missing workspace template file; skip seeding');\n      continue;\n    }\n    const body =\n      name === WORKSPACE_FILES.IDENTITY ? personalizeIdentityTemplate(tpl, options?.displayName) : tpl;\n    if (writeFileIfMissing(targetPath, body)) {\n      seeded++;\n      // Track bootstrap seeding in workspace state\n      if (name === WORKSPACE_FILES.BOOTSTRAP) {\n        markBootstrapSeeded(resolveWorkspaceStatePathForMarkdownWorkspace(markdownWorkspaceDir));\n      }\n    }\n  }\n\n  if (seeded > 0) {\n    log.info({ profileDir, seeded }, 'Seeded profile Markdown files');\n  }\n\n  ensureGitRepo(markdownWorkspaceDir, isBrandNewWorkspace);\n}\n\n/** Attempt `git init` on a brand-new Markdown workspace; silently skip on failure. */\nfunction ensureGitRepo(markdownWorkspaceDir: string, isBrandNew: boolean): void {\n  if (!isBrandNew) {\n    return;\n  }\n  if (existsSync(join(markdownWorkspaceDir, '.git'))) {\n    return;\n  }\n  try {\n    execFileSync('git', ['init'], { cwd: markdownWorkspaceDir, stdio: 'ignore', timeout: 5_000 });\n    log.info({ markdownWorkspaceDir }, 'Initialized git repo in Markdown workspace');\n  } catch {\n    log.debug({ markdownWorkspaceDir }, 'git init skipped (git not available or failed)');\n  }\n}\n\n/**\n * Ensure default (`main`) agent has reference profile Markdown templates (missing files only).\n */\nexport function seedMainAgentProfileMarkdown(cfg: Config): void {\n  seedAgentProfileMarkdownFiles(\n    resolveAgentProfileDir(cfg, DEFAULT_AGENT_ID),\n    resolveAgentWorkspaceDir(cfg, DEFAULT_AGENT_ID),\n  );\n}"],"mappings":";;;;;;;;;;;;;;;kBAWuG;YAC/C;aAEH;AAMrD,MAAM,MAAM,aAAa,gBAAgB;;AAGzC,MAAa,4BAA4B;;AAQzC,MAAM,iBAAoC,CAAC,GAAG,qCAAqC,gBAAgB,UAAU;AAE7G,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAEzD,SAAS,6BAAqC;AAC5C,QAAO,KAAK,WAAW,sBAAsB;;;AAI/C,SAAS,kCAAiD;CACxD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,YAAY,KAAK,KAAK,QAAQ,aAAa,YAAY;AAC7D,MAAI,WAAW,UAAU,CACvB,QAAO;EAET,MAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,WAAW,IAAK;AACpB,QAAM;;AAER,QAAO;;;AAIT,SAAS,iCAAgD;CACvD,MAAM,UAAU,QAAQ,IAAI,oBAAoB,MAAM;AACtD,KAAI,WAAW,WAAW,QAAQ,CAChC,QAAO;AAET,QAAO,iCAAiC;;AAG1C,SAAS,aAAa,MAA6B;CACjD,MAAM,UAAU,gCAAgC;AAChD,KAAI,SAAS;EACX,MAAM,IAAI,KAAK,SAAS,KAAK;AAC7B,MAAI,WAAW,EAAE,CACf,QAAO,aAAa,GAAG,QAAQ;;CAGnC,MAAM,UAAU,KAAK,4BAA4B,EAAE,KAAK;AACxD,KAAI,WAAW,QAAQ,CACrB,QAAO,aAAa,SAAS,QAAQ;AAEvC,QAAO;;AAGT,SAAS,mBAAmB,YAAoB,SAA0B;AACxE,KAAI,WAAW,WAAW,CACxB,QAAO;AAET,eAAc,YAAY,SAAS,QAAQ;AAC3C,QAAO;;AAGT,SAAS,4BAA4B,SAAiB,aAA8B;CAClF,MAAM,IAAI,aAAa,MAAM;AAC7B,KAAI,CAAC,KAAK,CAAC,QAAQ,SAAA,8BAAmC,CACpD,QAAO;AAET,QAAO,QAAQ,WAAW,2BAA2B,EAAE;;;;;;;AAQzD,SAAgB,8BACd,YACA,sBACA,SACM;CACN,MAAM,eAAe,WAAW,qBAAqB;AACrD,WAAU,YAAY,EAAE,WAAW,MAAM,CAAC;AAC1C,WAAU,sBAAsB,EAAE,WAAW,MAAM,CAAC;CAEpD,MAAM,sBAAsB,CAAC;CAE7B,IAAI,SAAS;AACb,MAAK,MAAM,QAAQ,gBAAgB;EACjC,MAAM,aAAa,KAAK,YAAY,KAAK;EACzC,MAAM,MAAM,aAAa,KAAK;AAC9B,MAAI,CAAC,KAAK;AACR,OAAI,KAAK,EAAE,MAAM,EAAE,gDAAgD;AACnE;;AAIF,MAAI,mBAAmB,YADrB,SAAS,gBAAgB,WAAW,4BAA4B,KAAK,SAAS,YAAY,GAAG,IACvD,EAAE;AACxC;AAEA,OAAI,SAAS,gBAAgB,UAC3B,qBAAoB,8CAA8C,qBAAqB,CAAC;;;AAK9F,KAAI,SAAS,EACX,KAAI,KAAK;EAAE;EAAY;EAAQ,EAAE,gCAAgC;AAGnE,eAAc,sBAAsB,oBAAoB;;;AAI1D,SAAS,cAAc,sBAA8B,YAA2B;AAC9E,KAAI,CAAC,WACH;AAEF,KAAI,WAAW,KAAK,sBAAsB,OAAO,CAAC,CAChD;AAEF,KAAI;AACF,eAAa,OAAO,CAAC,OAAO,EAAE;GAAE,KAAK;GAAsB,OAAO;GAAU,SAAS;GAAO,CAAC;AAC7F,MAAI,KAAK,EAAE,sBAAsB,EAAE,6CAA6C;SAC1E;AACN,MAAI,MAAM,EAAE,sBAAsB,EAAE,iDAAiD;;;;;;AAOzF,SAAgB,6BAA6B,KAAmB;AAC9D,+BACE,uBAAuB,KAAK,iBAAiB,EAC7C,yBAAyB,KAAK,iBAAiB,CAChD"}

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

@@ -0,0 +1,52 @@
+/**
+ * Workspace bootstrap state machine — OpenClaw-aligned.
+ *
+ * Tracks BOOTSTRAP.md lifecycle in `<markdownWorkspace>/.xopc/workspace.json`
+ * (same path as `resolveWorkspaceStatePath` / `xopc init`).
+ *
+ * Motivation: BOOTSTRAP.md instructs the agent to delete itself after setup,
+ * but that is unreliable (LLM-dependent). This module provides a runtime-level
+ * state machine so the system can track whether bootstrap was completed
+ * regardless of whether the agent actually deleted the file.
+ */
+import type { Config } from '../../config/schema.js';
+import { resolveWorkspaceStatePath } from '../../config/paths.js';
+export { resolveWorkspaceStatePath };
+export interface WorkspaceSetupState {
+    version: number;
+    /** Set by `xopc init` for the agent id owning this workspace. */
+    agentId?: string;
+    /** ISO timestamp when profile Markdown was first seeded (init / agents add). */
+    profileMarkdownSeededAt?: string;
+    /** ISO timestamp when BOOTSTRAP.md was first seeded into the profile. */
+    bootstrapSeededAt?: string;
+    /** ISO timestamp when bootstrap setup was completed (BOOTSTRAP.md workflow finished). */
+    setupCompletedAt?: string;
+}
+/** Resolve workspace state path when only the Markdown workspace root is known. */
+export declare function resolveWorkspaceStatePathForMarkdownWorkspace(markdownWorkspaceDir: string): string;
+/** Resolve workspace state path from config + agent id. */
+export declare function resolveAgentWorkspaceStatePath(config: Config, agentId: string): string;
+/**
+ * Check whether the workspace bootstrap setup has been completed.
+ * Returns true when `setupCompletedAt` is set in the state file.
+ */
+export declare function isWorkspaceSetupCompleted(statePath: string): boolean;
+/**
+ * Check whether BOOTSTRAP.md is still pending (seeded but not completed).
+ * Works even if the file was already deleted by the agent — the state file is authoritative.
+ */
+export declare function isWorkspaceBootstrapPending(statePath: string): boolean;
+/**
+ * When BOOTSTRAP.md was seeded but the file is now gone, treat setup as completed.
+ * Idempotent; safe to call before loading bootstrap files or listing profile files.
+ */
+export declare function syncBootstrapSetupCompletion(statePath: string, profileDir: string): void;
+/**
+ * Mark BOOTSTRAP.md as seeded (call when workspace-seed.ts writes the file).
+ */
+export declare function markBootstrapSeeded(statePath: string): void;
+/**
+ * Mark bootstrap setup as completed.
+ */
+export declare function markSetupCompleted(statePath: string): void;

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

@@ -0,0 +1,101 @@
+import { FILENAMES, WORKSPACE_FILES, init_paths, resolveWorkspaceStatePath } from "../../config/paths.js";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/agent/context/workspace-state.ts
+/**
+* Workspace bootstrap state machine — OpenClaw-aligned.
+*
+* Tracks BOOTSTRAP.md lifecycle in `<markdownWorkspace>/.xopc/workspace.json`
+* (same path as `resolveWorkspaceStatePath` / `xopc init`).
+*
+* Motivation: BOOTSTRAP.md instructs the agent to delete itself after setup,
+* but that is unreliable (LLM-dependent). This module provides a runtime-level
+* state machine so the system can track whether bootstrap was completed
+* regardless of whether the agent actually deleted the file.
+*/
+init_paths();
+const WORKSPACE_STATE_VERSION = 1;
+function parseWorkspaceState(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		if (!parsed || typeof parsed !== "object") return null;
+		return {
+			version: WORKSPACE_STATE_VERSION,
+			agentId: typeof parsed.agentId === "string" ? parsed.agentId : void 0,
+			profileMarkdownSeededAt: typeof parsed.profileMarkdownSeededAt === "string" ? parsed.profileMarkdownSeededAt : void 0,
+			bootstrapSeededAt: typeof parsed.bootstrapSeededAt === "string" ? parsed.bootstrapSeededAt : void 0,
+			setupCompletedAt: typeof parsed.setupCompletedAt === "string" ? parsed.setupCompletedAt : void 0
+		};
+	} catch {
+		return null;
+	}
+}
+function readWorkspaceState(statePath) {
+	try {
+		return parseWorkspaceState(readFileSync(statePath, "utf-8")) ?? { version: WORKSPACE_STATE_VERSION };
+	} catch (err) {
+		if (err.code !== "ENOENT") throw err;
+		return { version: WORKSPACE_STATE_VERSION };
+	}
+}
+function writeWorkspaceState(statePath, patch) {
+	const merged = {
+		...readWorkspaceState(statePath),
+		...patch,
+		version: WORKSPACE_STATE_VERSION
+	};
+	mkdirSync(dirname(statePath), { recursive: true });
+	writeFileSync(statePath, `${JSON.stringify(merged, null, 2)}\n`, "utf-8");
+}
+/** Resolve workspace state path when only the Markdown workspace root is known. */
+function resolveWorkspaceStatePathForMarkdownWorkspace(markdownWorkspaceDir) {
+	return join(markdownWorkspaceDir, ".xopc", FILENAMES.WORKSPACE_STATE);
+}
+/** Resolve workspace state path from config + agent id. */
+function resolveAgentWorkspaceStatePath(config, agentId) {
+	return resolveWorkspaceStatePath(config, agentId);
+}
+/**
+* Check whether the workspace bootstrap setup has been completed.
+* Returns true when `setupCompletedAt` is set in the state file.
+*/
+function isWorkspaceSetupCompleted(statePath) {
+	const state = readWorkspaceState(statePath);
+	return typeof state.setupCompletedAt === "string" && state.setupCompletedAt.trim().length > 0;
+}
+/**
+* Check whether BOOTSTRAP.md is still pending (seeded but not completed).
+* Works even if the file was already deleted by the agent — the state file is authoritative.
+*/
+function isWorkspaceBootstrapPending(statePath) {
+	const state = readWorkspaceState(statePath);
+	if (typeof state.setupCompletedAt === "string" && state.setupCompletedAt.trim().length > 0) return false;
+	return typeof state.bootstrapSeededAt === "string";
+}
+/**
+* When BOOTSTRAP.md was seeded but the file is now gone, treat setup as completed.
+* Idempotent; safe to call before loading bootstrap files or listing profile files.
+*/
+function syncBootstrapSetupCompletion(statePath, profileDir) {
+	if (isWorkspaceSetupCompleted(statePath)) return;
+	if (existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP))) return;
+	if (!readWorkspaceState(statePath).bootstrapSeededAt) return;
+	markSetupCompleted(statePath);
+}
+/**
+* Mark BOOTSTRAP.md as seeded (call when workspace-seed.ts writes the file).
+*/
+function markBootstrapSeeded(statePath) {
+	if (readWorkspaceState(statePath).bootstrapSeededAt) return;
+	writeWorkspaceState(statePath, { bootstrapSeededAt: (/* @__PURE__ */ new Date()).toISOString() });
+}
+/**
+* Mark bootstrap setup as completed.
+*/
+function markSetupCompleted(statePath) {
+	writeWorkspaceState(statePath, { setupCompletedAt: (/* @__PURE__ */ new Date()).toISOString() });
+}
+//#endregion
+export { isWorkspaceBootstrapPending, isWorkspaceSetupCompleted, markBootstrapSeeded, markSetupCompleted, resolveAgentWorkspaceStatePath, resolveWorkspaceStatePath, resolveWorkspaceStatePathForMarkdownWorkspace, syncBootstrapSetupCompletion };
+
+//# sourceMappingURL=workspace-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state.js","names":[],"sources":["../../../../src/agent/context/workspace-state.ts"],"sourcesContent":["/**\n * Workspace bootstrap state machine — OpenClaw-aligned.\n *\n * Tracks BOOTSTRAP.md lifecycle in `<markdownWorkspace>/.xopc/workspace.json`\n * (same path as `resolveWorkspaceStatePath` / `xopc init`).\n *\n * Motivation: BOOTSTRAP.md instructs the agent to delete itself after setup,\n * but that is unreliable (LLM-dependent). This module provides a runtime-level\n * state machine so the system can track whether bootstrap was completed\n * regardless of whether the agent actually deleted the file.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { FILENAMES, WORKSPACE_FILES, resolveWorkspaceStatePath } from '../../config/paths.js';\n\nexport { resolveWorkspaceStatePath };\n\nconst WORKSPACE_STATE_VERSION = 1;\n\nexport interface WorkspaceSetupState {\n  version: number;\n  /** Set by `xopc init` for the agent id owning this workspace. */\n  agentId?: string;\n  /** ISO timestamp when profile Markdown was first seeded (init / agents add). */\n  profileMarkdownSeededAt?: string;\n  /** ISO timestamp when BOOTSTRAP.md was first seeded into the profile. */\n  bootstrapSeededAt?: string;\n  /** ISO timestamp when bootstrap setup was completed (BOOTSTRAP.md workflow finished). */\n  setupCompletedAt?: string;\n}\n\nfunction parseWorkspaceState(raw: string): WorkspaceSetupState | null {\n  try {\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    if (!parsed || typeof parsed !== 'object') {\n      return null;\n    }\n    return {\n      version: WORKSPACE_STATE_VERSION,\n      agentId: typeof parsed.agentId === 'string' ? parsed.agentId : undefined,\n      profileMarkdownSeededAt:\n        typeof parsed.profileMarkdownSeededAt === 'string' ? parsed.profileMarkdownSeededAt : undefined,\n      bootstrapSeededAt:\n        typeof parsed.bootstrapSeededAt === 'string' ? parsed.bootstrapSeededAt : undefined,\n      setupCompletedAt: typeof parsed.setupCompletedAt === 'string' ? parsed.setupCompletedAt : undefined,\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction readWorkspaceState(statePath: string): WorkspaceSetupState {\n  try {\n    const raw = readFileSync(statePath, 'utf-8');\n    return parseWorkspaceState(raw) ?? { version: WORKSPACE_STATE_VERSION };\n  } catch (err: unknown) {\n    const code = (err as { code?: string }).code;\n    if (code !== 'ENOENT') {\n      throw err;\n    }\n    return { version: WORKSPACE_STATE_VERSION };\n  }\n}\n\nfunction writeWorkspaceState(statePath: string, patch: Partial<WorkspaceSetupState>): void {\n  const merged = { ...readWorkspaceState(statePath), ...patch, version: WORKSPACE_STATE_VERSION };\n  mkdirSync(dirname(statePath), { recursive: true });\n  writeFileSync(statePath, `${JSON.stringify(merged, null, 2)}\\n`, 'utf-8');\n}\n\n/** Resolve workspace state path when only the Markdown workspace root is known. */\nexport function resolveWorkspaceStatePathForMarkdownWorkspace(markdownWorkspaceDir: string): string {\n  return join(markdownWorkspaceDir, '.xopc', FILENAMES.WORKSPACE_STATE);\n}\n\n/** Resolve workspace state path from config + agent id. */\nexport function resolveAgentWorkspaceStatePath(config: Config, agentId: string): string {\n  return resolveWorkspaceStatePath(config, agentId);\n}\n\n/**\n * Check whether the workspace bootstrap setup has been completed.\n * Returns true when `setupCompletedAt` is set in the state file.\n */\nexport function isWorkspaceSetupCompleted(statePath: string): boolean {\n  const state = readWorkspaceState(statePath);\n  return typeof state.setupCompletedAt === 'string' && state.setupCompletedAt.trim().length > 0;\n}\n\n/**\n * Check whether BOOTSTRAP.md is still pending (seeded but not completed).\n * Works even if the file was already deleted by the agent — the state file is authoritative.\n */\nexport function isWorkspaceBootstrapPending(statePath: string): boolean {\n  const state = readWorkspaceState(statePath);\n  if (typeof state.setupCompletedAt === 'string' && state.setupCompletedAt.trim().length > 0) {\n    return false;\n  }\n  return typeof state.bootstrapSeededAt === 'string';\n}\n\n/**\n * When BOOTSTRAP.md was seeded but the file is now gone, treat setup as completed.\n * Idempotent; safe to call before loading bootstrap files or listing profile files.\n */\nexport function syncBootstrapSetupCompletion(statePath: string, profileDir: string): void {\n  if (isWorkspaceSetupCompleted(statePath)) {\n    return;\n  }\n  if (existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP))) {\n    return;\n  }\n  const state = readWorkspaceState(statePath);\n  if (!state.bootstrapSeededAt) {\n    return;\n  }\n  markSetupCompleted(statePath);\n}\n\n/**\n * Mark BOOTSTRAP.md as seeded (call when workspace-seed.ts writes the file).\n */\nexport function markBootstrapSeeded(statePath: string): void {\n  const state = readWorkspaceState(statePath);\n  if (state.bootstrapSeededAt) {\n    return;\n  }\n  writeWorkspaceState(statePath, { bootstrapSeededAt: new Date().toISOString() });\n}\n\n/**\n * Mark bootstrap setup as completed.\n */\nexport function markSetupCompleted(statePath: string): void {\n  writeWorkspaceState(statePath, { setupCompletedAt: new Date().toISOString() });\n}\n"],"mappings":";;;;;;;;;;;;;;;YAgB8F;AAI9F,MAAM,0BAA0B;AAchC,SAAS,oBAAoB,KAAyC;AACpE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;AAET,SAAO;GACL,SAAS;GACT,SAAS,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU,KAAA;GAC/D,yBACE,OAAO,OAAO,4BAA4B,WAAW,OAAO,0BAA0B,KAAA;GACxF,mBACE,OAAO,OAAO,sBAAsB,WAAW,OAAO,oBAAoB,KAAA;GAC5E,kBAAkB,OAAO,OAAO,qBAAqB,WAAW,OAAO,mBAAmB,KAAA;GAC3F;SACK;AACN,SAAO;;;AAIX,SAAS,mBAAmB,WAAwC;AAClE,KAAI;AAEF,SAAO,oBADK,aAAa,WAAW,QACN,CAAC,IAAI,EAAE,SAAS,yBAAyB;UAChE,KAAc;AAErB,MADc,IAA0B,SAC3B,SACX,OAAM;AAER,SAAO,EAAE,SAAS,yBAAyB;;;AAI/C,SAAS,oBAAoB,WAAmB,OAA2C;CACzF,MAAM,SAAS;EAAE,GAAG,mBAAmB,UAAU;EAAE,GAAG;EAAO,SAAS;EAAyB;AAC/F,WAAU,QAAQ,UAAU,EAAE,EAAE,WAAW,MAAM,CAAC;AAClD,eAAc,WAAW,GAAG,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC,KAAK,QAAQ;;;AAI3E,SAAgB,8CAA8C,sBAAsC;AAClG,QAAO,KAAK,sBAAsB,SAAS,UAAU,gBAAgB;;;AAIvE,SAAgB,+BAA+B,QAAgB,SAAyB;AACtF,QAAO,0BAA0B,QAAQ,QAAQ;;;;;;AAOnD,SAAgB,0BAA0B,WAA4B;CACpE,MAAM,QAAQ,mBAAmB,UAAU;AAC3C,QAAO,OAAO,MAAM,qBAAqB,YAAY,MAAM,iBAAiB,MAAM,CAAC,SAAS;;;;;;AAO9F,SAAgB,4BAA4B,WAA4B;CACtE,MAAM,QAAQ,mBAAmB,UAAU;AAC3C,KAAI,OAAO,MAAM,qBAAqB,YAAY,MAAM,iBAAiB,MAAM,CAAC,SAAS,EACvF,QAAO;AAET,QAAO,OAAO,MAAM,sBAAsB;;;;;;AAO5C,SAAgB,6BAA6B,WAAmB,YAA0B;AACxF,KAAI,0BAA0B,UAAU,CACtC;AAEF,KAAI,WAAW,KAAK,YAAY,gBAAgB,UAAU,CAAC,CACzD;AAGF,KAAI,CADU,mBAAmB,UACvB,CAAC,kBACT;AAEF,oBAAmB,UAAU;;;;;AAM/B,SAAgB,oBAAoB,WAAyB;AAE3D,KADc,mBAAmB,UACxB,CAAC,kBACR;AAEF,qBAAoB,WAAW,EAAE,oCAAmB,IAAI,MAAM,EAAC,aAAa,EAAE,CAAC;;;;;AAMjF,SAAgB,mBAAmB,WAAyB;AAC1D,qBAAoB,WAAW,EAAE,mCAAkB,IAAI,MAAM,EAAC,aAAa,EAAE,CAAC"}

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

@@ -1,8 +1,8 @@
 export { PiTranscriptManager, CURRENT_SESSION_VERSION } from './pi-transcript.js';
 export type { SessionManager as PiTranscriptManagerType } from './pi-transcript.js';
 export { installSessionToolResultGuard, guardSessionManager, getRawSessionAppendMessage, type GuardedPiTranscriptManager, type ToolResultGuardOptions, } from './session-tool-result-guard.js';
-export { prepareSessionManagerForRun } from './session-manager-init.js';
-export { trackSessionManagerAccess, prewarmSessionFile, isSessionManagerCached, } from './session-manager-cache.js';
+export { repairAssistantUsageInSessionManager } from './session-manager-init.js';
+export { openSqliteHydratingSessionManager } from './sqlite-hydrating-session-manager.js';
 export { acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, } from './session-runner.js';
 export { DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, resolveLiveToolResultMaxChars, truncateToolResultMessage, } from './tool-result-truncation.js';
 export { runXopcEmbeddedTurn, abortEmbeddedRun, queueEmbeddedSteer } from './run-turn.js';