@mclawnet/agent 0.6.34 → 0.6.36

package/cli.js

@@ -39,13 +39,39 @@ function printNeedsInit() {
 // === init ===
 program
   .command("init")
-  .description("Initialize ~/.clawnet/settings.json (token + name)")
+  .description("Initialize ~/.clawnet/settings.json (token + name) and check CLI dependencies")
   .option("--token <token>", "Agent token (skip interactive prompt)")
   .option("--name <name>", "Agent name (skip interactive prompt)")
   .option("--hub-url <url>", "Hub WebSocket URL (defaults to wss://mclaw.work/ws/agent)")
+  .option("--skip-deps", "Skip CLI dependency check / install / config patching")
+  .option("--yes", "Non-interactive: accept all install prompts")
   .action(async (opts) => {
     const { saveConfig, loadConfig } = await import("./dist/index.js");
 
+    if (!opts.skipDeps) {
+      const { bootstrapDeps } = await import("./dist/bootstrap-deps.js");
+      const isTty = process.stdin.isTTY === true && process.stdout.isTTY === true;
+      const interactive = isTty && !opts.yes;
+      try {
+        const report = await bootstrapDeps({
+          homeDir: (await import("os")).homedir(),
+          interactive,
+          install: true,
+          promptFn: prompt,
+        });
+        if (report.present.length) console.log(`  ✓ CLIs present: ${report.present.join(", ")}`);
+        if (report.installed.length) console.log(`  ✓ Installed: ${report.installed.join(", ")}`);
+        if (report.missing.filter((m) => !report.installed.includes(m)).length)
+          console.log(`  ⚠ Still missing: ${report.missing.filter((m) => !report.installed.includes(m)).join(", ")}`);
+        for (const c of report.configChanges) console.log(`  • ${c}`);
+        for (const h of report.envHints) console.log(`  ⚠ ${h}`);
+        console.log();
+      } catch (err) {
+        console.error("[clawnet] bootstrap-deps failed:", err.message || err);
+        console.error("  Continuing with token setup. Re-run 'clawnet-agent doctor' to retry.");
+      }
+    }
+
     const existing = loadConfig();
 
     let token = opts.token;
@@ -77,11 +103,53 @@ program
 
     const hubUrl = opts.hubUrl || existing.hubUrl || "wss://mclaw.work/ws/agent";
 
-    saveConfig({ token, name, hubUrl, backendType: "claude-code" });
+    saveConfig({ token, name, hubUrl, backendType: "claude" });
     console.log("\n✓ Saved to ~/.clawnet/settings.json");
     console.log("  Run 'clawnet-agent start' to start the agent.\n");
   });
 
+// === doctor ===
+program
+  .command("doctor")
+  .description("Diagnose CLI dependencies and config (read-only by default; --fix to install/patch)")
+  .option("--fix", "Install missing CLIs and patch missing config keys")
+  .option("--yes", "Non-interactive: accept all install prompts (only with --fix)")
+  .action(async (opts) => {
+    const { bootstrapDeps } = await import("./dist/bootstrap-deps.js");
+    const { homedir } = await import("os");
+    const isTty = process.stdin.isTTY === true && process.stdout.isTTY === true;
+    const interactive = opts.fix && isTty && !opts.yes;
+    const report = await bootstrapDeps({
+      homeDir: homedir(),
+      interactive,
+      install: Boolean(opts.fix),
+      promptFn: prompt,
+    });
+    console.log("ClawNet Agent — Doctor Report\n");
+    console.log("CLI dependencies:");
+    for (const name of ["claude", "codex"]) {
+      const present = report.present.includes(name);
+      const installed = report.installed.includes(name);
+      const status = installed ? "installed (this run)" : present ? "present" : "MISSING";
+      console.log(`  ${present || installed ? "✓" : "✗"} ${name}: ${status}`);
+    }
+    console.log("\nConfig:");
+    if (report.configChanges.length === 0) {
+      console.log("  ✓ ~/.codex/config.toml and ~/.claude/settings.json look fine");
+    } else {
+      for (const c of report.configChanges) console.log(`  • ${c}`);
+    }
+    if (report.envHints.length > 0) {
+      console.log("\nEnvironment:");
+      for (const h of report.envHints) console.log(`  ⚠ ${h}`);
+    }
+    const stillMissing = report.missing.filter((m) => !report.installed.includes(m));
+    if (stillMissing.length > 0 && !opts.fix) {
+      console.log(`\nRun 'clawnet-agent doctor --fix' to install missing CLIs and patch config.`);
+    }
+    if (stillMissing.length > 0) process.exit(1);
+  });
+
 // === start (default command) ===
 program
   .command("start", { isDefault: true })
@@ -90,7 +158,7 @@ program
   .option("--hub-url <url>", "Hub WebSocket URL")
   .option("--token <token>", "Agent token")
   .option("--name <name>", "Agent name")
-  .option("--backend <type>", "Backend type", "claude-code")
+  .option("--backend <type>", "Backend type", "claude")
   .action(async (opts) => {
     if (opts.foreground) {
       // Foreground mode: directly run agent (existing behavior)
@@ -109,8 +177,8 @@ program
       }
 
       let adapter;
-      const backendType = opts.backend || "claude-code";
-      if (backendType === "claude-code") {
+      const backendType = opts.backend || "claude";
+      if (backendType === "claude") {
         try {
           const { ClaudeCodeAdapter } = await import("@mclawnet/claude-adapter");
           adapter = new ClaudeCodeAdapter();
@@ -280,8 +348,8 @@ const CONFIG_SCHEMA = [
   },
   {
     key: "backendType",
-    description: "LLM backend implementation. Currently only 'claude-code' is supported.",
-    default: "claude-code",
+    description: "LLM backend implementation. Currently only 'claude' is supported.",
+    default: "claude",
   },
   {
     key: "embedding.provider",

package/dist/__tests__/bootstrap-deps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap-deps.test.d.ts.map

package/dist/__tests__/bootstrap-deps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-deps.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bootstrap-deps.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/collect-manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=collect-manifest.test.d.ts.map

package/dist/__tests__/collect-manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-manifest.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/collect-manifest.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hub-connection-on-activity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hub-connection-on-activity.test.d.ts.map

package/dist/__tests__/hub-connection-on-activity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-connection-on-activity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hub-connection-on-activity.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hub-connection-wake-watch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hub-connection-wake-watch.test.d.ts.map

package/dist/__tests__/hub-connection-wake-watch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-connection-wake-watch.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hub-connection-wake-watch.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ideas-rest-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ideas-rest-client.test.d.ts.map

package/dist/__tests__/ideas-rest-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas-rest-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ideas-rest-client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/legacy-claude-execute-compat.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=legacy-claude-execute-compat.test.d.ts.map

package/dist/__tests__/legacy-claude-execute-compat.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-claude-execute-compat.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/legacy-claude-execute-compat.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/no-adapter-cycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-adapter-cycle.test.d.ts.map

package/dist/__tests__/no-adapter-cycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-adapter-cycle.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/no-adapter-cycle.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/runtime-env-defaults.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-env-defaults.test.d.ts.map

package/dist/__tests__/runtime-env-defaults.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env-defaults.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtime-env-defaults.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-manager-exit-reason.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-manager-exit-reason.test.d.ts.map

package/dist/__tests__/session-manager-exit-reason.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-exit-reason.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-manager-exit-reason.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-manager-merge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-manager-merge.test.d.ts.map

package/dist/__tests__/session-manager-merge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-merge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-manager-merge.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-manager-sticky.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-manager-sticky.test.d.ts.map

package/dist/__tests__/session-manager-sticky.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-sticky.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-manager-sticky.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-protocol-dispatch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-protocol-dispatch.test.d.ts.map

package/dist/__tests__/session-protocol-dispatch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-protocol-dispatch.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-protocol-dispatch.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/worktree-bridge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worktree-bridge.test.d.ts.map

package/dist/__tests__/worktree-bridge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-bridge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worktree-bridge.test.ts"],"names":[],"mappings":""}

package/dist/backend-adapter.d.ts

@@ -1,236 +1,10 @@
 /**
- * BackendAdapter — pluggable backend for AI model interaction.
+ * Backend interface types — moved to @mclawnet/backend-types so that
+ * adapter packages (claude-adapter, codex-adapter, future ones) can depend
+ * on these types WITHOUT taking a build-time dependency on @mclawnet/agent.
  *
- * Implementations:
- * - ClaudeCodeAdapter (@mclawnet/claude-adapter): spawn `claude` CLI
- * - OpenClawAdapter: spawn `openclaw gateway` (legacy)
- * - CodexAdapter: M3.S3 — `codex app-server --listen stdio://`
- *
- * M3.S1 introduces:
- * - Typed permission flow (PermissionRequest / PermissionDecision)
- * - Typed BackendOutput envelope replacing the historical `onOutput(msg: unknown)`
- * - `backendSessionId` replaces the previous `claudeSessionId` (see plan D7).
- */
-export interface PermissionRequest {
-    /** Stable identifier for the pending tool call. */
-    callId: string;
-    /** Tool name as reported by the backend (e.g. 'shell', 'apply_patch', 'Write'). */
-    toolName: string;
-    /** Raw tool input as the backend supplied it. */
-    input: unknown;
-    /** Optional backend-supplied context (sandbox, cwd, reason, ...). */
-    meta?: {
-        backend?: "claude" | "codex" | string;
-        reason?: string;
-        cwd?: string;
-        [k: string]: unknown;
-    };
-}
-/**
- * S0 finding: neither claude `--permission-mode default` (no wire channel)
- * nor codex `ReviewDecision` supports "approve with modifiedInput", so the
- * S1 contract is a 4-state enum. `allow_session` may degrade to `allow` for
- * backends that don't track session-scoped approvals.
- */
-export interface PermissionDecision {
-    callId: string;
-    decision: "allow" | "allow_session" | "deny" | "abort";
-    reason?: string;
-}
-export type BackendOutput = {
-    kind: "assistant_text";
-    text: string;
-} | {
-    kind: "tool_use";
-    toolName: string;
-    input: unknown;
-    callId: string;
-} | {
-    kind: "tool_result";
-    callId: string;
-    output: unknown;
-    isError?: boolean;
-} | {
-    kind: "system";
-    subtype: string;
-    data: unknown;
-}
-/**
- * Adapter-internal diagnostic only. Hub and wire layers MUST NOT consume
- * `raw` — promote a new typed variant instead when hub needs to read it.
+ * agent still re-exports them via this barrel for backward compatibility,
+ * so existing internal imports (`./backend-adapter.js`) keep working.
  */
- | {
-    kind: "raw";
-    backend: string;
-    payload: unknown;
-};
-export interface BackendProcess {
-    /** Unique identifier (e.g., Claude session ID) */
-    id: string;
-    /** Working directory for this process */
-    workDir: string;
-    /**
-     * OS process id of the underlying backend process, if applicable.
-     *
-     * Optional because not every backend is a child process — a future in-process
-     * adapter (mock / stubbed / WASM) wouldn't have one. SessionManager uses pid
-     * for the PR-C checkpoint: a restart probes `process.kill(pid, 0)` to decide
-     * whether the recorded session is `dead` or an `orphan`. Adapters that omit
-     * pid forfeit the dead/orphan classification — checkpointed sessions will
-     * silently appear as "no longer here", which is also acceptable behavior.
-     */
-    pid?: number;
-    /** Kill the backend process */
-    kill(): Promise<void>;
-    /**
-     * Whether the backend process is still alive and capable of accepting input.
-     * Returns false if the process has exited, is being killed, or its stdin is no
-     * longer writable. Used by SessionManager.isHealthy() to detect stale entries.
-     */
-    isAlive(): boolean;
-}
-export interface SpawnOptions {
-    /** ClawNet session ID */
-    sessionId: string;
-    /** Working directory for the backend process */
-    workDir?: string;
-    /** Resume a previous session (e.g., Claude --resume UUID) */
-    resumeId?: string;
-    /** System prompt to append (e.g., role prompt for swarm mode) */
-    systemPrompt?: string;
-    /** Load BrainCore + CoreSkill via --add-dir */
-    useBrainCore?: boolean;
-    /** Path to MCP config JSON file for --mcp-config */
-    mcpConfigPath?: string;
-    /** Memory system role ID. When set, SessionManager auto-injects memory prompt + MCP config */
-    roleId?: string;
-    /**
-     * Optional first user input. When set, SessionManager uses this as the
-     * semantic-retrieval query for `buildMemorySection` (Pipeline A) so the
-     * injected memory section is relevant to what the user is about to ask.
-     * Falls back to an empty query (importance-top-K) when omitted.
-     */
-    initialUserInput?: string;
-    /** Extra directories to mount via --add-dir */
-    additionalDirs?: string[];
-    /** Optional allowlist of tool names to forward to the backend (PR3.5). */
-    allowedTools?: string[];
-    /** Optional denylist of tool names to forward to the backend (PR3.5). */
-    disallowedTools?: string[];
-    /**
-     * Override CLAUDE_CODE_MAX_OUTPUT_TOKENS for this spawn. Drives the
-     * server-side hard limit (200k − maxOutputTokens) and the CLI's own
-     * effective window. Lower = wider prompt budget. SessionManager pulls this
-     * from `getRecommendedMaxOutputTokens()` on each spawn so the ladder
-     * (32k → 16k → 8k) survives across `--resume` restarts.
-     *
-     * Optional: when omitted the CLI uses its own default — adapters that
-     * don't honour it lose D-lite escalation but never crash.
-     */
-    maxOutputTokens?: number;
-    /**
-     * Optional backend kind for this spawn. When set, SessionManager resolves
-     * an adapter via its `resolveAdapter` hook (typically `createBackendAdapter`)
-     * and uses it for this process instead of the default constructor adapter.
-     * Omitted = use the default adapter (back-compat).
-     */
-    backend?: "claude" | "codex";
-    /**
-     * Per-role sandbox level. Each adapter maps to its own permission model:
-     *   - codex-adapter: `-c sandbox_mode="<value>"` (OS-level seatbelt /
-     *     landlock — strong enforcement)
-     *   - claude-adapter: `--permission-mode` (LLM-soft approval; UI should
-     *     tooltip that claude has no real OS sandbox)
-     *
-     * Values: "read-only" | "workspace-write" | "full-access".
-     * Default (undefined): adapter-specific — claude uses constructor
-     * permissionMode (typically bypassPermissions), codex uses
-     * "workspace-write".
-     */
-    sandbox?: "read-only" | "workspace-write" | "full-access";
-}
-export interface BackendAdapter {
-    /** Backend type identifier */
-    type: string;
-    /** Spawn a new backend process */
-    spawn(options: SpawnOptions): Promise<BackendProcess>;
-    /** Stop a running backend process */
-    stop(process: BackendProcess): Promise<void>;
-    /** Send user input to the backend process */
-    send(process: BackendProcess, input: string): void;
-    /**
-     * Register output handler. Handler receives `unknown` today (legacy claude
-     * stream-json frames); adapters are migrating to emit `BackendOutput`
-     * envelopes. Consumers that need typed output should narrow with the
-     * `BackendOutput` discriminator.
-     */
-    onOutput(process: BackendProcess, handler: (msg: unknown) => void): void;
-    /**
-     * M3.S1 — Optional permission flow.
-     * - codex-adapter (S3): implemented; maps from `ReviewDecision` wire format.
-     * - claude-adapter: M3 stays on `bypassPermissions` and does NOT implement
-     *   these. M4+ will add via an MCP permission-prompt tool.
-     */
-    onPermissionRequest?(process: BackendProcess, handler: (req: PermissionRequest) => void): void;
-    respondToPermission?(process: BackendProcess, decision: PermissionDecision): Promise<void>;
-    /** Turn-complete handler. */
-    onTurnComplete?(process: BackendProcess, handler: (info: {
-        backendSessionId?: string;
-        cost?: number;
-        duration?: number;
-        contextUsage?: {
-            used: number;
-            total: number;
-        };
-        backendMeta?: Record<string, unknown>;
-    }) => void): void;
-    /** Register error handler */
-    onError?(process: BackendProcess, handler: (error: Error) => void): void;
-    /**
-     * Register a handler that fires the moment the backend reports its session
-     * is initialized (e.g. Claude CLI's `system/init` frame, codex `thread_id`).
-     * Used by hub to persist `backendSessionId` early — without this we have to
-     * wait for `turn_complete`, and a mid-turn crash would leave db's
-     * backend_session_id NULL despite a valid jsonl file existing on disk.
-     *
-     * Optional: adapters that don't implement this lose the early-backfill
-     * capability — db's backend_session_id will only be populated on
-     * `turn_complete`, so any session whose first turn crashes will be
-     * unrecoverable via `--resume`. Other backends (codex, openclaw) should
-     * implement this if they have an analogous "session ready" signal.
-     */
-    onSessionStarted?(process: BackendProcess, handler: (info: {
-        backendSessionId: string;
-    }) => void): void;
-    /**
-     * Register a handler that fires when the underlying process exits on its
-     * own (crash, EPIPE, OOM, manual SIGKILL from outside) — *not* when we
-     * deliberately call kill() ourselves. Used by SessionManager to auto-evict
-     * dead Map entries and notify hub via onSessionError.
-     *
-     * Optional: adapters that don't implement this lose auto-eviction —
-     * SessionManager's Map will keep the dead entry, isHealthy() will still
-     * fall back to BackendProcess.isAlive() so the unhealthy-fallback-resume
-     * branch in hub-connection.ts still works, but the orphan Map entry will
-     * accumulate until the next abortSession/closeSession call.
-     */
-    onExit?(process: BackendProcess, handler: (code: number | null) => void): void;
-    /**
-     * Register a handler for token-budget warnings. Fires when the backend
-     * estimates the prompt is approaching the server-side hard limit.
-     * SessionManager uses this to escalate the max_output_tokens ladder so
-     * the next spawn gets a wider budget.
-     *
-     * Optional: adapters that can't introspect token usage simply skip this —
-     * the ladder stays at index 0 forever, falling back to claude-code's own
-     * auto-compact (which works most of the time, just less defensively).
-     */
-    onTokenBudgetWarning?(process: BackendProcess, handler: (info: {
-        used: number;
-        hardLimit: number;
-        threshold: number;
-        distanceToHard: number;
-        maxOutputTokens: number;
-    }) => void): void;
-}
+export type { BackendAdapter, BackendProcess, BackendOutput, PermissionDecision, PermissionRequest, SpawnOptions, } from "@mclawnet/backend-types";
 //# sourceMappingURL=backend-adapter.d.ts.map

package/dist/backend-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-adapter.d.ts","sourceRoot":"","sources":["../src/backend-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend-adapter.d.ts","sourceRoot":"","sources":["../src/backend-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,yBAAyB,CAAC"}

package/dist/backend-factory-AFF6I7YF.js

@@ -0,0 +1,11 @@
+import {
+  __resetBackendFactoryCache,
+  collectAgentManifest,
+  createBackendAdapter
+} from "./chunk-VAEFJLPL.js";
+export {
+  __resetBackendFactoryCache,
+  collectAgentManifest,
+  createBackendAdapter
+};
+//# sourceMappingURL=backend-factory-AFF6I7YF.js.map

package/dist/backend-factory.d.ts

@@ -1,5 +1,6 @@
 import type { BackendAdapter } from "./backend-adapter.js";
-export type BackendKind = "claude" | "codex";
+import type { AgentManifestPayload, BackendKind } from "@mclawnet/shared";
+export type { BackendKind };
 export declare function __resetBackendFactoryCache(): void;
 export interface BackendFactoryContext {
     /** Role instance / template name — surfaces in error messages so users know
@@ -13,7 +14,28 @@ export interface BackendFactoryContext {
  * - "codex" → @mclawnet/codex-adapter via dynamic import so the codex bundle
  *   isn't pulled into claude-only deployments.
  *
+ * Why dynamic import (and why codex-adapter is `optionalDependencies` in
+ * agent's package.json, not `dependencies`):
+ *   - agent owns the runtime relationship "I load adapters on demand".
+ *   - Adapters only depend on @mclawnet/backend-types (the interface package),
+ *     so there is no build-time cycle.
+ *   - `optionalDependencies` keeps the "user installs just @mclawnet/agent
+ *     and codex backend works out of the box" UX: npm/pnpm will try to
+ *     install codex-adapter; if that fails (network, platform issue, user
+ *     opted out via --no-optional), the dynamic import below throws and
+ *     the agent surfaces a clear error instead of crashing at startup.
+ *   - Promoting codex-adapter to `dependencies` would force install, which
+ *     is fine for monorepo but unfriendly to claude-only deployments.
+ *
  * Results are cached per kind; subsequent calls return the same instance.
  */
 export declare function createBackendAdapter(kind: BackendKind | undefined, ctx?: BackendFactoryContext): Promise<BackendAdapter>;
+/**
+ * Probe every known backend adapter and aggregate their `getManifest()` output
+ * into a single payload the agent can ship to the hub. Failures (binary not on
+ * PATH, adapter package broken, etc.) become `installed: false` entries rather
+ * than rejecting the whole collection — the hub still wants to know "we tried
+ * but it isn't available" for each kind.
+ */
+export declare function collectAgentManifest(): Promise<AgentManifestPayload>;
 //# sourceMappingURL=backend-factory.d.ts.map

package/dist/backend-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../src/backend-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAI7C,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,MAAM,WAAW,qBAAqB;IACpC;8EAC0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,GAAE,qBAA0B,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0CzB"}
+{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../src/backend-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI1E,YAAY,EAAE,WAAW,EAAE,CAAC;AAI5B,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,MAAM,WAAW,qBAAqB;IACpC;8EAC0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,GAAE,qBAA0B,GAC9B,OAAO,CAAC,cAAc,CAAC,CAsCzB;AAgBD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkB1E"}

package/dist/bootstrap-deps.d.ts

@@ -0,0 +1,84 @@
+export interface DetectResult {
+    found: boolean;
+    path?: string;
+}
+export interface DetectOptions {
+    /** Override which/where lookup. Tests inject a fake; runtime defaults to execFileSync. */
+    whichFn?: (bin: string) => string;
+}
+export declare function detectCli(bin: string, opts?: DetectOptions): DetectResult;
+export interface PatchResult {
+    /** Human-readable change log entries; empty array = no changes. */
+    patched: string[];
+}
+export interface PatchOptions {
+    homeDir: string;
+}
+/**
+ * Merge defaults into ~/.codex/config.toml.
+ *
+ * Two paths:
+ *   - File absent → write a fresh stringified TOML with our defaults.
+ *   - File exists → parse to detect missing keys, then APPEND missing
+ *     fragments as raw text. We never re-stringify the parsed AST, because
+ *     smol-toml's stringify drops comments and may reorder keys (verified
+ *     by regression test). Appending preserves the user's original bytes.
+ *
+ * Never touches user-set model_provider / model / per-provider fields.
+ */
+export declare function patchCodexConfig(opts: PatchOptions): PatchResult;
+/**
+ * Ensure ~/.claude/settings.json exists.
+ *
+ * Currently a thin presence-check: claude-code's own config schema evolves
+ * fast and we don't want to fight it. Just create an empty object if absent
+ * so downstream tools can rely on the file's existence.
+ */
+export declare function patchClaudeConfig(opts: PatchOptions): PatchResult;
+export declare function detectEnvVar(name: string): boolean;
+/**
+ * Read ~/.codex/config.toml and return the currently-active model_provider
+ * string. Returns undefined when the file is absent, malformed, or has no
+ * model_provider key set.
+ *
+ * Used by bootstrapDeps to gate provider-specific env-var hints — we only
+ * warn about COPILOT_API_KEY when the user actually picked copilot-api.
+ */
+export declare function detectActiveCodexProvider(homeDir: string): string | undefined;
+/**
+ * Build a platform-specific user-facing instruction for setting
+ * COPILOT_API_KEY. The copilot-api proxy (the localhost:4141 forwarder)
+ * does not validate the bearer token — any non-empty string works — but
+ * codex's env_key check fails hard if the variable is missing. So the hint
+ * has to tell the user exactly which shell command to run.
+ *
+ * Platform split kept here (not at the call site) so future locales / new
+ * platforms can extend the matrix without touching bootstrapDeps logic.
+ */
+export declare function buildCopilotApiEnvHint(opts: {
+    platform: NodeJS.Platform | string;
+}): string;
+export interface BootstrapOptions {
+    homeDir: string;
+    /** When true, prompt user before installing CLIs. */
+    interactive: boolean;
+    /** When false, never install (doctor mode). */
+    install: boolean;
+    whichFn?: (bin: string) => string;
+    installFn?: (cliName: "claude" | "codex") => Promise<void>;
+    promptFn?: (question: string) => Promise<string>;
+}
+export interface BootstrapReport {
+    /** CLIs that were already installed. */
+    present: string[];
+    /** CLIs missing at start. */
+    missing: string[];
+    /** CLIs installed during this run. */
+    installed: string[];
+    /** Config patcher change logs (codex + claude). */
+    configChanges: string[];
+    /** Hint strings to print to user about env vars that need attention. */
+    envHints: string[];
+}
+export declare function bootstrapDeps(opts: BootstrapOptions): Promise<BootstrapReport>;
+//# sourceMappingURL=bootstrap-deps.d.ts.map

package/dist/bootstrap-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-deps.d.ts","sourceRoot":"","sources":["../src/bootstrap-deps.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAyB7E;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAqEhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAejE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAA;CAAE,GAAG,MAAM,CAmB3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwDpF"}