@xopcai/xopc 0.0.84 → 0.0.85

package/dist/src/agent/workflow/subagent-runner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Adapter: spawns one isolated child agent per `agent()` call from a workflow.
+ *
+ * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays
+ * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).
+ *
+ * Key behaviour:
+ * - When `opts.schema` is provided, we inject `structured_output` into the child
+ *   tool set and unwrap the captured value on success. If the subagent finishes
+ *   without ever calling `structured_output`, we treat it as failure (`null`).
+ * - Failures and aborts resolve to `null`. The workflow runtime continues — this
+ *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.
+ * - We do NOT mutate `createDelegateChildHandle` — we just leverage its
+ *   `buildChildTools` injection point.
+ */
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { Api, Model } from '@earendil-works/pi-ai';
+import type { Config } from '../../config/schema.js';
+import type { MessageBus } from '../../infra/bus/index.js';
+import { type BuildChildToolsOptions } from '../child-agent-factory.js';
+import type { ToolExecutorConfig } from '../tools/executor.js';
+import type { SubagentRunOptions, SubagentRunner } from './types.js';
+export interface DelegateSubagentRunnerDeps {
+    workspace: string;
+    bus: MessageBus;
+    /** Resolves the default subagent model (typically the parent agent's primary model). */
+    getDefaultModel: () => Model<Api>;
+    getConfig: () => Config | undefined;
+    toolExecutorConfig?: Partial<ToolExecutorConfig>;
+    /**
+     * Provided by the workflow tool from `AgentToolsFactory` — mirrors how
+     * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and
+     * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory
+     * dependency contract).
+     */
+    buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];
+}
+export declare class DelegateSubagentRunner implements SubagentRunner {
+    private readonly deps;
+    constructor(deps: DelegateSubagentRunnerDeps);
+    run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null>;
+}

package/dist/src/agent/workflow/subagent-runner.js

@@ -0,0 +1,104 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { createDelegateChildHandle } from "../child-agent-factory.js";
+import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS } from "../tools/delegate-tool.js";
+import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
+//#region src/agent/workflow/subagent-runner.ts
+init_logger();
+const log = createLogger("workflow-subagent-runner");
+const DEFAULT_MAX_ITERATIONS = 30;
+var DelegateSubagentRunner = class {
+	constructor(deps) {
+		this.deps = deps;
+	}
+	async run(prompt, opts) {
+		if (opts.signal?.aborted) return null;
+		const capture = {
+			called: false,
+			value: void 0
+		};
+		const wantStructured = Boolean(opts.schema);
+		const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);
+		const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);
+		if (!model) {
+			log.warn({ label: opts.label }, "subagent run skipped: no primary model resolved");
+			return null;
+		}
+		const fullPrompt = buildPrompt(prompt, opts, wantStructured);
+		const handle = createDelegateChildHandle({
+			workspace: this.deps.workspace,
+			goal: fullPrompt,
+			allowedToolNames: allowed,
+			maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,
+			model,
+			bus: this.deps.bus,
+			getConfig: this.deps.getConfig,
+			toolExecutorConfig: this.deps.toolExecutorConfig,
+			buildChildTools: (childOpts) => {
+				const base = this.deps.buildChildTools(childOpts);
+				if (!wantStructured || !opts.schema) return base;
+				return [...base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME), createStructuredOutputTool({
+					schema: opts.schema,
+					capture
+				})];
+			}
+		});
+		const onAbort = () => handle.abort();
+		opts.signal?.addEventListener("abort", onAbort, { once: true });
+		try {
+			const { summary } = await handle.run();
+			if (opts.signal?.aborted) return null;
+			if (wantStructured) {
+				if (!capture.called) {
+					log.warn({ label: opts.label }, "subagent finished without calling structured_output");
+					return null;
+				}
+				return capture.value;
+			}
+			return summary;
+		} catch (e) {
+			if (opts.rethrow) throw e;
+			const msg = e instanceof Error ? e.message : String(e);
+			log.warn({
+				err: e,
+				label: opts.label,
+				errorMessage: msg
+			}, `subagent run failed: ${msg}`);
+			return null;
+		} finally {
+			opts.signal?.removeEventListener("abort", onAbort);
+		}
+	}
+};
+function resolveAllowedToolNames(requested, wantStructured) {
+	const filtered = (requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS]).map((s) => String(s).trim()).filter((s) => s.length > 0).filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));
+	if (wantStructured && !filtered.includes("structured_output")) filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);
+	return [...new Set(filtered)];
+}
+function buildPrompt(prompt, opts, structured) {
+	const parts = [];
+	if (opts.instructions?.trim()) parts.push(opts.instructions.trim());
+	if (opts.label) parts.push(`Task label: ${opts.label}`);
+	if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);
+	parts.push(prompt);
+	if (structured) parts.push([
+		"Final output contract:",
+		"- Your final action MUST be a structured_output tool call.",
+		"- The structured_output arguments are the return value of this subagent.",
+		"- Do not emit a prose final answer instead of structured_output.",
+		"- If you need to inspect files or run commands first, do so, then call structured_output exactly once."
+	].join("\n"));
+	return parts.join("\n\n");
+}
+function safeResolveDefaultModel(get) {
+	try {
+		return get();
+	} catch (e) {
+		log.warn({ err: e }, "failed to resolve default subagent model");
+		return null;
+	}
+}
+//#endregion
+export { DelegateSubagentRunner };
+
+//# sourceMappingURL=subagent-runner.js.map

