@methodts/runtime 0.1.0

package/dist/sessions/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/sessions/channels.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAOF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,GAAG,CAAiC;IAC5C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAK5B,IAAI,MAAM,IAAI,MAAM,CAAuB;IAE3C,sDAAsD;IACtD,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAW/B,oDAAoD;IACpD,IAAI,IAAI,cAAc,GAAG,SAAS;IAKlC,iEAAiE;IACjE,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAS9D,kEAAkE;IAClE,OAAO,IAAI,cAAc,EAAE;CAO5B;AAMD,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAElE;AAeD,wBAAgB,qBAAqB,IAAI,eAAe,CAKvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,MAAU,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAiB1E"}

package/dist/sessions/channels.js

@@ -0,0 +1,118 @@
+// SPDX-License-Identifier: Apache-2.0
+// ── PRD 008: Channel infrastructure for agent visibility ─────
+// Constants
+const MAX_MESSAGES_PER_CHANNEL = 1000;
+// ── Ring buffer for O(1) append + eviction ───────────────────
+export class ChannelRingBuffer {
+    buf;
+    head = 0; // index of oldest element
+    count = 0; // number of live elements
+    capacity;
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.buf = new Array(capacity);
+    }
+    get length() { return this.count; }
+    /** O(1) append — overwrites oldest slot when full. */
+    push(msg) {
+        const writeIdx = (this.head + this.count) % this.capacity;
+        this.buf[writeIdx] = msg;
+        if (this.count === this.capacity) {
+            // Buffer full — advance head (evict oldest) in O(1)
+            this.head = (this.head + 1) % this.capacity;
+        }
+        else {
+            this.count++;
+        }
+    }
+    /** Last (newest) element, or undefined if empty. */
+    last() {
+        if (this.count === 0)
+            return undefined;
+        return this.buf[(this.head + this.count - 1) % this.capacity];
+    }
+    /** Return messages matching predicate, ordered oldest→newest. */
+    filter(fn) {
+        const result = [];
+        for (let i = 0; i < this.count; i++) {
+            const msg = this.buf[(this.head + i) % this.capacity];
+            if (fn(msg))
+                result.push(msg);
+        }
+        return result;
+    }
+    /** Materialize full contents as a plain array (oldest→newest). */
+    toArray() {
+        const result = new Array(this.count);
+        for (let i = 0; i < this.count; i++) {
+            result[i] = this.buf[(this.head + i) % this.capacity];
+        }
+        return result;
+    }
+}
+// ── Internal ring-buffer storage (hidden from Channel type) ──
+const rings = new WeakMap();
+/** @internal Retrieve the ring buffer backing a channel. */
+export function getChannelRing(channel) {
+    return rings.get(channel);
+}
+// Factory
+function createChannel(name) {
+    const ring = new ChannelRingBuffer(MAX_MESSAGES_PER_CHANNEL);
+    const channel = {
+        name,
+        get messages() { return ring.toArray(); },
+        cursors: new Map(),
+    };
+    rings.set(channel, ring);
+    return channel;
+}
+export function createSessionChannels() {
+    return {
+        progress: createChannel('progress'),
+        events: createChannel('events'),
+    };
+}
+/**
+ * Append a message to a channel. Returns the sequence number.
+ *
+ * NOTE: PRD 026 Phase 3 removed all domain callers — events flow through
+ * the EventBus + ChannelSink now. This function is retained for test
+ * infrastructure only (channels.test.ts, worktree-stale.test.ts).
+ *
+ * PRD 026 Phase 4: onMessage hook infrastructure removed (was dead code).
+ */
+export function appendMessage(channel, sender, type, content) {
+    const ring = rings.get(channel);
+    const last = ring.last();
+    const sequence = last ? last.sequence + 1 : 1;
+    const message = {
+        sequence,
+        timestamp: new Date().toISOString(),
+        sender,
+        type,
+        content,
+    };
+    ring.push(message);
+    return sequence;
+}
+/**
+ * Read messages since a sequence number. Returns messages and the last sequence.
+ */
+export function readMessages(channel, sinceSequence = 0, readerId) {
+    const ring = rings.get(channel);
+    const filtered = ring.filter(m => m.sequence > sinceSequence);
+    const lastSeq = filtered.length > 0
+        ? filtered[filtered.length - 1].sequence
+        : sinceSequence;
+    // Update cursor if reader_id provided
+    if (readerId) {
+        channel.cursors.set(readerId, lastSeq);
+    }
+    return {
+        messages: filtered,
+        last_sequence: lastSeq,
+        has_more: false, // No pagination for MVP
+    };
+}
+//# sourceMappingURL=channels.js.map

