@agents24/chat-react 0.5.0 → 0.5.2

package/dist/runtime/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/index.ts","../../src/runtime/use-agent-chat-runtime.ts","../../src/mcp-oauth.ts","../../src/runtime/input-contract.ts"],"sourcesContent":["export * from \"./use-agent-chat-runtime\";\nexport * from \"./input-contract\";\n","import type {\n  AgentClient,\n  Agents24ClientError,\n  ClientBootstrap,\n  EffectiveResourcePolicy,\n  HitlResponse,\n  PortableUpload,\n} from \"@agents24/client\";\nimport type { ContextCompression, ContextWindow } from \"@agents24/client/protocol\";\nimport {\n  type AgentChatController,\n  type ChatHitlPart,\n  useAgentAttachments,\n  useAgentChat,\n  useAgentMcp,\n} from \"@agents24/react\";\nimport * as React from \"react\";\n\nimport {\n  browserChatCrypto,\n  createMcpPkceProof,\n  validateMcpCallbackResult,\n  waitForMcpOauthComplete,\n} from \"../mcp-oauth\";\nimport type { ChatMcpOauthCompletion } from \"../types\";\nimport { validateAgentChatSubmission } from \"./input-contract\";\n\nexport type AgentChatRuntimeAgent = {\n  name: string;\n  description?: string | null;\n  handle?: string | null;\n  avatarUrl?: string | null;\n};\n\nexport type AgentChatRuntimeModel = {\n  id: string;\n  label: string;\n};\n\nexport type AgentChatRuntimeViewState =\n  | \"ready\"\n  | \"loading\"\n  | \"streaming\"\n  | \"reconnecting\"\n  | \"paused\"\n  | \"cancelling\"\n  | \"cancelled\"\n  | \"offline\"\n  | \"denied\"\n  | \"quota\"\n  | \"failed\"\n  | \"expired\";\n\nexport type AgentChatRuntimeConnectionState =\n  | \"connected\"\n  | \"connecting\"\n  | \"reconnecting\"\n  | \"offline\"\n  | \"expired\";\n\nexport type AgentChatThreadChangeReason = \"created\" | \"opened\" | \"new\" | \"deleted\";\n\nexport type AgentChatActiveThreadChange = {\n  threadId: string | null;\n  reason: AgentChatThreadChangeReason;\n};\n\nexport type AgentChatActiveThreadChangeHandler = (\n  change: AgentChatActiveThreadChange,\n) => void;\n\nexport type AgentChatMcpAuthorizationCompletion = (input: {\n  completion: ChatMcpOauthCompletion;\n  codeVerifier: string;\n  serverId: string;\n}) => Promise<void>;\n\nexport type AgentChatRuntimeSubmit = {\n  text: string;\n  files?: readonly PortableUpload[];\n};\n\nexport type AgentChatRuntimeHitlActionState = {\n  action: string;\n  error?: string | null;\n  status: \"connecting\" | \"resuming\" | \"error\";\n};\n\nexport type UseAgentChatRuntimeOptions = {\n  activeThreadId?: string | null;\n  agent?: AgentChatRuntimeAgent;\n  client: AgentClient;\n  completeMcpAuthorization?: AgentChatMcpAuthorizationCompletion;\n  mcpRedirectUri?: string;\n  modelId?: string | null;\n  onActiveThreadIdChange?: AgentChatActiveThreadChangeHandler;\n  onModelChange?: (modelId: string) => void;\n};\n\nexport type AgentChatRuntime = {\n  agent: AgentChatRuntimeAgent;\n  inputContract: ClientBootstrap[\"features\"][\"inputs\"] | null;\n  allowFeedback: boolean;\n  backgroundError: unknown;\n  bootstrap: ClientBootstrap | null;\n  capabilities: readonly string[];\n  changeModel(modelId: string): void;\n  clearOperationError(): void;\n  connectionState: AgentChatRuntimeConnectionState;\n  contextWindow: ContextWindow | null;\n  contextCompression: ContextCompression | null;\n  controller: AgentChatController;\n  deleteThread(threadId: string): Promise<void>;\n  errorMessage: string | null;\n  fatalError: unknown;\n  getHitlActionState(part: ChatHitlPart): AgentChatRuntimeHitlActionState | undefined;\n  isBootstrapping: boolean;\n  isSubmitting: boolean;\n  isUploading: boolean;\n  modelId: string | null;\n  models: AgentChatRuntimeModel[];\n  newThread(): void;\n  onHitlAction(part: ChatHitlPart, response: HitlResponse): Promise<void>;\n  openThread(threadId: string): Promise<void>;\n  operationError: unknown;\n  retryBootstrap(): Promise<void>;\n  state: AgentChatRuntimeViewState;\n  submit(input: AgentChatRuntimeSubmit): Promise<void>;\n};\n\ntype PendingThreadTransition = {\n  reason: \"opened\" | \"deleted\";\n  value: string | null;\n};\n\nexport function agentChatRuntimeStateFromError(error: unknown): AgentChatRuntimeViewState {\n  const typed = error as Partial<Agents24ClientError> | null;\n  if (typed?.kind === \"authentication\") return \"expired\";\n  if (typed?.kind === \"authorization\") return \"denied\";\n  if (typed?.kind === \"quota\" || typed?.kind === \"rate_limit\") return \"quota\";\n  if (typed?.kind === \"network\") return \"offline\";\n  return \"failed\";\n}\n\nexport function agentChatRuntimeErrorMessage(error: unknown): string | null {\n  if (!error) return null;\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function modelsFromAgentChatBootstrap(bootstrap: ClientBootstrap): {\n  defaultModelId: string | null;\n  models: AgentChatRuntimeModel[];\n} {\n  const modelFeatures = bootstrap.features.models;\n  const selectable = bootstrap.capabilities.includes(\"models.select\") && modelFeatures?.selectable === true;\n  if (!selectable) return { defaultModelId: null, models: [] };\n  const models = Array.isArray(modelFeatures.options)\n    ? modelFeatures.options.flatMap((option) => (\n        typeof option?.id === \"string\" && option.id.trim()\n          ? [{ id: option.id, label: typeof option.label === \"string\" && option.label.trim() ? option.label : option.id }]\n          : []\n      ))\n    : [];\n  const configuredDefault = models.some((model) => model.id === modelFeatures.default_id)\n    ? modelFeatures.default_id\n    : null;\n  return {\n    defaultModelId: configuredDefault,\n    models,\n  };\n}\n\nfunction modelsFromEffectivePolicy(policy: EffectiveResourcePolicy): {\n  defaultModelId: string | null;\n  models: AgentChatRuntimeModel[];\n} {\n  const models = policy.model_selection.selectable\n    ? policy.model_selection.options.map((option) => ({ id: option.id, label: option.label }))\n    : [];\n  return {\n    defaultModelId: models.some((model) => model.id === policy.model_selection.default_id)\n      ? policy.model_selection.default_id\n      : null,\n    models,\n  };\n}\n\nfunction hitlKey(part: ChatHitlPart): string {\n  return part.interruptId || part.id;\n}\n\nexport function useAgentChatRuntime(options: UseAgentChatRuntimeOptions): AgentChatRuntime {\n  const {\n    activeThreadId,\n    agent: agentOverride,\n    client,\n    completeMcpAuthorization,\n    mcpRedirectUri,\n    modelId,\n    onActiveThreadIdChange,\n    onModelChange,\n  } = options;\n  const controller = useAgentChat(\n    activeThreadId === undefined ? { client } : { activeThreadId, client },\n  );\n  const attachments = useAgentAttachments();\n  const mcp = useAgentMcp();\n  const [bootstrap, setBootstrap] = React.useState<ClientBootstrap | null>(null);\n  const [effectivePolicy, setEffectivePolicy] = React.useState<EffectiveResourcePolicy | null>(null);\n  const [isBootstrapping, setIsBootstrapping] = React.useState(true);\n  const [bootstrapError, setBootstrapError] = React.useState<unknown>(null);\n  const [localOperationError, setLocalOperationError] = React.useState<unknown>(null);\n  const [selectedModelId, setSelectedModelId] = React.useState<string | null>(modelId ?? null);\n  const [isSubmitting, setIsSubmitting] = React.useState(false);\n  const submitPromiseRef = React.useRef<Promise<void> | null>(null);\n  const [hitlStates, setHitlStates] = React.useState<Record<string, AgentChatRuntimeHitlActionState>>({});\n  const hitlStatesRef = React.useRef(hitlStates);\n  hitlStatesRef.current = hitlStates;\n\n  const mountedRef = React.useRef(true);\n  const clientRef = React.useRef(client);\n  clientRef.current = client;\n  const bootstrapPromiseRef = React.useRef<{ client: AgentClient; promise: Promise<void> } | null>(null);\n  React.useEffect(() => {\n    mountedRef.current = true;\n    return () => { mountedRef.current = false; };\n  }, []);\n\n  const previousControlledThreadRef = React.useRef(activeThreadId);\n  const controlledSyncTargetRef = React.useRef<{ value: string | null } | null>(null);\n  const previousControllerThreadRef = React.useRef(controller.activeThreadId);\n  const pendingThreadTransitionRef = React.useRef<PendingThreadTransition | null>(null);\n  const lastReportedThreadRef = React.useRef<string | null>(activeThreadId ?? controller.activeThreadId);\n  if (activeThreadId !== previousControlledThreadRef.current) {\n    previousControlledThreadRef.current = activeThreadId;\n    if (activeThreadId !== undefined) {\n      controlledSyncTargetRef.current = { value: activeThreadId };\n      lastReportedThreadRef.current = activeThreadId;\n    }\n  }\n\n  const reportActiveThread = React.useCallback((\n    threadId: string | null,\n    reason: AgentChatThreadChangeReason,\n  ) => {\n    if (lastReportedThreadRef.current === threadId) return;\n    lastReportedThreadRef.current = threadId;\n    onActiveThreadIdChange?.({ threadId, reason });\n  }, [onActiveThreadIdChange]);\n\n  const retryBootstrap = React.useCallback((): Promise<void> => {\n    if (bootstrapPromiseRef.current?.client === client) return bootstrapPromiseRef.current.promise;\n    const requestClient = client;\n    const request = (async () => {\n      if (mountedRef.current) {\n        setIsBootstrapping(true);\n        setBootstrapError(null);\n        setBootstrap(null);\n        setEffectivePolicy(null);\n      }\n      try {\n        const result = await requestClient.bootstrap();\n        if (!mountedRef.current || clientRef.current !== requestClient) return;\n        setBootstrap(result);\n        const entitlement = await requestClient.resourcePolicies.getEffective();\n        if (!mountedRef.current || clientRef.current !== requestClient) return;\n        setEffectivePolicy(entitlement);\n        const availableModels = modelsFromEffectivePolicy(entitlement);\n        if (modelId === undefined) {\n          setSelectedModelId((current) => availableModels.models.some((item) => item.id === current)\n            ? current\n            : availableModels.defaultModelId);\n        }\n        await controller.refreshThreads().catch(() => undefined);\n      } catch (error) {\n        if (mountedRef.current && clientRef.current === requestClient) setBootstrapError(error);\n      } finally {\n        if (mountedRef.current && clientRef.current === requestClient) setIsBootstrapping(false);\n      }\n    })();\n    bootstrapPromiseRef.current = { client: requestClient, promise: request };\n    void request.finally(() => {\n      if (bootstrapPromiseRef.current?.promise === request) bootstrapPromiseRef.current = null;\n    });\n    return request;\n  }, [client, controller.refreshThreads, modelId]);\n\n  const refreshEffectivePolicy = React.useCallback(async () => {\n    const entitlement = await client.resourcePolicies.getEffective();\n    if (!mountedRef.current || clientRef.current !== client) return;\n    setEffectivePolicy(entitlement);\n    if (modelId === undefined) {\n      const available = modelsFromEffectivePolicy(entitlement);\n      setSelectedModelId((current) => available.models.some((item) => item.id === current)\n        ? current\n        : available.defaultModelId);\n    }\n  }, [client, modelId]);\n\n  React.useEffect(() => {\n    void retryBootstrap();\n  }, [retryBootstrap]);\n\n  React.useEffect(() => {\n    if (modelId !== undefined) setSelectedModelId(modelId);\n  }, [modelId]);\n\n  React.useEffect(() => {\n    hitlStatesRef.current = {};\n    setHitlStates({});\n  }, [client, controller.activeThreadId]);\n\n  React.useEffect(() => {\n    if (controlledSyncTargetRef.current?.value === null && controller.activeThreadId) {\n      controller.startNewThread();\n    }\n  }, [activeThreadId, controller.activeThreadId, controller.startNewThread]);\n\n  React.useEffect(() => {\n    const previous = previousControllerThreadRef.current;\n    const current = controller.activeThreadId;\n    previousControllerThreadRef.current = current;\n    const controlledTarget = controlledSyncTargetRef.current;\n    if (controlledTarget) {\n      if (current === controlledTarget.value) controlledSyncTargetRef.current = null;\n      return;\n    }\n    const pendingTransition = pendingThreadTransitionRef.current;\n    if (pendingTransition && current === pendingTransition.value) return;\n    if (previous === null && current !== null) reportActiveThread(current, \"created\");\n  }, [activeThreadId, controller.activeThreadId, reportActiveThread]);\n\n  const clearOperationError = React.useCallback(() => {\n    setLocalOperationError(null);\n    controller.clearOperationError();\n  }, [controller.clearOperationError]);\n\n  const submit = React.useCallback((input: AgentChatRuntimeSubmit): Promise<void> => {\n    if (submitPromiseRef.current) return submitPromiseRef.current;\n    clearOperationError();\n    setIsSubmitting(true);\n    const request = (async () => {\n      try {\n        if (!bootstrap) throw new Error(\"The agent input contract is unavailable.\");\n        const inputError = validateAgentChatSubmission(bootstrap.features.inputs, input.text, input.files || []);\n        if (inputError) throw new Error(inputError);\n        const uploaded = input.files?.length\n          ? await attachments.uploadBatch({\n              uploads: input.files,\n              threadId: controller.activeThreadId || undefined,\n            })\n          : [];\n        await controller.submit({\n          text: input.text,\n          attachmentIds: uploaded.flatMap((attachment) => attachment.id ? [attachment.id] : []),\n          attachments: uploaded,\n          requestedModelId: selectedModelId || undefined,\n        });\n      } catch (error) {\n        setLocalOperationError(error);\n        const typed = error as Partial<Agents24ClientError>;\n        if (typed.kind === \"quota\" || typed.kind === \"authorization\") {\n          await refreshEffectivePolicy().catch(() => undefined);\n        }\n        throw error;\n      } finally {\n        setIsSubmitting(false);\n      }\n    })();\n    submitPromiseRef.current = request;\n    const clearRequest = () => {\n      if (submitPromiseRef.current === request) submitPromiseRef.current = null;\n    };\n    void request.then(clearRequest, clearRequest);\n    return request;\n  }, [attachments, bootstrap, clearOperationError, controller.activeThreadId, controller.submit, refreshEffectivePolicy, selectedModelId]);\n\n  const completeMcp = React.useCallback(async (part: ChatHitlPart) => {\n    if (!mcpRedirectUri) throw new Error(\"mcpRedirectUri is required for MCP Connect.\");\n    const serverId = String(part.presentation.server_id || \"\").trim();\n    if (!serverId) throw new Error(\"MCP authorization is missing its server identity.\");\n    const runId = controller.activeRunId || controller.messages.find((message) => message.parts.includes(part))?.runId;\n    if (!runId) throw new Error(\"MCP authorization is missing its paused run.\");\n    const popupNonce = browserChatCrypto().randomUUID();\n    const proof = await createMcpPkceProof();\n    const popup = window.open(\"about:blank\", \"agents24-mcp\", \"popup,width=560,height=720\");\n    if (!popup) throw new Error(\"Allow popups to connect this MCP account.\");\n    popup.document.title = \"Connecting to MCP\";\n    popup.document.body.textContent = \"Opening secure connection…\";\n    try {\n      const started = await mcp.startAuthorization({\n        runId,\n        serverId,\n        interruptId: part.interruptId,\n        redirectUri: mcpRedirectUri,\n        popupNonce,\n        codeChallenge: proof.challenge,\n      });\n      if (!started.callback_origin) throw new Error(\"MCP authorization did not return a callback origin.\");\n      popup.location.replace(started.authorization_url);\n      const completion = await waitForMcpOauthComplete({\n        popup,\n        callbackOrigin: started.callback_origin,\n        popupNonce,\n        requireConnectionId: Boolean(completeMcpAuthorization),\n        serverId,\n      });\n      if (completeMcpAuthorization) {\n        await completeMcpAuthorization({ completion, codeVerifier: proof.verifier, serverId });\n      } else {\n        const redeemed = await mcp.redeemCallback({ code: completion.code, codeVerifier: proof.verifier });\n        validateMcpCallbackResult(redeemed, serverId);\n      }\n    } finally {\n      popup.close();\n    }\n  }, [completeMcpAuthorization, controller.activeRunId, controller.messages, mcp, mcpRedirectUri]);\n\n  const onHitlAction = React.useCallback(async (part: ChatHitlPart, response: HitlResponse) => {\n    const action = response.action;\n    const key = hitlKey(part);\n    const current = hitlStatesRef.current[key];\n    if (current?.status === \"connecting\" || current?.status === \"resuming\") return;\n    clearOperationError();\n    const pending: AgentChatRuntimeHitlActionState = {\n      action,\n      status: part.hitlKind === \"mcp_auth\" && action === \"connect\" ? \"connecting\" : \"resuming\",\n    };\n    hitlStatesRef.current = { ...hitlStatesRef.current, [key]: pending };\n    setHitlStates(hitlStatesRef.current);\n    try {\n      if (part.hitlKind === \"mcp_auth\" && action === \"connect\") await completeMcp(part);\n      await controller.resumeHitl(part, response);\n      setHitlStates((states) => {\n        const next = { ...states };\n        delete next[key];\n        hitlStatesRef.current = next;\n        return next;\n      });\n    } catch (error) {\n      setLocalOperationError(error);\n      const failedState = {\n        ...hitlStatesRef.current,\n        [key]: { action, error: agentChatRuntimeErrorMessage(error), status: \"error\" },\n      } satisfies Record<string, AgentChatRuntimeHitlActionState>;\n      hitlStatesRef.current = failedState;\n      setHitlStates(failedState);\n      throw error;\n    }\n  }, [clearOperationError, completeMcp, controller.resumeHitl]);\n\n  const newThread = React.useCallback(() => {\n    clearOperationError();\n    pendingThreadTransitionRef.current = null;\n    reportActiveThread(null, \"new\");\n    controller.startNewThread();\n  }, [clearOperationError, controller.startNewThread, reportActiveThread]);\n\n  const openThread = React.useCallback(async (threadId: string) => {\n    clearOperationError();\n    pendingThreadTransitionRef.current = { reason: \"opened\", value: threadId };\n    try {\n      await controller.openThread(threadId);\n      reportActiveThread(threadId, \"opened\");\n    } catch (error) {\n      setLocalOperationError(error);\n      throw error;\n    } finally {\n      if (pendingThreadTransitionRef.current?.value === threadId) pendingThreadTransitionRef.current = null;\n    }\n  }, [clearOperationError, controller.openThread, reportActiveThread]);\n\n  const deleteThread = React.useCallback(async (threadId: string) => {\n    clearOperationError();\n    const wasActive = controller.activeThreadId === threadId;\n    if (wasActive) pendingThreadTransitionRef.current = { reason: \"deleted\", value: null };\n    try {\n      await controller.deleteThread(threadId);\n      if (wasActive) reportActiveThread(null, \"deleted\");\n    } catch (error) {\n      setLocalOperationError(error);\n      throw error;\n    } finally {\n      if (wasActive && pendingThreadTransitionRef.current?.reason === \"deleted\") {\n        pendingThreadTransitionRef.current = null;\n      }\n    }\n  }, [clearOperationError, controller.activeThreadId, controller.deleteThread, reportActiveThread]);\n\n  const changeModel = React.useCallback((nextModelId: string) => {\n    if (modelId === undefined) setSelectedModelId(nextModelId);\n    onModelChange?.(nextModelId);\n  }, [modelId, onModelChange]);\n\n  const modelOptions = effectivePolicy\n    ? modelsFromEffectivePolicy(effectivePolicy).models\n    : bootstrap\n      ? modelsFromAgentChatBootstrap(bootstrap).models\n      : [];\n  const fatalError = bootstrapError || controller.error;\n  const operationError = localOperationError || controller.operationError?.cause;\n  const state: AgentChatRuntimeViewState = isBootstrapping\n    ? \"loading\"\n    : fatalError\n      ? agentChatRuntimeStateFromError(fatalError)\n      : controller.runState === \"streaming\"\n        ? \"streaming\"\n        : controller.runState === \"reconnecting\"\n          ? \"reconnecting\"\n          : controller.runState === \"paused\"\n            ? \"paused\"\n            : controller.runState === \"cancelling\"\n              ? \"cancelling\"\n              : controller.runState === \"cancelled\"\n                ? \"cancelled\"\n            : \"ready\";\n  const connectionState: AgentChatRuntimeConnectionState = state === \"offline\"\n    ? \"offline\"\n    : state === \"expired\"\n      ? \"expired\"\n      : state === \"reconnecting\"\n        ? \"reconnecting\"\n        : isBootstrapping\n          ? \"connecting\"\n          : \"connected\";\n  return {\n    agent: agentOverride || { name: bootstrap?.deployment.name || \"Agent\" },\n    inputContract: bootstrap?.features.inputs || null,\n    allowFeedback: Boolean(bootstrap?.capabilities.includes(\"feedback.write\")),\n    backgroundError: controller.backgroundError?.cause || null,\n    bootstrap,\n    capabilities: bootstrap?.capabilities || [],\n    changeModel,\n    clearOperationError,\n    connectionState,\n    contextWindow: controller.contextWindow,\n    contextCompression: controller.contextCompression,\n    controller,\n    deleteThread,\n    errorMessage: agentChatRuntimeErrorMessage(fatalError || operationError),\n    fatalError,\n    getHitlActionState: (part) => hitlStates[hitlKey(part)],\n    isBootstrapping,\n    isSubmitting: isSubmitting || controller.isSubmitting,\n    isUploading: attachments.isUploading,\n    modelId: selectedModelId,\n    models: modelOptions,\n    newThread,\n    onHitlAction,\n    openThread,\n    operationError,\n    retryBootstrap,\n    state,\n    submit,\n  };\n}\n","import type { McpCallbackResult } from \"@agents24/client\";\nimport type { ChatMcpOauthCompletion, WaitForMcpOauthCompleteInput } from \"./types\";\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\ntype CryptoLike = {\n  getRandomValues<T extends Uint8Array>(array: T): T;\n  randomUUID(): string;\n  subtle: { digest(algorithm: string, data: Uint8Array): Promise<ArrayBuffer> };\n};\n\nexport function browserChatCrypto(): CryptoLike {\n  const value = (globalThis as unknown as { crypto?: CryptoLike }).crypto;\n  if (!value?.subtle || !value.randomUUID) {\n    throw new Error(\"Secure browser crypto is required for MCP authorization.\");\n  }\n  return value;\n}\n\nfunction base64Url(bytes: Uint8Array): string {\n  let binary = \"\";\n  bytes.forEach((byte) => { binary += String.fromCharCode(byte); });\n  return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/g, \"\");\n}\n\nexport async function createMcpPkceProof(): Promise<{ challenge: string; verifier: string }> {\n  const crypto = browserChatCrypto();\n  const verifier = base64Url(crypto.getRandomValues(new Uint8Array(32)));\n  const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(verifier));\n  return { challenge: base64Url(new Uint8Array(digest)), verifier };\n}\n\nfunction isLoopback(hostname: string): boolean {\n  return hostname === \"localhost\" || hostname === \"127.0.0.1\" || hostname === \"[::1]\";\n}\n\nfunction normalizedOrigin(value: string): string {\n  try {\n    const url = new URL(value);\n    if (url.protocol !== \"https:\" && !(url.protocol === \"http:\" && isLoopback(url.hostname))) {\n      throw new Error(\"unsafe callback origin\");\n    }\n    if (url.origin === \"null\") throw new Error(\"opaque callback origin\");\n    return url.origin;\n  } catch {\n    throw new Error(\"MCP authorization returned an invalid callback origin.\");\n  }\n}\n\nexport function validateMcpCallbackResult(\n  result: McpCallbackResult,\n  expectedServerId: string,\n): McpCallbackResult {\n  const serverId = String(result.server_id || \"\").trim();\n  const connectionId = String(result.connection_id || \"\").trim();\n  if (!serverId || serverId !== expectedServerId) {\n    throw new Error(\"MCP authorization completed for an unexpected server.\");\n  }\n  if (!UUID_PATTERN.test(connectionId)) {\n    throw new Error(\"MCP authorization returned an invalid connection identity.\");\n  }\n  return result;\n}\n\nexport function waitForMcpOauthComplete({\n  popup,\n  callbackOrigin,\n  popupNonce,\n  requireConnectionId = false,\n  serverId,\n  timeoutMs = 120_000,\n}: WaitForMcpOauthCompleteInput): Promise<ChatMcpOauthCompletion> {\n  if (!popup) return Promise.reject(new Error(\"Could not open the MCP authorization popup.\"));\n  const expectedOrigin = normalizedOrigin(callbackOrigin);\n  const expectedServerId = String(serverId || \"\").trim();\n  const expectedPopupNonce = String(popupNonce || \"\").trim();\n  if (!expectedServerId) return Promise.reject(new Error(\"MCP authorization is missing its server identity.\"));\n  if (!expectedPopupNonce) return Promise.reject(new Error(\"MCP authorization is missing its popup binding.\"));\n  const returnFocusTo = typeof document !== \"undefined\"\n    ? document.activeElement as { focus?: () => void } | null\n    : null;\n\n  return new Promise((resolve, reject) => {\n    let settled = false;\n    const finish = (result: ChatMcpOauthCompletion | Error) => {\n      if (settled) return;\n      settled = true;\n      window.clearTimeout(timeout);\n      window.clearInterval(closeTimer);\n      window.removeEventListener(\"message\", onMessage);\n      returnFocusTo?.focus?.();\n      if (result instanceof Error) reject(result);\n      else resolve(result);\n    };\n    const onMessage = (event: MessageEvent) => {\n      if (event.source !== popup || event.origin !== expectedOrigin) return;\n      const data = event.data as {\n        type?: string;\n        code?: string;\n        connection_id?: string;\n        popup_nonce?: string;\n        server_id?: string;\n      } | null;\n      if (\n        data?.type !== \"agents24.mcp.callback\" ||\n        data.server_id !== expectedServerId ||\n        data.popup_nonce !== expectedPopupNonce\n      ) return;\n      const code = String(data.code || \"\").trim();\n      if (!code || code.length > 2048) return;\n      const connectionId = String(data.connection_id || \"\").trim();\n      if ((requireConnectionId || connectionId) && !UUID_PATTERN.test(connectionId)) return;\n      finish({\n        code,\n        ...(connectionId ? { connectionId } : {}),\n        popupNonce: expectedPopupNonce,\n        serverId: expectedServerId,\n      });\n    };\n    const timeout = window.setTimeout(\n      () => finish(new Error(\"MCP authorization timed out.\")),\n      Math.max(1, timeoutMs),\n    );\n    const closeTimer = window.setInterval(() => {\n      if (popup.closed) finish(new Error(\"MCP authorization window was closed before connecting.\"));\n    }, 500);\n    window.addEventListener(\"message\", onMessage);\n  });\n}\n","import type { ClientInputFeature, PortableUpload } from \"@agents24/client\";\n\nexport type AgentChatInputContract = ClientInputFeature;\n\nexport const SUPPORTED_INPUT_MIME_TYPES = {\n  files: [\"application/pdf\", \"text/plain\", \"text/markdown\", \"text/csv\", \"application/json\"],\n  images: [\"image/png\", \"image/jpeg\", \"image/webp\"],\n  audio: [\"audio/wav\", \"audio/mpeg\", \"audio/webm\", \"audio/mp4\"],\n} as const;\n\nexport type WorkflowInputRule = {\n  key: string;\n  enabled?: boolean;\n  required?: boolean;\n};\n\nexport function workflowInputRule(\n  inputs: readonly WorkflowInputRule[] | null | undefined,\n  key: string,\n): { enabled: boolean; required: boolean } {\n  const input = inputs?.find((candidate) => candidate.key === key);\n  return {\n    enabled: input?.enabled !== false,\n    required: input?.required === true,\n  };\n}\n\nexport function validateWorkflowInputSubmission(\n  inputs: readonly WorkflowInputRule[] | null | undefined,\n  text: string,\n  attachmentMimeTypes: readonly string[],\n): string | null {\n  const present = { files: false, images: false, audio: false };\n  if (text.trim() && !workflowInputRule(inputs, \"text\").enabled) {\n    return \"This workflow does not accept text input.\";\n  }\n  for (const rawMimeType of attachmentMimeTypes) {\n    const mimeType = canonicalInputMimeType(rawMimeType);\n    const modality = mimeType.startsWith(\"image/\") ? \"images\" : mimeType.startsWith(\"audio/\") ? \"audio\" : \"files\";\n    const supported = (SUPPORTED_INPUT_MIME_TYPES[modality] as readonly string[]).includes(mimeType);\n    if (!supported || !workflowInputRule(inputs, modality).enabled) {\n      return `The attachment type ${mimeType || \"unknown\"} is not accepted.`;\n    }\n    present[modality] = true;\n  }\n  if (workflowInputRule(inputs, \"text\").required && !text.trim()) return \"Text input is required.\";\n  for (const modality of [\"files\", \"images\", \"audio\"] as const) {\n    if (workflowInputRule(inputs, modality).required && !present[modality]) {\n      return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;\n    }\n  }\n  return null;\n}\n\nexport function canonicalInputMimeType(value: string): string {\n  const normalized = value.split(\";\", 1)[0]?.trim().toLowerCase() || \"\";\n  if (normalized === \"image/jpg\") return \"image/jpeg\";\n  if ([\"audio/x-wav\"].includes(normalized)) return \"audio/wav\";\n  if ([\"audio/x-m4a\", \"audio/m4a\"].includes(normalized)) return \"audio/mp4\";\n  return normalized;\n}\n\nfunction uploadByteSize(data: PortableUpload[\"data\"]): number {\n  if (data instanceof Uint8Array || data instanceof ArrayBuffer) return data.byteLength;\n  return data.size;\n}\n\nexport function inputMimeTypes(contract: AgentChatInputContract | null | undefined): string[] {\n  if (!contract) return [];\n  return [\n    ...contract.modalities.files.allowed_mime_types,\n    ...contract.modalities.images.allowed_mime_types,\n    ...contract.modalities.audio.allowed_mime_types,\n  ];\n}\n\nexport function validateAgentChatSubmission(\n  contract: AgentChatInputContract,\n  text: string,\n  files: readonly Pick<PortableUpload, \"mediaType\" | \"data\">[],\n): string | null {\n  const { modalities, limits } = contract;\n  const normalizedText = text.trim();\n  if (normalizedText && !modalities.text.enabled) return \"This agent does not accept text input.\";\n  if (modalities.text.required && !normalizedText) return \"Text input is required.\";\n  if (files.length > limits.max_attachments_per_turn) {\n    return `You can attach up to ${limits.max_attachments_per_turn} items per message.`;\n  }\n  let totalBytes = 0;\n  const present = { files: false, images: false, audio: false };\n  for (const file of files) {\n    const mediaType = canonicalInputMimeType(file.mediaType);\n    const modality = mediaType.startsWith(\"image/\") ? \"images\" : mediaType.startsWith(\"audio/\") ? \"audio\" : \"files\";\n    const rule = modalities[modality];\n    if (!rule.enabled || !rule.allowed_mime_types.includes(mediaType)) {\n      return `The attachment type ${mediaType || \"unknown\"} is not accepted.`;\n    }\n    const byteSize = uploadByteSize(file.data);\n    if (byteSize > limits.max_file_bytes) return \"An attachment exceeds the per-file size limit.\";\n    totalBytes += byteSize;\n    present[modality] = true;\n  }\n  if (totalBytes > limits.max_total_bytes) return \"Attachments exceed the total size limit.\";\n  for (const modality of [\"files\", \"images\", \"audio\"] as const) {\n    if (modalities[modality].required && !present[modality]) return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./use-agent-chat-runtime";
+export * from "./input-contract";

