@xopcai/xopc 0.0.94 → 0.0.96

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

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,

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

@@ -1 +1 @@
-{"version":3,"file":"run-turn.js","names":[],"sources":["../../../../src/agent/embedded/run-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ImageContent, Model, Api } from '@earendil-works/pi-ai';\n\nimport { createLogger } from '../../utils/logger.js';\nimport { registerEmbeddedRun, unregisterEmbeddedRun } from './runs.js';\nimport { subscribeEmbeddedSessionEvents, lastAssistantPlainText } from './subscribe-session.js';\nimport type { RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport {\n  getAssistantTurnErrorMessage,\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport { runAgentTurnWithTimeout, resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { detectToolLoops, type RecentToolCall } from '../orchestration/loop-guard.js';\nimport {\n  acquireEmbeddedSessionRunner,\n  resolveEmbeddedTranscriptInputs,\n} from './session-runner.js';\nimport { wrapStreamFnForXopcExtensions } from './xopc-stream-bridge.js';\n\nconst log = createLogger('EmbeddedRun');\nconst LOG_PREVIEW_MAX_CHARS = 300;\n\nfunction truncateForLog(value: string, maxChars = LOG_PREVIEW_MAX_CHARS): string {\n  return value.length > maxChars ? `${value.slice(0, maxChars)}…` : value;\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter((block): block is { type: string; text: string } => {\n      return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n    })\n    .map((block) => block.text)\n    .join('');\n}\n\nfunction extractRecentToolCalls(messages: readonly { role?: string; content?: unknown }[]): RecentToolCall[] {\n  const calls: RecentToolCall[] = [];\n  for (const message of messages) {\n    if (message.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    for (const block of message.content) {\n      if (block && typeof block === 'object' && (block as { type?: string }).type === 'toolCall') {\n        const toolCall = block as { name: string; arguments: unknown };\n        calls.push({ name: toolCall.name, params: toolCall.arguments });\n      }\n    }\n  }\n  return calls;\n}\n\nfunction getLastUserMessagePreview(messages: readonly { role?: string; content?: unknown }[]): string | undefined {\n  for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex--) {\n    const message = messages[messageIndex];\n    if (message?.role !== 'user') {\n      continue;\n    }\n    const text = extractTextFromContent(message.content).trim();\n    return text ? truncateForLog(text) : undefined;\n  }\n  return undefined;\n}\n\nfunction requireEmbeddedModel(model: Model<Api> | undefined, modelRef: string): Model<Api> {\n  if (!model?.id || !model?.provider) {\n    throw new Error(`Invalid model for embedded run: ${modelRef}`);\n  }\n  return model;\n}\n\nfunction userMessageToPromptText(message: AgentMessage): string {\n  const content = (message as { content?: unknown }).content;\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (Array.isArray(content)) {\n    return content\n      .filter((block): block is { type: 'text'; text: string } => {\n        return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n      })\n      .map((block) => block.text)\n      .join('');\n  }\n  return '';\n}\n\nfunction userMessageToPromptImages(message: AgentMessage): ImageContent[] {\n  const content = (message as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return [];\n  }\n\n  const images: ImageContent[] = [];\n  for (const block of content) {\n    if (!block || typeof block !== 'object') {\n      continue;\n    }\n    const typedBlock = block as { type?: string; data?: unknown; mimeType?: unknown };\n    if (typedBlock.type !== 'image' || typeof typedBlock.data !== 'string' || typedBlock.data.length === 0) {\n      continue;\n    }\n    images.push({\n      type: 'image',\n      data: typedBlock.data,\n      mimeType: typeof typedBlock.mimeType === 'string' ? typedBlock.mimeType : 'image/png',\n    });\n  }\n  return images;\n}\n\nexport async function runXopcEmbeddedTurn(params: RunXopcEmbeddedTurnParams): Promise<RunXopcEmbeddedTurnResult> {\n  const {\n    sessionKey,\n    runId,\n    userMessage,\n    model,\n    tools,\n    systemPrompt,\n    thinkingLevel,\n    workspaceDir,\n    sessionStore,\n    onEvent,\n  } = params;\n\n  const timeoutMs = params.timeoutMs || resolveAgentTurnTimeoutMs();\n  const resolvedModel = requireEmbeddedModel(model, params.modelRef);\n  const transcript = await resolveEmbeddedTranscriptInputs(sessionStore, sessionKey);\n\n  let runner: Awaited<ReturnType<typeof acquireEmbeddedSessionRunner>> | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  try {\n    runner = await acquireEmbeddedSessionRunner({\n      sessionKey,\n      sessionId: transcript.sessionId,\n      sessionFile: transcript.sessionFile,\n      sessionsDir: transcript.sessionsDir,\n      hadSessionFile: transcript.hadSessionFile,\n      workspaceDir,\n      model: resolvedModel,\n      modelRef: params.modelRef,\n      tools,\n      systemPrompt,\n      thinkingLevel: thinkingLevel ?? 'medium',\n    });\n\n    const { session, reused } = runner;\n\n    const streamFnWithXopcExtensions = wrapStreamFnForXopcExtensions(session.agent.streamFn);\n    const loggingStreamFn: typeof session.agent.streamFn = (streamModel, context, options) => {\n      const recentToolCalls = extractRecentToolCalls(context.messages);\n      const loopGuard = detectToolLoops(recentToolCalls);\n\n      let effectiveContext = context;\n      if (loopGuard.injection || loopGuard.hiddenTools.size > 0) {\n        const messages = loopGuard.injection\n          ? [...context.messages, { role: 'user' as const, content: loopGuard.injection, timestamp: Date.now() }]\n          : context.messages;\n\n        const contextTools = loopGuard.hiddenTools.size > 0 && context.tools\n          ? context.tools.filter((t) => !loopGuard.hiddenTools.has(t.name))\n          : context.tools;\n\n        effectiveContext = { ...context, messages, tools: contextTools };\n      }\n\n      log.debug(\n        {\n          sessionKey,\n          runId,\n          reusedRunner: reused,\n          modelRef: `${streamModel.provider}/${streamModel.id}`,\n          systemPromptLength: effectiveContext.systemPrompt?.length ?? 0,\n          messageCount: effectiveContext.messages.length,\n          toolCount: effectiveContext.tools?.length ?? 0,\n          lastUserMessagePreview: getLastUserMessagePreview(effectiveContext.messages),\n          loopWarningInjected: !!loopGuard.injection,\n          hiddenToolCount: loopGuard.hiddenTools.size,\n        },\n        'Sending messages to AI',\n      );\n      return streamFnWithXopcExtensions(streamModel, effectiveContext, options);\n    };\n    session.agent.streamFn = loggingStreamFn;\n\n    if (onEvent) {\n      unsubscribe = subscribeEmbeddedSessionEvents(session, onEvent);\n    }\n\n    const handle = {\n      sessionKey,\n      sessionId: transcript.sessionId,\n      runId,\n      session,\n      abort: async () => {\n        await session.abort();\n      },\n    };\n    registerEmbeddedRun(handle);\n\n    const abortListener = () => {\n      void session.abort();\n    };\n    if (params.abortSignal) {\n      if (params.abortSignal.aborted) {\n        await session.abort();\n        return { ok: false, errorMessage: 'aborted' };\n      }\n      params.abortSignal.addEventListener('abort', abortListener, { once: true });\n    }\n\n    try {\n      await runAgentTurnWithTimeout(\n        session.agent,\n        async () => {\n          const text = userMessageToPromptText(userMessage);\n          const images = [...(params.images ?? []), ...userMessageToPromptImages(userMessage)];\n          await session.prompt(text, images.length > 0 ? { images } : undefined);\n          await session.agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(session.agent, { sessionKey, log });\n        },\n        timeoutMs,\n      );\n\n      if (isAssistantTurnAborted(session.agent)) {\n        return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n      }\n      if (isAssistantTurnFailed(session.agent)) {\n        return {\n          ok: false,\n          errorMessage: getAssistantTurnErrorMessage(session.agent) ?? 'Assistant turn failed',\n          lastAssistantText: lastAssistantPlainText(session),\n        };\n      }\n\n      return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n    } finally {\n      params.abortSignal?.removeEventListener('abort', abortListener);\n      unregisterEmbeddedRun(handle);\n    }\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    log.error({ err, sessionKey, runId }, `Embedded run failed: ${em}`);\n    onEvent?.({ type: 'error', content: em });\n    return { ok: false, errorMessage: em };\n  } finally {\n    unsubscribe?.();\n    try {\n      runner?.piSm.flushPendingToolResults?.();\n    } catch {\n      /* ignore */\n    }\n    runner?.release();\n  }\n}\n\nexport { abortEmbeddedRun, queueEmbeddedSteer } from './runs.js';\n"],"mappings":"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"}
+{"version":3,"file":"run-turn.js","names":[],"sources":["../../../../src/agent/embedded/run-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ImageContent, Model, Api } from '@earendil-works/pi-ai';\n\nimport { createLogger } from '../../utils/logger.js';\nimport { registerEmbeddedRun, unregisterEmbeddedRun } from './runs.js';\nimport { subscribeEmbeddedSessionEvents, lastAssistantPlainText } from './subscribe-session.js';\nimport type { RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport {\n  getAssistantTurnErrorMessage,\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport { runAgentTurnWithTimeout, resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { detectToolLoops, type RecentToolCall } from '../orchestration/loop-guard.js';\nimport {\n  acquireEmbeddedSessionRunner,\n  resolveEmbeddedTranscriptInputs,\n} from './session-runner.js';\nimport { wrapStreamFnForXopcExtensions } from './xopc-stream-bridge.js';\n\nconst log = createLogger('EmbeddedRun');\nconst LOG_PREVIEW_MAX_CHARS = 300;\n\nfunction truncateForLog(value: string, maxChars = LOG_PREVIEW_MAX_CHARS): string {\n  return value.length > maxChars ? `${value.slice(0, maxChars)}…` : value;\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter((block): block is { type: string; text: string } => {\n      return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n    })\n    .map((block) => block.text)\n    .join('');\n}\n\nfunction extractRecentToolCalls(messages: readonly { role?: string; content?: unknown }[]): RecentToolCall[] {\n  const calls: RecentToolCall[] = [];\n  for (const message of messages) {\n    if (message.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    for (const block of message.content) {\n      if (block && typeof block === 'object' && (block as { type?: string }).type === 'toolCall') {\n        const toolCall = block as { name: string; arguments: unknown };\n        calls.push({ name: toolCall.name, params: toolCall.arguments });\n      }\n    }\n  }\n  return calls;\n}\n\nfunction getLastUserMessagePreview(messages: readonly { role?: string; content?: unknown }[]): string | undefined {\n  for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex--) {\n    const message = messages[messageIndex];\n    if (message?.role !== 'user') {\n      continue;\n    }\n    const text = extractTextFromContent(message.content).trim();\n    return text ? truncateForLog(text) : undefined;\n  }\n  return undefined;\n}\n\nfunction requireEmbeddedModel(model: Model<Api> | undefined, modelRef: string): Model<Api> {\n  if (!model?.id || !model?.provider) {\n    throw new Error(`Invalid model for embedded run: ${modelRef}`);\n  }\n  return model;\n}\n\nfunction userMessageToPromptText(message: AgentMessage): string {\n  const content = (message as { content?: unknown }).content;\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (Array.isArray(content)) {\n    return content\n      .filter((block): block is { type: 'text'; text: string } => {\n        return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n      })\n      .map((block) => block.text)\n      .join('');\n  }\n  return '';\n}\n\nfunction userMessageToPromptImages(message: AgentMessage): ImageContent[] {\n  const content = (message as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return [];\n  }\n\n  const images: ImageContent[] = [];\n  for (const block of content) {\n    if (!block || typeof block !== 'object') {\n      continue;\n    }\n    const typedBlock = block as { type?: string; data?: unknown; mimeType?: unknown };\n    if (typedBlock.type !== 'image' || typeof typedBlock.data !== 'string' || typedBlock.data.length === 0) {\n      continue;\n    }\n    images.push({\n      type: 'image',\n      data: typedBlock.data,\n      mimeType: typeof typedBlock.mimeType === 'string' ? typedBlock.mimeType : 'image/png',\n    });\n  }\n  return images;\n}\n\nexport async function runXopcEmbeddedTurn(params: RunXopcEmbeddedTurnParams): Promise<RunXopcEmbeddedTurnResult> {\n  const {\n    sessionKey,\n    runId,\n    userMessage,\n    model,\n    tools,\n    systemPrompt,\n    thinkingLevel,\n    workspaceDir,\n    sessionStore,\n    onEvent,\n  } = params;\n\n  const timeoutMs = params.timeoutMs || resolveAgentTurnTimeoutMs();\n  const resolvedModel = requireEmbeddedModel(model, params.modelRef);\n  const transcript = await resolveEmbeddedTranscriptInputs(sessionStore, sessionKey);\n\n  let runner: Awaited<ReturnType<typeof acquireEmbeddedSessionRunner>> | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  try {\n    runner = await acquireEmbeddedSessionRunner({\n      sessionKey,\n      sessionId: transcript.sessionId,\n      workspaceDir,\n      model: resolvedModel,\n      modelRef: params.modelRef,\n      tools,\n      systemPrompt,\n      thinkingLevel: thinkingLevel ?? 'medium',\n    });\n\n    const { session, reused } = runner;\n\n    const streamFnWithXopcExtensions = wrapStreamFnForXopcExtensions(session.agent.streamFn);\n    const loggingStreamFn: typeof session.agent.streamFn = (streamModel, context, options) => {\n      const recentToolCalls = extractRecentToolCalls(context.messages);\n      const loopGuard = detectToolLoops(recentToolCalls);\n\n      let effectiveContext = context;\n      if (loopGuard.injection || loopGuard.hiddenTools.size > 0) {\n        const messages = loopGuard.injection\n          ? [...context.messages, { role: 'user' as const, content: loopGuard.injection, timestamp: Date.now() }]\n          : context.messages;\n\n        const contextTools = loopGuard.hiddenTools.size > 0 && context.tools\n          ? context.tools.filter((t) => !loopGuard.hiddenTools.has(t.name))\n          : context.tools;\n\n        effectiveContext = { ...context, messages, tools: contextTools };\n      }\n\n      log.debug(\n        {\n          sessionKey,\n          runId,\n          reusedRunner: reused,\n          modelRef: `${streamModel.provider}/${streamModel.id}`,\n          systemPromptLength: effectiveContext.systemPrompt?.length ?? 0,\n          messageCount: effectiveContext.messages.length,\n          toolCount: effectiveContext.tools?.length ?? 0,\n          lastUserMessagePreview: getLastUserMessagePreview(effectiveContext.messages),\n          loopWarningInjected: !!loopGuard.injection,\n          hiddenToolCount: loopGuard.hiddenTools.size,\n        },\n        'Sending messages to AI',\n      );\n      return streamFnWithXopcExtensions(streamModel, effectiveContext, options);\n    };\n    session.agent.streamFn = loggingStreamFn;\n\n    if (onEvent) {\n      unsubscribe = subscribeEmbeddedSessionEvents(session, onEvent);\n    }\n\n    const handle = {\n      sessionKey,\n      sessionId: transcript.sessionId,\n      runId,\n      session,\n      abort: async () => {\n        await session.abort();\n      },\n    };\n    registerEmbeddedRun(handle);\n\n    const abortListener = () => {\n      void session.abort();\n    };\n    if (params.abortSignal) {\n      if (params.abortSignal.aborted) {\n        await session.abort();\n        return { ok: false, errorMessage: 'aborted' };\n      }\n      params.abortSignal.addEventListener('abort', abortListener, { once: true });\n    }\n\n    try {\n      await runAgentTurnWithTimeout(\n        session.agent,\n        async () => {\n          const text = userMessageToPromptText(userMessage);\n          const images = [...(params.images ?? []), ...userMessageToPromptImages(userMessage)];\n          await session.prompt(text, images.length > 0 ? { images } : undefined);\n          await session.agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(session.agent, { sessionKey, log });\n        },\n        timeoutMs,\n      );\n\n      if (isAssistantTurnAborted(session.agent)) {\n        return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n      }\n      if (isAssistantTurnFailed(session.agent)) {\n        return {\n          ok: false,\n          errorMessage: getAssistantTurnErrorMessage(session.agent) ?? 'Assistant turn failed',\n          lastAssistantText: lastAssistantPlainText(session),\n        };\n      }\n\n      return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n    } finally {\n      params.abortSignal?.removeEventListener('abort', abortListener);\n      unregisterEmbeddedRun(handle);\n    }\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    log.error({ err, sessionKey, runId }, `Embedded run failed: ${em}`);\n    onEvent?.({ type: 'error', content: em });\n    return { ok: false, errorMessage: em };\n  } finally {\n    unsubscribe?.();\n    try {\n      runner?.piSm.flushPendingToolResults?.();\n    } catch {\n      /* ignore */\n    }\n    runner?.release();\n  }\n}\n\nexport { abortEmbeddedRun, queueEmbeddedSteer } from './runs.js';\n"],"mappings":"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"}