package/dist/sessions/channels.js.map

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

package/dist/sessions/channels.test.d.ts

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

package/dist/sessions/channels.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.test.d.ts","sourceRoot":"","sources":["../../src/sessions/channels.test.ts"],"names":[],"mappings":""}

package/dist/sessions/channels.test.js

@@ -0,0 +1,285 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { createSessionChannels, appendMessage, readMessages, } from './channels.js';
+describe('Channel Infrastructure (PRD 008)', () => {
+    // ── createSessionChannels() ───────────────────────────────────
+    describe('createSessionChannels()', () => {
+        it('creates progress and events channels with empty messages', () => {
+            const channels = createSessionChannels();
+            assert.ok(channels.progress);
+            assert.ok(channels.events);
+            assert.deepEqual(channels.progress.messages, []);
+            assert.deepEqual(channels.events.messages, []);
+        });
+        it('channels have correct names', () => {
+            const channels = createSessionChannels();
+            assert.equal(channels.progress.name, 'progress');
+            assert.equal(channels.events.name, 'events');
+        });
+        it('channels start with empty cursors', () => {
+            const channels = createSessionChannels();
+            assert.equal(channels.progress.cursors.size, 0);
+            assert.equal(channels.events.cursors.size, 0);
+        });
+    });
+    // ── appendMessage() ──────────────────────────────────────────
+    describe('appendMessage()', () => {
+        let channel;
+        beforeEach(() => {
+            const channels = createSessionChannels();
+            channel = channels.progress;
+        });
+        it('appends a message with sequence starting at 1', () => {
+            const seq = appendMessage(channel, 'session-abc', 'step_started', { step: 'sigma_0' });
+            assert.equal(seq, 1);
+            assert.equal(channel.messages.length, 1);
+            assert.equal(channel.messages[0].sequence, 1);
+        });
+        it('sequential appends get monotonically increasing sequences', () => {
+            const seq1 = appendMessage(channel, 'session-abc', 'step_started', { step: 'sigma_0' });
+            const seq2 = appendMessage(channel, 'session-abc', 'working_on', { desc: 'loading YAML' });
+            const seq3 = appendMessage(channel, 'session-abc', 'step_completed', { step: 'sigma_0' });
+            assert.equal(seq1, 1);
+            assert.equal(seq2, 2);
+            assert.equal(seq3, 3);
+            assert.ok(seq1 < seq2);
+            assert.ok(seq2 < seq3);
+        });
+        it('message has correct ISO 8601 timestamp format', () => {
+            appendMessage(channel, 'session-abc', 'step_started', { step: 'sigma_0' });
+            const msg = channel.messages[0];
+            // ISO 8601 pattern: YYYY-MM-DDTHH:mm:ss.sssZ
+            const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
+            assert.match(msg.timestamp, isoRegex);
+            // Also verify it parses as a valid date
+            const parsed = new Date(msg.timestamp);
+            assert.ok(!isNaN(parsed.getTime()));
+        });
+        it('message has correct sender, type, and content', () => {
+            const content = { step: 'sigma_0', methodology: 'P2-SD' };
+            appendMessage(channel, 'agent-42', 'step_started', content);
+            const msg = channel.messages[0];
+            assert.equal(msg.sender, 'agent-42');
+            assert.equal(msg.type, 'step_started');
+            assert.deepEqual(msg.content, content);
+        });
+        it('returns the sequence number', () => {
+            const seq = appendMessage(channel, 'session-abc', 'info', { detail: 'test' });
+            assert.equal(typeof seq, 'number');
+            assert.equal(seq, 1);
+        });
+    });
+    // ── readMessages() ───────────────────────────────────────────
+    describe('readMessages()', () => {
+        let channel;
+        beforeEach(() => {
+            const channels = createSessionChannels();
+            channel = channels.progress;
+            appendMessage(channel, 'agent-1', 'step_started', { step: 'sigma_0' });
+            appendMessage(channel, 'agent-1', 'working_on', { desc: 'validating schema' });
+            appendMessage(channel, 'agent-1', 'step_completed', { step: 'sigma_0' });
+        });
+        it('returns all messages when sinceSequence is 0', () => {
+            const result = readMessages(channel, 0);
+            assert.equal(result.messages.length, 3);
+            assert.equal(result.messages[0].sequence, 1);
+            assert.equal(result.messages[1].sequence, 2);
+            assert.equal(result.messages[2].sequence, 3);
+        });
+        it('returns only messages after sinceSequence', () => {
+            const result = readMessages(channel, 2);
+            assert.equal(result.messages.length, 1);
+            assert.equal(result.messages[0].sequence, 3);
+            assert.equal(result.messages[0].type, 'step_completed');
+        });
+        it('returns empty array when no messages match', () => {
+            const result = readMessages(channel, 3);
+            assert.equal(result.messages.length, 0);
+        });
+        it('returns correct last_sequence', () => {
+            const result = readMessages(channel, 0);
+            assert.equal(result.last_sequence, 3);
+            const result2 = readMessages(channel, 2);
+            assert.equal(result2.last_sequence, 3);
+        });
+        it('returns sinceSequence as last_sequence when no messages match', () => {
+            const result = readMessages(channel, 99);
+            assert.equal(result.last_sequence, 99);
+        });
+        it('updates cursor when readerId is provided', () => {
+            readMessages(channel, 0, 'parent-agent');
+            assert.equal(channel.cursors.get('parent-agent'), 3);
+        });
+        it('does not create cursor when readerId is omitted', () => {
+            readMessages(channel, 0);
+            assert.equal(channel.cursors.size, 0);
+        });
+        it('has_more is false (MVP — no pagination)', () => {
+            const result = readMessages(channel, 0);
+            assert.equal(result.has_more, false);
+            const result2 = readMessages(channel, 2);
+            assert.equal(result2.has_more, false);
+        });
+    });
+    // ── Message cap (1000 limit) ─────────────────────────────────
+    describe('message cap (1000 limit)', () => {
+        it('after 1001 appends, only 1000 messages remain', () => {
+            const channels = createSessionChannels();
+            const channel = channels.progress;
+            for (let i = 0; i < 1001; i++) {
+                appendMessage(channel, 'agent-bulk', 'tick', { index: i });
+            }
+            assert.equal(channel.messages.length, 1000);
+        });
+        it('the evicted message is the oldest (first appended)', () => {
+            const channels = createSessionChannels();
+            const channel = channels.progress;
+            for (let i = 0; i < 1001; i++) {
+                appendMessage(channel, 'agent-bulk', 'tick', { index: i });
+            }
+            // The first message (index: 0, sequence: 1) should have been evicted
+            const firstRemaining = channel.messages[0];
+            assert.equal(firstRemaining.sequence, 2);
+            assert.deepEqual(firstRemaining.content, { index: 1 });
+        });
+        it('the newest message is preserved', () => {
+            const channels = createSessionChannels();
+            const channel = channels.progress;
+            for (let i = 0; i < 1001; i++) {
+                appendMessage(channel, 'agent-bulk', 'tick', { index: i });
+            }
+            const lastMsg = channel.messages[channel.messages.length - 1];
+            assert.equal(lastMsg.sequence, 1001);
+            assert.deepEqual(lastMsg.content, { index: 1000 });
+        });
+    });
+    // ── Real scenario: methodology step progression ──────────────
+    describe('real scenario: methodology step progression', () => {
+        it('simulates agent working through methodology steps', () => {
+            const channels = createSessionChannels();
+            const ch = channels.progress;
+            const sessionId = 'session-method-run-42';
+            // 1. Agent starts sigma_0
+            appendMessage(ch, sessionId, 'step_started', {
+                step: 'sigma_0',
+                methodology: 'P2-SD',
+                label: 'Orientation',
+            });
+            // 2. Agent reports what it is working on
+            appendMessage(ch, sessionId, 'working_on', {
+                description: 'Reading project card and delivery rules',
+            });
+            // 3. Agent completes sigma_0
+            appendMessage(ch, sessionId, 'step_completed', {
+                step: 'sigma_0',
+                duration_ms: 4500,
+            });
+            // 4. Agent starts sigma_1
+            appendMessage(ch, sessionId, 'step_started', {
+                step: 'sigma_1',
+                methodology: 'P2-SD',
+                label: 'Discovery',
+            });
+            // 5. Read all progress — should have 4 messages
+            const allMessages = readMessages(ch, 0);
+            assert.equal(allMessages.messages.length, 4);
+            assert.equal(allMessages.last_sequence, 4);
+            // 6. Read since sequence 2 — should have 2 messages
+            const recentMessages = readMessages(ch, 2);
+            assert.equal(recentMessages.messages.length, 2);
+            assert.equal(recentMessages.messages[0].type, 'step_completed');
+            assert.equal(recentMessages.messages[1].type, 'step_started');
+            assert.deepEqual(recentMessages.messages[1].content.step, 'sigma_1');
+            // Verify timestamps are in chronological order
+            for (let i = 1; i < allMessages.messages.length; i++) {
+                const prev = new Date(allMessages.messages[i - 1].timestamp).getTime();
+                const curr = new Date(allMessages.messages[i].timestamp).getTime();
+                assert.ok(curr >= prev, `Message ${i} timestamp should be >= message ${i - 1}`);
+            }
+        });
+    });
+    // ── Real scenario: event lifecycle ───────────────────────────
+    describe('real scenario: event lifecycle', () => {
+        it('tracks session events from start to completion', () => {
+            const channels = createSessionChannels();
+            const ch = channels.events;
+            // Bridge auto-generates a 'started' event when session spawns
+            appendMessage(ch, 'bridge', 'started', {
+                session_id: 'session-xyz',
+                workdir: '/home/user/project',
+                methodology: 'P2-SD',
+                spawned_at: new Date().toISOString(),
+            });
+            // Bridge generates a 'completed' event when session finishes
+            appendMessage(ch, 'bridge', 'completed', {
+                session_id: 'session-xyz',
+                result: 'success',
+                prompts_sent: 12,
+                total_duration_ms: 45000,
+            });
+            // Read all events — should have 2 messages
+            const result = readMessages(ch, 0);
+            assert.equal(result.messages.length, 2);
+            // Verify content fields are preserved exactly
+            const startedEvent = result.messages[0];
+            assert.equal(startedEvent.sender, 'bridge');
+            assert.equal(startedEvent.type, 'started');
+            assert.equal(startedEvent.content.session_id, 'session-xyz');
+            assert.equal(startedEvent.content.workdir, '/home/user/project');
+            assert.equal(startedEvent.content.methodology, 'P2-SD');
+            const completedEvent = result.messages[1];
+            assert.equal(completedEvent.sender, 'bridge');
+            assert.equal(completedEvent.type, 'completed');
+            assert.equal(completedEvent.content.result, 'success');
+            assert.equal(completedEvent.content.prompts_sent, 12);
+            assert.equal(completedEvent.content.total_duration_ms, 45000);
+        });
+    });
+    // ── Cursor isolation ─────────────────────────────────────────
+    describe('cursor isolation', () => {
+        it('two readers have independent cursors on the same channel', () => {
+            const channels = createSessionChannels();
+            const ch = channels.progress;
+            // Append initial messages
+            appendMessage(ch, 'worker', 'step_started', { step: 'sigma_0' });
+            appendMessage(ch, 'worker', 'step_completed', { step: 'sigma_0' });
+            // Reader 1 reads all messages
+            const r1First = readMessages(ch, 0, 'orchestrator');
+            assert.equal(r1First.messages.length, 2);
+            assert.equal(ch.cursors.get('orchestrator'), 2);
+            // Reader 2 reads all messages
+            const r2First = readMessages(ch, 0, 'dashboard');
+            assert.equal(r2First.messages.length, 2);
+            assert.equal(ch.cursors.get('dashboard'), 2);
+            // New message arrives
+            appendMessage(ch, 'worker', 'step_started', { step: 'sigma_1' });
+            // Reader 1 reads new messages using its cursor
+            const cursor1 = ch.cursors.get('orchestrator');
+            const r1Second = readMessages(ch, cursor1, 'orchestrator');
+            assert.equal(r1Second.messages.length, 1);
+            assert.equal(r1Second.messages[0].type, 'step_started');
+            assert.deepEqual(r1Second.messages[0].content, { step: 'sigma_1' });
+            assert.equal(ch.cursors.get('orchestrator'), 3);
+            // Reader 2 hasn't read yet — using its cursor still shows the new message
+            const cursor2 = ch.cursors.get('dashboard');
+            const r2Second = readMessages(ch, cursor2, 'dashboard');
+            assert.equal(r2Second.messages.length, 1);
+            assert.equal(ch.cursors.get('dashboard'), 3);
+            // Another new message
+            appendMessage(ch, 'worker', 'working_on', { desc: 'analyzing dependencies' });
+            // Reader 1 reads again — only 1 new message
+            const cursor1b = ch.cursors.get('orchestrator');
+            const r1Third = readMessages(ch, cursor1b, 'orchestrator');
+            assert.equal(r1Third.messages.length, 1);
+            assert.equal(r1Third.messages[0].type, 'working_on');
+            assert.equal(ch.cursors.get('orchestrator'), 4);
+            // Reader 2 hasn't read — using its cursor shows 1 new message too
+            const cursor2b = ch.cursors.get('dashboard');
+            const r2Third = readMessages(ch, cursor2b, 'dashboard');
+            assert.equal(r2Third.messages.length, 1);
+            assert.equal(ch.cursors.get('dashboard'), 4);
+        });
+    });
+});
+//# sourceMappingURL=channels.test.js.map