package/dist/runtime/index.js

@@ -0,0 +1,458 @@
+import {
+  browserChatCrypto,
+  createMcpPkceProof,
+  validateMcpCallbackResult,
+  waitForMcpOauthComplete
+} from "../chunk-ZCNHLFRB.js";
+
+// src/runtime/use-agent-chat-runtime.ts
+import {
+  useAgentAttachments,
+  useAgentChat,
+  useAgentMcp
+} from "@agents24/react";
+import * as React from "react";
+
+// src/runtime/input-contract.ts
+var SUPPORTED_INPUT_MIME_TYPES = {
+  files: ["application/pdf", "text/plain", "text/markdown", "text/csv", "application/json"],
+  images: ["image/png", "image/jpeg", "image/webp"],
+  audio: ["audio/wav", "audio/mpeg", "audio/webm", "audio/mp4"]
+};
+function workflowInputRule(inputs, key) {
+  const input = inputs?.find((candidate) => candidate.key === key);
+  return {
+    enabled: input?.enabled !== false,
+    required: input?.required === true
+  };
+}
+function validateWorkflowInputSubmission(inputs, text, attachmentMimeTypes) {
+  const present = { files: false, images: false, audio: false };
+  if (text.trim() && !workflowInputRule(inputs, "text").enabled) {
+    return "This workflow does not accept text input.";
+  }
+  for (const rawMimeType of attachmentMimeTypes) {
+    const mimeType = canonicalInputMimeType(rawMimeType);
+    const modality = mimeType.startsWith("image/") ? "images" : mimeType.startsWith("audio/") ? "audio" : "files";
+    const supported = SUPPORTED_INPUT_MIME_TYPES[modality].includes(mimeType);
+    if (!supported || !workflowInputRule(inputs, modality).enabled) {
+      return `The attachment type ${mimeType || "unknown"} is not accepted.`;
+    }
+    present[modality] = true;
+  }
+  if (workflowInputRule(inputs, "text").required && !text.trim()) return "Text input is required.";
+  for (const modality of ["files", "images", "audio"]) {
+    if (workflowInputRule(inputs, modality).required && !present[modality]) {
+      return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;
+    }
+  }
+  return null;
+}
+function canonicalInputMimeType(value) {
+  const normalized = value.split(";", 1)[0]?.trim().toLowerCase() || "";
+  if (normalized === "image/jpg") return "image/jpeg";
+  if (["audio/x-wav"].includes(normalized)) return "audio/wav";
+  if (["audio/x-m4a", "audio/m4a"].includes(normalized)) return "audio/mp4";
+  return normalized;
+}
+function uploadByteSize(data) {
+  if (data instanceof Uint8Array || data instanceof ArrayBuffer) return data.byteLength;
+  return data.size;
+}
+function inputMimeTypes(contract) {
+  if (!contract) return [];
+  return [
+    ...contract.modalities.files.allowed_mime_types,
+    ...contract.modalities.images.allowed_mime_types,
+    ...contract.modalities.audio.allowed_mime_types
+  ];
+}
+function validateAgentChatSubmission(contract, text, files) {
+  const { modalities, limits } = contract;
+  const normalizedText = text.trim();
+  if (normalizedText && !modalities.text.enabled) return "This agent does not accept text input.";
+  if (modalities.text.required && !normalizedText) return "Text input is required.";
+  if (files.length > limits.max_attachments_per_turn) {
+    return `You can attach up to ${limits.max_attachments_per_turn} items per message.`;
+  }
+  let totalBytes = 0;
+  const present = { files: false, images: false, audio: false };
+  for (const file of files) {
+    const mediaType = canonicalInputMimeType(file.mediaType);
+    const modality = mediaType.startsWith("image/") ? "images" : mediaType.startsWith("audio/") ? "audio" : "files";
+    const rule = modalities[modality];
+    if (!rule.enabled || !rule.allowed_mime_types.includes(mediaType)) {
+      return `The attachment type ${mediaType || "unknown"} is not accepted.`;
+    }
+    const byteSize = uploadByteSize(file.data);
+    if (byteSize > limits.max_file_bytes) return "An attachment exceeds the per-file size limit.";
+    totalBytes += byteSize;
+    present[modality] = true;
+  }
+  if (totalBytes > limits.max_total_bytes) return "Attachments exceed the total size limit.";
+  for (const modality of ["files", "images", "audio"]) {
+    if (modalities[modality].required && !present[modality]) return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;
+  }
+  return null;
+}
+
+// src/runtime/use-agent-chat-runtime.ts
+function agentChatRuntimeStateFromError(error) {
+  const typed = error;
+  if (typed?.kind === "authentication") return "expired";
+  if (typed?.kind === "authorization") return "denied";
+  if (typed?.kind === "quota" || typed?.kind === "rate_limit") return "quota";
+  if (typed?.kind === "network") return "offline";
+  return "failed";
+}
+function agentChatRuntimeErrorMessage(error) {
+  if (!error) return null;
+  return error instanceof Error ? error.message : String(error);
+}
+function modelsFromAgentChatBootstrap(bootstrap) {
+  const modelFeatures = bootstrap.features.models;
+  const selectable = bootstrap.capabilities.includes("models.select") && modelFeatures?.selectable === true;
+  if (!selectable) return { defaultModelId: null, models: [] };
+  const models = Array.isArray(modelFeatures.options) ? modelFeatures.options.flatMap((option) => typeof option?.id === "string" && option.id.trim() ? [{ id: option.id, label: typeof option.label === "string" && option.label.trim() ? option.label : option.id }] : []) : [];
+  const configuredDefault = models.some((model) => model.id === modelFeatures.default_id) ? modelFeatures.default_id : null;
+  return {
+    defaultModelId: configuredDefault,
+    models
+  };
+}
+function modelsFromEffectivePolicy(policy) {
+  const models = policy.model_selection.selectable ? policy.model_selection.options.map((option) => ({ id: option.id, label: option.label })) : [];
+  return {
+    defaultModelId: models.some((model) => model.id === policy.model_selection.default_id) ? policy.model_selection.default_id : null,
+    models
+  };
+}
+function hitlKey(part) {
+  return part.interruptId || part.id;
+}
+function useAgentChatRuntime(options) {
+  const {
+    activeThreadId,
+    agent: agentOverride,
+    client,
+    completeMcpAuthorization,
+    mcpRedirectUri,
+    modelId,
+    onActiveThreadIdChange,
+    onModelChange
+  } = options;
+  const controller = useAgentChat(
+    activeThreadId === void 0 ? { client } : { activeThreadId, client }
+  );
+  const attachments = useAgentAttachments();
+  const mcp = useAgentMcp();
+  const [bootstrap, setBootstrap] = React.useState(null);
+  const [effectivePolicy, setEffectivePolicy] = React.useState(null);
+  const [isBootstrapping, setIsBootstrapping] = React.useState(true);
+  const [bootstrapError, setBootstrapError] = React.useState(null);
+  const [localOperationError, setLocalOperationError] = React.useState(null);
+  const [selectedModelId, setSelectedModelId] = React.useState(modelId ?? null);
+  const [isSubmitting, setIsSubmitting] = React.useState(false);
+  const submitPromiseRef = React.useRef(null);
+  const [hitlStates, setHitlStates] = React.useState({});
+  const hitlStatesRef = React.useRef(hitlStates);
+  hitlStatesRef.current = hitlStates;
+  const mountedRef = React.useRef(true);
+  const clientRef = React.useRef(client);
+  clientRef.current = client;
+  const bootstrapPromiseRef = React.useRef(null);
+  React.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const previousControlledThreadRef = React.useRef(activeThreadId);
+  const controlledSyncTargetRef = React.useRef(null);
+  const previousControllerThreadRef = React.useRef(controller.activeThreadId);
+  const pendingThreadTransitionRef = React.useRef(null);
+  const lastReportedThreadRef = React.useRef(activeThreadId ?? controller.activeThreadId);
+  if (activeThreadId !== previousControlledThreadRef.current) {
+    previousControlledThreadRef.current = activeThreadId;
+    if (activeThreadId !== void 0) {
+      controlledSyncTargetRef.current = { value: activeThreadId };
+      lastReportedThreadRef.current = activeThreadId;
+    }
+  }
+  const reportActiveThread = React.useCallback((threadId, reason) => {
+    if (lastReportedThreadRef.current === threadId) return;
+    lastReportedThreadRef.current = threadId;
+    onActiveThreadIdChange?.({ threadId, reason });
+  }, [onActiveThreadIdChange]);
+  const retryBootstrap = React.useCallback(() => {
+    if (bootstrapPromiseRef.current?.client === client) return bootstrapPromiseRef.current.promise;
+    const requestClient = client;
+    const request = (async () => {
+      if (mountedRef.current) {
+        setIsBootstrapping(true);
+        setBootstrapError(null);
+        setBootstrap(null);
+        setEffectivePolicy(null);
+      }
+      try {
+        const result = await requestClient.bootstrap();
+        if (!mountedRef.current || clientRef.current !== requestClient) return;
+        setBootstrap(result);
+        const entitlement = await requestClient.resourcePolicies.getEffective();
+        if (!mountedRef.current || clientRef.current !== requestClient) return;
+        setEffectivePolicy(entitlement);
+        const availableModels = modelsFromEffectivePolicy(entitlement);
+        if (modelId === void 0) {
+          setSelectedModelId((current) => availableModels.models.some((item) => item.id === current) ? current : availableModels.defaultModelId);
+        }
+        await controller.refreshThreads().catch(() => void 0);
+      } catch (error) {
+        if (mountedRef.current && clientRef.current === requestClient) setBootstrapError(error);
+      } finally {
+        if (mountedRef.current && clientRef.current === requestClient) setIsBootstrapping(false);
+      }
+    })();
+    bootstrapPromiseRef.current = { client: requestClient, promise: request };
+    void request.finally(() => {
+      if (bootstrapPromiseRef.current?.promise === request) bootstrapPromiseRef.current = null;
+    });
+    return request;
+  }, [client, controller.refreshThreads, modelId]);
+  const refreshEffectivePolicy = React.useCallback(async () => {
+    const entitlement = await client.resourcePolicies.getEffective();
+    if (!mountedRef.current || clientRef.current !== client) return;
+    setEffectivePolicy(entitlement);
+    if (modelId === void 0) {
+      const available = modelsFromEffectivePolicy(entitlement);
+      setSelectedModelId((current) => available.models.some((item) => item.id === current) ? current : available.defaultModelId);
+    }
+  }, [client, modelId]);
+  React.useEffect(() => {
+    void retryBootstrap();
+  }, [retryBootstrap]);
+  React.useEffect(() => {
+    if (modelId !== void 0) setSelectedModelId(modelId);
+  }, [modelId]);
+  React.useEffect(() => {
+    hitlStatesRef.current = {};
+    setHitlStates({});
+  }, [client, controller.activeThreadId]);
+  React.useEffect(() => {
+    if (controlledSyncTargetRef.current?.value === null && controller.activeThreadId) {
+      controller.startNewThread();
+    }
+  }, [activeThreadId, controller.activeThreadId, controller.startNewThread]);
+  React.useEffect(() => {
+    const previous = previousControllerThreadRef.current;
+    const current = controller.activeThreadId;
+    previousControllerThreadRef.current = current;
+    const controlledTarget = controlledSyncTargetRef.current;
+    if (controlledTarget) {
+      if (current === controlledTarget.value) controlledSyncTargetRef.current = null;
+      return;
+    }
+    const pendingTransition = pendingThreadTransitionRef.current;
+    if (pendingTransition && current === pendingTransition.value) return;
+    if (previous === null && current !== null) reportActiveThread(current, "created");
+  }, [activeThreadId, controller.activeThreadId, reportActiveThread]);
+  const clearOperationError = React.useCallback(() => {
+    setLocalOperationError(null);
+    controller.clearOperationError();
+  }, [controller.clearOperationError]);
+  const submit = React.useCallback((input) => {
+    if (submitPromiseRef.current) return submitPromiseRef.current;
+    clearOperationError();
+    setIsSubmitting(true);
+    const request = (async () => {
+      try {
+        if (!bootstrap) throw new Error("The agent input contract is unavailable.");
+        const inputError = validateAgentChatSubmission(bootstrap.features.inputs, input.text, input.files || []);
+        if (inputError) throw new Error(inputError);
+        const uploaded = input.files?.length ? await attachments.uploadBatch({
+          uploads: input.files,
+          threadId: controller.activeThreadId || void 0
+        }) : [];
+        await controller.submit({
+          text: input.text,
+          attachmentIds: uploaded.flatMap((attachment) => attachment.id ? [attachment.id] : []),
+          attachments: uploaded,
+          requestedModelId: selectedModelId || void 0
+        });
+      } catch (error) {
+        setLocalOperationError(error);
+        const typed = error;
+        if (typed.kind === "quota" || typed.kind === "authorization") {
+          await refreshEffectivePolicy().catch(() => void 0);
+        }
+        throw error;
+      } finally {
+        setIsSubmitting(false);
+      }
+    })();
+    submitPromiseRef.current = request;
+    const clearRequest = () => {
+      if (submitPromiseRef.current === request) submitPromiseRef.current = null;
+    };
+    void request.then(clearRequest, clearRequest);
+    return request;
+  }, [attachments, bootstrap, clearOperationError, controller.activeThreadId, controller.submit, refreshEffectivePolicy, selectedModelId]);
+  const completeMcp = React.useCallback(async (part) => {
+    if (!mcpRedirectUri) throw new Error("mcpRedirectUri is required for MCP Connect.");
+    const serverId = String(part.presentation.server_id || "").trim();
+    if (!serverId) throw new Error("MCP authorization is missing its server identity.");
+    const runId = controller.activeRunId || controller.messages.find((message) => message.parts.includes(part))?.runId;
+    if (!runId) throw new Error("MCP authorization is missing its paused run.");
+    const popupNonce = browserChatCrypto().randomUUID();
+    const proof = await createMcpPkceProof();
+    const popup = window.open("about:blank", "agents24-mcp", "popup,width=560,height=720");
+    if (!popup) throw new Error("Allow popups to connect this MCP account.");
+    popup.document.title = "Connecting to MCP";
+    popup.document.body.textContent = "Opening secure connection\u2026";
+    try {
+      const started = await mcp.startAuthorization({
+        runId,
+        serverId,
+        interruptId: part.interruptId,
+        redirectUri: mcpRedirectUri,
+        popupNonce,
+        codeChallenge: proof.challenge
+      });
+      if (!started.callback_origin) throw new Error("MCP authorization did not return a callback origin.");
+      popup.location.replace(started.authorization_url);
+      const completion = await waitForMcpOauthComplete({
+        popup,
+        callbackOrigin: started.callback_origin,
+        popupNonce,
+        requireConnectionId: Boolean(completeMcpAuthorization),
+        serverId
+      });
+      if (completeMcpAuthorization) {
+        await completeMcpAuthorization({ completion, codeVerifier: proof.verifier, serverId });
+      } else {
+        const redeemed = await mcp.redeemCallback({ code: completion.code, codeVerifier: proof.verifier });
+        validateMcpCallbackResult(redeemed, serverId);
+      }
+    } finally {
+      popup.close();
+    }
+  }, [completeMcpAuthorization, controller.activeRunId, controller.messages, mcp, mcpRedirectUri]);
+  const onHitlAction = React.useCallback(async (part, response) => {
+    const action = response.action;
+    const key = hitlKey(part);
+    const current = hitlStatesRef.current[key];
+    if (current?.status === "connecting" || current?.status === "resuming") return;
+    clearOperationError();
+    const pending = {
+      action,
+      status: part.hitlKind === "mcp_auth" && action === "connect" ? "connecting" : "resuming"
+    };
+    hitlStatesRef.current = { ...hitlStatesRef.current, [key]: pending };
+    setHitlStates(hitlStatesRef.current);
+    try {
+      if (part.hitlKind === "mcp_auth" && action === "connect") await completeMcp(part);
+      await controller.resumeHitl(part, response);
+      setHitlStates((states) => {
+        const next = { ...states };
+        delete next[key];
+        hitlStatesRef.current = next;
+        return next;
+      });
+    } catch (error) {
+      setLocalOperationError(error);
+      const failedState = {
+        ...hitlStatesRef.current,
+        [key]: { action, error: agentChatRuntimeErrorMessage(error), status: "error" }
+      };
+      hitlStatesRef.current = failedState;
+      setHitlStates(failedState);
+      throw error;
+    }
+  }, [clearOperationError, completeMcp, controller.resumeHitl]);
+  const newThread = React.useCallback(() => {
+    clearOperationError();
+    pendingThreadTransitionRef.current = null;
+    reportActiveThread(null, "new");
+    controller.startNewThread();
+  }, [clearOperationError, controller.startNewThread, reportActiveThread]);
+  const openThread = React.useCallback(async (threadId) => {
+    clearOperationError();
+    pendingThreadTransitionRef.current = { reason: "opened", value: threadId };
+    try {
+      await controller.openThread(threadId);
+      reportActiveThread(threadId, "opened");
+    } catch (error) {
+      setLocalOperationError(error);
+      throw error;
+    } finally {
+      if (pendingThreadTransitionRef.current?.value === threadId) pendingThreadTransitionRef.current = null;
+    }
+  }, [clearOperationError, controller.openThread, reportActiveThread]);
+  const deleteThread = React.useCallback(async (threadId) => {
+    clearOperationError();
+    const wasActive = controller.activeThreadId === threadId;
+    if (wasActive) pendingThreadTransitionRef.current = { reason: "deleted", value: null };
+    try {
+      await controller.deleteThread(threadId);
+      if (wasActive) reportActiveThread(null, "deleted");
+    } catch (error) {
+      setLocalOperationError(error);
+      throw error;
+    } finally {
+      if (wasActive && pendingThreadTransitionRef.current?.reason === "deleted") {
+        pendingThreadTransitionRef.current = null;
+      }
+    }
+  }, [clearOperationError, controller.activeThreadId, controller.deleteThread, reportActiveThread]);
+  const changeModel = React.useCallback((nextModelId) => {
+    if (modelId === void 0) setSelectedModelId(nextModelId);
+    onModelChange?.(nextModelId);
+  }, [modelId, onModelChange]);
+  const modelOptions = effectivePolicy ? modelsFromEffectivePolicy(effectivePolicy).models : bootstrap ? modelsFromAgentChatBootstrap(bootstrap).models : [];
+  const fatalError = bootstrapError || controller.error;
+  const operationError = localOperationError || controller.operationError?.cause;
+  const state = isBootstrapping ? "loading" : fatalError ? agentChatRuntimeStateFromError(fatalError) : controller.runState === "streaming" ? "streaming" : controller.runState === "reconnecting" ? "reconnecting" : controller.runState === "paused" ? "paused" : controller.runState === "cancelling" ? "cancelling" : controller.runState === "cancelled" ? "cancelled" : "ready";
+  const connectionState = state === "offline" ? "offline" : state === "expired" ? "expired" : state === "reconnecting" ? "reconnecting" : isBootstrapping ? "connecting" : "connected";
+  return {
+    agent: agentOverride || { name: bootstrap?.deployment.name || "Agent" },
+    inputContract: bootstrap?.features.inputs || null,
+    allowFeedback: Boolean(bootstrap?.capabilities.includes("feedback.write")),
+    backgroundError: controller.backgroundError?.cause || null,
+    bootstrap,
+    capabilities: bootstrap?.capabilities || [],
+    changeModel,
+    clearOperationError,
+    connectionState,
+    contextWindow: controller.contextWindow,
+    contextCompression: controller.contextCompression,
+    controller,
+    deleteThread,
+    errorMessage: agentChatRuntimeErrorMessage(fatalError || operationError),
+    fatalError,
+    getHitlActionState: (part) => hitlStates[hitlKey(part)],
+    isBootstrapping,
+    isSubmitting: isSubmitting || controller.isSubmitting,
+    isUploading: attachments.isUploading,
+    modelId: selectedModelId,
+    models: modelOptions,
+    newThread,
+    onHitlAction,
+    openThread,
+    operationError,
+    retryBootstrap,
+    state,
+    submit
+  };
+}
+export {
+  SUPPORTED_INPUT_MIME_TYPES,
+  agentChatRuntimeErrorMessage,
+  agentChatRuntimeStateFromError,
+  canonicalInputMimeType,
+  inputMimeTypes,
+  modelsFromAgentChatBootstrap,
+  useAgentChatRuntime,
+  validateAgentChatSubmission,
+  validateWorkflowInputSubmission,
+  workflowInputRule
+};
+//# sourceMappingURL=index.js.map