@agentick/express 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,329 @@
+# @agentick/express
+
+Express middleware for Agentick Gateway.
+
+This is a **thin adapter** (~50 lines) that delegates all business logic to `@agentick/gateway`. Use this when you want to integrate Agentick into an existing Express application.
+
+## Installation
+
+```bash
+npm install @agentick/express
+# or
+pnpm add @agentick/express
+```
+
+## Quick Start
+
+```typescript
+import express from "express";
+import { createAgentickMiddleware } from "@agentick/express";
+import { createApp, Model, System, Timeline } from "@agentick/core";
+
+const app = express();
+app.use(express.json());
+
+// Define your agent
+const AssistantAgent = () => (
+  <>
+    <Model model={gpt4} />
+    <System>You are a helpful assistant.</System>
+    <Timeline />
+  </>
+);
+
+const agentickApp = createApp(<AssistantAgent />);
+
+// Create middleware
+const agentick = createAgentickMiddleware({
+  apps: { assistant: agentickApp },
+  defaultApp: "assistant",
+});
+
+// Mount at /api
+app.use("/api", agentick);
+
+// Start server
+const server = app.listen(3000);
+
+// Graceful shutdown - access gateway via .gateway property
+process.on("SIGTERM", async () => {
+  await agentick.gateway.close();
+  server.close();
+});
+```
+
+## API
+
+### createAgentickMiddleware(config, options?)
+
+Creates an Express Router that delegates to an embedded Gateway.
+
+Returns a `AgentickRouter` - an Express Router with an attached `.gateway` property for lifecycle management.
+
+```typescript
+import { createAgentickMiddleware, method } from "@agentick/express";
+import { z } from "zod";
+
+const middleware = createAgentickMiddleware({
+  // Required: Register your apps
+  apps: {
+    assistant: agentickApp,
+    researcher: researchApp,
+  },
+  defaultApp: "assistant",
+
+  // Optional: Authentication
+  auth: {
+    type: "custom",
+    validate: async (token) => {
+      const user = await verifyToken(token);
+      return user ? { valid: true, user } : { valid: false };
+    },
+  },
+
+  // Optional: Custom methods
+  methods: {
+    tasks: {
+      list: method({
+        schema: z.object({ sessionId: z.string() }),
+        handler: async (params) => todoService.list(params.sessionId),
+      }),
+      create: method({
+        schema: z.object({
+          sessionId: z.string(),
+          title: z.string().min(1),
+        }),
+        handler: async (params) => todoService.create(params),
+      }),
+    },
+    health: async () => ({
+      status: "ok",
+      timestamp: new Date().toISOString(),
+    }),
+  },
+});
+```
+
+### AgentickRouter
+
+The middleware returns a `AgentickRouter` which extends Express Router with:
+
+```typescript
+interface AgentickRouter extends Router {
+  /** The underlying Gateway instance for lifecycle management */
+  gateway: Gateway;
+}
+```
+
+Use `.gateway` for:
+
+- Graceful shutdown: `await middleware.gateway.close()`
+- Event subscriptions: `middleware.gateway.on('session:created', ...)`
+- Direct method invocation (advanced)
+
+### Options
+
+```typescript
+interface AgentickMiddlewareOptions {
+  /**
+   * Extract token from Express request.
+   * By default, extracts from Authorization header.
+   */
+  getToken?: (req: Request) => string | undefined;
+}
+```
+
+## Endpoints
+
+The middleware exposes these HTTP endpoints:
+
+| Method | Path      | Description                   |
+| ------ | --------- | ----------------------------- |
+| GET    | `/events` | SSE stream for session events |
+| POST   | `/send`   | Send message to session       |
+| POST   | `/invoke` | Invoke custom method          |
+
+### SSE Events Stream
+
+```typescript
+// Client connects to events stream
+const events = new EventSource("/api/events?sessionId=main&token=xxx");
+
+events.addEventListener("content_delta", (e) => {
+  const data = JSON.parse(e.data);
+  console.log("Content:", data.delta);
+});
+
+events.addEventListener("tool_use", (e) => {
+  const data = JSON.parse(e.data);
+  console.log("Tool call:", data.name);
+});
+
+events.addEventListener("message_end", () => {
+  console.log("Response complete");
+});
+```
+
+### Send Message
+
+```typescript
+const response = await fetch("/api/send", {
+  method: "POST",
+  headers: {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${token}`,
+  },
+  body: JSON.stringify({
+    sessionId: "main",
+    message: "Hello!",
+  }),
+});
+```
+
+### Invoke Custom Method
+
+```typescript
+const response = await fetch("/api/invoke", {
+  method: "POST",
+  headers: {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${token}`,
+  },
+  body: JSON.stringify({
+    method: "tasks:list",
+    params: { sessionId: "main" },
+  }),
+});
+```
+
+## Custom Methods
+
+Define methods using the `method()` helper for schema validation and guards:
+
+```typescript
+import { method } from "@agentick/express";
+import { z } from "zod";
+import { Context } from "@agentick/kernel";
+
+const middleware = createAgentickMiddleware({
+  apps: { assistant: agentickApp },
+  defaultApp: "assistant",
+  methods: {
+    // Simple method - no schema
+    ping: async () => ({ pong: true }),
+
+    // With Zod schema - params are typed!
+    tasks: {
+      create: method({
+        schema: z.object({
+          title: z.string().min(1),
+          priority: z.enum(["low", "medium", "high"]).optional(),
+        }),
+        handler: async (params) => {
+          // Access Agentick context
+          const ctx = Context.get();
+          return todoService.create({
+            title: params.title,
+            priority: params.priority,
+            userId: ctx.user?.id,
+          });
+        },
+      }),
+
+      // With role guards
+      admin: {
+        delete: method({
+          roles: ["admin"],
+          schema: z.object({ id: z.number() }),
+          handler: async (params) => todoService.delete(params.id),
+        }),
+      },
+    },
+  },
+});
+```
+
+## Authentication
+
+```typescript
+// Token auth
+auth: {
+  type: "token",
+  token: process.env.API_TOKEN,
+}
+
+// JWT auth
+auth: {
+  type: "jwt",
+  secret: process.env.JWT_SECRET,
+}
+
+// Custom auth with user hydration
+auth: {
+  type: "custom",
+  validate: async (token) => {
+    const decoded = await verifyJWT(token);
+    return { valid: true, user: { id: decoded.sub } };
+  },
+  hydrateUser: async (authResult) => {
+    const dbUser = await db.users.findById(authResult.user.id);
+    return {
+      id: dbUser.id,
+      tenantId: dbUser.tenantId,
+      roles: dbUser.roles,
+    };
+  },
+}
+```
+
+## Graceful Shutdown
+
+The middleware exposes the underlying Gateway for lifecycle management:
+
+```typescript
+const agentick = createAgentickMiddleware({ ... });
+app.use("/api", agentick);
+
+const server = app.listen(3000);
+
+const shutdown = async (signal: string) => {
+  console.log(`${signal} received, shutting down...`);
+
+  // Close gateway first (cleanly disconnects all sessions)
+  await agentick.gateway.close();
+
+  // Then close HTTP server
+  server.close(() => {
+    console.log("Server closed");
+    process.exit(0);
+  });
+};
+
+process.once("SIGTERM", () => shutdown("SIGTERM"));
+process.once("SIGINT", () => shutdown("SIGINT"));
+```
+
+## Re-exports
+
+For convenience, the package re-exports common types from `@agentick/gateway`:
+
+```typescript
+export {
+  Gateway,
+  method,
+  type GatewayConfig,
+  type MethodDefinition,
+  type AuthConfig,
+} from "@agentick/gateway";
+```
+
+## Related Packages
+
+- [`@agentick/gateway`](../gateway) - Core gateway (used internally)
+- [`@agentick/core`](../core) - JSX runtime for agents
+- [`@agentick/client`](../client) - Browser/Node client SDK
+- [`@agentick/server`](../server) - SSE utilities
+
+## License
+
+MIT

package/dist/__tests__/message-flow.integration.spec.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Express Handler Integration Tests
+ *
+ * These tests verify the handler creates sessions correctly
+ * and routes requests to the appropriate endpoints.
+ */
+export {};
+//# sourceMappingURL=message-flow.integration.spec.d.ts.map

package/dist/__tests__/message-flow.integration.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-flow.integration.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/message-flow.integration.spec.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/message-flow.integration.spec.jsx

@@ -0,0 +1,175 @@
+/**
+ * Express Handler Integration Tests
+ *
+ * These tests verify the handler creates sessions correctly
+ * and routes requests to the appropriate endpoints.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import express, {} from "express";
+import { createTentickleHandler } from "../router";
+import { createApp, Model, System, Timeline } from "@tentickle/core";
+// Helper to create a mock model
+function createMockModel() {
+    return {
+        metadata: {
+            id: "test-model",
+            provider: "test",
+            model: "test",
+            capabilities: ["streaming", "tools"],
+        },
+        generate: vi.fn().mockResolvedValue({
+            message: { role: "assistant", content: [{ type: "text", text: "Test response" }] },
+            usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 },
+            stopReason: "stop",
+        }),
+        stream: vi.fn().mockImplementation(async function* () {
+            yield { type: "content_delta", delta: "Test ", role: "assistant" };
+            yield { type: "content_delta", delta: "response", role: "assistant" };
+            yield {
+                type: "result",
+                message: { role: "assistant", content: [{ type: "text", text: "Test response" }] },
+                usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 },
+                stopReason: "stop",
+            };
+        }),
+        fromEngineState: vi.fn().mockImplementation(async (input) => {
+            return {
+                messages: [
+                    ...(input.system || []).map((e) => e.message),
+                    ...input.timeline.filter((e) => e.kind === "message").map((e) => e.message),
+                ],
+                tools: input.tools || [],
+            };
+        }),
+        toEngineState: vi.fn().mockImplementation(async (output) => ({
+            message: output.message,
+            toolCalls: [],
+            stopReason: { reason: "stop", description: "Completed", recoverable: false },
+            usage: output.usage,
+        })),
+    };
+}
+describe("Express Handler Setup", () => {
+    let expressApp;
+    let tentickleApp;
+    let mockModel;
+    beforeEach(() => {
+        mockModel = createMockModel();
+        const Agent = () => {
+            return (<>
+          <Model model={mockModel}/>
+          <System>You are a test assistant</System>
+          <Timeline />
+        </>);
+        };
+        tentickleApp = createApp(Agent, { maxTicks: 1 });
+        expressApp = express();
+        expressApp.use(express.json());
+    });
+    describe("createTentickleHandler", () => {
+        it("should create a valid express router", () => {
+            const handler = createTentickleHandler(tentickleApp);
+            expect(handler).toBeDefined();
+            expect(typeof handler).toBe("function");
+        });
+        it("should accept custom options", () => {
+            const handler = createTentickleHandler(tentickleApp, {
+                authenticate: (req) => ({ userId: req.headers["x-user-id"] }),
+            });
+            expect(handler).toBeDefined();
+        });
+    });
+    describe("Session management", () => {
+        it("should create session on demand", () => {
+            // App should be able to create sessions
+            const session = tentickleApp.session("test-session");
+            expect(session).toBeDefined();
+            expect(session.id).toBe("test-session");
+        });
+        it("should reuse existing session with same ID", () => {
+            const session1 = tentickleApp.session("reuse-session");
+            const session2 = tentickleApp.session("reuse-session");
+            // Should be the same session instance
+            expect(session1).toBe(session2);
+        });
+        it("should create different sessions for different IDs", () => {
+            const session1 = tentickleApp.session("session-a");
+            const session2 = tentickleApp.session("session-b");
+            expect(session1.id).not.toBe(session2.id);
+        });
+    });
+    describe("Message handling via session", () => {
+        it("should handle send with message", async () => {
+            const session = tentickleApp.session("send-test");
+            const handle = session.send({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Hello" }],
+                },
+            });
+            // Collect events to verify execution happened
+            const events = [];
+            for await (const event of handle) {
+                events.push(event);
+            }
+            // Should have received events
+            expect(events.length).toBeGreaterThan(0);
+            // Should have execution_start
+            const hasExecutionStart = events.some((e) => e.type === "execution_start");
+            expect(hasExecutionStart).toBe(true);
+        });
+        it("should pass user message to model", async () => {
+            const session = tentickleApp.session("model-test");
+            await session.send({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Test message" }],
+                },
+            }).result;
+            // Model's fromEngineState should have been called
+            expect(mockModel.fromEngineState).toHaveBeenCalled();
+            // Check that user message was in the input
+            const calls = mockModel.fromEngineState.mock.calls;
+            const lastCall = calls[calls.length - 1];
+            const input = lastCall[0];
+            const userEntries = input.timeline.filter((e) => e.message?.role === "user");
+            expect(userEntries.length).toBeGreaterThanOrEqual(1);
+        });
+        it("should stream events from execution", async () => {
+            const session = tentickleApp.session("stream-test");
+            const handle = session.send({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Stream test" }],
+                },
+            });
+            const events = [];
+            for await (const event of handle) {
+                events.push(event);
+            }
+            // Should have received events
+            expect(events.length).toBeGreaterThan(0);
+            // Should have common event types
+            const eventTypes = events.map((e) => e.type);
+            expect(eventTypes).toContain("execution_start");
+        });
+    });
+});
+describe("Handler with Custom Options", () => {
+    it("should accept authentication handler", async () => {
+        const mockModel = createMockModel();
+        const Agent = () => (<>
+        <Model model={mockModel}/>
+        <System>Test</System>
+        <Timeline />
+      </>);
+        const app = createApp(Agent, { maxTicks: 1 });
+        const authHandler = vi.fn().mockReturnValue({ userId: "user-123" });
+        const handler = createTentickleHandler(app, {
+            authenticate: authHandler,
+        });
+        // The handler should be created successfully
+        expect(handler).toBeDefined();
+    });
+});
+//# sourceMappingURL=message-flow.integration.spec.jsx.map

package/dist/__tests__/message-flow.integration.spec.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-flow.integration.spec.jsx","sourceRoot":"","sources":["../../src/__tests__/message-flow.integration.spec.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @agentick/express - Express adapter for Agentick Gateway
+ *
+ * Provides an Express middleware that delegates to Gateway.
+ * This is a thin adapter - all business logic lives in @agentick/gateway.
+ *
+ * @example Quick start
+ * ```typescript
+ * import express from "express";
+ * import { createAgentickMiddleware } from "@agentick/express";
+ * import { createApp } from "@agentick/core";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * const agentickApp = createApp(<MyAgent />);
+ *
+ * app.use("/api", createAgentickMiddleware({
+ *   apps: { assistant: agentickApp },
+ *   defaultApp: "assistant",
+ * }));
+ *
+ * const server = app.listen(3000);
+ *
+ * // Cleanup on shutdown
+ * process.on("SIGTERM", () => server.close());
+ * ```
+ *
+ * @example With custom methods and auth
+ * ```typescript
+ * import { createAgentickMiddleware, method } from "@agentick/express";
+ * import { z } from "zod";
+ *
+ * app.use("/api", createAgentickMiddleware({
+ *   apps: { assistant: agentickApp },
+ *   defaultApp: "assistant",
+ *   auth: {
+ *     type: "custom",
+ *     validate: async (token) => {
+ *       const user = await verifyToken(token);
+ *       return user ? { valid: true, user } : { valid: false };
+ *     },
+ *   },
+ *   methods: {
+ *     tasks: {
+ *       list: method({
+ *         schema: z.object({ sessionId: z.string() }),
+ *         handler: async (params) => todoService.list(params.sessionId),
+ *       }),
+ *     },
+ *   },
+ * }));
+ * ```
+ *
+ * @module @agentick/express
+ */
+import { Router } from "express";
+import type { Request } from "express";
+import { Gateway, type GatewayConfig } from "@agentick/gateway";
+/**
+ * Options for the Express middleware.
+ */
+export interface AgentickMiddlewareOptions {
+    /**
+     * Extract token from Express request.
+     * By default, extracts from Authorization header.
+     */
+    getToken?: (req: Request) => string | undefined;
+}
+/**
+ * Gateway config type for Express middleware.
+ * Excludes standalone-mode-only options.
+ */
+export type AgentickExpressConfig = Omit<GatewayConfig, "port" | "host" | "transport" | "httpPort">;
+/**
+ * Express Router with attached Gateway instance for lifecycle management.
+ */
+export interface AgentickRouter extends Router {
+    /** The underlying Gateway instance for lifecycle management */
+    gateway: Gateway;
+}
+/**
+ * Create Express middleware that delegates to Gateway.
+ *
+ * @param gatewayConfig - Gateway configuration (apps, methods, auth, etc.)
+ * @param options - Optional Express-specific options
+ * @returns Express Router middleware with attached gateway
+ *
+ * @example
+ * ```typescript
+ * const middleware = createAgentickMiddleware({
+ *   apps: { assistant: myApp },
+ *   defaultApp: "assistant",
+ * });
+ *
+ * app.use("/api", middleware);
+ *
+ * // Access gateway for lifecycle management
+ * process.on("SIGTERM", () => middleware.gateway.close());
+ * ```
+ */
+export declare function createAgentickMiddleware(gatewayConfig: AgentickExpressConfig, options?: AgentickMiddlewareOptions): AgentickRouter;
+/**
+ * Get the Gateway instance from middleware for advanced use.
+ * Useful for lifecycle management, events, etc.
+ */
+export declare function createAgentickGateway(gatewayConfig: AgentickExpressConfig): Gateway;
+export { Gateway, method, type GatewayConfig, type MethodDefinition, type AuthConfig, } from "@agentick/gateway";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,qBAAqB,EACpC,OAAO,GAAE,yBAA8B,GACtC,cAAc,CA2BhB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAKnF;AAGD,OAAO,EACL,OAAO,EACP,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC"}