@stigmer/react 3.1.13 → 3.1.14

package/sharing/useAgentShare.d.ts

@@ -1,49 +0,0 @@
-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.
- *
- * `shareOrg` scopes resolution to one sharing org's channel and defaults
- * to the agent's own org (the owner's share). Pass the viewer's org to
- * manage a **cross-org share** — the viewer's own channel of another
- * org's marketplace-public agent (decision 013).
- *
- * 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 in `shareOrg`; 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, shareOrg?: string): UseAgentShareReturn;
-//# sourceMappingURL=useAgentShare.d.ts.map

package/sharing/useAgentShare.d.ts.map

@@ -1 +0,0 @@
-{"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;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,mBAAmB,CAuBrB"}

package/sharing/useAgentShare.js

@@ -1,64 +0,0 @@
-"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 **within one sharing org**:
- * 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 in that org. The data model allows N shares per agent across N
- * orgs (decision 011 D3 + decision 013), so the org filter is what keeps
- * each org's dialog on its own channel — without it, an owner who can
- * also see another org's share of the same agent would edit the wrong
- * one. Extra shares created via manifests never confuse the dialog.
- */
-function pickCanonicalShare(shares, shareOrg, agentSlug) {
-    const inOrg = shares.filter((share) => share.metadata?.org === shareOrg);
-    return (inOrg.find((share) => share.metadata?.slug === agentSlug) ??
-        inOrg[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.
- *
- * `shareOrg` scopes resolution to one sharing org's channel and defaults
- * to the agent's own org (the owner's share). Pass the viewer's org to
- * manage a **cross-org share** — the viewer's own channel of another
- * org's marketplace-public agent (decision 013).
- *
- * 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 in `shareOrg`; 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, shareOrg) {
-    const stigmer = useStigmer();
-    const agentId = agent?.metadata?.id ?? "";
-    const agentSlug = agent?.metadata?.slug ?? "";
-    const resolvedShareOrg = shareOrg || (agent?.metadata?.org ?? "");
-    const fetchFn = agentId
-        ? async () => {
-            const result = await stigmer.agentShare.getByAgent(create(GetAgentSharesByAgentRequestSchema, { agentId }));
-            return pickCanonicalShare(result.items, resolvedShareOrg, agentSlug);
-        }
-        : null;
-    const { data: share, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [agentId, agentSlug, resolvedShareOrg, stigmer], null);
-    return { share, isLoading, isRefetching, error, refetch };
-}
-//# sourceMappingURL=useAgentShare.js.map

package/sharing/useAgentShare.js.map

@@ -1 +0,0 @@
-{"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;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CACzB,MAA6B,EAC7B,QAAgB,EAChB,SAAiB;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;IACzE,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC;QACzD,KAAK,CAAC,CAAC,CAAC;QACR,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,QAAiB;IAEjB,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;IAC9C,MAAM,gBAAgB,GAAG,QAAQ,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAElE,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,gBAAgB,EAAE,SAAS,CAAC,CAAC;QACvE,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,gBAAgB,EAAE,OAAO,CAAC,EAC/C,IAAyB,CAC1B,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC"}

package/sharing/useCreateExternalShareLink.d.ts

@@ -1,90 +0,0 @@
-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 useCreateExternalShareLink}. */
-export interface UseCreateExternalShareLinkArgs {
-    /**
-     * The agent to share, or `null` while it is still loading. When
-     * `null`, {@link UseCreateExternalShareLinkReturn.action} is `null`
-     * and the dialog renders nothing — safe to call before the resource
-     * is ready.
-     */
-    readonly agent: Agent | null;
-    /**
-     * The viewer's own organization — the org that would own the external
-     * share, pay for its traffic, and host its URL. When empty or equal to
-     * the agent's org, the action is `null` (the same-org Share entry from
-     * {@link useShareAgent} covers that case).
-     */
-    readonly viewerOrg: string;
-    /**
-     * Builds the absolute public chat URL for the shared agent. Same
-     * contract as {@link useShareAgent}: the host application owns URL
-     * construction. 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. */
-    readonly onSharingChanged?: () => void;
-    /** Menu-item label. @default "Create share link" */
-    readonly label?: string;
-}
-/** Return value of {@link useCreateExternalShareLink}. */
-export interface UseCreateExternalShareLinkReturn {
-    /**
-     * A ready-to-spread {@link DetailAction} for a kebab/overflow menu, or
-     * `null` when the entry does not apply: agent still loading, same-org
-     * (or no) viewer org, agent not marketplace-public, or the viewer
-     * lacks `can_create_agent_share` in their own org. Lives in the
-     * `"sharing"` group, like its same-org sibling.
-     */
-    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;
-}
-/**
- * The marketplace entry for **cross-org shares** (decision 013): a
- * "Create share link" action on another org's marketplace-public agent
- * that opens the same {@link ShareAgentDialog} with the share org set to
- * the viewer's own org. The resulting share is the viewer org's channel —
- * its URL (`/chat/<viewer-org>/<slug>`), its billing, its credential
- * bindings — while the agent blueprint stays live in its own org.
- *
- * The gate mirrors the server's create bar so the action never appears
- * to a user whose create would be refused:
- *
- * - the agent lives in another org and is `visibility_public` — the
- *   origin org's implicit consent (D1); the agent-side `can_execute`
- *   half of the bar is granted to every authenticated account on public
- *   agents by the `allow_public` wildcard, so visibility is its exact
- *   client-side proxy;
- * - the viewer holds `can_create_agent_share` in their own org (D2's
- *   org-side half — admin-level, since a public share spends that org's
- *   credits on the open internet). The org check uses the org slug as
- *   the resource id: an Organization's id equals its slug
- *   (ApiResourceMetadata.id).
- *
- * The same-org Share entry ({@link useShareAgent}, gated on agent
- * `can_edit`) and this one are mutually exclusive by construction — at
- * most one renders for any viewer/agent pair — so hosts can inject both
- * unconditionally.
- *
- * @example
- * ```tsx
- * const externalShare = useCreateExternalShareLink({
- *   agent,
- *   viewerOrg: activeOrgSlug,
- *   buildShareUrl,
- *   onSharingChanged: refetch,
- * });
- * // ...
- * <ResourceDetailShell actions={[...actions, externalShare.action].filter(Boolean)} ... />
- * {externalShare.dialog}
- * ```
- */
-export declare function useCreateExternalShareLink({ agent, viewerOrg, buildShareUrl, onSharingChanged, label, }: UseCreateExternalShareLinkArgs): UseCreateExternalShareLinkReturn;
-//# sourceMappingURL=useCreateExternalShareLink.d.ts.map

