@stigmer/react 3.1.13 → 3.1.15

package/src/sharing/__tests__/useCreateExternalShareLink.test.tsx

@@ -1,194 +0,0 @@
-import { describe, it, expect, vi, beforeAll, afterEach } from "vitest";
-import { renderHook, waitFor, cleanup } from "@testing-library/react";
-import type { ReactNode } from "react";
-import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
-import { StigmerContext } from "../../context";
-import { FetchCacheContext } from "../../internal/FetchCacheProvider";
-import { useCreateExternalShareLink } from "../useCreateExternalShareLink";
-
-// happy-dom does not implement the native dialog show/close methods.
-beforeAll(() => {
-  HTMLDialogElement.prototype.showModal = function showModal() {
-    this.open = true;
-  };
-  HTMLDialogElement.prototype.close = function close() {
-    this.open = false;
-  };
-});
-
-afterEach(cleanup);
-
-function createMockStigmer(overrides: {
-  isAuthorized?: boolean;
-  checkMyPermission?: (...args: unknown[]) => Promise<unknown>;
-} = {}) {
-  return {
-    iamPolicy: {
-      checkMyPermission:
-        overrides.checkMyPermission ??
-        vi.fn().mockResolvedValue({
-          isAuthorized: overrides.isAuthorized ?? true,
-        }),
-    },
-    agentShare: {
-      getByAgent: vi.fn().mockResolvedValue({ totalCount: 0, items: [] }),
-      apply: vi.fn().mockResolvedValue({}),
-      rotateShareLink: vi.fn().mockResolvedValue({}),
-    },
-    billing: { getOrCreateBillingAccount: vi.fn().mockResolvedValue(null) },
-  } 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>
-    );
-  };
-}
-
-function makeAgent(visibility: ApiResourceVisibility) {
-  return {
-    metadata: {
-      id: "agt_1",
-      org: "provider-org",
-      slug: "public-helper",
-      name: "Public Helper",
-      visibility,
-    },
-    spec: {},
-  } as never;
-}
-
-const PUBLIC_AGENT = makeAgent(ApiResourceVisibility.visibility_public);
-const PRIVATE_AGENT = makeAgent(ApiResourceVisibility.visibility_private);
-
-describe("useCreateExternalShareLink", () => {
-  it("offers the action on another org's public agent when the viewer holds the org bar", async () => {
-    const { result } = renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PUBLIC_AGENT,
-          viewerOrg: "consumer-org",
-        }),
-      { wrapper: wrapper(createMockStigmer({ isAuthorized: true })) },
-    );
-
-    await waitFor(() => expect(result.current.action).not.toBeNull());
-    expect(result.current.action?.id).toBe("create-share-link");
-    expect(result.current.action?.label).toBe("Create share link");
-    expect(result.current.action?.group).toBe("sharing");
-  });
-
-  it("checks can_create_agent_share on the VIEWER's org (id = slug)", async () => {
-    const client = createMockStigmer({ isAuthorized: true });
-    renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PUBLIC_AGENT,
-          viewerOrg: "consumer-org",
-        }),
-      { wrapper: wrapper(client) },
-    );
-
-    const check = (
-      client as { iamPolicy: { checkMyPermission: ReturnType<typeof vi.fn> } }
-    ).iamPolicy.checkMyPermission;
-    await waitFor(() => expect(check).toHaveBeenCalled());
-    const input = check.mock.calls[0][0] as {
-      resource?: { kind: string; id: string };
-      relation: string;
-    };
-    expect(input.relation).toBe("can_create_agent_share");
-    expect(input.resource?.kind).toBe("organization");
-    expect(input.resource?.id).toBe("consumer-org");
-  });
-
-  it("stays null on the viewer's OWN agents — the same-org Share entry covers those", () => {
-    const checkMyPermission = vi.fn();
-    const { result } = renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PUBLIC_AGENT,
-          viewerOrg: "provider-org",
-        }),
-      { wrapper: wrapper(createMockStigmer({ checkMyPermission })) },
-    );
-
-    expect(result.current.action).toBeNull();
-    expect(result.current.dialog).toBeNull();
-    // Not applicable structurally: no permission round-trip is spent.
-    expect(checkMyPermission).not.toHaveBeenCalled();
-  });
-
-  it("stays null on a non-public agent — visibility is the origin org's consent", () => {
-    const checkMyPermission = vi.fn();
-    const { result } = renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PRIVATE_AGENT,
-          viewerOrg: "consumer-org",
-        }),
-      { wrapper: wrapper(createMockStigmer({ checkMyPermission })) },
-    );
-
-    expect(result.current.action).toBeNull();
-    expect(checkMyPermission).not.toHaveBeenCalled();
-  });
-
-  it("stays null while the agent is loading or the viewer org is unknown", () => {
-    const client = createMockStigmer();
-    const { result: loading } = renderHook(
-      () => useCreateExternalShareLink({ agent: null, viewerOrg: "consumer-org" }),
-      { wrapper: wrapper(client) },
-    );
-    const { result: orgless } = renderHook(
-      () => useCreateExternalShareLink({ agent: PUBLIC_AGENT, viewerOrg: "" }),
-      { wrapper: wrapper(client) },
-    );
-
-    expect(loading.current.action).toBeNull();
-    expect(orgless.current.action).toBeNull();
-  });
-
-  it("hides the action when the viewer lacks the org-side permission", async () => {
-    const client = createMockStigmer({ isAuthorized: false });
-    const { result } = renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PUBLIC_AGENT,
-          viewerOrg: "consumer-org",
-        }),
-      { wrapper: wrapper(client) },
-    );
-
-    await waitFor(() =>
-      expect(
-        (client as { iamPolicy: { checkMyPermission: ReturnType<typeof vi.fn> } })
-          .iamPolicy.checkMyPermission,
-      ).toHaveBeenCalled(),
-    );
-    await waitFor(() => expect(result.current.action).toBeNull());
-  });
-
-  it("opens the cross-org dialog via the action", async () => {
-    const { result } = renderHook(
-      () =>
-        useCreateExternalShareLink({
-          agent: PUBLIC_AGENT,
-          viewerOrg: "consumer-org",
-        }),
-      { wrapper: wrapper(createMockStigmer({ isAuthorized: true })) },
-    );
-
-    await waitFor(() => expect(result.current.action).not.toBeNull());
-    expect(result.current.isOpen).toBe(false);
-
-    result.current.action?.onAction();
-    await waitFor(() => expect(result.current.isOpen).toBe(true));
-  });
-});

