@agenthippo-ai/agenthippo 0.1.0

package/out/test/utils.test.js

@@ -0,0 +1,308 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Utils Test Suite
+ *
+ *  Tests for shared utilities: PID file management, path utilities, network probing, binary finding.
+ *--------------------------------------------------------------------------------------------*/
+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 index_1 = require("../utils/index");
+const branding_1 = require("../branding");
+const utils_1 = require("../utils");
+function setupPidTestDir() {
+    const ctx = { testDir: '', testPidFile: '' };
+    suiteSetup(() => {
+        ctx.testDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agentide-pid-test-'));
+        ctx.testPidFile = path.join(ctx.testDir, 'test.pid');
+    });
+    suiteTeardown(() => {
+        if (ctx.testDir) {
+            fs.rmSync(ctx.testDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 50 });
+        }
+    });
+    teardown(() => {
+        try {
+            fs.unlinkSync(ctx.testPidFile);
+        }
+        catch {
+            // File may not exist
+        }
+    });
+    return ctx;
+}
+suite('PID Utilities - isProcessRunning', () => {
+    test('returns true for current process', () => {
+        assert.strictEqual((0, index_1.isProcessRunning)(process.pid), true);
+    });
+    test('returns false for non-existent PID', () => {
+        assert.strictEqual((0, index_1.isProcessRunning)(999999999), false);
+    });
+    test('handles edge case PIDs gracefully', () => {
+        // On Unix, kill(0, 0) sends to current process group (returns true)
+        // kill(-1, 0) sends to all processes user can signal (returns true)
+        // This test just ensures we don't throw, behavior may vary by platform
+        const zeroResult = (0, index_1.isProcessRunning)(0);
+        const negResult = (0, index_1.isProcessRunning)(-1);
+        assert.strictEqual(typeof zeroResult, 'boolean');
+        assert.strictEqual(typeof negResult, 'boolean');
+    });
+});
+suite('PID Utilities - isProcessRunningAsync', () => {
+    test('returns true for current process', async () => {
+        assert.strictEqual(await (0, index_1.isProcessRunningAsync)(process.pid), true);
+    });
+    test('returns false for non-existent PID', async () => {
+        assert.strictEqual(await (0, index_1.isProcessRunningAsync)(999999999), false);
+    });
+});
+suite('PID Utilities - writePidFile / readPidFile', () => {
+    const ctx = setupPidTestDir();
+    test('writes and reads PID file correctly', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, 12345);
+        const data = await (0, index_1.readPidFile)(ctx.testPidFile);
+        assert.strictEqual(data?.pid, 12345);
+        assert.deepStrictEqual(data?.metadata, []);
+    });
+    test('writes and reads PID file with metadata', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, 12345, 'otel', 'url=http://localhost:4000');
+        const data = await (0, index_1.readPidFile)(ctx.testPidFile);
+        assert.strictEqual(data?.pid, 12345);
+        assert.deepStrictEqual(data?.metadata, ['otel', 'url=http://localhost:4000']);
+    });
+    test('returns null for non-existent file', async () => {
+        const data = await (0, index_1.readPidFile)('/nonexistent/path/file.pid');
+        assert.strictEqual(data, null);
+    });
+    test('returns null for invalid PID file content', async () => {
+        fs.writeFileSync(ctx.testPidFile, 'not-a-number\n');
+        const data = await (0, index_1.readPidFile)(ctx.testPidFile);
+        assert.strictEqual(data, null);
+    });
+    test('creates parent directories if needed', async () => {
+        const nestedPidFile = path.join(ctx.testDir, 'nested', 'dir', 'test.pid');
+        await (0, index_1.writePidFile)(nestedPidFile, 12345);
+        const data = await (0, index_1.readPidFile)(nestedPidFile);
+        assert.strictEqual(data?.pid, 12345);
+        fs.rmSync(path.join(ctx.testDir, 'nested'), { recursive: true, force: true });
+    });
+});
+suite('PID Utilities - removePidFile', () => {
+    const ctx = setupPidTestDir();
+    test('removes existing PID file', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, 12345);
+        assert.strictEqual(fs.existsSync(ctx.testPidFile), true);
+        await (0, index_1.removePidFile)(ctx.testPidFile);
+        assert.strictEqual(fs.existsSync(ctx.testPidFile), false);
+    });
+    test('does not throw for non-existent file', async () => {
+        await (0, index_1.removePidFile)('/nonexistent/path/file.pid');
+        // Should not throw
+    });
+});
+suite('PID Utilities - isPidFileProcessRunning', () => {
+    const ctx = setupPidTestDir();
+    test('returns true when PID file contains current process', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, process.pid);
+        assert.strictEqual(await (0, index_1.isPidFileProcessRunning)(ctx.testPidFile), true);
+    });
+    test('returns false when PID file contains non-existent process', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, 999999999);
+        assert.strictEqual(await (0, index_1.isPidFileProcessRunning)(ctx.testPidFile), false);
+    });
+    test('returns false when PID file does not exist', async () => {
+        assert.strictEqual(await (0, index_1.isPidFileProcessRunning)('/nonexistent/path/file.pid'), false);
+    });
+});
+suite('PID Utilities - checkPidFileWithCleanup', () => {
+    const ctx = setupPidTestDir();
+    test('returns PID data when process is running', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, process.pid, 'metadata');
+        const result = await (0, index_1.checkPidFileWithCleanup)(ctx.testPidFile);
+        assert.strictEqual(result?.pid, process.pid);
+        assert.deepStrictEqual(result?.metadata, ['metadata']);
+        assert.strictEqual(fs.existsSync(ctx.testPidFile), true);
+    });
+    test('returns null and cleans up stale PID file', async () => {
+        await (0, index_1.writePidFile)(ctx.testPidFile, 999999999);
+        const result = await (0, index_1.checkPidFileWithCleanup)(ctx.testPidFile);
+        assert.strictEqual(result, null);
+        assert.strictEqual(fs.existsSync(ctx.testPidFile), false);
+    });
+    test('returns null when PID file does not exist', async () => {
+        const result = await (0, index_1.checkPidFileWithCleanup)('/nonexistent/path/file.pid');
+        assert.strictEqual(result, null);
+    });
+});
+// =============================================================================
+// Path Utilities Tests
+// =============================================================================
+suite('Path Utilities - getAgentideHome', () => {
+    test('returns home directory with AGENTIDE_DIR_NAME', () => {
+        const result = (0, index_1.getAgentideHome)();
+        assert.strictEqual(result, path.join(os.homedir(), branding_1.AGENTIDE_DIR_NAME));
+    });
+});
+suite('Path Utilities - getAgentidePath', () => {
+    test('appends subpaths to home directory', () => {
+        const result = (0, index_1.getAgentidePath)('subdir', 'file.txt');
+        assert.strictEqual(result, path.join(os.homedir(), branding_1.AGENTIDE_DIR_NAME, 'subdir', 'file.txt'));
+    });
+    test('returns home directory when called with no args', () => {
+        assert.strictEqual((0, index_1.getAgentidePath)(), (0, index_1.getAgentideHome)());
+    });
+});
+suite('Path Utilities - PID_FILES', () => {
+    test('returns correct gateway PID file path', () => {
+        assert.strictEqual(index_1.PID_FILES.gateway(), (0, index_1.getAgentidePath)('gateway.pid'));
+    });
+    test('returns correct litellm PID file path', () => {
+        assert.strictEqual(index_1.PID_FILES.litellm(), (0, index_1.getAgentidePath)('litellm.pid'));
+    });
+    test('returns correct otelcol PID file path', () => {
+        assert.strictEqual(index_1.PID_FILES.otelcol(), (0, index_1.getAgentidePath)('analytics', 'otelcol.pid'));
+    });
+});
+suite('Path Utilities - DIRS', () => {
+    test('returns correct analytics directory', () => {
+        assert.strictEqual(index_1.DIRS.analytics(), (0, index_1.getAgentidePath)('analytics'));
+    });
+    test('returns correct credentials directory', () => {
+        assert.strictEqual(index_1.DIRS.credentials(), (0, index_1.getAgentidePath)('credentials'));
+    });
+    test('returns correct sessions directory', () => {
+        assert.strictEqual(index_1.DIRS.sessions(), (0, index_1.getAgentidePath)('sessions'));
+    });
+});
+// =============================================================================
+// Network Utilities Tests
+// =============================================================================
+suite('Network Utilities - probePort', () => {
+    test('returns false for unused port', async () => {
+        const unusedPort = 59999;
+        const result = await (0, index_1.probePort)(unusedPort, '127.0.0.1', 500);
+        assert.strictEqual(result, false);
+    });
+    test('times out gracefully', async () => {
+        const start = Date.now();
+        await (0, index_1.probePort)(59998, '127.0.0.1', 100);
+        const elapsed = Date.now() - start;
+        assert.ok(elapsed < 500, `Expected < 500ms but took ${elapsed}ms`);
+    });
+});
+// =============================================================================
+// Binary Utilities Tests
+// =============================================================================
+suite('Binary Utilities - findBinary', () => {
+    test('finds node binary', async () => {
+        const result = await (0, index_1.findBinary)('node');
+        assert.ok(result, 'node binary should be found');
+        assert.ok(result.includes('node'), `Expected path to contain 'node', got: ${result}`);
+    });
+    test('returns undefined for non-existent binary', async () => {
+        const result = await (0, index_1.findBinary)('nonexistent-binary-xyz-12345');
+        assert.strictEqual(result, undefined);
+    });
+});
+suite('Binary Utilities - findBinaryCached', () => {
+    setup(() => {
+        (0, index_1.clearBinaryCache)();
+    });
+    test('caches binary path', async () => {
+        const result1 = await (0, index_1.findBinaryCached)('node');
+        const result2 = await (0, index_1.findBinaryCached)('node');
+        assert.strictEqual(result1, result2);
+    });
+    test('checks common paths if not on PATH', async () => {
+        // Use a unique name to avoid cache collision
+        const uniqueName = 'nonexistent-binary-' + Date.now();
+        // Use /bin/sh on macOS, /usr/bin/env on Linux (both are reliable)
+        const testPath = process.platform === 'darwin' ? '/bin/sh' : '/usr/bin/env';
+        const result = await (0, index_1.findBinaryCached)(uniqueName, [testPath]);
+        if (process.platform !== 'win32') {
+            assert.strictEqual(result, testPath);
+        }
+    });
+});
+suite('Binary Utilities - getCommonBinaryPaths', () => {
+    test('returns array of paths', () => {
+        const paths = (0, index_1.getCommonBinaryPaths)('openclaw');
+        assert.ok(Array.isArray(paths));
+        assert.ok(paths.length > 0);
+    });
+    test('includes platform-specific paths', () => {
+        const paths = (0, index_1.getCommonBinaryPaths)('openclaw');
+        if (process.platform === 'win32') {
+            assert.ok(paths.some((p) => p.includes('AppData')));
+        }
+        else if (process.platform === 'darwin') {
+            assert.ok(paths.some((p) => p.includes('Library/pnpm')));
+        }
+        else {
+            assert.ok(paths.some((p) => p.includes('.local/share/pnpm')));
+        }
+    });
+});
+suite('Binary Utilities - clearBinaryCache', () => {
+    test('clears specific binary from cache', async () => {
+        await (0, index_1.findBinaryCached)('node');
+        (0, index_1.clearBinaryCache)('node');
+        await (0, index_1.findBinaryCached)('node');
+        // Should not throw
+    });
+    test('clears all binaries from cache', async () => {
+        await (0, index_1.findBinaryCached)('node');
+        (0, index_1.clearBinaryCache)();
+        await (0, index_1.findBinaryCached)('node');
+        // Should not throw
+    });
+});
+suite('File Change Kind Normalization', () => {
+    test('normalizes add/create to create', () => {
+        assert.strictEqual((0, utils_1.normalizeFileChangeKind)('add'), 'create');
+        assert.strictEqual((0, utils_1.normalizeFileChangeKind)('create'), 'create');
+    });
+    test('normalizes update/modify to modify', () => {
+        assert.strictEqual((0, utils_1.normalizeFileChangeKind)('update'), 'modify');
+        assert.strictEqual((0, utils_1.normalizeFileChangeKind)('modify'), 'modify');
+    });
+    test('returns undefined for unknown kinds', () => {
+        assert.strictEqual((0, utils_1.normalizeFileChangeKind)('rename'), undefined);
+    });
+});

