@agent-native/core 0.225.2-nightly-20261106152255 → 0.226.0

package/dist/agent/actions/get-agentkit-capabilities.d.ts

@@ -1,2 +1,13 @@
-declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, import("../../agentkit/capabilities.js").AgentKitCapabilityCatalog>;
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, {
+    sources: {
+        figma: {
+            available: boolean;
+        };
+    };
+    integrations: {
+        id: string;
+        label: string;
+        kind: "mcp" | "provider-api";
+    }[];
+}>;
 export default _default;

package/dist/agent/actions/get-agentkit-capabilities.js

@@ -1,17 +1,25 @@
 import { z } from "zod";
 import { defineAction, fail } from "../../action.js";
-import { listAgentKitCapabilities, } from "../../agentkit/capabilities.js";
+import { listAgentKitCapabilities } from "../../agentkit/capabilities.js";
 export default defineAction({
-    description: "Read the signed-in user's AgentKit context-source and integration capabilities for Design, Slides, or Slides 2. Returns only supported, connected capability labels and availability; never returns credentials or connection details.",
+    description: "Read context-source availability and connected workspace integrations usable by the authenticated caller in the current app. Returns scoped capability labels, never credentials or connection details.",
     schema: z.object({}),
+    outputSchema: z.object({
+        sources: z.object({ figma: z.object({ available: z.boolean() }) }),
+        integrations: z.array(z.object({
+            id: z.string(),
+            label: z.string(),
+            kind: z.enum(["provider-api", "mcp"]),
+        })),
+    }),
     http: { method: "GET" },
     readOnly: true,
     agentTool: false,
     toolCallable: false,
     run: async (_args, ctx) => {
-        const appId = ctx?.appId;
-        if (appId !== "design" && appId !== "slides") {
-            fail("AgentKit capabilities are only available in Design and Slides.", {
+        const appId = ctx?.appId?.trim();
+        if (!appId) {
+            fail("An app context is required to read workspace integrations.", {
                 errorCode: "agentkit_capabilities_unsupported_app",
                 statusCode: 400,
             });

package/dist/agent/production-agent.js

@@ -4,12 +4,13 @@ import { AGENT_NATIVE_SUBMISSION_EXPIRES_AT_METADATA_KEY, AGENT_NATIVE_SUBMISSIO
 import Ajv from "ajv";
 import Ajv2020 from "ajv/dist/2020.js";
 import { defineEventHandler, getHeader, setResponseHeader, setResponseStatus, getMethod, } from "h3";
-import "../authorization/check-action.js";
 import { parseA2AAgentActivityPart } from "../a2a/activity.js";
+import "../authorization/check-action.js";
 import { actionCallIsRetrySafe, actionChangeResource, classifyActionCall, } from "../action-call-classification.js";
 import { runOutsideActionInvocation, vouchedOutcome } from "../action-frame.js";
 import { ACTION_CHAT_UI_RECORD_CHANGE_RENDERER, normalizeActionChangeResult, } from "../action-ui.js";
 import { AgentConnectionRequiredError, describeToolParameterSignature, isActionContractError, isActionHiddenFromEveryAgentSurface, isAgentActionStopError, isAgentConnectionRequiredError, actionCallIntent, ActionInputValidationError, telemetryInvalidPaths, invocationEffect, runPreparedActionCall, boundActionCallIntent, preparedCallArguments, preparedCallNeedsApproval, recordInvalidActionCall, resolveToolMaxResultChars, stripUnsupportedSchemaKeywords, } from "../action.js";
+import { resolveAgentKitIntegrationReferences } from "../agentkit/capabilities.js";
 import { getAppConfig } from "../app-config/index.js";
 import { MAX_BACKGROUND_RUN_CONTINUATIONS, MAX_CONSECUTIVE_NO_PROGRESS_CONTINUATIONS, MAX_TURN_WALL_CLOCK_MS, } from "../app-config/run-lifecycle-invariants.js";
 import { readAppState } from "../application-state/script-helpers.js";
@@ -2779,7 +2780,7 @@ async function enrichMessage(message, references) {
     const fileRefs = references.filter((r) => r.type === "file");
     const skillRefs = references.filter((r) => r.type === "skill");
     const customAgentRefs = references.filter((r) => r.type === "custom-agent");
-    const mentionRefs = references.filter((r) => r.type === "mention");
+    const mentionRefs = references.filter((r) => r.type === "mention" && r.refType !== "integration");
     const parts = [];
     if (fileRefs.length > 0) {
         parts.push("Referenced files:\n" +
@@ -10886,6 +10887,14 @@ export function createProductionAgentHandler(options) {
                 retryable: false,
             };
         }
+        const integrationCredentialScope = getRequestContext()?.credentialScope;
+        const integrationIntents = await resolveAgentKitIntegrationReferences(options.appId ?? "", requestReferences, {
+            userEmail: getRequestUserEmail() ?? ownerEmail ?? "",
+            orgId: getRequestOrgId() ?? null,
+            ...(integrationCredentialScope
+                ? { credentialScope: integrationCredentialScope }
+                : {}),
+        });
         const contextPrefetchDeadlineAt = Date.now() + 1_300;
         const preparedRequest = await options.prepareRequest?.({
             event,
@@ -11343,7 +11352,8 @@ export function createProductionAgentHandler(options) {
         }
         setupMark("prepDone");
         workerStep("env_config");
-        const enrichedMessageThunk = () => enrichMessage(requestMessage, requestReferences);
+        const integrationMessage = [...integrationIntents, requestMessage].join("\n\n");
+        const enrichedMessageThunk = () => enrichMessage(integrationMessage, requestReferences);
         const loopSettingsThunk = () => readAgentLoopSettings({
             userEmail: ownerEmail ?? getRequestUserEmail() ?? null,
             orgId: getRequestOrgId() ?? null,
@@ -11633,7 +11643,7 @@ export function createProductionAgentHandler(options) {
             }),
             presendCap("files", filesContextThunk, "", 12000),
             presendCap("loopSettings", loopSettingsThunk, fallbackLoopSettings, 9000),
-            presendCap("enrichedMessage", enrichedMessageThunk, requestMessage, 9000),
+            presendCap("enrichedMessage", enrichedMessageThunk, integrationMessage, 9000),
             presendCap("jevContextCredentials", () => getJevContextCredentials(ownerEmail ?? getRequestUserEmail()), { apiKey: undefined, personalApiKey: undefined, builderAuth: null }, 9000),
             presendCap("priorConnection", 
             // The foreground of a dispatched run never prompts the model; the

package/dist/agentkit/capabilities.d.ts

@@ -1,5 +1,6 @@
+import type { AgentChatReference } from "../agent/types.js";
 import type { CredentialContext } from "../credentials/index.js";
-export type AgentKitCapabilityAppId = "design" | "slides";
+export type AgentKitCapabilityAppId = string;
 export interface AgentKitIntegrationCapability {
     id: string;
     label: string;
@@ -13,10 +14,11 @@ export interface AgentKitCapabilityCatalog {
     };
     integrations: AgentKitIntegrationCapability[];
 }
-export declare function isAgentKitFigmaSourceAvailable(context: CredentialContext): Promise<boolean>;
+export declare function isAgentKitFigmaSourceAvailable(context: CredentialContext, appId?: AgentKitCapabilityAppId): Promise<boolean>;
 export declare function listAgentKitCapabilities(appId: AgentKitCapabilityAppId, context: CredentialContext): Promise<AgentKitCapabilityCatalog>;
 export declare function readAgentKitIntegrationIntent(appId: AgentKitCapabilityAppId, provider: string, context: CredentialContext): Promise<{
     id: string;
     title: string;
     context: string;
 } | null>;
+export declare function resolveAgentKitIntegrationReferences(appId: string, references: readonly AgentChatReference[], context: CredentialContext): Promise<string[]>;

package/dist/agentkit/capabilities.js

@@ -1,7 +1,9 @@
+import { fail } from "../action.js";
+import { workspaceIntegrationMessagesForUser } from "../localization/workspace-integration-messages.js";
 import { parseMergedKey } from "../mcp-client/remote-store.js";
 import { isMcpToolAllowedForRequest } from "../mcp-client/visibility.js";
 import { hasOAuthTokens } from "../oauth-tokens/index.js";
-import { defaultProviderApiCredentialResolver, getProviderApiConfig, isProviderApiId, listProviderApiIdsForTemplateUse, } from "../provider-api/index.js";
+import { defaultProviderApiCredentialResolver, getProviderApiConfig, isProviderApiId, getRegisteredProviderApiRuntimeOptions, listRegisteredCustomProviderCapabilities, } from "../provider-api/index.js";
 import { getMcpManagerForCurrentRequest } from "../server/agent-chat/mcp-glue.js";
 import { getRequestContext, runWithRequestContext, } from "../server/request-context.js";
 import { resolveWorkspaceConnectionForApp } from "../workspace-connections/index.js";
@@ -50,19 +52,22 @@ function workspaceProvider(auth) {
     return "workspaceProvider" in auth ? auth.workspaceProvider : undefined;
 }
 async function groupHasCredentials(appId, provider, keys, context) {
-    const config = getProviderApiConfig(provider);
-    const resolved = await Promise.all(keys.map((key) => defaultProviderApiCredentialResolver({
+    const runtime = getRegisteredProviderApiRuntimeOptions(appId);
+    const config = getProviderApiConfig(provider, runtime?.providerOverrides);
+    const providerWorkspace = workspaceProvider(config.auth);
+    const resolved = await Promise.all(keys.map((key) => (runtime?.resolveCredential ?? defaultProviderApiCredentialResolver)({
         appId,
         provider,
         key,
         ctx: context,
-        workspaceProvider: workspaceProvider(config.auth),
-        localCredentialSource: `${appId}_local`,
+        ...(providerWorkspace ? { workspaceProvider: providerWorkspace } : {}),
+        localCredentialSource: runtime?.localCredentialSource ?? "app_local",
     })));
     return resolved.every(Boolean);
 }
 async function isIntegrationAvailable(appId, provider, context) {
-    const config = getProviderApiConfig(provider);
+    const runtime = getRegisteredProviderApiRuntimeOptions(appId);
+    const config = getProviderApiConfig(provider, runtime?.providerOverrides);
     if (config.auth.type === "oauth-bearer") {
         if (config.auth.workspaceProvider) {
             const connection = await resolveWorkspaceConnectionForApp({
@@ -140,18 +145,15 @@ async function listConnectedMcpIntegrations() {
             : [];
     });
 }
-export async function isAgentKitFigmaSourceAvailable(context) {
-    return inCapabilityScope(context, () => listProviderApiIdsForTemplateUse("design").includes("figma") &&
-        isIntegrationAvailable("design", "figma", context));
+export async function isAgentKitFigmaSourceAvailable(context, appId = "design") {
+    return inCapabilityScope(context, () => (getRegisteredProviderApiRuntimeOptions(appId)?.providerIds ?? []).includes("figma") && isIntegrationAvailable(appId, "figma", context));
 }
 export async function listAgentKitCapabilities(appId, context) {
     return inCapabilityScope(context, async () => {
-        const supported = listProviderApiIdsForTemplateUse(appId);
-        const figmaAvailable = await isAgentKitFigmaSourceAvailable(context);
-        const integrations = await Promise.all(supported
-            .filter((provider) => provider !== "figma")
-            .map(async (id) => {
-            const config = getProviderApiConfig(id);
+        const supported = (getRegisteredProviderApiRuntimeOptions(appId)?.providerIds ?? []).filter(isProviderApiId);
+        const figmaAvailable = await isAgentKitFigmaSourceAvailable(context, appId);
+        const integrations = await Promise.all(supported.map(async (id) => {
+            const config = getProviderApiConfig(id, getRegisteredProviderApiRuntimeOptions(appId)?.providerOverrides);
             return (await isIntegrationAvailable(appId, id, context))
                 ? {
                     id,
@@ -164,6 +166,7 @@ export async function listAgentKitCapabilities(appId, context) {
             sources: { figma: { available: figmaAvailable } },
             integrations: [
                 ...integrations.filter((integration) => integration !== null),
+                ...(await listRegisteredCustomProviderCapabilities(appId, context)).map((entry) => ({ ...entry, kind: "provider-api" })),
                 ...(await listConnectedMcpIntegrations()),
             ],
         };
@@ -178,6 +181,7 @@ export async function readAgentKitIntegrationIntent(appId, provider, context) {
             if (!serverId ||
                 !isMcpServerInScope(serverId) ||
                 !manager.hasServer(serverId) ||
+                !manager.getStatus().connectedServers.includes(serverId) ||
                 !config ||
                 !manager
                     .getToolsForServer(serverId)
@@ -194,14 +198,23 @@ export async function readAgentKitIntegrationIntent(appId, provider, context) {
                 ].join("\n"),
             };
         }
-        const supported = listProviderApiIdsForTemplateUse(appId);
+        if (!isProviderApiId(provider)) {
+            const custom = (await listRegisteredCustomProviderCapabilities(appId, context)).find((entry) => entry.id === provider);
+            return custom
+                ? {
+                    id: provider,
+                    title: custom.label,
+                    context: `The user selected the connected ${custom.label} integration for this request. Use its available provider tools when relevant; this selection is not retrieved data or proof an operation succeeded.`,
+                }
+                : null;
+        }
+        const supported = (getRegisteredProviderApiRuntimeOptions(appId)?.providerIds ?? []).filter(isProviderApiId);
         if (!isProviderApiId(provider) ||
             !supported.includes(provider) ||
-            provider === "figma" ||
             !(await isIntegrationAvailable(appId, provider, context))) {
             return null;
         }
-        const label = displayLabel(getProviderApiConfig(provider).label);
+        const label = displayLabel(getProviderApiConfig(provider, getRegisteredProviderApiRuntimeOptions(appId)?.providerOverrides).label);
         return {
             id: provider,
             title: label,
@@ -212,3 +225,43 @@ export async function readAgentKitIntegrationIntent(appId, provider, context) {
         };
     });
 }
+export async function resolveAgentKitIntegrationReferences(appId, references, context) {
+    const integrations = references.filter((reference) => reference.refType === "integration" ||
+        reference.source === "workspace-integration");
+    if (!integrations.length)
+        return [];
+    const messages = await workspaceIntegrationMessagesForUser(context.userEmail);
+    if (integrations.length > 20) {
+        fail(messages.limit, {
+            errorCode: "workspace_integration_limit",
+            statusCode: 400,
+        });
+    }
+    const selected = new Set();
+    const intents = [];
+    for (const reference of integrations) {
+        const id = reference.refId;
+        if (!appId.trim() ||
+            reference.type !== "mention" ||
+            reference.refType !== "integration" ||
+            !id ||
+            id.length > 200) {
+            fail(messages.invalid, {
+                errorCode: "workspace_integration_invalid",
+                statusCode: 400,
+            });
+        }
+        if (selected.has(id))
+            continue;
+        selected.add(id);
+        const intent = await readAgentKitIntegrationIntent(appId, id, context);
+        if (!intent) {
+            fail(messages.unavailable, {
+                errorCode: "workspace_integration_unavailable",
+                statusCode: 403,
+            });
+        }
+        intents.push(intent.context);
+    }
+    return intents;
+}

package/dist/app-config/experience-profiles.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const experienceProfilesConfig: z.ZodObject<{
+    referenceEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;

package/dist/app-config/experience-profiles.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export const experienceProfilesConfig = z.object({
+    referenceEmails: z.array(z.string().email()).default([]).meta({
+        env: "EXPERIENCE_REFERENCE_EMAILS",
+        doc: "Reviewers authorized to select the private reference experience. Empty denies reference access.",
+    }),
+});

package/dist/app-config/onboarding.d.ts

@@ -1,5 +1,7 @@
 import { z } from "zod";
 export declare const onboardingConfig: z.ZodObject<{
+    builderSignupExperiment: z.ZodDefault<z.ZodBoolean>;
+    builderSignupExperimentOverride: z.ZodOptional<z.ZodBoolean>;
     firstRunCreditsExperiment: z.ZodDefault<z.ZodEnum<{
         v1: "v1";
         v2: "v2";

package/dist/app-config/onboarding.js

@@ -1,5 +1,10 @@
 import { z } from "zod";
 export const onboardingConfig = z.object({
+    builderSignupExperiment: z.boolean().default(false),
+    builderSignupExperimentOverride: z.boolean().optional().meta({
+        env: "BUILDER_SIGNUP_EXPERIMENT",
+        doc: "Enable the pre-signup automatic Builder account experiment for Design.",
+    }),
     firstRunCreditsExperiment: z.enum(["v1", "v2"]).default("v1"),
     firstRunCreditsExperimentOverride: z.literal("v1").optional().meta({
         env: "FIRST_RUN_CREDITS_EXPERIMENT",

package/dist/app-config/schema.d.ts

@@ -169,6 +169,9 @@ export declare const appConfigSchema: z.ZodObject<{
         workspaceOwnerEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
         defaultOwnerEmail: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    experienceProfiles: z.ZodPrefault<z.ZodObject<{
+        referenceEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     extensions: z.ZodPrefault<z.ZodObject<{
         iframeImageSources: z.ZodDefault<z.ZodArray<z.ZodString>>;
         iframeMediaSources: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -268,6 +271,8 @@ export declare const appConfigSchema: z.ZodObject<{
         inferredSentimentModel: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     onboarding: z.ZodPrefault<z.ZodObject<{
+        builderSignupExperiment: z.ZodDefault<z.ZodBoolean>;
+        builderSignupExperimentOverride: z.ZodOptional<z.ZodBoolean>;
         firstRunCreditsExperiment: z.ZodDefault<z.ZodEnum<{
             v1: "v1";
             v2: "v2";

package/dist/app-config/schema.js

@@ -8,6 +8,7 @@ import { authConfig } from "./auth.js";
 import { clipsConfig } from "./clips.js";
 import { decisionsConfig } from "./decisions.js";
 import { dispatchConfig } from "./dispatch.js";
+import { experienceProfilesConfig } from "./experience-profiles.js";
 import { extensionsConfig } from "./extensions.js";
 import { hostedStorageConfig } from "./hosted-storage.js";
 import { integrationsConfig } from "./integrations.js";
@@ -68,6 +69,7 @@ export const appConfigSchema = z.object({
     clips: clipsConfig.prefault({}),
     decisions: decisionsConfig.prefault({}),
     dispatch: dispatchConfig.prefault({}),
+    experienceProfiles: experienceProfilesConfig.prefault({}),
     extensions: extensionsConfig.prefault({}),
     hostedStorage: hostedStorageConfig.prefault({}),
     integrations: integrationsConfig.prefault({}),

package/dist/application-state/handlers.d.ts

@@ -36,18 +36,18 @@ export declare const listComposeDrafts: import("h3").EventHandlerWithFetch<impor
 export declare const getComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Record<string, unknown> | null>>;
 export declare const putComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<any>>;
 export declare const saveComposeDraft: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    errorCode?: undefined;
     value?: undefined;
     error: string;
     revision?: undefined;
+    errorCode?: undefined;
     details?: undefined;
 } | {
-    errorCode?: undefined;
     error?: undefined;
     value: {
         id: string;
     };
     revision: string;
+    errorCode?: undefined;
     details?: undefined;
 } | {
     value?: undefined;

package/dist/client/agent-chat.d.ts

@@ -1,4 +1,4 @@
-import { type AgentActionScope, type AgentChatAttachment, type MentionItemMedia } from "../agent/types.js";
+import { type AgentActionScope, type AgentChatAttachment, type AgentChatReference, type MentionItemMedia } from "../agent/types.js";
 import type { ReasoningEffort } from "../shared/reasoning-effort.js";
 import { type McpAppModelContextContentPart } from "./mcp-app-host.js";
 export { appendAgentChatContextToMessage } from "../shared/agent-chat-context.js";
@@ -19,6 +19,7 @@ export interface AgentChatMessage {
     uploadedReferenceImages?: string[];
     images?: string[];
     attachments?: AgentChatAttachment[];
+    references?: AgentChatReference[];
     /** Stable tab identifier — auto-generated if omitted */
     tabId?: string;
     targetTabId?: string;
@@ -190,6 +191,7 @@ export interface ParsedSubmitChat {
     targetTabId?: string;
     images?: string[];
     attachments?: AgentChatAttachment[];
+    references?: AgentChatReference[];
     requestMode?: AgentChatRequestMode;
     submitMessageId?: string;
     submissionExpiresAt?: number;

package/dist/client/agent-chat.js

@@ -1,4 +1,5 @@
 import { normalizeAgentActionScope, tryNormalizeAgentActionScope, } from "../agent/types.js";
+import { parseAgentChatReferences } from "../shared/agent-chat-references.js";
 import { formatAgentSelectionPreamble } from "../shared/agent-selection.js";
 import { parseBase64DataUrl } from "../shared/data-url.js";
 import { trackEvent } from "./analytics.js";
@@ -575,6 +576,7 @@ function isDirectMcpAppEmbedSession() {
 function hasMcpAppLocalPayload(opts, additionalSubmitMessageId) {
     return Boolean(opts.attachments?.length ||
         opts.images?.length ||
+        opts.references?.length ||
         opts.referenceImagePaths?.length ||
         opts.uploadedReferenceImages?.length ||
         opts.usageLabel ||
@@ -653,6 +655,7 @@ function mcpAppHostContent(opts) {
 }
 function hasMcpAppLocalOnlySemantics(opts, content) {
     return Boolean(content === null ||
+        opts.references?.length ||
         opts.referenceImagePaths?.length ||
         opts.uploadedReferenceImages?.length ||
         opts.usageLabel ||
@@ -805,6 +808,11 @@ export function parseSubmitChatMessage(event) {
         targetTabId: nonEmptyString(raw.targetTabId),
         images,
         attachments: parseSubmitChatAttachments(raw.attachments),
+        ...(raw.references === undefined
+            ? {}
+            : {
+                references: parseAgentChatReferences(raw.references),
+            }),
         requestMode: normalizeAgentChatRequestMode(raw.requestMode ?? raw.mode),
         submitMessageId: typeof raw.submitMessageId === "string" ? raw.submitMessageId : undefined,
         ...(hasSubmissionExpiresAt

package/dist/client/agentkit-chat/transport.d.ts

@@ -1 +1,2 @@
-export { createAgentNativeAgentKitTransport } from "../chat/agentkit-agent-native.js";
+export { createAgentNativeAgentKitTransport, getAgentNativeAgentKitUploadDriver, clearAgentNativeAgentKitUploads, } from "../chat/agentkit-agent-native.js";
+export { createAgentNativeUploadRuntime, fileUploadUrlForChatApi, } from "../chat/native-uploads.js";

package/dist/client/agentkit-chat/transport.js

@@ -1 +1,2 @@
-export { createAgentNativeAgentKitTransport } from "../chat/agentkit-agent-native.js";
+export { createAgentNativeAgentKitTransport, getAgentNativeAgentKitUploadDriver, clearAgentNativeAgentKitUploads, } from "../chat/agentkit-agent-native.js";
+export { createAgentNativeUploadRuntime, fileUploadUrlForChatApi, } from "../chat/native-uploads.js";

package/dist/client/auth/builder-signup.d.ts

@@ -0,0 +1,14 @@
+export type BuilderSignupAssignment = {
+    status: "assigned";
+    id: string;
+    variant: "control" | "automatic";
+    policy: string;
+} | {
+    status: "disabled";
+} | {
+    status: "unavailable";
+};
+export declare function getBuilderSignupAssignment(): Promise<BuilderSignupAssignment>;
+export declare function acceptBuilderSignupAssignment(assignmentId: string, attemptId: string, method: "password" | "magic-link" | "google", email?: string): Promise<void>;
+export declare function activateBuilderSignupAssignment(): Promise<"connected" | "fallback" | "disabled">;
+export declare function hasPendingBuilderSignupAssignment(): boolean;

package/dist/client/auth/builder-signup.js

@@ -0,0 +1,75 @@
+import { agentNativePath } from "../api-path.js";
+async function request(body, signal = AbortSignal.timeout(8000)) {
+    const response = await fetch(agentNativePath("/_agent-native/auth/builder-signup-experiment"), {
+        ...(body
+            ? {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            }
+            : {}),
+        credentials: "same-origin",
+        signal,
+    });
+    if (!response.ok)
+        throw new Error(`Builder signup request failed (${response.status})`);
+    const result = await response.json();
+    if (!result || typeof result !== "object" || Array.isArray(result))
+        throw new Error("Invalid Builder signup response");
+    return result;
+}
+export async function getBuilderSignupAssignment() {
+    const result = await request();
+    if (result.status === "disabled")
+        return { status: "disabled" };
+    if (result.status === "assigned" &&
+        typeof result.id === "string" &&
+        typeof result.policy === "string" &&
+        (result.variant === "control" || result.variant === "automatic"))
+        return {
+            status: "assigned",
+            id: result.id,
+            policy: result.policy,
+            variant: result.variant,
+        };
+    throw new Error("Invalid Builder signup assignment");
+}
+export async function acceptBuilderSignupAssignment(assignmentId, attemptId, method, email) {
+    const result = await request({
+        operation: "accept",
+        assignmentId,
+        attemptId,
+        method,
+        ...(email ? { email } : {}),
+    });
+    if (result.status !== "accepted")
+        throw new Error("Builder signup acceptance was not recorded");
+}
+export async function activateBuilderSignupAssignment() {
+    const deadline = Date.now() + 30000;
+    const signal = AbortSignal.timeout(30000);
+    try {
+        while (Date.now() < deadline) {
+            const result = await request({ operation: "activate" }, signal);
+            if (result.status === "connected" ||
+                result.status === "fallback" ||
+                result.status === "disabled")
+                return result.status;
+            if (result.status !== "pending")
+                throw new Error("Builder signup activation did not complete");
+            await new Promise((resolve) => setTimeout(resolve, Math.min(500, Math.max(0, deadline - Date.now()))));
+        }
+        throw new Error("Builder signup activation is still pending");
+    }
+    finally {
+        if (typeof document !== "undefined")
+            document.cookie =
+                "an_builder_signup_pending=; Path=/; Max-Age=0; SameSite=Lax";
+    }
+}
+export function hasPendingBuilderSignupAssignment() {
+    return (typeof document !== "undefined" &&
+        document.cookie
+            .split(";")
+            .some((value) => value.trim() === "an_builder_signup_pending=1"));
+}

package/dist/client/chat/agentkit-agent-native.d.ts

@@ -1,5 +1,9 @@
+import type { AgentKitUploadDriver } from "@agent-native/agentkit";
+import type { AgentTransport } from "@agent-native/agentkit/protocol";
 import { type AgentKitProtocolAdapter, type CreateAgentKitProtocolAdapterOptions } from "./agentkit-protocol.js";
 import { type AgentChatRuntime, type CreateAgentNativeChatRuntimeOptions } from "./runtime.js";
+export declare function getAgentNativeAgentKitUploadDriver(transport: AgentTransport): AgentKitUploadDriver | undefined;
+export declare function clearAgentNativeAgentKitUploads(transport: object): void;
 export interface CreateAgentNativeAgentKitTransportOptions extends CreateAgentNativeChatRuntimeOptions {
     /** Optional host runtime executed through AgentKit's protocol lifecycle. */
     readonly runtime?: AgentChatRuntime;

package/dist/client/chat/agentkit-agent-native.js

@@ -11,10 +11,18 @@ import { CHAT_CAPABILITY_UNAVAILABLE_MESSAGE, CHAT_CAPABILITY_UNSUPPORTED_MESSAG
 import { dispatchAgentChatRunning } from "../use-agent-chat-running-threads.js";
 import { appendChatThreadScopeParams, } from "../use-chat-threads.js";
 import { AGENT_NATIVE_PROTOCOL_METADATA_KEY, createAgentKitProtocolAdapter, } from "./agentkit-protocol.js";
+import { createAgentNativeUploadRuntime, fileUploadUrlForChatApi, } from "./native-uploads.js";
 import { trackRunFeedback, trackRunOutcome } from "./run-outcome-telemetry.js";
 import { runOutcomeForCode } from "./run-outcome.js";
 import { createAgentNativeChatRuntime, isAgentNativeChatRuntime, } from "./runtime.js";
 import { trackTurnSubmitted } from "./turn-submitted-telemetry.js";
+const nativeUploadCleanups = new WeakMap();
+export function getAgentNativeAgentKitUploadDriver(transport) {
+    return nativeUploadCleanups.has(transport) ? transport.upload : undefined;
+}
+export function clearAgentNativeAgentKitUploads(transport) {
+    nativeUploadCleanups.get(transport)?.();
+}
 const RUN_SLOT_POLL_INTERVAL_MS = 150;
 const RUN_SLOT_STABLE_POLLS = 2;
 const SAFE_BOUNDARY_POLL_INTERVAL_MS = 500;
@@ -2267,6 +2275,15 @@ export function createAgentNativeAgentKitTransport(options = {}) {
     const apiUrl = options.apiUrl ?? agentNativePath("/_agent-native/agent-chat");
     const fetcher = options.fetch ?? fetch;
     const now = options.adapter?.now ?? (() => new Date().toISOString());
+    const defaultUploads = !options.operations?.createUpload &&
+        !options.operations?.completeUpload &&
+        !options.operations?.cancelUpload
+        ? createAgentNativeUploadRuntime({
+            url: fileUploadUrlForChatApi(apiUrl),
+            fetch: fetcher,
+            headers: (threadId) => headers({ sessionId: threadId }),
+        })
+        : undefined;
     const promotionClaimIds = new Map();
     const durableAssistantMessageIdsByRun = new Map();
     const assistantHistoryMessageIdsByRun = new Map();
@@ -3545,6 +3562,7 @@ export function createAgentNativeAgentKitTransport(options = {}) {
             connectionRequests: true,
         },
         operations: {
+            ...defaultUploads?.operations,
             getThread: async ({ threadId }) => {
                 const thread = await snapshot(threadId);
                 if (!thread)
@@ -4081,6 +4099,11 @@ export function createAgentNativeAgentKitTransport(options = {}) {
         : `${apiUrl}/capabilities`;
     transport = {
         ...protocolTransport,
+        ...(defaultUploads ? { upload: defaultUploads.upload } : {}),
+        async dispose() {
+            defaultUploads?.dispose();
+            await protocolTransport.dispose();
+        },
         assertAiSetupReady,
         startRun: (input, context) => startRunTrackingRunningState(input, context),
         async discoverCapabilities(input, context) {
@@ -4331,5 +4354,7 @@ export function createAgentNativeAgentKitTransport(options = {}) {
             }
         },
     };
+    if (defaultUploads)
+        nativeUploadCleanups.set(transport, defaultUploads.dispose);
     return transport;
 }

package/dist/client/chat/composer-draft.d.ts

@@ -2,13 +2,7 @@ import { z } from "zod";
 declare const composerContextDraftSchema: z.ZodObject<{
     designSystemId: z.ZodNullable<z.ZodString>;
     references: z.ZodArray<z.ZodObject<{
-        source: z.ZodEnum<{
-            design: "design";
-            figma: "figma";
-            integration: "integration";
-            slides: "slides";
-            website: "website";
-        }>;
+        source: z.ZodString;
         id: z.ZodString;
         title: z.ZodString;
         url: z.ZodOptional<z.ZodString>;

package/dist/client/chat/composer-draft.js

@@ -7,7 +7,11 @@ const composerContextDraftSchema = z.object({
     designSystemId: z.string().min(1).max(200).nullable(),
     references: z
         .array(z.object({
-        source: z.enum(["design", "slides", "figma", "website", "integration"]),
+        source: z
+            .string()
+            .min(1)
+            .max(128)
+            .regex(/^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/i),
         id: z.string().min(1).max(2048),
         title: z.string().max(2048),
         url: composerWebsiteUrlSchema.optional(),

package/dist/client/chat/native-uploads.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTransport } from "@agent-native/agentkit/protocol";
+export declare function fileUploadUrlForChatApi(apiUrl: string): string;
+export declare function createAgentNativeUploadRuntime(options?: {
+    url?: string;
+    fetch?: typeof fetch;
+    headers?: (threadId: string) => Promise<Headers>;
+}): {
+    operations: Required<Pick<AgentTransport, "cancelUpload" | "completeUpload" | "createUpload">>;
+    upload: import("@agent-native/agentkit").AgentUploadDriver;
+    dispose: () => void;
+};