package/sharing/useCreateExternalShareLink.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useCreateExternalShareLink.d.ts","sourceRoot":"","sources":["../../src/sharing/useCreateExternalShareLink.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAGhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gCAAgC;IAC/C;;;;;;OAMG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,KAA2B,GAC5B,EAAE,8BAA8B,GAAG,gCAAgC,CAsCnE"}

package/sharing/useCreateExternalShareLink.js

@@ -1,65 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useState } from "react";
-import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
-import { useCheckPermission } from "../iam-policy/useCheckPermission.js";
-import { ShareAgentDialog } from "./ShareAgentDialog.js";
-/**
- * The marketplace entry for **cross-org shares** (decision 013): a
- * "Create share link" action on another org's marketplace-public agent
- * that opens the same {@link ShareAgentDialog} with the share org set to
- * the viewer's own org. The resulting share is the viewer org's channel —
- * its URL (`/chat/<viewer-org>/<slug>`), its billing, its credential
- * bindings — while the agent blueprint stays live in its own org.
- *
- * The gate mirrors the server's create bar so the action never appears
- * to a user whose create would be refused:
- *
- * - the agent lives in another org and is `visibility_public` — the
- *   origin org's implicit consent (D1); the agent-side `can_execute`
- *   half of the bar is granted to every authenticated account on public
- *   agents by the `allow_public` wildcard, so visibility is its exact
- *   client-side proxy;
- * - the viewer holds `can_create_agent_share` in their own org (D2's
- *   org-side half — admin-level, since a public share spends that org's
- *   credits on the open internet). The org check uses the org slug as
- *   the resource id: an Organization's id equals its slug
- *   (ApiResourceMetadata.id).
- *
- * The same-org Share entry ({@link useShareAgent}, gated on agent
- * `can_edit`) and this one are mutually exclusive by construction — at
- * most one renders for any viewer/agent pair — so hosts can inject both
- * unconditionally.
- *
- * @example
- * ```tsx
- * const externalShare = useCreateExternalShareLink({
- *   agent,
- *   viewerOrg: activeOrgSlug,
- *   buildShareUrl,
- *   onSharingChanged: refetch,
- * });
- * // ...
- * <ResourceDetailShell actions={[...actions, externalShare.action].filter(Boolean)} ... />
- * {externalShare.dialog}
- * ```
- */
-export function useCreateExternalShareLink({ agent, viewerOrg, buildShareUrl, onSharingChanged, label = "Create share link", }) {
-    const [isOpen, setIsOpen] = useState(false);
-    const agentOrg = agent?.metadata?.org ?? "";
-    const isCrossOrg = !!agent && viewerOrg !== "" && viewerOrg !== agentOrg;
-    const isPublic = agent?.metadata?.visibility === ApiResourceVisibility.visibility_public;
-    // The org-side bar is only worth asking about when the entry could
-    // apply at all — passing null skips the RPC entirely.
-    const { allowed: canCreateShare } = useCheckPermission(isCrossOrg && isPublic
-        ? { kind: "organization", id: viewerOrg }
-        : null, "can_create_agent_share");
-    const open = useCallback(() => setIsOpen(true), []);
-    const applicable = isCrossOrg && isPublic && canCreateShare;
-    const action = applicable
-        ? { id: "create-share-link", label, group: "sharing", onAction: open }
-        : null;
-    const dialog = agent && applicable ? (_jsx(ShareAgentDialog, { open: isOpen, onOpenChange: setIsOpen, agent: agent, shareOrg: viewerOrg, buildShareUrl: buildShareUrl, onSharingChanged: onSharingChanged })) : null;
-    return { action, dialog, open, isOpen };
-}
-//# sourceMappingURL=useCreateExternalShareLink.js.map