package/out/test/viewsConfigMerge.test.js

@@ -0,0 +1,180 @@
+"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 viewsConfigMerge_1 = require("../analytics/dashboard/viewsConfigMerge");
+function minimalConfig(activeViewId, views) {
+    return { version: 1, activeViewId, views };
+}
+suite('viewsConfigMerge', () => {
+    test('normalizeDashboardViewId lowercases and sanitizes', () => {
+        assert.strictEqual((0, viewsConfigMerge_1.normalizeDashboardViewId)('My View'), 'my-view');
+        assert.strictEqual((0, viewsConfigMerge_1.normalizeDashboardViewId)('  '), 'global');
+    });
+    test('formatDisplayNameForAllocatedViewId adds numeric suffix from id', () => {
+        assert.strictEqual((0, viewsConfigMerge_1.formatDisplayNameForAllocatedViewId)('Workspace Copy', 'workspace-copy'), 'Workspace Copy');
+        assert.strictEqual((0, viewsConfigMerge_1.formatDisplayNameForAllocatedViewId)('Workspace Copy', 'workspace-copy-3'), 'Workspace Copy 3');
+        assert.strictEqual((0, viewsConfigMerge_1.formatDisplayNameForAllocatedViewId)('Workspace Copy', 'workspace-copy-12'), 'Workspace Copy 12');
+    });
+    test('workspace view overrides global view with same id', () => {
+        const global = minimalConfig('global', [
+            { id: 'custom', name: 'Global Name', scope: 'global', scripts: ['a.js'] },
+        ]);
+        const workspace = minimalConfig('workspace', [
+            { id: 'custom', name: 'Workspace Name', scope: 'workspace', scripts: ['b.js'] },
+        ]);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, workspace);
+        const custom = merged.views.find(v => v.id === 'custom');
+        assert.ok(custom);
+        assert.strictEqual(custom.name, 'Workspace Name');
+        assert.deepStrictEqual(custom.scripts, ['b.js']);
+    });
+    test('prefers workspace activeViewId over global when workspace yaml exists', () => {
+        const global = minimalConfig('custom', [
+            { id: 'custom', name: 'Custom', scope: 'global', scripts: [] },
+            { id: 'global', name: 'Global', scope: 'global', scripts: [] },
+        ]);
+        const workspace = minimalConfig('workspace', [
+            { id: 'workspace', name: 'Workspace', scope: 'workspace', scripts: [] },
+        ]);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, workspace);
+        assert.strictEqual(merged.activeViewId, 'workspace');
+    });
+    test('workspace activeViewId may name a global-scoped view in the merged catalog', () => {
+        const defaults = (0, viewsConfigMerge_1.createDefaultDashboardViewsConfig)('global');
+        const global = minimalConfig('global', defaults.views);
+        const workspace = minimalConfig('fleet', defaults.views);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, workspace, defaults);
+        assert.strictEqual(merged.activeViewId, 'fleet');
+    });
+    test('prefers workspace activeViewId for workspace-scoped custom view over stale global active', () => {
+        const global = minimalConfig('global', [
+            { id: 'global', name: 'Global', scope: 'global', scripts: [] },
+        ]);
+        const workspace = minimalConfig('workspace-copy', [
+            { id: 'workspace', name: 'Workspace', scope: 'workspace', scripts: [] },
+            { id: 'workspace-copy', name: 'Workspace Copy', scope: 'workspace', scripts: [] },
+        ]);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, workspace);
+        assert.strictEqual(merged.activeViewId, 'workspace-copy');
+    });
+    test('falls back when workspace activeViewId is orphan', () => {
+        const defaults = (0, viewsConfigMerge_1.createDefaultDashboardViewsConfig)('global');
+        const global = minimalConfig('global', defaults.views);
+        const workspace = minimalConfig('deleted-view', defaults.views);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, workspace, defaults);
+        assert.strictEqual(merged.activeViewId, 'workspace');
+    });
+    test('uses global activeViewId when no workspace yaml', () => {
+        const global = minimalConfig('fleet', [
+            { id: 'fleet', name: 'Fleet', scope: 'global', scripts: ['agent-fleet-widget.js'], system: true },
+            { id: 'global', name: 'Global', scope: 'global', scripts: [] },
+        ]);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, undefined);
+        assert.strictEqual(merged.activeViewId, 'fleet');
+    });
+    test('global-only orphan active falls back to default then global', () => {
+        const defaults = (0, viewsConfigMerge_1.createDefaultDashboardViewsConfig)('global');
+        const global = minimalConfig('nope', defaults.views);
+        const merged = (0, viewsConfigMerge_1.mergeDashboardViewsConfigs)(global, undefined, defaults);
+        assert.strictEqual(merged.activeViewId, 'global');
+    });
+    test('resolveMergedActiveViewId prefers workspace builtin when healing orphan in workspace context', () => {
+        const defaults = (0, viewsConfigMerge_1.createDefaultDashboardViewsConfig)('global');
+        const merged = defaults.views;
+        assert.strictEqual((0, viewsConfigMerge_1.resolveMergedActiveViewId)(merged, 'missing', defaults, { preferWorkspaceScopeFallback: true }), 'workspace');
+    });
+    test('createDefaultDashboardViewsConfig includes Fleet and Workflows system views', () => {
+        const defaults = (0, viewsConfigMerge_1.createDefaultDashboardViewsConfig)('global');
+        const fleet = defaults.views.find(v => v.id === 'fleet');
+        const workflows = defaults.views.find(v => v.id === viewsConfigMerge_1.WORKFLOWS_VIEW_ID);
+        assert.ok(fleet);
+        assert.ok(workflows);
+        assert.strictEqual(workflows?.name, 'Workflows');
+        assert.strictEqual(workflows?.system, true);
+        assert.strictEqual(workflows?.refreshOnNavigate, 'always');
+        assert.strictEqual(workflows?.layout, 'fleet-dashboard');
+        assert.deepStrictEqual(workflows?.scripts, [viewsConfigMerge_1.WORKFLOWS_RUN_SCRIPT]);
+        assert.deepStrictEqual(workflows, (0, viewsConfigMerge_1.createDefaultWorkflowsView)());
+    });
+    test('resolvePreserveFleetIframe defaults true for fleet widget views', () => {
+        assert.strictEqual((0, viewsConfigMerge_1.resolvePreserveFleetIframe)({ scripts: [viewsConfigMerge_1.FLEET_WIDGET_SCRIPT] }), true);
+        assert.strictEqual((0, viewsConfigMerge_1.resolvePreserveFleetIframe)({ scripts: [], layout: 'fleet-dashboard' }), true);
+        assert.strictEqual((0, viewsConfigMerge_1.resolvePreserveFleetIframe)({ scripts: [], layout: 'gallery' }), false);
+        assert.strictEqual((0, viewsConfigMerge_1.resolvePreserveFleetIframe)({ scripts: [viewsConfigMerge_1.FLEET_WIDGET_SCRIPT], preserveFleetIframe: false }), false);
+    });
+    test('buildViewExportSnapshotMessages passthrough workflow export unchanged', () => {
+        const parsed = {
+            generatedAt: '2026-05-30T19:00:00Z',
+            totals: { running: 1 },
+            running: [{ workflowId: 'star-pipeline' }],
+            finished: [],
+            history: [],
+        };
+        const messages = (0, viewsConfigMerge_1.buildViewExportSnapshotMessages)(parsed);
+        assert.strictEqual(messages.length, 1);
+        assert.ok(Array.isArray(messages[0].payload.running));
+        assert.strictEqual(messages[0].payload.running.length, 1);
+        assert.strictEqual(messages[0].meta.sessionCount, 0);
+    });
+    test('buildViewExportSnapshotMessages passthrough session export', () => {
+        const messages = (0, viewsConfigMerge_1.buildViewExportSnapshotMessages)({
+            generatedAt: '2026-05-30T19:00:00Z',
+            totals: { sessions: 2 },
+            sessions: [{ sessionId: 'a' }, { sessionId: 'b' }],
+        });
+        assert.strictEqual(messages.length, 1);
+        assert.strictEqual(messages[0].payload.sessions?.length, 2);
+        assert.strictEqual(messages[0].meta.sessionCount, 2);
+    });
+    test('buildViewExportSnapshotMessages chunks large sessions only', () => {
+        const sessions = Array.from({ length: 250 }, (_, i) => ({ sessionId: `s-${i}`, data: 'x'.repeat(900) }));
+        const messages = (0, viewsConfigMerge_1.buildViewExportSnapshotMessages)({
+            generatedAt: '2026-05-30T19:00:00Z',
+            totals: { sessions: sessions.length },
+            sessions,
+            running: [{ workflowId: 'keep-me' }],
+        });
+        assert.ok(messages.length > 1);
+        assert.strictEqual(messages[0].meta.chunkedSessions, true);
+        assert.ok(Array.isArray(messages[0].payload.running));
+        assert.strictEqual(messages[0].payload.running.length, 1);
+        assert.strictEqual(messages[0].payload.sessions?.length, 100);
+    });
+});

