@agentium/transport 3.0.2 → 3.1.1

package/dist/index.d.ts

@@ -1,523 +1,32 @@
-import { Agent, A2AAgentCard, MCPToolProviderConfig, ToolDef, MCPToolProvider, Registry, Servable, ServableAgent, Team, Workflow, Toolkit, EventBus, VisionAgent, VoiceAgent } from '@agentium/core';
-
-interface A2AServerOptions {
-    agents: Record<string, Agent>;
-    basePath?: string;
-    provider?: {
-        organization: string;
-        url?: string;
-    };
-    version?: string;
-}
-
-/**
- * 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
- */
-declare function createA2AServer(app: any, opts: A2AServerOptions): void;
-
-/**
- * Generate an A2A Agent Card from a Agentium Agent.
- * The card is served at /.well-known/agent.json per the A2A spec.
- */
-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.
- */
-declare function generateMultiAgentCard(agents: Record<string, Agent>, serverUrl: string, provider?: {
-    organization: string;
-    url?: string;
-}, version?: string): A2AAgentCard;
-
-interface MCPServerEntry {
-    id: string;
-    config: MCPToolProviderConfig;
-    provider: MCPToolProvider;
-    status: "disconnected" | "connecting" | "connected" | "error";
-    error?: string;
-    toolCount: number;
-    connectedAt?: Date;
-}
-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.
- */
-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;
-}
-
-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
- */
-declare function createAdminRouter(opts?: AdminRouterOptions): {
-    router: any;
-    mcpManager: MCPManager;
-};
-
-interface FileUploadOptions {
-    maxFileSize?: number;
-    maxFiles?: number;
-    allowedMimeTypes?: string[];
-}
-declare function createFileUploadMiddleware(opts?: FileUploadOptions): any;
-declare function buildMultiModalInput(body: any, files?: any[]): string | any[];
-
-interface RbacConfig {
-    scopeField?: string;
-    defaultScopes?: Record<string, string[]>;
-    agentScopes?: Record<string, string[]>;
-}
-declare function createRbacMiddleware(config?: RbacConfig): (req: any, res: any, next: any) => any;
-
-interface JwtConfig {
-    secret: string;
-    algorithm?: string;
-    issuer?: string;
-    audience?: string;
-    extractFrom?: "header" | "cookie";
-    cookieName?: string;
-}
-declare function createJwtMiddleware(config: JwtConfig): (req: any, res: any, next: any) => any;
-
-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;
-}
-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?: JwtConfig;
-    /**
-     * Role-based access control. Checks `req.user.scopes` against required scopes per route.
-     * Requires `jwt` to be configured first.
-     */
-    rbac?: RbacConfig;
-}
-
-interface RemoteEndpoint {
-    baseUrl: string;
-    agents?: string[];
-    teams?: string[];
-    workflows?: string[];
-    headers?: Record<string, string>;
-    healthPath?: string;
-}
-interface GatewayConfig {
-    locals?: RouterOptions;
-    remotes: RemoteEndpoint[];
-    healthCheckIntervalMs?: number;
-}
-declare function createGatewayRouter(config: GatewayConfig): any;
-
-declare function errorHandler(options?: {
-    logger?: Pick<Console, "error">;
-}): (err: any, _req: any, res: any, _next: any) => void;
-declare function requestLogger(options?: {
-    logger?: Pick<Console, "log">;
-}): (req: any, _res: any, next: any) => void;
-
-declare function createAgentRouter(opts: RouterOptions): any;
-
-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;
-    }>;
-}
-declare function generateOpenAPISpec(routerOpts: RouterOptions, swaggerOpts?: SwaggerOptions): OpenAPISpec;
-
-/**
- * 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
- */
-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`.
- */
-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 });
- * }
- * ```
- */
-declare function createAgentUIStreamResponse(agent: Agent | AgentLike, input: string, options?: AgentUIStreamOptions): Response;
-/**
- * Pipe a Vercel UI message stream into a Node `ServerResponse` (Express style).
- */
-declare function pipeAgentUIStreamToResponse(agent: Agent | AgentLike, input: string, res: any, options?: AgentUIStreamOptions): Promise<void>;
-
-/**
- * Minimal interface for a BrowserAgent — avoids a hard dependency on @agentium/browser.
- * Any object that matches this shape (e.g. a real BrowserAgent) works.
- */
-interface BrowserAgentLike {
-    name: string;
-    eventBus: EventBus;
-    run(task: string, opts?: {
-        startUrl?: string;
-        apiKey?: string;
-        sessionId?: string;
-    }): Promise<{
-        result: string;
-        success: boolean;
-        finalUrl: string;
-        durationMs: number;
-        videoPath?: string;
-        steps: Array<{
-            index: number;
-            action: unknown;
-            screenshot: Buffer;
-            pageUrl: string;
-            pageTitle: string;
-            dom?: string;
-        }>;
-    }>;
-}
-interface BrowserGatewayOptions {
-    /** Named BrowserAgent instances. Clients select one via agentName. */
-    agents: Record<string, BrowserAgentLike>;
-    /** Socket.IO server instance */
-    io: any;
-    /** Socket.IO namespace. Default: "/agentium-browser" */
-    namespace?: string;
-    /** Optional auth middleware applied to the namespace */
-    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
-    /**
-     * Stream screenshots to the client in real-time.
-     * Default: true. Disable for bandwidth-constrained clients.
-     */
-    streamScreenshots?: boolean;
-}
-/**
- * Create a Socket.IO gateway that streams BrowserAgent execution in real-time.
- *
- * ## Client → Server events
- * - `browser.start` — kick off a browser task
- * - `browser.stop`  — cancel a running task
- *
- * ## Server → Client events
- * - `browser.started`    — task accepted
- * - `browser.screenshot` — live screenshot (base64 PNG)
- * - `browser.action`     — action about to execute
- * - `browser.step`       — full step with screenshot + DOM
- * - `browser.done`       — task finished (result, success, duration, video)
- * - `browser.error`      — error occurred
- * - `browser.stopped`    — task was cancelled
- */
-declare function createBrowserGateway(opts: BrowserGatewayOptions): void;
-
-interface GatewayOptions {
-    /**
-     * Use a Registry for live auto-discovery. The gateway resolves agents/teams
-     * at event time — any instance created after the gateway starts is automatically
-     * reachable.
-     *
-     * When omitted, falls back to the global registry from `@agentium/core`.
-     * Pass `false` to disable registry-based lookup (use explicit maps only).
-     *
-     * @example
-     * createAgentGateway({ io });
-     * new Agent({ name: "bot", model: openai("gpt-4o") }); // immediately reachable
-     */
-    registry?: Registry | false;
-    /**
-     * Auto-discover agents and teams 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>;
-    io: any;
-    namespace?: string;
-    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
-    /** Max requests per minute per socket. Default: 60 */
-    maxRequestsPerMinute?: number;
-    /** Named tool library exposed via tools.list event. */
-    toolLibrary?: Record<string, ToolDef>;
-    /** Toolkit instances whose tools are exposed via tools.list. Merged with toolLibrary. */
-    toolkits?: Toolkit[];
-}
-
-declare function createAgentGateway(opts: GatewayOptions): void;
-
-interface VisionGatewayOptions {
-    agents: Record<string, VisionAgent>;
-    io: any;
-    namespace?: string;
-    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
-}
-declare function createVisionGateway(opts: VisionGatewayOptions): void;
-
-interface VoiceGatewayOptions {
-    agents: Record<string, VoiceAgent>;
-    io: any;
-    namespace?: string;
-    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
-}
-declare function createVoiceGateway(opts: VoiceGatewayOptions): void;
-
-/**
- * Per-run in-memory ring buffer of SSE events. Each event gets a monotonically
- * increasing numeric `id` so clients can pass `Last-Event-ID` on reconnect and
- * replay missed events.
- *
- * Storage is intentionally in-process; for multi-instance deployments, plug a
- * Redis-backed implementation behind the same interface.
- */
-interface SSEEvent {
-    /** Monotonic numeric ID. */
-    id: number;
-    /** Optional `event:` line value. Default omitted. */
-    event?: string;
-    /** Payload (will be JSON-stringified into the `data:` field). */
-    payload: unknown;
-    /** Wall-clock time the event was recorded. */
-    recordedAt: number;
-}
-interface SSEEventLog {
-    /** Record a new event and return its assigned id. */
-    record(runId: string, event: Omit<SSEEvent, "id" | "recordedAt">): SSEEvent;
-    /** Return events for a run with id greater than `afterId`. */
-    since(runId: string, afterId: number): SSEEvent[];
-    /** All events for a run. */
-    all(runId: string): SSEEvent[];
-    /** Mark a run completed (frees buffers after `ttlMs`). */
-    finalize(runId: string): void;
-    /** Remove a run's buffer immediately. */
-    drop(runId: string): void;
-}
-interface InMemoryEventLogConfig {
-    /** Max events kept per run. Oldest evicted when exceeded. Default: 1024. */
-    maxEventsPerRun?: number;
-    /** Milliseconds after finalize before a run's buffer is dropped. Default: 300_000 (5min). */
-    ttlMs?: number;
-}
-declare class InMemoryEventLog implements SSEEventLog {
-    private buffers;
-    private nextIds;
-    private finalizeTimers;
-    private maxEvents;
-    private ttlMs;
-    constructor(config?: InMemoryEventLogConfig);
-    record(runId: string, event: Omit<SSEEvent, "id" | "recordedAt">): SSEEvent;
-    since(runId: string, afterId: number): SSEEvent[];
-    all(runId: string): SSEEvent[];
-    finalize(runId: string): void;
-    drop(runId: string): void;
-}
-/** Format an `SSEEvent` for the wire. */
-declare function formatSSEEvent(ev: SSEEvent): string;
-/** Process-wide default log so multiple endpoints can share one buffer. */
-declare const defaultEventLog: InMemoryEventLog;
-
-export { type A2AServerOptions, type AdminRouterOptions, type AgentUIStreamOptions, type BrowserGatewayOptions, type FileUploadOptions, type GatewayConfig, type GatewayOptions, InMemoryEventLog, type InMemoryEventLogConfig, type JwtConfig, MCPManager, type MCPServerEntry, type MCPServerSummary, type RbacConfig, type RemoteEndpoint, type RouterOptions, type SSEEvent, type SSEEventLog, type SwaggerOptions, type VisionGatewayOptions, type VoiceGatewayOptions, agentUIStream, buildMultiModalInput, createA2AServer, createAdminRouter, createAgentGateway, createAgentRouter, createAgentUIStreamResponse, createBrowserGateway, createFileUploadMiddleware, createGatewayRouter, createJwtMiddleware, createRbacMiddleware, createVisionGateway, createVoiceGateway, defaultEventLog, errorHandler, formatSSEEvent, generateAgentCard, generateMultiAgentCard, generateOpenAPISpec, pipeAgentUIStreamToResponse, requestLogger };
+export { createA2AServer } from "./a2a/a2a-server.js";
+export { generateAgentCard, generateMultiAgentCard } from "./a2a/agent-card.js";
+export type { A2AServerOptions } from "./a2a/types.js";
+export type { AdminRouterOptions } from "./express/admin-router.js";
+export { createAdminRouter } from "./express/admin-router.js";
+export type { FileUploadOptions } from "./express/file-upload.js";
+export { buildMultiModalInput, createFileUploadMiddleware } from "./express/file-upload.js";
+export type { GatewayConfig, RemoteEndpoint } from "./express/gateway.js";
+export { createGatewayRouter } from "./express/gateway.js";
+export type { JwtConfig } from "./express/jwt-middleware.js";
+export { createJwtMiddleware } from "./express/jwt-middleware.js";
+export type { MCPServerEntry, MCPServerSummary } from "./express/mcp-manager.js";
+export { MCPManager } from "./express/mcp-manager.js";
+export { errorHandler, requestLogger } from "./express/middleware.js";
+export type { RbacConfig } from "./express/rbac-middleware.js";
+export { createRbacMiddleware } from "./express/rbac-middleware.js";
+export { createAgentRouter } from "./express/router-factory.js";
+export { generateOpenAPISpec } from "./express/swagger.js";
+export type { RouterOptions, SwaggerOptions } from "./express/types.js";
+export type { AgentUIStreamOptions } from "./express/ui-stream.js";
+export { agentUIStream, createAgentUIStreamResponse, pipeAgentUIStreamToResponse } from "./express/ui-stream.js";
+export type { BrowserGatewayOptions } from "./socketio/browser-gateway.js";
+export { createBrowserGateway } from "./socketio/browser-gateway.js";
+export { createAgentGateway } from "./socketio/gateway.js";
+export type { GatewayOptions } from "./socketio/types.js";
+export type { VisionGatewayOptions } from "./socketio/vision-gateway.js";
+export { createVisionGateway } from "./socketio/vision-gateway.js";
+export type { VoiceGatewayOptions } from "./socketio/voice-gateway.js";
+export { createVoiceGateway } from "./socketio/voice-gateway.js";
+export type { InMemoryEventLogConfig, SSEEvent, SSEEventLog } from "./sse-event-log.js";
+export { defaultEventLog, formatSSEEvent, InMemoryEventLog } from "./sse-event-log.js";
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACjH,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/socketio/browser-gateway.d.ts

