@mclawnet/agent 0.6.33 → 0.6.35

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;
@@ -82,6 +108,48 @@ program
     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 })

package/dist/__tests__/backend-adapter-types.test.d.ts

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

package/dist/__tests__/backend-adapter-types.test.d.ts.map

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

package/dist/__tests__/backend-factory.test.d.ts

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

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

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

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__/normalize-backend-output.test.d.ts

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

package/dist/__tests__/normalize-backend-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-backend-output.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/normalize-backend-output.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-backend.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-backend.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-manager-backend.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-permission.test.d.ts

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

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

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

package/dist/__tests__/templates-roles-bridge.test.d.ts

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

package/dist/__tests__/templates-roles-bridge.test.d.ts.map

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

package/dist/backend-adapter.d.ts

@@ -4,8 +4,66 @@
  * Implementations:
  * - ClaudeCodeAdapter (@mclawnet/claude-adapter): spawn `claude` CLI
  * - OpenClawAdapter: spawn `openclaw gateway` (legacy)
- * - CodexAdapter: future
+ * - 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.
+ */
+ | {
+    kind: "raw";
+    backend: string;
+    payload: unknown;
+};
 export interface BackendProcess {
     /** Unique identifier (e.g., Claude session ID) */
     id: string;
@@ -70,6 +128,26 @@ export interface SpawnOptions {
      * 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 */
@@ -80,35 +158,49 @@ export interface BackendAdapter {
     stop(process: BackendProcess): Promise<void>;
     /** Send user input to the backend process */
     send(process: BackendProcess, input: string): void;
-    /** Register output handler for a backend process */
+    /**
+     * 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;
-    /** Register turn-complete handler */
+    /**
+     * 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: {
-        claudeSessionId?: string;
+        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). Used by hub to
-     * persist `claudeSessionId` early — without this we have to wait for
-     * `turn_complete`, and a mid-turn crash would leave db's claudeSessionId
-     * NULL despite a valid jsonl file existing on disk.
+     * 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 claudeSessionId will only be populated on
+     * 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: {
-        claudeSessionId: string;
+        backendSessionId: string;
     }) => void): void;
     /**
      * Register a handler that fires when the underlying process exits on its

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

@@ -1 +1 @@
-{"version":3,"file":"backend-adapter.d.ts","sourceRoot":"","sources":["../src/backend-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEtD,qCAAqC;IACrC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,6CAA6C;IAC7C,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAEzE,qCAAqC;IACrC,cAAc,CAAC,CACb,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CAAC,IAAI,EAAE;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAChD,KAAK,IAAI,GACT,IAAI,CAAC;IAER,6BAA6B;IAC7B,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAEzE;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,CACf,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GACnD,IAAI,CAAC;IAER;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/E;;;;;;;;;OASG;IACH,oBAAoB,CAAC,CACnB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CAAC,IAAI,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;KACzB,KAAK,IAAI,GACT,IAAI,CAAC;CACT"}
+{"version":3,"file":"backend-adapter.d.ts","sourceRoot":"","sources":["../src/backend-adapter.ts"],"names":[],"mappings":"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"}

package/dist/backend-factory-VRPU3534.js

@@ -0,0 +1,9 @@
+import {
+  __resetBackendFactoryCache,
+  createBackendAdapter
+} from "./chunk-FYM7CXUI.js";
+export {
+  __resetBackendFactoryCache,
+  createBackendAdapter
+};
+//# sourceMappingURL=backend-factory-VRPU3534.js.map

package/dist/backend-factory-VRPU3534.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/backend-factory.d.ts

@@ -0,0 +1,19 @@
+import type { BackendAdapter } from "./backend-adapter.js";
+export type BackendKind = "claude" | "codex";
+export declare function __resetBackendFactoryCache(): void;
+export interface BackendFactoryContext {
+    /** Role instance / template name — surfaces in error messages so users know
+     *  which role is misconfigured when its backend package fails to load. */
+    roleName?: string;
+}
+/**
+ * Resolve a BackendAdapter for the given backend kind.
+ *
+ * - "claude" / undefined → @mclawnet/claude-adapter (back-compat default).
+ * - "codex" → @mclawnet/codex-adapter via dynamic import so the codex bundle
+ *   isn't pulled into 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>;
+//# sourceMappingURL=backend-factory.d.ts.map

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

@@ -0,0 +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"}

package/dist/bootstrap-deps.d.ts

@@ -0,0 +1,62 @@
+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;
+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,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,CAqDpF"}

package/dist/bootstrap-deps.js

@@ -0,0 +1,154 @@
+// src/bootstrap-deps.ts
+import { execFileSync } from "child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { platform } from "os";
+import { join } from "path";
+import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
+var isWin = platform() === "win32";
+function detectCli(bin, opts = {}) {
+  const whichFn = opts.whichFn ?? ((b) => {
+    const cmd = isWin ? "where" : "which";
+    return execFileSync(cmd, [b], {
+      encoding: "utf-8",
+      timeout: 1500,
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim().split(/\r?\n/)[0];
+  });
+  try {
+    const path = whichFn(bin);
+    if (path) return { found: true, path };
+    return { found: false };
+  } catch {
+    return { found: false };
+  }
+}
+var COPILOT_PROVIDER_DEFAULTS = {
+  name: "copilot-api",
+  base_url: "http://localhost:4141/v1",
+  wire_api: "responses",
+  env_key: "COPILOT_API_KEY"
+};
+function patchCodexConfig(opts) {
+  const codexDir = join(opts.homeDir, ".codex");
+  const cfgPath = join(codexDir, "config.toml");
+  if (!existsSync(cfgPath)) {
+    const fresh = {
+      model_provider: "copilot-api",
+      model_providers: { "copilot-api": COPILOT_PROVIDER_DEFAULTS }
+    };
+    mkdirSync(codexDir, { recursive: true });
+    writeFileSync(cfgPath, stringifyToml(fresh) + "\n");
+    return { patched: ["created ~/.codex/config.toml"] };
+  }
+  const originalText = readFileSync(cfgPath, "utf-8");
+  let cfg;
+  try {
+    cfg = parseToml(originalText);
+  } catch {
+    return { patched: ["~/.codex/config.toml could not be parsed; left untouched"] };
+  }
+  const mp = cfg.model_providers;
+  if (mp !== void 0 && (typeof mp !== "object" || Array.isArray(mp))) {
+    return {
+      patched: ["~/.codex/config.toml has model_providers that is not a table; left untouched"]
+    };
+  }
+  const needsTopLevel = cfg.model_provider === void 0;
+  const providers = mp ?? {};
+  const needsProvider = !providers["copilot-api"];
+  if (!needsTopLevel && !needsProvider) {
+    return { patched: [] };
+  }
+  const fragments = [];
+  const patched = [];
+  if (needsTopLevel) {
+    fragments.push(`model_provider = "copilot-api"`);
+    patched.push("set model_provider=copilot-api");
+  }
+  let updated = originalText;
+  if (fragments.length > 0) {
+    updated = fragments.join("\n") + "\n\n" + updated;
+  }
+  if (needsProvider) {
+    const sectionToml = stringifyToml({
+      model_providers: { "copilot-api": COPILOT_PROVIDER_DEFAULTS }
+    });
+    const sep = updated.endsWith("\n") ? "\n" : "\n\n";
+    updated = updated + sep + sectionToml + "\n";
+    patched.push("added [model_providers.copilot-api]");
+  }
+  writeFileSync(cfgPath, updated);
+  return { patched };
+}
+function patchClaudeConfig(opts) {
+  const claudeDir = join(opts.homeDir, ".claude");
+  const cfgPath = join(claudeDir, "settings.json");
+  if (existsSync(cfgPath)) {
+    try {
+      JSON.parse(readFileSync(cfgPath, "utf-8"));
+      return { patched: [] };
+    } catch {
+      return { patched: ["~/.claude/settings.json is not valid JSON; left untouched"] };
+    }
+  }
+  mkdirSync(claudeDir, { recursive: true });
+  writeFileSync(cfgPath, "{}\n");
+  return { patched: ["created ~/.claude/settings.json"] };
+}
+function detectEnvVar(name) {
+  const v = process.env[name];
+  return typeof v === "string" && v.length > 0;
+}
+async function defaultInstall(name) {
+  const pkg = name === "claude" ? "@anthropic-ai/claude-code" : "@openai/codex";
+  execFileSync("npm", ["install", "-g", pkg], { stdio: "inherit" });
+}
+async function bootstrapDeps(opts) {
+  const installFn = opts.installFn ?? defaultInstall;
+  const promptFn = opts.promptFn ?? (async () => "y");
+  const report = {
+    present: [],
+    missing: [],
+    installed: [],
+    configChanges: [],
+    envHints: []
+  };
+  const cliNames = ["claude", "codex"];
+  for (const name of cliNames) {
+    const r = detectCli(name, { whichFn: opts.whichFn });
+    if (r.found) report.present.push(name);
+    else report.missing.push(name);
+  }
+  if (opts.install && report.missing.length > 0) {
+    for (const name of report.missing) {
+      let shouldInstall = true;
+      if (opts.interactive) {
+        const ans = (await promptFn(`Install ${name} CLI via npm? [Y/n]: `)).trim().toLowerCase();
+        shouldInstall = ans === "" || ans === "y" || ans === "yes";
+      }
+      if (shouldInstall) {
+        await installFn(name);
+        report.installed.push(name);
+      }
+    }
+  }
+  const codexR = patchCodexConfig({ homeDir: opts.homeDir });
+  report.configChanges.push(...codexR.patched);
+  const claudeR = patchClaudeConfig({ homeDir: opts.homeDir });
+  report.configChanges.push(...claudeR.patched);
+  if (!detectEnvVar("COPILOT_API_KEY")) {
+    const shellHint = isWin ? "Set COPILOT_API_KEY in System \u2192 Environment Variables (any non-empty value, e.g. 'dummy')" : "Add to ~/.zshrc (or ~/.bashrc): export COPILOT_API_KEY=dummy";
+    report.envHints.push(
+      `COPILOT_API_KEY is not set. ${shellHint}. The copilot-api proxy does not validate the value, but codex requires the variable to exist.`
+    );
+  }
+  return report;
+}
+export {
+  bootstrapDeps,
+  detectCli,
+  detectEnvVar,
+  patchClaudeConfig,
+  patchCodexConfig
+};
+//# sourceMappingURL=bootstrap-deps.js.map

package/dist/bootstrap-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bootstrap-deps.ts"],"sourcesContent":["/**\n * bootstrap-deps — `clawnet-agent init` / `doctor` shared logic.\n *\n * Responsibilities (all idempotent, safe to re-run):\n *   - detect whether claude / codex CLIs are installed (which / where)\n *   - idempotent-merge ~/.codex/config.toml (default to copilot-api provider)\n *   - idempotent-merge ~/.claude/settings.json (create if absent, never overwrite)\n *   - detect env vars (COPILOT_API_KEY) and return user-facing hints when missing\n *\n * Side-effects deliberately NOT taken:\n *   - never modifies ~/.zshrc / ~/.bashrc / Windows env — dotfiles are sacred.\n *     Missing env is reported via `envHints[]` so the caller can print them.\n *   - never overwrites user-set TOML / JSON values; only adds missing keys.\n *   - when patching an EXISTING TOML file we never round-trip through\n *     stringify (smol-toml drops comments). We parse only to detect which\n *     keys are missing, then append the missing bits as raw text so user\n *     comments and key order survive untouched.\n *\n * Network / subprocess side-effects (npm install) are injected via `installFn`\n * so tests can verify call shape without actually spawning npm.\n */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { platform } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parse as parseToml, stringify as stringifyToml } from \"smol-toml\";\n\nconst isWin = platform() === \"win32\";\n\nexport interface DetectResult {\n  found: boolean;\n  path?: string;\n}\n\nexport interface DetectOptions {\n  /** Override which/where lookup. Tests inject a fake; runtime defaults to execFileSync. */\n  whichFn?: (bin: string) => string;\n}\n\nexport function detectCli(bin: string, opts: DetectOptions = {}): DetectResult {\n  const whichFn =\n    opts.whichFn ??\n    ((b: string) => {\n      const cmd = isWin ? \"where\" : \"which\";\n      // execFileSync (not execSync) — pass `b` as an arg, never interpolate\n      // into a shell string. Today callers pass only literal \"claude\"/\"codex\"\n      // but the signature accepts any string; using execFile is defense in\n      // depth so a future caller passing user input can't smuggle a shell\n      // metacharacter and turn this into a command-injection sink.\n      return execFileSync(cmd, [b], {\n        encoding: \"utf-8\",\n        timeout: 1500,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      })\n        .trim()\n        .split(/\\r?\\n/)[0];\n    });\n  try {\n    const path = whichFn(bin);\n    if (path) return { found: true, path };\n    return { found: false };\n  } catch {\n    return { found: false };\n  }\n}\n\nexport interface PatchResult {\n  /** Human-readable change log entries; empty array = no changes. */\n  patched: string[];\n}\n\nexport interface PatchOptions {\n  homeDir: string;\n}\n\nconst COPILOT_PROVIDER_DEFAULTS = {\n  name: \"copilot-api\",\n  base_url: \"http://localhost:4141/v1\",\n  wire_api: \"responses\",\n  env_key: \"COPILOT_API_KEY\",\n} as const;\n\n/**\n * Merge defaults into ~/.codex/config.toml.\n *\n * Two paths:\n *   - File absent → write a fresh stringified TOML with our defaults.\n *   - File exists → parse to detect missing keys, then APPEND missing\n *     fragments as raw text. We never re-stringify the parsed AST, because\n *     smol-toml's stringify drops comments and may reorder keys (verified\n *     by regression test). Appending preserves the user's original bytes.\n *\n * Never touches user-set model_provider / model / per-provider fields.\n */\nexport function patchCodexConfig(opts: PatchOptions): PatchResult {\n  const codexDir = join(opts.homeDir, \".codex\");\n  const cfgPath = join(codexDir, \"config.toml\");\n\n  // Fresh-write path.\n  if (!existsSync(cfgPath)) {\n    const fresh = {\n      model_provider: \"copilot-api\",\n      model_providers: { \"copilot-api\": COPILOT_PROVIDER_DEFAULTS },\n    };\n    mkdirSync(codexDir, { recursive: true });\n    writeFileSync(cfgPath, stringifyToml(fresh) + \"\\n\");\n    return { patched: [\"created ~/.codex/config.toml\"] };\n  }\n\n  // Existing-file path: parse-then-append-raw.\n  const originalText = readFileSync(cfgPath, \"utf-8\");\n  let cfg: Record<string, unknown>;\n  try {\n    cfg = parseToml(originalText) as Record<string, unknown>;\n  } catch {\n    return { patched: [\"~/.codex/config.toml could not be parsed; left untouched\"] };\n  }\n\n  // Type-guard model_providers: smol-toml will faithfully parse a wrong-typed\n  // `model_providers = \"string\"` as a string, and our previous .cast-and-poke\n  // approach would silently overwrite it. Bail loudly instead.\n  const mp = cfg.model_providers;\n  if (mp !== undefined && (typeof mp !== \"object\" || Array.isArray(mp))) {\n    return {\n      patched: [\"~/.codex/config.toml has model_providers that is not a table; left untouched\"],\n    };\n  }\n\n  const needsTopLevel = cfg.model_provider === undefined;\n  const providers = (mp ?? {}) as Record<string, unknown>;\n  const needsProvider = !providers[\"copilot-api\"];\n\n  if (!needsTopLevel && !needsProvider) {\n    return { patched: [] };\n  }\n\n  const fragments: string[] = [];\n  const patched: string[] = [];\n\n  if (needsTopLevel) {\n    // Top-level scalar key must precede any [section] header to remain\n    // top-level. The safest place to insert is at the very top of the file.\n    // We accumulate scalar additions and prepend them in a single splice.\n    fragments.push(`model_provider = \"copilot-api\"`);\n    patched.push(\"set model_provider=copilot-api\");\n  }\n\n  let updated = originalText;\n  if (fragments.length > 0) {\n    updated = fragments.join(\"\\n\") + \"\\n\\n\" + updated;\n  }\n\n  if (needsProvider) {\n    const sectionToml = stringifyToml({\n      model_providers: { \"copilot-api\": COPILOT_PROVIDER_DEFAULTS },\n    });\n    const sep = updated.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n    updated = updated + sep + sectionToml + \"\\n\";\n    patched.push(\"added [model_providers.copilot-api]\");\n  }\n\n  writeFileSync(cfgPath, updated);\n  return { patched };\n}\n\n/**\n * Ensure ~/.claude/settings.json exists.\n *\n * Currently a thin presence-check: claude-code's own config schema evolves\n * fast and we don't want to fight it. Just create an empty object if absent\n * so downstream tools can rely on the file's existence.\n */\nexport function patchClaudeConfig(opts: PatchOptions): PatchResult {\n  const claudeDir = join(opts.homeDir, \".claude\");\n  const cfgPath = join(claudeDir, \"settings.json\");\n  if (existsSync(cfgPath)) {\n    // Validate it parses; if not, surface but don't rewrite.\n    try {\n      JSON.parse(readFileSync(cfgPath, \"utf-8\"));\n      return { patched: [] };\n    } catch {\n      return { patched: [\"~/.claude/settings.json is not valid JSON; left untouched\"] };\n    }\n  }\n  mkdirSync(claudeDir, { recursive: true });\n  writeFileSync(cfgPath, \"{}\\n\");\n  return { patched: [\"created ~/.claude/settings.json\"] };\n}\n\nexport function detectEnvVar(name: string): boolean {\n  const v = process.env[name];\n  return typeof v === \"string\" && v.length > 0;\n}\n\nexport interface BootstrapOptions {\n  homeDir: string;\n  /** When true, prompt user before installing CLIs. */\n  interactive: boolean;\n  /** When false, never install (doctor mode). */\n  install: boolean;\n  whichFn?: (bin: string) => string;\n  installFn?: (cliName: \"claude\" | \"codex\") => Promise<void>;\n  promptFn?: (question: string) => Promise<string>;\n}\n\nexport interface BootstrapReport {\n  /** CLIs that were already installed. */\n  present: string[];\n  /** CLIs missing at start. */\n  missing: string[];\n  /** CLIs installed during this run. */\n  installed: string[];\n  /** Config patcher change logs (codex + claude). */\n  configChanges: string[];\n  /** Hint strings to print to user about env vars that need attention. */\n  envHints: string[];\n}\n\n/**\n * Default npm-based install. Kept here (not in detect.ts) so production\n * callers don't have to wire it; tests inject their own spy.\n *\n * Why npm and not brew/cargo/winget: we picked one source per CLI to keep\n * the matrix small. claude-code is npm-only anyway, and codex npm package\n * works on both macOS and Windows (our codex-adapter already handles the\n * Windows .cmd shim).\n */\nasync function defaultInstall(name: \"claude\" | \"codex\"): Promise<void> {\n  const pkg = name === \"claude\" ? \"@anthropic-ai/claude-code\" : \"@openai/codex\";\n  // Inherit stdio so the user sees npm's progress; init is interactive.\n  // execFileSync with explicit args — never interpolate the package name\n  // into a shell string even though it's hardcoded today.\n  execFileSync(\"npm\", [\"install\", \"-g\", pkg], { stdio: \"inherit\" });\n}\n\nexport async function bootstrapDeps(opts: BootstrapOptions): Promise<BootstrapReport> {\n  const installFn = opts.installFn ?? defaultInstall;\n  const promptFn = opts.promptFn ?? (async () => \"y\");\n\n  const report: BootstrapReport = {\n    present: [],\n    missing: [],\n    installed: [],\n    configChanges: [],\n    envHints: [],\n  };\n\n  // 1. Detect CLIs\n  const cliNames: Array<\"claude\" | \"codex\"> = [\"claude\", \"codex\"];\n  for (const name of cliNames) {\n    const r = detectCli(name, { whichFn: opts.whichFn });\n    if (r.found) report.present.push(name);\n    else report.missing.push(name);\n  }\n\n  // 2. Optionally install missing\n  if (opts.install && report.missing.length > 0) {\n    for (const name of report.missing as Array<\"claude\" | \"codex\">) {\n      let shouldInstall = true;\n      if (opts.interactive) {\n        const ans = (await promptFn(`Install ${name} CLI via npm? [Y/n]: `)).trim().toLowerCase();\n        // Default Y (empty input → yes); only explicit \"n\"/\"no\" skips.\n        shouldInstall = ans === \"\" || ans === \"y\" || ans === \"yes\";\n      }\n      if (shouldInstall) {\n        await installFn(name);\n        report.installed.push(name);\n      }\n    }\n  }\n\n  // 3. Patch configs (always — they're idempotent)\n  const codexR = patchCodexConfig({ homeDir: opts.homeDir });\n  report.configChanges.push(...codexR.patched);\n  const claudeR = patchClaudeConfig({ homeDir: opts.homeDir });\n  report.configChanges.push(...claudeR.patched);\n\n  // 4. Env hints (no dotfile mutation — print only)\n  if (!detectEnvVar(\"COPILOT_API_KEY\")) {\n    const shellHint = isWin\n      ? \"Set COPILOT_API_KEY in System → Environment Variables (any non-empty value, e.g. 'dummy')\"\n      : \"Add to ~/.zshrc (or ~/.bashrc): export COPILOT_API_KEY=dummy\";\n    report.envHints.push(\n      `COPILOT_API_KEY is not set. ${shellHint}. The copilot-api proxy does not validate the value, but codex requires the variable to exist.`,\n    );\n  }\n\n  return report;\n}\n"],"mappings":"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","names":[]}

package/dist/checkpoint.d.ts

@@ -9,7 +9,7 @@ export interface CheckpointEntry {
     sessionId: string;
     kind: SessionKind;
     workDir: string;
-    claudeSessionId?: string;
+    backendSessionId?: string;
     agentInstanceId?: string;
     startedAt: number;
     lastActivityAt: number;

package/dist/checkpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C"}
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C"}