@autonav/core 1.6.0 → 1.7.0

package/dist/harness/chibi-harness.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Chibi Harness
+ *
+ * Adapts chibi-json into the universal Harness interface.
+ *
+ * chibi-json is stateless per invocation: each call reads ONE JSON object
+ * from stdin, executes the command, outputs JSONL to stdout, and exits.
+ * Multi-turn continuity comes from the named `context` — chibi persists
+ * conversation history on disk keyed by context name.
+ *
+ * Protocol (from `chibi-json --json-schema`):
+ *   Input:  { command: Command, context: string, project_root?: string, flags?: ExecutionFlags }
+ *   Output: JSONL lines — transcript entries (entry_type: "message"|"tool_call"|"tool_result")
+ *           and error objects (type: "error", message: string)
+ *
+ * Session lifecycle:
+ *   1. set_system_prompt (separate invocation, no output)
+ *   2. send_prompt (separate invocation, streams JSONL output)
+ *   3. For multi-turn: send_prompt again with same context name
+ */
+import type { Harness, HarnessSession, AgentConfig } from "./types.js";
+import type { ToolDefinition } from "./tool-server.js";
+/**
+ * Chibi Harness
+ *
+ * Creates sessions that delegate to chibi-json subprocess invocations.
+ * Each command is a separate process; context names provide multi-turn continuity.
+ */
+export declare class ChibiHarness implements Harness {
+    readonly displayName = "chibi";
+    run(config: AgentConfig, prompt: string): HarnessSession;
+    createToolServer(name: string, tools: ToolDefinition[]): {
+        server: unknown;
+    };
+}
+//# sourceMappingURL=chibi-harness.d.ts.map

package/dist/harness/chibi-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chibi-harness.d.ts","sourceRoot":"","sources":["../../src/harness/chibi-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA+YvD;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,WAAW,WAAW;IAE/B,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;CAY7E"}

package/dist/harness/chibi-harness.js

