@agent-native/toolkit 0.198.3 → 0.198.5

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

@@ -745,7 +745,7 @@ const messages: ToolkitAgentChatTranslation = {
   "mcpIntegrations.catalog.gong.useCase":
     "銷售通話、逐字稿、交易洞察、客戶摘要",
   "mcpIntegrations.catalog.gong.setupNote":
-    "Gong 需要技術管理員建立 MCP 整合，並選擇個人或共用授權。連線前必須先設定產生的用戶端 ID 和密鑰。",
+    "Gong 技術管理員需要建立 MCP 整合並選擇個人或共用授權。使用手動註冊時，請將產生的用戶端 ID 和密鑰儲存為工作區密鑰 `GONG_MCP_CLIENT_ID` 和 `GONG_MCP_CLIENT_SECRET`；自動註冊不需要用戶端憑證。",
   "mcpIntegrations.catalog.semgrep.description": "掃描程式碼中的安全性問題。",
   "mcpIntegrations.catalog.semgrep.useCase": "安全性掃描、漏洞偵測、程式碼分析",
   "mcpIntegrations.catalog.linear.description": "讀取及撰寫 Linear 議題。",
@@ -937,6 +937,7 @@ const messages: ToolkitAgentChatTranslation = {
   "message.restoreQuestion": "要還原到這裡嗎？",
   "message.revertQuestion": "要還原到這裡嗎？之後所做的變更將會遺失。",
   "message.restoreRequestFailed": "還原要求失敗。",
+  "message.historyUnavailable": "無法載入變更歷史。",
   "message.threadNotFound":
     "此聊天串已無法使用。請開始新的聊天；如果這是意外情況，也可以重試。",
   "message.restoring": "正在還原...",

package/src/app/integrations/IntegrationDetailPage.spec.tsx

@@ -36,7 +36,7 @@ vi.mock("../settings/api-keys/api-keys-client.js", () => keys);
 vi.mock("@agent-native/core/client/org/hooks", () => ({
   useOrg: () => ({ data: { orgName: "Acme" } }),
 }));
-vi.mock("./useIntegrationStatus.js", () => ({
+vi.mock("@agent-native/core/client/integrations/useIntegrationStatus", () => ({
   useIntegrationStatus: () => ({ statuses: [], loading: false, refetch() {} }),
 }));
 vi.mock("sonner", () => ({ toast: { success: vi.fn(), error: vi.fn() } }));

package/src/app/labs/LabsSettings.tsx

@@ -1,5 +1,8 @@
 import { useT } from "@agent-native/core/client/i18n";
-import type { LabValues } from "@agent-native/core/client/labs/use-lab";
+import type {
+  LabStates,
+  LabValues,
+} from "@agent-native/core/client/labs/use-lab";
 import {
   useActionMutation,
   useActionQuery,
@@ -21,6 +24,7 @@ interface LabsSettingsState {
   /** The labs to list: every one passed until the server answers, then the ones it registered. */
   labs: readonly LabDefinition[];
   enabled: (lab: LabDefinition) => boolean;
+  mixed: (lab: LabDefinition) => boolean;
   toggle: (lab: LabDefinition, enabled: boolean) => void;
   /** Switches wait for the server's answer; they can't save before it. */
   disabled: boolean;
@@ -30,7 +34,7 @@ interface LabsSettingsState {
   failedLab: LabDefinition | null;
 }
 
-function hasOwn(values: LabValues, key: string): boolean {
+function hasOwn(values: LabStates, key: string): boolean {
   return Object.prototype.hasOwnProperty.call(values, key);
 }
 
@@ -43,7 +47,7 @@ function hasOwn(values: LabValues, key: string): boolean {
 function useLabsSettingsState(
   labs: readonly LabDefinition[],
 ): LabsSettingsState {
-  const valuesQuery = useActionQuery<LabValues>("get-labs" as never);
+  const valuesQuery = useActionQuery<LabStates>("get-lab-states" as never);
   const setLab = useActionMutation<
     { key: string; enabled: boolean; values: LabValues },
     { key: string; enabled: boolean }
@@ -80,7 +84,11 @@ function useLabsSettingsState(
     labs: visible,
     enabled: (lab) =>
       overrides[lab.key] ??
-      (values ? values[lab.key] === true : lab.defaultEnabled === true),
+      (values
+        ? values[lab.key]?.enabled === true
+        : lab.defaultEnabled === true),
+    mixed: (lab) =>
+      overrides[lab.key] === undefined && values?.[lab.key]?.mixed === true,
     toggle,
     disabled: !values || setLab.isPending,
     loadFailed: !values && valuesQuery.isError,
@@ -111,6 +119,7 @@ function LabRows({ state }: { state: LabsSettingsState }) {
       {state.labs.map((lab) => {
         const label = lab.displayName ?? lab.key;
         const failed = state.failedLab?.key === lab.key;
+        const mixed = state.mixed(lab);
         return (
           <SettingsRow
             key={lab.key}
@@ -123,17 +132,44 @@ function LabRows({ state }: { state: LabsSettingsState }) {
                     lab: label,
                   })}
                 </span>
+              ) : mixed ? (
+                (lab.inheritedMixedDescription ?? lab.description)
               ) : (
                 lab.description
               )
             }
             control={
-              <Switch
-                checked={state.enabled(lab)}
-                onChange={(next) => state.toggle(lab, next)}
-                disabled={state.disabled}
-                aria-label={label}
-              />
+              mixed ? (
+                <div className="flex gap-2">
+                  <Button
+                    type="button"
+                    variant="outline"
+                    size="sm"
+                    disabled={state.disabled}
+                    onClick={() => state.toggle(lab, true)}
+                    aria-label={`${label}: ${t("agentChat.settingsShell.channels.state.on")}`}
+                  >
+                    {t("agentChat.settingsShell.channels.state.on")}
+                  </Button>
+                  <Button
+                    type="button"
+                    variant="outline"
+                    size="sm"
+                    disabled={state.disabled}
+                    onClick={() => state.toggle(lab, false)}
+                    aria-label={`${label}: ${t("agentChat.settingsShell.channels.state.off")}`}
+                  >
+                    {t("agentChat.settingsShell.channels.state.off")}
+                  </Button>
+                </div>
+              ) : (
+                <Switch
+                  checked={state.enabled(lab)}
+                  onChange={(next) => state.toggle(lab, next)}
+                  disabled={state.disabled}
+                  aria-label={label}
+                />
+              )
             }
           />
         );

package/src/app/observability/ThumbsFeedback.spec.tsx

@@ -52,11 +52,14 @@ afterEach(() => {
   vi.unstubAllEnvs();
 });
 
+const catalog = createToolkitI18nCatalog({ messages: {} });
+
 describe("ThumbsFeedback localization", () => {
   it("renders localized accessible labels and explanation copy", async () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="de-DE"
           initialPreference="de-DE"
           persistPreference={false}
@@ -87,6 +90,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -181,6 +185,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -295,6 +300,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -421,6 +427,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -511,6 +518,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -558,6 +566,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -596,6 +605,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -639,6 +649,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -674,6 +685,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -709,6 +721,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -746,6 +759,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}
@@ -797,6 +811,7 @@ describe("ThumbsFeedback localization", () => {
     act(() => {
       root.render(
         <AgentNativeI18nProvider
+          catalog={catalog}
           initialLocale="en-US"
           initialPreference="en-US"
           persistPreference={false}

package/src/app/onboarding/FirstRunOnboarding.spec.tsx

@@ -45,6 +45,10 @@ vi.mock("react-router", async (importOriginal) => {
   };
 });
 
+vi.mock("@agent-native/core/client/feature-flags/use-feature-flag", () => ({
+  useFeatureFlagState: () => ({ status: "ready", enabled: true }),
+}));
+
 vi.mock("@agent-native/core/client/onboarding/use-onboarding", () => ({
   trackOnboardingEvent: mocks.trackOnboardingEvent,
   useOnboarding: mocks.useOnboarding,

package/src/app/org/OrgGeneralSection.tsx

@@ -1,3 +1,4 @@
+import { useActionQuery } from "@agent-native/core/client/hooks";
 import { useIconPickerLabels, useT } from "@agent-native/core/client/i18n";
 import {
   useOrg,
@@ -8,8 +9,11 @@ import {
   useSwitchOrg,
   useSetOrgWorkspaceUrl,
 } from "@agent-native/core/client/org";
-import { uploadEditorImage } from "@agent-native/core/client/uploads";
-import { useFileUploadStatus } from "@agent-native/core/client/uploads/use-file-upload-status";
+import {
+  uploadWorkspacePrivateIcon,
+  workspacePrivateIconLibraryUrl,
+  workspacePrivateIconUrl,
+} from "@agent-native/core/client/uploads";
 import type { IconValue } from "@agent-native/core/icons";
 import { docsUrl } from "@agent-native/core/shared/docs-url";
 import { ResourceIcon, ResourceIconPicker } from "@agent-native/toolkit/icons";
@@ -368,31 +372,37 @@ export function OrgIconControl({
 }) {
   const t = useT();
   const iconPickerLabels = useIconPickerLabels();
-  const fileUploadStatus = useFileUploadStatus(canEdit);
-  const fileStorageConfigured =
-    fileUploadStatus.data?.configured === true && !fileUploadStatus.isError;
+  const { data: org } = useOrg();
+  const uploadedIcons = useActionQuery<{
+    assets: Array<{ id: string; alt?: string }>;
+  }>("list-workspace-icons", {}, { enabled: canEdit && !!org?.orgId });
   return canEdit ? (
     <ResourceIconPicker
       value={icon}
+      uploadedImages={(uploadedIcons.data?.assets ?? []).map((asset) => ({
+        version: 1,
+        kind: "image",
+        authority: "private-icon",
+        assetId: asset.id,
+        ...(asset.alt ? { alt: asset.alt } : {}),
+      }))}
+      uploadedImagesError={Boolean(uploadedIcons.error)}
+      onUploadedImagesRetry={() => {
+        void uploadedIcons.refetch();
+      }}
       onValueChange={async (next) => {
         await setVisualIdentity.mutateAsync(next);
       }}
-      onUpload={
-        fileStorageConfigured
-          ? async (file) => {
-              const uploaded = await uploadEditorImage(file);
-              return {
-                version: 1,
-                kind: "image",
-                authority: "url",
-                assetId: uploaded.src,
-                alt: uploaded.alt || file.name,
-              };
-            }
-          : undefined
-      }
+      onUpload={async (file) => {
+        const uploaded = await uploadWorkspacePrivateIcon(file);
+        void uploadedIcons.refetch();
+        return uploaded;
+      }}
+      formatUploadError={() => iconPickerLabels.uploadFailed}
       resolveImageUrl={(image) =>
-        image.authority === "url" ? image.assetId : undefined
+        image.assetId === (icon?.kind === "image" ? icon.assetId : null)
+          ? workspacePrivateIconUrl(org?.orgId ?? "", image)
+          : workspacePrivateIconLibraryUrl(org?.orgId ?? "", image)
       }
       disabled={setVisualIdentity.isPending}
       labels={{
@@ -439,7 +449,7 @@ export function OrgIconControl({
           value={icon}
           size={16}
           resolveImageUrl={(image) =>
-            image.authority === "url" ? image.assetId : undefined
+            workspacePrivateIconUrl(org?.orgId ?? "", image)
           }
           fallback={<IconUsersGroup className="size-4 text-muted-foreground" />}
         />
@@ -450,7 +460,7 @@ export function OrgIconControl({
       value={icon}
       size={16}
       resolveImageUrl={(image) =>
-        image.authority === "url" ? image.assetId : undefined
+        workspacePrivateIconUrl(org?.orgId ?? "", image)
       }
       fallback={<IconUsersGroup className="size-4 text-muted-foreground" />}
     />

package/src/app/org/OrgSwitcher.tsx

@@ -11,6 +11,7 @@ import {
   useJoinByDomain,
 } from "@agent-native/core/client/org";
 import { signOut } from "@agent-native/core/client/sign-out";
+import { workspacePrivateIconUrl } from "@agent-native/core/client/uploads";
 import { setBrowserDemoModeEnabled } from "@agent-native/core/demo/browser-state";
 import { buildSettingsRoute } from "@agent-native/core/navigation";
 import { shouldOfferWorkspace } from "@agent-native/core/org/workspace-url";
@@ -503,7 +504,7 @@ export function OrgSwitcher({
               value={org.icon}
               size={12}
               resolveImageUrl={(image) =>
-                image.authority === "url" ? image.assetId : undefined
+                workspacePrivateIconUrl(org.orgId ?? "", image)
               }
               fallback={<IconBriefcase className="size-3 shrink-0" />}
             />
@@ -585,7 +586,7 @@ export function OrgSwitcher({
                 value={o.icon}
                 size={14}
                 resolveImageUrl={(image) =>
-                  image.authority === "url" ? image.assetId : undefined
+                  workspacePrivateIconUrl(o.orgId, image)
                 }
                 fallback={<IconBriefcase className={ITEM_ICON_CLASS} />}
               />

package/src/app/org/workspace-app-links.spec.ts

@@ -3,6 +3,7 @@ import { describe, expect, it } from "vitest";
 import {
   defaultOrgAppLinks,
   dispatchAppsHref,
+  dispatchIntegrationsHref,
   isWorkspaceAppEnvironment,
   parseWorkspaceAppLinks,
   visibleOrgAppLinks,
@@ -66,6 +67,9 @@ describe("org switcher app links", () => {
     expect(dispatchAppsHref(apps ?? [])).toBe(
       "http://127.0.0.1:8080/dispatch/apps",
     );
+    expect(dispatchIntegrationsHref(apps ?? [])).toBe(
+      "http://127.0.0.1:8080/dispatch/integrations",
+    );
   });
 
   it("uses a published custom home path for workspace app links", () => {

package/src/app/org/workspace-app-links.ts

@@ -266,7 +266,7 @@ export function isWorkspaceAppEnvironment(
 
 function dispatchPageHref(
   apps: OrgSwitcherAppLink[],
-  page: "overview" | "apps" | "vault" | "workspace",
+  page: "overview" | "apps" | "vault" | "workspace" | "integrations",
   env: RuntimeEnv,
 ): string {
   const dispatch = apps.find((app) => app.isDispatch);
@@ -303,6 +303,13 @@ export function dispatchResourcesHref(
   return dispatchPageHref(apps, "workspace", env);
 }
 
+export function dispatchIntegrationsHref(
+  apps: OrgSwitcherAppLink[],
+  env: RuntimeEnv = runtimeEnv(),
+): string {
+  return dispatchPageHref(apps, "integrations", env);
+}
+
 export function visibleOrgAppLinks(
   apps: OrgSwitcherAppLink[],
   max = ORG_SWITCHER_MAX_APP_LINKS,