package/dist/src/agent/embedded/session-manager-init.d.ts

@@ -2,20 +2,3 @@
  * Legacy xopc transcripts may omit `usage` on assistant rows; pi AgentSession crashes on turn end.
  */
 export declare function repairAssistantUsageInSessionManager(sessionManager: unknown): void;
-/**
- * pi-coding-agent SessionManager persistence quirk:
- * - If the file exists but has no assistant message, SessionManager marks itself `flushed=true`
- *   and will never persist the initial user message.
- * - If the file doesn't exist yet, SessionManager builds a new session in memory and flushes
- *   header+user+assistant once the first assistant arrives (good).
- *
- * This normalizes the file/session state so the first user prompt is persisted before the first
- * assistant entry, even for pre-created session files.
- */
-export declare function prepareSessionManagerForRun(params: {
-    sessionManager: unknown;
-    sessionFile: string;
-    hadSessionFile: boolean;
-    sessionId: string;
-    cwd: string;
-}): Promise<void>;

package/dist/src/agent/embedded/session-manager-init.js

@@ -1,4 +1,3 @@
-import fs from "node:fs/promises";
 //#region src/agent/embedded/session-manager-init.ts
 /** pi-coding-agent auto-compaction calls `calculateContextTokens(usage)` without a null check. */
 const EMPTY_ASSISTANT_USAGE = {
@@ -45,41 +44,7 @@ function repairAssistantUsageInSessionManager(sessionManager) {
 		}
 	}
 }