@@ -0,0 +1,383 @@
+/**
+ * Chibi Harness
+ *
+ * Adapts chibi-json into the universal Harness interface.
+ *
+ * chibi-json is stateless per invocation: each call reads ONE JSON object
+ * from stdin, executes the command, outputs JSONL to stdout, and exits.
+ * Multi-turn continuity comes from the named `context` — chibi persists
+ * conversation history on disk keyed by context name.
+ *
+ * Protocol (from `chibi-json --json-schema`):
+ *   Input:  { command: Command, context: string, project_root?: string, flags?: ExecutionFlags }
+ *   Output: JSONL lines — transcript entries (entry_type: "message"|"tool_call"|"tool_result")
+ *           and error objects (type: "error", message: string)
+ *
+ * Session lifecycle:
+ *   1. set_system_prompt (separate invocation, no output)
+ *   2. send_prompt (separate invocation, streams JSONL output)
+ *   3. For multi-turn: send_prompt again with same context name
+ */
+import { execFileSync, spawn } from "node:child_process";
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { createEphemeralHome } from "./ephemeral-home.js";
+import { wrapCommand, isSandboxEnabled } from "./sandbox.js";
+const CHIBI_TOOL_MARKER = "__chibi_tools__";
+/**
+ * Build the chibi-json input object for a command.
+ */
+function buildInput(command, context, projectRoot, home) {
+    const input = { command, context };
+    if (projectRoot) {
+        input.project_root = projectRoot;
+    }
+    if (home) {
+        input.home = home;
+    }
+    return JSON.stringify(input);
+}
+/**
+ * Run a chibi-json command synchronously (for commands with no streaming output like set_system_prompt).
+ */
+function runSync(inputJson, opts) {
+    const { command, args } = wrapCommand("chibi-json", [], opts?.sandboxConfig);
+    execFileSync(command, args, {
+        input: inputJson,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 10_000,
+        env: opts?.env ? { ...process.env, ...opts.env } : undefined,
+    });
+}
+/**
+ * Parse a chibi JSONL output line into AgentEvents.
+ *
+ * Chibi transcript entries have:
+ *   - entry_type: "message" | "tool_call" | "tool_result"
+ *   - from: sender name
+ *   - to: context name
+ *   - content: string (for messages) or structured data
+ *
+ * Error objects have:
+ *   - type: "error"
+ *   - message: string
+ */
+function parseChibiLine(line) {
+    const events = [];
+    try {
+        const data = JSON.parse(line);
+        // Error object
+        if (data.type === "error") {
+            events.push({
+                type: "error",
+                message: data.message || "Unknown chibi error",
+            });
+            return events;
+        }
+        // Transcript entries (from chibi's conversation log)
+        if (data.entry_type === "message") {
+            // Skip user messages (from="user"), only emit assistant responses
+            if (data.from !== "user" && data.content) {
+                events.push({ type: "text", text: data.content });
+            }
+        }
+        else if (data.entry_type === "tool_call") {
+            let input = {};
+            try {
+                input = typeof data.content === "string" ? JSON.parse(data.content) : (data.content || {});
+            }
+            catch {
+                // content wasn't valid JSON — leave input empty
+            }
+            events.push({
+                type: "tool_use",
+                name: data.to || "unknown",
+                id: data.tool_call_id || data.id || "",
+                input,
+            });
+        }
+        else if (data.entry_type === "tool_result") {
+            events.push({
+                type: "tool_result",
+                toolUseId: data.tool_call_id || data.id || "",
+                content: typeof data.content === "string" ? data.content : JSON.stringify(data.content || ""),
+                isError: data.is_error === true,
+            });
+        }
+    }
+    catch {
+        // Not valid JSON — ignore
+    }
+    return events;
+}
+/**
+ * Chibi harness session.
+ *
+ * Each prompt is a separate chibi-json invocation. The named context
+ * provides conversation continuity across invocations.
+ */
+class ChibiSession {
+    config;
+    contextName;
+    child = null;
+    closed = false;
+    registeredTools = new Map();
+    ephemeralHome = null;
+    sandboxConfig;
+    extraEnv = {};
+    sandboxDenials = [];
+    constructor(config, initialPrompt) {
+        this.config = { ...config };
+        this.contextName = `autonav-${crypto.randomUUID().slice(0, 8)}`;
+        // Create ephemeral home with all chibi plugins
+        this.ephemeralHome = createEphemeralHome({
+            harness: "chibi",
+            setup: (home) => {
+                // home_override IS the chibi_dir in AppState::load — files go at root level.
+                // Copy user config so chibi can authenticate with the LLM API.
+                const userConfig = path.join(os.homedir(), ".chibi", "config.toml");
+                if (fs.existsSync(userConfig)) {
+                    fs.copyFileSync(userConfig, path.join(home, "config.toml"));
+                }
+                // Install all chibi plugins from the plugins directory
+                const pluginsDir = path.join(home, "plugins");
+                fs.mkdirSync(pluginsDir);
+                const srcDir = fileURLToPath(new URL("./chibi-plugins", import.meta.url));
+                if (fs.existsSync(srcDir)) {
+                    for (const file of fs.readdirSync(srcDir)) {
+                        const srcPath = path.join(srcDir, file);
+                        if (fs.statSync(srcPath).isFile()) {
+                            fs.copyFileSync(srcPath, path.join(pluginsDir, file));
+                            fs.chmodSync(path.join(pluginsDir, file), 0o755);
+                        }
+                    }
+                }
+            },
+        });
+        // Build extra env vars for plugin scripts
+        if (config.cwd) {
+            // Resolve plugins.json path relative to navigator directory
+            const pluginsPath = path.join(config.cwd, ".claude", "plugins.json");
+            if (fs.existsSync(pluginsPath)) {
+                this.extraEnv.AUTONAV_PLUGINS_PATH = pluginsPath;
+            }
+        }
+        // Cycle detection depth for cross-nav queries
+        const currentDepth = process.env.AUTONAV_QUERY_DEPTH || "0";
+        this.extraEnv.AUTONAV_QUERY_DEPTH = currentDepth;
+        // Build sandbox config from AgentConfig.sandbox + defaults
+        if (config.sandbox) {
+            this.sandboxConfig = { ...config.sandbox };
+            // Chibi makes its own API calls — never block network
+            this.sandboxConfig.blockNetwork = false;
+            // Merge paths: navigator dir (at least read), ephemeral home (always write)
+            const writeSet = new Set(this.sandboxConfig.writePaths || []);
+            if (this.ephemeralHome)
+                writeSet.add(this.ephemeralHome.homePath);
+            this.sandboxConfig.writePaths = [...writeSet];
+            // Only add cwd to readPaths if it's not already in writePaths (write implies read)
+            const readSet = new Set(this.sandboxConfig.readPaths || []);
+            if (config.cwd && !writeSet.has(config.cwd))
+                readSet.add(config.cwd);
+            this.sandboxConfig.readPaths = [...readSet];
+            // Debug: log sandbox status
+            if (process.env.AUTONAV_DEBUG === "1" && config.stderr) {
+                const active = isSandboxEnabled(this.sandboxConfig);
+                config.stderr(`[chibi] Sandbox: ${active ? "enabled (nono)" : "disabled"}\n`);
+                if (active) {
+                    const { command, args } = wrapCommand("chibi-json", [], this.sandboxConfig);
+                    config.stderr(`[chibi] Sandbox cmd: ${command} ${args.join(" ")}\n`);
+                }
+            }
+        }
+        // Extract chibi tool servers from mcpServers config
+        if (config.mcpServers) {
+            for (const serverObj of Object.values(config.mcpServers)) {
+                if (serverObj &&
+                    typeof serverObj === "object" &&
+                    CHIBI_TOOL_MARKER in serverObj) {
+                    const chibiServer = serverObj;
+                    for (const td of chibiServer.tools) {
+                        this.registeredTools.set(td.name, td);
+                    }
+                }
+            }
+        }
+        // Set system prompt (separate synchronous invocation)
+        if (config.systemPrompt) {
+            const input = buildInput({ set_system_prompt: { prompt: config.systemPrompt } }, this.contextName, config.cwd, this.ephemeralHome.homePath);
+            try {
+                runSync(input, { env: this.extraEnv, sandboxConfig: this.sandboxConfig });
+            }
+            catch (error) {
+                // Log but don't fail — system prompt is best-effort
+                const msg = error instanceof Error ? error.message : String(error);
+                if (config.stderr) {
+                    config.stderr(`[chibi] Failed to set system prompt: ${msg}`);
+                }
+            }
+        }
+        // Start the prompt invocation
+        this.child = this.spawnPrompt(initialPrompt);
+    }
+    /**
+     * Spawn a chibi-json process for a send_prompt command.
+     * Returns the child process whose stdout streams JSONL events.
+     */
+    spawnPrompt(prompt) {
+        const inputJson = buildInput({ send_prompt: { prompt } }, this.contextName, this.config.cwd, this.ephemeralHome?.homePath);
+        const { command, args } = wrapCommand("chibi-json", [], this.sandboxConfig);
+        const child = spawn(command, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, ...this.extraEnv },
+        });
+        // Write the single JSON input and close stdin
+        child.stdin?.write(inputJson);
+        child.stdin?.end();
+        // Handle stderr — always capture sandbox denials, forward rest to debug handler
+        if (child.stderr) {
+            const stderrHandler = this.config.stderr;
+            const sandboxActive = isSandboxEnabled(this.sandboxConfig);
+            child.stderr.on("data", (data) => {
+                const text = data.toString();
+                if (stderrHandler) {
+                    stderrHandler(text);
+                }
+                // Surface sandbox denials as events even outside debug mode
+                if (sandboxActive && text.includes("nono:")) {
+                    this.sandboxDenials.push(text.trim());
+                }
+            });
+        }
+        return child;
+    }
+    async *[Symbol.asyncIterator]() {
+        if (!this.child || !this.child.stdout) {
+            throw new Error("Chibi process not started");
+        }
+        const rl = readline.createInterface({
+            input: this.child.stdout,
+            crlfDelay: Infinity,
+        });
+        let hasResult = false;
+        let lastText = "";
+        let hadError = false;
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            const events = parseChibiLine(line);
+            for (const event of events) {
+                if (event.type === "error") {
+                    hadError = true;
+                }
+                if (event.type === "text") {
+                    lastText = event.text;
+                }
+                // Intercept tool_use events for registered tools
+                // Note: chibi handles its own tool calls natively, but autonav-registered
+                // tools (submit_answer, self-config) need local interception.
+                // This won't work with stateless chibi-json — tool interception requires
+                // a long-running process. For now, yield the event and let the caller handle it.
+                yield event;
+            }
+        }
+        // Surface sandbox denials so callers see what nono blocked
+        // These are informational — the process exit code determines success/failure
+        for (const denial of this.sandboxDenials) {
+            yield { type: "error", message: `[sandbox] ${denial}` };
+        }
+        this.sandboxDenials = [];
+        // Emit a synthetic result event based on process exit
+        if (!hasResult) {
+            const exitCode = await new Promise((resolve) => {
+                if (!this.child) {
+                    resolve(null);
+                    return;
+                }
+                if (this.child.exitCode !== null) {
+                    resolve(this.child.exitCode);
+                    return;
+                }
+                this.child.on("exit", (code) => resolve(code));
+            });
+            yield {
+                type: "result",
+                success: exitCode === 0 && !hadError,
+                text: lastText || (hadError ? "chibi-json returned an error" : ""),
+            };
+        }
+    }
+    send(prompt) {
+        if (this.closed) {
+            throw new Error("Session is closed");
+        }
+        // New invocation, same context name = multi-turn continuity
+        this.child = this.spawnPrompt(prompt);
+        const session = this;
+        return {
+            [Symbol.asyncIterator]() {
+                return session[Symbol.asyncIterator]();
+            },
+        };
+    }
+    updateConfig(config) {
+        Object.assign(this.config, config);
+    }
+    async close() {
+        this.closed = true;
+        if (this.child && this.child.exitCode === null) {
+            this.child.kill("SIGTERM");
+            await new Promise((resolve) => {
+                if (!this.child) {
+                    resolve();
+                    return;
+                }
+                this.child.on("exit", () => resolve());
+                setTimeout(() => {
+                    this.child?.kill("SIGKILL");
+                    resolve();
+                }, 5000);
+            });
+        }
+        // Clean up the context
+        try {
+            const destroyInput = buildInput({ destroy_context: { name: this.contextName } }, this.contextName, undefined, this.ephemeralHome?.homePath);
+            runSync(destroyInput, { env: this.extraEnv, sandboxConfig: this.sandboxConfig });
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        // Clean up ephemeral home directory
+        this.ephemeralHome?.cleanup();
+        this.ephemeralHome = null;
+    }
+}
+/**
+ * Chibi Harness
+ *
+ * Creates sessions that delegate to chibi-json subprocess invocations.
+ * Each command is a separate process; context names provide multi-turn continuity.
+ */
+export class ChibiHarness {
+    displayName = "chibi";
+    run(config, prompt) {
+        return new ChibiSession(config, prompt);
+    }
+    createToolServer(name, tools) {
+        // Return a sentinel object that ChibiSession can detect and extract tools from.
+        // Note: Tool interception doesn't work with stateless chibi-json invocations.
+        // Tools registered here are yielded as events for the caller to handle.
+        return {
+            server: {
+                [CHIBI_TOOL_MARKER]: true,
+                name,
+                tools,
+            },
+        };
+    }
+}
+//# sourceMappingURL=chibi-harness.js.map

