@opengeni/react 3.1.0 → 3.1.2

package/dist/chunk-3PVDYTTB.js

@@ -0,0 +1,24 @@
+"use client";
+
+// src/timeline/tool-display-name.ts
+function mcpToolLeaf(name) {
+  const boundary = name.indexOf("__");
+  return boundary >= 0 ? name.slice(boundary + 2) : name;
+}
+function toolMatchesLeaf(wireName, leaf) {
+  return wireName === leaf || wireName.endsWith(`__${leaf}`);
+}
+function toolDisplayName(name, display) {
+  if (!display && /^[a-f0-9]{64}$/.test(name)) return "Tool call";
+  const phrase = (display?.toolName ?? mcpToolLeaf(name)).replace(/[_-]+/g, " ").trim().replace(/^batch\s+(?=\S)/i, "");
+  const title = display?.title ?? (phrase ? phrase.charAt(0).toUpperCase() + phrase.slice(1) : name);
+  if (!display?.connector) return title;
+  return display.accountLabel ? `${title} \xB7 ${display.accountLabel}` : title;
+}
+
+export {
+  mcpToolLeaf,
+  toolMatchesLeaf,
+  toolDisplayName
+};
+//# sourceMappingURL=chunk-3PVDYTTB.js.map

package/dist/chunk-3PVDYTTB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timeline/tool-display-name.ts"],"sourcesContent":["/**\n * MCP / first-party tool naming helpers.\n *\n * Wire names are often `<serverId>__<toolName>` (see prefixedMcpToolName).\n * Matching and titles must use the leaf tool name so `opengeni__session_create`\n * and bare `session_create` resolve the same UI — without inventing previews\n * from argument JSON.\n */\n\nimport type { ToolDisplayMetadata } from \"@opengeni/sdk\";\n\n/** Leaf tool name after the first `__` server boundary (or the whole name). */\nexport function mcpToolLeaf(name: string): string {\n  const boundary = name.indexOf(\"__\");\n  return boundary >= 0 ? name.slice(boundary + 2) : name;\n}\n\n/**\n * True when `wireName` is exactly `leaf` or ends with `__${leaf}` (MCP prefix).\n * Does not treat arbitrary suffixes as matches — the leaf must be the full\n * right-hand side after `__`.\n */\nexport function toolMatchesLeaf(wireName: string, leaf: string): boolean {\n  return wireName === leaf || wireName.endsWith(`__${leaf}`);\n}\n\n/**\n * Readable label for a tool call (\"session_create\" / \"opengeni__session_create\"\n * → \"Session create\"). Title-cases the first character of the leaf phrase. A\n * connector account is named only when the connector has several (\"List\n * issues · alice@example.com\"); the connector itself shows as its logo.\n */\nexport function toolDisplayName(name: string, display?: ToolDisplayMetadata): string {\n  if (!display && /^[a-f0-9]{64}$/.test(name)) return \"Tool call\";\n  // \"batch modify messages\" → \"Modify messages\": batching is transport, not the action.\n  const phrase = (display?.toolName ?? mcpToolLeaf(name))\n    .replace(/[_-]+/g, \" \")\n    .trim()\n    .replace(/^batch\\s+(?=\\S)/i, \"\");\n  const title =\n    display?.title ?? (phrase ? phrase.charAt(0).toUpperCase() + phrase.slice(1) : name);\n  // Older events carry the full \"Connector — Personal: account · Only me\" route\n  // label for every account route without saying whether there were several.\n  // The tool name alone reads better than that.\n  if (!display?.connector) return title;\n  return display.accountLabel ? `${title} · ${display.accountLabel}` : title;\n}\n"],"mappings":";;;AAYO,SAAS,YAAY,MAAsB;AAChD,QAAM,WAAW,KAAK,QAAQ,IAAI;AAClC,SAAO,YAAY,IAAI,KAAK,MAAM,WAAW,CAAC,IAAI;AACpD;AAOO,SAAS,gBAAgB,UAAkB,MAAuB;AACvE,SAAO,aAAa,QAAQ,SAAS,SAAS,KAAK,IAAI,EAAE;AAC3D;AAQO,SAAS,gBAAgB,MAAc,SAAuC;AACnF,MAAI,CAAC,WAAW,iBAAiB,KAAK,IAAI,EAAG,QAAO;AAEpD,QAAM,UAAU,SAAS,YAAY,YAAY,IAAI,GAClD,QAAQ,UAAU,GAAG,EACrB,KAAK,EACL,QAAQ,oBAAoB,EAAE;AACjC,QAAM,QACJ,SAAS,UAAU,SAAS,OAAO,OAAO,CAAC,EAAE,YAAY,IAAI,OAAO,MAAM,CAAC,IAAI;AAIjF,MAAI,CAAC,SAAS,UAAW,QAAO;AAChC,SAAO,QAAQ,eAAe,GAAG,KAAK,SAAM,QAAQ,YAAY,KAAK;AACvE;","names":[]}