package/dist/src/agent/workflow/subagent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner } from './types.js';\n\nconst log = createLogger('workflow-subagent-runner');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n    };\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary } = await handle.run();\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Shared types for the workflow runtime.
+ *
+ * The runtime depends only on `SubagentRunner` — the adapter that wraps the
+ * concrete child-agent factory lives in `subagent-runner.ts`. This keeps
+ * `runtime.ts` free of any LLM-stack imports and makes alternate runners
+ * (remote agents, test doubles) drop-in replacements.
+ */
+import type { Model, Api } from '@earendil-works/pi-ai';
+/** Plain JSON Schema (no TypeBox brand). Mirrors the shape models emit verbatim. */
+export interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema | JsonSchema[];
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface WorkflowMetaPhase {
+    title: string;
+    detail?: string;
+    model?: string;
+}
+export interface WorkflowMeta {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    phases?: WorkflowMetaPhase[];
+}
+export type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';
+export interface WorkflowAgentSnapshot {
+    id: number;
+    label: string;
+    phase?: string;
+    prompt: string;
+    status: WorkflowAgentStatus;
+    resultPreview?: string;
+    error?: string;
+}
+export interface WorkflowSnapshot {
+    name: string;
+    description?: string;
+    phases: string[];
+    currentPhase?: string;
+    logs: string[];
+    agents: WorkflowAgentSnapshot[];
+    agentCount: number;
+    runningCount: number;
+    doneCount: number;
+    errorCount: number;
+    skippedCount: number;
+    durationMs?: number;
+    result?: unknown;
+}
+export interface SubagentRunOptions<T = unknown> {
+    label: string;
+    /** When set, the subagent must return a value matching the schema (validated via ajv). */
+    schema?: JsonSchema;
+    /** Per-agent overrides; defaults filled by the runner adapter. */
+    allowedToolNames?: string[];
+    maxIterations?: number;
+    /** Resolved model. When omitted the adapter falls back to the workflow-level default. */
+    model?: Model<Api>;
+    signal?: AbortSignal;
+    /** Extra guidance prepended to the subagent prompt. */
+    instructions?: string;
+    /** When false (default), failures resolve to `null`; when true, errors propagate. */
+    rethrow?: boolean;
+    /** Hint about which phase this agent belongs to (passed through for logging). */
+    phase?: string;
+    /** Pre-bound capture for structured output (internal: created by the adapter when schema present). */
+    __capture?: {
+        called: boolean;
+        value?: T;
+    };
+}
+/**
+ * Spawns a single fresh subagent and returns its result.
+ *
+ * - Without `schema`: returns the final assistant text (`string`).
+ * - With `schema`: returns the value the subagent passed to the injected
+ *   `structured_output` tool (validated, typed as `T`).
+ *
+ * Returns `null` when the subagent fails or aborts — runtime keeps going.
+ */
+export interface SubagentRunner {
+    run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null>;
+}
+/** Options accepted by `agent()` inside a workflow script. */
+export interface AgentScriptOptions {
+    label?: string;
+    phase?: string;
+    schema?: JsonSchema;
+    /** Model id; currently passed as text guidance, runner may resolve in future. */
+    model?: string;
+    /** Subagent tool allowlist override (forwarded to the runner). */
+    toolset?: string[];
+    /** Max tool iterations inside the subagent. */
+    maxIterations?: number;
+}
+export interface WorkflowRunOptions {
+    args?: unknown;
+    cwd: string;
+    signal?: AbortSignal;
+    /** Hard upper bound on concurrent subagents (default min(16, cpu-2)). */
+    concurrency?: number;
+    /** Total token budget exposed to script via `budget`. `null` = unlimited. */
+    tokenBudget?: number | null;
+    /** Hard cap on total subagent count for one workflow run (default 1000). */
+    maxSubagents?: number;
+    onLog?: (message: string) => void;
+    onPhase?: (title: string) => void;
+    onAgentStart?: (event: {
+        id: number;
+        label: string;
+        phase?: string;
+        prompt: string;
+    }) => void;
+    onAgentEnd?: (event: {
+        id: number;
+        label: string;
+        phase?: string;
+        result: unknown;
+        status: WorkflowAgentStatus;
+    }) => void;
+}
+export interface WorkflowRunResult<T = unknown> {
+    meta: WorkflowMeta;
+    result: T;
+    logs: string[];
+    phases: string[];
+    agentCount: number;
+    durationMs: number;
+}

