@griffin-app/griffin-executor 0.1.0

package/dist/events/adapters/kinesis.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AWS Kinesis event bus adapter.
+ *
+ * Publishes execution events to an AWS Kinesis stream.
+ * Supports batching, retries, and automatic partitioning by executionId.
+ *
+ * Features:
+ * - Automatic batching (max 500 records per PutRecords call)
+ * - Retry logic for failed records with exponential backoff
+ * - Partition key strategies for optimal shard distribution
+ * - EventType included in data for Lambda filtering
+ */
+import type { DurableEventBusAdapter } from "../emitter.js";
+import type { ExecutionEvent } from "../types.js";
+import { KinesisClient } from "@aws-sdk/client-kinesis";
+export interface KinesisAdapterOptions {
+    /**
+     * AWS Kinesis client instance.
+     * Should be pre-configured with region and credentials.
+     *
+     * Example:
+     *   import { KinesisClient } from "@aws-sdk/client-kinesis";
+     *   const client = new KinesisClient({ region: "us-east-1" });
+     */
+    client: KinesisClient;
+    /**
+     * Name of the Kinesis stream to publish to.
+     */
+    streamName: string;
+    /**
+     * Maximum number of retries for failed records.
+     * Default: 3
+     */
+    maxRetries?: number;
+    /**
+     * Milliseconds to wait between retries.
+     * Default: 1000
+     */
+    retryDelayMs?: number;
+    /**
+     * Partition key strategy.
+     * - "executionId": Use executionId as partition key (maintains ordering within execution)
+     * - "organizationId": Use organizationId as partition key (better shard distribution for multi-tenant)
+     * - "composite": Use "orgId:executionId" for balanced distribution with execution ordering
+     * Default: "executionId"
+     */
+    partitionKeyStrategy?: "executionId" | "organizationId" | "composite";
+}
+/**
+ * AWS Kinesis adapter for durable event publishing.
+ *
+ * Batches events and publishes them to a Kinesis stream.
+ * Implements retry logic for failed records and respects Kinesis batch limits.
+ */
+export declare class KinesisAdapter implements DurableEventBusAdapter {
+    private readonly client;
+    private readonly streamName;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly partitionKeyStrategy;
+    private static readonly KINESIS_MAX_BATCH;
+    constructor(options: KinesisAdapterOptions);
+    publish(events: ExecutionEvent[]): Promise<void>;
+    /**
+     * Publish a single batch with retry logic for failed records.
+     */
+    private publishBatchWithRetry;
+    /**
+     * Convert ExecutionEvent to Kinesis record format.
+     */
+    private eventToRecord;
+    /**
+     * Get partition key based on configured strategy.
+     */
+    private getPartitionKey;
+    /**
+     * Serialize event to JSON and encode as UTF-8 bytes.
+     * Events are structured to enable efficient Lambda filtering by including
+     * type as a top-level field in the JSON payload.
+     */
+    private serializeEvent;
+    /**
+     * Split array into chunks of specified size.
+     */
+    private chunkArray;
+    /**
+     * Sleep for specified milliseconds.
+     */
+    private sleep;
+}
+//# sourceMappingURL=kinesis.d.ts.map

package/dist/events/adapters/kinesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinesis.d.ts","sourceRoot":"","sources":["../../../src/events/adapters/kinesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAEL,aAAa,EAGd,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,aAAa,GAAG,gBAAgB,GAAG,WAAW,CAAC;CACvE;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGrB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;gBAEpC,OAAO,EAAE,qBAAqB;IAQpC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtD;;OAEG;YACW,qBAAqB;IAuDnC;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/events/adapters/kinesis.js

