specli 0.0.19 → 0.0.20

package/README.md

@@ -321,7 +321,7 @@ import { generateText } from "ai";
 const result = await generateText({
   model: yourModel,
   tools: {
-    api: specli({
+    api: await specli({
       spec: "https://api.example.com/openapi.json",
       bearerToken: process.env.API_TOKEN,
     }),
@@ -330,6 +330,8 @@ const result = await generateText({
 });
 ```
 
+The `specli()` function is async and fetches the OpenAPI spec upfront, so the returned tool is ready to use immediately without any additional network requests.
+
 The tool supports three commands:
 - `list` - Show available resources and actions
 - `help` - Get details about a specific action

package/dist/ai/tools.d.ts

@@ -11,7 +11,7 @@
  * const result = await generateText({
  *   model: yourModel,
  *   tools: {
- *     api: specli({ spec: "https://api.example.com/openapi.json" }),
+ *     api: await specli({ spec: "https://api.example.com/openapi.json" }),
  *   },
  *   prompt: "List all users",
  * });
@@ -38,8 +38,11 @@ export type SpecliToolOptions = {
 };
 /**
  * Create an AI SDK tool for interacting with an OpenAPI spec.
+ *
+ * The spec is fetched once when this function is called, so the returned
+ * tool already has the spec loaded and ready to use.
  */
-export declare function specli(options: SpecliToolOptions): import("ai").Tool<{
+export declare function specli(options: SpecliToolOptions): Promise<import("ai").Tool<{
     command: "list" | "exec" | "help";
     resource?: string | undefined;
     action?: string | undefined;
@@ -133,6 +136,4 @@ export declare function specli(options: SpecliToolOptions): import("ai").Tool<{
     summary?: undefined;
     args?: undefined;
     flags?: undefined;
-}>;
-/** Clear cached spec context */
-export declare function clearSpecliCache(spec?: string): void;
+}>>;

package/dist/ai/tools.js

@@ -11,7 +11,7 @@
  * const result = await generateText({
  *   model: yourModel,
  *   tools: {
- *     api: specli({ spec: "https://api.example.com/openapi.json" }),
+ *     api: await specli({ spec: "https://api.example.com/openapi.json" }),
  *   },
  *   prompt: "List all users",
  * });
@@ -21,25 +21,20 @@ import { tool } from "ai";
 import { z } from "zod";
 import { buildRuntimeContext } from "../cli/runtime/context.js";
 import { execute } from "../cli/runtime/execute.js";
-// Cache contexts to avoid reloading spec on every call
-const contextCache = new Map();
-async function getContext(spec) {
-    let ctx = contextCache.get(spec);
-    if (!ctx) {
-        ctx = await buildRuntimeContext({ spec });
-        contextCache.set(spec, ctx);
-    }
-    return ctx;
-}
 function findAction(ctx, resource, action) {
     const r = ctx.commands.resources.find((r) => r.resource.toLowerCase() === resource.toLowerCase());
     return r?.actions.find((a) => a.action.toLowerCase() === action.toLowerCase());
 }
 /**
  * Create an AI SDK tool for interacting with an OpenAPI spec.
+ *
+ * The spec is fetched once when this function is called, so the returned
+ * tool already has the spec loaded and ready to use.
  */
-export function specli(options) {
+export async function specli(options) {
     const { spec, server, serverVars, bearerToken, apiKey, basicAuth, authScheme, } = options;
+    // Fetch and parse the spec upfront
+    const ctx = await buildRuntimeContext({ spec });
     return tool({
         description: `Execute API operations. Commands: "list" (show resources/actions), "help" (action details), "exec" (call API).`,
         inputSchema: z.object({
@@ -56,7 +51,6 @@ export function specli(options) {
                 .describe("Named flags"),
         }),
         execute: async ({ command, resource, action, args, flags }) => {
-            const ctx = await getContext(spec);
             if (command === "list") {
                 return {
                     resources: ctx.commands.resources.map((r) => ({
@@ -152,10 +146,3 @@ export function specli(options) {
         },
     });
 }
-/** Clear cached spec context */
-export function clearSpecliCache(spec) {
-    if (spec)
-        contextCache.delete(spec);
-    else
-        contextCache.clear();
-}

package/dist/ai/tools.test.js

@@ -1,13 +1,13 @@
 import { describe, expect, test } from "bun:test";
-import { clearSpecliCache, specli } from "./tools.js";
+import { specli } from "./tools.js";
 const mockOptions = {
     toolCallId: "test-call-id",
     abortSignal: new AbortController().signal,
     messages: [],
 };
 describe("specli tool", () => {
-    test("creates a tool with correct structure", () => {
-        const tool = specli({
+    test("creates a tool with correct structure", async () => {
+        const tool = await specli({
             spec: "https://petstore3.swagger.io/api/v3/openapi.json",
         });
         expect(tool).toHaveProperty("description");
@@ -16,7 +16,7 @@ describe("specli tool", () => {
         expect(typeof tool.execute).toBe("function");
     });
     test("list command returns resources", async () => {
-        const tool = specli({
+        const tool = await specli({
             spec: "https://petstore3.swagger.io/api/v3/openapi.json",
         });
         const result = (await tool.execute?.({ command: "list" }, mockOptions));
@@ -24,7 +24,7 @@ describe("specli tool", () => {
         expect(Array.isArray(result.resources)).toBe(true);
     });
     test("help command returns action details", async () => {
-        const tool = specli({
+        const tool = await specli({
             spec: "https://petstore3.swagger.io/api/v3/openapi.json",
         });
         const result = (await tool.execute?.({ command: "help", resource: "pets", action: "get" }, mockOptions));
@@ -32,25 +32,18 @@ describe("specli tool", () => {
         expect(result.action).toBe("get");
     });
     test("help command with missing resource returns error", async () => {
-        const tool = specli({
+        const tool = await specli({
             spec: "https://petstore3.swagger.io/api/v3/openapi.json",
         });
         const result = (await tool.execute?.({ command: "help" }, mockOptions));
         expect(result).toHaveProperty("error");
     });
     test("exec command with missing args returns error", async () => {
-        const tool = specli({
+        const tool = await specli({
             spec: "https://petstore3.swagger.io/api/v3/openapi.json",
         });
         const result = (await tool.execute?.({ command: "exec", resource: "pets", action: "get" }, mockOptions));
         expect(result).toHaveProperty("error");
         expect(result.error).toContain("Missing args");
     });
-    test("clearCache works", async () => {
-        const spec = "https://petstore3.swagger.io/api/v3/openapi.json";
-        const tool = specli({ spec });
-        await tool.execute?.({ command: "list" }, mockOptions);
-        clearSpecliCache(spec);
-        clearSpecliCache();
-    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "specli",
-	"version": "0.0.19",
+	"version": "0.0.20",
 	"type": "module",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",