@methodts/runtime 0.1.0

package/dist/event-bus/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/event-bus/adapters.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAOlD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAsB,EACtB,OAAO,GAAG,KAAK;IAYf,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9C,OAAO;QACL,QAAQ;QACR,aAAa,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;YAChC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ;YACxC,CAAC,CAAC,CAAC;QACL,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC"}

package/dist/event-bus/adapters.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PRD 026 Phase 2: MCP Adapter Layer Tests
+ */
+export {};
+//# sourceMappingURL=adapters.test.d.ts.map

package/dist/event-bus/adapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.test.d.ts","sourceRoot":"","sources":["../../src/event-bus/adapters.test.ts"],"names":[],"mappings":"AACA;;GAEG"}

package/dist/event-bus/adapters.test.js

@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * PRD 026 Phase 2: MCP Adapter Layer Tests
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { toChannelMessage, toAllEventsWrapper } from './adapters.js';
+function makeRuntimeEvent(overrides) {
+    return {
+        id: 'evt-001',
+        version: 1,
+        timestamp: '2026-03-24T15:00:00.000Z',
+        sequence: 42,
+        domain: 'strategy',
+        type: 'strategy.completed',
+        severity: 'info',
+        payload: { execution_id: 'exec-1', status: 'completed', cost_usd: 0.05 },
+        source: 'bridge/strategies/routes',
+        ...overrides,
+    };
+}
+describe('toChannelMessage', () => {
+    it('maps RuntimeEvent fields to legacy channel shape', () => {
+        const event = makeRuntimeEvent();
+        const result = toChannelMessage(event);
+        assert.equal(result.sequence, 42);
+        assert.equal(result.timestamp, '2026-03-24T15:00:00.000Z');
+        assert.equal(result.sender, 'bridge/strategies/routes');
+        assert.equal(result.type, 'strategy.completed');
+        assert.deepEqual(result.content, {
+            execution_id: 'exec-1',
+            status: 'completed',
+            cost_usd: 0.05,
+        });
+    });
+    it('preserves sessionId and projectId in payload if present', () => {
+        const event = makeRuntimeEvent({
+            sessionId: 'ses-1',
+            projectId: 'proj-1',
+            payload: { key: 'value' },
+        });
+        const result = toChannelMessage(event);
+        assert.deepEqual(result.content, { key: 'value' });
+        assert.equal(result.sender, 'bridge/strategies/routes');
+    });
+});
+describe('toAllEventsWrapper', () => {
+    it('wraps events in legacy all-events shape', () => {
+        const events = [
+            makeRuntimeEvent({ sequence: 1 }),
+            makeRuntimeEvent({ sequence: 2, type: 'strategy.failed' }),
+        ];
+        const result = toAllEventsWrapper(events);
+        assert.equal(result.messages.length, 2);
+        assert.equal(result.last_sequence, 2);
+        assert.equal(result.has_more, false);
+        assert.equal(result.messages[0].type, 'strategy.completed');
+        assert.equal(result.messages[1].type, 'strategy.failed');
+    });
+    it('returns zero last_sequence for empty events', () => {
+        const result = toAllEventsWrapper([]);
+        assert.equal(result.messages.length, 0);
+        assert.equal(result.last_sequence, 0);
+        assert.equal(result.has_more, false);
+    });
+    it('respects hasMore flag', () => {
+        const events = [makeRuntimeEvent({ sequence: 10 })];
+        const result = toAllEventsWrapper(events, true);
+        assert.equal(result.has_more, true);
+        assert.equal(result.last_sequence, 10);
+    });
+});
+//# sourceMappingURL=adapters.test.js.map

package/dist/event-bus/adapters.test.js.map

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

package/dist/event-bus/agent-event-adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AgentEvent-to-BridgeEvent Adapter — PRD 029 Phase C-2.
+ *
+ * Creates an onEvent callback compatible with Pacta's CreateAgentOptions.onEvent
+ * that maps AgentEvent objects to BridgeEventInput and emits them to the bus.
+ *
+ * This bridges the Pacta agent SDK observability surface into the Universal
+ * Event Bus so that agent lifecycle events appear alongside session, strategy,
+ * and trigger events.
+ */
+import type { AgentEvent } from '@methodts/pacta';
+import type { EventBus } from '../ports/event-bus.js';
+/**
+ * Create an onEvent callback that maps Pacta AgentEvents to BridgeEvents.
+ *
+ * @param eventBus - The Universal Event Bus to emit into.
+ * @param sessionId - Bridge session ID that owns this agent.
+ * @param projectId - Project ID context for the agent.
+ * @returns An onEvent callback compatible with CreateAgentOptions.onEvent.
+ */
+export declare function createAgentEventAdapter(eventBus: EventBus, sessionId: string, projectId: string): (event: AgentEvent) => void;
+//# sourceMappingURL=agent-event-adapter.d.ts.map

