echo-cli-agent 0.1.0

package/dist/tests/final-output.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/final-output.test.js

@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest';
+import { extractFinalOutput } from '../src/session/final-output.js';
+describe('extractFinalOutput', () => {
+    it('keeps Kiro final text while dropping terminal decorations', () => {
+        const output = '\u001b[32mRunning tool echo_report_task_progress\u001b[0m\n> 1+12 = **13**\n\n ▸ Credits: 0.1';
+        expect(extractFinalOutput(output)).toBe('1+12 = **13**');
+    });
+});
+//# sourceMappingURL=final-output.test.js.map

package/dist/tests/final-output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-output.test.js","sourceRoot":"","sources":["../../tests/final-output.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEnE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,MAAM,GAAG,+FAA+F,CAAA;QAC9G,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/health-server.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/health-server.test.js

@@ -0,0 +1,38 @@
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { HealthServer } from '../src/health/server.js';
+const logger = {
+    error: () => undefined,
+    warn: () => undefined,
+    info: () => undefined,
+    debug: () => undefined,
+    close: () => undefined
+};
+describe('HealthServer', () => {
+    let server;
+    afterEach(async () => server?.stop());
+    it('serves a local dashboard with run and event data', async () => {
+        const directory = await mkdtemp(join(tmpdir(), 'api-ocra-health-'));
+        const logFile = join(directory, 'agent.log');
+        await writeFile(logFile, JSON.stringify({ ts: '2026-08-06T13:00:00.000Z', level: 'info', event: 'prompt-delivered', runId: 'run-1' }));
+        server = new HealthServer('127.0.0.1', 0, () => ({
+            deviceId: 'device-1',
+            connected: true,
+            activeSessions: 1,
+            storedRuns: 1,
+            startedAt: '2026-08-06T13:00:00.000Z',
+            runs: [{ runId: 'run-1', status: 'delivered', updatedAt: '2026-08-06T13:00:00.000Z' }]
+        }), logFile, logger);
+        await server.start();
+        const root = await fetch(`http://127.0.0.1:${server.boundPort}/`);
+        const status = await fetch(`http://127.0.0.1:${server.boundPort}/api/status`).then((response) => response.json());
+        const events = await fetch(`http://127.0.0.1:${server.boundPort}/api/events`).then((response) => response.json());
+        expect(root.status).toBe(200);
+        expect(await root.text()).toContain('Orca Agent');
+        expect(status.runs[0].runId).toBe('run-1');
+        expect(events.events[0].event).toBe('prompt-delivered');
+    });
+});
+//# sourceMappingURL=health-server.test.js.map

package/dist/tests/health-server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-server.test.js","sourceRoot":"","sources":["../../tests/health-server.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,MAAgC,CAAA;IAEpC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAErC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QAC5C,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;QACtI,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/C,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,CAAC;YACjB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,0BAA0B;YACrC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC;SACvF,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QAEpB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,oBAAoB,MAAM,CAAC,SAAS,GAAG,CAAC,CAAA;QACjE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,oBAAoB,MAAM,CAAC,SAAS,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QACjH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,oBAAoB,MAAM,CAAC,SAAS,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAEjH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/model-catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/model-catalog.test.js