package/out/test/windows-command-line.test.js

@@ -0,0 +1,75 @@
+"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 windowsCommandLine_1 = require("../utils/windowsCommandLine");
+suite('Windows Command Line Utilities', () => {
+    suite('quoteWindowsCommandLineArg', () => {
+        test('keeps plain args unquoted', () => {
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)('-NoProfile'), '-NoProfile');
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)('C:\\tools\\script.ps1'), 'C:\\tools\\script.ps1');
+        });
+        test('quotes args with spaces', () => {
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)('C:\\Program Files\\Git\\bin\\bash.exe'), '"C:\\Program Files\\Git\\bin\\bash.exe"');
+        });
+        test('quotes empty args', () => {
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)(''), '""');
+        });
+        test('escapes embedded quotes', () => {
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)('say "hello"'), '"say \\"hello\\""');
+        });
+        test('doubles trailing backslashes when quoted', () => {
+            assert.strictEqual((0, windowsCommandLine_1.quoteWindowsCommandLineArg)('C:\\Program Files\\Agent\\'), '"C:\\Program Files\\Agent\\\\"');
+        });
+    });
+    suite('buildWindowsArgumentLine', () => {
+        test('builds a command line with correct quoting', () => {
+            const line = (0, windowsCommandLine_1.buildWindowsArgumentLine)([
+                '-NoProfile',
+                '-ExecutionPolicy',
+                'Bypass',
+                '-File',
+                'C:\\Program Files\\AgentHippo\\scripts\\agentide-litellm.ps1',
+                '-ConfigPath',
+                'C:\\Users\\trung\\AppData\\Local\\Temp\\my config\\litellm.yaml',
+            ]);
+            assert.strictEqual(line, '-NoProfile -ExecutionPolicy Bypass -File "C:\\Program Files\\AgentHippo\\scripts\\agentide-litellm.ps1" -ConfigPath "C:\\Users\\trung\\AppData\\Local\\Temp\\my config\\litellm.yaml"');
+        });
+    });
+});