-/**
-* pi-coding-agent SessionManager persistence quirk:
-* - If the file exists but has no assistant message, SessionManager marks itself `flushed=true`
-*   and will never persist the initial user message.
-* - If the file doesn't exist yet, SessionManager builds a new session in memory and flushes
-*   header+user+assistant once the first assistant arrives (good).
-*
-* This normalizes the file/session state so the first user prompt is persisted before the first
-* assistant entry, even for pre-created session files.
-*/
-async function prepareSessionManagerForRun(params) {
-	const sm = params.sessionManager;
-	const header = sm.fileEntries.find((e) => e.type === "session");
-	const hasAssistant = sm.fileEntries.some((e) => e.type === "message" && e.message?.role === "assistant");
-	if (!params.hadSessionFile && header) {
-		header.id = params.sessionId;
-		header.cwd = params.cwd;
-		sm.sessionId = params.sessionId;
-		return;
-	}
-	if (params.hadSessionFile && header && !hasAssistant) {
-		try {
-			await fs.unlink(params.sessionFile);
-		} catch (err) {
-			if (err.code !== "ENOENT") throw err;
-		}
-		sm.fileEntries = [header];
-		sm.byId?.clear?.();
-		sm.labelsById?.clear?.();
-		sm.leafId = null;
-		sm.flushed = false;
-	}
-	repairAssistantUsageInSessionManager(sm);
-}
 //#endregion
