@executor-js/plugin-openapi 1.5.3 → 1.5.4

package/dist/sdk/preview.d.ts

@@ -0,0 +1,269 @@
+import { Effect, Option } from "effect";
+import { Schema } from "effect";
+export declare const OAuth2AuthorizationCodeFlow: Schema.Struct<{
+    readonly authorizationUrl: Schema.String;
+    readonly tokenUrl: Schema.String;
+    readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+    readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+}>;
+export type OAuth2AuthorizationCodeFlow = typeof OAuth2AuthorizationCodeFlow.Type;
+export declare const OAuth2ClientCredentialsFlow: Schema.Struct<{
+    readonly tokenUrl: Schema.String;
+    readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+    readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+}>;
+export type OAuth2ClientCredentialsFlow = typeof OAuth2ClientCredentialsFlow.Type;
+export declare const OAuth2Flows: Schema.Struct<{
+    readonly authorizationCode: Schema.OptionFromOptional<Schema.Struct<{
+        readonly authorizationUrl: Schema.String;
+        readonly tokenUrl: Schema.String;
+        readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+        readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+    }>>;
+    readonly clientCredentials: Schema.OptionFromOptional<Schema.Struct<{
+        readonly tokenUrl: Schema.String;
+        readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+        readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+    }>>;
+}>;
+export type OAuth2Flows = typeof OAuth2Flows.Type;
+export declare const SecurityScheme: Schema.Struct<{
+    /** Key name in components.securitySchemes (e.g. "api_token") */
+    readonly name: Schema.String;
+    /** OpenAPI security scheme type */
+    readonly type: Schema.Literals<readonly ["http", "apiKey", "oauth2", "openIdConnect"]>;
+    /** For type: "http" — e.g. "bearer", "basic" */
+    readonly scheme: Schema.OptionFromOptional<Schema.String>;
+    /** For type: "http" with scheme "bearer" — e.g. "JWT" */
+    readonly bearerFormat: Schema.OptionFromOptional<Schema.String>;
+    /** For type: "apiKey" — where the key goes */
+    readonly in: Schema.OptionFromOptional<Schema.Literals<readonly ["header", "query", "cookie"]>>;
+    /** For type: "apiKey" — the header/query/cookie name */
+    readonly headerName: Schema.OptionFromOptional<Schema.String>;
+    readonly description: Schema.OptionFromOptional<Schema.String>;
+    /** For type: "oauth2" — declared flows (authorizationCode / clientCredentials only; implicit and password are deprecated). */
+    readonly flows: Schema.OptionFromOptional<Schema.Struct<{
+        readonly authorizationCode: Schema.OptionFromOptional<Schema.Struct<{
+            readonly authorizationUrl: Schema.String;
+            readonly tokenUrl: Schema.String;
+            readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+            readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+        }>>;
+        readonly clientCredentials: Schema.OptionFromOptional<Schema.Struct<{
+            readonly tokenUrl: Schema.String;
+            readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+            readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+        }>>;
+    }>>;
+    /** For type: "openIdConnect" — the discovery URL. */
+    readonly openIdConnectUrl: Schema.OptionFromOptional<Schema.String>;
+}>;
+export type SecurityScheme = typeof SecurityScheme.Type;
+export declare const AuthStrategy: Schema.Struct<{
+    /** The security schemes required together for this strategy */
+    readonly schemes: Schema.$Array<Schema.String>;
+}>;
+export type AuthStrategy = typeof AuthStrategy.Type;
+export declare const HeaderPreset: Schema.Struct<{
+    /** Human-readable label for the UI (e.g. "Bearer Token", "API Key + Email") */
+    readonly label: Schema.String;
+    /** Headers this strategy needs. Value is null when the user must provide it. */
+    readonly headers: Schema.$Record<Schema.String, Schema.NullOr<Schema.String>>;
+    /** Which headers should be stored as secrets */
+    readonly secretHeaders: Schema.$Array<Schema.String>;
+}>;
+export type HeaderPreset = typeof HeaderPreset.Type;
+export declare const OAuth2Preset: Schema.Struct<{
+    /** Human-readable label for the UI (e.g. "OAuth2 (Authorization Code) — oauth_app") */
+    readonly label: Schema.String;
+    /** The source security scheme this preset came from (components.securitySchemes key). */
+    readonly securitySchemeName: Schema.String;
+    /** Which OAuth2 flow this preset uses. */
+    readonly flow: Schema.Literals<readonly ["authorizationCode", "clientCredentials"]>;
+    /** For authorizationCode: user-agent redirect URL (from the spec). */
+    readonly authorizationUrl: Schema.OptionFromOptional<Schema.String>;
+    /** Token endpoint to exchange the code / refresh. */
+    readonly tokenUrl: Schema.String;
+    /** Optional refresh endpoint if the spec declares one separately. */
+    readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+    /** Declared scopes for this flow: `{ scope: description }`. */
+    readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+    /** Identity scopes to request alongside API scopes. `"auto"` discovers standard OIDC scopes. */
+    readonly identityScopes: Schema.Union<readonly [Schema.Literal<"auto">, Schema.Literal<false>, Schema.$Array<Schema.String>]>;
+}>;
+export type OAuth2Preset = typeof OAuth2Preset.Type;
+export declare const PreviewOperation: Schema.Struct<{
+    readonly operationId: Schema.String;
+    readonly method: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+    readonly path: Schema.String;
+    readonly summary: Schema.OptionFromOptional<Schema.String>;
+    readonly tags: Schema.$Array<Schema.String>;
+    readonly deprecated: Schema.Boolean;
+}>;
+export type PreviewOperation = typeof PreviewOperation.Type;
+export declare const SpecPreview: Schema.Struct<{
+    readonly title: Schema.OptionFromOptional<Schema.String>;
+    readonly version: Schema.OptionFromOptional<Schema.String>;
+    /** Reuses ServerInfo from extraction */
+    readonly servers: Schema.$Array<Schema.Struct<{
+        readonly url: Schema.String;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+        readonly variables: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+            readonly default: Schema.String;
+            readonly enum: Schema.OptionFromOptional<Schema.$Array<Schema.String>>;
+            readonly description: Schema.OptionFromOptional<Schema.String>;
+        }>>>;
+    }>>;
+    readonly operationCount: Schema.Number;
+    /** Lightweight operation list for the add-source UI */
+    readonly operations: Schema.$Array<Schema.Struct<{
+        readonly operationId: Schema.String;
+        readonly method: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+        readonly path: Schema.String;
+        readonly summary: Schema.OptionFromOptional<Schema.String>;
+        readonly tags: Schema.$Array<Schema.String>;
+        readonly deprecated: Schema.Boolean;
+    }>>;
+    readonly tags: Schema.$Array<Schema.String>;
+    readonly securitySchemes: Schema.$Array<Schema.Struct<{
+        /** Key name in components.securitySchemes (e.g. "api_token") */
+        readonly name: Schema.String;
+        /** OpenAPI security scheme type */
+        readonly type: Schema.Literals<readonly ["http", "apiKey", "oauth2", "openIdConnect"]>;
+        /** For type: "http" — e.g. "bearer", "basic" */
+        readonly scheme: Schema.OptionFromOptional<Schema.String>;
+        /** For type: "http" with scheme "bearer" — e.g. "JWT" */
+        readonly bearerFormat: Schema.OptionFromOptional<Schema.String>;
+        /** For type: "apiKey" — where the key goes */
+        readonly in: Schema.OptionFromOptional<Schema.Literals<readonly ["header", "query", "cookie"]>>;
+        /** For type: "apiKey" — the header/query/cookie name */
+        readonly headerName: Schema.OptionFromOptional<Schema.String>;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+        /** For type: "oauth2" — declared flows (authorizationCode / clientCredentials only; implicit and password are deprecated). */
+        readonly flows: Schema.OptionFromOptional<Schema.Struct<{
+            readonly authorizationCode: Schema.OptionFromOptional<Schema.Struct<{
+                readonly authorizationUrl: Schema.String;
+                readonly tokenUrl: Schema.String;
+                readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+                readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+            }>>;
+            readonly clientCredentials: Schema.OptionFromOptional<Schema.Struct<{
+                readonly tokenUrl: Schema.String;
+                readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+                readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+            }>>;
+        }>>;
+        /** For type: "openIdConnect" — the discovery URL. */
+        readonly openIdConnectUrl: Schema.OptionFromOptional<Schema.String>;
+    }>>;
+    /** Valid auth strategies (each is a set of schemes used together) */
+    readonly authStrategies: Schema.$Array<Schema.Struct<{
+        /** The security schemes required together for this strategy */
+        readonly schemes: Schema.$Array<Schema.String>;
+    }>>;
+    /** Pre-built header presets derived from auth strategies */
+    readonly headerPresets: Schema.$Array<Schema.Struct<{
+        /** Human-readable label for the UI (e.g. "Bearer Token", "API Key + Email") */
+        readonly label: Schema.String;
+        /** Headers this strategy needs. Value is null when the user must provide it. */
+        readonly headers: Schema.$Record<Schema.String, Schema.NullOr<Schema.String>>;
+        /** Which headers should be stored as secrets */
+        readonly secretHeaders: Schema.$Array<Schema.String>;
+    }>>;
+    /** OAuth2 presets — one per (oauth2 scheme × supported flow) combination */
+    readonly oauth2Presets: Schema.$Array<Schema.Struct<{
+        /** Human-readable label for the UI (e.g. "OAuth2 (Authorization Code) — oauth_app") */
+        readonly label: Schema.String;
+        /** The source security scheme this preset came from (components.securitySchemes key). */
+        readonly securitySchemeName: Schema.String;
+        /** Which OAuth2 flow this preset uses. */
+        readonly flow: Schema.Literals<readonly ["authorizationCode", "clientCredentials"]>;
+        /** For authorizationCode: user-agent redirect URL (from the spec). */
+        readonly authorizationUrl: Schema.OptionFromOptional<Schema.String>;
+        /** Token endpoint to exchange the code / refresh. */
+        readonly tokenUrl: Schema.String;
+        /** Optional refresh endpoint if the spec declares one separately. */
+        readonly refreshUrl: Schema.OptionFromOptional<Schema.String>;
+        /** Declared scopes for this flow: `{ scope: description }`. */
+        readonly scopes: Schema.$Record<Schema.String, Schema.String>;
+        /** Identity scopes to request alongside API scopes. `"auto"` discovers standard OIDC scopes. */
+        readonly identityScopes: Schema.Union<readonly [Schema.Literal<"auto">, Schema.Literal<false>, Schema.$Array<Schema.String>]>;
+    }>>;
+}>;
+export type SpecPreview = typeof SpecPreview.Type;
+/** Preview an OpenAPI spec — extract metadata without registering anything.
+ *  Accepts either a URL or raw JSON/YAML text. */
+export declare const previewSpec: (input: string) => Effect.Effect<{
+    readonly version: Option.Option<string>;
+    readonly operations: readonly {
+        readonly method: "post" | "options" | "delete" | "get" | "put" | "patch" | "head" | "trace";
+        readonly deprecated: boolean;
+        readonly path: string;
+        readonly summary: Option.Option<string>;
+        readonly tags: readonly string[];
+        readonly operationId: string;
+    }[];
+    readonly title: Option.Option<string>;
+    readonly tags: readonly string[];
+    readonly servers: readonly {
+        readonly description: Option.Option<string>;
+        readonly url: string;
+        readonly variables: Option.Option<{
+            readonly [x: string]: {
+                readonly default: string;
+                readonly description: Option.Option<string>;
+                readonly enum: Option.Option<readonly string[]>;
+            };
+        }>;
+    }[];
+    readonly securitySchemes: readonly {
+        readonly name: string;
+        readonly type: "oauth2" | "http" | "apiKey" | "openIdConnect";
+        readonly in: Option.Option<"header" | "query" | "cookie">;
+        readonly description: Option.Option<string>;
+        readonly scheme: Option.Option<string>;
+        readonly bearerFormat: Option.Option<string>;
+        readonly headerName: Option.Option<string>;
+        readonly flows: Option.Option<{
+            readonly authorizationCode: Option.Option<{
+                readonly authorizationUrl: string;
+                readonly tokenUrl: string;
+                readonly scopes: {
+                    readonly [x: string]: string;
+                };
+                readonly refreshUrl: Option.Option<string>;
+            }>;
+            readonly clientCredentials: Option.Option<{
+                readonly tokenUrl: string;
+                readonly scopes: {
+                    readonly [x: string]: string;
+                };
+                readonly refreshUrl: Option.Option<string>;
+            }>;
+        }>;
+        readonly openIdConnectUrl: Option.Option<string>;
+    }[];
+    readonly authStrategies: readonly {
+        readonly schemes: readonly string[];
+    }[];
+    readonly headerPresets: readonly {
+        readonly label: string;
+        readonly headers: {
+            readonly [x: string]: string | null;
+        };
+        readonly secretHeaders: readonly string[];
+    }[];
+    readonly oauth2Presets: readonly {
+        readonly label: string;
+        readonly authorizationUrl: Option.Option<string>;
+        readonly tokenUrl: string;
+        readonly scopes: {
+            readonly [x: string]: string;
+        };
+        readonly refreshUrl: Option.Option<string>;
+        readonly flow: "authorizationCode" | "clientCredentials";
+        readonly identityScopes: false | "auto" | readonly string[];
+        readonly securitySchemeName: string;
+    }[];
+    readonly operationCount: number;
+}, import("./errors").OpenApiParseError | import("./errors").OpenApiExtractionError, import("effect/unstable/http/HttpClient").HttpClient>;

