acpx 0.12.0 → 0.13.0

package/README.md

@@ -36,6 +36,7 @@ One command surface for Pi, OpenClaw ACP, Codex, Claude, and other ACP-compatibl
 - **Session export/import**: move portable session archives between machines
 - **Local status checks**: `status` reports running/idle/dead/no-session, pid, uptime, last prompt
 - **Client methods**: stable `fs/*` and `terminal/*` handlers with permission controls and cwd sandboxing
+- **Capability opt-outs**: let adapters use their native filesystem or terminal tools with `--no-fs` and `--no-terminal`
 - **Auth handshake**: stable `authenticate` support via env/config credentials
 - **Structured output**: typed ACP messages (thinking, tool calls, diffs) instead of ANSI scraping
 - **Any ACP agent**: built-in registry + `--agent` escape hatch for custom servers
@@ -148,7 +149,8 @@ acpx codex --file - "extra context"            # explicit stdin + appended args
 acpx codex --no-wait 'draft test migration plan' # enqueue without waiting if session is busy
 acpx codex cancel                               # cooperative cancel of in-flight prompt
 acpx codex set-mode auto                        # session/set_mode (adapter-defined mode id)
-acpx codex set model 'gpt-5.2[high]'            # adapter-advertised model control
+acpx codex set model gpt-5.6-sol                # select the advertised base model
+acpx codex set reasoning_effort max             # set the advertised reasoning effort
 acpx exec 'summarize this repo'                # default agent shortcut (codex)
 acpx codex exec 'what does this repo do?'      # one-shot, no saved session
 
@@ -218,6 +220,7 @@ acpx flow run ./my-flow.ts --input-file ./flow-input.json
 acpx --timeout 1800 flow run ./my-flow.ts
 acpx --format quiet codex 'final recommendation only'
 acpx --suppress-reads codex exec 'show tool activity without dumping file bodies'
+acpx --no-fs codex exec 'read files without ACP client filesystem delegation'
 
 acpx --timeout 90 codex 'investigate intermittent test timeout'
 acpx --ttl 30 codex 'keep queue owner alive for quick follow-ups'
