@executor-js/plugin-openapi 1.5.5 → 1.5.7

package/dist/{OpenApiAccountsPanel-3VJJXNQF.js → OpenApiAccountsPanel-7XT6ZMD5.js}

@@ -1,15 +1,16 @@
 import {
   authMethodsFromConfig,
+  openApiWireAuthInput,
   templateFromPlacements
-} from "./chunk-QSSRVK6M.js";
+} from "./chunk-RCBR3QMJ.js";
 import {
   googleAudienceWarningsForUrls
 } from "./chunk-MZWZQ24W.js";
 import {
   openApiConfigAtom,
   openapiConfigure
-} from "./chunk-BSLE6HCE.js";
-import "./chunk-YVRI7KRC.js";
+} from "./chunk-IB36ED7Y.js";
+import "./chunk-C3IJX4AN.js";
 
 // src/react/OpenApiAccountsPanel.tsx
 import { useCallback, useMemo } from "react";
@@ -21,6 +22,9 @@ import { TriangleAlert } from "lucide-react";
 import { AccountsSection } from "@executor-js/react/components/accounts-section";
 import { Alert, AlertDescription, AlertTitle } from "@executor-js/react/components/alert";
 import { integrationWriteKeys } from "@executor-js/react/api/reactivity-keys";
+import {
+  useCustomMethodActions
+} from "@executor-js/react/lib/custom-auth-methods";
 import { jsx, jsxs } from "react/jsx-runtime";
 var GOOGLE_AUDIENCE_WARNING = {
   "workspace-admin": "This connection includes Google Workspace admin APIs (Chat, Admin Directory, Admin Reports). Connecting requires a Workspace admin account \u2014 personal Gmail accounts cannot grant these scopes.",
@@ -47,38 +51,36 @@ function OpenApiAccountsPanel(props) {
     const declared = authMethodsFromConfig(existingTemplate);
     return declared.length > 0 ? declared : [NO_AUTH_METHOD];
   }, [existingTemplate]);
