@agenthippo-ai/agenthippo 0.1.0

package/out/engines/customEngineIpc.js

@@ -0,0 +1,95 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeRunnerEvent = encodeRunnerEvent;
+exports.encodeWorkerRequest = encodeWorkerRequest;
+exports.parseWorkerOutbound = parseWorkerOutbound;
+exports.applyRunnerEvent = applyRunnerEvent;
+exports.applyParsedRunnerEvent = applyParsedRunnerEvent;
+function encodeRunnerEvent(event) {
+    return `${JSON.stringify(event)}\n`;
+}
+function encodeWorkerRequest(req) {
+    return `${JSON.stringify(req)}\n`;
+}
+function parseWorkerOutbound(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return undefined;
+    }
+    const candidate = parsed;
+    if (candidate.type === 'ready') {
+        return { type: 'ready' };
+    }
+    if (candidate.type === 'result' && typeof candidate.id === 'string') {
+        return {
+            type: 'result',
+            id: candidate.id,
+            nativeSessionId: typeof candidate.nativeSessionId === 'string' ? candidate.nativeSessionId : undefined,
+        };
+    }
+    if (candidate.type === 'failed' && typeof candidate.id === 'string') {
+        return {
+            type: 'failed',
+            id: candidate.id,
+            message: typeof candidate.message === 'string' ? candidate.message : 'Custom engine turn failed',
+        };
+    }
+    if (typeof candidate.id === 'string' && candidate.event && typeof candidate.event === 'object') {
+        return { id: candidate.id, event: candidate.event };
+    }
+    return undefined;
+}
+async function applyRunnerEvent(emitter, line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    return applyParsedRunnerEvent(emitter, parsed);
+}
+async function applyParsedRunnerEvent(emitter, parsed) {
+    switch (parsed.type) {
+        case 'text':
+            await emitter.text(parsed.delta);
+            break;
+        case 'thinking':
+            await emitter.thinking(parsed.delta);
+            break;
+        case 'toolStart':
+            await emitter.toolStart(parsed.toolName, parsed.input, parsed.toolCallId);
+            break;
+        case 'toolEnd':
+            await emitter.toolEnd(parsed.toolName, parsed.toolCallId, parsed.result, parsed.isError);
+            break;
+        case 'progress':
+            await emitter.progress(parsed.message);
+            break;
+        case 'error':
+            await emitter.error(parsed.message);
+            break;
+        case 'done':
+            await emitter.done();
+            break;
+        case 'nativeSessionId':
+            return parsed.nativeSessionId;
+        case 'probe':
+            if (!parsed.ok) {
+                throw new Error(parsed.message ?? 'Custom engine import probe failed');
+            }
+            break;
+        default:
+            break;
+    }
+    return undefined;
+}

package/out/engines/customEngineRunnerEmbed.js

