@superblocksteam/gateway 2.0.165-next.0 → 2.0.166-next.1

package/dist/capabilities/query-integration.js

@@ -1,11 +1,11 @@
-import { pickOrchestratorBaseUrl } from "../agents/resolve-orchestrator-url.js";
+import { AGENT_TYPE_ONPREMISE, pickOrchestratorBaseUrl, } from "../agents/resolve-orchestrator-url.js";
 import { hasBuildPermission } from "../integrations/map.js";
-import { pickEditorProfileKey } from "../integrations/profile-key.js";
 import { isReadOnlyPostgresQuery, supportsReadOnlyPostgresQuery, } from "../integrations/read-only-postgres-query.js";
+import { describeProfile, profileSummary, profileUnresolvedMessage, resolveProfileForApplication, } from "../integrations/resolve-profile.js";
 import { HttpOrchestratorClient } from "../orchestrator/client.js";
 import { sanitizeAgentFacingText } from "../sabs/agent-facing-text.js";
 import { executeRequestToIntegrationViaOrchestrator, } from "../sabs/editor-client-methods.js";
-import { ensurePrincipal } from "./lifecycle.js";
+import { ensurePrincipal, resolveApplicationId, } from "./lifecycle.js";
 const DEFAULT_QUERY_TIMEOUT_MS = 30_000;
 const MAX_RESPONSE_CHARS = 50_000;
 const RESPONSE_RESERVE_MS = 1_000;
@@ -14,8 +14,9 @@ function boundedText(text) {
     if (text.length <= MAX_RESPONSE_CHARS) {
         return { text, truncated: false };
     }
+    const sliceLength = MAX_RESPONSE_CHARS - TRUNCATED_SUFFIX.length;
     return {
-        text: `${text.slice(0, MAX_RESPONSE_CHARS - TRUNCATED_SUFFIX.length)}${TRUNCATED_SUFFIX}`,
+        text: `${text.slice(0, sliceLength)}${TRUNCATED_SUFFIX}`,
         truncated: true,
     };
 }
