@stigmer/react 3.1.17 → 3.2.0

package/channel/useChannelToolReadiness.d.ts

@@ -0,0 +1,23 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { ResourceRef } from "@stigmer/sdk";
+import { type ToolCredentialsReadiness } from "../environment/useToolCredentialsReadiness.js";
+/**
+ * Channel-scoped wrapper over {@link useToolCredentialsReadiness}:
+ * checks whether a tool-using agent's credentials will work over a
+ * channel — i.e. whether the channel binds environments
+ * (`AgentChannelSpec.environment_refs`) and each one is shared with the
+ * organization.
+ *
+ * Channel executions receive credentials exclusively from the
+ * channel's own bindings, resolved through the org-shared environment
+ * seam — exactly the share contract, without the audience arm (channels
+ * have no audience concept). So a tool-using agent on a channel with no
+ * bindings is guaranteed to refuse every workspace message that needs a
+ * tool.
+ *
+ * The check runs only when serving is enabled (a paused channel serves
+ * no traffic), the deployment is cloud (the channel runtime is
+ * cloud-only), and the agent declares MCP server usages.
+ */
+export declare function useChannelToolReadiness(agent: Agent, enabled: boolean, environmentRefs: readonly ResourceRef[]): ToolCredentialsReadiness;
+//# sourceMappingURL=useChannelToolReadiness.d.ts.map

package/channel/useChannelToolReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChannelToolReadiness.d.ts","sourceRoot":"","sources":["../../src/channel/useChannelToolReadiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+CAA+C,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,SAAS,WAAW,EAAE,GACtC,wBAAwB,CAM1B"}

package/channel/useChannelToolReadiness.js

@@ -0,0 +1,28 @@
+"use client";
+import { useDeploymentMode } from "../deployment-mode.js";
+import { useToolCredentialsReadiness, } from "../environment/useToolCredentialsReadiness.js";
+/**
+ * Channel-scoped wrapper over {@link useToolCredentialsReadiness}:
+ * checks whether a tool-using agent's credentials will work over a
+ * channel — i.e. whether the channel binds environments
+ * (`AgentChannelSpec.environment_refs`) and each one is shared with the
+ * organization.
+ *
+ * Channel executions receive credentials exclusively from the
+ * channel's own bindings, resolved through the org-shared environment
+ * seam — exactly the share contract, without the audience arm (channels
+ * have no audience concept). So a tool-using agent on a channel with no
+ * bindings is guaranteed to refuse every workspace message that needs a
+ * tool.
+ *
+ * The check runs only when serving is enabled (a paused channel serves
+ * no traffic), the deployment is cloud (the channel runtime is
+ * cloud-only), and the agent declares MCP server usages.
+ */
+export function useChannelToolReadiness(agent, enabled, environmentRefs) {
+    const deploymentMode = useDeploymentMode();
+    const hasMcpTools = (agent.spec?.mcpServerUsages?.length ?? 0) > 0;
+    const applicable = enabled && deploymentMode === "cloud" && hasMcpTools;
+    return useToolCredentialsReadiness(applicable, environmentRefs);
+}
+//# sourceMappingURL=useChannelToolReadiness.js.map

package/channel/useChannelToolReadiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChannelToolReadiness.js","sourceRoot":"","sources":["../../src/channel/useChannelToolReadiness.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,2BAA2B,GAE5B,MAAM,+CAA+C,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAY,EACZ,OAAgB,EAChB,eAAuC;IAEvC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,IAAI,cAAc,KAAK,OAAO,IAAI,WAAW,CAAC;IAExE,OAAO,2BAA2B,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAClE,CAAC"}

package/channel/useConnectSlackChannel.d.ts

