@radaros/transport 0.3.5 → 0.3.6

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+import { Agent, Team, Workflow, A2AAgentCard } from '@radaros/core';
+
+interface FileUploadOptions {
+    maxFileSize?: number;
+    maxFiles?: number;
+    allowedMimeTypes?: string[];
+}
+declare function createFileUploadMiddleware(opts?: FileUploadOptions): any;
+declare function buildMultiModalInput(body: any, files?: any[]): string | 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 {
+    agents?: Record<string, Agent>;
+    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;
+}
+
+declare function createAgentRouter(opts: RouterOptions): any;
+
+declare function errorHandler(): (err: any, _req: any, res: any, _next: any) => void;
+declare function requestLogger(): (req: any, _res: any, next: any) => void;
+
+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;
+
+interface GatewayOptions {
+    agents?: Record<string, Agent>;
+    teams?: Record<string, Team>;
+    io: any;
+    namespace?: string;
+    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
+}
+
+declare function createAgentGateway(opts: GatewayOptions): void;
+
+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 RadarOS 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;
+
+export { type A2AServerOptions, type FileUploadOptions, type GatewayOptions, type RouterOptions, type SwaggerOptions, buildMultiModalInput, createA2AServer, createAgentGateway, createAgentRouter, createFileUploadMiddleware, errorHandler, generateAgentCard, generateMultiAgentCard, generateOpenAPISpec, requestLogger };