@@ -0,0 +1,59 @@
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { parseKiroModelCatalog, readCodexModelCatalog } from '../src/providers/model-catalog.js';
+const originalCodexHome = process.env.CODEX_HOME;
+afterEach(() => {
+    if (originalCodexHome === undefined)
+        delete process.env.CODEX_HOME;
+    else
+        process.env.CODEX_HOME = originalCodexHome;
+});
+describe('Kiro model catalog', () => {
+    it('preserves Kiro local models and leaves unadvertised effort choices empty', () => {
+        expect(parseKiroModelCatalog({
+            default_model: 'gpt-5.6-sol',
+            models: [{
+                    model_id: 'gpt-5.6-terra',
+                    model_name: 'gpt-5.6-terra',
+                    description: 'Local Kiro model'
+                }]
+        }, '2026-08-09T00:00:00.000Z')).toEqual({
+            agent_type: 'kiro',
+            default_model: 'gpt-5.6-sol',
+            fetched_at: '2026-08-09T00:00:00.000Z',
+            models: [{
+                    id: 'gpt-5.6-terra',
+                    name: 'gpt-5.6-terra',
+                    description: 'Local Kiro model',
+                    supported_reasoning_efforts: []
+                }]
+        });
+    });
+});
+describe('Codex model catalog', () => {
+    it('reads local defaults and per-model reasoning levels', async () => {
+        const home = await mkdtemp(join(tmpdir(), 'api-ocra-codex-'));
+        process.env.CODEX_HOME = home;
+        await writeFile(join(home, 'config.toml'), 'model = "gpt-5.6-terra"\nmodel_reasoning_effort = "medium"\n');
+        await writeFile(join(home, 'models_cache.json'), JSON.stringify({
+            models: [{
+                    slug: 'gpt-5.6-terra',
+                    display_name: 'GPT-5.6 Terra',
+                    default_reasoning_level: 'medium',
+                    supported_reasoning_levels: [{ effort: 'low' }, { effort: 'medium' }, { effort: 'high' }]
+                }]
+        }));
+        await expect(readCodexModelCatalog()).resolves.toMatchObject({
+            agent_type: 'codex',
+            default_model: 'gpt-5.6-terra',
+            default_reasoning_effort: 'medium',
+            models: [{
+                    id: 'gpt-5.6-terra',
+                    supported_reasoning_efforts: ['low', 'medium', 'high']
+                }]
+        });
+    });
+});
+//# sourceMappingURL=model-catalog.test.js.map

package/dist/tests/model-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.test.js","sourceRoot":"","sources":["../../tests/model-catalog.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAEhG,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;AAEhD,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;;QAC7D,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,iBAAiB,CAAA;AACjD,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,CAAC,qBAAqB,CAAC;YAC3B,aAAa,EAAE,aAAa;YAC5B,MAAM,EAAE,CAAC;oBACP,QAAQ,EAAE,eAAe;oBACzB,UAAU,EAAE,eAAe;oBAC3B,WAAW,EAAE,kBAAkB;iBAChC,CAAC;SACH,EAAE,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC;YACtC,UAAU,EAAE,MAAM;YAClB,aAAa,EAAE,aAAa;YAC5B,UAAU,EAAE,0BAA0B;YACtC,MAAM,EAAE,CAAC;oBACP,EAAE,EAAE,eAAe;oBACnB,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,kBAAkB;oBAC/B,2BAA2B,EAAE,EAAE;iBAChC,CAAC;SACH,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC7D,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAA;QAC7B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,8DAA8D,CAAC,CAAA;QAC1G,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YAC9D,MAAM,EAAE,CAAC;oBACP,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,eAAe;oBAC7B,uBAAuB,EAAE,QAAQ;oBACjC,0BAA0B,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;iBAC1F,CAAC;SACH,CAAC,CAAC,CAAA;QAEH,MAAM,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3D,UAAU,EAAE,OAAO;YACnB,aAAa,EAAE,eAAe;YAC9B,wBAAwB,EAAE,QAAQ;YAClC,MAAM,EAAE,CAAC;oBACP,EAAE,EAAE,eAAe;oBACnB,2BAA2B,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;iBACvD,CAAC;SACH,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/providers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/providers.test.js