@@ -0,0 +1,62 @@
+import type { EventBus } from "@agentium/core";
+/**
+ * Minimal interface for a BrowserAgent — avoids a hard dependency on @agentium/browser.
+ * Any object that matches this shape (e.g. a real BrowserAgent) works.
+ */
+interface BrowserAgentLike {
+    name: string;
+    eventBus: EventBus;
+    run(task: string, opts?: {
+        startUrl?: string;
+        apiKey?: string;
+        sessionId?: string;
+    }): Promise<{
+        result: string;
+        success: boolean;
+        finalUrl: string;
+        durationMs: number;
+        videoPath?: string;
+        steps: Array<{
+            index: number;
+            action: unknown;
+            screenshot: Buffer;
+            pageUrl: string;
+            pageTitle: string;
+            dom?: string;
+        }>;
+    }>;
+}
+export interface BrowserGatewayOptions {
+    /** Named BrowserAgent instances. Clients select one via agentName. */
+    agents: Record<string, BrowserAgentLike>;
+    /** Socket.IO server instance */
+    io: any;
+    /** Socket.IO namespace. Default: "/agentium-browser" */
+    namespace?: string;
+    /** Optional auth middleware applied to the namespace */
+    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
+    /**
+     * Stream screenshots to the client in real-time.
+     * Default: true. Disable for bandwidth-constrained clients.
+     */
+    streamScreenshots?: boolean;
+}
+/**
+ * Create a Socket.IO gateway that streams BrowserAgent execution in real-time.
+ *
+ * ## Client → Server events
+ * - `browser.start` — kick off a browser task
+ * - `browser.stop`  — cancel a running task
+ *
+ * ## Server → Client events
+ * - `browser.started`    — task accepted
+ * - `browser.screenshot` — live screenshot (base64 PNG)
+ * - `browser.action`     — action about to execute
+ * - `browser.step`       — full step with screenshot + DOM
+ * - `browser.done`       — task finished (result, success, duration, video)
+ * - `browser.error`      — error occurred
+ * - `browser.stopped`    — task was cancelled
+ */
+export declare function createBrowserGateway(opts: BrowserGatewayOptions): void;
+export {};
+//# sourceMappingURL=browser-gateway.d.ts.map

