@sdk-it/typescript 0.27.0 → 0.28.0

package/dist/index.js

@@ -13,11 +13,15 @@ import {
 import {
   augmentSpec,
   cleanFiles,
+  forEachOperation as forEachOperation4,
   readWriteMetadata,
   sanitizeTag as sanitizeTag4,
   securityToOptions as securityToOptions2
 } from "@sdk-it/spec";
 
+// packages/typescript/src/lib/agent/utils.txt
+var utils_default = "function coerceContext(context?: any) {\n  if (!context) {\n    throw new Error('Context is required');\n  }\n  return context as {\n    client: any\n  };\n}\n/**\n * Takes a Zod object schema and makes all optional properties nullable as well.\n * This is useful for APIs where optional fields can be explicitly set to null.\n *\n * @param schema - The Zod object schema to transform\n * @returns A new Zod schema with optional properties made nullable\n */\nfunction makeOptionalPropsNullable<T extends z.ZodRawShape>(\n  schema: z.ZodObject<T>,\n) {\n  const shape = schema.shape;\n  const newShape = {} as Record<string, z.ZodTypeAny>;\n\n  for (const [key, value] of Object.entries(shape)) {\n    if (value instanceof z.ZodOptional) {\n      // Make optional properties also nullable\n      newShape[key] = value._def.innerType.nullable().optional();\n    } else {\n      // Keep non-optional properties as they are\n      newShape[key] = value;\n    }\n  }\n\n  return z.object(newShape);\n}";
+
 // packages/typescript/src/lib/client.ts
 import { toLitObject } from "@sdk-it/core";
 
@@ -1639,7 +1643,7 @@ var PropEmitter = class {
     const defaultVal = !isRef4(schema) && schema.default !== void 0 ? ` default: ${JSON.stringify(schema.default)}` : "";
     const reqMark = required ? " required" : "";
     const summary = `- \`${name}\` ${rawType}${reqMark}${defaultVal}:`;
-    const detailLines = docs.slice(1).filter((l) => !l.startsWith("**Default:**")).map((l) => `  ${l}`);
+    const detailLines = docs.slice(1).filter((it) => !it.startsWith("**Default:**")).map((it) => `  ${it}`);
     return [summary, ...detailLines];
   }
   /**
@@ -1849,35 +1853,29 @@ var PropEmitter = class {
    * Process a request body and return markdown documentation
    */
   requestBody(requestBody) {
-    if (!requestBody) return [];
     const lines = [];
-    lines.push(`##### Request Body`);
-    if (requestBody.description) {
-      lines.push(requestBody.description);
-    }
-    if (requestBody.content) {
-      const contentEntries = Object.entries(requestBody.content);
-      if (contentEntries.length === 1) {
-        const [contentType, mediaType] = contentEntries[0];
-        lines.push(`**Content Type:** \`${contentType}\``);
+    lines.push(`#### Input`);
+    lines.push(requestBody.description || "");
+    const contentEntries = Object.entries(requestBody.content);
+    const multipleContentTypes = contentEntries.length > 1;
+    if (multipleContentTypes) {
+      for (const [contentType, mediaType] of contentEntries) {
+        lines.push(`<details>`);
+        lines.push(`<summary>Content Type: \`${contentType}\`</summary>`);
+        lines.push("");
         if (mediaType.schema) {
           const schemaDocs = this.handle(mediaType.schema);
-          lines.push(...schemaDocs);
-        }
-      } else {
-        for (const [contentType, mediaType] of contentEntries) {
-          lines.push(`<details>`);
-          lines.push(
-            `<summary><b>Content Type:</b> \`${contentType}\`</summary>`
-          );
-          lines.push("");
-          if (mediaType.schema) {
-            const schemaDocs = this.handle(mediaType.schema);
-            lines.push(...schemaDocs.map((l) => l));
-          }
-          lines.push("");
-          lines.push(`</details>`);
+          lines.push(...schemaDocs.map((l) => l));
         }
+        lines.push("");
+        lines.push(`</details>`);
+      }
+    } else {
+      const [contentType, mediaType] = contentEntries[0];
+      lines.push(`Content Type: \`${contentType}\``);
+      if (mediaType.schema) {
+        const schemaDocs = this.handle(mediaType.schema);
+        lines.push(...schemaDocs);
       }
     }
     return lines;
@@ -1915,37 +1913,49 @@ function toReadme(spec, generator) {
   forEachOperation2(spec, (entry, operation) => {
     const { method, path } = entry;
     markdown.push(
-      `#### ${operation["x-fn-name"]} | ${`_${method.toUpperCase()} ${path}_`}`
+      `### ${operation["x-fn-name"]} | ${`_${method.toUpperCase()} ${path}_`}`
     );
     markdown.push(operation.summary || "");
     const snippet = generator.snippet(entry, operation);
-    markdown.push(`##### Example usage`);
+    markdown.push(`#### Example usage`);
     markdown.push(snippet);
     const requestBodyContent = propEmitter.requestBody(operation.requestBody);
     if (requestBodyContent.length > 1) {
       markdown.push(requestBodyContent.join("\n\n"));
     }
-    markdown.push(`##### Responses`);
+    markdown.push(`#### Output`);
     for (const status in operation.responses) {
       const response = operation.responses[status];
-      markdown.push(`<details>`);
-      markdown.push(
-        `<summary><b>${status}</b>  <i>${response.description}</i></summary>`
-      );
       if (!isEmpty3(response.content)) {
-        for (const [contentType, mediaType] of Object.entries(
-          response.content
-        )) {
+        const contentEntries = Object.entries(response.content);
+        if (contentEntries.length === 1) {
+          const [contentType, mediaType] = contentEntries[0];
+          markdown.push(`**${status}** - ${response.description}`);
           markdown.push(`
 **Content Type:** \`${contentType}\``);
           if (mediaType.schema) {
             const schemaDocs = propEmitter.handle(mediaType.schema);
-            markdown.push(...schemaDocs.map((l) => `
+            markdown.push(...schemaDocs);
+          }
+        } else {
+          markdown.push(`<details>`);
+          markdown.push(
+            `<summary><b>${status}</b>  <i>${response.description}</i></summary>`
+          );
+          for (const [contentType, mediaType] of contentEntries) {
+            markdown.push(`
+**Content Type:** \`${contentType}\``);
+            if (mediaType.schema) {
+              const schemaDocs = propEmitter.handle(mediaType.schema);
+              markdown.push(...schemaDocs.map((l) => `
 ${l}`));
+            }
           }
+          markdown.push(`</details>`);
         }
+      } else {
+        markdown.push(`**${status}** - ${response.description}`);
       }
-      markdown.push(`</details>`);
     }
   });
   if (spec.components?.schemas) {
@@ -3070,6 +3080,12 @@ ${template2(dispatcher_default, {})({ throwError: !style.errorAsValue, outputTyp
     "models/index.ts": modelsIndex
     // ...(modelsImports.length ? { 'models/index.ts': modelsIndex } : {}),
   });
+  if (settings.agentTools) {
+    await settings.writer(output, {
+      "agents.ts": `${generateAgentTools(spec)}
+${utils_default}`
+    });
+  }
   await settings.writer(output, {
     "index.ts": await getFolderExports(
       output,
@@ -3228,9 +3244,44 @@ function toInputs(operationsSet, commonZod, makeImport) {
     ...inputs
   };
 }
+function generateAgentTools(spec) {
+  const groups = {};
+  forEachOperation4(spec, (entry, operation) => {
+    groups[entry.tag] ??= [];
+    groups[entry.tag].push(createTool(entry, operation));
+  });
+  const imports = [
+    `import { z } from 'zod';`,
+    `import { tool } from '@openai/agents';`,
+    `import * as schemas from './inputs/index.ts';`
+  ];
+  const tools = Object.entries(groups).map(([group, tools2]) => {
+    return `export const ${spinalcase3(group)} = [${tools2.join(", ")}];`;
+  });
+  return [...imports, ...tools].join("\n\n");
+}
+function createTool(entry, operation) {
+  const schemaName = camelcase4(`${operation.operationId} schema`);
+  return `tool({
+      description: \`${operation.description || operation.summary}\`,
+      name: '${operation["x-fn-name"]}',
+      parameters: makeOptionalPropsNullable(schemas.${schemaName}),
+			execute: async (input, maybeContext) => {
+				console.log('Executing ${operation.operationId} tool with input:', input);
+        const context = coerceContext(maybeContext?.context);
+        const client = context.client;
+        const response = await client.request(
+          '${entry.method.toUpperCase()} ${entry.path}' ,
+          input as any,
+        );
+        return JSON.stringify(response);
+      },
+    })`;
+}
 export {
   TypeScriptGenerator,
   generate,
+  generateAgentTools,
   toInputs
 };
 //# sourceMappingURL=index.js.map