@stigmer/react 3.1.7 → 3.1.9

package/sharing/SharedAgentChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedAgentChat.d.ts","sourceRoot":"","sources":["../../src/sharing/SharedAgentChat.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,IAAI,EACJ,OAAO,EACP,WAAW,EACX,aAAoB,EACpB,gBAAgB,EAChB,eAA0B,EAC1B,SAAS,EACT,SAAS,GACV,EAAE,oBAAoB,2CAoItB"}

package/sharing/SharedAgentChat.js

@@ -0,0 +1,80 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { NewSessionViewer } from "../session/NewSessionViewer.js";
+import { SessionViewer } from "../session/SessionViewer.js";
+import { useSharedAgentProfile } from "./useSharedAgentProfile.js";
+/**
+ * The complete shared-agent chat experience for anonymous visitors —
+ * the organism behind a shared agent's hosted page and embeds.
+ *
+ * Resolves the agent's public profile (name, description, icon, and
+ * the pinned deployment) via {@link useSharedAgentProfile}, then
+ * renders the session organisms with `audience="guest"`: a pure chat
+ * surface with no configuration pickers, pinned to the shared agent's
+ * default instance so the session binds synchronously on mount.
+ *
+ * Handles all states: loading, unavailable (the agent does not exist
+ * or is not shared — indistinguishable by design), transient errors
+ * (with retry), and the live chat.
+ *
+ * **Auth contract:** requires a `StigmerProvider` whose client can
+ * chat with this agent. For public shares (the default), pair with
+ * `createGuestAuth({ baseUrl, org, slug })` from `@stigmer/sdk` —
+ * the profile fetch is public and sessions use the guest token the
+ * provider mints on demand. For org-members-only shares, pass
+ * `sharingAudience="org"` and a client carrying the signed-in
+ * member's own token; the presentation stays the same pure chat.
+ *
+ * @example
+ * ```tsx
+ * const guestAuth = createGuestAuth({ baseUrl, org, slug });
+ * const client = useMemo(
+ *   () => new Stigmer({ baseUrl, getAccessToken: guestAuth.getAccessToken }),
+ *   [guestAuth],
+ * );
+ *
+ * <StigmerProvider client={client} colorMode="system">
+ *   <SharedAgentChat org={org} slug={slug} />
+ * </StigmerProvider>
+ * ```
+ */
+export function SharedAgentChat({ org, slug, heading, placeholder, showPoweredBy = true, onSessionCreated, sharingAudience = "public", linkToken, className, }) {
+    const { profile, isLoading, error, refetch } = useSharedAgentProfile(org, slug, {
+        audience: sharingAudience,
+        linkToken,
+    });
+    const [sessionId, setSessionId] = useState(null);
+    const [submitError, setSubmitError] = useState(null);
+    const handleSessionCreated = useCallback((id) => {
+        setSubmitError(null);
+        setSessionId(id);
+        onSessionCreated?.(id);
+    }, [onSessionCreated]);
+    if (isLoading) {
+        return (_jsx("div", { className: cn("flex h-full w-full items-center justify-center", className), "aria-busy": "true", "aria-label": "Loading agent", children: _jsx(LoadingSkeleton, {}) }));
+    }
+    if (error) {
+        return (_jsx("div", { className: cn("flex h-full w-full items-center justify-center", className), children: _jsx(StateCard, { title: "Something went wrong", message: getUserMessage(error), onRetry: refetch }) }));
+    }
+    // NOT_FOUND covers both "no such agent" and "sharing disabled" — the
+    // server keeps them indistinguishable so a revoked link leaks nothing.
+    // A profile without a default instance is equally unusable: there is
+    // no deployment to chat with, so it presents as the same state.
+    if (!profile || !profile.defaultInstanceId) {
+        return (_jsx("div", { className: cn("flex h-full w-full items-center justify-center", className), children: _jsx(StateCard, { title: "This agent isn't available", message: "The link may be incorrect, or sharing may have been turned off." }) }));
+    }
+    return (_jsxs("div", { className: cn("flex h-full w-full flex-col", className), children: [_jsxs("header", { className: "flex items-center gap-3 border-b border-border px-4 py-3", children: [profile.iconUrl ? (_jsx("img", { src: profile.iconUrl, alt: "", className: "size-8 rounded-md object-cover" })) : (_jsx("div", { "aria-hidden": "true", className: "flex size-8 items-center justify-center rounded-md bg-muted text-sm font-semibold text-muted-foreground", children: (profile.name || slug).charAt(0).toUpperCase() })), _jsxs("div", { className: "min-w-0", children: [_jsx("h1", { className: "truncate text-sm font-semibold text-foreground", children: profile.name || slug }), profile.description && (_jsx("p", { className: "truncate text-xs text-muted-foreground", children: profile.description }))] })] }), _jsx("div", { className: "min-h-0 flex-1", children: sessionId ? (_jsx(SessionViewer, { sessionId: sessionId, org: org, audience: "guest", enableGitHub: false })) : (_jsx(NewSessionViewer, { org: org, audience: "guest", initialAgentRef: { org, slug }, initialInstanceId: profile.defaultInstanceId, enableGitHub: false, heading: heading ?? `Chat with ${profile.name || slug}`, placeholder: placeholder ?? "Ask anything\u2026", onSessionCreated: handleSessionCreated, onError: setSubmitError, footerContent: submitError ? (_jsx("p", { role: "alert", className: "text-center text-xs text-destructive", children: submitError })) : undefined })) }), showPoweredBy && (_jsx("footer", { className: "border-t border-border px-4 py-2 text-center", children: _jsx("a", { href: "https://stigmer.ai", target: "_blank", rel: "noopener noreferrer", className: "text-[0.65rem] text-muted-foreground hover:text-foreground transition-colors", children: "Powered by Stigmer" }) }))] }));
+}
+// ---------------------------------------------------------------------------
+// State presentation
+// ---------------------------------------------------------------------------
+function LoadingSkeleton() {
+    return (_jsxs("div", { className: "w-full max-w-sm space-y-3 px-6", children: [_jsx("div", { className: "mx-auto h-8 w-8 animate-pulse rounded-md bg-muted" }), _jsx("div", { className: "mx-auto h-4 w-2/3 animate-pulse rounded bg-muted" }), _jsx("div", { className: "mx-auto h-3 w-1/2 animate-pulse rounded bg-muted" })] }));
+}
+function StateCard({ title, message, onRetry, }) {
+    return (_jsxs("div", { className: "mx-6 w-full max-w-sm rounded-lg border border-border bg-card p-6 text-center shadow-sm", children: [_jsx("h2", { className: "text-base font-semibold text-foreground", children: title }), _jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: message }), onRetry && (_jsx("button", { type: "button", onClick: onRetry, className: cn("mt-4 inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium", "bg-primary text-primary-foreground hover:bg-primary-hover", "transition-colors"), children: "Try again" }))] }));
+}
+//# sourceMappingURL=SharedAgentChat.js.map