@@ -60,19 +61,25 @@ export async function queryIntegration(context, input) {
     const queryTimeoutMs = Math.max(1, context.config.hostCallCeilingMs - RESPONSE_RESERVE_MS);
     const deadlineAtMs = Date.now() + queryTimeoutMs;
     const beforeDeadline = (pending) => beforeQueryDeadline(pending, deadlineAtMs, context.signal);
+    let applicationId;
+    let profileResolution;
     let label = sanitizeAgentFacingText(input.integrationId);
     try {
         const principal = await beforeDeadline(ensurePrincipal(context));
         if (principal.kind !== "ok") {
             return principal;
         }
+        const resolved = await beforeDeadline(resolveApplicationId(context, principal.value, input.applicationId));
+        applicationId = resolved.kind === "ok" ? resolved.value : undefined;
         const integrations = await beforeDeadline(context.server.getSupersetIntegrations({
             apiKey: principal.value.apiKey,
+            ...(applicationId && { applicationId }),
             organizationId: principal.value.organizationId,
         }));
         const integration = integrations.find((candidate) => candidate.id === input.integrationId);
         if (!integration) {
             return {
+                ...(applicationId && { applicationId }),
                 kind: "error",
                 code: "integration_not_accessible",
                 message: `Integration ${label} was not found or is not accessible.`,
@@ -83,6 +90,7 @@ export async function queryIntegration(context, input) {
         label = integrationName;
         if (!hasBuildPermission(integration)) {
             return {
+                ...(applicationId && { applicationId }),
                 kind: "error",
                 code: "integration_not_permitted",
                 message: `You do not have build permission on ${integrationName}.`,
@@ -90,6 +98,7 @@ export async function queryIntegration(context, input) {
         }
         if (!supportsReadOnlyPostgresQuery(integration.pluginId)) {
             return {
+                ...(applicationId && { applicationId }),
                 kind: "error",
                 code: "integration_query_not_supported",
                 message: `${integrationName} is not a supported PostgreSQL integration for direct read-only queries.`,
@@ -97,33 +106,63 @@ export async function queryIntegration(context, input) {
         }
         if (!(await beforeDeadline(isReadOnlyPostgresQuery(input.query)))) {
             return {
+                ...(applicationId && { applicationId }),
                 kind: "error",
                 code: "integration_query_not_read_only",
                 message: "Provide exactly one read-only SELECT, CTE, SHOW, or EXPLAIN query. Mutations, schema or session changes, row locks, and functions other than count, sum, avg, min, and max are not allowed.",
             };
         }
-        const profiles = await beforeDeadline(context.server.getOrganizationProfiles({
+        ({ resolution: profileResolution } = await resolveProfileForApplication({
             apiKey: principal.value.apiKey,
+            applicationId,
+            configuredKey: context.config.profileKey,
             organizationId: principal.value.organizationId,
+            scope: "integration_query",
+            server: context.server,
+            wrap: beforeDeadline,
         }));
-        const profileKey = pickEditorProfileKey(context.config.profileKey, profiles);
+        const profileKey = profileResolution.key;
         const inventory = await beforeDeadline(context.server.getAgentInventory({
             apiKey: principal.value.apiKey,
             organizationId: principal.value.organizationId,
         }));
-        const orchestratorUrl = pickOrchestratorBaseUrl({
-            agentType: inventory.agentType,
-            agents: inventory.agents,
-            profileKey,
-        });
-        const scopedToken = await beforeDeadline(context.server.issueScopedToken({
-            apiKey: principal.value.apiKey,
-            integrationId: input.integrationId,
-            scope: "integrations:build",
-        }));
+        let orchestratorUrl;
+        try {
+            orchestratorUrl = pickOrchestratorBaseUrl({
+                agentType: inventory.agentType,
+                agents: inventory.agents,
+                controlPlaneUrl: inventory.controlPlaneUrl,
+                profileKey,
+            });
+        }
+        catch (error) {
+            // Only on-prem agents are picked by profile tag, so only there does a
+            // missing profile explain a missing agent.
+            if (profileKey || inventory.agentType !== AGENT_TYPE_ONPREMISE) {
+                throw error;
+            }
+            return {
+                ...(applicationId && { applicationId }),
+                kind: "error",
+                code: "integration_profile_unresolved",
+                message: profileUnresolvedMessage(integrationName, profileResolution),
+            };
+        }
+        const scopedToken = await beforeDeadline(context.server.issueScopedToken(applicationId
+            ? {
+                apiKey: principal.value.apiKey,
+                applicationId,
+                scope: "apps:update",
+            }
+            : {
+                apiKey: principal.value.apiKey,
+                integrationId: input.integrationId,
+                scope: "integrations:build",
+            }));
         const executionTimeoutMs = Math.max(1, Math.min(DEFAULT_QUERY_TIMEOUT_MS, deadlineAtMs - Date.now()));
         const executionContext = {
             apiKey: principal.value.apiKey,
+            ...(applicationId && { applicationId }),
             orchestrator: new HttpOrchestratorClient(orchestratorUrl, executionTimeoutMs),
             organizationId: principal.value.organizationId,
             profileKey,
@@ -140,8 +179,9 @@ export async function queryIntegration(context, input) {
             request: { body: input.query, usePreparedSql: true },
         }));
         if (result.error) {
-            const { text } = boundedText(result.error);
+            const { text } = boundedText(`Query on ${integrationName} (${describeProfile(profileResolution)}) failed: ${result.error}`);
             return {
+                ...(applicationId && { applicationId }),
                 kind: "error",
                 code: "integration_query_failed",
                 message: text,
@@ -151,9 +191,11 @@ export async function queryIntegration(context, input) {
         return {
             kind: "ok",
             value: {
+                ...(applicationId && { applicationId }),
                 integrationId: integration.id,
                 integrationName,
                 pluginId,
+                profile: profileSummary(profileResolution),
                 response: bounded.text,
                 truncated: bounded.truncated,
             },
@@ -161,8 +203,9 @@ export async function queryIntegration(context, input) {
     }
     catch (error) {
         const detail = sanitizeAgentFacingText(error instanceof Error ? error.message : "Unknown integration error").replaceAll("\u2014", "-");
-        const { text } = boundedText(`Could not query ${label}: ${detail}`);
+        const { text } = boundedText(`Could not query ${label}${profileResolution ? ` (${describeProfile(profileResolution)})` : ""}: ${detail}`);
         return {
+            ...(applicationId && { applicationId }),
             kind: "error",
             code: "integration_query_unavailable",
             message: text,

package/dist/capabilities/query-integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-integration.js","sourceRoot":"","sources":["../../src/capabilities/query-integration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query-integration.js","sourceRoot":"","sources":["../../src/capabilities/query-integration.ts"],"names":[],"mappings":"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"}

package/dist/{transports/mcp → capture}/cowork-editor-url.d.ts

@@ -1,6 +1,6 @@
 /**
  * The editor only renders in Cowork's host mode when the URL says so, so every
- * editor URL handed to the browser pane carries the param - a build's
- * navigation and a publish's details page alike.
+ * editor URL handed to a Cowork client carries the param - a build's
+ * navigation, the canvas it may open mid-build, and a publish's details page.
  */
 export declare function withCoworkEditorHost(url: string): string;

package/dist/capture/cowork-editor-url.js

@@ -0,0 +1,12 @@
+import { URL_PARAMS } from "@superblocksteam/library-shared";
+/**
+ * The editor only renders in Cowork's host mode when the URL says so, so every
+ * editor URL handed to a Cowork client carries the param - a build's
+ * navigation, the canvas it may open mid-build, and a publish's details page.
+ */
+export function withCoworkEditorHost(url) {
+    const parsed = new URL(url);
+    parsed.searchParams.set(URL_PARAMS.editorHost, "cowork");
+    return parsed.toString();
+}
+//# sourceMappingURL=cowork-editor-url.js.map

package/dist/capture/cowork-editor-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cowork-editor-url.js","sourceRoot":"","sources":["../../src/capture/cowork-editor-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/integrations/profile-key.d.ts

@@ -6,14 +6,58 @@
  */
 export type OrgProfileRow = {
     allowedInEditor?: boolean;
+    /** The organization's editor default; at most one row per org sets it. */
+    defaultInEditor?: boolean;
+    id?: string;
     key: string;
 };
 /**
- * Resolves an editor profile key from the org's profile list.
+ * The source from which the profile key was selected.
+ * Bounded string enum suitable for OpenTelemetry metric attributes.
+ */
+export type ProfileKeySource = "app_default" | "none" | "operator_config" | "org_default";
+/**
+ * The specific reason explaining why a profile key or fallback was chosen.
+ * Bounded string enum suitable for OpenTelemetry metric attributes.
+ */
+export type ProfileKeyReason = "app_default_missing" | "app_default_unjoinable" | "app_needs_attention" | "app_settings_unavailable" | "org_default_missing" | "operator_key_not_available" | "org_profiles_unavailable" | "resolved";
+/**
+ * Encapsulates the resolved profile key alongside provenance and reason
+ * for telemetry and cache invalidation.
+ */
+export type ProfileResolution = {
+    /** Absent means: send no profile; the control plane uses the app's own default. */
+    key?: string;
+    /** Log line only, never a metric label. */
+    profileId?: string;
+    reason: ProfileKeyReason;
+    source: ProfileKeySource;
+};
+/**
+ * Resolves the same editor profile the browser uses for AI execution.
+ *
+ * App settings contain ids, while orchestrator requests contain keys, so the
+ * org rows are used only to join those two representations. This deliberately
+ * does not pick another allowed profile when the default cannot be joined.
+ */
+export declare function resolveAppEditorProfileKey(input: {
+    configuredKey: string | undefined;
+    editor: {
+        availableProfileIds: string[];
+        defaultProfileId?: string;
+    } | undefined;
+    needsAttention?: boolean;
+    orgProfiles: OrgProfileRow[];
+}): ProfileResolution;
+/**
+ * Resolves the organization's editor default for a request with no
+ * application in play.
  *
- * - Honors `preferred` when it exists on the org (and is not the legacy
- *   placeholder `default`).
- * - Otherwise prefers staging → dev → production, then the first listed key.
- * - When the org list is unavailable, falls back to `preferred` or `staging`.
+ * A new application copies this default into its own editor settings (behind
+ * the default data tags flag), so reading metadata before an app exists sees
+ * the same profile the app will use once it does.
  */
-export declare function pickEditorProfileKey(preferred: string | undefined, profiles: OrgProfileRow[]): string;
+export declare function resolveOrgEditorProfileKey(input: {
+    configuredKey: string | undefined;
+    orgProfiles: OrgProfileRow[];
+}): ProfileResolution;

package/dist/integrations/profile-key.js

@@ -4,32 +4,111 @@
  * `default` — they use `dev` / `staging` / `production` — and a wrong key
  * surfaces as orchestrator "Invalid profile specified" / HTTP 500.
  */
-const AUTO_PREFERRED_KEYS = ["staging", "dev", "production"];
 /**
- * Resolves an editor profile key from the org's profile list.
+ * Resolves the same editor profile the browser uses for AI execution.
  *
- * - Honors `preferred` when it exists on the org (and is not the legacy
- *   placeholder `default`).
- * - Otherwise prefers staging → dev → production, then the first listed key.
- * - When the org list is unavailable, falls back to `preferred` or `staging`.
+ * App settings contain ids, while orchestrator requests contain keys, so the
+ * org rows are used only to join those two representations. This deliberately
+ * does not pick another allowed profile when the default cannot be joined.
  */
-export function pickEditorProfileKey(preferred, profiles) {
-    const configured = preferred?.trim() ?? "";
-    const isAuto = !configured || configured.toLowerCase() === "default";
-    const keys = profiles
-        .map((profile) => profile.key?.trim())
-        .filter((key) => Boolean(key));
-    if (!isAuto && keys.includes(configured)) {
-        return configured;
-    }
-    if (keys.length === 0) {
-        return isAuto ? "staging" : configured;
-    }
-    for (const candidate of AUTO_PREFERRED_KEYS) {
-        if (keys.includes(candidate)) {
-            return candidate;
+export function resolveAppEditorProfileKey(input) {
+    if (!input.editor) {
+        return { reason: "app_settings_unavailable", source: "none" };
+    }
+    if (input.needsAttention || input.editor.availableProfileIds.length === 0) {
+        return { reason: "app_needs_attention", source: "none" };
+    }
+    if (input.orgProfiles.length === 0) {
+        return { reason: "org_profiles_unavailable", source: "none" };
+    }
+    const profilesById = new Map(input.orgProfiles.flatMap((profile) => profile.id ? [[profile.id, profile]] : []));
+    const availableProfiles = input.editor.availableProfileIds.flatMap((id) => {
+        const profile = profilesById.get(id);
+        return profile ? [profile] : [];
+    });
+    const configuredKey = input.configuredKey?.trim();
+    const hasConfiguredKey = configuredKey && configuredKey.toLowerCase() !== "default";
+    let reason = "resolved";
+    if (hasConfiguredKey) {
+        const configuredProfile = availableProfiles.find((profile) => profile.key === configuredKey);
+        if (configuredProfile) {
+            return {
+                key: configuredProfile.key,
+                profileId: configuredProfile.id,
+                reason: "resolved",
+                source: "operator_config",
+            };
         }
+        reason = "operator_key_not_available";
+    }
+    const defaultProfileId = input.editor.defaultProfileId;
+    if (!defaultProfileId) {
+        return {
+            reason: reason === "operator_key_not_available"
+                ? reason
+                : "app_default_missing",
+            source: "none",
+        };
+    }
+    const defaultProfile = profilesById.get(defaultProfileId);
+    if (!defaultProfile) {
+        return {
+            profileId: defaultProfileId,
+            reason: reason === "operator_key_not_available"
+                ? reason
+                : "app_default_unjoinable",
+            source: "none",
+        };
+    }
+    return {
+        key: defaultProfile.key,
+        profileId: defaultProfileId,
+        reason,
+        source: "app_default",
+    };
+}
+/**
+ * Resolves the organization's editor default for a request with no
+ * application in play.
+ *
+ * A new application copies this default into its own editor settings (behind
+ * the default data tags flag), so reading metadata before an app exists sees
+ * the same profile the app will use once it does.
+ */
+export function resolveOrgEditorProfileKey(input) {
+    if (input.orgProfiles.length === 0) {
+        return { reason: "org_profiles_unavailable", source: "none" };
+    }
+    const editorProfiles = input.orgProfiles.filter((profile) => profile.allowedInEditor !== false);
+    const configuredKey = input.configuredKey?.trim();
+    const hasConfiguredKey = configuredKey && configuredKey.toLowerCase() !== "default";
+    let reason = "resolved";
+    if (hasConfiguredKey) {
+        const configuredProfile = editorProfiles.find((profile) => profile.key === configuredKey);
+        if (configuredProfile) {
+            return {
+                key: configuredProfile.key,
+                ...(configuredProfile.id && { profileId: configuredProfile.id }),
+                reason: "resolved",
+                source: "operator_config",
+            };
+        }
+        reason = "operator_key_not_available";
+    }
+    const defaultProfile = editorProfiles.find((profile) => profile.defaultInEditor === true);
+    if (!defaultProfile) {
+        return {
+            reason: reason === "operator_key_not_available"
+                ? reason
+                : "org_default_missing",
+            source: "none",
+        };
     }
-    return keys[0] ?? "staging";
+    return {
+        key: defaultProfile.key,
+        ...(defaultProfile.id && { profileId: defaultProfile.id }),
+        reason,
+        source: "org_default",
+    };
 }
 //# sourceMappingURL=profile-key.js.map

package/dist/integrations/profile-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile-key.js","sourceRoot":"","sources":["../../src/integrations/profile-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,CAAU,CAAC;AAOtE;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA6B,EAC7B,QAAyB;IAEzB,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,UAAU,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC;IACrE,MAAM,IAAI,GAAG,QAAQ;SAClB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;SACrC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"profile-key.js","sourceRoot":"","sources":["../../src/integrations/profile-key.ts"],"names":[],"mappings":"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"}

package/dist/integrations/resolve-profile.d.ts

@@ -0,0 +1,30 @@
+import type { SuperblocksServerClient } from "../server/client.js";
+import { type OrgProfileRow, type ProfileResolution } from "./profile-key.js";
+export declare function resolveProfileForApplication(input: {
+    apiKey: string;
+    applicationId?: string;
+    configuredKey: string | undefined;
+    organizationId: string;
+    scope: "held_session" | "integration_metadata" | "integration_query";
+    server: Pick<SuperblocksServerClient, "getApplicationEnvironment" | "getOrganizationProfiles">;
+    /** query_integration passes its `beforeDeadline`; metadata omits it. */
+    wrap?: <T>(pending: Promise<T>) => Promise<T>;
+}): Promise<{
+    profiles: OrgProfileRow[];
+    resolution: ProfileResolution;
+}>;
+/** What a tool result reports about the profile its data came from. */
+export type ResolvedProfileSummary = {
+    /** Absent when no profile was sent. */
+    key?: string;
+    source: ProfileResolution["source"];
+};
+export declare function profileSummary(resolution: ProfileResolution): ResolvedProfileSummary;
+/** Appended to an error so the agent can tell the user which data it tried. */
+export declare function describeProfile(resolution: ProfileResolution): string;
+/**
+ * On-prem agents only take requests for the profiles they are tagged with, so
+ * with no profile there is no agent to send the request to. Says why none
+ * resolved rather than reporting a missing agent.
+ */
+export declare function profileUnresolvedMessage(integrationName: string, resolution: ProfileResolution): string;

package/dist/integrations/resolve-profile.js

@@ -0,0 +1,104 @@
+import { recordIntegrationProfileResolution } from "../telemetry/metrics.js";
+import { resolveAppEditorProfileKey, resolveOrgEditorProfileKey, } from "./profile-key.js";
+function identity(pending) {
+    return pending;
+}
+export async function resolveProfileForApplication(input) {
+    const wrap = input.wrap ?? identity;
+    const [profiles, environment] = await Promise.all([
+        wrap(input.server
+            .getOrganizationProfiles({
+            apiKey: input.apiKey,
+            organizationId: input.organizationId,
+        })
+            .catch((error) => {
+            console.warn("gateway failed to load organization profiles", {
+                applicationId: input.applicationId,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        })),
+        input.applicationId
+            ? wrap(input.server
+                .getApplicationEnvironment({
+                apiKey: input.apiKey,
+                applicationId: input.applicationId,
+            })
+                .catch((error) => {
+                console.warn("gateway failed to load application environment", {
+                    applicationId: input.applicationId,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return undefined;
+            }))
+            : undefined,
+    ]);
+    // With no application there are no app settings to read, so use the
+    // organization's editor default: the profile a new app would start with.
+    // A failed app settings read is not that case and still sends no profile.
+    const resolution = input.applicationId
+        ? resolveAppEditorProfileKey({
+            configuredKey: input.configuredKey,
+            editor: environment?.profiles.editor,
+            needsAttention: environment?.needsAttention?.editor,
+            orgProfiles: profiles,
+        })
+        : resolveOrgEditorProfileKey({
+            configuredKey: input.configuredKey,
+            orgProfiles: profiles,
+        });
+    recordIntegrationProfileResolution({
+        reason: resolution.reason,
+        scope: input.scope,
+        source: resolution.source,
+    });
+    console.error("gateway resolved integration profile", {
+        ...(input.applicationId && { applicationId: input.applicationId }),
+        organizationId: input.organizationId,
+        ...(input.configuredKey && { preferred: input.configuredKey }),
+        ...(resolution.profileId && { profileId: resolution.profileId }),
+        ...(resolution.key && { profileKey: resolution.key }),
+        reason: resolution.reason,
+        scope: input.scope,
+        source: resolution.source,
+    });
+    return { profiles, resolution };
+}
+export function profileSummary(resolution) {
+    return {
+        ...(resolution.key && { key: resolution.key }),
+        source: resolution.source,
+    };
+}
+const SOURCE_LABELS = {
+    app_default: "the app's editor default",
+    none: "no profile",
+    operator_config: "the gateway configuration",
+    org_default: "the organization's editor default",
+};
+/** Appended to an error so the agent can tell the user which data it tried. */
+export function describeProfile(resolution) {
+    return resolution.key
+        ? `profile "${resolution.key}", from ${SOURCE_LABELS[resolution.source]}`
+        : "no profile";
+}
+/**
+ * On-prem agents only take requests for the profiles they are tagged with, so
+ * with no profile there is no agent to send the request to. Says why none
+ * resolved rather than reporting a missing agent.
+ */
+export function profileUnresolvedMessage(integrationName, resolution) {
+    switch (resolution.reason) {
+        case "org_default_missing":
+            return `No profile is set as the organization's default for editing, so there is no agent to send the request for ${integrationName} to. An organization admin can choose a default editing profile in the organization's profile settings.`;
+        case "org_profiles_unavailable":
+            return `The organization's profiles could not be loaded, so there is no profile to send the request for ${integrationName} with. Try again shortly.`;
+        case "operator_key_not_available":
+            return `The profile set in the gateway configuration is not available for editing and there is no default to fall back to, so there is no agent to send the request for ${integrationName} to. Remove the configured profile or choose one that is allowed in the editor.`;
+        case "app_settings_unavailable":
+            return `The app's environment settings could not be loaded, so there is no profile to send the request for ${integrationName} with. Try again shortly.`;
+        default:
+            return `The app's editor profile could not be resolved (${resolution.reason}), so there is no agent to send the request for ${integrationName} to. Check the app's environment settings.`;
+    }
+}
+//# sourceMappingURL=resolve-profile.js.map

package/dist/integrations/resolve-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-profile.js","sourceRoot":"","sources":["../../src/integrations/resolve-profile.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/client.d.ts

@@ -40,7 +40,7 @@ export type V2ExecuteInput = RequesterCredential & {
 };
 export type MetadataInput = RequesterCredential & {
     integrationId: string;
-    profileKey: string;
+    profileKey?: string;
     scopedToken: string;
     stepConfiguration?: Record<string, unknown>;
 };

package/dist/orchestrator/client.js

@@ -141,7 +141,7 @@ export class HttpOrchestratorClient {
             apiKey: input.apiKey,
             body: {
                 integration: input.integrationId,
-                profile: { name: input.profileKey },
+                ...(input.profileKey ? { profile: { name: input.profileKey } } : {}),
                 stepConfiguration: input.stepConfiguration ?? {},
             },
             profileKey: input.profileKey,