specli 0.0.19 → 0.0.21

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;
@@ -108,7 +111,7 @@ export declare function specli(options: SpecliToolOptions): import("ai").Tool<{
     }[];
     flags: {
         name: string;
-        type: import("../cli/schema-shape.js").ParamType;
+        type: import("../cli/parse/schema-shape.js").ParamType;
         required: boolean;
         description: 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/dist/cli/compile.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { deriveBinaryName } from "./derive-name.js";
+import { deriveBinaryName } from "./spec/derive-name.js";
 // Resolve the package root directory (at runtime this file is at dist/cli/compile.js)
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(__dirname, "../..");

package/dist/cli/main.js

@@ -19,13 +19,13 @@ function getPackageVersion() {
         return "0.0.0";
     }
 }
+import { stableStringify } from "./core/stable-json.js";
+import { toMinimalSchemaOutput } from "./model/schema.js";
 import { readStdinText } from "./runtime/compat.js";
 import { buildRuntimeContext } from "./runtime/context.js";
 import { addGeneratedCommands } from "./runtime/generated.js";
 import { deleteToken, getToken, setToken } from "./runtime/profile/secrets.js";
 import { readProfiles, upsertProfile, writeProfiles, } from "./runtime/profile/store.js";
-import { toMinimalSchemaOutput } from "./schema.js";
-import { stableStringify } from "./stable-json.js";
 export async function main(argv, options = {}) {
     const program = new Command();
     // Get version - use embedded version if available, otherwise read from package.json

package/dist/cli/{capabilities.d.ts → model/capabilities.d.ts}

@@ -1,7 +1,7 @@
-import type { AuthScheme, AuthSchemeKind } from "./auth-schemes.js";
+import type { NormalizedOperation, OpenApiDoc } from "../core/types.js";
+import type { AuthScheme, AuthSchemeKind } from "../parse/auth-schemes.js";
+import type { ServerInfo } from "../parse/servers.js";
 import type { CommandModel } from "./command-model.js";
-import type { ServerInfo } from "./server.js";
-import type { NormalizedOperation, OpenApiDoc } from "./types.js";
 export type Capabilities = {
     servers: {
         count: number;

package/dist/cli/{command-id.js → model/command-id.js}

@@ -1,4 +1,4 @@
-import { kebabCase } from "./strings.js";
+import { kebabCase } from "../core/strings.js";
 export function buildCommandId(parts) {
     // operationKey is the ultimate disambiguator, but we keep the id readable.
     // Example:

package/dist/cli/{command-model.d.ts → model/command-model.d.ts}

@@ -1,9 +1,10 @@
-import type { AuthSummary } from "./auth-requirements.js";
-import type { AuthScheme } from "./auth-schemes.js";
+import type { JsonSchema, SecurityRequirement } from "../core/types.js";
+import { type AuthSummary } from "../parse/auth-requirements.js";
+import type { AuthScheme } from "../parse/auth-schemes.js";
+import { type ParamSpec } from "../parse/params.js";
+import { type PositionalArg } from "../parse/positional.js";
+import { type RequestBodyInfo } from "../parse/request-body.js";
 import type { PlannedOperation } from "./naming.js";
-import type { ParamSpec } from "./params.js";
-import type { RequestBodyInfo } from "./request-body.js";
-import type { SecurityRequirement } from "./types.js";
 export type CommandAction = {
     id: string;
     key: string;
@@ -17,12 +18,12 @@ export type CommandAction = {
     description?: string;
     deprecated?: boolean;
     style: PlannedOperation["style"];
-    positionals: Array<import("./positional.js").PositionalArg>;
-    flags: Array<Pick<import("./params.js").ParamSpec, "in" | "name" | "flag" | "required" | "description" | "type" | "format" | "enum" | "itemType" | "itemFormat" | "itemEnum">>;
+    positionals: PositionalArg[];
+    flags: Array<Pick<ParamSpec, "in" | "name" | "flag" | "required" | "description" | "type" | "format" | "enum" | "itemType" | "itemFormat" | "itemEnum">>;
     params: ParamSpec[];
     auth: AuthSummary;
     requestBody?: RequestBodyInfo;
-    requestBodySchema?: import("./types.js").JsonSchema;
+    requestBodySchema?: JsonSchema;
 };
 export type CommandResource = {
     resource: string;

package/dist/cli/{command-model.js → model/command-model.js}

@@ -1,8 +1,8 @@
-import { summarizeAuth } from "./auth-requirements.js";
+import { summarizeAuth } from "../parse/auth-requirements.js";
+import { deriveParamSpecs } from "../parse/params.js";
+import { deriveFlags, derivePositionals, } from "../parse/positional.js";
+import { deriveRequestBodyInfo, } from "../parse/request-body.js";
 import { buildCommandId } from "./command-id.js";
-import { deriveParamSpecs } from "./params.js";
-import { deriveFlags, derivePositionals } from "./positional.js";
-import { deriveRequestBodyInfo } from "./request-body.js";
 export function buildCommandModel(planned, options) {
     const byResource = new Map();
     for (const op of planned) {

package/dist/cli/{naming.d.ts → model/naming.d.ts}

@@ -1,4 +1,4 @@
-import type { NormalizedOperation } from "./types.js";
+import type { NormalizedOperation } from "../core/types.js";
 export type PlannedOperation = NormalizedOperation & {
     resource: string;
     action: string;

package/dist/cli/{naming.js → model/naming.js}

@@ -1,5 +1,5 @@
-import { pluralize } from "./pluralize.js";
-import { kebabCase } from "./strings.js";
+import { pluralize } from "../core/pluralize.js";
+import { kebabCase } from "../core/strings.js";
 const GENERIC_TAGS = new Set(["default", "defaults", "api"]);
 function getPathSegments(path) {
     return path

package/dist/cli/{schema.d.ts → model/schema.d.ts}

@@ -1,9 +1,10 @@
-import type { AuthScheme } from "./auth-schemes.js";
+import type { LoadedSpec, NormalizedOperation } from "../core/types.js";
+import type { AuthScheme } from "../parse/auth-schemes.js";
+import type { ServerInfo } from "../parse/servers.js";
 import type { Capabilities } from "./capabilities.js";
+import type { CommandsIndex } from "./command-index.js";
 import type { CommandModel } from "./command-model.js";
 import type { PlannedOperation } from "./naming.js";
-import type { ServerInfo } from "./server.js";
-import type { LoadedSpec, NormalizedOperation } from "./types.js";
 export type SchemaOutput = {
     schemaVersion: 1;
     openapi: {
@@ -22,8 +23,8 @@ export type SchemaOutput = {
     operations: NormalizedOperation[];
     planned?: PlannedOperation[];
     commands?: CommandModel;
-    commandsIndex?: import("./command-index.js").CommandsIndex;
+    commandsIndex?: CommandsIndex;
 };
 export type MinimalSchemaOutput = Pick<SchemaOutput, "schemaVersion" | "openapi" | "spec" | "capabilities" | "commands">;
-export declare function buildSchemaOutput(loaded: LoadedSpec, operations: NormalizedOperation[], planned: PlannedOperation[] | undefined, servers: ServerInfo[], authSchemes: AuthScheme[], commands: CommandModel | undefined, commandsIndex: import("./command-index.js").CommandsIndex | undefined, capabilities: Capabilities): SchemaOutput;
+export declare function buildSchemaOutput(loaded: LoadedSpec, operations: NormalizedOperation[], planned: PlannedOperation[] | undefined, servers: ServerInfo[], authSchemes: AuthScheme[], commands: CommandModel | undefined, commandsIndex: CommandsIndex | undefined, capabilities: Capabilities): SchemaOutput;
 export declare function toMinimalSchemaOutput(output: SchemaOutput): MinimalSchemaOutput;

package/dist/cli/{auth-schemes.d.ts → parse/auth-schemes.d.ts}

@@ -1,4 +1,4 @@
-import type { OpenApiDoc } from "./types.js";
+import type { OpenApiDoc } from "../core/types.js";
 export type AuthSchemeKind = "http-bearer" | "http-basic" | "api-key" | "oauth2" | "openIdConnect" | "unknown";
 export type AuthScheme = {
     key: string;

package/dist/cli/{auth-schemes.js → parse/auth-schemes.js}

@@ -1,4 +1,4 @@
-import { kebabCase } from "./strings.js";
+import { kebabCase } from "../core/strings.js";
 function parseOAuthFlow(flow) {
     if (!flow)
         return undefined;

package/dist/cli/{operations.d.ts → parse/operations.d.ts}

@@ -1,2 +1,2 @@
-import type { NormalizedOperation, OpenApiDoc } from "./types.js";
+import type { NormalizedOperation, OpenApiDoc } from "../core/types.js";
 export declare function indexOperations(doc: OpenApiDoc): NormalizedOperation[];

package/dist/cli/{params.d.ts → parse/params.d.ts}

@@ -1,5 +1,6 @@
-import type { NormalizedOperation, NormalizedParameter } from "./types.js";
-export type ParamType = import("./schema-shape.js").ParamType;
+import type { JsonSchema, NormalizedOperation, NormalizedParameter } from "../core/types.js";
+import { type ParamType } from "./schema-shape.js";
+export type { ParamType };
 export type ParamSpec = {
     kind: "positional" | "flag";
     in: NormalizedParameter["in"];
@@ -13,6 +14,6 @@ export type ParamSpec = {
     itemType?: ParamType;
     itemFormat?: string;
     itemEnum?: string[];
-    schema?: import("./types.js").JsonSchema;
+    schema?: JsonSchema;
 };
 export declare function deriveParamSpecs(op: NormalizedOperation): ParamSpec[];

package/dist/cli/{params.js → parse/params.js}

@@ -1,5 +1,5 @@
+import { kebabCase } from "../core/strings.js";
 import { getSchemaEnumStrings, getSchemaFormat, getSchemaType, } from "./schema-shape.js";
-import { kebabCase } from "./strings.js";
 export function deriveParamSpecs(op) {
     const out = [];
     for (const p of op.parameters) {

package/dist/cli/{positional.d.ts → parse/positional.d.ts}

@@ -1,4 +1,4 @@
-import type { ParamSpec } from "./params.js";
+import type { ParamSpec, ParamType } from "./params.js";
 export type ActionShapeForCli = {
     pathArgs: string[];
     params: ParamSpec[];
@@ -7,12 +7,12 @@ export type PositionalArg = {
     name: string;
     required: boolean;
     description?: string;
-    type: import("./schema-shape.js").ParamType;
+    type: ParamType;
     format?: string;
     enum?: string[];
 };
 export type FlagsIndex = {
-    flags: Array<Pick<import("./params.js").ParamSpec, "in" | "name" | "flag" | "required" | "description" | "type" | "format" | "enum" | "itemType" | "itemFormat" | "itemEnum">>;
+    flags: Array<Pick<ParamSpec, "in" | "name" | "flag" | "required" | "description" | "type" | "format" | "enum" | "itemType" | "itemFormat" | "itemEnum">>;
 };
 export declare function derivePositionals(action: ActionShapeForCli): PositionalArg[];
 export declare function deriveFlags(action: ActionShapeForCli): FlagsIndex;

package/dist/cli/{request-body.d.ts → parse/request-body.d.ts}

@@ -1,8 +1,9 @@
-import type { JsonSchema, NormalizedOperation } from "./types.js";
+import type { JsonSchema, NormalizedOperation } from "../core/types.js";
+import { type ParamType } from "./schema-shape.js";
 export type RequestBodyContent = {
     contentType: string;
     required: boolean;
-    schemaType: import("./schema-shape.js").ParamType;
+    schemaType: ParamType;
     schemaFormat?: string;
     schemaEnum?: string[];
 };

package/dist/cli/{request-body.js → parse/request-body.js}

@@ -1,5 +1,5 @@
+import { isJsonSchema } from "../core/types.js";
 import { getSchemaEnumStrings, getSchemaFormat, getSchemaType, } from "./schema-shape.js";
-import { isJsonSchema } from "./types.js";
 function getRequestBody(op) {
     return op.requestBody;
 }

package/dist/cli/{server.d.ts → parse/servers.d.ts}

@@ -1,4 +1,4 @@
-import type { OpenApiDoc } from "./types.js";
+import type { OpenApiDoc } from "../core/types.js";
 export type ServerVariable = {
     name: string;
     default?: string;

package/dist/cli/{server.test.js → parse/servers.test.js}

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { listServers } from "./server.js";
+import { listServers } from "./servers.js";
 describe("listServers", () => {
     test("extracts server variables from template", () => {
         const doc = {

package/dist/cli/runtime/auth/resolve.d.ts

@@ -1,8 +1,9 @@
-import type { AuthScheme } from "../../auth-schemes.js";
+import type { AuthSummary } from "../../parse/auth-requirements.js";
+import type { AuthScheme } from "../../parse/auth-schemes.js";
 export type AuthInputs = {
     flagAuthScheme?: string;
     profileAuthScheme?: string;
     embeddedAuthScheme?: string;
     hasStoredToken?: boolean;
 };
-export declare function resolveAuthScheme(authSchemes: AuthScheme[], required: import("../../auth-requirements.js").AuthSummary, inputs: AuthInputs): string | undefined;
+export declare function resolveAuthScheme(authSchemes: AuthScheme[], required: AuthSummary, inputs: AuthInputs): string | undefined;

package/dist/cli/runtime/context.d.ts

@@ -3,13 +3,13 @@ export type BuildRuntimeContextOptions = {
     embeddedSpecText?: string;
 };
 export declare function buildRuntimeContext(options: BuildRuntimeContextOptions): Promise<{
-    loaded: import("../types.js").LoadedSpec;
-    operations: import("../types.js").NormalizedOperation[];
-    servers: import("../server.js").ServerInfo[];
-    authSchemes: import("../auth-schemes.js").AuthScheme[];
-    planned: import("../naming.js").PlannedOperation[];
-    commands: import("../command-model.js").CommandModel;
-    commandsIndex: import("../command-index.js").CommandsIndex;
-    capabilities: import("../capabilities.js").Capabilities;
-    schema: import("../schema.js").SchemaOutput;
+    loaded: import("../core/types.js").LoadedSpec;
+    operations: import("../core/types.js").NormalizedOperation[];
+    servers: import("../parse/servers.js").ServerInfo[];
+    authSchemes: import("../parse/auth-schemes.js").AuthScheme[];
+    planned: import("../model/naming.js").PlannedOperation[];
+    commands: import("../model/command-model.js").CommandModel;
+    commandsIndex: import("../model/command-index.js").CommandsIndex;
+    capabilities: import("../model/capabilities.js").Capabilities;
+    schema: import("../model/schema.js").SchemaOutput;
 }>;

package/dist/cli/runtime/context.js

@@ -1,12 +1,12 @@
-import { listAuthSchemes } from "../auth-schemes.js";
-import { deriveCapabilities } from "../capabilities.js";
-import { buildCommandsIndex } from "../command-index.js";
-import { buildCommandModel } from "../command-model.js";
-import { planOperations } from "../naming.js";
-import { indexOperations } from "../operations.js";
-import { buildSchemaOutput } from "../schema.js";
-import { listServers } from "../server.js";
-import { loadSpec } from "../spec-loader.js";
+import { deriveCapabilities } from "../model/capabilities.js";
+import { buildCommandsIndex } from "../model/command-index.js";
+import { buildCommandModel } from "../model/command-model.js";
+import { planOperations } from "../model/naming.js";
+import { buildSchemaOutput } from "../model/schema.js";
+import { listAuthSchemes } from "../parse/auth-schemes.js";
+import { indexOperations } from "../parse/operations.js";
+import { listServers } from "../parse/servers.js";
+import { loadSpec } from "../spec/loader.js";
 export async function buildRuntimeContext(options) {
     const loaded = await loadSpec({
         spec: options.spec,

package/dist/cli/runtime/execute.d.ts

@@ -1,13 +1,15 @@
-import type { CommandAction } from "../command-model.js";
+import type { CommandAction } from "../model/command-model.js";
+import type { AuthScheme } from "../parse/auth-schemes.js";
+import type { ServerInfo } from "../parse/servers.js";
 import type { BodyFlagDef } from "./body-flags.js";
-import { type EmbeddedDefaults } from "./request.js";
+import { type EmbeddedDefaults, type RuntimeGlobals } from "./request.js";
 export type ExecuteInput = {
     action: CommandAction;
     positionalValues: string[];
     flagValues: Record<string, unknown>;
-    globals: import("./request.js").RuntimeGlobals;
-    servers: import("../server.js").ServerInfo[];
-    authSchemes: import("../auth-schemes.js").AuthScheme[];
+    globals: RuntimeGlobals;
+    servers: ServerInfo[];
+    authSchemes: AuthScheme[];
     specId: string;
     embeddedDefaults?: EmbeddedDefaults;
     bodyFlagDefs?: BodyFlagDef[];

package/dist/cli/runtime/execute.js

@@ -1,4 +1,4 @@
-import { buildRequest } from "./request.js";
+import { buildRequest, } from "./request.js";
 /**
  * Format an error message with a help hint.
  */

package/dist/cli/runtime/generated.d.ts

@@ -1,7 +1,7 @@
 import { Command } from "commander";
-import type { AuthScheme } from "../auth-schemes.js";
-import type { CommandModel } from "../command-model.js";
-import type { ServerInfo } from "../server.js";
+import type { CommandModel } from "../model/command-model.js";
+import type { AuthScheme } from "../parse/auth-schemes.js";
+import type { ServerInfo } from "../parse/servers.js";
 import type { EmbeddedDefaults } from "./request.js";
 export type GeneratedCliContext = {
     servers: ServerInfo[];

package/dist/cli/runtime/request.d.ts

@@ -1,5 +1,6 @@
-import type { AuthScheme } from "../auth-schemes.js";
-import type { CommandAction } from "../command-model.js";
+import type { CommandAction } from "../model/command-model.js";
+import type { AuthScheme } from "../parse/auth-schemes.js";
+import type { ServerInfo } from "../parse/servers.js";
 export type RuntimeGlobals = {
     spec?: string;
     server?: string;
@@ -24,7 +25,7 @@ export type BuildRequestInput = {
     positionalValues: string[];
     flagValues: Record<string, unknown>;
     globals: RuntimeGlobals;
-    servers: import("../server.js").ServerInfo[];
+    servers: ServerInfo[];
     authSchemes: AuthScheme[];
     embeddedDefaults?: EmbeddedDefaults;
     bodyFlagDefs?: import("./body-flags.js").BodyFlagDef[];

package/dist/cli/runtime/server-url.d.ts

@@ -1,4 +1,4 @@
-import type { ServerInfo } from "../server.js";
+import type { ServerInfo } from "../parse/servers.js";
 export type ResolveServerInput = {
     serverOverride?: string;
     servers: ServerInfo[];

package/dist/cli/runtime/validate/coerce.d.ts

@@ -1,3 +1,3 @@
-import type { ParamType } from "../../schema-shape.js";
+import type { ParamType } from "../../parse/schema-shape.js";
 export declare function coerceValue(raw: string, type: ParamType): unknown;
 export declare function coerceArrayInput(raw: string, itemType: ParamType): unknown[];

package/dist/cli/runtime/validate/schema.d.ts

@@ -1,5 +1,5 @@
-import type { CommandAction } from "../../command-model.js";
-import type { JsonSchema } from "../../types.js";
+import type { JsonSchema } from "../../core/types.js";
+import type { CommandAction } from "../../model/command-model.js";
 export type ValidationSchemas = {
     querySchema?: JsonSchema;
     headerSchema?: JsonSchema;

package/dist/cli/{spec-id.d.ts → spec/id.d.ts}

@@ -1,2 +1,2 @@
-import type { LoadedSpec } from "./types.js";
+import type { LoadedSpec } from "../core/types.js";
 export declare function getSpecId(loaded: Pick<LoadedSpec, "doc" | "fingerprint">): string;

package/dist/cli/{spec-id.js → spec/id.js}

@@ -1,4 +1,4 @@
-import { kebabCase } from "./strings.js";
+import { kebabCase } from "../core/strings.js";
 export function getSpecId(loaded) {
     const title = loaded.doc.info?.title;
     const fromTitle = title ? kebabCase(title) : "";

package/dist/cli/{spec-loader.d.ts → spec/loader.d.ts}

@@ -1,4 +1,4 @@
-import type { LoadedSpec } from "./types.js";
+import type { LoadedSpec } from "../core/types.js";
 export type LoadSpecOptions = {
     spec?: string;
     embeddedSpecText?: string;

package/dist/cli/{spec-loader.js → spec/loader.js}

@@ -1,8 +1,8 @@
 import SwaggerParser from "@apidevtools/swagger-parser";
-import { sha256Hex } from "./crypto.js";
-import { parseYamlContent } from "./runtime/compat.js";
-import { getSpecId } from "./spec-id.js";
-import { stableStringify } from "./stable-json.js";
+import { sha256Hex } from "../core/crypto.js";
+import { stableStringify } from "../core/stable-json.js";
+import { parseYamlContent } from "../runtime/compat.js";
+import { getSpecId } from "./id.js";
 function isProbablyUrl(input) {
     return /^https?:\/\//i.test(input);
 }

package/package.json

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

package/dist/compiled.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-export {};

package/dist/compiled.js

@@ -1,21 +0,0 @@
-#!/usr/bin/env bun
-import { main } from "./cli/main.js";
-import { env, envRequired } from "./macros/env.js" with { type: "macro" };
-import { loadSpec } from "./macros/spec.js" with { type: "macro" };
-import { version } from "./macros/version.js" with { type: "macro" };
-// This entrypoint is intended to be compiled.
-// All values are embedded via Bun macros at bundle-time.
-const embeddedSpecText = await loadSpec(envRequired("SPECLI_SPEC"));
-const cliName = env("SPECLI_NAME");
-const server = env("SPECLI_SERVER");
-const serverVars = env("SPECLI_SERVER_VARS");
-const auth = env("SPECLI_AUTH");
-const embeddedVersion = version();
-await main(process.argv, {
-    embeddedSpecText,
-    cliName,
-    server,
-    serverVars: serverVars ? serverVars.split(",") : undefined,
-    auth,
-    version: embeddedVersion,
-});

package/dist/macros/env.d.ts

@@ -1,10 +0,0 @@
-/**
- * Bun macro: reads an environment variable at bundle-time.
- * Returns undefined if the env var is not set.
- */
-export declare function env(name: string): string | undefined;
-/**
- * Bun macro: reads a required environment variable at bundle-time.
- * Throws if the env var is not set.
- */
-export declare function envRequired(name: string): string;

package/dist/macros/env.js

@@ -1,22 +0,0 @@
-/**
- * Bun macro: reads an environment variable at bundle-time.
- * Returns undefined if the env var is not set.
- */
-export function env(name) {
-    if (!name)
-        throw new Error("env macro: missing variable name");
-    return process.env[name];
-}
-/**
- * Bun macro: reads a required environment variable at bundle-time.
- * Throws if the env var is not set.
- */
-export function envRequired(name) {
-    if (!name)
-        throw new Error("envRequired macro: missing variable name");
-    const value = process.env[name];
-    if (value === undefined) {
-        throw new Error(`Missing required env var: ${name}`);
-    }
-    return value;
-}

package/dist/macros/spec.d.ts

@@ -1,5 +0,0 @@
-/**
- * Bun macro: loads an OpenAPI spec from a URL or file path at bundle-time.
- * The spec text is inlined into the bundle.
- */
-export declare function loadSpec(spec: string): Promise<string>;

package/dist/macros/spec.js

@@ -1,16 +0,0 @@
-/**
- * Bun macro: loads an OpenAPI spec from a URL or file path at bundle-time.
- * The spec text is inlined into the bundle.
- */
-export async function loadSpec(spec) {
-    if (!spec)
-        throw new Error("loadSpec macro: missing spec path/URL");
-    if (/^https?:\/\//i.test(spec)) {
-        const res = await fetch(spec);
-        if (!res.ok) {
-            throw new Error(`Failed to fetch spec: ${res.status} ${res.statusText}`);
-        }
-        return await res.text();
-    }
-    return await Bun.file(spec).text();
-}

package/dist/macros/version.d.ts

@@ -1,4 +0,0 @@
-/**
- * Bun macro: reads the version from package.json at bundle-time.
- */
-export declare function version(): string;

package/dist/macros/version.js

@@ -1,13 +0,0 @@
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-/**
- * Bun macro: reads the version from package.json at bundle-time.
- */
-export function version() {
-    const currentDir = dirname(fileURLToPath(import.meta.url));
-    const packageJsonPath = join(currentDir, "../../package.json");
-    const content = readFileSync(packageJsonPath, "utf-8");
-    const packageJson = JSON.parse(content);
-    return packageJson.version;
-}