@stigmer/react 3.1.16 → 3.2.0

package/channel/ConnectSlackDialog.js

@@ -0,0 +1,238 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getErrorReason } from "@stigmer/sdk";
+import { AgentChannelInstallState } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/status_pb";
+import { Button } from "../button/Button.js";
+import { useChannelAppList } from "../channel-app/useChannelAppList.js";
+import { useDeploymentMode } from "../deployment-mode.js";
+import { CloudFeatureNotice } from "../internal/CloudFeatureNotice.js";
+import { RegisterChannelAppAffordance, ServingAppSection, } from "./connect/ServingAppSection.js";
+import { ToolCredentialsSection } from "./connect/ToolCredentialsSection.js";
+import { RefusalBox, VerbatimRefusal } from "./connect/VerbatimRefusal.js";
+import { CheckIcon, CloseIcon, Spinner } from "./connect/icons.js";
+import { useConnectSlackChannel } from "./useConnectSlackChannel.js";
+import { useCreateAgentChannel } from "./useCreateAgentChannel.js";
+import { useOrgAgentChannelList } from "./useOrgAgentChannelList.js";
+import { SlackMarkIcon } from "./SlackMarkIcon.js";
+/**
+ * The connect flow for a Slack channel: create the {@link AgentChannel}
+ * (create mode), then run the "Add to Slack" OAuth install in a popup
+ * and report progress phase by phase.
+ *
+ * Requires a deployment with platform Slack app credentials — on a
+ * `local` (OSS) backend the flow is preempted with a cloud-feature
+ * notice, matching the server's FAILED_PRECONDITION refusal. Install
+ * refusals (unconfigured deployment, duplicate workspace, Enterprise
+ * Grid) render the server's copy verbatim — the server owns that
+ * vocabulary.
+ *
+ * Built on the native `<dialog>` element for focus trapping and escape
+ * handling, matching the SDK's modal convention ({@link ShareAgentDialog}).
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * Most hosts mount it via {@link AgentChannelsPanel} (the Channels tab).
+ * Render it directly only when you own the open-state.
+ */
+export function ConnectSlackDialog({ open, onOpenChange, agent, channel, onChannelsChanged, modal = true, channelAppsHref, }) {
+    const dialogRef = useRef(null);
+    const handleClose = useCallback(() => {
+        dialogRef.current?.close();
+        onOpenChange(false);
+    }, [onOpenChange]);
+    // Sync native dialog open state (matches the SDK dialog convention).
+    // Non-modal hosts pass `open` as a plain attribute instead — the dialog
+    // renders in-flow with no top layer to manage.
+    const prevOpenRef = useRef(false);
+    if (modal && open !== prevOpenRef.current) {
+        prevOpenRef.current = open;
+        if (open) {
+            requestAnimationFrame(() => {
+                if (dialogRef.current && !dialogRef.current.open) {
+                    dialogRef.current.showModal();
+                }
+            });
+        }
+        else if (dialogRef.current?.open) {
+            dialogRef.current.close();
+        }
+    }
+    return (_jsx("dialog", { ref: dialogRef, open: modal ? undefined : open, onClose: handleClose, className: cn("w-full max-w-md rounded-xl border border-border bg-popover p-0 shadow-xl", modal ? "fixed inset-0 m-auto backdrop:bg-black/50" : "relative"), "aria-labelledby": "connect-slack-title", children: open && (_jsx(ConnectSlackDialogBody, { agent: agent, channel: channel ?? null, onChannelsChanged: onChannelsChanged, onClose: handleClose, channelAppsHref: channelAppsHref })) }));
+}
+function ConnectSlackDialogBody({ agent, channel, onChannelsChanged, onClose, channelAppsHref, }) {
+    const deploymentMode = useDeploymentMode();
+    const agentName = agent.metadata?.name || agent.metadata?.slug || "this agent";
+    const org = agent.metadata?.org ?? "";
+    const { createChannel, isPending: isCreating } = useCreateAgentChannel();
+    const slack = useConnectSlackChannel();
+    const [name, setName] = useState(() => channel ? (channel.metadata?.name ?? "") : `${agentName} Slack`);
+    // Tool credentials bound at connect time (create mode only — a
+    // reconnect keeps the channel's existing bindings untouched; edits go
+    // through the channel card's credentials dialog).
+    const [environmentRefs, setEnvironmentRefs] = useState([]);
+    // The serving app (create mode only): null = the platform Stigmer app;
+    // a ref = one of the org's own channel apps (BYO — the bot carries that
+    // app's name, and each app is its own bot identity). A reconnect keeps
+    // the channel's existing binding — an installed channel's app_ref is
+    // frozen server-side.
+    const [appRef, setAppRef] = useState(null);
+    const [installed, setInstalled] = useState(null);
+    const [error, setError] = useState(null);
+    // The org's channel apps, fetched once here so the serving-app picker,
+    // the addressing copy, and the advisory all read one consistent list.
+    const { channelApps } = useChannelAppList(org || null);
+    const slackApps = useMemo(() => channelApps.filter((app) => app.spec?.providerConfig?.case === "slack"), [channelApps]);
+    // The app the install will (or did) go through: the picker's choice in
+    // create mode, the frozen spec.app_ref on a reconnect. null = platform.
+    const effectiveAppRef = channel
+        ? channel.spec?.appRef?.slug
+            ? { org: channel.spec.appRef.org || org, slug: channel.spec.appRef.slug }
+            : null
+        : appRef;
+    const selectedApp = effectiveAppRef
+        ? slackApps.find((app) => app.metadata?.slug === effectiveAppRef.slug) ?? null
+        : null;
+    // What members type after "@" in Slack. App-level, not agent-level: the
+    // platform app's bot is "Stigmer"; a BYO app's bot carries the name its
+    // manifest declared — which the registration form seeded from the
+    // ChannelApp's own name.
+    const botName = effectiveAppRef
+        ? selectedApp?.metadata?.name || effectiveAppRef.slug
+        : "Stigmer";
+    // Workspaces the selected serving app already occupies, matched on the
+    // same key the database enforces uniqueness on: (team, channel app).
+    // Advisory only — the list is permission-bounded, and other orgs'
+    // holds are invisible; completeInstall stays the arbiter.
+    const advisoryActive = deploymentMode === "cloud" && !channel && !installed;
+    const { channels: orgChannels } = useOrgAgentChannelList(advisoryActive && org ? org : null);
+    const alreadyServed = useMemo(() => {
+        // Platform app installs stamp an empty channel_app_id.
+        const selectedAppId = effectiveAppRef ? selectedApp?.metadata?.id : "";
+        if (selectedAppId === undefined)
+            return [];
+        return orgChannels.filter((c) => c.status?.installState === AgentChannelInstallState.installed &&
+            c.status?.providerStatus?.case === "slack" &&
+            c.status.providerStatus.value.channelAppId === selectedAppId);
+    }, [orgChannels, effectiveAppRef, selectedApp]);
+    // One click drives the whole journey: (create →) initiate → popup →
+    // complete. It must stay a single synchronous entry point — the popup
+    // opens inside connect(), and browsers only allow that from a
+    // user-gesture call stack.
+    const handleConnect = useCallback(async () => {
+        setError(null);
+        try {
+            let target = channel;
+            if (!target) {
+                target = await createChannel({
+                    name: name.trim() || `${agentName} Slack`,
+                    org,
+                    agentRef: {
+                        org,
+                        slug: agent.metadata?.slug ?? "",
+                    },
+                    enabled: true,
+                    slack: {},
+                    ...(appRef ? { appRef } : {}),
+                    ...(environmentRefs.length > 0 ? { environmentRefs } : {}),
+                });
+                // The channel now exists even if the install below fails or is
+                // abandoned — surface it in the list either way.
+                onChannelsChanged?.();
+            }
+            const result = await slack.connect(target.metadata?.id ?? "");
+            setInstalled(result);
+            onChannelsChanged?.();
+        }
+        catch (err) {
+            // Cancellation is a user decision, not a failure — the hook keeps
+            // error null for it; everything else renders below.
+            setError(slack.error ?? (err instanceof Error ? err : new Error(String(err))));
+        }
+    }, [agent, agentName, appRef, channel, createChannel, environmentRefs, name, org, onChannelsChanged, slack]);
+    const handleCancel = useCallback(() => {
+        slack.clearError();
+        setError(null);
+    }, [slack]);
+    const busy = isCreating || slack.isInProgress;
+    return (_jsxs("div", { className: "flex flex-col", children: [_jsxs("div", { className: "flex items-start justify-between gap-3 border-b border-border px-5 py-4", children: [_jsxs("div", { className: "flex items-center gap-2.5", children: [_jsx(SlackMarkIcon, { className: "size-5 text-foreground" }), _jsx("h2", { id: "connect-slack-title", className: "text-sm font-semibold text-foreground", children: channel ? "Reconnect to Slack" : "Connect to Slack" })] }), _jsx("button", { type: "button", onClick: onClose, "aria-label": "Close dialog", className: cn("rounded p-1 text-muted-foreground", "hover:bg-accent-hover hover:text-foreground", "focus:outline-none focus:ring-1 focus:ring-ring"), children: _jsx(CloseIcon, {}) })] }), _jsx("div", { className: "space-y-4 px-5 py-4", children: deploymentMode === "local" ? (
+                // Preempt the doomed flow: the OSS backend answers every install
+                // with FAILED_PRECONDITION, so don't open a popup destined to fail.
+                _jsx(CloudFeatureNotice, { children: "Channel installs require Stigmer Cloud. The local backend manages channel configuration, but connecting to Slack uses the platform's hosted Slack app." })) : installed ? (_jsx(InstalledSummary, { channel: installed, agentName: agentName, botName: botName })) : busy ? (_jsx(FlowProgress, { phase: slack.phase, onCancel: handleCancel })) : (_jsxs(_Fragment, { children: [!channel && (_jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1.5 block text-xs font-medium text-foreground", children: "Channel name" }), _jsx("input", { type: "text", value: name, onChange: (e) => setName(e.target.value), disabled: busy, className: cn("w-full rounded-md border border-input bg-background px-3 py-1.5", "text-sm text-foreground placeholder:text-muted-foreground", "focus:outline-none focus:ring-1 focus:ring-ring") }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Names the connection in Stigmer \u2014 pick something that identifies the workspace if you connect more than one." })] })), !channel && (_jsx(ServingAppSection, { org: org, apps: slackApps, value: appRef, onChange: setAppRef, disabled: busy, channelAppsHref: channelAppsHref, idPrefix: "stgm-slack-app", platformOption: {
+                                label: "Stigmer app",
+                                hint: "Fastest — no setup, the bot is named Stigmer",
+                            }, appHint: "Your app \u2014 your bot name and icon", emptyBody: _jsxs("p", { className: "text-xs text-muted-foreground", children: ["The platform", " ", _jsx("span", { className: "font-medium text-foreground", children: "Stigmer" }), " ", "app \u2014 no setup needed. Want the bot to carry your own name and icon, or several agents in one workspace?", " ", _jsx(RegisterChannelAppAffordance, { channelAppsHref: channelAppsHref, children: "Register a channel app" }), "."] }) })), alreadyServed.length > 0 && (_jsx(AlreadyServedNote, { botName: botName, channels: alreadyServed })), !channel && (_jsx(ToolCredentialsSection, { agent: agent, org: org, value: environmentRefs, onChange: setEnvironmentRefs, disabled: busy })), _jsx("p", { className: "text-sm text-muted-foreground", children: "When you continue, Slack asks which workspace to add the bot to \u2014 pick the one where your team should chat with this agent." }), _jsxs("p", { className: "text-sm text-muted-foreground", children: ["Members reach the agent by opening a direct message with", " ", _jsx("span", { className: "font-medium text-foreground", children: botName }), ", or typing @ in a channel and picking", " ", _jsx("span", { className: "font-medium text-foreground", children: botName }), " ", "from the list \u2014 it answers as", " ", _jsx("span", { className: "font-medium text-foreground", children: agentName }), "."] }), _jsxs("p", { className: "text-xs text-muted-foreground", children: ["Conversations from Slack are billed to", " ", _jsx("span", { className: "font-medium", children: org }), ". A workspace can host one agent per Slack app."] }), error && (_jsx(InstallRefusal, { error: error, channelAppsHref: channelAppsHref }))] })) }), _jsx("div", { className: "flex justify-end gap-2 border-t border-border px-5 py-3", children: installed || deploymentMode === "local" ? (_jsx(Button, { variant: "outline", size: "sm", onClick: onClose, children: installed ? "Done" : "Close" })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: onClose, disabled: busy, children: "Cancel" }), _jsx(Button, { variant: "primary", size: "sm", onClick: () => void handleConnect(), disabled: busy, icon: _jsx(SlackMarkIcon, { className: "size-3.5" }), "data-cursor-target": "dialog-connect-slack", children: error ? "Try again" : channel ? "Reconnect to Slack" : "Connect to Slack" })] })) })] }));
+}
+// ---------------------------------------------------------------------------
+// Install refusal — guided for the duplicate-workspace reason
+// ---------------------------------------------------------------------------
+/**
+ * The reason code the server attaches (google.rpc.ErrorInfo, domain
+ * stigmer.ai) to a duplicate-workspace completeInstall refusal — see the
+ * completeInstall rpc comment for the vocabulary.
+ */
+const REASON_WORKSPACE_ALREADY_CONNECTED = "SLACK_WORKSPACE_ALREADY_CONNECTED";
+/**
+ * Install-refusal rendering. The duplicate-workspace refusal is the one
+ * a user can act on from here, so it gets a guided treatment — names the
+ * occupied workspace (from the ErrorInfo metadata) and offers the
+ * register-a-channel-app path. Every other refusal (and any error from a
+ * server not attaching reasons) renders the server's copy verbatim — the
+ * server owns that vocabulary.
+ */
+function InstallRefusal({ error, channelAppsHref, }) {
+    const reason = getErrorReason(error);
+    if (reason?.reason !== REASON_WORKSPACE_ALREADY_CONNECTED) {
+        return _jsx(VerbatimRefusal, { error: error });
+    }
+    const team = reason.metadata.team_name || "This workspace";
+    return (_jsxs(RefusalBox, { children: [_jsxs("p", { children: [_jsx("span", { className: "font-medium", children: team }), " already hosts an agent through this app \u2014 a workspace hosts one agent per Slack app."] }), _jsxs("p", { children: ["To reach it with this agent, disconnect the existing channel, or", " ", _jsx(RegisterChannelAppAffordance, { channelAppsHref: channelAppsHref, children: "register a channel app" }), " ", "and connect through that instead."] })] }));
+}
+/**
+ * Pre-OAuth advisory: the selected serving app already occupies these
+ * workspaces, matched on the exact key the database enforces —
+ * (workspace, serving app). Shown before the user spends a Slack OAuth
+ * round-trip discovering it. Best-effort by design: the list is bounded
+ * by the caller's visibility and cannot see other orgs' holds, so the
+ * copy warns rather than forbids.
+ */
+function AlreadyServedNote({ botName, channels, }) {
+    return (_jsx("div", { role: "status", className: "space-y-0.5 text-xs text-warning", children: channels.map((c) => {
+            const slack = c.status?.providerStatus?.case === "slack"
+                ? c.status.providerStatus.value
+                : null;
+            const team = slack?.teamName || slack?.teamId || "a workspace";
+            const agent = c.spec?.agentRef?.slug || "another agent";
+            return (_jsxs("p", { children: [_jsx("span", { className: "font-medium", children: botName }), " already serves", " ", _jsx("span", { className: "font-medium", children: team }), " via ", agent, " \u2014 a workspace hosts one agent per app, so connect through a different channel app to reach it."] }, c.metadata?.id ?? team));
+        }) }));
+}
+// ---------------------------------------------------------------------------
+// Flow progress — one row per phase, the active one live
+// ---------------------------------------------------------------------------
+const FLOW_STEPS = [
+    { phase: "initiating", label: "Contacting Slack" },
+    { phase: "awaiting-callback", label: "Waiting for your approval in the Slack window" },
+    { phase: "completing", label: "Finalizing the connection" },
+];
+function FlowProgress({ phase, onCancel, }) {
+    const activeIndex = FLOW_STEPS.findIndex((s) => s.phase === phase);
+    return (_jsxs("div", { className: "space-y-3", "aria-live": "polite", children: [_jsx("ul", { className: "space-y-2", children: FLOW_STEPS.map((step, i) => {
+                    const isActive = i === activeIndex;
+                    const isDone = activeIndex > i;
+                    return (_jsxs("li", { className: cn("flex items-center gap-2 text-sm", isActive
+                            ? "text-foreground"
+                            : isDone
+                                ? "text-muted-foreground"
+                                : "text-muted-foreground-subtle"), children: [isDone ? (_jsx(CheckIcon, { className: "size-3.5 shrink-0 text-success" })) : isActive ? (_jsx(Spinner, { className: "size-3.5 shrink-0" })) : (_jsx("span", { className: "size-3.5 shrink-0 rounded-full border border-border", "aria-hidden": "true" })), step.label] }, step.phase));
+                }) }), _jsx(Button, { variant: "ghost", size: "xs", onClick: onCancel, children: "Cancel" })] }));
+}
+// ---------------------------------------------------------------------------
+// Installed summary — the success state with the observed Slack facts
+// ---------------------------------------------------------------------------
+function InstalledSummary({ channel, agentName, botName, }) {
+    const slack = channel.status?.providerStatus?.case === "slack"
+        ? channel.status.providerStatus.value
+        : null;
+    return (_jsxs("div", { className: "space-y-2", role: "status", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-medium text-foreground", children: [_jsx(CheckIcon, { className: "size-4 text-success" }), "Connected", slack?.teamName ? ` to ${slack.teamName}` : ""] }), _jsxs("p", { className: "text-sm text-muted-foreground", children: ["In Slack, open a direct message with", " ", _jsx("span", { className: "font-medium text-foreground", children: botName }), " \u2014 or type @ in any channel and pick", " ", _jsx("span", { className: "font-medium text-foreground", children: botName }), " from the list \u2014 then ask your question. Answers come from", " ", _jsx("span", { className: "font-medium text-foreground", children: agentName }), "."] })] }));
+}
+//# sourceMappingURL=ConnectSlackDialog.js.map

package/channel/ConnectSlackDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectSlackDialog.js","sourceRoot":"","sources":["../../src/channel/ConnectSlackDialog.tsx"],"names":[],"mappings":"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"}

package/channel/ConnectWhatsAppDialog.d.ts

@@ -0,0 +1,70 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/** Props for {@link ConnectWhatsAppDialog}. */
+export interface ConnectWhatsAppDialogProps {
+    /** Whether the dialog is open. */
+    readonly open: boolean;
+    /** Called when the dialog requests an open-state change. */
+    readonly onOpenChange: (open: boolean) => void;
+    /** The agent the channel connects. */
+    readonly agent: Agent;
+    /**
+     * An existing channel to (re)connect — a `pending_install` channel
+     * whose install never completed. Unlike Slack's frozen reconnect, the
+     * number and serving app stay editable here: a failed direct install
+     * usually means one of them is wrong, and both are server-mutable
+     * while the channel isn't installed. When omitted, the dialog opens in
+     * **create mode**.
+     */
+    readonly channel?: AgentChannel | null;
+    /**
+     * Called after the channel set changes (created, or install completed).
+     * Hosts typically pass the channel list's `refetch`.
+     */
+    readonly onChannelsChanged?: () => void;
+    /**
+     * When `false`, renders as an in-flow open dialog instead of a
+     * top-layer modal — no `showModal()`, no backdrop, no focus trap.
+     * For embedding the dialog in a constrained surface (documentation
+     * demos, visual tests). Interactive hosts keep the default.
+     * @default true
+     */
+    readonly modal?: boolean;
+    /**
+     * Where the host manages Channel Apps (the console passes
+     * `/settings/channel-apps`). When provided, the serving-app section
+     * and install refusals render a "Register a channel app" link there.
+     * SDK components never hardcode host routes — hosts inject the
+     * destination. Absent, the affordance degrades to plain guidance text.
+     */
+    readonly channelAppsHref?: string;
+}
+/**
+ * The connect flow for a WhatsApp channel: create the
+ * {@link AgentChannel} (create mode), then run the direct install — one
+ * server call that verifies the declared phone number against Meta's
+ * Graph API through the selected channel app's credentials (DD-WA-1).
+ * No consent popup, no callback route.
+ *
+ * WhatsApp is BYO-only (DD-WA-2): there is no platform Meta app, so a
+ * serving channel app is required — with none registered, the flow
+ * blocks on registering one first. The declared phone number ID is
+ * likewise required: the install proves it, and an empty value can only
+ * fail there.
+ *
+ * Requires Stigmer Cloud — on a `local` (OSS) backend the flow is
+ * preempted with a cloud-feature notice, matching the server's
+ * FAILED_PRECONDITION refusal. Install refusals render the server's
+ * copy verbatim except the duplicate-number refusal, which gets a
+ * guided treatment.
+ *
+ * Built on the native `<dialog>` element for focus trapping and escape
+ * handling, matching the SDK's modal convention
+ * ({@link ConnectSlackDialog}). All visual properties flow through
+ * `--stgm-*` design tokens.
+ *
+ * Most hosts mount it via {@link AgentChannelsPanel} (the Channels tab).
+ * Render it directly only when you own the open-state.
+ */
+export declare function ConnectWhatsAppDialog({ open, onOpenChange, agent, channel, onChannelsChanged, modal, channelAppsHref, }: ConnectWhatsAppDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConnectWhatsAppDialog.d.ts.map

package/channel/ConnectWhatsAppDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectWhatsAppDialog.d.ts","sourceRoot":"","sources":["../../src/channel/ConnectWhatsAppDialog.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAoB9F,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,KAAY,EACZ,eAAe,GAChB,EAAE,0BAA0B,2CAiD5B"}

package/channel/ConnectWhatsAppDialog.js

@@ -0,0 +1,256 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getErrorReason } from "@stigmer/sdk";
+import { AgentChannelInstallState } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/status_pb";
+import { Button } from "../button/Button.js";
+import { useChannelAppList } from "../channel-app/useChannelAppList.js";
+import { useDeploymentMode } from "../deployment-mode.js";
+import { useStigmer } from "../hooks.js";
+import { CloudFeatureNotice } from "../internal/CloudFeatureNotice.js";
+import { RegisterChannelAppAffordance, ServingAppSection, } from "./connect/ServingAppSection.js";
+import { ToolCredentialsSection } from "./connect/ToolCredentialsSection.js";
+import { RefusalBox, VerbatimRefusal } from "./connect/VerbatimRefusal.js";
+import { CheckIcon, CloseIcon, Spinner } from "./connect/icons.js";
+import { useCreateAgentChannel } from "./useCreateAgentChannel.js";
+import { useInstallChannel } from "./useInstallChannel.js";
+import { useOrgAgentChannelList } from "./useOrgAgentChannelList.js";
+import { agentChannelToInput, useSaveAgentChannel } from "./useSaveAgentChannel.js";
+import { WhatsAppMarkIcon } from "./WhatsAppMarkIcon.js";
+/**
+ * The connect flow for a WhatsApp channel: create the
+ * {@link AgentChannel} (create mode), then run the direct install — one
+ * server call that verifies the declared phone number against Meta's
+ * Graph API through the selected channel app's credentials (DD-WA-1).
+ * No consent popup, no callback route.
+ *
+ * WhatsApp is BYO-only (DD-WA-2): there is no platform Meta app, so a
+ * serving channel app is required — with none registered, the flow
+ * blocks on registering one first. The declared phone number ID is
+ * likewise required: the install proves it, and an empty value can only
+ * fail there.
+ *
+ * Requires Stigmer Cloud — on a `local` (OSS) backend the flow is
+ * preempted with a cloud-feature notice, matching the server's
+ * FAILED_PRECONDITION refusal. Install refusals render the server's
+ * copy verbatim except the duplicate-number refusal, which gets a
+ * guided treatment.
+ *
+ * Built on the native `<dialog>` element for focus trapping and escape
+ * handling, matching the SDK's modal convention
+ * ({@link ConnectSlackDialog}). All visual properties flow through
+ * `--stgm-*` design tokens.
+ *
+ * Most hosts mount it via {@link AgentChannelsPanel} (the Channels tab).
+ * Render it directly only when you own the open-state.
+ */
+export function ConnectWhatsAppDialog({ open, onOpenChange, agent, channel, onChannelsChanged, modal = true, channelAppsHref, }) {
+    const dialogRef = useRef(null);
+    const handleClose = useCallback(() => {
+        dialogRef.current?.close();
+        onOpenChange(false);
+    }, [onOpenChange]);
+    // Sync native dialog open state (matches the SDK dialog convention).
+    // Non-modal hosts pass `open` as a plain attribute instead — the dialog
+    // renders in-flow with no top layer to manage.
+    const prevOpenRef = useRef(false);
+    if (modal && open !== prevOpenRef.current) {
+        prevOpenRef.current = open;
+        if (open) {
+            requestAnimationFrame(() => {
+                if (dialogRef.current && !dialogRef.current.open) {
+                    dialogRef.current.showModal();
+                }
+            });
+        }
+        else if (dialogRef.current?.open) {
+            dialogRef.current.close();
+        }
+    }
+    return (_jsx("dialog", { ref: dialogRef, open: modal ? undefined : open, onClose: handleClose, className: cn("w-full max-w-md rounded-xl border border-border bg-popover p-0 shadow-xl", modal ? "fixed inset-0 m-auto backdrop:bg-black/50" : "relative"), "aria-labelledby": "connect-whatsapp-title", children: open && (_jsx(ConnectWhatsAppDialogBody, { agent: agent, channel: channel ?? null, onChannelsChanged: onChannelsChanged, onClose: handleClose, channelAppsHref: channelAppsHref })) }));
+}
+function ConnectWhatsAppDialogBody({ agent, channel, onChannelsChanged, onClose, channelAppsHref, }) {
+    const stigmer = useStigmer();
+    const deploymentMode = useDeploymentMode();
+    const agentName = agent.metadata?.name || agent.metadata?.slug || "this agent";
+    const org = agent.metadata?.org ?? "";
+    const { createChannel, isPending: isCreating } = useCreateAgentChannel();
+    const { save, isPending: isSaving } = useSaveAgentChannel();
+    const installer = useInstallChannel();
+    const [name, setName] = useState(() => channel ? (channel.metadata?.name ?? "") : `${agentName} WhatsApp`);
+    // The declared number (spec.whatsapp.phone_number_id). Genuinely
+    // user-declared — a WABA holds many numbers; the owner picks which one
+    // the agent serves. Required client-side: the write path defers it to
+    // the install probe, where an empty value can only fail.
+    const [phoneNumberId, setPhoneNumberId] = useState(() => channel?.spec?.providerConfig?.case === "whatsapp"
+        ? channel.spec.providerConfig.value.phoneNumberId
+        : "");
+    // Tool credentials bound at connect time (create mode only — a retry
+    // keeps the channel's existing bindings untouched; edits go through
+    // the channel card's credentials dialog).
+    const [environmentRefs, setEnvironmentRefs] = useState([]);
+    // The serving app — required (DD-WA-2: no platform Meta app exists).
+    // Editable in retry mode too: app_ref is server-mutable while the
+    // channel isn't installed, and a wrong app is a likely failure cause.
+    const [appRef, setAppRef] = useState(() => channel?.spec?.appRef?.slug
+        ? { org: channel.spec.appRef.org || org, slug: channel.spec.appRef.slug }
+        : null);
+    const [installed, setInstalled] = useState(null);
+    const [error, setError] = useState(null);
+    // The org's channel apps, fetched once here so the serving-app picker
+    // and the advisory read one consistent list.
+    const { channelApps } = useChannelAppList(org || null);
+    const whatsappApps = useMemo(() => channelApps.filter((app) => app.spec?.providerConfig?.case === "whatsapp"), [channelApps]);
+    // A sole registered app is the only possible choice — preselect it so
+    // the required picker never blocks on a decision with one answer
+    // (Hick's law). Derived, not effect-synced: apps load async.
+    const effectiveAppRef = appRef ??
+        (whatsappApps.length === 1
+            ? { org, slug: whatsappApps[0].metadata?.slug ?? "" }
+            : null);
+    const selectedApp = effectiveAppRef
+        ? whatsappApps.find((app) => app.metadata?.slug === effectiveAppRef.slug) ?? null
+        : null;
+    // Numbers the selected serving app already serves, matched on the same
+    // key the database enforces uniqueness on: (phone number, channel app).
+    // Advisory only — the list is permission-bounded; the install stays
+    // the arbiter.
+    const advisoryActive = deploymentMode === "cloud" && !installed;
+    const { channels: orgChannels } = useOrgAgentChannelList(advisoryActive && org ? org : null);
+    const trimmedNumber = phoneNumberId.trim();
+    const alreadyServed = useMemo(() => {
+        const selectedAppId = selectedApp?.metadata?.id;
+        if (!selectedAppId || !trimmedNumber)
+            return [];
+        return orgChannels.filter((c) => c.metadata?.id !== channel?.metadata?.id &&
+            c.status?.installState === AgentChannelInstallState.installed &&
+            c.status?.providerStatus?.case === "whatsapp" &&
+            c.status.providerStatus.value.phoneNumberId === trimmedNumber &&
+            c.status.providerStatus.value.channelAppId === selectedAppId);
+    }, [orgChannels, selectedApp, trimmedNumber, channel]);
+    // One click drives the whole journey: (create/update →) direct
+    // install → fetch the installed facts. No popup, so nothing here needs
+    // the synchronous-gesture treatment the Slack flow does.
+    const handleConnect = useCallback(async () => {
+        setError(null);
+        try {
+            let target = channel;
+            if (!target) {
+                target = await createChannel({
+                    name: name.trim() || `${agentName} WhatsApp`,
+                    org,
+                    agentRef: {
+                        org,
+                        slug: agent.metadata?.slug ?? "",
+                    },
+                    enabled: true,
+                    whatsapp: { phoneNumberId: trimmedNumber },
+                    ...(effectiveAppRef ? { appRef: effectiveAppRef } : {}),
+                    ...(environmentRefs.length > 0 ? { environmentRefs } : {}),
+                });
+                // The channel now exists even if the install below fails —
+                // surface it in the list either way.
+                onChannelsChanged?.();
+            }
+            else {
+                // Retry mode: persist edits to the number or app before
+                // re-installing. Skipped when nothing changed so a plain retry
+                // is one call, not two.
+                const existingNumber = target.spec?.providerConfig?.case === "whatsapp"
+                    ? target.spec.providerConfig.value.phoneNumberId
+                    : "";
+                const existingAppSlug = target.spec?.appRef?.slug ?? "";
+                if (existingNumber !== trimmedNumber ||
+                    existingAppSlug !== (effectiveAppRef?.slug ?? "")) {
+                    target = await save({
+                        ...agentChannelToInput(target),
+                        whatsapp: { phoneNumberId: trimmedNumber },
+                        ...(effectiveAppRef ? { appRef: effectiveAppRef } : {}),
+                    });
+                    onChannelsChanged?.();
+                }
+            }
+            await installer.install(target.metadata?.id ?? "");
+            // The install answer carries no channel — read the recorded facts
+            // (display number, verified name) for the success summary.
+            const result = await stigmer.agentChannel.get(target.metadata?.id ?? "");
+            setInstalled(result);
+            onChannelsChanged?.();
+        }
+        catch (err) {
+            setError(installer.error ?? (err instanceof Error ? err : new Error(String(err))));
+        }
+    }, [agent, agentName, channel, createChannel, effectiveAppRef, environmentRefs, installer, name, org, onChannelsChanged, save, stigmer, trimmedNumber]);
+    const busy = isCreating || isSaving || installer.isInProgress;
+    const canConnect = trimmedNumber !== "" && effectiveAppRef !== null && !busy;
+    return (_jsxs("div", { className: "flex flex-col", children: [_jsxs("div", { className: "flex items-start justify-between gap-3 border-b border-border px-5 py-4", children: [_jsxs("div", { className: "flex items-center gap-2.5", children: [_jsx(WhatsAppMarkIcon, { className: "size-5 text-foreground" }), _jsx("h2", { id: "connect-whatsapp-title", className: "text-sm font-semibold text-foreground", children: channel ? "Reconnect to WhatsApp" : "Connect to WhatsApp" })] }), _jsx("button", { type: "button", onClick: onClose, "aria-label": "Close dialog", className: cn("rounded p-1 text-muted-foreground", "hover:bg-accent-hover hover:text-foreground", "focus:outline-none focus:ring-1 focus:ring-ring"), children: _jsx(CloseIcon, {}) })] }), _jsx("div", { className: "space-y-4 px-5 py-4", children: deploymentMode === "local" ? (
+                // Preempt the doomed flow: the OSS backend answers every
+                // install with FAILED_PRECONDITION.
+                _jsx(CloudFeatureNotice, { children: "Channel installs require Stigmer Cloud. The local backend manages channel configuration, but connecting to WhatsApp verifies your number through Stigmer's hosted webhook infrastructure." })) : installed ? (_jsx(InstalledSummary, { channel: installed, agentName: agentName })) : busy ? (_jsx(InstallingIndicator, {})) : (_jsxs(_Fragment, { children: [!channel && (_jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1.5 block text-xs font-medium text-foreground", children: "Channel name" }), _jsx("input", { type: "text", value: name, onChange: (e) => setName(e.target.value), disabled: busy, className: cn("w-full rounded-md border border-input bg-background px-3 py-1.5", "text-sm text-foreground placeholder:text-muted-foreground", "focus:outline-none focus:ring-1 focus:ring-ring") }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Names the connection in Stigmer \u2014 pick something that identifies the number if you connect more than one." })] })), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1.5 block text-xs font-medium text-foreground", children: "Phone number ID" }), _jsx("input", { type: "text", value: phoneNumberId, onChange: (e) => setPhoneNumberId(e.target.value), disabled: busy, required: true, placeholder: "106540352242922", "data-cursor-target": "dialog-whatsapp-number", className: cn("w-full rounded-md border border-input bg-background px-3 py-1.5", "font-mono text-sm text-foreground placeholder:text-muted-foreground", "focus:outline-none focus:ring-1 focus:ring-ring") }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "From Meta's WhatsApp Manager (API Setup) \u2014 the numeric ID of the number this agent should answer, not the phone number itself." })] }), _jsx(ServingAppSection, { org: org, apps: whatsappApps, value: effectiveAppRef, onChange: setAppRef, disabled: busy, channelAppsHref: channelAppsHref, idPrefix: "stgm-whatsapp-app", appHint: "Your Meta app \u2014 its credentials verify and serve the number", emptyBody: _jsxs("p", { className: "text-xs text-muted-foreground", children: ["WhatsApp channels connect through your own Meta app \u2014 there is no shared platform app.", " ", _jsx(RegisterChannelAppAffordance, { channelAppsHref: channelAppsHref, children: "Register a channel app" }), " ", "with your Meta app's credentials first, then connect here."] }) }), alreadyServed.length > 0 && (_jsx(AlreadyServedNote, { channels: alreadyServed })), !channel && (_jsx(ToolCredentialsSection, { agent: agent, org: org, value: environmentRefs, onChange: setEnvironmentRefs, disabled: busy })), _jsx("p", { className: "text-sm text-muted-foreground", children: "When you continue, Stigmer verifies the number with WhatsApp through the selected app's credentials \u2014 the connection completes right here, with no browser hand-off." }), _jsxs("p", { className: "text-sm text-muted-foreground", children: ["People reach the agent by sending a WhatsApp message to the connected number \u2014 it answers as", " ", _jsx("span", { className: "font-medium text-foreground", children: agentName }), "."] }), _jsxs("p", { className: "text-xs text-muted-foreground", children: ["Conversations from WhatsApp are billed to", " ", _jsx("span", { className: "font-medium", children: org }), ". Each number serves one agent per channel app."] }), error && (_jsx(InstallRefusal, { error: error, channelAppsHref: channelAppsHref }))] })) }), _jsx("div", { className: "flex justify-end gap-2 border-t border-border px-5 py-3", children: installed || deploymentMode === "local" ? (_jsx(Button, { variant: "outline", size: "sm", onClick: onClose, children: installed ? "Done" : "Close" })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: onClose, disabled: busy, children: "Cancel" }), _jsx(Button, { variant: "primary", size: "sm", onClick: () => void handleConnect(), disabled: !canConnect, icon: _jsx(WhatsAppMarkIcon, { className: "size-3.5" }), "data-cursor-target": "dialog-connect-whatsapp", children: error ? "Try again" : channel ? "Reconnect to WhatsApp" : "Connect to WhatsApp" })] })) })] }));
+}
+// ---------------------------------------------------------------------------
+// Install refusal — guided for the duplicate-number reason
+// ---------------------------------------------------------------------------
+/**
+ * The reason code the server attaches (google.rpc.ErrorInfo, domain
+ * stigmer.ai) to a duplicate-number initiateInstall refusal — see the
+ * initiateInstall rpc comment for the vocabulary.
+ */
+const REASON_NUMBER_ALREADY_CONNECTED = "WHATSAPP_NUMBER_ALREADY_CONNECTED";
+/**
+ * Install-refusal rendering. The duplicate-number refusal is the one a
+ * user can act on from here, so it gets a guided treatment — names the
+ * occupied number (from the ErrorInfo metadata) and the ways out. Every
+ * other refusal (bad token, unknown number, dangling app — and any error
+ * from a server not attaching reasons) renders the server's copy
+ * verbatim — the server owns that vocabulary.
+ */
+function InstallRefusal({ error, channelAppsHref, }) {
+    const reason = getErrorReason(error);
+    if (reason?.reason !== REASON_NUMBER_ALREADY_CONNECTED) {
+        return _jsx(VerbatimRefusal, { error: error });
+    }
+    const number = reason.metadata.display_phone_number || "This number";
+    return (_jsxs(RefusalBox, { children: [_jsxs("p", { children: [_jsx("span", { className: "font-medium", children: number }), " is already connected to an agent through this channel app \u2014 each number serves one agent."] }), _jsxs("p", { children: ["To reach it with this agent, disconnect the existing channel, use a different number, or", " ", _jsx(RegisterChannelAppAffordance, { channelAppsHref: channelAppsHref, children: "register a channel app" }), " ", "and connect through that instead."] })] }));
+}
+/**
+ * Pre-install advisory: the selected serving app already serves this
+ * number, matched on the exact key the database enforces — (phone
+ * number, serving app). Shown before the user spends the install
+ * round-trip discovering it. Best-effort by design: the list is bounded
+ * by the caller's visibility, so the copy warns rather than forbids.
+ */
+function AlreadyServedNote({ channels, }) {
+    return (_jsx("div", { role: "status", className: "space-y-0.5 text-xs text-warning", children: channels.map((c) => {
+            const whatsapp = c.status?.providerStatus?.case === "whatsapp"
+                ? c.status.providerStatus.value
+                : null;
+            const number = whatsapp?.displayPhoneNumber || whatsapp?.phoneNumberId || "this number";
+            const agent = c.spec?.agentRef?.slug || "another agent";
+            return (_jsxs("p", { children: [_jsx("span", { className: "font-medium", children: number }), " is already served via ", agent, " \u2014 each number serves one agent per channel app, so disconnect that channel or pick a different number."] }, c.metadata?.id ?? number));
+        }) }));
+}
+// ---------------------------------------------------------------------------
+// Installing indicator — a single live step, deliberately not a ladder
+// ---------------------------------------------------------------------------
+/**
+ * The busy state of a direct install: one server call, so one live line —
+ * not the Slack dialog's three-step OAuth ladder, which would render two
+ * permanently-empty rungs here. No cancel affordance either: there is no
+ * popup to abandon, and the call settles in seconds.
+ */
+function InstallingIndicator() {
+    return (_jsxs("div", { className: "flex items-center gap-2 text-sm text-foreground", "aria-live": "polite", children: [_jsx(Spinner, { className: "size-3.5 shrink-0" }), "Verifying the number with WhatsApp\u2026"] }));
+}
+// ---------------------------------------------------------------------------
+// Installed summary — the success state with the observed WhatsApp facts
+// ---------------------------------------------------------------------------
+function InstalledSummary({ channel, agentName, }) {
+    const whatsapp = channel.status?.providerStatus?.case === "whatsapp"
+        ? channel.status.providerStatus.value
+        : null;
+    const number = whatsapp?.displayPhoneNumber || whatsapp?.phoneNumberId || null;
+    return (_jsxs("div", { className: "space-y-2", role: "status", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-medium text-foreground", children: [_jsx(CheckIcon, { className: "size-4 text-success" }), "Connected", number ? ` to ${number}` : "", whatsapp?.verifiedName ? ` (${whatsapp.verifiedName})` : ""] }), _jsxs("p", { className: "text-sm text-muted-foreground", children: ["Send a WhatsApp message to", " ", _jsx("span", { className: "font-medium text-foreground", children: number ?? "the connected number" }), " ", "and ask your question \u2014 answers come from", " ", _jsx("span", { className: "font-medium text-foreground", children: agentName }), "."] })] }));
+}
+//# sourceMappingURL=ConnectWhatsAppDialog.js.map