@agenthippo-ai/agenthippo 0.1.0

package/out/test/branding.test.js

@@ -0,0 +1,229 @@
+"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 });
+require("mocha");
+const assert = __importStar(require("assert"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const branding_1 = require("../branding");
+const paths_1 = require("../agentpack/paths");
+// Import copyDirRecursiveWithTransform directly to avoid vscode dependency
+// This is a simplified re-implementation for testing only
+async function copyDirRecursiveWithTransformForTest(sourceDir, targetDir, transformMd) {
+    await fs.promises.mkdir(targetDir, { recursive: true });
+    const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const src = path.join(sourceDir, entry.name);
+        const dst = path.join(targetDir, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirRecursiveWithTransformForTest(src, dst, transformMd);
+        }
+        else if (entry.isFile()) {
+            const lowerName = entry.name.toLowerCase();
+            if (lowerName.endsWith('.md')) {
+                const content = await fs.promises.readFile(src, 'utf8');
+                await fs.promises.writeFile(dst, transformMd(content), 'utf8');
+            }
+            else {
+                await fs.promises.copyFile(src, dst);
+            }
+        }
+    }
+}
+// =============================================================================
+// Branding Constants Tests
+// =============================================================================
+suite('Branding Constants', () => {
+    test('AGENTIDE_BRAND_NAME is defined', () => {
+        assert.ok(branding_1.AGENTIDE_BRAND_NAME, 'Brand name should be defined');
+        assert.strictEqual(typeof branding_1.AGENTIDE_BRAND_NAME, 'string');
+    });
+    test('AGENTIDE_DIR_NAME is defined and starts with dot', () => {
+        assert.ok(branding_1.AGENTIDE_DIR_NAME, 'Directory name should be defined');
+        assert.strictEqual(typeof branding_1.AGENTIDE_DIR_NAME, 'string');
+        assert.ok(branding_1.AGENTIDE_DIR_NAME.startsWith('.'), 'Directory name should start with a dot');
+    });
+    test('AGENT_CONSTANTS.AGENTIDE_DIR_NAME matches branding', () => {
+        assert.strictEqual(paths_1.AGENT_CONSTANTS.AGENTIDE_DIR_NAME, branding_1.AGENTIDE_DIR_NAME, 'AGENT_CONSTANTS should use the same value as branding');
+    });
+});
+// =============================================================================
+// applyBrandingTokens Tests
+// =============================================================================
+suite('applyBrandingTokens', () => {
+    test('replaces {{AGENT_BRAND}} with brand name', () => {
+        const input = 'Welcome to {{AGENT_BRAND}}!';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, `Welcome to ${branding_1.AGENTIDE_BRAND_NAME}!`);
+    });
+    test('replaces {{AGENTIDE_BRAND}} with brand name', () => {
+        const input = 'Powered by {{AGENTIDE_BRAND}}';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, `Powered by ${branding_1.AGENTIDE_BRAND_NAME}`);
+    });
+    test('replaces {{BRAND_FOLDER}} with directory name', () => {
+        const input = 'Files are stored in {{BRAND_FOLDER}}/agents/';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, `Files are stored in ${branding_1.AGENTIDE_DIR_NAME}/agents/`);
+    });
+    test('replaces multiple tokens in same string', () => {
+        const input = '{{AGENT_BRAND}} stores data in {{BRAND_FOLDER}}/sessions/';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, `${branding_1.AGENTIDE_BRAND_NAME} stores data in ${branding_1.AGENTIDE_DIR_NAME}/sessions/`);
+    });
+    test('replaces multiple occurrences of same token', () => {
+        const input = '{{BRAND_FOLDER}}/agents/ and {{BRAND_FOLDER}}/sessions/';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, `${branding_1.AGENTIDE_DIR_NAME}/agents/ and ${branding_1.AGENTIDE_DIR_NAME}/sessions/`);
+    });
+    test('leaves text without tokens unchanged', () => {
+        const input = 'No tokens here';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, input);
+    });
+    test('handles empty string', () => {
+        const result = (0, branding_1.applyBrandingTokens)('');
+        assert.strictEqual(result, '');
+    });
+    test('is case-sensitive (does not replace lowercase)', () => {
+        const input = '{{agent_brand}} and {{brand_folder}}';
+        const result = (0, branding_1.applyBrandingTokens)(input);
+        assert.strictEqual(result, input, 'Lowercase tokens should not be replaced');
+    });
+});
+// =============================================================================
+// brandify Tests
+// =============================================================================
+suite('brandify', () => {
+    test('replaces AgentIDE with brand name', () => {
+        const input = 'Welcome to AgentIDE!';
+        const result = (0, branding_1.brandify)(input);
+        assert.strictEqual(result, `Welcome to ${branding_1.AGENTIDE_BRAND_NAME}!`);
+    });
+    test('applies branding tokens and replaces AgentIDE', () => {
+        const input = '{{AGENT_BRAND}} (AgentIDE) folder: {{BRAND_FOLDER}}';
+        const result = (0, branding_1.brandify)(input);
+        assert.strictEqual(result, `${branding_1.AGENTIDE_BRAND_NAME} (${branding_1.AGENTIDE_BRAND_NAME}) folder: ${branding_1.AGENTIDE_DIR_NAME}`);
+    });
+});
+// =============================================================================
+// copyDirRecursiveWithTransform Tests
+// =============================================================================
+suite('copyDirRecursiveWithTransform', () => {
+    let tempDir;
+    let srcDir;
+    let dstDir;
+    setup(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'branding-test-'));
+        srcDir = path.join(tempDir, 'src');
+        dstDir = path.join(tempDir, 'dst');
+        fs.mkdirSync(srcDir, { recursive: true });
+    });
+    teardown(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    test('applies transform to .md files', async () => {
+        // Create source file with token
+        const mdContent = 'Files in {{BRAND_FOLDER}}/skills/';
+        fs.writeFileSync(path.join(srcDir, 'README.md'), mdContent);
+        // Copy with transform
+        await copyDirRecursiveWithTransformForTest(srcDir, dstDir, branding_1.applyBrandingTokens);
+        // Verify transform was applied
+        const result = fs.readFileSync(path.join(dstDir, 'README.md'), 'utf8');
+        assert.strictEqual(result, `Files in ${branding_1.AGENTIDE_DIR_NAME}/skills/`);
+    });
+    test('does not transform non-md files', async () => {
+        // Create source files
+        const jsContent = 'const folder = "{{BRAND_FOLDER}}";';
+        fs.writeFileSync(path.join(srcDir, 'script.js'), jsContent);
+        // Copy with transform
+        await copyDirRecursiveWithTransformForTest(srcDir, dstDir, branding_1.applyBrandingTokens);
+        // Verify .js file was NOT transformed
+        const result = fs.readFileSync(path.join(dstDir, 'script.js'), 'utf8');
+        assert.strictEqual(result, jsContent, 'Non-md files should not be transformed');
+    });
+    test('handles nested directories', async () => {
+        // Create nested structure
+        const nestedDir = path.join(srcDir, 'subdir');
+        fs.mkdirSync(nestedDir, { recursive: true });
+        fs.writeFileSync(path.join(nestedDir, 'SKILL.md'), 'Path: {{BRAND_FOLDER}}/agents/');
+        // Copy with transform
+        await copyDirRecursiveWithTransformForTest(srcDir, dstDir, branding_1.applyBrandingTokens);
+        // Verify nested file was transformed
+        const result = fs.readFileSync(path.join(dstDir, 'subdir', 'SKILL.md'), 'utf8');
+        assert.strictEqual(result, `Path: ${branding_1.AGENTIDE_DIR_NAME}/agents/`);
+    });
+    test('handles mixed content', async () => {
+        // Create mixed content
+        fs.writeFileSync(path.join(srcDir, 'doc.md'), '{{AGENT_BRAND}} guide');
+        fs.writeFileSync(path.join(srcDir, 'config.json'), '{"path": "{{BRAND_FOLDER}}"}');
+        fs.writeFileSync(path.join(srcDir, 'notes.MD'), 'Uppercase extension: {{BRAND_FOLDER}}');
+        // Copy with transform
+        await copyDirRecursiveWithTransformForTest(srcDir, dstDir, branding_1.applyBrandingTokens);
+        // .md transformed
+        assert.strictEqual(fs.readFileSync(path.join(dstDir, 'doc.md'), 'utf8'), `${branding_1.AGENTIDE_BRAND_NAME} guide`);
+        // .json NOT transformed
+        assert.strictEqual(fs.readFileSync(path.join(dstDir, 'config.json'), 'utf8'), '{"path": "{{BRAND_FOLDER}}"}');
+        // .MD (uppercase) transformed
+        assert.strictEqual(fs.readFileSync(path.join(dstDir, 'notes.MD'), 'utf8'), `Uppercase extension: ${branding_1.AGENTIDE_DIR_NAME}`);
+    });
+    test('creates destination directory if it does not exist', async () => {
+        fs.writeFileSync(path.join(srcDir, 'test.md'), 'content');
+        const newDst = path.join(tempDir, 'new', 'nested', 'dst');
+        await copyDirRecursiveWithTransformForTest(srcDir, newDst, branding_1.applyBrandingTokens);
+        assert.ok(fs.existsSync(path.join(newDst, 'test.md')));
+    });
+});
+// =============================================================================
+// Path Consistency Tests
+// =============================================================================
+suite('Path Constants Consistency', () => {
+    test('AGENT_CONSTANTS uses AGENTIDE_DIR_NAME from branding', () => {
+        // This ensures the constant is imported from branding, not hardcoded
+        assert.strictEqual(paths_1.AGENT_CONSTANTS.AGENTIDE_DIR_NAME, branding_1.AGENTIDE_DIR_NAME, 'Path constants should derive from branding module');
+    });
+    test('AGENTIDE_DIR_NAME does not contain path separators', () => {
+        assert.ok(!branding_1.AGENTIDE_DIR_NAME.includes('/') && !branding_1.AGENTIDE_DIR_NAME.includes('\\'), 'Directory name should not contain path separators');
+    });
+    test('AGENTIDE_DIR_NAME is a valid directory name', () => {
+        // Should not contain characters invalid for directory names
+        const invalidChars = /[<>:"|?*]/;
+        assert.ok(!invalidChars.test(branding_1.AGENTIDE_DIR_NAME), 'Directory name should not contain invalid filesystem characters');
+    });
+});

package/out/test/cli-agent-id.test.js

@@ -0,0 +1,55 @@
+"use strict";
+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 });
+const assert = __importStar(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const cli_agent_id_js_1 = require("../gateway/cli-agent-id.js");
+(0, node_test_1.describe)('cli-agent-id', () => {
+    (0, node_test_1.test)('resolveCliGatewayAgentId uses agenthippo-cli for default pack', () => {
+        assert.strictEqual((0, cli_agent_id_js_1.resolveCliGatewayAgentId)('default'), cli_agent_id_js_1.CLI_GATEWAY_AGENT_PREFIX);
+        assert.strictEqual((0, cli_agent_id_js_1.resolveCliGatewayAgentId)('Default'), cli_agent_id_js_1.CLI_GATEWAY_AGENT_PREFIX);
+        assert.strictEqual((0, cli_agent_id_js_1.resolveCliGatewayAgentId)(''), cli_agent_id_js_1.CLI_GATEWAY_AGENT_PREFIX);
+    });
+    (0, node_test_1.test)('resolveCliGatewayAgentId suffixes named packs', () => {
+        assert.strictEqual((0, cli_agent_id_js_1.resolveCliGatewayAgentId)('data-analyst'), 'agenthippo-cli-data-analyst');
+        assert.strictEqual((0, cli_agent_id_js_1.resolveCliGatewayAgentId)('Data Analyst'), 'agenthippo-cli-data-analyst');
+    });
+    (0, node_test_1.test)('isCliGatewayAgentId recognizes CLI gateway ids', () => {
+        assert.strictEqual((0, cli_agent_id_js_1.isCliGatewayAgentId)('agenthippo-cli'), true);
+        assert.strictEqual((0, cli_agent_id_js_1.isCliGatewayAgentId)('agenthippo-cli-data-analyst'), true);
+        assert.strictEqual((0, cli_agent_id_js_1.isCliGatewayAgentId)('default'), false);
+        assert.strictEqual((0, cli_agent_id_js_1.isCliGatewayAgentId)('ide-agenthippo-vscode'), false);
+    });
+});

package/out/test/credential-context.test.js

@@ -0,0 +1,105 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Credential Context Test Suite (serve-v3 §11.1, Design B)
+ *
+ *  The request-scoped credential primitive: presence, fail-closed access, and
+ *  — most important — isolation between concurrent async turns.
+ *--------------------------------------------------------------------------------------------*/
+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 });
+require("mocha");
+const assert = __importStar(require("assert"));
+const credential_context_1 = require("../cli/credential-context");
+const serve_hardening_1 = require("../cli/serve-hardening");
+suite('credential-context: presence + fail-closed', () => {
+    test('no credential outside a run scope', () => {
+        assert.strictEqual((0, credential_context_1.currentCredential)(), undefined);
+        assert.throws(() => (0, credential_context_1.requireUserId)(), /fail-closed/);
+    });
+    test('credential visible inside the scope', async () => {
+        await (0, credential_context_1.runWithCredential)({ userId: 'alice@acme.com', dataToken: 'tok' }, async () => {
+            assert.strictEqual((0, credential_context_1.requireUserId)(), 'alice@acme.com');
+            assert.strictEqual((0, credential_context_1.currentCredential)()?.dataToken, 'tok');
+        });
+    });
+    test('scope is cleared after the run returns', async () => {
+        await (0, credential_context_1.runWithCredential)({ userId: 'alice@acme.com' }, async () => undefined);
+        assert.strictEqual((0, credential_context_1.currentCredential)(), undefined);
+    });
+    test('returns the callback value (sync and async)', async () => {
+        const sync = await (0, credential_context_1.runWithCredential)({ userId: 'a' }, () => 42);
+        assert.strictEqual(sync, 42);
+        const asyncVal = await (0, credential_context_1.runWithCredential)({ userId: 'a' }, async () => {
+            await Promise.resolve();
+            return (0, credential_context_1.requireUserId)();
+        });
+        assert.strictEqual(asyncVal, 'a');
+    });
+    test('credential survives across awaits within the same turn', async () => {
+        await (0, credential_context_1.runWithCredential)({ userId: 'priya@meridian.com' }, async () => {
+            await new Promise((r) => setTimeout(r, 5));
+            assert.strictEqual((0, credential_context_1.requireUserId)(), 'priya@meridian.com');
+        });
+    });
+});
+suite('credential-context: concurrent isolation (the load-bearing property)', () => {
+    test('two interleaved turns never see each other\'s user', async () => {
+        // Interleave alice and bob with deliberate awaits; each must keep its own identity.
+        const run = (user, delay) => (0, credential_context_1.runWithCredential)({ userId: user }, async () => {
+            await new Promise((r) => setTimeout(r, delay));
+            const seen1 = (0, credential_context_1.requireUserId)();
+            await new Promise((r) => setTimeout(r, delay));
+            const seen2 = (0, credential_context_1.requireUserId)();
+            return [seen1, seen2];
+        });
+        const [alice, bob] = await Promise.all([
+            run('alice@acme.com', 8),
+            run('bob@acme.com', 3),
+        ]);
+        assert.deepStrictEqual(alice, ['alice@acme.com', 'alice@acme.com']);
+        assert.deepStrictEqual(bob, ['bob@acme.com', 'bob@acme.com']);
+    });
+});
+suite('credential-context: resolveDataToken (the OBO token seam)', () => {
+    test('Databricks X-Forwarded-Access-Token', () => {
+        assert.strictEqual((0, serve_hardening_1.resolveDataToken)({ 'x-forwarded-access-token': 'obo-123' }), 'obo-123');
+    });
+    test('generic X-Agent-Data-Token', () => {
+        assert.strictEqual((0, serve_hardening_1.resolveDataToken)({ 'x-agent-data-token': 'tok-9' }), 'tok-9');
+    });
+    test('undefined when absent', () => {
+        assert.strictEqual((0, serve_hardening_1.resolveDataToken)({}), undefined);
+    });
+});

