@stigmer/react 3.1.12 → 3.1.14

package/sharing/useAgentShare.d.ts

@@ -1,43 +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.
- *
- * Pass `null` for `agent` to skip fetching (stable no-op) — useful
- * while the agent is still loading. A resolved `null` share means the
- * agent has never been shared; the first save creates the share.
- *
- * @example
- * ```tsx
- * const { share, isLoading } = useAgentShare(agent);
- *
- * if (isLoading) return <Spinner />;
- * const enabled = share?.spec?.enabled ?? false;
- * ```
- */
-export declare function useAgentShare(agent: Agent | null): UseAgentShareReturn;
-//# sourceMappingURL=useAgentShare.d.ts.map

package/sharing/useAgentShare.d.ts.map

@@ -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;AAqBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,mBAAmB,CAsBtE"}

package/sharing/useAgentShare.js

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

package/sharing/useAgentShare.js.map

@@ -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;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,MAA6B,EAC7B,SAAiB;IAEjB,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC;QACT,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAE9C,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAChD,MAAM,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,CAAC,CACxD,CAAC;YACF,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACvE,OAAO,EACP,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAC7B,IAAyB,CAC1B,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC"}

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

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