package/dist/event-bus/agent-event-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event-adapter.d.ts","sourceRoot":"","sources":["../../src/event-bus/agent-event-adapter.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAoC,MAAM,uBAAuB,CAAC;AAgBxF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAmB7B"}

package/dist/event-bus/agent-event-adapter.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * AgentEvent-to-BridgeEvent Adapter — PRD 029 Phase C-2.
+ *
+ * Creates an onEvent callback compatible with Pacta's CreateAgentOptions.onEvent
+ * that maps AgentEvent objects to BridgeEventInput and emits them to the bus.
+ *
+ * This bridges the Pacta agent SDK observability surface into the Universal
+ * Event Bus so that agent lifecycle events appear alongside session, strategy,
+ * and trigger events.
+ */
+// ── Severity mapping ─────────────────────────────────────────────
+const SEVERITY_MAP = {
+    error: 'error',
+    budget_exhausted: 'error',
+    budget_warning: 'warning',
+};
+function mapSeverity(eventType) {
+    return SEVERITY_MAP[eventType] ?? 'info';
+}
+// ── Adapter factory ──────────────────────────────────────────────
+/**
+ * Create an onEvent callback that maps Pacta AgentEvents to BridgeEvents.
+ *
+ * @param eventBus - The Universal Event Bus to emit into.
+ * @param sessionId - Bridge session ID that owns this agent.
+ * @param projectId - Project ID context for the agent.
+ * @returns An onEvent callback compatible with CreateAgentOptions.onEvent.
+ */
+export function createAgentEventAdapter(eventBus, sessionId, projectId) {
+    return (event) => {
+        const runtimeEvent = {
+            version: 1,
+            domain: 'agent',
+            type: `agent.${event.type}`,
+            severity: mapSeverity(event.type),
+            sessionId,
+            projectId,
+            payload: {
+                ...event,
+                sessionId,
+                projectId,
+            },
+            source: `runtime/event-bus/agent-event-adapter/${sessionId}`,
+        };
+        eventBus.emit(runtimeEvent);
+    };
+}
+//# sourceMappingURL=agent-event-adapter.js.map

package/dist/event-bus/agent-event-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event-adapter.js","sourceRoot":"","sources":["../../src/event-bus/agent-event-adapter.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;GASG;AAKH,oEAAoE;AAEpE,MAAM,YAAY,GAAkC;IAClD,KAAK,EAAE,OAAO;IACd,gBAAgB,EAAE,OAAO;IACzB,cAAc,EAAE,SAAS;CAC1B,CAAC;AAEF,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC;AAC3C,CAAC;AAED,oEAAoE;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkB,EAClB,SAAiB,EACjB,SAAiB;IAEjB,OAAO,CAAC,KAAiB,EAAQ,EAAE;QACjC,MAAM,YAAY,GAAsB;YACtC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE;YAC3B,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,SAAS;YACT,SAAS;YACT,OAAO,EAAE;gBACP,GAAG,KAAK;gBACR,SAAS;gBACT,SAAS;aACV;YACD,MAAM,EAAE,yCAAyC,SAAS,EAAE;SAC7D,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC"}

package/dist/event-bus/agent-event-adapter.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for AgentEvent-to-RuntimeEvent adapter (PRD 029 Phase C-2).
+ */
+export {};
+//# sourceMappingURL=agent-event-adapter.test.d.ts.map

package/dist/event-bus/agent-event-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event-adapter.test.d.ts","sourceRoot":"","sources":["../../src/event-bus/agent-event-adapter.test.ts"],"names":[],"mappings":"AACA;;GAEG"}

