@agent-native/dispatch 0.40.30-nightly-20261021064625 → 0.40.30

package/dist/actions/list-curated-community-apps.js

@@ -0,0 +1,10 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { listCuratedCommunityApps } from "../server/lib/community-apps.js";
+export default defineAction({
+    description: "List reviewed, pinned community app templates that can be installed in the associated workspace. This catalog is separate from deployed agents in Connect.",
+    schema: z.object({}),
+    http: { method: "GET" },
+    run: async () => listCuratedCommunityApps(),
+});
+//# sourceMappingURL=list-curated-community-apps.js.map

package/dist/actions/list-curated-community-apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-curated-community-apps.js","sourceRoot":"","sources":["../../src/actions/list-curated-community-apps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,4JAA4J;IAC9J,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,wBAAwB,EAAE;CAC5C,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nimport { listCuratedCommunityApps } from \"../server/lib/community-apps.js\";\n\nexport default defineAction({\n  description:\n    \"List reviewed, pinned community app templates that can be installed in the associated workspace. This catalog is separate from deployed agents in Connect.\",\n  schema: z.object({}),\n  http: { method: \"GET\" },\n  run: async () => listCuratedCommunityApps(),\n});\n"]}

package/dist/actions/provider-api-register.d.ts

@@ -47,10 +47,7 @@ declare const _default: import("node_modules/@agent-native/core/dist").ActionDef
     notes?: string | undefined;
     scope?: "org" | "user" | undefined;
 }, {
-    message?: undefined;
     provider?: undefined;
-    id?: undefined;
-    deleted?: undefined;
     providers: {
         id: string;
         label: string;
@@ -62,44 +59,47 @@ declare const _default: import("node_modules/@agent-native/core/dist").ActionDef
     }[];
     count: number;
     found?: undefined;
+    deleted?: undefined;
     registered?: undefined;
+    id?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
-    id?: undefined;
-    count?: undefined;
-    deleted?: undefined;
+} | {
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     provider: import("node_modules/@agent-native/core/dist/provider-api").CustomProviderConfig;
+    deleted?: undefined;
     registered?: undefined;
+    id?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
     provider?: undefined;
-    count?: undefined;
-    deleted?: undefined;
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     id: string;
+    deleted?: undefined;
     registered?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
     provider?: undefined;
-    count?: undefined;
     providers?: undefined;
+    count?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
     provider?: undefined;
-    count?: undefined;
-    deleted?: undefined;
     providers?: undefined;
+    count?: undefined;
     found?: undefined;
+    deleted?: undefined;
     registered: boolean;
     id: string;
     label: string;

package/dist/actions/remix-workspace-template.d.ts

@@ -50,6 +50,12 @@ declare const _default: import("@agent-native/core/action").ActionDefinition<{
     appId: string;
     prompt: string;
     message: string;
+    attachments?: Array<{
+        type: "file";
+        name: string;
+        contentType: string;
+        text: string;
+    }>;
     sourceTemplate: import("../server/lib/curated-workspace-templates.js").CuratedWorkspaceTemplate;
 }>;
 export default _default;

package/dist/actions/update-workspace-app-metadata.d.ts

@@ -2,6 +2,7 @@ declare const _default: import("@agent-native/core/action").ActionDefinition<{
     appId: string;
     name?: string | null | undefined;
     description?: string | null | undefined;
+    whenToUse?: string[] | null | undefined;
 }, import("../server/lib/app-creation-store.js").WorkspaceAppSummary>;
 export default _default;
 //# sourceMappingURL=update-workspace-app-metadata.d.ts.map

package/dist/actions/update-workspace-app-metadata.js

@@ -1,10 +1,11 @@
 import { defineAction } from "@agent-native/core/action";
-import { getWorkspaceAppIdValidationError } from "@agent-native/core/shared";
+import { getWorkspaceAppIdValidationError, parseAgentProfileMetadata, } from "@agent-native/core/shared";
 import { z } from "zod";
 import { updateWorkspaceAppMetadata } from "../server/lib/app-creation-store.js";
 export default defineAction({
-    description: "Update the human-editable display name and description Dispatch uses for a workspace app. Workspace members can edit these shared details, which are also used as connected-agent/A2A context.",
-    schema: z.object({
+    description: "Update a workspace app's display name, description, and when-to-use profile. Only organization owners and admins can edit these shared details.",
+    schema: z
+        .object({
         appId: z
             .string()
             .max(64)
@@ -20,10 +21,30 @@ export default defineAction({
             .describe("Human-readable app name"),
         description: z
             .string()
-            .max(500)
+            .max(1000)
             .optional()
             .nullable()
-            .describe("Human-readable app description"),
+            .describe("Human-readable app description, up to 1,000 characters"),
+        whenToUse: z
+            .array(z.string())
+            .max(6)
+            .optional()
+            .nullable()
+            .describe("Example requests that indicate when this app is useful"),
+    })
+        .superRefine(({ description, whenToUse }, context) => {
+        if (description == null && whenToUse == null)
+            return;
+        const profile = parseAgentProfileMetadata({
+            ...(description != null ? { description } : {}),
+            ...(whenToUse != null ? { whenToUse } : {}),
+        });
+        if (!profile) {
+            context.addIssue({
+                code: "custom",
+                message: "Use a description up to 1,000 characters and up to 6 non-empty examples, each no longer than 140 characters.",
+            });
+        }
     }),
     run: async (args) => updateWorkspaceAppMetadata(args),
 });

package/dist/actions/update-workspace-app-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-workspace-app-metadata.js","sourceRoot":"","sources":["../../src/actions/update-workspace-app-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,gMAAgM;IAClM,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gCAAgC,CAAC,KAAK,CAAC,EAAE;YAC3D,OAAO,EACL,yEAAyE;SAC5E,CAAC;aACD,QAAQ,CAAC,iDAAiD,CAAC;QAC9D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,yBAAyB,CAAC;QACtC,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;KAC9C,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;CACtD,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core/action\";\nimport { getWorkspaceAppIdValidationError } from \"@agent-native/core/shared\";\nimport { z } from \"zod\";\n\nimport { updateWorkspaceAppMetadata } from \"../server/lib/app-creation-store.js\";\n\nexport default defineAction({\n  description:\n    \"Update the human-editable display name and description Dispatch uses for a workspace app. Workspace members can edit these shared details, which are also used as connected-agent/A2A context.\",\n  schema: z.object({\n    appId: z\n      .string()\n      .max(64)\n      .refine((appId) => !getWorkspaceAppIdValidationError(appId), {\n        message:\n          \"Use a non-reserved app id with lowercase letters, numbers, and hyphens.\",\n      })\n      .describe(\"Workspace app id, matching the apps/<id> folder\"),\n    name: z\n      .string()\n      .max(120)\n      .optional()\n      .nullable()\n      .describe(\"Human-readable app name\"),\n    description: z\n      .string()\n      .max(500)\n      .optional()\n      .nullable()\n      .describe(\"Human-readable app description\"),\n  }),\n  run: async (args) => updateWorkspaceAppMetadata(args),\n});\n"]}
+{"version":3,"file":"update-workspace-app-metadata.js","sourceRoot":"","sources":["../../src/actions/update-workspace-app-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,iJAAiJ;IACnJ,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gCAAgC,CAAC,KAAK,CAAC,EAAE;YAC3D,OAAO,EACL,yEAAyE;SAC5E,CAAC;aACD,QAAQ,CAAC,iDAAiD,CAAC;QAC9D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,yBAAyB,CAAC;QACtC,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;KACtE,CAAC;SACD,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE;QACnD,IAAI,WAAW,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI;YAAE,OAAO;QACrD,MAAM,OAAO,GAAG,yBAAyB,CAAC;YACxC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,8GAA8G;aACjH,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IACJ,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;CACtD,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core/action\";\nimport {\n  getWorkspaceAppIdValidationError,\n  parseAgentProfileMetadata,\n} from \"@agent-native/core/shared\";\nimport { z } from \"zod\";\n\nimport { updateWorkspaceAppMetadata } from \"../server/lib/app-creation-store.js\";\n\nexport default defineAction({\n  description:\n    \"Update a workspace app's display name, description, and when-to-use profile. Only organization owners and admins can edit these shared details.\",\n  schema: z\n    .object({\n      appId: z\n        .string()\n        .max(64)\n        .refine((appId) => !getWorkspaceAppIdValidationError(appId), {\n          message:\n            \"Use a non-reserved app id with lowercase letters, numbers, and hyphens.\",\n        })\n        .describe(\"Workspace app id, matching the apps/<id> folder\"),\n      name: z\n        .string()\n        .max(120)\n        .optional()\n        .nullable()\n        .describe(\"Human-readable app name\"),\n      description: z\n        .string()\n        .max(1000)\n        .optional()\n        .nullable()\n        .describe(\"Human-readable app description, up to 1,000 characters\"),\n      whenToUse: z\n        .array(z.string())\n        .max(6)\n        .optional()\n        .nullable()\n        .describe(\"Example requests that indicate when this app is useful\"),\n    })\n    .superRefine(({ description, whenToUse }, context) => {\n      if (description == null && whenToUse == null) return;\n      const profile = parseAgentProfileMetadata({\n        ...(description != null ? { description } : {}),\n        ...(whenToUse != null ? { whenToUse } : {}),\n      });\n      if (!profile) {\n        context.addIssue({\n          code: \"custom\",\n          message:\n            \"Use a description up to 1,000 characters and up to 6 non-empty examples, each no longer than 140 characters.\",\n        });\n      }\n    }),\n  run: async (args) => updateWorkspaceAppMetadata(args),\n});\n"]}

package/dist/components/community-apps-section.d.ts

@@ -0,0 +1,2 @@
+export declare function CommunityAppsSection(): import("node_modules/@types/react/index.js").JSX.Element | null;
+//# sourceMappingURL=community-apps-section.d.ts.map

package/dist/components/community-apps-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-apps-section.d.ts","sourceRoot":"","sources":["../../src/components/community-apps-section.tsx"],"names":[],"mappings":"AAsDA,wBAAgB,oBAAoB,oEAyKnC"}

package/dist/components/community-apps-section.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
+import { useActionMutation, useActionQuery, } from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
+import { useLab } from "@agent-native/core/client/labs";
+import { IconArrowUpRight, IconCircleCheck, IconPlus, } from "@tabler/icons-react";
+import { useState } from "react";
+import { toast } from "sonner";
+import { COMMUNITY_APPS_LAB } from "../shared/labs.js";
+import { ActionQueryError } from "./action-query-error.js";
+import { AppIcon } from "./app-icon.js";
+import { AppList, AppListRow } from "./app-list-row.js";
+import { Badge } from "./ui/badge.js";
+import { Button } from "./ui/button.js";
+import { Skeleton } from "./ui/skeleton.js";
+import { Spinner } from "./ui/spinner.js";
+function pinnedSourceUrl(source) {
+    return ("https://github.com/" +
+        source.repo +
+        "/tree/" +
+        source.ref +
+        "/" +
+        source.templatePath);
+}
+export function CommunityAppsSection() {
+    const t = useT();
+    const enabled = useLab(COMMUNITY_APPS_LAB);
+    const [installingId, setInstallingId] = useState(null);
+    const catalogQuery = useActionQuery("list-curated-community-apps", {}, { enabled });
+    const workspaceAppsQuery = useActionQuery("list-workspace-apps", {
+        includeAgentCards: false,
+        includeArchived: true,
+    });
+    const install = useActionMutation("install-curated-community-app", {
+        onSuccess: (result) => {
+            const mode = result?.mode;
+            const message = result?.message;
+            if (mode === "builder") {
+                toast.success(t("dispatch.pages.communityAppsInstallStarted"));
+            }
+            else if (mode === "pending") {
+                toast.info(t("dispatch.pages.communityAppsPending"));
+            }
+            else if (mode === "already-installed") {
+                toast.success(t("dispatch.pages.communityAppsAlreadyInstalled"));
+            }
+            else if (mode === "builder-unavailable" || mode === "app-id-taken") {
+                toast.error(message || t("dispatch.pages.communityAppsInstallFailed"));
+            }
+            else if (mode === "local-agent") {
+                sendToAgentChat({
+                    message: result?.prompt ||
+                        t("dispatch.pages.communityAppsLocalRequestReady"),
+                    attachments: result?.attachments,
+                    submit: true,
+                    type: "code",
+                    newTab: true,
+                    reuseEmptyTab: true,
+                });
+                toast.info(t("dispatch.pages.communityAppsLocalRequestReady"));
+            }
+            else {
+                toast.error(t("dispatch.pages.communityAppsInstallFailed"));
+            }
+            setInstallingId(null);
+            void catalogQuery.refetch();
+            void workspaceAppsQuery.refetch();
+        },
+        onError: () => {
+            setInstallingId(null);
+            toast.error(t("dispatch.pages.communityAppsInstallFailed"));
+        },
+    });
+    if (!enabled)
+        return null;
+    return (_jsxs("section", { className: "space-y-3 border-t pt-6", children: [_jsx("h2", { className: "text-sm font-semibold text-foreground", children: t("dispatch.pages.communityApps") }), catalogQuery.isError ? (_jsx(ActionQueryError, { error: catalogQuery.error, onRetry: () => void catalogQuery.refetch() })) : catalogQuery.isLoading ? (_jsx(AppList, { className: "divide-y rounded-xl border", children: _jsxs("div", { className: "flex items-center gap-3 px-4 py-3.5", children: [_jsx(Skeleton, { className: "size-8 rounded-lg" }), _jsx(Skeleton, { className: "h-4 w-40" })] }) })) : catalogQuery.data?.length ? (_jsx(AppList, { className: "divide-y rounded-xl border", children: catalogQuery.data.map((source) => (_jsxs(AppListRow, { className: "border-b-0", children: [_jsx(AppIcon, { id: source.id, name: source.name, size: "sm" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-2", children: [_jsx("h3", { className: "truncate text-sm font-semibold text-foreground", children: source.name }), source.installed ? (_jsxs(Badge, { variant: "secondary", className: "gap-1", children: [_jsx(IconCircleCheck, { size: 13 }), t("dispatch.pages.communityAppsInstalled")] })) : source.pending ? (_jsx(Badge, { variant: "secondary", children: t("dispatch.pages.communityAppsPending") })) : null] }), source.description ? (_jsx("p", { className: "mt-0.5 truncate text-xs text-muted-foreground", children: source.description })) : null, _jsxs("div", { className: "mt-1 flex flex-wrap items-center gap-x-2 text-xs text-muted-foreground", children: [_jsxs("span", { children: [t("dispatch.pages.communityAppsLicense"), ": ", source.license] }), _jsxs("a", { href: pinnedSourceUrl(source), target: "_blank", rel: "noreferrer", className: "inline-flex items-center gap-1 underline-offset-4 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: [t("dispatch.pages.communityAppsTemplateSource"), _jsx(IconArrowUpRight, { size: 12, "aria-hidden": "true" })] })] })] }), source.installable ? (_jsxs(Button, { type: "button", size: "sm", variant: "outline", disabled: install.isPending, onClick: () => {
+                                setInstallingId(source.id);
+                                install.mutate({ sourceId: source.id });
+                            }, children: [install.isPending && installingId === source.id ? (_jsx(Spinner, { className: "mr-1.5" })) : (_jsx(IconPlus, { size: 14, className: "mr-1.5" })), install.isPending && installingId === source.id
+                                    ? t("dispatch.pages.communityAppsInstalling")
+                                    : t("dispatch.pages.communityAppsInstall")] })) : !source.installed &&
+                            !source.pending &&
+                            source.installUnavailableReason === "workspace-required" ? (_jsx("span", { className: "max-w-48 text-right text-xs text-muted-foreground", children: t("dispatch.pages.communityAppsWorkspaceRequired") })) : !source.installed &&
+                            !source.pending &&
+                            source.installUnavailableReason === "app-id-conflict" ? (_jsx("span", { className: "max-w-48 text-right text-xs text-muted-foreground", children: t("dispatch.pages.communityAppsIdConflict") })) : !source.installed &&
+                            !source.pending &&
+                            source.installUnavailableReason ===
+                                "builder-install-unverified" ? (_jsx("span", { className: "max-w-48 text-right text-xs text-muted-foreground", children: t("dispatch.pages.communityAppsBuilderInstallUnavailable") })) : null] }, source.id))) })) : (_jsx("p", { className: "text-sm text-muted-foreground", children: t("dispatch.pages.communityAppsEmpty") }))] }));
+}
+//# sourceMappingURL=community-apps-section.js.map

