homegraph 1.2.0 → 1.5.0

package/dist/spec/llm/agents/codex.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Codex CLI headless adapter (`codex exec`).
+ *
+ * Invocation design:
+ *   - `codex exec`             — non-interactive one-shot mode
+ *   - `--sandbox read-only`    — no file writes or command side effects
+ *   - `--skip-git-repo-check`  — allow running outside/inside any repo
+ *   - `--json`                 — stdout is a JSONL event stream; the final
+ *                                assistant message is the last
+ *                                `item.completed` event whose item type is
+ *                                `agent_message`
+ *   - `-`                      — read the prompt from stdin (prompts can
+ *                                reach ~60K chars; stdin avoids OS argv
+ *                                length limits)
+ *
+ * Codex has no native system-prompt flag, so the system prompt is embedded
+ * into the user prompt inside an <instructions> block.
+ *
+ * @module spec/llm/agents/codex
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codexAdapter = exports.CodexAdapter = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const detect_utils_1 = require("./detect-utils");
+/** Signatures of auth/quota failures — retrying is pointless. */
+const TERMINAL_PATTERNS = [
+    /not\s+logged\s+in/i,
+    /please\s+(run\s+)?\/?login/i,
+    /unauthorized|invalid\s+api\s+key|authentication/i,
+    /usage\s+limit|quota\s+(exceeded|exhausted)|rate\s+limit\s+reached/i,
+];
+/** Footer line Codex prints after the final message in plain-text mode. */
+const STDOUT_NOISE = /^tokens used\b/i;
+class CodexAdapter {
+    id = 'codex';
+    displayName = 'Codex';
+    binary = 'codex';
+    detect() {
+        // Executable-based detection only: an uninstalled Codex leaves
+        // ~/.codex behind, so the config directory is NOT a valid signal.
+        // Fall back to a well-known manual-install location for setups that
+        // never added the binary to PATH.
+        return (0, detect_utils_1.isOnPath)(this.binary)
+            || (0, detect_utils_1.isExecutable)(path.join(os.homedir(), '.local', 'bin', 'codex'));
+    }
+    buildInvocation(systemPrompt, userPrompt) {
+        const args = [
+            'exec',
+            '--sandbox', 'read-only',
+            '--skip-git-repo-check',
+            '--json',
+            '-',
+        ];
+        // No native system-prompt flag — embed it in the prompt body.
+        const stdin = systemPrompt
+            ? `<instructions>\n${systemPrompt}\n</instructions>\n\n${userPrompt}`
+            : userPrompt;
+        return { args, stdin };
+    }
+    extractOutput(result) {
+        // JSONL event stream (codex exec --json): the model text is the LAST
+        // `item.completed` event whose item is an agent message. Verified
+        // shape: {"type":"item.completed","item":{"type":"agent_message","text":...}}
+        let lastMessage = '';
+        let sawEvent = false;
+        for (const line of result.stdout.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith('{'))
+                continue;
+            try {
+                const event = JSON.parse(trimmed);
+                sawEvent = true;
+                if (event?.type === 'item.completed'
+                    && event?.item?.type === 'agent_message') {
+                    // `text` is the documented field; tolerate `message` for
+                    // cross-version robustness at this external boundary.
+                    const text = event.item.text ?? event.item.message;
+                    if (typeof text === 'string')
+                        lastMessage = text;
+                }
+            }
+            catch {
+                // Non-JSON line — ignore.
+            }
+        }
+        if (lastMessage)
+            return lastMessage.trim();
+        if (sawEvent)
+            return ''; // events parsed but no agent message
+        // Fallback for CLI versions without JSONL support: strip known noise.
+        return result.stdout
+            .split('\n')
+            .filter((line) => !STDOUT_NOISE.test(line.trim()))
+            .join('\n')
+            .trim();
+    }
+    classifyFailure(failure) {
+        if (failure.exitCode === null)
+            return 'terminal'; // spawn-level failure (e.g. ENOENT)
+        // Auth/quota errors surface on stderr (Rust logs) AND as JSONL error
+        // events on stdout — check both.
+        const haystack = `${failure.stderr}\n${failure.stdout}`;
+        if (TERMINAL_PATTERNS.some((re) => re.test(haystack)))
+            return 'terminal';
+        return 'retryable';
+    }
+}
+exports.CodexAdapter = CodexAdapter;
+exports.codexAdapter = new CodexAdapter();
+//# sourceMappingURL=codex.js.map

