@agentick/gateway 0.0.1

package/dist/testing.js

@@ -0,0 +1,129 @@
+/**
+ * Gateway Testing Utilities
+ *
+ * Provides helpers for testing gateway interactions.
+ *
+ * @example
+ * ```typescript
+ * import { createTestGateway, createMockApp } from '@agentick/gateway/testing';
+ *
+ * test('gateway handles messages', async () => {
+ *   const mockApp = createMockApp({
+ *     response: 'Hello!',
+ *   });
+ *
+ *   const { gateway, client, cleanup } = await createTestGateway({
+ *     agents: { chat: mockApp },
+ *     defaultAgent: 'chat',
+ *   });
+ *
+ *   try {
+ *     const response = await client.send('main', 'Hi there');
+ *     expect(response.payload.messageId).toBeDefined();
+ *   } finally {
+ *     await cleanup();
+ *   }
+ * });
+ * ```
+ *
+ * @module @agentick/gateway/testing
+ */
+import WebSocket from "ws";
+import { createGateway } from "./gateway.js";
+// Re-export mock factories from core
+export { createMockApp, createMockSession, createMockExecutionHandle, createTestProcedure, } from "@agentick/core/testing";
+/**
+ * Create a test gateway with a connected client.
+ *
+ * Automatically handles port allocation, client connection, and cleanup.
+ */
+export async function createTestGateway(options) {
+    // Use random high port to avoid conflicts
+    const port = options.port ?? 19000 + Math.floor(Math.random() * 1000);
+    const host = "127.0.0.1";
+    const url = `ws://${host}:${port}`;
+    const gateway = createGateway({
+        ...options,
+        port,
+        host,
+    });
+    await gateway.start();
+    // Create and connect client
+    const ws = new WebSocket(url);
+    await new Promise((resolve, reject) => {
+        ws.on("open", () => resolve());
+        ws.on("error", reject);
+    });
+    // Authenticate
+    ws.send(JSON.stringify({ type: "connect", clientId: "test-client" }));
+    await new Promise((r) => setTimeout(r, 50));
+    let requestId = 0;
+    const pendingRequests = new Map();
+    ws.on("message", (data) => {
+        const msg = JSON.parse(data.toString());
+        if (msg.type === "res" && pendingRequests.has(msg.id)) {
+            const { resolve } = pendingRequests.get(msg.id);
+            pendingRequests.delete(msg.id);
+            resolve({ ok: msg.ok, payload: msg.payload, error: msg.error });
+        }
+    });
+    const client = {
+        ws,
+        async request(method, params = {}) {
+            const id = `req-${++requestId}`;
+            return new Promise((resolve, reject) => {
+                pendingRequests.set(id, { resolve, reject });
+                ws.send(JSON.stringify({ type: "req", id, method, params }));
+                // Timeout after 5s
+                setTimeout(() => {
+                    if (pendingRequests.has(id)) {
+                        pendingRequests.delete(id);
+                        reject(new Error(`Request ${method} timed out`));
+                    }
+                }, 5000);
+            });
+        },
+        async send(sessionId, message) {
+            return this.request("send", { sessionId, message });
+        },
+        async collectEvents(sessionId, timeout = 1000) {
+            const events = [];
+            const handler = (data) => {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === "event" && msg.sessionId === sessionId) {
+                    events.push({ type: msg.event, data: msg.data });
+                }
+            };
+            ws.on("message", handler);
+            await new Promise((r) => setTimeout(r, timeout));
+            ws.off("message", handler);
+            return events;
+        },
+        close() {
+            ws.close();
+        },
+    };
+    const cleanup = async () => {
+        client.close();
+        await gateway.stop();
+    };
+    return { gateway, client, url, port, cleanup };
+}
+// ============================================================================
+// Event Helpers
+// ============================================================================
+/**
+ * Wait for a specific gateway event.
+ */
+export function waitForGatewayEvent(gateway, event, timeout = 5000) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Timeout waiting for gateway event: ${event}`));
+        }, timeout);
+        gateway.on(event, (payload) => {
+            clearTimeout(timer);
+            resolve(payload);
+        });
+    });
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/transport-protocol.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Gateway Protocol Types
+ *
+ * Defines the WebSocket message protocol between clients and the gateway.
+ */
+export interface ConnectMessage {
+    type: "connect";
+    clientId: string;
+    token?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RequestMessage {
+    type: "req";
+    id: string;
+    method: GatewayMethod;
+    params: Record<string, unknown>;
+}
+export interface PingMessage {
+    type: "ping";
+    timestamp: number;
+}
+export type ClientMessage = ConnectMessage | RequestMessage | PingMessage;
+export interface ConnectedMessage {
+    type: "connected";
+    gatewayId: string;
+    apps: string[];
+    sessions: string[];
+}
+export interface ResponseMessage {
+    type: "res";
+    id: string;
+    ok: boolean;
+    payload?: unknown;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export interface EventMessage {
+    type: "event";
+    event: GatewayEventType;
+    sessionId: string;
+    data: unknown;
+}
+export interface PongMessage {
+    type: "pong";
+    timestamp: number;
+}
+export interface ErrorMessage {
+    type: "error";
+    code: string;
+    message: string;
+}
+export type GatewayMessage = ConnectedMessage | ResponseMessage | EventMessage | PongMessage | ErrorMessage;
+/**
+ * Built-in gateway methods with autocomplete support.
+ */
+export type BuiltInMethod = "send" | "abort" | "status" | "history" | "reset" | "close" | "apps" | "sessions" | "subscribe" | "unsubscribe";
+/**
+ * Gateway method - built-in methods or custom method strings.
+ * The (string & {}) allows any string while preserving autocomplete for built-in methods.
+ */
+export type GatewayMethod = BuiltInMethod | (string & {});
+export type GatewayEventType = "content_delta" | "content_block_start" | "content_block_end" | "tool_call_start" | "tool_call_delta" | "tool_result" | "message_start" | "message_end" | "error";
+export interface SendParams {
+    sessionId: string;
+    message: string;
+    attachments?: Array<{
+        type: "image" | "file";
+        data: string;
+        mimeType: string;
+        name?: string;
+    }>;
+}
+export interface AbortParams {
+    sessionId: string;
+}
+export interface StatusParams {
+    sessionId?: string;
+}
+export interface HistoryParams {
+    sessionId: string;
+    limit?: number;
+    before?: string;
+}
+export interface ResetParams {
+    sessionId: string;
+}
+export interface CloseParams {
+    sessionId: string;
+}
+export interface SubscribeParams {
+    sessionId: string;
+}
+export interface UnsubscribeParams {
+    sessionId: string;
+}
+export interface StatusPayload {
+    gateway: {
+        id: string;
+        uptime: number;
+        clients: number;
+        sessions: number;
+        apps: string[];
+    };
+    session?: {
+        id: string;
+        appId: string;
+        messageCount: number;
+        createdAt: string;
+        lastActivityAt: string;
+        isActive: boolean;
+    };
+}
+export interface HistoryPayload {
+    messages: Array<{
+        id: string;
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp: string;
+        toolCalls?: Array<{
+            name: string;
+            input: unknown;
+            output?: unknown;
+        }>;
+    }>;
+    hasMore: boolean;
+}
+export interface AppsPayload {
+    apps: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        isDefault: boolean;
+    }>;
+}
+export interface SessionsPayload {
+    sessions: Array<{
+        id: string;
+        appId: string;
+        createdAt: string;
+        lastActivityAt: string;
+        messageCount: number;
+    }>;
+}
+/**
+ * Session keys follow the format: [app:]name
+ *
+ * Examples:
+ * - "main" → default app, "main" session
+ * - "chat:main" → "chat" app, "main" session
+ * - "research:task-123" → "research" app, "task-123" session
+ * - "whatsapp:+1234567890" → WhatsApp channel session
+ */
+export interface SessionKey {
+    appId: string;
+    sessionName: string;
+}
+export declare function parseSessionKey(key: string, defaultApp: string): SessionKey;
+export declare function formatSessionKey(key: SessionKey): string;
+//# sourceMappingURL=transport-protocol.d.ts.map

package/dist/transport-protocol.d.ts.map

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

package/dist/transport-protocol.js

@@ -0,0 +1,16 @@
+/**
+ * Gateway Protocol Types
+ *
+ * Defines the WebSocket message protocol between clients and the gateway.
+ */
+export function parseSessionKey(key, defaultApp) {
+    const parts = key.split(":");
+    if (parts.length === 1) {
+        return { appId: defaultApp, sessionName: parts[0] };
+    }
+    return { appId: parts[0], sessionName: parts.slice(1).join(":") };
+}
+export function formatSessionKey(key) {
+    return `${key.appId}:${key.sessionName}`;
+}
+//# sourceMappingURL=transport-protocol.js.map

package/dist/transport-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-protocol.js","sourceRoot":"","sources":["../src/transport-protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0OH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,UAAkB;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,OAAO,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Gateway Transport Interface
+ *
+ * Abstracts the transport layer (WebSocket, HTTP/SSE) from gateway business logic.
+ * This allows the same GatewayCore to serve clients via different protocols.
+ */
+import type { Message } from "@agentick/shared";
+import { type AuthResult } from "@agentick/server";
+import type { GatewayMessage, ClientMessage } from "./transport-protocol.js";
+import type { AuthConfig, ClientState, UserContext } from "./types.js";
+/**
+ * A connected client from the transport's perspective.
+ */
+export interface TransportClient {
+    /** Unique client identifier */
+    readonly id: string;
+    /** Client state (auth, subscriptions, etc.) */
+    readonly state: ClientState;
+    /** Send a message to this client */
+    send(message: GatewayMessage): void;
+    /** Close the connection */
+    close(code?: number, reason?: string): void;
+    /** Check if connected */
+    readonly isConnected: boolean;
+}
+/**
+ * Events emitted by a transport.
+ */
+export interface TransportEvents {
+    /** Client connected (may not be authenticated yet) */
+    connection: (client: TransportClient) => void;
+    /** Client disconnected */
+    disconnect: (clientId: string, reason?: string) => void;
+    /** Message received from authenticated client */
+    message: (clientId: string, message: ClientMessage) => void;
+    /** Transport error */
+    error: (error: Error) => void;
+}
+/**
+ * Transport configuration.
+ */
+export interface TransportConfig {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to */
+    host: string;
+    /** Authentication configuration */
+    auth?: AuthConfig;
+    /**
+     * Direct send handler for HTTP transport.
+     * Called instead of routing through message handler when streaming response is needed.
+     * Accepts full Message object to support multimodal content (images, audio, video, docs).
+     */
+    onDirectSend?: (sessionId: string, message: Message) => AsyncIterable<{
+        type: string;
+        data?: unknown;
+    }>;
+    /**
+     * Method invocation handler for HTTP transport.
+     * Called to execute custom gateway methods.
+     * Returns the method result directly (no streaming).
+     */
+    onInvoke?: (method: string, params: Record<string, unknown>, user?: UserContext) => Promise<unknown>;
+}
+/** Transport type identifier */
+export type TransportType = "websocket" | "http" | "sse";
+/**
+ * Transport interface - abstracts WebSocket vs HTTP/SSE.
+ */
+export interface Transport {
+    /** Transport type identifier */
+    readonly type: TransportType;
+    /** Start the transport server */
+    start(): Promise<void>;
+    /** Stop the transport server */
+    stop(): Promise<void>;
+    /** Register event handlers */
+    on<K extends keyof TransportEvents>(event: K, handler: TransportEvents[K]): void;
+    /** Get a client by ID */
+    getClient(id: string): TransportClient | undefined;
+    /** Get all connected clients */
+    getClients(): TransportClient[];
+    /** Get authenticated clients */
+    getAuthenticatedClients(): TransportClient[];
+    /** Broadcast to all authenticated clients */
+    broadcast(message: GatewayMessage): void;
+    /** Send to clients subscribed to a session */
+    sendToSubscribers(sessionId: string, message: GatewayMessage): void;
+    /** Number of connected clients */
+    readonly clientCount: number;
+}
+/**
+ * Base class with shared transport functionality.
+ */
+export declare abstract class BaseTransport implements Transport {
+    /** Transport type - must be set by subclass */
+    abstract readonly type: TransportType;
+    protected clients: Map<string, TransportClient>;
+    protected handlers: Partial<TransportEvents>;
+    protected config: TransportConfig;
+    protected clientIdCounter: number;
+    constructor(config: TransportConfig);
+    abstract start(): Promise<void>;
+    abstract stop(): Promise<void>;
+    on<K extends keyof TransportEvents>(event: K, handler: TransportEvents[K]): void;
+    getClient(id: string): TransportClient | undefined;
+    getClients(): TransportClient[];
+    getAuthenticatedClients(): TransportClient[];
+    broadcast(message: GatewayMessage): void;
+    sendToSubscribers(sessionId: string, message: GatewayMessage): void;
+    get clientCount(): number;
+    protected generateClientId(): string;
+    protected validateAuth(token?: string): Promise<AuthResult>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

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

package/dist/transport.js

@@ -0,0 +1,56 @@
+/**
+ * Gateway Transport Interface
+ *
+ * Abstracts the transport layer (WebSocket, HTTP/SSE) from gateway business logic.
+ * This allows the same GatewayCore to serve clients via different protocols.
+ */
+import { validateAuth } from "@agentick/server";
+// ============================================================================
+// Base Transport Implementation (shared logic)
+// ============================================================================
+/**
+ * Base class with shared transport functionality.
+ */
+export class BaseTransport {
+    clients = new Map();
+    handlers = {};
+    config;
+    clientIdCounter = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    on(event, handler) {
+        this.handlers[event] = handler;
+    }
+    getClient(id) {
+        return this.clients.get(id);
+    }
+    getClients() {
+        return Array.from(this.clients.values());
+    }
+    getAuthenticatedClients() {
+        return this.getClients().filter((c) => c.state.authenticated);
+    }
+    broadcast(message) {
+        for (const client of this.getAuthenticatedClients()) {
+            client.send(message);
+        }
+    }
+    sendToSubscribers(sessionId, message) {
+        for (const client of this.getAuthenticatedClients()) {
+            if (client.state.subscriptions.has(sessionId)) {
+                client.send(message);
+            }
+        }
+    }
+    get clientCount() {
+        return this.clients.size;
+    }
+    generateClientId() {
+        return `client-${++this.clientIdCounter}`;
+    }
+    validateAuth(token) {
+        return validateAuth(token, this.config.auth);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AAsHjE,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAgB,aAAa;IAIvB,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,QAAQ,GAA6B,EAAE,CAAC;IACxC,MAAM,CAAkB;IACxB,eAAe,GAAG,CAAC,CAAC;IAE9B,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAKD,EAAE,CAAkC,KAAQ,EAAE,OAA2B;QACvE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,OAAuB;QAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,OAAuB;QAC1D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YACpD,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAES,gBAAgB;QACxB,OAAO,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IAC5C,CAAC;IAES,YAAY,CAAC,KAAc;QACnC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF"}