@autonav/core 1.6.0 → 1.8.0

package/dist/harness/chibi-plugins/query_navigator

@@ -0,0 +1,114 @@
+#!/bin/bash
+# query_navigator chibi plugin
+#
+# Queries another navigator by running chibi-json directly with the
+# target's system prompt in a separate context. Chibi is naturally
+# plural — one instance can be many navigators at once, each in its
+# own context with no knowledge of the others.
+#
+# Flow: set_system_prompt → send_prompt → extract last assistant message → destroy_context
+# Cycle detection via AUTONAV_QUERY_DEPTH env var (max 3).
+
+set -euo pipefail
+
+if [[ "${1:-}" == "--schema" ]]; then
+  printf '%s\n' '{' \
+    '  "name": "query_navigator",' \
+    '  "description": "Ask another navigator a question. Use this when you need information from a different navigator'\''s knowledge base. The target navigator will search its own knowledge and return an answer.",' \
+    '  "parameters": {' \
+    '    "type": "object",' \
+    '    "properties": {' \
+    '      "navigator": { "type": "string", "description": "Path to the target navigator directory (relative to cwd or absolute)" },' \
+    '      "question": { "type": "string", "description": "The question to ask the target navigator" }' \
+    '    },' \
+    '    "required": ["navigator", "question"]' \
+    '  }' \
+    '}'
+  exit 0
+fi
+
+# Read JSON args from stdin
+input=$(cat)
+navigator=$(echo "$input" | jq -r '.navigator // empty')
+question=$(echo "$input" | jq -r '.question // empty')
+
+if [[ -z "$navigator" || -z "$question" ]]; then
+  echo '{"success": false, "error": "Missing required fields: navigator and question"}'
+  exit 0
+fi
+
+# Cycle detection
+depth="${AUTONAV_QUERY_DEPTH:-0}"
+if [[ "$depth" -ge 3 ]]; then
+  echo '{"success": false, "error": "Query depth limit reached (max 3). Cannot query another navigator from this depth."}'
+  exit 0
+fi
+export AUTONAV_QUERY_DEPTH=$(( depth + 1 ))
+
+# Validate navigator directory
+if [[ ! -d "$navigator" ]]; then
+  jq -n --arg p "$navigator" '{"success": false, "error": ("Navigator directory not found: " + $p)}'
+  exit 0
+fi
+
+config_file="$navigator/config.json"
+if [[ ! -f "$config_file" ]]; then
+  echo '{"success": false, "error": "Navigator config.json not found."}'
+  exit 0
+fi
+
+nav_name=$(jq -r '.name // "unknown"' "$config_file")
+instructions_path=$(jq -r '.instructionsPath // "CLAUDE.md"' "$config_file")
+
+prompt_file="$navigator/$instructions_path"
+if [[ ! -f "$prompt_file" ]]; then
+  jq -n --arg f "$instructions_path" '{"success": false, "error": ("Navigator instructions file not found: " + $f)}'
+  exit 0
+fi
+
+system_prompt=$(cat "$prompt_file")
+
+# Unique context for this sub-query (PID + random for collision avoidance)
+ctx="autonav-xnav-$$-$(head -c 4 /dev/urandom | xxd -p)"
+
+cleanup() {
+  # Destroy sub-query context (best-effort)
+  jq -n --arg ctx "$ctx" \
+    '{command: {destroy_context: {name: $ctx}}, context: $ctx}' \
+    | chibi-json 2>/dev/null || true
+}
+trap cleanup EXIT
+
+# 1. Set system prompt on the sub-query context
+jq -n \
+  --arg prompt "$system_prompt" \
+  --arg ctx "$ctx" \
+  --arg root "$navigator" \
+  '{command: {set_system_prompt: {prompt: $prompt}}, context: $ctx, project_root: $root}' \
+  | chibi-json 2>/dev/null || true
+
+# 2. Send the question, capture JSONL output
+response_jsonl=$(
+  jq -n \
+    --arg prompt "$question" \
+    --arg ctx "$ctx" \
+    --arg root "$navigator" \
+    '{command: {send_prompt: {prompt: $prompt}}, context: $ctx, project_root: $root}' \
+  | chibi-json 2>/dev/null
+) || true
+
+# 3. Extract the last assistant message from JSONL
+response=""
+if [[ -n "$response_jsonl" ]]; then
+  response=$(echo "$response_jsonl" \
+    | jq -rs '[.[] | select(.entry_type == "message" and .from != "user") | .content] | last // ""')
+fi
+
+# 4. Return structured result (cleanup runs via trap)
+if [[ -n "$response" && "$response" != "null" && "$response" != '""' ]]; then
+  jq -n --arg nav "$nav_name" --arg resp "$response" \
+    '{"success": true, "navigator": $nav, "response": $resp}'
+else
+  jq -n --arg nav "$nav_name" \
+    '{"success": false, "navigator": $nav, "error": "Navigator returned empty response."}'
+fi

package/dist/harness/chibi-plugins/submit_answer

@@ -0,0 +1,38 @@
+#!/bin/bash
+# submit_answer chibi plugin
+#
+# Provides the submit_answer tool to chibi so the LLM can call it with
+# structured args. The adapter captures the tool_call event from JSONL
+# output — this script just needs to exist and declare the schema.
+
+if [[ "$1" == "--schema" ]]; then
+  printf '%s\n' '{' \
+    '  "name": "submit_answer",' \
+    '  "description": "Submit your final answer. You MUST use this tool to provide your response with proper source citations.",' \
+    '  "parameters": {' \
+    '    "type": "object",' \
+    '    "properties": {' \
+    '      "answer": { "type": "string", "description": "Your complete answer grounded in the knowledge base." },' \
+    '      "sources": {' \
+    '        "type": "array",' \
+    '        "items": {' \
+    '          "type": "object",' \
+    '          "properties": {' \
+    '            "file": { "type": "string" },' \
+    '            "section": { "type": "string" },' \
+    '            "relevance": { "type": "string" }' \
+    '          },' \
+    '          "required": ["file", "section", "relevance"]' \
+    '        }' \
+    '      },' \
+    '      "confidence": { "type": "number", "minimum": 0, "maximum": 1, "description": "Confidence score from 0.0 (no confidence) to 1.0 (fully confident). 0.9+ = high, 0.45-0.89 = medium, below 0.45 = low." },' \
+    '      "confidenceReason": { "type": "string" },' \
+    '      "outOfDomain": { "type": "boolean" }' \
+    '    },' \
+    '    "required": ["answer", "sources", "confidence", "confidenceReason", "outOfDomain"]' \
+    '  }' \
+    '}'
+  exit 0
+fi
+
+echo "Answer submitted successfully."

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