package/sharing/useCreateExternalShareLink.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useCreateExternalShareLink.js","sourceRoot":"","sources":["../../src/sharing/useCreateExternalShareLink.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAiDzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,KAAK,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,KAAK,GAAG,mBAAmB,GACI;IAC/B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,QAAQ,CAAC;IACzE,MAAM,QAAQ,GACZ,KAAK,EAAE,QAAQ,EAAE,UAAU,KAAK,qBAAqB,CAAC,iBAAiB,CAAC;IAE1E,mEAAmE;IACnE,sDAAsD;IACtD,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,kBAAkB,CACpD,UAAU,IAAI,QAAQ;QACpB,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE;QACzC,CAAC,CAAC,IAAI,EACR,wBAAwB,CACzB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpD,MAAM,UAAU,GAAG,UAAU,IAAI,QAAQ,IAAI,cAAc,CAAC;IAE5D,MAAM,MAAM,GAAwB,UAAU;QAC5C,CAAC,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtE,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,MAAM,GACV,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CACpB,KAAC,gBAAgB,IACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,EACvB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,SAAS,EACnB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GAClC,CACH,CAAC,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/sharing/useShareAgent.d.ts

@@ -1,69 +0,0 @@
-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
- * AgentShare create/apply handlers enforce on the referenced agent, 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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,KAAe,GAChB,EAAE,iBAAiB,GAAG,mBAAmB,CA2BzC"}

package/sharing/useShareAgent.js

@@ -1,42 +0,0 @@
-"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
- * AgentShare create/apply handlers enforce on the referenced agent, 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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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/src/sharing/__tests__/useAgentShare.test.tsx