package/dist/sdk/query-serialization.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sdk/real-specs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sdk/store.d.ts

@@ -0,0 +1,21 @@
+import { Effect } from "effect";
+import { type StorageDeps, type StorageFailure } from "@executor-js/sdk/core";
+import { OperationBinding } from "./types";
+export interface StoredOperation {
+    /** The integration slug this operation belongs to. */
+    readonly integration: string;
+    /** The tool name (the `<tool>` address segment) this operation backs. */
+    readonly toolName: string;
+    readonly binding: OperationBinding;
+}
+export interface OpenapiStore {
+    /** Replace all stored operations for an integration. */
+    readonly putOperations: (integration: string, operations: readonly StoredOperation[]) => Effect.Effect<void, StorageFailure>;
+    /** Look up one operation by integration + tool name. */
+    readonly getOperation: (integration: string, toolName: string) => Effect.Effect<StoredOperation | null, StorageFailure>;
+    /** List every stored operation for an integration. */
+    readonly listOperations: (integration: string) => Effect.Effect<readonly StoredOperation[], StorageFailure>;
+    /** Drop all stored operations for an integration. */
+    readonly removeOperations: (integration: string) => Effect.Effect<void, StorageFailure>;
+}
+export declare const makeDefaultOpenapiStore: ({ pluginStorage }: StorageDeps) => OpenapiStore;