package/sharing/SharedAgentChat.js.map

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

package/sharing/index.d.ts

@@ -0,0 +1,18 @@
+export { useSharedAgentProfile } from "./useSharedAgentProfile.js";
+export type { UseSharedAgentProfileOptions, UseSharedAgentProfileReturn, } from "./useSharedAgentProfile.js";
+export { SharedAgentChat } from "./SharedAgentChat.js";
+export type { SharedAgentChatProps } from "./SharedAgentChat.js";
+export { useAgentShare } from "./useAgentShare.js";
+export type { UseAgentShareReturn } from "./useAgentShare.js";
+export { sharingAudienceFromProto, useSaveAgentShare, } from "./useSaveAgentShare.js";
+export type { AgentShareDraft, SharingAudience, UseSaveAgentShareReturn, } from "./useSaveAgentShare.js";
+export { useRotateShareLink } from "./useRotateShareLink.js";
+export type { UseRotateShareLinkReturn } from "./useRotateShareLink.js";
+export { ShareAgentDialog } from "./ShareAgentDialog.js";
+export type { ShareAgentDialogProps } from "./ShareAgentDialog.js";
+export { useShareAgent } from "./useShareAgent.js";
+export type { UseShareAgentArgs, UseShareAgentReturn, } from "./useShareAgent.js";
+export { useShareToolReadiness } from "./useShareToolReadiness.js";
+export type { ShareToolReadiness } from "./useShareToolReadiness.js";
+export { validateOrigin, MAX_ALLOWED_ORIGINS } from "@stigmer/sdk";
+//# sourceMappingURL=index.d.ts.map