package/dist/event-bus/agent-event-adapter.test.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Unit tests for AgentEvent-to-RuntimeEvent adapter (PRD 029 Phase C-2).
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { createAgentEventAdapter } from './agent-event-adapter.js';
+// ── Mock EventBus ─────────────────────────────────────────────────
+function createMockBus() {
+    let seq = 0;
+    const emitted = [];
+    return {
+        emitted,
+        emit(input) {
+            seq++;
+            const event = {
+                ...input,
+                id: `evt-${seq}`,
+                timestamp: new Date().toISOString(),
+                sequence: seq,
+            };
+            emitted.push(event);
+            return event;
+        },
+        importEvent(_event) { },
+        subscribe(_filter, _handler) {
+            return { unsubscribe: () => { } };
+        },
+        query(_filter) { return []; },
+        registerSink(_sink) { },
+    };
+}
+// ── Tests ──────────────────────────────────────────────────────
+describe('createAgentEventAdapter', () => {
+    let bus;
+    let onEvent;
+    const SESSION_ID = 'sess-abc';
+    const PROJECT_ID = 'proj-123';
+    beforeEach(() => {
+        bus = createMockBus();
+        onEvent = createAgentEventAdapter(bus, SESSION_ID, PROJECT_ID);
+    });
+    describe('type mapping', () => {
+        it('maps started to agent.started', () => {
+            onEvent({ type: 'started', sessionId: 'pacta-sess', timestamp: new Date().toISOString() });
+            assert.equal(bus.emitted.length, 1);
+            assert.equal(bus.emitted[0].type, 'agent.started');
+        });
+        it('maps text to agent.text', () => {
+            onEvent({ type: 'text', content: 'hello' });
+            assert.equal(bus.emitted[0].type, 'agent.text');
+        });
+        it('maps thinking to agent.thinking', () => {
+            onEvent({ type: 'thinking', content: 'reasoning...' });
+            assert.equal(bus.emitted[0].type, 'agent.thinking');
+        });
+        it('maps tool_use to agent.tool_use', () => {
+            onEvent({ type: 'tool_use', tool: 'read', input: {}, toolUseId: 'tu-1' });
+            assert.equal(bus.emitted[0].type, 'agent.tool_use');
+        });
+        it('maps tool_result to agent.tool_result', () => {
+            onEvent({ type: 'tool_result', tool: 'read', output: 'data', toolUseId: 'tu-1', durationMs: 100 });
+            assert.equal(bus.emitted[0].type, 'agent.tool_result');
+        });
+        it('maps turn_complete to agent.turn_complete', () => {
+            onEvent({
+                type: 'turn_complete',
+                turnNumber: 3,
+                usage: { inputTokens: 100, outputTokens: 50, totalTokens: 150, cacheReadTokens: 0, cacheWriteTokens: 0 },
+            });
+            assert.equal(bus.emitted[0].type, 'agent.turn_complete');
+        });
+        it('maps context_compacted to agent.context_compacted', () => {
+            onEvent({ type: 'context_compacted', fromTokens: 50000, toTokens: 10000 });
+            assert.equal(bus.emitted[0].type, 'agent.context_compacted');
+        });
+        it('maps reflection to agent.reflection', () => {
+            onEvent({ type: 'reflection', trial: 2, critique: 'needs improvement' });
+            assert.equal(bus.emitted[0].type, 'agent.reflection');
+        });
+        it('maps budget_warning to agent.budget_warning', () => {
+            onEvent({ type: 'budget_warning', resource: 'tokens', consumed: 80000, limit: 100000, percentUsed: 80 });
+            assert.equal(bus.emitted[0].type, 'agent.budget_warning');
+        });
+        it('maps budget_exhausted to agent.budget_exhausted', () => {
+            onEvent({ type: 'budget_exhausted', resource: 'cost', consumed: 10, limit: 10 });
+            assert.equal(bus.emitted[0].type, 'agent.budget_exhausted');
+        });
+        it('maps error to agent.error', () => {
+            onEvent({ type: 'error', message: 'API failure', recoverable: true });
+            assert.equal(bus.emitted[0].type, 'agent.error');
+        });
+        it('maps completed to agent.completed', () => {
+            onEvent({
+                type: 'completed',
+                result: { answer: 42 },
+                usage: { inputTokens: 1000, outputTokens: 500, totalTokens: 1500, cacheReadTokens: 0, cacheWriteTokens: 0 },
+                cost: { totalUsd: 0.03, perModel: {} },
+                durationMs: 5000,
+                turns: 3,
+            });
+            assert.equal(bus.emitted[0].type, 'agent.completed');
+        });
+    });
+    describe('domain', () => {
+        it('sets domain to agent for all events', () => {
+            onEvent({ type: 'started', sessionId: 'x', timestamp: new Date().toISOString() });
+            onEvent({ type: 'text', content: 'hi' });
+            onEvent({ type: 'error', message: 'fail', recoverable: false });
+            for (const e of bus.emitted) {
+                assert.equal(e.domain, 'agent');
+            }
+        });
+    });
+    describe('severity mapping', () => {
+        it('maps error type to error severity', () => {
+            onEvent({ type: 'error', message: 'fail', recoverable: false });
+            assert.equal(bus.emitted[0].severity, 'error');
+        });
+        it('maps budget_exhausted to error severity', () => {
+            onEvent({ type: 'budget_exhausted', resource: 'tokens', consumed: 100, limit: 100 });
+            assert.equal(bus.emitted[0].severity, 'error');
+        });
+        it('maps budget_warning to warning severity', () => {
+            onEvent({ type: 'budget_warning', resource: 'cost', consumed: 8, limit: 10, percentUsed: 80 });
+            assert.equal(bus.emitted[0].severity, 'warning');
+        });
+        it('maps other types to info severity', () => {
+            onEvent({ type: 'started', sessionId: 'x', timestamp: new Date().toISOString() });
+            assert.equal(bus.emitted[0].severity, 'info');
+            onEvent({ type: 'text', content: 'hi' });
+            assert.equal(bus.emitted[1].severity, 'info');
+            onEvent({ type: 'completed', result: null, usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 }, cost: { totalUsd: 0, perModel: {} }, durationMs: 0, turns: 0 });
+            assert.equal(bus.emitted[2].severity, 'info');
+            onEvent({ type: 'tool_use', tool: 'x', input: {}, toolUseId: 'tu-1' });
+            assert.equal(bus.emitted[3].severity, 'info');
+        });
+    });
+    describe('session and project attachment', () => {
+        it('attaches sessionId to the RuntimeEvent', () => {
+            onEvent({ type: 'text', content: 'hi' });
+            assert.equal(bus.emitted[0].sessionId, SESSION_ID);
+        });
+        it('attaches projectId to the RuntimeEvent', () => {
+            onEvent({ type: 'text', content: 'hi' });
+            assert.equal(bus.emitted[0].projectId, PROJECT_ID);
+        });
+        it('includes sessionId and projectId in the payload', () => {
+            onEvent({ type: 'text', content: 'hi' });
+            assert.equal(bus.emitted[0].payload.sessionId, SESSION_ID);
+            assert.equal(bus.emitted[0].payload.projectId, PROJECT_ID);
+        });
+    });
+    describe('payload passthrough', () => {
+        it('includes original AgentEvent data in payload', () => {
+            onEvent({ type: 'tool_use', tool: 'bash', input: { cmd: 'ls' }, toolUseId: 'tu-99' });
+            const payload = bus.emitted[0].payload;
+            assert.equal(payload.tool, 'bash');
+            assert.equal(payload.toolUseId, 'tu-99');
+            assert.deepEqual(payload.input, { cmd: 'ls' });
+        });
+    });
+    describe('source', () => {
+        it('sets source to runtime/event-bus/agent-event-adapter/{sessionId}', () => {
+            onEvent({ type: 'text', content: 'hi' });
+            assert.equal(bus.emitted[0].source, `runtime/event-bus/agent-event-adapter/${SESSION_ID}`);
+        });
+    });
+});
+//# sourceMappingURL=agent-event-adapter.test.js.map