package/dist/sdk/types.d.ts

@@ -0,0 +1,252 @@
+import { Schema } from "effect";
+import type { AuthTemplateSlug } from "@executor-js/sdk/shared";
+import type { OAuthAuthentication } from "@executor-js/sdk/shared";
+export type AuthenticationVariable = {
+    readonly type: "variable";
+    readonly name: string;
+};
+/** A literal string, or a parts-array mixing literals and variable refs. */
+export type AuthenticationTemplateValue = string | readonly (string | AuthenticationVariable)[];
+export declare const variable: (name: string) => AuthenticationVariable;
+/** The variable name the resolved credential value renders into. */
+export declare const TOKEN_VARIABLE: "token";
+export type APIKeyAuthentication = {
+    readonly slug: AuthTemplateSlug;
+    readonly type: "apiKey";
+    readonly headers?: Record<string, AuthenticationTemplateValue>;
+    readonly queryParams?: Record<string, AuthenticationTemplateValue>;
+};
+export type Authentication = OAuthAuthentication | APIKeyAuthentication;
+export declare const OperationId: Schema.brand<Schema.String, "OperationId">;
+export type OperationId = typeof OperationId.Type;
+export declare const HttpMethod: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+export type HttpMethod = typeof HttpMethod.Type;
+export declare const ParameterLocation: Schema.Literals<readonly ["path", "query", "header", "cookie"]>;
+export type ParameterLocation = typeof ParameterLocation.Type;
+export declare const OperationParameter: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly location: Schema.Literals<readonly ["path", "query", "header", "cookie"]>;
+    readonly required: Schema.Boolean;
+    readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+    readonly style: Schema.OptionFromOptional<Schema.String>;
+    readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+    readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+    readonly description: Schema.OptionFromOptional<Schema.String>;
+}>;
+export type OperationParameter = typeof OperationParameter.Type;
+/**
+ * OpenAPI 3.x `Encoding Object` (§4.8.15). Declared per-property inside a
+ * multipart/form-data or application/x-www-form-urlencoded request body.
+ *
+ * - `contentType` — for multipart, overrides the per-part `Content-Type`
+ *   header (e.g. `application/json` for a JSON-encoded metadata part).
+ * - `style` / `explode` / `allowReserved` — for form-urlencoded, control
+ *   array / object serialization the same way parameter-level style does.
+ */
+export declare const EncodingObject: Schema.Struct<{
+    readonly contentType: Schema.OptionFromOptional<Schema.String>;
+    readonly style: Schema.OptionFromOptional<Schema.String>;
+    readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+    readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+}>;
+export type EncodingObject = typeof EncodingObject.Type;
+export declare const MediaBinding: Schema.Struct<{
+    readonly contentType: Schema.String;
+    readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+    readonly encoding: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly contentType: Schema.OptionFromOptional<Schema.String>;
+        readonly style: Schema.OptionFromOptional<Schema.String>;
+        readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+        readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+    }>>>;
+}>;
+export type MediaBinding = typeof MediaBinding.Type;
+export declare const OperationRequestBody: Schema.Struct<{
+    readonly required: Schema.Boolean;
+    /** Default media type — first declared in spec order (not JSON-first).
+     *  Used when the caller does not override via the tool's `contentType` arg. */
+    readonly contentType: Schema.String;
+    /** Schema of the default media type. Kept for backward compat with stored
+     *  bindings from before `contents` was added. */
+    readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+    /** All declared media types in spec order. Populated by `extract.ts`
+     *  going forward; older persisted bindings may have this unset and will
+     *  fall back to `{contentType, schema}`. */
+    readonly contents: Schema.OptionFromOptional<Schema.$Array<Schema.Struct<{
+        readonly contentType: Schema.String;
+        readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+        readonly encoding: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+            readonly contentType: Schema.OptionFromOptional<Schema.String>;
+            readonly style: Schema.OptionFromOptional<Schema.String>;
+            readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+            readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+        }>>>;
+    }>>>;
+}>;
+export type OperationRequestBody = typeof OperationRequestBody.Type;
+export declare const ExtractedOperation: Schema.Struct<{
+    readonly operationId: Schema.brand<Schema.String, "OperationId">;
+    readonly toolPath: Schema.OptionFromOptional<Schema.String>;
+    readonly method: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+    readonly baseUrl: Schema.optional<Schema.String>;
+    readonly pathTemplate: Schema.String;
+    readonly summary: Schema.OptionFromOptional<Schema.String>;
+    readonly description: Schema.OptionFromOptional<Schema.String>;
+    readonly tags: Schema.$Array<Schema.String>;
+    readonly parameters: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly location: Schema.Literals<readonly ["path", "query", "header", "cookie"]>;
+        readonly required: Schema.Boolean;
+        readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+        readonly style: Schema.OptionFromOptional<Schema.String>;
+        readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+        readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+    }>>;
+    readonly requestBody: Schema.OptionFromOptional<Schema.Struct<{
+        readonly required: Schema.Boolean;
+        /** Default media type — first declared in spec order (not JSON-first).
+         *  Used when the caller does not override via the tool's `contentType` arg. */
+        readonly contentType: Schema.String;
+        /** Schema of the default media type. Kept for backward compat with stored
+         *  bindings from before `contents` was added. */
+        readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+        /** All declared media types in spec order. Populated by `extract.ts`
+         *  going forward; older persisted bindings may have this unset and will
+         *  fall back to `{contentType, schema}`. */
+        readonly contents: Schema.OptionFromOptional<Schema.$Array<Schema.Struct<{
+            readonly contentType: Schema.String;
+            readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+            readonly encoding: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+                readonly contentType: Schema.OptionFromOptional<Schema.String>;
+                readonly style: Schema.OptionFromOptional<Schema.String>;
+                readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+                readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+            }>>>;
+        }>>>;
+    }>>;
+    readonly inputSchema: Schema.OptionFromOptional<Schema.Unknown>;
+    readonly outputSchema: Schema.OptionFromOptional<Schema.Unknown>;
+    readonly deprecated: Schema.Boolean;
+}>;
+export type ExtractedOperation = typeof ExtractedOperation.Type;
+export declare const ServerVariable: Schema.Struct<{
+    readonly default: Schema.String;
+    readonly enum: Schema.OptionFromOptional<Schema.$Array<Schema.String>>;
+    readonly description: Schema.OptionFromOptional<Schema.String>;
+}>;
+export type ServerVariable = typeof ServerVariable.Type;
+export declare const ServerInfo: Schema.Struct<{
+    readonly url: Schema.String;
+    readonly description: Schema.OptionFromOptional<Schema.String>;
+    readonly variables: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly default: Schema.String;
+        readonly enum: Schema.OptionFromOptional<Schema.$Array<Schema.String>>;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+    }>>>;
+}>;
+export type ServerInfo = typeof ServerInfo.Type;
+export declare const ExtractionResult: Schema.Struct<{
+    readonly title: Schema.OptionFromOptional<Schema.String>;
+    readonly version: Schema.OptionFromOptional<Schema.String>;
+    readonly servers: Schema.$Array<Schema.Struct<{
+        readonly url: Schema.String;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+        readonly variables: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+            readonly default: Schema.String;
+            readonly enum: Schema.OptionFromOptional<Schema.$Array<Schema.String>>;
+            readonly description: Schema.OptionFromOptional<Schema.String>;
+        }>>>;
+    }>>;
+    readonly operations: Schema.$Array<Schema.Struct<{
+        readonly operationId: Schema.brand<Schema.String, "OperationId">;
+        readonly toolPath: Schema.OptionFromOptional<Schema.String>;
+        readonly method: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+        readonly baseUrl: Schema.optional<Schema.String>;
+        readonly pathTemplate: Schema.String;
+        readonly summary: Schema.OptionFromOptional<Schema.String>;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+        readonly tags: Schema.$Array<Schema.String>;
+        readonly parameters: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly location: Schema.Literals<readonly ["path", "query", "header", "cookie"]>;
+            readonly required: Schema.Boolean;
+            readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+            readonly style: Schema.OptionFromOptional<Schema.String>;
+            readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+            readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+            readonly description: Schema.OptionFromOptional<Schema.String>;
+        }>>;
+        readonly requestBody: Schema.OptionFromOptional<Schema.Struct<{
+            readonly required: Schema.Boolean;
+            /** Default media type — first declared in spec order (not JSON-first).
+             *  Used when the caller does not override via the tool's `contentType` arg. */
+            readonly contentType: Schema.String;
+            /** Schema of the default media type. Kept for backward compat with stored
+             *  bindings from before `contents` was added. */
+            readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+            /** All declared media types in spec order. Populated by `extract.ts`
+             *  going forward; older persisted bindings may have this unset and will
+             *  fall back to `{contentType, schema}`. */
+            readonly contents: Schema.OptionFromOptional<Schema.$Array<Schema.Struct<{
+                readonly contentType: Schema.String;
+                readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+                readonly encoding: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+                    readonly contentType: Schema.OptionFromOptional<Schema.String>;
+                    readonly style: Schema.OptionFromOptional<Schema.String>;
+                    readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+                    readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+                }>>>;
+            }>>>;
+        }>>;
+        readonly inputSchema: Schema.OptionFromOptional<Schema.Unknown>;
+        readonly outputSchema: Schema.OptionFromOptional<Schema.Unknown>;
+        readonly deprecated: Schema.Boolean;
+    }>>;
+}>;
+export type ExtractionResult = typeof ExtractionResult.Type;
+export declare const OperationBinding: Schema.Struct<{
+    readonly method: Schema.Literals<readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"]>;
+    readonly baseUrl: Schema.optional<Schema.String>;
+    readonly pathTemplate: Schema.String;
+    readonly parameters: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly location: Schema.Literals<readonly ["path", "query", "header", "cookie"]>;
+        readonly required: Schema.Boolean;
+        readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+        readonly style: Schema.OptionFromOptional<Schema.String>;
+        readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+        readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+        readonly description: Schema.OptionFromOptional<Schema.String>;
+    }>>;
+    readonly requestBody: Schema.OptionFromOptional<Schema.Struct<{
+        readonly required: Schema.Boolean;
+        /** Default media type — first declared in spec order (not JSON-first).
+         *  Used when the caller does not override via the tool's `contentType` arg. */
+        readonly contentType: Schema.String;
+        /** Schema of the default media type. Kept for backward compat with stored
+         *  bindings from before `contents` was added. */
+        readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+        /** All declared media types in spec order. Populated by `extract.ts`
+         *  going forward; older persisted bindings may have this unset and will
+         *  fall back to `{contentType, schema}`. */
+        readonly contents: Schema.OptionFromOptional<Schema.$Array<Schema.Struct<{
+            readonly contentType: Schema.String;
+            readonly schema: Schema.OptionFromOptional<Schema.Unknown>;
+            readonly encoding: Schema.OptionFromOptional<Schema.$Record<Schema.String, Schema.Struct<{
+                readonly contentType: Schema.OptionFromOptional<Schema.String>;
+                readonly style: Schema.OptionFromOptional<Schema.String>;
+                readonly explode: Schema.OptionFromOptional<Schema.Boolean>;
+                readonly allowReserved: Schema.OptionFromOptional<Schema.Boolean>;
+            }>>>;
+        }>>>;
+    }>>;
+}>;
+export type OperationBinding = typeof OperationBinding.Type;
+export declare const InvocationResult: Schema.Struct<{
+    readonly status: Schema.Number;
+    readonly headers: Schema.$Record<Schema.String, Schema.String>;
+    readonly data: Schema.NullOr<Schema.Unknown>;
+    readonly error: Schema.NullOr<Schema.Unknown>;
+}>;
+export type InvocationResult = typeof InvocationResult.Type;

package/dist/sdk/upstream-failures.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sdk/usage-scope-isolation.test.d.ts

@@ -0,0 +1 @@
+export {};