@agentick/gateway 0.0.1

package/dist/websocket-server.js.map

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

package/dist/ws-transport.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WebSocket Transport
+ *
+ * Implements the Transport interface using WebSocket connections.
+ */
+import { BaseTransport, type TransportConfig } from "./transport.js";
+export declare class WSTransport extends BaseTransport {
+    readonly type: "websocket";
+    private wss;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleConnection;
+    private handleMessage;
+    private handleConnect;
+}
+export declare function createWSTransport(config: TransportConfig): WSTransport;
+//# sourceMappingURL=ws-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../src/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,aAAa,EAAwB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAiD3F,qBAAa,WAAY,SAAQ,aAAa;IAC5C,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,OAAO,CAAC,GAAG,CAAgC;IAElC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,OAAO,CAAC,gBAAgB;YA+BV,aAAa;YA2Bb,aAAa;CA+B5B;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAEtE"}

package/dist/ws-transport.js

@@ -0,0 +1,174 @@
+/**
+ * WebSocket Transport
+ *
+ * Implements the Transport interface using WebSocket connections.
+ */
+import { WebSocketServer, WebSocket } from "ws";
+import { BaseTransport } from "./transport.js";
+// ============================================================================
+// WebSocket Client
+// ============================================================================
+class WSClientImpl {
+    id;
+    socket;
+    state;
+    transport;
+    constructor(id, socket, transport) {
+        this.id = id;
+        this.socket = socket;
+        this.transport = transport;
+        this.state = {
+            id,
+            connectedAt: new Date(),
+            authenticated: false,
+            subscriptions: new Set(),
+        };
+    }
+    send(message) {
+        if (this.socket.readyState === WebSocket.OPEN) {
+            this.socket.send(JSON.stringify(message));
+        }
+    }
+    close(code, reason) {
+        this.socket.close(code, reason);
+    }
+    get isConnected() {
+        return this.socket.readyState === WebSocket.OPEN;
+    }
+    /** @internal - Update client ID (for custom client IDs) */
+    _setId(newId) {
+        this.id = newId;
+        this.state.id = newId;
+    }
+}
+// ============================================================================
+// WebSocket Transport
+// ============================================================================
+export class WSTransport extends BaseTransport {
+    type = "websocket";
+    wss = null;
+    start() {
+        return new Promise((resolve, reject) => {
+            try {
+                this.wss = new WebSocketServer({
+                    port: this.config.port,
+                    host: this.config.host,
+                });
+                this.wss.on("connection", this.handleConnection.bind(this));
+                this.wss.on("error", (error) => {
+                    this.handlers.error?.(error);
+                    reject(error);
+                });
+                this.wss.on("listening", () => {
+                    resolve();
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (!this.wss) {
+                resolve();
+                return;
+            }
+            // Close all client connections
+            for (const client of this.clients.values()) {
+                client.close(1001, "Server shutting down");
+            }
+            this.clients.clear();
+            // Close the server
+            this.wss.close(() => {
+                this.wss = null;
+                resolve();
+            });
+        });
+    }
+    handleConnection(socket, _request) {
+        const clientId = this.generateClientId();
+        const client = new WSClientImpl(clientId, socket, this);
+        this.clients.set(clientId, client);
+        socket.on("message", (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleMessage(client, message);
+            }
+            catch (_error) {
+                client.send({
+                    type: "error",
+                    code: "INVALID_MESSAGE",
+                    message: "Failed to parse message",
+                });
+            }
+        });
+        socket.on("close", () => {
+            this.clients.delete(client.id);
+            this.handlers.disconnect?.(client.id);
+        });
+        socket.on("error", (error) => {
+            this.handlers.error?.(error);
+        });
+        // Notify handler of new connection (before auth)
+        this.handlers.connection?.(client);
+    }
+    async handleMessage(client, message) {
+        // Handle connect message (authentication)
+        if (message.type === "connect") {
+            await this.handleConnect(client, message);
+            return;
+        }
+        // Handle ping
+        if (message.type === "ping") {
+            client.send({ type: "pong", timestamp: message.timestamp });
+            return;
+        }
+        // All other messages require authentication
+        if (!client.state.authenticated) {
+            client.send({
+                type: "error",
+                code: "UNAUTHORIZED",
+                message: "Authentication required. Send connect message first.",
+            });
+            return;
+        }
+        // Forward to message handler
+        this.handlers.message?.(client.id, message);
+    }
+    async handleConnect(client, message) {
+        // Validate authentication
+        const authResult = await this.validateAuth(message.token);
+        if (!authResult.valid) {
+            client.send({
+                type: "error",
+                code: "AUTH_FAILED",
+                message: "Authentication failed",
+            });
+            client.close(4001, "Authentication failed");
+            return;
+        }
+        // Update client state
+        client.state.authenticated = true;
+        client.state.user = authResult.user;
+        client.state.metadata = {
+            ...client.state.metadata,
+            ...authResult.metadata,
+            ...message.metadata,
+        };
+        // Client ID from message takes precedence
+        if (message.clientId) {
+            // Update internal tracking if client provides their own ID
+            this.clients.delete(client.id);
+            client._setId(message.clientId);
+            this.clients.set(message.clientId, client);
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createWSTransport(config) {
+    return new WSTransport(config);
+}
+//# sourceMappingURL=ws-transport.js.map

package/dist/ws-transport.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agentick/gateway",
+  "version": "0.0.1",
+  "description": "Standalone daemon for multi-client, multi-agent access",
+  "bin": {
+    "agentick-gateway": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.16.0",
+    "@agentick/core": "0.0.1",
+    "@agentick/server": "0.0.1",
+    "@agentick/kernel": "0.0.1",
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/ws": "^8.5.10",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@agentick/core": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "tsx src/bin.ts"
+  }
+}

package/src/__tests__/custom-methods.spec.ts

@@ -0,0 +1,220 @@
+/**
+ * Custom Methods Tests
+ *
+ * Tests for Gateway custom method dispatch, guards, and schema validation.
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { z } from "zod";
+import { Context, type KernelContext, type UserContext } from "@agentick/kernel";
+import {
+  method,
+  isMethodDefinition,
+  METHOD_DEFINITION,
+  type MethodDefinition,
+  type AuthResult,
+} from "../types.js";
+
+// ============================================================================
+// method() factory tests
+// ============================================================================
+
+describe("method() factory", () => {
+  it("should create a method definition with symbol marker", () => {
+    const def = method({
+      handler: async () => ({ result: true }),
+    });
+
+    expect(def[METHOD_DEFINITION]).toBe(true);
+    expect(isMethodDefinition(def)).toBe(true);
+    expect(typeof def.handler).toBe("function");
+  });
+
+  it("should preserve schema in method definition", () => {
+    const schema = z.object({
+      title: z.string(),
+      priority: z.enum(["low", "medium", "high"]).optional(),
+    });
+
+    const def = method({
+      schema,
+      handler: async (params) => params,
+    });
+
+    expect(def.schema).toBe(schema);
+  });
+
+  it("should preserve roles in method definition", () => {
+    const def = method({
+      roles: ["admin", "moderator"],
+      handler: async () => ({}),
+    });
+
+    expect(def.roles).toEqual(["admin", "moderator"]);
+  });
+
+  it("should preserve guard function in method definition", () => {
+    const guard = (ctx: KernelContext) => ctx.user?.id === "admin";
+
+    const def = method({
+      guard,
+      handler: async () => ({}),
+    });
+
+    expect(def.guard).toBe(guard);
+  });
+
+  it("should preserve description in method definition", () => {
+    const def = method({
+      description: "List all tasks for the current user",
+      handler: async () => [],
+    });
+
+    expect(def.description).toBe("List all tasks for the current user");
+  });
+});
+
+// ============================================================================
+// isMethodDefinition() tests
+// ============================================================================
+
+describe("isMethodDefinition()", () => {
+  it("should return true for method definitions", () => {
+    const def = method({ handler: async () => ({}) });
+    expect(isMethodDefinition(def)).toBe(true);
+  });
+
+  it("should return false for plain functions", () => {
+    const fn = async () => ({});
+    expect(isMethodDefinition(fn)).toBe(false);
+  });
+
+  it("should return false for plain objects", () => {
+    const obj = { handler: async () => ({}) };
+    expect(isMethodDefinition(obj)).toBe(false);
+  });
+
+  it("should return false for null", () => {
+    expect(isMethodDefinition(null)).toBe(false);
+  });
+
+  it("should return false for undefined", () => {
+    expect(isMethodDefinition(undefined)).toBe(false);
+  });
+
+  it("should return false for primitives", () => {
+    expect(isMethodDefinition("string")).toBe(false);
+    expect(isMethodDefinition(123)).toBe(false);
+    expect(isMethodDefinition(true)).toBe(false);
+  });
+});
+
+// ============================================================================
+// Schema validation behavior
+// ============================================================================
+
+describe("method schema validation", () => {
+  it("should type-infer params from schema", () => {
+    const schema = z.object({
+      title: z.string(),
+      count: z.number(),
+    });
+
+    // This is a compile-time type check - if it compiles, the types work
+    const def = method({
+      schema,
+      handler: async (params) => {
+        // TypeScript should infer params.title as string and params.count as number
+        const result: { title: string; count: number } = {
+          title: params.title,
+          count: params.count,
+        };
+        return result;
+      },
+    });
+
+    expect(def.schema).toBe(schema);
+  });
+});
+
+// ============================================================================
+// Context integration (unit tests without full Gateway)
+// ============================================================================
+
+describe("Context integration", () => {
+  it("should allow Context.get() inside handlers", async () => {
+    const handler = async () => {
+      const ctx = Context.get();
+      return { userId: ctx.user?.id };
+    };
+
+    const user: UserContext = { id: "user-123", roles: ["user"] };
+    const ctx = Context.create({ user });
+
+    const result = await Context.run(ctx, handler);
+    expect(result).toEqual({ userId: "user-123" });
+  });
+
+  it("should make user roles available in context", async () => {
+    const handler = async () => {
+      const ctx = Context.get();
+      return { roles: ctx.user?.roles };
+    };
+
+    const user: UserContext = { id: "admin-1", roles: ["admin", "user"] };
+    const ctx = Context.create({ user });
+
+    const result = await Context.run(ctx, handler);
+    expect(result).toEqual({ roles: ["admin", "user"] });
+  });
+
+  it("should make metadata available in context", async () => {
+    const handler = async () => {
+      const ctx = Context.get();
+      return {
+        sessionId: ctx.metadata?.sessionId,
+        gatewayId: ctx.metadata?.gatewayId,
+      };
+    };
+
+    const ctx = Context.create({
+      metadata: { sessionId: "sess-1", gatewayId: "gw-1" },
+    });
+
+    const result = await Context.run(ctx, handler);
+    expect(result).toEqual({ sessionId: "sess-1", gatewayId: "gw-1" });
+  });
+});
+
+// ============================================================================
+// Streaming method behavior
+// ============================================================================
+
+describe("streaming methods", () => {
+  it("should support async generator handlers", async () => {
+    async function* streamingHandler() {
+      yield { chunk: 1 };
+      yield { chunk: 2 };
+      yield { chunk: 3 };
+    }
+
+    const chunks: unknown[] = [];
+    for await (const chunk of streamingHandler()) {
+      chunks.push(chunk);
+    }
+
+    expect(chunks).toEqual([{ chunk: 1 }, { chunk: 2 }, { chunk: 3 }]);
+  });
+
+  it("should allow method() with streaming handler", () => {
+    const def = method({
+      handler: async function* (params: { limit: number }) {
+        for (let i = 0; i < params.limit; i++) {
+          yield { index: i };
+        }
+      },
+    });
+
+    expect(isMethodDefinition(def)).toBe(true);
+  });
+});