@xopcai/xopc 0.0.95 → 0.0.97

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":";;;;;;;;;;AA+CA,SAAS,gCAAgC,GAAmB;AAC1D,QAAO,EAAE,MAAM,CAAC,aAAa;;;AAI/B,SAAgB,iBAAiB,OAA0C;CACzE,MAAM,WAAW,SAAS,IAAI,MAAM;AACpC,KAAI,CAAC,QACH,QAAO;CAET,MAAM,aAAa,gCAAgC,QAAQ;AAC3D,KAAI,YAAY,KAAK,QAAQ,CAC3B,QAAO;AAET,QACE,WACG,QAAQ,kBAAkB,IAAI,CAC9B,QAAQ,iBAAiB,GAAG,CAC5B,QAAQ,kBAAkB,GAAG,CAC7B,MAAM,GAAG,GAAG,IAAA;;;;;;;AASnB,SAAgB,2BACd,YACA,0BAC8D;CAC9D,MAAM,WAAW,YAAY,MAAM;AACnC,KAAI,UAAU;EACZ,MAAM,KAAK,SAAS,aAAa;AACjC,MAAI,CAAC,mBAAmB,KAAK,GAAG,CAC9B,QAAO;GACL,IAAI;GACJ,OACE;GACH;AAEH,MAAI,OAAA,OACF,QAAO;GAAE,IAAI;GAAO,OAAO,IAAI,iBAAiB;GAAgB;AAElE,MAAI,2BAA2B,IAAI,GAAG,CACpC,QAAO;GAAE,IAAI;GAAO,OAAO,aAAa,GAAG;GAAuC;AAEpF,SAAO;GAAE,IAAI;GAAM,SAAS;GAAI;;CAGlC,MAAM,UAAU,iBAAiB,yBAAyB,MAAM,CAAC;AACjE,KAAI,YAAA,OACF,QAAO;EACL,IAAI;EACJ,OACE;EACH;AAEH,KAAI,2BAA2B,IAAI,QAAQ,CACzC,QAAO;EACL,IAAI;EACJ,OAAO,kCAAkC,QAAQ;EAClD;AAEH,KAAI,CAAC,mBAAmB,KAAK,QAAQ,CACnC,QAAO;EACL,IAAI;EACJ,OACE;EACH;AAEH,QAAO;EAAE,IAAI;EAAM;EAAS;;;AAI9B,SAAgB,gBAAgB,KAAqB;AAEnD,QAAO,QADU,0BAA0B,IAAI,MAAM,CAC9B,CAAC;;AAK1B,SAAgB,iBAAiB,KAA2B;CAC1D,MAAM,OAAO,IAAI,QAAQ;AACzB,KAAI,CAAC,MAAM,QAAQ,KAAK,CACtB,QAAO,EAAE;AAEX,QAAO,KAAK,QAAQ,MAAuB,QAAQ,KAAK,OAAO,MAAM,SAAS,CAAC;;AAGjF,SAAgB,sBAAsB,KAAqB;CACzD,MAAM,WAAW,IAAI,QAAQ,SAAS,MAAM;AAC5C,KAAI,SACF,QAAO,iBAAiB,SAAS;CAEnC,MAAM,SAAS,iBAAiB,IAAI;AACpC,KAAI,OAAO,WAAW,EACpB,QAAO;CAGT,MAAM,UADW,OAAO,QAAQ,MAAM,GAAG,YAAY,KAC7B,CAAC,MAAM,OAAO,KAAK,IAAI,MAAM;AACrD,QAAO,SAAS,iBAAiB,OAAO,GAAG;;AAG7C,SAAS,kBAAkB,KAAa,SAAyC;CAC/E,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,iBAAiB,IAAI,CAAC,MAAM,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;;;;;AAMzE,SAAgB,yBAAyB,KAAa,SAAyB;CAC7E,MAAM,KAAK,iBAAiB,QAAQ;CACpC,MAAM,aAAa,kBAAkB,KAAK,GAAG,EAAE,WAAW,MAAM;AAChE,KAAI,WACF,QAAO,gBAAgB,WAAW;CAEpC,MAAM,iBAAiB,sBAAsB,IAAI;CACjD,MAAM,WAAW,IAAI,QAAQ,UAAU,WAAW,MAAM;AACxD,KAAI,SACF,QAAO,KAAK,gBAAgB,SAAS,EAAE,GAAG;AAE5C,KAAI,OAAO,eACT,QAAO,gCAAgC,QAAQ,IAAI;AAGrD,QAAO,KADU,gBAAgB,QAAQ,IACrB,EAAE,aAAa,KAAK;;;;;AAM1C,SAAgB,gBAAgB,KAAa,SAAyB;CACpE,MAAM,KAAK,iBAAiB,QAAQ;CACpC,MAAM,aAAa,kBAAkB,KAAK,GAAG,EAAE,UAAU,MAAM;AAC/D,KAAI,WACF,QAAO,gBAAgB,WAAW;AAGpC,QAAO,KADM,gBAAgB,QAAQ,IACrB,EAAE,UAAU,IAAI,QAAQ;;;AAI1C,SAAgB,oBAAoB,KAAa,SAAyB;AACxE,QAAO,KAAK,gBAAgB,QAAQ,IAAI,EAAE,UAAU,iBAAiB,QAAQ,CAAC;;;AAIhF,SAAgB,uBAAuB,KAAa,SAAyB;AAC3E,QAAO,KAAK,oBAAoB,KAAK,QAAQ,EAAE,UAAU;;;AAI3D,SAAgB,gCAAgC,KAAa,SAAiB,UAA0B;CACtG,MAAM,OAAO,SAAS,SAAS,MAAM,CAAC,QAAQ,OAAO,IAAI,CAAC;AAC1D,QAAO,KAAK,uBAAuB,KAAK,QAAQ,EAAE,KAAK;;AAGzD,SAAS,2BAA2B,OAAuB;CACzD,MAAM,WAAW,QAAQ,gBAAgB,MAAM,CAAC;CAChD,IAAI,aAAa;AACjB,KAAI;AACF,eAAa,GAAG,aAAa,OAAO,SAAS;SACvC;AAGR,KAAI,QAAQ,aAAa,QACvB,QAAO,WAAW,aAAa;AAEjC,QAAO;;AAGT,SAAS,iBAAiB,eAAuB,UAA2B;CAC1E,MAAM,MAAM,SAAS,UAAU,cAAc;AAC7C,QAAO,QAAQ,MAAO,CAAC,IAAI,WAAW,KAAK,IAAI,CAAC,WAAW,IAAI;;;AAIjE,SAAgB,+BAA+B,KAAa,eAAiC;CAC3F,MAAM,0BAA0B,2BAA2B,cAAc;CACzE,MAAM,UAAU,iBAAiB,IAAI;CACrC,MAAM,UAAsE,EAAE;AAE9E,MAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,QAAQ,QAAQ;EACtB,MAAM,KAAK,iBAAiB,MAAM,GAAG;EACrC,MAAM,eAAe,2BAA2B,yBAAyB,KAAK,GAAG,CAAC;AAClF,MAAI,CAAC,iBAAiB,yBAAyB,aAAa,CAC1D;AAEF,UAAQ,KAAK;GAAE;GAAI;GAAc,OAAO;GAAO,CAAC;;CAGlD,MAAM,YAAY,sBAAsB,IAAI;AAC5C,KAAI,CAAC,QAAQ,MAAM,MAAM,iBAAiB,EAAE,GAAG,KAAK,UAAU,EAAE;EAC9D,MAAM,eAAe,2BAA2B,yBAAyB,KAAK,UAAU,CAAC;AACzF,MAAI,iBAAiB,yBAAyB,aAAa,CACzD,SAAQ,KAAK;GAAE,IAAI;GAAW;GAAc,OAAO,QAAQ;GAAQ,CAAC;;AAIxE,SAAQ,MAAM,MAAM,UAAU;EAC5B,MAAM,uBAAuB,MAAM,aAAa,SAAS,KAAK,aAAa;AAC3E,MAAI,yBAAyB,EAC3B,QAAO;AAET,SAAO,KAAK,QAAQ,MAAM;GAC1B;AAEF,QAAO,QAAQ,KAAK,UAAU,MAAM,GAAG;;;AAIzC,SAAgB,8BACd,KACA,eACoB;AACpB,QAAO,+BAA+B,KAAK,cAAc,CAAC;;;;;;AAO5D,SAAgB,+BAA+B,KAAa,uBAAuC;AACjG,QACE,8BAA8B,KAAK,sBAAsB,IACzD,sBAAsB,IAAI;;AAI9B,SAAgB,wBAAwB,KAAqB;AAC3D,QAAO,yBAAyB,KAAK,sBAAsB,IAAI,CAAC;;;;mBAjRP;sBACa;0BACU;AAErE,oBAAmB;AAE1B,eAAc;AACd,oBAAmB;AACnB,mBAAkB;AAClB,oBAAmB;AAGZ,sBAAqB;AAE5B,8BAA6B,IAAI,IAAY;EACjD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC"}

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