package/dist/components/community-apps-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-apps-section.js","sourceRoot":"","sources":["../../src/components/community-apps-section.tsx"],"names":[],"mappings":"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","sourcesContent":["import { sendToAgentChat } from \"@agent-native/core/client/agent-chat\";\nimport {\n  useActionMutation,\n  useActionQuery,\n} from \"@agent-native/core/client/hooks\";\nimport { useT } from \"@agent-native/core/client/i18n\";\nimport { useLab } from \"@agent-native/core/client/labs\";\nimport {\n  IconArrowUpRight,\n  IconCircleCheck,\n  IconPlus,\n} from \"@tabler/icons-react\";\nimport { useState } from \"react\";\nimport { toast } from \"sonner\";\n\nimport { COMMUNITY_APPS_LAB } from \"../shared/labs.js\";\nimport { ActionQueryError } from \"./action-query-error\";\nimport { AppIcon } from \"./app-icon\";\nimport { AppList, AppListRow } from \"./app-list-row\";\nimport { Badge } from \"./ui/badge\";\nimport { Button } from \"./ui/button\";\nimport { Skeleton } from \"./ui/skeleton\";\nimport { Spinner } from \"./ui/spinner\";\n\ninterface CommunityAppSource {\n  id: string;\n  name: string;\n  description?: string;\n  appId: string;\n  repo: string;\n  ref: string;\n  license: string;\n  provenance: string;\n  templatePath: string;\n  installed: boolean;\n  pending: boolean;\n  installable: boolean;\n  installUnavailableReason?:\n    | \"workspace-required\"\n    | \"app-id-conflict\"\n    | \"builder-install-unverified\";\n}\n\nfunction pinnedSourceUrl(source: CommunityAppSource): string {\n  return (\n    \"https://github.com/\" +\n    source.repo +\n    \"/tree/\" +\n    source.ref +\n    \"/\" +\n    source.templatePath\n  );\n}\n\nexport function CommunityAppsSection() {\n  const t = useT();\n  const enabled = useLab(COMMUNITY_APPS_LAB);\n  const [installingId, setInstallingId] = useState<string | null>(null);\n  const catalogQuery = useActionQuery<CommunityAppSource[]>(\n    \"list-curated-community-apps\" as never,\n    {},\n    { enabled },\n  );\n  const workspaceAppsQuery = useActionQuery(\"list-workspace-apps\", {\n    includeAgentCards: false,\n    includeArchived: true,\n  });\n  const install = useActionMutation(\"install-curated-community-app\", {\n    onSuccess: (result) => {\n      const mode = (result as { mode?: string } | null)?.mode;\n      const message = (result as { message?: string } | null)?.message;\n      if (mode === \"builder\") {\n        toast.success(t(\"dispatch.pages.communityAppsInstallStarted\"));\n      } else if (mode === \"pending\") {\n        toast.info(t(\"dispatch.pages.communityAppsPending\"));\n      } else if (mode === \"already-installed\") {\n        toast.success(t(\"dispatch.pages.communityAppsAlreadyInstalled\"));\n      } else if (mode === \"builder-unavailable\" || mode === \"app-id-taken\") {\n        toast.error(message || t(\"dispatch.pages.communityAppsInstallFailed\"));\n      } else if (mode === \"local-agent\") {\n        sendToAgentChat({\n          message:\n            (result as { prompt?: string } | null)?.prompt ||\n            t(\"dispatch.pages.communityAppsLocalRequestReady\"),\n          attachments: (\n            result as {\n              attachments?: Array<{\n                type: \"file\";\n                name: string;\n                contentType: string;\n                text: string;\n              }>;\n            } | null\n          )?.attachments,\n          submit: true,\n          type: \"code\",\n          newTab: true,\n          reuseEmptyTab: true,\n        });\n        toast.info(t(\"dispatch.pages.communityAppsLocalRequestReady\"));\n      } else {\n        toast.error(t(\"dispatch.pages.communityAppsInstallFailed\"));\n      }\n      setInstallingId(null);\n      void catalogQuery.refetch();\n      void workspaceAppsQuery.refetch();\n    },\n    onError: () => {\n      setInstallingId(null);\n      toast.error(t(\"dispatch.pages.communityAppsInstallFailed\"));\n    },\n  });\n\n  if (!enabled) return null;\n\n  return (\n    <section className=\"space-y-3 border-t pt-6\">\n      <h2 className=\"text-sm font-semibold text-foreground\">\n        {t(\"dispatch.pages.communityApps\")}\n      </h2>\n      {catalogQuery.isError ? (\n        <ActionQueryError\n          error={catalogQuery.error}\n          onRetry={() => void catalogQuery.refetch()}\n        />\n      ) : catalogQuery.isLoading ? (\n        <AppList className=\"divide-y rounded-xl border\">\n          <div className=\"flex items-center gap-3 px-4 py-3.5\">\n            <Skeleton className=\"size-8 rounded-lg\" />\n            <Skeleton className=\"h-4 w-40\" />\n          </div>\n        </AppList>\n      ) : catalogQuery.data?.length ? (\n        <AppList className=\"divide-y rounded-xl border\">\n          {catalogQuery.data.map((source) => (\n            <AppListRow key={source.id} className=\"border-b-0\">\n              <AppIcon id={source.id} name={source.name} size=\"sm\" />\n              <div className=\"min-w-0 flex-1\">\n                <div className=\"flex min-w-0 flex-wrap items-center gap-2\">\n                  <h3 className=\"truncate text-sm font-semibold text-foreground\">\n                    {source.name}\n                  </h3>\n                  {source.installed ? (\n                    <Badge variant=\"secondary\" className=\"gap-1\">\n                      <IconCircleCheck size={13} />\n                      {t(\"dispatch.pages.communityAppsInstalled\")}\n                    </Badge>\n                  ) : source.pending ? (\n                    <Badge variant=\"secondary\">\n                      {t(\"dispatch.pages.communityAppsPending\")}\n                    </Badge>\n                  ) : null}\n                </div>\n                {source.description ? (\n                  <p className=\"mt-0.5 truncate text-xs text-muted-foreground\">\n                    {source.description}\n                  </p>\n                ) : null}\n                <div className=\"mt-1 flex flex-wrap items-center gap-x-2 text-xs text-muted-foreground\">\n                  <span>\n                    {t(\"dispatch.pages.communityAppsLicense\")}: {source.license}\n                  </span>\n                  <a\n                    href={pinnedSourceUrl(source)}\n                    target=\"_blank\"\n                    rel=\"noreferrer\"\n                    className=\"inline-flex items-center gap-1 underline-offset-4 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n                  >\n                    {t(\"dispatch.pages.communityAppsTemplateSource\")}\n                    <IconArrowUpRight size={12} aria-hidden=\"true\" />\n                  </a>\n                </div>\n              </div>\n              {source.installable ? (\n                <Button\n                  type=\"button\"\n                  size=\"sm\"\n                  variant=\"outline\"\n                  disabled={install.isPending}\n                  onClick={() => {\n                    setInstallingId(source.id);\n                    install.mutate({ sourceId: source.id });\n                  }}\n                >\n                  {install.isPending && installingId === source.id ? (\n                    <Spinner className=\"mr-1.5\" />\n                  ) : (\n                    <IconPlus size={14} className=\"mr-1.5\" />\n                  )}\n                  {install.isPending && installingId === source.id\n                    ? t(\"dispatch.pages.communityAppsInstalling\")\n                    : t(\"dispatch.pages.communityAppsInstall\")}\n                </Button>\n              ) : !source.installed &&\n                !source.pending &&\n                source.installUnavailableReason === \"workspace-required\" ? (\n                <span className=\"max-w-48 text-right text-xs text-muted-foreground\">\n                  {t(\"dispatch.pages.communityAppsWorkspaceRequired\")}\n                </span>\n              ) : !source.installed &&\n                !source.pending &&\n                source.installUnavailableReason === \"app-id-conflict\" ? (\n                <span className=\"max-w-48 text-right text-xs text-muted-foreground\">\n                  {t(\"dispatch.pages.communityAppsIdConflict\")}\n                </span>\n              ) : !source.installed &&\n                !source.pending &&\n                source.installUnavailableReason ===\n                  \"builder-install-unverified\" ? (\n                <span className=\"max-w-48 text-right text-xs text-muted-foreground\">\n                  {t(\"dispatch.pages.communityAppsBuilderInstallUnavailable\")}\n                </span>\n              ) : null}\n            </AppListRow>\n          ))}\n        </AppList>\n      ) : (\n        <p className=\"text-sm text-muted-foreground\">\n          {t(\"dispatch.pages.communityAppsEmpty\")}\n        </p>\n      )}\n    </section>\n  );\n}\n"]}