-export { prepareSessionManagerForRun, repairAssistantUsageInSessionManager };
+export { repairAssistantUsageInSessionManager };
 
 //# sourceMappingURL=session-manager-init.js.map

package/dist/src/agent/embedded/session-manager-init.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager-init.js","names":[],"sources":["../../../../src/agent/embedded/session-manager-init.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\n\ntype SessionHeaderEntry = { type: \"session\"; id?: string; cwd?: string };\ntype SessionMessageEntry = {\n  type: \"message\";\n  message?: {\n    role?: string;\n    stopReason?: string;\n    usage?: Record<string, unknown>;\n  };\n};\n\n/** pi-coding-agent auto-compaction calls `calculateContextTokens(usage)` without a null check. */\nconst EMPTY_ASSISTANT_USAGE = {\n  input: 0,\n  output: 0,\n  cacheRead: 0,\n  cacheWrite: 0,\n  totalTokens: 0,\n  cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\n/**\n * Legacy xopc transcripts may omit `usage` on assistant rows; pi AgentSession crashes on turn end.\n */\nexport function repairAssistantUsageInSessionManager(sessionManager: unknown): void {\n  const sm = sessionManager as { fileEntries?: Array<SessionHeaderEntry | SessionMessageEntry | { type: string }> };\n  if (!Array.isArray(sm.fileEntries)) {\n    return;\n  }\n  for (const entry of sm.fileEntries) {\n    if (entry.type !== \"message\") {\n      continue;\n    }\n    const msg = (entry as SessionMessageEntry).message;\n    if (msg?.role !== \"assistant\") {\n      continue;\n    }\n    if (msg.stopReason === \"aborted\" || msg.stopReason === \"error\") {\n      continue;\n    }\n    if (!msg.usage || typeof msg.usage !== \"object\") {\n      msg.usage = { ...EMPTY_ASSISTANT_USAGE };\n    } else if (msg.usage.totalTokens === undefined) {\n      const u = msg.usage;\n      const input = typeof u.input === \"number\" ? u.input : 0;\n      const output = typeof u.output === \"number\" ? u.output : 0;\n      const cacheRead = typeof u.cacheRead === \"number\" ? u.cacheRead : 0;\n      const cacheWrite = typeof u.cacheWrite === \"number\" ? u.cacheWrite : 0;\n      msg.usage = {\n        ...EMPTY_ASSISTANT_USAGE,\n        ...u,\n        input,\n        output,\n        cacheRead,\n        cacheWrite,\n        totalTokens: input + output + cacheRead + cacheWrite,\n      };\n    }\n  }\n}\n\n/**\n * pi-coding-agent SessionManager persistence quirk:\n * - If the file exists but has no assistant message, SessionManager marks itself `flushed=true`\n *   and will never persist the initial user message.\n * - If the file doesn't exist yet, SessionManager builds a new session in memory and flushes\n *   header+user+assistant once the first assistant arrives (good).\n *\n * This normalizes the file/session state so the first user prompt is persisted before the first\n * assistant entry, even for pre-created session files.\n */\nexport async function prepareSessionManagerForRun(params: {\n  sessionManager: unknown;\n  sessionFile: string;\n  hadSessionFile: boolean;\n  sessionId: string;\n  cwd: string;\n}): Promise<void> {\n  const sm = params.sessionManager as {\n    sessionId: string;\n    flushed: boolean;\n    fileEntries: Array<SessionHeaderEntry | SessionMessageEntry | { type: string }>;\n    byId?: Map<string, unknown>;\n    labelsById?: Map<string, unknown>;\n    leafId?: string | null;\n  };\n\n  const header = sm.fileEntries.find((e): e is SessionHeaderEntry => e.type === \"session\");\n  const hasAssistant = sm.fileEntries.some(\n    (e) => e.type === \"message\" && (e as SessionMessageEntry).message?.role === \"assistant\",\n  );\n\n  if (!params.hadSessionFile && header) {\n    header.id = params.sessionId;\n    header.cwd = params.cwd;\n    sm.sessionId = params.sessionId;\n    return;\n  }\n\n  if (params.hadSessionFile && header && !hasAssistant) {\n    // Remove the pre-created transcript so pi SessionManager can create it with O_EXCL\n    // on the first assistant flush (pi-coding-agent 0.77+ uses open(..., \"wx\") there).\n    try {\n      await fs.unlink(params.sessionFile);\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException).code;\n      if (code !== \"ENOENT\") {\n        throw err;\n      }\n    }\n    sm.fileEntries = [header];\n    sm.byId?.clear?.();\n    sm.labelsById?.clear?.();\n    sm.leafId = null;\n    sm.flushed = false;\n  }\n\n  repairAssistantUsageInSessionManager(sm);\n}\n"],"mappings":";;;AAaA,MAAM,wBAAwB;CAC5B,OAAO;CACP,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,aAAa;CACb,MAAM;EAAE,OAAO;EAAG,QAAQ;EAAG,WAAW;EAAG,YAAY;EAAG,OAAO;EAAG;CACrE;;;;AAKD,SAAgB,qCAAqC,gBAA+B;CAClF,MAAM,KAAK;AACX,KAAI,CAAC,MAAM,QAAQ,GAAG,YAAY,CAChC;AAEF,MAAK,MAAM,SAAS,GAAG,aAAa;AAClC,MAAI,MAAM,SAAS,UACjB;EAEF,MAAM,MAAO,MAA8B;AAC3C,MAAI,KAAK,SAAS,YAChB;AAEF,MAAI,IAAI,eAAe,aAAa,IAAI,eAAe,QACrD;AAEF,MAAI,CAAC,IAAI,SAAS,OAAO,IAAI,UAAU,SACrC,KAAI,QAAQ,EAAE,GAAG,uBAAuB;WAC/B,IAAI,MAAM,gBAAgB,KAAA,GAAW;GAC9C,MAAM,IAAI,IAAI;GACd,MAAM,QAAQ,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ;GACtD,MAAM,SAAS,OAAO,EAAE,WAAW,WAAW,EAAE,SAAS;GACzD,MAAM,YAAY,OAAO,EAAE,cAAc,WAAW,EAAE,YAAY;GAClE,MAAM,aAAa,OAAO,EAAE,eAAe,WAAW,EAAE,aAAa;AACrE,OAAI,QAAQ;IACV,GAAG;IACH,GAAG;IACH;IACA;IACA;IACA;IACA,aAAa,QAAQ,SAAS,YAAY;IAC3C;;;;;;;;;;;;;;AAeP,eAAsB,4BAA4B,QAMhC;CAChB,MAAM,KAAK,OAAO;CASlB,MAAM,SAAS,GAAG,YAAY,MAAM,MAA+B,EAAE,SAAS,UAAU;CACxF,MAAM,eAAe,GAAG,YAAY,MACjC,MAAM,EAAE,SAAS,aAAc,EAA0B,SAAS,SAAS,YAC7E;AAED,KAAI,CAAC,OAAO,kBAAkB,QAAQ;AACpC,SAAO,KAAK,OAAO;AACnB,SAAO,MAAM,OAAO;AACpB,KAAG,YAAY,OAAO;AACtB;;AAGF,KAAI,OAAO,kBAAkB,UAAU,CAAC,cAAc;AAGpD,MAAI;AACF,SAAM,GAAG,OAAO,OAAO,YAAY;WAC5B,KAAK;AAEZ,OADc,IAA8B,SAC/B,SACX,OAAM;;AAGV,KAAG,cAAc,CAAC,OAAO;AACzB,KAAG,MAAM,SAAS;AAClB,KAAG,YAAY,SAAS;AACxB,KAAG,SAAS;AACZ,KAAG,UAAU;;AAGf,sCAAqC,GAAG"}
+{"version":3,"file":"session-manager-init.js","names":[],"sources":["../../../../src/agent/embedded/session-manager-init.ts"],"sourcesContent":["type SessionHeaderEntry = { type: \"session\"; id?: string; cwd?: string };\ntype SessionMessageEntry = {\n  type: \"message\";\n  message?: {\n    role?: string;\n    stopReason?: string;\n    usage?: Record<string, unknown>;\n  };\n};\n\n/** pi-coding-agent auto-compaction calls `calculateContextTokens(usage)` without a null check. */\nconst EMPTY_ASSISTANT_USAGE = {\n  input: 0,\n  output: 0,\n  cacheRead: 0,\n  cacheWrite: 0,\n  totalTokens: 0,\n  cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\n/**\n * Legacy xopc transcripts may omit `usage` on assistant rows; pi AgentSession crashes on turn end.\n */\nexport function repairAssistantUsageInSessionManager(sessionManager: unknown): void {\n  const sm = sessionManager as { fileEntries?: Array<SessionHeaderEntry | SessionMessageEntry | { type: string }> };\n  if (!Array.isArray(sm.fileEntries)) {\n    return;\n  }\n  for (const entry of sm.fileEntries) {\n    if (entry.type !== \"message\") {\n      continue;\n    }\n    const msg = (entry as SessionMessageEntry).message;\n    if (msg?.role !== \"assistant\") {\n      continue;\n    }\n    if (msg.stopReason === \"aborted\" || msg.stopReason === \"error\") {\n      continue;\n    }\n    if (!msg.usage || typeof msg.usage !== \"object\") {\n      msg.usage = { ...EMPTY_ASSISTANT_USAGE };\n    } else if (msg.usage.totalTokens === undefined) {\n      const u = msg.usage;\n      const input = typeof u.input === \"number\" ? u.input : 0;\n      const output = typeof u.output === \"number\" ? u.output : 0;\n      const cacheRead = typeof u.cacheRead === \"number\" ? u.cacheRead : 0;\n      const cacheWrite = typeof u.cacheWrite === \"number\" ? u.cacheWrite : 0;\n      msg.usage = {\n        ...EMPTY_ASSISTANT_USAGE,\n        ...u,\n        input,\n        output,\n        cacheRead,\n        cacheWrite,\n        totalTokens: input + output + cacheRead + cacheWrite,\n      };\n    }\n  }\n}\n"],"mappings":";;AAWA,MAAM,wBAAwB;CAC5B,OAAO;CACP,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,aAAa;CACb,MAAM;EAAE,OAAO;EAAG,QAAQ;EAAG,WAAW;EAAG,YAAY;EAAG,OAAO;EAAG;CACrE;;;;AAKD,SAAgB,qCAAqC,gBAA+B;CAClF,MAAM,KAAK;AACX,KAAI,CAAC,MAAM,QAAQ,GAAG,YAAY,CAChC;AAEF,MAAK,MAAM,SAAS,GAAG,aAAa;AAClC,MAAI,MAAM,SAAS,UACjB;EAEF,MAAM,MAAO,MAA8B;AAC3C,MAAI,KAAK,SAAS,YAChB;AAEF,MAAI,IAAI,eAAe,aAAa,IAAI,eAAe,QACrD;AAEF,MAAI,CAAC,IAAI,SAAS,OAAO,IAAI,UAAU,SACrC,KAAI,QAAQ,EAAE,GAAG,uBAAuB;WAC/B,IAAI,MAAM,gBAAgB,KAAA,GAAW;GAC9C,MAAM,IAAI,IAAI;GACd,MAAM,QAAQ,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ;GACtD,MAAM,SAAS,OAAO,EAAE,WAAW,WAAW,EAAE,SAAS;GACzD,MAAM,YAAY,OAAO,EAAE,cAAc,WAAW,EAAE,YAAY;GAClE,MAAM,aAAa,OAAO,EAAE,eAAe,WAAW,EAAE,aAAa;AACrE,OAAI,QAAQ;IACV,GAAG;IACH,GAAG;IACH;IACA;IACA;IACA;IACA,aAAa,QAAQ,SAAS,YAAY;IAC3C"}