@@ -0,0 +1,75 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/**
+ * Progress phases of the Slack channel install flow.
+ *
+ * Mirrors the MCP OAuth phases minus `connecting` — a channel install has
+ * no tool-discovery step; `completeInstall` returns the installed channel
+ * directly.
+ */
+export type SlackConnectPhase = "idle" | "initiating" | "awaiting-callback" | "completing" | "done";
+/** Return value of {@link useConnectSlackChannel}. */
+export interface UseConnectSlackChannelReturn {
+    /**
+     * Run the Slack install flow for a channel.
+     *
+     * Opens a popup for Slack's "Add to Slack" consent screen, waits for
+     * the OAuth callback, then exchanges the authorization code via
+     * `completeInstall`. Works for first installs and re-installs after
+     * revocation alike (the server transitions `revoked → installed`).
+     *
+     * **Must be called from a synchronous user-gesture handler** (e.g. an
+     * `onClick` callback) so the browser allows the popup. The popup is
+     * opened synchronously before any async work to avoid popup blockers.
+     *
+     * Failure modes surface as `error` with server-authored copy:
+     * a deployment without Slack app credentials or an OSS backend refuses
+     * at `initiating` (FAILED_PRECONDITION); duplicate-workspace and
+     * Enterprise Grid installs refuse at `completing`.
+     *
+     * @param channelId - System-generated ID (metadata.id) of the channel.
+     * @returns The installed AgentChannel (status carries the Slack facts).
+     */
+    readonly connect: (channelId: string) => Promise<AgentChannel>;
+    /** `true` while any phase of the install flow is in progress. */
+    readonly isInProgress: boolean;
+    /** Current phase of the install flow. */
+    readonly phase: SlackConnectPhase;
+    /** Error from the most recent unsuccessful attempt, or `null`. */
+    readonly error: Error | null;
+    /** Reset the hook to idle state, cancelling any in-flight flow. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that orchestrates the Slack channel install flow.
+ *
+ * Handles the complete lifecycle:
+ * 1. Calls `initiateInstall` to get Slack's authorization URL + state
+ * 2. Opens a popup window to the "Add to Slack" consent screen
+ * 3. Waits for the callback (`postMessage` + BroadcastChannel, via the
+ *    shared `internal/oauthPopup.ts` machinery)
+ * 4. Calls `completeInstall` to exchange the code — the server stores the
+ *    bot token and records the install facts on `status.slack`
+ *
+ * The callback page is the same `OAuthCallbackHandler` component used by
+ * MCP OAuth, hosted on the console's Slack redirect route.
+ *
+ * @example
+ * ```tsx
+ * const slack = useConnectSlackChannel();
+ *
+ * async function handleConnect() {
+ *   try {
+ *     const installed = await slack.connect(channel.metadata.id);
+ *     refetch();
+ *   } catch {
+ *     // error is available via slack.error
+ *   }
+ * }
+ *
+ * <button onClick={handleConnect} disabled={slack.isInProgress}>
+ *   {slack.isInProgress ? "Connecting..." : "Connect to Slack"}
+ * </button>
+ * ```
+ */
+export declare function useConnectSlackChannel(): UseConnectSlackChannelReturn;
+//# sourceMappingURL=useConnectSlackChannel.d.ts.map

package/channel/useConnectSlackChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectSlackChannel.d.ts","sourceRoot":"","sources":["../../src/channel/useConnectSlackChannel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAc9F;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,YAAY,GACZ,mBAAmB,GACnB,YAAY,GACZ,MAAM,CAAC;AAEX,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAiGrE"}

package/channel/useConnectSlackChannel.js

@@ -0,0 +1,115 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { InitiateChannelInstallInputSchema, CompleteChannelInstallInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+import { openOAuthPopup, popupBlockedError, waitForOAuthCallback, closeOAuthPopup, } from "../internal/oauthPopup.js";
+/**
+ * Behavior hook that orchestrates the Slack channel install flow.
+ *
+ * Handles the complete lifecycle:
+ * 1. Calls `initiateInstall` to get Slack's authorization URL + state
+ * 2. Opens a popup window to the "Add to Slack" consent screen
+ * 3. Waits for the callback (`postMessage` + BroadcastChannel, via the
+ *    shared `internal/oauthPopup.ts` machinery)
+ * 4. Calls `completeInstall` to exchange the code — the server stores the
+ *    bot token and records the install facts on `status.slack`
+ *
+ * The callback page is the same `OAuthCallbackHandler` component used by
+ * MCP OAuth, hosted on the console's Slack redirect route.
+ *
+ * @example
+ * ```tsx
+ * const slack = useConnectSlackChannel();
+ *
+ * async function handleConnect() {
+ *   try {
+ *     const installed = await slack.connect(channel.metadata.id);
+ *     refetch();
+ *   } catch {
+ *     // error is available via slack.error
+ *   }
+ * }
+ *
+ * <button onClick={handleConnect} disabled={slack.isInProgress}>
+ *   {slack.isInProgress ? "Connecting..." : "Connect to Slack"}
+ * </button>
+ * ```
+ */
+export function useConnectSlackChannel() {
+    const stigmer = useStigmer();
+    const [phase, setPhase] = useState("idle");
+    const [error, setError] = useState(null);
+    const popupRef = useRef(null);
+    const cleanupRef = useRef(null);
+    const cancelledRef = useRef(false);
+    useEffect(() => {
+        return () => {
+            cleanupRef.current?.();
+        };
+    }, []);
+    const clearError = useCallback(() => {
+        if (cleanupRef.current || popupRef.current) {
+            cancelledRef.current = true;
+            cleanupRef.current?.();
+            closeOAuthPopup(popupRef.current);
+            popupRef.current = null;
+            cleanupRef.current = null;
+        }
+        setPhase("idle");
+        setError(null);
+    }, []);
+    const connect = useCallback(async (channelId) => {
+        setPhase("initiating");
+        setError(null);
+        cancelledRef.current = false;
+        cleanupRef.current?.();
+        const popup = openOAuthPopup();
+        if (!popup) {
+            const blocked = popupBlockedError();
+            setError(blocked);
+            setPhase("idle");
+            throw blocked;
+        }
+        popupRef.current = popup;
+        try {
+            const initOutput = await stigmer.agentChannel.initiateInstall(create(InitiateChannelInstallInputSchema, { resourceId: channelId }));
+            popup.location.href = initOutput.authorizationUrl;
+            setPhase("awaiting-callback");
+            const { code, state } = await waitForOAuthCallback(popup, initOutput.state, (dispose) => {
+                cleanupRef.current = dispose;
+            });
+            setPhase("completing");
+            const channel = await stigmer.agentChannel.completeInstall(create(CompleteChannelInstallInputSchema, {
+                resourceId: channelId,
+                state,
+                code,
+            }));
+            setPhase("done");
+            return channel;
+        }
+        catch (err) {
+            const wrapped = toError(err);
+            if (!cancelledRef.current) {
+                setError(wrapped);
+                setPhase("idle");
+                closeOAuthPopup(popup);
+            }
+            cancelledRef.current = false;
+            throw wrapped;
+        }
+        finally {
+            popupRef.current = null;
+            cleanupRef.current = null;
+        }
+    }, [stigmer]);
+    return {
+        connect,
+        isInProgress: phase !== "idle" && phase !== "done",
+        phase,
+        error,
+        clearError,
+    };
+}
+//# sourceMappingURL=useConnectSlackChannel.js.map

package/channel/useConnectSlackChannel.js.map

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

package/channel/useCreateAgentChannel.d.ts

@@ -0,0 +1,42 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+import type { AgentChannelInput } from "@stigmer/sdk";
+/** Return value of {@link useCreateAgentChannel}. */
+export interface UseCreateAgentChannelReturn {
+    /**
+     * Create a new agent channel (strict create: an existing org + slug
+     * fails with ALREADY_EXISTS rather than silently updating it — the
+     * reason this is not `apply`). Returns the created resource in
+     * `pending_install` state; run the provider install flow next.
+     */
+    readonly createChannel: (input: AgentChannelInput) => Promise<AgentChannel>;
+    /** `true` while the create request is in flight. */
+    readonly isPending: boolean;
+    /** Error from the last failed create, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Mutation hook that creates an {@link AgentChannel}.
+ *
+ * Wraps `stigmer.agentChannel.create()` with loading/error state. An
+ * agent can carry several channels (e.g. two Slack workspaces), so a new
+ * channel must never overwrite a sibling whose derived slug collides —
+ * strict-create semantics make that mistake loud instead of silent.
+ * Updates and toggles go through `useSaveAgentChannel` (apply).
+ *
+ * @example
+ * ```tsx
+ * const { createChannel, isPending } = useCreateAgentChannel();
+ *
+ * const channel = await createChannel({
+ *   name: "Support Slack",
+ *   org: agent.metadata.org,
+ *   agentRef: { org: agent.metadata.org, slug: agent.metadata.slug },
+ *   enabled: true,
+ *   slack: {},
+ * });
+ * ```
+ */
+export declare function useCreateAgentChannel(): UseCreateAgentChannelReturn;
+//# sourceMappingURL=useCreateAgentChannel.d.ts.map

package/channel/useCreateAgentChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateAgentChannel.d.ts","sourceRoot":"","sources":["../../src/channel/useCreateAgentChannel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,IAAI,2BAA2B,CAyBnE"}

package/channel/useCreateAgentChannel.js

@@ -0,0 +1,48 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Mutation hook that creates an {@link AgentChannel}.
+ *
+ * Wraps `stigmer.agentChannel.create()` with loading/error state. An
+ * agent can carry several channels (e.g. two Slack workspaces), so a new
+ * channel must never overwrite a sibling whose derived slug collides —
+ * strict-create semantics make that mistake loud instead of silent.
+ * Updates and toggles go through `useSaveAgentChannel` (apply).
+ *
+ * @example
+ * ```tsx
+ * const { createChannel, isPending } = useCreateAgentChannel();
+ *
+ * const channel = await createChannel({
+ *   name: "Support Slack",
+ *   org: agent.metadata.org,
+ *   agentRef: { org: agent.metadata.org, slug: agent.metadata.slug },
+ *   enabled: true,
+ *   slack: {},
+ * });
+ * ```
+ */
+export function useCreateAgentChannel() {
+    const stigmer = useStigmer();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const createChannel = useCallback(async (input) => {
+        setIsPending(true);
+        setError(null);
+        try {
+            return await stigmer.agentChannel.create(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [stigmer]);
+    return { createChannel, isPending, error, clearError };
+}
+//# sourceMappingURL=useCreateAgentChannel.js.map

package/channel/useCreateAgentChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateAgentChannel.js","sourceRoot":"","sources":["../../src/channel/useCreateAgentChannel.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAmBjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EAAE,KAAwB,EAAyB,EAAE;QACxD,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC"}

package/channel/useDeleteAgentChannel.d.ts

@@ -0,0 +1,40 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/** Return value of {@link useDeleteAgentChannel}. */
+export interface UseDeleteAgentChannelReturn {
+    /**
+     * Delete an agent channel by ID. Returns the deleted resource.
+     *
+     * Deleting a channel is full teardown: the provider connection stops
+     * serving immediately and the stored install (including its
+     * credentials) is removed. To stop serving while keeping the install,
+     * save the channel with `enabled: false` instead (a config-preserving
+     * pause via `useSaveAgentChannel`).
+     */
+    readonly deleteChannel: (id: string) => Promise<AgentChannel>;
+    /** `true` while the delete request is in flight. */
+    readonly isDeleting: boolean;
+    /** Error from the last failed delete, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Mutation hook that deletes an {@link AgentChannel} resource.
+ *
+ * Wraps `stigmer.agentChannel.delete()` with loading/error state. The
+ * caller is responsible for post-delete UI updates (e.g. refreshing the
+ * channel list) and for confirming the destructive action — the
+ * delete-vs-pause distinction belongs in the confirmation copy.
+ *
+ * @example
+ * ```tsx
+ * const { deleteChannel, isDeleting } = useDeleteAgentChannel();
+ *
+ * const handleDelete = async () => {
+ *   await deleteChannel(channel.metadata.id);
+ *   refetch(); // refresh the channel list
+ * };
+ * ```
+ */
+export declare function useDeleteAgentChannel(): UseDeleteAgentChannelReturn;
+//# sourceMappingURL=useDeleteAgentChannel.d.ts.map

package/channel/useDeleteAgentChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteAgentChannel.d.ts","sourceRoot":"","sources":["../../src/channel/useDeleteAgentChannel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAI9F,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9D,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,IAAI,2BAA2B,CAyBnE"}

package/channel/useDeleteAgentChannel.js

@@ -0,0 +1,44 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Mutation hook that deletes an {@link AgentChannel} resource.
+ *
+ * Wraps `stigmer.agentChannel.delete()` with loading/error state. The
+ * caller is responsible for post-delete UI updates (e.g. refreshing the
+ * channel list) and for confirming the destructive action — the
+ * delete-vs-pause distinction belongs in the confirmation copy.
+ *
+ * @example
+ * ```tsx
+ * const { deleteChannel, isDeleting } = useDeleteAgentChannel();
+ *
+ * const handleDelete = async () => {
+ *   await deleteChannel(channel.metadata.id);
+ *   refetch(); // refresh the channel list
+ * };
+ * ```
+ */
+export function useDeleteAgentChannel() {
+    const stigmer = useStigmer();
+    const [isDeleting, setIsDeleting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const deleteChannel = useCallback(async (id) => {
+        setIsDeleting(true);
+        setError(null);
+        try {
+            return await stigmer.agentChannel.delete(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsDeleting(false);
+        }
+    }, [stigmer]);
+    return { deleteChannel, isDeleting, error, clearError };
+}
+//# sourceMappingURL=useDeleteAgentChannel.js.map

package/channel/useDeleteAgentChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteAgentChannel.js","sourceRoot":"","sources":["../../src/channel/useDeleteAgentChannel.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAsBjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EAAE,EAAU,EAAyB,EAAE;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC"}

package/channel/useInstallChannel.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Progress phases of a direct channel install.
+ *
+ * One live phase only — a direct install has no consent redirect and no
+ * code exchange; the whole flow is the single `initiateInstall` call.
+ */
+export type InstallChannelPhase = "idle" | "installing" | "done";
+/** Return value of {@link useInstallChannel}. */
+export interface UseInstallChannelReturn {
+    /**
+     * Run the direct install flow for a channel.
+     *
+     * One `initiateInstall` call does everything: the server validates the
+     * declared provider identity against the provider's API, persists the
+     * install facts on status, and answers `completed=true` (DD-WA-1).
+     * Works for first installs and retries of a pending channel alike.
+     *
+     * The server's `completed` field is the authoritative outcome
+     * (DD-WA-1b): `false` means this channel's provider actually wants the
+     * redirect flow — surfaced as an error rather than silently ignored,
+     * because this hook cannot run a consent redirect.
+     *
+     * Failure modes surface as `error` with server-authored copy: bad or
+     * expired app credentials, an unrecognized provider identity, a
+     * dangling app reference, or a duplicate install (carrying a
+     * `google.rpc.ErrorInfo` reason readable via `getErrorReason`).
+     *
+     * @param channelId - System-generated ID (metadata.id) of the channel.
+     */
+    readonly install: (channelId: string) => Promise<void>;
+    /** `true` while the install call is in flight. */
+    readonly isInProgress: boolean;
+    /** Current phase of the install flow. */
+    readonly phase: InstallChannelPhase;
+    /** Error from the most recent unsuccessful attempt, or `null`. */
+    readonly error: Error | null;
+    /** Reset the hook to idle state. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that runs a direct (non-redirect) channel install —
+ * WhatsApp today ({@link useConnectSlackChannel} is the redirect
+ * counterpart). No popup, no callback route, no `completeInstall`.
+ *
+ * `initiateInstall` does not return the channel — callers refetch their
+ * channel (list) afterwards to observe the `installed` state, exactly
+ * like every other mutation-then-refetch flow in this package.
+ *
+ * @example
+ * ```tsx
+ * const installer = useInstallChannel();
+ *
+ * async function handleConnect() {
+ *   await installer.install(channel.metadata.id);
+ *   refetch();
+ * }
+ * ```
+ */
+export declare function useInstallChannel(): UseInstallChannelReturn;
+//# sourceMappingURL=useInstallChannel.d.ts.map

package/channel/useInstallChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInstallChannel.d.ts","sourceRoot":"","sources":["../../src/channel/useInstallChannel.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjE,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAgD3D"}

package/channel/useInstallChannel.js

@@ -0,0 +1,63 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { InitiateChannelInstallInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that runs a direct (non-redirect) channel install —
+ * WhatsApp today ({@link useConnectSlackChannel} is the redirect
+ * counterpart). No popup, no callback route, no `completeInstall`.
+ *
+ * `initiateInstall` does not return the channel — callers refetch their
+ * channel (list) afterwards to observe the `installed` state, exactly
+ * like every other mutation-then-refetch flow in this package.
+ *
+ * @example
+ * ```tsx
+ * const installer = useInstallChannel();
+ *
+ * async function handleConnect() {
+ *   await installer.install(channel.metadata.id);
+ *   refetch();
+ * }
+ * ```
+ */
+export function useInstallChannel() {
+    const stigmer = useStigmer();
+    const [phase, setPhase] = useState("idle");
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => {
+        setPhase("idle");
+        setError(null);
+    }, []);
+    const install = useCallback(async (channelId) => {
+        setPhase("installing");
+        setError(null);
+        try {
+            const output = await stigmer.agentChannel.initiateInstall(create(InitiateChannelInstallInputSchema, { resourceId: channelId }));
+            if (!output.completed) {
+                // The server says this provider installs via consent redirect —
+                // a wiring error (the caller routed a redirect-style provider
+                // to the direct hook), not a user-fixable condition.
+                throw new Error("This channel's provider requires an interactive install — " +
+                    "connect it through its provider flow instead.");
+            }
+            setPhase("done");
+        }
+        catch (err) {
+            const wrapped = toError(err);
+            setError(wrapped);
+            setPhase("idle");
+            throw wrapped;
+        }
+    }, [stigmer]);
+    return {
+        install,
+        isInProgress: phase === "installing",
+        phase,
+        error,
+        clearError,
+    };
+}
+//# sourceMappingURL=useInstallChannel.js.map

package/channel/useInstallChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInstallChannel.js","sourceRoot":"","sources":["../../src/channel/useInstallChannel.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,0DAA0D,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AA2CjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAsB,MAAM,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,SAAiB,EAAiB,EAAE;QACzC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,eAAe,CACvD,MAAM,CAAC,iCAAiC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CACrE,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,gEAAgE;gBAChE,8DAA8D;gBAC9D,qDAAqD;gBACrD,MAAM,IAAI,KAAK,CACb,4DAA4D;oBAC1D,+CAA+C,CAClD,CAAC;YACJ,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjB,MAAM,OAAO,CAAC;QAChB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO;QACL,OAAO;QACP,YAAY,EAAE,KAAK,KAAK,YAAY;QACpC,KAAK;QACL,KAAK;QACL,UAAU;KACX,CAAC;AACJ,CAAC"}

package/channel/useOrgAgentChannelList.d.ts

@@ -0,0 +1,32 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/** Return value of {@link useOrgAgentChannelList}. */
+export interface UseOrgAgentChannelListReturn {
+    /**
+     * The organization's channels visible to the caller, across all its
+     * agents, in server order. Empty while loading, on error, or when the
+     * org has none.
+     */
+    readonly channels: readonly AgentChannel[];
+    /** `true` while the initial fetch is in flight and no data is shown. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Re-fetch the channels from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that loads an organization's {@link AgentChannel} resources
+ * across all its agents — the org-wide view {@link useAgentChannelList}
+ * (per-agent) cannot provide.
+ *
+ * The connect flow uses it to tell the user which workspaces a serving
+ * app already occupies before they start the provider OAuth. The view is
+ * permission-bounded (FGA-filtered in cloud), so treat it as advisory —
+ * the database uniqueness index remains the arbiter.
+ *
+ * Pass `null` for `org` to skip fetching (stable no-op).
+ */
+export declare function useOrgAgentChannelList(org: string | null): UseOrgAgentChannelListReturn;
+//# sourceMappingURL=useOrgAgentChannelList.d.ts.map

package/channel/useOrgAgentChannelList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOrgAgentChannelList.d.ts","sourceRoot":"","sources":["../../src/channel/useOrgAgentChannelList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAK9F,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,4BAA4B,CAmB9B"}