borgmcp 1.1.14 → 2.0.1

package/dist/cli-help.js

@@ -1,56 +1,104 @@
-function n(e){return e==="--help"||e==="-h"}function o(e){return`borgmcp ${e} \u2014 run several AI coding agents on one project, together.
-              They coordinate through a shared log (a "cube"). For Claude Code, Codex & OpenCode.
-
-Docs & quickstart: https://borgmcp.ai/get-started
-
-Install Claude Code, Codex, or OpenCode first. Type \`borg ...\` in your terminal;
-type \`borg_...\` inside your agent session once you've joined a cube ("assimilate").
-
-Usage:
-  borg                     Launch your agent CLI; in a TTY, bare borg may show the launch menu
-  borg setup               Set up OAuth + register MCP server
-  borg setup --no-browser  Set up from SSH/headless terminals
-  borg assimilate [role]   Join a cube (creates one if needed)
-  borg assimilate --worktree <name>   Spawn a worktree drone (in ~/.borg/worktrees/<repo>/<name>)
-  borg sync [--prune]      Sync this worktree's branch to origin/main
-  borg cleanup [--prune]   Report (or --prune) worktrees orphaned by evicted drones
-  borg launch-all [cube]   Launch all drone worktrees of a cube (default: active cube)
-  borg launch-all [cube] --cli claude|codex|opencode
-                           Launch all drone worktrees with that agent CLI
-  borg --cli claude|codex|opencode  Launch that agent CLI directly
-  borg --version           Show installed version
-
-All other arguments are passed through to the selected agent CLI.
-`}function r(e){return`borg assimilate (borgmcp ${e}) \u2014 join a cube under a role (creates the cube if needed)
-
-Usage:
-  borg assimilate [role]               Join the active cube under [role] (default role if omitted)
-  borg assimilate [role] --worktree <name>   Spawn the drone in an isolated git worktree
-                                       (~/.borg/worktrees/<repo>/<name>)
-  borg assimilate --here               Assimilate in the current worktree (no sibling spawn)
-  borg assimilate --help               Show this help
-
-Flags:
-  --worktree <name>          Create + launch the drone in a sibling git worktree
-  --here                     Stay in the current worktree (no sibling spawn)
-  --cube-name <name>         Cube to join/create (default: repo basename)
-  --template <name>          Bootstrap a new cube from a bundled role template
-  --no-template              Create the cube with no template roles
-  --cli claude|codex|opencode         Agent CLI to launch (default: claude)
-  --model claude:<model>   Legacy Claude model override (configure models in the agent CLI)
-  --yes, -y                  Skip confirmation prompts
-
-For local or provider-specific models, configure the selected agent CLI directly.
-OpenCode supports Ollama and other providers through its own model configuration.
-`}function t(e){return`borg setup (borgmcp ${e}) \u2014 set up OAuth + register the borg MCP server
-
-Borg MCP needs Claude Code, Codex, or OpenCode installed first.
-
-Usage:
-  borg setup               Run the interactive setup wizard (OAuth sign-in +
-                           register the borg MCP server with your agent CLI)
-  borg setup --no-browser  Sign in without a local browser (device-code flow)
-                           for SSH / headless / container terminals. Alias: --device.
-                           Auto-detected on SSH/headless; this forces it.
-  borg setup --help        Show this help
-`}export{r as assimilateHelpText,n as isHelpFlag,t as setupHelpText,o as topLevelHelpText};
+/**
+ * Pure CLI help-text + flag helpers.
+ *
+ * Kept in its own module (not in claude.ts) so importing them in tests does NOT
+ * run claude.ts's `main()` side effects — the same pattern as parse-assimilate-args.ts
+ * and cli-platform.ts.
+ */
+/** True for the standard help flags `--help` / `-h`. */
+export function isHelpFlag(arg) {
+    return arg === '--help' || arg === '-h';
+}
+/**
+ * Help text for top-level `borg --help`.
+ *
+ * Kept pure so tests can pin user-facing discoverability without importing
+ * claude.ts, which launches agent CLIs as a side effect.
+ */
+export function topLevelHelpText(version) {
+    return (`borgmcp ${version} — run several AI coding agents on one project, together.\n` +
+        `              They coordinate through a shared log (a "cube"). For Claude Code, Codex & OpenCode.\n\n` +
+        `Docs & quickstart: https://github.com/Byte-Ventures/borg-mcp-client#readme\n\n` +
+        `Install Claude Code, Codex, or OpenCode first. Type \`borg ...\` in your terminal;\n` +
+        `type \`borg_...\` inside your agent session once you've joined a cube ("assimilate").\n\n` +
+        `Usage:\n` +
+        `  borg                     Launch your agent CLI; in a TTY, bare borg may show the launch menu\n` +
+        `  borg setup               Set up borg MCP server + agent CLI integration\n` +
+        `  borg assimilate [role]   Join or create a cube\n` +
+        `  borg assimilate --host <host>   Join or create on an explicit server\n` +
+        `  borg assimilate --worktree <name>   Spawn a worktree drone (in ~/.borg/worktrees/<repo>/<name>)\n` +
+        `  borg reset-local-seat    Clear ONLY this worktree's saved local seat (offline; after a rejection)\n` +
+        `  borg sync [--prune]      Sync this worktree's branch to origin/main\n` +
+        `  borg cleanup [--prune]   Report (or --prune) worktrees orphaned by evicted drones\n` +
+        `  borg launch-all [cube]   Launch all drone worktrees of a cube (default: active cube)\n` +
+        `  borg launch-all [cube] --cli claude|codex|opencode\n` +
+        `                           Launch all drone worktrees with that agent CLI\n` +
+        `  borg --cli claude|codex|opencode  Launch that agent CLI directly\n` +
+        `  borg --version           Show installed version\n\n` +
+        `All other arguments are passed through to the selected agent CLI.\n`);
+}
+/**
+ * Help text for `borg assimilate --help` — the home for the full assimilate flag
+ * set. Model/provider configuration belongs to the selected agent CLI.
+ */
+export function assimilateHelpText(version) {
+    return (`borg assimilate (borgmcp ${version}) — join or create a cube under a role\n\n` +
+        `Usage:\n` +
+        `  borg assimilate [role]               Join the active cube under [role] (default role if omitted)\n` +
+        `  borg assimilate [role] --worktree <name>   Spawn the drone in an isolated git worktree\n` +
+        `                                       (~/.borg/worktrees/<repo>/<name>)\n` +
+        `  borg assimilate --here               Assimilate in the current worktree (no sibling spawn)\n` +
+        `  borg assimilate --host <host>        Join an authorized self-hosted cube\n` +
+        `  borg assimilate --host <host> --enroll   Operator-terminal enrollment, then create/join (preview)\n` +
+        `  borg assimilate --help               Show this help\n\n` +
+        `Flags:\n` +
+        `  --worktree <name>          Create + launch the drone in a sibling git worktree\n` +
+        `  --here                     Stay in the current worktree (no sibling spawn)\n` +
+        `  --cube-name <name>         Cube to join/create (otherwise confirm repo basename)\n` +
+        `  --host <host>              Borg server host or URL (bare hosts default to HTTPS)\n` +
+        `  --enroll                   Prompt for a hidden enrollment invitation in the operator terminal\n` +
+        `  --template <name>          Bootstrap a new cube from a bundled role template\n` +
+        `  --no-template              Create the cube with no template roles\n` +
+        `  --cli claude|codex|opencode         Agent CLI to launch (default: claude)\n` +
+        `  --model claude:<model>   Legacy Claude model override (configure models in the agent CLI)\n` +
+        `  --yes, -y                  Skip confirmation prompts\n\n` +
+        `An enrolled owner client may create an idempotent repository cube; ordinary clients\n` +
+        `require an explicit cube grant. Agent seats begin only after enrollment. Preview only.\n` +
+        `See docs/LOCAL_SERVER.md for self-hosted setup and current status.\n\n` +
+        `For local or provider-specific models, configure the selected agent CLI directly.\n` +
+        `OpenCode supports Ollama and other providers through its own model configuration.\n`);
+}
+/**
+ * Help text for `borg reset-local-seat --help`. The offline, network-free seat
+ * reset recommended by the pin-matched SESSION_REJECTED diagnostic (#1082).
+ */
+export function resetLocalSeatHelpText(version) {
+    return (`borg reset-local-seat (borgmcp ${version}) — clear ONLY this worktree's saved local seat\n\n` +
+        `Offline and network-free: it contacts no server and revokes nothing server-side. It clears\n` +
+        `just this worktree's saved local seat — its credential and cube binding together — from the\n` +
+        `local seat store on this machine. Server, trust anchor, cube, and every sibling worktree are\n` +
+        `left untouched.\n\n` +
+        `Use it after \`borg assimilate\` reports this worktree's seat was revoked or taken over\n` +
+        `(a pin-matched rejection), then ask the operator for a new invitation and re-enroll.\n\n` +
+        `Usage:\n` +
+        `  borg reset-local-seat                 Reset this worktree's saved seat (TTY confirms [y/N])\n` +
+        `  borg reset-local-seat --host <host>   No-op unless this worktree's seat is on <host>\n` +
+        `  borg reset-local-seat --yes           Reset without a prompt (required when non-interactive)\n` +
+        `  borg reset-local-seat --help          Show this help\n\n` +
+        `Flags:\n` +
+        `  --host <host>              Only act if this worktree's saved seat is on <host> (else no-op)\n` +
+        `  --yes, -y                  Skip the confirmation prompt (required in non-TTY contexts)\n`);
+}
+/**
+ * Help text for `borg setup --help` (gh#520 — previously this ran the setup
+ * wizard instead of showing help). Mirrors the `borg setup` description in the
+ * top-level `borg --help`.
+ */
+export function setupHelpText(version) {
+    return (`borg setup (borgmcp ${version}) — set up borg MCP server + agent CLI integration\n\n` +
+        `Borg MCP needs Claude Code, Codex, or OpenCode installed first.\n\n` +
+        `Usage:\n` +
+        `  borg setup               Run the interactive setup wizard\n` +
+        `  borg setup --help        Show this help\n`);
+}
+//# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,GAAuB;IAChD,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,CACL,WAAW,OAAO,6DAA6D;QAC/E,uGAAuG;QACvG,gFAAgF;QAChF,sFAAsF;QACtF,2FAA2F;QAC3F,UAAU;QACV,kGAAkG;QAClG,6EAA6E;QAC7E,oDAAoD;QACpD,0EAA0E;QAC1E,qGAAqG;QACrG,uGAAuG;QACvG,yEAAyE;QACzE,uFAAuF;QACvF,0FAA0F;QAC1F,wDAAwD;QACxD,6EAA6E;QAC7E,sEAAsE;QACtE,uDAAuD;QACvD,qEAAqE,CACtE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,CACL,4BAA4B,OAAO,4CAA4C;QAC/E,UAAU;QACV,sGAAsG;QACtG,4FAA4F;QAC5F,4EAA4E;QAC5E,gGAAgG;QAChG,8EAA8E;QAC9E,uGAAuG;QACvG,2DAA2D;QAC3D,UAAU;QACV,oFAAoF;QACpF,gFAAgF;QAChF,sFAAsF;QACtF,sFAAsF;QACtF,mGAAmG;QACnG,kFAAkF;QAClF,uEAAuE;QACvE,+EAA+E;QAC/E,+FAA+F;QAC/F,4DAA4D;QAC5D,uFAAuF;QACvF,0FAA0F;QAC1F,wEAAwE;QACxE,qFAAqF;QACrF,qFAAqF,CACtF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,CACL,kCAAkC,OAAO,qDAAqD;QAC9F,8FAA8F;QAC9F,+FAA+F;QAC/F,gGAAgG;QAChG,qBAAqB;QACrB,2FAA2F;QAC3F,0FAA0F;QAC1F,UAAU;QACV,iGAAiG;QACjG,0FAA0F;QAC1F,kGAAkG;QAClG,4DAA4D;QAC5D,UAAU;QACV,iGAAiG;QACjG,4FAA4F,CAC7F,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,CACL,uBAAuB,OAAO,wDAAwD;QACtF,qEAAqE;QACrE,UAAU;QACV,+DAA+D;QAC/D,6CAA6C,CAC9C,CAAC;AACJ,CAAC"}

