@agentick/gateway 0.0.1

package/dist/app-registry.js

@@ -0,0 +1,78 @@
+/**
+ * App Registry
+ *
+ * Manages available apps and their configurations.
+ */
+export class AppRegistry {
+    apps = new Map();
+    defaultAppId;
+    constructor(apps, defaultApp) {
+        if (!apps[defaultApp]) {
+            throw new Error(`Default app "${defaultApp}" not found in apps: ${Object.keys(apps).join(", ")}`);
+        }
+        this.defaultAppId = defaultApp;
+        for (const [id, app] of Object.entries(apps)) {
+            this.apps.set(id, {
+                id,
+                app,
+                isDefault: id === defaultApp,
+            });
+        }
+    }
+    /**
+     * Get an app by ID
+     */
+    get(id) {
+        return this.apps.get(id);
+    }
+    /**
+     * Get the default app
+     */
+    getDefault() {
+        return this.apps.get(this.defaultAppId);
+    }
+    /**
+     * Get the default app ID
+     */
+    get defaultId() {
+        return this.defaultAppId;
+    }
+    /**
+     * Check if an app exists
+     */
+    has(id) {
+        return this.apps.has(id);
+    }
+    /**
+     * Get all app IDs
+     */
+    ids() {
+        return Array.from(this.apps.keys());
+    }
+    /**
+     * Get all apps
+     */
+    all() {
+        return Array.from(this.apps.values());
+    }
+    /**
+     * Get app count
+     */
+    get size() {
+        return this.apps.size;
+    }
+    /**
+     * Resolve an app ID, falling back to default
+     */
+    resolve(id) {
+        if (!id) {
+            return this.getDefault();
+        }
+        const app = this.apps.get(id);
+        if (!app) {
+            throw new Error(`Unknown app "${id}". Available: ${this.ids().join(", ")}`);
+        }
+        return app;
+    }
+}
+//# sourceMappingURL=app-registry.js.map

package/dist/app-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-registry.js","sourceRoot":"","sources":["../src/app-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IAClC,YAAY,CAAS;IAE7B,YAAY,IAAyB,EAAE,UAAkB;QACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,gBAAgB,UAAU,wBAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QAE/B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChB,EAAE;gBACF,GAAG;gBACH,SAAS,EAAE,EAAE,KAAK,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAW;QACjB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Gateway CLI
+ *
+ * Run the gateway daemon from the command line.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/bin.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * Gateway CLI
+ *
+ * Run the gateway daemon from the command line.
+ */
+import { createGateway } from "./gateway.js";
+// For now, just a placeholder that shows usage
+console.log("@agentick/gateway");
+console.log("");
+console.log("Usage:");
+console.log("  The gateway is typically started programmatically:");
+console.log("");
+console.log("  ```typescript");
+console.log("  import { createGateway } from '@agentick/gateway';");
+console.log("  import { createApp } from '@agentick/core';");
+console.log("");
+console.log("  const Agent = () => (");
+console.log("    <>");
+console.log("      <Model model={gpt4} />");
+console.log("      <System>You are a helpful assistant.</System>");
+console.log("      <Timeline />");
+console.log("    </>");
+console.log("  );");
+console.log("");
+console.log("  const gateway = createGateway({");
+console.log("    agents: { chat: createApp(Agent) },");
+console.log("    defaultAgent: 'chat',");
+console.log("    port: 18789,");
+console.log("  });");
+console.log("");
+console.log("  await gateway.start();");
+console.log("  ```");
+console.log("");
+console.log("Future versions will support a config file:");
+console.log("  agentick-gateway --config ./gateway.config.ts");
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,+CAA+C;AAC/C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACtB,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;AACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;AACpE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;AAC7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACtB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAC5C,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;AACnE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAClC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AACjD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACvD,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAChC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACrB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACrB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;AAC3D,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC"}

