@agimon-ai/po-runner 0.0.0-alpha.110 → 0.0.0-alpha.111

package/dist/bin/runnerHost.cjs

@@ -163,7 +163,7 @@ async function cleanupSessions(watches) {
 	const [first] = failures;
 	if (!first) return;
 	const log = await (telemetry ??= loadTelemetry(first.watch.environment));
-	for (const { watch, error } of failures) await log.recordError("po_runner.observer_cleanup_failed", error, { "session.id": watch.sessionId });
+	for (const { watch, error } of failures) await log.recordError("po_runner.observer_cleanup_failed", error, { "session.id": watch.sessionId }, { includeException: true });
 	await log.flush();
 	throw new AggregateError(failures.map(({ error }) => error), `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(", ")}`);
 }

package/dist/bin/runnerHost.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runnerHost.cjs","names":["watchOwner","LIFELINE_ENV","spawn","os","fs","pathToFileURL","REGISTRY_PATH_ENV"],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, execFile, spawn } from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport type { PoTelemetry } from '@agimon-ai/po-core/telemetry';\n\nimport { OBSERVE_SESSIONS_FLAG } from '../constants/lifeline';\nimport { REGISTRY_PATH_ENV } from '../constants/runnerRegistry';\nimport { LIFELINE_ENV, observeSessions, watchOwner } from '../services/lifeline/client';\nimport type { ProcessRegistryPort } from '../services/runnerRegistry';\nimport type { LifelineWatch } from '../types/lifeline';\n\n// Everything heavier loads on first use: the observer idles for its owner's whole life and\n// these imports alone would more than double its memory. A command's host loads none of it:\n// the server records the runner when it completes the record from this host's exit file.\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n  ownerLostCleanup?: string[];\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\nconst OWNER_LOST_EXIT = { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' };\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  if (argv[0] === OBSERVE_SESSIONS_FLAG) {\n    observeSessions(cleanupSessions);\n    return 0;\n  }\n  const [specPath, gatePath, exitPath] = argv;\n  if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n  const spec = await readSpec(specPath);\n  let ownerLost = false;\n  let onOwnerLost = (): void => undefined;\n  // Watched from before the gate: an owner that dies before opening it never will, and nothing\n  // else would end that wait.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    onOwnerLost();\n  }, spec.env[LIFELINE_ENV]);\n  if (!(await waitForGate(gatePath, () => ownerLost))) {\n    detachLifeline();\n    await writeAtomic(exitPath, { code: null, signal: null, ...OWNER_LOST_EXIT });\n    await cleanupOwnerSession(spec);\n    return 1;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  onOwnerLost = () => forward('SIGTERM');\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    await writeAtomic(exitPath, { ...result, ...(ownerLost ? OWNER_LOST_EXIT : {}) });\n    if (ownerLost) await cleanupOwnerSession(spec);\n    return result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n  }\n}\n\n/** The backend supplies an exact kill-session argv, never a shared-server shutdown. */\nasync function cleanupOwnerSession(spec: CommandSpec): Promise<void> {\n  const [binary, ...args] = spec.ownerLostCleanup ?? [];\n  if (!binary) return;\n  await new Promise<void>((resolve, reject) => {\n    execFile(binary, args, { env: spec.env, timeout: 10_000 }, (error) => {\n      if (error) reject(error);\n      else resolve();\n    });\n  });\n}\n\nasync function readSpec(target: string): Promise<CommandSpec> {\n  const value: unknown = JSON.parse(await fs.readFile(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env, ownerLostCleanup: spec.ownerLostCleanup };\n}\n\n/** False once the owner is gone, since only the owner opens the gate. */\nasync function waitForGate(target: string, abandoned: () => boolean): Promise<boolean> {\n  while (!abandoned()) {\n    try {\n      await fs.access(target);\n      return true;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n  }\n  return false;\n}\n\nasync function writeAtomic(target: string, value: unknown): Promise<void> {\n  const temporary = `${target}.${process.pid}.tmp`;\n  await fs.writeFile(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  await fs.rename(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n\n/** Loaded on the first session an owner leaves behind, then shared by every later one. */\nlet cleaner: Promise<(watch: LifelineWatch) => Promise<void>> | undefined;\nlet telemetry: Promise<PoTelemetry> | undefined;\n\n/**\n * A separate process survives SIGKILL of the owner, even if that session has no active runners.\n * The owner cleans up each session it ends with its own shared services and removes its marker,\n * so only a session still marked with its generation is left here; the rest load nothing.\n */\nasync function cleanupSessions(watches: readonly LifelineWatch[]): Promise<void> {\n  const failures: { watch: LifelineWatch; error: unknown }[] = [];\n  // One session failing to clean up must not stop the others.\n  for (const watch of watches) {\n    try {\n      // The same fence cleanupRunnerSession applies, checked before anything loads for it.\n      if ((await readMarker(watch.marker)) !== watch.generation) continue;\n      const clean = await (cleaner ??= loadCleaner());\n      await clean(watch);\n    } catch (error) {\n      failures.push({ watch, error });\n    }\n  }\n  const [first] = failures;\n  if (!first) return;\n  const log = await (telemetry ??= loadTelemetry(first.watch.environment));\n  for (const { watch, error } of failures) {\n    await log.recordError('po_runner.observer_cleanup_failed', error, { 'session.id': watch.sessionId });\n  }\n  await log.flush();\n  throw new AggregateError(\n    failures.map(({ error }) => error),\n    `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(', ')}`,\n  );\n}\n\nasync function readMarker(marker: string): Promise<string | undefined> {\n  try {\n    return await fs.readFile(marker, 'utf8');\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/** One registry per registry path, held until the observer runs out of work. */\nasync function loadCleaner(): Promise<(watch: LifelineWatch) => Promise<void>> {\n  const [{ cleanupRunnerSession }, { RunnerPaths }, { createDefaultProcessRegistry }] = await Promise.all([\n    import('../services/runnerHost'),\n    import('../services/runnerPaths'),\n    import('../services/runnerRegistry'),\n  ]);\n  const registries = new Map<string | undefined, ProcessRegistryPort>();\n  process.once('beforeExit', () => {\n    for (const registry of registries.values()) registry.close();\n  });\n  return (watch) => {\n    const registryPath = watch.environment[REGISTRY_PATH_ENV];\n    let registry = registries.get(registryPath);\n    if (!registry) {\n      registry = createDefaultProcessRegistry(watch.environment);\n      registries.set(registryPath, registry);\n    }\n    return cleanupRunnerSession({\n      sessionId: watch.sessionId,\n      paths: new RunnerPaths(watch.repository, watch.environment),\n      processRegistry: registry,\n      ownerPid: watch.ownerPid,\n      generation: watch.generation,\n    });\n  };\n}\n\nasync function loadTelemetry(environment: LifelineWatch['environment']): Promise<PoTelemetry> {\n  const { createPoTelemetry } = await import('@agimon-ai/po-core/telemetry');\n  const shared = createPoTelemetry({\n    serviceName: 'po-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: environment,\n    enableLogs: true,\n  });\n  process.once('beforeExit', () => void shared.shutdown());\n  return shared;\n}\n"],"mappings":"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"}
+{"version":3,"file":"runnerHost.cjs","names":["watchOwner","LIFELINE_ENV","spawn","os","fs","pathToFileURL","REGISTRY_PATH_ENV"],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, execFile, spawn } from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport type { PoTelemetry } from '@agimon-ai/po-core/telemetry';\n\nimport { OBSERVE_SESSIONS_FLAG } from '../constants/lifeline';\nimport { REGISTRY_PATH_ENV } from '../constants/runnerRegistry';\nimport { LIFELINE_ENV, observeSessions, watchOwner } from '../services/lifeline/client';\nimport type { ProcessRegistryPort } from '../services/runnerRegistry';\nimport type { LifelineWatch } from '../types/lifeline';\n\n// Everything heavier loads on first use: the observer idles for its owner's whole life and\n// these imports alone would more than double its memory. A command's host loads none of it:\n// the server records the runner when it completes the record from this host's exit file.\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n  ownerLostCleanup?: string[];\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\nconst OWNER_LOST_EXIT = { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' };\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  if (argv[0] === OBSERVE_SESSIONS_FLAG) {\n    observeSessions(cleanupSessions);\n    return 0;\n  }\n  const [specPath, gatePath, exitPath] = argv;\n  if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n  const spec = await readSpec(specPath);\n  let ownerLost = false;\n  let onOwnerLost = (): void => undefined;\n  // Watched from before the gate: an owner that dies before opening it never will, and nothing\n  // else would end that wait.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    onOwnerLost();\n  }, spec.env[LIFELINE_ENV]);\n  if (!(await waitForGate(gatePath, () => ownerLost))) {\n    detachLifeline();\n    await writeAtomic(exitPath, { code: null, signal: null, ...OWNER_LOST_EXIT });\n    await cleanupOwnerSession(spec);\n    return 1;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  onOwnerLost = () => forward('SIGTERM');\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    await writeAtomic(exitPath, { ...result, ...(ownerLost ? OWNER_LOST_EXIT : {}) });\n    if (ownerLost) await cleanupOwnerSession(spec);\n    return result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n  }\n}\n\n/** The backend supplies an exact kill-session argv, never a shared-server shutdown. */\nasync function cleanupOwnerSession(spec: CommandSpec): Promise<void> {\n  const [binary, ...args] = spec.ownerLostCleanup ?? [];\n  if (!binary) return;\n  await new Promise<void>((resolve, reject) => {\n    execFile(binary, args, { env: spec.env, timeout: 10_000 }, (error) => {\n      if (error) reject(error);\n      else resolve();\n    });\n  });\n}\n\nasync function readSpec(target: string): Promise<CommandSpec> {\n  const value: unknown = JSON.parse(await fs.readFile(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env, ownerLostCleanup: spec.ownerLostCleanup };\n}\n\n/** False once the owner is gone, since only the owner opens the gate. */\nasync function waitForGate(target: string, abandoned: () => boolean): Promise<boolean> {\n  while (!abandoned()) {\n    try {\n      await fs.access(target);\n      return true;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n  }\n  return false;\n}\n\nasync function writeAtomic(target: string, value: unknown): Promise<void> {\n  const temporary = `${target}.${process.pid}.tmp`;\n  await fs.writeFile(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  await fs.rename(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n\n/** Loaded on the first session an owner leaves behind, then shared by every later one. */\nlet cleaner: Promise<(watch: LifelineWatch) => Promise<void>> | undefined;\nlet telemetry: Promise<PoTelemetry> | undefined;\n\n/**\n * A separate process survives SIGKILL of the owner, even if that session has no active runners.\n * The owner cleans up each session it ends with its own shared services and removes its marker,\n * so only a session still marked with its generation is left here; the rest load nothing.\n */\nasync function cleanupSessions(watches: readonly LifelineWatch[]): Promise<void> {\n  const failures: { watch: LifelineWatch; error: unknown }[] = [];\n  // One session failing to clean up must not stop the others.\n  for (const watch of watches) {\n    try {\n      // The same fence cleanupRunnerSession applies, checked before anything loads for it.\n      if ((await readMarker(watch.marker)) !== watch.generation) continue;\n      const clean = await (cleaner ??= loadCleaner());\n      await clean(watch);\n    } catch (error) {\n      failures.push({ watch, error });\n    }\n  }\n  const [first] = failures;\n  if (!first) return;\n  const log = await (telemetry ??= loadTelemetry(first.watch.environment));\n  for (const { watch, error } of failures) {\n    await log.recordError(\n      'po_runner.observer_cleanup_failed',\n      error,\n      { 'session.id': watch.sessionId },\n      { includeException: true },\n    );\n  }\n  await log.flush();\n  throw new AggregateError(\n    failures.map(({ error }) => error),\n    `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(', ')}`,\n  );\n}\n\nasync function readMarker(marker: string): Promise<string | undefined> {\n  try {\n    return await fs.readFile(marker, 'utf8');\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/** One registry per registry path, held until the observer runs out of work. */\nasync function loadCleaner(): Promise<(watch: LifelineWatch) => Promise<void>> {\n  const [{ cleanupRunnerSession }, { RunnerPaths }, { createDefaultProcessRegistry }] = await Promise.all([\n    import('../services/runnerHost'),\n    import('../services/runnerPaths'),\n    import('../services/runnerRegistry'),\n  ]);\n  const registries = new Map<string | undefined, ProcessRegistryPort>();\n  process.once('beforeExit', () => {\n    for (const registry of registries.values()) registry.close();\n  });\n  return (watch) => {\n    const registryPath = watch.environment[REGISTRY_PATH_ENV];\n    let registry = registries.get(registryPath);\n    if (!registry) {\n      registry = createDefaultProcessRegistry(watch.environment);\n      registries.set(registryPath, registry);\n    }\n    return cleanupRunnerSession({\n      sessionId: watch.sessionId,\n      paths: new RunnerPaths(watch.repository, watch.environment),\n      processRegistry: registry,\n      ownerPid: watch.ownerPid,\n      generation: watch.generation,\n    });\n  };\n}\n\nasync function loadTelemetry(environment: LifelineWatch['environment']): Promise<PoTelemetry> {\n  const { createPoTelemetry } = await import('@agimon-ai/po-core/telemetry');\n  const shared = createPoTelemetry({\n    serviceName: 'po-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: environment,\n    enableLogs: true,\n  });\n  process.once('beforeExit', () => void shared.shutdown());\n  return shared;\n}\n"],"mappings":"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"}

