@radaros/transport 0.3.0 → 0.3.2

package/dist/index.js

@@ -4,6 +4,16 @@ import { createRequire as createRequire3 } from "module";
 // src/express/swagger.ts
 import { createRequire } from "module";
 var _require = createRequire(import.meta.url);
+function zodSchemaToJsonSchema(schema) {
+  try {
+    const zodToJsonSchema = _require("zod-to-json-schema").default ?? _require("zod-to-json-schema");
+    const result = zodToJsonSchema(schema, { target: "openApi3" });
+    const { $schema, ...rest } = result;
+    return rest;
+  } catch {
+    return null;
+  }
+}
 var SCHEMAS = {
   RunRequest: {
     type: "object",
@@ -206,6 +216,45 @@ function generateOpenAPISpec(routerOpts, swaggerOpts = {}) {
     spec.tags.push({ name: "Agents", description: "Agent endpoints for running and streaming AI agents" });
     for (const [name, agent] of Object.entries(routerOpts.agents)) {
       const agentDesc = buildAgentDescription(agent);
+      let responseSchemaRef = "#/components/schemas/RunOutput";
+      const zodSchema = agent.structuredOutputSchema;
+      if (zodSchema) {
+        const structuredJsonSchema = zodSchemaToJsonSchema(zodSchema);
+        if (structuredJsonSchema) {
+          const schemaName = `RunOutput_${name}`;
+          spec.components.schemas[schemaName] = {
+            type: "object",
+            properties: {
+              text: { type: "string", description: "Raw agent response text" },
+              toolCalls: {
+                type: "array",
+                items: {
+                  type: "object",
+                  properties: {
+                    toolCallId: { type: "string" },
+                    toolName: { type: "string" },
+                    result: {}
+                  }
+                }
+              },
+              usage: {
+                type: "object",
+                properties: {
+                  promptTokens: { type: "number" },
+                  completionTokens: { type: "number" },
+                  totalTokens: { type: "number" }
+                }
+              },
+              structured: {
+                ...structuredJsonSchema,
+                description: "Parsed structured output"
+              },
+              durationMs: { type: "number" }
+            }
+          };
+          responseSchemaRef = `#/components/schemas/${schemaName}`;
+        }
+      }
       spec.paths[`${prefix}/agents/${name}/run`] = {
         post: {
           tags: ["Agents"],
@@ -228,7 +277,7 @@ function generateOpenAPISpec(routerOpts, swaggerOpts = {}) {
               description: "Agent run result",
               content: {
                 "application/json": {
-                  schema: { $ref: "#/components/schemas/RunOutput" }
+                  schema: { $ref: responseSchemaRef }
                 }
               }
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radaros/transport",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -20,7 +20,7 @@
     "typescript": "^5.6.0"
   },
   "peerDependencies": {
-    "@radaros/core": "^0.3.0",
+    "@radaros/core": "^0.3.2",
     "@types/express": "^4.0.0 || ^5.0.0",
     "express": "^4.0.0 || ^5.0.0",
     "multer": ">=1.4.0",

package/src/express/swagger.ts

@@ -3,6 +3,17 @@ import type { RouterOptions, SwaggerOptions } from "./types.js";
 
 const _require = createRequire(import.meta.url);
 
+function zodSchemaToJsonSchema(schema: any): Record<string, unknown> | null {
+  try {
+    const zodToJsonSchema = _require("zod-to-json-schema").default ?? _require("zod-to-json-schema");
+    const result = zodToJsonSchema(schema, { target: "openApi3" });
+    const { $schema, ...rest } = result as Record<string, unknown>;
+    return rest;
+  } catch {
+    return null;
+  }
+}
+
 interface OpenAPISpec {
   openapi: string;
   info: {
@@ -242,6 +253,47 @@ export function generateOpenAPISpec(
     for (const [name, agent] of Object.entries(routerOpts.agents)) {
       const agentDesc = buildAgentDescription(agent);
 
+      let responseSchemaRef = "#/components/schemas/RunOutput";
+
+      const zodSchema = (agent as any).structuredOutputSchema;
+      if (zodSchema) {
+        const structuredJsonSchema = zodSchemaToJsonSchema(zodSchema);
+        if (structuredJsonSchema) {
+          const schemaName = `RunOutput_${name}`;
+          (spec.components.schemas as Record<string, unknown>)[schemaName] = {
+            type: "object",
+            properties: {
+              text: { type: "string", description: "Raw agent response text" },
+              toolCalls: {
+                type: "array",
+                items: {
+                  type: "object",
+                  properties: {
+                    toolCallId: { type: "string" },
+                    toolName: { type: "string" },
+                    result: {},
+                  },
+                },
+              },
+              usage: {
+                type: "object",
+                properties: {
+                  promptTokens: { type: "number" },
+                  completionTokens: { type: "number" },
+                  totalTokens: { type: "number" },
+                },
+              },
+              structured: {
+                ...structuredJsonSchema,
+                description: "Parsed structured output",
+              },
+              durationMs: { type: "number" },
+            },
+          };
+          responseSchemaRef = `#/components/schemas/${schemaName}`;
+        }
+      }
+
       spec.paths[`${prefix}/agents/${name}/run`] = {
         post: {
           tags: ["Agents"],
@@ -264,7 +316,7 @@ export function generateOpenAPISpec(
               description: "Agent run result",
               content: {
                 "application/json": {
-                  schema: { $ref: "#/components/schemas/RunOutput" },
+                  schema: { $ref: responseSchemaRef },
                 },
               },
             },