@agent-native/toolkit 0.225.1 → 0.226.0-nightly-20261106182619

package/src/app/auth/AuthPage.tsx

@@ -11,6 +11,11 @@ import {
   normalizeOAuthReturnPath,
   shouldRetryAuthSessionProbe,
 } from "@agent-native/core/client/auth/auth-page-helpers";
+import {
+  acceptBuilderSignupAssignment,
+  getBuilderSignupAssignment,
+  type BuilderSignupAssignment,
+} from "@agent-native/core/client/auth/builder-signup";
 import { whenConsentDecided } from "@agent-native/core/client/consent";
 import { openOAuthPopup } from "@agent-native/core/client/oauth-popup";
 import { navigateForSession } from "@agent-native/core/client/use-session";
@@ -260,13 +265,15 @@ async function requestJson(
   return { response, data, readable };
 }
 
+let builderSignupTelemetry: Record<string, unknown> = {};
+
 function trackAuth(
   app: string,
   name: string,
   properties: Record<string, unknown> = {},
-  email: string,
+  email?: string,
 ): void {
-  if (!isValidEmail(email) || isTestIdentityEmail(email)) return;
+  if (email && (!isValidEmail(email) || isTestIdentityEmail(email))) return;
   if (
     isSyntheticTrafficValue(
       (
@@ -295,7 +302,11 @@ function trackAuth(
         "https://analytics.agent-native.com/track",
       window.location.hostname,
     );
-    const legacyProperties = { app, ...properties };
+    const legacyProperties = {
+      app,
+      ...(app === "design" ? builderSignupTelemetry : {}),
+      ...properties,
+    };
     const events: Array<{
       name: string;
       properties: Record<string, unknown>;
@@ -656,12 +667,63 @@ export function AuthPage(props: AuthPageProps) {
     googleAuthMode,
     builderPreviewLocalDevEnabled,
   } = props;
+  const [builderSignup, setBuilderSignup] =
+    React.useState<BuilderSignupAssignment | null>(
+      trackingApp === "design" ? null : { status: "disabled" },
+    );
+  const builderSignupRequest =
+    React.useRef<Promise<BuilderSignupAssignment> | null>(null);
+  React.useEffect(() => {
+    if (trackingApp !== "design") return;
+    builderSignupTelemetry = {};
+    let disposed = false;
+    builderSignupRequest.current ??= getBuilderSignupAssignment();
+    void builderSignupRequest.current.then(
+      (assignment) => {
+        if (disposed) return;
+        setBuilderSignup(assignment);
+      },
+      () => {
+        if (!disposed) {
+          builderSignupTelemetry = {};
+          setBuilderSignup({ status: "unavailable" });
+          trackAuth(trackingApp, "auth.builder_signup_experiment_unavailable", {
+            stage: "assignment",
+          });
+        }
+      },
+    );
+    return () => {
+      disposed = true;
+    };
+  }, [trackingApp]);
   const [localePreference, setLocalePreference] = React.useState("system");
   const [locale, setLocale] = React.useState(defaultLocale);
   const [browserLocationReady, setBrowserLocationReady] = React.useState(false);
   React.useEffect(() => setBrowserLocationReady(true), []);
   const [localeMenuOpen, setLocaleMenuOpen] = React.useState(false);
   const [view, setView] = React.useState<AuthView>(props.initialView);
+  const builderSignupExposure = React.useRef<string | null>(null);
+  React.useEffect(() => {
+    if (
+      builderSignup?.status !== "assigned" ||
+      !["signup", "magicLink", "googleOnly"].includes(view) ||
+      builderSignupExposure.current === builderSignup.id
+    )
+      return;
+    builderSignupExposure.current = builderSignup.id;
+    builderSignupTelemetry = {
+      experiment_id: "design_builder_signup_v1",
+      experiment_variant: builderSignup.variant,
+      assignment_id: builderSignup.id,
+    };
+    trackAuth(
+      trackingApp,
+      "auth.builder_signup_experiment_exposed",
+      builderSignupTelemetry,
+    );
+  }, [builderSignup, trackingApp, view]);
+
   const [messages, setMessages] = React.useState<Record<string, Notice>>({});
   const [submitting, setSubmitting] = React.useState<string | null>(null);
   const [localDevAvailable, setLocalDevAvailable] = React.useState(false);
@@ -1428,10 +1490,52 @@ export function AuthPage(props: AuthPageProps) {
     [publicOAuthOrigin, runtimeAppBasePath],
   );
 
+  const prepareBuilderSignup = React.useCallback(
+    async (
+      method: "password" | "magic-link" | "google",
+      email?: string,
+      flowId = createFlowId(),
+    ): Promise<string | undefined> => {
+      if (
+        builderSignup?.status !== "assigned" ||
+        builderSignup.variant !== "automatic" ||
+        view === "login"
+      )
+        return undefined;
+      try {
+        await acceptBuilderSignupAssignment(
+          builderSignup.id,
+          flowId,
+          method,
+          email,
+        );
+        return flowId;
+      } catch {
+        trackAuth(
+          trackingApp,
+          "auth.builder_signup_experiment_unavailable",
+          { stage: "acceptance" },
+          email,
+        );
+        return undefined;
+      }
+    },
+    [builderSignup, trackingApp, view],
+  );
+
   const startGoogle = React.useCallback(async () => {
-    if (!showGoogle || googleBusy) return;
+    if (!showGoogle || googleBusy || !builderSignup) return;
     setGoogleBusy(true);
     setNotice("google", null);
+    const flowId = createFlowId();
+    const redirectAfterAcceptance = async (url: string) => {
+      const attemptId = await prepareBuilderSignup("google", undefined, flowId);
+      const targetUrl = new URL(url, window.location.origin);
+      if (attemptId)
+        targetUrl.searchParams.set("builder_signup_attempt", attemptId);
+      targetUrl.searchParams.set("flow_id", flowId);
+      window.location.replace(targetUrl.toString());
+    };
     try {
       window.sessionStorage.setItem("__an_signin", "1");
     } catch {
@@ -1447,10 +1551,9 @@ export function AuthPage(props: AuthPageProps) {
       })
     ) {
       const params = new URLSearchParams({ return: target });
-      window.location.replace(`${identityHref}?${params.toString()}`);
+      await redirectAfterAcceptance(`${identityHref}?${params.toString()}`);
       return;
     }
-    const flowId = createFlowId();
     oauthFlowId.current = flowId;
     const flow = resolveGoogleFlow();
     const nativeDesktop = flow === "redirect" && isAgentNativeDesktop();
@@ -1473,7 +1576,7 @@ export function AuthPage(props: AuthPageProps) {
         return: oauthTarget,
         redirect: "1",
       });
-      window.location.replace(`${authUrl}?${params.toString()}`);
+      await redirectAfterAcceptance(`${authUrl}?${params.toString()}`);
       return;
     }
     const verifier = createVerifier();
@@ -1507,7 +1610,7 @@ export function AuthPage(props: AuthPageProps) {
             return: oauthTarget,
             redirect: "1",
           });
-          window.location.replace(`${authUrl}?${params.toString()}`);
+          await redirectAfterAcceptance(`${authUrl}?${params.toString()}`);
           return;
         }
         try {
@@ -1528,15 +1631,17 @@ export function AuthPage(props: AuthPageProps) {
           return: oauthTarget,
           redirect: "1",
         });
-        window.location.replace(`${authUrl}?${params.toString()}`);
+        await redirectAfterAcceptance(`${authUrl}?${params.toString()}`);
         return;
       }
     }
     try {
+      const attemptId = await prepareBuilderSignup("google", undefined, flowId);
       const params = new URLSearchParams({
         return: oauthTarget,
         desktop: "1",
         flow_id: flowId,
+        ...(attemptId ? { builder_signup_attempt: attemptId } : {}),
       });
       const { response, data } = await requestJson(
         `${authUrl}?${params.toString()}`,
@@ -1589,6 +1694,8 @@ export function AuthPage(props: AuthPageProps) {
     apiPath,
     googleAuthUrlPath,
     googleBusy,
+    builderSignup,
+    prepareBuilderSignup,
     identityHref,
     identityBootstrapHref,
     googleViaIdentitySso,
@@ -1819,6 +1926,10 @@ export function AuthPage(props: AuthPageProps) {
         email,
       );
       try {
+        const builderSignupAttemptId = await prepareBuilderSignup(
+          "password",
+          email,
+        );
         const { response, data } = await requestJson(
           apiPath("/_agent-native/auth/register"),
           {
@@ -1826,6 +1937,7 @@ export function AuthPage(props: AuthPageProps) {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
               email,
+              ...(builderSignupAttemptId ? { builderSignupAttemptId } : {}),
               password: signupPassword,
               callbackURL: identityBootstrapHref(resumeHref()),
             }),
@@ -1888,6 +2000,7 @@ export function AuthPage(props: AuthPageProps) {
       signupEmail,
       signupPassword,
       signupPasswordConfirmation,
+      prepareBuilderSignup,
       t,
       trackingApp,
       view,
@@ -2070,6 +2183,10 @@ export function AuthPage(props: AuthPageProps) {
       );
       const desktop = isAgentNativeDesktop();
       try {
+        const builderSignupAttemptId = await prepareBuilderSignup(
+          "magic-link",
+          email,
+        );
         const { response, data } = await requestJson(
           apiPath("/_agent-native/auth/magic-link"),
           {
@@ -2077,6 +2194,7 @@ export function AuthPage(props: AuthPageProps) {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
               email,
+              ...(builderSignupAttemptId ? { builderSignupAttemptId } : {}),
               callbackURL: desktop
                 ? apiPath("/_agent-native/auth/magic-link/desktop-callback")
                 : identityBootstrapHref(resumeHref()),
@@ -2122,6 +2240,7 @@ export function AuthPage(props: AuthPageProps) {
       apiPath,
       identityBootstrapHref,
       magicLinkEmail,
+      prepareBuilderSignup,
       resumeHref,
       setNotice,
       startOAuthExchange,
@@ -2312,6 +2431,29 @@ export function AuthPage(props: AuthPageProps) {
       </button>
     </div>
   ) : null;
+  const builderLegalNote =
+    builderSignup?.status === "assigned" &&
+    builderSignup.variant === "automatic" ? (
+      <p className="legal-note">
+        {t("builderSignupDisclosure")}{" "}
+        <a
+          href="https://www.builder.io/legal/terms"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          {t("legalTerms")}
+        </a>{" "}
+        {t("legalConnector")}{" "}
+        <a
+          href="https://www.builder.io/legal/privacy"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          {t("legalPrivacy")}
+        </a>
+        {t("legalSuffix")}
+      </p>
+    ) : null;
   const legalNote = signupLegalNotice ? (
     <p className="legal-note">
       <span data-i18n="legalPrefix">
@@ -2401,11 +2543,12 @@ export function AuthPage(props: AuthPageProps) {
       submitLabel={t("createAccount")}
       submitProps={{
         "data-i18n": "createAccount",
-        disabled: submitting === "signup",
+        disabled: submitting === "signup" || !builderSignup,
       }}
       footer={
         <>
           {legalNote}
+
           {localModeNote}
         </>
       }
@@ -2541,13 +2684,14 @@ export function AuthPage(props: AuthPageProps) {
             {t("googleNotConfigured")}
           </p>
         ) : null}
+        {view !== "login" && builderLegalNote}
         {showGoogle ? (
           <div className="google-signin" id="google-signin">
             <button
               className={`btn-google ${view === "magicLink" && isValidEmail(magicLinkEmail) ? "magic-link-secondary" : ""}`}
               id="google-btn"
               type="button"
-              disabled={googleBusy}
+              disabled={googleBusy || !builderSignup}
               aria-busy={googleBusy}
               onClick={() => void startGoogle()}
             >
@@ -2583,7 +2727,7 @@ export function AuthPage(props: AuthPageProps) {
             <button
               type="submit"
               id="organization-sso-submit"
-              disabled={ssoBusy || !isValidEmail(ssoEmail)}
+              disabled={!builderSignup || ssoBusy || !isValidEmail(ssoEmail)}
               data-i18n="ssoButton"
             >
               {ssoBusy ? t("checking") : t("ssoButton")}
@@ -2618,7 +2762,9 @@ export function AuthPage(props: AuthPageProps) {
               type="submit"
               id="magic-link-submit"
               className="magic-link-submit"
-              disabled={magicLinkBusy || !isValidEmail(magicLinkEmail)}
+              disabled={
+                !builderSignup || magicLinkBusy || !isValidEmail(magicLinkEmail)
+              }
               data-i18n="sendMagicLink"
             >
               {magicLinkBusy ? t("sending") : t("sendMagicLink")}

package/src/app/chat/AgentKitAssistantChat.spec.tsx

@@ -1332,6 +1332,24 @@ describe("AgentKitAssistantChat host behavior", () => {
     ]);
   });
 
+  it("renders a menu-only provider without optional context items", async () => {
+    const Provider = ({
+      children,
+    }: AssistantChatComposerContextProviderProps) =>
+      children({
+        menuItems: [
+          {
+            id: "native-reference",
+            label: "Native reference",
+            onSelect: vi.fn(),
+          },
+        ],
+      });
+    const ref = createRef<AssistantChatHandle>();
+    await mount(baseProps({ composerContextProvider: Provider }), ref);
+    expect(ref.current).not.toBeNull();
+  });
+
   it("counts provider-owned context against the prefill capacity", async () => {
     const providerItem = {
       key: "provider-reference",
@@ -5174,7 +5192,15 @@ describe("AgentKitAssistantChat host behavior", () => {
     try {
       await expect(
         chatMocks.rootProps.clientOptions.upload(
-          { uploadId: "upload-1", method: "POST", url: "/uploads" },
+          await chatMocks.transportOptions.operations.createUpload({
+            threadId: "test-thread",
+            descriptor: {
+              name: "reference.png",
+              mediaType: "image/png",
+              size: 4,
+              purpose: "message",
+            },
+          }),
           {
             name: "reference.pdf",
             mediaType: "application/pdf",
@@ -5350,7 +5376,15 @@ describe("AgentKitAssistantChat host behavior", () => {
       try {
         const error = await chatMocks.rootProps.clientOptions
           .upload(
-            { uploadId: "upload-1", method: "POST", url: "/uploads" },
+            await chatMocks.transportOptions.operations.createUpload({
+              threadId: "test-thread",
+              descriptor: {
+                name: "reference.png",
+                mediaType: "image/png",
+                size: 4,
+                purpose: "message",
+              },
+            }),
             {
               name: "reference.png",
               mediaType: "image/png",
@@ -5381,7 +5415,15 @@ describe("AgentKitAssistantChat host behavior", () => {
     try {
       await expect(
         chatMocks.rootProps.clientOptions.upload(
-          { uploadId: "upload-1", method: "POST", url: "/uploads" },
+          await chatMocks.transportOptions.operations.createUpload({
+            threadId: "test-thread",
+            descriptor: {
+              name: "reference.png",
+              mediaType: "image/png",
+              size: 4,
+              purpose: "message",
+            },
+          }),
           {
             name: "reference.png",
             mediaType: "image/png",
@@ -6811,6 +6853,16 @@ describe("AgentKitAssistantChat host behavior", () => {
       await ref.current!.sendMessage("Sent by the app", undefined, {
         submitMessageId: "submit-app",
         surface: "deck-outline",
+        references: [
+          {
+            type: "mention",
+            path: "github",
+            name: "GitHub",
+            source: "workspace-integration",
+            refType: "integration",
+            refId: "github",
+          },
+        ],
       });
     });
     await act(async () => {
@@ -6832,6 +6884,16 @@ describe("AgentKitAssistantChat host behavior", () => {
     expect(metadata[1]).toMatchObject({
       submitMessageId: "submit-app",
       agentNativeSurface: "deck-outline",
+      references: [
+        {
+          type: "mention",
+          path: "github",
+          name: "GitHub",
+          source: "workspace-integration",
+          refType: "integration",
+          refId: "github",
+        },
+      ],
     });
   });
 

package/src/app/chat/AgentKitAssistantChat.tsx

@@ -26,7 +26,6 @@ import type {
   AgentTransport,
   AgentThreadSnapshot,
   AgentToolCall,
-  AgentUploadTarget,
   FilePart,
 } from "@agent-native/agentkit/protocol";
 import type { AgentChatAttachment } from "@agent-native/core";
@@ -70,6 +69,10 @@ import {
   useAgentEngineConfigured,
   type AgentEngineConfiguredState,
 } from "@agent-native/core/client/agent-chat";
+import {
+  createAgentNativeUploadRuntime,
+  fileUploadUrlForChatApi,
+} from "@agent-native/core/client/agentkit-chat/transport";
 import { agentNativePath } from "@agent-native/core/client/api-path";
 import {
   compareAndSetClientAppState,
@@ -1948,55 +1951,54 @@ export const AgentKitAssistantChat = forwardRef<
     }),
     [formatDate, props.composerPlaceholder, t],
   );
-  const uploadedFilesRef = useRef(new Map<string, FilePart>());
+  const { session: uploadSession } = useSession();
+  const uploadScopeKey = JSON.stringify([
+    uploadSession?.email ?? null,
+    uploadSession?.orgId ?? null,
+    uploadSession?.authUserId ?? null,
+  ]);
+  const uploadRuntime = useMemo(
+    () =>
+      createAgentNativeUploadRuntime({
+        url: fileUploadUrlForChatApi(
+          props.apiUrl ?? agentNativePath("/_agent-native/agent-chat"),
+        ),
+      }),
+    [props.apiUrl],
+  );
+  useEffect(
+    () => () => uploadRuntime.dispose(),
+    [uploadRuntime, uploadScopeKey],
+  );
   const upload: AgentKitUploadDriver = useCallback(
-    async (target, file, context) => {
-      if (file.size > AGENT_CHAT_UPLOAD_MAX_FILE_BYTES) {
-        throw attachmentTooLargeError(
-          uploadTooLargeMessage(translatorRef.current),
-        );
-      }
-      const form = new FormData();
-      for (const [key, value] of Object.entries(target.fields ?? {})) {
-        form.set(key, value);
-      }
-      form.set("file", file.body, file.name);
-      let response: Response;
+    async (...args) => {
       try {
-        response = await fetch(target.url, {
-          method: target.method,
-          headers: target.headers,
-          body: form,
-          signal: context?.signal,
-        });
-      } catch (error) {
-        if (context?.signal?.aborted) throw error;
+        await uploadRuntime.upload(...args);
+      } catch (cause) {
+        if (args[2]?.signal?.aborted) throw cause;
+        const status =
+          cause && typeof cause === "object" && "status" in cause
+            ? cause.status
+            : undefined;
+        if (typeof status === "number")
+          throw uploadHttpError(status, translatorRef.current);
+        const code =
+          cause && typeof cause === "object" && "code" in cause
+            ? cause.code
+            : undefined;
         throw Object.assign(
-          new Error(translatorRef.current("agentChat.composer.uploadOffline")),
-          { code: "upload_network_error", retryable: true, cause: error },
-        );
-      }
-      // The server's error body is never shown: its text is untranslated.
-      if (!response.ok) {
-        throw uploadHttpError(response.status, translatorRef.current);
-      }
-      const result: unknown = await response.json();
-      const uploaded = asRecord(result);
-      if (typeof uploaded?.url !== "string" || !uploaded.url) {
-        throw Object.assign(
-          new Error(translatorRef.current("agentChat.composer.uploadFailed")),
-          { code: "upload_invalid_response", retryable: false },
+          new Error(
+            translatorRef.current(
+              code === "upload_network_error"
+                ? "agentChat.composer.uploadOffline"
+                : "agentChat.composer.uploadFailed",
+            ),
+          ),
+          { code, cause, retryable: code === "upload_network_error" },
         );
       }
-      uploadedFilesRef.current.set(target.uploadId, {
-        type: "file",
-        name: file.name,
-        mediaType: file.mediaType,
-        url: uploaded.url,
-        ...(typeof uploaded.id === "string" ? { fileId: uploaded.id } : {}),
-      });
     },
-    [],
+    [uploadRuntime],
   );
   const transportThreadIdRef = useRef(threadId);
   const tabIdRef = useRef(props.tabId);
@@ -2036,21 +2038,7 @@ export const AgentKitAssistantChat = forwardRef<
     const operations: NonNullable<
       CreateAgentNativeAgentKitTransportOptions["operations"]
     > = {
-      createUpload: async () =>
-        ({
-          uploadId: createAgentUploadId(),
-          method: "POST",
-          url: agentNativePath("/_agent-native/file-upload"),
-          fields: {},
-        }) satisfies AgentUploadTarget,
-      completeUpload: async ({ uploadId }) => {
-        const uploaded = uploadedFilesRef.current.get(uploadId);
-        if (!uploaded) {
-          throw new Error(`Upload ${uploadId} did not complete.`);
-        }
-        uploadedFilesRef.current.delete(uploadId);
-        return uploaded;
-      },
+      ...uploadRuntime.operations,
       invokeAction: async ({ invocation }) => {
         try {
           const result = await callAction(
@@ -3700,10 +3688,13 @@ const AgentKitAssistantChatBody = forwardRef<
             ? { agentNativeInternalContinuation: true }
             : {}),
           ...(contextScope ? { chatScope: contextScope } : {}),
-          ...(references.length || options.recoveryReferences?.length
+          ...(references.length ||
+          options.references?.length ||
+          options.recoveryReferences?.length
             ? {
                 references: [
                   ...references,
+                  ...(options.references ?? []),
                   ...(options.recoveryReferences ?? []),
                 ],
               }
@@ -5811,12 +5802,11 @@ function AgentKitComposerSurface({
       mounted.current = false;
     };
   }, []);
+  const visibleProviderContextItems = composerContext?.contextItems ?? [];
   const providerContextKeys = new Set(
-    composerContext?.contextItems.map((item) => item.key),
+    visibleProviderContextItems.map((item) => item.key),
   );
-  const visibleContextItems = composerContext
-    ? [...contextItems, ...composerContext.contextItems]
-    : contextItems;
+  const visibleContextItems = [...contextItems, ...visibleProviderContextItems];
   const submissionScope = JSON.stringify([
     threadId,
     props.tabId,
@@ -6273,7 +6263,9 @@ function AgentKitComposerSurface({
             props.availableModels === undefined
           }
           attachmentsEnabled={fileStorageConfigured}
-          onAttachmentRequest={requestFileStorage}
+          {...(!fileStorageConfigured
+            ? { onAttachmentRequest: requestFileStorage }
+            : {})}
           contextButtonTooltipDisabled={fileStoragePromptOpen}
           onAttachmentError={setComposerError}
           onSubmit={submitComposer}

package/src/app/chat/MultiTabAssistantChat.spec.tsx

@@ -5345,6 +5345,27 @@ describe("MultiTabAssistantChat postMessage bridge", () => {
     );
   });
 
+  it("forwards serialized workspace integration references through the app handoff", () => {
+    const references = [
+      {
+        type: "mention" as const,
+        path: "github",
+        name: "GitHub",
+        source: "workspace-integration",
+        refType: "integration",
+        refId: "github",
+      },
+    ];
+    act(() => {
+      dispatchSubmitChat({ message: "Use this integration", references });
+    });
+    expect(chatHandleMocks.sendMessage).toHaveBeenCalledWith(
+      "Use this integration",
+      undefined,
+      { references },
+    );
+  });
+
   it("forwards approval keys as a hidden protocol continuation", () => {
     act(() => {
       dispatchSubmitChat({

package/src/app/chat/MultiTabAssistantChat.tsx

@@ -139,6 +139,7 @@ interface PendingSend {
   actionScope?: AgentActionScope;
   /** See `AgentChatMessage.approvedToolCalls`. */
   approvedToolCalls?: string[];
+  references?: AgentChatMessage["references"];
   /** See `AssistantChatSendOptions.surface`. */
   surface?: string;
 }
@@ -270,6 +271,7 @@ function deliverPendingSend(
     ...(send.trackInRunsTray ? { trackInRunsTray: true } : {}),
     ...(send.requestMode ? { requestMode: send.requestMode } : {}),
     ...(send.attachments ? { attachments: send.attachments } : {}),
+    ...(send.references ? { references: send.references } : {}),
     ...(send.submitMessageId ? { submitMessageId: send.submitMessageId } : {}),
     ...(send.submissionExpiresAt !== undefined
       ? { submissionExpiresAt: send.submissionExpiresAt }
@@ -2554,6 +2556,7 @@ export function MultiTabAssistantChat({
         submit,
         images,
         attachments,
+        references,
         submitMessageId,
         usageLabel,
         actionScope,
@@ -2608,6 +2611,7 @@ export function MultiTabAssistantChat({
         ...(prefillContext ? { prefillContext } : {}),
         images,
         attachments,
+        references,
         submit,
         ...(background ? { trackInRunsTray: true } : {}),
         ...(requestMode ? { requestMode } : {}),