@agentick/server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agentick Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @agentick/server
+
+Server-side utilities for Agentick applications:
+
+- **SSE utilities** - Stream events to clients via Server-Sent Events
+- **Type re-exports** - Convenient imports from `@agentick/shared`
+
+## Installation
+
+```bash
+npm install @agentick/server @agentick/core @agentick/shared
+```
+
+## Quick Start
+
+For most use cases, use `@agentick/express` instead - it provides a complete handler:
+
+```typescript
+import { createApp } from "@agentick/core";
+import { createAgentickHandler } from "@agentick/express";
+
+const app = createApp(MyAgent, { model });
+expressApp.use("/api/agent", createAgentickHandler(app));
+```
+
+## Direct Usage
+
+If building a custom framework adapter:
+
+```typescript
+import { setSSEHeaders, createSSEWriter } from "@agentick/server";
+
+// SSE endpoint
+app.get("/events", (req, res) => {
+  setSSEHeaders(res);
+  const writer = createSSEWriter(res);
+
+  // Write events
+  writer.writeEvent({ type: "connected" });
+
+  // Keepalive
+  const keepalive = setInterval(() => {
+    writer.writeComment("keepalive");
+  }, 15000);
+
+  req.on("close", () => {
+    clearInterval(keepalive);
+    writer.close();
+  });
+});
+
+// Streaming response
+app.post("/send", async (req, res) => {
+  setSSEHeaders(res);
+  const writer = createSSEWriter(res);
+
+  const session = app.getOrCreateSession(req.body.sessionId);
+  const handle = session.send(req.body);
+
+  for await (const event of handle) {
+    writer.writeEvent(event);
+  }
+
+  writer.close();
+});
+```
+
+## API Reference
+
+### setSSEHeaders(res)
+
+Set SSE headers on a response object:
+
+```typescript
+setSSEHeaders(res);
+// Sets: Content-Type, Cache-Control, Connection, X-Accel-Buffering
+```
+
+### createSSEWriter(stream)
+
+Create an SSE writer for streaming events:
+
+```typescript
+const writer = createSSEWriter(res);
+
+writer.writeEvent({ type: "content_delta", delta: "Hello" });
+writer.writeComment("keepalive");
+writer.writeError({ code: "SESSION_NOT_FOUND", message: "Not found" });
+writer.close();
+```
+
+## Type Re-exports
+
+For convenience, this package re-exports common types from `@agentick/shared`:
+
+```typescript
+import type {
+  SessionResultPayload,
+  ToolConfirmationRequest,
+  ToolConfirmationResponse,
+  SessionState,
+  CreateSessionResponse,
+} from "@agentick/server";
+```
+
+## Philosophy
+
+This package follows the "primitives, not opinions" philosophy:
+
+- **Minimal** - Just SSE utilities and type re-exports
+- **Framework-agnostic** - Works with any HTTP framework
+- **Composable** - Use what you need
+
+For a complete server integration, use `@agentick/express`, `@agentick/nestjs`, or build your own using these utilities.