package/dist/event-bus/agent-event-adapter.test.js.map

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

package/dist/event-bus/channel-sink.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ChannelSink — PRD 026 Phase 3.
+ *
+ * Replaces the legacy appendMessage channel system. Subscribes to ALL events
+ * from the bus and maintains per-session ring buffers. Provides cursor-based
+ * reads for REST endpoints and triggers push notifications to parent agents
+ * for events with severity warning/error/critical.
+ *
+ * Channel classification: events are classified as 'progress' or 'events'
+ * based on type and payload, matching the legacy dual-channel design.
+ */
+import type { RuntimeEvent, EventSink } from '../ports/event-bus.js';
+import { toChannelMessage } from './adapters.js';
+export interface ChannelSinkOptions {
+    /** Per-session buffer capacity (default: 200). */
+    capacity?: number;
+    /** Callback for push notifications to parent agents. */
+    pushToParent?: (sessionId: string, event: RuntimeEvent) => void;
+}
+/**
+ * Classify a RuntimeEvent as belonging to the 'progress' or 'events' channel.
+ * Matches legacy dual-channel behavior from channels.ts.
+ */
+export declare function getChannelTarget(event: RuntimeEvent): 'progress' | 'events';
+export declare class ChannelSink implements EventSink {
+    readonly name = "channels";
+    private readonly capacity;
+    private readonly sessions;
+    private readonly pushToParent;
+    private lastSequence;
+    constructor(options?: ChannelSinkOptions);
+    /**
+     * Initialize from persisted cursor state.
+     */
+    initFromCursor(cursor: number): void;
+    /** Current cursor position (last processed sequence). */
+    get cursor(): number;
+    onEvent(event: RuntimeEvent): void;
+    onError(error: Error, event: RuntimeEvent): void;
+    /**
+     * Get events for a session, optionally filtered by channel target.
+     * Returns backward-compatible ChannelMessage shape.
+     */
+    getEvents(sessionId: string, sinceSequence?: number, channel?: 'progress' | 'events'): {
+        messages: Array<ReturnType<typeof toChannelMessage>>;
+        last_sequence: number;
+        has_more: boolean;
+    };
+    /**
+     * Get aggregated events across all sessions, sorted by timestamp.
+     * Returns backward-compatible shape for GET /channels/events.
+     */
+    getAggregated(sinceSequence?: number, filterType?: string): {
+        events: Array<{
+            bridge_session_id: string;
+            session_metadata: Record<string, unknown>;
+            message: ReturnType<typeof toChannelMessage>;
+        }>;
+        last_sequence: number;
+    };
+    /**
+     * Get all session IDs that have buffered events.
+     */
+    getSessionIds(): string[];
+    /**
+     * Remove a session's buffer (e.g., on session kill).
+     */
+    removeSession(sessionId: string): void;
+    private getOrCreateBuffer;
+}
+//# sourceMappingURL=channel-sink.d.ts.map

