@autonav/core 1.6.0 → 1.7.0

package/dist/harness/chibi-plugins/update_plugin_config

@@ -0,0 +1,91 @@
+#!/bin/bash
+# update_plugin_config chibi plugin
+#
+# Reads plugins.json, merges updates into a plugin's config section,
+# and writes back. Requires AUTONAV_PLUGINS_PATH and jq.
+
+set -euo pipefail
+
+if [[ "${1:-}" == "--schema" ]]; then
+  printf '%s\n' '{' \
+    '  "name": "update_plugin_config",' \
+    '  "description": "Update your own plugin configuration. Use this to schedule check-ins, change notification settings, enable/disable plugins, update channel preferences, or modify any plugin behavior.",' \
+    '  "parameters": {' \
+    '    "type": "object",' \
+    '    "properties": {' \
+    '      "plugin": {' \
+    '        "type": "string",' \
+    '        "enum": ["slack", "signal", "github", "email"],' \
+    '        "description": "The plugin to configure"' \
+    '      },' \
+    '      "updates": {' \
+    '        "type": "object",' \
+    '        "description": "Config key-value pairs to merge into the plugin'\''s config section"' \
+    '      },' \
+    '      "reason": {' \
+    '        "type": "string",' \
+    '        "description": "Brief explanation of why you'\''re making this change"' \
+    '      }' \
+    '    },' \
+    '    "required": ["plugin", "updates", "reason"]' \
+    '  }' \
+    '}'
+  exit 0
+fi
+
+# jq is required for this plugin (merge logic)
+if ! command -v jq &>/dev/null; then
+  echo '{"success": false, "error": "jq is required for update_plugin_config but was not found on PATH."}'
+  exit 0
+fi
+
+# Read JSON args from stdin
+input=$(cat)
+plugin=$(echo "$input" | jq -r '.plugin // empty')
+updates=$(echo "$input" | jq '.updates // empty')
+reason=$(echo "$input" | jq -r '.reason // empty')
+
+if [[ -z "$plugin" || "$updates" == "empty" || "$updates" == "" || -z "$reason" ]]; then
+  echo '{"success": false, "error": "Missing required fields: plugin, updates, and reason"}'
+  exit 0
+fi
+
+# Validate plugin name
+case "$plugin" in
+  slack|signal|github|email) ;;
+  *)
+    jq -n --arg p "$plugin" \
+      '{"success": false, "error": ("Unknown plugin: " + $p + ". Valid: slack, signal, github, email")}'
+    exit 0
+    ;;
+esac
+
+# Check env var
+config_path="${AUTONAV_PLUGINS_PATH:-}"
+if [[ -z "$config_path" ]]; then
+  echo '{"success": false, "error": "AUTONAV_PLUGINS_PATH not set. Plugin configuration unavailable."}'
+  exit 0
+fi
+
+if [[ ! -f "$config_path" ]]; then
+  echo '{"success": false, "error": "Plugin configuration file not found."}'
+  exit 0
+fi
+
+# Read current config
+current=$(cat "$config_path")
+
+# Merge updates into the plugin's config section
+# If the plugin section doesn't exist, create it with enabled: false
+updated=$(echo "$current" | jq --arg p "$plugin" --argjson u "$updates" '
+  if .[$p] == null then
+    .[$p] = {"enabled": false, "config": {}}
+  else . end
+  | .[$p].config = (.[$p].config // {} | . * $u)
+')
+
+# Write back
+echo "$updated" > "$config_path"
+
+jq -n --arg p "$plugin" --arg r "$reason" --argjson u "$updates" \
+  '{"success": true, "plugin": $p, "message": ("Updated " + $p + " config: " + $r), "changes": $u}'

package/dist/harness/claude-code-harness.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code SDK Harness
+ *
+ * Adapts the Claude Agent SDK into the universal Harness interface.
+ * This is a near-passthrough — most AgentConfig fields map directly
+ * to SDK options. The main job is flattening SDK messages into AgentEvent.
+ */
+import type { Harness, HarnessSession, AgentConfig } from "./types.js";
+import type { ToolDefinition } from "./tool-server.js";
+/**
+ * Claude Code SDK Harness
+ *
+ * Creates HarnessSessions that delegate to the Claude Agent SDK's query() function.
+ * This is the default harness — it's a thin adapter since AgentConfig maps almost
+ * directly to SDK options.
+ */
+export declare class ClaudeCodeHarness implements Harness {
+    readonly displayName = "Claude";
+    run(config: AgentConfig, prompt: string): HarnessSession;
+    createToolServer(name: string, tools: ToolDefinition[]): {
+        server: unknown;
+    };
+}
+//# sourceMappingURL=claude-code-harness.d.ts.map

package/dist/harness/claude-code-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-harness.d.ts","sourceRoot":"","sources":["../../src/harness/claude-code-harness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAyNvD;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,WAAW,YAAY;IAEhC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAIxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE;CAW7E"}

package/dist/harness/claude-code-harness.js

@@ -0,0 +1,242 @@
+/**
+ * Claude Code SDK Harness
+ *
+ * Adapts the Claude Agent SDK into the universal Harness interface.
+ * This is a near-passthrough — most AgentConfig fields map directly
+ * to SDK options. The main job is flattening SDK messages into AgentEvent.
+ */
+import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
+/**
+ * Flatten an SDK message into zero or more AgentEvents.
+ *
+ * SDK messages are rich and nested. We extract the parts that matter
+ * for harness consumers (text, tool_use, tool_result, errors, result).
+ */
+function flattenMessage(message) {
+    const events = [];
+    if (message.type === "assistant") {
+        // Check for rate limit error on the message
+        if (message.error === "rate_limit") {
+            events.push({
+                type: "error",
+                message: "Rate limit reached",
+                retryable: true,
+            });
+        }
+        // Extract content blocks
+        for (const block of message.message.content) {
+            if (block.type === "text") {
+                events.push({ type: "text", text: block.text });
+            }
+            else if (block.type === "tool_use") {
+                events.push({
+                    type: "tool_use",
+                    name: block.name,
+                    id: block.id,
+                    input: block.input || {},
+                });
+            }
+        }
+    }
+    else if (message.type === "user") {
+        // Extract tool results from user messages
+        const msg = message;
+        if (msg.tool_use_result !== undefined) {
+            const result = msg.tool_use_result;
+            // Simple text result
+            if (typeof result === "string") {
+                events.push({
+                    type: "tool_result",
+                    toolUseId: "",
+                    content: result,
+                    isError: /^(Error:|error:)/i.test(result),
+                });
+            }
+            else if (result && typeof result === "object") {
+                const r = result;
+                events.push({
+                    type: "tool_result",
+                    toolUseId: "",
+                    content: typeof r.content === "string" ? r.content : JSON.stringify(r),
+                    isError: r.isError === true,
+                });
+            }
+        }
+    }
+    else if (message.type === "result") {
+        const resultMsg = message;
+        if (resultMsg.subtype === "success") {
+            events.push({
+                type: "result",
+                success: true,
+                text: resultMsg.result,
+                usage: {
+                    inputTokens: resultMsg.usage.input_tokens,
+                    outputTokens: resultMsg.usage.output_tokens,
+                },
+                costUsd: resultMsg.total_cost_usd,
+                durationMs: resultMsg.duration_ms,
+                durationApiMs: resultMsg.duration_api_ms,
+                numTurns: resultMsg.num_turns,
+                sessionId: resultMsg.session_id,
+            });
+        }
+        else {
+            const errors = "errors" in resultMsg ? resultMsg.errors : [];
+            events.push({
+                type: "result",
+                success: false,
+                text: errors.join("; "),
+                usage: {
+                    inputTokens: resultMsg.usage.input_tokens,
+                    outputTokens: resultMsg.usage.output_tokens,
+                },
+                costUsd: resultMsg.total_cost_usd,
+                durationMs: resultMsg.duration_ms,
+                durationApiMs: resultMsg.duration_api_ms,
+                numTurns: resultMsg.num_turns,
+                sessionId: resultMsg.session_id,
+            });
+        }
+    }
+    return events;
+}
+/**
+ * Map AgentConfig to Claude Code SDK Options
+ */
+function configToSdkOptions(config) {
+    const options = {};
+    if (config.model)
+        options.model = config.model;
+    if (config.systemPrompt)
+        options.systemPrompt = config.systemPrompt;
+    if (config.cwd)
+        options.cwd = config.cwd;
+    if (config.additionalDirectories)
+        options.additionalDirectories = config.additionalDirectories;
+    if (config.maxTurns !== undefined)
+        options.maxTurns = config.maxTurns;
+    if (config.maxBudgetUsd !== undefined)
+        options.maxBudgetUsd = config.maxBudgetUsd;
+    if (config.allowedTools)
+        options.allowedTools = config.allowedTools;
+    if (config.disallowedTools)
+        options.disallowedTools = config.disallowedTools;
+    if (config.mcpServers)
+        options.mcpServers = config.mcpServers;
+    if (config.permissionMode)
+        options.permissionMode = config.permissionMode;
+    if (config.stderr)
+        options.stderr = config.stderr;
+    // Translate AgentConfig.sandbox to SDK SandboxSettings.
+    // ChibiHarness translates to nono; ClaudeCodeHarness translates to SDK sandbox.
+    // The SDK sandbox uses Seatbelt (macOS) / bubblewrap (Linux) and restricts
+    // writes to cwd by default. When AgentConfig.sandbox is not set (e.g., memento
+    // default), no sandbox options are passed — YOLO mode.
+    if (config.sandbox) {
+        options.sandbox = {
+            enabled: true,
+            autoAllowBashIfSandboxed: true,
+            allowUnsandboxedCommands: false,
+        };
+    }
+    return options;
+}
+/**
+ * Claude Code SDK harness session.
+ *
+ * For initial prompt: iterates over the SDK Query's async generator.
+ * For multi-turn (send): builds conversation context from prior messages
+ * and starts a new query with accumulated history.
+ */
+class ClaudeCodeSession {
+    config;
+    queryInstance;
+    conversationHistory = [];
+    closed = false;
+    constructor(config, initialPrompt) {
+        this.config = { ...config };
+        this.conversationHistory.push(`User: ${initialPrompt}`);
+        this.queryInstance = query({
+            prompt: initialPrompt,
+            options: configToSdkOptions(this.config),
+        });
+    }
+    async *[Symbol.asyncIterator]() {
+        let lastAssistantText = "";
+        for await (const message of this.queryInstance) {
+            const events = flattenMessage(message);
+            for (const event of events) {
+                if (event.type === "text") {
+                    lastAssistantText = event.text;
+                }
+                yield event;
+            }
+        }
+        // Record assistant response for multi-turn context
+        if (lastAssistantText) {
+            this.conversationHistory.push(`Assistant: ${lastAssistantText}`);
+        }
+    }
+    send(prompt) {
+        if (this.closed) {
+            throw new Error("Session is closed");
+        }
+        this.conversationHistory.push(`User: ${prompt}`);
+        // Build the full conversation as a single prompt
+        // (same pattern as App.tsx conversation history)
+        const fullPrompt = this.conversationHistory.join("\n\n");
+        this.queryInstance = query({
+            prompt: fullPrompt,
+            options: configToSdkOptions(this.config),
+        });
+        // Return a new async iterable that tracks the response
+        const session = this;
+        return {
+            async *[Symbol.asyncIterator]() {
+                let lastText = "";
+                for await (const message of session.queryInstance) {
+                    const events = flattenMessage(message);
+                    for (const event of events) {
+                        if (event.type === "text") {
+                            lastText = event.text;
+                        }
+                        yield event;
+                    }
+                }
+                if (lastText) {
+                    session.conversationHistory.push(`Assistant: ${lastText}`);
+                }
+            },
+        };
+    }
+    updateConfig(config) {
+        Object.assign(this.config, config);
+    }
+    async close() {
+        this.closed = true;
+    }
+}
+/**
+ * Claude Code SDK Harness
+ *
+ * Creates HarnessSessions that delegate to the Claude Agent SDK's query() function.
+ * This is the default harness — it's a thin adapter since AgentConfig maps almost
+ * directly to SDK options.
+ */
+export class ClaudeCodeHarness {
+    displayName = "Claude";
+    run(config, prompt) {
+        return new ClaudeCodeSession(config, prompt);
+    }
+    createToolServer(name, tools) {
+        const sdkTools = tools.map((td) => tool(td.name, td.description, td.inputSchema, td.handler));
+        const server = createSdkMcpServer({
+            name,
+            version: "1.0.0",
+            tools: sdkTools,
+        });
+        return { server };
+    }
+}
+//# sourceMappingURL=claude-code-harness.js.map

package/dist/harness/claude-code-harness.js.map

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

package/dist/harness/ephemeral-home.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Ephemeral Home
+ *
+ * Creates temporary home directories for harness sessions. Each harness
+ * (chibi, opencode, etc.) can use this to inject custom plugins/tools
+ * into the agent's environment without polluting global config.
+ *
+ * Base location priority:
+ *   1. AUTONAV_<HARNESS>_HOME env var (e.g. AUTONAV_CHIBI_HOME)
+ *   2. os.tmpdir()
+ */
+export interface EphemeralHomeOptions {
+    /** Harness name used for dir prefix and env var lookup (e.g. "chibi", "opencode") */
+    harness: string;
+    /** Callback to populate the home directory after creation */
+    setup: (homePath: string) => void;
+}
+export interface EphemeralHome {
+    /** Absolute path to the ephemeral home directory */
+    homePath: string;
+    /** Remove the ephemeral home directory and all contents */
+    cleanup: () => void;
+}
+/**
+ * Create an ephemeral home directory for a harness session.
+ *
+ * The directory is created under:
+ *   - $AUTONAV_<HARNESS>_HOME if set (e.g. AUTONAV_CHIBI_HOME=/tmp/my-chibi)
+ *   - os.tmpdir() otherwise
+ *
+ * Directory name: `autonav-<harness>-<uuid>/`
+ */
+export declare function createEphemeralHome(opts: EphemeralHomeOptions): EphemeralHome;
+//# sourceMappingURL=ephemeral-home.d.ts.map

package/dist/harness/ephemeral-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-home.d.ts","sourceRoot":"","sources":["../../src/harness/ephemeral-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CA8B7E"}

package/dist/harness/ephemeral-home.js

@@ -0,0 +1,56 @@
+/**
+ * Ephemeral Home
+ *
+ * Creates temporary home directories for harness sessions. Each harness
+ * (chibi, opencode, etc.) can use this to inject custom plugins/tools
+ * into the agent's environment without polluting global config.
+ *
+ * Base location priority:
+ *   1. AUTONAV_<HARNESS>_HOME env var (e.g. AUTONAV_CHIBI_HOME)
+ *   2. os.tmpdir()
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+/**
+ * Create an ephemeral home directory for a harness session.
+ *
+ * The directory is created under:
+ *   - $AUTONAV_<HARNESS>_HOME if set (e.g. AUTONAV_CHIBI_HOME=/tmp/my-chibi)
+ *   - os.tmpdir() otherwise
+ *
+ * Directory name: `autonav-<harness>-<uuid>/`
+ */
+export function createEphemeralHome(opts) {
+    const envKey = `AUTONAV_${opts.harness.toUpperCase()}_HOME`;
+    const base = process.env[envKey] || os.tmpdir();
+    const dirName = `autonav-${opts.harness}-${crypto.randomUUID().slice(0, 8)}`;
+    const homePath = path.join(base, dirName);
+    fs.mkdirSync(homePath, { recursive: true });
+    try {
+        opts.setup(homePath);
+    }
+    catch (err) {
+        // Clean up on setup failure
+        try {
+            fs.rmSync(homePath, { recursive: true, force: true });
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        throw err;
+    }
+    return {
+        homePath,
+        cleanup: () => {
+            try {
+                fs.rmSync(homePath, { recursive: true, force: true });
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        },
+    };
+}
+//# sourceMappingURL=ephemeral-home.js.map

package/dist/harness/ephemeral-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-home.js","sourceRoot":"","sources":["../../src/harness/ephemeral-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAgBtC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA0B;IAC5D,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4BAA4B;QAC5B,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC;gBACH,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/harness/factory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Harness Factory
+ *
+ * Resolves and creates the appropriate harness based on configuration.
+ *
+ * Resolution priority:
+ * 1. Explicit type parameter
+ * 2. CLI flag: --harness chibi
+ * 3. Env var: AUTONAV_HARNESS=chibi
+ * 4. Navigator config.json: harness.type
+ * 5. Default: claude-code
+ */
+import type { Harness, HarnessType } from "./types.js";
+/**
+ * Resolve harness type from available sources.
+ *
+ * @param explicit - Explicit type (from CLI flag or direct call)
+ * @param navigatorConfig - Navigator config object (may have harness.type)
+ * @returns Resolved harness type
+ */
+export declare function resolveHarnessType(explicit?: string, navigatorConfig?: {
+    harness?: {
+        type?: string;
+    };
+}): HarnessType;
+/**
+ * Create a harness instance for the given type.
+ *
+ * @param type - Harness type to create
+ * @returns Harness instance
+ */
+export declare function createHarness(type: HarnessType): Promise<Harness>;
+/**
+ * Resolve harness type and create instance in one call.
+ *
+ * This is the main entry point for harness creation.
+ *
+ * @param explicit - Explicit type (from CLI --harness flag)
+ * @param navigatorConfig - Navigator config object
+ * @returns Ready-to-use Harness instance
+ */
+export declare function resolveAndCreateHarness(explicit?: string, navigatorConfig?: {
+    harness?: {
+        type?: string;
+    };
+}): Promise<Harness>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/harness/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/harness/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGvD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChD,WAAW,CAmBb;AAeD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChD,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/harness/factory.js

@@ -0,0 +1,84 @@
+/**
+ * Harness Factory
+ *
+ * Resolves and creates the appropriate harness based on configuration.
+ *
+ * Resolution priority:
+ * 1. Explicit type parameter
+ * 2. CLI flag: --harness chibi
+ * 3. Env var: AUTONAV_HARNESS=chibi
+ * 4. Navigator config.json: harness.type
+ * 5. Default: claude-code
+ */
+import { ClaudeCodeHarness } from "./claude-code-harness.js";
+/**
+ * Resolve harness type from available sources.
+ *
+ * @param explicit - Explicit type (from CLI flag or direct call)
+ * @param navigatorConfig - Navigator config object (may have harness.type)
+ * @returns Resolved harness type
+ */
+export function resolveHarnessType(explicit, navigatorConfig) {
+    // 1. Explicit parameter (from CLI --harness flag)
+    if (explicit) {
+        return validateHarnessType(explicit);
+    }
+    // 2. Environment variable
+    const envType = process.env.AUTONAV_HARNESS;
+    if (envType) {
+        return validateHarnessType(envType);
+    }
+    // 3. Navigator config
+    if (navigatorConfig?.harness?.type) {
+        return validateHarnessType(navigatorConfig.harness.type);
+    }
+    // 4. Default
+    return "claude-code";
+}
+/**
+ * Validate a string is a valid HarnessType
+ */
+function validateHarnessType(value) {
+    const valid = ["claude-code", "chibi", "opencode"];
+    if (!valid.includes(value)) {
+        throw new Error(`Invalid harness type: "${value}". Valid types: ${valid.join(", ")}`);
+    }
+    return value;
+}
+/**
+ * Create a harness instance for the given type.
+ *
+ * @param type - Harness type to create
+ * @returns Harness instance
+ */
+export async function createHarness(type) {
+    switch (type) {
+        case "claude-code":
+            return new ClaudeCodeHarness();
+        case "chibi": {
+            // Dynamic import to avoid loading chibi dependencies when not needed
+            const { ChibiHarness } = await import("./chibi-harness.js");
+            return new ChibiHarness();
+        }
+        case "opencode": {
+            const { OpenCodeHarness } = await import("./opencode-harness.js");
+            return new OpenCodeHarness();
+        }
+        default:
+            throw new Error(`Unknown harness type: ${type}`);
+    }
+}
+/**
+ * Resolve harness type and create instance in one call.
+ *
+ * This is the main entry point for harness creation.
+ *
+ * @param explicit - Explicit type (from CLI --harness flag)
+ * @param navigatorConfig - Navigator config object
+ * @returns Ready-to-use Harness instance
+ */
+export async function resolveAndCreateHarness(explicit, navigatorConfig) {
+    const type = resolveHarnessType(explicit, navigatorConfig);
+    return createHarness(type);
+}
+//# sourceMappingURL=factory.js.map

package/dist/harness/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/harness/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAiB,EACjB,eAAiD;IAEjD,kDAAkD;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,0BAA0B;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC5C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,sBAAsB;IACtB,IAAI,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO,mBAAmB,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,aAAa;IACb,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,KAAK,GAAkB,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAoB,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAiB;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,EAAE,CAAC;QAEjC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,qEAAqE;YACrE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC5D,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAClE,OAAO,IAAI,eAAe,EAAE,CAAC;QAC/B,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAiB,EACjB,eAAiD;IAEjD,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC3D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/harness/helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Harness Helpers
+ *
+ * Utility functions for consuming AgentEvent streams.
+ * These are the most common patterns across all harness consumers.
+ */
+import type { AgentEvent } from "./types.js";
+/**
+ * Collect all text from an agent event stream into a single string.
+ *
+ * Useful for simple queries where you just need the final answer text.
+ */
+export declare function collectText(events: AsyncIterable<AgentEvent>): Promise<string>;
+/**
+ * Result from collecting a complete agent run.
+ */
+export interface CollectedResult {
+    /** Whether the run succeeded */
+    success: boolean;
+    /** Final text output */
+    text: string;
+    /** Token usage */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Cost in USD */
+    costUsd?: number;
+    /** Duration in ms */
+    durationMs?: number;
+    /** All text events (in order) */
+    textEvents: string[];
+    /** All tool use events */
+    toolUseEvents: Array<{
+        name: string;
+        id: string;
+        input: Record<string, unknown>;
+    }>;
+    /** All tool result events */
+    toolResultEvents: Array<{
+        toolUseId: string;
+        content: string;
+        isError?: boolean;
+    }>;
+    /** All error events */
+    errorEvents: Array<{
+        message: string;
+        retryable?: boolean;
+    }>;
+}
+/**
+ * Collect the full result from an agent event stream.
+ *
+ * Accumulates all events into a structured result. Useful when you need
+ * to inspect tool usage, track errors, or access usage metrics.
+ */
+export declare function collectResult(events: AsyncIterable<AgentEvent>): Promise<CollectedResult>;
+//# sourceMappingURL=helpers.d.ts.map