-  const createCustomMethod = useCallback(
+  const configure = useCallback(
     async (input) => {
-      const method = templateFromPlacements(input.placements);
       const exit = await doConfigure({
         params: { slug },
-        payload: { authenticationTemplate: [...existingTemplate, method] },
+        payload: {
+          authenticationTemplate: input.authenticationTemplate.map(openApiWireAuthInput),
+          ...input.mode ? { mode: input.mode } : {}
+        },
         reactivityKeys: integrationWriteKeys
       });
-      if (Exit.isFailure(exit)) return null;
-      const before = new Set(existingTemplate.map((template) => String(template.slug)));
-      const created = authMethodsFromConfig(
-        exit.value.authenticationTemplate
-      ).find((candidate) => !before.has(String(candidate.template)));
-      return created ?? null;
+      return Exit.map(exit, (result) => result.authenticationTemplate);
     },
-    [doConfigure, slug, existingTemplate]
+    [doConfigure, slug]
   );
-  const removeCustomMethod = useCallback(
-    async (method) => {
-      if (method.source !== "custom") return false;
-      const next = existingTemplate.filter(
-        (template) => String(template.slug) !== String(method.template)
-      );
-      const exit = await doConfigure({
-        params: { slug },
-        payload: { authenticationTemplate: next, mode: "replace" },
-        reactivityKeys: integrationWriteKeys
-      });
-      return Exit.isSuccess(exit);
-    },
-    [doConfigure, existingTemplate, slug]
+  const codec = useMemo(
+    () => ({
+      toAuthMethods: authMethodsFromConfig,
+      // Slug omitted → backend backfills `custom_<id>`.
+      templatesFromPlacements: (placements) => [
+        templateFromPlacements(placements)
+      ],
+      slugOf: (template) => String(template.slug)
+    }),
+    []
   );
+  const { createCustomMethod, removeCustomMethod } = useCustomMethodActions({
+    existing: existingTemplate,
+    codec,
+    configure
+  });
   const audienceWarnings = useMemo(() => {
     if (!AsyncResult.isSuccess(configResult) || configResult.value == null) return [];
     const urls = configResult.value.googleDiscoveryUrls ?? [];
@@ -109,4 +111,4 @@ function OpenApiAccountsPanel(props) {
 export {
   OpenApiAccountsPanel as default
 };
-//# sourceMappingURL=OpenApiAccountsPanel-3VJJXNQF.js.map
+//# sourceMappingURL=OpenApiAccountsPanel-7XT6ZMD5.js.map

package/dist/OpenApiAccountsPanel-7XT6ZMD5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/OpenApiAccountsPanel.tsx"],"sourcesContent":["import { useCallback, useMemo } from \"react\";\nimport { useAtomValue, useAtomSet } from \"@effect/atom-react\";\nimport * as Exit from \"effect/Exit\";\nimport * as AsyncResult from \"effect/unstable/reactivity/AsyncResult\";\nimport { AuthTemplateSlug, IntegrationSlug } from \"@executor-js/sdk/shared\";\nimport type { IntegrationAccountHandoff } from \"@executor-js/sdk/client\";\n\nimport { TriangleAlert } from \"lucide-react\";\n\nimport { AccountsSection } from \"@executor-js/react/components/accounts-section\";\nimport { Alert, AlertDescription, AlertTitle } from \"@executor-js/react/components/alert\";\nimport { integrationWriteKeys } from \"@executor-js/react/api/reactivity-keys\";\nimport type { AuthMethod, Placement } from \"@executor-js/react/lib/auth-placements\";\nimport {\n  useCustomMethodActions,\n  type AuthMethodsCodec,\n  type ConfigureAuthMethods,\n} from \"@executor-js/react/lib/custom-auth-methods\";\n\nimport { openApiConfigAtom, openapiConfigure } from \"./atoms\";\nimport {\n  authMethodsFromConfig,\n  templateFromPlacements,\n  openApiWireAuthInput,\n} from \"./auth-method-config\";\nimport { googleAudienceWarningsForUrls } from \"../sdk/google-presets\";\nimport type { Authentication } from \"../sdk/types\";\n\nconst GOOGLE_AUDIENCE_WARNING: Readonly<Record<string, string>> = {\n  \"workspace-admin\":\n    \"This connection includes Google Workspace admin APIs (Chat, Admin Directory, Admin Reports). Connecting requires a Workspace admin account — personal Gmail accounts cannot grant these scopes.\",\n  \"unsupported-user\":\n    \"This connection includes APIs (e.g. Google Keep) that Google does not grant through standard user OAuth consent. Those tools may fail to authorize.\",\n};\n\nconst NO_AUTH_METHOD: AuthMethod = {\n  id: \"none\",\n  label: \"No authentication\",\n  kind: \"none\",\n  source: \"spec\",\n  template: AuthTemplateSlug.make(\"none\"),\n  placements: [],\n};\n\n// ---------------------------------------------------------------------------\n// OpenAPI Accounts hub — fills the generic detail page's `accounts` slot.\n//\n// Reads the integration's real `authenticationTemplate` (via `getConfig`),\n// converts it to generic `AuthMethod[]`, and composes the generic\n// `AccountsSection` — whose Add-account offers those methods plus a \"+ Custom\n// method\" row (apiKey-only). The custom-method create is INJECTED here\n// (`createCustomMethod`): generic placements → an `APIKeyAuthentication`\n// (`templateFromPlacements`, slug omitted → backend `custom_<id>`) merge-\n// appended onto the existing template and persisted via `configure`. Stays\n// plugin-side because it touches the OpenAPI sdk `Authentication` types.\n// ---------------------------------------------------------------------------\n\nexport default function OpenApiAccountsPanel(props: {\n  readonly sourceId: string;\n  readonly integrationName: string;\n  readonly accountHandoff?: IntegrationAccountHandoff | null;\n}) {\n  const { sourceId, integrationName, accountHandoff } = props;\n  const slug = IntegrationSlug.make(sourceId);\n  const configResult = useAtomValue(openApiConfigAtom(slug));\n  const doConfigure = useAtomSet(openapiConfigure, { mode: \"promiseExit\" });\n\n  // The wire `getConfig` template is structurally an `Authentication[]` (the\n  // `slug` is an unbranded string on the wire); treat it as such for the\n  // plugin-side converters that brand the slug back.\n  const existingTemplate = useMemo<readonly Authentication[]>(() => {\n    if (!AsyncResult.isSuccess(configResult) || configResult.value == null) return [];\n    return (configResult.value.authenticationTemplate ?? []) as readonly Authentication[];\n  }, [configResult]);\n\n  const methods = useMemo<readonly AuthMethod[]>(() => {\n    const declared = authMethodsFromConfig(existingTemplate);\n    return declared.length > 0 ? declared : [NO_AUTH_METHOD];\n  }, [existingTemplate]);\n\n  // Custom-method create/remove: the shared skeleton (merge-append → diff out\n  // the created method; filter → replace) parameterized by the OpenAPI codec.\n  // Stays plugin-side only where it touches the OpenAPI `Authentication` types.\n  const configure = useCallback<ConfigureAuthMethods<Authentication>>(\n    async (input) => {\n      const exit = await doConfigure({\n        params: { slug },\n        payload: {\n          authenticationTemplate: input.authenticationTemplate.map(openApiWireAuthInput),\n          ...(input.mode ? { mode: input.mode } : {}),\n        },\n        reactivityKeys: integrationWriteKeys,\n      });\n      return Exit.map(exit, (result) => result.authenticationTemplate as readonly Authentication[]);\n    },\n    [doConfigure, slug],\n  );\n\n  const codec = useMemo<AuthMethodsCodec<Authentication>>(\n    () => ({\n      toAuthMethods: authMethodsFromConfig,\n      // Slug omitted → backend backfills `custom_<id>`.\n      templatesFromPlacements: (placements: readonly Placement[]) => [\n        templateFromPlacements(placements),\n      ],\n      slugOf: (template: Authentication) => String(template.slug),\n    }),\n    [],\n  );\n\n  const { createCustomMethod, removeCustomMethod } = useCustomMethodActions({\n    existing: existingTemplate,\n    codec,\n    configure,\n  });\n\n  // For a bundled `google` integration, surface a caution when any selected API\n  // needs a privileged or unsupported OAuth consent the user should know about\n  // BEFORE connecting an account. Derived from the stored Discovery URLs.\n  const audienceWarnings = useMemo<readonly string[]>(() => {\n    if (!AsyncResult.isSuccess(configResult) || configResult.value == null) return [];\n    const urls = configResult.value.googleDiscoveryUrls ?? [];\n    return googleAudienceWarningsForUrls(urls).flatMap((audience: string) => {\n      const message = GOOGLE_AUDIENCE_WARNING[audience];\n      return message ? [message] : [];\n    });\n  }, [configResult]);\n\n  return (\n    <div className=\"mx-auto max-w-3xl space-y-8 px-6 py-8\">\n      {audienceWarnings.length > 0 && (\n        <Alert variant=\"destructive\">\n          <TriangleAlert />\n          <AlertTitle>Some Google APIs need special consent</AlertTitle>\n          <AlertDescription>\n            {audienceWarnings.map((message: string) => (\n              <p key={message}>{message}</p>\n            ))}\n          </AlertDescription>\n        </Alert>\n      )}\n      <AccountsSection\n        integration={slug}\n        integrationName={integrationName}\n        methods={methods}\n        accountHandoff={accountHandoff}\n        createCustomMethod={createCustomMethod}\n        removeCustomMethod={removeCustomMethod}\n      />\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/api/group.d.ts

@@ -88,7 +88,14 @@ export declare const OpenApiGroup: HttpApiGroup.HttpApiGroup<"openapi", HttpApiE
     readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly authenticationTemplate: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
         readonly slug: Schema.String;
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly authorizationUrl: Schema.String;
+        readonly tokenUrl: Schema.String;
+        readonly scopes: Schema.$Array<Schema.String>;
+    }>, Schema.Struct<{
+        readonly slug: Schema.optional<Schema.String>;
         readonly type: Schema.Literal<"apiKey">;
+        readonly label: Schema.optional<Schema.String>;
         readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
             readonly type: Schema.Literal<"variable">;
             readonly name: Schema.String;
@@ -97,12 +104,6 @@ export declare const OpenApiGroup: HttpApiGroup.HttpApiGroup<"openapi", HttpApiE
             readonly type: Schema.Literal<"variable">;
             readonly name: Schema.String;
         }>]>>]>>>;
-    }>, Schema.Struct<{
-        readonly slug: Schema.String;
-        readonly type: Schema.Literal<"oauth">;
-        readonly authorizationUrl: Schema.String;
-        readonly tokenUrl: Schema.String;
-        readonly scopes: Schema.$Array<Schema.String>;
     }>]>>>;
 }>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
     readonly slug: Schema.brand<Schema.String, "IntegrationSlug">;