package/dist/chunk-3UZCWK46.js

@@ -0,0 +1,298 @@
+"use client";
+import {
+  useDebouncedCallback,
+  useMutationRunner,
+  usePolledValue,
+  useSessionEventTrigger
+} from "./chunk-QHUE7E4N.js";
+import {
+  useEmbeddedSessionLineage,
+  useEmbeddedSessionMcpApprovalPolicy
+} from "./chunk-G76LSA76.js";
+
+// src/embedded-session-client.ts
+var requiredMethods = [
+  "getSession",
+  "listEvents",
+  "streamEvents",
+  "getComposerDraft",
+  "saveComposerDraft",
+  "submitComposerDraft",
+  "sendMessage",
+  "steerMessage",
+  "getQueue",
+  "moveQueueItem",
+  "editQueueItem",
+  "steerQueueItem",
+  "deleteQueueItem",
+  "pauseSession",
+  "resumeSession",
+  "sendApprovalDecision"
+];
+function createEmbeddedSessionClient(base, options = {}) {
+  const overrides = options.overrides ?? {};
+  const client = {};
+  for (const key of requiredMethods) {
+    const override = overrides[key];
+    const method = override ?? base[key];
+    if (typeof method !== "function") {
+      throw new TypeError(`Embedded session client method is required: ${key}`);
+    }
+    client[key] = method.bind(override === void 0 ? base : overrides);
+  }
+  const inferenceOverride = overrides.setWorkspaceInferenceState;
+  const inferenceBase = base.setWorkspaceInferenceState;
+  const inferenceMethod = inferenceOverride ?? inferenceBase;
+  if (typeof inferenceMethod === "function") {
+    client.setWorkspaceInferenceState = inferenceMethod.bind(
+      inferenceOverride === void 0 ? base : overrides
+    );
+  }
+  const mapDraft = options.mapComposerDraft;
+  if (!mapDraft) return client;
+  const getComposerDraft = client.getComposerDraft;
+  client.getComposerDraft = async (workspaceId, sessionId) => mapDraft(await getComposerDraft(workspaceId, sessionId), {
+    operation: "read",
+    workspaceId,
+    sessionId
+  });
+  const saveComposerDraft = client.saveComposerDraft;
+  client.saveComposerDraft = async (workspaceId, sessionId, request) => mapDraft(await saveComposerDraft(workspaceId, sessionId, request), {
+    operation: "save",
+    workspaceId,
+    sessionId
+  });
+  const submitComposerDraft = client.submitComposerDraft;
+  client.submitComposerDraft = async (workspaceId, sessionId, request) => {
+    const response = await submitComposerDraft(workspaceId, sessionId, request);
+    return {
+      ...response,
+      draft: mapDraft(response.draft, {
+        operation: "submit",
+        workspaceId,
+        sessionId
+      })
+    };
+  };
+  return client;
+}
+
+// src/hooks/use-session-mcp-approval-policy.ts
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+function isSessionMcpApprovalPolicyEvent(event, serverId) {
+  if (event.type !== "session.mcp.approval_policy.updated") {
+    return false;
+  }
+  if (serverId === void 0) {
+    return true;
+  }
+  const payload = event.payload;
+  return payload?.serverId === serverId;
+}
+function useSessionMcpApprovalPolicy(sessionId, serverId, options = {}) {
+  const { client, workspaceId } = useEmbeddedSessionMcpApprovalPolicy(options);
+  const enabled = (options.enabled ?? true) && Boolean(sessionId && serverId);
+  const [override, setOverride] = useState(null);
+  const targetKey = `${workspaceId}\0${sessionId ?? ""}\0${serverId ?? ""}`;
+  const authoritativeGeneration = useRef(0);
+  const mutationIdentity = useMemo(() => ({ client, targetKey }), [client, targetKey]);
+  const { run, mutating, mutationError, clearMutationError } = useMutationRunner(mutationIdentity);
+  useLayoutEffect(() => {
+    authoritativeGeneration.current += 1;
+    setOverride(null);
+  }, [client, targetKey]);
+  const load = useCallback(async () => {
+    const generation = authoritativeGeneration.current;
+    if (!sessionId || !serverId) {
+      return { targetKey, generation, server: null };
+    }
+    const session = await client.getSession(workspaceId, sessionId);
+    return {
+      targetKey,
+      generation,
+      server: session.mcpServers.find((server2) => server2.id === serverId) ?? (session.mcpApprovalPolicies && Object.hasOwn(session.mcpApprovalPolicies, serverId) ? {
+        id: serverId,
+        source: "workspace",
+        requireApproval: session.mcpApprovalPolicies[serverId]
+      } : null)
+    };
+  }, [client, serverId, sessionId, targetKey, workspaceId]);
+  const {
+    data,
+    loading,
+    error: loadError,
+    refresh
+  } = usePolledValue(load, {
+    enabled,
+    pollIntervalMs: options.pollIntervalMs
+  });
+  useEffect(() => {
+    if (data?.targetKey === targetKey && data.generation === authoritativeGeneration.current) {
+      setOverride(null);
+    }
+  }, [data, targetKey]);
+  const scheduleRefresh = useDebouncedCallback(() => void refresh());
+  const matchesPolicyEvent = useCallback(
+    (event) => isSessionMcpApprovalPolicyEvent(event, serverId ?? void 0),
+    [serverId]
+  );
+  useSessionEventTrigger(
+    client,
+    workspaceId,
+    sessionId,
+    matchesPolicyEvent,
+    scheduleRefresh,
+    {
+      enabled,
+      ...options.events !== void 0 ? { events: options.events } : {}
+    },
+    async () => await refresh()
+  );
+  const update = useCallback(
+    async (policy) => {
+      if (!sessionId || !serverId) {
+        return null;
+      }
+      const response = await run(
+        () => client.updateSessionMcpApprovalPolicy(workspaceId, sessionId, serverId, {
+          requireApproval: policy
+        })
+      );
+      if (response) {
+        authoritativeGeneration.current += 1;
+        setOverride(response.server);
+        void refresh();
+      }
+      return response;
+    },
+    [client, refresh, run, serverId, sessionId, workspaceId]
+  );
+  const server = override ?? data?.server ?? null;
+  return {
+    server,
+    policy: server?.requireApproval ?? null,
+    loading,
+    error: mutationError ?? loadError,
+    refresh: async () => {
+      await refresh();
+    },
+    update,
+    updating: mutating,
+    clearError: clearMutationError
+  };
+}
+
+// src/hooks/use-session-lineage.ts
+import { useCallback as useCallback2, useEffect as useEffect2, useRef as useRef2 } from "react";
+function isLineageRefreshEvent(event) {
+  if (event.type === "session.status.changed" || event.type === "session.created") {
+    return true;
+  }
+  if (event.type === "agent.toolCall.output") {
+    const payload = event.payload;
+    const name = typeof payload?.name === "string" ? payload.name : typeof payload?.toolName === "string" ? payload.toolName : "";
+    return name === "session_create" || name.endsWith("__session_create");
+  }
+  return false;
+}
+function isSessionCreateToolCallCreated(event) {
+  if (event.type !== "agent.toolCall.created") {
+    return false;
+  }
+  const payload = event.payload;
+  const name = typeof payload?.name === "string" ? payload.name : typeof payload?.toolName === "string" ? payload.toolName : "";
+  return name === "session_create" || name.endsWith("__session_create");
+}
+function useSessionLineage(sessionId, options = {}) {
+  const { client, workspaceId, workspaceControlEvent, registerSessionReconciler } = useEmbeddedSessionLineage(options);
+  const enabled = (options.enabled ?? true) && Boolean(sessionId);
+  const nextReadGeneration = useRef2(0);
+  const beginRead = options.beginRead;
+  const load = useCallback2(
+    async (signal) => {
+      if (!sessionId) {
+        return {
+          lineage: { ancestors: [], children: [], truncated: false },
+          readGeneration: 0
+        };
+      }
+      let readGeneration = 0;
+      const lineage = await client.getSessionLineage(workspaceId, sessionId, {
+        signal,
+        onRequestStart: (sharedReadGeneration) => {
+          readGeneration = sharedReadGeneration ?? beginRead?.() ?? ++nextReadGeneration.current;
+        }
+      });
+      return {
+        lineage,
+        readGeneration
+      };
+    },
+    [beginRead, client, workspaceId, sessionId]
+  );
+  const state = usePolledValue(load, { pollIntervalMs: options.pollIntervalMs, enabled });
+  const refresh = state.refresh;
+  useEffect2(() => {
+    if (enabled && workspaceControlEvent) void refresh();
+  }, [enabled, refresh, workspaceControlEvent]);
+  useEffect2(() => {
+    if (!sessionId || !enabled) return;
+    return registerSessionReconciler(sessionId, "lineage", refresh);
+  }, [enabled, refresh, registerSessionReconciler, sessionId]);
+  const refreshSoon = useDebouncedCallback(() => void refresh(), 150);
+  const delayedChildRefreshRef = useRef2(null);
+  useEffect2(() => {
+    return () => {
+      if (delayedChildRefreshRef.current !== null) {
+        clearTimeout(delayedChildRefreshRef.current);
+        delayedChildRefreshRef.current = null;
+      }
+    };
+  }, [sessionId, workspaceId]);
+  const refreshAfterChildCreate = useCallback2(() => {
+    void refresh();
+    if (delayedChildRefreshRef.current !== null) {
+      clearTimeout(delayedChildRefreshRef.current);
+    }
+    delayedChildRefreshRef.current = setTimeout(() => {
+      delayedChildRefreshRef.current = null;
+      void refresh();
+    }, 2500);
+  }, [refresh]);
+  useSessionEventTrigger(
+    client,
+    workspaceId,
+    sessionId,
+    isLineageRefreshEvent,
+    refreshSoon,
+    // SHARED-FEED ONLY: without a caller-provided events log the trigger would
+    // open its OWN streamEvents tail — a second live SSE connection next to the
+    // session route's useSessionEvents. A caller with no feed opts into polling
+    // (pollIntervalMs), never a duplicate stream.
+    { events: options.events, enabled: enabled && options.events !== void 0 }
+  );
+  useSessionEventTrigger(
+    client,
+    workspaceId,
+    sessionId,
+    isSessionCreateToolCallCreated,
+    refreshAfterChildCreate,
+    { events: options.events, enabled: enabled && options.events !== void 0 }
+  );
+  return {
+    lineage: state.data?.lineage ?? null,
+    loading: state.loading,
+    error: state.error,
+    readGeneration: state.data?.readGeneration ?? 0,
+    refresh
+  };
+}
+
+export {
+  createEmbeddedSessionClient,
+  isSessionMcpApprovalPolicyEvent,
+  useSessionMcpApprovalPolicy,
+  isLineageRefreshEvent,
+  useSessionLineage
+};
+//# sourceMappingURL=chunk-3UZCWK46.js.map