@@ -1,210 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { renderHook, waitFor } from "@testing-library/react";
-import type { ReactNode } from "react";
-import type { GetAgentSharesByAgentRequest } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/io_pb";
-import { StigmerContext } from "../../context";
-import { FetchCacheContext } from "../../internal/FetchCacheProvider";
-import { useAgentShare } from "../useAgentShare";
-
-function createMockStigmer(overrides: {
-  getByAgent?: (input: GetAgentSharesByAgentRequest) => Promise<unknown>;
-} = {}) {
-  return {
-    agentShare: {
-      getByAgent:
-        overrides.getByAgent ??
-        vi.fn().mockResolvedValue({ totalCount: 0, items: [] }),
-    },
-  } as never;
-}
-
-function wrapper(client: unknown) {
-  return function Wrapper({ children }: { children: ReactNode }) {
-    return (
-      <FetchCacheContext.Provider value={null}>
-        <StigmerContext.Provider value={client as never}>
-          {children}
-        </StigmerContext.Provider>
-      </FetchCacheContext.Provider>
-    );
-  };
-}
-
-const AGENT = {
-  metadata: {
-    id: "agt_1",
-    org: "acme",
-    slug: "support-agent",
-    name: "Support Agent",
-  },
-} as never;
-
-function makeShare(slug: string, id = `ash_${slug}`) {
-  return {
-    metadata: { id, org: "acme", slug },
-    spec: { enabled: true },
-  };
-}
-
-describe("useAgentShare", () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it("loads the agent's shares by agent id", async () => {
-    const share = makeShare("support-agent");
-    const getByAgent = vi
-      .fn()
-      .mockResolvedValue({ totalCount: 1, items: [share] });
-    const client = createMockStigmer({ getByAgent });
-
-    const { result } = renderHook(() => useAgentShare(AGENT), {
-      wrapper: wrapper(client),
-    });
-
-    expect(result.current.isLoading).toBe(true);
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-
-    expect(result.current.share).toBe(share);
-    expect(result.current.error).toBeNull();
-    expect(getByAgent).toHaveBeenCalledWith(
-      expect.objectContaining({ agentId: "agt_1" }),
-    );
-  });
-
-  it("resolves null (no share yet) when the agent has never been shared", async () => {
-    const client = createMockStigmer();
-
-    const { result } = renderHook(() => useAgentShare(AGENT), {
-      wrapper: wrapper(client),
-    });
-
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-
-    // The no-share state is not an error: the first save creates the share.
-    expect(result.current.share).toBeNull();
-    expect(result.current.error).toBeNull();
-  });
-
-  it("picks the slug-matching share as canonical when several exist", async () => {
-    const canonical = makeShare("support-agent");
-    const renamed = makeShare("support-help-desk");
-    const getByAgent = vi
-      .fn()
-      .mockResolvedValue({ totalCount: 2, items: [renamed, canonical] });
-    const client = createMockStigmer({ getByAgent });
-
-    const { result } = renderHook(() => useAgentShare(AGENT), {
-      wrapper: wrapper(client),
-    });
-
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    expect(result.current.share).toBe(canonical);
-  });
-
-  it("falls back to the first share when none matches the agent slug", async () => {
-    // A manifest-created share with a custom slug is still manageable —
-    // preferring it over "no share" keeps the dialog editing the real row.
-    const renamed = makeShare("support-help-desk");
-    const getByAgent = vi
-      .fn()
-      .mockResolvedValue({ totalCount: 1, items: [renamed] });
-    const client = createMockStigmer({ getByAgent });
-
-    const { result } = renderHook(() => useAgentShare(AGENT), {
-      wrapper: wrapper(client),
-    });
-
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    expect(result.current.share).toBe(renamed);
-  });
-
-  it("skips fetching while the agent is null (stable no-op)", () => {
-    const getByAgent = vi.fn();
-    const client = createMockStigmer({ getByAgent });
-
-    const { result } = renderHook(() => useAgentShare(null), {
-      wrapper: wrapper(client),
-    });
-
-    expect(result.current.isLoading).toBe(false);
-    expect(result.current.share).toBeNull();
-    expect(getByAgent).not.toHaveBeenCalled();
-  });
-
-  describe("cross-org share resolution (shareOrg — decision 013)", () => {
-    it("scopes the canonical pick to the sharing org's channel", async () => {
-      // The same agent shared in two orgs: the owner's share AND another
-      // org's external share. Each org's dialog must resolve its own row.
-      const ownerShare = makeShare("support-agent");
-      const externalShare = {
-        metadata: { id: "ash_ext", org: "consumer-org", slug: "support-agent" },
-        spec: { enabled: true },
-      };
-      const getByAgent = vi
-        .fn()
-        .mockResolvedValue({ totalCount: 2, items: [ownerShare, externalShare] });
-      const client = createMockStigmer({ getByAgent });
-
-      const { result } = renderHook(
-        () => useAgentShare(AGENT, "consumer-org"),
-        { wrapper: wrapper(client) },
-      );
-
-      await waitFor(() => expect(result.current.isLoading).toBe(false));
-      expect(result.current.share).toBe(externalShare);
-    });
-
-    it("resolves null when only OTHER orgs' shares exist — never edits a foreign channel", async () => {
-      const ownerShare = makeShare("support-agent");
-      const getByAgent = vi
-        .fn()
-        .mockResolvedValue({ totalCount: 1, items: [ownerShare] });
-      const client = createMockStigmer({ getByAgent });
-
-      const { result } = renderHook(
-        () => useAgentShare(AGENT, "consumer-org"),
-        { wrapper: wrapper(client) },
-      );
-
-      await waitFor(() => expect(result.current.isLoading).toBe(false));
-      // Without the org filter this would fall back to the owner's share
-      // and a save would overwrite the wrong org's configuration.
-      expect(result.current.share).toBeNull();
-    });
-
-    it("defaults shareOrg to the agent's own org (Phase A behavior unchanged)", async () => {
-      const ownerShare = makeShare("support-agent");
-      const externalShare = {
-        metadata: { id: "ash_ext", org: "consumer-org", slug: "support-agent" },
-        spec: { enabled: true },
-      };
-      const getByAgent = vi
-        .fn()
-        .mockResolvedValue({ totalCount: 2, items: [externalShare, ownerShare] });
-      const client = createMockStigmer({ getByAgent });
-
-      const { result } = renderHook(() => useAgentShare(AGENT), {
-        wrapper: wrapper(client),
-      });
-
-      await waitFor(() => expect(result.current.isLoading).toBe(false));
-      expect(result.current.share).toBe(ownerShare);
-    });
-  });
-
-  it("exposes fetch failures as errors", async () => {
-    const getByAgent = vi
-      .fn()
-      .mockRejectedValue(new Error("backend unavailable"));
-    const client = createMockStigmer({ getByAgent });
-
-    const { result } = renderHook(() => useAgentShare(AGENT), {
-      wrapper: wrapper(client),
-    });
-
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    expect(result.current.error).toBeTruthy();
-    expect(result.current.share).toBeNull();
-  });
-});