@@ -118,7 +119,6 @@ export declare const OpenApiGroup: HttpApiGroup.HttpApiGroup<"openapi", HttpApiE
 }>>>, HttpApiEndpoint.Json<typeof IntegrationAlreadyExistsError | typeof InternalError | typeof OpenApiParseError | typeof OpenApiExtractionError | typeof OpenApiOAuthError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getConfig", "GET", "/openapi/integrations/:slug/config", HttpApiEndpoint.StringTree<Schema.Struct<{
     slug: Schema.String;
 }>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.NullOr<Schema.Struct<{
-    readonly spec: Schema.String;
     readonly sourceUrl: Schema.optional<Schema.String>;
     readonly googleDiscoveryUrls: Schema.optional<Schema.$Array<Schema.String>>;
     readonly baseUrl: Schema.optional<Schema.String>;
@@ -126,28 +126,35 @@ export declare const OpenApiGroup: HttpApiGroup.HttpApiGroup<"openapi", HttpApiE
     readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly authenticationTemplate: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
         readonly slug: Schema.String;
-        readonly type: Schema.Literal<"apiKey">;
-        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
-            readonly type: Schema.Literal<"variable">;
-            readonly name: Schema.String;
-        }>]>>]>>>;
-        readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
-            readonly type: Schema.Literal<"variable">;
-            readonly name: Schema.String;
-        }>]>>]>>>;
-    }>, Schema.Struct<{
-        readonly slug: Schema.String;
-        readonly type: Schema.Literal<"oauth">;
+        readonly kind: Schema.Literal<"oauth2">;
         readonly authorizationUrl: Schema.String;
         readonly tokenUrl: Schema.String;
         readonly scopes: Schema.$Array<Schema.String>;
+    }>, Schema.Struct<{
+        readonly slug: Schema.String;
+        readonly kind: Schema.Literal<"apikey">;
+        readonly label: Schema.optional<Schema.String>;
+        readonly placements: Schema.$Array<Schema.Struct<{
+            readonly carrier: Schema.Literals<readonly ["header", "query"]>;
+            readonly name: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+            readonly variable: Schema.optional<Schema.String>;
+            readonly literal: Schema.optional<Schema.String>;
+        }>>;
     }>]>>>;
 }>>>, HttpApiEndpoint.Json<typeof IntegrationAlreadyExistsError | typeof InternalError | typeof OpenApiParseError | typeof OpenApiExtractionError | typeof OpenApiOAuthError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"configure", "POST", "/openapi/integrations/:slug/config", HttpApiEndpoint.StringTree<Schema.Struct<{
     slug: Schema.String;
 }>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
     readonly authenticationTemplate: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
         readonly slug: Schema.String;
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly authorizationUrl: Schema.String;
+        readonly tokenUrl: Schema.String;
+        readonly scopes: Schema.$Array<Schema.String>;
+    }>, Schema.Struct<{
+        readonly slug: Schema.optional<Schema.String>;
         readonly type: Schema.Literal<"apiKey">;
+        readonly label: Schema.optional<Schema.String>;
         readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
             readonly type: Schema.Literal<"variable">;
             readonly name: Schema.String;
@@ -156,32 +163,26 @@ export declare const OpenApiGroup: HttpApiGroup.HttpApiGroup<"openapi", HttpApiE
             readonly type: Schema.Literal<"variable">;
             readonly name: Schema.String;
         }>]>>]>>>;