package/dist/harness/chibi-harness.js.map

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

package/dist/harness/chibi-plugins/get_plugin_config

@@ -0,0 +1,64 @@
+#!/bin/bash
+# get_plugin_config chibi plugin
+#
+# Reads $AUTONAV_PLUGINS_PATH and returns plugin configuration.
+
+set -euo pipefail
+
+if [[ "${1:-}" == "--schema" ]]; then
+  printf '%s\n' '{' \
+    '  "name": "get_plugin_config",' \
+    '  "description": "Read your current plugin configuration. Use this to check what plugins are enabled, see notification settings, or verify your current schedule.",' \
+    '  "parameters": {' \
+    '    "type": "object",' \
+    '    "properties": {' \
+    '      "plugin": {' \
+    '        "type": "string",' \
+    '        "enum": ["slack", "signal", "github", "email", "all"],' \
+    '        "description": "The plugin to read configuration for, or '\''all'\'' for everything"' \
+    '      }' \
+    '    },' \
+    '    "required": ["plugin"]' \
+    '  }' \
+    '}'
+  exit 0
+fi
+
+# Read JSON args from stdin
+input=$(cat)
+plugin=$(echo "$input" | jq -r '.plugin // empty')
+
+if [[ -z "$plugin" ]]; then
+  echo '{"success": false, "error": "Missing required field: plugin"}'
+  exit 0
+fi
+
+# 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 and return config
+config=$(cat "$config_path")
+
+if [[ "$plugin" == "all" ]]; then
+  jq -n --argjson config "$config" \
+    '{"success": true, "plugin": "all", "config": $config}'
+else
+  # Extract specific plugin section
+  section=$(echo "$config" | jq --arg p "$plugin" '.[$p] // null')
+  if [[ "$section" == "null" ]]; then
+    jq -n --arg p "$plugin" \
+      '{"success": true, "plugin": $p, "config": {"enabled": false, "config": {}}}'
+  else
+    jq -n --arg p "$plugin" --argjson section "$section" \
+      '{"success": true, "plugin": $p, "config": $section}'
+  fi
+fi

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."