package/dist/event-bus/channel-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-sink.d.ts","sourceRoot":"","sources":["../../src/event-bus/channel-sink.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIjD,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACjE;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAY3E;AAyBD,qBAAa,WAAY,YAAW,SAAS;IAC3C,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4D;IACzF,OAAO,CAAC,YAAY,CAAK;gBAEb,OAAO,GAAE,kBAAuB;IAK5C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC,yDAAyD;IACzD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAID,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAmBlC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAMhD;;;OAGG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,aAAa,SAAI,EACjB,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,GAC9B;QAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAoBrG;;;OAGG;IACH,aAAa,CACX,aAAa,SAAI,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB;QACD,MAAM,EAAE,KAAK,CAAC;YACZ,iBAAiB,EAAE,MAAM,CAAC;YAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;SAC9C,CAAC,CAAC;QACH,aAAa,EAAE,MAAM,CAAC;KACvB;IAoCD;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMtC,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/event-bus/channel-sink.js

@@ -0,0 +1,159 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * ChannelSink — PRD 026 Phase 3.
+ *
+ * Replaces the legacy appendMessage channel system. Subscribes to ALL events
+ * from the bus and maintains per-session ring buffers. Provides cursor-based
+ * reads for REST endpoints and triggers push notifications to parent agents
+ * for events with severity warning/error/critical.
+ *
+ * Channel classification: events are classified as 'progress' or 'events'
+ * based on type and payload, matching the legacy dual-channel design.
+ */
+import { toChannelMessage } from './adapters.js';
+const DEFAULT_CAPACITY = 200;
+// ── Channel classification ──────────────────────────────────────
+/**
+ * Classify a RuntimeEvent as belonging to the 'progress' or 'events' channel.
+ * Matches legacy dual-channel behavior from channels.ts.
+ */
+export function getChannelTarget(event) {
+    // Explicit channel target in payload (from pty-watcher)
+    if (event.payload.channelTarget === 'progress')
+        return 'progress';
+    if (event.payload.channelTarget === 'events')
+        return 'events';
+    // Methodology step events are progress
+    if (event.type === 'methodology.step_completed' || event.type === 'methodology.step_started') {
+        return 'progress';
+    }
+    // Default: events
+    return 'events';
+}
+function createSessionBuffer(capacity) {
+    return { events: [], capacity };
+}
+function pushToBuffer(buf, event) {
+    buf.events.push(event);
+    if (buf.events.length > buf.capacity) {
+        buf.events.shift(); // evict oldest
+    }
+}
+// ── ChannelSink ─────────────────────────────────────────────────
+/** Severity levels that trigger push notifications to parent agents. */
+const PUSH_SEVERITIES = new Set(['warning', 'error', 'critical']);
+export class ChannelSink {
+    name = 'channels';
+    capacity;
+    sessions = new Map();
+    pushToParent;
+    lastSequence = 0;
+    constructor(options = {}) {
+        this.capacity = options.capacity ?? DEFAULT_CAPACITY;
+        this.pushToParent = options.pushToParent ?? null;
+    }
+    /**
+     * Initialize from persisted cursor state.
+     */
+    initFromCursor(cursor) {
+        this.lastSequence = cursor;
+    }
+    /** Current cursor position (last processed sequence). */
+    get cursor() {
+        return this.lastSequence;
+    }
+    // ── EventSink interface ──────────────────────────────────────
+    onEvent(event) {
+        // Cursor recovery: skip already-processed events
+        if (event.sequence <= this.lastSequence)
+            return;
+        this.lastSequence = event.sequence;
+        // Only buffer events that have a sessionId
+        if (event.sessionId) {
+            const buf = this.getOrCreateBuffer(event.sessionId);
+            pushToBuffer(buf, event);
+        }
+        // Push notification for elevated severity events
+        if (event.sessionId && PUSH_SEVERITIES.has(event.severity) && this.pushToParent) {
+            try {
+                this.pushToParent(event.sessionId, event);
+            }
+            catch { /* push failure is non-fatal */ }
+        }
+    }
+    onError(error, event) {
+        console.error(`[channel-sink] Error processing event ${event.id}:`, error.message);
+    }
+    // ── Read methods ─────────────────────────────────────────────
+    /**
+     * Get events for a session, optionally filtered by channel target.
+     * Returns backward-compatible ChannelMessage shape.
+     */
+    getEvents(sessionId, sinceSequence = 0, channel) {
+        const buf = this.sessions.get(sessionId);
+        if (!buf) {
+            return { messages: [], last_sequence: sinceSequence, has_more: false };
+        }
+        let filtered = buf.events.filter(e => e.sequence > sinceSequence);
+        if (channel) {
+            filtered = filtered.filter(e => getChannelTarget(e) === channel);
+        }
+        const messages = filtered.map(toChannelMessage);
+        const lastSeq = messages.length > 0
+            ? messages[messages.length - 1].sequence
+            : sinceSequence;
+        return { messages, last_sequence: lastSeq, has_more: false };
+    }
+    /**
+     * Get aggregated events across all sessions, sorted by timestamp.
+     * Returns backward-compatible shape for GET /channels/events.
+     */
+    getAggregated(sinceSequence = 0, filterType) {
+        const results = [];
+        let globalLastSequence = sinceSequence;
+        for (const [sessionId, buf] of this.sessions) {
+            for (const event of buf.events) {
+                if (event.sequence <= sinceSequence)
+                    continue;
+                // Channel target filter: aggregated endpoint shows 'events' channel by default
+                if (getChannelTarget(event) !== 'events')
+                    continue;
+                const msg = toChannelMessage(event);
+                if (filterType && msg.type !== filterType)
+                    continue;
+                results.push({
+                    bridge_session_id: sessionId,
+                    session_metadata: event.payload.metadata ?? {},
+                    message: msg,
+                });
+                if (event.sequence > globalLastSequence) {
+                    globalLastSequence = event.sequence;
+                }
+            }
+        }
+        results.sort((a, b) => a.message.timestamp.localeCompare(b.message.timestamp));
+        return { events: results, last_sequence: globalLastSequence };
+    }
+    /**
+     * Get all session IDs that have buffered events.
+     */
+    getSessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Remove a session's buffer (e.g., on session kill).
+     */
+    removeSession(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    // ── Internal ─────────────────────────────────────────────────
+    getOrCreateBuffer(sessionId) {
+        let buf = this.sessions.get(sessionId);
+        if (!buf) {
+            buf = createSessionBuffer(this.capacity);
+            this.sessions.set(sessionId, buf);
+        }
+        return buf;
+    }
+}
+//# sourceMappingURL=channel-sink.js.map

package/dist/event-bus/channel-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-sink.js","sourceRoot":"","sources":["../../src/event-bus/channel-sink.ts"],"names":[],"mappings":"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"}

package/dist/event-bus/channel-sink.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for ChannelSink (PRD 026 Phase 3).
+ */
+export {};
+//# sourceMappingURL=channel-sink.test.d.ts.map

package/dist/event-bus/channel-sink.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-sink.test.d.ts","sourceRoot":"","sources":["../../src/event-bus/channel-sink.test.ts"],"names":[],"mappings":"AACA;;GAEG"}