@@ -1,4 +1,6 @@
 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;
     sessionKey: string;

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,6 +9,12 @@ 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);
@@ -20,11 +27,13 @@ async function getOrLoadBootstrapFiles(params) {
 }
 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  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"}

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

@@ -1,6 +1,5 @@
 import type { Config } from '../../config/schema.js';
 import type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';
-export { isProfileBootstrapPending } from './load-bootstrap-files.js';
 export { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';
 export declare function resolveBootstrapFilesSync(params: {
     profileDir: string;
@@ -18,6 +17,7 @@ export declare function resolveBootstrapContextSync(params: {
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
+    contextInjection?: 'always' | 'continuation-skip' | 'never';
 }): {
     bootstrapFiles: WorkspaceBootstrapFile[];
     contextFiles: EmbeddedContextFile[];
@@ -27,6 +27,7 @@ export declare function resolveBootstrapContextForRun(params: {
     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 { loadProfileBootstrapFiles } 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";
 //#region src/agent/bootstrap/bootstrap-files.ts
@@ -19,27 +19,49 @@ async function resolveBootstrapFilesForRun(params) {
 	}) : loadProfileBootstrapFiles(params.profileDir), 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
-export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, isProfileBootstrapPending, resolveBootstrapContextForRun, resolveBootstrapContextSync, resolveBootstrapFilesForRun, resolveBootstrapFilesSync };
+export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, resolveBootstrapContextForRun, resolveBootstrapContextSync, resolveBootstrapFilesForRun, resolveBootstrapFilesSync };
 
 //# sourceMappingURL=bootstrap-files.js.map

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 { 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"}

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

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

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

@@ -1,17 +1,14 @@
-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 { 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 = [
+const PROFILE_LOAD_ORDER = [
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_SOUL_FILENAME,
 	DEFAULT_TOOLS_FILENAME,
 	DEFAULT_IDENTITY_FILENAME,
 	DEFAULT_USER_FILENAME,
 	DEFAULT_HEARTBEAT_FILENAME,
-	WORKSPACE_FILES.BOOTSTRAP,
 	DEFAULT_MEMORY_FILENAME
 ];
 function readProfileFile(filePath) {
@@ -22,19 +19,16 @@ function readProfileFile(filePath) {
 		return null;
 	}
 }
-function isProfileBootstrapPending(profileDir) {
-	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.
+* MEMORY.md is omitted when absent; other slots emit missing markers.
 */
 function loadProfileBootstrapFiles(profileDir) {
 	const resolvedDir = resolve(profileDir);
 	const result = [];
-	for (const name of BOOTSTRAP_LOAD_ORDER) {
+	for (const name of PROFILE_LOAD_ORDER) {
 		const filePath = join(resolvedDir, name);
-		if (name === "MEMORY.md" || name === WORKSPACE_FILES.BOOTSTRAP) {
+		if (name === "MEMORY.md") {
 			const content = readProfileFile(filePath);
 			if (content === null) continue;
 			result.push({
@@ -61,6 +55,6 @@ function loadProfileBootstrapFiles(profileDir) {
 	return result;
 }
 //#endregion
-export { isProfileBootstrapPending, loadProfileBootstrapFiles };
+export { loadProfileBootstrapFiles };
 
 //# 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 { 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 { 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"}

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

@@ -1,12 +1,12 @@
 import type { AgentProfileMarkdownFilename } from '../context/workspace.js';
-export type BootstrapFileName = AgentProfileMarkdownFilename | 'BOOTSTRAP.md';
-export interface WorkspaceBootstrapFile {
+export type BootstrapFileName = AgentProfileMarkdownFilename;
+export type WorkspaceBootstrapFile = {
     name: BootstrapFileName;
     path: string;
     content?: string;
     missing: boolean;
-}
-export interface EmbeddedContextFile {
+};
+export type EmbeddedContextFile = {
     path: string;
     content: string;
-}
+};

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

@@ -1,12 +1,12 @@
-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 { init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } 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 { 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).
@@ -18,8 +18,7 @@ init_logger();
 const log = createLogger("WorkspaceSeed");
 /** Marker in bundled/reference `IDENTITY.md` templates; replaced on agent creation when a display name is known. */
 const IDENTITY_NAME_PLACEHOLDER = "_(pick something you like)_";
-/** Files to copy when seeding a new agent (includes `BOOTSTRAP.md`, not part of system-prompt load order). */
-const SEED_FILENAMES = [...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, WORKSPACE_FILES.BOOTSTRAP];
+const SEED_FILENAMES = [...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES];
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function resolveBundledTemplatesDir() {
 	return join(__dirname, "workspace-templates");
@@ -107,7 +106,8 @@ function ensureGitRepo(markdownWorkspaceDir, isBrandNew) {
 * Ensure default (`main`) agent has reference profile Markdown templates (missing files only).
 */
 function seedMainAgentProfileMarkdown(cfg) {
-	seedAgentProfileMarkdownFiles(resolveAgentProfileDir(cfg, DEFAULT_AGENT_ID), resolveAgentWorkspaceDir(cfg, DEFAULT_AGENT_ID));
+	const agentId = resolveDefaultAgentId(cfg);
+	seedAgentProfileMarkdownFiles(resolveAgentProfileDir(cfg, agentId), resolveAgentWorkspaceDir(cfg, agentId), { displayName: agentId });
 }
 //#endregion
 export { IDENTITY_NAME_PLACEHOLDER, seedAgentProfileMarkdownFiles, seedMainAgentProfileMarkdown };

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 {\n  resolveAgentProfileDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n} 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\nconst SEED_FILENAMES: readonly string[] = [...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES];\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  const agentId = resolveDefaultAgentId(cfg);\n  seedAgentProfileMarkdownFiles(\n    resolveAgentProfileDir(cfg, agentId),\n    resolveAgentWorkspaceDir(cfg, agentId),\n    { displayName: agentId },\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;kBAe2B;YAC6B;aAEH;AAErD,MAAM,MAAM,aAAa,gBAAgB;;AAGzC,MAAa,4BAA4B;AAOzC,MAAM,iBAAoC,CAAC,GAAG,oCAAoC;AAElF,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;CAC9D,MAAM,UAAU,sBAAsB,IAAI;AAC1C,+BACE,uBAAuB,KAAK,QAAQ,EACpC,yBAAyB,KAAK,QAAQ,EACtC,EAAE,aAAa,SAAS,CACzB"}

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

@@ -0,0 +1,20 @@
+/**
+ * Workspace setup metadata in `<markdownWorkspace>/.xopc/workspace.json`
+ * (same path as `resolveWorkspaceStatePath` / `xopc init`).
+ */
+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;
+}
+/** 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;
+/** Record profile Markdown seed time (idempotent). */
+export declare function markProfileMarkdownSeeded(statePath: string): void;

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

@@ -0,0 +1,57 @@
+import { FILENAMES, init_paths, resolveWorkspaceStatePath } from "../../config/paths.js";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/agent/context/workspace-state.ts
+/**
+* Workspace setup metadata in `<markdownWorkspace>/.xopc/workspace.json`
+* (same path as `resolveWorkspaceStatePath` / `xopc init`).
+*/
+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
+		};
+	} 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);
+}
+/** Record profile Markdown seed time (idempotent). */
+function markProfileMarkdownSeeded(statePath) {
+	if (readWorkspaceState(statePath).profileMarkdownSeededAt) return;
+	writeWorkspaceState(statePath, { profileMarkdownSeededAt: (/* @__PURE__ */ new Date()).toISOString() });
+}
+//#endregion
+export { markProfileMarkdownSeeded, resolveAgentWorkspaceStatePath, resolveWorkspaceStatePath, resolveWorkspaceStatePathForMarkdownWorkspace };
+
+//# 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 setup metadata in `<markdownWorkspace>/.xopc/workspace.json`\n * (same path as `resolveWorkspaceStatePath` / `xopc init`).\n */\n\nimport { mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { FILENAMES, 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}\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    };\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/** Record profile Markdown seed time (idempotent). */\nexport function markProfileMarkdownSeeded(statePath: string): void {\n  const state = readWorkspaceState(statePath);\n  if (state.profileMarkdownSeededAt) {\n    return;\n  }\n  writeWorkspaceState(statePath, { profileMarkdownSeededAt: new Date().toISOString() });\n}\n"],"mappings":";;;;;;;;YAS6E;AAI7E,MAAM,0BAA0B;AAUhC,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;GACzF;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;;;AAInD,SAAgB,0BAA0B,WAAyB;AAEjE,KADc,mBAAmB,UACxB,CAAC,wBACR;AAEF,qBAAoB,WAAW,EAAE,0CAAyB,IAAI,MAAM,EAAC,aAAa,EAAE,CAAC"}

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

@@ -9,10 +9,6 @@ read_when:
 
 This folder is home. Treat it that way.
 
-## First Run
-
-If `BOOTSTRAP.md` exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.
-
 ## Session Startup
 
 Use runtime-provided startup context first.

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';

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

@@ -1,10 +1,10 @@
 import { DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
 import { getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard } from "./session-tool-result-guard.js";
-import { prepareSessionManagerForRun } from "./session-manager-init.js";
-import { isSessionManagerCached, prewarmSessionFile, trackSessionManagerAccess } from "./session-manager-cache.js";
+import { repairAssistantUsageInSessionManager } from "./session-manager-init.js";
+import { openSqliteHydratingSessionManager } from "./sqlite-hydrating-session-manager.js";
 import { acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs } from "./session-runner.js";
 import { abortEmbeddedRun, getEmbeddedRunBySessionKey, queueEmbeddedSteer, registerEmbeddedRun } from "./runs.js";
 import { runXopcEmbeddedTurn } from "./run-turn.js";
 import { runEmbeddedTurnForSession } from "./run-for-session.js";
 import { CURRENT_SESSION_VERSION, PiTranscriptManager } from "./pi-transcript.js";
-export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, isSessionManagerCached, prepareSessionManagerForRun, prewarmSessionFile, queueEmbeddedSteer, registerEmbeddedRun, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runXopcEmbeddedTurn, trackSessionManagerAccess, truncateToolResultMessage };
+export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, openSqliteHydratingSessionManager, queueEmbeddedSteer, registerEmbeddedRun, repairAssistantUsageInSessionManager, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runXopcEmbeddedTurn, truncateToolResultMessage };

package/dist/src/agent/embedded/run-turn.js

@@ -82,9 +82,6 @@ async function runXopcEmbeddedTurn(params) {
 		runner = await acquireEmbeddedSessionRunner({
 			sessionKey,
 			sessionId: transcript.sessionId,
-			sessionFile: transcript.sessionFile,
-			sessionsDir: transcript.sessionsDir,
-			hadSessionFile: transcript.hadSessionFile,
 			workspaceDir,
 			model: resolvedModel,
 			modelRef: params.modelRef,