@opengeni/react 0.29.0 → 0.32.1

package/dist/approvals.d.ts

@@ -0,0 +1,14 @@
+import type { SessionEvent } from "@opengeni/sdk";
+export type PendingApproval = {
+    /** The id to send back via `user.approvalDecision` (`approvalId`). */
+    id: string;
+    /** Tool/function name awaiting the decision. */
+    name: string;
+    arguments?: unknown;
+    /** The raw approval entry from the `session.requiresAction` payload. */
+    raw?: unknown;
+};
+/** The approvals carried by one `session.requiresAction` payload. */
+export declare function approvalsFromRequiresAction(payload: unknown): PendingApproval[];
+/** The approvals still awaiting a decision after replaying `events` in order. */
+export declare function projectPendingApprovals(events: SessionEvent[]): PendingApproval[];

package/dist/{chunk-M7X4JZOD.js → chunk-4QOQ2DSR.js}

@@ -1,4 +1,5 @@
 // src/lib/format.ts
+import { OpenGeniApiError } from "@opengeni/sdk";
 function formatRelativeTime(iso, now = /* @__PURE__ */ new Date()) {
   const then = new Date(iso).getTime();
   if (Number.isNaN(then)) {
@@ -75,6 +76,10 @@ function tryParseJson(text) {
   }
 }
 var CREDIT_EXHAUSTION_MESSAGE = "Out of OpenGeni credits \u2014 this workspace's balance is empty. Add credits to continue; the conversation is preserved.";
+var COMPOSER_PAYMENT_REQUIRED_MESSAGE = "This turn requires OpenGeni managed credits, but the account balance is empty. Add credits or choose a connected Codex subscription model, then retry. Your draft and attachments are preserved.";
+function composerSubmissionErrorMessage(error) {
+  return error instanceof OpenGeniApiError && error.status === 402 && error.code === "payment_required" ? COMPOSER_PAYMENT_REQUIRED_MESSAGE : error.message;
+}
 function isCreditExhaustion(input) {
   if (typeof input === "string") {
     return input.toLowerCase().includes("insufficient opengeni credits");
@@ -115,7 +120,9 @@ export {
   stringifyPayload,
   tryParseJson,
   CREDIT_EXHAUSTION_MESSAGE,
+  COMPOSER_PAYMENT_REQUIRED_MESSAGE,
+  composerSubmissionErrorMessage,
   isCreditExhaustion,
   humanizeFailureReason
 };
-//# sourceMappingURL=chunk-M7X4JZOD.js.map
+//# sourceMappingURL=chunk-4QOQ2DSR.js.map

package/dist/chunk-4QOQ2DSR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/format.ts"],"sourcesContent":["import { OpenGeniApiError } from \"@opengeni/sdk\";\n\n/** Compact relative time: \"now\", \"42s\", \"7m\", \"3h\", \"2d\", then a date. */\nexport function formatRelativeTime(iso: string, now: Date = new Date()): string {\n  const then = new Date(iso).getTime();\n  if (Number.isNaN(then)) {\n    return \"\";\n  }\n  const seconds = Math.max(0, Math.floor((now.getTime() - then) / 1000));\n  if (seconds < 10) {\n    return \"now\";\n  }\n  if (seconds < 60) {\n    return `${seconds}s`;\n  }\n  const minutes = Math.floor(seconds / 60);\n  if (minutes < 60) {\n    return `${minutes}m`;\n  }\n  const hours = Math.floor(minutes / 60);\n  if (hours < 24) {\n    return `${hours}h`;\n  }\n  const days = Math.floor(hours / 24);\n  if (days < 14) {\n    return `${days}d`;\n  }\n  return new Date(iso).toLocaleDateString();\n}\n\n/** Human-readable byte size: \"512 B\", \"8.0 KB\", \"1.4 MB\", \"3 GB\". */\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) {\n    return `${bytes} B`;\n  }\n  const units = [\"KB\", \"MB\", \"GB\"] as const;\n  let value = bytes / 1024;\n  for (const unit of units) {\n    if (value < 1024 || unit === \"GB\") {\n      return `${value.toFixed(value < 10 ? 1 : 0)} ${unit}`;\n    }\n    value /= 1024;\n  }\n  return `${bytes} B`;\n}\n\n/** Single-line preview of arbitrary text, for tiles and collapsed rows. */\nexport function truncate(text: string, maxLength: number): string {\n  const collapsed = text.replace(/\\s+/g, \" \").trim();\n  if (collapsed.length <= maxLength) {\n    return collapsed;\n  }\n  return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Render an unknown payload as readable text (pretty JSON when possible). */\nexport function stringifyPayload(value: unknown): string {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n  if (typeof value === \"string\") {\n    const parsed = tryParseJson(value);\n    if (parsed !== undefined && typeof parsed === \"object\") {\n      return stringifyPayload(parsed);\n    }\n    return value;\n  }\n  try {\n    return JSON.stringify(value, null, 2) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** JSON.parse that returns `undefined` instead of throwing. */\nexport function tryParseJson(text: string): unknown {\n  const trimmed = text.trim();\n  if (!trimmed.startsWith(\"{\") && !trimmed.startsWith(\"[\") && !trimmed.startsWith('\"')) {\n    return undefined;\n  }\n  try {\n    return JSON.parse(trimmed) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The canonical credit-death sentence. Credit exhaustion is the one failure a\n * user can fix themselves — the copy must say what happened (empty balance),\n * what to do (add credits), and what is safe (nothing was lost). Crucially it\n * must NOT say \"send a message to revive\": a revive turn burns credits the\n * workspace no longer has.\n */\nexport const CREDIT_EXHAUSTION_MESSAGE =\n  \"Out of OpenGeni credits — this workspace's balance is empty. Add credits to continue; the conversation is preserved.\";\n\n/**\n * Actionable composer copy for an edge rejection before a turn is accepted.\n * Unlike an in-flight credit exhaustion, this path has not consumed the\n * actor-private draft or any finalized attachment.\n */\nexport const COMPOSER_PAYMENT_REQUIRED_MESSAGE =\n  \"This turn requires OpenGeni managed credits, but the account balance is empty. Add credits or choose a connected Codex subscription model, then retry. Your draft and attachments are preserved.\";\n\nexport function composerSubmissionErrorMessage(error: Error): string {\n  return error instanceof OpenGeniApiError &&\n    error.status === 402 &&\n    error.code === \"payment_required\"\n    ? COMPOSER_PAYMENT_REQUIRED_MESSAGE\n    : error.message;\n}\n\n/**\n * Does this failure/completion payload (or raw error string) mean the\n * workspace ran out of OpenGeni credits? Matches the engine's\n * \"insufficient OpenGeni credits\" text (case-insensitive, substring — it\n * arrives both bare and wrapped in \"Activity task failed: …\") and the\n * budget-exhausted segment limit the engine stamps on a turn it ended early.\n */\nexport function isCreditExhaustion(\n  input: { error?: string | null; detail?: string | null; segmentLimit?: string | null } | string,\n): boolean {\n  if (typeof input === \"string\") {\n    return input.toLowerCase().includes(\"insufficient opengeni credits\");\n  }\n  if (input.segmentLimit === \"budget_exhausted\") {\n    return true;\n  }\n  for (const text of [input.error, input.detail]) {\n    if (typeof text === \"string\" && text.toLowerCase().includes(\"insufficient opengeni credits\")) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Humanize engine/provider failure text before it reaches the timeline or a\n * failure banner. Raw provider errors leak the wrong audience's instructions —\n * \"Incorrect API key … find your API key at platform.openai.com\" tells a\n * managed-deployment USER to fix credentials only an OPERATOR controls (and is\n * flatly wrong for Azure or subscription-backed engines). Auth, quota, and\n * credit-exhaustion failures collapse to one neutral, honest sentence; every\n * other reason passes through untouched. Raw payloads stay available in the\n * debug surfaces.\n */\nexport function humanizeFailureReason(reason: string | null): string | null {\n  if (!reason) {\n    return reason;\n  }\n  if (isCreditExhaustion(reason)) {\n    return CREDIT_EXHAUSTION_MESSAGE;\n  }\n  const normalized = reason.toLowerCase();\n  const authFailure =\n    normalized.includes(\"incorrect api key\") ||\n    normalized.includes(\"invalid api key\") ||\n    normalized.includes(\"invalid_api_key\") ||\n    normalized.includes(\"platform.openai.com/account/api-keys\") ||\n    (normalized.includes(\"401\") &&\n      (normalized.includes(\"api key\") || normalized.includes(\"unauthorized\")));\n  if (authFailure) {\n    return \"The model provider rejected this deployment's engine credentials. Sending messages won't help until the deployment's engine configuration is fixed.\";\n  }\n  const quotaFailure =\n    normalized.includes(\"insufficient_quota\") || normalized.includes(\"exceeded your current quota\");\n  if (quotaFailure) {\n    return \"The model provider refused the request: this deployment's provider quota is exhausted.\";\n  }\n  return reason;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-HQFPO7VX.js → chunk-7CJOAW3V.js}

@@ -279,16 +279,37 @@ function useSessionEventTrigger(client, workspaceId, sessionId, match, onEvent,
   }, [match, onEvent, reconcileBeforeLive]);
   const consumedRef = useRef(0);
   const feedKeyRef = useRef(null);
+  const sharedFeedHasEventsRef = useRef(false);
   useEffect(() => {
     if (!sharedFeed || !enabled || !sessionId) {
       return;
     }
     const feedKey = `${workspaceId}\0${sessionId}`;
     const firstSequence = events[0]?.sequence ?? 0;
-    if (feedKeyRef.current !== feedKey || firstSequence > consumedRef.current + 1) {
+    if (feedKeyRef.current !== feedKey) {
       feedKeyRef.current = feedKey;
-      consumedRef.current = 0;
+      sharedFeedHasEventsRef.current = events.length > 0;
+      consumedRef.current = events.at(-1)?.sequence ?? 0;
+      return;
+    }
+    const firstNonEmptyBatch = !sharedFeedHasEventsRef.current && events.length > 0;
+    if (firstNonEmptyBatch || firstSequence > consumedRef.current + 1) {
+      sharedFeedHasEventsRef.current = events.length > 0;
+      consumedRef.current = events.at(-1)?.sequence ?? consumedRef.current;
+      let latestMatch;
+      for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event && matchRef.current(event)) {
+          latestMatch = event;
+          break;
+        }
+      }
+      if (latestMatch) {
+        onEventRef.current(latestMatch);
+      }
+      return;
     }
+    sharedFeedHasEventsRef.current ||= events.length > 0;
     for (const event of events) {
       if (event.sequence <= consumedRef.current) {
         continue;
@@ -368,4 +389,4 @@ export {
   useSessionEventTrigger,
   useDebouncedCallback
 };
-//# sourceMappingURL=chunk-HQFPO7VX.js.map
+//# sourceMappingURL=chunk-7CJOAW3V.js.map

package/dist/{chunk-HQFPO7VX.js.map → chunk-7CJOAW3V.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/session-context.ts","../src/hooks/internal.ts"],"sourcesContent":["import type { StreamConnectionState, WorkspaceControlEvent } from \"@opengeni/sdk\";\nimport { createContext, useContext } from \"react\";\nimport type {\n  EmbeddedFileAttachmentClientLike,\n  EmbeddedGoalClientLike,\n  EmbeddedHumanInputSessionClientLike,\n  EmbeddedSessionClientLike,\n  EmbeddedSessionLineageClientLike,\n  EmbeddedSessionMcpApprovalPolicyClientLike,\n  EmbeddedSessionReadClientLike,\n  SessionClientLike,\n} from \"./client\";\n\nexport type OpenGeniContextValue = {\n  client: SessionClientLike;\n  workspaceId: string;\n  workspaceControlEvent: WorkspaceControlEvent | null;\n  workspaceControlConnectionState: StreamConnectionState | \"idle\" | \"error\";\n  registerSessionReconciler: (\n    sessionId: string,\n    key: string,\n    reconcile: () => Promise<void>,\n  ) => () => void;\n  reconcileSession: (sessionId: string) => Promise<void>;\n};\n\nexport const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);\n\nconst NOOP_REGISTER_RECONCILER: OpenGeniContextValue[\"registerSessionReconciler\"] = () => () =>\n  undefined;\nconst NOOP_RECONCILE_SESSION: OpenGeniContextValue[\"reconcileSession\"] = async () => undefined;\n\nexport type ClientOverride = {\n  client?: SessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionClientOverride = {\n  client?: EmbeddedSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedHumanInputClientOverride = {\n  client?: EmbeddedHumanInputSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionMcpApprovalPolicyClientOverride = {\n  client?: EmbeddedSessionMcpApprovalPolicyClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionReadClientOverride = {\n  client?: EmbeddedSessionReadClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedGoalClientOverride = {\n  client?: EmbeddedGoalClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionLineageClientOverride = {\n  client?: EmbeddedSessionLineageClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedFileAttachmentClientOverride = {\n  client?: EmbeddedFileAttachmentClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionContextValue = Omit<OpenGeniContextValue, \"client\"> & {\n  client: EmbeddedSessionClientLike;\n};\n\ntype EmbeddedClientOverride<TClient> = {\n  client?: TClient | undefined;\n  workspaceId?: string | undefined;\n};\n\ntype EmbeddedClientContextValue<TClient> = Omit<OpenGeniContextValue, \"client\"> & {\n  client: TClient;\n};\n\nfunction useEmbeddedClientRefinement<TClient extends object>(\n  override: EmbeddedClientOverride<TClient>,\n  requiredMethods: readonly string[],\n  hookName: string,\n): EmbeddedClientContextValue<TClient> {\n  const context = useContext(OpenGeniContext);\n  const candidate = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!candidate || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  const methods = candidate as Record<string, unknown>;\n  const missing = requiredMethods.filter((method) => typeof methods[method] !== \"function\");\n  if (missing.length > 0) {\n    throw new Error(\n      `@opengeni/react: ${hookName} requires client method${missing.length === 1 ? \"\" : \"s\"} ${missing.join(\", \")}.`,\n    );\n  }\n  return {\n    client: candidate as TClient,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\nfunction eventClientMethods(override: object, directMethods: readonly string[]): readonly string[] {\n  const hasSharedEventFeed =\n    \"events\" in override && (override as { events?: unknown }).events !== undefined;\n  return hasSharedEventFeed ? directMethods : [\"getSession\", \"streamEvents\", ...directMethods];\n}\n\n/** Resolve client + workspace from explicit overrides or the provider. */\nexport function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!client || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  return {\n    client,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\n/**\n * Resolve the narrow client required by the session-only hooks. The full\n * provider client is structurally compatible, while an explicit host proxy\n * only needs to expose session/event/composer/queue/control operations.\n */\nexport function useEmbeddedSession(\n  override: EmbeddedSessionClientOverride = {},\n): EmbeddedSessionContextValue {\n  return useEmbeddedClientRefinement(\n    override,\n    [\n      \"getSession\",\n      \"listEvents\",\n      \"streamEvents\",\n      \"getComposerDraft\",\n      \"saveComposerDraft\",\n      \"sendMessage\",\n      \"steerMessage\",\n      \"getQueue\",\n      \"moveQueueItem\",\n      \"editQueueItem\",\n      \"steerQueueItem\",\n      \"deleteQueueItem\",\n      \"pauseSession\",\n      \"resumeSession\",\n      \"sendApprovalDecision\",\n    ],\n    \"session hooks\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSession`. */\nexport function useEmbeddedSessionRead(\n  override: EmbeddedSessionReadClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionReadClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSession\"]),\n    \"useSession\",\n  );\n}\n\n/** Resolve the exact client surface required by `useGoal`. */\nexport function useEmbeddedGoal(\n  override: EmbeddedGoalClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedGoalClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getGoal\", \"updateGoal\", \"deleteGoal\"]),\n    \"useGoal\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSessionLineage`. */\nexport function useEmbeddedSessionLineage(\n  override: EmbeddedSessionLineageClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionLineageClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSessionLineage\"]),\n    \"useSessionLineage\",\n  );\n}\n\n/** Resolve the exact client surface required by `useFileAttachments`. */\nexport function useEmbeddedFileAttachments(\n  override: EmbeddedFileAttachmentClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedFileAttachmentClientLike> {\n  return useEmbeddedClientRefinement(override, [\"uploadFile\"], \"useFileAttachments\");\n}\n\n/**\n * Resolve the structured-input refinement without widening the baseline\n * session-only proxy contract.\n */\nexport function useEmbeddedHumanInputSession(override: EmbeddedHumanInputClientOverride = {}): Omit<\n  EmbeddedSessionContextValue,\n  \"client\"\n> & {\n  client: EmbeddedHumanInputSessionClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"listHumanInputRequests\", \"submitHumanInputResponse\"]),\n    \"useHumanInputRequests\",\n  );\n}\n\n/** Resolve the approval-policy refinement without widening session-only hosts. */\nexport function useEmbeddedSessionMcpApprovalPolicy(\n  override: EmbeddedSessionMcpApprovalPolicyClientOverride = {},\n): Omit<EmbeddedSessionContextValue, \"client\"> & {\n  client: EmbeddedSessionMcpApprovalPolicyClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSessionMcpApprovalPolicy\"]),\n    \"useSessionMcpApprovalPolicy\",\n  );\n}\n\n/**\n * Resolve the client only — for hooks that are not workspace-scoped\n * (`useWorkspaces`, `useBillingUsage`).\n */\nexport function useOpenGeniClient(\n  override: Pick<ClientOverride, \"client\"> = {},\n): SessionClientLike {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  if (!client) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.\",\n    );\n  }\n  return client;\n}\n","import type { SessionEvent } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { EmbeddedSessionEventClientLike } from \"../client\";\n\nexport type AsyncListState<T> = {\n  data: T | null;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n};\n\n/**\n * Shared fetch + optional polling loop for the list/read hooks. Stale\n * responses (superseded by a newer load or an unmount) are dropped.\n */\nexport function usePolledValue<T>(\n  load: (signal?: AbortSignal) => Promise<T>,\n  options: { pollIntervalMs?: number | undefined; enabled?: boolean | undefined } = {},\n): AsyncListState<T> {\n  const enabled = options.enabled ?? true;\n  const pollIntervalMs = options.pollIntervalMs;\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(enabled);\n  const [error, setError] = useState<Error | null>(null);\n  const generation = useRef(0);\n  const activeLoadRef = useRef(load);\n  useLayoutEffect(() => {\n    activeLoadRef.current = load;\n  }, [load]);\n  const requestAbortRef = useRef<AbortController | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<{ load: typeof load }>(() => ({ load }));\n\n  // A new loader identity means a new query (different session/workspace/...):\n  // drop the previous result instead of showing it as the new query's data.\n  useEffect(() => {\n    if (stateIdentity.load !== load) {\n      setStateIdentity({ load });\n      setData(null);\n      setError(null);\n    }\n  }, [load, stateIdentity.load]);\n\n  const run = useCallback(async () => {\n    // A callback retained by a completed mutation from the previous query must\n    // not supersede or settle the current query's request.\n    if (activeLoadRef.current !== load) return;\n    const ticket = ++generation.current;\n    requestAbortRef.current?.abort();\n    const requestAbort = new AbortController();\n    requestAbortRef.current = requestAbort;\n    try {\n      const result = await load(requestAbort.signal);\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setData(result);\n        setError(null);\n        setLoading(false);\n      }\n    } catch (cause) {\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setError(cause instanceof Error ? cause : new Error(String(cause)));\n        setLoading(false);\n      }\n    } finally {\n      if (requestAbortRef.current === requestAbort) {\n        requestAbortRef.current = null;\n      }\n    }\n  }, [load]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setLoading(false);\n      return;\n    }\n    setLoading(true);\n    void run();\n    if (pollIntervalMs === undefined || pollIntervalMs <= 0) {\n      return () => {\n        generation.current += 1;\n        requestAbortRef.current?.abort();\n      };\n    }\n    const timer = setInterval(() => void run(), pollIntervalMs);\n    return () => {\n      clearInterval(timer);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n    };\n  }, [run, enabled, pollIntervalMs]);\n\n  const identityMatches = stateIdentity.load === load;\n  return {\n    data: identityMatches ? data : null,\n    loading: identityMatches ? loading : enabled,\n    error: identityMatches ? error : null,\n    refresh: run,\n  };\n}\n\nexport type MutationState = {\n  mutating: boolean;\n  mutationError: Error | null;\n  clearMutationError: () => void;\n};\n\n/**\n * Shared async mutation runner for the write hooks. `run` resolves with the\n * operation's value, or `null` after capturing the error in `mutationError`\n * (callers then roll back optimistic state).\n */\nexport function useMutationRunner(identity: unknown = undefined): MutationState & {\n  run: <T>(operation: () => Promise<T>) => Promise<T | null>;\n} {\n  const [mutating, setMutating] = useState(false);\n  const [mutationError, setMutationError] = useState<Error | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<unknown>(() => identity);\n  const inFlight = useRef(0);\n  const generation = useRef(0);\n  const identityRef = useRef(identity);\n  useLayoutEffect(() => {\n    if (Object.is(identityRef.current, identity)) return;\n    identityRef.current = identity;\n    generation.current += 1;\n    inFlight.current = 0;\n  }, [identity]);\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n  useEffect(() => {\n    if (!Object.is(stateIdentity, identity)) {\n      setStateIdentity(() => identity);\n      setMutating(false);\n      setMutationError(null);\n    }\n  }, [identity, stateIdentity]);\n  const run = useCallback(\n    async <T>(operation: () => Promise<T>): Promise<T | null> => {\n      const ownedIdentity = identity;\n      const ownedGeneration = generation.current;\n      if (!Object.is(identityRef.current, ownedIdentity)) return null;\n      inFlight.current += 1;\n      if (mounted.current) {\n        setMutating(true);\n        setMutationError(null);\n      }\n      try {\n        const result = await operation();\n        if (\n          !mounted.current ||\n          generation.current !== ownedGeneration ||\n          !Object.is(identityRef.current, ownedIdentity)\n        ) {\n          return null;\n        }\n        return result;\n      } catch (cause) {\n        if (\n          mounted.current &&\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          setMutationError(cause instanceof Error ? cause : new Error(String(cause)));\n        }\n        return null;\n      } finally {\n        if (\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          inFlight.current -= 1;\n          if (mounted.current && inFlight.current === 0) {\n            setMutating(false);\n          }\n        }\n      }\n    },\n    [identity],\n  );\n  const identityMatches = Object.is(stateIdentity, identity);\n  return {\n    mutating: identityMatches && mutating,\n    mutationError: identityMatches ? mutationError : null,\n    clearMutationError: useCallback(() => {\n      if (Object.is(identityRef.current, identity)) setMutationError(null);\n    }, [identity]),\n    run,\n  };\n}\n\nexport type SessionEventFeedOptions = {\n  /**\n   * Share an existing event log (from `useSessionEvents`) instead of opening\n   * a second stream. When omitted the hook tails the session's event stream\n   * itself, starting at the current `lastSequence`.\n   */\n  events?: SessionEvent[] | undefined;\n  enabled?: boolean | undefined;\n};\n\n/**\n * Invoke `onEvent` for every session event matching `match` — the live-update\n * primitive behind `useTurnQueue` and `useGoal`. Either watches a shared\n * `events` log or tails the stream directly (reconnect handled by the SDK).\n */\nexport function useSessionEventTrigger(\n  client: EmbeddedSessionEventClientLike,\n  workspaceId: string,\n  sessionId: string | null | undefined,\n  match: (event: SessionEvent) => boolean,\n  onEvent: (event: SessionEvent) => void,\n  options: SessionEventFeedOptions = {},\n  reconcileBeforeLive?: (() => void | Promise<void>) | undefined,\n): void {\n  const enabled = options.enabled ?? true;\n  const events = options.events;\n  const sharedFeed = events !== undefined;\n  const matchRef = useRef(match);\n  const onEventRef = useRef(onEvent);\n  const reconcileBeforeLiveRef = useRef(reconcileBeforeLive);\n  useLayoutEffect(() => {\n    matchRef.current = match;\n    onEventRef.current = onEvent;\n    reconcileBeforeLiveRef.current = reconcileBeforeLive;\n  }, [match, onEvent, reconcileBeforeLive]);\n  const consumedRef = useRef(0);\n  const feedKeyRef = useRef<string | null>(null);\n\n  // Shared-log mode: scan only the unseen tail on every append.\n  useEffect(() => {\n    if (!sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const feedKey = `${workspaceId}\\u0000${sessionId}`;\n    const firstSequence = events[0]?.sequence ?? 0;\n    // A new session target or a log reset (sequence restarted below the\n    // cursor) restarts consumption from the top of the shared log.\n    if (feedKeyRef.current !== feedKey || firstSequence > consumedRef.current + 1) {\n      feedKeyRef.current = feedKey;\n      consumedRef.current = 0;\n    }\n    for (const event of events) {\n      if (event.sequence <= consumedRef.current) {\n        continue;\n      }\n      consumedRef.current = event.sequence;\n      if (matchRef.current(event)) {\n        onEventRef.current(event);\n      }\n    }\n  }, [sharedFeed, enabled, events, workspaceId, sessionId]);\n\n  // Self-stream mode: tail from the session's current lastSequence.\n  useEffect(() => {\n    if (sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const controller = new AbortController();\n    void (async () => {\n      try {\n        const session = await client.getSession(workspaceId, sessionId);\n        if (controller.signal.aborted) {\n          return;\n        }\n        const stream = client.streamEvents(workspaceId, sessionId, {\n          after: session.lastSequence,\n          signal: controller.signal,\n          beforeLive: async () => await reconcileBeforeLiveRef.current?.(),\n        });\n        for await (const event of stream) {\n          if (matchRef.current(event)) {\n            onEventRef.current(event);\n          }\n        }\n      } catch {\n        // Live updates are best-effort: the read hooks still expose refresh()\n        // and the initial load already populated state.\n      }\n    })();\n    return () => {\n      controller.abort();\n    };\n  }, [sharedFeed, enabled, client, workspaceId, sessionId]);\n}\n\n/** Debounce rapid event bursts into one trailing call (default 150ms). */\nexport function useDebouncedCallback(callback: () => void, delayMs = 150): () => void {\n  const callbackRef = useRef(callback);\n  useLayoutEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(() => {\n    return () => {\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n      }\n    };\n  }, []);\n  return useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n    }\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null;\n      callbackRef.current();\n    }, delayMs);\n  }, [delayMs]);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/session-context.ts","../src/hooks/internal.ts"],"sourcesContent":["import type { StreamConnectionState, WorkspaceControlEvent } from \"@opengeni/sdk\";\nimport { createContext, useContext } from \"react\";\nimport type {\n  EmbeddedFileAttachmentClientLike,\n  EmbeddedGoalClientLike,\n  EmbeddedHumanInputSessionClientLike,\n  EmbeddedSessionClientLike,\n  EmbeddedSessionLineageClientLike,\n  EmbeddedSessionMcpApprovalPolicyClientLike,\n  EmbeddedSessionReadClientLike,\n  SessionClientLike,\n} from \"./client\";\n\nexport type OpenGeniContextValue = {\n  client: SessionClientLike;\n  workspaceId: string;\n  workspaceControlEvent: WorkspaceControlEvent | null;\n  workspaceControlConnectionState: StreamConnectionState | \"idle\" | \"error\";\n  registerSessionReconciler: (\n    sessionId: string,\n    key: string,\n    reconcile: () => Promise<void>,\n  ) => () => void;\n  reconcileSession: (sessionId: string) => Promise<void>;\n};\n\nexport const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);\n\nconst NOOP_REGISTER_RECONCILER: OpenGeniContextValue[\"registerSessionReconciler\"] = () => () =>\n  undefined;\nconst NOOP_RECONCILE_SESSION: OpenGeniContextValue[\"reconcileSession\"] = async () => undefined;\n\nexport type ClientOverride = {\n  client?: SessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionClientOverride = {\n  client?: EmbeddedSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedHumanInputClientOverride = {\n  client?: EmbeddedHumanInputSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionMcpApprovalPolicyClientOverride = {\n  client?: EmbeddedSessionMcpApprovalPolicyClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionReadClientOverride = {\n  client?: EmbeddedSessionReadClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedGoalClientOverride = {\n  client?: EmbeddedGoalClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionLineageClientOverride = {\n  client?: EmbeddedSessionLineageClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedFileAttachmentClientOverride = {\n  client?: EmbeddedFileAttachmentClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionContextValue = Omit<OpenGeniContextValue, \"client\"> & {\n  client: EmbeddedSessionClientLike;\n};\n\ntype EmbeddedClientOverride<TClient> = {\n  client?: TClient | undefined;\n  workspaceId?: string | undefined;\n};\n\ntype EmbeddedClientContextValue<TClient> = Omit<OpenGeniContextValue, \"client\"> & {\n  client: TClient;\n};\n\nfunction useEmbeddedClientRefinement<TClient extends object>(\n  override: EmbeddedClientOverride<TClient>,\n  requiredMethods: readonly string[],\n  hookName: string,\n): EmbeddedClientContextValue<TClient> {\n  const context = useContext(OpenGeniContext);\n  const candidate = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!candidate || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  const methods = candidate as Record<string, unknown>;\n  const missing = requiredMethods.filter((method) => typeof methods[method] !== \"function\");\n  if (missing.length > 0) {\n    throw new Error(\n      `@opengeni/react: ${hookName} requires client method${missing.length === 1 ? \"\" : \"s\"} ${missing.join(\", \")}.`,\n    );\n  }\n  return {\n    client: candidate as TClient,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\nfunction eventClientMethods(override: object, directMethods: readonly string[]): readonly string[] {\n  const hasSharedEventFeed =\n    \"events\" in override && (override as { events?: unknown }).events !== undefined;\n  return hasSharedEventFeed ? directMethods : [\"getSession\", \"streamEvents\", ...directMethods];\n}\n\n/** Resolve client + workspace from explicit overrides or the provider. */\nexport function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!client || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  return {\n    client,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\n/**\n * Resolve the narrow client required by the session-only hooks. The full\n * provider client is structurally compatible, while an explicit host proxy\n * only needs to expose session/event/composer/queue/control operations.\n */\nexport function useEmbeddedSession(\n  override: EmbeddedSessionClientOverride = {},\n): EmbeddedSessionContextValue {\n  return useEmbeddedClientRefinement(\n    override,\n    [\n      \"getSession\",\n      \"listEvents\",\n      \"streamEvents\",\n      \"getComposerDraft\",\n      \"saveComposerDraft\",\n      \"sendMessage\",\n      \"steerMessage\",\n      \"getQueue\",\n      \"moveQueueItem\",\n      \"editQueueItem\",\n      \"steerQueueItem\",\n      \"deleteQueueItem\",\n      \"pauseSession\",\n      \"resumeSession\",\n      \"sendApprovalDecision\",\n    ],\n    \"session hooks\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSession`. */\nexport function useEmbeddedSessionRead(\n  override: EmbeddedSessionReadClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionReadClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSession\"]),\n    \"useSession\",\n  );\n}\n\n/** Resolve the exact client surface required by `useGoal`. */\nexport function useEmbeddedGoal(\n  override: EmbeddedGoalClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedGoalClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getGoal\", \"updateGoal\", \"deleteGoal\"]),\n    \"useGoal\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSessionLineage`. */\nexport function useEmbeddedSessionLineage(\n  override: EmbeddedSessionLineageClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionLineageClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSessionLineage\"]),\n    \"useSessionLineage\",\n  );\n}\n\n/** Resolve the exact client surface required by `useFileAttachments`. */\nexport function useEmbeddedFileAttachments(\n  override: EmbeddedFileAttachmentClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedFileAttachmentClientLike> {\n  return useEmbeddedClientRefinement(override, [\"uploadFile\"], \"useFileAttachments\");\n}\n\n/**\n * Resolve the structured-input refinement without widening the baseline\n * session-only proxy contract.\n */\nexport function useEmbeddedHumanInputSession(override: EmbeddedHumanInputClientOverride = {}): Omit<\n  EmbeddedSessionContextValue,\n  \"client\"\n> & {\n  client: EmbeddedHumanInputSessionClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"listHumanInputRequests\", \"submitHumanInputResponse\"]),\n    \"useHumanInputRequests\",\n  );\n}\n\n/** Resolve the approval-policy refinement without widening session-only hosts. */\nexport function useEmbeddedSessionMcpApprovalPolicy(\n  override: EmbeddedSessionMcpApprovalPolicyClientOverride = {},\n): Omit<EmbeddedSessionContextValue, \"client\"> & {\n  client: EmbeddedSessionMcpApprovalPolicyClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSessionMcpApprovalPolicy\"]),\n    \"useSessionMcpApprovalPolicy\",\n  );\n}\n\n/**\n * Resolve the client only — for hooks that are not workspace-scoped\n * (`useWorkspaces`, `useBillingUsage`).\n */\nexport function useOpenGeniClient(\n  override: Pick<ClientOverride, \"client\"> = {},\n): SessionClientLike {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  if (!client) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.\",\n    );\n  }\n  return client;\n}\n","import type { SessionEvent } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { EmbeddedSessionEventClientLike } from \"../client\";\n\nexport type AsyncListState<T> = {\n  data: T | null;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n};\n\n/**\n * Shared fetch + optional polling loop for the list/read hooks. Stale\n * responses (superseded by a newer load or an unmount) are dropped.\n */\nexport function usePolledValue<T>(\n  load: (signal?: AbortSignal) => Promise<T>,\n  options: { pollIntervalMs?: number | undefined; enabled?: boolean | undefined } = {},\n): AsyncListState<T> {\n  const enabled = options.enabled ?? true;\n  const pollIntervalMs = options.pollIntervalMs;\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(enabled);\n  const [error, setError] = useState<Error | null>(null);\n  const generation = useRef(0);\n  const activeLoadRef = useRef(load);\n  useLayoutEffect(() => {\n    activeLoadRef.current = load;\n  }, [load]);\n  const requestAbortRef = useRef<AbortController | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<{ load: typeof load }>(() => ({ load }));\n\n  // A new loader identity means a new query (different session/workspace/...):\n  // drop the previous result instead of showing it as the new query's data.\n  useEffect(() => {\n    if (stateIdentity.load !== load) {\n      setStateIdentity({ load });\n      setData(null);\n      setError(null);\n    }\n  }, [load, stateIdentity.load]);\n\n  const run = useCallback(async () => {\n    // A callback retained by a completed mutation from the previous query must\n    // not supersede or settle the current query's request.\n    if (activeLoadRef.current !== load) return;\n    const ticket = ++generation.current;\n    requestAbortRef.current?.abort();\n    const requestAbort = new AbortController();\n    requestAbortRef.current = requestAbort;\n    try {\n      const result = await load(requestAbort.signal);\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setData(result);\n        setError(null);\n        setLoading(false);\n      }\n    } catch (cause) {\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setError(cause instanceof Error ? cause : new Error(String(cause)));\n        setLoading(false);\n      }\n    } finally {\n      if (requestAbortRef.current === requestAbort) {\n        requestAbortRef.current = null;\n      }\n    }\n  }, [load]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setLoading(false);\n      return;\n    }\n    setLoading(true);\n    void run();\n    if (pollIntervalMs === undefined || pollIntervalMs <= 0) {\n      return () => {\n        generation.current += 1;\n        requestAbortRef.current?.abort();\n      };\n    }\n    const timer = setInterval(() => void run(), pollIntervalMs);\n    return () => {\n      clearInterval(timer);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n    };\n  }, [run, enabled, pollIntervalMs]);\n\n  const identityMatches = stateIdentity.load === load;\n  return {\n    data: identityMatches ? data : null,\n    loading: identityMatches ? loading : enabled,\n    error: identityMatches ? error : null,\n    refresh: run,\n  };\n}\n\nexport type MutationState = {\n  mutating: boolean;\n  mutationError: Error | null;\n  clearMutationError: () => void;\n};\n\n/**\n * Shared async mutation runner for the write hooks. `run` resolves with the\n * operation's value, or `null` after capturing the error in `mutationError`\n * (callers then roll back optimistic state).\n */\nexport function useMutationRunner(identity: unknown = undefined): MutationState & {\n  run: <T>(operation: () => Promise<T>) => Promise<T | null>;\n} {\n  const [mutating, setMutating] = useState(false);\n  const [mutationError, setMutationError] = useState<Error | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<unknown>(() => identity);\n  const inFlight = useRef(0);\n  const generation = useRef(0);\n  const identityRef = useRef(identity);\n  useLayoutEffect(() => {\n    if (Object.is(identityRef.current, identity)) return;\n    identityRef.current = identity;\n    generation.current += 1;\n    inFlight.current = 0;\n  }, [identity]);\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n  useEffect(() => {\n    if (!Object.is(stateIdentity, identity)) {\n      setStateIdentity(() => identity);\n      setMutating(false);\n      setMutationError(null);\n    }\n  }, [identity, stateIdentity]);\n  const run = useCallback(\n    async <T>(operation: () => Promise<T>): Promise<T | null> => {\n      const ownedIdentity = identity;\n      const ownedGeneration = generation.current;\n      if (!Object.is(identityRef.current, ownedIdentity)) return null;\n      inFlight.current += 1;\n      if (mounted.current) {\n        setMutating(true);\n        setMutationError(null);\n      }\n      try {\n        const result = await operation();\n        if (\n          !mounted.current ||\n          generation.current !== ownedGeneration ||\n          !Object.is(identityRef.current, ownedIdentity)\n        ) {\n          return null;\n        }\n        return result;\n      } catch (cause) {\n        if (\n          mounted.current &&\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          setMutationError(cause instanceof Error ? cause : new Error(String(cause)));\n        }\n        return null;\n      } finally {\n        if (\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          inFlight.current -= 1;\n          if (mounted.current && inFlight.current === 0) {\n            setMutating(false);\n          }\n        }\n      }\n    },\n    [identity],\n  );\n  const identityMatches = Object.is(stateIdentity, identity);\n  return {\n    mutating: identityMatches && mutating,\n    mutationError: identityMatches ? mutationError : null,\n    clearMutationError: useCallback(() => {\n      if (Object.is(identityRef.current, identity)) setMutationError(null);\n    }, [identity]),\n    run,\n  };\n}\n\nexport type SessionEventFeedOptions = {\n  /**\n   * Share an existing event log (from `useSessionEvents`) instead of opening\n   * a second stream. When omitted the hook tails the session's event stream\n   * itself, starting at the current `lastSequence`.\n   */\n  events?: SessionEvent[] | undefined;\n  enabled?: boolean | undefined;\n};\n\n/**\n * Invoke `onEvent` for every session event matching `match` — the live-update\n * primitive behind `useTurnQueue` and `useGoal`. Either watches a shared\n * `events` log or tails the stream directly (reconnect handled by the SDK).\n */\nexport function useSessionEventTrigger(\n  client: EmbeddedSessionEventClientLike,\n  workspaceId: string,\n  sessionId: string | null | undefined,\n  match: (event: SessionEvent) => boolean,\n  onEvent: (event: SessionEvent) => void,\n  options: SessionEventFeedOptions = {},\n  reconcileBeforeLive?: (() => void | Promise<void>) | undefined,\n): void {\n  const enabled = options.enabled ?? true;\n  const events = options.events;\n  const sharedFeed = events !== undefined;\n  const matchRef = useRef(match);\n  const onEventRef = useRef(onEvent);\n  const reconcileBeforeLiveRef = useRef(reconcileBeforeLive);\n  useLayoutEffect(() => {\n    matchRef.current = match;\n    onEventRef.current = onEvent;\n    reconcileBeforeLiveRef.current = reconcileBeforeLive;\n  }, [match, onEvent, reconcileBeforeLive]);\n  const consumedRef = useRef(0);\n  const feedKeyRef = useRef<string | null>(null);\n  const sharedFeedHasEventsRef = useRef(false);\n\n  // Shared-log mode: scan only the unseen tail on every append.\n  useEffect(() => {\n    if (!sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const feedKey = `${workspaceId}\\u0000${sessionId}`;\n    const firstSequence = events[0]?.sequence ?? 0;\n    if (feedKeyRef.current !== feedKey) {\n      feedKeyRef.current = feedKey;\n      sharedFeedHasEventsRef.current = events.length > 0;\n      // The caller has already loaded its authoritative initial projection.\n      // Seed from the shared log's current tail so mounting a large historical\n      // session cannot replay every old event as a new live trigger.\n      consumedRef.current = events.at(-1)?.sequence ?? 0;\n      return;\n    }\n    const firstNonEmptyBatch = !sharedFeedHasEventsRef.current && events.length > 0;\n    if (firstNonEmptyBatch || firstSequence > consumedRef.current + 1) {\n      // The usual shared feed mounts empty, then receives a historical tail.\n      // A later discontinuity can likewise replace the retained browser\n      // window. In either case, reconcile once from the latest relevant event\n      // instead of replaying the whole retained window as live traffic.\n      sharedFeedHasEventsRef.current = events.length > 0;\n      consumedRef.current = events.at(-1)?.sequence ?? consumedRef.current;\n      let latestMatch: SessionEvent | undefined;\n      for (let index = events.length - 1; index >= 0; index -= 1) {\n        const event = events[index];\n        if (event && matchRef.current(event)) {\n          latestMatch = event;\n          break;\n        }\n      }\n      if (latestMatch) {\n        onEventRef.current(latestMatch);\n      }\n      return;\n    }\n    sharedFeedHasEventsRef.current ||= events.length > 0;\n    for (const event of events) {\n      if (event.sequence <= consumedRef.current) {\n        continue;\n      }\n      consumedRef.current = event.sequence;\n      if (matchRef.current(event)) {\n        onEventRef.current(event);\n      }\n    }\n  }, [sharedFeed, enabled, events, workspaceId, sessionId]);\n\n  // Self-stream mode: tail from the session's current lastSequence.\n  useEffect(() => {\n    if (sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const controller = new AbortController();\n    void (async () => {\n      try {\n        const session = await client.getSession(workspaceId, sessionId);\n        if (controller.signal.aborted) {\n          return;\n        }\n        const stream = client.streamEvents(workspaceId, sessionId, {\n          after: session.lastSequence,\n          signal: controller.signal,\n          beforeLive: async () => await reconcileBeforeLiveRef.current?.(),\n        });\n        for await (const event of stream) {\n          if (matchRef.current(event)) {\n            onEventRef.current(event);\n          }\n        }\n      } catch {\n        // Live updates are best-effort: the read hooks still expose refresh()\n        // and the initial load already populated state.\n      }\n    })();\n    return () => {\n      controller.abort();\n    };\n  }, [sharedFeed, enabled, client, workspaceId, sessionId]);\n}\n\n/** Debounce rapid event bursts into one trailing call (default 150ms). */\nexport function useDebouncedCallback(callback: () => void, delayMs = 150): () => void {\n  const callbackRef = useRef(callback);\n  useLayoutEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(() => {\n    return () => {\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n      }\n    };\n  }, []);\n  return useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n    }\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null;\n      callbackRef.current();\n    }, delayMs);\n  }, [delayMs]);\n}\n"],"mappings":"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","names":[]}