package/dist/gateway.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Gateway
+ *
+ * Standalone daemon for multi-client, multi-app access.
+ * Transport-agnostic: supports both WebSocket and HTTP/SSE.
+ *
+ * Can run standalone or embedded in an external framework.
+ */
+import { EventEmitter } from "events";
+import type { IncomingMessage as NodeRequest, ServerResponse as NodeResponse } from "http";
+import type { GatewayConfig, GatewayEvents } from "./types.js";
+import type { StatusPayload } from "./transport-protocol.js";
+export declare class Gateway extends EventEmitter {
+    private config;
+    private registry;
+    private sessions;
+    private transports;
+    private startTime;
+    private isRunning;
+    private embedded;
+    /** Pre-compiled map of method paths to procedures */
+    private methodProcedures;
+    /** Track open SSE connections for embedded mode */
+    private sseClients;
+    /** Track channel subscriptions: "sessionId:channelName" -> Set of clientIds */
+    private channelSubscriptions;
+    /** Track unsubscribe functions for core session channels */
+    private coreChannelUnsubscribes;
+    /** Track client connection times for duration calculation */
+    private clientConnectedAt;
+    /** Sequence counter for DevTools events */
+    private devToolsSequence;
+    constructor(config: GatewayConfig);
+    /**
+     * Walk the methods tree and wrap all handlers as procedures.
+     * Infers full path name (e.g., "tasks:admin:archive") automatically.
+     */
+    private initializeMethods;
+    /**
+     * Get a method's procedure by path (supports both ":" and "." separators)
+     */
+    private getMethodProcedure;
+    private initializeTransports;
+    private setupTransportHandlers;
+    /**
+     * Start the gateway (standalone mode only)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the gateway
+     */
+    stop(): Promise<void>;
+    /**
+     * Alias for stop() - useful for embedded mode cleanup
+     */
+    close(): Promise<void>;
+    /**
+     * Get gateway status
+     */
+    get status(): StatusPayload["gateway"];
+    /**
+     * Check if running
+     */
+    get running(): boolean;
+    /**
+     * Get the gateway ID
+     */
+    get id(): string;
+    /**
+     * Handle an HTTP request (embedded mode).
+     * This is the main entry point when Gateway is embedded in an external framework.
+     *
+     * @param req - Node.js IncomingMessage (or Express/Koa/etc request)
+     * @param res - Node.js ServerResponse (or Express/Koa/etc response)
+     * @returns Promise that resolves when request is handled (may reject on error)
+     *
+     * @example
+     * ```typescript
+     * // Express middleware
+     * app.use("/api", (req, res, next) => {
+     *   gateway.handleRequest(req, res).catch(next);
+     * });
+     * ```
+     */
+    handleRequest(req: NodeRequest, res: NodeResponse): Promise<void>;
+    private handleSSE;
+    /**
+     * Clean up channel subscriptions for a disconnected client.
+     */
+    private cleanupClientChannelSubscriptions;
+    private handleSend;
+    private handleInvoke;
+    private handleSubscribe;
+    private handleAbort;
+    private handleCloseEndpoint;
+    /**
+     * Channel endpoint - handles channel pub/sub operations.
+     */
+    private handleChannel;
+    /**
+     * Subscribe a client to a session's channel.
+     * Sets up forwarding from core session channel to SSE clients.
+     */
+    private subscribeToChannel;
+    /**
+     * Forward a channel event to all subscribed SSE clients.
+     */
+    private forwardChannelEvent;
+    /**
+     * Publish an event to a session's channel.
+     */
+    private publishToChannel;
+    private parseBody;
+    private handleTransportRequest;
+    private executeMethod;
+    /**
+     * Execute a custom method within Agentick ALS context.
+     */
+    private executeCustomMethod;
+    private handleSendMethod;
+    /**
+     * Execute a message and stream events to subscribers.
+     *
+     * @param sessionId - The session key as provided by client (may be unnormalized)
+     * @param coreSession - The core session instance
+     * @param messageText - The message text to send
+     *
+     * IMPORTANT: Uses the original sessionId for events to ensure client matching.
+     */
+    private executeAndStream;
+    private sendEventToSubscribers;
+    /**
+     * Direct send handler for HTTP transport.
+     * Returns an async generator that yields events for streaming.
+     * Accepts full Message object to support multimodal content (images, audio, video, docs).
+     *
+     * IMPORTANT: Uses the original sessionId (as provided by client) for events,
+     * not the normalized internal ID. This ensures clients can match events to their sessions.
+     */
+    private directSend;
+    /**
+     * Invoke a custom method directly (for HTTP transport).
+     * Called with pre-authenticated user context.
+     */
+    private invokeMethod;
+    private handleAbortMethod;
+    private handleStatusMethod;
+    private handleHistoryMethod;
+    private handleResetMethod;
+    private handleCloseMethod;
+    private handleAppsMethod;
+    private handleSessionsMethod;
+    private handleSubscribeMethod;
+    private handleUnsubscribeMethod;
+    private createGatewayContext;
+}
+export interface Gateway {
+    on<K extends keyof GatewayEvents>(event: K, listener: (payload: GatewayEvents[K]) => void): this;
+    emit<K extends keyof GatewayEvents>(event: K, payload: GatewayEvents[K]): boolean;
+}
+/**
+ * Create a gateway instance
+ */
+export declare function createGateway(config: GatewayConfig): Gateway;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

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