@agentick/server 0.0.1

package/dist/sse.js

@@ -0,0 +1,137 @@
+/**
+ * SSE (Server-Sent Events) utilities.
+ *
+ * Provides helpers for streaming events to clients via SSE.
+ * Works with any web framework that supports writable streams.
+ *
+ * @module @agentick/server/sse
+ */
+/**
+ * Create an SSE writer for a response stream.
+ *
+ * Works with any writable stream that has write() and end() methods
+ * (Node.js response, Express response, etc.).
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   const writer = createSSEWriter(res);
+ *
+ *   // Write events
+ *   writer.writeEvent({
+ *     channel: 'session:events',
+ *     type: 'content_delta',
+ *     payload: { delta: 'Hello' },
+ *   });
+ *
+ *   // Close when done
+ *   writer.close();
+ * });
+ * ```
+ */
+export function createSSEWriter(stream, options = {}) {
+    const keepaliveInterval = options.keepaliveInterval ?? 15000;
+    const eventName = options.eventName ?? "message";
+    let closed = false;
+    let keepaliveTimer;
+    // Start keepalive
+    if (keepaliveInterval > 0) {
+        keepaliveTimer = setInterval(() => {
+            if (!closed) {
+                stream.write(": keepalive\n\n");
+            }
+        }, keepaliveInterval);
+    }
+    return {
+        writeEvent(event) {
+            if (closed)
+                return;
+            let data;
+            try {
+                data = JSON.stringify(event);
+            }
+            catch (err) {
+                // JSON.stringify can throw on circular references, BigInt, etc.
+                // Fall back to a serializable error event
+                console.error("SSE: Failed to serialize event", err, event);
+                data = JSON.stringify({
+                    type: "error",
+                    code: "SERIALIZATION_ERROR",
+                    message: `Failed to serialize event: ${err.message}`,
+                });
+            }
+            stream.write(`event: ${eventName}\n`);
+            stream.write(`data: ${data}\n\n`);
+        },
+        writeComment(comment) {
+            if (closed)
+                return;
+            stream.write(`: ${comment}\n\n`);
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            if (keepaliveTimer) {
+                clearInterval(keepaliveTimer);
+            }
+            stream.end();
+        },
+        get closed() {
+            return closed;
+        },
+    };
+}
+/**
+ * Stream an async iterable to SSE.
+ *
+ * @example
+ * ```typescript
+ * app.get('/sessions/:id/stream', async (req, res) => {
+ *   setSSEHeaders(res);
+ *
+ *   const stream = sessionHandler.stream(req.params.id, {});
+ *   await streamToSSE(res, stream, 'session:events');
+ * });
+ * ```
+ */
+export async function streamToSSE(stream, events, channel, options = {}) {
+    const writer = createSSEWriter(stream, options);
+    try {
+        for await (const event of events) {
+            writer.writeEvent({
+                channel,
+                type: event.type ?? "event",
+                payload: event,
+            });
+        }
+    }
+    finally {
+        writer.close();
+    }
+}
+/**
+ * Set SSE headers on a response.
+ *
+ * @example
+ * ```typescript
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   // ... write events
+ * });
+ * ```
+ */
+export function setSSEHeaders(res) {
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.setHeader("X-Accel-Buffering", "no"); // Disable nginx buffering
+    // Flush headers immediately so EventSource 'open' event fires
+    // Without this, Node.js/Express may buffer and delay the response
+    if (res.flushHeaders) {
+        res.flushHeaders();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server Types for @agentick/server
+ *
+ * @module @agentick/server/types
+ */
+export type { ChannelEvent, ChannelEventMetadata, ConnectionMetadata, ProtocolError, SessionResultPayload, ToolConfirmationRequest, ToolConfirmationResponse, SessionState, CreateSessionResponse, } from "@agentick/shared";
+export { FrameworkChannels, ErrorCodes } from "@agentick/shared";
+/**
+ * SSE writer interface.
+ */
+export interface SSEWriter {
+    /** Write an SSE event payload */
+    writeEvent(event: unknown): void;
+    /** Write a comment (keepalive) */
+    writeComment(comment: string): void;
+    /** Close the stream */
+    close(): void;
+    /** Check if closed */
+    readonly closed: boolean;
+}
+/**
+ * SSE writer options.
+ */
+export interface SSEWriterOptions {
+    /** Keepalive interval in ms (default: 15000) */
+    keepaliveInterval?: number;
+    /** Event name for SSE (default: 'message') */
+    eventName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uBAAuB;IACvB,KAAK,IAAI,IAAI,CAAC;IACd,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Server Types for @agentick/server
+ *
+ * @module @agentick/server/types
+ */
+export { FrameworkChannels, ErrorCodes } from "@agentick/shared";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agentick/server",
+  "version": "0.0.1",
+  "description": "Server SDK for Agentick - channel routing, session handling, transport adapters",
+  "keywords": [
+    "agent",
+    "ai",
+    "channels",
+    "server",
+    "sse",
+    "websocket"
+  ],
+  "license": "ISC",
+  "author": "Ryan Lindgren",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentick/kernel": "0.0.1",
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "types": "./dist/index.d.ts"
+}