@spec2tools/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @spec2tools/sdk
+
+Create AI SDK tools from OpenAPI specifications.
+
+## Installation
+
+```bash
+npm install @spec2tools/sdk
+```
+
+## Usage
+
+```ts
+import { createTools } from '@spec2tools/sdk';
+import { generateText, stepCountIs } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+const tools = await createTools({ spec: './openapi.yaml' });
+
+const result = await generateText({
+  model: openai('gpt-4o'),
+  tools,
+  prompt: 'List all users',
+  stopWhen: stepCountIs(3)
+});
+
+console.log(result.text);
+```
+
+## API
+
+### `createTools(options: Spec2ToolsOptions): Promise<ToolSet>`
+
+Creates AI SDK-compatible tools from an OpenAPI specification.
+
+#### Options
+
+- `spec` (string, required): Path or URL to the OpenAPI specification file (JSON or YAML)
+
+#### Returns
+
+A `Promise` that resolves to an object of AI SDK tools.
+
+#### Throws
+
+- `Error` if the API requires authentication. For authenticated APIs, use the `@spec2tools/cli` package instead.
+
+## Notes
+
+- `createTools()` only works with APIs that don't require authentication
+- For authenticated APIs, use the CLI: `npx @spec2tools/cli start --spec ./openapi.yaml`
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createTools, type Spec2ToolsOptions } from './lib.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createTools } from './lib.js';
+//# sourceMappingURL=index.js.map

package/dist/lib.d.ts

@@ -0,0 +1,29 @@
+import { generateText } from 'ai';
+type ToolSet = NonNullable<Parameters<typeof generateText>[0]['tools']>;
+export interface Spec2ToolsOptions {
+    /** Path or URL to OpenAPI specification */
+    spec: string;
+}
+/**
+ * Create AI SDK tools from an OpenAPI specification.
+ *
+ * @example
+ * ```ts
+ * import { createTools } from '@spec2tools/sdk';
+ * import { generateText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const tools = await createTools({ spec: './openapi.yaml' });
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools,
+ *   prompt: 'List all users',
+ * });
+ * ```
+ *
+ * @throws Error if the API requires authentication
+ */
+export declare function createTools(options: Spec2ToolsOptions): Promise<ToolSet>;
+export {};
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.js

@@ -0,0 +1,97 @@
+import { tool } from 'ai';
+import { loadOpenAPISpec, extractBaseUrl, extractAuthConfig, parseOperations, AuthManager, ToolExecutionError, } from '@spec2tools/core';
+/**
+ * Create AI SDK tools from an OpenAPI specification.
+ *
+ * @example
+ * ```ts
+ * import { createTools } from '@spec2tools/sdk';
+ * import { generateText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const tools = await createTools({ spec: './openapi.yaml' });
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools,
+ *   prompt: 'List all users',
+ * });
+ * ```
+ *
+ * @throws Error if the API requires authentication
+ */
+export async function createTools(options) {
+    const spec = await loadOpenAPISpec(options.spec);
+    const baseUrl = extractBaseUrl(spec);
+    const authConfig = extractAuthConfig(spec);
+    // Check if auth is required
+    if (authConfig.type !== 'none') {
+        throw new Error(`This API requires authentication (${authConfig.type}). ` +
+            `The createTools() function only supports APIs without authentication. ` +
+            `Use the CLI for authenticated APIs: npx @spec2tools/cli start --spec ${options.spec}`);
+    }
+    const toolDefs = parseOperations(spec);
+    const authManager = new AuthManager(authConfig);
+    // Build AI SDK tools
+    const tools = {};
+    for (const toolDef of toolDefs) {
+        const { name, description, parameters, httpMethod, path } = toolDef;
+        tools[name] = tool({
+            description,
+            inputSchema: parameters,
+            execute: async (params) => {
+                // Build URL with path parameters
+                let url = `${baseUrl}${path}`;
+                const queryParams = {};
+                const bodyParams = {};
+                for (const [key, value] of Object.entries(params)) {
+                    if (value === undefined)
+                        continue;
+                    if (url.includes(`{${key}}`)) {
+                        // Path parameter
+                        url = url.replace(`{${key}}`, encodeURIComponent(String(value)));
+                    }
+                    else if (httpMethod === 'GET' || httpMethod === 'DELETE') {
+                        // Query parameter for GET/DELETE
+                        queryParams[key] = String(value);
+                    }
+                    else {
+                        // Body parameter for POST/PUT/PATCH
+                        bodyParams[key] = value;
+                    }
+                }
+                // Add query parameters
+                const queryString = new URLSearchParams(queryParams).toString();
+                if (queryString) {
+                    url += `?${queryString}`;
+                }
+                // Build request options
+                const fetchOptions = {
+                    method: httpMethod,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...authManager.getAuthHeaders(),
+                    },
+                };
+                // Add body for non-GET/DELETE requests
+                if (Object.keys(bodyParams).length > 0 &&
+                    httpMethod !== 'GET' &&
+                    httpMethod !== 'DELETE') {
+                    fetchOptions.body = JSON.stringify(bodyParams);
+                }
+                const response = await fetch(url, fetchOptions);
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    throw new ToolExecutionError(name, new Error(`HTTP ${response.status}: ${errorText}`));
+                }
+                const contentType = response.headers.get('content-type');
+                if (contentType?.includes('application/json')) {
+                    return await response.json();
+                }
+                return await response.text();
+            },
+        });
+    }
+    return tools;
+}
+//# sourceMappingURL=lib.js.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@spec2tools/sdk",
+  "version": "0.1.0",
+  "description": "Create AI SDK tools from OpenAPI specifications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "keywords": [
+    "openapi",
+    "ai",
+    "agent",
+    "tools",
+    "ai-sdk",
+    "vercel-ai"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CahidArda/spec2tools.git",
+    "directory": "packages/sdk"
+  },
+  "dependencies": {
+    "ai": "^6.0.68",
+    "zod": "^3.24.0",
+    "@spec2tools/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}