package/dist/spec/llm/agents/codex.js.map

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

package/dist/spec/llm/agents/detect-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared detection helpers for coding-agent adapters.
+ *
+ * Detection philosophy mirrors src/installer/targets (cheap filesystem
+ * checks, never spawn the agent), with one crucial difference: installer
+ * targets detect WHERE to install hooks (a config directory is a fine
+ * signal), while adapters detect WHETHER the agent can run — and an
+ * uninstalled agent leaves its config directory behind. Detection must
+ * therefore key on executable files only: the binary on PATH, or a
+ * well-known install path with the executable bit set.
+ *
+ * @module spec/llm/agents/detect-utils
+ */
+/**
+ * Check whether `binary` resolves to an existing file on PATH.
+ *
+ * Scans PATH directories directly instead of shelling out to `which` —
+ * no child process, no platform-specific locator quirks. Executable-bit
+ * verification is POSIX-only; on Windows existence is sufficient.
+ */
+export declare function isOnPath(binary: string): boolean;
+/**
+ * Check whether `fullPath` exists and is executable (POSIX) or simply
+ * exists (Windows). Used for well-known install locations of agents that
+ * are installed but not on PATH.
+ */
+export declare function isExecutable(fullPath: string): boolean;
+//# sourceMappingURL=detect-utils.d.ts.map

package/dist/spec/llm/agents/detect-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-utils.d.ts","sourceRoot":"","sources":["../../../../src/spec/llm/agents/detect-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAehD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOtD"}

