im-hub-pro 0.2.29

package/dist/plugins/agents/opencode/adapter.test.js

@@ -0,0 +1,139 @@
+// OpenCodeAdapter — verify session-id capture, --session injection, and
+// usage callbacks. The adapter is the only piece in the v2 chain that turns
+// opencode's `--format json` event stream into the per-agent session row in
+// im-hub, so this is the regression net for the 2026-05-02 wire-up.
+import { describe, it, expect } from 'bun:test';
+import { OpenCodeAdapter } from './index.js';
+// Reach past the protected modifier to drive the adapter directly without
+// spawning real opencode.
+function inspect(adapter, event, opts) {
+    // @ts-expect-error — protected hook, intentional reach for tests
+    adapter.inspectEvent(event, opts);
+}
+function buildArgs(adapter, prompt, opts) {
+    // @ts-expect-error — protected
+    return adapter.buildArgs(prompt, opts);
+}
+describe('OpenCodeAdapter buildArgs', () => {
+    it('starts a fresh session when no agentSessionId provided', () => {
+        const adapter = new OpenCodeAdapter();
+        const args = buildArgs(adapter, 'hello', {});
+        expect(args).not.toContain('--session');
+        expect(args[args.length - 1]).toBe('hello');
+    });
+    it('injects --session <id> when opts.agentSessionId is set', () => {
+        const adapter = new OpenCodeAdapter();
+        const args = buildArgs(adapter, 'hello', { agentSessionId: 'ses_abc' });
+        const idx = args.indexOf('--session');
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(args[idx + 1]).toBe('ses_abc');
+    });
+    it('still passes model and variant alongside --session', () => {
+        const adapter = new OpenCodeAdapter();
+        const args = buildArgs(adapter, 'p', {
+            agentSessionId: 'ses_abc', model: 'anthropic/claude-sonnet-4-6', variant: 'high',
+        });
+        expect(args).toContain('--session');
+        expect(args).toContain('--model');
+        expect(args).toContain('--variant');
+    });
+    it('injects --agent plan when planMode is true', () => {
+        const adapter = new OpenCodeAdapter();
+        const args = buildArgs(adapter, 'design X', { planMode: true });
+        const idx = args.indexOf('--agent');
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(args[idx + 1]).toBe('plan');
+        // Prompt is still last positional.
+        expect(args[args.length - 1]).toBe('design X');
+    });
+    it('does not pass --agent when planMode is false / unset', () => {
+        const adapter = new OpenCodeAdapter();
+        expect(buildArgs(adapter, 'p', {})).not.toContain('--agent');
+        expect(buildArgs(adapter, 'p', { planMode: false })).not.toContain('--agent');
+    });
+});
+describe('OpenCodeAdapter inspectEvent — session id capture', () => {
+    it('forwards sessionID via opts.onAgentSessionId', () => {
+        const adapter = new OpenCodeAdapter();
+        const ids = [];
+        inspect(adapter, { type: 'step_start', sessionID: 'ses_x' }, {
+            onAgentSessionId: (id) => ids.push(id),
+        });
+        expect(ids).toEqual(['ses_x']);
+    });
+    it('fires every time it sees sessionID — caller dedupes', () => {
+        const adapter = new OpenCodeAdapter();
+        const ids = [];
+        const opts = { onAgentSessionId: (id) => ids.push(id) };
+        inspect(adapter, { type: 'step_start', sessionID: 'ses_x' }, opts);
+        inspect(adapter, { type: 'text', sessionID: 'ses_x', part: { type: 'text', text: 'hi' } }, opts);
+        inspect(adapter, { type: 'step_finish', sessionID: 'ses_x' }, opts);
+        // 3 events, all carry ses_x. Adapter forwards each — setOpencodeSessionId
+        // is itself idempotent so this is safe.
+        expect(ids.length).toBe(3);
+        expect(new Set(ids).size).toBe(1);
+    });
+    it('does nothing when callback is absent', () => {
+        const adapter = new OpenCodeAdapter();
+        // Should not throw
+        inspect(adapter, { type: 'step_start', sessionID: 'ses_x' }, {});
+    });
+    it('survives a callback that throws', () => {
+        const adapter = new OpenCodeAdapter();
+        inspect(adapter, { type: 'step_start', sessionID: 'ses_x' }, {
+            onAgentSessionId: () => { throw new Error('boom'); },
+        });
+        // No assertion — the absence of an unhandled throw is the assertion.
+        expect(true).toBe(true);
+    });
+});
+describe('OpenCodeAdapter inspectEvent — usage capture', () => {
+    // Reproduces the exact shape opencode 1.14.x emits — cost and tokens
+    // are nested under `part`, not on the event root. The first cut of this
+    // adapter read them from the root, silently zeroing /stats.
+    it('forwards cost + tokens from step_finish (event.part.cost / .tokens)', () => {
+        const adapter = new OpenCodeAdapter();
+        const deltas = [];
+        inspect(adapter, {
+            type: 'step_finish',
+            sessionID: 'ses_x',
+            part: {
+                type: 'step-finish',
+                tokens: { input: 100, output: 50, total: 150 },
+                cost: 0.0123,
+            },
+        }, { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(1);
+        expect(deltas[0].costUsd).toBe(0.0123);
+        expect(deltas[0].tokensInput).toBe(100);
+        expect(deltas[0].tokensOutput).toBe(50);
+    });
+    it('does NOT misread cost/tokens placed at event root (regression guard)', () => {
+        const adapter = new OpenCodeAdapter();
+        const deltas = [];
+        // Some hypothetical future format that flattens to root — should NOT
+        // accidentally match. This locks in the part-nested expectation.
+        inspect(adapter, {
+            type: 'step_finish',
+            sessionID: 'ses_x',
+            // Purposely misshapen — properties at root instead of nested under part.
+            cost: 99,
+            tokens: { input: 999 },
+        }, { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(0);
+    });
+    it('does NOT fire onUsage for non-step_finish events', () => {
+        const adapter = new OpenCodeAdapter();
+        const deltas = [];
+        inspect(adapter, { type: 'text', sessionID: 'ses_x', part: { type: 'text', text: 'hi' } }, { onUsage: (d) => deltas.push(d) });
+        inspect(adapter, { type: 'step_start', sessionID: 'ses_x' }, { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(0);
+    });
+    it('skips onUsage when step_finish carries no cost/tokens', () => {
+        const adapter = new OpenCodeAdapter();
+        const deltas = [];
+        inspect(adapter, { type: 'step_finish', sessionID: 'ses_x' }, { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(0);
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

package/dist/plugins/agents/opencode/adapter.test.js.map

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

package/dist/plugins/agents/opencode/http-adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-adapter.test.d.ts.map

package/dist/plugins/agents/opencode/http-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/opencode/http-adapter.test.ts"],"names":[],"mappings":""}

package/dist/plugins/agents/opencode/http-adapter.test.js

@@ -0,0 +1,492 @@
+// OpenCodeHttpAdapter tests.
+//
+// Coverage layers:
+//   1. Driver-selection contract (factory) — protects the
+//      IMHUB_OPENCODE_DRIVER env toggle.
+//   2. Pure event-mapping helpers (inspectHttpEvent / isIdleEvent /
+//      isErrorEvent) — locks in the SSE → adapter-effects contract without
+//      spinning up `opencode serve`.
+//   3. End-to-end sendPrompt with a fully-mocked fetch + serve — proves the
+//      happy path (subscribes SSE, posts prompt, captures sessionID, yields
+//      text on time.end, breaks on session.idle) and the four permission
+//      paths: no bus → fallback once, bus without IM ctx → fallback once,
+//      bridge allow → POST reply once, bridge deny+message → POST reply
+//      reject + message.
+import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
+import { OpenCodeAdapter, OpenCodeHttpAdapter } from './index.js';
+describe('OpenCodeHttpAdapter — identity', () => {
+    it('inherits from OpenCodeAdapter so registry sees the same name/aliases', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a).toBeInstanceOf(OpenCodeAdapter);
+        expect(a.name).toBe('opencode');
+        expect(a.aliases).toEqual(['oc', 'opencodeai']);
+    });
+});
+describe('opencode driver factory (env IMHUB_OPENCODE_DRIVER)', () => {
+    let original;
+    beforeEach(() => { original = process.env.IMHUB_OPENCODE_DRIVER; });
+    afterEach(() => {
+        if (original === undefined)
+            delete process.env.IMHUB_OPENCODE_DRIVER;
+        else
+            process.env.IMHUB_OPENCODE_DRIVER = original;
+    });
+    // The factory is invoked at module-load time — to test selection without
+    // re-importing the module on every case, we re-construct the same factory
+    // logic locally. Mirrors index.ts and locks in the contract.
+    function pick(envValue) {
+        if (envValue === undefined)
+            delete process.env.IMHUB_OPENCODE_DRIVER;
+        else
+            process.env.IMHUB_OPENCODE_DRIVER = envValue;
+        const driver = (process.env.IMHUB_OPENCODE_DRIVER || '').toLowerCase();
+        return driver === 'http' ? new OpenCodeHttpAdapter() : new OpenCodeAdapter();
+    }
+    it('defaults to stdio when env is unset', () => {
+        const a = pick(undefined);
+        expect(a).toBeInstanceOf(OpenCodeAdapter);
+        expect(a).not.toBeInstanceOf(OpenCodeHttpAdapter);
+    });
+    it('defaults to stdio when env is empty string', () => {
+        const a = pick('');
+        expect(a).not.toBeInstanceOf(OpenCodeHttpAdapter);
+    });
+    it('selects http when env is "http"', () => {
+        const a = pick('http');
+        expect(a).toBeInstanceOf(OpenCodeHttpAdapter);
+    });
+    it('selects http case-insensitively', () => {
+        const a = pick('HTTP');
+        expect(a).toBeInstanceOf(OpenCodeHttpAdapter);
+    });
+    it('falls back to stdio for unknown values (no throw)', () => {
+        const a = pick('grpc-someday');
+        expect(a).not.toBeInstanceOf(OpenCodeHttpAdapter);
+        expect(a).toBeInstanceOf(OpenCodeAdapter);
+    });
+});
+describe('OpenCodeHttpAdapter.inspectHttpEvent — sessionID + usage capture', () => {
+    it('forwards sessionID via opts.onAgentSessionId (event.properties.sessionID)', () => {
+        const a = new OpenCodeHttpAdapter();
+        const ids = [];
+        a.inspectHttpEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x', part: { type: 'step-start' } } }, 'ses_x', { onAgentSessionId: (id) => ids.push(id) });
+        expect(ids).toEqual(['ses_x']);
+    });
+    it('forwards sessionID from properties.info.sessionID when properties.sessionID missing', () => {
+        const a = new OpenCodeHttpAdapter();
+        const ids = [];
+        a.inspectHttpEvent({ type: 'session.status', properties: { info: { sessionID: 'ses_x', status: { type: 'running' } } } }, 'ses_x', { onAgentSessionId: (id) => ids.push(id) });
+        expect(ids).toEqual(['ses_x']);
+    });
+    it('captures cost + tokens from message.part.updated of type step-finish', () => {
+        const a = new OpenCodeHttpAdapter();
+        const deltas = [];
+        a.inspectHttpEvent({
+            type: 'message.part.updated',
+            properties: {
+                sessionID: 'ses_x',
+                part: { type: 'step-finish', cost: 0.0123, tokens: { input: 100, output: 50, total: 150 } },
+            },
+        }, 'ses_x', { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(1);
+        expect(deltas[0].costUsd).toBe(0.0123);
+        expect(deltas[0].tokensInput).toBe(100);
+        expect(deltas[0].tokensOutput).toBe(50);
+    });
+    it('does not fire onUsage when step-finish carries no cost/tokens', () => {
+        const a = new OpenCodeHttpAdapter();
+        const deltas = [];
+        a.inspectHttpEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x', part: { type: 'step-finish' } } }, 'ses_x', { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(0);
+    });
+    it('does not fire onUsage for non-step-finish events', () => {
+        const a = new OpenCodeHttpAdapter();
+        const deltas = [];
+        a.inspectHttpEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x', part: { type: 'text', text: 'hi' } } }, 'ses_x', { onUsage: (d) => deltas.push(d) });
+        expect(deltas.length).toBe(0);
+    });
+    it('survives onAgentSessionId throwing (callback safety)', () => {
+        const a = new OpenCodeHttpAdapter();
+        a.inspectHttpEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x', part: { type: 'step-start' } } }, 'ses_x', { onAgentSessionId: () => { throw new Error('boom'); } });
+        expect(true).toBe(true);
+    });
+});
+describe('OpenCodeHttpAdapter.inspectHttpEvent — text emission', () => {
+    it('yields text only when part.time.end is set (matches stdio adapter)', () => {
+        const a = new OpenCodeHttpAdapter();
+        const opts = {};
+        const streaming = a.inspectHttpEvent({
+            type: 'message.part.updated',
+            properties: { sessionID: 'ses_x', part: { type: 'text', text: 'hel', time: { start: 1 } } },
+        }, 'ses_x', opts);
+        expect(streaming.text).toBeUndefined();
+        const finished = a.inspectHttpEvent({
+            type: 'message.part.updated',
+            properties: { sessionID: 'ses_x', part: { type: 'text', text: 'hello', time: { start: 1, end: 2 } } },
+        }, 'ses_x', opts);
+        expect(finished.text).toBe('hello');
+    });
+    it('ignores text from a different sessionID (cross-talk guard)', () => {
+        const a = new OpenCodeHttpAdapter();
+        const out = a.inspectHttpEvent({
+            type: 'message.part.updated',
+            properties: { sessionID: 'ses_other', part: { type: 'text', text: 'hi', time: { end: 1 } } },
+        }, 'ses_x', {});
+        expect(out.text).toBeUndefined();
+    });
+});
+describe('OpenCodeHttpAdapter.isIdleEvent', () => {
+    it('matches session.status idle for our session', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isIdleEvent({ type: 'session.status', properties: { sessionID: 'ses_x', status: { type: 'idle' } } }, 'ses_x')).toBe(true);
+    });
+    it('matches when status comes nested under properties.info', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isIdleEvent({ type: 'session.status', properties: { info: { sessionID: 'ses_x', status: { type: 'idle' } } } }, 'ses_x')).toBe(true);
+    });
+    it('does not match running status', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isIdleEvent({ type: 'session.status', properties: { sessionID: 'ses_x', status: { type: 'running' } } }, 'ses_x')).toBe(false);
+    });
+    it('does not match idle for a different session', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isIdleEvent({ type: 'session.status', properties: { sessionID: 'ses_other', status: { type: 'idle' } } }, 'ses_x')).toBe(false);
+    });
+    it('does not match non-status events', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isIdleEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x' } }, 'ses_x')).toBe(false);
+    });
+});
+describe('OpenCodeHttpAdapter.isErrorEvent', () => {
+    it('extracts error message from properties.error.data.message', () => {
+        const a = new OpenCodeHttpAdapter();
+        const out = a.isErrorEvent({
+            type: 'session.error',
+            properties: {
+                sessionID: 'ses_x',
+                error: { name: 'ProviderError', data: { message: 'rate limited' } },
+            },
+        }, 'ses_x');
+        expect(out).toEqual({ error: 'rate limited' });
+    });
+    it('falls back to error.name when data.message is absent', () => {
+        const a = new OpenCodeHttpAdapter();
+        const out = a.isErrorEvent({ type: 'session.error', properties: { sessionID: 'ses_x', error: { name: 'BoomError' } } }, 'ses_x');
+        expect(out).toEqual({ error: 'BoomError' });
+    });
+    it('returns null for non-error events', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isErrorEvent({ type: 'message.part.updated', properties: { sessionID: 'ses_x' } }, 'ses_x')).toBeNull();
+    });
+    it('returns null for errors on a different session', () => {
+        const a = new OpenCodeHttpAdapter();
+        expect(a.isErrorEvent({ type: 'session.error', properties: { sessionID: 'ses_other', error: { name: 'X' } } }, 'ses_x')).toBeNull();
+    });
+});
+function makeServeStub(baseUrl = 'http://127.0.0.1:14199') {
+    // Just enough surface for sendPrompt — the manager's real lifecycle is
+    // tested separately if/when it grows.
+    return {
+        ensureRunning: async () => baseUrl,
+        isRunning: () => true,
+        getBaseUrl: () => baseUrl,
+        stop: async () => { },
+    };
+}
+/** Build a fake fetch that returns a programmable stream of SSE frames for
+ *  /event and JSON for the other endpoints. */
+function makeFakeFetch(events, opts = {}) {
+    const hits = opts.hits ?? [];
+    return (async (input, init) => {
+        const url = typeof input === 'string'
+            ? input
+            : input instanceof URL ? input.toString() : input.url;
+        const method = init?.method ?? 'GET';
+        let parsedBody;
+        if (init?.body && typeof init.body === 'string') {
+            try {
+                parsedBody = JSON.parse(init.body);
+            }
+            catch {
+                parsedBody = init.body;
+            }
+        }
+        hits.push({ url, method, body: parsedBody });
+        if (url.endsWith('/session') && method === 'POST') {
+            return new Response(JSON.stringify({ id: opts.sessionId ?? 'ses_test' }), {
+                status: 200, headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        if (url.includes('/session/') && url.endsWith('/message') && method === 'POST') {
+            return new Response('{}', { status: 200, headers: { 'Content-Type': 'application/json' } });
+        }
+        if (url.endsWith('/permission') === false && url.includes('/permission/') && url.endsWith('/reply')) {
+            return new Response('true', { status: 200 });
+        }
+        if (url.endsWith('/event')) {
+            const stream = new ReadableStream({
+                start(controller) {
+                    const enc = new TextEncoder();
+                    for (const ev of events) {
+                        controller.enqueue(enc.encode(`data: ${JSON.stringify(ev)}\n\n`));
+                    }
+                    // Leave the stream open — the adapter cancels via close() on idle.
+                },
+            });
+            return new Response(stream, {
+                status: 200, headers: { 'Content-Type': 'text/event-stream' },
+            });
+        }
+        return new Response('not mocked', { status: 404 });
+    });
+}
+async function collect(gen) {
+    const out = [];
+    for await (const chunk of gen)
+        out.push(chunk);
+    return out;
+}
+describe('OpenCodeHttpAdapter.sendPrompt — happy path', () => {
+    it('creates a session, captures sessionID, yields finished text, breaks on idle', async () => {
+        const sid = 'ses_happy';
+        const events = [
+            { type: 'server.connected', properties: {} },
+            { type: 'message.part.updated', properties: { sessionID: sid, part: { type: 'step-start' } } },
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'step-finish', cost: 0.01, tokens: { input: 10, output: 5 } },
+                } },
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'hello world', time: { start: 1, end: 2 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const ids = [];
+        const usage = [];
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl });
+        const chunks = await collect(adapter.sendPrompt('imhub-1', 'hi', [], {
+            onAgentSessionId: (id) => ids.push(id),
+            onUsage: (d) => usage.push(d),
+        }));
+        expect(chunks).toEqual(['hello world']);
+        expect(ids[0]).toBe(sid); // Captured both at create-time and from events
+        expect(usage[0].costUsd).toBe(0.01);
+        expect(usage[0].tokensInput).toBe(10);
+        expect(usage[0].tokensOutput).toBe(5);
+        // Must have hit /event, then POST /session, POST /session/:id/message
+        const urls = hits.map(h => `${h.method} ${h.url}`);
+        expect(urls.some(u => u.startsWith('GET ') && u.endsWith('/event'))).toBe(true);
+        expect(urls.some(u => u === 'POST http://test.local/session')).toBe(true);
+        expect(urls.some(u => u === `POST http://test.local/session/${sid}/message`)).toBe(true);
+    });
+    it('skips session create and reuses agentSessionId on resume', async () => {
+        const sid = 'ses_resumed';
+        const events = [
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'second turn', time: { end: 1 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl });
+        const chunks = await collect(adapter.sendPrompt('imhub-1', 'next', [], {
+            agentSessionId: sid,
+            agentSessionResume: true,
+        }));
+        expect(chunks).toEqual(['second turn']);
+        const urls = hits.map(h => `${h.method} ${h.url}`);
+        // No POST /session — we skipped create
+        expect(urls.some(u => u === 'POST http://test.local/session')).toBe(false);
+        // But we DID submit the prompt to the right session
+        expect(urls.some(u => u === `POST http://test.local/session/${sid}/message`)).toBe(true);
+    });
+    it('falls back to "once" when no approval bus is wired', async () => {
+        // Explicit `approvalBus: null` to lock in: when the bridge is
+        // unavailable, the adapter falls back to auto-`once`.
+        const sid = 'ses_perm';
+        const events = [
+            { type: 'permission.asked', properties: { id: 'perm_1', sessionID: sid } },
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'done', time: { end: 1 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl, approvalBus: null });
+        await collect(adapter.sendPrompt('imhub-1', 'go', [], {}));
+        const replyHit = hits.find(h => h.url === 'http://test.local/permission/perm_1/reply' && h.method === 'POST');
+        expect(replyHit).toBeDefined();
+        expect(replyHit?.body?.reply).toBe('once');
+    });
+    it('falls back to "once" when bus is wired but IM ctx is missing', async () => {
+        // When the prompt comes from a non-IM caller (web UI, scheduler),
+        // there's no thread to surface a card to even though the bus is alive.
+        const { ApprovalBus } = await import('../../../core/approval-bus.js');
+        const bus = new ApprovalBus({ approvalTimeoutMs: 200 });
+        bus.setNotifier(async () => { });
+        const sid = 'ses_perm_noctx';
+        const events = [
+            { type: 'permission.asked', properties: { id: 'perm_x', sessionID: sid } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl, approvalBus: bus });
+        // No threadId / platform → bridge declines, fallback fires.
+        await collect(adapter.sendPrompt('imhub-1', 'go', [], {}));
+        const replyHit = hits.find(h => h.url === 'http://test.local/permission/perm_x/reply');
+        expect(replyHit).toBeDefined();
+        expect(replyHit?.body?.reply).toBe('once');
+        expect(bus.hasPendingFor('any')).toBe(false);
+    });
+    it('routes permission.asked through the IM bridge: allow → POST reply once', async () => {
+        const { ApprovalBus } = await import('../../../core/approval-bus.js');
+        const bus = new ApprovalBus({ approvalTimeoutMs: 5000 });
+        let notified = null;
+        bus.setNotifier(async (n) => {
+            notified = { reqId: n.reqId, toolName: n.toolName, threadId: n.ctx.threadId };
+        });
+        const sid = 'ses_bridge';
+        const events = [
+            { type: 'permission.asked', properties: {
+                    id: 'perm_b1', sessionID: sid,
+                    permission: 'external_directory',
+                    patterns: ['/root/workspace/im-hub/*'],
+                } },
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'after approval', time: { end: 1 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl, approvalBus: bus });
+        // Drive sendPrompt + simulate the user replying "y" once the bus has
+        // surfaced the request. We can't easily await mid-stream, so kick the
+        // resolve after a tick.
+        const drained = collect(adapter.sendPrompt('imhub-1', 'go', [], {
+            threadId: 'thread-X', platform: 'wechat', userId: 'u', channelId: 'c',
+        }));
+        // Wait for the notifier to fire (bridge registered its synthetic pending).
+        for (let i = 0; i < 50 && !notified; i++)
+            await new Promise(r => setTimeout(r, 5));
+        expect(notified).not.toBeNull();
+        expect(notified.reqId).toBe('perm_b1');
+        expect(notified.toolName).toBe('external_directory');
+        expect(notified.threadId).toBe('thread-X');
+        // User clicks "approve" → bus.resolvePending → adapter's dispatch → POST.
+        bus.resolvePending('thread-X', { behavior: 'allow' });
+        await drained;
+        const replyHit = hits.find(h => h.url === 'http://test.local/permission/perm_b1/reply' && h.method === 'POST');
+        expect(replyHit).toBeDefined();
+        expect(replyHit?.body?.reply).toBe('once');
+    });
+    it('routes permission.asked through the IM bridge: deny → POST reply reject + message', async () => {
+        const { ApprovalBus } = await import('../../../core/approval-bus.js');
+        const bus = new ApprovalBus({ approvalTimeoutMs: 5000 });
+        bus.setNotifier(async () => { });
+        const sid = 'ses_bridge_deny';
+        const events = [
+            { type: 'permission.asked', properties: { id: 'perm_d1', sessionID: sid, permission: 'bash' } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl, approvalBus: bus });
+        const drained = collect(adapter.sendPrompt('imhub-1', 'go', [], {
+            threadId: 'thread-Y', platform: 'wechat',
+        }));
+        for (let i = 0; i < 50 && !bus.hasPendingFor('thread-Y'); i++)
+            await new Promise(r => setTimeout(r, 5));
+        expect(bus.hasPendingFor('thread-Y')).toBe(true);
+        bus.resolvePending('thread-Y', { behavior: 'deny', message: 'user said no' });
+        await drained;
+        const replyHit = hits.find(h => h.url === 'http://test.local/permission/perm_d1/reply');
+        expect(replyHit).toBeDefined();
+        const body = replyHit.body;
+        expect(body.reply).toBe('reject');
+        expect(body.message).toBe('user said no');
+    });
+    it('surfaces session.error message as a final chunk', async () => {
+        const sid = 'ses_err';
+        const events = [
+            { type: 'session.error', properties: {
+                    sessionID: sid,
+                    error: { name: 'ProviderError', data: { message: 'rate limited' } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl });
+        const chunks = await collect(adapter.sendPrompt('imhub-1', 'oops', [], {}));
+        expect(chunks.some(c => c.includes('rate limited'))).toBe(true);
+    });
+});
+describe('OpenCodeHttpAdapter.sendPrompt — plan mode', () => {
+    it('creates a session with agent=plan and no permission ruleset', async () => {
+        const sid = 'ses_plan_new';
+        const events = [
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'plan ready', time: { end: 1 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { sessionId: sid, hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl });
+        await collect(adapter.sendPrompt('imhub-1', 'design X', [], { planMode: true }));
+        const createHit = hits.find(h => h.url === 'http://test.local/session' && h.method === 'POST');
+        expect(createHit).toBeDefined();
+        const createBody = createHit.body;
+        expect(createBody.agent).toBe('plan');
+        // plan agent's own ruleset governs — we MUST NOT stack our medium gate.
+        expect(createBody.permission).toBeUndefined();
+        const messageHit = hits.find(h => h.url === `http://test.local/session/${sid}/message` && h.method === 'POST');
+        expect(messageHit).toBeDefined();
+        const messageBody = messageHit.body;
+        expect(messageBody.agent).toBe('plan');
+    });
+    it('on resume, posts agent=plan per message and skips ruleset PATCH', async () => {
+        const sid = 'ses_plan_resume';
+        const events = [
+            { type: 'message.part.updated', properties: {
+                    sessionID: sid,
+                    part: { type: 'text', text: 'replanning', time: { end: 1 } },
+                } },
+            { type: 'session.status', properties: { sessionID: sid, status: { type: 'idle' } } },
+        ];
+        const hits = [];
+        const fetchImpl = makeFakeFetch(events, { hits });
+        const serve = makeServeStub('http://test.local');
+        const adapter = new OpenCodeHttpAdapter({ serve, fetchImpl });
+        await collect(adapter.sendPrompt('imhub-1', 'redo plan', [], {
+            agentSessionId: sid,
+            agentSessionResume: true,
+            planMode: true,
+        }));
+        const urls = hits.map(h => `${h.method} ${h.url}`);
+        // Plan-mode resume must NOT PATCH the session — plan agent's own rules win.
+        expect(urls.some(u => u === `PATCH http://test.local/session/${sid}`)).toBe(false);
+        // But it MUST submit the prompt with agent=plan to override session default.
+        const messageHit = hits.find(h => h.url === `http://test.local/session/${sid}/message` && h.method === 'POST');
+        expect(messageHit.body.agent).toBe('plan');
+    });
+});
+//# sourceMappingURL=http-adapter.test.js.map