acpx 0.6.1 → 0.7.0

package/README.md

@@ -225,6 +225,7 @@ runtime and persists run state under `~/.acpx/flows/runs/`.
 Flows are for multi-step ACP work where one prompt is not enough:
 
 - `acp` steps keep model-shaped work in ACP
+- `decision()` and `decisionEdge()` wrap constrained-choice ACP branching without adding a new node type
 - `action` steps handle deterministic mechanics like shell commands or GitHub calls
 - `compute` steps do local routing or shaping
 - `checkpoint` steps pause for something outside the runtime

package/dist/{cli-Ddxpnz9X.js → cli-T-Z-9x6a.js}

@@ -1,6 +1,6 @@
-import { C as permissionModeSatisfies } from "./prompt-turn-BY5SwU1F.js";
-import { _ as resolvePermissionMode, a as hasExplicitPermissionModeFlag, g as resolveOutputPolicy, h as resolveGlobalFlags, m as resolveAgentInvocation } from "./flags-yXzUm7Aq.js";
-import { i as FlowRunner, o as validateFlowDefinition, p as isDefinedFlow } from "./flows-CDsfbaA2.js";
+import { w as permissionModeSatisfies } from "./prompt-turn-CVPMWdj1.js";
+import { _ as resolvePermissionMode, a as hasExplicitPermissionModeFlag, g as resolveOutputPolicy, h as resolveGlobalFlags, m as resolveAgentInvocation } from "./flags-Dj-IXgo9.js";
+import { c as validateFlowDefinition, h as isDefinedFlow, o as FlowRunner } from "./flows-CF8w1rPI.js";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import path from "node:path";
 import { InvalidArgumentError } from "commander";