@@ -282,7 +285,7 @@ Supported keys:
   "timeout": null,
   "format": "text",
   "agents": {
-    "my-custom": { "command": "./bin/my-acp-server", "args": ["acp"] }
+    "my-custom": { "argv": ["./bin/my-acp-server", "acp"] }
   },
   "auth": {
     "my_auth_method_id": "credential-value"
@@ -291,6 +294,9 @@ Supported keys:
 ```
 
 Use `acpx config show` to inspect the resolved result and `acpx config init` to create the global template.
+Use structured `agents.<name>.argv` for custom launches; it is required on Windows. Legacy
+`command` plus `args` entries migrate when `command` is an unquoted executable with no whitespace,
+while raw command strings remain Unix-only.
 
 For ACP `authenticate` handshakes, use either config `auth` entries or explicit
 `ACPX_AUTH_<METHOD_ID>` environment variables such as `ACPX_AUTH_OPENAI_API_KEY`.
@@ -361,11 +367,13 @@ Built-ins:
 | `kilocode`   | `npx -y @kilocode/cli acp`                                                  | [Kilocode](https://kilocode.ai)                                                                                 |
 | `kimi`       | native (`kimi acp`)                                                         | [Kimi CLI](https://github.com/MoonshotAI/kimi-cli)                                                              |
 | `kiro`       | native (`kiro-cli-chat acp`)                                                | [Kiro CLI](https://kiro.dev)                                                                                    |
-| `mux`        | `npx -y mux@^0.27.0 acp`                                                    | [Mux](https://mux.coder.com)                                                                                    |
+| `mux`        | `mux acp` via an ACPX-owned npm range                                       | [Mux](https://mux.coder.com)                                                                                    |
 | `opencode`   | `npx -y opencode-ai acp`                                                    | [OpenCode](https://opencode.ai)                                                                                 |
+| `pool`       | native (`pool acp`)                                                         | [Poolside](https://poolside.ai)                                                                                 |
 | `qoder`      | native (`qodercli --acp`)                                                   | [Qoder CLI](https://docs.qoder.com/cli/acp)                                                                     |
 | `qwen`       | native (`qwen --acp`)                                                       | [Qwen Code](https://github.com/QwenLM/qwen-code)                                                                |
 | `trae`       | native (`traecli acp serve`)                                                | [Trae CLI](https://docs.trae.cn/cli)                                                                            |
+| `zeroclaw`   | native (`zeroclaw acp`)                                                     | [ZeroClaw](https://github.com/zeroclaw-labs/zeroclaw)                                                           |
 
 `factory-droid` and `factorydroid` also resolve to the built-in `droid` adapter.
 

package/dist/{cli-CxsS1XQp.js → cli-D52eGvxU.js}

@@ -1,6 +1,6 @@
-import { R as permissionModeSatisfies } from "./live-checkpoint-ClPCSdrW.js";
-import { _ as resolveGlobalFlags, a as hasExplicitPermissionModeFlag, g as resolveAgentInvocation, v as resolveOutputPolicy, x as loadPermissionPolicySpec, y as resolvePermissionMode } from "./flags-Bjq_XQ4-.js";
-import { c as validateFlowDefinition, h as isDefinedFlow, o as FlowRunner } from "./flows-Db_LZKu9.js";
+import { B as permissionModeSatisfies } from "./live-checkpoint-CBecfnSH.js";
+import { S as loadPermissionPolicySpec, _ as resolveGlobalFlags, a as hasExplicitPermissionModeFlag, g as resolveAgentInvocation, v as resolveOutputPolicy, y as resolvePermissionMode } from "./flags---9OR06b.js";
+import { c as validateFlowDefinition, h as isDefinedFlow, o as FlowRunner } from "./flows-CYfjwbn2.js";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import path from "node:path";
 import { InvalidArgumentError } from "commander";
@@ -36,6 +36,7 @@ async function handleFlowRun(flowFile, flags, command, config) {
 		permissionPolicy,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		timeoutMs: globalFlags.timeout,
 		ttlMs: globalFlags.ttl,
 		verbose: globalFlags.verbose,
@@ -194,4 +195,4 @@ function printFlowRunResult(result, globalFlags) {
 //#endregion
 export { handleFlowRun };
 
-//# sourceMappingURL=cli-CxsS1XQp.js.map
+//# sourceMappingURL=cli-D52eGvxU.js.map

package/dist/cli-D52eGvxU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-D52eGvxU.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 { loadPermissionPolicySpec } from \"../permission-policy.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 permissionPolicy = await resolveFlowPermissionPolicy(globalFlags);\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    permissionPolicy,\n    authCredentials: config.auth,\n    authPolicy: globalFlags.authPolicy,\n    fs: globalFlags.fs,\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\nasync function resolveFlowPermissionPolicy(globalFlags: GlobalFlags) {\n  try {\n    return await loadPermissionPolicySpec(globalFlags.permissionPolicy, globalFlags.cwd);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    throw new InvalidArgumentError(`Invalid permission policy: ${message}`);\n  }\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  let runtimePath: string;\n\n  if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.ts`)) {\n    runtimePath = fileURLToPath(new URL(\"../flows.ts\", import.meta.url));\n  } else if (selfPath.endsWith(`${path.sep}src${path.sep}flows${path.sep}cli.js`)) {\n    runtimePath = fileURLToPath(new URL(\"../flows.js\", import.meta.url));\n  } else {\n    runtimePath = fileURLToPath(new URL(\"./flows.js\", import.meta.url));\n  }\n  return runtimePath.replaceAll(path.sep, \"/\");\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 === \".cts\") {\n    const { register } = (await import(\"tsx/cjs/api\")) as {\n      register: (options: { namespace: string }) => {\n        require: (\n          specifier: string,\n          parentURL: string,\n        ) => {\n          default?: unknown;\n          \"module.exports\"?: unknown;\n        };\n        unregister: () => void;\n      };\n    };\n    const loader = register({ namespace: randomUUID() });\n    try {\n      return loader.require(flowUrl, import.meta.url);\n    } finally {\n      loader.unregister();\n    }\n  }\n\n  if (extension === \".mts\") {\n    const { register } = (await import(\"tsx/esm/api\")) as {\n      register: (options: { namespace: string }) => {\n        import: (\n          specifier: string,\n          parentURL: string,\n        ) => Promise<{\n          default?: unknown;\n          \"module.exports\"?: unknown;\n        }>;\n        unregister: () => Promise<void>;\n      };\n    };\n    const loader = register({ namespace: randomUUID() });\n    try {\n      return await loader.import(flowUrl, import.meta.url);\n    } finally {\n      await loader.unregister();\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":";;;;;;;;;AA2BA,MAAM,yBAAyB;AAC/B,MAAM,yCAAyB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAQ;CAAO;CAAQ;CAAQ;AAAM,CAAC;AAE7F,eAAsB,cACpB,UACA,OACA,SACA,QACe;CACf,MAAM,cAAc,mBAAmB,SAAS,MAAM;CACtD,MAAM,iBAAiB,sBAAsB,aAAa,OAAO,kBAAkB;CACnF,MAAM,mBAAmB,MAAM,4BAA4B,WAAW;CACtE,MAAM,eAAe,oBAAoB,YAAY,QAAQ,YAAY,eAAe,IAAI;CAC5F,MAAM,QAAQ,MAAM,cAAc,KAAK;CACvC,MAAM,WAAW,KAAK,QAAQ,QAAQ;CACtC,MAAM,OAAO,MAAM,eAAe,QAAQ;CAC1C,iCAAiC,MAAM,gBAAgB,WAAW;CA4BlE,mBAAmB,MAJE,IAtBF,WAAW;EAC5B,eAAe,YAAqB;GAClC,OAAO,uBAAuB,WAAW,MAAM,cAAc,aAAa,MAAM;EAClF;EACA;EACA,YAAY,OAAO;EACnB,2BAA2B,YAAY;EACvC;EACA,iBAAiB,OAAO;EACxB,YAAY,YAAY;EACxB,IAAI,YAAY;EAChB,WAAW,YAAY;EACvB,OAAO,YAAY;EACnB,SAAS,YAAY;EACrB,0BAA0B,aAAa;EACvC,gBAAgB;GACd,OAAO,YAAY;GACnB,cAAc,YAAY;GAC1B,UAAU,YAAY;EACxB;CACF,CAE0B,CAAC,CAAC,IAAI,MAAM,OAAO,EAC3C,SACF,CAAC,GAE0B,WAAW;AACxC;AAEA,eAAe,4BAA4B,aAA0B;CACnE,IAAI;EACF,OAAO,MAAM,yBAAyB,YAAY,kBAAkB,YAAY,GAAG;CACrF,SAAS,OAAO;EAEd,MAAM,IAAI,qBAAqB,8BADf,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACC;CACxE;AACF;AAEA,SAAS,iCACP,MACA,gBACA,aACM;CACN,MAAM,cAAc,KAAK;CACzB,IAAI,CAAC,aACH;CAGF,IAAI,YAAY,wBAAwB,CAAC,8BAA8B,WAAW,GAChF,MAAM,IAAI,qBACR,kCAAkC,MAAM,YAAY,cAAc,YAAY,QAAQ,IAAI,CAC5F;CAGF,IAAI,CAAC,wBAAwB,gBAAgB,YAAY,YAAY,GACnE,MAAM,IAAI,qBACR,kCAAkC,MAAM,YAAY,cAAc,YAAY,QAAQ,KAAK,CAC7F;AAEJ;AAEA,SAAS,kCACP,MACA,cACA,QACA,WAAW,OACH;CACR,OAAO;EACL,WACI,SAAS,KAAK,KAAK,yBAAyB,aAAa,WACzD,SAAS,KAAK,KAAK,6BAA6B,aAAa;EACjE,gBAAgB,aAAa;EAC7B,GAAI,SAAS,CAAC,WAAW,QAAQ,IAAI,CAAC;CACxC,CAAC,CAAC,KAAK,GAAG;AACZ;AAEA,eAAe,cAAc,OAAuC;CAClE,IAAI,MAAM,aAAa,MAAM,WAC3B,MAAM,IAAI,qBAAqB,8CAA8C;CAG/E,IAAI,MAAM,WACR,OAAO,eAAe,MAAM,WAAW,cAAc;CAGvD,IAAI,MAAM,WAAW;EACnB,MAAM,YAAY,KAAK,QAAQ,MAAM,SAAS;EAE9C,OAAO,eAAe,MADA,GAAG,SAAS,WAAW,MAAM,GACpB,cAAc;CAC/C;CAEA,OAAO,CAAC;AACV;AAEA,eAAe,eAAe,UAA2C;CACvE,MAAM,YAAY,KAAK,QAAQ,QAAQ,CAAC,CAAC,YAAY;CACrD,MAAM,WAAW,MAAM,wBAAwB,UAAU,SAAS;CAClE,IAAI;EAGF,MAAM,YAAY,mBAAmB,MAFhB,sBAAsB,SAAS,SAAS,SAAS,CAE3B;EAC3C,IAAI,CAAC,WACH,MAAM,IAAI,MACR,wEAAwE,UAC1E;EAEF,uBAAuB,SAAS;EAChC,OAAO;CACT,UAAU;EACR,MAAM,SAAS,UAAU;CAC3B;AACF;AAEA,eAAe,wBACb,UACA,WAIC;CACD,MAAM,UAAU,cAAc,QAAQ,CAAC,CAAC;CACxC,IAAI,CAAC,uBAAuB,IAAI,SAAS,GACvC,OAAO,EAAE,QAAQ;CAGnB,MAAM,SAAS,MAAM,GAAG,SAAS,UAAU,MAAM;CACjD,IAAI,CAAC,OAAO,SAAS,sBAAsB,GACzC,OAAO,EAAE,QAAQ;CAGnB,MAAM,mBAAmB,kCAAkC;CAC3D,MAAM,YAAY,OAAO,WACvB,yBACC,QAAQ,UAAkB,GAAG,QAAQ,mBAAmB,OAC3D;CACA,IAAI,cAAc,QAChB,OAAO,EAAE,QAAQ;CAGnB,MAAM,WAAW,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,mBAAmB,WAAW,IAAI,WAAW;CAChG,MAAM,GAAG,UAAU,UAAU,WAAW,MAAM;CAC9C,OAAO;EACL,SAAS,cAAc,QAAQ,CAAC,CAAC;EACjC,SAAS,YAAY;GACnB,MAAM,GAAG,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;EACvC;CACF;AACF;AAEA,SAAS,oCAA4C;CACnD,MAAM,WAAW,cAAc,OAAO,KAAK,GAAG;CAC9C,IAAI;CAEJ,IAAI,SAAS,SAAS,GAAG,KAAK,IAAI,KAAK,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO,GACrE,cAAc,cAAc,IAAI,IAAI,eAAe,OAAO,KAAK,GAAG,CAAC;MAC9D,IAAI,SAAS,SAAS,GAAG,KAAK,IAAI,KAAK,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO,GAC5E,cAAc,cAAc,IAAI,IAAI,eAAe,OAAO,KAAK,GAAG,CAAC;MAEnE,cAAc,cAAc,IAAI,IAAI,cAAc,OAAO,KAAK,GAAG,CAAC;CAEpE,OAAO,YAAY,WAAW,KAAK,KAAK,GAAG;AAC7C;AAEA,eAAe,sBACb,SACA,WAIC;CACD,IAAI,cAAc,SAAS,cAAc,UAAU,cAAc,QAAQ;EACvE,MAAM,EAAE,aAAc,MAAM,OAAO;EAYnC,MAAM,SAAS,SAAS,EAAE,WAAW,WAAW,EAAE,CAAC;EACnD,IAAI;GACF,OAAO,OAAO,QAAQ,SAAS,OAAO,KAAK,GAAG;EAChD,UAAU;GACR,OAAO,WAAW;EACpB;CACF;CAEA,IAAI,cAAc,QAAQ;EACxB,MAAM,EAAE,aAAc,MAAM,OAAO;EAYnC,MAAM,SAAS,SAAS,EAAE,WAAW,WAAW,EAAE,CAAC;EACnD,IAAI;GACF,OAAO,MAAM,OAAO,OAAO,SAAS,OAAO,KAAK,GAAG;EACrD,UAAU;GACR,MAAM,OAAO,WAAW;EAC1B;CACF;CAEA,OAAQ,MAAM,OAAO;AAIvB;AAEA,SAAS,mBAAmB,QAGF;CACxB,MAAM,aAAa;EACjB,OAAO;EACP,OAAO;EACP,iBAAiB,OAAO,OAAO;EAC/B,iBAAiB,OAAO,iBAAiB;CAC3C;CAEA,KAAK,MAAM,aAAa,YACtB,IAAI,cAAc,SAAS,GACzB,OAAO;CAIX,OAAO;AACT;AAEA,SAAS,iBAAiB,OAAyB;CACjD,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,aAAa,QACxD,OAAO;CAET,OAAQ,MAAgC,WAAW;AACrD;AAEA,SAAS,eAAe,KAAa,OAAwB;CAC3D,IAAI;EACF,OAAO,KAAK,MAAM,GAAG;CACvB,SAAS,OAAO;EACd,MAAM,IAAI,qBACR,GAAG,MAAM,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC5F;CACF;AACF;AAEA,SAAS,mBACP,QACA,aACM;CACN,MAAM,UAAU;EACd,QAAQ;EACR,OAAO,OAAO,MAAM;EACpB,UAAU,OAAO,MAAM;EACvB,UAAU,OAAO,MAAM;EACvB,UAAU,OAAO,MAAM;EACvB,QAAQ,OAAO,MAAM;EACrB,aAAa,OAAO,MAAM;EAC1B,iBAAiB,OAAO,MAAM;EAC9B,sBAAsB,OAAO,MAAM;EACnC,iBAAiB,OAAO,MAAM;EAC9B,cAAc,OAAO,MAAM;EAC3B,WAAW,OAAO,MAAM;EACxB,QAAQ,OAAO;EACf,SAAS,OAAO,MAAM;EACtB,iBAAiB,OAAO,MAAM;CAChC;CAEA,IAAI,YAAY,WAAW,QAAQ;EACjC,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,OAAO,EAAE,GAAG;EACnD;CACF;CAEA,IAAI,YAAY,WAAW,SAAS;EAClC,QAAQ,OAAO,MAAM,GAAG,OAAO,MAAM,MAAM,GAAG;EAC9C;CACF;CAEA,QAAQ,OAAO,MAAM,UAAU,QAAQ,MAAM,GAAG;CAChD,QAAQ,OAAO,MAAM,SAAS,QAAQ,SAAS,GAAG;CAClD,IAAI,QAAQ,UACV,QAAQ,OAAO,MAAM,UAAU,QAAQ,SAAS,GAAG;CAErD,QAAQ,OAAO,MAAM,WAAW,QAAQ,OAAO,GAAG;CAClD,QAAQ,OAAO,MAAM,WAAW,QAAQ,OAAO,GAAG;CAClD,IAAI,QAAQ,aACV,QAAQ,OAAO,MAAM,gBAAgB,QAAQ,YAAY,GAAG;CAE9D,IAAI,QAAQ,cACV,QAAQ,OAAO,MAAM,iBAAiB,QAAQ,aAAa,GAAG;CAEhE,IAAI,QAAQ,WACV,QAAQ,OAAO,MAAM,cAAc,QAAQ,UAAU,GAAG;CAE1D,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,QAAQ,SAAS,MAAM,CAAC,EAAE,GAAG;AACtE"}

package/dist/cli.d.ts

@@ -1,13 +1,12 @@
-import { f as SessionRecord } from "./session-options-jkYbBxGE.js";
+import { f as SessionRecord } from "./session-options-CTdZvr68.js";
 import { Command } from "commander";
-
 //#region src/cli/flags.d.ts
 declare function parseTtlSeconds(value: string): number;
 declare function parseAllowedTools(value: string): string[];
 declare function parseMaxTurns(value: string): number;
 //#endregion
 //#region src/cli/output/render.d.ts
-type SessionConnectionStatus = "connected" | "needs reconnect";
+type SessionConnectionStatus = "connected" | "starting" | "needs reconnect";
 declare function formatPromptSessionBannerLine(record: SessionRecord, currentCwd: string, connectionStatus?: SessionConnectionStatus): string;
 //#endregion
 export { formatPromptSessionBannerLine, parseAllowedTools, parseMaxTurns, parseTtlSeconds };

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/cli/flags.ts","../src/cli/output/render.ts"],"mappings":";;;;iBAgKgB,eAAA,CAAgB,KAAa;AAAA,iBAkD7B,iBAAA,CAAkB,KAAa;AAAA,iBAgB/B,aAAA,CAAc,KAAa;;;KChNtC,uBAAA;AAAA,iBAwLW,6BAAA,CACd,MAAA,EAAQ,aAAA,EACR,UAAA,UACA,gBAAA,GAAkB,uBAA2C"}
+{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/cli/flags.ts","../src/cli/output/render.ts"],"mappings":";;;iBAyKgB,gBAAgB;iBAsDhB,kBAAkB;iBAgBlB,cAAc;;;KC7NzB;iBAkMW,8BACd,QAAQ,eACR,oBACA,mBAAkB"}

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { a as runSessionQueueOwner, c as buildQueueOwnerArgOverride, g as __exportAll, h as isProcessAlive, l as flushPerfMetricsCapture, n as getTextErrorRemediationHints, o as runOnce, p as probeQueueOwnerHealth, t as createOutputFormatter, u as installPerfMetricsCapture } from "./output-CjdF5rHk.js";
-import { At as listBuiltInAgents, Et as TimeoutError, G as listSessions, Gt as OUTPUT_FORMATS, H as findSession, It as normalizeOutputError, L as getAcpxVersion, Nt as exitCodeForOutputErrorCode, St as parsePromptSource, Tt as InterruptedError, U as findSessionByDirectoryWalk, V as findGitRepositoryRoot, Vt as EXIT_CODES, X as writeSessionRecord, Xt as AgentSpawnError, Yt as AcpxOperationalError, ct as normalizeRuntimeSessionId, ft as sessionEventActivePath, gt as isAcpJsonRpcMessage, jt as normalizeAgentName$1, kt as DEFAULT_AGENT_NAME, mt as sessionEventSegmentPath, ot as parseSessionRecord, pt as sessionEventLockPath, q as normalizeName, st as serializeSessionRecordForDisk, ut as defaultSessionEventLog, wt as textPrompt, xt as mergePromptSourceWithText, yt as PromptInputValidationError } from "./live-checkpoint-ClPCSdrW.js";
-import { _ as resolveGlobalFlags, b as resolveSessionNameFromFlags, c as parseHistoryLimit, d as parseOutputFormat$1, f as parsePruneBeforeDate, g as resolveAgentInvocation, h as parseTtlSeconds, i as addSessionOption, l as parseMaxTurns, m as parseTimeoutSeconds, n as addPromptInputOption, o as parseAllowedTools, p as parseSessionName, r as addSessionNameOption, s as parseDaysOlderThan, t as addGlobalFlags, u as parseNonEmptyValue, v as resolveOutputPolicy, x as loadPermissionPolicySpec, y as resolvePermissionMode } from "./flags-Bjq_XQ4-.js";
+import { a as runSessionQueueOwner, c as buildQueueOwnerArgOverride, g as __exportAll, h as isProcessAlive, l as flushPerfMetricsCapture, n as getTextErrorRemediationHints, o as runOnce, p as probeQueueOwnerHealth, t as createOutputFormatter, u as installPerfMetricsCapture } from "./output-CzN8vLdE.js";
+import { Dt as textPrompt, G as findSessionByDirectoryWalk, Kt as EXIT_CODES, L as renderArgvIdentity, Mt as DEFAULT_AGENT_NAME, Nt as listBuiltInAgents, Ot as InterruptedError, Pt as normalizeAgentName$1, Q as writeSessionRecord, Rt as exitCodeForOutputErrorCode, St as PromptInputValidationError, Tt as parsePromptSource, U as findGitRepositoryRoot, Vt as normalizeOutputError, W as findSession, Xt as OUTPUT_FORMATS, Y as normalizeName, _t as sessionEventSegmentPath, dt as normalizeRuntimeSessionId, en as AcpxOperationalError, gt as sessionEventLockPath, ht as sessionEventActivePath, kt as TimeoutError, lt as parseSessionRecord, pt as defaultSessionEventLog, q as listSessions, tn as AgentSpawnError, ut as serializeSessionRecordForDisk, wt as mergePromptSourceWithText, yt as isAcpJsonRpcMessage, z as getAcpxVersion } from "./live-checkpoint-CBecfnSH.js";
+import { S as loadPermissionPolicySpec, _ as resolveGlobalFlags, b as resolveSessionNameFromFlags, c as parseHistoryLimit, d as parseOutputFormat$1, f as parsePruneBeforeDate, g as resolveAgentInvocation, h as parseTtlSeconds, i as addSessionOption, l as parseMaxTurns, m as parseTimeoutSeconds, n as addPromptInputOption, o as parseAllowedTools, p as parseSessionName, r as addSessionNameOption, s as parseDaysOlderThan, t as addGlobalFlags, u as parseNonEmptyValue, v as resolveOutputPolicy, x as toTimerMilliseconds, y as resolvePermissionMode } from "./flags---9OR06b.js";
 import { realpathSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import path from "node:path";
@@ -387,11 +387,11 @@ let sessionModulePromise;
 let outputModulePromise;
 let outputRenderModulePromise;
 function loadSessionModule() {
-	sessionModulePromise ??= import("./output-CjdF5rHk.js").then((n) => n.i);
+	sessionModulePromise ??= import("./output-CzN8vLdE.js").then((n) => n.i);
 	return sessionModulePromise;
 }
 function loadOutputModule() {
-	outputModulePromise ??= import("./output-CjdF5rHk.js").then((n) => n.r);
+	outputModulePromise ??= import("./output-CzN8vLdE.js").then((n) => n.r);
 	return outputModulePromise;
 }
 function loadOutputRenderModule() {
@@ -463,6 +463,7 @@ async function resolvePermissionPolicyFromFlags$1(globalFlags) {
 function buildSessionStartOptions(params) {
 	return {
 		agentCommand: params.agent.agentCommand,
+		agentArgv: params.agent.agentArgv,
 		cwd: params.agent.cwd,
 		name: params.flags.name,
 		resumeSessionId: params.flags.resumeSession,
@@ -472,6 +473,7 @@ function buildSessionStartOptions(params) {
 		permissionPolicy: params.permissionPolicy,
 		authCredentials: params.config.auth,
 		authPolicy: params.globalFlags.authPolicy,
+		fs: params.globalFlags.fs,
 		terminal: params.globalFlags.terminal,
 		timeoutMs: params.globalFlags.timeout,
 		verbose: params.globalFlags.verbose,
@@ -540,6 +542,7 @@ async function handlePrompt(explicitAgentName, promptParts, flags, command, conf
 		permissionPolicy,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		terminal: globalFlags.terminal,
 		outputFormatter,
 		errorEmissionPolicy: { queueErrorAlreadyEmitted: outputPolicy.queueErrorAlreadyEmitted },
@@ -588,6 +591,7 @@ async function handleExec(explicitAgentName, promptParts, flags, command, config
 	const agent = resolveAgentInvocation(explicitAgentName, globalFlags, config);
 	applyPermissionExitCode(await runOnce({
 		agentCommand: agent.agentCommand,
+		agentArgv: agent.agentArgv,
 		cwd: agent.cwd,
 		prompt,
 		mcpServers: config.mcpServers,
@@ -596,6 +600,7 @@ async function handleExec(explicitAgentName, promptParts, flags, command, config
 		permissionPolicy,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		terminal: globalFlags.terminal,
 		outputFormatter,
 		errorEmissionPolicy: { queueErrorAlreadyEmitted: outputPolicy.queueErrorAlreadyEmitted },
@@ -688,6 +693,7 @@ async function handleSetMode(explicitAgentName, modeId, flags, command, config)
 		nonInteractivePermissions: globalFlags.nonInteractivePermissions,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		terminal: globalFlags.terminal,
 		timeoutMs: globalFlags.timeout,
 		verbose: globalFlags.verbose
@@ -706,6 +712,7 @@ async function handleSetModel(explicitAgentName, modelId, flags, command, config
 		nonInteractivePermissions: globalFlags.nonInteractivePermissions,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		terminal: globalFlags.terminal,
 		timeoutMs: globalFlags.timeout,
 		verbose: globalFlags.verbose
@@ -730,6 +737,7 @@ async function handleSetConfigOption(explicitAgentName, configId, value, flags,
 		nonInteractivePermissions: globalFlags.nonInteractivePermissions,
 		authCredentials: config.auth,
 		authPolicy: globalFlags.authPolicy,
+		fs: globalFlags.fs,
 		terminal: globalFlags.terminal,
 		timeoutMs: globalFlags.timeout,
 		verbose: globalFlags.verbose
@@ -744,6 +752,7 @@ async function tryListAgentSessions(agent, flags, globalFlags, config) {
 	try {
 		return await listAgentSessions({
 			agentCommand: agent.agentCommand,
+			agentArgv: agent.agentArgv,
 			cwd: agent.cwd,
 			cursor: flags.cursor,
 			filterCwd: resolveSessionListFilterCwd(flags, agent.cwd),
@@ -753,6 +762,7 @@ async function tryListAgentSessions(agent, flags, globalFlags, config) {
 			permissionPolicy,
 			authCredentials: config.auth,
 			authPolicy: globalFlags.authPolicy,
+			fs: globalFlags.fs,
 			terminal: globalFlags.terminal,
 			timeoutMs: globalFlags.timeout,
 			verbose: globalFlags.verbose
@@ -1169,6 +1179,7 @@ async function runAgentForCompare(params) {
 		const agent = resolveAgentInvocation(params.agentName, params.globalFlags, params.config);
 		const result = await runOnce({
 			agentCommand: agent.agentCommand,
+			agentArgv: agent.agentArgv,
 			cwd: agent.cwd,
 			prompt: params.prompt,
 			mcpServers: params.config.mcpServers,
@@ -1177,6 +1188,7 @@ async function runAgentForCompare(params) {
 			permissionPolicy: params.permissionPolicy,
 			authCredentials: params.config.auth,
 			authPolicy: params.globalFlags.authPolicy,
+			fs: params.globalFlags.fs,
 			terminal: params.globalFlags.terminal,
 			outputFormatter: formatter,
 			suppressSdkConsoleErrors: true,
@@ -1413,12 +1425,16 @@ function isObject(value) {
 function parseTtlMs(value, sourcePath) {
 	if (value == null) return;
 	if (typeof value !== "number" || !Number.isFinite(value) || value < 0) throw new Error(`Invalid config ttl in ${sourcePath}: expected non-negative seconds`);
-	return Math.round(value * 1e3);
+	const milliseconds = toTimerMilliseconds(value, true);
+	if (milliseconds === void 0) throw new Error(`Invalid config ttl in ${sourcePath}: exceeds maximum supported timer delay`);
+	return milliseconds;
 }
 function parseTimeoutMs(value, sourcePath) {
 	if (value == null) return;
 	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) throw new Error(`Invalid config timeout in ${sourcePath}: expected positive seconds or null`);
-	return Math.round(value * 1e3);
+	const milliseconds = toTimerMilliseconds(value, false);
+	if (milliseconds === void 0) throw new Error(`Invalid config timeout in ${sourcePath}: exceeds maximum supported timer delay`);
+	return milliseconds;
 }
 function parseQueueMaxDepth(value, sourcePath) {
 	if (value == null) return;
@@ -1454,15 +1470,42 @@ function parseAgents(value, sourcePath) {
 	if (value == null) return;
 	if (!isObject(value)) throw new Error(`Invalid config agents in ${sourcePath}: expected object`);
 	const parsed = {};
-	for (const [name, raw] of Object.entries(value)) {
-		if (!isObject(raw)) throw new Error(`Invalid config agents.${name} in ${sourcePath}: expected object with command`);
-		const command = raw.command;
-		if (typeof command !== "string" || command.trim().length === 0) throw new Error(`Invalid config agents.${name}.command in ${sourcePath}: expected non-empty string`);
-		const args = parseAgentArgs(raw.args, name, sourcePath);
-		parsed[normalizeAgentName$1(name)] = args.length > 0 ? `${command.trim()} ${args.map(quoteCommandArg).join(" ")}` : command.trim();
-	}
+	for (const [name, raw] of Object.entries(value)) parsed[normalizeAgentName$1(name)] = parseAgentEntry(raw, name, sourcePath);
 	return parsed;
 }
+function parseAgentEntry(raw, name, sourcePath) {
+	if (!isObject(raw)) throw new Error(`Invalid config agents.${name} in ${sourcePath}: expected object with command`);
+	return Object.prototype.hasOwnProperty.call(raw, "argv") ? parseArgvAgentEntry(raw, name, sourcePath) : parseLegacyAgentEntry(raw, name, sourcePath);
+}
+function parseArgvAgentEntry(raw, name, sourcePath) {
+	if (Object.prototype.hasOwnProperty.call(raw, "command") || Object.prototype.hasOwnProperty.call(raw, "args")) throw new Error(`Invalid config agents.${name} in ${sourcePath}: use argv alone, not command or args`);
+	const argv = parseAgentArgv(raw.argv, name, sourcePath);
+	return {
+		command: renderArgv(argv),
+		argv
+	};
+}
+function parseLegacyAgentEntry(raw, name, sourcePath) {
+	const command = raw.command;
+	if (typeof command !== "string" || command.trim().length === 0) throw new Error(`Invalid config agents.${name}.command in ${sourcePath}: expected non-empty string`);
+	const trimmedCommand = command.trim();
+	if (!Object.prototype.hasOwnProperty.call(raw, "args")) return { command: trimmedCommand };
+	if (/[\s'"]/u.test(trimmedCommand)) throw new Error(`Invalid config agents.${name}.command in ${sourcePath}: command must be an unquoted executable with no whitespace when args is present; migrate the complete launch to argv`);
+	const args = parseAgentArgs(raw.args, name, sourcePath);
+	return {
+		command: args.length > 0 ? `${trimmedCommand} ${args.map(quoteCommandArg).join(" ")}` : trimmedCommand,
+		argv: [trimmedCommand, ...args]
+	};
+}
+function parseAgentArgv(value, agentName, sourcePath) {
+	if (!Array.isArray(value) || value.length === 0) throw new Error(`Invalid config agents.${agentName}.argv in ${sourcePath}: expected non-empty array of strings`);
+	const argv = value.map((arg, index) => {
+		if (typeof arg !== "string") throw new Error(`Invalid config agents.${agentName}.argv[${index}] in ${sourcePath}: expected string`);
+		return arg;
+	});
+	if (argv[0]?.length === 0) throw new Error(`Invalid config agents.${agentName}.argv[0] in ${sourcePath}: expected non-empty executable`);
+	return argv;
+}
 function parseAgentArgs(value, agentName, sourcePath) {
 	if (value == null) return [];
 	if (!Array.isArray(value)) throw new Error(`Invalid config agents.${agentName}.args in ${sourcePath}: expected array of strings`);
@@ -1474,6 +1517,9 @@ function parseAgentArgs(value, agentName, sourcePath) {
 function quoteCommandArg(value) {
 	return JSON.stringify(value);
 }
+function renderArgv(argv) {
+	return renderArgvIdentity(argv);
+}
 function parseAuth(value, sourcePath) {
 	if (value == null) return;
 	if (!isObject(value)) throw new Error(`Invalid config auth in ${sourcePath}: expected object`);
@@ -1611,13 +1657,13 @@ function resolveDisableExec(projectConfig, projectPath, globalConfig, globalPath
 }
 function toConfigDisplay(config) {
 	const agents = {};
-	for (const [name, command] of Object.entries(config.agents)) agents[name] = { command };
+	for (const [name, agent] of Object.entries(config.agents)) agents[name] = agent.argv ? { argv: [...agent.argv] } : { command: agent.command };
 	return {
 		defaultAgent: config.defaultAgent,
 		defaultPermissions: config.defaultPermissions,
 		nonInteractivePermissions: config.nonInteractivePermissions,
 		authPolicy: config.authPolicy,
-		ttl: Math.round(config.ttlMs / 1e3),
+		ttl: config.ttlMs / 1e3,
 		timeout: config.timeoutMs == null ? null : config.timeoutMs / 1e3,
 		queueMaxDepth: config.queueMaxDepth,
 		format: config.format,
@@ -1723,6 +1769,7 @@ function registerConfigCommand(program, config) {
 //#region src/cli/output/render.ts
 var render_exports = /* @__PURE__ */ __exportAll({
 	agentSessionIdPayload: () => agentSessionIdPayload,
+	classifySessionConnectionStatus: () => classifySessionConnectionStatus,
 	formatPromptSessionBannerLine: () => formatPromptSessionBannerLine,
 	printAgentSessionsByFormat: () => printAgentSessionsByFormat,
 	printClosedSessionByFormat: () => printClosedSessionByFormat,
@@ -1742,8 +1789,12 @@ function formatRoutedFrom(sessionCwd, currentCwd) {
 	if (!relative || relative === ".") return;
 	return relative.startsWith(".") ? relative : `.${path.sep}${relative}`;
 }
+function classifySessionConnectionStatus(health) {
+	if (health.healthy) return "connected";
+	return health.hasLease ? "needs reconnect" : "starting";
+}
 async function resolveSessionConnectionStatus(record) {
-	return (await probeQueueOwnerHealth(record.acpxRecordId)).healthy ? "connected" : "needs reconnect";
+	return classifySessionConnectionStatus(await probeQueueOwnerHealth(record.acpxRecordId));
 }
 function printSessionsByFormat(sessions, format) {
 	if (format === "json") {
@@ -1848,7 +1899,7 @@ function printQueuedPromptByFormat(result, format) {
 	if (format === "quiet") return;
 	process.stdout.write(`[queued] ${result.requestId}\n`);
 }
-function formatPromptSessionBannerLine(record, currentCwd, connectionStatus = "needs reconnect") {
+function formatPromptSessionBannerLine(record, currentCwd, connectionStatus = "starting") {
 	const label = formatSessionLabel(record);
 	const normalizedSessionCwd = path.resolve(record.cwd);
 	const normalizedCurrentCwd = path.resolve(currentCwd);
@@ -2181,7 +2232,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-CxsS1XQp.js");
+		const { handleFlowRun } = await import("./cli-D52eGvxU.js");
 		await handleFlowRun(file, flags, this, config);
 	});
 }
@@ -2234,6 +2285,7 @@ function assignQueueOwnerTransportOptions(options, record) {
 function assignQueueOwnerScalarOptions(options, record) {
 	if (record.nonInteractivePermissions === "deny" || record.nonInteractivePermissions === "fail") options.nonInteractivePermissions = record.nonInteractivePermissions;
 	if (record.authPolicy === "skip" || record.authPolicy === "fail") options.authPolicy = record.authPolicy;
+	assignBooleanOption(options, "fs", record.fs);
 	assignBooleanOption(options, "terminal", record.terminal);
 	assignBooleanOption(options, "suppressSdkConsoleErrors", record.suppressSdkConsoleErrors);
 	assignBooleanOption(options, "verbose", record.verbose);
@@ -2347,6 +2399,7 @@ const TOP_LEVEL_VERSION_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
 	"--deny-all",
 	"--suppress-reads",
 	"--json-strict",
+	"--no-fs",
 	"--no-terminal",
 	"--verbose"
 ]);
@@ -2653,13 +2706,18 @@ function normalizeLifecycleScriptArgs(rawArgs) {
 	return rawArgs;
 }
 //#endregion
-//#region src/cli.ts
-function installBrokenPipeHandler(stream) {
+//#region src/cli/broken-pipe.ts
+function handleBrokenPipeError(error, mode, exit = (code) => process.exit(code)) {
+	if (error.code !== "EPIPE") throw error;
+	if (mode === "exit") exit(0);
+}
+function installBrokenPipeHandler(stream, mode) {
 	stream.on("error", (error) => {
-		if (error.code === "EPIPE") process.exit(0);
-		throw error;
+		handleBrokenPipeError(error, mode);
 	});
 }
+//#endregion
+//#region src/cli.ts
 function isCliEntrypoint(argv) {
 	const entry = argv[1];
 	if (!entry) return false;
@@ -2671,8 +2729,9 @@ function isCliEntrypoint(argv) {
 	}
 }
 if (isCliEntrypoint(process.argv)) {
-	installBrokenPipeHandler(process.stdout);
-	installBrokenPipeHandler(process.stderr);
+	const isQueueOwner = process.argv[2] === "__queue-owner";
+	installBrokenPipeHandler(process.stdout, "exit");
+	installBrokenPipeHandler(process.stderr, isQueueOwner ? "ignore" : "exit");
 	const queueOwnerArgOverride = buildQueueOwnerArgOverride(fileURLToPath(import.meta.url));
 	if (queueOwnerArgOverride) process.env.ACPX_QUEUE_OWNER_ARGS ??= queueOwnerArgOverride;
 	main(process.argv);