@@ -0,0 +1,136 @@
+/**
+ * AWS Kinesis event bus adapter.
+ *
+ * Publishes execution events to an AWS Kinesis stream.
+ * Supports batching, retries, and automatic partitioning by executionId.
+ *
+ * Features:
+ * - Automatic batching (max 500 records per PutRecords call)
+ * - Retry logic for failed records with exponential backoff
+ * - Partition key strategies for optimal shard distribution
+ * - EventType included in data for Lambda filtering
+ */
+import { PutRecordsCommand, } from "@aws-sdk/client-kinesis";
+/**
+ * AWS Kinesis adapter for durable event publishing.
+ *
+ * Batches events and publishes them to a Kinesis stream.
+ * Implements retry logic for failed records and respects Kinesis batch limits.
+ */
+export class KinesisAdapter {
+    client;
+    streamName;
+    maxRetries;
+    retryDelayMs;
+    partitionKeyStrategy;
+    static KINESIS_MAX_BATCH = 500;
+    constructor(options) {
+        this.client = options.client;
+        this.streamName = options.streamName;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.retryDelayMs = options.retryDelayMs ?? 1000;
+        this.partitionKeyStrategy = options.partitionKeyStrategy ?? "executionId";
+    }
+    async publish(events) {
+        if (events.length === 0) {
+            return;
+        }
+        // Convert events to Kinesis records
+        const records = events.map((event) => this.eventToRecord(event));
+        // Process in batches of 500 (Kinesis limit)
+        const batches = this.chunkArray(records, KinesisAdapter.KINESIS_MAX_BATCH);
+        for (const batch of batches) {
+            await this.publishBatchWithRetry(batch);
+        }
+    }
+    /**
+     * Publish a single batch with retry logic for failed records.
+     */
+    async publishBatchWithRetry(records, attempt = 0) {
+        try {
+            const command = new PutRecordsCommand({
+                StreamName: this.streamName,
+                Records: records,
+            });
+            const response = await this.client.send(command);
+            // Check for failed records
+            if (response.FailedRecordCount && response.FailedRecordCount > 0) {
+                const failedRecords = records.filter((_, idx) => {
+                    const result = response.Records?.[idx];
+                    return result?.ErrorCode !== undefined;
+                });
+                if (attempt < this.maxRetries) {
+                    // Exponential backoff
+                    const delay = this.retryDelayMs * Math.pow(2, attempt);
+                    console.warn(`Retrying ${failedRecords.length} failed records (attempt ${attempt + 1}/${this.maxRetries}) after ${delay}ms`);
+                    await this.sleep(delay);
+                    await this.publishBatchWithRetry(failedRecords, attempt + 1);
+                }
+                else {
+                    console.error(`Failed to publish ${failedRecords.length} records after ${this.maxRetries} attempts`);
+                    // Events are lost after max retries - caller should implement dead letter queue if needed
+                }
+            }
+        }
+        catch (error) {
+            if (attempt < this.maxRetries) {
+                const delay = this.retryDelayMs * Math.pow(2, attempt);
+                console.warn(`Kinesis publish error, retrying (attempt ${attempt + 1}/${this.maxRetries}) after ${delay}ms:`, error);
+                await this.sleep(delay);
+                await this.publishBatchWithRetry(records, attempt + 1);
+            }
+            else {
+                console.error(`Failed to publish batch after ${this.maxRetries} attempts:`, error);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Convert ExecutionEvent to Kinesis record format.
+     */
+    eventToRecord(event) {
+        return {
+            Data: this.serializeEvent(event),
+            PartitionKey: this.getPartitionKey(event),
+        };
+    }
+    /**
+     * Get partition key based on configured strategy.
+     */
+    getPartitionKey(event) {
+        switch (this.partitionKeyStrategy) {
+            case "executionId":
+                return event.execution_id;
+            case "organizationId":
+                return event.organization_id;
+            case "composite":
+                return `${event.organization_id}:${event.execution_id}`;
+        }
+    }
+    /**
+     * Serialize event to JSON and encode as UTF-8 bytes.
+     * Events are structured to enable efficient Lambda filtering by including
+     * type as a top-level field in the JSON payload.
+     */
+    serializeEvent(event) {
+        const json = JSON.stringify(event);
+        return new TextEncoder().encode(json);
+    }
+    /**
+     * Split array into chunks of specified size.
+     */
+    chunkArray(array, chunkSize) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += chunkSize) {
+            chunks.push(array.slice(i, i + chunkSize));
+        }
+        return chunks;
+    }
+    /**
+     * Sleep for specified milliseconds.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=kinesis.js.map

package/dist/events/adapters/kinesis.js.map

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

package/dist/events/adapters/kinesis.test.d.ts

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

package/dist/events/adapters/kinesis.test.d.ts.map

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

package/dist/events/adapters/kinesis.test.js

@@ -0,0 +1,249 @@
+import { describe, it, expect, vi } from "vitest";
+import { KinesisAdapter } from "./kinesis.js";
+describe("KinesisAdapter", () => {
+    const createMockEvent = (type, executionId, organizationId, seq) => ({
+        type,
+        event_id: `event-${seq}`,
+        seq,
+        timestamp: Date.now(),
+        monitor_id: "monitor-1",
+        execution_id: executionId,
+        organization_id: organizationId,
+        monitor_name: "Test Monitor",
+        monitor_version: "1.0.0",
+        node_count: 1,
+        edge_count: 1,
+    });
+    describe("publish", () => {
+        it("should publish events successfully", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [{ SequenceNumber: "seq-1", ShardId: "shard-1" }],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+            });
+            const events = [createMockEvent("MONITOR_START", "exec-1", "org-1", 0)];
+            await adapter.publish(events);
+            expect(mockSend).toHaveBeenCalledOnce();
+            const command = mockSend.mock.calls[0][0];
+            expect(command.input.StreamName).toBe("test-stream");
+            expect(command.input.Records).toHaveLength(1);
+        });
+        it("should handle empty event array", async () => {
+            const mockSend = vi.fn();
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+            });
+            await adapter.publish([]);
+            expect(mockSend).not.toHaveBeenCalled();
+        });
+        it("should batch events into chunks of 500", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+            });
+            // Create 1250 events (should result in 3 batches: 500, 500, 250)
+            const events = Array.from({ length: 1250 }, (_, i) => createMockEvent("MONITOR_START", "exec-1", "org-1", i));
+            await adapter.publish(events);
+            expect(mockSend).toHaveBeenCalledTimes(3);
+            expect(mockSend.mock.calls[0][0].input.Records).toHaveLength(500);
+            expect(mockSend.mock.calls[1][0].input.Records).toHaveLength(500);
+            expect(mockSend.mock.calls[2][0].input.Records).toHaveLength(250);
+        });
+    });
+    describe("partition key strategies", () => {
+        it("should use executionId as partition key by default", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+            });
+            const events = [
+                createMockEvent("MONITOR_START", "exec-123", "org-456", 0),
+            ];
+            await adapter.publish(events);
+            const records = mockSend.mock.calls[0][0].input.Records;
+            expect(records[0].PartitionKey).toBe("exec-123");
+        });
+        it("should use organizationId as partition key when configured", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                partitionKeyStrategy: "organizationId",
+            });
+            const events = [
+                createMockEvent("MONITOR_START", "exec-123", "org-456", 0),
+            ];
+            await adapter.publish(events);
+            const records = mockSend.mock.calls[0][0].input.Records;
+            expect(records[0].PartitionKey).toBe("org-456");
+        });
+        it("should use composite partition key when configured", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                partitionKeyStrategy: "composite",
+            });
+            const events = [
+                createMockEvent("MONITOR_START", "exec-123", "org-456", 0),
+            ];
+            await adapter.publish(events);
+            const records = mockSend.mock.calls[0][0].input.Records;
+            expect(records[0].PartitionKey).toBe("org-456:exec-123");
+        });
+    });
+    describe("retry logic", () => {
+        it("should retry failed records with exponential backoff", async () => {
+            let callCount = 0;
+            const mockSend = vi.fn().mockImplementation(() => {
+                callCount++;
+                if (callCount === 1) {
+                    // First call: one record fails
+                    return Promise.resolve({
+                        FailedRecordCount: 1,
+                        Records: [{ ErrorCode: "ProvisionedThroughputExceededException" }],
+                    });
+                }
+                // Second call: success
+                return Promise.resolve({
+                    FailedRecordCount: 0,
+                    Records: [{ SequenceNumber: "seq-1", ShardId: "shard-1" }],
+                });
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                maxRetries: 3,
+                retryDelayMs: 10, // Short delay for testing
+            });
+            const events = [createMockEvent("MONITOR_START", "exec-1", "org-1", 0)];
+            await adapter.publish(events);
+            expect(mockSend).toHaveBeenCalledTimes(2); // Initial + 1 retry
+        });
+        it("should stop retrying after max attempts", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 1,
+                Records: [{ ErrorCode: "ProvisionedThroughputExceededException" }],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                maxRetries: 2,
+                retryDelayMs: 10,
+            });
+            const events = [createMockEvent("MONITOR_START", "exec-1", "org-1", 0)];
+            // Should not throw, but log errors
+            await adapter.publish(events);
+            expect(mockSend).toHaveBeenCalledTimes(3); // Initial + 2 retries
+        });
+        it("should retry on client errors", async () => {
+            let callCount = 0;
+            const mockSend = vi.fn().mockImplementation(() => {
+                callCount++;
+                if (callCount === 1) {
+                    return Promise.reject(new Error("Network error"));
+                }
+                return Promise.resolve({
+                    FailedRecordCount: 0,
+                    Records: [{ SequenceNumber: "seq-1", ShardId: "shard-1" }],
+                });
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                maxRetries: 3,
+                retryDelayMs: 10,
+            });
+            const events = [createMockEvent("MONITOR_START", "exec-1", "org-1", 0)];
+            await adapter.publish(events);
+            expect(mockSend).toHaveBeenCalledTimes(2); // Initial + 1 retry
+        });
+        it("should throw after max retries on client errors", async () => {
+            const mockSend = vi.fn().mockRejectedValue(new Error("Network error"));
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+                maxRetries: 2,
+                retryDelayMs: 10,
+            });
+            const events = [createMockEvent("MONITOR_START", "exec-1", "org-1", 0)];
+            await expect(adapter.publish(events)).rejects.toThrow("Network error");
+            expect(mockSend).toHaveBeenCalledTimes(3); // Initial + 2 retries
+        });
+    });
+    describe("event serialization", () => {
+        it("should serialize events as JSON", async () => {
+            const mockSend = vi.fn().mockResolvedValue({
+                FailedRecordCount: 0,
+                Records: [],
+            });
+            const mockClient = {
+                send: mockSend,
+            };
+            const adapter = new KinesisAdapter({
+                client: mockClient,
+                streamName: "test-stream",
+            });
+            const event = createMockEvent("MONITOR_START", "exec-1", "org-1", 0);
+            await adapter.publish([event]);
+            const records = mockSend.mock.calls[0][0].input.Records;
+            const data = records[0].Data;
+            // Decode the Uint8Array back to JSON
+            const decoder = new TextDecoder();
+            const json = decoder.decode(data);
+            const parsed = JSON.parse(json);
+            expect(parsed.type).toBe("MONITOR_START");
+            expect(parsed.execution_id).toBe("exec-1");
+            expect(parsed.organization_id).toBe("org-1");
+        });
+    });
+});
+//# sourceMappingURL=kinesis.test.js.map

package/dist/events/adapters/kinesis.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinesis.test.js","sourceRoot":"","sources":["../../../src/events/adapters/kinesis.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAc,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,eAAe,GAAG,CACtB,IAA4B,EAC5B,WAAmB,EACnB,cAAsB,EACtB,GAAW,EACK,EAAE,CAClB,CAAC;QACC,IAAI;QACJ,QAAQ,EAAE,SAAS,GAAG,EAAE;QACxB,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,WAAW;QACzB,eAAe,EAAE,cAAc;QAC/B,YAAY,EAAE,cAAc;QAC5B,eAAe,EAAE,OAAO;QACxB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;KACd,CAAmB,CAAC;IAEvB,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;aAC3D,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAExE,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAE1B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,iEAAiE;YACjE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnD,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CACvD,CAAC;YAEF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,eAAe,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;aAC3D,CAAC;YAEF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,oBAAoB,EAAE,gBAAgB;aACvC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,eAAe,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;aAC3D,CAAC;YAEF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,oBAAoB,EAAE,WAAW;aAClC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,eAAe,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;aAC3D,CAAC;YAEF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC/C,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBACpB,+BAA+B;oBAC/B,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,iBAAiB,EAAE,CAAC;wBACpB,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,wCAAwC,EAAE,CAAC;qBACnE,CAAC,CAAC;gBACL,CAAC;gBACD,uBAAuB;gBACvB,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,iBAAiB,EAAE,CAAC;oBACpB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;iBAC3D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE,EAAE,0BAA0B;aAC7C,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAExE,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,wCAAwC,EAAE,CAAC;aACnE,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE;aACjB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAExE,mCAAmC;YACnC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC/C,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;gBACpD,CAAC;gBACD,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,iBAAiB,EAAE,CAAC;oBACpB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;iBAC3D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE;aACjB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAExE,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;YAEvE,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE;aACjB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAExE,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACvE,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACzC,iBAAiB,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,QAAQ;aACa,CAAC;YAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACrE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACxD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAE7B,qCAAqC;YACrC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/events/emitter.d.ts

@@ -0,0 +1,68 @@
+import type { ExecutionEvent } from "./types.js";
+/**
+ * Pluggable event emitter interface for execution observability.
+ *
+ * Implementations can be synchronous (local) or asynchronous (durable bus).
+ * The executor treats emission as best-effort and non-blocking.
+ */
+export interface ExecutionEventEmitter {
+    /**
+     * Emit a single event. May be synchronous or asynchronous depending on implementation.
+     * Errors during emission should not propagate to the executor.
+     */
+    emit(event: ExecutionEvent): void | Promise<void>;
+    /**
+     * Optional: flush any buffered events (for batching implementations).
+     * Called at the end of execution to ensure all events are delivered.
+     */
+    flush?(): Promise<void>;
+    /**
+     * Optional: cleanup resources (timers, connections, etc.).
+     */
+    destroy?(): void;
+}
+/**
+ * In-memory event emitter for local/development use.
+ * Events are delivered synchronously to all subscribers.
+ */
+export declare class LocalEventEmitter implements ExecutionEventEmitter {
+    private listeners;
+    /**
+     * Subscribe to all execution events.
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: (event: ExecutionEvent) => void): () => void;
+    emit(event: ExecutionEvent): void;
+}
+/**
+ * Adapter interface for durable event buses (SQS, Kafka, Redis Streams, etc.).
+ * Implementations provided by callers based on their infrastructure.
+ */
+export interface DurableEventBusAdapter {
+    /**
+     * Publish a batch of events to the durable bus.
+     * Should handle serialization, retries, and error handling internally.
+     */
+    publish(events: ExecutionEvent[]): Promise<void>;
+}
+/**
+ * Event emitter that batches events for efficient delivery to durable event buses.
+ * Flushes on interval and when batch size is reached.
+ */
+export declare class DurableEventEmitter implements ExecutionEventEmitter {
+    private adapter;
+    private options;
+    private buffer;
+    private flushInterval;
+    private isDestroyed;
+    constructor(adapter: DurableEventBusAdapter, options?: {
+        /** Number of events to batch before auto-flushing (default: 50) */
+        batchSize?: number;
+        /** Milliseconds between auto-flushes (default: 100) */
+        flushIntervalMs?: number;
+    });
+    emit(event: ExecutionEvent): void;
+    flush(): Promise<void>;
+    destroy(): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/events/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,OAAO,CAAC,SAAS,CAA8C;IAE/D;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAOhE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;CAUlC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,qBAAqB;IAM7D,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,WAAW,CAAS;gBAGlB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE;QACf,mEAAmE;QACnE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uDAAuD;QACvD,eAAe,CAAC,EAAE,MAAM,CAAC;KACrB;IAUR,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAgB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,OAAO,IAAI,IAAI;CAOhB"}

package/dist/events/emitter.js

@@ -0,0 +1,83 @@
+/**
+ * In-memory event emitter for local/development use.
+ * Events are delivered synchronously to all subscribers.
+ */
+export class LocalEventEmitter {
+    listeners = [];
+    /**
+     * Subscribe to all execution events.
+     * @returns Unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                // Don't let listener errors break execution
+                console.error("Error in event listener:", error);
+            }
+        }
+    }
+}
+/**
+ * Event emitter that batches events for efficient delivery to durable event buses.
+ * Flushes on interval and when batch size is reached.
+ */
+export class DurableEventEmitter {
+    adapter;
+    options;
+    buffer = [];
+    flushInterval = null;
+    isDestroyed = false;
+    constructor(adapter, options = {}) {
+        this.adapter = adapter;
+        this.options = options;
+        const intervalMs = options.flushIntervalMs ?? 100;
+        this.flushInterval = setInterval(() => {
+            this.flush().catch((error) => {
+                console.error("Error flushing events:", error);
+            });
+        }, intervalMs);
+    }
+    emit(event) {
+        if (this.isDestroyed) {
+            console.warn("Cannot emit event: emitter is destroyed");
+            return;
+        }
+        this.buffer.push(event);
+        // Auto-flush when batch size is reached
+        if (this.buffer.length >= (this.options.batchSize ?? 50)) {
+            this.flush().catch((error) => {
+                console.error("Error auto-flushing events:", error);
+            });
+        }
+    }
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const events = this.buffer;
+        this.buffer = [];
+        try {
+            await this.adapter.publish(events);
+        }
+        catch (error) {
+            console.error("Failed to publish events:", error);
+            // Events are lost on failure - caller adapter should implement retries if needed
+        }
+    }
+    destroy() {
+        this.isDestroyed = true;
+        if (this.flushInterval) {
+            clearInterval(this.flushInterval);
+            this.flushInterval = null;
+        }
+    }
+}
+//# sourceMappingURL=emitter.js.map