package/dist/auth.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Authentication utilities for @agentick/server
+ *
+ * Provides standalone auth functions that can be used by Gateway
+ * and framework adapters.
+ *
+ * @module @agentick/server/auth
+ */
+import type { UserContext } from "@agentick/kernel";
+/**
+ * Result returned by auth validation.
+ */
+export interface AuthResult {
+    valid: boolean;
+    /** User context from token - may be hydrated further */
+    user?: UserContext;
+    /** Auth metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Base auth options available on all auth types.
+ */
+interface AuthBaseOptions {
+    /**
+     * Hydrate user context after validation.
+     * Called with the auth result - fetch additional data from DB, etc.
+     * Return the complete UserContext that will be available in methods.
+     */
+    hydrateUser?: (authResult: AuthResult) => Promise<UserContext>;
+}
+/**
+ * Authentication configuration.
+ */
+export type AuthConfig = ({
+    type: "none";
+} & AuthBaseOptions) | ({
+    type: "token";
+    token: string;
+} & AuthBaseOptions) | ({
+    type: "jwt";
+    secret: string;
+    issuer?: string;
+} & AuthBaseOptions) | ({
+    type: "custom";
+    validate: (token: string) => Promise<AuthResult>;
+} & AuthBaseOptions);
+/**
+ * Extract auth token from a request.
+ * Looks for Bearer token in Authorization header.
+ */
+export declare function extractToken(req: {
+    headers?: {
+        authorization?: string;
+        [key: string]: string | string[] | undefined;
+    };
+}): string | undefined;
+/**
+ * Validate an auth token against the configured auth method.
+ */
+export declare function validateAuth(token: string | undefined, config: AuthConfig | undefined): Promise<AuthResult>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,UAAU,eAAe;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,GACpC,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,GACpD,CAAC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,GACpE,CAAC;IACC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAClD,GAAG,eAAe,CAAC,CAAC;AAEzB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;KAAE,CAAC;CACpF,GAAG,MAAM,GAAG,SAAS,CAMrB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/auth.js

@@ -0,0 +1,51 @@
+/**
+ * Authentication utilities for @agentick/server
+ *
+ * Provides standalone auth functions that can be used by Gateway
+ * and framework adapters.
+ *
+ * @module @agentick/server/auth
+ */
+/**
+ * Extract auth token from a request.
+ * Looks for Bearer token in Authorization header.
+ */
+export function extractToken(req) {
+    const auth = req.headers?.authorization;
+    if (typeof auth === "string" && auth.startsWith("Bearer ")) {
+        return auth.slice(7);
+    }
+    return undefined;
+}
+/**
+ * Validate an auth token against the configured auth method.
+ */
+export async function validateAuth(token, config) {
+    // No auth configured
+    if (!config || config.type === "none") {
+        return { valid: true };
+    }
+    // Token required but not provided
+    if (!token) {
+        return { valid: false };
+    }
+    let result;
+    if (config.type === "token") {
+        result = { valid: token === config.token };
+    }
+    else if (config.type === "custom") {
+        result = await config.validate(token);
+    }
+    else if (config.type === "jwt") {
+        result = { valid: false };
+    }
+    else {
+        result = { valid: false };
+    }
+    // Run hydrateUser hook if configured and auth succeeded
+    if (result.valid && config.hydrateUser) {
+        result.user = await config.hydrateUser(result);
+    }
+    return result;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuCH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAE5B;IACC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAyB,EACzB,MAA8B;IAE9B,qBAAqB;IACrB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,MAAkB,CAAC;IAEvB,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7C,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,wDAAwD;IACxD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/event-bridge.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Event Bridge - Routes events between transport and sessions.
+ *
+ * The bridge has two modes:
+ * 1. With transport adapter (e.g., Socket.IO): Delegates connection management to the adapter
+ * 2. Without transport adapter (HTTP/SSE): Manages connections internally
+ *
+ * @module @tentickle/server/event-bridge
+ */
+import type { EventBridge, EventBridgeConfig, ServerConnection } from "./types.js";
+/**
+ * Event Bridge implementation.
+ *
+ * @example With HTTP/SSE (manages connections internally)
+ * ```typescript
+ * const bridge = createEventBridge({ sessionHandler });
+ *
+ * // Register connections from SSE endpoint
+ * bridge.registerConnection(connection);
+ *
+ * // Handle events from POST endpoint
+ * await bridge.handleEvent(connectionId, event);
+ * ```
+ *
+ * @example With Socket.IO (delegates to adapter)
+ * ```typescript
+ * const adapter = createSocketIOAdapter({
+ *   io,
+ *   onEvent: (connection, event) => bridge.handleEvent(connection, event),
+ * });
+ *
+ * const bridge = createEventBridge({
+ *   sessionHandler,
+ *   transport: adapter,
+ * });
+ * // No need to call registerConnection - adapter handles it
+ * ```
+ */
+export declare class EventBridgeImpl implements EventBridge {
+    private readonly logger;
+    private readonly sessionHandler;
+    private readonly transport?;
+    private readonly validateEvent?;
+    private readonly connections;
+    private readonly sessionConnections;
+    private readonly activeStreams;
+    constructor(config: EventBridgeConfig);
+    /**
+     * Whether this bridge manages connections internally.
+     * False when a transport adapter handles connection management.
+     */
+    private get managesConnections();
+    /**
+     * Register a connection.
+     * Only needed when NOT using a transport adapter.
+     */
+    registerConnection(connection: ServerConnection): void;
+    /**
+     * Unregister a connection.
+     * Only needed when NOT using a transport adapter.
+     */
+    unregisterConnection(connectionId: string): void;
+    /**
+     * Handle an incoming event.
+     *
+     * Accepts either:
+     * - connectionId (string) - looks up connection internally (HTTP/SSE mode)
+     * - connection (ServerConnection) - uses directly (transport adapter mode)
+     */
+    handleEvent(connectionOrId: string | ServerConnection, event: {
+        channel: string;
+        type: string;
+        payload: unknown;
+        id?: string;
+    }): Promise<void>;
+    private handleMessage;
+    private handleControl;
+    private handleToolConfirmation;
+    private startStreaming;
+    /**
+     * Classify an error into a protocol error code.
+     */
+    private classifyError;
+    private sendToSession;
+    destroy(): void;
+}
+/**
+ * Create an event bridge.
+ */
+export declare function createEventBridge(config: EventBridgeConfig): EventBridge;
+//# sourceMappingURL=event-bridge.d.ts.map

package/dist/event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../src/event-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAEjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAqC;IAGpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IAGrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;gBAEnD,MAAM,EAAE,iBAAiB;IAMrC;;;OAGG;IACH,OAAO,KAAK,kBAAkB,GAE7B;IAED;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAgBtD;;;OAGG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAmBhD;;;;;;OAMG;IACG,WAAW,CACf,cAAc,EAAE,MAAM,GAAG,gBAAgB,EACzC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GACtE,OAAO,CAAC,IAAI,CAAC;YAwCF,aAAa;YAeb,aAAa;YA6Bb,sBAAsB;YAiBtB,cAAc;IA0D5B;;OAEG;IACH,OAAO,CAAC,aAAa;YAoBP,aAAa;IA2B3B,OAAO,IAAI,IAAI;CAiBhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE"}

package/dist/event-bridge.js

@@ -0,0 +1,301 @@
+/**
+ * Event Bridge - Routes events between transport and sessions.
+ *
+ * The bridge has two modes:
+ * 1. With transport adapter (e.g., Socket.IO): Delegates connection management to the adapter
+ * 2. Without transport adapter (HTTP/SSE): Manages connections internally
+ *
+ * @module @tentickle/server/event-bridge
+ */
+import { FrameworkChannels, ErrorCodes } from "@tentickle/shared";
+import { Logger } from "@tentickle/core/core";
+/**
+ * Event Bridge implementation.
+ *
+ * @example With HTTP/SSE (manages connections internally)
+ * ```typescript
+ * const bridge = createEventBridge({ sessionHandler });
+ *
+ * // Register connections from SSE endpoint
+ * bridge.registerConnection(connection);
+ *
+ * // Handle events from POST endpoint
+ * await bridge.handleEvent(connectionId, event);
+ * ```
+ *
+ * @example With Socket.IO (delegates to adapter)
+ * ```typescript
+ * const adapter = createSocketIOAdapter({
+ *   io,
+ *   onEvent: (connection, event) => bridge.handleEvent(connection, event),
+ * });
+ *
+ * const bridge = createEventBridge({
+ *   sessionHandler,
+ *   transport: adapter,
+ * });
+ * // No need to call registerConnection - adapter handles it
+ * ```
+ */
+export class EventBridgeImpl {
+    logger = Logger.for("EventBridge");
+    sessionHandler;
+    transport;
+    validateEvent;
+    // Internal connection tracking - only used when no transport adapter
+    connections = new Map();
+    sessionConnections = new Map();
+    // Active streams for abort handling
+    activeStreams = new Map();
+    constructor(config) {
+        this.sessionHandler = config.sessionHandler;
+        this.transport = config.transport;
+        this.validateEvent = config.validateEvent;
+    }
+    /**
+     * Whether this bridge manages connections internally.
+     * False when a transport adapter handles connection management.
+     */
+    get managesConnections() {
+        return !this.transport;
+    }
+    /**
+     * Register a connection.
+     * Only needed when NOT using a transport adapter.
+     */
+    registerConnection(connection) {
+        if (!this.managesConnections) {
+            // Transport adapter handles connection tracking
+            return;
+        }
+        this.connections.set(connection.id, connection);
+        let sessionConns = this.sessionConnections.get(connection.sessionId);
+        if (!sessionConns) {
+            sessionConns = new Set();
+            this.sessionConnections.set(connection.sessionId, sessionConns);
+        }
+        sessionConns.add(connection.id);
+    }
+    /**
+     * Unregister a connection.
+     * Only needed when NOT using a transport adapter.
+     */
+    unregisterConnection(connectionId) {
+        if (!this.managesConnections) {
+            return;
+        }
+        const connection = this.connections.get(connectionId);
+        if (!connection)
+            return;
+        const sessionConns = this.sessionConnections.get(connection.sessionId);
+        if (sessionConns) {
+            sessionConns.delete(connectionId);
+            if (sessionConns.size === 0) {
+                this.sessionConnections.delete(connection.sessionId);
+            }
+        }
+        this.connections.delete(connectionId);
+    }
+    /**
+     * Handle an incoming event.
+     *
+     * Accepts either:
+     * - connectionId (string) - looks up connection internally (HTTP/SSE mode)
+     * - connection (ServerConnection) - uses directly (transport adapter mode)
+     */
+    async handleEvent(connectionOrId, event) {
+        // Resolve connection
+        const connection = typeof connectionOrId === "string"
+            ? this.connections.get(connectionOrId)
+            : connectionOrId;
+        if (!connection) {
+            this.logger.warn({ connectionOrId }, "Event from unknown connection");
+            return;
+        }
+        if (this.validateEvent) {
+            try {
+                await this.validateEvent(connection, event);
+            }
+            catch (err) {
+                this.logger.warn({ err, connectionId: connection.id, channel: event.channel, type: event.type }, "Event validation failed");
+                return;
+            }
+        }
+        // Route by channel
+        switch (event.channel) {
+            case FrameworkChannels.MESSAGES:
+                await this.handleMessage(connection, event);
+                break;
+            case FrameworkChannels.CONTROL:
+                await this.handleControl(connection, event);
+                break;
+            case FrameworkChannels.TOOL_CONFIRMATION:
+                await this.handleToolConfirmation(connection, event);
+                break;
+            default:
+                this.logger.warn({ channel: event.channel }, "Unknown channel");
+        }
+    }
+    async handleMessage(connection, event) {
+        if (event.type !== "message")
+            return;
+        const message = event.payload;
+        const session = this.sessionHandler.getSession(connection.sessionId);
+        if (!session) {
+            this.logger.warn({ sessionId: connection.sessionId }, "Session not found");
+            return;
+        }
+        await session.queueMessage(message);
+    }
+    async handleControl(connection, event) {
+        const session = this.sessionHandler.getSession(connection.sessionId);
+        if (!session) {
+            this.logger.warn({ sessionId: connection.sessionId }, "Session not found");
+            return;
+        }
+        if (event.type === "tick") {
+            const props = event.payload?.props;
+            const inspection = session.inspect();
+            const hasQueuedMessages = inspection.queuedMessages.length > 0;
+            const hasProps = props != null &&
+                (typeof props !== "object" || Object.keys(props).length > 0);
+            if (!hasQueuedMessages && !hasProps) {
+                return;
+            }
+            await this.startStreaming(connection.sessionId, props);
+        }
+        else if (event.type === "abort") {
+            this.activeStreams.get(connection.sessionId)?.();
+            const reason = event.payload?.reason;
+            session.interrupt(undefined, reason);
+        }
+    }
+    async handleToolConfirmation(connection, event) {
+        if (event.type !== "response")
+            return;
+        const session = this.sessionHandler.getSession(connection.sessionId);
+        if (!session)
+            return;
+        session.channel("tool_confirmation").publish({
+            type: "response",
+            id: event.id,
+            channel: "tool_confirmation",
+            payload: event.payload,
+        });
+    }
+    async startStreaming(sessionId, props) {
+        // Abort existing stream
+        this.activeStreams.get(sessionId)?.();
+        let aborted = false;
+        this.activeStreams.set(sessionId, () => { aborted = true; });
+        const session = this.sessionHandler.getSession(sessionId);
+        if (!session) {
+            this.logger.warn({ sessionId }, "Session not found");
+            return;
+        }
+        const handle = session.tick(props);
+        try {
+            for await (const event of handle) {
+                if (aborted)
+                    break;
+                await this.sendToSession(sessionId, {
+                    channel: FrameworkChannels.EVENTS,
+                    type: event.type,
+                    payload: event,
+                });
+                if (event.type === "result") {
+                    await this.sendToSession(sessionId, {
+                        channel: FrameworkChannels.RESULT,
+                        type: "result",
+                        payload: event.result,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            if (!aborted) {
+                const err = error;
+                const errorPayload = {
+                    code: this.classifyError(err),
+                    message: err.message,
+                    details: err.cause ? { cause: String(err.cause) } : undefined,
+                };
+                await this.sendToSession(sessionId, {
+                    channel: FrameworkChannels.EVENTS,
+                    type: "error",
+                    payload: errorPayload,
+                });
+            }
+        }
+        finally {
+            void handle.result.catch((err) => {
+                this.logger.error({ err, sessionId }, "Session result failed");
+            });
+            this.activeStreams.delete(sessionId);
+        }
+    }
+    /**
+     * Classify an error into a protocol error code.
+     */
+    classifyError(error) {
+        const message = error.message.toLowerCase();
+        if (message.includes("session not found") || message.includes("sessionnotfound")) {
+            return ErrorCodes.SESSION_NOT_FOUND;
+        }
+        if (message.includes("session closed") || message.includes("sessionclosed")) {
+            return ErrorCodes.SESSION_CLOSED;
+        }
+        if (message.includes("timeout") || error.name === "TimeoutError") {
+            return ErrorCodes.TIMEOUT;
+        }
+        if (message.includes("invalid") || message.includes("validation")) {
+            return ErrorCodes.INVALID_MESSAGE;
+        }
+        // Default to a generic error - could add more codes as needed
+        return "EXECUTION_ERROR";
+    }
+    async sendToSession(sessionId, event) {
+        // Delegate to transport adapter if available
+        if (this.transport) {
+            await this.transport.sendToSession(sessionId, event);
+            return;
+        }
+        // Otherwise use internal tracking
+        const connectionIds = this.sessionConnections.get(sessionId);
+        if (!connectionIds)
+            return;
+        for (const id of connectionIds) {
+            const conn = this.connections.get(id);
+            if (!conn)
+                continue;
+            void conn.send(event).catch((err) => {
+                this.logger.warn({ connectionId: id, err }, "Connection send failed");
+                // Drop the connection; it can reconnect via a new SSE/WebSocket connection.
+                conn.close();
+                this.unregisterConnection(id);
+            });
+        }
+    }
+    destroy() {
+        // Abort all streams
+        for (const abort of this.activeStreams.values()) {
+            abort();
+        }
+        this.activeStreams.clear();
+        // Close internal connections
+        for (const conn of this.connections.values()) {
+            conn.close();
+        }
+        this.connections.clear();
+        this.sessionConnections.clear();
+        // Cleanup transport
+        this.transport?.destroy();
+    }
+}
+/**
+ * Create an event bridge.
+ */
+export function createEventBridge(config) {
+    return new EventBridgeImpl(config);
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/event-bridge.js.map

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