package/dist/bin/runnerHost.mjs

@@ -159,7 +159,7 @@ async function cleanupSessions(watches) {
 	const [first] = failures;
 	if (!first) return;
 	const log = await (telemetry ??= loadTelemetry(first.watch.environment));
-	for (const { watch, error } of failures) await log.recordError("po_runner.observer_cleanup_failed", error, { "session.id": watch.sessionId });
+	for (const { watch, error } of failures) await log.recordError("po_runner.observer_cleanup_failed", error, { "session.id": watch.sessionId }, { includeException: true });
 	await log.flush();
 	throw new AggregateError(failures.map(({ error }) => error), `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(", ")}`);
 }

package/dist/bin/runnerHost.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runnerHost.mjs","names":[],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, execFile, spawn } from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport type { PoTelemetry } from '@agimon-ai/po-core/telemetry';\n\nimport { OBSERVE_SESSIONS_FLAG } from '../constants/lifeline';\nimport { REGISTRY_PATH_ENV } from '../constants/runnerRegistry';\nimport { LIFELINE_ENV, observeSessions, watchOwner } from '../services/lifeline/client';\nimport type { ProcessRegistryPort } from '../services/runnerRegistry';\nimport type { LifelineWatch } from '../types/lifeline';\n\n// Everything heavier loads on first use: the observer idles for its owner's whole life and\n// these imports alone would more than double its memory. A command's host loads none of it:\n// the server records the runner when it completes the record from this host's exit file.\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n  ownerLostCleanup?: string[];\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\nconst OWNER_LOST_EXIT = { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' };\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  if (argv[0] === OBSERVE_SESSIONS_FLAG) {\n    observeSessions(cleanupSessions);\n    return 0;\n  }\n  const [specPath, gatePath, exitPath] = argv;\n  if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n  const spec = await readSpec(specPath);\n  let ownerLost = false;\n  let onOwnerLost = (): void => undefined;\n  // Watched from before the gate: an owner that dies before opening it never will, and nothing\n  // else would end that wait.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    onOwnerLost();\n  }, spec.env[LIFELINE_ENV]);\n  if (!(await waitForGate(gatePath, () => ownerLost))) {\n    detachLifeline();\n    await writeAtomic(exitPath, { code: null, signal: null, ...OWNER_LOST_EXIT });\n    await cleanupOwnerSession(spec);\n    return 1;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  onOwnerLost = () => forward('SIGTERM');\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    await writeAtomic(exitPath, { ...result, ...(ownerLost ? OWNER_LOST_EXIT : {}) });\n    if (ownerLost) await cleanupOwnerSession(spec);\n    return result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n  }\n}\n\n/** The backend supplies an exact kill-session argv, never a shared-server shutdown. */\nasync function cleanupOwnerSession(spec: CommandSpec): Promise<void> {\n  const [binary, ...args] = spec.ownerLostCleanup ?? [];\n  if (!binary) return;\n  await new Promise<void>((resolve, reject) => {\n    execFile(binary, args, { env: spec.env, timeout: 10_000 }, (error) => {\n      if (error) reject(error);\n      else resolve();\n    });\n  });\n}\n\nasync function readSpec(target: string): Promise<CommandSpec> {\n  const value: unknown = JSON.parse(await fs.readFile(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env, ownerLostCleanup: spec.ownerLostCleanup };\n}\n\n/** False once the owner is gone, since only the owner opens the gate. */\nasync function waitForGate(target: string, abandoned: () => boolean): Promise<boolean> {\n  while (!abandoned()) {\n    try {\n      await fs.access(target);\n      return true;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n  }\n  return false;\n}\n\nasync function writeAtomic(target: string, value: unknown): Promise<void> {\n  const temporary = `${target}.${process.pid}.tmp`;\n  await fs.writeFile(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  await fs.rename(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n\n/** Loaded on the first session an owner leaves behind, then shared by every later one. */\nlet cleaner: Promise<(watch: LifelineWatch) => Promise<void>> | undefined;\nlet telemetry: Promise<PoTelemetry> | undefined;\n\n/**\n * A separate process survives SIGKILL of the owner, even if that session has no active runners.\n * The owner cleans up each session it ends with its own shared services and removes its marker,\n * so only a session still marked with its generation is left here; the rest load nothing.\n */\nasync function cleanupSessions(watches: readonly LifelineWatch[]): Promise<void> {\n  const failures: { watch: LifelineWatch; error: unknown }[] = [];\n  // One session failing to clean up must not stop the others.\n  for (const watch of watches) {\n    try {\n      // The same fence cleanupRunnerSession applies, checked before anything loads for it.\n      if ((await readMarker(watch.marker)) !== watch.generation) continue;\n      const clean = await (cleaner ??= loadCleaner());\n      await clean(watch);\n    } catch (error) {\n      failures.push({ watch, error });\n    }\n  }\n  const [first] = failures;\n  if (!first) return;\n  const log = await (telemetry ??= loadTelemetry(first.watch.environment));\n  for (const { watch, error } of failures) {\n    await log.recordError('po_runner.observer_cleanup_failed', error, { 'session.id': watch.sessionId });\n  }\n  await log.flush();\n  throw new AggregateError(\n    failures.map(({ error }) => error),\n    `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(', ')}`,\n  );\n}\n\nasync function readMarker(marker: string): Promise<string | undefined> {\n  try {\n    return await fs.readFile(marker, 'utf8');\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/** One registry per registry path, held until the observer runs out of work. */\nasync function loadCleaner(): Promise<(watch: LifelineWatch) => Promise<void>> {\n  const [{ cleanupRunnerSession }, { RunnerPaths }, { createDefaultProcessRegistry }] = await Promise.all([\n    import('../services/runnerHost'),\n    import('../services/runnerPaths'),\n    import('../services/runnerRegistry'),\n  ]);\n  const registries = new Map<string | undefined, ProcessRegistryPort>();\n  process.once('beforeExit', () => {\n    for (const registry of registries.values()) registry.close();\n  });\n  return (watch) => {\n    const registryPath = watch.environment[REGISTRY_PATH_ENV];\n    let registry = registries.get(registryPath);\n    if (!registry) {\n      registry = createDefaultProcessRegistry(watch.environment);\n      registries.set(registryPath, registry);\n    }\n    return cleanupRunnerSession({\n      sessionId: watch.sessionId,\n      paths: new RunnerPaths(watch.repository, watch.environment),\n      processRegistry: registry,\n      ownerPid: watch.ownerPid,\n      generation: watch.generation,\n    });\n  };\n}\n\nasync function loadTelemetry(environment: LifelineWatch['environment']): Promise<PoTelemetry> {\n  const { createPoTelemetry } = await import('@agimon-ai/po-core/telemetry');\n  const shared = createPoTelemetry({\n    serviceName: 'po-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: environment,\n    enableLogs: true,\n  });\n  process.once('beforeExit', () => void shared.shutdown());\n  return shared;\n}\n"],"mappings":"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"}
+{"version":3,"file":"runnerHost.mjs","names":[],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, execFile, spawn } from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport type { PoTelemetry } from '@agimon-ai/po-core/telemetry';\n\nimport { OBSERVE_SESSIONS_FLAG } from '../constants/lifeline';\nimport { REGISTRY_PATH_ENV } from '../constants/runnerRegistry';\nimport { LIFELINE_ENV, observeSessions, watchOwner } from '../services/lifeline/client';\nimport type { ProcessRegistryPort } from '../services/runnerRegistry';\nimport type { LifelineWatch } from '../types/lifeline';\n\n// Everything heavier loads on first use: the observer idles for its owner's whole life and\n// these imports alone would more than double its memory. A command's host loads none of it:\n// the server records the runner when it completes the record from this host's exit file.\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n  ownerLostCleanup?: string[];\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\nconst OWNER_LOST_EXIT = { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' };\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  if (argv[0] === OBSERVE_SESSIONS_FLAG) {\n    observeSessions(cleanupSessions);\n    return 0;\n  }\n  const [specPath, gatePath, exitPath] = argv;\n  if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n  const spec = await readSpec(specPath);\n  let ownerLost = false;\n  let onOwnerLost = (): void => undefined;\n  // Watched from before the gate: an owner that dies before opening it never will, and nothing\n  // else would end that wait.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    onOwnerLost();\n  }, spec.env[LIFELINE_ENV]);\n  if (!(await waitForGate(gatePath, () => ownerLost))) {\n    detachLifeline();\n    await writeAtomic(exitPath, { code: null, signal: null, ...OWNER_LOST_EXIT });\n    await cleanupOwnerSession(spec);\n    return 1;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  onOwnerLost = () => forward('SIGTERM');\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    await writeAtomic(exitPath, { ...result, ...(ownerLost ? OWNER_LOST_EXIT : {}) });\n    if (ownerLost) await cleanupOwnerSession(spec);\n    return result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n  }\n}\n\n/** The backend supplies an exact kill-session argv, never a shared-server shutdown. */\nasync function cleanupOwnerSession(spec: CommandSpec): Promise<void> {\n  const [binary, ...args] = spec.ownerLostCleanup ?? [];\n  if (!binary) return;\n  await new Promise<void>((resolve, reject) => {\n    execFile(binary, args, { env: spec.env, timeout: 10_000 }, (error) => {\n      if (error) reject(error);\n      else resolve();\n    });\n  });\n}\n\nasync function readSpec(target: string): Promise<CommandSpec> {\n  const value: unknown = JSON.parse(await fs.readFile(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env, ownerLostCleanup: spec.ownerLostCleanup };\n}\n\n/** False once the owner is gone, since only the owner opens the gate. */\nasync function waitForGate(target: string, abandoned: () => boolean): Promise<boolean> {\n  while (!abandoned()) {\n    try {\n      await fs.access(target);\n      return true;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n  }\n  return false;\n}\n\nasync function writeAtomic(target: string, value: unknown): Promise<void> {\n  const temporary = `${target}.${process.pid}.tmp`;\n  await fs.writeFile(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  await fs.rename(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n\n/** Loaded on the first session an owner leaves behind, then shared by every later one. */\nlet cleaner: Promise<(watch: LifelineWatch) => Promise<void>> | undefined;\nlet telemetry: Promise<PoTelemetry> | undefined;\n\n/**\n * A separate process survives SIGKILL of the owner, even if that session has no active runners.\n * The owner cleans up each session it ends with its own shared services and removes its marker,\n * so only a session still marked with its generation is left here; the rest load nothing.\n */\nasync function cleanupSessions(watches: readonly LifelineWatch[]): Promise<void> {\n  const failures: { watch: LifelineWatch; error: unknown }[] = [];\n  // One session failing to clean up must not stop the others.\n  for (const watch of watches) {\n    try {\n      // The same fence cleanupRunnerSession applies, checked before anything loads for it.\n      if ((await readMarker(watch.marker)) !== watch.generation) continue;\n      const clean = await (cleaner ??= loadCleaner());\n      await clean(watch);\n    } catch (error) {\n      failures.push({ watch, error });\n    }\n  }\n  const [first] = failures;\n  if (!first) return;\n  const log = await (telemetry ??= loadTelemetry(first.watch.environment));\n  for (const { watch, error } of failures) {\n    await log.recordError(\n      'po_runner.observer_cleanup_failed',\n      error,\n      { 'session.id': watch.sessionId },\n      { includeException: true },\n    );\n  }\n  await log.flush();\n  throw new AggregateError(\n    failures.map(({ error }) => error),\n    `Could not clean up runner sessions ${failures.map(({ watch }) => watch.sessionId).join(', ')}`,\n  );\n}\n\nasync function readMarker(marker: string): Promise<string | undefined> {\n  try {\n    return await fs.readFile(marker, 'utf8');\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/** One registry per registry path, held until the observer runs out of work. */\nasync function loadCleaner(): Promise<(watch: LifelineWatch) => Promise<void>> {\n  const [{ cleanupRunnerSession }, { RunnerPaths }, { createDefaultProcessRegistry }] = await Promise.all([\n    import('../services/runnerHost'),\n    import('../services/runnerPaths'),\n    import('../services/runnerRegistry'),\n  ]);\n  const registries = new Map<string | undefined, ProcessRegistryPort>();\n  process.once('beforeExit', () => {\n    for (const registry of registries.values()) registry.close();\n  });\n  return (watch) => {\n    const registryPath = watch.environment[REGISTRY_PATH_ENV];\n    let registry = registries.get(registryPath);\n    if (!registry) {\n      registry = createDefaultProcessRegistry(watch.environment);\n      registries.set(registryPath, registry);\n    }\n    return cleanupRunnerSession({\n      sessionId: watch.sessionId,\n      paths: new RunnerPaths(watch.repository, watch.environment),\n      processRegistry: registry,\n      ownerPid: watch.ownerPid,\n      generation: watch.generation,\n    });\n  };\n}\n\nasync function loadTelemetry(environment: LifelineWatch['environment']): Promise<PoTelemetry> {\n  const { createPoTelemetry } = await import('@agimon-ai/po-core/telemetry');\n  const shared = createPoTelemetry({\n    serviceName: 'po-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: environment,\n    enableLogs: true,\n  });\n  process.once('beforeExit', () => void shared.shutdown());\n  return shared;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-runner",
-  "version": "0.0.0-alpha.110",
+  "version": "0.0.0-alpha.111",
   "description": "Supervised shell execution, background process control, and run logs for Pi coding agents.",
   "keywords": [
     "ai",
@@ -214,10 +214,10 @@
   },
   "dependencies": {
     "@agimon-ai/foundation-process-registry": "0.30.14",
-    "@agimon-ai/po-core": "0.0.0-alpha.110",
-    "@agimon-ai/po-ui": "0.0.0-alpha.110",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.110",
-    "@agimon-ai/po-web-security": "0.0.0-alpha.110",
+    "@agimon-ai/po-core": "0.0.0-alpha.111",
+    "@agimon-ai/po-ui": "0.0.0-alpha.111",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-web-security": "0.0.0-alpha.111",
     "@deepseek-ai/cordis": "4.0.5",
     "@rmux/sdk": "0.6.5",
     "@xterm/headless": "6.0.0",
@@ -225,8 +225,8 @@
     "typebox": "1.4.2"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.110",
-    "@agimon-ai/po-native-components": "0.0.0-alpha.110",
+    "@agimon-ai/po-build": "0.0.0-alpha.111",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "@tanstack/react-store": "0.11.2",
     "@tanstack/store": "0.11.2",
@@ -242,7 +242,7 @@
     "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@agimon-ai/po-native-components": "0.0.0-alpha.110",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "react-native": "0.88.1",
     "react-native-unistyles": "^3.5.3"
@@ -262,14 +262,14 @@
     }
   },
   "optionalDependencies": {
-    "@agimon-ai/po-runner-rmux-darwin-arm64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rmux-darwin-x64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rmux-linux-arm64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rmux-linux-x64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rtk-darwin-arm64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rtk-darwin-x64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rtk-linux-arm64": "0.0.0-alpha.110",
-    "@agimon-ai/po-runner-rtk-linux-x64": "0.0.0-alpha.110"
+    "@agimon-ai/po-runner-rmux-darwin-arm64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rmux-darwin-x64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rmux-linux-arm64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rmux-linux-x64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rtk-darwin-arm64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rtk-darwin-x64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rtk-linux-arm64": "0.0.0-alpha.111",
+    "@agimon-ai/po-runner-rtk-linux-x64": "0.0.0-alpha.111"
   },
   "engines": {
     "node": ">=24"