package/dist/src/agent/workflow/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/auth/credentials.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
-import { mkdir, readFile } from "fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { dirname, join } from "path";
+import { mkdir, readFile } from "fs/promises";
 //#region src/auth/credentials.ts
 function getCredentialResolver(options) {
 	return new CredentialResolver(options);

package/dist/src/auth/profiles/store.js

@@ -1,6 +1,6 @@
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { homedir } from "os";
 //#region src/auth/profiles/store.ts
 /**

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/browser/cache-dir-policy.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { isAbsolute, relative, resolve, sep } from "node:path";
 import { homedir } from "node:os";
+import { isAbsolute, relative, resolve, sep } from "node:path";
 //#region src/browser/cache-dir-policy.ts
 function expandHome(input) {
 	if (input === "~") return homedir();

package/dist/src/browser/cdp-local-launcher.js

@@ -2,10 +2,10 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 import { pickFreePort } from "./free-port.js";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
-import { join } from "node:path";
-import { homedir, platform } from "node:os";
 import { spawn } from "node:child_process";
 //#region src/browser/cdp-local-launcher.ts
 /**

package/dist/src/browser/providers/browser-ext-install.js

@@ -1,15 +1,15 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
-import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { resolvePackageRoot } from "../../infra/update-check.js";
+import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { readFile, readdir, rm } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/{version}/.

package/dist/src/browser/providers/cloakbrowser.js

@@ -1,15 +1,15 @@
+import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
-import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
 import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildStealthArgs, filterCloakBrowserExtraArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "../stealth.js";
 import { pickFreePort } from "../free-port.js";
-import { createHash } from "node:crypto";
+import { arch, platform, tmpdir } from "node:os";
+import { join, resolve } from "node:path";
 import { createReadStream, createWriteStream } from "node:fs";
+import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, readdir, rename, rm, stat } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import { arch, platform, tmpdir } from "node:os";
 import { spawn } from "node:child_process";
 import { Readable, Transform } from "node:stream";
 import AdmZip from "adm-zip";

package/dist/src/browser/providers/playwright-doctor.js

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
 import { existsSync } from "node:fs";
 import { stat } from "node:fs/promises";
-import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/browser/providers/playwright-doctor.ts
 /** Root directory of the `playwright-core` package (Electron extraResources or node_modules). */

package/dist/src/browser/stealth.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { chmod, stat } from "node:fs/promises";
 import { platform } from "node:os";
+import { chmod, stat } from "node:fs/promises";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
 //#region src/browser/stealth.ts

package/dist/src/channels/attachments/inbound-persist.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { mkdir, writeFile } from "fs/promises";
 import { join, resolve } from "path";
+import { mkdir, writeFile } from "fs/promises";
 import { randomBytes } from "crypto";
 //#region src/channels/attachments/inbound-persist.ts
 /**

package/dist/src/channels/attachments/outbound-tts-persist.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { mkdir, writeFile } from "fs/promises";
 import { join, resolve } from "path";
+import { mkdir, writeFile } from "fs/promises";
 import { randomBytes } from "crypto";
 //#region src/channels/attachments/outbound-tts-persist.ts
 /**

package/dist/src/channels/outbound/persist-store.js

@@ -1,7 +1,7 @@
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import { randomUUID } from "node:crypto";
 import { join } from "path";
 import { existsSync, mkdirSync, readFileSync } from "fs";
+import { randomUUID } from "node:crypto";
 //#region src/channels/outbound/persist-store.ts
 /**
 * Durable outbound queue (crash recovery): JSON file under agent internal dir.

package/dist/src/channels/pairing/allow-from-file.js

@@ -1,5 +1,5 @@
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
 //#region src/channels/pairing/allow-from-file.ts
 function readAllowFromFile(filePath) {
 	try {

package/dist/src/channels/pairing/pairing-store.js

@@ -1,8 +1,8 @@
 import { appendAllowFromIdSync } from "./allow-from-file.js";
 import "./pairing-constants.js";
-import crypto from "node:crypto";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
+import crypto from "node:crypto";
 //#region src/channels/pairing/pairing-store.ts
 const PAIRING_CODE_LENGTH = 8;
 const PAIRING_CODE_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";

package/dist/src/chat-commands/builtins/config.js

@@ -1,9 +1,9 @@
+import { ConfigSchema, init_schema } from "../../config/schema.js";
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveConfigPath } from "../../config/paths.js";
-import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { commandRegistry } from "../registry.js";
 import { resolveAllowlistMatchSimple } from "../../channels/security.js";
 import { parseConfigValue } from "../config-value.js";

package/dist/src/chat-commands/builtins/model.js

@@ -1,4 +1,5 @@
 import { commandRegistry } from "../registry.js";
+import { bulletList, code, hint, joinBlocks, kvList, section } from "../format-output.js";
 //#region src/chat-commands/builtins/model.ts
 const modelsCommand = {
 	id: "model.list",
@@ -24,19 +25,13 @@ const modelsCommand = {
 			if (!byProvider.has(m.provider)) byProvider.set(m.provider, []);
 			byProvider.get(m.provider).push(m);
 		}
-		/** `m.id` from listModels is always `serviceId/modelId` (canonical `/switch` ref). */
-		const lines = ["🤖 Available models (use the `provider/model` ref with `/switch`):\n"];
-		for (const [provider, providerModels] of byProvider) {
-			lines.push(`**${provider}**`);
-			for (const m of providerModels.slice(0, 5)) {
-				const indicator = m.id === currentModel ? "▶️" : "  ";
-				lines.push(`${indicator} ${m.name} — \`${m.id}\``);
-			}
-			if (providerModels.length > 5) lines.push(`   … and ${providerModels.length - 5} more in this provider`);
-			lines.push("");
-		}
-		lines.push("_Copy the ref in backticks after each name, then: `/switch provider/model-id`._");
-		const content = lines.join("\n");
+		const content = joinBlocks("🤖 Available models (use the `provider/model` ref with `/switch`):", ...Array.from(byProvider.entries()).map(([provider, providerModels]) => {
+			const items = providerModels.slice(0, 5).map((m) => {
+				return `${m.id === currentModel ? "▶️ " : ""}**${m.name}** — ${code(m.id)}`;
+			});
+			if (providerModels.length > 5) items.push(hint(`… and ${providerModels.length - 5} more in this provider`));
+			return joinBlocks(section(provider), bulletList(items));
+		}), hint("Copy the ref in backticks after each name, then: `/switch provider/model-id`."));
 		if (ctx.supports("buttons")) return {
 			content,
 			success: true,
@@ -74,17 +69,20 @@ const switchCommand = {
 	examples: ["/switch openai/gpt-4o", "/switch minimax/minimax-m2.1"],
 	handler: async (ctx, args) => {
 		if (!args.trim()) return {
-			content: "❌ Missing model ref.\n\n**Usage:** `/switch provider/model-id`\n\nRun `/models` — each line shows a display name and a `provider/model` ref in backticks. Copy that ref.\n\n**Example:** `/switch openai/gpt-4o`",
+			content: joinBlocks("❌ Missing model ref.", "**Usage:** `/switch provider/model-id`", "Run `/models` — each line shows a display name and a `provider/model` ref in backticks. Copy that ref.", "**Example:** `/switch openai/gpt-4o`"),
 			success: false
 		};
 		await ctx.setTyping(true);
 		const modelId = args.trim();
-		if (await ctx.switchModel(modelId)) return {
-			content: `✅ Switched to *\`${modelId}\`* (${modelId.split("/").pop() || modelId}).\n\nThis model will be used for your next message.`,
-			success: true
-		};
-		else return {
-			content: `❌ Could not switch to \`${modelId}\`.\n\nUse the exact \`provider/model\` ref from \`/models\` (not only the display name). **Example:** \`/switch anthropic/claude-sonnet-4-20250514\``,
+		if (await ctx.switchModel(modelId)) {
+			const modelName = modelId.split("/").pop() || modelId;
+			return {
+				content: joinBlocks(`✅ Switched to ${code(modelId)} (${modelName}).`, "This model will be used for your next message."),
+				success: true
+			};
+		}
+		return {
+			content: joinBlocks(`❌ Could not switch to ${code(modelId)}.`, "Use the exact `provider/model` ref from `/models` (not only the display name).", "**Example:** `/switch anthropic/claude-sonnet-4-20250514`"),
 			success: false
 		};
 	}
@@ -103,9 +101,28 @@ const usageCommand = {
 		await ctx.setTyping(true);
 		const stats = await ctx.getUsage();
 		const modelName = ctx.getCurrentModel().split("/").pop() || "Unknown";
-		const content = `📊 *Session Token Usage*
-
-🤖 Model: ${modelName}\n📥 Prompt: ${stats.promptTokens.toLocaleString()} tokens\n📤 Completion: ${stats.completionTokens.toLocaleString()} tokens\n📊 Total: ${stats.totalTokens.toLocaleString()} tokens\n💬 Messages: ${stats.messageCount}`;
+		const content = joinBlocks(section("📊 Session Token Usage"), kvList([
+			{
+				key: "Model",
+				value: modelName
+			},
+			{
+				key: "Prompt",
+				value: `${stats.promptTokens.toLocaleString()} tokens`
+			},
+			{
+				key: "Completion",
+				value: `${stats.completionTokens.toLocaleString()} tokens`
+			},
+			{
+				key: "Total",
+				value: `${stats.totalTokens.toLocaleString()} tokens`
+			},
+			{
+				key: "Messages",
+				value: String(stats.messageCount)
+			}
+		]));
 		if (ctx.supports("buttons")) return {
 			content,
 			success: true,

package/dist/src/chat-commands/builtins/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":[],"sources":["../../../../src/chat-commands/builtins/model.ts"],"sourcesContent":["/**\n * Model Commands\n * \n * Built-in commands for model management:\n * - /models - List models with display names and `provider/model` refs for /switch\n * - /switch - Switch model using the ref from /models\n * - /usage - Show token usage statistics\n */\n\nimport type { CommandDefinition, CommandContext, UIComponent } from '../types.js';\nimport { commandRegistry } from '../registry.js';\n\nconst modelsCommand: CommandDefinition = {\n  id: 'model.list',\n  name: 'models',\n  aliases: ['model'],\n  description: 'List models with display names and `provider/model` refs for /switch',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    const models = await ctx.listModels();\n    const currentModel = ctx.getCurrentModel();\n    \n    if (models.length === 0) {\n      return {\n        content: '🤖 No models available. Please check your configuration.',\n        success: true,\n      };\n    }\n    \n    // Group by provider\n    const byProvider = new Map<string, typeof models>();\n    for (const m of models) {\n      if (!byProvider.has(m.provider)) {\n        byProvider.set(m.provider, []);\n      }\n      byProvider.get(m.provider)!.push(m);\n    }\n    \n    /** `m.id` from listModels is always `serviceId/modelId` (canonical `/switch` ref). */\n    const lines: string[] = [\n      '🤖 Available models (use the `provider/model` ref with `/switch`):\\n',\n    ];\n\n    for (const [provider, providerModels] of byProvider) {\n      lines.push(`**${provider}**`);\n      for (const m of providerModels.slice(0, 5)) {\n        const indicator = m.id === currentModel ? '▶️' : '  ';\n        lines.push(`${indicator} ${m.name} — \\`${m.id}\\``);\n      }\n      if (providerModels.length > 5) {\n        lines.push(`   … and ${providerModels.length - 5} more in this provider`);\n      }\n      lines.push('');\n    }\n\n    lines.push('_Copy the ref in backticks after each name, then: `/switch provider/model-id`._');\n    const content = lines.join('\\n');\n    \n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'model-picker',\n        providers: Array.from(byProvider.entries()).map(([id, models]) => ({\n          id,\n          name: id,\n          models: models.map(m => ({\n            id: m.id,\n            name: m.name,\n            provider: m.provider,\n          })),\n        })),\n        currentModel,\n      };\n      \n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n    \n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst switchCommand: CommandDefinition = {\n  id: 'model.switch',\n  name: 'switch',\n  description: 'Switch model — pass the `provider/model` ref shown by /models',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/switch openai/gpt-4o', '/switch minimax/minimax-m2.1'],\n  handler: async (ctx: CommandContext, args: string) => {\n    if (!args.trim()) {\n      return {\n        content:\n          '❌ Missing model ref.\\n\\n' +\n          '**Usage:** `/switch provider/model-id`\\n\\n' +\n          'Run `/models` — each line shows a display name and a `provider/model` ref in backticks. Copy that ref.\\n\\n' +\n          '**Example:** `/switch openai/gpt-4o`',\n        success: false,\n      };\n    }\n    \n    await ctx.setTyping(true);\n    \n    const modelId = args.trim();\n    const success = await ctx.switchModel(modelId);\n    \n    if (success) {\n      const modelName = modelId.split('/').pop() || modelId;\n      return {\n        content:\n          `✅ Switched to *\\`${modelId}\\`* (${modelName}).\\n\\n` +\n          'This model will be used for your next message.',\n        success: true,\n      };\n    } else {\n      return {\n        content:\n          `❌ Could not switch to \\`${modelId}\\`.\\n\\n` +\n          'Use the exact `provider/model` ref from `/models` (not only the display name). ' +\n          '**Example:** `/switch anthropic/claude-sonnet-4-20250514`',\n        success: false,\n      };\n    }\n  },\n};\n\nconst usageCommand: CommandDefinition = {\n  id: 'model.usage',\n  name: 'usage',\n  description: 'Show token usage statistics for current session',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    const stats = await ctx.getUsage();\n    const modelName = ctx.getCurrentModel().split('/').pop() || 'Unknown';\n    \n    const content = \n      '📊 *Session Token Usage*\\n\\n' +\n      `🤖 Model: ${modelName}\\n` +\n      `📥 Prompt: ${stats.promptTokens.toLocaleString()} tokens\\n` +\n      `📤 Completion: ${stats.completionTokens.toLocaleString()} tokens\\n` +\n      `📊 Total: ${stats.totalTokens.toLocaleString()} tokens\\n` +\n      `💬 Messages: ${stats.messageCount}`;\n    \n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'usage-display',\n        stats,\n        modelName,\n      };\n      \n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n    \n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\n// Register all model commands\nexport function registerModelCommands(): void {\n  commandRegistry.register(modelsCommand);\n  commandRegistry.register(switchCommand);\n  commandRegistry.register(usageCommand);\n}\n"],"mappings":"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"}
+{"version":3,"file":"model.js","names":[],"sources":["../../../../src/chat-commands/builtins/model.ts"],"sourcesContent":["/**\n * Model Commands\n *\n * Built-in commands for model management:\n * - /models - List models with display names and `provider/model` refs for /switch\n * - /switch - Switch model using the ref from /models\n * - /usage - Show token usage statistics\n */\n\nimport type { CommandDefinition, CommandContext, UIComponent } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { bulletList, code, hint, joinBlocks, kvList, section } from '../format-output.js';\n\nconst modelsCommand: CommandDefinition = {\n  id: 'model.list',\n  name: 'models',\n  aliases: ['model'],\n  description: 'List models with display names and `provider/model` refs for /switch',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n\n    const models = await ctx.listModels();\n    const currentModel = ctx.getCurrentModel();\n\n    if (models.length === 0) {\n      return {\n        content: '🤖 No models available. Please check your configuration.',\n        success: true,\n      };\n    }\n\n    // Group by provider\n    const byProvider = new Map<string, typeof models>();\n    for (const m of models) {\n      if (!byProvider.has(m.provider)) {\n        byProvider.set(m.provider, []);\n      }\n      byProvider.get(m.provider)!.push(m);\n    }\n\n    /** `m.id` from listModels is always `serviceId/modelId` (canonical `/switch` ref). */\n    const providerBlocks = Array.from(byProvider.entries()).map(([provider, providerModels]) => {\n      const items = providerModels.slice(0, 5).map((m) => {\n        const marker = m.id === currentModel ? '▶️ ' : '';\n        return `${marker}**${m.name}** — ${code(m.id)}`;\n      });\n      if (providerModels.length > 5) {\n        items.push(hint(`… and ${providerModels.length - 5} more in this provider`));\n      }\n      return joinBlocks(section(provider), bulletList(items));\n    });\n\n    const content = joinBlocks(\n      '🤖 Available models (use the `provider/model` ref with `/switch`):',\n      ...providerBlocks,\n      hint('Copy the ref in backticks after each name, then: `/switch provider/model-id`.'),\n    );\n\n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'model-picker',\n        providers: Array.from(byProvider.entries()).map(([id, models]) => ({\n          id,\n          name: id,\n          models: models.map((m) => ({\n            id: m.id,\n            name: m.name,\n            provider: m.provider,\n          })),\n        })),\n        currentModel,\n      };\n\n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst switchCommand: CommandDefinition = {\n  id: 'model.switch',\n  name: 'switch',\n  description: 'Switch model — pass the `provider/model` ref shown by /models',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/switch openai/gpt-4o', '/switch minimax/minimax-m2.1'],\n  handler: async (ctx: CommandContext, args: string) => {\n    if (!args.trim()) {\n      return {\n        content: joinBlocks(\n          '❌ Missing model ref.',\n          '**Usage:** `/switch provider/model-id`',\n          'Run `/models` — each line shows a display name and a `provider/model` ref in backticks. Copy that ref.',\n          '**Example:** `/switch openai/gpt-4o`',\n        ),\n        success: false,\n      };\n    }\n\n    await ctx.setTyping(true);\n\n    const modelId = args.trim();\n    const success = await ctx.switchModel(modelId);\n\n    if (success) {\n      const modelName = modelId.split('/').pop() || modelId;\n      return {\n        content: joinBlocks(\n          `✅ Switched to ${code(modelId)} (${modelName}).`,\n          'This model will be used for your next message.',\n        ),\n        success: true,\n      };\n    }\n\n    return {\n      content: joinBlocks(\n        `❌ Could not switch to ${code(modelId)}.`,\n        'Use the exact `provider/model` ref from `/models` (not only the display name).',\n        '**Example:** `/switch anthropic/claude-sonnet-4-20250514`',\n      ),\n      success: false,\n    };\n  },\n};\n\nconst usageCommand: CommandDefinition = {\n  id: 'model.usage',\n  name: 'usage',\n  description: 'Show token usage statistics for current session',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n\n    const stats = await ctx.getUsage();\n    const modelName = ctx.getCurrentModel().split('/').pop() || 'Unknown';\n\n    const content = joinBlocks(\n      section('📊 Session Token Usage'),\n      kvList([\n        { key: 'Model', value: modelName },\n        { key: 'Prompt', value: `${stats.promptTokens.toLocaleString()} tokens` },\n        { key: 'Completion', value: `${stats.completionTokens.toLocaleString()} tokens` },\n        { key: 'Total', value: `${stats.totalTokens.toLocaleString()} tokens` },\n        { key: 'Messages', value: String(stats.messageCount) },\n      ]),\n    );\n\n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'usage-display',\n        stats,\n        modelName,\n      };\n\n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\n// Register all model commands\nexport function registerModelCommands(): void {\n  commandRegistry.register(modelsCommand);\n  commandRegistry.register(switchCommand);\n  commandRegistry.register(usageCommand);\n}\n"],"mappings":"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"}