@agent-native/toolkit 0.206.0 → 0.206.1-nightly-20261009213000

package/src/app/i18n/catalogs/zh-TW.ts

@@ -479,9 +479,14 @@ const messages: ToolkitAgentChatTranslation = {
   "composer.skill.uploadFile": "上傳技能檔案",
   "composer.upload": "上傳",
   "composer.uploadFailed": "無法上傳所選檔案。",
-  "composer.fileTooLarge": "此檔案超出上傳大小限制。",
-  "composer.sessionExpired": "工作階段已逾期。請重新整理頁面後再試一次。",
+  "composer.fileTooLarge": "此檔案超過 {{size}} MB 的上傳大小限制。",
+  "composer.sessionExpired": "工作階段已逾期。請重新登入，然後再傳送訊息。",
   "composer.unsupportedFileType": "不支援此檔案類型。",
+  "composer.uploadUnavailable": "目前無法上傳檔案。請稍後再試。",
+  "composer.uploadOffline": "上傳無法連線至伺服器。請檢查網路連線後再試一次。",
+  "composer.submissionNotReady": "聊天尚未準備好傳送。請稍候片刻再傳送。",
+  "composer.submissionScopeChanged": "此聊天在訊息傳送前已變更。請重新傳送。",
+  "composer.attachmentNotSaved": "未隨此聊天儲存",
   "composer.useAttachedContext": "使用附加的上下文。",
   "mentions.commands": "命令",
   "mentions.learnMore": "深入瞭解",
@@ -1081,6 +1086,7 @@ const messages: ToolkitAgentChatTranslation = {
   "recovery.continueUnavailable": "此執行已無法繼續。傳送訊息以繼續。",
   "recovery.retryAttachmentUnavailable":
     "此要求包含無法重試的檔案。請在訊息輸入框中重新附加檔案，然後再試一次。",
+  "recovery.retryWithoutAttachment": "不含附件重試",
   "recovery.deferredSubmissionFailed":
     "無法傳送這則訊息。請檢查連線或聊天設定，然後再試一次。",
   "recovery.credentialRejected":

package/src/app/settings/model/ProviderDialog.spec.tsx

@@ -340,6 +340,7 @@ describe("ProviderDialog", () => {
           outcome: "accepted",
         }),
       );
+      expect(button("Add provider").disabled).toBe(false);
     });
 
     await act(async () => button("Add provider").click());

package/src/app/sharing/ShareButton.spec.tsx

@@ -1395,6 +1395,154 @@ describe("ShareButton", () => {
     expect(queriedActions).not.toContain("list-resource-access-requests");
   });
 
+  it("keeps to the basic share actions when the session cannot run the rest", async () => {
+    sharesData.current = { ...sharesData.current, agentReadable: true };
+    accessRequestsData.current = [patRequest];
+    await act(async () => {
+      root.render(
+        <TooltipProvider>
+          <QueryClientProvider client={queryClient}>
+            <ShareButton
+              resourceType="deck"
+              resourceId="deck-1"
+              basicSharingOnly
+            />
+          </QueryClientProvider>
+        </TooltipProvider>,
+      );
+    });
+
+    const text = container.textContent ?? "";
+    expect(text).toContain("People with access");
+    expect(text).not.toContain("Access requests");
+    expect(text).not.toContain("Share with agents");
+    expect(queriedActions).not.toContain("list-resource-access-requests");
+    expect(queriedActions).toContain("list-resource-shares");
+  });
+
+  it("does not search the organization for people when keeping to the basic share actions", async () => {
+    const fetchMock = vi.fn(async () => Response.json({ members: [] }));
+    vi.stubGlobal("fetch", fetchMock);
+    await act(async () => {
+      root.render(
+        <TooltipProvider>
+          <QueryClientProvider client={queryClient}>
+            <ShareButton
+              resourceType="deck"
+              resourceId="deck-1"
+              basicSharingOnly
+            />
+          </QueryClientProvider>
+        </TooltipProvider>,
+      );
+    });
+
+    const input = container.querySelector(
+      'input[placeholder="Add people by email"]',
+    ) as HTMLInputElement;
+    act(() => input.focus());
+    setInputValue(input, "guest@example.com");
+    await act(async () => {
+      await new Promise((resolve) => setTimeout(resolve, 180));
+    });
+
+    expect(
+      fetchMock.mock.calls.some((call) =>
+        String(call[0]).includes("/_agent-native/org/members"),
+      ),
+    ).toBe(false);
+    expect(container.textContent).not.toContain("Could not load people.");
+  });
+
+  it("does not offer the admin role or an email note when keeping to the basic share actions", async () => {
+    await act(async () => {
+      root.render(
+        <QueryClientProvider client={queryClient}>
+          <ShareButton
+            resourceType="deck"
+            resourceId="deck-1"
+            basicSharingOnly
+          />
+        </QueryClientProvider>,
+      );
+    });
+
+    const input = container.querySelector(
+      'input[placeholder="Add people by email"]',
+    ) as HTMLInputElement;
+    setInputValue(input, "guest@example.com");
+    expect(container.textContent).toContain("Notify people");
+    expect(container.textContent).not.toContain("Add a message");
+
+    const roleTrigger = container.querySelector(
+      'button[aria-label="Role"]',
+    ) as HTMLButtonElement | null;
+    await act(async () => roleTrigger?.click());
+    const options = Array.from(
+      document.querySelectorAll<HTMLElement>('[role="option"]'),
+    ).map((option) => option.textContent ?? "");
+    expect(options.some((option) => option.includes("Editor"))).toBe(true);
+    expect(options.some((option) => option.includes("Admin"))).toBe(false);
+  });
+
+  it("offers the admin role and an email note outside the basic share actions", async () => {
+    await act(async () => {
+      root.render(
+        <QueryClientProvider client={queryClient}>
+          <ShareButton resourceType="deck" resourceId="deck-1" />
+        </QueryClientProvider>,
+      );
+    });
+
+    const input = container.querySelector(
+      'input[placeholder="Add people by email"]',
+    ) as HTMLInputElement;
+    setInputValue(input, "guest@example.com");
+    expect(container.textContent).toContain("Add a message");
+
+    const roleTrigger = container.querySelector(
+      'button[aria-label="Role"]',
+    ) as HTMLButtonElement | null;
+    await act(async () => roleTrigger?.click());
+    expect(
+      Array.from(
+        document.querySelectorAll<HTMLElement>('[role="option"]'),
+      ).some((option) => option.textContent?.includes("Admin")),
+    ).toBe(true);
+  });
+
+  it("lets a host size the joined copy control through quickCopy.className", async () => {
+    await act(async () => {
+      root.render(
+        <TooltipProvider>
+          <QueryClientProvider client={queryClient}>
+            <ShareButton
+              resourceType="document"
+              resourceId="doc-1"
+              quickCopy={{
+                label: "Copy page link",
+                copiedLabel: "Copied page link",
+                onCopy: async () => true,
+                className: "widget-joined-share",
+              }}
+            />
+          </QueryClientProvider>
+        </TooltipProvider>,
+      );
+    });
+
+    const joined = container.querySelector(".widget-joined-share");
+    expect(joined).not.toBeNull();
+    expect(
+      joined?.contains(
+        container.querySelector('button[aria-label="Copy page link"]'),
+      ),
+    ).toBe(true);
+    expect(
+      joined?.contains(container.querySelector('button[aria-label="Share"]')),
+    ).toBe(true);
+  });
+
   // Keep the non-source-locale provider test last: react-i18next's global
   // fallback instance otherwise leaks the selected language into tests that
   // intentionally exercise providerless compatibility.

package/src/app/sharing/ShareButton.tsx

@@ -80,6 +80,14 @@ export interface ShareButtonProps {
   shareUrl?: string;
   /** Use a bottom sheet for the share surface below the small-screen breakpoint. */
   mobileSheet?: boolean;
+  /**
+   * The session can run only the basic share actions (list, share, unshare,
+   * visibility), as a scoped MCP App widget session can. Omits the access
+   * request review, the agent-context link and the people suggestions, which
+   * need other routes, and the admin role and email note, which such a
+   * session may not send; an email is still added by typing it.
+   */
+  basicSharingOnly?: boolean;
   /** Open the share surface without rendering a trigger button. */
   hideTrigger?: boolean;
   /** Override the optional temporary agent-context link label. */
@@ -93,6 +101,7 @@ export interface ShareButtonProps {
     label: string;
     copiedLabel: string;
     onCopy: () => Promise<boolean | void> | boolean | void;
+    className?: string;
   };
   /** Optional label for the primary copyable link section. */
   shareUrlLabel?: string;
@@ -220,6 +229,18 @@ function visibilityMeta(
   };
 }
 
+// A scoped host session cannot grant the admin role, so it is not offered.
+const BASIC_SHARING_ROLES: readonly Role[] = ["viewer", "commenter", "editor"];
+
+function allowedRolesFor(
+  props: Pick<ShareButtonProps, "allowedRoles" | "basicSharingOnly">,
+): readonly Role[] | undefined {
+  return (
+    props.allowedRoles ??
+    (props.basicSharingOnly ? BASIC_SHARING_ROLES : undefined)
+  );
+}
+
 function roleOptions(
   t: ShareTranslate,
 ): Array<{ value: Role; label: string; description: string }> {
@@ -312,7 +333,7 @@ export function ShareButton(props: ShareButtonProps) {
     onShareSuccess: props.onShareSuccess,
     shareTabs: props.shareTabs,
     shareUrl: props.shareUrl,
-    allowedRoles: props.allowedRoles,
+    allowedRoles: allowedRolesFor(props),
     hideInSearchControl: props.hideInSearchControl,
   });
   useEffect(() => {
@@ -355,6 +376,7 @@ export function ShareButton(props: ShareButtonProps) {
             copyLabel={props.quickCopy.label}
             copiedLabel={props.quickCopy.copiedLabel}
             onCopy={props.quickCopy.onCopy}
+            className={props.quickCopy.className}
           />
         ) : (
           <SheetTrigger asChild>{trigger}</SheetTrigger>
@@ -391,6 +413,7 @@ export function ShareButton(props: ShareButtonProps) {
             copyLabel={props.quickCopy.label}
             copiedLabel={props.quickCopy.copiedLabel}
             onCopy={props.quickCopy.onCopy}
+            className={props.quickCopy.className}
           />
         </PopoverAnchor>
       ) : (
@@ -469,12 +492,13 @@ function SharePanel(
   const generalAccessLabel =
     props.generalAccessLabel ??
     t("agentChat.share.generalAccess", { defaultValue: "General access" });
-  const accessRequests = canManage ? (
-    <AccessRequestsSection
-      resourceType={props.resourceType}
-      resourceId={props.resourceId}
-    />
-  ) : null;
+  const accessRequests =
+    canManage && !props.basicSharingOnly ? (
+      <AccessRequestsSection
+        resourceType={props.resourceType}
+        resourceId={props.resourceId}
+      />
+    ) : null;
   const shareLinks = (
     <>
       {props.shareUrl ? (
@@ -610,8 +634,10 @@ function SharePanel(
               <div className="w-full sm:min-w-0 sm:flex-1">
                 <MemberAutocomplete
                   value={inviteEmail}
-                  open={suggestionsOpen}
-                  onOpenChange={setSuggestionsOpen}
+                  open={suggestionsOpen && !props.basicSharingOnly}
+                  onOpenChange={(open) => {
+                    if (!props.basicSharingOnly) setSuggestionsOpen(open);
+                  }}
                   onValueChange={(next) => {
                     onInviteEmailChange(next);
                     if (shareError) setShareError(null);
@@ -656,7 +682,7 @@ function SharePanel(
                 value={role}
                 onChange={setRole}
                 roleCopy={props.roleCopy}
-                allowedRoles={props.allowedRoles}
+                allowedRoles={allowedRolesFor(props)}
               />
               <button
                 type="button"
@@ -688,7 +714,7 @@ function SharePanel(
                     defaultValue: "Notify people",
                   })}
                 </label>
-                {notifyPeople ? (
+                {notifyPeople && !props.basicSharingOnly ? (
                   <button
                     type="button"
                     aria-expanded={messageOpen}
@@ -706,7 +732,10 @@ function SharePanel(
                 ) : null}
               </div>
             ) : null}
-            {hasInviteEmail && notifyPeople && messageOpen ? (
+            {hasInviteEmail &&
+            notifyPeople &&
+            messageOpen &&
+            !props.basicSharingOnly ? (
               <div className="rounded-md border border-border/70 bg-muted/20 p-2.5">
                 <textarea
                   aria-label={t("agentChat.share.message", {
@@ -777,7 +806,7 @@ function SharePanel(
                   disabled={inFlight.has(keyOf(s))}
                   plain
                   roleCopy={props.roleCopy}
-                  allowedRoles={props.allowedRoles}
+                  allowedRoles={allowedRolesFor(props)}
                 />
               ) : (
                 <span className="text-xs text-muted-foreground">
@@ -818,7 +847,7 @@ function SharePanel(
         </div>
       ) : null}
 
-      {!props.agentTabContent ? (
+      {!props.agentTabContent && !props.basicSharingOnly ? (
         <AgentShareSection
           enabled={data?.agentReadable === true}
           resourceType={props.resourceType}
@@ -849,7 +878,7 @@ function SharePanel(
     const agentPanel = (
       <div className="space-y-4">
         {props.agentTabContent}
-        {!loadFailed && !isLoading ? (
+        {!loadFailed && !isLoading && !props.basicSharingOnly ? (
           <AgentShareSection
             enabled={data?.agentReadable === true}
             resourceType={props.resourceType}

package/src/app/sharing/useShareButtonController.spec.tsx

@@ -12,6 +12,7 @@ import { createRoot, type Root } from "react-dom/client";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({
+  useActionQuery: vi.fn(),
   query: {
     data: undefined as ShareButtonSharesResponse | undefined,
     refetch: vi.fn(async () => undefined),
@@ -22,7 +23,7 @@ const mocks = vi.hoisted(() => ({
 }));
 
 vi.mock("@agent-native/core/client/use-action", () => ({
-  useActionQuery: vi.fn(() => mocks.query),
+  useActionQuery: mocks.useActionQuery,
   useActionMutation: vi.fn((name: string) => {
     if (name === "set-resource-visibility") return mocks.setVisibility;
     if (name === "share-resource") return mocks.share;
@@ -84,6 +85,7 @@ describe("useShareButtonController", () => {
       ],
     };
     mocks.query.refetch.mockClear();
+    mocks.useActionQuery.mockReset().mockReturnValue(mocks.query);
     mocks.setVisibility.mutate.mockReset();
     mocks.share.mutate.mockReset();
     mocks.unshare.mutate.mockReset();
@@ -106,6 +108,28 @@ describe("useShareButtonController", () => {
     controller = undefined;
   });
 
+  it("loads share state only while the popover is open", async () => {
+    const result = await render();
+    const latestShareQueryOptions = () =>
+      mocks.useActionQuery.mock.calls
+        .filter(([name]) => name === "list-resource-shares")
+        .at(-1)?.[2];
+
+    expect(latestShareQueryOptions()).toEqual({
+      enabled: false,
+      staleTime: 0,
+    });
+    expect(mocks.query.refetch).not.toHaveBeenCalled();
+
+    act(() => result.handleOpenChange(true));
+
+    expect(latestShareQueryOptions()).toEqual({
+      enabled: true,
+      staleTime: 0,
+    });
+    expect(mocks.query.refetch).not.toHaveBeenCalled();
+  });
+
   it("guards rapid duplicate invites for the same principal", async () => {
     const result = await render();
     act(() => {