package/dist/src/agent/embedded/session-runner.d.ts

@@ -3,9 +3,8 @@ import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
 import { type AgentSession } from '@earendil-works/pi-coding-agent';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import { type GuardedPiTranscriptManager } from './session-tool-result-guard.js';
-import { type SessionManagerCache } from './session-manager-cache.js';
 export type EmbeddedRunnerFingerprintInput = {
-    sessionFile: string;
+    sessionId: string;
     workspaceDir: string;
     modelRef: string;
     toolNames: readonly string[];
@@ -16,9 +15,6 @@ export declare function buildEmbeddedRunnerFingerprint(input: EmbeddedRunnerFing
 export type AcquireEmbeddedSessionRunnerParams = {
     sessionKey: string;
     sessionId: string;
-    sessionFile: string;
-    sessionsDir: string;
-    hadSessionFile: boolean;
     workspaceDir: string;
     model: Model<Api>;
     modelRef: string;
@@ -42,8 +38,6 @@ export interface EmbeddedSessionRunnerPoolStats {
 export declare function isEmbeddedSessionRunnerEnabled(): boolean;
 export declare function getEmbeddedSessionRunnerIdleTtlMs(): number;
 export interface EmbeddedSessionRunnerPoolOptions {
-    /** File-exists cache shared with prewarmSessionFile callers. */
-    sessionManagerCache?: SessionManagerCache;
     /** Override for the env-driven enable flag (testing). */
     isEnabled?: () => boolean;
     /** Override for the env-driven idle TTL (testing). */
@@ -56,7 +50,6 @@ export interface EmbeddedSessionRunnerPoolOptions {
  */
 export declare class EmbeddedSessionRunnerPool {
     private readonly pool;
-    private readonly cache;
     private readonly isEnabledFn;
     private readonly getIdleTtlMsFn;
     private stats;
@@ -77,10 +70,8 @@ export declare function resetEmbeddedSessionRunnerForTest(): void;
 export declare function evictEmbeddedSessionRunner(sessionKey: string, reason?: string): void;
 export declare function evictAllEmbeddedSessionRunners(reason?: string): void;
 export declare function acquireEmbeddedSessionRunner(params: AcquireEmbeddedSessionRunnerParams): Promise<AcquiredEmbeddedSessionRunner>;
-/** Resolve transcript path inputs used by both runner acquire and turn execution. */
+/** Resolve session identity used by embedded runner acquire and turn execution. */
 export declare function resolveEmbeddedTranscriptInputs(sessionStore: import('../../session/store.js').SessionStore, sessionKey: string): Promise<{
     sessionId: string;
-    sessionFile: string;
-    sessionsDir: string;
-    hadSessionFile: boolean;
+    sessionKey: string;
 }>;

package/dist/src/agent/embedded/session-runner.js

@@ -1,14 +1,12 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { guardSessionManager } from "./session-tool-result-guard.js";
-import { prepareSessionManagerForRun } from "./session-manager-init.js";
-import { defaultSessionManagerCache } from "./session-manager-cache.js";
+import { openSqliteHydratingSessionManager } from "./sqlite-hydrating-session-manager.js";
 import { applyXopcProviderApiKey, createEmbeddedAuthStorage } from "./xopc-auth-storage.js";
 import { wrapStreamFnForXopcExtensions } from "./xopc-stream-bridge.js";
 import { xopcToolsToDefinitions } from "./xopc-tools-bridge.js";
 import { applySystemPromptOverrideToSession } from "./system-prompt-override.js";
-import { existsSync } from "node:fs";
-import { DefaultResourceLoader, SessionManager, SettingsManager, createAgentSession, getAgentDir } from "@earendil-works/pi-coding-agent";
+import { DefaultResourceLoader, SettingsManager, createAgentSession, getAgentDir } from "@earendil-works/pi-coding-agent";
 //#region src/agent/embedded/session-runner.ts
 init_logger();
 const log = createLogger("EmbeddedSessionRunner");
@@ -17,7 +15,7 @@ function buildEmbeddedRunnerFingerprint(input) {
 	const tools = [...input.toolNames].sort().join("\0");
 	const promptMarker = `${input.systemPrompt.length}:${input.systemPrompt.slice(0, 128)}`;
 	return [
-		input.sessionFile,
+		input.sessionId,
 		input.workspaceDir,
 		input.modelRef,
 		tools,
@@ -48,7 +46,6 @@ function createEmbeddedSettingsManager(cwd) {
 */
 var EmbeddedSessionRunnerPool = class {
 	pool = /* @__PURE__ */ new Map();
-	cache;
 	isEnabledFn;
 	getIdleTtlMsFn;
 	stats = {
@@ -58,7 +55,6 @@ var EmbeddedSessionRunnerPool = class {
 		evictions: 0
 	};
 	constructor(opts = {}) {
-		this.cache = opts.sessionManagerCache ?? defaultSessionManagerCache;
 		this.isEnabledFn = opts.isEnabled ?? isEmbeddedSessionRunnerEnabled;
 		this.getIdleTtlMsFn = opts.getIdleTtlMs ?? getEmbeddedSessionRunnerIdleTtlMs;
 	}
@@ -89,7 +85,7 @@ var EmbeddedSessionRunnerPool = class {
 	async acquire(params) {
 		this.stats.acquires += 1;
 		const fingerprint = buildEmbeddedRunnerFingerprint({
-			sessionFile: params.sessionFile,
+			sessionId: params.sessionId,
 			workspaceDir: params.workspaceDir,
 			modelRef: params.modelRef,
 			toolNames: params.tools.map((t) => t.name),
@@ -157,19 +153,15 @@ var EmbeddedSessionRunnerPool = class {
 		}, "Embedded session runner evicted");
 	}
 	async createPooledRunner(params) {
-		const { sessionKey, sessionId, sessionFile, sessionsDir, hadSessionFile, workspaceDir, model, thinkingLevel, tools, systemPrompt } = params;
-		await this.cache.prewarm(sessionFile);
+		const { sessionKey, sessionId, workspaceDir, model, thinkingLevel, tools, systemPrompt } = params;
 		const settingsManager = createEmbeddedSettingsManager(workspaceDir);
-		const piSm = guardSessionManager(SessionManager.open(sessionFile, sessionsDir, workspaceDir), {
+		const piSm = guardSessionManager(openSqliteHydratingSessionManager({
 			sessionKey,
-			contextWindowTokens: model.contextWindow ?? 128e3
-		});
-		await prepareSessionManagerForRun({
-			sessionManager: piSm,
-			sessionFile,
-			hadSessionFile,
 			sessionId,
 			cwd: workspaceDir
+		}), {
+			sessionKey,
+			contextWindowTokens: model.contextWindow ?? 128e3
 		});
 		const toolDefs = xopcToolsToDefinitions(tools);
 		const toolNames = tools.map((t) => t.name);
@@ -200,7 +192,7 @@ var EmbeddedSessionRunnerPool = class {
 		return {
 			sessionKey,
 			fingerprint: buildEmbeddedRunnerFingerprint({
-				sessionFile,
+				sessionId,
 				workspaceDir,
 				modelRef: params.modelRef,
 				toolNames,
@@ -232,15 +224,9 @@ function evictAllEmbeddedSessionRunners(reason = "dispose_all") {
 function acquireEmbeddedSessionRunner(params) {
 	return defaultEmbeddedSessionRunnerPool.acquire(params);
 }
-/** Resolve transcript path inputs used by both runner acquire and turn execution. */
+/** Resolve session identity used by embedded runner acquire and turn execution. */
 async function resolveEmbeddedTranscriptInputs(sessionStore, sessionKey) {
-	const { sessionId, absPath: sessionFile, sessionsDir } = await sessionStore.resolveTranscriptPath(sessionKey);
-	return {
-		sessionId,
-		sessionFile,
-		sessionsDir,
-		hadSessionFile: existsSync(sessionFile)
-	};
+	return sessionStore.resolveTranscriptPath(sessionKey);
 }
 //#endregion
 export { EmbeddedSessionRunnerPool, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, defaultEmbeddedSessionRunnerPool, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs };