@stigmer/react 3.1.16 → 3.2.0

package/channel/providers.d.ts

@@ -0,0 +1,62 @@
+import type { ComponentType } from "react";
+/**
+ * Identifier of a channel provider — matches the `provider_config` oneof
+ * case name on `AgentChannelSpec` / `ChannelAppSpec`, which is the wire
+ * discriminator every channel surface already switches on.
+ */
+export type ChannelProviderId = "slack" | "whatsapp";
+/**
+ * How a provider's install flow runs — the client-side hint for whether
+ * connecting needs a browser popup.
+ *
+ * - `redirect`: an OAuth consent redirect (Slack). The client opens a
+ *   popup synchronously inside the user gesture — before `initiateInstall`
+ *   answers — because browsers only allow `window.open` from a gesture
+ *   call stack.
+ * - `direct`: `initiateInstall` runs the whole install server-side and
+ *   answers `completed=true` (WhatsApp, DD-WA-1). No popup, no callback
+ *   route; the client refetches the channel.
+ *
+ * The server's `InitiateChannelInstallOutput.completed` field stays the
+ * authoritative outcome (DD-WA-1b) — this hint only decides whether to
+ * pre-open a popup at all.
+ */
+export type ChannelInstallStyle = "redirect" | "direct";
+/**
+ * Display descriptor for a channel provider.
+ *
+ * The single place a provider's UI identity lives. Adding a provider
+ * means adding a registry entry here (plus its presentation copy in
+ * providerPresentation.tsx); consumers derive labels, icons, and connect
+ * affordances from the registry instead of hardcoding a provider.
+ */
+export interface ChannelProviderDescriptor {
+    readonly id: ChannelProviderId;
+    /** Human-readable provider name ("Slack"). */
+    readonly label: string;
+    /** Brand mark; consumers size it via className. */
+    readonly Icon: ComponentType<{
+        readonly className?: string;
+    }>;
+    /** How this provider's install flow runs. */
+    readonly installStyle: ChannelInstallStyle;
+}
+/**
+ * All channel providers this UI can render, in display order.
+ *
+ * With two providers the connect affordance renders as one visible
+ * "Connect to {label}" button per provider — deliberately NOT a dropdown
+ * menu: two options are clearer side by side (visibility over a hidden
+ * menu), and each button keeps its own stable cursor target for the docs
+ * demos. A third entry is the signal to fold these into a provider menu.
+ */
+export declare const CHANNEL_PROVIDERS: readonly ChannelProviderDescriptor[];
+/**
+ * Resolve a provider descriptor from a `provider_config` oneof case name.
+ *
+ * Returns `null` for unknown cases (e.g. a newer server returning a
+ * provider this UI doesn't know yet) — callers hide or fall back rather
+ * than render a half-known provider.
+ */
+export declare function channelProviderOf(providerCase: string | undefined): ChannelProviderDescriptor | null;
+//# sourceMappingURL=providers.d.ts.map

package/channel/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/channel/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,yBAAyB,EAGjE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,yBAAyB,GAAG,IAAI,CAElC"}

package/channel/providers.js

@@ -0,0 +1,26 @@
+import { SlackMarkIcon } from "./SlackMarkIcon.js";
+import { WhatsAppMarkIcon } from "./WhatsAppMarkIcon.js";
+/**
+ * All channel providers this UI can render, in display order.
+ *
+ * With two providers the connect affordance renders as one visible
+ * "Connect to {label}" button per provider — deliberately NOT a dropdown
+ * menu: two options are clearer side by side (visibility over a hidden
+ * menu), and each button keeps its own stable cursor target for the docs
+ * demos. A third entry is the signal to fold these into a provider menu.
+ */
+export const CHANNEL_PROVIDERS = [
+    { id: "slack", label: "Slack", Icon: SlackMarkIcon, installStyle: "redirect" },
+    { id: "whatsapp", label: "WhatsApp", Icon: WhatsAppMarkIcon, installStyle: "direct" },
+];
+/**
+ * Resolve a provider descriptor from a `provider_config` oneof case name.
+ *
+ * Returns `null` for unknown cases (e.g. a newer server returning a
+ * provider this UI doesn't know yet) — callers hide or fall back rather
+ * than render a half-known provider.
+ */
+export function channelProviderOf(providerCase) {
+    return CHANNEL_PROVIDERS.find((p) => p.id === providerCase) ?? null;
+}
+//# sourceMappingURL=providers.js.map

package/channel/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/channel/providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA6CzD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyC;IACrE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE;IAC9E,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE;CACtF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAgC;IAEhC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,IAAI,IAAI,CAAC;AACtE,CAAC"}

package/channel/useAgentChannel.d.ts

@@ -0,0 +1,31 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/** Return value of {@link useAgentChannel}. */
+export interface UseAgentChannelReturn {
+    /**
+     * The channel, or `null` while loading, on error, or when no channel
+     * with that ID exists (not-found is data, not an error).
+     */
+    readonly channel: AgentChannel | null;
+    /** `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 channel from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that loads a single {@link AgentChannel} by ID.
+ *
+ * Not-found maps to `channel === null` rather than an error, so callers
+ * can render an absent channel (e.g. deleted in another tab) without
+ * error styling. Pass an empty `id` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { channel, isLoading, refetch } = useAgentChannel(channelId);
+ * ```
+ */
+export declare function useAgentChannel(id: string): UseAgentChannelReturn;
+//# sourceMappingURL=useAgentChannel.d.ts.map

package/channel/useAgentChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentChannel.d.ts","sourceRoot":"","sources":["../../src/channel/useAgentChannel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAK9F,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,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,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,CAqBjE"}

package/channel/useAgentChannel.js

@@ -0,0 +1,34 @@
+"use client";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that loads a single {@link AgentChannel} by ID.
+ *
+ * Not-found maps to `channel === null` rather than an error, so callers
+ * can render an absent channel (e.g. deleted in another tab) without
+ * error styling. Pass an empty `id` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { channel, isLoading, refetch } = useAgentChannel(channelId);
+ * ```
+ */
+export function useAgentChannel(id) {
+    const stigmer = useStigmer();
+    const fetchFn = id
+        ? async () => {
+            try {
+                return await stigmer.agentChannel.get(id);
+            }
+            catch (err) {
+                if (isNotFound(err))
+                    return null;
+                throw err;
+            }
+        }
+        : null;
+    const { data: channel, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [id, stigmer], null);
+    return { channel, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useAgentChannel.js.map

package/channel/useAgentChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentChannel.js","sourceRoot":"","sources":["../../src/channel/useAgentChannel.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmBnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,EAAE;QAChB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACzE,OAAO,EACP,CAAC,EAAE,EAAE,OAAO,CAAC,EACb,IAA2B,CAC5B,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/channel/useAgentChannelList.d.ts

@@ -0,0 +1,43 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+/** Return value of {@link useAgentChannelList}. */
+export interface UseAgentChannelListReturn {
+    /**
+     * Every channel of the agent visible to the caller, in server order.
+     * Empty while loading, on error, or when the agent has no channels —
+     * `channels.length === 0 && !isLoading && !error` means "no channels
+     * exist yet".
+     */
+    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 agent's {@link AgentChannel} resources — the
+ * connections that expose the agent on external messaging platforms
+ * (Slack in v1, more providers later).
+ *
+ * A channel serves traffic only when its provider install completed
+ * (`status.installState === installed`) AND the owner's serving switch is
+ * on (`spec.enabled`) — the two axes the Channels tab renders.
+ *
+ * Pass `org` to scope the list to one organization's channels; the server
+ * only ever narrows the permission-bounded view. Pass an empty `agentId`
+ * to skip fetching (stable no-op) — useful while the agent is still
+ * loading.
+ *
+ * @example
+ * ```tsx
+ * const { channels, isLoading, refetch } = useAgentChannelList(
+ *   agent?.metadata?.id ?? "",
+ *   viewerOrg,
+ * );
+ * ```
+ */
+export declare function useAgentChannelList(agentId: string, org?: string): UseAgentChannelListReturn;
+//# sourceMappingURL=useAgentChannelList.d.ts.map

package/channel/useAgentChannelList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentChannelList.d.ts","sourceRoot":"","sources":["../../src/channel/useAgentChannelList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAK9F,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAmB5F"}

package/channel/useAgentChannelList.js

@@ -0,0 +1,39 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetAgentChannelsByAgentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that loads an agent's {@link AgentChannel} resources — the
+ * connections that expose the agent on external messaging platforms
+ * (Slack in v1, more providers later).
+ *
+ * A channel serves traffic only when its provider install completed
+ * (`status.installState === installed`) AND the owner's serving switch is
+ * on (`spec.enabled`) — the two axes the Channels tab renders.
+ *
+ * Pass `org` to scope the list to one organization's channels; the server
+ * only ever narrows the permission-bounded view. Pass an empty `agentId`
+ * to skip fetching (stable no-op) — useful while the agent is still
+ * loading.
+ *
+ * @example
+ * ```tsx
+ * const { channels, isLoading, refetch } = useAgentChannelList(
+ *   agent?.metadata?.id ?? "",
+ *   viewerOrg,
+ * );
+ * ```
+ */
+export function useAgentChannelList(agentId, org) {
+    const stigmer = useStigmer();
+    const fetchFn = agentId
+        ? async () => {
+            const result = await stigmer.agentChannel.getByAgent(create(GetAgentChannelsByAgentRequestSchema, { agentId, org: org ?? "" }));
+            return result.items;
+        }
+        : null;
+    const { data: channels, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [agentId, org, stigmer], []);
+    return { channels, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useAgentChannelList.js.map

package/channel/useAgentChannelList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentChannelList.js","sourceRoot":"","sources":["../../src/channel/useAgentChannelList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,oCAAoC,EAAE,MAAM,0DAA0D,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAqBnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,GAAY;IAC/D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAClD,MAAM,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAC1E,CAAC;YACF,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC1E,OAAO,EACP,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EACvB,EAAoB,CACrB,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/channel/useChannelSessions.d.ts

@@ -0,0 +1,47 @@
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+/** Return value of {@link useChannelSessions}. */
+export interface UseChannelSessionsReturn {
+    /**
+     * The channel's conversations (one session per external conversation),
+     * newest activity first. Empty while loading, on error, or when nobody
+     * has messaged the channel yet — `sessions.length === 0 && !isLoading
+     * && !error` means "no conversations yet".
+     */
+    readonly sessions: readonly Session[];
+    /** `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. A
+     * PERMISSION_DENIED here means the caller cannot view the channel —
+     * conversations are visible to exactly the channel's viewers (the
+     * connector and org admins).
+     */
+    readonly error: Error | null;
+    /** Re-fetch the conversations from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that loads the conversations an {@link AgentChannel} created —
+ * the Slack/WhatsApp sessions the channel runtime owns (design decision
+ * 012: channel-session read-only observability).
+ *
+ * The server enforces the visibility boundary twice: the caller must hold
+ * `can_view` on the channel, and results are filtered to sessions the
+ * caller can individually view. Open a returned session with
+ * `SessionViewer` — it self-selects the read-only `"observer"` audience
+ * for channel-originated sessions.
+ *
+ * Pass an empty `channelId` to skip fetching (stable no-op) — useful
+ * while the channel list is still loading.
+ *
+ * @example
+ * ```tsx
+ * const { sessions, isLoading, error } = useChannelSessions(
+ *   channel.metadata?.id ?? "",
+ * );
+ * ```
+ */
+export declare function useChannelSessions(channelId: string): UseChannelSessionsReturn;
+//# sourceMappingURL=useChannelSessions.d.ts.map

package/channel/useChannelSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChannelSessions.d.ts","sourceRoot":"","sources":["../../src/channel/useChannelSessions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAKpF,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,CAmB9E"}

package/channel/useChannelSessions.js

@@ -0,0 +1,38 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ListSessionsByChannelRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that loads the conversations an {@link AgentChannel} created —
+ * the Slack/WhatsApp sessions the channel runtime owns (design decision
+ * 012: channel-session read-only observability).
+ *
+ * The server enforces the visibility boundary twice: the caller must hold
+ * `can_view` on the channel, and results are filtered to sessions the
+ * caller can individually view. Open a returned session with
+ * `SessionViewer` — it self-selects the read-only `"observer"` audience
+ * for channel-originated sessions.
+ *
+ * Pass an empty `channelId` to skip fetching (stable no-op) — useful
+ * while the channel list is still loading.
+ *
+ * @example
+ * ```tsx
+ * const { sessions, isLoading, error } = useChannelSessions(
+ *   channel.metadata?.id ?? "",
+ * );
+ * ```
+ */
+export function useChannelSessions(channelId) {
+    const stigmer = useStigmer();
+    const fetchFn = channelId
+        ? async () => {
+            const result = await stigmer.session.listByChannel(create(ListSessionsByChannelRequestSchema, { channelId }));
+            return result.entries;
+        }
+        : null;
+    const { data: sessions, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [channelId, stigmer], []);
+    return { sessions, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useChannelSessions.js.map

package/channel/useChannelSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChannelSessions.js","sourceRoot":"","sources":["../../src/channel/useChannelSessions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,kCAAkC,EAAE,MAAM,qDAAqD,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA0BnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAChD,MAAM,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,CAAC,CAC1D,CAAC;YACF,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC1E,OAAO,EACP,CAAC,SAAS,EAAE,OAAO,CAAC,EACpB,EAAe,CAChB,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}

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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"}