-    }>, Schema.Struct<{
-        readonly slug: Schema.String;
-        readonly type: Schema.Literal<"oauth">;
-        readonly authorizationUrl: Schema.String;
-        readonly tokenUrl: Schema.String;
-        readonly scopes: Schema.$Array<Schema.String>;
     }>]>>;
     readonly mode: Schema.optional<Schema.Literals<readonly ["merge", "replace"]>>;
 }>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
     readonly authenticationTemplate: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
         readonly slug: Schema.String;
-        readonly type: Schema.Literal<"apiKey">;
-        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
-            readonly type: Schema.Literal<"variable">;
-            readonly name: Schema.String;
-        }>]>>]>>>;
-        readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
-            readonly type: Schema.Literal<"variable">;
-            readonly name: Schema.String;
-        }>]>>]>>>;
-    }>, Schema.Struct<{
-        readonly slug: Schema.String;
-        readonly type: Schema.Literal<"oauth">;
+        readonly kind: Schema.Literal<"oauth2">;
         readonly authorizationUrl: Schema.String;
         readonly tokenUrl: Schema.String;
         readonly scopes: Schema.$Array<Schema.String>;
+    }>, Schema.Struct<{
+        readonly slug: Schema.String;
+        readonly kind: Schema.Literal<"apikey">;
+        readonly label: Schema.optional<Schema.String>;
+        readonly placements: Schema.$Array<Schema.Struct<{
+            readonly carrier: Schema.Literals<readonly ["header", "query"]>;
+            readonly name: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+            readonly variable: Schema.optional<Schema.String>;
+            readonly literal: Schema.optional<Schema.String>;
+        }>>;
     }>]>>;
 }>>, HttpApiEndpoint.Json<typeof IntegrationAlreadyExistsError | typeof InternalError | typeof OpenApiParseError | typeof OpenApiExtractionError | typeof OpenApiOAuthError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"removeSpec", "DELETE", "/openapi/integrations/:slug", HttpApiEndpoint.StringTree<Schema.Struct<{
     slug: Schema.String;

package/dist/api/index.d.ts

@@ -14,7 +14,6 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
             readonly operationId: string;
         }[];
         readonly title: import("effect/Option").Option<string>;
-        readonly tags: readonly string[];
         readonly servers: readonly {
             readonly description: import("effect/Option").Option<string>;
             readonly url: string;
@@ -26,6 +25,7 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
                 };
             }>;
         }[];
+        readonly tags: readonly string[];
         readonly securitySchemes: readonly {
             readonly name: string;
             readonly type: "oauth2" | "http" | "apiKey" | "openIdConnect";
@@ -171,7 +171,14 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
     readonly queryParams: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").String>>;
     readonly authenticationTemplate: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
         readonly slug: import("effect/Schema").String;
+        readonly kind: import("effect/Schema").Literal<"oauth2">;
+        readonly authorizationUrl: import("effect/Schema").String;
+        readonly tokenUrl: import("effect/Schema").String;
+        readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        readonly slug: import("effect/Schema").optional<import("effect/Schema").String>;
         readonly type: import("effect/Schema").Literal<"apiKey">;
+        readonly label: import("effect/Schema").optional<import("effect/Schema").String>;
         readonly headers: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
             readonly type: import("effect/Schema").Literal<"variable">;
             readonly name: import("effect/Schema").String;
@@ -180,12 +187,6 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
             readonly type: import("effect/Schema").Literal<"variable">;
             readonly name: import("effect/Schema").String;
         }>]>>]>>>;
-    }>, import("effect/Schema").Struct<{
-        readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"oauth">;
-        readonly authorizationUrl: import("effect/Schema").String;
-        readonly tokenUrl: import("effect/Schema").String;
-        readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
     }>]>>>;
 }>>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<import("effect/Schema").Struct<{
     readonly slug: import("effect/Schema").brand<import("effect/Schema").String, "IntegrationSlug">;
@@ -201,7 +202,6 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
 }>>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("@executor-js/sdk/core").IntegrationAlreadyExistsError | typeof import("@executor-js/api").InternalError | typeof import("../sdk").OpenApiParseError | typeof import("../sdk").OpenApiExtractionError | typeof import("../sdk").OpenApiOAuthError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"getConfig", "GET", "/openapi/integrations/:slug/config", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
     slug: import("effect/Schema").String;
 }>>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
-    readonly spec: import("effect/Schema").String;
     readonly sourceUrl: import("effect/Schema").optional<import("effect/Schema").String>;
     readonly googleDiscoveryUrls: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").String>>;
     readonly baseUrl: import("effect/Schema").optional<import("effect/Schema").String>;
@@ -209,28 +209,35 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
     readonly queryParams: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").String>>;
     readonly authenticationTemplate: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
         readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"apiKey">;
