@agentium/transport 3.1.0 → 3.1.1

package/dist/a2a/a2a-server.d.ts

@@ -0,0 +1,9 @@
+import type { A2AServerOptions } from "./types.js";
+/**
+ * Mount an A2A-compliant server on an Express app.
+ *
+ * - Serves `/.well-known/agent.json` with the Agent Card
+ * - Handles JSON-RPC 2.0 requests at the basePath for message/send, message/stream, tasks/get, tasks/cancel
+ */
+export declare function createA2AServer(app: any, opts: A2AServerOptions): void;
+//# sourceMappingURL=a2a-server.d.ts.map

package/dist/a2a/a2a-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-server.d.ts","sourceRoot":"","sources":["../../src/a2a/a2a-server.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA4EnD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAuCtE"}

package/dist/a2a/agent-card.d.ts

@@ -0,0 +1,17 @@
+import type { A2AAgentCard, Agent } from "@agentium/core";
+/**
+ * Generate an A2A Agent Card from a Agentium Agent.
+ * The card is served at /.well-known/agent.json per the A2A spec.
+ */
+export declare function generateAgentCard(agent: Agent, serverUrl: string, provider?: {
+    organization: string;
+    url?: string;
+}, version?: string): A2AAgentCard;
+/**
+ * Generate a combined Agent Card that lists multiple agents as skills.
+ */
+export declare function generateMultiAgentCard(agents: Record<string, Agent>, serverUrl: string, provider?: {
+    organization: string;
+    url?: string;
+}, version?: string): A2AAgentCard;
+//# sourceMappingURL=agent-card.d.ts.map

package/dist/a2a/agent-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAkCd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAwBd"}

package/dist/a2a/types.d.ts

