@opengeni/react 7.6.1 → 7.7.0-canary.37111190284001

package/dist/{chunk-VGIKFIO2.js → chunk-XOAMRDDK.js}

@@ -4,7 +4,10 @@ import {
   usePageLiveActivity,
   usePolledValue,
   useSessionEventTrigger
-} from "./chunk-KZ73RL76.js";
+} from "./chunk-YQEAA6LT.js";
+import {
+  normalizeError
+} from "./chunk-UGLEYEMP.js";
 import {
   useEmbeddedGoal,
   useEmbeddedSessionLineage,
@@ -131,7 +134,7 @@ function useGoal(sessionId, options = {}) {
         setGoal(null);
         setError(null);
       } else {
-        setError(cause instanceof Error ? cause : new Error(String(cause)));
+        setError(normalizeError(cause));
       }
       setLoading(false);
     } finally {
@@ -475,4 +478,4 @@ export {
   isLineageRefreshEvent,
   useSessionLineage
 };
-//# sourceMappingURL=chunk-VGIKFIO2.js.map
+//# sourceMappingURL=chunk-XOAMRDDK.js.map

package/dist/chunk-XOAMRDDK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embedded-session-client.ts","../src/hooks/use-goal.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 { OpenGeniApiError, type SessionEvent, type SessionGoal } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useEmbeddedGoal, type EmbeddedGoalClientOverride } from \"../session-context\";\nimport { normalizeError } from \"../lib/error-message\";\nimport {\n  useDebouncedCallback,\n  useMutationRunner,\n  usePageLiveActivity,\n  useSessionEventTrigger,\n  type SessionEventFeedOptions,\n} from \"./internal\";\n\n/** Event types that change the session goal (set/updated/completed/paused/...). */\nexport function isGoalEvent(event: Pick<SessionEvent, \"type\">): boolean {\n  return event.type.startsWith(\"goal.\");\n}\n\n/**\n * Events that can change the server-authoritative continuation projection.\n * The projection is derived from durable turn, session, control, and system\n * update state, so those events refresh the goal without model polling.\n */\nexport function isGoalRefreshEvent(event: Pick<SessionEvent, \"type\">): boolean {\n  const type = event.type;\n  return (\n    isGoalEvent(event) ||\n    type.startsWith(\"turn.\") ||\n    type.startsWith(\"session.\") ||\n    type.startsWith(\"system.update.\") ||\n    type.startsWith(\"workspace.inference.\") ||\n    type.startsWith(\"user.\")\n  );\n}\n\nexport type UseGoalOptions = EmbeddedGoalClientOverride &\n  SessionEventFeedOptions & {\n    /** Optional safety-net polling (ms). Off by default — event refreshes drive updates. */\n    pollIntervalMs?: number | undefined;\n  };\n\nexport type UseGoalResult = {\n  /** The session goal, or null when the session has none. */\n  goal: SessionGoal | null;\n  /** Convenience flags over `goal.status`. */\n  isActive: boolean;\n  isPaused: boolean;\n  isCompleted: boolean;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n  /** Pause the goal loop (PATCH status=paused). */\n  pause: (rationale?: string) => Promise<SessionGoal | null>;\n  /** Resume a paused goal: resets counters and re-arms continuations. */\n  resume: () => Promise<SessionGoal | null>;\n  /** Clear the session goal; goal-less sessions remain a successful no-op. */\n  clearGoal: () => Promise<void>;\n  /** Alias for `clearGoal`. */\n  deleteGoal: () => Promise<void>;\n  /** True while a pause/resume/clear is in flight. */\n  updating: boolean;\n  mutationError: Error | null;\n  clearMutationError: () => void;\n};\n\n/**\n * The session's goal: state, the autonomy counters (`autoContinuations`,\n * `noProgressStreak`), and pause/resume control. A goal-less session yields\n * `goal: null` (the 404 is absorbed). Live-updates on goal, turn, session,\n * control, and system-update events — pass `options.events` from\n * `useSessionEvents` to reuse its stream.\n */\nexport function useGoal(\n  sessionId: string | null | undefined,\n  options: UseGoalOptions = {},\n): UseGoalResult {\n  const { client, workspaceId } = useEmbeddedGoal(options);\n  const enabled = (options.enabled ?? true) && Boolean(sessionId);\n  const sharedEvents = options.events;\n  const sharedFeed = sharedEvents !== undefined;\n  const pageLive = usePageLiveActivity();\n  const [goal, setGoal] = useState<SessionGoal | null>(null);\n  const [loading, setLoading] = useState(enabled);\n  const [error, setError] = useState<Error | null>(null);\n  const { run, mutating, mutationError, clearMutationError } = useMutationRunner();\n  const generation = useRef(0);\n  const targetKeyRef = useRef<string | null>(null);\n  const loadAbort = useRef<AbortController | null>(null);\n\n  const retireLoads = useCallback(() => {\n    generation.current += 1;\n    loadAbort.current?.abort();\n    loadAbort.current = null;\n  }, []);\n\n  const load = useCallback(async (): Promise<void> => {\n    if (!sessionId) {\n      return;\n    }\n    const ticket = ++generation.current;\n    loadAbort.current?.abort();\n    const controller = new AbortController();\n    loadAbort.current = controller;\n    try {\n      const fetched = await client.getGoal(workspaceId, sessionId, {\n        signal: controller.signal,\n      });\n      if (ticket === generation.current) {\n        setGoal(fetched);\n        setError(null);\n        setLoading(false);\n      }\n    } catch (cause) {\n      if (ticket !== generation.current) {\n        return;\n      }\n      if (cause instanceof OpenGeniApiError && cause.status === 404) {\n        // No goal is a normal state, not an error.\n        setGoal(null);\n        setError(null);\n      } else {\n        setError(normalizeError(cause));\n      }\n      setLoading(false);\n    } finally {\n      if (loadAbort.current === controller) loadAbort.current = null;\n    }\n  }, [client, workspaceId, sessionId]);\n\n  useEffect(() => {\n    const targetKey = `${workspaceId} ${sessionId ?? \"\"}`;\n    if (targetKeyRef.current !== targetKey) {\n      targetKeyRef.current = targetKey;\n      setGoal(null);\n      setError(null);\n    }\n    if (!enabled || !pageLive) {\n      retireLoads();\n      setLoading(false);\n      return;\n    }\n    if (sharedFeed) {\n      // A shared log supplies invalidations, not the authoritative goal snapshot.\n      setLoading(true);\n      void load();\n      return () => {\n        retireLoads();\n      };\n    }\n    setLoading(true);\n    const pollIntervalMs = options.pollIntervalMs;\n    if (pollIntervalMs === undefined || pollIntervalMs <= 0) {\n      void load();\n      return () => {\n        retireLoads();\n      };\n    }\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const schedule = () => {\n      if (cancelled) return;\n      timer = setTimeout(() => {\n        timer = null;\n        void load().finally(schedule);\n      }, pollIntervalMs);\n    };\n    void load().finally(schedule);\n    return () => {\n      cancelled = true;\n      if (timer !== null) clearTimeout(timer);\n      retireLoads();\n    };\n  }, [\n    load,\n    enabled,\n    pageLive,\n    workspaceId,\n    sessionId,\n    options.pollIntervalMs,\n    retireLoads,\n    sharedFeed,\n  ]);\n\n  const scheduleRefresh = useDebouncedCallback(() => void load());\n  useSessionEventTrigger(client, workspaceId, sessionId, isGoalRefreshEvent, scheduleRefresh, {\n    enabled,\n    ...(sharedEvents !== undefined ? { events: sharedEvents } : {}),\n  });\n\n  const pause = useCallback(\n    async (rationale?: string): Promise<SessionGoal | null> => {\n      if (!sessionId) {\n        return null;\n      }\n      const result = await run(() =>\n        client.updateGoal(workspaceId, sessionId, {\n          status: \"paused\",\n          ...(rationale !== undefined ? { rationale } : {}),\n        }),\n      );\n      if (result) {\n        setGoal(result);\n      }\n      return result;\n    },\n    [client, workspaceId, sessionId, run],\n  );\n\n  const resume = useCallback(async (): Promise<SessionGoal | null> => {\n    if (!sessionId) {\n      return null;\n    }\n    const result = await run(() => client.updateGoal(workspaceId, sessionId, { status: \"active\" }));\n    if (result) {\n      setGoal(result);\n    }\n    return result;\n  }, [client, workspaceId, sessionId, run]);\n\n  const clearGoal = useCallback(async (): Promise<void> => {\n    if (!sessionId) {\n      return;\n    }\n    // deleteGoal resolves void, so distinguish success (a truthy sentinel) from\n    // mutation.run's null-on-failure. Only a SUCCESSFUL delete hides the goal:\n    // a failed one leaves the pill up so its mutationError renders. And invalidate\n    // any in-flight load first so a slower getGoal started before the delete can't\n    // commit and repopulate the just-cleared goal.\n    const ok = await run(async () => {\n      await client.deleteGoal(workspaceId, sessionId);\n      return true as const;\n    });\n    if (ok) {\n      retireLoads();\n      setGoal(null);\n      setError(null);\n    }\n  }, [client, workspaceId, sessionId, run, retireLoads]);\n\n  return {\n    goal,\n    isActive: goal?.status === \"active\",\n    isPaused: goal?.status === \"paused\",\n    isCompleted: goal?.status === \"completed\",\n    loading,\n    error,\n    refresh: load,\n    pause,\n    resume,\n    clearGoal,\n    deleteGoal: clearGoal,\n    updating: mutating,\n    mutationError,\n    clearMutationError,\n  };\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":";;;;;;;;;;;;;;;;;AAqBA,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,SAAS,4BACd,MACA,UAA8C,CAAC,GACpB;AAC3B,QAAM,YAAY,QAAQ,aAAa,CAAC;AACxC,QAAM,SAAS,CAAC;AAChB,aAAW,OAAO,iBAAiB;AACjC,UAAM,WAAW,UAAU,GAAG;AAC9B,UAAM,SAAS,YAAY,KAAK,GAAG;AACnC,QAAI,OAAO,WAAW,YAAY;AAChC,YAAM,IAAI,UAAU,+CAA+C,GAAG,EAAE;AAAA,IAC1E;AACA,WAAO,GAAG,IAAI,OAAO,KAAK,aAAa,SAAY,OAAO,SAAS;AAAA,EACrE;AAEA,QAAM,oBAAoB,UAAU;AACpC,QAAM,gBAAgB,KAAK;AAC3B,QAAM,kBAAkB,qBAAqB;AAC7C,MAAI,OAAO,oBAAoB,YAAY;AACzC,WAAO,6BAA6B,gBAAgB;AAAA,MAClD,sBAAsB,SAAY,OAAO;AAAA,IAC3C;AAAA,EACF;AAEA,QAAM,WAAW,QAAQ;AACzB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,mBAAmB,OAAO;AAChC,SAAO,mBAAmB,OAAO,aAAa,cAC5C,SAAS,MAAM,iBAAiB,aAAa,SAAS,GAAG;AAAA,IACvD,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF,CAAC;AAEH,QAAM,oBAAoB,OAAO;AACjC,SAAO,oBAAoB,OAAO,aAAa,WAAW,YACxD,SAAS,MAAM,kBAAkB,aAAa,WAAW,OAAO,GAAG;AAAA,IACjE,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF,CAAC;AAEH,QAAM,sBAAsB,OAAO;AACnC,SAAO,sBAAsB,OAAO,aAAa,WAAW,YAAY;AACtE,UAAM,WAAW,MAAM,oBAAoB,aAAa,WAAW,OAAO;AAC1E,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO,SAAS,SAAS,OAAO;AAAA,QAC9B,WAAW;AAAA,QACX;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;;;ACvGA,SAAS,wBAA6D;AACtE,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AAYlD,SAAS,YAAY,OAA4C;AACtE,SAAO,MAAM,KAAK,WAAW,OAAO;AACtC;AAOO,SAAS,mBAAmB,OAA4C;AAC7E,QAAM,OAAO,MAAM;AACnB,SACE,YAAY,KAAK,KACjB,KAAK,WAAW,OAAO,KACvB,KAAK,WAAW,UAAU,KAC1B,KAAK,WAAW,gBAAgB,KAChC,KAAK,WAAW,sBAAsB,KACtC,KAAK,WAAW,OAAO;AAE3B;AAuCO,SAAS,QACd,WACA,UAA0B,CAAC,GACZ;AACf,QAAM,EAAE,QAAQ,YAAY,IAAI,gBAAgB,OAAO;AACvD,QAAM,WAAW,QAAQ,WAAW,SAAS,QAAQ,SAAS;AAC9D,QAAM,eAAe,QAAQ;AAC7B,QAAM,aAAa,iBAAiB;AACpC,QAAM,WAAW,oBAAoB;AACrC,QAAM,CAAC,MAAM,OAAO,IAAI,SAA6B,IAAI;AACzD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,OAAO;AAC9C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AACrD,QAAM,EAAE,KAAK,UAAU,eAAe,mBAAmB,IAAI,kBAAkB;AAC/E,QAAM,aAAa,OAAO,CAAC;AAC3B,QAAM,eAAe,OAAsB,IAAI;AAC/C,QAAM,YAAY,OAA+B,IAAI;AAErD,QAAM,cAAc,YAAY,MAAM;AACpC,eAAW,WAAW;AACtB,cAAU,SAAS,MAAM;AACzB,cAAU,UAAU;AAAA,EACtB,GAAG,CAAC,CAAC;AAEL,QAAM,OAAO,YAAY,YAA2B;AAClD,QAAI,CAAC,WAAW;AACd;AAAA,IACF;AACA,UAAM,SAAS,EAAE,WAAW;AAC5B,cAAU,SAAS,MAAM;AACzB,UAAM,aAAa,IAAI,gBAAgB;AACvC,cAAU,UAAU;AACpB,QAAI;AACF,YAAM,UAAU,MAAM,OAAO,QAAQ,aAAa,WAAW;AAAA,QAC3D,QAAQ,WAAW;AAAA,MACrB,CAAC;AACD,UAAI,WAAW,WAAW,SAAS;AACjC,gBAAQ,OAAO;AACf,iBAAS,IAAI;AACb,mBAAW,KAAK;AAAA,MAClB;AAAA,IACF,SAAS,OAAO;AACd,UAAI,WAAW,WAAW,SAAS;AACjC;AAAA,MACF;AACA,UAAI,iBAAiB,oBAAoB,MAAM,WAAW,KAAK;AAE7D,gBAAQ,IAAI;AACZ,iBAAS,IAAI;AAAA,MACf,OAAO;AACL,iBAAS,eAAe,KAAK,CAAC;AAAA,MAChC;AACA,iBAAW,KAAK;AAAA,IAClB,UAAE;AACA,UAAI,UAAU,YAAY,WAAY,WAAU,UAAU;AAAA,IAC5D;AAAA,EACF,GAAG,CAAC,QAAQ,aAAa,SAAS,CAAC;AAEnC,YAAU,MAAM;AACd,UAAM,YAAY,GAAG,WAAW,IAAI,aAAa,EAAE;AACnD,QAAI,aAAa,YAAY,WAAW;AACtC,mBAAa,UAAU;AACvB,cAAQ,IAAI;AACZ,eAAS,IAAI;AAAA,IACf;AACA,QAAI,CAAC,WAAW,CAAC,UAAU;AACzB,kBAAY;AACZ,iBAAW,KAAK;AAChB;AAAA,IACF;AACA,QAAI,YAAY;AAEd,iBAAW,IAAI;AACf,WAAK,KAAK;AACV,aAAO,MAAM;AACX,oBAAY;AAAA,MACd;AAAA,IACF;AACA,eAAW,IAAI;AACf,UAAM,iBAAiB,QAAQ;AAC/B,QAAI,mBAAmB,UAAa,kBAAkB,GAAG;AACvD,WAAK,KAAK;AACV,aAAO,MAAM;AACX,oBAAY;AAAA,MACd;AAAA,IACF;AACA,QAAI,YAAY;AAChB,QAAI,QAA8C;AAClD,UAAM,WAAW,MAAM;AACrB,UAAI,UAAW;AACf,cAAQ,WAAW,MAAM;AACvB,gBAAQ;AACR,aAAK,KAAK,EAAE,QAAQ,QAAQ;AAAA,MAC9B,GAAG,cAAc;AAAA,IACnB;AACA,SAAK,KAAK,EAAE,QAAQ,QAAQ;AAC5B,WAAO,MAAM;AACX,kBAAY;AACZ,UAAI,UAAU,KAAM,cAAa,KAAK;AACtC,kBAAY;AAAA,IACd;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,kBAAkB,qBAAqB,MAAM,KAAK,KAAK,CAAC;AAC9D,yBAAuB,QAAQ,aAAa,WAAW,oBAAoB,iBAAiB;AAAA,IAC1F;AAAA,IACA,GAAI,iBAAiB,SAAY,EAAE,QAAQ,aAAa,IAAI,CAAC;AAAA,EAC/D,CAAC;AAED,QAAM,QAAQ;AAAA,IACZ,OAAO,cAAoD;AACzD,UAAI,CAAC,WAAW;AACd,eAAO;AAAA,MACT;AACA,YAAM,SAAS,MAAM;AAAA,QAAI,MACvB,OAAO,WAAW,aAAa,WAAW;AAAA,UACxC,QAAQ;AAAA,UACR,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,QACjD,CAAC;AAAA,MACH;AACA,UAAI,QAAQ;AACV,gBAAQ,MAAM;AAAA,MAChB;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,QAAQ,aAAa,WAAW,GAAG;AAAA,EACtC;AAEA,QAAM,SAAS,YAAY,YAAyC;AAClE,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AACA,UAAM,SAAS,MAAM,IAAI,MAAM,OAAO,WAAW,aAAa,WAAW,EAAE,QAAQ,SAAS,CAAC,CAAC;AAC9F,QAAI,QAAQ;AACV,cAAQ,MAAM;AAAA,IAChB;AACA,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,aAAa,WAAW,GAAG,CAAC;AAExC,QAAM,YAAY,YAAY,YAA2B;AACvD,QAAI,CAAC,WAAW;AACd;AAAA,IACF;AAMA,UAAM,KAAK,MAAM,IAAI,YAAY;AAC/B,YAAM,OAAO,WAAW,aAAa,SAAS;AAC9C,aAAO;AAAA,IACT,CAAC;AACD,QAAI,IAAI;AACN,kBAAY;AACZ,cAAQ,IAAI;AACZ,eAAS,IAAI;AAAA,IACf;AAAA,EACF,GAAG,CAAC,QAAQ,aAAa,WAAW,KAAK,WAAW,CAAC;AAErD,SAAO;AAAA,IACL;AAAA,IACA,UAAU,MAAM,WAAW;AAAA,IAC3B,UAAU,MAAM,WAAW;AAAA,IAC3B,aAAa,MAAM,WAAW;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ,UAAU;AAAA,IACV;AAAA,IACA;AAAA,EACF;AACF;;;ACxPA,SAAS,eAAAA,cAAa,aAAAC,YAAW,iBAAiB,SAAS,UAAAC,SAAQ,YAAAC,iBAAgB;AAa5E,SAAS,gCACd,OACA,UACS;AACT,MAAI,MAAM,SAAS,uCAAuC;AACxD,WAAO;AAAA,EACT;AACA,MAAI,aAAa,QAAW;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM;AACtB,SAAO,SAAS,aAAa;AAC/B;AAyBO,SAAS,4BACd,WACA,UACA,UAA8C,CAAC,GACZ;AACnC,QAAM,EAAE,QAAQ,YAAY,IAAI,oCAAoC,OAAO;AAC3E,QAAM,WAAW,QAAQ,WAAW,SAAS,QAAQ,aAAa,QAAQ;AAC1E,QAAM,CAAC,UAAU,WAAW,IAAIC,UAAgD,IAAI;AACpF,QAAM,YAAY,GAAG,WAAW,KAAS,aAAa,EAAE,KAAS,YAAY,EAAE;AAC/E,QAAM,0BAA0BC,QAAO,CAAC;AACxC,QAAM,mBAAmB,QAAQ,OAAO,EAAE,QAAQ,UAAU,IAAI,CAAC,QAAQ,SAAS,CAAC;AACnF,QAAM,EAAE,KAAK,UAAU,eAAe,mBAAmB,IAAI,kBAAkB,gBAAgB;AAE/F,kBAAgB,MAAM;AACpB,4BAAwB,WAAW;AACnC,gBAAY,IAAI;AAAA,EAClB,GAAG,CAAC,QAAQ,SAAS,CAAC;AAOtB,QAAM,OAAOC,aAAY,YAAiC;AACxD,UAAM,aAAa,wBAAwB;AAC3C,QAAI,CAAC,aAAa,CAAC,UAAU;AAC3B,aAAO,EAAE,WAAW,YAAY,QAAQ,KAAK;AAAA,IAC/C;AACA,UAAM,UAAU,MAAM,OAAO,WAAW,aAAa,SAAS;AAC9D,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,QACE,QAAQ,WAAW,KAAK,CAACC,YAAWA,QAAO,OAAO,QAAQ,MACzD,QAAQ,uBAAuB,OAAO,OAAO,QAAQ,qBAAqB,QAAQ,IAC/E;AAAA,QACE,IAAI;AAAA,QACJ,QAAQ;AAAA,QACR,iBAAiB,QAAQ,oBAAoB,QAAQ;AAAA,MACvD,IACA;AAAA,IACR;AAAA,EACF,GAAG,CAAC,QAAQ,UAAU,WAAW,WAAW,WAAW,CAAC;AACxD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF,IAAI,eAAe,MAAM;AAAA,IACvB;AAAA,IACA,gBAAgB,QAAQ;AAAA,EAC1B,CAAC;AACD,EAAAC,WAAU,MAAM;AACd,QAAI,MAAM,cAAc,aAAa,KAAK,eAAe,wBAAwB,SAAS;AACxF,kBAAY,IAAI;AAAA,IAClB;AAAA,EACF,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,kBAAkB,qBAAqB,MAAM,KAAK,QAAQ,CAAC;AACjE,QAAM,qBAAqBF;AAAA,IACzB,CAAC,UACC,gCAAgC,OAAO,YAAY,MAAS;AAAA,IAC9D,CAAC,QAAQ;AAAA,EACX;AACA;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE;AAAA,MACA,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnE;AAAA,IACA,YAAY,MAAM,QAAQ;AAAA,EAC5B;AAEA,QAAM,SAASA;AAAA,IACb,OACE,WAC2D;AAC3D,UAAI,CAAC,aAAa,CAAC,UAAU;AAC3B,eAAO;AAAA,MACT;AACA,YAAM,WAAW,MAAM;AAAA,QAAI,MACzB,OAAO,+BAA+B,aAAa,WAAW,UAAU;AAAA,UACtE,iBAAiB;AAAA,QACnB,CAAC;AAAA,MACH;AACA,UAAI,UAAU;AACZ,gCAAwB,WAAW;AACnC,oBAAY,SAAS,MAAM;AAC3B,aAAK,QAAQ;AAAA,MACf;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,QAAQ,SAAS,KAAK,UAAU,WAAW,WAAW;AAAA,EACzD;AAEA,QAAM,SAAS,YAAY,MAAM,UAAU;AAC3C,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,QAAQ,mBAAmB;AAAA,IACnC;AAAA,IACA,OAAO,iBAAiB;AAAA,IACxB,SAAS,YAAY;AACnB,YAAM,QAAQ;AAAA,IAChB;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV,YAAY;AAAA,EACd;AACF;;;ACvKA,SAAS,eAAAG,cAAa,aAAAC,YAAW,UAAAC,eAAc;AAyBxC,SAAS,sBAAsB,OAA8B;AAClE,MAAI,MAAM,SAAS,4BAA4B,MAAM,SAAS,mBAAmB;AAC/E,WAAO;AAAA,EACT;AAKA,MAAI,MAAM,SAAS,yBAAyB;AAC1C,UAAM,UAAU,MAAM;AACtB,UAAM,OACJ,OAAO,SAAS,SAAS,WACrB,QAAQ,OACR,OAAO,SAAS,aAAa,WAC3B,QAAQ,WACR;AACR,WAAO,SAAS,oBAAoB,KAAK,SAAS,kBAAkB;AAAA,EACtE;AACA,SAAO;AACT;AAEA,SAAS,+BAA+B,OAA8B;AACpE,MAAI,MAAM,SAAS,0BAA0B;AAC3C,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM;AACtB,QAAM,OACJ,OAAO,SAAS,SAAS,WACrB,QAAQ,OACR,OAAO,SAAS,aAAa,WAC3B,QAAQ,WACR;AACR,SAAO,SAAS,oBAAoB,KAAK,SAAS,kBAAkB;AACtE;AAGO,SAAS,kBACd,WACA,UAAoC,CAAC,GACZ;AACzB,QAAM,EAAE,QAAQ,aAAa,uBAAuB,0BAA0B,IAC5E,0BAA0B,OAAO;AACnC,QAAM,WAAW,QAAQ,WAAW,SAAS,QAAQ,SAAS;AAC9D,QAAM,qBAAqBC,QAAO,CAAC;AACnC,QAAM,YAAY,QAAQ;AAC1B,QAAM,OAAOC;AAAA,IACX,OAAO,WAAyB;AAC9B,UAAI,CAAC,WAAW;AACd,eAAO;AAAA,UACL,SAAS,EAAE,WAAW,CAAC,GAAG,UAAU,CAAC,GAAG,WAAW,MAAM;AAAA,UACzD,gBAAgB;AAAA,QAClB;AAAA,MACF;AACA,UAAI,iBAAiB;AACrB,YAAM,UAAU,MAAM,OAAO,kBAAkB,aAAa,WAAW;AAAA,QACrE;AAAA,QACA,gBAAgB,CAAC,yBAAyB;AACxC,2BAAiB,wBAAwB,YAAY,KAAK,EAAE,mBAAmB;AAAA,QACjF;AAAA,MACF,CAAC;AACD,aAAO;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACA,CAAC,WAAW,QAAQ,aAAa,SAAS;AAAA,EAC5C;AACA,QAAM,QAAQ,eAAe,MAAM,EAAE,gBAAgB,QAAQ,gBAAgB,QAAQ,CAAC;AACtF,QAAM,UAAU,MAAM;AACtB,EAAAC,WAAU,MAAM;AACd,QAAI,WAAW,sBAAuB,MAAK,QAAQ;AAAA,EACrD,GAAG,CAAC,SAAS,SAAS,qBAAqB,CAAC;AAC5C,EAAAA,WAAU,MAAM;AACd,QAAI,CAAC,aAAa,CAAC,QAAS;AAC5B,WAAO,0BAA0B,WAAW,WAAW,OAAO;AAAA,EAChE,GAAG,CAAC,SAAS,SAAS,2BAA2B,SAAS,CAAC;AAC3D,QAAM,cAAc,qBAAqB,MAAM,KAAK,QAAQ,GAAG,GAAG;AAClE,QAAM,yBAAyBF,QAA6C,IAAI;AAIhF,EAAAE,WAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,uBAAuB,YAAY,MAAM;AAC3C,qBAAa,uBAAuB,OAAO;AAC3C,+BAAuB,UAAU;AAAA,MACnC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,WAAW,WAAW,CAAC;AAC3B,QAAM,0BAA0BD,aAAY,MAAM;AAChD,SAAK,QAAQ;AACb,QAAI,uBAAuB,YAAY,MAAM;AAC3C,mBAAa,uBAAuB,OAAO;AAAA,IAC7C;AACA,2BAAuB,UAAU,WAAW,MAAM;AAChD,6BAAuB,UAAU;AACjC,WAAK,QAAQ;AAAA,IACf,GAAG,IAAI;AAAA,EACT,GAAG,CAAC,OAAO,CAAC;AACZ;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,EAAE,QAAQ,QAAQ,QAAQ,SAAS,WAAW,QAAQ,WAAW,OAAU;AAAA,EAC7E;AACA;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,QAAQ,QAAQ,QAAQ,SAAS,WAAW,QAAQ,WAAW,OAAU;AAAA,EAC7E;AACA,SAAO;AAAA,IACL,SAAS,MAAM,MAAM,WAAW;AAAA,IAChC,SAAS,MAAM;AAAA,IACf,OAAO,MAAM;AAAA,IACb,gBAAgB,MAAM,MAAM,kBAAkB;AAAA,IAC9C;AAAA,EACF;AACF;","names":["useCallback","useEffect","useRef","useState","useState","useRef","useCallback","server","useEffect","useCallback","useEffect","useRef","useRef","useCallback","useEffect"]}