@@ -0,0 +1,107 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+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.NODE_RUNNER_FILENAME = void 0;
+exports.ensureNodeRunnerScriptPath = ensureNodeRunnerScriptPath;
+exports.embeddedRunnerContentHash = embeddedRunnerContentHash;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const paths_1 = require("../utils/paths");
+exports.NODE_RUNNER_FILENAME = 'run-custom-engine-runner.js';
+/** Avoid static import: generated embed is only needed when the sidecar file is missing. */
+async function loadEmbeddedRunnerModule() {
+    return import('./embeddedCustomEngineRunner.generated.js');
+}
+/**
+ * Path to the Node subprocess runner for custom engines (strategy C).
+ * Prefers a sibling file next to the CLI entry (bundled binary or `node out/cli/index.js`);
+ * otherwise materializes embedded source under ~/.agent-hippo/cache/cli/ so distribution
+ * is a single agenthippo binary.
+ */
+async function ensureNodeRunnerScriptPath() {
+    const candidates = [];
+    // `node …/out/cli/index.js` — execPath is the node binary, not the CLI dir.
+    const mainScript = process.argv[1];
+    if (mainScript) {
+        candidates.push(path.join(path.dirname(mainScript), exports.NODE_RUNNER_FILENAME));
+    }
+    // Bundled CLI binary (bun): execPath is the agenthippo executable.
+    candidates.push(path.join(path.dirname(process.execPath), exports.NODE_RUNNER_FILENAME));
+    for (const sibling of candidates) {
+        try {
+            await node_fs_1.promises.access(sibling);
+            return sibling;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    const { EMBEDDED_CUSTOM_ENGINE_RUNNER_HASH, EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE } = await loadEmbeddedRunnerModule();
+    const cacheDir = path.join((0, paths_1.getAgentideHome)(), 'cache', 'cli');
+    const cachePath = path.join(cacheDir, `${exports.NODE_RUNNER_FILENAME.replace(/\.js$/, '')}-${EMBEDDED_CUSTOM_ENGINE_RUNNER_HASH}.js`);
+    try {
+        const existing = await node_fs_1.promises.readFile(cachePath, 'utf8');
+        if (existing === EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE) {
+            return cachePath;
+        }
+    }
+    catch {
+        // Cache miss or stale — rewrite below.
+    }
+    await node_fs_1.promises.mkdir(cacheDir, { recursive: true });
+    await node_fs_1.promises.writeFile(cachePath, EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE, 'utf8');
+    // Best-effort: drop older runner caches with a different content hash.
+    try {
+        const prefix = `${exports.NODE_RUNNER_FILENAME.replace(/\.js$/, '')}-`;
+        for (const name of await node_fs_1.promises.readdir(cacheDir)) {
+            if (name.startsWith(prefix) && name.endsWith('.js') && path.join(cacheDir, name) !== cachePath) {
+                await node_fs_1.promises.unlink(path.join(cacheDir, name)).catch(() => undefined);
+            }
+        }
+    }
+    catch {
+        // Non-fatal.
+    }
+    return cachePath;
+}
+/** SHA-256 of embedded runner (for tests/diagnostics). */
+async function embeddedRunnerContentHash() {
+    const { EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE } = await loadEmbeddedRunnerModule();
+    return (0, node_crypto_1.createHash)('sha256').update(EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE).digest('hex');
+}

package/out/engines/customRegistry.js

@@ -0,0 +1,274 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+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.parseCustomEngineSearchPath = parseCustomEngineSearchPath;
+exports.getCustomEngineSearchRoots = getCustomEngineSearchRoots;
+exports.discoverCustomEngineManifests = discoverCustomEngineManifests;
+exports.resolveCustomEngineManifest = resolveCustomEngineManifest;
+exports.tryResolveCustomEngineManifest = tryResolveCustomEngineManifest;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const branding_1 = require("../branding");
+const install_1 = require("./install");
+const CUSTOM_ENGINES_SUBDIR = 'engines';
+const CUSTOM_ENGINE_MANIFEST_NAME = 'engine.manifest.json';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function normalizeCustomEngineId(value) {
+    return value.trim().toLowerCase();
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function parseCustomEngineSearchPath(raw) {
+    if (Array.isArray(raw)) {
+        return raw.flatMap(value => parseCustomEngineSearchPath(value));
+    }
+    if (!raw?.trim()) {
+        return [];
+    }
+    return raw.split(path.delimiter).map(d => d.trim()).filter(Boolean);
+}
+function uniquePaths(paths) {
+    const seen = new Set();
+    const out = [];
+    for (const p of paths) {
+        const r = path.resolve(p);
+        if (!seen.has(r)) {
+            seen.add(r);
+            out.push(r);
+        }
+    }
+    return out;
+}
+function parseModelConfig(raw, manifestPath) {
+    if (!raw) {
+        return undefined;
+    }
+    if (typeof raw !== 'object') {
+        throw new Error(`Invalid model config in ${manifestPath}: expected object`);
+    }
+    const c = raw;
+    if (!isNonEmptyString(c.defaultModel)) {
+        throw new Error(`Invalid model config in ${manifestPath}: "defaultModel" is required`);
+    }
+    return {
+        defaultModel: c.defaultModel.trim(),
+        apiKeyEnvVar: isNonEmptyString(c.apiKeyEnvVar) ? c.apiKeyEnvVar.trim() : undefined,
+        baseUrlEnvVar: isNonEmptyString(c.baseUrlEnvVar) ? c.baseUrlEnvVar.trim() : undefined,
+        openaiBaseUrlEnvVar: isNonEmptyString(c.openaiBaseUrlEnvVar) ? c.openaiBaseUrlEnvVar.trim() : undefined,
+    };
+}
+function parsePromptInjectionConfig(raw, manifestPath) {
+    if (!raw) {
+        return { mode: 'env-only' };
+    }
+    if (typeof raw !== 'object') {
+        throw new Error(`Invalid promptInjection config in ${manifestPath}: expected object`);
+    }
+    const c = raw;
+    const modeRaw = isNonEmptyString(c.mode) ? c.mode.trim() : 'env-only';
+    const mode = modeRaw;
+    if (mode !== 'none' && mode !== 'env-only' && mode !== 'message-suffix') {
+        throw new Error(`Invalid promptInjection config in ${manifestPath}: "mode" must be none, env-only, or message-suffix`);
+    }
+    return { mode };
+}
+function parseWorkspaceSyncConfig(raw, manifestPath) {
+    if (!raw) {
+        return undefined;
+    }
+    if (typeof raw !== 'object') {
+        throw new Error(`Invalid workspaceSync config in ${manifestPath}: expected object`);
+    }
+    const c = raw;
+    const enabled = c.enabled === true;
+    if (!enabled) {
+        return {
+            enabled: false,
+            dir: '',
+            rulesFile: '',
+            includeSkills: false,
+            includeRules: false,
+        };
+    }
+    if (!isNonEmptyString(c.dir)) {
+        throw new Error(`Invalid workspaceSync config in ${manifestPath}: "dir" is required when enabled`);
+    }
+    if (!isNonEmptyString(c.rulesFile)) {
+        throw new Error(`Invalid workspaceSync config in ${manifestPath}: "rulesFile" is required when enabled`);
+    }
+    const dir = c.dir.trim();
+    if (path.isAbsolute(dir) || dir.includes('..')) {
+        throw new Error(`Invalid workspaceSync config in ${manifestPath}: "dir" must be a relative workspace directory`);
+    }
+    const rulesFile = c.rulesFile.trim();
+    if (path.isAbsolute(rulesFile) || rulesFile.includes('..')) {
+        throw new Error(`Invalid workspaceSync config in ${manifestPath}: "rulesFile" must be a relative path`);
+    }
+    return {
+        enabled: true,
+        dir,
+        rulesFile,
+        includeSkills: c.includeSkills !== false,
+        includeRules: c.includeRules !== false,
+    };
+}
+function parseManifest(manifestPath, searchRoot) {
+    const raw = fs.readFileSync(manifestPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (!isNonEmptyString(parsed.id)) {
+        throw new Error(`Invalid custom engine manifest ${manifestPath}: "id" is required`);
+    }
+    if (parsed.version !== 2) {
+        throw new Error(`Invalid custom engine manifest ${manifestPath}: "version" must be 2`);
+    }
+    if (!isNonEmptyString(parsed.entry)) {
+        throw new Error(`Invalid custom engine manifest ${manifestPath}: "entry" is required`);
+    }
+    const id = normalizeCustomEngineId(parsed.id);
+    const manifestDir = path.dirname(manifestPath);
+    const entry = parsed.entry.trim();
+    const entryPath = path.isAbsolute(entry) ? entry : path.resolve(manifestDir, entry);
+    return {
+        version: 2,
+        id,
+        displayName: isNonEmptyString(parsed.displayName) ? parsed.displayName.trim() : undefined,
+        description: isNonEmptyString(parsed.description) ? parsed.description.trim() : undefined,
+        entry,
+        entryPath,
+        engineExport: isNonEmptyString(parsed.engineExport) ? parsed.engineExport.trim() : undefined,
+        homeEnvVar: isNonEmptyString(parsed.homeEnvVar) ? parsed.homeEnvVar.trim() : undefined,
+        workspaceSync: parseWorkspaceSyncConfig(parsed.workspaceSync, manifestPath),
+        promptInjection: parsePromptInjectionConfig(parsed.promptInjection, manifestPath),
+        model: parseModelConfig(parsed.model, manifestPath),
+        manifestPath,
+        manifestDir,
+        searchRoot,
+    };
+}
+// ---------------------------------------------------------------------------
+// Discovery
+// ---------------------------------------------------------------------------
+function getCustomEngineSearchRoots(workspaceRoot, extraSearchPath) {
+    const workspaceRootResolved = workspaceRoot ? path.resolve(workspaceRoot) : undefined;
+    const configuredDirs = parseCustomEngineSearchPath(extraSearchPath);
+    const envDirs = parseCustomEngineSearchPath(process.env.AGENTHIPPO_CUSTOM_ENGINES_DIR ?? process.env.AGENTIDE_CUSTOM_ENGINES_DIR);
+    return uniquePaths([
+        ...(workspaceRootResolved ? [path.join(workspaceRootResolved, branding_1.AGENTIDE_DIR_NAME, CUSTOM_ENGINES_SUBDIR)] : []),
+        ...configuredDirs,
+        ...envDirs,
+        (0, install_1.getDefaultCustomEnginesInstallRoot)(),
+        path.join(os.homedir(), branding_1.AGENTIDE_DIR_NAME, CUSTOM_ENGINES_SUBDIR),
+    ]);
+}
+function discoverCustomEngineManifests(workspaceRoot, extraSearchPath, onError) {
+    const manifests = [];
+    const seen = new Set();
+    for (const root of getCustomEngineSearchRoots(workspaceRoot, extraSearchPath)) {
+        if (!fs.existsSync(root)) {
+            continue;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(root, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const manifestPath = path.join(root, entry.name, CUSTOM_ENGINE_MANIFEST_NAME);
+            if (!fs.existsSync(manifestPath)) {
+                continue;
+            }
+            let manifest;
+            try {
+                manifest = parseManifest(manifestPath, root);
+            }
+            catch (err) {
+                onError?.(manifestPath, err);
+                continue;
+            }
+            if (!seen.has(manifest.id)) {
+                seen.add(manifest.id);
+                manifests.push(manifest);
+            }
+        }
+    }
+    return manifests;
+}
+function resolveCustomEngineManifest(workspaceRoot, requestedId, extraSearchPath, onError) {
+    const discovered = discoverCustomEngineManifests(workspaceRoot, extraSearchPath, onError);
+    const requested = requestedId ? normalizeCustomEngineId(requestedId) : undefined;
+    if (requested) {
+        const matched = discovered.find(m => m.id === requested);
+        if (!matched) {
+            const available = discovered.map(m => m.id).sort();
+            throw new Error(available.length > 0
+                ? `Custom engine "${requested}" not found. Available: ${available.join(', ')}`
+                : `Custom engine "${requested}" not found. No manifests discovered under ${branding_1.AGENTIDE_DIR_NAME}/engines.`);
+        }
+        return matched;
+    }
+    if (discovered.length === 0) {
+        throw new Error(`No custom engines found. Add ${CUSTOM_ENGINE_MANIFEST_NAME} under ${branding_1.AGENTIDE_DIR_NAME}/engines/<engine-id>/`);
+    }
+    if (discovered.length > 1) {
+        const ids = discovered.map(m => m.id).sort();
+        throw new Error(`Multiple custom engines found (${ids.join(', ')}). Specify one with --engine <id>.`);
+    }
+    return discovered[0];
+}
+/**
+ * Safe variant: returns undefined instead of throwing when the engine is not found.
+ * Use at CLI startup for default-model pre-fill to avoid crashing before the user's
+ * request is even processed.
+ */
+function tryResolveCustomEngineManifest(workspaceRoot, requestedId, extraSearchPath, onError) {
+    try {
+        return resolveCustomEngineManifest(workspaceRoot, requestedId, extraSearchPath, onError);
+    }
+    catch {
+        return undefined;
+    }
+}

package/out/engines/embeddedCustomEngineRunner.generated.js

@@ -0,0 +1,9 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *  AUTO-GENERATED by scripts/generate-embedded-custom-engine-runner.mjs — do not edit.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE = exports.EMBEDDED_CUSTOM_ENGINE_RUNNER_HASH = void 0;
+exports.EMBEDDED_CUSTOM_ENGINE_RUNNER_HASH = "fe3840b3a767b36e";
+exports.EMBEDDED_CUSTOM_ENGINE_RUNNER_SOURCE = "\"use strict\";\n/*---------------------------------------------------------------------------------------------\n *  Copyright (c) AgentHippo.ai. All rights reserved.\n *--------------------------------------------------------------------------------------------*/\nvar __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    var desc = Object.getOwnPropertyDescriptor(m, k);\n    if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n    }\n    Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    o[k2] = m[k];\n}));\nvar __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n    o[\"default\"] = v;\n});\nvar __importStar = (this && this.__importStar) || (function () {\n    var ownKeys = function(o) {\n        ownKeys = Object.getOwnPropertyNames || function (o) {\n            var ar = [];\n            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;\n            return ar;\n        };\n        return ownKeys(o);\n    };\n    return function (mod) {\n        if (mod && mod.__esModule) return mod;\n        var result = {};\n        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== \"default\") __createBinding(result, mod, k[i]);\n        __setModuleDefault(result, mod);\n        return result;\n    };\n})();\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.runCustomEngineRunnerMain = runCustomEngineRunnerMain;\nconst node_readline_1 = require(\"node:readline\");\nconst node_url_1 = require(\"node:url\");\nconst path = __importStar(require(\"node:path\"));\n/** Must stay self-contained — this file is embedded and run from ~/.agent-hippo/cache/cli/. */\nconst AGENTHIPPO_MCP_SERVERS_ENV = 'AGENTHIPPO_MCP_SERVERS';\nfunction parseInlineMcpServers(raw) {\n    if (!raw?.trim()) {\n        return undefined;\n    }\n    try {\n        const parsed = JSON.parse(raw);\n        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n            return undefined;\n        }\n        return parsed;\n    }\n    catch {\n        return undefined;\n    }\n}\nfunction emitEvent(obj) {\n    process.stdout.write(`${JSON.stringify(obj)}\\n`);\n}\nconst runtime = {\n    logger: {\n        info: () => { },\n        warn: () => { },\n        error: () => { },\n    },\n};\n/** Apply the engine entry's directory to cwd + NODE_PATH so its node_modules resolve. */\nfunction applyEngineDir(entryPath) {\n    const engineDir = path.dirname(entryPath);\n    process.chdir(engineDir);\n    const engineNodeModules = path.join(engineDir, 'node_modules');\n    const existingNodePath = process.env.NODE_PATH?.trim();\n    process.env.NODE_PATH = existingNodePath\n        ? `${engineNodeModules}${path.delimiter}${existingNodePath}`\n        : engineNodeModules;\n}\n/** Import the engine module and instantiate the exported engine (must provide run(turn)). */\nasync function loadEngine(entryPath, engineExport) {\n    const mod = (await import((0, node_url_1.pathToFileURL)(entryPath).href));\n    const exported = (engineExport ? (mod[engineExport] ?? mod.default?.[engineExport]) : undefined) ??\n        mod.default;\n    const EngineClass = typeof exported === 'function' ? exported : null;\n    const engine = EngineClass ? new EngineClass() : exported;\n    if (!engine || typeof engine.run !== 'function') {\n        throw new Error('Engine export must provide run(turn)');\n    }\n    return engine;\n}\n/**\n * Build a CustomEngineTurn from an env map (shared by one-shot and persistent modes).\n *\n * ENGINE CONTRACT: in persistent mode a single warm worker serves many chat sessions, and its\n * process.env is frozen at first spawn (the *first* turn's secrets/session keys). Per-turn values\n * arrive here in `env` (the worker's per-turn `run` message), never on process.env. Engines must\n * therefore read all per-turn state from `turn.env`/`turn.routing`/`turn.session` and never from\n * `process.env` directly, or they will see the spawn-time values for the worker's whole lifetime\n * and cross-wire sessions.\n */\nfunction buildTurn(env, emitter, signal) {\n    const entryPath = env.AGENTHIPPO_ENGINE_ENTRY?.trim() ?? '';\n    const engineDir = path.dirname(entryPath);\n    const message = env.AGENTHIPPO_MESSAGE ?? '';\n    const workspaceRoot = env.AGENTHIPPO_WORKSPACE_ROOT ?? process.cwd();\n    const modelId = env.AGENTHIPPO_MODEL_ID ?? 'auto';\n    const sessionKey = env.AGENTHIPPO_CONVERSATION_KEY?.trim()\n        || env.AGENTIDE_CHAT_SESSION_ID?.trim()\n        || env.AGENTHIPPO_CHAT_SESSION_ID?.trim()\n        || 'runner';\n    const chatSessionId = env.AGENTIDE_CHAT_SESSION_ID?.trim()\n        || env.AGENTHIPPO_CHAT_SESSION_ID?.trim()\n        || sessionKey;\n    const contextSessionId = env.AGENTHIPPO_CONTEXT_SESSION_ID?.trim() || chatSessionId;\n    const mcpServers = parseInlineMcpServers(env[AGENTHIPPO_MCP_SERVERS_ENV]);\n    return {\n        message,\n        modelId,\n        workspaceRoot,\n        additionalDirectories: [],\n        permissions: { fileAccess: 'full' },\n        env: { ...env },\n        routing: {\n            useLiteLLM: env.AGENTHIPPO_USE_LITELLM === 'true',\n            ...(env.AGENTHIPPO_API_KEY ? { apiKey: env.AGENTHIPPO_API_KEY } : {}),\n            ...(env.AGENTHIPPO_BASE_URL ? { baseUrl: env.AGENTHIPPO_BASE_URL } : {}),\n            ...(env.AGENTHIPPO_OPENAI_BASE_URL ? { openaiBaseUrl: env.AGENTHIPPO_OPENAI_BASE_URL } : {}),\n        },\n        session: {\n            key: sessionKey,\n            chatSessionId,\n            contextSessionId,\n            isEphemeral: env.AGENTHIPPO_IS_EPHEMERAL === 'true',\n            engineHomeDir: env.AGENTHIPPO_ENGINE_HOME?.trim() || engineDir,\n            engineSessionDir: env.AGENTHIPPO_ENGINE_SESSION_DIR?.trim() || engineDir,\n            nativeSessionId: env.AGENTHIPPO_NATIVE_SESSION_ID?.trim() || undefined,\n            contextFilePath: env.AGENTHIPPO_CONTEXT_EXPORT_PATH?.trim() || undefined,\n            terminalLogPath: env.AGENTHIPPO_TERMINAL_LOG_PATH?.trim() || undefined,\n            attachmentsDir: env.AGENTHIPPO_ATTACHMENTS_DIR?.trim() || undefined,\n        },\n        agent: { id: env.AGENTHIPPO_ACTIVE_AGENT ?? 'default' },\n        ...(mcpServers ? { mcpServers } : {}),\n        emitter,\n        runtime,\n        signal,\n    };\n}\n/**\n * One-shot mode (strategy \"node-subprocess\"): build one turn from process.env, run, exit.\n * Parent sets AGENTHIPPO_* env vars before spawn.\n */\nasync function runOnce() {\n    const entryPath = process.env.AGENTHIPPO_ENGINE_ENTRY?.trim();\n    if (!entryPath) {\n        emitEvent({ type: 'error', message: 'AGENTHIPPO_ENGINE_ENTRY is required' });\n        return 1;\n    }\n    applyEngineDir(entryPath);\n    let doneEmitted = false;\n    const emitter = {\n        async text(delta) { emitEvent({ type: 'text', delta }); },\n        async thinking(delta) { emitEvent({ type: 'thinking', delta }); },\n        async toolStart(toolName, input, toolCallId) { emitEvent({ type: 'toolStart', toolName, input, toolCallId }); },\n        async toolEnd(toolName, toolCallId, result, isError) { emitEvent({ type: 'toolEnd', toolName, toolCallId, result, isError }); },\n        async progress(msg) { emitEvent({ type: 'progress', message: msg }); },\n        async error(msg) { emitEvent({ type: 'error', message: msg }); },\n        async done() {\n            // Engines call done(); runner also calls done() after run — emit at most once.\n            if (doneEmitted) {\n                return;\n            }\n            doneEmitted = true;\n            emitEvent({ type: 'done' });\n        },\n        async question() {\n            return { selected: [], freeText: null, declined: true };\n        },\n    };\n    try {\n        const engine = await loadEngine(entryPath, process.env.AGENTHIPPO_ENGINE_EXPORT?.trim());\n        if (process.env.AGENTHIPPO_CUSTOM_ENGINE_PROBE === 'import') {\n            emitEvent({ type: 'probe', ok: true });\n            return 0;\n        }\n        const turn = buildTurn(process.env, emitter);\n        const result = await engine.run(turn);\n        if (result?.nativeSessionId) {\n            emitEvent({ type: 'nativeSessionId', nativeSessionId: result.nativeSessionId });\n        }\n        await emitter.done();\n        return 0;\n    }\n    catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        emitEvent({ type: 'error', message: msg });\n        return 1;\n    }\n}\n/**\n * Persistent mode (strategy \"persistent-worker\"): load the engine once (SDK stays warm),\n * then serve turns from stdin NDJSON requests, tagging each event with its run id so the\n * host can multiplex concurrent turns. The host recycles this child on failure.\n */\nasync function runPersistent() {\n    const entryPath = process.env.AGENTHIPPO_ENGINE_ENTRY?.trim();\n    if (!entryPath) {\n        emitEvent({ type: 'error', message: 'AGENTHIPPO_ENGINE_ENTRY is required' });\n        process.exit(1);\n    }\n    applyEngineDir(entryPath);\n    let engine;\n    try {\n        engine = await loadEngine(entryPath, process.env.AGENTHIPPO_ENGINE_EXPORT?.trim());\n    }\n    catch (err) {\n        emitEvent({ type: 'error', message: err instanceof Error ? err.message : String(err) });\n        process.exit(1);\n    }\n    const controllers = new Map();\n    const makeEmitter = (id) => {\n        const emit = (event) => emitEvent({ id, event });\n        let doneEmitted = false;\n        return {\n            async text(delta) { emit({ type: 'text', delta }); },\n            async thinking(delta) { emit({ type: 'thinking', delta }); },\n            async toolStart(toolName, input, toolCallId) { emit({ type: 'toolStart', toolName, input, toolCallId }); },\n            async toolEnd(toolName, toolCallId, result, isError) { emit({ type: 'toolEnd', toolName, toolCallId, result, isError }); },\n            async progress(msg) { emit({ type: 'progress', message: msg }); },\n            async error(msg) { emit({ type: 'error', message: msg }); },\n            async done() {\n                if (doneEmitted) {\n                    return;\n                }\n                doneEmitted = true;\n                emit({ type: 'done' });\n            },\n            async question() {\n                return { selected: [], freeText: null, declined: true };\n            },\n        };\n    };\n    const handleRun = async (id, runEnv) => {\n        const controller = new AbortController();\n        controllers.set(id, controller);\n        const emitter = makeEmitter(id);\n        try {\n            // Build the turn purely from this turn's runEnv — it is a complete environment\n            // (host buildRunnerChildEnv spreads process.env + the per-turn block). Do NOT merge\n            // the worker's process.env or mutate it: a warm worker serves many chat sessions, and\n            // per-session keys (AGENTHIPPO_NATIVE_SESSION_ID/CONVERSATION_KEY) are only present for\n            // sessions that have them, so leaking them across turns cross-wires Cursor sessions.\n            const turn = buildTurn(runEnv, emitter, controller.signal);\n            const result = await engine.run(turn);\n            await emitter.done();\n            // Terminal control message — sent after the engine fully settles so nativeSessionId\n            // is captured even though engines call done() mid-run.\n            emitEvent({ type: 'result', id, nativeSessionId: result?.nativeSessionId });\n        }\n        catch (err) {\n            const message = err instanceof Error ? err.message : String(err);\n            emitEvent({ id, event: { type: 'error', message } });\n            emitEvent({ type: 'failed', id, message });\n        }\n        finally {\n            controllers.delete(id);\n        }\n    };\n    const rl = (0, node_readline_1.createInterface)({ input: process.stdin });\n    rl.on('line', line => {\n        const trimmed = line.trim();\n        if (!trimmed) {\n            return;\n        }\n        let req;\n        try {\n            req = JSON.parse(trimmed);\n        }\n        catch {\n            return;\n        }\n        if (req.type === 'run' && typeof req.id === 'string') {\n            void handleRun(req.id, req.env ?? {});\n        }\n        else if (req.type === 'abort' && typeof req.id === 'string') {\n            controllers.get(req.id)?.abort();\n        }\n        else if (req.type === 'shutdown') {\n            rl.close();\n        }\n    });\n    rl.on('close', () => {\n        for (const controller of controllers.values()) {\n            controller.abort();\n        }\n        process.exit(0);\n    });\n    emitEvent({ type: 'ready' });\n}\n/**\n * Exported one-shot entry. NOTE: this is always one-shot regardless of AGENTHIPPO_RUNNER_MODE —\n * persistent mode is selected only by the module-bottom dispatch below (the real CLI entrypoint),\n * not by this function. Callers that import this module get one-shot behavior from this export.\n */\nasync function runCustomEngineRunnerMain() {\n    return runOnce();\n}\n// Module-level dispatch is the actual entrypoint: the mode is fixed at spawn by the env var the\n// host sets, so importing this module for its export still runs the correct loop for that mode.\nif (process.env.AGENTHIPPO_RUNNER_MODE === 'persistent') {\n    void runPersistent();\n}\nelse {\n    void runCustomEngineRunnerMain().then(code => { process.exit(code); }, err => {\n        emitEvent({ type: 'error', message: err instanceof Error ? err.message : String(err) });\n        process.exit(1);\n    });\n}\n";

package/out/engines/engineApiKey.js

@@ -0,0 +1,138 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+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.isValidCursorApiKey = isValidCursorApiKey;
+exports.isValidGenericApiKey = isValidGenericApiKey;
+exports.resolveEngineApiKeyForTurn = resolveEngineApiKeyForTurn;
+exports.formatMissingEngineApiKeyChatMessage = formatMissingEngineApiKeyChatMessage;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const agentEnvFile_1 = require("../utils/agentEnvFile");
+const PLACEHOLDER_KEYS = new Set(['sk-dummy']);
+/**
+ * Whether a Cursor API key looks usable (user/service account key from Cursor dashboard).
+ */
+function isValidCursorApiKey(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || PLACEHOLDER_KEYS.has(trimmed)) {
+        return false;
+    }
+    return trimmed.startsWith('crsr_');
+}
+/**
+ * Whether a generic engine API key env value looks usable.
+ */
+function isValidGenericApiKey(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || PLACEHOLDER_KEYS.has(trimmed)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Resolve the API key for a custom engine turn (mirrors engine-specific runtime checks).
+ */
+function resolveEngineApiKeyForTurn(engineId, apiKeyEnvVar, processEnv, turnEnv, routingApiKey) {
+    if (engineId === 'cursor') {
+        const candidates = [
+            processEnv[apiKeyEnvVar],
+            turnEnv[apiKeyEnvVar],
+        ].map(value => value?.trim()).filter(Boolean);
+        for (const key of candidates) {
+            if (isValidCursorApiKey(key)) {
+                return key;
+            }
+        }
+        return isValidCursorApiKey(routingApiKey?.trim()) ? routingApiKey.trim() : undefined;
+    }
+    const candidates = [
+        processEnv[apiKeyEnvVar],
+        turnEnv[apiKeyEnvVar],
+        routingApiKey,
+    ].map(value => value?.trim()).filter(Boolean);
+    for (const key of candidates) {
+        if (isValidGenericApiKey(key)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+function formatEnvFilePathForUser(envFilePath) {
+    const home = os.homedir();
+    if (envFilePath.startsWith(home + path.sep)) {
+        return `~${envFilePath.slice(home.length)}`;
+    }
+    return envFilePath;
+}
+/**
+ * Assistant-style chat message when a custom engine API key is missing (Option C).
+ */
+function formatMissingEngineApiKeyChatMessage(options) {
+    const envFilePath = formatEnvFilePathForUser(options.envFilePath ?? (0, agentEnvFile_1.getAgentHomeEnvFilePath)());
+    const name = options.displayName.trim() || options.engineId;
+    if (options.engineId === 'cursor') {
+        return [
+            `**${name}** needs a Cursor API key before it can run.`,
+            '',
+            `Add this line to \`${envFilePath}\` (create the file if it does not exist):`,
+            '',
+            '```',
+            `${options.apiKeyEnvVar}=crsr_your_key_here`,
+            '```',
+            '',
+            'Get a key from the Cursor dashboard (user or service account). Keys start with `crsr_`.',
+            '',
+            `If \`${options.apiKeyEnvVar}\` is already set in your shell environment, fix or unset it there too — shell values take priority over \`${envFilePath}\`.`,
+            '',
+            'Save the file, then send your message again.',
+        ].join('\n');
+    }
+    return [
+        `**${name}** needs \`${options.apiKeyEnvVar}\` before it can run.`,
+        '',
+        `Add it to \`${envFilePath}\` (create the file if it does not exist):`,
+        '',
+        '```',
+        `${options.apiKeyEnvVar}=your_key_here`,
+        '```',
+        '',
+        `If \`${options.apiKeyEnvVar}\` is already set in your shell environment, fix or unset it there too — shell values take priority over \`${envFilePath}\`.`,
+        '',
+        'Save the file, then send your message again.',
+    ].join('\n');
+}