package/out/test/customEngineInstall.test.js

@@ -0,0 +1,100 @@
+"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 });
+require("mocha");
+const assert = __importStar(require("assert"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const install_1 = require("../engines/install");
+suite('Custom engine install', () => {
+    let tempDir;
+    let originalAgentHomeDir;
+    let originalAgentHippoHome;
+    setup(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agentide-engine-install-'));
+        originalAgentHomeDir = process.env.AGENT_HOME_DIR;
+        originalAgentHippoHome = process.env.AGENTHIPPO_HOME;
+        delete process.env.AGENT_HOME_DIR;
+        process.env.AGENTHIPPO_HOME = path.join(tempDir, 'home');
+    });
+    teardown(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        restoreEnv('AGENT_HOME_DIR', originalAgentHomeDir);
+        restoreEnv('AGENTHIPPO_HOME', originalAgentHippoHome);
+    });
+    test('installs, lists, and uninstalls an engine from the home root', async () => {
+        const result = await (0, install_1.installCustomEngineFromFiles)([
+            {
+                path: 'engine.manifest.json',
+                content: JSON.stringify({
+                    version: 2,
+                    id: 'test-engine',
+                    displayName: 'Test Engine',
+                    entry: 'engine.mjs',
+                    promptInjection: { mode: 'env-only' },
+                }),
+            },
+            {
+                path: 'engine.mjs',
+                content: 'export default { async run() {} };\n',
+            },
+        ], {
+            runNpmCi: false,
+        });
+        assert.strictEqual(result.id, 'test-engine');
+        assert.strictEqual(result.installDir, path.join((0, install_1.getDefaultCustomEnginesInstallRoot)(), 'test-engine'));
+        const installed = await (0, install_1.listInstalledCustomEngines)();
+        assert.deepStrictEqual(installed.map(engine => engine.id), ['test-engine']);
+        const removed = await (0, install_1.uninstallCustomEngine)('test-engine');
+        assert.strictEqual(removed.removed, true);
+        assert.strictEqual(fs.existsSync(result.installDir), false);
+        assert.deepStrictEqual(await (0, install_1.listInstalledCustomEngines)(), []);
+    });
+    test('rejects unsafe uninstall ids', async () => {
+        await assert.rejects(() => (0, install_1.uninstallCustomEngine)('../outside'), /Custom engine id must contain only lowercase letters/);
+    });
+});
+function restoreEnv(name, value) {
+    if (value === undefined) {
+        delete process.env[name];
+    }
+    else {
+        process.env[name] = value;
+    }
+}