package/dist/components/workspace-app-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-app-card.d.ts","sourceRoot":"","sources":["../../src/components/workspace-app-card.tsx"],"names":[],"mappings":"AA6BA,OAAO,EASL,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AA2D/B,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,SAAS,EACT,QAAgB,EAChB,cAAc,GACf,EAAE;IACD,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B,mDA6NA"}
+{"version":3,"file":"workspace-app-card.d.ts","sourceRoot":"","sources":["../../src/components/workspace-app-card.tsx"],"names":[],"mappings":"AA+BA,OAAO,EASL,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AA4E/B,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,SAAS,EACT,QAAgB,EAChB,cAAc,GACf,EAAE;IACD,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B,mDA6SA"}

package/dist/components/workspace-app-card.js

@@ -1,6 +1,8 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useActionMutation, useActionQuery, } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
+import { useOrgRole } from "@agent-native/core/client/org";
+import { parseAgentProfileMetadata } from "@agent-native/core/shared";
 import { APP_ACTION_MENU_CONTENT_CLASS } from "@agent-native/toolkit/app/chat/chat-first/app-open-actions";
 import { ShareButton } from "@agent-native/toolkit/app/sharing";
 import { IconChevronDown, IconChevronRight, IconClockHour4, IconEdit, IconEye, IconEyeOff, IconFileText, IconKey, IconPin, IconShare3, IconSettings, IconTrash, IconUser, IconUsersGroup, IconWorld, } from "@tabler/icons-react";