package/src/sharing/__tests__/useShareAgent.test.tsx

@@ -1,131 +0,0 @@
-import { describe, it, expect, vi, beforeAll, afterEach } from "vitest";
-import { renderHook, waitFor, cleanup } from "@testing-library/react";
-import type { ReactNode } from "react";
-import { StigmerContext } from "../../context";
-import { FetchCacheContext } from "../../internal/FetchCacheProvider";
-import { useShareAgent } from "../useShareAgent";
-
-// happy-dom does not implement the native dialog show/close methods.
-beforeAll(() => {
-  HTMLDialogElement.prototype.showModal = function showModal() {
-    this.open = true;
-  };
-  HTMLDialogElement.prototype.close = function close() {
-    this.open = false;
-  };
-});
-
-afterEach(cleanup);
-
-function createMockStigmer(overrides: {
-  isAuthorized?: boolean;
-  checkMyPermission?: (...args: unknown[]) => Promise<unknown>;
-} = {}) {
-  return {
-    iamPolicy: {
-      checkMyPermission:
-        overrides.checkMyPermission ??
-        vi.fn().mockResolvedValue({
-          isAuthorized: overrides.isAuthorized ?? true,
-        }),
-    },
-    agentShare: {
-      getByAgent: vi.fn().mockResolvedValue({ totalCount: 0, items: [] }),
-      apply: vi.fn().mockResolvedValue({}),
-      rotateShareLink: vi.fn().mockResolvedValue({}),
-    },
-    billing: { getOrCreateBillingAccount: vi.fn().mockResolvedValue(null) },
-  } 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",
-  },
-  spec: {},
-} as never;
-
-describe("useShareAgent", () => {
-  it("returns a Share action in the sharing group when the user can edit", async () => {
-    const { result } = renderHook(() => useShareAgent({ agent: AGENT }), {
-      wrapper: wrapper(createMockStigmer({ isAuthorized: true })),
-    });
-
-    await waitFor(() => expect(result.current.action).not.toBeNull());
-    expect(result.current.action?.id).toBe("share");
-    expect(result.current.action?.label).toBe("Share");
-    expect(result.current.action?.group).toBe("sharing");
-  });
-
-  it("returns a null action while the agent is loading", () => {
-    const checkMyPermission = vi.fn();
-    const { result } = renderHook(() => useShareAgent({ agent: null }), {
-      wrapper: wrapper(createMockStigmer({ checkMyPermission })),
-    });
-
-    expect(result.current.action).toBeNull();
-    expect(result.current.dialog).toBeNull();
-    expect(checkMyPermission).not.toHaveBeenCalled();
-  });
-
-  it("returns a null action when the user lacks can_edit", async () => {
-    const client = createMockStigmer({ isAuthorized: false });
-    const { result } = renderHook(() => useShareAgent({ agent: AGENT }), {
-      wrapper: wrapper(client),
-    });
-
-    await waitFor(() =>
-      expect(
-        (client as { iamPolicy: { checkMyPermission: ReturnType<typeof vi.fn> } })
-          .iamPolicy.checkMyPermission,
-      ).toHaveBeenCalled(),
-    );
-    await waitFor(() => expect(result.current.action).toBeNull());
-  });
-
-  it("checks the can_edit relation on the agent", async () => {
-    const client = createMockStigmer({ isAuthorized: true });
-    renderHook(() => useShareAgent({ agent: AGENT }), {
-      wrapper: wrapper(client),
-    });
-
-    const check = (
-      client as { iamPolicy: { checkMyPermission: ReturnType<typeof vi.fn> } }
-    ).iamPolicy.checkMyPermission;
-    await waitFor(() => expect(check).toHaveBeenCalled());
-    const input = check.mock.calls[0][0] as {
-      resource?: { kind: string; id: string };
-      relation: string;
-    };
-    expect(input.relation).toBe("can_edit");
-    expect(input.resource?.kind).toBe("agent");
-    expect(input.resource?.id).toBe("agt_1");
-  });
-
-  it("opens the dialog via the action", async () => {
-    const { result } = renderHook(() => useShareAgent({ agent: AGENT }), {
-      wrapper: wrapper(createMockStigmer({ isAuthorized: true })),
-    });
-
-    await waitFor(() => expect(result.current.action).not.toBeNull());
-    expect(result.current.isOpen).toBe(false);
-
-    result.current.action?.onAction();
-    await waitFor(() => expect(result.current.isOpen).toBe(true));
-  });
-});

