@stigmer/react 3.1.7 → 3.1.8

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,16 @@
+export { useSharedAgentProfile } from "./useSharedAgentProfile.js";
+export type { UseSharedAgentProfileOptions, UseSharedAgentProfileReturn, } from "./useSharedAgentProfile.js";
+export { SharedAgentChat } from "./SharedAgentChat.js";
+export type { SharedAgentChatProps } from "./SharedAgentChat.js";
+export { sharingAudienceFromProto, useUpdateAgentSharing, } from "./useUpdateAgentSharing.js";
+export { useRotateShareLink } from "./useRotateShareLink.js";
+export type { UseRotateShareLinkReturn } from "./useRotateShareLink.js";
+export type { AgentSharingDraft, SharingAudience, UseUpdateAgentSharingReturn, } from "./useUpdateAgentSharing.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,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,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,11 @@
+export { useSharedAgentProfile } from "./useSharedAgentProfile.js";
+export { SharedAgentChat } from "./SharedAgentChat.js";
+export { sharingAudienceFromProto, useUpdateAgentSharing, } from "./useUpdateAgentSharing.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,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D,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/useRotateShareLink.d.ts

@@ -0,0 +1,42 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+/** Return value of {@link useRotateShareLink}. */
+export interface UseRotateShareLinkReturn {
+    /**
+     * Rotate the agent's share-link token via the `rotateShareLink` RPC.
+     * Resolves with the updated agent, whose `status.shareLinkToken`
+     * carries the new token for building the fresh share URL.
+     */
+    readonly rotateShareLink: () => Promise<Agent | 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 an agent's share-link token.
+ *
+ * Wraps the `stigmer.agent.rotateShareLink()` RPC (authorized by
+ * `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), so it is never part of a sharing draft and survives
+ * manifest applies.
+ *
+ * The hook is stateless with respect to the agent — adopt the returned
+ * agent (or refetch) so the UI shows the new tokened link, matching the
+ * {@link useUpdateAgentSharing} convention.
+ *
+ * Pass `null` for `agentId` to produce a stable no-op (useful while the
+ * agent is still loading).
+ *
+ * @example
+ * ```tsx
+ * const { rotateShareLink, isPending } = useRotateShareLink(agent.metadata.id);
+ *
+ * const updated = await rotateShareLink();
+ * // updated.status.shareLinkToken is the new token
+ * ```
+ */
+export declare function useRotateShareLink(agentId: 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,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAKhF,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC3D,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,wBAAwB,CAwB1B"}

package/sharing/useRotateShareLink.js

@@ -0,0 +1,55 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RotateShareLinkInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that rotates an agent's share-link token.
+ *
+ * Wraps the `stigmer.agent.rotateShareLink()` RPC (authorized by
+ * `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), so it is never part of a sharing draft and survives
+ * manifest applies.
+ *
+ * The hook is stateless with respect to the agent — adopt the returned
+ * agent (or refetch) so the UI shows the new tokened link, matching the
+ * {@link useUpdateAgentSharing} convention.
+ *
+ * Pass `null` for `agentId` to produce a stable no-op (useful while the
+ * agent is still loading).
+ *
+ * @example
+ * ```tsx
+ * const { rotateShareLink, isPending } = useRotateShareLink(agent.metadata.id);
+ *
+ * const updated = await rotateShareLink();
+ * // updated.status.shareLinkToken is the new token
+ * ```
+ */
+export function useRotateShareLink(agentId) {
+    const stigmer = useStigmer();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const rotateShareLink = useCallback(async () => {
+        if (!agentId)
+            return undefined;
+        setIsPending(true);
+        setError(null);
+        try {
+            return await stigmer.agent.rotateShareLink(create(RotateShareLinkInputSchema, { resourceId: agentId }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [agentId, 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,mDAAmD,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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,IAAgC,EAAE;QACzE,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,KAAK,CAAC,eAAe,CACxC,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/useShareAgent.d.ts

@@ -0,0 +1,68 @@
+import { type ReactNode } from "react";
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { DetailAction } from "../resource-detail/types.js";
+/** Arguments for {@link useShareAgent}. */
+export interface UseShareAgentArgs {
+    /**
+     * The agent whose sharing is managed, or `null` while it is still
+     * loading. When `null`, {@link UseShareAgentReturn.action} is `null`
+     * and the dialog renders nothing — safe to call before the resource
+     * is ready.
+     */
+    readonly agent: Agent | null;
+    /**
+     * Builds the absolute public chat URL for the shared agent. The host
+     * application owns URL construction (its configured public origin may
+     * differ from the rendering origin — e.g. the desktop app). When
+     * omitted, the dialog falls back to the relative `/chat/<org>/<slug>`.
+     */
+    readonly buildShareUrl?: (org: string, slug: string) => string;
+    /**
+     * Called after any sharing change is persisted. Hosts typically pass
+     * the agent data hook's `refetch`.
+     */
+    readonly onSharingChanged?: () => void;
+    /** Menu-item label. @default "Share" */
+    readonly label?: string;
+}
+/** Return value of {@link useShareAgent}. */
+export interface UseShareAgentReturn {
+    /**
+     * A ready-to-spread {@link DetailAction} for a kebab/overflow menu, or
+     * `null` when the agent is unavailable or the user lacks `can_edit`.
+     * Lives in the `"sharing"` group, beside "Manage access".
+     */
+    readonly action: DetailAction | null;
+    /** The {@link ShareAgentDialog} node — render it once in the host tree. */
+    readonly dialog: ReactNode;
+    /** Imperatively open the dialog. */
+    readonly open: () => void;
+    /** Whether the dialog is currently open. */
+    readonly isOpen: boolean;
+}
+/**
+ * Wires the Share dialog to a kebab/overflow menu — the same trigger
+ * shape as {@link useManageAccess}, its conceptual sibling: Manage access
+ * governs who can *read* the blueprint; Share governs who can *chat* with
+ * the running agent (billed to the owning org).
+ *
+ * Owns the open-state and the `can_edit` gate — the same permission the
+ * `updateSharing` RPC enforces, so the action never appears to a user
+ * whose changes would be rejected. Returns a `null` action while the
+ * agent is loading or the user cannot edit, so the host can
+ * unconditionally fold `action` into its actions array.
+ *
+ * @example
+ * ```tsx
+ * const share = useShareAgent({
+ *   agent,
+ *   buildShareUrl: (org, slug) => `${appOrigin}/chat/${org}/${slug}`,
+ *   onSharingChanged: refetch,
+ * });
+ * // ...
+ * <ResourceDetailShell actions={share.action ? [...actions, share.action] : actions} ... />
+ * {share.dialog}
+ * ```
+ */
+export declare function useShareAgent({ agent, buildShareUrl, onSharingChanged, label, }: UseShareAgentArgs): UseShareAgentReturn;
+//# sourceMappingURL=useShareAgent.d.ts.map

package/sharing/useShareAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareAgent.d.ts","sourceRoot":"","sources":["../../src/sharing/useShareAgent.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,KAAe,GAChB,EAAE,iBAAiB,GAAG,mBAAmB,CA2BzC"}

package/sharing/useShareAgent.js

@@ -0,0 +1,41 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { useCheckPermission } from "../iam-policy/useCheckPermission.js";
+import { ShareAgentDialog } from "./ShareAgentDialog.js";
+/**
+ * Wires the Share dialog to a kebab/overflow menu — the same trigger
+ * shape as {@link useManageAccess}, its conceptual sibling: Manage access
+ * governs who can *read* the blueprint; Share governs who can *chat* with
+ * the running agent (billed to the owning org).
+ *
+ * Owns the open-state and the `can_edit` gate — the same permission the
+ * `updateSharing` RPC enforces, so the action never appears to a user
+ * whose changes would be rejected. Returns a `null` action while the
+ * agent is loading or the user cannot edit, so the host can
+ * unconditionally fold `action` into its actions array.
+ *
+ * @example
+ * ```tsx
+ * const share = useShareAgent({
+ *   agent,
+ *   buildShareUrl: (org, slug) => `${appOrigin}/chat/${org}/${slug}`,
+ *   onSharingChanged: refetch,
+ * });
+ * // ...
+ * <ResourceDetailShell actions={share.action ? [...actions, share.action] : actions} ... />
+ * {share.dialog}
+ * ```
+ */
+export function useShareAgent({ agent, buildShareUrl, onSharingChanged, label = "Share", }) {
+    const [isOpen, setIsOpen] = useState(false);
+    const agentId = agent?.metadata?.id ?? null;
+    const { allowed: canEdit } = useCheckPermission(agentId ? { kind: "agent", id: agentId } : null, "can_edit");
+    const open = useCallback(() => setIsOpen(true), []);
+    const action = agent && canEdit
+        ? { id: "share", label, group: "sharing", onAction: open }
+        : null;
+    const dialog = agent ? (_jsx(ShareAgentDialog, { open: isOpen, onOpenChange: setIsOpen, agent: agent, buildShareUrl: buildShareUrl, onSharingChanged: onSharingChanged })) : null;
+    return { action, dialog, open, isOpen };
+}
+//# sourceMappingURL=useShareAgent.js.map

package/sharing/useShareAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareAgent.js","sourceRoot":"","sources":["../../src/sharing/useShareAgent.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA2CzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,GAAG,OAAO,GACG;IAClB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC;IAC5C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAC7C,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAC/C,UAAU,CACX,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpD,MAAM,MAAM,GACV,KAAK,IAAI,OAAO;QACd,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1D,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CACrB,KAAC,gBAAgB,IACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,EACvB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GAClC,CACH,CAAC,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/sharing/useShareToolReadiness.d.ts

@@ -0,0 +1,48 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+/**
+ * Readiness of a shared agent's tool credentials for visitor (and
+ * teammate) executions.
+ *
+ * - `na` — nothing to check: the agent uses no MCP tools, the check is
+ *   disabled, or the deployment cannot serve guest chat (local mode).
+ * - `checking` — lookups in flight.
+ * - `ready` — every environment bound to the agent's default instance is
+ *   shared with the organization.
+ * - `blocked` — one or more bound environments are private; their
+ *   `org/slug` references are listed for the hint copy.
+ */
+export type ShareToolReadiness = {
+    readonly status: "na";
+} | {
+    readonly status: "checking";
+} | {
+    readonly status: "ready";
+} | {
+    readonly status: "blocked";
+    readonly privateEnvironments: readonly string[];
+};
+/**
+ * Data hook that checks whether a tool-using shared agent's credentials
+ * will work for visitors — i.e. whether the environments bound to its
+ * default instance are shared with the organization (`visibility_org`).
+ *
+ * Guest and teammate executions can only use org-shared environments;
+ * a private environment's secrets are creator-only and silently
+ * unavailable to them, so the agent's tools would fail at runtime. This
+ * hook powers the Share dialog's pre-flight hint, catching the
+ * misconfiguration at share time instead of at the visitor's first
+ * message.
+ *
+ * Scope note: environments bound via `environment_refs` are the
+ * supported credential path for shared agents. Credentials that only
+ * exist in the owner's personal environment are also invisible to
+ * guests, but are not detectable from the instance binding — the
+ * runtime's enriched FAILED_PRECONDITION error covers that case.
+ *
+ * The check runs only when `enabled` is true, the deployment is cloud
+ * (local mode has no guest runtime or secret gating), and the agent
+ * declares MCP server usages. All lookups run as the owner viewing the
+ * dialog, who can read the bound environments.
+ */
+export declare function useShareToolReadiness(agent: Agent, enabled: boolean): ShareToolReadiness;
+//# sourceMappingURL=useShareToolReadiness.d.ts.map

package/sharing/useShareToolReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareToolReadiness.d.ts","sourceRoot":"","sources":["../../src/sharing/useShareToolReadiness.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAKhF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAIpF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,kBAAkB,CA0EpB"}

package/sharing/useShareToolReadiness.js

@@ -0,0 +1,93 @@
+"use client";
+import { useEffect, useState } from "react";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { useStigmer } from "../hooks.js";
+import { useDeploymentMode } from "../deployment-mode.js";
+const NA = { status: "na" };
+/**
+ * Data hook that checks whether a tool-using shared agent's credentials
+ * will work for visitors — i.e. whether the environments bound to its
+ * default instance are shared with the organization (`visibility_org`).
+ *
+ * Guest and teammate executions can only use org-shared environments;
+ * a private environment's secrets are creator-only and silently
+ * unavailable to them, so the agent's tools would fail at runtime. This
+ * hook powers the Share dialog's pre-flight hint, catching the
+ * misconfiguration at share time instead of at the visitor's first
+ * message.
+ *
+ * Scope note: environments bound via `environment_refs` are the
+ * supported credential path for shared agents. Credentials that only
+ * exist in the owner's personal environment are also invisible to
+ * guests, but are not detectable from the instance binding — the
+ * runtime's enriched FAILED_PRECONDITION error covers that case.
+ *
+ * The check runs only when `enabled` is true, the deployment is cloud
+ * (local mode has no guest runtime or secret gating), and the agent
+ * declares MCP server usages. All lookups run as the owner viewing the
+ * dialog, who can read the bound environments.
+ */
+export function useShareToolReadiness(agent, enabled) {
+    const stigmer = useStigmer();
+    const deploymentMode = useDeploymentMode();
+    const [readiness, setReadiness] = useState(NA);
+    const agentId = agent.metadata?.id ?? "";
+    const hasMcpTools = (agent.spec?.mcpServerUsages?.length ?? 0) > 0;
+    const defaultInstanceId = agent.status?.defaultInstanceId ?? "";
+    const shouldCheck = enabled &&
+        deploymentMode === "cloud" &&
+        hasMcpTools &&
+        defaultInstanceId !== "";
+    useEffect(() => {
+        if (!shouldCheck) {
+            setReadiness(NA);
+            return;
+        }
+        let cancelled = false;
+        setReadiness({ status: "checking" });
+        (async () => {
+            const instance = await stigmer.agentInstance.get(defaultInstanceId);
+            const refs = instance.spec?.environmentRefs ?? [];
+            if (refs.length === 0) {
+                // No bound environments to assess. The tools may need no
+                // credentials at all — do not warn on a guess.
+                return NA;
+            }
+            const privateRefs = [];
+            for (const ref of refs) {
+                try {
+                    const env = await stigmer.environment.getByReference({
+                        org: ref.org,
+                        slug: ref.slug,
+                    });
+                    if (env.metadata?.visibility !== ApiResourceVisibility.visibility_org) {
+                        privateRefs.push(`${ref.org}/${ref.slug}`);
+                    }
+                }
+                catch {
+                    // Unreadable ref (deleted, foreign): the runtime will skip it
+                    // for visitors too — surface it as blocking.
+                    privateRefs.push(`${ref.org}/${ref.slug}`);
+                }
+            }
+            return privateRefs.length === 0
+                ? { status: "ready" }
+                : { status: "blocked", privateEnvironments: privateRefs };
+        })().then((result) => {
+            if (!cancelled)
+                setReadiness(result);
+        }, () => {
+            // The hint is best-effort pre-flight advice — a failed check must
+            // never block the dialog. The runtime error path still diagnoses.
+            if (!cancelled)
+                setReadiness(NA);
+        });
+        return () => {
+            cancelled = true;
+        };
+        // agentId stands in for the agent object identity: the inputs that
+        // matter (instance id, MCP usage presence) are covered explicitly.
+    }, [shouldCheck, defaultInstanceId, agentId, stigmer]);
+    return readiness;
+}
+//# sourceMappingURL=useShareToolReadiness.js.map

package/sharing/useShareToolReadiness.js.map

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

package/sharing/useSharedAgentProfile.d.ts

@@ -0,0 +1,84 @@
+import { type SharedAgentProfile } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/io_pb";
+import type { SharingAudience } from "./useUpdateAgentSharing.js";
+/** Options for {@link useSharedAgentProfile}. */
+export interface UseSharedAgentProfileOptions {
+    /**
+     * Which resolution path to use.
+     *
+     * - `"public"` (default) — the anonymous `getSharedProfile` RPC. An
+     *   org-audience share answers NOT_FOUND here by design.
+     * - `"org"` — the authenticated `getSharedProfileForMember` RPC, which
+     *   resolves org-audience shares for signed-in members of the owning
+     *   organization (and public shares too). Requires a `StigmerProvider`
+     *   whose client carries the member's token.
+     */
+    readonly audience?: SharingAudience;
+    /**
+     * Share-link token from the URL's `?k=` parameter (public path only).
+     *
+     * Required when the share link has been locked with a rotatable token;
+     * harmless on plain links. On a locked link a missing or rotated-away
+     * token resolves to `profile === null`, indistinguishable from an
+     * agent that does not exist.
+     */
+    readonly linkToken?: string;
+}
+/** Return value of {@link useSharedAgentProfile}. */
+export interface UseSharedAgentProfileReturn {
+    /**
+     * The shared agent's public profile, or `null` while loading, on
+     * error, or when the agent is not shared.
+     */
+    readonly profile: SharedAgentProfile | 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 profile from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a shared agent's public profile by
+ * organization and agent slug.
+ *
+ * By default this hook calls the `getSharedProfile` endpoint, which is
+ * **public** — it requires no authentication. The server returns a
+ * trimmed projection safe for anonymous visitors: name, description,
+ * icon, and the default instance id needed to start a session
+ * (an identifier, not a capability — session creation still requires
+ * an authorized token, e.g. a guest token from `createGuestAuth`).
+ * With `{ audience: "org" }` it calls the authenticated
+ * `getSharedProfileForMember` endpoint instead, which resolves
+ * org-members-only shares for a signed-in member.
+ *
+ * **Not-shared handling:** the server answers NOT_FOUND for "this
+ * agent does not exist", "this agent is not shared", and (on the
+ * member path) "you are not a member of this organization" — all
+ * indistinguishable by design so a share URL leaks nothing. The hook
+ * maps that to `profile === null` without raising an error, matching
+ * `useAgent`'s not-found convention:
+ * `profile === null && !isLoading && !error` means unavailable.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op) — useful while route params are still resolving.
+ *
+ * **Note**: Although authentication is not required by the server,
+ * the hook still requires a `StigmerProvider` ancestor because it
+ * needs the transport configuration (API base URL) to make the
+ * request.
+ *
+ * @example
+ * ```tsx
+ * const { profile, isLoading, error } = useSharedAgentProfile(org, slug);
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <ErrorCard error={error} />;
+ * if (!profile) return <AgentUnavailable />;
+ *
+ * return <h1>{profile.name}</h1>;
+ * ```
+ */
+export declare function useSharedAgentProfile(org: string | null, slug: string | null, options?: UseSharedAgentProfileOptions): UseSharedAgentProfileReturn;
+//# sourceMappingURL=useSharedAgentProfile.d.ts.map

package/sharing/useSharedAgentProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSharedAgentProfile.d.ts","sourceRoot":"","sources":["../../src/sharing/useSharedAgentProfile.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,mDAAmD,CAAC;AAI3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAEpC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,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,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,4BAA4B,GACrC,2BAA2B,CA+B7B"}

package/sharing/useSharedAgentProfile.js

@@ -0,0 +1,72 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetSharedProfileRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/io_pb";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that fetches a shared agent's public profile by
+ * organization and agent slug.
+ *
+ * By default this hook calls the `getSharedProfile` endpoint, which is
+ * **public** — it requires no authentication. The server returns a
+ * trimmed projection safe for anonymous visitors: name, description,
+ * icon, and the default instance id needed to start a session
+ * (an identifier, not a capability — session creation still requires
+ * an authorized token, e.g. a guest token from `createGuestAuth`).
+ * With `{ audience: "org" }` it calls the authenticated
+ * `getSharedProfileForMember` endpoint instead, which resolves
+ * org-members-only shares for a signed-in member.
+ *
+ * **Not-shared handling:** the server answers NOT_FOUND for "this
+ * agent does not exist", "this agent is not shared", and (on the
+ * member path) "you are not a member of this organization" — all
+ * indistinguishable by design so a share URL leaks nothing. The hook
+ * maps that to `profile === null` without raising an error, matching
+ * `useAgent`'s not-found convention:
+ * `profile === null && !isLoading && !error` means unavailable.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op) — useful while route params are still resolving.
+ *
+ * **Note**: Although authentication is not required by the server,
+ * the hook still requires a `StigmerProvider` ancestor because it
+ * needs the transport configuration (API base URL) to make the
+ * request.
+ *
+ * @example
+ * ```tsx
+ * const { profile, isLoading, error } = useSharedAgentProfile(org, slug);
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <ErrorCard error={error} />;
+ * if (!profile) return <AgentUnavailable />;
+ *
+ * return <h1>{profile.name}</h1>;
+ * ```
+ */
+export function useSharedAgentProfile(org, slug, options) {
+    const stigmer = useStigmer();
+    const audience = options?.audience ?? "public";
+    const linkToken = options?.linkToken ?? "";
+    const fetchFn = org && slug
+        ? async () => {
+            try {
+                // The member path is tokenless by contract: org-audience access
+                // is gated by live membership, and token-locked public shares
+                // deliberately refuse there (see getSharedProfileForMember).
+                return audience === "org"
+                    ? await stigmer.agent.getSharedProfileForMember({ org, slug })
+                    : await stigmer.agent.getSharedProfile(create(GetSharedProfileRequestSchema, { org, slug, linkToken }));
+            }
+            catch (err) {
+                if (isNotFound(err))
+                    return null;
+                throw err;
+            }
+        }
+        : null;
+    const { data: profile, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [org, slug, audience, linkToken, stigmer], null);
+    return { profile, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useSharedAgentProfile.js.map

package/sharing/useSharedAgentProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSharedAgentProfile.js","sourceRoot":"","sources":["../../src/sharing/useSharedAgentProfile.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,6BAA6B,GAE9B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA6CnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAkB,EAClB,IAAmB,EACnB,OAAsC;IAEtC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAE3C,MAAM,OAAO,GACX,GAAG,IAAI,IAAI;QACT,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,gEAAgE;gBAChE,8DAA8D;gBAC9D,6DAA6D;gBAC7D,OAAO,QAAQ,KAAK,KAAK;oBACvB,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;oBAC9D,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAClC,MAAM,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAChE,CAAC;YACR,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;IAEX,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACzE,OAAO,EACP,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EACzC,IAAiC,CAClC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}