@@ -24,6 +26,20 @@ import { Textarea } from "./ui/textarea.js";
 import { Tooltip, TooltipContent, TooltipTrigger } from "./ui/tooltip.js";
 import { AppResourceEffectiveStack } from "./workspace-resource-effective-stack.js";
 const APP_CARD_ACTION_CLASS = "size-7 rounded-md p-0 text-muted-foreground transition-[background-color,color] hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring data-[state=open]:bg-accent data-[state=open]:text-foreground";
+function normalizeProfileDescription(value) {
+    return value.replace(/[\r\n]+/g, " ").replace(/[\u0000-\u001f\u007f]/g, "");
+}
+function normalizeWhenToUseText(value) {
+    return value
+        .replace(/\r\n?/g, "\n")
+        .replace(/[\u0000-\u0009\u000b-\u001f\u007f]/g, "");
+}
+function parseWhenToUseText(value) {
+    return value
+        .split("\n")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
 function deferWorkspaceAppOverlayOpen(event, closeMenu, openOverlay) {
     event.preventDefault();
     closeMenu();
@@ -43,6 +59,11 @@ function consumeWorkspaceAppOverlayFocusRestore(pendingOverlayRef, event) {
 }
 export function WorkspaceAppCard({ app, className, isPinned = false, onTogglePinned, }) {
     const t = useT();
+    const { org, role, isLoading: orgLoading, error: orgError } = useOrgRole();
+    const canEditMetadata = !orgLoading &&
+        !orgError &&
+        !!org?.orgId &&
+        (role === "owner" || role === "admin");
     const href = workspaceAppHref(app);
     const directHref = app.status !== "pending" &&
         !isWorkspaceSsoApp(app) &&
@@ -60,13 +81,22 @@ export function WorkspaceAppCard({ app, className, isPinned = false, onTogglePin
     const [keysOpen, setKeysOpen] = useState(false);
     const [resourcesOpen, setResourcesOpen] = useState(false);
     const [draftName, setDraftName] = useState(app.name);
-    const [draftDescription, setDraftDescription] = useState(app.description || "");
+    const [draftDescription, setDraftDescription] = useState(normalizeProfileDescription(app.description || ""));
+    const [draftWhenToUse, setDraftWhenToUse] = useState(app.whenToUse?.join("\n") ?? "");
+    const draftWhenToUseValues = parseWhenToUseText(draftWhenToUse);
+    const validProfile = Boolean(parseAgentProfileMetadata({
+        ...(draftDescription.trim()
+            ? { description: draftDescription.trim() }
+            : {}),
+        whenToUse: draftWhenToUseValues,
+    }));
     useEffect(() => {
         if (editOpen)
             return;
         setDraftName(app.name);
-        setDraftDescription(app.description || "");
-    }, [app.description, app.name, editOpen]);
+        setDraftDescription(normalizeProfileDescription(app.description || ""));
+        setDraftWhenToUse(app.whenToUse?.join("\n") ?? "");
+    }, [app.description, app.name, app.whenToUse, editOpen]);
     const archive = useActionMutation("archive-workspace-app", {
         onError: (err) => toast.error(`Could not hide ${app.name}: ${stringifyError(err)}`),
     });
@@ -102,22 +132,46 @@ export function WorkspaceAppCard({ app, className, isPinned = false, onTogglePin
             toast.error("App name is required.");
             return;
         }
+        const description = draftDescription.trim();
+        const currentDescription = normalizeProfileDescription(app.description || "").trim();
+        const currentWhenToUse = app.whenToUse ?? [];
+        const nameChanged = name !== app.name.trim();
+        const descriptionChanged = description !== currentDescription;
+        const whenToUseChanged = draftWhenToUseValues.length !== currentWhenToUse.length ||
+            draftWhenToUseValues.some((example, index) => example !== currentWhenToUse[index]);
+        if (!parseAgentProfileMetadata({
+            ...(description ? { description } : {}),
+            whenToUse: draftWhenToUseValues,
+        })) {
+            return;
+        }
+        if (!nameChanged && !descriptionChanged && !whenToUseChanged) {
+            setEditOpen(false);
+            return;
+        }
         updateMetadata.mutate({
             appId: app.id,
-            name,
-            description: draftDescription.trim(),
+            ...(nameChanged ? { name } : {}),
+            ...(descriptionChanged ? { description } : {}),
+            ...(whenToUseChanged ? { whenToUse: draftWhenToUseValues } : {}),
         });
     };
     const pinLabel = t(isPinned ? "dispatch.pages.unpinApp" : "dispatch.pages.pinApp", {
         name: app.name,
         defaultValue: isPinned ? "Unpin this app" : "Pin this app",
     });
-    return (_jsxs(_Fragment, { children: [_jsxs(AppListRow, { className: cn(!href && "opacity-60", isArchived && "opacity-70", className), children: [_jsx(AppIcon, { id: app.id, name: app.name, size: "sm" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("h3", { className: "truncate text-sm font-semibold text-foreground", children: app.name }), app.description || isPending ? (_jsx("p", { className: "mt-0.5 truncate text-xs text-muted-foreground", children: app.description || pendingLabel })) : null, _jsxs("div", { className: "mt-1.5 flex min-w-0 flex-wrap items-center gap-2 text-[11px] text-muted-foreground", children: [isPending ? (_jsxs("span", { className: "inline-flex min-w-0 items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconClockHour4, { size: 12 }), _jsx("span", { className: "truncate", children: pendingLabel })] })) : null, isArchived ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconEyeOff, { size: 12 }), "Hidden"] })) : null, audience === "public" ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconWorld, { size: 12 }), "Public"] })) : null] })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-2", children: [_jsx(WorkspaceAppOpenActions, { app: app, href: directHref ?? href, openDirectly: Boolean(directHref && shouldOpenWorkspaceAppInTopWindow()), isPinned: isPinned, pinLabel: pinLabel, pendingOpenLabel: pendingOpenLabel, onTogglePinned: onTogglePinned }), _jsx(WorkspaceAppSettings, { app: app, isArchived: isArchived, isPending: isPending, onEdit: () => setEditOpen(true), onKeys: () => setKeysOpen(true), onResources: () => setResourcesOpen(true), onArchive: handleArchive, onUnarchive: handleUnarchive, onRemovePending: handleRemovePending, labels: {
+    return (_jsxs(_Fragment, { children: [_jsxs(AppListRow, { className: cn(!href && "opacity-60", isArchived && "opacity-70", className), children: [_jsx(AppIcon, { id: app.id, name: app.name, size: "sm" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("h3", { className: "truncate text-sm font-semibold text-foreground", children: app.name }), app.description || isPending ? (_jsx("p", { className: "mt-0.5 truncate text-xs text-muted-foreground", children: app.description || pendingLabel })) : null, _jsxs("div", { className: "mt-1.5 flex min-w-0 flex-wrap items-center gap-2 text-[11px] text-muted-foreground", children: [isPending ? (_jsxs("span", { className: "inline-flex min-w-0 items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconClockHour4, { size: 12 }), _jsx("span", { className: "truncate", children: pendingLabel })] })) : null, isArchived ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconEyeOff, { size: 12 }), "Hidden"] })) : null, audience === "public" ? (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-muted px-2 py-0.5", children: [_jsx(IconWorld, { size: 12 }), "Public"] })) : null] })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-2", children: [_jsx(WorkspaceAppOpenActions, { app: app, href: directHref ?? href, openDirectly: Boolean(directHref && shouldOpenWorkspaceAppInTopWindow()), isPinned: isPinned, pinLabel: pinLabel, pendingOpenLabel: pendingOpenLabel, onTogglePinned: onTogglePinned }), _jsx(WorkspaceAppSettings, { app: app, canEditMetadata: canEditMetadata, isArchived: isArchived, isPending: isPending, onEdit: () => setEditOpen(true), onKeys: () => setKeysOpen(true), onResources: () => setResourcesOpen(true), onArchive: handleArchive, onUnarchive: handleUnarchive, onRemovePending: handleRemovePending, labels: {
                                     createdBy: t("agents.dashboardMetadataCreatedBy"),
                                     owner: t("dispatch.pages.appMetadataOwner"),
                                     teams: t("dispatch.pages.appMetadataTeams"),
                                     share: t("share.share", { defaultValue: "Share" }),
-                                } })] })] }), _jsx(Dialog, { open: editOpen, onOpenChange: setEditOpen, children: _jsxs(DialogContent, { children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: "Edit app details" }) }), _jsxs("form", { className: "space-y-4", onSubmit: handleMetadataSubmit, children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: `app-name-${app.id}`, children: "Name" }), _jsx(Input, { id: `app-name-${app.id}`, value: draftName, maxLength: 120, onChange: (event) => setDraftName(event.target.value) })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: `app-description-${app.id}`, children: "Description" }), _jsx(Textarea, { id: `app-description-${app.id}`, value: draftDescription, maxLength: 500, rows: 4, onChange: (event) => setDraftDescription(event.target.value) })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => setEditOpen(false), children: "Cancel" }), _jsx(Button, { type: "submit", disabled: updateMetadata.isPending, children: updateMetadata.isPending ? "Saving..." : "Save" })] })] })] }) }), _jsx(Dialog, { open: keysOpen, onOpenChange: setKeysOpen, children: _jsxs(DialogContent, { className: "max-w-md", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Manage keys for ", app.name] }), _jsx(DialogDescription, { children: "Choose which workspace credentials this app can use." })] }), _jsx(AppKeysPanel, { appId: app.id, appName: app.name }), _jsx(DialogFooter, { children: _jsx(Button, { type: "button", onClick: () => setKeysOpen(false), children: "Done" }) })] }) }), _jsx(AppResourcesDialog, { app: app, open: resourcesOpen, onOpenChange: setResourcesOpen })] }));
+                                } })] })] }), _jsx(Dialog, { open: editOpen, onOpenChange: setEditOpen, children: _jsxs(DialogContent, { children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: "Edit app details" }) }), _jsxs("form", { className: "space-y-4", onSubmit: handleMetadataSubmit, children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: `app-name-${app.id}`, children: "Name" }), _jsx(Input, { id: `app-name-${app.id}`, value: draftName, maxLength: 120, onChange: (event) => setDraftName(event.target.value) })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: `app-description-${app.id}`, children: "Description" }), _jsx(Textarea, { id: `app-description-${app.id}`, value: draftDescription, maxLength: 1000, rows: 4, onChange: (event) => setDraftDescription(normalizeProfileDescription(event.target.value)) })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: `app-when-to-use-${app.id}`, children: t("dispatch.pages.appProfileWhenToUse", {
+                                                defaultValue: "When to use",
+                                            }) }), _jsx(Textarea, { id: `app-when-to-use-${app.id}`, value: draftWhenToUse, "aria-invalid": !validProfile, rows: 3, placeholder: t("dispatch.pages.appProfileWhenToUsePlaceholder", {
+                                                defaultValue: "One example request per line",
+                                            }), onChange: (event) => setDraftWhenToUse(normalizeWhenToUseText(event.target.value)) }), _jsx("p", { className: "text-xs text-muted-foreground", children: t("dispatch.pages.appProfileWhenToUseHint", {
+                                                defaultValue: "Add up to 6 examples, with no more than 140 characters each.",
+                                            }) })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => setEditOpen(false), children: "Cancel" }), _jsx(Button, { type: "submit", disabled: updateMetadata.isPending || !validProfile, children: updateMetadata.isPending ? "Saving..." : "Save" })] })] })] }) }), _jsx(Dialog, { open: keysOpen, onOpenChange: setKeysOpen, children: _jsxs(DialogContent, { className: "max-w-md", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Manage keys for ", app.name] }), _jsx(DialogDescription, { children: "Choose which workspace credentials this app can use." })] }), _jsx(AppKeysPanel, { appId: app.id, appName: app.name }), _jsx(DialogFooter, { children: _jsx(Button, { type: "button", onClick: () => setKeysOpen(false), children: "Done" }) })] }) }), _jsx(AppResourcesDialog, { app: app, open: resourcesOpen, onOpenChange: setResourcesOpen })] }));
 }
 function WorkspaceAppOpenActions({ app, href, openDirectly, isPinned, pinLabel, pendingOpenLabel, onTogglePinned, }) {
     const navigate = useNavigate();
@@ -144,7 +198,7 @@ function WorkspaceAppOpenActions({ app, href, openDirectly, isPinned, pinLabel,
             ]
             : undefined }));
 }
-function WorkspaceAppSettings({ app, isArchived, isPending, onEdit, onKeys, onResources, onArchive, onUnarchive, onRemovePending, labels, }) {
+function WorkspaceAppSettings({ app, canEditMetadata, isArchived, isPending, onEdit, onKeys, onResources, onArchive, onUnarchive, onRemovePending, labels, }) {
     const [shareOpen, setShareOpen] = useState(false);
     const [settingsOpen, setSettingsOpen] = useState(false);
     const settingsTriggerRef = useRef(null);
@@ -162,7 +216,7 @@ function WorkspaceAppSettings({ app, isArchived, isPending, onEdit, onKeys, onRe
             setTimeout(restoreSettingsFocus, 0);
         }
     };
-    return (_jsxs(_Fragment, { children: [_jsxs(DropdownMenu, { open: settingsOpen, onOpenChange: setSettingsOpen, children: [_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { type: "button", variant: "ghost", size: "sm", ref: settingsTriggerRef, "aria-label": `Settings for ${app.name}`, className: APP_CARD_ACTION_CLASS, children: _jsx(IconSettings, { size: 15 }) }) }) }), _jsx(TooltipContent, { children: "App settings" })] }), _jsxs(DropdownMenuContent, { align: "end", className: cn(APP_ACTION_MENU_CONTENT_CLASS, "min-w-max"), onCloseAutoFocus: (event) => consumeWorkspaceAppOverlayFocusRestore(pendingShareOverlayRef, event), children: [_jsxs(DropdownMenuItem, { onSelect: onEdit, children: [_jsx(IconEdit, { size: 14, "aria-hidden": "true" }), "Edit details"] }), !isPending ? (_jsxs(DropdownMenuItem, { onSelect: (event) => deferWorkspaceAppOverlayOpen(event, () => {
+    return (_jsxs(_Fragment, { children: [_jsxs(DropdownMenu, { open: settingsOpen, onOpenChange: setSettingsOpen, children: [_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { type: "button", variant: "ghost", size: "sm", ref: settingsTriggerRef, "aria-label": `Settings for ${app.name}`, className: APP_CARD_ACTION_CLASS, children: _jsx(IconSettings, { size: 15 }) }) }) }), _jsx(TooltipContent, { children: "App settings" })] }), _jsxs(DropdownMenuContent, { align: "end", className: cn(APP_ACTION_MENU_CONTENT_CLASS, "min-w-max"), onCloseAutoFocus: (event) => consumeWorkspaceAppOverlayFocusRestore(pendingShareOverlayRef, event), children: [canEditMetadata ? (_jsxs(DropdownMenuItem, { onSelect: onEdit, children: [_jsx(IconEdit, { size: 14, "aria-hidden": "true" }), "Edit details"] })) : null, !isPending ? (_jsxs(DropdownMenuItem, { onSelect: (event) => deferWorkspaceAppOverlayOpen(event, () => {
                                     pendingShareOverlayRef.current = true;
                                     setSettingsOpen(false);
                                 }, () => setShareOpen(true)), children: [_jsx(IconShare3, { size: 14, "aria-hidden": "true" }), labels.share] })) : null, !isPending && !isArchived ? (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: onKeys, children: [_jsx(IconKey, { size: 14, "aria-hidden": "true" }), "Manage keys"] }), _jsxs(DropdownMenuItem, { onSelect: onResources, children: [_jsx(IconFileText, { size: 14, "aria-hidden": "true" }), "Agent resources"] })] })) : null, isPending ? (_jsxs(DropdownMenuItem, { onSelect: onRemovePending, className: "text-destructive focus:text-destructive", children: [_jsx(IconTrash, { size: 14, "aria-hidden": "true" }), "Remove from list"] })) : isArchived ? (_jsxs(DropdownMenuItem, { onSelect: onUnarchive, children: [_jsx(IconEye, { size: 14, "aria-hidden": "true" }), "Restore to list"] })) : (_jsxs(DropdownMenuItem, { onSelect: onArchive, children: [_jsx(IconEyeOff, { size: 14, "aria-hidden": "true" }), "Hide from list"] })), _jsx(WorkspaceAppMetadata, { app: app, labels: labels })] })] }), !isPending && shareOpen ? (_jsx(ShareButton, { resourceType: "workspace-app", resourceId: app.id, resourceTitle: app.name, defaultOpen: true, onOpenChange: handleShareOpenChange, triggerClassName: "sr-only" })) : null] }));