package/src/sharing/useAgentShare.ts

@@ -1,105 +0,0 @@
-"use client";
-
-import { create } from "@bufbuild/protobuf";
-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 { GetAgentSharesByAgentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/io_pb";
-import { useStigmer } from "../hooks.js";
-import { useFetch } from "../internal/useFetch.js";
-
-/** 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;
-}
-
-/**
- * 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: readonly AgentShare[],
-  shareOrg: string,
-  agentSlug: string,
-): AgentShare | null {
-  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: Agent | null,
-  shareOrg?: string,
-): UseAgentShareReturn {
-  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 as AgentShare | null,
-  );
-
-  return { share, isLoading, isRefetching, error, refetch };
-}

package/src/sharing/useCreateExternalShareLink.tsx

@@ -1,141 +0,0 @@
-"use client";
-
-import { useCallback, useState, type ReactNode } from "react";
-import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
-import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
-import { useCheckPermission } from "../iam-policy/useCheckPermission.js";
-import type { DetailAction } from "../resource-detail/types.js";
-import { ShareAgentDialog } from "./ShareAgentDialog.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 function useCreateExternalShareLink({
-  agent,
-  viewerOrg,
-  buildShareUrl,
-  onSharingChanged,
-  label = "Create share link",
-}: UseCreateExternalShareLinkArgs): UseCreateExternalShareLinkReturn {
-  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: DetailAction | null = applicable
-    ? { id: "create-share-link", label, group: "sharing", onAction: open }
-    : null;
-
-  const dialog =
-    agent && applicable ? (
-      <ShareAgentDialog
-        open={isOpen}
-        onOpenChange={setIsOpen}
-        agent={agent}
-        shareOrg={viewerOrg}
-        buildShareUrl={buildShareUrl}
-        onSharingChanged={onSharingChanged}
-      />
-    ) : null;
-
-  return { action, dialog, open, isOpen };
-}

package/src/sharing/useShareAgent.tsx

@@ -1,107 +0,0 @@
-"use client";
-
-import { useCallback, useState, type ReactNode } from "react";
-import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
-import { useCheckPermission } from "../iam-policy/useCheckPermission.js";
-import type { DetailAction } from "../resource-detail/types.js";
-import { ShareAgentDialog } from "./ShareAgentDialog.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 function useShareAgent({
-  agent,
-  buildShareUrl,
-  onSharingChanged,
-  label = "Share",
-}: UseShareAgentArgs): UseShareAgentReturn {
-  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: DetailAction | null =
-    agent && canEdit
-      ? { id: "share", label, group: "sharing", onAction: open }
-      : null;
-
-  const dialog = agent ? (
-    <ShareAgentDialog
-      open={isOpen}
-      onOpenChange={setIsOpen}
-      agent={agent}
-      buildShareUrl={buildShareUrl}
-      onSharingChanged={onSharingChanged}
-    />
-  ) : null;
-
-  return { action, dialog, open, isOpen };
-}