@@ -0,0 +1,95 @@
+import { describe, expect, it } from 'vitest';
+import { claudeProvider } from '../src/providers/claude.js';
+import { codexProvider } from '../src/providers/codex.js';
+import { kiroProvider } from '../src/providers/kiro.js';
+import { AgentCliRequestSchema } from '../src/types/protocol.js';
+const base = AgentCliRequestSchema.parse({
+    type: 'agent_cli',
+    run_id: 'run-1',
+    task_id: 'task-1',
+    agent_type: 'claude',
+    prompt: 'hello',
+    model: 'sonnet',
+    session_id: 'session-1',
+    config: { executable: '/tmp/untrusted', arguments: ['--permission-mode', 'acceptEdits'] }
+});
+describe('provider launch plans', () => {
+    it('builds Claude resume arguments without trusting executable overrides', () => {
+        const plan = claudeProvider.buildLaunchPlan(base, { allowExecutableOverride: false });
+        expect(plan.executable).toBe('claude');
+        expect(plan.args).toEqual([
+            '--permission-mode',
+            'acceptEdits',
+            '--resume',
+            'session-1',
+            '--model',
+            'sonnet'
+        ]);
+    });
+    it('uses the Codex resume subcommand', () => {
+        const plan = codexProvider.buildLaunchPlan({ ...base, agent_type: 'codex' }, {
+            allowExecutableOverride: true
+        });
+        expect(plan.executable).toBe('/tmp/untrusted');
+        expect(plan.args[0]).toBe('exec');
+        expect(plan.args).toContain('resume');
+        expect(plan.args).toContain('session-1');
+        expect(plan.args).toContain('--dangerously-bypass-approvals-and-sandbox');
+        expect(plan.args.at(-2)).toBe('--');
+        expect(plan.args.at(-1)).toBe('hello');
+        expect(plan.promptDelivery).toBe('startup');
+        expect(plan.reuseSession).toBe(false);
+    });
+    it('only accepts UUID-shaped Codex session identifiers', () => {
+        expect(codexProvider.extractSessionId('session id: SessionDep')).toBeUndefined();
+        expect(codexProvider.extractSessionId('session id: 019ff004-803d-7e21-8cc9-8494543d2d7e'))
+            .toBe('019ff004-803d-7e21-8cc9-8494543d2d7e');
+    });
+    it('rejects prompt requests without a provider session identifier', () => {
+        const { session_id: _sessionId, ...withoutSession } = base;
+        expect(AgentCliRequestSchema.safeParse(withoutSession).success).toBe(false);
+    });
+    it('passes the selected Codex reasoning effort for this invocation', () => {
+        const plan = codexProvider.buildLaunchPlan({ ...base, agent_type: 'codex', reasoning_effort: 'high' }, {
+            allowExecutableOverride: true
+        });
+        expect(plan.args).toContain('-c');
+        expect(plan.args).toContain('model_reasoning_effort="high"');
+    });
+    it('passes prompts that begin with dashes as prompt values', () => {
+        const prompt = '---payload---\n{"msg_id":"run-1"}';
+        const { session_id: _sessionId, ...baseWithoutSession } = base;
+        const plan = codexProvider.buildLaunchPlan({ ...baseWithoutSession, agent_type: 'codex', prompt }, {
+            allowExecutableOverride: true
+        });
+        expect(plan.args.slice(-2)).toEqual(['--', prompt]);
+    });
+    it('runs Kiro non-interactively with the first prompt', () => {
+        const plan = kiroProvider.buildLaunchPlan({ ...base, agent_type: 'kiro' }, {
+            allowExecutableOverride: false
+        });
+        expect(plan.executable).toBe('kiro-cli');
+        expect(plan.args).toContain('chat');
+        expect(plan.args).toContain('--no-interactive');
+        expect(plan.args).toContain('--trust-all-tools');
+        expect(plan.args).toContain('--');
+        expect(plan.args.some((argument) => argument.includes('hello'))).toBe(true);
+        expect(plan.args.at(-1)).toBe('hello');
+        expect(plan.promptDelivery).toBe('startup');
+        expect(plan.reuseSession).toBe(false);
+        expect(plan.autoApproveTrustPrompt).toBe(true);
+    });
+    it('passes selected Kiro model and effort for this invocation', () => {
+        const plan = kiroProvider.buildLaunchPlan({
+            ...base,
+            agent_type: 'kiro',
+            model: 'gpt-5.6-terra',
+            reasoning_effort: 'high'
+        }, { allowExecutableOverride: false });
+        expect(plan.args).toContain('--model');
+        expect(plan.args).toContain('gpt-5.6-terra');
+        expect(plan.args).toContain('--effort');
+        expect(plan.args).toContain('high');
+    });
+});
+//# sourceMappingURL=providers.test.js.map

package/dist/tests/providers.test.js.map

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

package/dist/tests/state-store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/state-store.test.js