@@ -0,0 +1,11 @@
+import type { Agent } from "@agentium/core";
+export interface A2AServerOptions {
+    agents: Record<string, Agent>;
+    basePath?: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    version?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/a2a/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/a2a/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/express/admin-router.d.ts

@@ -0,0 +1,36 @@
+import { MCPManager } from "./mcp-manager.js";
+export interface AdminRouterOptions {
+    /** Shared MCPManager instance. If omitted, a new one is created. */
+    mcpManager?: MCPManager;
+    /**
+     * Express middleware for authentication/authorization.
+     * **IMPORTANT**: These endpoints can add MCP servers and execute tools.
+     * Always add auth middleware in production.
+     */
+    middleware?: any[];
+}
+/**
+ * Creates an Express sub-router with admin endpoints for managing
+ * MCP servers and the toolkit catalog at runtime.
+ *
+ * Mount under a prefix: `app.use("/admin", createAdminRouter())`
+ *
+ * Routes:
+ *   GET    /mcp              — list MCP servers
+ *   POST   /mcp              — add + connect an MCP server
+ *   GET    /mcp/:id          — single server details
+ *   POST   /mcp/:id/connect  — connect a server
+ *   POST   /mcp/:id/disconnect — disconnect
+ *   DELETE /mcp/:id          — remove a server
+ *   GET    /mcp/:id/tools    — tools from a specific server
+ *   GET    /mcp/tools        — all tools across connected servers
+ *
+ *   GET    /toolkits         — list toolkit catalog
+ *   GET    /toolkits/:id     — single toolkit meta
+ *   POST   /toolkits/:id     — instantiate a toolkit with config
+ */
+export declare function createAdminRouter(opts?: AdminRouterOptions): {
+    router: any;
+    mcpManager: MCPManager;
+};
+//# sourceMappingURL=admin-router.d.ts.map

package/dist/express/admin-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-router.d.ts","sourceRoot":"","sources":["../../src/express/admin-router.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,kBAAkB;;;EA6J1D"}

package/dist/express/file-upload.d.ts

@@ -0,0 +1,9 @@
+export interface FileUploadOptions {
+    maxFileSize?: number;
+    maxFiles?: number;
+    allowedMimeTypes?: string[];
+}
+export declare function createFileUploadMiddleware(opts?: FileUploadOptions): any;
+export declare function filesToContentParts(files: any[]): any[];
+export declare function buildMultiModalInput(body: any, files?: any[]): string | any[];
+//# sourceMappingURL=file-upload.d.ts.map

package/dist/express/file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.d.ts","sourceRoot":"","sources":["../../src/express/file-upload.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,iBAAsB,OA2BtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAcvD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAY7E"}

package/dist/express/gateway.d.ts

@@ -0,0 +1,16 @@
+import type { RouterOptions } from "./types.js";
+export interface RemoteEndpoint {
+    baseUrl: string;
+    agents?: string[];
+    teams?: string[];
+    workflows?: string[];
+    headers?: Record<string, string>;
+    healthPath?: string;
+}
+export interface GatewayConfig {
+    locals?: RouterOptions;
+    remotes: RemoteEndpoint[];
+    healthCheckIntervalMs?: number;
+}
+export declare function createGatewayRouter(config: GatewayConfig): any;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/express/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/express/gateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,OAwHxD"}

package/dist/express/jwt-middleware.d.ts

@@ -0,0 +1,10 @@
+export interface JwtConfig {
+    secret: string;
+    algorithm?: string;
+    issuer?: string;
+    audience?: string;
+    extractFrom?: "header" | "cookie";
+    cookieName?: string;
+}
+export declare function createJwtMiddleware(config: JwtConfig): (req: any, res: any, next: any) => any;
+//# sourceMappingURL=jwt-middleware.d.ts.map

package/dist/express/jwt-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-middleware.d.ts","sourceRoot":"","sources":["../../src/express/jwt-middleware.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,IAW3C,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,SAgCtC"}

package/dist/express/mcp-manager.d.ts

@@ -0,0 +1,52 @@
+import type { MCPToolProviderConfig, ToolDef } from "@agentium/core";
+import { MCPToolProvider } from "@agentium/core";
+export interface MCPServerEntry {
+    id: string;
+    config: MCPToolProviderConfig;
+    provider: MCPToolProvider;
+    status: "disconnected" | "connecting" | "connected" | "error";
+    error?: string;
+    toolCount: number;
+    connectedAt?: Date;
+}
+export interface MCPServerSummary {
+    id: string;
+    name: string;
+    transport: string;
+    url?: string;
+    command?: string;
+    status: string;
+    toolCount: number;
+    error?: string;
+    connectedAt?: string;
+}
+/**
+ * Manages multiple MCP server connections at runtime.
+ * Servers can be added/removed/connected/disconnected dynamically,
+ * and their tools can be collected for injection into agents.
+ */
+export declare class MCPManager {
+    private servers;
+    /** Add a server config. Auto-generates an id from the name if not provided. */
+    add(config: MCPToolProviderConfig, id?: string): MCPServerSummary;
+    /** Connect a server by id. Discovers tools on success. */
+    connect(id: string): Promise<MCPServerSummary>;
+    /** Disconnect a server by id. */
+    disconnect(id: string): Promise<MCPServerSummary>;
+    /** Remove a server entirely. Disconnects first if connected. */
+    remove(id: string): Promise<void>;
+    /** Get all tools from all connected servers, merged into one array. */
+    getAllTools(): Promise<ToolDef[]>;
+    /** Get tools from a specific server. */
+    getTools(id: string): Promise<ToolDef[]>;
+    /** List all registered servers. */
+    list(): MCPServerSummary[];
+    /** Get a single server summary. */
+    get(id: string): MCPServerSummary;
+    has(id: string): boolean;
+    /** Disconnect all servers. */
+    closeAll(): Promise<void>;
+    private getEntry;
+    private summarize;
+}
+//# sourceMappingURL=mcp-manager.d.ts.map

package/dist/express/mcp-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-manager.d.ts","sourceRoot":"","sources":["../../src/express/mcp-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAqC;IAEpD,+EAA+E;IAC/E,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAkBjE,0DAA0D;IACpD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBpD,iCAAiC;IAC3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAavD,gEAAgE;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,uEAAuE;IACjE,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAevC,wCAAwC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQ9C,mCAAmC;IACnC,IAAI,IAAI,gBAAgB,EAAE;IAI1B,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;IAIjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,8BAA8B;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,SAAS;CAalB"}

package/dist/express/middleware.d.ts

@@ -0,0 +1,7 @@
+export declare function errorHandler(options?: {
+    logger?: Pick<Console, "error">;
+}): (err: any, _req: any, res: any, _next: any) => void;
+export declare function requestLogger(options?: {
+    logger?: Pick<Console, "log">;
+}): (req: any, _res: any, next: any) => void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/express/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/express/middleware.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;CAAE,IAEhE,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,KAAK,GAAG,EAAE,OAAO,GAAG,UAQlD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;CAAE,IAE/D,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,MAAM,GAAG,UAKvC"}

package/dist/express/rbac-middleware.d.ts

@@ -0,0 +1,7 @@
+export interface RbacConfig {
+    scopeField?: string;
+    defaultScopes?: Record<string, string[]>;
+    agentScopes?: Record<string, string[]>;
+}
+export declare function createRbacMiddleware(config?: RbacConfig): (req: any, res: any, next: any) => any;
+//# sourceMappingURL=rbac-middleware.d.ts.map

package/dist/express/rbac-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbac-middleware.d.ts","sourceRoot":"","sources":["../../src/express/rbac-middleware.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACxC;AAqBD,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,UAAe,IAIlD,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,SA4CtC"}

package/dist/express/router-factory.d.ts

@@ -0,0 +1,3 @@
+import type { RouterOptions } from "./types.js";
+export declare function createAgentRouter(opts: RouterOptions): any;
+//# sourceMappingURL=router-factory.d.ts.map

package/dist/express/router-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-factory.d.ts","sourceRoot":"","sources":["../../src/express/router-factory.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA2GhD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,OAmmBpD"}

package/dist/express/swagger.d.ts

@@ -0,0 +1,30 @@
+import type { RouterOptions, SwaggerOptions } from "./types.js";
+interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        description: string;
+        version: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, Record<string, unknown>>;
+    components: {
+        schemas: Record<string, unknown>;
+        securitySchemes?: Record<string, unknown>;
+    };
+    security?: Array<Record<string, string[]>>;
+    tags: Array<{
+        name: string;
+        description: string;
+    }>;
+}
+export declare function generateOpenAPISpec(routerOpts: RouterOptions, swaggerOpts?: SwaggerOptions): OpenAPISpec;
+export declare function serveSwaggerUI(spec: OpenAPISpec): {
+    setup: any;
+    serve: any;
+};
+export {};
+//# sourceMappingURL=swagger.d.ts.map