package/dist/chunk-3UZCWK46.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embedded-session-client.ts","../src/hooks/use-session-mcp-approval-policy.ts","../src/hooks/use-session-lineage.ts"],"sourcesContent":["import type { ComposerDraft } from \"@opengeni/sdk\";\nimport type { EmbeddedSessionClientLike } from \"./client\";\n\nexport type ComposerDraftMapContext = {\n  operation: \"read\" | \"save\" | \"submit\";\n  workspaceId: string;\n  sessionId: string;\n};\n\nexport type CreateEmbeddedSessionClientOptions = {\n  /**\n   * Explicit host-owned method replacements. Methods inherited from `base`\n   * retain `base` as their receiver; overrides retain this object as theirs.\n   */\n  overrides?: Partial<EmbeddedSessionClientLike> | undefined;\n  /** Presentation/policy projection for every draft entering the React layer. */\n  mapComposerDraft?:\n    | ((draft: ComposerDraft, context: ComposerDraftMapContext) => ComposerDraft)\n    | undefined;\n};\n\nconst requiredMethods = [\n  \"getSession\",\n  \"listEvents\",\n  \"streamEvents\",\n  \"getComposerDraft\",\n  \"saveComposerDraft\",\n  \"submitComposerDraft\",\n  \"sendMessage\",\n  \"steerMessage\",\n  \"getQueue\",\n  \"moveQueueItem\",\n  \"editQueueItem\",\n  \"steerQueueItem\",\n  \"deleteQueueItem\",\n  \"pauseSession\",\n  \"resumeSession\",\n  \"sendApprovalDecision\",\n] as const satisfies readonly (keyof EmbeddedSessionClientLike)[];\n\n/**\n * Build the exact client required by `@opengeni/react/session` from a full SDK\n * client or host proxy. The constructor binds every delegated method once,\n * supports a host-owned atomic composer-submit override, and fails at creation\n * time instead of waiting for a missing method to be exercised by a hook.\n */\nexport function createEmbeddedSessionClient(\n  base: EmbeddedSessionClientLike,\n  options: CreateEmbeddedSessionClientOptions = {},\n): EmbeddedSessionClientLike {\n  const overrides = options.overrides ?? {};\n  const client = {} as EmbeddedSessionClientLike;\n  for (const key of requiredMethods) {\n    const override = overrides[key];\n    const method = override ?? base[key];\n    if (typeof method !== \"function\") {\n      throw new TypeError(`Embedded session client method is required: ${key}`);\n    }\n    client[key] = method.bind(override === undefined ? base : overrides) as never;\n  }\n\n  const inferenceOverride = overrides.setWorkspaceInferenceState;\n  const inferenceBase = base.setWorkspaceInferenceState;\n  const inferenceMethod = inferenceOverride ?? inferenceBase;\n  if (typeof inferenceMethod === \"function\") {\n    client.setWorkspaceInferenceState = inferenceMethod.bind(\n      inferenceOverride === undefined ? base : overrides,\n    );\n  }\n\n  const mapDraft = options.mapComposerDraft;\n  if (!mapDraft) return client;\n\n  const getComposerDraft = client.getComposerDraft;\n  client.getComposerDraft = async (workspaceId, sessionId) =>\n    mapDraft(await getComposerDraft(workspaceId, sessionId), {\n      operation: \"read\",\n      workspaceId,\n      sessionId,\n    });\n\n  const saveComposerDraft = client.saveComposerDraft;\n  client.saveComposerDraft = async (workspaceId, sessionId, request) =>\n    mapDraft(await saveComposerDraft(workspaceId, sessionId, request), {\n      operation: \"save\",\n      workspaceId,\n      sessionId,\n    });\n\n  const submitComposerDraft = client.submitComposerDraft;\n  client.submitComposerDraft = async (workspaceId, sessionId, request) => {\n    const response = await submitComposerDraft(workspaceId, sessionId, request);\n    return {\n      ...response,\n      draft: mapDraft(response.draft, {\n        operation: \"submit\",\n        workspaceId,\n        sessionId,\n      }),\n    };\n  };\n\n  return client;\n}\n","import type {\n  SessionEvent,\n  SessionMcpApprovalPolicy,\n  SessionMcpApprovalPolicyTarget,\n  UpdateSessionMcpApprovalPolicyResponse,\n} from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  useEmbeddedSessionMcpApprovalPolicy,\n  type EmbeddedSessionMcpApprovalPolicyClientOverride,\n} from \"../session-context\";\nimport {\n  useDebouncedCallback,\n  useMutationRunner,\n  usePolledValue,\n  useSessionEventTrigger,\n  type SessionEventFeedOptions,\n} from \"./internal\";\n\nexport function isSessionMcpApprovalPolicyEvent(\n  event: Pick<SessionEvent, \"type\" | \"payload\">,\n  serverId?: string,\n): boolean {\n  if (event.type !== \"session.mcp.approval_policy.updated\") {\n    return false;\n  }\n  if (serverId === undefined) {\n    return true;\n  }\n  const payload = event.payload as { serverId?: unknown } | null;\n  return payload?.serverId === serverId;\n}\n\nexport type UseSessionMcpApprovalPolicyOptions = EmbeddedSessionMcpApprovalPolicyClientOverride &\n  SessionEventFeedOptions & {\n    /** Optional safety-net polling (ms). Off by default; policy events drive refreshes. */\n    pollIntervalMs?: number | undefined;\n  };\n\nexport type UseSessionMcpApprovalPolicyResult = {\n  server: SessionMcpApprovalPolicyTarget | null;\n  policy: SessionMcpApprovalPolicy | null;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n  update: (\n    policy: SessionMcpApprovalPolicy,\n  ) => Promise<UpdateSessionMcpApprovalPolicyResponse | null>;\n  updating: boolean;\n  clearError: () => void;\n};\n\n/**\n * Read and update one existing session MCP server's approval policy. Updates\n * become effective for the next claimed attempt; current work is unchanged.\n */\nexport function useSessionMcpApprovalPolicy(\n  sessionId: string | null | undefined,\n  serverId: string | null | undefined,\n  options: UseSessionMcpApprovalPolicyOptions = {},\n): UseSessionMcpApprovalPolicyResult {\n  const { client, workspaceId } = useEmbeddedSessionMcpApprovalPolicy(options);\n  const enabled = (options.enabled ?? true) && Boolean(sessionId && serverId);\n  const [override, setOverride] = useState<SessionMcpApprovalPolicyTarget | null>(null);\n  const targetKey = `${workspaceId}\\u0000${sessionId ?? \"\"}\\u0000${serverId ?? \"\"}`;\n  const authoritativeGeneration = useRef(0);\n  const mutationIdentity = useMemo(() => ({ client, targetKey }), [client, targetKey]);\n  const { run, mutating, mutationError, clearMutationError } = useMutationRunner(mutationIdentity);\n\n  useLayoutEffect(() => {\n    authoritativeGeneration.current += 1;\n    setOverride(null);\n  }, [client, targetKey]);\n\n  type PolicyRead = {\n    targetKey: string;\n    generation: number;\n    server: SessionMcpApprovalPolicyTarget | null;\n  };\n  const load = useCallback(async (): Promise<PolicyRead> => {\n    const generation = authoritativeGeneration.current;\n    if (!sessionId || !serverId) {\n      return { targetKey, generation, server: null };\n    }\n    const session = await client.getSession(workspaceId, sessionId);\n    return {\n      targetKey,\n      generation,\n      server:\n        session.mcpServers.find((server) => server.id === serverId) ??\n        (session.mcpApprovalPolicies && Object.hasOwn(session.mcpApprovalPolicies, serverId)\n          ? {\n              id: serverId,\n              source: \"workspace\",\n              requireApproval: session.mcpApprovalPolicies[serverId]!,\n            }\n          : null),\n    };\n  }, [client, serverId, sessionId, targetKey, workspaceId]);\n  const {\n    data,\n    loading,\n    error: loadError,\n    refresh,\n  } = usePolledValue(load, {\n    enabled,\n    pollIntervalMs: options.pollIntervalMs,\n  });\n  useEffect(() => {\n    if (data?.targetKey === targetKey && data.generation === authoritativeGeneration.current) {\n      setOverride(null);\n    }\n  }, [data, targetKey]);\n\n  const scheduleRefresh = useDebouncedCallback(() => void refresh());\n  const matchesPolicyEvent = useCallback(\n    (event: Pick<SessionEvent, \"type\" | \"payload\">) =>\n      isSessionMcpApprovalPolicyEvent(event, serverId ?? undefined),\n    [serverId],\n  );\n  useSessionEventTrigger(\n    client,\n    workspaceId,\n    sessionId,\n    matchesPolicyEvent,\n    scheduleRefresh,\n    {\n      enabled,\n      ...(options.events !== undefined ? { events: options.events } : {}),\n    },\n    async () => await refresh(),\n  );\n\n  const update = useCallback(\n    async (\n      policy: SessionMcpApprovalPolicy,\n    ): Promise<UpdateSessionMcpApprovalPolicyResponse | null> => {\n      if (!sessionId || !serverId) {\n        return null;\n      }\n      const response = await run(() =>\n        client.updateSessionMcpApprovalPolicy(workspaceId, sessionId, serverId, {\n          requireApproval: policy,\n        }),\n      );\n      if (response) {\n        authoritativeGeneration.current += 1;\n        setOverride(response.server);\n        void refresh();\n      }\n      return response;\n    },\n    [client, refresh, run, serverId, sessionId, workspaceId],\n  );\n\n  const server = override ?? data?.server ?? null;\n  return {\n    server,\n    policy: server?.requireApproval ?? null,\n    loading,\n    error: mutationError ?? loadError,\n    refresh: async () => {\n      await refresh();\n    },\n    update,\n    updating: mutating,\n    clearError: clearMutationError,\n  };\n}\n","import type { SessionEvent, SessionLineageResponse } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport {\n  useEmbeddedSessionLineage,\n  type EmbeddedSessionLineageClientOverride,\n} from \"../session-context\";\nimport { useDebouncedCallback, usePolledValue, useSessionEventTrigger } from \"./internal\";\n\nexport type UseSessionLineageOptions = EmbeddedSessionLineageClientOverride & {\n  events?: SessionEvent[] | undefined;\n  /** Refresh interval (ms). Off by default. */\n  pollIntervalMs?: number | undefined;\n  enabled?: boolean | undefined;\n  /** Optional shared causal clock invoked when each network read starts. */\n  beginRead?: (() => number) | undefined;\n};\n\nexport type UseSessionLineageResult = {\n  lineage: SessionLineageResponse | null;\n  loading: boolean;\n  error: Error | null;\n  /** Causal generation captured when the accepted lineage read started. */\n  readGeneration: number;\n  refresh: () => Promise<void>;\n};\n\nexport function isLineageRefreshEvent(event: SessionEvent): boolean {\n  if (event.type === \"session.status.changed\" || event.type === \"session.created\") {\n    return true;\n  }\n  // A child's creation never appears on the PARENT's stream as session.created —\n  // the parent sees its own spawn as an agent.toolCall.* for session_create.\n  // Created events are handled separately so they can refresh immediately and\n  // once after the child row has had time to commit.\n  if (event.type === \"agent.toolCall.output\") {\n    const payload = event.payload as { name?: unknown; toolName?: unknown } | null | undefined;\n    const name =\n      typeof payload?.name === \"string\"\n        ? payload.name\n        : typeof payload?.toolName === \"string\"\n          ? payload.toolName\n          : \"\";\n    return name === \"session_create\" || name.endsWith(\"__session_create\");\n  }\n  return false;\n}\n\nfunction isSessionCreateToolCallCreated(event: SessionEvent): boolean {\n  if (event.type !== \"agent.toolCall.created\") {\n    return false;\n  }\n  const payload = event.payload as { name?: unknown; toolName?: unknown } | null | undefined;\n  const name =\n    typeof payload?.name === \"string\"\n      ? payload.name\n      : typeof payload?.toolName === \"string\"\n        ? payload.toolName\n        : \"\";\n  return name === \"session_create\" || name.endsWith(\"__session_create\");\n}\n\n/** Read the ancestors + descendant tree for one session. Data-only; no UI state. */\nexport function useSessionLineage(\n  sessionId: string | null | undefined,\n  options: UseSessionLineageOptions = {},\n): UseSessionLineageResult {\n  const { client, workspaceId, workspaceControlEvent, registerSessionReconciler } =\n    useEmbeddedSessionLineage(options);\n  const enabled = (options.enabled ?? true) && Boolean(sessionId);\n  const nextReadGeneration = useRef(0);\n  const beginRead = options.beginRead;\n  const load = useCallback(\n    async (signal?: AbortSignal) => {\n      if (!sessionId) {\n        return {\n          lineage: { ancestors: [], children: [], truncated: false },\n          readGeneration: 0,\n        };\n      }\n      let readGeneration = 0;\n      const lineage = await client.getSessionLineage(workspaceId, sessionId, {\n        signal,\n        onRequestStart: (sharedReadGeneration) => {\n          readGeneration = sharedReadGeneration ?? beginRead?.() ?? ++nextReadGeneration.current;\n        },\n      });\n      return {\n        lineage,\n        readGeneration,\n      };\n    },\n    [beginRead, client, workspaceId, sessionId],\n  );\n  const state = usePolledValue(load, { pollIntervalMs: options.pollIntervalMs, enabled });\n  const refresh = state.refresh;\n  useEffect(() => {\n    if (enabled && workspaceControlEvent) void refresh();\n  }, [enabled, refresh, workspaceControlEvent]);\n  useEffect(() => {\n    if (!sessionId || !enabled) return;\n    return registerSessionReconciler(sessionId, \"lineage\", refresh);\n  }, [enabled, refresh, registerSessionReconciler, sessionId]);\n  const refreshSoon = useDebouncedCallback(() => void refresh(), 150);\n  const delayedChildRefreshRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  // Clear a pending delayed refresh on session/workspace SWITCH (not just\n  // unmount): otherwise a timer scheduled for the previous session can fire\n  // ~2.5s later and commit that session's lineage onto the new one.\n  useEffect(() => {\n    return () => {\n      if (delayedChildRefreshRef.current !== null) {\n        clearTimeout(delayedChildRefreshRef.current);\n        delayedChildRefreshRef.current = null;\n      }\n    };\n  }, [sessionId, workspaceId]);\n  const refreshAfterChildCreate = useCallback(() => {\n    void refresh();\n    if (delayedChildRefreshRef.current !== null) {\n      clearTimeout(delayedChildRefreshRef.current);\n    }\n    delayedChildRefreshRef.current = setTimeout(() => {\n      delayedChildRefreshRef.current = null;\n      void refresh();\n    }, 2500);\n  }, [refresh]);\n  useSessionEventTrigger(\n    client,\n    workspaceId,\n    sessionId,\n    isLineageRefreshEvent,\n    refreshSoon,\n    // SHARED-FEED ONLY: without a caller-provided events log the trigger would\n    // open its OWN streamEvents tail — a second live SSE connection next to the\n    // session route's useSessionEvents. A caller with no feed opts into polling\n    // (pollIntervalMs), never a duplicate stream.\n    { events: options.events, enabled: enabled && options.events !== undefined },\n  );\n  useSessionEventTrigger(\n    client,\n    workspaceId,\n    sessionId,\n    isSessionCreateToolCallCreated,\n    refreshAfterChildCreate,\n    { events: options.events, enabled: enabled && options.events !== undefined },\n  );\n  return {\n    lineage: state.data?.lineage ?? null,\n    loading: state.loading,\n    error: state.error,\n    readGeneration: state.data?.readGeneration ?? 0,\n    refresh,\n  };\n}\n"],"mappings":"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","names":["server","useCallback","useEffect","useRef","useRef","useCallback","useEffect"]}