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

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/dist/headless-CZGASZQW.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"headless-CZGASZQW.mjs","names":[],"sources":["../src/constants/headless.ts","../src/constants/runners.ts","../src/constants/runnersCommand.ts","../src/services/runnersCommand/index.ts","../src/services/headless/index.ts"],"sourcesContent":["export const MS_PER_SECOND = 1000;\n","export const COMMAND_NAME = 'runners';\nexport const COMMAND_DESCRIPTION =\n  'Open Runner Space: background processes started by bash. `/runners stop <id> [reason]` stops one, `/runners start [name=x] [cwd=y] [interactive=true] -- <command>` starts one.';\nexport const SERVER_COMMAND_DESCRIPTION = 'Start and stop supervised background runners without a terminal UI.';\n","export const RUNNERS_STOP_VERB = 'stop';\nexport const RUNNERS_START_VERB = 'start';\nexport const RUNNERS_COMMAND_SEPARATOR = '--';\nexport const NAME_KEY = 'name';\nexport const CWD_KEY = 'cwd';\nexport const INTERACTIVE_KEY = 'interactive';\n/** `interactive=prefer`: a terminal when rmux or tmux is available, plain output otherwise. */\nexport const INTERACTIVE_PREFER = 'prefer';\n","import {\n  CWD_KEY,\n  INTERACTIVE_KEY,\n  INTERACTIVE_PREFER,\n  NAME_KEY,\n  RUNNERS_COMMAND_SEPARATOR,\n  RUNNERS_START_VERB,\n  RUNNERS_STOP_VERB,\n} from '../../constants/runnersCommand';\n/** The `/runners` verb that stops one runner without opening Runner Space. */\n/** The `/runners` verb that starts one, for a client that cannot call the bash tool. */\n/**\n * Ends the options and begins the command.\n *\n * A command is arbitrary shell: it may hold `=`, and it may hold flags of its\n * own (`pnpm test -- --watch`). Only the first of these is the separator, so\n * everything the reader typed survives intact after it.\n */\n\nexport interface RunnersStartRequest {\n  kind: 'start';\n  /** The shell command to run; empty when the reader gave none. */\n  command: string;\n  cwd?: string;\n  name?: string;\n  interactive: boolean;\n  /** `interactive=prefer`: a terminal when one is available, plain output otherwise. */\n  preferInteractive?: boolean;\n}\n\nexport type RunnersCommandRequest =\n  /** No arguments: open Runner Space. */\n  | { kind: 'space' }\n  /** `stop <id> [reason]`: stop one runner headlessly; id is empty when it was left out. */\n  | { kind: 'stop'; id: string; reason?: string }\n  /** `start [key=value ...] -- <command>`: start one headlessly. */\n  | RunnersStartRequest;\n\n/** Splits on whitespace but keeps a double-quoted run together, so a path with spaces survives. */\nfunction tokenize(text: string): string[] {\n  return text.match(/(?:\"[^\"]*\"|\\S)+/gu) ?? [];\n}\n\nfunction unquote(value: string): string {\n  return value.length >= 2 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Parses `start`'s tail: `key=value` pairs up to the separator, then the\n * command verbatim.\n *\n * Without a separator the whole tail is the command, so typing\n * `/runners start pnpm build` does what it looks like. Options are read only\n * when a separator says where they end, which is what keeps a command such as\n * `FOO=bar pnpm test` from being mistaken for one.\n */\nfunction parseStart(tail: string): RunnersStartRequest {\n  const tokens = tokenize(tail);\n  const separator = tokens.indexOf(RUNNERS_COMMAND_SEPARATOR);\n  if (separator === -1) return { kind: 'start', command: tail.trim(), interactive: false };\n\n  const request: RunnersStartRequest = {\n    kind: 'start',\n    // Sliced from the raw text rather than rejoined from tokens: rejoining\n    // would collapse the spacing the reader wrote.\n    command: tail.slice(tail.indexOf(RUNNERS_COMMAND_SEPARATOR) + RUNNERS_COMMAND_SEPARATOR.length).trim(),\n    interactive: false,\n  };\n  for (const token of tokens.slice(0, separator)) {\n    const split = token.indexOf('=');\n    if (split <= 0) continue;\n    const value = unquote(token.slice(split + 1));\n    const key = token.slice(0, split);\n    if (key === NAME_KEY && value !== '') request.name = value;\n    if (key === CWD_KEY && value !== '') request.cwd = value;\n    if (key === INTERACTIVE_KEY) {\n      request.interactive = value === 'true';\n      if (value === INTERACTIVE_PREFER) request.preferInteractive = true;\n    }\n  }\n  return request;\n}\n\n/**\n * Parses `/runners` arguments. Anything other than a known verb opens Runner\n * Space, which is what the bare command has always done.\n */\nexport function parseRunnersCommand(args: string): RunnersCommandRequest {\n  const trimmed = args.trim();\n  const [verb = '', id = '', ...rest] = trimmed.split(/\\s+/u).filter(Boolean);\n  if (verb === RUNNERS_START_VERB) return parseStart(trimmed.slice(verb.length).trim());\n  if (verb !== RUNNERS_STOP_VERB) return { kind: 'space' };\n  const reason = rest.join(' ').trim();\n  return { kind: 'stop', id, ...(reason ? { reason } : {}) };\n}\n","import { resolve } from 'node:path';\n\nimport type {\n  PoHeadlessCommand,\n  PoHeadlessExecutionContext,\n  PoHeadlessTool,\n  PoHeadlessToolResult,\n} from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { BASH_TOOL_LABEL, BASH_TOOL_NAME } from '../../constants/bashTool';\nimport { MS_PER_SECOND } from '../../constants/headless';\nimport { COMMAND_NAME, SERVER_COMMAND_DESCRIPTION } from '../../constants/runners';\nimport { type BashParams, BashParamsSchema } from '../../schemas/bashTool';\nimport { formatRunResult } from '../../services/bashResult';\nimport { stopRunnerProcess } from '../../services/reconcile';\nimport { getBackgroundThresholdMs } from '../../services/runnerConfig';\nimport type { RunnerDependencies } from '../../services/runnerDependencies/type';\nimport { parseRunnersCommand } from '../../services/runnersCommand';\nimport type { RunnerSequenceService } from '../runnerSequence';\nimport { isSequenceId } from '../runnerSequenceStore';\n\nexport function createHeadlessBashTool(\n  runSequence: RunnerSequenceService['run'] | undefined,\n  environment: Readonly<Record<string, string | undefined>>,\n): PoHeadlessTool<typeof BashParamsSchema> {\n  return {\n    name: BASH_TOOL_NAME,\n    label: BASH_TOOL_LABEL,\n    description:\n      'Execute an array of Bash commands in order in the current working directory, stopping on first failure. Each command gets a complete saved log; return all log paths and only the last executed result. Do not pipe or redirect output to a file, head, or tail. Runner saves full logs automatically and bounds returned output.',\n    promptSnippet: 'Execute shell commands with bounded foreground output and supervised background runners',\n    promptGuidelines: [\n      `A command sequence still running after ${Math.round(getBackgroundThresholdMs(environment) / MS_PER_SECOND)} seconds remains active as a background runner with an id and streaming log paths.`,\n      'Pass background: true for commands that should remain active, such as dev servers and watchers.',\n      'Always pass command as an array, including for one command. interactive: true applies only to the last command.',\n      'Do not pipe or redirect command output to a file, head, or tail. Full logs are saved automatically; returned output is already bounded.',\n      'Stop background runners when they are no longer needed.',\n    ],\n    parameters: BashParamsSchema,\n    executionMode: 'serial',\n    execute: async (\n      _toolCallId: string,\n      params: BashParams,\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => {\n      if (signal?.aborted) throw new Error('Operation aborted');\n      if (!runSequence) throw new Error('This host does not support supervised Bash command sequences.');\n      return runSequence(params, context, _toolCallId, signal, onUpdate);\n    },\n  };\n}\n\nexport interface HeadlessRunnersCommandOptions {\n  /** Checks a typed folder exists before a runner starts in it. */\n  fs?: FileSystem | undefined;\n  /** Hears every start: why it did not happen, or undefined when it did, so the runners panel can say. */\n  onStart?: (sessionId: string, failure: string | undefined) => void;\n  sequences?: Pick<RunnerSequenceService, 'get' | 'stop'>;\n}\n\n/** A folder as typed, relative to the session directory; undefined when it is not one. */\nasync function runnerFolder(\n  sessionDirectory: string,\n  folder: string | undefined,\n  fs: FileSystem | undefined,\n): Promise<string | undefined> {\n  if (folder === undefined) return sessionDirectory;\n  const path = resolve(sessionDirectory, folder);\n  if (!fs) return path;\n  const info = await fs.fileInfo(path, BACKGROUND_CONTEXT);\n  return info.ok && info.value.kind === 'directory' ? path : undefined;\n}\n\nexport function createHeadlessRunnersCommand(\n  dependencies: RunnerDependencies,\n  { fs, onStart, sequences }: HeadlessRunnersCommandOptions = {},\n): PoHeadlessCommand {\n  return {\n    name: COMMAND_NAME,\n    description: SERVER_COMMAND_DESCRIPTION,\n    async execute(args: string, context: PoHeadlessExecutionContext) {\n      const request = parseRunnersCommand(args);\n      if (request.kind === 'space') {\n        const active = await dependencies.runnerRegistry.listBySession(context.sessionId);\n        await context.client.notify({\n          body: `${active.length} active runner${active.length === 1 ? '' : 's'}.`,\n          level: 'info',\n        });\n        return;\n      }\n      if (request.kind === 'start') {\n        if (!request.command) throw new Error('Usage: /runners start [name=x] [cwd=y] [interactive=true] -- <command>');\n        const cwd = await runnerFolder(context.cwd, request.cwd, fs);\n        if (cwd === undefined) {\n          const message = `That folder does not exist: ${request.cwd ?? ''}`;\n          onStart?.(context.sessionId, message);\n          await context.client.notify({ body: message, level: 'error' });\n          return;\n        }\n        const result = await dependencies.bashRunService.run({\n          command: request.command,\n          background: true,\n          sessionId: context.sessionId,\n          cwd,\n          ...(request.name ? { name: request.name } : {}),\n          ...(request.interactive ? { interactive: true } : {}),\n          ...(request.preferInteractive ? { preferInteractive: true } : {}),\n        });\n        onStart?.(context.sessionId, result.kind === 'failed' ? result.error : undefined);\n        await context.client.notify({\n          body:\n            (await formatRunResult(result, {}, undefined, dependencies.settings, dependencies.environment)).content[0]\n              ?.text ?? 'Runner started.',\n          level: result.kind === 'failed' ? 'error' : 'info',\n        });\n        return;\n      }\n      if (!request.id) throw new Error('Usage: /runners stop <runner-id> [reason]');\n      if (isSequenceId(request.id)) {\n        if (!sequences) throw new Error('Sequence controls are unavailable.');\n        await sequences.stop(request.id, request.reason);\n        await context.client.notify({ body: `Stop requested for sequence ${request.id}.`, level: 'info' });\n        return;\n      }\n      const record = await dependencies.runnerRegistry.get(request.id, context.sessionId);\n      if (!record) {\n        await context.client.notify({ body: `No active runner ${request.id} in this session.`, level: 'warning' });\n        return;\n      }\n      const stopped = await stopRunnerProcess(record, dependencies.launcher, dependencies.rmuxBackend, {\n        registry: dependencies.runnerRegistry,\n        intent: {\n          reason: 'stopped',\n          terminationReason: 'user_stop',\n          ...(request.reason ? { stopReason: request.reason } : {}),\n        },\n      });\n      if (stopped) {\n        await dependencies.runnerRegistry.complete(\n          request.id,\n          {\n            reason: 'stopped',\n            code: null,\n            signal: null,\n            ...(request.reason ? { stopReason: request.reason } : {}),\n          },\n          context.sessionId,\n        );\n      }\n      await context.client.notify({\n        body: stopped ? `Stopped runner ${request.id}.` : `Could not stop runner ${request.id}.`,\n        level: stopped ? 'info' : 'error',\n      });\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"headless-CZGASZQW.mjs","names":[],"sources":["../src/constants/headless.ts","../src/constants/runners.ts","../src/constants/runnersCommand.ts","../src/services/runnersCommand/index.ts","../src/services/headless/index.ts"],"sourcesContent":["export const MS_PER_SECOND = 1000;\n","export const COMMAND_NAME = 'runners';\nexport const COMMAND_DESCRIPTION =\n  'Open Runner Space: background processes started by bash. `/runners stop <id> [reason]` stops one, `/runners start [name=x] [cwd=y] [interactive=true] -- <command>` starts one.';\nexport const SERVER_COMMAND_DESCRIPTION = 'Start and stop supervised background runners without a terminal UI.';\nexport const RUNNER_UNAVAILABLE_MESSAGE = 'Subprocess supervision is unavailable on this host.';\n","export const RUNNERS_STOP_VERB = 'stop';\nexport const RUNNERS_START_VERB = 'start';\nexport const RUNNERS_COMMAND_SEPARATOR = '--';\nexport const NAME_KEY = 'name';\nexport const CWD_KEY = 'cwd';\nexport const INTERACTIVE_KEY = 'interactive';\n/** `interactive=prefer`: a terminal when rmux or tmux is available, plain output otherwise. */\nexport const INTERACTIVE_PREFER = 'prefer';\n","import {\n  CWD_KEY,\n  INTERACTIVE_KEY,\n  INTERACTIVE_PREFER,\n  NAME_KEY,\n  RUNNERS_COMMAND_SEPARATOR,\n  RUNNERS_START_VERB,\n  RUNNERS_STOP_VERB,\n} from '../../constants/runnersCommand';\n/** The `/runners` verb that stops one runner without opening Runner Space. */\n/** The `/runners` verb that starts one, for a client that cannot call the bash tool. */\n/**\n * Ends the options and begins the command.\n *\n * A command is arbitrary shell: it may hold `=`, and it may hold flags of its\n * own (`pnpm test -- --watch`). Only the first of these is the separator, so\n * everything the reader typed survives intact after it.\n */\n\nexport interface RunnersStartRequest {\n  kind: 'start';\n  /** The shell command to run; empty when the reader gave none. */\n  command: string;\n  cwd?: string;\n  name?: string;\n  interactive: boolean;\n  /** `interactive=prefer`: a terminal when one is available, plain output otherwise. */\n  preferInteractive?: boolean;\n}\n\nexport type RunnersCommandRequest =\n  /** No arguments: open Runner Space. */\n  | { kind: 'space' }\n  /** `stop <id> [reason]`: stop one runner headlessly; id is empty when it was left out. */\n  | { kind: 'stop'; id: string; reason?: string }\n  /** `start [key=value ...] -- <command>`: start one headlessly. */\n  | RunnersStartRequest;\n\n/** Splits on whitespace but keeps a double-quoted run together, so a path with spaces survives. */\nfunction tokenize(text: string): string[] {\n  return text.match(/(?:\"[^\"]*\"|\\S)+/gu) ?? [];\n}\n\nfunction unquote(value: string): string {\n  return value.length >= 2 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Parses `start`'s tail: `key=value` pairs up to the separator, then the\n * command verbatim.\n *\n * Without a separator the whole tail is the command, so typing\n * `/runners start pnpm build` does what it looks like. Options are read only\n * when a separator says where they end, which is what keeps a command such as\n * `FOO=bar pnpm test` from being mistaken for one.\n */\nfunction parseStart(tail: string): RunnersStartRequest {\n  const tokens = tokenize(tail);\n  const separator = tokens.indexOf(RUNNERS_COMMAND_SEPARATOR);\n  if (separator === -1) return { kind: 'start', command: tail.trim(), interactive: false };\n\n  const request: RunnersStartRequest = {\n    kind: 'start',\n    // Sliced from the raw text rather than rejoined from tokens: rejoining\n    // would collapse the spacing the reader wrote.\n    command: tail.slice(tail.indexOf(RUNNERS_COMMAND_SEPARATOR) + RUNNERS_COMMAND_SEPARATOR.length).trim(),\n    interactive: false,\n  };\n  for (const token of tokens.slice(0, separator)) {\n    const split = token.indexOf('=');\n    if (split <= 0) continue;\n    const value = unquote(token.slice(split + 1));\n    const key = token.slice(0, split);\n    if (key === NAME_KEY && value !== '') request.name = value;\n    if (key === CWD_KEY && value !== '') request.cwd = value;\n    if (key === INTERACTIVE_KEY) {\n      request.interactive = value === 'true';\n      if (value === INTERACTIVE_PREFER) request.preferInteractive = true;\n    }\n  }\n  return request;\n}\n\n/**\n * Parses `/runners` arguments. Anything other than a known verb opens Runner\n * Space, which is what the bare command has always done.\n */\nexport function parseRunnersCommand(args: string): RunnersCommandRequest {\n  const trimmed = args.trim();\n  const [verb = '', id = '', ...rest] = trimmed.split(/\\s+/u).filter(Boolean);\n  if (verb === RUNNERS_START_VERB) return parseStart(trimmed.slice(verb.length).trim());\n  if (verb !== RUNNERS_STOP_VERB) return { kind: 'space' };\n  const reason = rest.join(' ').trim();\n  return { kind: 'stop', id, ...(reason ? { reason } : {}) };\n}\n","import { resolve } from 'node:path';\n\nimport type {\n  PoHeadlessCommand,\n  PoHeadlessExecutionContext,\n  PoHeadlessTool,\n  PoHeadlessToolResult,\n} from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { BASH_TOOL_LABEL, BASH_TOOL_NAME } from '../../constants/bashTool';\nimport { MS_PER_SECOND } from '../../constants/headless';\nimport { COMMAND_NAME, SERVER_COMMAND_DESCRIPTION } from '../../constants/runners';\nimport { type BashParams, BashParamsSchema } from '../../schemas/bashTool';\nimport { formatRunResult } from '../../services/bashResult';\nimport { stopRunnerProcess } from '../../services/reconcile';\nimport { getBackgroundThresholdMs } from '../../services/runnerConfig';\nimport type { RunnerDependencies } from '../../services/runnerDependencies/type';\nimport { parseRunnersCommand } from '../../services/runnersCommand';\nimport type { RunnerSequenceService } from '../runnerSequence';\nimport { isSequenceId } from '../runnerSequenceStore';\n\nexport function createHeadlessBashTool(\n  runSequence: RunnerSequenceService['run'] | undefined,\n  environment: Readonly<Record<string, string | undefined>>,\n): PoHeadlessTool<typeof BashParamsSchema> {\n  return {\n    name: BASH_TOOL_NAME,\n    label: BASH_TOOL_LABEL,\n    description:\n      'Execute an array of Bash commands in order in the current working directory, stopping on first failure. Each command gets a complete saved log; return all log paths and only the last executed result. Do not pipe or redirect output to a file, head, or tail. Runner saves full logs automatically and bounds returned output.',\n    promptSnippet: 'Execute shell commands with bounded foreground output and supervised background runners',\n    promptGuidelines: [\n      `A command sequence still running after ${Math.round(getBackgroundThresholdMs(environment) / MS_PER_SECOND)} seconds remains active as a background runner with an id and streaming log paths.`,\n      'Pass background: true for commands that should remain active, such as dev servers and watchers.',\n      'Always pass command as an array, including for one command. interactive: true applies only to the last command.',\n      'Do not pipe or redirect command output to a file, head, or tail. Full logs are saved automatically; returned output is already bounded.',\n      'Stop background runners when they are no longer needed.',\n    ],\n    parameters: BashParamsSchema,\n    executionMode: 'serial',\n    execute: async (\n      _toolCallId: string,\n      params: BashParams,\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => {\n      if (signal?.aborted) throw new Error('Operation aborted');\n      if (!runSequence) throw new Error('This host does not support supervised Bash command sequences.');\n      return runSequence(params, context, _toolCallId, signal, onUpdate);\n    },\n  };\n}\n\nexport interface HeadlessRunnersCommandOptions {\n  /** Checks a typed folder exists before a runner starts in it. */\n  fs?: FileSystem | undefined;\n  /** Hears every start: why it did not happen, or undefined when it did, so the runners panel can say. */\n  onStart?: (sessionId: string, failure: string | undefined) => void;\n  sequences?: Pick<RunnerSequenceService, 'get' | 'stop'>;\n}\n\n/** A folder as typed, relative to the session directory; undefined when it is not one. */\nasync function runnerFolder(\n  sessionDirectory: string,\n  folder: string | undefined,\n  fs: FileSystem | undefined,\n): Promise<string | undefined> {\n  if (folder === undefined) return sessionDirectory;\n  const path = resolve(sessionDirectory, folder);\n  if (!fs) return path;\n  const info = await fs.fileInfo(path, BACKGROUND_CONTEXT);\n  return info.ok && info.value.kind === 'directory' ? path : undefined;\n}\n\nexport function createHeadlessRunnersCommand(\n  dependencies: RunnerDependencies,\n  { fs, onStart, sequences }: HeadlessRunnersCommandOptions = {},\n): PoHeadlessCommand {\n  return {\n    name: COMMAND_NAME,\n    description: SERVER_COMMAND_DESCRIPTION,\n    async execute(args: string, context: PoHeadlessExecutionContext) {\n      const request = parseRunnersCommand(args);\n      if (request.kind === 'space') {\n        const active = await dependencies.runnerRegistry.listBySession(context.sessionId);\n        await context.client.notify({\n          body: `${active.length} active runner${active.length === 1 ? '' : 's'}.`,\n          level: 'info',\n        });\n        return;\n      }\n      if (request.kind === 'start') {\n        if (!request.command) throw new Error('Usage: /runners start [name=x] [cwd=y] [interactive=true] -- <command>');\n        const cwd = await runnerFolder(context.cwd, request.cwd, fs);\n        if (cwd === undefined) {\n          const message = `That folder does not exist: ${request.cwd ?? ''}`;\n          onStart?.(context.sessionId, message);\n          await context.client.notify({ body: message, level: 'error' });\n          return;\n        }\n        const result = await dependencies.bashRunService.run({\n          command: request.command,\n          background: true,\n          sessionId: context.sessionId,\n          cwd,\n          ...(request.name ? { name: request.name } : {}),\n          ...(request.interactive ? { interactive: true } : {}),\n          ...(request.preferInteractive ? { preferInteractive: true } : {}),\n        });\n        onStart?.(context.sessionId, result.kind === 'failed' ? result.error : undefined);\n        await context.client.notify({\n          body:\n            (await formatRunResult(result, {}, undefined, dependencies.settings, dependencies.environment)).content[0]\n              ?.text ?? 'Runner started.',\n          level: result.kind === 'failed' ? 'error' : 'info',\n        });\n        return;\n      }\n      if (!request.id) throw new Error('Usage: /runners stop <runner-id> [reason]');\n      if (isSequenceId(request.id)) {\n        if (!sequences) throw new Error('Sequence controls are unavailable.');\n        await sequences.stop(request.id, request.reason);\n        await context.client.notify({ body: `Stop requested for sequence ${request.id}.`, level: 'info' });\n        return;\n      }\n      const record = await dependencies.runnerRegistry.get(request.id, context.sessionId);\n      if (!record) {\n        await context.client.notify({ body: `No active runner ${request.id} in this session.`, level: 'warning' });\n        return;\n      }\n      const stopped = await stopRunnerProcess(record, dependencies.launcher, dependencies.rmuxBackend, {\n        registry: dependencies.runnerRegistry,\n        intent: {\n          reason: 'stopped',\n          terminationReason: 'user_stop',\n          ...(request.reason ? { stopReason: request.reason } : {}),\n        },\n      });\n      if (stopped) {\n        await dependencies.runnerRegistry.complete(\n          request.id,\n          {\n            reason: 'stopped',\n            code: null,\n            signal: null,\n            ...(request.reason ? { stopReason: request.reason } : {}),\n          },\n          context.sessionId,\n        );\n      }\n      await context.client.notify({\n        body: stopped ? `Stopped runner ${request.id}.` : `Could not stop runner ${request.id}.`,\n        level: stopped ? 'info' : 'error',\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/headless-rEHOO_5S.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"headless-rEHOO_5S.cjs","names":["BASH_TOOL_NAME","BASH_TOOL_LABEL","getBackgroundThresholdMs","BashParamsSchema","resolve","BACKGROUND_CONTEXT","formatRunResult","isSequenceId","stopRunnerProcess"],"sources":["../src/constants/headless.ts","../src/constants/runners.ts","../src/constants/runnersCommand.ts","../src/services/runnersCommand/index.ts","../src/services/headless/index.ts"],"sourcesContent":["export const MS_PER_SECOND = 1000;\n","export const COMMAND_NAME = 'runners';\nexport const COMMAND_DESCRIPTION =\n  'Open Runner Space: background processes started by bash. `/runners stop <id> [reason]` stops one, `/runners start [name=x] [cwd=y] [interactive=true] -- <command>` starts one.';\nexport const SERVER_COMMAND_DESCRIPTION = 'Start and stop supervised background runners without a terminal UI.';\n","export const RUNNERS_STOP_VERB = 'stop';\nexport const RUNNERS_START_VERB = 'start';\nexport const RUNNERS_COMMAND_SEPARATOR = '--';\nexport const NAME_KEY = 'name';\nexport const CWD_KEY = 'cwd';\nexport const INTERACTIVE_KEY = 'interactive';\n/** `interactive=prefer`: a terminal when rmux or tmux is available, plain output otherwise. */\nexport const INTERACTIVE_PREFER = 'prefer';\n","import {\n  CWD_KEY,\n  INTERACTIVE_KEY,\n  INTERACTIVE_PREFER,\n  NAME_KEY,\n  RUNNERS_COMMAND_SEPARATOR,\n  RUNNERS_START_VERB,\n  RUNNERS_STOP_VERB,\n} from '../../constants/runnersCommand';\n/** The `/runners` verb that stops one runner without opening Runner Space. */\n/** The `/runners` verb that starts one, for a client that cannot call the bash tool. */\n/**\n * Ends the options and begins the command.\n *\n * A command is arbitrary shell: it may hold `=`, and it may hold flags of its\n * own (`pnpm test -- --watch`). Only the first of these is the separator, so\n * everything the reader typed survives intact after it.\n */\n\nexport interface RunnersStartRequest {\n  kind: 'start';\n  /** The shell command to run; empty when the reader gave none. */\n  command: string;\n  cwd?: string;\n  name?: string;\n  interactive: boolean;\n  /** `interactive=prefer`: a terminal when one is available, plain output otherwise. */\n  preferInteractive?: boolean;\n}\n\nexport type RunnersCommandRequest =\n  /** No arguments: open Runner Space. */\n  | { kind: 'space' }\n  /** `stop <id> [reason]`: stop one runner headlessly; id is empty when it was left out. */\n  | { kind: 'stop'; id: string; reason?: string }\n  /** `start [key=value ...] -- <command>`: start one headlessly. */\n  | RunnersStartRequest;\n\n/** Splits on whitespace but keeps a double-quoted run together, so a path with spaces survives. */\nfunction tokenize(text: string): string[] {\n  return text.match(/(?:\"[^\"]*\"|\\S)+/gu) ?? [];\n}\n\nfunction unquote(value: string): string {\n  return value.length >= 2 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Parses `start`'s tail: `key=value` pairs up to the separator, then the\n * command verbatim.\n *\n * Without a separator the whole tail is the command, so typing\n * `/runners start pnpm build` does what it looks like. Options are read only\n * when a separator says where they end, which is what keeps a command such as\n * `FOO=bar pnpm test` from being mistaken for one.\n */\nfunction parseStart(tail: string): RunnersStartRequest {\n  const tokens = tokenize(tail);\n  const separator = tokens.indexOf(RUNNERS_COMMAND_SEPARATOR);\n  if (separator === -1) return { kind: 'start', command: tail.trim(), interactive: false };\n\n  const request: RunnersStartRequest = {\n    kind: 'start',\n    // Sliced from the raw text rather than rejoined from tokens: rejoining\n    // would collapse the spacing the reader wrote.\n    command: tail.slice(tail.indexOf(RUNNERS_COMMAND_SEPARATOR) + RUNNERS_COMMAND_SEPARATOR.length).trim(),\n    interactive: false,\n  };\n  for (const token of tokens.slice(0, separator)) {\n    const split = token.indexOf('=');\n    if (split <= 0) continue;\n    const value = unquote(token.slice(split + 1));\n    const key = token.slice(0, split);\n    if (key === NAME_KEY && value !== '') request.name = value;\n    if (key === CWD_KEY && value !== '') request.cwd = value;\n    if (key === INTERACTIVE_KEY) {\n      request.interactive = value === 'true';\n      if (value === INTERACTIVE_PREFER) request.preferInteractive = true;\n    }\n  }\n  return request;\n}\n\n/**\n * Parses `/runners` arguments. Anything other than a known verb opens Runner\n * Space, which is what the bare command has always done.\n */\nexport function parseRunnersCommand(args: string): RunnersCommandRequest {\n  const trimmed = args.trim();\n  const [verb = '', id = '', ...rest] = trimmed.split(/\\s+/u).filter(Boolean);\n  if (verb === RUNNERS_START_VERB) return parseStart(trimmed.slice(verb.length).trim());\n  if (verb !== RUNNERS_STOP_VERB) return { kind: 'space' };\n  const reason = rest.join(' ').trim();\n  return { kind: 'stop', id, ...(reason ? { reason } : {}) };\n}\n","import { resolve } from 'node:path';\n\nimport type {\n  PoHeadlessCommand,\n  PoHeadlessExecutionContext,\n  PoHeadlessTool,\n  PoHeadlessToolResult,\n} from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { BASH_TOOL_LABEL, BASH_TOOL_NAME } from '../../constants/bashTool';\nimport { MS_PER_SECOND } from '../../constants/headless';\nimport { COMMAND_NAME, SERVER_COMMAND_DESCRIPTION } from '../../constants/runners';\nimport { type BashParams, BashParamsSchema } from '../../schemas/bashTool';\nimport { formatRunResult } from '../../services/bashResult';\nimport { stopRunnerProcess } from '../../services/reconcile';\nimport { getBackgroundThresholdMs } from '../../services/runnerConfig';\nimport type { RunnerDependencies } from '../../services/runnerDependencies/type';\nimport { parseRunnersCommand } from '../../services/runnersCommand';\nimport type { RunnerSequenceService } from '../runnerSequence';\nimport { isSequenceId } from '../runnerSequenceStore';\n\nexport function createHeadlessBashTool(\n  runSequence: RunnerSequenceService['run'] | undefined,\n  environment: Readonly<Record<string, string | undefined>>,\n): PoHeadlessTool<typeof BashParamsSchema> {\n  return {\n    name: BASH_TOOL_NAME,\n    label: BASH_TOOL_LABEL,\n    description:\n      'Execute an array of Bash commands in order in the current working directory, stopping on first failure. Each command gets a complete saved log; return all log paths and only the last executed result. Do not pipe or redirect output to a file, head, or tail. Runner saves full logs automatically and bounds returned output.',\n    promptSnippet: 'Execute shell commands with bounded foreground output and supervised background runners',\n    promptGuidelines: [\n      `A command sequence still running after ${Math.round(getBackgroundThresholdMs(environment) / MS_PER_SECOND)} seconds remains active as a background runner with an id and streaming log paths.`,\n      'Pass background: true for commands that should remain active, such as dev servers and watchers.',\n      'Always pass command as an array, including for one command. interactive: true applies only to the last command.',\n      'Do not pipe or redirect command output to a file, head, or tail. Full logs are saved automatically; returned output is already bounded.',\n      'Stop background runners when they are no longer needed.',\n    ],\n    parameters: BashParamsSchema,\n    executionMode: 'serial',\n    execute: async (\n      _toolCallId: string,\n      params: BashParams,\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => {\n      if (signal?.aborted) throw new Error('Operation aborted');\n      if (!runSequence) throw new Error('This host does not support supervised Bash command sequences.');\n      return runSequence(params, context, _toolCallId, signal, onUpdate);\n    },\n  };\n}\n\nexport interface HeadlessRunnersCommandOptions {\n  /** Checks a typed folder exists before a runner starts in it. */\n  fs?: FileSystem | undefined;\n  /** Hears every start: why it did not happen, or undefined when it did, so the runners panel can say. */\n  onStart?: (sessionId: string, failure: string | undefined) => void;\n  sequences?: Pick<RunnerSequenceService, 'get' | 'stop'>;\n}\n\n/** A folder as typed, relative to the session directory; undefined when it is not one. */\nasync function runnerFolder(\n  sessionDirectory: string,\n  folder: string | undefined,\n  fs: FileSystem | undefined,\n): Promise<string | undefined> {\n  if (folder === undefined) return sessionDirectory;\n  const path = resolve(sessionDirectory, folder);\n  if (!fs) return path;\n  const info = await fs.fileInfo(path, BACKGROUND_CONTEXT);\n  return info.ok && info.value.kind === 'directory' ? path : undefined;\n}\n\nexport function createHeadlessRunnersCommand(\n  dependencies: RunnerDependencies,\n  { fs, onStart, sequences }: HeadlessRunnersCommandOptions = {},\n): PoHeadlessCommand {\n  return {\n    name: COMMAND_NAME,\n    description: SERVER_COMMAND_DESCRIPTION,\n    async execute(args: string, context: PoHeadlessExecutionContext) {\n      const request = parseRunnersCommand(args);\n      if (request.kind === 'space') {\n        const active = await dependencies.runnerRegistry.listBySession(context.sessionId);\n        await context.client.notify({\n          body: `${active.length} active runner${active.length === 1 ? '' : 's'}.`,\n          level: 'info',\n        });\n        return;\n      }\n      if (request.kind === 'start') {\n        if (!request.command) throw new Error('Usage: /runners start [name=x] [cwd=y] [interactive=true] -- <command>');\n        const cwd = await runnerFolder(context.cwd, request.cwd, fs);\n        if (cwd === undefined) {\n          const message = `That folder does not exist: ${request.cwd ?? ''}`;\n          onStart?.(context.sessionId, message);\n          await context.client.notify({ body: message, level: 'error' });\n          return;\n        }\n        const result = await dependencies.bashRunService.run({\n          command: request.command,\n          background: true,\n          sessionId: context.sessionId,\n          cwd,\n          ...(request.name ? { name: request.name } : {}),\n          ...(request.interactive ? { interactive: true } : {}),\n          ...(request.preferInteractive ? { preferInteractive: true } : {}),\n        });\n        onStart?.(context.sessionId, result.kind === 'failed' ? result.error : undefined);\n        await context.client.notify({\n          body:\n            (await formatRunResult(result, {}, undefined, dependencies.settings, dependencies.environment)).content[0]\n              ?.text ?? 'Runner started.',\n          level: result.kind === 'failed' ? 'error' : 'info',\n        });\n        return;\n      }\n      if (!request.id) throw new Error('Usage: /runners stop <runner-id> [reason]');\n      if (isSequenceId(request.id)) {\n        if (!sequences) throw new Error('Sequence controls are unavailable.');\n        await sequences.stop(request.id, request.reason);\n        await context.client.notify({ body: `Stop requested for sequence ${request.id}.`, level: 'info' });\n        return;\n      }\n      const record = await dependencies.runnerRegistry.get(request.id, context.sessionId);\n      if (!record) {\n        await context.client.notify({ body: `No active runner ${request.id} in this session.`, level: 'warning' });\n        return;\n      }\n      const stopped = await stopRunnerProcess(record, dependencies.launcher, dependencies.rmuxBackend, {\n        registry: dependencies.runnerRegistry,\n        intent: {\n          reason: 'stopped',\n          terminationReason: 'user_stop',\n          ...(request.reason ? { stopReason: request.reason } : {}),\n        },\n      });\n      if (stopped) {\n        await dependencies.runnerRegistry.complete(\n          request.id,\n          {\n            reason: 'stopped',\n            code: null,\n            signal: null,\n            ...(request.reason ? { stopReason: request.reason } : {}),\n          },\n          context.sessionId,\n        );\n      }\n      await context.client.notify({\n        body: stopped ? `Stopped runner ${request.id}.` : `Could not stop runner ${request.id}.`,\n        level: stopped ? 'info' : 'error',\n      });\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"headless-rEHOO_5S.cjs","names":["BASH_TOOL_NAME","BASH_TOOL_LABEL","getBackgroundThresholdMs","BashParamsSchema","resolve","BACKGROUND_CONTEXT","formatRunResult","isSequenceId","stopRunnerProcess"],"sources":["../src/constants/headless.ts","../src/constants/runners.ts","../src/constants/runnersCommand.ts","../src/services/runnersCommand/index.ts","../src/services/headless/index.ts"],"sourcesContent":["export const MS_PER_SECOND = 1000;\n","export const COMMAND_NAME = 'runners';\nexport const COMMAND_DESCRIPTION =\n  'Open Runner Space: background processes started by bash. `/runners stop <id> [reason]` stops one, `/runners start [name=x] [cwd=y] [interactive=true] -- <command>` starts one.';\nexport const SERVER_COMMAND_DESCRIPTION = 'Start and stop supervised background runners without a terminal UI.';\nexport const RUNNER_UNAVAILABLE_MESSAGE = 'Subprocess supervision is unavailable on this host.';\n","export const RUNNERS_STOP_VERB = 'stop';\nexport const RUNNERS_START_VERB = 'start';\nexport const RUNNERS_COMMAND_SEPARATOR = '--';\nexport const NAME_KEY = 'name';\nexport const CWD_KEY = 'cwd';\nexport const INTERACTIVE_KEY = 'interactive';\n/** `interactive=prefer`: a terminal when rmux or tmux is available, plain output otherwise. */\nexport const INTERACTIVE_PREFER = 'prefer';\n","import {\n  CWD_KEY,\n  INTERACTIVE_KEY,\n  INTERACTIVE_PREFER,\n  NAME_KEY,\n  RUNNERS_COMMAND_SEPARATOR,\n  RUNNERS_START_VERB,\n  RUNNERS_STOP_VERB,\n} from '../../constants/runnersCommand';\n/** The `/runners` verb that stops one runner without opening Runner Space. */\n/** The `/runners` verb that starts one, for a client that cannot call the bash tool. */\n/**\n * Ends the options and begins the command.\n *\n * A command is arbitrary shell: it may hold `=`, and it may hold flags of its\n * own (`pnpm test -- --watch`). Only the first of these is the separator, so\n * everything the reader typed survives intact after it.\n */\n\nexport interface RunnersStartRequest {\n  kind: 'start';\n  /** The shell command to run; empty when the reader gave none. */\n  command: string;\n  cwd?: string;\n  name?: string;\n  interactive: boolean;\n  /** `interactive=prefer`: a terminal when one is available, plain output otherwise. */\n  preferInteractive?: boolean;\n}\n\nexport type RunnersCommandRequest =\n  /** No arguments: open Runner Space. */\n  | { kind: 'space' }\n  /** `stop <id> [reason]`: stop one runner headlessly; id is empty when it was left out. */\n  | { kind: 'stop'; id: string; reason?: string }\n  /** `start [key=value ...] -- <command>`: start one headlessly. */\n  | RunnersStartRequest;\n\n/** Splits on whitespace but keeps a double-quoted run together, so a path with spaces survives. */\nfunction tokenize(text: string): string[] {\n  return text.match(/(?:\"[^\"]*\"|\\S)+/gu) ?? [];\n}\n\nfunction unquote(value: string): string {\n  return value.length >= 2 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Parses `start`'s tail: `key=value` pairs up to the separator, then the\n * command verbatim.\n *\n * Without a separator the whole tail is the command, so typing\n * `/runners start pnpm build` does what it looks like. Options are read only\n * when a separator says where they end, which is what keeps a command such as\n * `FOO=bar pnpm test` from being mistaken for one.\n */\nfunction parseStart(tail: string): RunnersStartRequest {\n  const tokens = tokenize(tail);\n  const separator = tokens.indexOf(RUNNERS_COMMAND_SEPARATOR);\n  if (separator === -1) return { kind: 'start', command: tail.trim(), interactive: false };\n\n  const request: RunnersStartRequest = {\n    kind: 'start',\n    // Sliced from the raw text rather than rejoined from tokens: rejoining\n    // would collapse the spacing the reader wrote.\n    command: tail.slice(tail.indexOf(RUNNERS_COMMAND_SEPARATOR) + RUNNERS_COMMAND_SEPARATOR.length).trim(),\n    interactive: false,\n  };\n  for (const token of tokens.slice(0, separator)) {\n    const split = token.indexOf('=');\n    if (split <= 0) continue;\n    const value = unquote(token.slice(split + 1));\n    const key = token.slice(0, split);\n    if (key === NAME_KEY && value !== '') request.name = value;\n    if (key === CWD_KEY && value !== '') request.cwd = value;\n    if (key === INTERACTIVE_KEY) {\n      request.interactive = value === 'true';\n      if (value === INTERACTIVE_PREFER) request.preferInteractive = true;\n    }\n  }\n  return request;\n}\n\n/**\n * Parses `/runners` arguments. Anything other than a known verb opens Runner\n * Space, which is what the bare command has always done.\n */\nexport function parseRunnersCommand(args: string): RunnersCommandRequest {\n  const trimmed = args.trim();\n  const [verb = '', id = '', ...rest] = trimmed.split(/\\s+/u).filter(Boolean);\n  if (verb === RUNNERS_START_VERB) return parseStart(trimmed.slice(verb.length).trim());\n  if (verb !== RUNNERS_STOP_VERB) return { kind: 'space' };\n  const reason = rest.join(' ').trim();\n  return { kind: 'stop', id, ...(reason ? { reason } : {}) };\n}\n","import { resolve } from 'node:path';\n\nimport type {\n  PoHeadlessCommand,\n  PoHeadlessExecutionContext,\n  PoHeadlessTool,\n  PoHeadlessToolResult,\n} from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { BASH_TOOL_LABEL, BASH_TOOL_NAME } from '../../constants/bashTool';\nimport { MS_PER_SECOND } from '../../constants/headless';\nimport { COMMAND_NAME, SERVER_COMMAND_DESCRIPTION } from '../../constants/runners';\nimport { type BashParams, BashParamsSchema } from '../../schemas/bashTool';\nimport { formatRunResult } from '../../services/bashResult';\nimport { stopRunnerProcess } from '../../services/reconcile';\nimport { getBackgroundThresholdMs } from '../../services/runnerConfig';\nimport type { RunnerDependencies } from '../../services/runnerDependencies/type';\nimport { parseRunnersCommand } from '../../services/runnersCommand';\nimport type { RunnerSequenceService } from '../runnerSequence';\nimport { isSequenceId } from '../runnerSequenceStore';\n\nexport function createHeadlessBashTool(\n  runSequence: RunnerSequenceService['run'] | undefined,\n  environment: Readonly<Record<string, string | undefined>>,\n): PoHeadlessTool<typeof BashParamsSchema> {\n  return {\n    name: BASH_TOOL_NAME,\n    label: BASH_TOOL_LABEL,\n    description:\n      'Execute an array of Bash commands in order in the current working directory, stopping on first failure. Each command gets a complete saved log; return all log paths and only the last executed result. Do not pipe or redirect output to a file, head, or tail. Runner saves full logs automatically and bounds returned output.',\n    promptSnippet: 'Execute shell commands with bounded foreground output and supervised background runners',\n    promptGuidelines: [\n      `A command sequence still running after ${Math.round(getBackgroundThresholdMs(environment) / MS_PER_SECOND)} seconds remains active as a background runner with an id and streaming log paths.`,\n      'Pass background: true for commands that should remain active, such as dev servers and watchers.',\n      'Always pass command as an array, including for one command. interactive: true applies only to the last command.',\n      'Do not pipe or redirect command output to a file, head, or tail. Full logs are saved automatically; returned output is already bounded.',\n      'Stop background runners when they are no longer needed.',\n    ],\n    parameters: BashParamsSchema,\n    executionMode: 'serial',\n    execute: async (\n      _toolCallId: string,\n      params: BashParams,\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => {\n      if (signal?.aborted) throw new Error('Operation aborted');\n      if (!runSequence) throw new Error('This host does not support supervised Bash command sequences.');\n      return runSequence(params, context, _toolCallId, signal, onUpdate);\n    },\n  };\n}\n\nexport interface HeadlessRunnersCommandOptions {\n  /** Checks a typed folder exists before a runner starts in it. */\n  fs?: FileSystem | undefined;\n  /** Hears every start: why it did not happen, or undefined when it did, so the runners panel can say. */\n  onStart?: (sessionId: string, failure: string | undefined) => void;\n  sequences?: Pick<RunnerSequenceService, 'get' | 'stop'>;\n}\n\n/** A folder as typed, relative to the session directory; undefined when it is not one. */\nasync function runnerFolder(\n  sessionDirectory: string,\n  folder: string | undefined,\n  fs: FileSystem | undefined,\n): Promise<string | undefined> {\n  if (folder === undefined) return sessionDirectory;\n  const path = resolve(sessionDirectory, folder);\n  if (!fs) return path;\n  const info = await fs.fileInfo(path, BACKGROUND_CONTEXT);\n  return info.ok && info.value.kind === 'directory' ? path : undefined;\n}\n\nexport function createHeadlessRunnersCommand(\n  dependencies: RunnerDependencies,\n  { fs, onStart, sequences }: HeadlessRunnersCommandOptions = {},\n): PoHeadlessCommand {\n  return {\n    name: COMMAND_NAME,\n    description: SERVER_COMMAND_DESCRIPTION,\n    async execute(args: string, context: PoHeadlessExecutionContext) {\n      const request = parseRunnersCommand(args);\n      if (request.kind === 'space') {\n        const active = await dependencies.runnerRegistry.listBySession(context.sessionId);\n        await context.client.notify({\n          body: `${active.length} active runner${active.length === 1 ? '' : 's'}.`,\n          level: 'info',\n        });\n        return;\n      }\n      if (request.kind === 'start') {\n        if (!request.command) throw new Error('Usage: /runners start [name=x] [cwd=y] [interactive=true] -- <command>');\n        const cwd = await runnerFolder(context.cwd, request.cwd, fs);\n        if (cwd === undefined) {\n          const message = `That folder does not exist: ${request.cwd ?? ''}`;\n          onStart?.(context.sessionId, message);\n          await context.client.notify({ body: message, level: 'error' });\n          return;\n        }\n        const result = await dependencies.bashRunService.run({\n          command: request.command,\n          background: true,\n          sessionId: context.sessionId,\n          cwd,\n          ...(request.name ? { name: request.name } : {}),\n          ...(request.interactive ? { interactive: true } : {}),\n          ...(request.preferInteractive ? { preferInteractive: true } : {}),\n        });\n        onStart?.(context.sessionId, result.kind === 'failed' ? result.error : undefined);\n        await context.client.notify({\n          body:\n            (await formatRunResult(result, {}, undefined, dependencies.settings, dependencies.environment)).content[0]\n              ?.text ?? 'Runner started.',\n          level: result.kind === 'failed' ? 'error' : 'info',\n        });\n        return;\n      }\n      if (!request.id) throw new Error('Usage: /runners stop <runner-id> [reason]');\n      if (isSequenceId(request.id)) {\n        if (!sequences) throw new Error('Sequence controls are unavailable.');\n        await sequences.stop(request.id, request.reason);\n        await context.client.notify({ body: `Stop requested for sequence ${request.id}.`, level: 'info' });\n        return;\n      }\n      const record = await dependencies.runnerRegistry.get(request.id, context.sessionId);\n      if (!record) {\n        await context.client.notify({ body: `No active runner ${request.id} in this session.`, level: 'warning' });\n        return;\n      }\n      const stopped = await stopRunnerProcess(record, dependencies.launcher, dependencies.rmuxBackend, {\n        registry: dependencies.runnerRegistry,\n        intent: {\n          reason: 'stopped',\n          terminationReason: 'user_stop',\n          ...(request.reason ? { stopReason: request.reason } : {}),\n        },\n      });\n      if (stopped) {\n        await dependencies.runnerRegistry.complete(\n          request.id,\n          {\n            reason: 'stopped',\n            code: null,\n            signal: null,\n            ...(request.reason ? { stopReason: request.reason } : {}),\n          },\n          context.sessionId,\n        );\n      }\n      await context.client.notify({\n        body: stopped ? `Stopped runner ${request.id}.` : `Could not stop runner ${request.id}.`,\n        level: stopped ? 'info' : 'error',\n      });\n    },\n  };\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.112",
   "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.112",
+    "@agimon-ai/po-ui": "0.0.0-alpha.112",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.112",
+    "@agimon-ai/po-web-security": "0.0.0-alpha.112",
     "@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.112",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.112",
     "@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.112",
     "@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.112",
+    "@agimon-ai/po-runner-rmux-darwin-x64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rmux-linux-arm64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rmux-linux-x64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rtk-darwin-arm64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rtk-darwin-x64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rtk-linux-arm64": "0.0.0-alpha.112",
+    "@agimon-ai/po-runner-rtk-linux-x64": "0.0.0-alpha.112"
   },
   "engines": {
     "node": ">=24"