package/dist/spec/llm/agents/detect-utils.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Shared detection helpers for coding-agent adapters.
+ *
+ * Detection philosophy mirrors src/installer/targets (cheap filesystem
+ * checks, never spawn the agent), with one crucial difference: installer
+ * targets detect WHERE to install hooks (a config directory is a fine
+ * signal), while adapters detect WHETHER the agent can run — and an
+ * uninstalled agent leaves its config directory behind. Detection must
+ * therefore key on executable files only: the binary on PATH, or a
+ * well-known install path with the executable bit set.
+ *
+ * @module spec/llm/agents/detect-utils
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOnPath = isOnPath;
+exports.isExecutable = isExecutable;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Check whether `binary` resolves to an existing file on PATH.
+ *
+ * Scans PATH directories directly instead of shelling out to `which` —
+ * no child process, no platform-specific locator quirks. Executable-bit
+ * verification is POSIX-only; on Windows existence is sufficient.
+ */
+function isOnPath(binary) {
+    const pathEnv = process.env.PATH;
+    if (!pathEnv)
+        return false;
+    const candidates = process.platform === 'win32'
+        ? [binary, `${binary}.exe`, `${binary}.cmd`, `${binary}.bat`]
+        : [binary];
+    for (const dir of pathEnv.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const name of candidates) {
+            if (isExecutable(path.join(dir, name)))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check whether `fullPath` exists and is executable (POSIX) or simply
+ * exists (Windows). Used for well-known install locations of agents that
+ * are installed but not on PATH.
+ */
+function isExecutable(fullPath) {
+    try {
+        fs.accessSync(fullPath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect-utils.js.map

package/dist/spec/llm/agents/detect-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-utils.js","sourceRoot":"","sources":["../../../../src/spec/llm/agents/detect-utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYH,4BAeC;AAOD,oCAOC;AAvCD,uCAAyB;AACzB,2CAA6B;AAE7B;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,MAAc;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC7C,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC;QAC7D,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEb,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/spec/llm/agents/deveco-code.d.ts

@@ -0,0 +1,33 @@
+/**
+ * DevEco Code headless adapter (`deveco run`).
+ *
+ * Invocation design:
+ *   - `deveco run`             — non-interactive one-shot mode, exits when
+ *                                the session goes idle
+ *   - `--agent explore`        — read-only agent: only read/grep/glob/
+ *                                webfetch/websearch are allowed; all write
+ *                                and shell tools are denied at agent level
+ *   - `--format json`          — stdout is a JSONL event stream; model text
+ *                                arrives in `{"type":"text","part":{...}}`
+ *                                events
+ *   - prompt via stdin         — spec prompts can reach ~60K chars; stdin
+ *                                avoids OS argv length limits
+ *
+ * DevEco Code has no native system-prompt flag on `deveco run`, so the
+ * system prompt is embedded into the user prompt inside an <instructions>
+ * block — same strategy as the Codex adapter.
+ *
+ * @module spec/llm/agents/deveco-code
+ */
+import { AgentAdapter, AgentFailure, AgentInvocation, AgentRunResult } from './types';
+export declare class DevecoCodeAdapter implements AgentAdapter {
+    readonly id: "deveco-code";
+    readonly displayName = "DevEco Code";
+    readonly binary = "deveco";
+    detect(): boolean;
+    buildInvocation(systemPrompt: string, userPrompt: string): AgentInvocation;
+    extractOutput(result: AgentRunResult): string;
+    classifyFailure(failure: AgentFailure): 'retryable' | 'terminal';
+}
+export declare const devecoCodeAdapter: DevecoCodeAdapter;
+//# sourceMappingURL=deveco-code.d.ts.map

package/dist/spec/llm/agents/deveco-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deveco-code.d.ts","sourceRoot":"","sources":["../../../../src/spec/llm/agents/deveco-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAYtF,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,EAAE,EAAG,aAAa,CAAU;IACrC,QAAQ,CAAC,WAAW,iBAAiB;IACrC,QAAQ,CAAC,MAAM,YAAY;IAE3B,MAAM,IAAI,OAAO;IAkBjB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe;IAoB1E,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAiD7C,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU;CAMjE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/spec/llm/agents/deveco-code.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * DevEco Code headless adapter (`deveco run`).
+ *
+ * Invocation design:
+ *   - `deveco run`             — non-interactive one-shot mode, exits when
+ *                                the session goes idle
+ *   - `--agent explore`        — read-only agent: only read/grep/glob/
+ *                                webfetch/websearch are allowed; all write
+ *                                and shell tools are denied at agent level
+ *   - `--format json`          — stdout is a JSONL event stream; model text
+ *                                arrives in `{"type":"text","part":{...}}`
+ *                                events
+ *   - prompt via stdin         — spec prompts can reach ~60K chars; stdin
+ *                                avoids OS argv length limits
+ *
+ * DevEco Code has no native system-prompt flag on `deveco run`, so the
+ * system prompt is embedded into the user prompt inside an <instructions>
+ * block — same strategy as the Codex adapter.
+ *
+ * @module spec/llm/agents/deveco-code
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devecoCodeAdapter = exports.DevecoCodeAdapter = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const detect_utils_1 = require("./detect-utils");
+/** stderr signatures of auth/quota failures — retrying is pointless. */
+const TERMINAL_PATTERNS = [
+    /not\s+logged\s+in/i,
+    /please\s+(run\s+)?\/?login/i,
+    /unauthorized|invalid\s+api\s+key|authentication/i,
+    /usage\s+limit|quota\s+(exceeded|exhausted)|credit\s+balance/i,
+    /rate\s+limit/i,
+];
+class DevecoCodeAdapter {
+    id = 'deveco-code';
+    displayName = 'DevEco Code';
+    binary = 'deveco';
+    detect() {
+        // Executable-based detection only. DevEco Code config directories
+        // (`.deveco/`, `~/.config/deveco/`) persist after uninstall, so they
+        // are NOT valid detection signals.
+        //
+        // DevEco Code is built on OpenCode and follows similar install patterns.
+        // Common install paths:
+        //   - System PATH (via installer)
+        //   - ~/.local/bin/deveco (manual install, same pattern as codex/claude)
+        //
+        // DevEco Studio IDE installs its own copy to an IDE-private location;
+        // we don't attempt to locate that — PATH + ~/.local/bin covers the
+        // CLI-first workflows this adapter targets.
+        const home = os.homedir();
+        return (0, detect_utils_1.isOnPath)(this.binary)
+            || (0, detect_utils_1.isExecutable)(path.join(home, '.local', 'bin', 'deveco'));
+    }
+    buildInvocation(systemPrompt, userPrompt) {
+        const args = [
+            'run',
+            '--agent', 'explore', // Read-only: no file writes or shell commands
+            '--format', 'json', // JSONL event stream for reliable parsing
+        ];
+        // No native system-prompt flag — embed it in the prompt body, same
+        // strategy as Codex. The agent processes the combined prompt as a
+        // single user message.
+        const prompt = systemPrompt
+            ? `<instructions>\n${systemPrompt}\n</instructions>\n\n${userPrompt}`
+            : userPrompt;
+        // Deliver via stdin to avoid OS argv length limits (spec prompts are
+        // ~50-60K chars). `deveco run` reads from stdin when no positional
+        // message is provided and stdin is not a TTY — both hold when spawned.
+        return { args, stdin: prompt };
+    }
+    extractOutput(result) {
+        // JSONL event stream (`deveco run --format json`).
+        //
+        // Events of interest:
+        //   {"type":"text","timestamp":...,"sessionID":"...",
+        //    "part":{"type":"text","text":"actual content","time":{...}}}
+        //
+        // We extract all `type: "text"` events and concatenate them. Text
+        // parts can arrive incrementally (streaming); each event contains the
+        // latest content delta.
+        //
+        // Other event types we ignore:
+        //   "tool_use"  — tool invocations (empty with explore agent anyway)
+        //   "reasoning" — thinking traces
+        //   "error"     — session errors
+        //   "step_start" / "step_finish" — turn boundaries
+        let output = '';
+        let sawJsonlEvent = false;
+        for (const line of result.stdout.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith('{'))
+                continue;
+            try {
+                const event = JSON.parse(trimmed);
+                sawJsonlEvent = true;
+                if (event?.type === 'text'
+                    && event?.part?.type === 'text'
+                    && typeof event.part.text === 'string') {
+                    output += event.part.text;
+                }
+            }
+            catch {
+                // Non-JSON line — ignore (diagnostic output, warnings, etc.)
+            }
+        }
+        if (output)
+            return output.trim();
+        if (sawJsonlEvent)
+            return ''; // events parsed but no text content
+        // Fallback for CLI versions that may not produce JSONL (unlikely with
+        // --format json, but safe). Strip anything that looks like noise.
+        return result.stdout
+            .split('\n')
+            .filter((line) => !/^(deveco|warning|info)[:\s]/i.test(line.trim()))
+            .join('\n')
+            .trim();
+    }
+    classifyFailure(failure) {
+        if (failure.exitCode === null)
+            return 'terminal'; // spawn-level failure (e.g. ENOENT)
+        // Auth/quota errors surface on stderr.
+        if (TERMINAL_PATTERNS.some((re) => re.test(failure.stderr)))
+            return 'terminal';
+        return 'retryable';
+    }
+}
+exports.DevecoCodeAdapter = DevecoCodeAdapter;
+exports.devecoCodeAdapter = new DevecoCodeAdapter();
+//# sourceMappingURL=deveco-code.js.map

package/dist/spec/llm/agents/deveco-code.js.map

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

package/dist/spec/llm/agents/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Coding-agent registry, installation detection, and resolution.
+ *
+ * Resolution is fully automatic and deterministic (spec evolve is mostly
+ * triggered by git hooks, so interactive selection is impossible):
+ *
+ *   - exactly one agent installed → use it
+ *   - both installed              → prefer Claude Code (registry order)
+ *   - none installed              → null (caller falls back to LLMConfig)
+ *
+ * There is intentionally no user-facing way to pick an agent. The
+ * HOMEGRAPH_SPEC_AGENT environment variable exists ONLY as a test escape
+ * hatch ('none' disables agent usage; an adapter id forces that adapter)
+ * and is not documented for end users.
+ *
+ * @module spec/llm/agents
+ */
+import { AgentAdapter } from './types';
+export type { AgentAdapter, AgentInvocation, AgentRunResult } from './types';
+export { claudeCodeAdapter } from './claude-code';
+export { codexAdapter } from './codex';
+export { devecoCodeAdapter } from './deveco-code';
+/**
+ * Resolve the coding agent to use for LLM tasks, or null when none is
+ * installed. Result is cached for the process lifetime — detection is
+ * repeated only after {@link resetAgentResolutionCache} (tests).
+ */
+export declare function resolveAgent(): AgentAdapter | null;
+/** Test-only: clear the cached resolution after mutating PATH/HOME/env. */
+export declare function resetAgentResolutionCache(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/llm/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/spec/llm/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKvC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAWlD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAgBlD;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/spec/llm/agents/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Coding-agent registry, installation detection, and resolution.
+ *
+ * Resolution is fully automatic and deterministic (spec evolve is mostly
+ * triggered by git hooks, so interactive selection is impossible):
+ *
+ *   - exactly one agent installed → use it
+ *   - both installed              → prefer Claude Code (registry order)
+ *   - none installed              → null (caller falls back to LLMConfig)
+ *
+ * There is intentionally no user-facing way to pick an agent. The
+ * HOMEGRAPH_SPEC_AGENT environment variable exists ONLY as a test escape
+ * hatch ('none' disables agent usage; an adapter id forces that adapter)
+ * and is not documented for end users.
+ *
+ * @module spec/llm/agents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devecoCodeAdapter = exports.codexAdapter = exports.claudeCodeAdapter = void 0;
+exports.resolveAgent = resolveAgent;
+exports.resetAgentResolutionCache = resetAgentResolutionCache;
+const claude_code_1 = require("./claude-code");
+const codex_1 = require("./codex");
+const deveco_code_1 = require("./deveco-code");
+var claude_code_2 = require("./claude-code");
+Object.defineProperty(exports, "claudeCodeAdapter", { enumerable: true, get: function () { return claude_code_2.claudeCodeAdapter; } });
+var codex_2 = require("./codex");
+Object.defineProperty(exports, "codexAdapter", { enumerable: true, get: function () { return codex_2.codexAdapter; } });
+var deveco_code_2 = require("./deveco-code");
+Object.defineProperty(exports, "devecoCodeAdapter", { enumerable: true, get: function () { return deveco_code_2.devecoCodeAdapter; } });
+/**
+ * Registry in priority order — the first installed adapter wins.
+ * Claude Code ranks first: its headless mode offers native system-prompt
+ * support, a clean JSON output envelope, and reliable tool disabling.
+ */
+const REGISTRY = [claude_code_1.claudeCodeAdapter, codex_1.codexAdapter, deveco_code_1.devecoCodeAdapter];
+let cachedResolution;
+/**
+ * Resolve the coding agent to use for LLM tasks, or null when none is
+ * installed. Result is cached for the process lifetime — detection is
+ * repeated only after {@link resetAgentResolutionCache} (tests).
+ */
+function resolveAgent() {
+    if (cachedResolution !== undefined)
+        return cachedResolution;
+    const override = process.env.HOMEGRAPH_SPEC_AGENT?.trim().toLowerCase();
+    let resolved = null;
+    if (override === 'none') {
+        resolved = null;
+    }
+    else if (override) {
+        resolved = REGISTRY.find((a) => a.id === override) ?? null;
+    }
+    else {
+        resolved = REGISTRY.find((a) => a.detect()) ?? null;
+    }
+    cachedResolution = resolved;
+    return resolved;
+}
+/** Test-only: clear the cached resolution after mutating PATH/HOME/env. */
+function resetAgentResolutionCache() {
+    cachedResolution = undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/llm/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/spec/llm/agents/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AA0BH,oCAgBC;AAGD,8DAEC;AA5CD,+CAAkD;AAClD,mCAAuC;AACvC,+CAAkD;AAGlD,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAC1B,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAE1B;;;;GAIG;AACH,MAAM,QAAQ,GAAmB,CAAC,+BAAiB,EAAE,oBAAY,EAAE,+BAAiB,CAAC,CAAC;AAEtF,IAAI,gBAAiD,CAAC;AAEtD;;;;GAIG;AACH,SAAgB,YAAY;IAC1B,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IAE5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,IAAI,QAAQ,GAAwB,IAAI,CAAC;IAEzC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED,gBAAgB,GAAG,QAAQ,CAAC;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2EAA2E;AAC3E,SAAgB,yBAAyB;IACvC,gBAAgB,GAAG,SAAS,CAAC;AAC/B,CAAC"}