package/dist/cli-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-platform.d.ts","sourceRoot":"","sources":["../src/cli-platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,eAAe,CAAC;IACjC,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7C,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,OAAO,CAAC;CACtB;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AAUD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,EAAE,CAM1E;AAOD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,GAAG,aAAa,CAQtH;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAuB9F"}

package/dist/cli-platform.js

@@ -1,4 +1,106 @@
-import C from"which";import{getProjectCliPreference as p,setProjectCliPreference as w}from"./cubes.js";function m(){return{claude:f("claude"),codex:f("codex"),opencode:f("opencode")}}function f(r){try{return C.sync(r)}catch{return null}}function g(r){const e=[];return r.claude&&e.push("claude"),r.codex&&e.push("codex"),r.opencode&&e.push("opencode"),e}async function a(r,e){return await e.setPreference(r),r}async function I(r,e){const c=e.detectCli(),n=g(c);if(n.length===0)throw new Error("No supported agent CLI found (claude, codex, opencode). Install one of them, then run borg again.");if(r){if(!n.includes(r))throw new Error(`${r} CLI is not installed.`);return await e.setPreference(r),r}const t=await e.getPreference();if(t&&n.includes(t))return t;if(n.length===1)return await e.setPreference(n[0]),n[0];if(!e.isTTY())throw new Error("Multiple agent CLIs detected. Pass --cli claude, --cli codex, or --cli opencode to choose.");const o=n.map((s,h)=>`  ${h+1}) ${s}`),i=(await e.prompt(`Use which CLI for this project?
-${o.join(`
-`)}
-[1]: `)).trim();if(i===""||i==="1")return a(n[0],e);const l=parseInt(i,10);if(!Number.isNaN(l)&&l>=1&&l<=n.length)return a(n[l-1],e);const d=i.toLowerCase();for(const s of n)if(d===s)return a(s,e);throw new Error(`invalid CLI choice "${i}"`)}function L(r,e){return{detectCli:m,getPreference:p,setPreference:w,prompt:r,isTTY:e}}const u=["claude","codex","opencode"];function $(r){const e=[];let c;for(let n=0;n<r.length;n++){const t=r[n];if(t==="--cli"){const o=r[n+1];if(!o||!u.includes(o))return{rest:e,error:`--cli requires one of: ${u.join(", ")}`};c=o,n+=1}else if(t.startsWith("--cli=")){const o=t.slice(6);if(!u.includes(o))return{rest:e,error:`--cli requires one of: ${u.join(", ")}`};c=o}else e.push(t)}return{cli:c,rest:e}}export{L as defaultCliChoiceDeps,m as detectCliAvailability,g as installedCliNames,$ as parseCliFlag,I as resolveCliChoice};
+import which from 'which';
+import { getProjectCliPreference, setProjectCliPreference } from './cubes.js';
+export function detectCliAvailability() {
+    return {
+        claude: findCommand('claude'),
+        codex: findCommand('codex'),
+        opencode: findCommand('opencode'),
+    };
+}
+function findCommand(name) {
+    try {
+        return which.sync(name);
+    }
+    catch {
+        return null;
+    }
+}
+export function installedCliNames(availability) {
+    const out = [];
+    if (availability.claude)
+        out.push('claude');
+    if (availability.codex)
+        out.push('codex');
+    if (availability.opencode)
+        out.push('opencode');
+    return out;
+}
+async function setPreferenceAndReturn(cli, deps) {
+    await deps.setPreference(cli);
+    return cli;
+}
+export async function resolveCliChoice(explicit, deps) {
+    const availability = deps.detectCli();
+    const installed = installedCliNames(availability);
+    if (installed.length === 0) {
+        throw new Error('No supported agent CLI found (claude, codex, opencode). Install one of them, then run borg again.');
+    }
+    if (explicit) {
+        if (!installed.includes(explicit)) {
+            throw new Error(`${explicit} CLI is not installed.`);
+        }
+        await deps.setPreference(explicit);
+        return explicit;
+    }
+    const stored = await deps.getPreference();
+    if (stored && installed.includes(stored))
+        return stored;
+    if (installed.length === 1) {
+        await deps.setPreference(installed[0]);
+        return installed[0];
+    }
+    if (!deps.isTTY()) {
+        throw new Error('Multiple agent CLIs detected. Pass --cli claude, --cli codex, or --cli opencode to choose.');
+    }
+    const promptLines = installed.map((cli, i) => `  ${i + 1}) ${cli}`);
+    const answer = (await deps.prompt(`Use which CLI for this project?\n${promptLines.join('\n')}\n[1]: `)).trim();
+    if (answer === '' || answer === '1')
+        return setPreferenceAndReturn(installed[0], deps);
+    const num = parseInt(answer, 10);
+    if (!Number.isNaN(num) && num >= 1 && num <= installed.length) {
+        return setPreferenceAndReturn(installed[num - 1], deps);
+    }
+    const lower = answer.toLowerCase();
+    for (const cli of installed) {
+        if (lower === cli)
+            return setPreferenceAndReturn(cli, deps);
+    }
+    throw new Error(`invalid CLI choice "${answer}"`);
+}
+export function defaultCliChoiceDeps(prompt, isTTY) {
+    return {
+        detectCli: detectCliAvailability,
+        getPreference: getProjectCliPreference,
+        setPreference: setProjectCliPreference,
+        prompt,
+        isTTY,
+    };
+}
+const VALID_CLIS = ['claude', 'codex', 'opencode'];
+export function parseCliFlag(args) {
+    const rest = [];
+    let cli;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--cli') {
+            const next = args[i + 1];
+            if (!next || !VALID_CLIS.includes(next)) {
+                return { rest, error: `--cli requires one of: ${VALID_CLIS.join(', ')}` };
+            }
+            cli = next;
+            i += 1;
+        }
+        else if (arg.startsWith('--cli=')) {
+            const value = arg.slice('--cli='.length);
+            if (!VALID_CLIS.includes(value)) {
+                return { rest, error: `--cli requires one of: ${VALID_CLIS.join(', ')}` };
+            }
+            cli = value;
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { cli, rest };
+}
+//# sourceMappingURL=cli-platform.js.map