@@ -0,0 +1,22 @@
+import { mkdtemp, readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { StateStore } from '../src/state/state-store.js';
+describe('StateStore', () => {
+    it('persists run delivery state without persisting device identity', async () => {
+        const directory = await mkdtemp(join(tmpdir(), 'api-ocra-state-'));
+        const path = join(directory, 'state.json');
+        const first = new StateStore(path);
+        await first.initialize();
+        await first.markRun('run-1', 'delivered', 'session-1');
+        const second = new StateStore(path);
+        await second.initialize();
+        expect(second.getRun('run-1')).toMatchObject({
+            status: 'delivered',
+            sessionId: 'session-1'
+        });
+        expect(JSON.parse(await readFile(path, 'utf8'))).not.toHaveProperty('deviceId');
+    });
+});
+//# sourceMappingURL=state-store.test.js.map

package/dist/tests/state-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.test.js","sourceRoot":"","sources":["../../tests/state-store.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAExD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;QACxB,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;QAEtD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QACzB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;YAC3C,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,WAAW;SACvB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/vitest.config.js

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+    server: {
+        host: '127.0.0.1'
+    },
+    test: {
+        environment: 'node',
+        pool: 'forks'
+    }
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAe,YAAY,CAAC;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;KAClB;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,OAAO;KACd;CACF,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "echo-cli-agent",
+  "version": "0.1.0",
+  "description": "Local CLI bridge agent",
+  "type": "module",
+  "bin": {
+    "echo-cli-agent": "./dist/src/index.js"
+  },
+  "files": [
+    "dist/",
+    "scripts/service.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts run",
+    "start": "node dist/src/index.js run",
+    "doctor": "tsx src/index.ts doctor",
+    "service:install": "node scripts/service.mjs install",
+    "service:uninstall": "node scripts/service.mjs uninstall",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "node-pty": "^1.1.0",
+    "ws": "^8.18.3",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "license": "MIT"
+}

package/scripts/service.mjs

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs'
+import { chmod, mkdir, unlink, writeFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+
+const SERVICE_NAME = 'echo-cli-agent'
+const LAUNCHD_LABEL = 'top.stormapex.echo-cli-agent'
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const agentEntry = join(root, 'dist', 'src', 'index.js')
+const action = process.argv[2]
+const configPath = resolve(readOption('--config') ?? defaultConfigPath())
+
+if (action !== 'install' && action !== 'uninstall') usage()
+if (action === 'install' && !existsSync(agentEntry)) fail('Build output is missing. Run npm run build first.')
+if (action === 'install' && !existsSync(configPath)) fail(`Configuration file is missing: ${configPath}`)
+
+if (process.platform === 'darwin') await manageLaunchd(action)
+else if (process.platform === 'linux') await manageSystemd(action)
+else if (process.platform === 'win32') await manageWindowsTask(action)
+else fail(`Unsupported platform: ${process.platform}`)
+
+function readOption(name) {
+  const index = process.argv.indexOf(name)
+  return index >= 0 ? process.argv[index + 1] : undefined
+}
+
+function defaultDataDir() {
+  if (process.platform === 'darwin') return join(homedir(), 'Library', 'Application Support', SERVICE_NAME)
+  if (process.platform === 'win32') return join(process.env.APPDATA ?? homedir(), SERVICE_NAME)
+  return join(process.env.XDG_STATE_HOME ?? join(homedir(), '.local', 'state'), SERVICE_NAME)
+}
+
+function defaultConfigPath() {
+  return join(defaultDataDir(), 'config.json')
+}
+
+async function manageLaunchd(mode) {
+  const target = join(homedir(), 'Library', 'LaunchAgents', `${LAUNCHD_LABEL}.plist`)
+  const domain = `gui/${process.getuid()}`
+  if (mode === 'uninstall') {
+    command('launchctl', ['bootout', domain, target], true)
+    await unlink(target).catch(ignoreMissing)
+    process.stdout.write(`Removed ${target}\n`)
+    return
+  }
+
+  const logDir = join(defaultDataDir(), 'logs')
+  await mkdir(dirname(target), { recursive: true })
+  await mkdir(logDir, { recursive: true, mode: 0o700 })
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>${LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key><array>
+    <string>${xml(process.execPath)}</string><string>${xml(agentEntry)}</string><string>run</string>
+  </array>
+  <key>EnvironmentVariables</key><dict>
+    <key>ECHO_AGENT_CONFIG</key><string>${xml(configPath)}</string>
+  </dict>
+  <key>RunAtLoad</key><true/><key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>${xml(join(logDir, 'service.stdout.log'))}</string>
+  <key>StandardErrorPath</key><string>${xml(join(logDir, 'service.stderr.log'))}</string>
+</dict></plist>
+`
+  await writeFile(target, plist, { mode: 0o600 })
+  command('launchctl', ['bootout', domain, target], true)
+  command('launchctl', ['bootstrap', domain, target])
+  command('launchctl', ['enable', `${domain}/${LAUNCHD_LABEL}`])
+  command('launchctl', ['kickstart', '-k', `${domain}/${LAUNCHD_LABEL}`])
+  process.stdout.write(`Installed ${target}\n`)
+}
+
+async function manageSystemd(mode) {
+  const target = join(homedir(), '.config', 'systemd', 'user', `${SERVICE_NAME}.service`)
+  if (mode === 'uninstall') {
+    command('systemctl', ['--user', 'disable', '--now', SERVICE_NAME], true)
+    await unlink(target).catch(ignoreMissing)
+    command('systemctl', ['--user', 'daemon-reload'])
+    process.stdout.write(`Removed ${target}\n`)
+    return
+  }
+
+  await mkdir(dirname(target), { recursive: true })
+  const unit = `[Unit]
+Description=echo_cli_agent TaskMCP device agent
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+Environment=ECHO_AGENT_CONFIG=${systemdQuote(configPath)}
+ExecStart=${systemdQuote(process.execPath)} ${systemdQuote(agentEntry)} run
+Restart=always
+RestartSec=3
+NoNewPrivileges=true
+
+[Install]
+WantedBy=default.target
+`
+  await writeFile(target, unit, { mode: 0o600 })
+  command('systemctl', ['--user', 'daemon-reload'])
+  command('systemctl', ['--user', 'enable', '--now', SERVICE_NAME])
+  process.stdout.write(`Installed ${target}\n`)
+}
+
+async function manageWindowsTask(mode) {
+  const launcher = join(defaultDataDir(), 'run-agent.cmd')
+  if (mode === 'uninstall') {
+    command('schtasks.exe', ['/Delete', '/F', '/TN', SERVICE_NAME], true)
+    await unlink(launcher).catch(ignoreMissing)
+    process.stdout.write(`Removed scheduled task ${SERVICE_NAME}\n`)
+    return
+  }
+
+  rejectCmdMetacharacters(configPath)
+  rejectCmdMetacharacters(process.execPath)
+  rejectCmdMetacharacters(agentEntry)
+  await mkdir(dirname(launcher), { recursive: true })
+  await writeFile(launcher, `@echo off\r\nset "ECHO_AGENT_CONFIG=${configPath}"\r\n"${process.execPath}" "${agentEntry}" run\r\n`, { mode: 0o600 })
+  await chmod(launcher, 0o700).catch(() => undefined)
+  command('schtasks.exe', ['/Create', '/F', '/TN', SERVICE_NAME, '/SC', 'ONLOGON', '/RL', 'LIMITED', '/TR', `"${launcher}"`])
+  command('schtasks.exe', ['/Run', '/TN', SERVICE_NAME])
+  process.stdout.write(`Installed scheduled task ${SERVICE_NAME}\n`)
+}
+
+function command(executable, args, allowFailure = false) {
+  const result = spawnSync(executable, args, { stdio: 'inherit', shell: false })
+  if (!allowFailure && result.status !== 0) fail(`${executable} failed with exit code ${result.status ?? 'unknown'}`)
+}
+
+function xml(value) {
+  return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;')
+}
+
+function systemdQuote(value) {
+  return `"${value.replaceAll('\\', '\\\\').replaceAll('"', '\\"').replaceAll('%', '%%')}"`
+}
+
+function rejectCmdMetacharacters(value) {
+  if (/[\r\n&|<>^]/.test(value)) fail('Windows service paths contain unsupported command characters')
+}
+
+function ignoreMissing(error) {
+  if (error?.code !== 'ENOENT') throw error
+}
+
+function usage() {
+  process.stderr.write('Usage: node scripts/service.mjs <install|uninstall> [--config /path/config.json]\n')
+  process.exit(2)
+}
+
+function fail(message) {
+  process.stderr.write(`${message}\n`)
+  process.exit(1)
+}