package/dist/express/swagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../src/express/swagger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAehE,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC3C,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AA+KD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,GAAE,cAAmB,GAAG,WAAW,CAoV5G;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW;;;EAe/C"}

package/dist/express/types.d.ts

@@ -0,0 +1,91 @@
+import type { Agent, Registry, Servable, ServableAgent, Team, ToolDef, Toolkit, Workflow } from "@agentium/core";
+import type { FileUploadOptions } from "./file-upload.js";
+import type { MCPManager } from "./mcp-manager.js";
+export interface SwaggerOptions {
+    /** Enable Swagger UI at /docs. Default: false */
+    enabled?: boolean;
+    /** API title shown in Swagger UI */
+    title?: string;
+    /** API description shown in Swagger UI */
+    description?: string;
+    /** API version string */
+    version?: string;
+    /** Route prefix used in path generation (e.g. "/api") */
+    routePrefix?: string;
+    /** Server URLs for the spec */
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    /** Path to serve Swagger UI. Default: "/docs" */
+    docsPath?: string;
+    /** Path to serve the raw OpenAPI JSON spec. Default: "/docs/spec.json" */
+    specPath?: string;
+}
+export interface RouterOptions {
+    /**
+     * Use a Registry for live auto-discovery. The router creates dynamic routes
+     * that resolve agents/teams/workflows at request time — any instance created
+     * after the router is mounted is automatically available.
+     *
+     * When omitted, falls back to the global registry from `@agentium/core`.
+     * Pass `false` to disable registry-based routing entirely (use explicit maps only).
+     *
+     * @example
+     * createAgentRouter({ cors: true });
+     * new Agent({ name: "bot", model: openai("gpt-4o") }); // immediately routable
+     */
+    registry?: Registry | false;
+    /**
+     * Auto-discover agents, teams, and workflows from a mixed array.
+     * Each item is classified by its `.kind` and keyed by `.name`.
+     */
+    serve?: Servable[];
+    agents?: Record<string, Agent | ServableAgent>;
+    teams?: Record<string, Team>;
+    workflows?: Record<string, Workflow<any>>;
+    middleware?: any[];
+    /** Swagger / OpenAPI configuration */
+    swagger?: SwaggerOptions;
+    /** File upload configuration for multi-modal inputs */
+    fileUpload?: boolean | FileUploadOptions;
+    /** CORS configuration. Pass true or '*' for permissive, a string for a single origin, or an array for multiple origins. */
+    cors?: string | string[] | boolean;
+    /** Rate limiting configuration. Pass true for defaults (100 req/min), or an object to customize. */
+    rateLimit?: {
+        windowMs?: number;
+        max?: number;
+    } | boolean;
+    /** Named tool library exposed via GET /tools. Tools from toolkits are auto-collected. */
+    toolLibrary?: Record<string, ToolDef>;
+    /** Toolkit instances whose tools are exposed via GET /tools. Merged with toolLibrary. */
+    toolkits?: Toolkit[];
+    /**
+     * Enable admin routes under `/admin` for managing MCP servers and the toolkit catalog.
+     * Pass `true` to use defaults, or provide an MCPManager instance to share state.
+     */
+    admin?: boolean | {
+        mcpManager?: MCPManager;
+        middleware?: any[];
+    };
+    /**
+     * Enable schedule management routes under `/schedules`.
+     * Pass an AgentQueue instance from `@agentium/queue`.
+     */
+    scheduler?: any;
+    /**
+     * MetricsExporter instance from `@agentium/observability` for `/metrics` endpoints.
+     */
+    metricsExporter?: any;
+    /**
+     * JWT authentication middleware. Verifies tokens and attaches decoded payload to `req.user`.
+     * Requires `jsonwebtoken` package.
+     */
+    jwt?: import("./jwt-middleware.js").JwtConfig;
+    /**
+     * Role-based access control. Checks `req.user.scopes` against required scopes per route.
+     * Requires `jwt` to be configured first.
+     */
+    rbac?: import("./rbac-middleware.js").RbacConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/express/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/express/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACzC,2HAA2H;IAC3H,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACnC,oGAAoG;IACpG,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC1D,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAClE;;;OAGG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB;;OAEG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,qBAAqB,EAAE,SAAS,CAAC;IAC9C;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,sBAAsB,EAAE,UAAU,CAAC;CAClD"}

package/dist/express/ui-stream.d.ts

@@ -0,0 +1,78 @@
+import type { Agent } from "@agentium/core";
+/**
+ * Vercel AI SDK UI Message Stream adapter.
+ *
+ * Converts the chunks emitted by `agent.stream(...)` into the line-delimited
+ * JSON protocol consumed by Vercel's `useChat` / `createAgentUIStreamResponse`.
+ *
+ * Spec: https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol
+ */
+export interface AgentUIStreamOptions {
+    /** sessionId forwarded to `agent.run` / `agent.stream`. */
+    sessionId?: string;
+    /** userId forwarded to `agent.run` / `agent.stream`. */
+    userId?: string;
+    /** Optional per-request API key override. */
+    apiKey?: string;
+    /** Optional abort signal to cancel the run. */
+    signal?: AbortSignal;
+}
+interface AgentLikeChunk {
+    type?: string;
+    text?: string;
+    delta?: string;
+    toolCallId?: string;
+    toolName?: string;
+    arguments?: unknown;
+    args?: unknown;
+    input?: unknown;
+    output?: unknown;
+    result?: unknown;
+    finishReason?: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    error?: string | {
+        message?: string;
+    };
+    reasoning?: string;
+    thinking?: string;
+}
+interface AgentLike {
+    stream(input: string, opts?: {
+        sessionId?: string;
+        userId?: string;
+        apiKey?: string;
+        signal?: AbortSignal;
+    }): AsyncIterable<AgentLikeChunk>;
+}
+/**
+ * Render an `agent.stream()` source as a Vercel-compatible UI message stream.
+ *
+ * The returned `ReadableStream<Uint8Array>` can be wrapped in a `Response`
+ * (web / edge / fetch) or piped to a Node `ServerResponse`.
+ */
+export declare function agentUIStream(agent: Agent | AgentLike, input: string, options?: AgentUIStreamOptions): ReadableStream<Uint8Array>;
+/**
+ * Create a `Response` whose body streams Vercel UI messages. Use as the return
+ * value of a Web / Edge / Next.js Route Handler.
+ *
+ * @example
+ * ```ts
+ * import { createAgentUIStreamResponse } from "@agentium/transport";
+ *
+ * export async function POST(req: Request) {
+ *   const { input, sessionId } = await req.json();
+ *   return createAgentUIStreamResponse(agent, input, { sessionId });
+ * }
+ * ```
+ */
+export declare function createAgentUIStreamResponse(agent: Agent | AgentLike, input: string, options?: AgentUIStreamOptions): Response;
+/**
+ * Pipe a Vercel UI message stream into a Node `ServerResponse` (Express style).
+ */
+export declare function pipeAgentUIStreamToResponse(agent: Agent | AgentLike, input: string, res: any, options?: AgentUIStreamOptions): Promise<void>;
+export {};
+//# sourceMappingURL=ui-stream.d.ts.map

package/dist/express/ui-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-stream.d.ts","sourceRoot":"","sources":["../../src/express/ui-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,SAAS;IACjB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpF,aAAa,CAAC,cAAc,CAAC,CAAC;CAClC;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAAC,UAAU,CAAC,CAuG5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,QAAQ,CAUV;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAkBf"}