package/sharing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,eAAe,EACf,eAAe,EACf,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/sharing/index.js

@@ -0,0 +1,12 @@
+export { useSharedAgentProfile } from "./useSharedAgentProfile.js";
+export { SharedAgentChat } from "./SharedAgentChat.js";
+export { useAgentShare } from "./useAgentShare.js";
+export { sharingAudienceFromProto, useSaveAgentShare, } from "./useSaveAgentShare.js";
+export { useRotateShareLink } from "./useRotateShareLink.js";
+export { ShareAgentDialog } from "./ShareAgentDialog.js";
+export { useShareAgent } from "./useShareAgent.js";
+export { useShareToolReadiness } from "./useShareToolReadiness.js";
+// Origin validation moved to @stigmer/sdk (framework-free, shared with the
+// CLI); re-exported here so existing @stigmer/react importers keep working.
+export { validateOrigin, MAX_ALLOWED_ORIGINS } from "@stigmer/sdk";
+//# sourceMappingURL=index.js.map

package/sharing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,2EAA2E;AAC3E,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/sharing/useAgentShare.d.ts

@@ -0,0 +1,43 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
+/** Return value of {@link useAgentShare}. */
+export interface UseAgentShareReturn {
+    /**
+     * The agent's canonical share, or `null` while loading, on error, or
+     * when the agent has never been shared. `share === null && !isLoading
+     * && !error` means "no share exists yet" — the first save creates it.
+     */
+    readonly share: AgentShare | null;
+    /** `true` while the initial fetch or a refetch is in flight. */
+    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;
+    /** Discard cached data and re-fetch the share from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that loads an agent's canonical {@link AgentShare} — the
+ * resource carrying the hosted-chat channel configuration (audience,
+ * allowed origins, visitor messages, tool credentials, link token).
+ *
+ * Sharing is channel configuration, not agent behavior (decision 011):
+ * it lives in its own resource, so reading the agent alone can never
+ * tell whether it is shared. This hook is how owner-side surfaces (the
+ * Share dialog) resolve that state.
+ *
+ * Pass `null` for `agent` to skip fetching (stable no-op) — useful
+ * while the agent is still loading. A resolved `null` share means the
+ * agent has never been shared; the first save creates the share.
+ *
+ * @example
+ * ```tsx
+ * const { share, isLoading } = useAgentShare(agent);
+ *
+ * if (isLoading) return <Spinner />;
+ * const enabled = share?.spec?.enabled ?? false;
+ * ```
+ */
+export declare function useAgentShare(agent: Agent | null): UseAgentShareReturn;
+//# sourceMappingURL=useAgentShare.d.ts.map

package/sharing/useAgentShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentShare.d.ts","sourceRoot":"","sources":["../../src/sharing/useAgentShare.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yDAAyD,CAAC;AAK1F,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,gEAAgE;IAChE,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,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAqBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,mBAAmB,CAsBtE"}

package/sharing/useAgentShare.js

@@ -0,0 +1,54 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetAgentSharesByAgentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * The canonical share among an agent's shares: the one whose slug equals
+ * the agent's slug (the server's default when a share is created without
+ * an explicit slug), falling back to the first entry. The data model
+ * allows N shares per agent (decision 011 D3); the console manages the
+ * canonical one in Phase A, so extra shares created via manifests never
+ * confuse the dialog.
+ */
+function pickCanonicalShare(shares, agentSlug) {
+    return (shares.find((share) => share.metadata?.slug === agentSlug) ??
+        shares[0] ??
+        null);
+}
+/**
+ * Data hook that loads an agent's canonical {@link AgentShare} — the
+ * resource carrying the hosted-chat channel configuration (audience,
+ * allowed origins, visitor messages, tool credentials, link token).
+ *
+ * Sharing is channel configuration, not agent behavior (decision 011):
+ * it lives in its own resource, so reading the agent alone can never
+ * tell whether it is shared. This hook is how owner-side surfaces (the
+ * Share dialog) resolve that state.
+ *
+ * Pass `null` for `agent` to skip fetching (stable no-op) — useful
+ * while the agent is still loading. A resolved `null` share means the
+ * agent has never been shared; the first save creates the share.
+ *
+ * @example
+ * ```tsx
+ * const { share, isLoading } = useAgentShare(agent);
+ *
+ * if (isLoading) return <Spinner />;
+ * const enabled = share?.spec?.enabled ?? false;
+ * ```
+ */
+export function useAgentShare(agent) {
+    const stigmer = useStigmer();
+    const agentId = agent?.metadata?.id ?? "";
+    const agentSlug = agent?.metadata?.slug ?? "";
+    const fetchFn = agentId
+        ? async () => {
+            const result = await stigmer.agentShare.getByAgent(create(GetAgentSharesByAgentRequestSchema, { agentId }));
+            return pickCanonicalShare(result.items, agentSlug);
+        }
+        : null;
+    const { data: share, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [agentId, agentSlug, stigmer], null);
+    return { share, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useAgentShare.js.map

package/sharing/useAgentShare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentShare.js","sourceRoot":"","sources":["../../src/sharing/useAgentShare.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EAAE,kCAAkC,EAAE,MAAM,wDAAwD,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAoBnD;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,MAA6B,EAC7B,SAAiB;IAEjB,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC;QACT,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAE9C,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAChD,MAAM,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,CAAC,CACxD,CAAC;YACF,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACvE,OAAO,EACP,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAC7B,IAAyB,CAC1B,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC"}

package/sharing/useRotateShareLink.d.ts

@@ -0,0 +1,45 @@
+import type { AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
+/** Return value of {@link useRotateShareLink}. */
+export interface UseRotateShareLinkReturn {
+    /**
+     * Rotate the share's link token via the `rotateShareLink` RPC.
+     * Resolves with the updated share, whose `status.shareLinkToken`
+     * carries the new token for building the fresh share URL.
+     */
+    readonly rotateShareLink: () => Promise<AgentShare | undefined>;
+    /** `true` while the RPC is in flight. */
+    readonly isPending: boolean;
+    /** The last error from the RPC, or `null`. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that rotates a share's link token.
+ *
+ * Wraps the `stigmer.agentShare.rotateShareLink()` RPC (authorized by
+ * the share's `can_edit`) with loading and error state management. The
+ * server generates the token — there is nothing to supply — and the
+ * previous link stops working the moment the call resolves, including
+ * for visitors mid-conversation. The token lives in
+ * `status.shareLinkToken` (server-owned; this RPC is its sole writer),
+ * so it is never part of a share draft and survives every apply.
+ *
+ * The hook is stateless with respect to the share — adopt the returned
+ * share (or refetch) so the UI shows the new tokened link, matching the
+ * {@link useSaveAgentShare} convention.
+ *
+ * Pass `null` for `shareId` to produce a stable no-op (useful while the
+ * share is still loading, or before the agent has ever been shared —
+ * there is no token to rotate until a share exists).
+ *
+ * @example
+ * ```tsx
+ * const { rotateShareLink, isPending } = useRotateShareLink(
+ *   share?.metadata?.id ?? null,
+ * );
+ *
+ * const updated = await rotateShareLink();
+ * // updated.status.shareLinkToken is the new token
+ * ```
+ */
+export declare function useRotateShareLink(shareId: string | null): UseRotateShareLinkReturn;
+//# sourceMappingURL=useRotateShareLink.d.ts.map

package/sharing/useRotateShareLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRotateShareLink.d.ts","sourceRoot":"","sources":["../../src/sharing/useRotateShareLink.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yDAAyD,CAAC;AAK1F,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAChE,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,wBAAwB,CA0B1B"}

package/sharing/useRotateShareLink.js

@@ -0,0 +1,58 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RotateShareLinkInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that rotates a share's link token.
+ *
+ * Wraps the `stigmer.agentShare.rotateShareLink()` RPC (authorized by
+ * the share's `can_edit`) with loading and error state management. The
+ * server generates the token — there is nothing to supply — and the
+ * previous link stops working the moment the call resolves, including
+ * for visitors mid-conversation. The token lives in
+ * `status.shareLinkToken` (server-owned; this RPC is its sole writer),
+ * so it is never part of a share draft and survives every apply.
+ *
+ * The hook is stateless with respect to the share — adopt the returned
+ * share (or refetch) so the UI shows the new tokened link, matching the
+ * {@link useSaveAgentShare} convention.
+ *
+ * Pass `null` for `shareId` to produce a stable no-op (useful while the
+ * share is still loading, or before the agent has ever been shared —
+ * there is no token to rotate until a share exists).
+ *
+ * @example
+ * ```tsx
+ * const { rotateShareLink, isPending } = useRotateShareLink(
+ *   share?.metadata?.id ?? null,
+ * );
+ *
+ * const updated = await rotateShareLink();
+ * // updated.status.shareLinkToken is the new token
+ * ```
+ */
+export function useRotateShareLink(shareId) {
+    const stigmer = useStigmer();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const rotateShareLink = useCallback(async () => {
+        if (!shareId)
+            return undefined;
+        setIsPending(true);
+        setError(null);
+        try {
+            return await stigmer.agentShare.rotateShareLink(create(RotateShareLinkInputSchema, { resourceId: shareId }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [shareId, stigmer]);
+    return { rotateShareLink, isPending, error };
+}
+//# sourceMappingURL=useRotateShareLink.js.map

package/sharing/useRotateShareLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRotateShareLink.js","sourceRoot":"","sources":["../../src/sharing/useRotateShareLink.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAsB;IAEtB,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,eAAe,GAAG,WAAW,CAAC,KAAK,IAEvC,EAAE;QACF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,eAAe,CAC7C,MAAM,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAC5D,CAAC;QACJ,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,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}

package/sharing/useSaveAgentShare.d.ts

@@ -0,0 +1,105 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
+import { AgentShareAudience } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/spec_pb";
+import type { ResourceRef } from "@stigmer/sdk";
+/**
+ * Who can chat with a shared agent over its hosted link.
+ *
+ * - `"public"` — anyone with the link; visitors are anonymous guests.
+ * - `"org"` — signed-in members of the owning organization only.
+ *   Membership is checked on every conversation turn, so access ends the
+ *   moment a member leaves the org.
+ */
+export type SharingAudience = "public" | "org";
+/**
+ * A complete share configuration to persist.
+ *
+ * Every field is required by design: saving **replaces the share's whole
+ * spec**, so a caller must always supply the full configuration. A
+ * partial type here would let a toggle change silently wipe
+ * `allowedOrigins`, `messages`, `environmentRefs`, or the `audience` —
+ * the required shape makes that mistake unrepresentable. (The rotatable
+ * link token is exempt: it is server-owned `status`, which survives
+ * every save verbatim.)
+ */
+export interface AgentShareDraft {
+    /** Whether hosted-chat access for the configured audience is enabled. */
+    readonly enabled: boolean;
+    /** Who can chat: anyone with the link, or org members only. */
+    readonly audience: SharingAudience;
+    /**
+     * Exact web origins allowed to embed the shared agent
+     * (e.g. `https://example.com`). Empty list = embeddable anywhere.
+     * Embedding is public-audience only.
+     */
+    readonly allowedOrigins: readonly string[];
+    /** Owner-customized visitor refusal copy. Empty strings mean platform defaults. */
+    readonly messages: {
+        /** Shown when a visitor exceeds the message rate limit. */
+        readonly rateLimited: string;
+        /** Shown when the org's credits are exhausted (sharing fails closed). */
+        readonly unavailable: string;
+        /** Shown when a conversation hits its turn limit or inactivity timeout. */
+        readonly conversationEnded: string;
+    };
+    /**
+     * Org-shared environments whose values guest conversations receive —
+     * how a tool-using agent becomes chattable over a share link without
+     * touching its pristine default instance. Public-audience only (the
+     * proto CEL rule rejects bindings on org-audience shares, whose member
+     * sessions carry no share linkage in Phase A — decision 011 addendum).
+     */
+    readonly environmentRefs: readonly ResourceRef[];
+}
+/**
+ * Maps a proto {@link AgentShareAudience} to the SDK's string union.
+ * Unspecified means public by contract (a share created without an
+ * explicit audience is an anyone-with-link share).
+ */
+export declare function sharingAudienceFromProto(audience: AgentShareAudience | undefined): SharingAudience;
+/** Return value of {@link useSaveAgentShare}. */
+export interface UseSaveAgentShareReturn {
+    /**
+     * Persist the complete share configuration. Resolves with the
+     * persisted {@link AgentShare} — adopt it as the new baseline (its
+     * `status.shareLinkToken` carries the live link token).
+     *
+     * `current` is the share being edited, or `null` when the agent has
+     * never been shared — the save then creates the canonical share.
+     */
+    readonly save: (draft: AgentShareDraft, current: AgentShare | null) => Promise<AgentShare | undefined>;
+    /** `true` while the RPC is in flight. */
+    readonly isPending: boolean;
+    /** The last error from the RPC, or `null`. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that persists an agent's canonical share configuration.
+ *
+ * Commits via `stigmer.agentShare.apply()` — an idempotent upsert keyed
+ * on the share's `(org, slug)` identity — so one code path serves both
+ * the first enable (creates the share; the server authorizes on the
+ * referenced agent's `can_edit`) and every later edit. There is
+ * deliberately no create/update branching: the share slug is unique per
+ * org and defaults to the agent's slug, which makes apply-by-identity
+ * exact, and the generated `AgentShareInput` carries no `metadata.id`
+ * for an update to route by anyway.
+ *
+ * Disabling is a save with `enabled: false` — a config-preserving pause
+ * (decision 011 D1). Deleting the share is a separate, destructive
+ * operation this hook does not perform.
+ *
+ * Pass `null` for `agent` to produce a stable no-op (useful while the
+ * agent is still loading).
+ *
+ * @example
+ * ```tsx
+ * const { share } = useAgentShare(agent);
+ * const { save, isPending } = useSaveAgentShare(agent);
+ *
+ * const persisted = await save({ ...draft, enabled: true }, share);
+ * // persisted.status.shareLinkToken is the live link token
+ * ```
+ */
+export declare function useSaveAgentShare(agent: Agent | null): UseSaveAgentShareReturn;
+//# sourceMappingURL=useSaveAgentShare.d.ts.map

package/sharing/useSaveAgentShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSaveAgentShare.d.ts","sourceRoot":"","sources":["../../src/sharing/useSaveAgentShare.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yDAAyD,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE;QACjB,2DAA2D;QAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,yEAAyE;QACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,2EAA2E;QAC3E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;KACpC,CAAC;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,WAAW,EAAE,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,eAAe,CAEjB;AAQD,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,CACb,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,UAAU,GAAG,IAAI,KACvB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GAAG,IAAI,GAClB,uBAAuB,CAyDzB"}

package/sharing/useSaveAgentShare.js

@@ -0,0 +1,97 @@
+"use client";
+import { useCallback, useState } from "react";
+import { AgentShareAudience } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/spec_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Maps a proto {@link AgentShareAudience} to the SDK's string union.
+ * Unspecified means public by contract (a share created without an
+ * explicit audience is an anyone-with-link share).
+ */
+export function sharingAudienceFromProto(audience) {
+    return audience === AgentShareAudience.org ? "org" : "public";
+}
+function sharingAudienceToProto(audience) {
+    return audience === "org"
+        ? AgentShareAudience.org
+        : AgentShareAudience.public;
+}
+/**
+ * Behavior hook that persists an agent's canonical share configuration.
+ *
+ * Commits via `stigmer.agentShare.apply()` — an idempotent upsert keyed
+ * on the share's `(org, slug)` identity — so one code path serves both
+ * the first enable (creates the share; the server authorizes on the
+ * referenced agent's `can_edit`) and every later edit. There is
+ * deliberately no create/update branching: the share slug is unique per
+ * org and defaults to the agent's slug, which makes apply-by-identity
+ * exact, and the generated `AgentShareInput` carries no `metadata.id`
+ * for an update to route by anyway.
+ *
+ * Disabling is a save with `enabled: false` — a config-preserving pause
+ * (decision 011 D1). Deleting the share is a separate, destructive
+ * operation this hook does not perform.
+ *
+ * Pass `null` for `agent` to produce a stable no-op (useful while the
+ * agent is still loading).
+ *
+ * @example
+ * ```tsx
+ * const { share } = useAgentShare(agent);
+ * const { save, isPending } = useSaveAgentShare(agent);
+ *
+ * const persisted = await save({ ...draft, enabled: true }, share);
+ * // persisted.status.shareLinkToken is the live link token
+ * ```
+ */
+export function useSaveAgentShare(agent) {
+    const stigmer = useStigmer();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const agentOrg = agent?.metadata?.org ?? "";
+    const agentSlug = agent?.metadata?.slug ?? "";
+    const agentName = agent?.metadata?.name ?? "";
+    const save = useCallback(async (draft, current) => {
+        if (!agentOrg || !agentSlug)
+            return undefined;
+        setIsPending(true);
+        setError(null);
+        try {
+            return await stigmer.agentShare.apply({
+                // Identity: the existing share's org/slug when editing (a
+                // manifest-created share may carry a non-default slug — apply
+                // with the agent's slug would create a SECOND share), the
+                // agent's when creating (the server's own D2 default, made
+                // explicit).
+                org: current?.metadata?.org || agentOrg,
+                slug: current?.metadata?.slug || agentSlug,
+                name: current?.metadata?.name || agentName || agentSlug,
+                agentRef: { org: agentOrg, slug: agentSlug },
+                enabled: draft.enabled,
+                // Written as the explicit enum value, never left unspecified —
+                // a share persisted as "public" can't be silently downgraded
+                // by tooling that relies on the unspecified-means-public rule.
+                audience: sharingAudienceToProto(draft.audience),
+                allowedOrigins: [...draft.allowedOrigins],
+                messages: {
+                    rateLimited: draft.messages.rateLimited,
+                    unavailable: draft.messages.unavailable,
+                    conversationEnded: draft.messages.conversationEnded,
+                },
+                environmentRefs: draft.environmentRefs.map((ref) => ({
+                    org: ref.org,
+                    slug: ref.slug,
+                })),
+            });
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [agentOrg, agentSlug, agentName, stigmer]);
+    return { save, isPending, error };
+}
+//# sourceMappingURL=useSaveAgentShare.js.map

package/sharing/useSaveAgentShare.js.map

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