package/dist/{chunk-6NEZPF53.js → chunk-YN7I3STW.js}

@@ -1,10 +1,11 @@
 import {
   InteractionInterventionBanner,
+  isInteractionControlUnavailable,
   isNonRetryableInteractionError,
   isSourcePlacementChangedError,
   useInteractionInterventions,
   useInteractionInvalidation
-} from "./chunk-YSMMDOOE.js";
+} from "./chunk-GISEVGS6.js";
 import {
   copyTextToClipboard
 } from "./chunk-JVYQRRC4.js";
@@ -22,7 +23,7 @@ import {
 } from "./chunk-5J4FOW6Q.js";
 import {
   usePageLiveActivity
-} from "./chunk-KZ73RL76.js";
+} from "./chunk-YQEAA6LT.js";
 import {
   useEmbeddedComputerInteraction
 } from "./chunk-NEXLLTP4.js";
@@ -452,6 +453,7 @@ function useComputerSession(options) {
     requestRef.current.controller?.abort();
     const controller = new AbortController();
     requestRef.current = { id, controller };
+    let discoveryCompleted = false;
     try {
       const [session, targetResponse] = await Promise.all([
         client.getComputerSession(workspaceId, computerSessionId, {
@@ -461,6 +463,7 @@ function useComputerSession(options) {
           signal: controller.signal
         })
       ]);
+      discoveryCompleted = true;
       if (!mountedRef.current || requestRef.current.id !== id) return;
       const targets = sortComputerTargets(targetResponse.targets);
       const selected = chooseTarget(targets, selectedTargetIdRef.current, session.platform);
@@ -477,7 +480,8 @@ function useComputerSession(options) {
           selectedTargetId: selected?.id ?? null,
           observation: retainedObservation,
           loading: false,
-          error: null
+          error: null,
+          controlError: null
         } : current
       );
       const observation = selected ? await client.observeComputerTarget(workspaceId, computerSessionId, selected.id, {
@@ -500,11 +504,16 @@ function useComputerSession(options) {
       );
     } catch (cause) {
       if (controller.signal.aborted || !mountedRef.current || requestRef.current.id !== id) return;
+      const error = cause instanceof Error ? cause : new Error(String(cause));
       setState(
         (current) => current.computerSessionId === computerSessionId ? {
           ...current,
           loading: false,
-          error: cause instanceof Error ? cause : new Error(String(cause))
+          error,
+          controlError: isInteractionControlUnavailable(
+            error,
+            discoveryCompleted ? "observation" : "control"
+          ) ? error : current.controlError
         } : current
       );
     } finally {
@@ -561,11 +570,19 @@ function useComputerSession(options) {
         (current) => current.computerSessionId === scopeComputerSessionId ? { ...current, mutating: true, error: null } : current
       );
       try {
-        return await operation();
+        const result = await operation();
+        setState(
+          (current) => current.computerSessionId === scopeComputerSessionId ? { ...current, controlError: null } : current
+        );
+        return result;
       } catch (cause) {
         const error = cause instanceof Error ? cause : new Error(String(cause));
         setState(
-          (current) => current.computerSessionId === scopeComputerSessionId ? { ...current, error } : current
+          (current) => current.computerSessionId === scopeComputerSessionId ? {
+            ...current,
+            error,
+            controlError: isInteractionControlUnavailable(error) ? error : current.controlError
+          } : current
         );
         throw error;
       } finally {
@@ -612,7 +629,12 @@ function useComputerSession(options) {
       } catch (cause) {
         const error = cause instanceof Error ? cause : new Error(String(cause));
         setState(
-          (current) => current.computerSessionId === computerSessionId && current.selectedTargetId === target.id ? { ...current, loading: false, error } : current
+          (current) => current.computerSessionId === computerSessionId && current.selectedTargetId === target.id ? {
+            ...current,
+            loading: false,
+            error,
+            controlError: isInteractionControlUnavailable(error, "observation") ? error : current.controlError
+          } : current
         );
         throw error;
       }
@@ -684,7 +706,19 @@ function useComputerSession(options) {
   );
   const readClipboard = useCallback2(async () => {
     if (!computerSessionId) throw new Error("No desktop is selected.");
-    return await client.readComputerClipboard(workspaceId, computerSessionId);
+    try {
+      return await client.readComputerClipboard(workspaceId, computerSessionId);
+    } catch (cause) {
+      const error = cause instanceof Error ? cause : new Error(String(cause));
+      setState(
+        (current) => current.computerSessionId === computerSessionId ? {
+          ...current,
+          error,
+          controlError: isInteractionControlUnavailable(error) ? error : current.controlError
+        } : current
+      );
+      throw error;
+    }
   }, [client, computerSessionId, workspaceId]);
   return {
     session: visible.session,
@@ -694,6 +728,7 @@ function useComputerSession(options) {
     loading: visible.loading,
     mutating: visible.mutating,
     error: visible.error,
+    controlError: visible.controlError,
     refresh,
     readClipboard,
     selectTarget,
@@ -710,7 +745,8 @@ function emptyState(computerSessionId, loading) {
     observation: null,
     loading,
     mutating: false,
-    error: null
+    error: null,
+    controlError: null
   };
 }
 function chooseTarget(targets, preferredId, platform) {
@@ -1084,7 +1120,9 @@ function ComputerViewer({
   const displayedFrame = frames.frame && frames.frame.computerSessionId === selection?.sessionId && frames.frame.targetId === computer.selectedTarget?.id && frames.frame.targetGeneration === computer.selectedTarget?.targetGeneration ? frames.frame : null;
   const rfbStream = frames.attachment?.stream.kind === "direct_rfb" ? frames.attachment.stream : null;
   const machineLocked = selectedRegistrySession?.failureCode === "machine_locked";
-  const rfbInputEnabled = !machineLocked && computer.session?.capabilities?.pointerInput === true && computer.session?.capabilities?.keyboardInput === true;
+  const controlUnavailable = computer.controlError !== null;
+  const connectionState = controlUnavailable ? "error" : frames.state;
+  const rfbInputEnabled = !machineLocked && !controlUnavailable && computer.session?.capabilities?.pointerInput === true && computer.session?.capabilities?.keyboardInput === true;
   const rfbCapability = useMemo2(() => {
     if (!rfbStream || !frames.attachment) return null;
     const bounds = computer.selectedTarget?.bounds;
@@ -1192,6 +1230,7 @@ function ComputerViewer({
   ]);
   const perform = useCallback4(
     async (action, frame) => {
+      if (computer.controlError) throw computer.controlError;
       let receipt;
       if (action.type === "pointer") {
         if (!frame) throw new Error("Desktop view is not ready for pointer input.");
@@ -1203,8 +1242,12 @@ function ComputerViewer({
         throw new Error(receipt.error?.message ?? "Desktop input did not complete.");
       }
     },
-    [act, actFromFrame]
+    [act, actFromFrame, computer.controlError]
   );
+  const reconnect = () => {
+    void refreshComputer();
+    frames.reconnect();
+  };
   const copyFromRfb = useCallback4(
     (event) => {
       if (!rfbInputEnabled || !rfbStream || computer.session?.capabilities?.clipboard !== true)
@@ -1298,7 +1341,7 @@ function ComputerViewer({
             },
             onCreate: hideGenericCreate ? void 0 : createComputer,
             onRefresh: () => {
-              if (frames.state === "error" && !generationLossSelected && !generationLossFrames) {
+              if (connectionState === "error" && !generationLossSelected && !generationLossFrames) {
                 frames.reconnect();
               }
               void Promise.all([refreshRegistry(), refreshComputer()]);
@@ -1356,7 +1399,19 @@ function ComputerViewer({
                   className: "h-full"
                 }
               ),
-              !rfbInputEnabled ? /* @__PURE__ */ jsx("div", { className: "pointer-events-none absolute bottom-3 left-1/2 -translate-x-1/2 rounded-full border border-white/10 bg-black/70 px-3 py-1 text-[11px] text-white/80 backdrop-blur", children: "View only \xB7 direct input unavailable" }) : null
+              !rfbInputEnabled ? /* @__PURE__ */ jsx("div", { className: "pointer-events-none absolute bottom-3 left-1/2 -translate-x-1/2 rounded-full border border-white/10 bg-black/70 px-3 py-1 text-[11px] text-white/80 backdrop-blur", children: controlUnavailable ? /* @__PURE__ */ jsxs(Fragment, { children: [
+                "Desktop controls unavailable",
+                " ",
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: reconnect,
+                    className: "pointer-events-auto ml-2 font-medium underline",
+                    children: "Reconnect"
+                  }
+                )
+              ] }) : "View only \xB7 direct input unavailable" }) : null
             ] }) : /* @__PURE__ */ jsx(
               ComputerViewport,
               {
@@ -1364,16 +1419,18 @@ function ComputerViewer({
                 observation: computer.observation,
                 target: computer.selectedTarget,
                 machineLocked,
-                connectionState: frames.state,
-                connectionError: frames.error ?? computer.error,
+                controlUnavailable,
+                connectionState,
+                connectionError: computer.controlError ?? frames.error ?? computer.error,
                 mutating: computer.mutating,
                 backgroundActions: computer.session?.capabilities?.backgroundActions === true,
+                backgroundInput: computer.session?.capabilities?.backgroundInput === true,
                 clipboardEnabled: computer.session?.capabilities?.clipboard === true,
                 pointerInput: computer.session?.capabilities?.pointerInput === true,
                 keyboardInput: computer.session?.capabilities?.keyboardInput === true,
                 onAction: perform,
                 onReadClipboard: computer.readClipboard,
-                onReconnect: generationLossSelected || generationLossFrames ? () => void 0 : frames.reconnect,
+                onReconnect: generationLossSelected || generationLossFrames ? () => void 0 : reconnect,
                 onError: (cause) => notifyError(cause, "Desktop input failed.")
               },
               JSON.stringify([
@@ -1387,7 +1444,8 @@ function ComputerViewer({
               ComputerSemanticPanel,
               {
                 observation: computer.observation,
-                mutating: computer.mutating,
+                mutating: computer.mutating || controlUnavailable,
+                controlUnavailable,
                 onAction: (action) => void perform(action, null).catch(
                   (cause) => notifyError(cause, "Desktop action failed.")
                 )
@@ -1399,10 +1457,11 @@ function ComputerViewer({
             {
               session: computer.session,
               target: computer.selectedTarget,
-              connectionState: frames.state,
+              connectionState,
+              controlUnavailable,
               refreshing: registry.refreshing,
               showControls,
-              controlCount: semanticNodes(computer.observation).length,
+              controlCount: semanticControls(computer.observation).length,
               onToggleControls: () => setShowControls((current) => !current)
             }
           )
@@ -1627,6 +1686,7 @@ function ComputerLifecyclePanel(props) {
 function ComputerViewport(props) {
   const canvasRef = useRef4(null);
   const inputRef = useRef4(null);
+  const composingRef = useRef4(false);
   const pointerStartRef = useRef4(null);
   const clickTimerRef = useRef4(null);
   const lastClickRef = useRef4(null);
@@ -1647,7 +1707,7 @@ function ComputerViewport(props) {
   readClipboardRef.current = props.onReadClipboard;
   errorRef.current = props.onError;
   const streamFailed = props.connectionState === "error";
-  const rawInputEnabled = !streamFailed && !props.machineLocked && (!props.backgroundActions || props.target?.kind === "screen" || props.target?.focused === true);
+  const rawInputEnabled = !streamFailed && !props.controlUnavailable && !props.machineLocked && (props.backgroundInput || !props.backgroundActions || props.target?.kind === "screen" || props.target?.focused === true);
   const clearBufferedInput = useCallback4(() => {
     if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
     if (wheelRef.current?.timer) clearTimeout(wheelRef.current.timer);
@@ -1657,10 +1717,25 @@ function ComputerViewport(props) {
     pendingTextRef.current = null;
     pointerStartRef.current = null;
     lastClickRef.current = null;
+    composingRef.current = false;
     if (inputRef.current) inputRef.current.value = "";
   }, []);
   const pointerInputEnabled = rawInputEnabled && props.pointerInput;
   const keyboardInputEnabled = rawInputEnabled && props.keyboardInput;
+  useLayoutEffect(() => {
+    const canvas = canvasRef.current;
+    const viewport = canvas?.parentElement;
+    if (!canvas || !viewport) return;
+    const fit = () => fitComputerCanvas(canvas);
+    fit();
+    if (typeof ResizeObserver === "undefined") {
+      window.addEventListener("resize", fit);
+      return () => window.removeEventListener("resize", fit);
+    }
+    const observer = new ResizeObserver(fit);
+    observer.observe(viewport);
+    return () => observer.disconnect();
+  }, []);
   const paintQueuedFrames = useCallback4(() => {
     if (decodingFrameRef.current) return;
     decodingFrameRef.current = true;
@@ -1925,6 +2000,9 @@ function ComputerViewport(props) {
   };
   const keyDown = (event) => {
     if (!keyboardInputEnabled) return;
+    if (composingRef.current || event.nativeEvent.isComposing || event.nativeEvent.keyCode === 229) {
+      return;
+    }
     flushPendingWheel();
     const command = event.metaKey || event.ctrlKey;
     if (props.clipboardEnabled && command && !event.altKey && ["c", "v"].includes(event.key.toLowerCase())) {
@@ -1970,7 +2048,8 @@ function ComputerViewport(props) {
       await dispatch({ type: "clipboard", operation: "paste" }, null);
     });
   };
-  const input = (value) => {
+  const input = (value, nativeComposing = false) => {
+    if (composingRef.current || nativeComposing) return;
     if (!value || !keyboardInputEnabled) return;
     flushPendingWheel();
     flushPendingClick();
@@ -1987,6 +2066,10 @@ function ComputerViewport(props) {
     }
     if (inputRef.current) inputRef.current.value = "";
   };
+  const compositionEnd = (event) => {
+    composingRef.current = false;
+    input(event.currentTarget.value || event.data);
+  };
   const showCanvas = props.frame !== null && paintedFrame !== null && sameComputerTarget(props.frame, paintedFrame) && !props.machineLocked && !streamFailed;
   return /* @__PURE__ */ jsxs("div", { className: "relative min-h-0 flex-1 overflow-hidden bg-black", children: [
     /* @__PURE__ */ jsx(
@@ -2013,7 +2096,11 @@ function ComputerViewport(props) {
       {
         ref: inputRef,
         defaultValue: "",
-        onInput: (event) => input(event.currentTarget.value),
+        onInput: (event) => input(event.currentTarget.value, event.nativeEvent.isComposing),
+        onCompositionStart: () => {
+          composingRef.current = true;
+        },
+        onCompositionEnd: compositionEnd,
         onKeyDown: keyDown,
         onCopy: copy,
         onPaste: paste,
@@ -2030,6 +2117,7 @@ function ComputerViewport(props) {
       {
         observation: props.observation,
         machineLocked: props.machineLocked,
+        controlUnavailable: props.controlUnavailable,
         connectionState: props.connectionState,
         error: props.connectionError,
         onAction: (action) => enqueue(action, null),
@@ -2069,14 +2157,14 @@ function ComputerViewportFallback(props) {
     ] }) });
   }
   const controlFailure = interactionControlFailureFromError(props.error);
-  const interactive = semanticNodes(props.observation).filter((node) => semanticAction(node) !== null).slice(0, 10);
+  const interactive = semanticControls(props.observation).filter((node) => semanticAction(node) !== null).slice(0, 10);
   return /* @__PURE__ */ jsx("div", { className: "absolute inset-0 grid place-items-center bg-og-bg p-6", children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-md rounded-og-lg border border-og-border bg-og-surface-1 p-4 shadow-lg", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
       props.error ? /* @__PURE__ */ jsx(CircleAlertIcon, { className: "size-4 text-og-danger" }) : /* @__PURE__ */ jsx(LoaderCircleIcon, { className: "size-4 animate-spin text-og-fg-muted" }),
-      /* @__PURE__ */ jsx("p", { className: "text-og-menu font-medium text-og-fg", children: isAttachedChromeGenerationLossError(props.error) ? "Chrome reconnected\u2014open a fresh browser/desktop." : props.error ? "Live view disconnected" : computerConnectionLabel(props.connectionState) })
+      /* @__PURE__ */ jsx("p", { className: "text-og-menu font-medium text-og-fg", children: isAttachedChromeGenerationLossError(props.error) ? "Chrome reconnected\u2014open a fresh browser/desktop." : props.controlUnavailable ? "Desktop controls unavailable" : props.error ? "Live view disconnected" : computerConnectionLabel(props.connectionState) })
     ] }),
     props.error ? /* @__PURE__ */ jsx("p", { className: "mt-2 text-og-control leading-5 text-og-fg-muted", children: isAttachedChromeGenerationLossError(props.error) ? "Chrome reconnected\u2014open a fresh browser/desktop. Use Browser \u2192 New browser \u2192 Connected Chrome." : controlFailure?.message ?? props.error.message }) : null,
-    interactive.length > 0 ? /* @__PURE__ */ jsxs("div", { className: "mt-3 border-t border-og-border pt-3", children: [
+    interactive.length > 0 && !props.controlUnavailable ? /* @__PURE__ */ jsxs("div", { className: "mt-3 border-t border-og-border pt-3", children: [
       /* @__PURE__ */ jsx("p", { className: "mb-2 text-og-xs text-og-fg-subtle", children: "App controls remain available" }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: interactive.map((node) => /* @__PURE__ */ jsx(
         "button",
@@ -2104,13 +2192,14 @@ function ComputerViewportFallback(props) {
   ] }) });
 }
 function ComputerSemanticPanel(props) {
-  const nodes = semanticNodes(props.observation).slice(0, 100);
+  const nodes = semanticControls(props.observation).slice(0, 100);
   return /* @__PURE__ */ jsxs("aside", { className: "box-border max-h-[40%] w-full shrink-0 overflow-y-auto border-t border-og-border bg-og-surface-1 p-2 @xl/computer-viewer:max-h-none @xl/computer-viewer:w-64 @xl/computer-viewer:border-t-0 @xl/computer-viewer:border-l", children: [
     /* @__PURE__ */ jsxs("div", { className: "mb-2 flex items-center gap-1.5 px-1 text-og-xs font-medium uppercase tracking-[0.1em] text-og-fg-subtle", children: [
       /* @__PURE__ */ jsx(KeyboardIcon, { className: "size-3" }),
       " App controls"
     ] }),
-    nodes.length === 0 ? /* @__PURE__ */ jsx("p", { className: "px-1 py-2 text-og-control leading-5 text-og-fg-muted", children: "This view has no accessibility controls. Use the live image instead." }) : /* @__PURE__ */ jsx("div", { className: "space-y-0.5", children: nodes.map((node) => /* @__PURE__ */ jsx(
+    props.controlUnavailable ? /* @__PURE__ */ jsx("p", { className: "px-1 py-2 text-og-control leading-5 text-og-fg-muted", children: "Reconnect to use app controls." }) : null,
+    nodes.length === 0 ? props.controlUnavailable ? null : /* @__PURE__ */ jsx("p", { className: "px-1 py-2 text-og-control leading-5 text-og-fg-muted", children: "This view has no accessibility controls. Use the live image instead." }) : /* @__PURE__ */ jsx("div", { className: "space-y-0.5", children: nodes.map((node) => /* @__PURE__ */ jsx(
       ComputerSemanticControl,
       {
         node,
@@ -2199,8 +2288,8 @@ function ComputerStatusBar(props) {
         )
       }
     ),
-    /* @__PURE__ */ jsx("span", { children: props.connectionState === "live" ? "Live" : computerConnectionLabel(props.connectionState) }),
-    /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: screen ? "Full screen \xB7 input may move pointer and focus" : props.session?.capabilities?.backgroundActions ? "Window \xB7 app controls work in the background" : props.target?.kind ?? "Desktop" }),
+    /* @__PURE__ */ jsx("span", { children: props.controlUnavailable ? "Controls unavailable" : props.connectionState === "live" ? "Live" : computerConnectionLabel(props.connectionState) }),
+    /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: props.controlUnavailable ? "Reconnect to use desktop input" : screen ? "Full screen \xB7 input may move pointer and focus" : props.session?.capabilities?.backgroundInput ? "Window \xB7 clicks and typing stay in the background" : props.session?.capabilities?.backgroundActions ? "Window \xB7 app controls work in the background" : props.target?.kind ?? "Desktop" }),
     screen ? /* @__PURE__ */ jsx(MousePointer2Icon, { className: "size-3", "aria-hidden": true }) : null,
     props.refreshing ? /* @__PURE__ */ jsx(LoaderCircleIcon, { className: "size-3 animate-spin" }) : null,
     /* @__PURE__ */ jsxs(
@@ -2236,11 +2325,30 @@ function ComputerNotice(props) {
     }
   );
 }
-function semanticNodes(observation) {
+var structuralRoles = /* @__PURE__ */ new Set([
+  "frame",
+  "panel",
+  "section",
+  "document",
+  "document web",
+  "static",
+  "static text",
+  "heading",
+  "paragraph",
+  "notification",
+  "separator",
+  "tool bar",
+  "page tab list"
+]);
+function semanticControls(observation) {
   if (observation?.semantic?.kind !== "snapshot") return [];
   const result = [];
   const visit = (node) => {
-    result.push(node);
+    const role = node.role.trim().toLowerCase();
+    const label = node.name?.trim() || node.identifier?.trim();
+    if (node.actions.includes("set_value") || label && label.toLowerCase() !== role && !structuralRoles.has(role) && semanticAction(node) !== null) {
+      result.push(node);
+    }
     node.children?.forEach(visit);
   };
   observation.semantic.roots.forEach(visit);
@@ -2261,11 +2369,24 @@ function semanticValue(node) {
   return typeof node.value === "string" ? node.value : null;
 }
 function paintCanvas(canvas, image, width, height) {
+  const dimensionsChanged = canvas.width !== width || canvas.height !== height;
   canvas.width = width;
   canvas.height = height;
   const context = canvas.getContext("2d", { alpha: false });
   if (!context) throw new Error("Desktop canvas is unavailable.");
   context.drawImage(image, 0, 0, width, height);
+  if (dimensionsChanged) fitComputerCanvas(canvas);
+}
+function fitComputerCanvas(canvas) {
+  const viewport = canvas.parentElement;
+  if (!viewport || canvas.width <= 0 || canvas.height <= 0) return;
+  const scale = Math.min(
+    viewport.clientWidth / canvas.width,
+    viewport.clientHeight / canvas.height
+  );
+  if (!Number.isFinite(scale) || scale <= 0) return;
+  canvas.style.width = `${canvas.width * scale}px`;
+  canvas.style.height = `${canvas.height * scale}px`;
 }
 function loadImage(url) {
   return new Promise((resolve, reject) => {
@@ -2423,4 +2544,4 @@ export {
   ComputerViewer,
   computerKey
 };
-//# sourceMappingURL=chunk-6NEZPF53.js.map
+//# sourceMappingURL=chunk-YN7I3STW.js.map