package/out/test/customRegistry.test.js

@@ -0,0 +1,122 @@
+"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 });
+require("mocha");
+const assert = __importStar(require("assert"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const customRegistry_1 = require("../engines/customRegistry");
+suite('Custom engine registry', () => {
+    let tempDir;
+    let originalAgentHippoCustomEnginesDir;
+    let originalAgentideCustomEnginesDir;
+    let originalAgentHomeDir;
+    let originalAgentHippoHome;
+    setup(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agentide-custom-registry-'));
+        originalAgentHippoCustomEnginesDir = process.env.AGENTHIPPO_CUSTOM_ENGINES_DIR;
+        originalAgentideCustomEnginesDir = process.env.AGENTIDE_CUSTOM_ENGINES_DIR;
+        originalAgentHomeDir = process.env.AGENT_HOME_DIR;
+        originalAgentHippoHome = process.env.AGENTHIPPO_HOME;
+        delete process.env.AGENTHIPPO_CUSTOM_ENGINES_DIR;
+        delete process.env.AGENTIDE_CUSTOM_ENGINES_DIR;
+        delete process.env.AGENT_HOME_DIR;
+        delete process.env.AGENTHIPPO_HOME;
+    });
+    teardown(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        restoreEnv('AGENTHIPPO_CUSTOM_ENGINES_DIR', originalAgentHippoCustomEnginesDir);
+        restoreEnv('AGENTIDE_CUSTOM_ENGINES_DIR', originalAgentideCustomEnginesDir);
+        restoreEnv('AGENT_HOME_DIR', originalAgentHomeDir);
+        restoreEnv('AGENTHIPPO_HOME', originalAgentHippoHome);
+    });
+    test('parses configured search path strings and arrays', () => {
+        const first = path.join(tempDir, 'first');
+        const second = path.join(tempDir, 'second');
+        const third = path.join(tempDir, 'third');
+        assert.deepStrictEqual((0, customRegistry_1.parseCustomEngineSearchPath)([first, `${second}${path.delimiter}${third}`]), [first, second, third]);
+    });
+    test('adds configured directories before environment and home roots', () => {
+        const configured = path.join(tempDir, 'configured');
+        const envRoot = path.join(tempDir, 'env');
+        process.env.AGENTHIPPO_CUSTOM_ENGINES_DIR = envRoot;
+        const roots = (0, customRegistry_1.getCustomEngineSearchRoots)(undefined, configured);
+        assert.strictEqual(roots[0], path.resolve(configured));
+        assert.strictEqual(roots[1], path.resolve(envRoot));
+    });
+    test('includes custom engine installer home root', () => {
+        const agentHome = path.join(tempDir, 'agent-home');
+        process.env.AGENTHIPPO_HOME = agentHome;
+        const roots = (0, customRegistry_1.getCustomEngineSearchRoots)(undefined, undefined);
+        assert.strictEqual(roots[0], path.join(agentHome, 'engines'));
+    });
+    test('discovers manifests from configured directories', () => {
+        const configured = path.join(tempDir, 'engines');
+        writeCustomEngineManifest(configured, 'external-test-engine');
+        const manifests = (0, customRegistry_1.discoverCustomEngineManifests)(undefined, configured);
+        const manifest = manifests.find(item => item.id === 'external-test-engine');
+        assert.ok(manifest);
+        assert.strictEqual(manifest.displayName, 'External Test Engine');
+        assert.strictEqual(manifest.searchRoot, path.resolve(configured));
+    });
+});
+function restoreEnv(name, value) {
+    if (value === undefined) {
+        delete process.env[name];
+    }
+    else {
+        process.env[name] = value;
+    }
+}
+function writeCustomEngineManifest(root, id) {
+    const engineDir = path.join(root, id);
+    fs.mkdirSync(engineDir, { recursive: true });
+    fs.writeFileSync(path.join(engineDir, 'engine.manifest.json'), JSON.stringify({
+        version: 2,
+        id,
+        displayName: 'External Test Engine',
+        entry: 'engine.mjs',
+        promptInjection: {
+            mode: 'env-only',
+        },
+        model: {
+            defaultModel: 'test-model',
+        },
+    }, null, 2), 'utf8');
+}