package/dist/socketio/browser-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-gateway.d.ts","sourceRoot":"","sources":["../../src/socketio/browser-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;GAGG;AACH,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YACX,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;YACnB,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,gCAAgC;IAChC,EAAE,EAAE,GAAG,CAAC;IACR,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;IACpE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA+HtE"}

package/dist/socketio/gateway.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayOptions } from "./types.js";
+export declare function createAgentGateway(opts: GatewayOptions): void;
+//# sourceMappingURL=gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/socketio/gateway.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmBjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA0K7D"}

package/dist/socketio/handlers.d.ts

@@ -0,0 +1,2 @@
+export { createAgentGateway } from "./gateway.js";
+//# sourceMappingURL=handlers.d.ts.map

package/dist/socketio/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/socketio/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/socketio/types.d.ts

@@ -0,0 +1,33 @@
+import type { Agent, Registry, Servable, ServableAgent, Team, ToolDef, Toolkit } from "@agentium/core";
+export interface GatewayOptions {
+    /**
+     * Use a Registry for live auto-discovery. The gateway resolves agents/teams
+     * at event time — any instance created after the gateway starts is automatically
+     * reachable.
+     *
+     * When omitted, falls back to the global registry from `@agentium/core`.
+     * Pass `false` to disable registry-based lookup (use explicit maps only).
+     *
+     * @example
+     * createAgentGateway({ io });
+     * new Agent({ name: "bot", model: openai("gpt-4o") }); // immediately reachable
+     */
+    registry?: Registry | false;
+    /**
+     * Auto-discover agents and teams 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>;
+    io: any;
+    namespace?: string;
+    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
+    /** Max requests per minute per socket. Default: 60 */
+    maxRequestsPerMinute?: number;
+    /** Named tool library exposed via tools.list event. */
+    toolLibrary?: Record<string, ToolDef>;
+    /** Toolkit instances whose tools are exposed via tools.list. Merged with toolLibrary. */
+    toolkits?: Toolkit[];
+}
+//# sourceMappingURL=types.d.ts.map