@@ -169,4 +169,4 @@ function printFlowRunResult(result, globalFlags) {
 //#endregion
 export { handleFlowRun };
 
-//# sourceMappingURL=cli-Ddxpnz9X.js.map
+//# sourceMappingURL=cli-T-Z-9x6a.js.map

package/dist/{cli-Ddxpnz9X.js.map → cli-T-Z-9x6a.js.map}

@@ -1 +1 @@
-{"version":3,"file":"cli-Ddxpnz9X.js","names":[],"sources":["../src/flows/cli.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { InvalidArgumentError, type Command } from \"commander\";\nimport type { ResolvedAcpxConfig } from \"../cli/config.js\";\nimport {\n  hasExplicitPermissionModeFlag,\n  resolveAgentInvocation,\n  resolveGlobalFlags,\n  resolveOutputPolicy,\n  resolvePermissionMode,\n  type GlobalFlags,\n} from \"../cli/flags.js\";\nimport { type FlowDefinition, FlowRunner } from \"../flows.js\";\nimport { permissionModeSatisfies } from \"../permissions.js\";\nimport type { PermissionMode } from \"../types.js\";\nimport { isDefinedFlow } from \"./authoring.js\";\nimport { validateFlowDefinition } from \"./graph.js\";\n\ntype FlowRunFlags = {\n  inputJson?: string;\n  inputFile?: string;\n  defaultAgent?: string;\n};\n\nconst FLOW_RUNTIME_SPECIFIER = \"acpx/flows\";\nconst TEXT_MODULE_EXTENSIONS = new Set([\".js\", \".mjs\", \".cjs\", \".ts\", \".tsx\", \".mts\", \".cts\"]);\n\nexport async function handleFlowRun(\n  flowFile: string,\n  flags: FlowRunFlags,\n  command: Command,\n  config: ResolvedAcpxConfig,\n): Promise<void> {\n  const globalFlags = resolveGlobalFlags(command, config);\n  const permissionMode = resolvePermissionMode(globalFlags, config.defaultPermissions);\n  const outputPolicy = resolveOutputPolicy(globalFlags.format, globalFlags.jsonStrict === true);\n  const input = await readFlowInput(flags);\n  const flowPath = path.resolve(flowFile);\n  const flow = await loadFlowModule(flowPath);\n  assertFlowPermissionRequirements(flow, permissionMode, globalFlags);\n\n  const runner = new FlowRunner({\n    resolveAgent: (profile?: string) => {\n      return resolveAgentInvocation(profile ?? flags.defaultAgent, globalFlags, config);\n    },\n    permissionMode,\n    mcpServers: config.mcpServers,\n    nonInteractivePermissions: globalFlags.nonInteractivePermissions,\n    authCredentials: config.auth,\n    authPolicy: globalFlags.authPolicy,\n    timeoutMs: globalFlags.timeout,\n    ttlMs: globalFlags.ttl,\n    verbose: globalFlags.verbose,\n    suppressSdkConsoleErrors: outputPolicy.suppressSdkConsoleErrors,\n    sessionOptions: {\n      model: globalFlags.model,\n      allowedTools: globalFlags.allowedTools,\n      maxTurns: globalFlags.maxTurns,\n    },\n  });\n\n  const result = await runner.run(flow, input, {\n    flowPath,\n  });\n\n  printFlowRunResult(result, globalFlags);\n}\n\nfunction assertFlowPermissionRequirements(\n  flow: FlowDefinition,\n  permissionMode: PermissionMode,\n  globalFlags: GlobalFlags,\n): void {\n  const permissions = flow.permissions;\n  if (!permissions) {\n    return;\n  }\n\n  if (permissions.requireExplicitGrant && !hasExplicitPermissionModeFlag(globalFlags)) {\n    throw new InvalidArgumentError(\n      buildFlowPermissionFailureMessage(flow, permissions.requiredMode, permissions.reason, true),\n    );\n  }\n\n  if (!permissionModeSatisfies(permissionMode, permissions.requiredMode)) {\n    throw new InvalidArgumentError(\n      buildFlowPermissionFailureMessage(flow, permissions.requiredMode, permissions.reason, false),\n    );\n  }\n}\n\nfunction buildFlowPermissionFailureMessage(\n  flow: FlowDefinition,\n  requiredMode: PermissionMode,\n  reason?: string,\n  explicit = false,\n): string {\n  return [\n    explicit\n      ? `Flow \"${flow.name}\" requires an explicit ${requiredMode} grant.`\n      : `Flow \"${flow.name}\" requires permission mode ${requiredMode}.`,\n    `Rerun with --${requiredMode}.`,\n    ...(reason ? [`Reason: ${reason}`] : []),\n  ].join(\" \");\n}\n\nasync function readFlowInput(flags: FlowRunFlags): Promise<unknown> {\n  if (flags.inputJson && flags.inputFile) {\n    throw new InvalidArgumentError(\"Use only one of --input-json or --input-file\");\n  }\n\n  if (flags.inputJson) {\n    return parseJsonInput(flags.inputJson, \"--input-json\");\n  }\n\n  if (flags.inputFile) {\n    const inputPath = path.resolve(flags.inputFile);\n    const payload = await fs.readFile(inputPath, \"utf8\");\n    return parseJsonInput(payload, \"--input-file\");\n  }\n\n  return {};\n}\n\nasync function loadFlowModule(flowPath: string): Promise<FlowDefinition> {\n  const extension = path.extname(flowPath).toLowerCase();\n  const prepared = await prepareFlowModuleImport(flowPath, extension);\n  try {\n    const module = await loadFlowRuntimeModule(prepared.flowUrl, extension);\n\n    const candidate = findFlowDefinition(module);\n    if (!candidate) {\n      throw new Error(\n        `Flow module must export default defineFlow({...}) from \"acpx/flows\": ${flowPath}`,\n      );\n    }\n    validateFlowDefinition(candidate);\n    return candidate;\n  } finally {\n    await prepared.cleanup?.();\n  }\n}\n\nasync function prepareFlowModuleImport(\n  flowPath: string,\n  extension: string,\n): Promise<{\n  flowUrl: string;\n  cleanup?: () => Promise<void>;\n}> {\n  const flowUrl = pathToFileURL(flowPath).href;\n  if (!TEXT_MODULE_EXTENSIONS.has(extension)) {\n    return { flowUrl };\n  }\n\n  const source = await fs.readFile(flowPath, \"utf8\");\n  if (!source.includes(FLOW_RUNTIME_SPECIFIER)) {\n    return { flowUrl };\n  }\n\n  const runtimeSpecifier = resolveFlowRuntimeImportSpecifier();\n  const rewritten = source.replaceAll(\n    /([\"'])acpx\\/flows\\1/g,\n    (_match, quote: string) => `${quote}${runtimeSpecifier}${quote}`,\n  );\n  if (rewritten === source) {\n    return { flowUrl };\n  }\n\n  const tempPath = path.join(path.dirname(flowPath), `.acpx-flow-load-${randomUUID()}${extension}`);\n  await fs.writeFile(tempPath, rewritten, \"utf8\");\n  return {\n    flowUrl: pathToFileURL(tempPath).href,\n    cleanup: async () => {\n      await fs.rm(tempPath, { force: true });\n    },\n  };\n}\n\nfunction resolveFlowRuntimeImportSpecifier(): string {\n  const selfPath = fileURLToPath(import.meta.url);\n\n  if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.ts`)) {\n    return new URL(\"../flows.ts\", import.meta.url).href;\n  }\n  if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.js`)) {\n    return new URL(\"../flows.js\", import.meta.url).href;\n  }\n  return new URL(\"./flows.js\", import.meta.url).href;\n}\n\nasync function loadFlowRuntimeModule(\n  flowUrl: string,\n  extension: string,\n): Promise<{\n  default?: unknown;\n  \"module.exports\"?: unknown;\n}> {\n  if (extension === \".ts\" || extension === \".tsx\" || extension === \".mts\" || extension === \".cts\") {\n    const { tsImport } = (await import(\"tsx/esm/api\")) as {\n      tsImport: (\n        specifier: string,\n        parentURL: string,\n      ) => Promise<{\n        default?: unknown;\n        \"module.exports\"?: unknown;\n      }>;\n    };\n    return (await tsImport(flowUrl, import.meta.url)) as {\n      default?: unknown;\n      \"module.exports\"?: unknown;\n    };\n  }\n\n  return (await import(flowUrl)) as {\n    default?: unknown;\n    \"module.exports\"?: unknown;\n  };\n}\n\nfunction findFlowDefinition(module: {\n  default?: unknown;\n  \"module.exports\"?: unknown;\n}): FlowDefinition | null {\n  const candidates = [\n    module.default,\n    module[\"module.exports\"],\n    getNestedDefault(module.default),\n    getNestedDefault(module[\"module.exports\"]),\n  ];\n\n  for (const candidate of candidates) {\n    if (isDefinedFlow(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction getNestedDefault(value: unknown): unknown {\n  if (!value || typeof value !== \"object\" || !(\"default\" in value)) {\n    return null;\n  }\n  return (value as { default?: unknown }).default ?? null;\n}\n\nfunction parseJsonInput(raw: string, label: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch (error) {\n    throw new InvalidArgumentError(\n      `${label} must contain valid JSON: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n\nfunction printFlowRunResult(\n  result: Awaited<ReturnType<FlowRunner[\"run\"]>>,\n  globalFlags: GlobalFlags,\n): void {\n  const payload = {\n    action: \"flow_run_result\",\n    runId: result.state.runId,\n    flowName: result.state.flowName,\n    runTitle: result.state.runTitle,\n    flowPath: result.state.flowPath,\n    status: result.state.status,\n    currentNode: result.state.currentNode,\n    currentNodeType: result.state.currentNodeType,\n    currentNodeStartedAt: result.state.currentNodeStartedAt,\n    lastHeartbeatAt: result.state.lastHeartbeatAt,\n    statusDetail: result.state.statusDetail,\n    waitingOn: result.state.waitingOn,\n    runDir: result.runDir,\n    outputs: result.state.outputs,\n    sessionBindings: result.state.sessionBindings,\n  };\n\n  if (globalFlags.format === \"json\") {\n    process.stdout.write(`${JSON.stringify(payload)}\\n`);\n    return;\n  }\n\n  if (globalFlags.format === \"quiet\") {\n    process.stdout.write(`${result.state.runId}\\n`);\n    return;\n  }\n\n  process.stdout.write(`runId: ${payload.runId}\\n`);\n  process.stdout.write(`flow: ${payload.flowName}\\n`);\n  if (payload.runTitle) {\n    process.stdout.write(`title: ${payload.runTitle}\\n`);\n  }\n  process.stdout.write(`status: ${payload.status}\\n`);\n  process.stdout.write(`runDir: ${payload.runDir}\\n`);\n  if (payload.currentNode) {\n    process.stdout.write(`currentNode: ${payload.currentNode}\\n`);\n  }\n  if (payload.statusDetail) {\n    process.stdout.write(`statusDetail: ${payload.statusDetail}\\n`);\n  }\n  if (payload.waitingOn) {\n    process.stdout.write(`waitingOn: ${payload.waitingOn}\\n`);\n  }\n  process.stdout.write(`${JSON.stringify(payload.outputs, null, 2)}\\n`);\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli-T-Z-9x6a.js","names":[],"sources":["../src/flows/cli.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { InvalidArgumentError, type Command } from \"commander\";\nimport type { ResolvedAcpxConfig } from \"../cli/config.js\";\nimport {\n  hasExplicitPermissionModeFlag,\n  resolveAgentInvocation,\n  resolveGlobalFlags,\n  resolveOutputPolicy,\n  resolvePermissionMode,\n  type GlobalFlags,\n} from \"../cli/flags.js\";\nimport { type FlowDefinition, FlowRunner } from \"../flows.js\";\nimport { permissionModeSatisfies } from \"../permissions.js\";\nimport type { PermissionMode } from \"../types.js\";\nimport { isDefinedFlow } from \"./authoring.js\";\nimport { validateFlowDefinition } from \"./graph.js\";\n\ntype FlowRunFlags = {\n  inputJson?: string;\n  inputFile?: string;\n  defaultAgent?: string;\n};\n\nconst FLOW_RUNTIME_SPECIFIER = \"acpx/flows\";\nconst TEXT_MODULE_EXTENSIONS = new Set([\".js\", \".mjs\", \".cjs\", \".ts\", \".tsx\", \".mts\", \".cts\"]);\n\nexport async function handleFlowRun(\n  flowFile: string,\n  flags: FlowRunFlags,\n  command: Command,\n  config: ResolvedAcpxConfig,\n): Promise<void> {\n  const globalFlags = resolveGlobalFlags(command, config);\n  const permissionMode = resolvePermissionMode(globalFlags, config.defaultPermissions);\n  const outputPolicy = resolveOutputPolicy(globalFlags.format, globalFlags.jsonStrict === true);\n  const input = await readFlowInput(flags);\n  const flowPath = path.resolve(flowFile);\n  const flow = await loadFlowModule(flowPath);\n  assertFlowPermissionRequirements(flow, permissionMode, globalFlags);\n\n  const runner = new FlowRunner({\n    resolveAgent: (profile?: string) => {\n      return resolveAgentInvocation(profile ?? flags.defaultAgent, globalFlags, config);\n    },\n    permissionMode,\n    mcpServers: config.mcpServers,\n    nonInteractivePermissions: globalFlags.nonInteractivePermissions,\n    authCredentials: config.auth,\n    authPolicy: globalFlags.authPolicy,\n    timeoutMs: globalFlags.timeout,\n    ttlMs: globalFlags.ttl,\n    verbose: globalFlags.verbose,\n    suppressSdkConsoleErrors: outputPolicy.suppressSdkConsoleErrors,\n    sessionOptions: {\n      model: globalFlags.model,\n      allowedTools: globalFlags.allowedTools,\n      maxTurns: globalFlags.maxTurns,\n    },\n  });\n\n  const result = await runner.run(flow, input, {\n    flowPath,\n  });\n\n  printFlowRunResult(result, globalFlags);\n}\n\nfunction assertFlowPermissionRequirements(\n  flow: FlowDefinition,\n  permissionMode: PermissionMode,\n  globalFlags: GlobalFlags,\n): void {\n  const permissions = flow.permissions;\n  if (!permissions) {\n    return;\n  }\n\n  if (permissions.requireExplicitGrant && !hasExplicitPermissionModeFlag(globalFlags)) {\n    throw new InvalidArgumentError(\n      buildFlowPermissionFailureMessage(flow, permissions.requiredMode, permissions.reason, true),\n    );\n  }\n\n  if (!permissionModeSatisfies(permissionMode, permissions.requiredMode)) {\n    throw new InvalidArgumentError(\n      buildFlowPermissionFailureMessage(flow, permissions.requiredMode, permissions.reason, false),\n    );\n  }\n}\n\nfunction buildFlowPermissionFailureMessage(\n  flow: FlowDefinition,\n  requiredMode: PermissionMode,\n  reason?: string,\n  explicit = false,\n): string {\n  return [\n    explicit\n      ? `Flow \"${flow.name}\" requires an explicit ${requiredMode} grant.`\n      : `Flow \"${flow.name}\" requires permission mode ${requiredMode}.`,\n    `Rerun with --${requiredMode}.`,\n    ...(reason ? [`Reason: ${reason}`] : []),\n  ].join(\" \");\n}\n\nasync function readFlowInput(flags: FlowRunFlags): Promise<unknown> {\n  if (flags.inputJson && flags.inputFile) {\n    throw new InvalidArgumentError(\"Use only one of --input-json or --input-file\");\n  }\n\n  if (flags.inputJson) {\n    return parseJsonInput(flags.inputJson, \"--input-json\");\n  }\n\n  if (flags.inputFile) {\n    const inputPath = path.resolve(flags.inputFile);\n    const payload = await fs.readFile(inputPath, \"utf8\");\n    return parseJsonInput(payload, \"--input-file\");\n  }\n\n  return {};\n}\n\nasync function loadFlowModule(flowPath: string): Promise<FlowDefinition> {\n  const extension = path.extname(flowPath).toLowerCase();\n  const prepared = await prepareFlowModuleImport(flowPath, extension);\n  try {\n    const module = await loadFlowRuntimeModule(prepared.flowUrl, extension);\n\n    const candidate = findFlowDefinition(module);\n    if (!candidate) {\n      throw new Error(\n        `Flow module must export default defineFlow({...}) from \"acpx/flows\": ${flowPath}`,\n      );\n    }\n    validateFlowDefinition(candidate);\n    return candidate;\n  } finally {\n    await prepared.cleanup?.();\n  }\n}\n\nasync function prepareFlowModuleImport(\n  flowPath: string,\n  extension: string,\n): Promise<{\n  flowUrl: string;\n  cleanup?: () => Promise<void>;\n}> {\n  const flowUrl = pathToFileURL(flowPath).href;\n  if (!TEXT_MODULE_EXTENSIONS.has(extension)) {\n    return { flowUrl };\n  }\n\n  const source = await fs.readFile(flowPath, \"utf8\");\n  if (!source.includes(FLOW_RUNTIME_SPECIFIER)) {\n    return { flowUrl };\n  }\n\n  const runtimeSpecifier = resolveFlowRuntimeImportSpecifier();\n  const rewritten = source.replaceAll(\n    /([\"'])acpx\\/flows\\1/g,\n    (_match, quote: string) => `${quote}${runtimeSpecifier}${quote}`,\n  );\n  if (rewritten === source) {\n    return { flowUrl };\n  }\n\n  const tempPath = path.join(path.dirname(flowPath), `.acpx-flow-load-${randomUUID()}${extension}`);\n  await fs.writeFile(tempPath, rewritten, \"utf8\");\n  return {\n    flowUrl: pathToFileURL(tempPath).href,\n    cleanup: async () => {\n      await fs.rm(tempPath, { force: true });\n    },\n  };\n}\n\nfunction resolveFlowRuntimeImportSpecifier(): string {\n  const selfPath = fileURLToPath(import.meta.url);\n\n  if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.ts`)) {\n    return new URL(\"../flows.ts\", import.meta.url).href;\n  }\n  if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.js`)) {\n    return new URL(\"../flows.js\", import.meta.url).href;\n  }\n  return new URL(\"./flows.js\", import.meta.url).href;\n}\n\nasync function loadFlowRuntimeModule(\n  flowUrl: string,\n  extension: string,\n): Promise<{\n  default?: unknown;\n  \"module.exports\"?: unknown;\n}> {\n  if (extension === \".ts\" || extension === \".tsx\" || extension === \".mts\" || extension === \".cts\") {\n    const { tsImport } = (await import(\"tsx/esm/api\")) as {\n      tsImport: (\n        specifier: string,\n        parentURL: string,\n      ) => Promise<{\n        default?: unknown;\n        \"module.exports\"?: unknown;\n      }>;\n    };\n    return (await tsImport(flowUrl, import.meta.url)) as {\n      default?: unknown;\n      \"module.exports\"?: unknown;\n    };\n  }\n\n  return (await import(flowUrl)) as {\n    default?: unknown;\n    \"module.exports\"?: unknown;\n  };\n}\n\nfunction findFlowDefinition(module: {\n  default?: unknown;\n  \"module.exports\"?: unknown;\n}): FlowDefinition | null {\n  const candidates = [\n    module.default,\n    module[\"module.exports\"],\n    getNestedDefault(module.default),\n    getNestedDefault(module[\"module.exports\"]),\n  ];\n\n  for (const candidate of candidates) {\n    if (isDefinedFlow(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction getNestedDefault(value: unknown): unknown {\n  if (!value || typeof value !== \"object\" || !(\"default\" in value)) {\n    return null;\n  }\n  return (value as { default?: unknown }).default ?? null;\n}\n\nfunction parseJsonInput(raw: string, label: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch (error) {\n    throw new InvalidArgumentError(\n      `${label} must contain valid JSON: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n\nfunction printFlowRunResult(\n  result: Awaited<ReturnType<FlowRunner[\"run\"]>>,\n  globalFlags: GlobalFlags,\n): void {\n  const payload = {\n    action: \"flow_run_result\",\n    runId: result.state.runId,\n    flowName: result.state.flowName,\n    runTitle: result.state.runTitle,\n    flowPath: result.state.flowPath,\n    status: result.state.status,\n    currentNode: result.state.currentNode,\n    currentNodeType: result.state.currentNodeType,\n    currentNodeStartedAt: result.state.currentNodeStartedAt,\n    lastHeartbeatAt: result.state.lastHeartbeatAt,\n    statusDetail: result.state.statusDetail,\n    waitingOn: result.state.waitingOn,\n    runDir: result.runDir,\n    outputs: result.state.outputs,\n    sessionBindings: result.state.sessionBindings,\n  };\n\n  if (globalFlags.format === \"json\") {\n    process.stdout.write(`${JSON.stringify(payload)}\\n`);\n    return;\n  }\n\n  if (globalFlags.format === \"quiet\") {\n    process.stdout.write(`${result.state.runId}\\n`);\n    return;\n  }\n\n  process.stdout.write(`runId: ${payload.runId}\\n`);\n  process.stdout.write(`flow: ${payload.flowName}\\n`);\n  if (payload.runTitle) {\n    process.stdout.write(`title: ${payload.runTitle}\\n`);\n  }\n  process.stdout.write(`status: ${payload.status}\\n`);\n  process.stdout.write(`runDir: ${payload.runDir}\\n`);\n  if (payload.currentNode) {\n    process.stdout.write(`currentNode: ${payload.currentNode}\\n`);\n  }\n  if (payload.statusDetail) {\n    process.stdout.write(`statusDetail: ${payload.statusDetail}\\n`);\n  }\n  if (payload.waitingOn) {\n    process.stdout.write(`waitingOn: ${payload.waitingOn}\\n`);\n  }\n  process.stdout.write(`${JSON.stringify(payload.outputs, null, 2)}\\n`);\n}\n"],"mappings":"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"}

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { A as OUTPUT_FORMATS, E as EXIT_CODES, _ as exitCodeForOutputErrorCode, d as PromptInputValidationError, g as textPrompt, m as parsePromptSource, p as mergePromptSourceWithText, x as normalizeOutputError } from "./perf-metrics-C2pXfxvR.js";
-import { D as findSession, E as findGitRepositoryRoot, G as InterruptedError, O as findSessionByDirectoryWalk, X as listBuiltInAgents, Y as DEFAULT_AGENT_NAME, Z as normalizeAgentName } from "./prompt-turn-BY5SwU1F.js";
-import { a as buildQueueOwnerArgOverride, n as runSessionQueueOwner, o as flushPerfMetricsCapture, s as installPerfMetricsCapture } from "./session-BwgaPK8-.js";
-import { s as probeQueueOwnerHealth } from "./ipc-BruTG5Fb.js";
-import { _ as resolvePermissionMode, c as parseHistoryLimit, d as parsePruneBeforeDate, f as parseSessionName, g as resolveOutputPolicy, h as resolveGlobalFlags, i as addSessionOption, l as parseMaxTurns, m as resolveAgentInvocation, n as addPromptInputOption, o as parseAllowedTools, p as parseTtlSeconds, r as addSessionNameOption, s as parseDaysOlderThan, t as addGlobalFlags, u as parseNonEmptyValue, v as resolveSessionNameFromFlags } from "./flags-yXzUm7Aq.js";
-import { i as emitJsonResult, n as formatPromptSessionBannerLine, t as agentSessionIdPayload } from "./render-yqwtaOX4.js";
+import { D as findGitRepositoryRoot, K as InterruptedError, O as findSession, Q as normalizeAgentName, X as DEFAULT_AGENT_NAME, Z as listBuiltInAgents, k as findSessionByDirectoryWalk } from "./prompt-turn-CVPMWdj1.js";
+import { a as buildQueueOwnerArgOverride, n as runSessionQueueOwner, o as flushPerfMetricsCapture, s as installPerfMetricsCapture } from "./session-CDaQe6BH.js";
+import { c as probeQueueOwnerHealth } from "./ipc-ABXlXzGP.js";
+import { _ as resolvePermissionMode, c as parseHistoryLimit, d as parsePruneBeforeDate, f as parseSessionName, g as resolveOutputPolicy, h as resolveGlobalFlags, i as addSessionOption, l as parseMaxTurns, m as resolveAgentInvocation, n as addPromptInputOption, o as parseAllowedTools, p as parseTtlSeconds, r as addSessionNameOption, s as parseDaysOlderThan, t as addGlobalFlags, u as parseNonEmptyValue, v as resolveSessionNameFromFlags } from "./flags-Dj-IXgo9.js";
+import { i as emitJsonResult, n as formatPromptSessionBannerLine, t as agentSessionIdPayload } from "./render-N5YwotCy.js";
 import { n as getTextErrorRemediationHints, t as createOutputFormatter } from "./output-DmHvT8vm.js";
 import { readFileSync, realpathSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -69,7 +69,7 @@ let sessionModulePromise;
 let outputModulePromise;
 let outputRenderModulePromise;
 function loadSessionModule() {
-	sessionModulePromise ??= import("./session-BwgaPK8-.js").then((n) => n.t);
+	sessionModulePromise ??= import("./session-CDaQe6BH.js").then((n) => n.t);
 	return sessionModulePromise;
 }
 function loadOutputModule() {
@@ -77,7 +77,7 @@ function loadOutputModule() {
 	return outputModulePromise;
 }
 function loadOutputRenderModule() {
-	outputRenderModulePromise ??= import("./render-yqwtaOX4.js").then((n) => n.r);
+	outputRenderModulePromise ??= import("./render-N5YwotCy.js").then((n) => n.r);
 	return outputRenderModulePromise;
 }
 async function readPromptInputFromStdin() {
@@ -1140,7 +1140,7 @@ function registerAgentCommand(program, agentName, config) {
 }
 function registerFlowCommand(program, config) {
 	program.command("flow").description("Run multi-step ACP workflows from flow files").command("run").description("Run a flow file").argument("<file>", "Flow module path").option("--input-json <json>", "Flow input as JSON").option("--input-file <path>", "Read flow input JSON from file").option("--default-agent <name>", "Default agent profile for ACP nodes without profile", (value) => parseNonEmptyValue("Default agent", value)).action(async function(file, flags) {
-		const { handleFlowRun } = await import("./cli-Ddxpnz9X.js");
+		const { handleFlowRun } = await import("./cli-T-Z-9x6a.js");
 		await handleFlowRun(file, flags, this, config);
 	});
 }

package/dist/{client-2fTFutRH.d.ts → client-COPilhO_.d.ts}

@@ -1,5 +1,5 @@
 import { a as PermissionMode, c as PromptInput, i as NonInteractivePermissionPolicy, o as PermissionStats, t as AcpClientOptions } from "./types-CVBeQyi3.js";
-import { InitializeResponse, PromptResponse, SessionModelState, SetSessionConfigOptionResponse } from "@agentclientprotocol/sdk";
+import { InitializeResponse, PromptResponse, SessionConfigOption, SessionModelState, SetSessionConfigOptionResponse } from "@agentclientprotocol/sdk";
 
 //#region src/acp/client.d.ts
 type LoadSessionOptions = {
@@ -10,10 +10,12 @@ type LoadSessionOptions = {
 type SessionCreateResult = {
   sessionId: string;
   agentSessionId?: string;
+  configOptions?: SessionConfigOption[];
   models?: SessionModelState;
 };
 type SessionLoadResult = {
   agentSessionId?: string;
+  configOptions?: SessionConfigOption[];
   models?: SessionModelState;
 };
 type AgentDisconnectReason = "process_exit" | "process_close" | "pipe_close" | "connection_close";
@@ -120,4 +122,4 @@ declare class AcpClient {
 }
 //#endregion
 export { AcpClient as t };
-//# sourceMappingURL=client-2fTFutRH.d.ts.map
+//# sourceMappingURL=client-COPilhO_.d.ts.map

package/dist/client-COPilhO_.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-COPilhO_.d.ts","names":[],"sources":["../src/acp/client.ts"],"mappings":"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"}

package/dist/{flags-yXzUm7Aq.js → flags-Dj-IXgo9.js}

@@ -1,6 +1,6 @@
 import { A as OUTPUT_FORMATS, D as NON_INTERACTIVE_PERMISSION_POLICIES, T as AUTH_POLICIES } from "./perf-metrics-C2pXfxvR.js";
-import { Q as resolveAgentCommand } from "./prompt-turn-BY5SwU1F.js";
-import "./session-BwgaPK8-.js";
+import { $ as resolveAgentCommand } from "./prompt-turn-CVPMWdj1.js";
+import "./session-CDaQe6BH.js";
 import path from "node:path";
 import { InvalidArgumentError } from "commander";
 //#region src/cli/flags.ts
@@ -160,4 +160,4 @@ function resolveAgentInvocation(explicitAgentName, globalFlags, config) {
 //#endregion
 export { resolvePermissionMode as _, hasExplicitPermissionModeFlag as a, parseHistoryLimit as c, parsePruneBeforeDate as d, parseSessionName as f, resolveOutputPolicy as g, resolveGlobalFlags as h, addSessionOption as i, parseMaxTurns as l, resolveAgentInvocation as m, addPromptInputOption as n, parseAllowedTools as o, parseTtlSeconds as p, addSessionNameOption as r, parseDaysOlderThan as s, addGlobalFlags as t, parseNonEmptyValue as u, resolveSessionNameFromFlags as v };
 
-//# sourceMappingURL=flags-yXzUm7Aq.js.map
+//# sourceMappingURL=flags-Dj-IXgo9.js.map

package/dist/{flags-yXzUm7Aq.js.map → flags-Dj-IXgo9.js.map}

@@ -1 +1 @@
-{"version":3,"file":"flags-yXzUm7Aq.js","names":["resolveAgentCommandFromRegistry"],"sources":["../src/cli/flags.ts"],"sourcesContent":["import path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport type { Command } from \"commander\";\nimport {\n  DEFAULT_AGENT_NAME,\n  resolveAgentCommand as resolveAgentCommandFromRegistry,\n} from \"../agent-registry.js\";\nimport type { SystemPromptOption } from \"../runtime/engine/session-options.js\";\nimport { DEFAULT_QUEUE_OWNER_TTL_MS } from \"../session/session.js\";\nimport {\n  AUTH_POLICIES,\n  NON_INTERACTIVE_PERMISSION_POLICIES,\n  OUTPUT_FORMATS,\n  type AuthPolicy,\n  type NonInteractivePermissionPolicy,\n  type OutputFormat,\n  type OutputPolicy,\n  type PermissionMode,\n} from \"../types.js\";\nimport type { ResolvedAcpxConfig } from \"./config.js\";\n\nexport type PermissionFlags = {\n  approveAll?: boolean;\n  approveReads?: boolean;\n  denyAll?: boolean;\n};\n\nexport function hasExplicitPermissionModeFlag(flags: PermissionFlags): boolean {\n  return flags.approveAll === true || flags.approveReads === true || flags.denyAll === true;\n}\n\nexport type GlobalFlags = PermissionFlags & {\n  agent?: string;\n  cwd: string;\n  authPolicy?: AuthPolicy;\n  nonInteractivePermissions: NonInteractivePermissionPolicy;\n  jsonStrict?: boolean;\n  suppressReads?: boolean;\n  terminal?: boolean;\n  timeout?: number;\n  ttl: number;\n  verbose?: boolean;\n  format: OutputFormat;\n  model?: string;\n  allowedTools?: string[];\n  maxTurns?: number;\n  systemPrompt?: SystemPromptOption;\n  promptRetries?: number;\n};\n\nexport type PromptFlags = {\n  session?: string;\n  wait?: boolean;\n  file?: string;\n};\n\nexport type ExecFlags = {\n  file?: string;\n};\n\nexport type SessionsNewFlags = {\n  name?: string;\n  resumeSession?: string;\n};\n\nexport type SessionsHistoryFlags = {\n  limit: number;\n};\n\nexport type StatusFlags = {\n  session?: string;\n};\n\nexport type SessionsPruneFlags = {\n  dryRun?: boolean;\n  before?: Date;\n  olderThan?: number;\n  includeHistory?: boolean;\n};\n\nexport function parseOutputFormat(value: string): OutputFormat {\n  if (!OUTPUT_FORMATS.includes(value as OutputFormat)) {\n    throw new InvalidArgumentError(\n      `Invalid format \"${value}\". Expected one of: ${OUTPUT_FORMATS.join(\", \")}`,\n    );\n  }\n  return value as OutputFormat;\n}\n\nexport function parseAuthPolicy(value: string): AuthPolicy {\n  if (!AUTH_POLICIES.includes(value as AuthPolicy)) {\n    throw new InvalidArgumentError(\n      `Invalid auth policy \"${value}\". Expected one of: ${AUTH_POLICIES.join(\", \")}`,\n    );\n  }\n  return value as AuthPolicy;\n}\n\nexport function parseNonInteractivePermissionPolicy(value: string): NonInteractivePermissionPolicy {\n  if (!NON_INTERACTIVE_PERMISSION_POLICIES.includes(value as NonInteractivePermissionPolicy)) {\n    throw new InvalidArgumentError(\n      `Invalid non-interactive permission policy \"${value}\". Expected one of: ${NON_INTERACTIVE_PERMISSION_POLICIES.join(\", \")}`,\n    );\n  }\n  return value as NonInteractivePermissionPolicy;\n}\n\nexport function parseTimeoutSeconds(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Timeout must be a positive number of seconds\");\n  }\n  return Math.round(parsed * 1000);\n}\n\nexport function parseTtlSeconds(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new InvalidArgumentError(\"TTL must be a non-negative number of seconds\");\n  }\n  return Math.round(parsed * 1000);\n}\n\nexport function parseSessionName(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new InvalidArgumentError(\"Session name must not be empty\");\n  }\n  return trimmed;\n}\n\nexport function parseNonEmptyValue(label: string, value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new InvalidArgumentError(`${label} must not be empty`);\n  }\n  return trimmed;\n}\n\nexport function parseHistoryLimit(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Limit must be a positive integer\");\n  }\n  return parsed;\n}\n\nexport function parseDaysOlderThan(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"--older-than must be a positive integer number of days\");\n  }\n  return parsed;\n}\n\nexport function parsePruneBeforeDate(value: string): Date {\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    throw new InvalidArgumentError(\n      `--before must be a valid date (e.g. 2026-01-01 or 2026-01-01T00:00:00Z)`,\n    );\n  }\n  return date;\n}\n\nexport function parseAllowedTools(value: string): string[] {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    return [];\n  }\n\n  const items = trimmed.split(\",\").map((item) => item.trim());\n  if (items.some((item) => item.length === 0)) {\n    throw new InvalidArgumentError(\n      \"Allowed tools must be a comma-separated list without empty entries\",\n    );\n  }\n\n  return items;\n}\n\nexport function parseMaxTurns(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Max turns must be a positive integer\");\n  }\n  return parsed;\n}\n\nexport function resolveSystemPromptFlag(opts: {\n  systemPrompt?: unknown;\n  appendSystemPrompt?: unknown;\n}): SystemPromptOption | undefined {\n  const replace =\n    typeof opts.systemPrompt === \"string\" && opts.systemPrompt.length > 0\n      ? opts.systemPrompt\n      : undefined;\n  const append =\n    typeof opts.appendSystemPrompt === \"string\" && opts.appendSystemPrompt.length > 0\n      ? opts.appendSystemPrompt\n      : undefined;\n\n  if (replace !== undefined && append !== undefined) {\n    throw new InvalidArgumentError(\"Use only one of --system-prompt or --append-system-prompt\");\n  }\n  if (replace !== undefined) {\n    return replace;\n  }\n  if (append !== undefined) {\n    return { append };\n  }\n  return undefined;\n}\n\nexport function parsePromptRetries(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new InvalidArgumentError(\"Prompt retries must be a non-negative integer\");\n  }\n  return parsed;\n}\n\nexport function resolvePermissionMode(\n  flags: PermissionFlags,\n  defaultMode: PermissionMode,\n): PermissionMode {\n  const selected = [flags.approveAll, flags.approveReads, flags.denyAll].filter(Boolean).length;\n\n  if (selected > 1) {\n    throw new InvalidArgumentError(\n      \"Use only one permission mode: --approve-all, --approve-reads, or --deny-all\",\n    );\n  }\n\n  if (flags.approveAll) {\n    return \"approve-all\";\n  }\n  if (flags.approveReads) {\n    return \"approve-reads\";\n  }\n  if (flags.denyAll) {\n    return \"deny-all\";\n  }\n\n  return defaultMode;\n}\n\nexport function addGlobalFlags(command: Command): Command {\n  return command\n    .option(\"--agent <command>\", \"Raw ACP agent command (escape hatch)\")\n    .option(\"--cwd <dir>\", \"Working directory\", process.cwd())\n    .option(\n      \"--auth-policy <policy>\",\n      \"Authentication policy: skip or fail when auth is required\",\n      parseAuthPolicy,\n    )\n    .option(\"--approve-all\", \"Auto-approve all permission requests\")\n    .option(\"--approve-reads\", \"Auto-approve read/search requests and prompt for writes\")\n    .option(\"--deny-all\", \"Deny all permission requests\")\n    .option(\n      \"--non-interactive-permissions <policy>\",\n      \"When prompting is unavailable: deny or fail\",\n      parseNonInteractivePermissionPolicy,\n    )\n    .option(\"--format <fmt>\", \"Output format: text, json, quiet\", parseOutputFormat)\n    .option(\"--suppress-reads\", \"Suppress raw read-file contents in output\")\n    .option(\"--model <id>\", \"Agent model id\")\n    .option(\n      \"--allowed-tools <list>\",\n      'Allowed tool names as a comma-separated list (use \"\" for no tools)',\n      parseAllowedTools,\n    )\n    .option(\"--max-turns <count>\", \"Maximum turns for the session\", parseMaxTurns)\n    .option(\n      \"--system-prompt <text>\",\n      \"Replace the agent system prompt (claude-agent-acp via ACP _meta.systemPrompt)\",\n      (value: string) => parseNonEmptyValue(\"System prompt\", value),\n    )\n    .option(\n      \"--append-system-prompt <text>\",\n      \"Append text to the agent system prompt (claude-agent-acp via ACP _meta.systemPrompt.append)\",\n      (value: string) => parseNonEmptyValue(\"Append system prompt\", value),\n    )\n    .option(\n      \"--prompt-retries <count>\",\n      \"Retry failed prompt turns on transient errors (default: 0)\",\n      parsePromptRetries,\n    )\n    .option(\n      \"--json-strict\",\n      \"Strict JSON mode: requires --format json and suppresses non-JSON stderr output\",\n    )\n    .option(\"--no-terminal\", \"Do not advertise ACP terminal capability\")\n    .option(\"--timeout <seconds>\", \"Maximum time to wait for agent response\", parseTimeoutSeconds)\n    .option(\n      \"--ttl <seconds>\",\n      \"Queue owner idle TTL before shutdown (0 = keep alive forever) (default: 300)\",\n      parseTtlSeconds,\n    )\n    .option(\"--verbose\", \"Enable verbose debug logs\");\n}\n\nexport function addSessionOption(command: Command): Command {\n  return command\n    .option(\"-s, --session <name>\", \"Use named session instead of cwd default\", parseSessionName)\n    .option(\n      \"--no-wait\",\n      \"Queue prompt and return immediately when another prompt is already running\",\n    );\n}\n\nexport function addSessionNameOption(command: Command): Command {\n  return command.option(\n    \"-s, --session <name>\",\n    \"Use named session instead of cwd default\",\n    parseSessionName,\n  );\n}\n\nexport function resolveSessionNameFromFlags(\n  flags: StatusFlags,\n  command: Command,\n): string | undefined {\n  if (flags.session) {\n    return flags.session;\n  }\n\n  // Commander parses options on the parent command when flags appear before the\n  // subcommand (e.g. `acpx codex -s foo cancel`). Use optsWithGlobals() so\n  // subcommands can still access those values.\n  const allOpts = (command as unknown as { optsWithGlobals?: () => unknown }).optsWithGlobals?.();\n  if (allOpts && typeof (allOpts as { session?: unknown }).session === \"string\") {\n    return parseSessionName((allOpts as { session: string }).session);\n  }\n\n  const parentOpts = command.parent?.opts?.();\n  if (parentOpts && typeof (parentOpts as { session?: unknown }).session === \"string\") {\n    return parseSessionName((parentOpts as { session: string }).session);\n  }\n\n  return undefined;\n}\n\nexport function addPromptInputOption(command: Command): Command {\n  return command.option(\"-f, --file <path>\", \"Read prompt text from file path (use - for stdin)\");\n}\n\nexport function resolveGlobalFlags(command: Command, config: ResolvedAcpxConfig): GlobalFlags {\n  const opts = command.optsWithGlobals();\n  const format = opts.format ?? config.format ?? \"text\";\n  const jsonStrict = opts.jsonStrict === true;\n  const verbose = opts.verbose === true;\n\n  if (jsonStrict && format !== \"json\") {\n    throw new InvalidArgumentError(\"--json-strict requires --format json\");\n  }\n\n  if (jsonStrict && verbose) {\n    throw new InvalidArgumentError(\"--json-strict cannot be combined with --verbose\");\n  }\n\n  return {\n    agent: opts.agent,\n    cwd: opts.cwd ?? process.cwd(),\n    authPolicy: opts.authPolicy ?? config.authPolicy,\n    nonInteractivePermissions: opts.nonInteractivePermissions ?? config.nonInteractivePermissions,\n    jsonStrict,\n    suppressReads: opts.suppressReads === true,\n    terminal: opts.terminal === false ? false : undefined,\n    timeout: opts.timeout ?? config.timeoutMs,\n    ttl: opts.ttl ?? config.ttlMs ?? DEFAULT_QUEUE_OWNER_TTL_MS,\n    verbose,\n    format,\n    model: typeof opts.model === \"string\" ? parseNonEmptyValue(\"Model\", opts.model) : undefined,\n    allowedTools: Array.isArray(opts.allowedTools) ? opts.allowedTools : undefined,\n    maxTurns: typeof opts.maxTurns === \"number\" ? opts.maxTurns : undefined,\n    systemPrompt: resolveSystemPromptFlag(opts),\n    promptRetries: typeof opts.promptRetries === \"number\" ? opts.promptRetries : undefined,\n    approveAll: opts.approveAll ? true : undefined,\n    approveReads: opts.approveReads ? true : undefined,\n    denyAll: opts.denyAll ? true : undefined,\n  };\n}\n\nexport function resolveOutputPolicy(format: OutputFormat, jsonStrict: boolean): OutputPolicy {\n  return {\n    format,\n    jsonStrict,\n    suppressReads: false,\n    suppressNonJsonStderr: jsonStrict,\n    queueErrorAlreadyEmitted: format !== \"quiet\",\n    suppressSdkConsoleErrors: jsonStrict,\n  };\n}\n\nexport function resolveAgentInvocation(\n  explicitAgentName: string | undefined,\n  globalFlags: GlobalFlags,\n  config: ResolvedAcpxConfig,\n): {\n  agentName: string;\n  agentCommand: string;\n  cwd: string;\n} {\n  const override = globalFlags.agent?.trim();\n  if (override && explicitAgentName) {\n    throw new InvalidArgumentError(\"Do not combine positional agent with --agent override\");\n  }\n\n  const agentName = explicitAgentName ?? config.defaultAgent ?? DEFAULT_AGENT_NAME;\n  const agentCommand =\n    override && override.length > 0\n      ? override\n      : resolveAgentCommandFromRegistry(agentName, config.agents);\n\n  return {\n    agentName,\n    agentCommand,\n    cwd: path.resolve(globalFlags.cwd),\n  };\n}\n"],"mappings":";;;;;;AA2BA,SAAgB,8BAA8B,OAAiC;AAC7E,QAAO,MAAM,eAAe,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,YAAY;;AAoDvF,SAAgB,kBAAkB,OAA6B;AAC7D,KAAI,CAAC,eAAe,SAAS,MAAsB,CACjD,OAAM,IAAI,qBACR,mBAAmB,MAAM,sBAAsB,eAAe,KAAK,KAAK,GACzE;AAEH,QAAO;;AAGT,SAAgB,gBAAgB,OAA2B;AACzD,KAAI,CAAC,cAAc,SAAS,MAAoB,CAC9C,OAAM,IAAI,qBACR,wBAAwB,MAAM,sBAAsB,cAAc,KAAK,KAAK,GAC7E;AAEH,QAAO;;AAGT,SAAgB,oCAAoC,OAA+C;AACjG,KAAI,CAAC,oCAAoC,SAAS,MAAwC,CACxF,OAAM,IAAI,qBACR,8CAA8C,MAAM,sBAAsB,oCAAoC,KAAK,KAAK,GACzH;AAEH,QAAO;;AAGT,SAAgB,oBAAoB,OAAuB;CACzD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,UAAU,EACxC,OAAM,IAAI,qBAAqB,+CAA+C;AAEhF,QAAO,KAAK,MAAM,SAAS,IAAK;;AAGlC,SAAgB,gBAAgB,OAAuB;CACrD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,SAAS,EACvC,OAAM,IAAI,qBAAqB,+CAA+C;AAEhF,QAAO,KAAK,MAAM,SAAS,IAAK;;AAGlC,SAAgB,iBAAiB,OAAuB;CACtD,MAAM,UAAU,MAAM,MAAM;AAC5B,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,qBAAqB,iCAAiC;AAElE,QAAO;;AAGT,SAAgB,mBAAmB,OAAe,OAAuB;CACvE,MAAM,UAAU,MAAM,MAAM;AAC5B,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,qBAAqB,GAAG,MAAM,oBAAoB;AAE9D,QAAO;;AAGT,SAAgB,kBAAkB,OAAuB;CACvD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,UAAU,EACzC,OAAM,IAAI,qBAAqB,mCAAmC;AAEpE,QAAO;;AAGT,SAAgB,mBAAmB,OAAuB;CACxD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,UAAU,EACzC,OAAM,IAAI,qBAAqB,yDAAyD;AAE1F,QAAO;;AAGT,SAAgB,qBAAqB,OAAqB;CACxD,MAAM,OAAO,IAAI,KAAK,MAAM;AAC5B,KAAI,OAAO,MAAM,KAAK,SAAS,CAAC,CAC9B,OAAM,IAAI,qBACR,0EACD;AAEH,QAAO;;AAGT,SAAgB,kBAAkB,OAAyB;CACzD,MAAM,UAAU,MAAM,MAAM;AAC5B,KAAI,QAAQ,WAAW,EACrB,QAAO,EAAE;CAGX,MAAM,QAAQ,QAAQ,MAAM,IAAI,CAAC,KAAK,SAAS,KAAK,MAAM,CAAC;AAC3D,KAAI,MAAM,MAAM,SAAS,KAAK,WAAW,EAAE,CACzC,OAAM,IAAI,qBACR,qEACD;AAGH,QAAO;;AAGT,SAAgB,cAAc,OAAuB;CACnD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,UAAU,EACzC,OAAM,IAAI,qBAAqB,uCAAuC;AAExE,QAAO;;AAGT,SAAgB,wBAAwB,MAGL;CACjC,MAAM,UACJ,OAAO,KAAK,iBAAiB,YAAY,KAAK,aAAa,SAAS,IAChE,KAAK,eACL,KAAA;CACN,MAAM,SACJ,OAAO,KAAK,uBAAuB,YAAY,KAAK,mBAAmB,SAAS,IAC5E,KAAK,qBACL,KAAA;AAEN,KAAI,YAAY,KAAA,KAAa,WAAW,KAAA,EACtC,OAAM,IAAI,qBAAqB,4DAA4D;AAE7F,KAAI,YAAY,KAAA,EACd,QAAO;AAET,KAAI,WAAW,KAAA,EACb,QAAO,EAAE,QAAQ;;AAKrB,SAAgB,mBAAmB,OAAuB;CACxD,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,EACxC,OAAM,IAAI,qBAAqB,gDAAgD;AAEjF,QAAO;;AAGT,SAAgB,sBACd,OACA,aACgB;AAGhB,KAFiB;EAAC,MAAM;EAAY,MAAM;EAAc,MAAM;EAAQ,CAAC,OAAO,QAAQ,CAAC,SAExE,EACb,OAAM,IAAI,qBACR,8EACD;AAGH,KAAI,MAAM,WACR,QAAO;AAET,KAAI,MAAM,aACR,QAAO;AAET,KAAI,MAAM,QACR,QAAO;AAGT,QAAO;;AAGT,SAAgB,eAAe,SAA2B;AACxD,QAAO,QACJ,OAAO,qBAAqB,uCAAuC,CACnE,OAAO,eAAe,qBAAqB,QAAQ,KAAK,CAAC,CACzD,OACC,0BACA,6DACA,gBACD,CACA,OAAO,iBAAiB,uCAAuC,CAC/D,OAAO,mBAAmB,0DAA0D,CACpF,OAAO,cAAc,+BAA+B,CACpD,OACC,0CACA,+CACA,oCACD,CACA,OAAO,kBAAkB,oCAAoC,kBAAkB,CAC/E,OAAO,oBAAoB,4CAA4C,CACvE,OAAO,gBAAgB,iBAAiB,CACxC,OACC,0BACA,wEACA,kBACD,CACA,OAAO,uBAAuB,iCAAiC,cAAc,CAC7E,OACC,0BACA,kFACC,UAAkB,mBAAmB,iBAAiB,MAAM,CAC9D,CACA,OACC,iCACA,gGACC,UAAkB,mBAAmB,wBAAwB,MAAM,CACrE,CACA,OACC,4BACA,8DACA,mBACD,CACA,OACC,iBACA,iFACD,CACA,OAAO,iBAAiB,2CAA2C,CACnE,OAAO,uBAAuB,2CAA2C,oBAAoB,CAC7F,OACC,mBACA,gFACA,gBACD,CACA,OAAO,aAAa,4BAA4B;;AAGrD,SAAgB,iBAAiB,SAA2B;AAC1D,QAAO,QACJ,OAAO,wBAAwB,4CAA4C,iBAAiB,CAC5F,OACC,aACA,6EACD;;AAGL,SAAgB,qBAAqB,SAA2B;AAC9D,QAAO,QAAQ,OACb,wBACA,4CACA,iBACD;;AAGH,SAAgB,4BACd,OACA,SACoB;AACpB,KAAI,MAAM,QACR,QAAO,MAAM;CAMf,MAAM,UAAW,QAA2D,mBAAmB;AAC/F,KAAI,WAAW,OAAQ,QAAkC,YAAY,SACnE,QAAO,iBAAkB,QAAgC,QAAQ;CAGnE,MAAM,aAAa,QAAQ,QAAQ,QAAQ;AAC3C,KAAI,cAAc,OAAQ,WAAqC,YAAY,SACzE,QAAO,iBAAkB,WAAmC,QAAQ;;AAMxE,SAAgB,qBAAqB,SAA2B;AAC9D,QAAO,QAAQ,OAAO,qBAAqB,oDAAoD;;AAGjG,SAAgB,mBAAmB,SAAkB,QAAyC;CAC5F,MAAM,OAAO,QAAQ,iBAAiB;CACtC,MAAM,SAAS,KAAK,UAAU,OAAO,UAAU;CAC/C,MAAM,aAAa,KAAK,eAAe;CACvC,MAAM,UAAU,KAAK,YAAY;AAEjC,KAAI,cAAc,WAAW,OAC3B,OAAM,IAAI,qBAAqB,uCAAuC;AAGxE,KAAI,cAAc,QAChB,OAAM,IAAI,qBAAqB,kDAAkD;AAGnF,QAAO;EACL,OAAO,KAAK;EACZ,KAAK,KAAK,OAAO,QAAQ,KAAK;EAC9B,YAAY,KAAK,cAAc,OAAO;EACtC,2BAA2B,KAAK,6BAA6B,OAAO;EACpE;EACA,eAAe,KAAK,kBAAkB;EACtC,UAAU,KAAK,aAAa,QAAQ,QAAQ,KAAA;EAC5C,SAAS,KAAK,WAAW,OAAO;EAChC,KAAK,KAAK,OAAO,OAAO,SAAA;EACxB;EACA;EACA,OAAO,OAAO,KAAK,UAAU,WAAW,mBAAmB,SAAS,KAAK,MAAM,GAAG,KAAA;EAClF,cAAc,MAAM,QAAQ,KAAK,aAAa,GAAG,KAAK,eAAe,KAAA;EACrE,UAAU,OAAO,KAAK,aAAa,WAAW,KAAK,WAAW,KAAA;EAC9D,cAAc,wBAAwB,KAAK;EAC3C,eAAe,OAAO,KAAK,kBAAkB,WAAW,KAAK,gBAAgB,KAAA;EAC7E,YAAY,KAAK,aAAa,OAAO,KAAA;EACrC,cAAc,KAAK,eAAe,OAAO,KAAA;EACzC,SAAS,KAAK,UAAU,OAAO,KAAA;EAChC;;AAGH,SAAgB,oBAAoB,QAAsB,YAAmC;AAC3F,QAAO;EACL;EACA;EACA,eAAe;EACf,uBAAuB;EACvB,0BAA0B,WAAW;EACrC,0BAA0B;EAC3B;;AAGH,SAAgB,uBACd,mBACA,aACA,QAKA;CACA,MAAM,WAAW,YAAY,OAAO,MAAM;AAC1C,KAAI,YAAY,kBACd,OAAM,IAAI,qBAAqB,wDAAwD;CAGzF,MAAM,YAAY,qBAAqB,OAAO,gBAAA;AAM9C,QAAO;EACL;EACA,cANA,YAAY,SAAS,SAAS,IAC1B,WACAA,oBAAgC,WAAW,OAAO,OAAO;EAK7D,KAAK,KAAK,QAAQ,YAAY,IAAI;EACnC"}
+{"version":3,"file":"flags-Dj-IXgo9.js","names":["resolveAgentCommandFromRegistry"],"sources":["../src/cli/flags.ts"],"sourcesContent":["import path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport type { Command } from \"commander\";\nimport {\n  DEFAULT_AGENT_NAME,\n  resolveAgentCommand as resolveAgentCommandFromRegistry,\n} from \"../agent-registry.js\";\nimport type { SystemPromptOption } from \"../runtime/engine/session-options.js\";\nimport { DEFAULT_QUEUE_OWNER_TTL_MS } from \"../session/session.js\";\nimport {\n  AUTH_POLICIES,\n  NON_INTERACTIVE_PERMISSION_POLICIES,\n  OUTPUT_FORMATS,\n  type AuthPolicy,\n  type NonInteractivePermissionPolicy,\n  type OutputFormat,\n  type OutputPolicy,\n  type PermissionMode,\n} from \"../types.js\";\nimport type { ResolvedAcpxConfig } from \"./config.js\";\n\nexport type PermissionFlags = {\n  approveAll?: boolean;\n  approveReads?: boolean;\n  denyAll?: boolean;\n};\n\nexport function hasExplicitPermissionModeFlag(flags: PermissionFlags): boolean {\n  return flags.approveAll === true || flags.approveReads === true || flags.denyAll === true;\n}\n\nexport type GlobalFlags = PermissionFlags & {\n  agent?: string;\n  cwd: string;\n  authPolicy?: AuthPolicy;\n  nonInteractivePermissions: NonInteractivePermissionPolicy;\n  jsonStrict?: boolean;\n  suppressReads?: boolean;\n  terminal?: boolean;\n  timeout?: number;\n  ttl: number;\n  verbose?: boolean;\n  format: OutputFormat;\n  model?: string;\n  allowedTools?: string[];\n  maxTurns?: number;\n  systemPrompt?: SystemPromptOption;\n  promptRetries?: number;\n};\n\nexport type PromptFlags = {\n  session?: string;\n  wait?: boolean;\n  file?: string;\n};\n\nexport type ExecFlags = {\n  file?: string;\n};\n\nexport type SessionsNewFlags = {\n  name?: string;\n  resumeSession?: string;\n};\n\nexport type SessionsHistoryFlags = {\n  limit: number;\n};\n\nexport type StatusFlags = {\n  session?: string;\n};\n\nexport type SessionsPruneFlags = {\n  dryRun?: boolean;\n  before?: Date;\n  olderThan?: number;\n  includeHistory?: boolean;\n};\n\nexport function parseOutputFormat(value: string): OutputFormat {\n  if (!OUTPUT_FORMATS.includes(value as OutputFormat)) {\n    throw new InvalidArgumentError(\n      `Invalid format \"${value}\". Expected one of: ${OUTPUT_FORMATS.join(\", \")}`,\n    );\n  }\n  return value as OutputFormat;\n}\n\nexport function parseAuthPolicy(value: string): AuthPolicy {\n  if (!AUTH_POLICIES.includes(value as AuthPolicy)) {\n    throw new InvalidArgumentError(\n      `Invalid auth policy \"${value}\". Expected one of: ${AUTH_POLICIES.join(\", \")}`,\n    );\n  }\n  return value as AuthPolicy;\n}\n\nexport function parseNonInteractivePermissionPolicy(value: string): NonInteractivePermissionPolicy {\n  if (!NON_INTERACTIVE_PERMISSION_POLICIES.includes(value as NonInteractivePermissionPolicy)) {\n    throw new InvalidArgumentError(\n      `Invalid non-interactive permission policy \"${value}\". Expected one of: ${NON_INTERACTIVE_PERMISSION_POLICIES.join(\", \")}`,\n    );\n  }\n  return value as NonInteractivePermissionPolicy;\n}\n\nexport function parseTimeoutSeconds(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Timeout must be a positive number of seconds\");\n  }\n  return Math.round(parsed * 1000);\n}\n\nexport function parseTtlSeconds(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new InvalidArgumentError(\"TTL must be a non-negative number of seconds\");\n  }\n  return Math.round(parsed * 1000);\n}\n\nexport function parseSessionName(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new InvalidArgumentError(\"Session name must not be empty\");\n  }\n  return trimmed;\n}\n\nexport function parseNonEmptyValue(label: string, value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new InvalidArgumentError(`${label} must not be empty`);\n  }\n  return trimmed;\n}\n\nexport function parseHistoryLimit(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Limit must be a positive integer\");\n  }\n  return parsed;\n}\n\nexport function parseDaysOlderThan(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"--older-than must be a positive integer number of days\");\n  }\n  return parsed;\n}\n\nexport function parsePruneBeforeDate(value: string): Date {\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    throw new InvalidArgumentError(\n      `--before must be a valid date (e.g. 2026-01-01 or 2026-01-01T00:00:00Z)`,\n    );\n  }\n  return date;\n}\n\nexport function parseAllowedTools(value: string): string[] {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    return [];\n  }\n\n  const items = trimmed.split(\",\").map((item) => item.trim());\n  if (items.some((item) => item.length === 0)) {\n    throw new InvalidArgumentError(\n      \"Allowed tools must be a comma-separated list without empty entries\",\n    );\n  }\n\n  return items;\n}\n\nexport function parseMaxTurns(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new InvalidArgumentError(\"Max turns must be a positive integer\");\n  }\n  return parsed;\n}\n\nexport function resolveSystemPromptFlag(opts: {\n  systemPrompt?: unknown;\n  appendSystemPrompt?: unknown;\n}): SystemPromptOption | undefined {\n  const replace =\n    typeof opts.systemPrompt === \"string\" && opts.systemPrompt.length > 0\n      ? opts.systemPrompt\n      : undefined;\n  const append =\n    typeof opts.appendSystemPrompt === \"string\" && opts.appendSystemPrompt.length > 0\n      ? opts.appendSystemPrompt\n      : undefined;\n\n  if (replace !== undefined && append !== undefined) {\n    throw new InvalidArgumentError(\"Use only one of --system-prompt or --append-system-prompt\");\n  }\n  if (replace !== undefined) {\n    return replace;\n  }\n  if (append !== undefined) {\n    return { append };\n  }\n  return undefined;\n}\n\nexport function parsePromptRetries(value: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new InvalidArgumentError(\"Prompt retries must be a non-negative integer\");\n  }\n  return parsed;\n}\n\nexport function resolvePermissionMode(\n  flags: PermissionFlags,\n  defaultMode: PermissionMode,\n): PermissionMode {\n  const selected = [flags.approveAll, flags.approveReads, flags.denyAll].filter(Boolean).length;\n\n  if (selected > 1) {\n    throw new InvalidArgumentError(\n      \"Use only one permission mode: --approve-all, --approve-reads, or --deny-all\",\n    );\n  }\n\n  if (flags.approveAll) {\n    return \"approve-all\";\n  }\n  if (flags.approveReads) {\n    return \"approve-reads\";\n  }\n  if (flags.denyAll) {\n    return \"deny-all\";\n  }\n\n  return defaultMode;\n}\n\nexport function addGlobalFlags(command: Command): Command {\n  return command\n    .option(\"--agent <command>\", \"Raw ACP agent command (escape hatch)\")\n    .option(\"--cwd <dir>\", \"Working directory\", process.cwd())\n    .option(\n      \"--auth-policy <policy>\",\n      \"Authentication policy: skip or fail when auth is required\",\n      parseAuthPolicy,\n    )\n    .option(\"--approve-all\", \"Auto-approve all permission requests\")\n    .option(\"--approve-reads\", \"Auto-approve read/search requests and prompt for writes\")\n    .option(\"--deny-all\", \"Deny all permission requests\")\n    .option(\n      \"--non-interactive-permissions <policy>\",\n      \"When prompting is unavailable: deny or fail\",\n      parseNonInteractivePermissionPolicy,\n    )\n    .option(\"--format <fmt>\", \"Output format: text, json, quiet\", parseOutputFormat)\n    .option(\"--suppress-reads\", \"Suppress raw read-file contents in output\")\n    .option(\"--model <id>\", \"Agent model id\")\n    .option(\n      \"--allowed-tools <list>\",\n      'Allowed tool names as a comma-separated list (use \"\" for no tools)',\n      parseAllowedTools,\n    )\n    .option(\"--max-turns <count>\", \"Maximum turns for the session\", parseMaxTurns)\n    .option(\n      \"--system-prompt <text>\",\n      \"Replace the agent system prompt (claude-agent-acp via ACP _meta.systemPrompt)\",\n      (value: string) => parseNonEmptyValue(\"System prompt\", value),\n    )\n    .option(\n      \"--append-system-prompt <text>\",\n      \"Append text to the agent system prompt (claude-agent-acp via ACP _meta.systemPrompt.append)\",\n      (value: string) => parseNonEmptyValue(\"Append system prompt\", value),\n    )\n    .option(\n      \"--prompt-retries <count>\",\n      \"Retry failed prompt turns on transient errors (default: 0)\",\n      parsePromptRetries,\n    )\n    .option(\n      \"--json-strict\",\n      \"Strict JSON mode: requires --format json and suppresses non-JSON stderr output\",\n    )\n    .option(\"--no-terminal\", \"Do not advertise ACP terminal capability\")\n    .option(\"--timeout <seconds>\", \"Maximum time to wait for agent response\", parseTimeoutSeconds)\n    .option(\n      \"--ttl <seconds>\",\n      \"Queue owner idle TTL before shutdown (0 = keep alive forever) (default: 300)\",\n      parseTtlSeconds,\n    )\n    .option(\"--verbose\", \"Enable verbose debug logs\");\n}\n\nexport function addSessionOption(command: Command): Command {\n  return command\n    .option(\"-s, --session <name>\", \"Use named session instead of cwd default\", parseSessionName)\n    .option(\n      \"--no-wait\",\n      \"Queue prompt and return immediately when another prompt is already running\",\n    );\n}\n\nexport function addSessionNameOption(command: Command): Command {\n  return command.option(\n    \"-s, --session <name>\",\n    \"Use named session instead of cwd default\",\n    parseSessionName,\n  );\n}\n\nexport function resolveSessionNameFromFlags(\n  flags: StatusFlags,\n  command: Command,\n): string | undefined {\n  if (flags.session) {\n    return flags.session;\n  }\n\n  // Commander parses options on the parent command when flags appear before the\n  // subcommand (e.g. `acpx codex -s foo cancel`). Use optsWithGlobals() so\n  // subcommands can still access those values.\n  const allOpts = (command as unknown as { optsWithGlobals?: () => unknown }).optsWithGlobals?.();\n  if (allOpts && typeof (allOpts as { session?: unknown }).session === \"string\") {\n    return parseSessionName((allOpts as { session: string }).session);\n  }\n\n  const parentOpts = command.parent?.opts?.();\n  if (parentOpts && typeof (parentOpts as { session?: unknown }).session === \"string\") {\n    return parseSessionName((parentOpts as { session: string }).session);\n  }\n\n  return undefined;\n}\n\nexport function addPromptInputOption(command: Command): Command {\n  return command.option(\"-f, --file <path>\", \"Read prompt text from file path (use - for stdin)\");\n}\n\nexport function resolveGlobalFlags(command: Command, config: ResolvedAcpxConfig): GlobalFlags {\n  const opts = command.optsWithGlobals();\n  const format = opts.format ?? config.format ?? \"text\";\n  const jsonStrict = opts.jsonStrict === true;\n  const verbose = opts.verbose === true;\n\n  if (jsonStrict && format !== \"json\") {\n    throw new InvalidArgumentError(\"--json-strict requires --format json\");\n  }\n\n  if (jsonStrict && verbose) {\n    throw new InvalidArgumentError(\"--json-strict cannot be combined with --verbose\");\n  }\n\n  return {\n    agent: opts.agent,\n    cwd: opts.cwd ?? process.cwd(),\n    authPolicy: opts.authPolicy ?? config.authPolicy,\n    nonInteractivePermissions: opts.nonInteractivePermissions ?? config.nonInteractivePermissions,\n    jsonStrict,\n    suppressReads: opts.suppressReads === true,\n    terminal: opts.terminal === false ? false : undefined,\n    timeout: opts.timeout ?? config.timeoutMs,\n    ttl: opts.ttl ?? config.ttlMs ?? DEFAULT_QUEUE_OWNER_TTL_MS,\n    verbose,\n    format,\n    model: typeof opts.model === \"string\" ? parseNonEmptyValue(\"Model\", opts.model) : undefined,\n    allowedTools: Array.isArray(opts.allowedTools) ? opts.allowedTools : undefined,\n    maxTurns: typeof opts.maxTurns === \"number\" ? opts.maxTurns : undefined,\n    systemPrompt: resolveSystemPromptFlag(opts),\n    promptRetries: typeof opts.promptRetries === \"number\" ? opts.promptRetries : undefined,\n    approveAll: opts.approveAll ? true : undefined,\n    approveReads: opts.approveReads ? true : undefined,\n    denyAll: opts.denyAll ? true : undefined,\n  };\n}\n\nexport function resolveOutputPolicy(format: OutputFormat, jsonStrict: boolean): OutputPolicy {\n  return {\n    format,\n    jsonStrict,\n    suppressReads: false,\n    suppressNonJsonStderr: jsonStrict,\n    queueErrorAlreadyEmitted: format !== \"quiet\",\n    suppressSdkConsoleErrors: jsonStrict,\n  };\n}\n\nexport function resolveAgentInvocation(\n  explicitAgentName: string | undefined,\n  globalFlags: GlobalFlags,\n  config: ResolvedAcpxConfig,\n): {\n  agentName: string;\n  agentCommand: string;\n  cwd: string;\n} {\n  const override = globalFlags.agent?.trim();\n  if (override && explicitAgentName) {\n    throw new InvalidArgumentError(\"Do not combine positional agent with --agent override\");\n  }\n\n  const agentName = explicitAgentName ?? config.defaultAgent ?? DEFAULT_AGENT_NAME;\n  const agentCommand =\n    override && override.length > 0\n      ? override\n      : resolveAgentCommandFromRegistry(agentName, config.agents);\n\n  return {\n    agentName,\n    agentCommand,\n    cwd: path.resolve(globalFlags.cwd),\n  };\n}\n"],"mappings":"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"}

package/dist/{flows-CDsfbaA2.js → flows-CF8w1rPI.js}

@@ -1,6 +1,6 @@
 import { M as SESSION_RECORD_SCHEMA, g as textPrompt, h as promptToDisplayText, j as PERMISSION_MODES } from "./perf-metrics-C2pXfxvR.js";
-import { G as InterruptedError, J as withTimeout, K as TimeoutError, P as resolveSessionRecord, R as defaultSessionEventLog, _ as createSessionConversation, b as recordSessionUpdate, h as cloneSessionAcpxState, q as withInterrupt, v as recordClientOperation, y as recordPromptSubmission } from "./prompt-turn-BY5SwU1F.js";
-import { c as createSessionWithClient, i as sendSessionDirect, l as cancelSessionPrompt, r as runOnce } from "./session-BwgaPK8-.js";
+import { F as resolveSessionRecord, J as withInterrupt, K as InterruptedError, Y as withTimeout, b as recordPromptSubmission, g as cloneSessionAcpxState, q as TimeoutError, v as createSessionConversation, x as recordSessionUpdate, y as recordClientOperation, z as defaultSessionEventLog } from "./prompt-turn-CVPMWdj1.js";
+import { c as createSessionWithClient, i as sendSessionDirect, l as cancelSessionPrompt, r as runOnce } from "./session-CDaQe6BH.js";
 import { t as createOutputFormatter } from "./output-DmHvT8vm.js";
 import path from "node:path";
 import fs from "node:fs/promises";
@@ -465,7 +465,7 @@ function normalizeFlowRunTitle(value) {
 	return trimmed ? trimmed : void 0;
 }
 function createRunId(flowName) {
-	return `${isoNow$1().replaceAll(":", "").replaceAll(".", "")}-${flowName.replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "").toLowerCase()}-${randomUUID().slice(0, 8)}`;
+	return `${isoNow$1().replaceAll(":", "").replaceAll(".", "")}-${slugifyAsciiIdPart(flowName)}-${randomUUID().slice(0, 8)}`;
 }
 function createSessionBindingKey(agentCommand, cwd, handle) {
 	return `${agentCommand}::${cwd}::${handle}`;
@@ -474,7 +474,31 @@ function createSessionName(flowName, handle, cwd, runId) {
 	return `${flowName}-${handle}-${stableShortHash(cwd)}-${runId.slice(-8)}`;
 }
 function createSessionBundleId(handle, key) {
-	return `${handle.replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "").toLowerCase() || "session"}-${stableShortHash(key)}`;
+	return `${slugifyAsciiIdPart(handle) || "session"}-${stableShortHash(key)}`;
+}
+function slugifyAsciiIdPart(value) {
+	let slug = "";
+	let lastWasSeparator = false;
+	for (const char of value) {
+		const safeChar = toLowerAsciiAlphaNumeric(char);
+		if (safeChar) {
+			slug += safeChar;
+			lastWasSeparator = false;
+			continue;
+		}
+		if (slug.length > 0 && !lastWasSeparator) {
+			slug += "-";
+			lastWasSeparator = true;
+		}
+	}
+	return lastWasSeparator ? slug.slice(0, -1) : slug;
+}
+function toLowerAsciiAlphaNumeric(char) {
+	const code = char.charCodeAt(0);
+	if (code >= 48 && code <= 57) return char;
+	if (code >= 65 && code <= 90) return String.fromCharCode(code + 32);
+	if (code >= 97 && code <= 122) return char;
+	return null;
 }
 function createIsolatedSessionBinding(flowName, runId, attemptId, profile, agent) {
 	const key = `isolated::${attemptId}`;
@@ -1677,9 +1701,9 @@ function parseJsonObject(text, options = {}) {
 	const direct = tryParse(trimmed);
 	if (direct.ok) return direct.value;
 	if (mode === "fenced" || mode === "compat") {
-		const fencedMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
-		if (fencedMatch) {
-			const fenced = tryParse(fencedMatch[1].trim());
+		const fencedText = extractFencedJsonText(trimmed);
+		if (fencedText !== null) {
+			const fenced = tryParse(fencedText);
 			if (fenced.ok) return fenced.value;
 		}
 	}
@@ -1705,6 +1729,19 @@ function tryParse(text) {
 		return { ok: false };
 	}
 }
+function extractFencedJsonText(text) {
+	const openingFenceIndex = text.indexOf("```");
+	if (openingFenceIndex === -1) return null;
+	let contentStart = openingFenceIndex + 3;
+	if (text.slice(contentStart, contentStart + 4).toLowerCase() === "json" && isFenceWhitespace(text[contentStart + 4])) contentStart += 4;
+	while (isFenceWhitespace(text[contentStart])) contentStart += 1;
+	const closingFenceIndex = text.indexOf("```", contentStart);
+	if (closingFenceIndex === -1) return null;
+	return text.slice(contentStart, closingFenceIndex).trim();
+}
+function isFenceWhitespace(char) {
+	return char === " " || char === "\n" || char === "\r" || char === "	";
+}
 function extractBalancedJsonCandidates(text) {
 	const candidates = [];
 	for (let index = 0; index < text.length; index += 1) {
@@ -1743,6 +1780,72 @@ function scanBalanced(text, startIndex) {
 	return null;
 }
 //#endregion
-export { flowRunsBaseDir as a, action as c, defineFlow as d, shell as f, FlowRunner as i, checkpoint as l, parseJsonObject as n, validateFlowDefinition as o, isDefinedFlow as p, parseStrictJsonObject as r, acp as s, extractJsonObject as t, compute as u };
+//#region src/flows/decision.ts
+const DEFAULT_FIELD = "route";
+const SIMPLE_FIELD_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function decision(definition) {
+	const { question, choices, field: fieldOverride, ...acpOptions } = definition;
+	const field = normalizeField(fieldOverride);
+	assertValidChoices(choices);
+	const allowed = new Set(choices);
+	return acp({
+		...acpOptions,
+		async prompt(context) {
+			return formatDecisionPrompt(typeof question === "function" ? await question(context) : question, choices, field);
+		},
+		parse(text) {
+			const raw = extractJsonObject(text);
+			if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Decision response must be a JSON object, got ${typeof raw}`);
+			const value = raw[field];
+			if (typeof value !== "string" || !allowed.has(value)) {
+				const allowedLabels = choices.map((choice) => JSON.stringify(choice)).join(", ");
+				throw new Error(`Decision returned invalid ${field}=${JSON.stringify(value)}; expected one of ${allowedLabels}`);
+			}
+			return raw;
+		}
+	});
+}
+function decisionEdge(args) {
+	const field = normalizeField(args.field);
+	assertValidChoices(args.choices);
+	for (const choice of args.choices) if (!Object.hasOwn(args.cases, choice)) throw new Error(`Decision edge is missing case for choice ${JSON.stringify(choice)}`);
+	return {
+		from: args.from,
+		switch: {
+			on: `$.${field}`,
+			cases: args.cases
+		}
+	};
+}
+function assertValidChoices(choices) {
+	if (choices.length === 0) throw new Error("Decision choices must include at least one value");
+	const seen = /* @__PURE__ */ new Set();
+	for (const choice of choices) {
+		if (typeof choice !== "string" || choice.length === 0) throw new Error("Decision choices must be non-empty strings");
+		if (seen.has(choice)) throw new Error(`Decision choices must be unique; duplicate ${JSON.stringify(choice)}`);
+		seen.add(choice);
+	}
+}
+function normalizeField(fieldOverride) {
+	const field = fieldOverride ?? DEFAULT_FIELD;
+	if (!SIMPLE_FIELD_PATTERN.test(field)) throw new Error(`Decision field must be a simple JSON key matching ${SIMPLE_FIELD_PATTERN.source}`);
+	return field;
+}
+function formatDecisionPrompt(question, choices, field) {
+	const allowed = choices.map((choice) => JSON.stringify(choice)).join(" | ");
+	return [
+		question,
+		"",
+		"Return exactly one JSON object with this shape:",
+		"{",
+		`  ${JSON.stringify(field)}: ${allowed},`,
+		"  \"reason\": \"short justification\"",
+		"}",
+		"",
+		"Do not include any other text outside the JSON object."
+	].join("\n");
+}
+//#endregion
+export { parseStrictJsonObject as a, validateFlowDefinition as c, checkpoint as d, compute as f, isDefinedFlow as h, parseJsonObject as i, acp as l, shell as m, decisionEdge as n, FlowRunner as o, defineFlow as p, extractJsonObject as r, flowRunsBaseDir as s, decision as t, action as u };
 
-//# sourceMappingURL=flows-CDsfbaA2.js.map
+//# sourceMappingURL=flows-CF8w1rPI.js.map