package/dist/cli-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-platform.js","sourceRoot":"","sources":["../src/cli-platform.ts"],"names":[],"mappings":"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"}

package/dist/cli-tool-approval.d.ts

@@ -0,0 +1,84 @@
+import { spawn } from 'node:child_process';
+import type { BorgCli } from './cubes.js';
+/**
+ * Client #20: the narrow coordination surface a borg-launched agent needs
+ * without an approval round-trip. Keep the direct-tool list deliberately
+ * smaller than the complete Borg MCP surface. borg_tool's transitive scope is
+ * disclosed separately before consent.
+ */
+export declare const BORG_COORDINATION_TOOLS: readonly ["regen", "log", "read-log", "roster", "ack", "stream-status", "whoami", "cube", "role", "playbook", "tool", "describe-tool"];
+export declare const CODEX_BORG_COORDINATION_TOOLS: string[];
+export declare const OPENCODE_BORG_COORDINATION_TOOLS: string[];
+export declare const BORG_DISPATCHER_APPROVAL_DISCLOSURE = "This set includes borg_tool: approving the dispatcher also approves any Borg operation invoked through it.";
+type OpenCodePermissionAction = 'allow' | 'ask' | 'deny';
+export interface ApprovalInspection {
+    restrictiveTools: string[];
+    repairSnippet: string;
+}
+export interface LaunchApprovalDecision {
+    codexArgs: string[];
+    openCodePermission?: string;
+    warning?: string;
+}
+export declare function codexApprovalRepairSnippet(tools?: string[]): string;
+export declare function inspectCodexBorgApprovals(config: unknown): ApprovalInspection;
+export declare function openCodeApprovalRepairObject(tools?: string[]): Record<string, OpenCodePermissionAction>;
+/** Preserve every existing OpenCode permission rule, then append the exact
+ * Borg coordination allows. This remains safe whether OPENCODE_PERMISSION is
+ * deep-merged or replaces the configured permission value. */
+export declare function mergeOpenCodePermission(permission: unknown, tools?: string[]): Record<string, unknown>;
+export declare function inspectOpenCodeBorgApprovals(config: unknown): ApprovalInspection;
+export declare function codexBorgApprovalArgs(tools?: string[]): string[];
+export interface ApprovalIo {
+    readCodexConfig: (approvalArgs?: string[]) => Promise<unknown> | unknown;
+    readOpenCodeConfig: (permissionOverride?: string) => Promise<unknown> | unknown;
+    isTTY: () => boolean;
+    confirm: (message: string) => Promise<string>;
+}
+export interface EffectiveConfigOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    /** User-selected Codex profile/config flags, in their launch precedence. */
+    codexArgs: string[];
+    loadCodex?: (args: string[], cwd: string, env: NodeJS.ProcessEnv, profile?: string) => Promise<unknown>;
+    loadOpenCode?: (cwd: string, env: NodeJS.ProcessEnv) => Promise<unknown> | unknown;
+}
+export interface CodexEffectiveConfigRuntime {
+    spawnProcess?: typeof spawn;
+    timeoutMs?: number;
+    maxResponseBytes?: number;
+    profile?: string;
+}
+/** Keep only flags that app-server supports and that participate in config
+ * resolution. Runtime-only --profile/-p is resolved separately because Codex
+ * rejects it on the app-server subcommand. */
+export declare function codexEffectiveConfigArgs(args: string[]): string[];
+/** Resolve Codex's selected runtime profile. Short attached forms are accepted
+ * by Codex/clap; the final occurrence before -- wins. */
+export declare function codexSelectedProfile(args: string[]): string | undefined;
+interface CodexConfigLayer {
+    name?: {
+        type?: string;
+        profile?: string | null;
+    };
+    config?: unknown;
+    disabledReason?: string | null;
+}
+interface CodexConfigSnapshot {
+    config?: unknown;
+    layers?: CodexConfigLayer[] | null;
+}
+/** Rebuild the native ordered layer stack with the selected profile inserted
+ * immediately above the base user layer, matching Codex's runtime loader. */
+export declare function composeCodexProfileConfig(snapshot: CodexConfigSnapshot, profileConfig: unknown): unknown;
+export declare function readCodexEffectiveConfig(args: string[], cwd: string, env: NodeJS.ProcessEnv, runtime?: CodexEffectiveConfigRuntime): Promise<unknown>;
+export declare function readOpenCodeEffectiveConfig(cwd: string, env: NodeJS.ProcessEnv): unknown;
+export declare function defaultApprovalIo(confirm: (message: string) => Promise<string>, isTTY: () => boolean, options?: Partial<EffectiveConfigOptions>): ApprovalIo;
+export declare function resolveLaunchBorgApprovals(cli: BorgCli, io: ApprovalIo): Promise<LaunchApprovalDecision>;
+export declare function buildOpenCodeLaunchArgs(cwd: string, port: number, prompt: string, passthroughArgs?: string[]): string[];
+export declare function setupApprovalWarnings(deps: Pick<ApprovalIo, 'readCodexConfig' | 'readOpenCodeConfig'>, selected?: {
+    codex?: boolean;
+    opencode?: boolean;
+}): Promise<string[]>;
+export {};
+//# sourceMappingURL=cli-tool-approval.d.ts.map

package/dist/cli-tool-approval.d.ts.map

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