-        readonly headers: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
-            readonly type: import("effect/Schema").Literal<"variable">;
-            readonly name: import("effect/Schema").String;
-        }>]>>]>>>;
-        readonly queryParams: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
-            readonly type: import("effect/Schema").Literal<"variable">;
-            readonly name: import("effect/Schema").String;
-        }>]>>]>>>;
-    }>, import("effect/Schema").Struct<{
-        readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"oauth">;
+        readonly kind: import("effect/Schema").Literal<"oauth2">;
         readonly authorizationUrl: import("effect/Schema").String;
         readonly tokenUrl: import("effect/Schema").String;
         readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        readonly slug: import("effect/Schema").String;
+        readonly kind: import("effect/Schema").Literal<"apikey">;
+        readonly label: import("effect/Schema").optional<import("effect/Schema").String>;
+        readonly placements: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+            readonly carrier: import("effect/Schema").Literals<readonly ["header", "query"]>;
+            readonly name: import("effect/Schema").String;
+            readonly prefix: import("effect/Schema").optional<import("effect/Schema").String>;
+            readonly variable: import("effect/Schema").optional<import("effect/Schema").String>;
+            readonly literal: import("effect/Schema").optional<import("effect/Schema").String>;
+        }>>;
     }>]>>>;
 }>>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("@executor-js/sdk/core").IntegrationAlreadyExistsError | typeof import("@executor-js/api").InternalError | typeof import("../sdk").OpenApiParseError | typeof import("../sdk").OpenApiExtractionError | typeof import("../sdk").OpenApiOAuthError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"configure", "POST", "/openapi/integrations/:slug/config", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
     slug: import("effect/Schema").String;
 }>>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<import("effect/Schema").Struct<{
     readonly authenticationTemplate: import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
         readonly slug: import("effect/Schema").String;
+        readonly kind: import("effect/Schema").Literal<"oauth2">;
+        readonly authorizationUrl: import("effect/Schema").String;
+        readonly tokenUrl: import("effect/Schema").String;
+        readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        readonly slug: import("effect/Schema").optional<import("effect/Schema").String>;
         readonly type: import("effect/Schema").Literal<"apiKey">;
+        readonly label: import("effect/Schema").optional<import("effect/Schema").String>;
         readonly headers: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
             readonly type: import("effect/Schema").Literal<"variable">;
             readonly name: import("effect/Schema").String;
@@ -239,32 +246,26 @@ export declare const openApiHttpPlugin: import("@executor-js/sdk/core").Configur
             readonly type: import("effect/Schema").Literal<"variable">;
             readonly name: import("effect/Schema").String;
         }>]>>]>>>;
-    }>, import("effect/Schema").Struct<{
-        readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"oauth">;
-        readonly authorizationUrl: import("effect/Schema").String;
-        readonly tokenUrl: import("effect/Schema").String;
-        readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
     }>]>>;
     readonly mode: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["merge", "replace"]>>;
 }>>, import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<never>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<import("effect/Schema").Struct<{
     readonly authenticationTemplate: import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
         readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"apiKey">;
-        readonly headers: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
-            readonly type: import("effect/Schema").Literal<"variable">;
-            readonly name: import("effect/Schema").String;
-        }>]>>]>>>;
-        readonly queryParams: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").String, import("effect/Schema").Struct<{
-            readonly type: import("effect/Schema").Literal<"variable">;
-            readonly name: import("effect/Schema").String;
-        }>]>>]>>>;
-    }>, import("effect/Schema").Struct<{
-        readonly slug: import("effect/Schema").String;
-        readonly type: import("effect/Schema").Literal<"oauth">;
+        readonly kind: import("effect/Schema").Literal<"oauth2">;
         readonly authorizationUrl: import("effect/Schema").String;
         readonly tokenUrl: import("effect/Schema").String;
         readonly scopes: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        readonly slug: import("effect/Schema").String;
+        readonly kind: import("effect/Schema").Literal<"apikey">;
+        readonly label: import("effect/Schema").optional<import("effect/Schema").String>;
+        readonly placements: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+            readonly carrier: import("effect/Schema").Literals<readonly ["header", "query"]>;
+            readonly name: import("effect/Schema").String;
+            readonly prefix: import("effect/Schema").optional<import("effect/Schema").String>;
+            readonly variable: import("effect/Schema").optional<import("effect/Schema").String>;
+            readonly literal: import("effect/Schema").optional<import("effect/Schema").String>;
+        }>>;
     }>]>>;
 }>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("@executor-js/sdk/core").IntegrationAlreadyExistsError | typeof import("@executor-js/api").InternalError | typeof import("../sdk").OpenApiParseError | typeof import("../sdk").OpenApiExtractionError | typeof import("../sdk").OpenApiOAuthError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"removeSpec", "DELETE", "/openapi/integrations/:slug", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
     slug: import("effect/Schema").String;