package/dist/sessions/channels.test.js.map

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

package/dist/sessions/cognitive-modules.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Bridge Cognitive Modules — CognitiveModule implementations extracted from
+ * the monolithic cognitive-provider.ts inline loop.
+ *
+ * BridgeReasonerActorModule: extracts the inner while-loop (multi-tool cycle)
+ * BridgeMonitorModule: extracts the inline monitor block (anomaly, write gate, etc.)
+ *
+ * All 11 behavioral fixes from PRDs 033/040/041 remain intact inside these modules.
+ * The refactor is structural, not behavioral.
+ *
+ * PRD 042 Phase 1-3: Module Type Definitions + Factories
+ */
+import type { CognitiveModule, MonitoringSignal, ControlDirective, ProviderAdapter, WorkspaceManager, WorkspaceReadPort, WorkspaceWritePort, ToolProvider } from '@methodts/pacta';
+import type { StreamEvent } from './pool.js';
+import type { StreamChunkCallback } from './print-session.js';
+import type { CognitiveEventBusSink as CognitiveSink } from './cognitive-sink.js';
+export declare const READ_ONLY_ACTIONS: Set<string>;
+/** Control issued by BridgeMonitorModule, consumed by RA on the same cycle. */
+export interface BridgeMonitorControl extends ControlDirective {
+    forceReplan: boolean;
+    restricted: string[];
+    interventionMessage: string | null;
+    writeGateFired: boolean;
+    prevCycleAction: string | null;
+}
+/** Persistent state for one prompt's worth of ReasonerActor execution. */
+export interface BridgeReasonerActorState {
+    foldedCtx: string[];
+    promptSuccessfulReads: number;
+    promptSuccessfulWrites: number;
+    writeGateFired: boolean;
+}
+/** Monitoring signal emitted per cycle for the Monitor to read next cycle. */
+export interface BridgeReasonerActorMonitoring extends MonitoringSignal {
+    type: 'bridge-reasoner-actor';
+    prevConf: number;
+    prevAction: string | null;
+    consecutiveFailedParses: number;
+    wsUtilization: number;
+    promptInputTokens: number;
+    promptOutputTokens: number;
+    writeGateFired: boolean;
+    promptSuccessfulReads: number;
+    promptSuccessfulWrites: number;
+    cycleDone: boolean;
+    lastOutput: string;
+}
+/** Persistent monitor state across cycles within a single prompt. */
+export interface BridgeMonitorState {
+    readOnlyRun: number;
+    interventions: number;
+    accumulatedInputTokens: number;
+}
+/** Type alias for the BridgeReasonerActorModule. */
+export type BridgeReasonerActorModuleType = CognitiveModule<string, // input: the current prompt
+BridgeReasonerActorMonitoring, // output: same as monitoring for caller convenience
+BridgeReasonerActorState, BridgeReasonerActorMonitoring, BridgeMonitorControl>;
+/** Type alias for the BridgeMonitorModule. */
+export type BridgeMonitorModuleType = CognitiveModule<BridgeReasonerActorMonitoring | null, // input: last cycle's RA monitoring (null on first cycle)
+BridgeMonitorControl, // output: control directives for this cycle's RA
+BridgeMonitorState, MonitoringSignal, // monitor's own monitoring
+ControlDirective>;
+export interface ReasonerActorModuleConfig {
+    maxToolsPerCycle: number;
+    maxOutputTokens: number;
+    wsCapacity: number;
+    cycleNumber: number;
+    maxCycles: number;
+}
+export interface MonitorModuleConfig {
+    confThreshold: number;
+    stagThreshold: number;
+    intBudget: number;
+}
+/** Returns the default monitor control (no interventions). */
+export declare function defaultBridgeMonitorControl(): BridgeMonitorControl;
+/**
+ * Creates a BridgeReasonerActorModule that extracts the inner while-loop
+ * from cognitive-provider.ts into a CognitiveModule implementation.
+ *
+ * All 11 behavioral fixes remain inside:
+ * - Write-completion hint (salience 1.0 after successful Write)
+ * - Write gate counters (promptSuccessfulReads/Writes, writeGateFired)
+ * - Impasse detection (exact-match semantic key, within-step local)
+ * - Parse failure circuit-breaker (consecutiveFailedParses >= 3)
+ * - Content block handling (<content> tag for Write)
+ * - Truncation hint (Read result truncation message)
+ */
+export declare function createBridgeReasonerActorModule(adapter: ProviderAdapter, tools: ToolProvider, ws: WorkspaceManager, raWritePort: WorkspaceWritePort, raReadPort: WorkspaceReadPort, obsPort: WorkspaceWritePort, config: ReasonerActorModuleConfig, onEvent: (e: StreamEvent) => void, cognitiveSink?: CognitiveSink, onChunk?: StreamChunkCallback): BridgeReasonerActorModuleType;
+/**
+ * Creates a BridgeMonitorModule that extracts the inline monitor block
+ * from cognitive-provider.ts into a CognitiveModule implementation.
+ *
+ * Reads the previous cycle's RA monitoring signal and produces control
+ * directives for the current cycle's RA.
+ *
+ * Workspace writes use source: moduleId('monitor') (identity fix per PRD 042).
+ */
+export declare function createBridgeMonitorModule(ws: WorkspaceManager, monitorPort: WorkspaceWritePort, wsCapacity: number, config: MonitorModuleConfig, onEvent: (e: StreamEvent) => void, cognitiveSink?: CognitiveSink): BridgeMonitorModuleType;
+//# sourceMappingURL=cognitive-modules.d.ts.map

package/dist/sessions/cognitive-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-modules.d.ts","sourceRoot":"","sources":["../../src/sessions/cognitive-modules.ts"],"names":[],"mappings":"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"}