acpx 0.5.0 → 0.5.1

package/dist/{cli-CLRrs6eQ.js → cli-DZjj5kij.js}

@@ -1,6 +1,6 @@
-import { b as permissionModeSatisfies } from "./prompt-turn-Bt8T3SRR.js";
-import { a as hasExplicitPermissionModeFlag, f as resolveAgentInvocation, h as resolvePermissionMode, m as resolveOutputPolicy, p as resolveGlobalFlags } from "./flags-BmubjvOw.js";
-import { i as FlowRunner, o as validateFlowDefinition, p as isDefinedFlow } from "./flows-CR7xCmkR.js";
+import { b as permissionModeSatisfies } from "./prompt-turn-CbSSNHjk.js";
+import { a as hasExplicitPermissionModeFlag, f as resolveAgentInvocation, h as resolvePermissionMode, m as resolveOutputPolicy, p as resolveGlobalFlags } from "./flags-W3vEVSiS.js";
+import { i as FlowRunner, o as validateFlowDefinition, p as isDefinedFlow } from "./flows-CLQYpPh7.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-CLRrs6eQ.js.map
+//# sourceMappingURL=cli-DZjj5kij.js.map

package/dist/{cli-CLRrs6eQ.js.map → cli-DZjj5kij.js.map}

@@ -1 +1 @@
-{"version":3,"file":"cli-CLRrs6eQ.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-DZjj5kij.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.d.ts

@@ -1,4 +1,4 @@
-import { s as SessionRecord } from "./types-DXxLBQc3.js";
+import { s as SessionRecord } from "./types-Cgigsj1X.js";
 import { Command } from "commander";
 
 //#region src/cli/flags.d.ts

package/dist/cli.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
-import { T as EXIT_CODES, _ as exitCodeForOutputErrorCode, d as PromptInputValidationError, g as textPrompt, k as OUTPUT_FORMATS, m as parsePromptSource, p as mergePromptSourceWithText, x as normalizeOutputError } from "./perf-metrics-D9QC81lB.js";
-import { n as listBuiltInAgents, r as normalizeAgentName, t as DEFAULT_AGENT_NAME } from "./agent-registry-DGw0-3Tc.js";
-import { C as findGitRepositoryRoot, T as findSessionByDirectoryWalk, V as InterruptedError, w as findSession } from "./prompt-turn-Bt8T3SRR.js";
-import { a as buildQueueOwnerArgOverride, n as runSessionQueueOwner, o as flushPerfMetricsCapture, s as installPerfMetricsCapture } from "./session-BbN0SBgf.js";
-import { s as probeQueueOwnerHealth } from "./ipc-DN6M4Ui9.js";
-import { c as parseMaxTurns, d as parseTtlSeconds, f as resolveAgentInvocation, g as resolveSessionNameFromFlags, h as resolvePermissionMode, i as addSessionOption, l as parseNonEmptyValue, m as resolveOutputPolicy, n as addPromptInputOption, o as parseAllowedTools, p as resolveGlobalFlags, r as addSessionNameOption, s as parseHistoryLimit, t as addGlobalFlags, u as parseSessionName } from "./flags-BmubjvOw.js";
-import { i as emitJsonResult, n as formatPromptSessionBannerLine, t as agentSessionIdPayload } from "./render-BL5ynRkN.js";
-import { t as createOutputFormatter } from "./output-Di0M9Et8.js";
+import { T as EXIT_CODES, _ as exitCodeForOutputErrorCode, d as PromptInputValidationError, g as textPrompt, k as OUTPUT_FORMATS, m as parsePromptSource, p as mergePromptSourceWithText, x as normalizeOutputError } from "./perf-metrics-D0um6IR6.js";
+import { C as findGitRepositoryRoot, G as DEFAULT_AGENT_NAME, K as listBuiltInAgents, T as findSessionByDirectoryWalk, V as InterruptedError, q as normalizeAgentName, w as findSession } from "./prompt-turn-CbSSNHjk.js";
+import { a as buildQueueOwnerArgOverride, n as runSessionQueueOwner, o as flushPerfMetricsCapture, s as installPerfMetricsCapture } from "./session-BiBN0BvM.js";
+import { s as probeQueueOwnerHealth } from "./ipc-BM335WFg.js";
+import { c as parseMaxTurns, d as parseTtlSeconds, f as resolveAgentInvocation, g as resolveSessionNameFromFlags, h as resolvePermissionMode, i as addSessionOption, l as parseNonEmptyValue, m as resolveOutputPolicy, n as addPromptInputOption, o as parseAllowedTools, p as resolveGlobalFlags, r as addSessionNameOption, s as parseHistoryLimit, t as addGlobalFlags, u as parseSessionName } from "./flags-W3vEVSiS.js";
+import { i as emitJsonResult, n as formatPromptSessionBannerLine, t as agentSessionIdPayload } from "./render-Br-kVPK_.js";
+import { t as createOutputFormatter } from "./output-C4QhjpM6.js";
 import { readFileSync, realpathSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import path from "node:path";
@@ -70,15 +69,15 @@ let sessionModulePromise;
 let outputModulePromise;
 let outputRenderModulePromise;
 function loadSessionModule() {
-	sessionModulePromise ??= import("./session-BbN0SBgf.js").then((n) => n.t);
+	sessionModulePromise ??= import("./session-BiBN0BvM.js").then((n) => n.t);
 	return sessionModulePromise;
 }
 function loadOutputModule() {
-	outputModulePromise ??= import("./output-Di0M9Et8.js").then((n) => n.n);
+	outputModulePromise ??= import("./output-C4QhjpM6.js").then((n) => n.n);
 	return outputModulePromise;
 }
 function loadOutputRenderModule() {
-	outputRenderModulePromise ??= import("./render-BL5ynRkN.js").then((n) => n.r);
+	outputRenderModulePromise ??= import("./render-Br-kVPK_.js").then((n) => n.r);
 	return outputRenderModulePromise;
 }
 async function readPromptInputFromStdin() {
@@ -1085,7 +1084,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-CLRrs6eQ.js");
+		const { handleFlowRun } = await import("./cli-DZjj5kij.js");
 		await handleFlowRun(file, flags, this, config);
 	});
 }