pulseed 0.2.0 → 0.4.0

package/dist/runtime/executor/loop-supervisor.js

@@ -0,0 +1,388 @@
+import { writeFileSync, mkdirSync, renameSync, existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { GoalWorker } from './goal-worker.js';
+import { createEnvelope } from '../types/envelope.js';
+import { StateFenceError } from '../../base/utils/errors.js';
+const DEFAULT_CONFIG = {
+    concurrency: 4,
+    iterationsPerCycle: 5,
+    maxCrashCount: 3,
+    crashBackoffBaseMs: 1000,
+    stateFilePath: join(homedir(), '.pulseed', 'supervisor-state.json'),
+    pollIntervalMs: 100,
+    claimLeaseMs: 30_000,
+    leaseRenewIntervalMs: 10_000,
+};
+export class LoopSupervisor {
+    workers = [];
+    activeGoals = new Map();
+    crashCounts = new Map();
+    suspendedGoals = new Set();
+    running = false;
+    pollTimer = null;
+    config;
+    deps;
+    durableExecutionEnabled;
+    polling = false;
+    runningExecutions = [];
+    pendingTimers = new Set();
+    constructor(deps, config) {
+        this.deps = deps;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.durableExecutionEnabled = Boolean(this.deps.journalQueue && this.deps.goalLeaseManager);
+    }
+    async start(initialGoalIds) {
+        if (!this.deps.eventBus && !this.durableExecutionEnabled) {
+            throw new Error('LoopSupervisor requires eventBus or durable runtime queue dependencies');
+        }
+        const workerCfg = { iterationsPerCycle: this.config.iterationsPerCycle };
+        for (let i = 0; i < this.config.concurrency; i++) {
+            this.workers.push(new GoalWorker(this.deps.coreLoopFactory(), workerCfg));
+        }
+        this.running = true;
+        this.loadState();
+        for (const goalId of initialGoalIds) {
+            this.enqueueGoalActivation(goalId);
+        }
+        this.pollTimer = setInterval(() => {
+            void this.pollAndAssign();
+        }, this.config.pollIntervalMs);
+    }
+    async shutdown() {
+        this.running = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        for (const timer of this.pendingTimers)
+            clearTimeout(timer);
+        this.pendingTimers.clear();
+        await Promise.allSettled(this.runningExecutions);
+        this.persistState();
+    }
+    getState() {
+        return {
+            workers: this.workers.map(w => ({
+                workerId: w.id,
+                goalId: w.getCurrentGoalId(),
+                startedAt: w.getStartedAt(),
+                iterations: 0,
+            })),
+            crashCounts: Object.fromEntries(this.crashCounts),
+            suspendedGoals: [...this.suspendedGoals],
+            updatedAt: Date.now(),
+        };
+    }
+    enqueueGoalActivation(goalId) {
+        const envelope = createEnvelope({
+            type: 'event',
+            name: 'goal_activated',
+            source: 'supervisor',
+            goal_id: goalId,
+            payload: {},
+            priority: 'normal',
+            dedupe_key: `goal_activated:${goalId}`,
+        });
+        if (this.durableExecutionEnabled) {
+            const accepted = this.deps.journalQueue.accept(envelope);
+            if (!accepted.accepted && !accepted.duplicate) {
+                this.deps.logger?.warn('Failed to enqueue durable goal activation', {
+                    goalId,
+                    envelopeId: envelope.id,
+                });
+            }
+            return;
+        }
+        this.deps.eventBus.push(envelope);
+    }
+    async pollAndAssign() {
+        if (!this.running || this.polling)
+            return;
+        this.polling = true;
+        const idleWorkers = this.workers.filter(w => w.isIdle());
+        const requeue = [];
+        try {
+            for (const worker of idleWorkers) {
+                const dispatch = await this.claimNextDispatch(worker.id);
+                if (!dispatch)
+                    break;
+                if (dispatch.mode === 'legacy_non_goal') {
+                    requeue.push(dispatch.envelope);
+                    continue;
+                }
+                const goalId = dispatch.goalId;
+                if (this.activeGoals.has(goalId)) {
+                    this.activeGoals.get(goalId).requestExtend();
+                    await this.completeClaim(dispatch);
+                    continue;
+                }
+                if (this.suspendedGoals.has(goalId)) {
+                    await this.failClaim(dispatch, 'goal suspended', false);
+                    continue;
+                }
+                if (!(await this.acquireExecutionLease(worker, dispatch))) {
+                    await this.failClaim(dispatch, 'goal lease unavailable', true);
+                    continue;
+                }
+                this.activeGoals.set(goalId, worker);
+                const execution = this.executeWorker(worker, dispatch);
+                this.runningExecutions.push(execution);
+                execution.finally(() => {
+                    const idx = this.runningExecutions.indexOf(execution);
+                    if (idx !== -1)
+                        this.runningExecutions.splice(idx, 1);
+                });
+            }
+        }
+        finally {
+            for (const env of requeue) {
+                this.deps.eventBus?.push(env);
+            }
+            this.polling = false;
+        }
+    }
+    async claimNextDispatch(workerId) {
+        if (this.durableExecutionEnabled) {
+            const claim = this.deps.journalQueue.claim(workerId, this.config.claimLeaseMs, (envelope) => envelope.type === 'event' && envelope.name === 'goal_activated' && Boolean(envelope.goal_id));
+            if (!claim || !claim.envelope.goal_id) {
+                return null;
+            }
+            return {
+                mode: 'journal',
+                goalId: claim.envelope.goal_id,
+                claim,
+                ownerToken: claim.claimToken,
+                attemptId: claim.claimToken,
+            };
+        }
+        const envelope = this.deps.eventBus?.pull();
+        if (envelope === undefined) {
+            return null;
+        }
+        if (envelope.name !== 'goal_activated' || !envelope.goal_id) {
+            return { mode: 'legacy_non_goal', envelope };
+        }
+        return {
+            mode: 'eventBus',
+            goalId: envelope.goal_id,
+        };
+    }
+    async acquireExecutionLease(worker, activation) {
+        if (activation.mode !== 'journal') {
+            return true;
+        }
+        const lease = await this.deps.goalLeaseManager.acquire(activation.goalId, {
+            workerId: worker.id,
+            ownerToken: activation.ownerToken,
+            attemptId: activation.attemptId,
+            leaseMs: this.config.claimLeaseMs,
+        });
+        return lease !== null;
+    }
+    startLeaseRenewLoop(activation, onLeaseLost) {
+        if (activation.mode !== 'journal') {
+            return () => { };
+        }
+        let stopped = false;
+        let renewing = false;
+        const timer = setInterval(() => {
+            if (stopped || renewing)
+                return;
+            renewing = true;
+            void (async () => {
+                try {
+                    const renewedClaim = this.deps.journalQueue.renew(activation.claim.claimToken, this.config.claimLeaseMs);
+                    const renewedLease = await this.deps.goalLeaseManager.renew(activation.goalId, activation.ownerToken, { leaseMs: this.config.claimLeaseMs });
+                    if (!renewedClaim || !renewedLease) {
+                        stopped = true;
+                        clearInterval(timer);
+                        this.deps.logger?.warn('Lost durable execution ownership during renewal', {
+                            goalId: activation.goalId,
+                            claimToken: activation.claim.claimToken,
+                        });
+                        onLeaseLost();
+                    }
+                }
+                catch (err) {
+                    this.deps.logger?.warn('Failed to renew durable execution ownership', {
+                        goalId: activation.goalId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                finally {
+                    renewing = false;
+                }
+            })();
+        }, this.config.leaseRenewIntervalMs);
+        timer.unref?.();
+        return () => {
+            stopped = true;
+            clearInterval(timer);
+        };
+    }
+    async executeWorker(worker, activation) {
+        const { goalId } = activation;
+        let ownershipLost = false;
+        this.installWriteFence(activation);
+        const stopRenewal = this.startLeaseRenewLoop(activation, () => {
+            ownershipLost = true;
+        });
+        try {
+            const result = await worker.execute(goalId);
+            if (result.status === 'error') {
+                const count = (this.crashCounts.get(goalId) ?? 0) + 1;
+                this.crashCounts.set(goalId, count);
+                if (count >= this.config.maxCrashCount) {
+                    this.suspendedGoals.add(goalId);
+                    this.deps.logger?.warn('Goal suspended after max crashes', {
+                        goalId,
+                        crashCount: count,
+                    });
+                    this.deps.onEscalation?.(goalId, count, result.error ?? 'unknown error');
+                    await this.failClaim(activation, result.error ?? 'goal suspended after max crashes', false, ownershipLost);
+                }
+                else {
+                    const backoffMs = this.calculateCrashBackoff(count);
+                    if (activation.mode === 'journal') {
+                        await this.deferDurableRetry(activation, result.error ?? 'goal execution failed', backoffMs, ownershipLost);
+                    }
+                    else {
+                        const timer = setTimeout(() => {
+                            this.pendingTimers.delete(timer);
+                            if (!this.running)
+                                return;
+                            this.enqueueGoalActivation(goalId);
+                        }, backoffMs);
+                        this.pendingTimers.add(timer);
+                    }
+                }
+                return;
+            }
+            await this.completeClaim(activation, ownershipLost);
+        }
+        finally {
+            stopRenewal();
+            this.clearWriteFence(goalId);
+            await this.releaseExecutionLease(activation);
+            this.activeGoals.delete(goalId);
+            this.persistState();
+        }
+    }
+    async completeClaim(activation, ownershipLost = false) {
+        if (activation.mode !== 'journal' || ownershipLost) {
+            if (activation.mode === 'journal' && ownershipLost) {
+                this.deps.logger?.warn('Skipping ack because durable execution ownership was lost', {
+                    goalId: activation.goalId,
+                    claimToken: activation.claim.claimToken,
+                });
+            }
+            return;
+        }
+        const acked = this.deps.journalQueue.ack(activation.claim.claimToken);
+        if (!acked) {
+            this.deps.logger?.warn('Failed to ack durable goal activation claim', {
+                goalId: activation.goalId,
+                claimToken: activation.claim.claimToken,
+            });
+        }
+    }
+    async failClaim(activation, reason, requeue, ownershipLost = false) {
+        if (activation.mode !== 'journal' || ownershipLost) {
+            return;
+        }
+        const settled = this.deps.journalQueue.nack(activation.claim.claimToken, reason, requeue);
+        if (!settled) {
+            this.deps.logger?.warn('Failed to nack durable goal activation claim', {
+                goalId: activation.goalId,
+                claimToken: activation.claim.claimToken,
+                reason,
+                requeue,
+            });
+        }
+    }
+    async releaseExecutionLease(activation) {
+        if (activation.mode !== 'journal') {
+            return;
+        }
+        try {
+            await this.deps.goalLeaseManager.release(activation.goalId, activation.ownerToken);
+        }
+        catch (err) {
+            this.deps.logger?.warn('Failed to release goal execution lease', {
+                goalId: activation.goalId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    calculateCrashBackoff(crashCount) {
+        const jitter = Math.random() * 0.3;
+        return Math.min(this.config.crashBackoffBaseMs * Math.pow(2, crashCount - 1) * (1 + jitter), 30_000);
+    }
+    async deferDurableRetry(activation, reason, backoffMs, ownershipLost) {
+        if (ownershipLost) {
+            return;
+        }
+        const leaseMs = backoffMs + Math.max(this.config.pollIntervalMs, 100);
+        const renewedClaim = this.deps.journalQueue.renew(activation.claim.claimToken, leaseMs);
+        if (!renewedClaim) {
+            return;
+        }
+        const timer = setTimeout(() => {
+            this.pendingTimers.delete(timer);
+            if (!this.running)
+                return;
+            void this.failClaim(activation, reason, true, false);
+        }, backoffMs);
+        this.pendingTimers.add(timer);
+    }
+    installWriteFence(activation) {
+        if (activation.mode !== 'journal') {
+            return;
+        }
+        this.deps.stateManager.setWriteFence?.(activation.goalId, async () => {
+            const current = await this.deps.goalLeaseManager.read(activation.goalId);
+            if (!current ||
+                current.owner_token !== activation.ownerToken ||
+                current.attempt_id !== activation.attemptId ||
+                current.lease_until <= Date.now()) {
+                throw new StateFenceError(`Write fence rejected commit for goal "${activation.goalId}" because execution ownership is stale`);
+            }
+        });
+    }
+    clearWriteFence(goalId) {
+        this.deps.stateManager.clearWriteFence?.(goalId);
+    }
+    persistState() {
+        const state = this.getState();
+        const filePath = this.config.stateFilePath;
+        const tmpPath = filePath + '.tmp';
+        try {
+            mkdirSync(dirname(filePath), { recursive: true });
+            writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf8');
+            renameSync(tmpPath, filePath);
+        }
+        catch (err) {
+            this.deps.logger?.error('Failed to persist supervisor state', { err: String(err) });
+        }
+    }
+    loadState() {
+        const filePath = this.config.stateFilePath;
+        if (!existsSync(filePath))
+            return;
+        try {
+            const raw = readFileSync(filePath, 'utf8');
+            const state = JSON.parse(raw);
+            for (const [goalId, count] of Object.entries(state.crashCounts)) {
+                this.crashCounts.set(goalId, count);
+            }
+            for (const goalId of state.suspendedGoals) {
+                this.suspendedGoals.add(goalId);
+            }
+        }
+        catch {
+            // Corrupt or missing state — start fresh
+        }
+    }
+}
+//# sourceMappingURL=loop-supervisor.js.map

package/dist/runtime/executor/loop-supervisor.js.map

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

package/dist/runtime/gateway/channel-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Envelope } from "../types/envelope.js";
+export interface ReplyChannel {
+    send(data: unknown): void;
+    close(): void;
+}
+export type EnvelopeHandler = (envelope: Envelope, reply?: ReplyChannel) => void | Promise<void>;
+/**
+ * A ChannelAdapter receives protocol-specific input and emits Envelopes.
+ * Each adapter handles one external protocol (HTTP, WebSocket, CLI, MCP, Slack, etc.).
+ */
+export interface ChannelAdapter {
+    /** Unique adapter name (e.g., "http", "websocket", "cli", "slack") */
+    readonly name: string;
+    /** Start accepting input from this channel */
+    start(): Promise<void>;
+    /** Stop accepting input and clean up resources */
+    stop(): Promise<void>;
+    /** Register the handler that receives Envelopes from this adapter */
+    onEnvelope(handler: EnvelopeHandler): void;
+}
+//# sourceMappingURL=channel-adapter.d.ts.map

package/dist/runtime/gateway/channel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/channel-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjG;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,kDAAkD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,qEAAqE;IACrE,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;CAC5C"}

package/dist/runtime/gateway/channel-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel-adapter.js.map

package/dist/runtime/gateway/channel-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-adapter.js","sourceRoot":"","sources":["../../../src/runtime/gateway/channel-adapter.ts"],"names":[],"mappings":""}

package/dist/runtime/gateway/http-channel-adapter.d.ts

@@ -0,0 +1,23 @@
+import type { ChannelAdapter, EnvelopeHandler } from "./channel-adapter.js";
+import type { EventServer } from "../event-server.js";
+/**
+ * HttpChannelAdapter wraps the existing EventServer and converts
+ * incoming HTTP events into Envelopes for the Gateway.
+ *
+ * In Phase A, this is the only ChannelAdapter.
+ * The EventServer retains all its existing functionality (SSE, approval, goals API).
+ * The adapter intercepts POST /events to route through the Envelope path.
+ */
+export declare class HttpChannelAdapter implements ChannelAdapter {
+    readonly name = "http";
+    private handler;
+    private eventServer;
+    constructor(eventServer: EventServer);
+    onEnvelope(handler: EnvelopeHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Access the underlying EventServer for approval, broadcast, port, etc. */
+    getEventServer(): EventServer;
+    private emitEnvelope;
+}
+//# sourceMappingURL=http-channel-adapter.d.ts.map

package/dist/runtime/gateway/http-channel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-channel-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/http-channel-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,EAAE,WAAW;IAOpC,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,4EAA4E;IAC5E,cAAc,IAAI,WAAW;IAI7B,OAAO,CAAC,YAAY;CAerB"}

package/dist/runtime/gateway/http-channel-adapter.js

@@ -0,0 +1,51 @@
+import { createEnvelope } from "../types/envelope.js";
+/**
+ * HttpChannelAdapter wraps the existing EventServer and converts
+ * incoming HTTP events into Envelopes for the Gateway.
+ *
+ * In Phase A, this is the only ChannelAdapter.
+ * The EventServer retains all its existing functionality (SSE, approval, goals API).
+ * The adapter intercepts POST /events to route through the Envelope path.
+ */
+export class HttpChannelAdapter {
+    name = "http";
+    handler = null;
+    eventServer;
+    constructor(eventServer) {
+        this.eventServer = eventServer;
+        this.eventServer.setEnvelopeHook((eventData) => {
+            return this.emitEnvelope(eventData);
+        });
+    }
+    onEnvelope(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        await this.eventServer.start();
+        this.eventServer.startFileWatcher();
+    }
+    async stop() {
+        this.eventServer.stopFileWatcher();
+        await this.eventServer.stop();
+    }
+    /** Access the underlying EventServer for approval, broadcast, port, etc. */
+    getEventServer() {
+        return this.eventServer;
+    }
+    emitEnvelope(eventData) {
+        if (!this.handler) {
+            console.warn("HttpChannelAdapter: no handler registered, dropping event");
+            return;
+        }
+        const envelope = createEnvelope({
+            type: "event",
+            name: String(eventData["type"] ?? "external_event"),
+            source: "http",
+            goal_id: eventData["goal_id"],
+            priority: "normal",
+            payload: eventData,
+        });
+        return this.handler(envelope);
+    }
+}
+//# sourceMappingURL=http-channel-adapter.js.map

package/dist/runtime/gateway/http-channel-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-channel-adapter.js","sourceRoot":"","sources":["../../../src/runtime/gateway/http-channel-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,MAAM,CAAC;IACf,OAAO,GAA2B,IAAI,CAAC;IACvC,WAAW,CAAc;IAEjC,YAAY,WAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,SAAkC,EAAE,EAAE;YACtE,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,OAAwB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,4EAA4E;IAC5E,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,YAAY,CAAC,SAAkC;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAa,cAAc,CAAC;YACxC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,SAAS,CAAC,SAAS,CAAuB;YACnD,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/runtime/gateway/index.d.ts

@@ -0,0 +1,8 @@
+export { IngressGateway } from "./ingress-gateway.js";
+export { HttpChannelAdapter } from "./http-channel-adapter.js";
+export { SlackChannelAdapter } from "./slack-channel-adapter.js";
+export type { ChannelAdapter, EnvelopeHandler, ReplyChannel } from "./channel-adapter.js";
+export type { SlackChannelAdapterConfig, SlackResponse } from "./slack-channel-adapter.js";
+export { WsChannelAdapter } from "./ws-channel-adapter.js";
+export type { WsLike, WsSocketLike } from "./ws-channel-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/runtime/gateway/index.js

@@ -0,0 +1,5 @@
+export { IngressGateway } from "./ingress-gateway.js";
+export { HttpChannelAdapter } from "./http-channel-adapter.js";
+export { SlackChannelAdapter } from "./slack-channel-adapter.js";
+export { WsChannelAdapter } from "./ws-channel-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/runtime/gateway/ingress-gateway.d.ts

@@ -0,0 +1,27 @@
+import type { ChannelAdapter, EnvelopeHandler } from "./channel-adapter.js";
+import type { Logger } from "../logger.js";
+/**
+ * IngressGateway collects Envelopes from all registered ChannelAdapters
+ * and forwards them to a single handler (the Queue in Phase B, or direct
+ * processing in Phase A).
+ */
+export declare class IngressGateway {
+    private adapters;
+    private handler;
+    private logger?;
+    constructor(logger?: Logger);
+    /** Register an adapter. Throws if name is already registered. */
+    registerAdapter(adapter: ChannelAdapter): void;
+    /** Set the handler that receives all Envelopes from all adapters. */
+    onEnvelope(handler: EnvelopeHandler): void;
+    /** Start all registered adapters. */
+    start(): Promise<void>;
+    /** Stop all registered adapters. */
+    stop(): Promise<void>;
+    /** Get a registered adapter by name. */
+    getAdapter(name: string): ChannelAdapter | undefined;
+    /** List all registered adapter names. */
+    get adapterNames(): string[];
+    private routeEnvelope;
+}
+//# sourceMappingURL=ingress-gateway.d.ts.map

package/dist/runtime/gateway/ingress-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress-gateway.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/ingress-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAI3B,iEAAiE;IACjE,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAS9C,qEAAqE;IACrE,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,oCAAoC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,wCAAwC;IACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD,yCAAyC;IACzC,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED,OAAO,CAAC,aAAa;CAyBtB"}

package/dist/runtime/gateway/ingress-gateway.js

@@ -0,0 +1,75 @@
+/**
+ * IngressGateway collects Envelopes from all registered ChannelAdapters
+ * and forwards them to a single handler (the Queue in Phase B, or direct
+ * processing in Phase A).
+ */
+export class IngressGateway {
+    adapters = new Map();
+    handler = null;
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /** Register an adapter. Throws if name is already registered. */
+    registerAdapter(adapter) {
+        if (this.adapters.has(adapter.name)) {
+            throw new Error(`ChannelAdapter "${adapter.name}" already registered`);
+        }
+        this.adapters.set(adapter.name, adapter);
+        adapter.onEnvelope((envelope, reply) => this.routeEnvelope(envelope, reply));
+        this.logger?.info(`Gateway: registered adapter "${adapter.name}"`);
+    }
+    /** Set the handler that receives all Envelopes from all adapters. */
+    onEnvelope(handler) {
+        this.handler = handler;
+    }
+    /** Start all registered adapters. */
+    async start() {
+        for (const [name, adapter] of this.adapters) {
+            await adapter.start();
+            this.logger?.info(`Gateway: started adapter "${name}"`);
+        }
+    }
+    /** Stop all registered adapters. */
+    async stop() {
+        for (const [name, adapter] of this.adapters) {
+            await adapter.stop();
+            this.logger?.info(`Gateway: stopped adapter "${name}"`);
+        }
+    }
+    /** Get a registered adapter by name. */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /** List all registered adapter names. */
+    get adapterNames() {
+        return Array.from(this.adapters.keys());
+    }
+    routeEnvelope(envelope, reply) {
+        if (!this.handler) {
+            this.logger?.warn("Gateway: no handler registered, dropping envelope", {
+                id: envelope.id,
+                name: envelope.name,
+            });
+            return;
+        }
+        try {
+            const result = this.handler(envelope, reply);
+            if (result instanceof Promise) {
+                return result.catch((err) => {
+                    this.logger?.error("Gateway: handler error", {
+                        id: envelope.id,
+                        error: String(err),
+                    });
+                });
+            }
+        }
+        catch (err) {
+            this.logger?.error("Gateway: handler error", {
+                id: envelope.id,
+                error: String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=ingress-gateway.js.map