@dudousxd/nestjs-agent-react 0.29.2 → 0.30.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, b as AttachmentUploadStrategy } from './client-DhHEJi7c.cjs';
-export { c as AgentBackendUnsupportedError, d as AgentClient, e as AgentClientOptions, f as AgentConnection, g as AgentHttpError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-DhHEJi7c.cjs';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BuobfZtx.cjs';
+export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-BuobfZtx.cjs';
 import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
 export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
@@ -368,6 +368,59 @@ interface ClipboardLikeEvent {
  */
 declare function useAttachments(options?: UseAttachmentsOptions): AttachmentsState;
 
+/**
+ * Talk to an AG-UI 1.0 producer (https://docs.ag-ui.com/spec/1.0) through `useAgentChat`.
+ *
+ * `agUiChatStream` POSTs a `RunAgentInput` and hands the transport the answer re-framed in this
+ * library's stream protocol, so everything built on `useAgentChat` — the transcript, tool activity,
+ * generative UI — renders an AG-UI agent unchanged. Put it behind `openChatStream` of any backend:
+ *
+ * ```ts
+ * const backend: AgentBackend = {
+ *   ...httpBackend,
+ *   openChatStream: (request) => agUiChatStream(request, { url: '/agent/ag-ui' }),
+ * }
+ * ```
+ *
+ * What maps where (the inverse of the producer in `@adonis-agora/agent/ag-ui`):
+ *  - `TEXT_MESSAGE_*` → `text`; `REASONING_MESSAGE_*` → `reasoning`; `STEP_*` → `step-start` /
+ *    `step-finish`;
+ *  - `TOOL_CALL_START` / `ARGS` / `END` → `tool-input-start` / `-delta` / `-available`;
+ *    `TOOL_CALL_RESULT` → `tool-output` (or `tool-output-error` / `-denied`, from
+ *    `metadata['agora.outcome']`);
+ *  - `RUN_ERROR` → the stream's `event: error`; `RUN_FINISHED` → `event: done` (a cancelled
+ *    outcome writes `cancelled` first; an interrupt outcome writes a `ui` part named
+ *    `AgUiInterrupt` carrying the interrupts, for the app to render);
+ *  - `CUSTOM` events a producer of this family writes (`agora.ui`, `agora.title`, `agora.queue`,
+ *    `agora.approval-requested` / `-settled`, `agora.run`) → the frames they stand for. Any other
+ *    `CUSTOM` is ignored, as the protocol requires of a consumer that does not know it.
+ */
+interface AgUiChatStreamOptions {
+    /** The producer's endpoint (`POST`, `RunAgentInput` in, `text/event-stream` out). */
+    url: string;
+    /** Headers for every request (auth, CSRF). Per-request headers from the send win. */
+    headers?: Record<string, string>;
+    /** Defaults to the global `fetch`, with `credentials: 'same-origin'`. */
+    fetch?: typeof fetch;
+    /**
+     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model }` from the
+     * body, whichever are present.
+     */
+    forwardedProps?: (body: Record<string, unknown>) => unknown;
+    /** Read the refusal of a non-2xx answer. Default: the JSON body's `message`, else the status. */
+    refusal?: (response: Response) => Promise<Error>;
+}
+/** Start a turn against an AG-UI producer; the stream comes back in this library's framing. */
+declare function agUiChatStream(request: ChatStreamRequest, options: AgUiChatStreamOptions): Promise<ChatStreamResponse>;
+/**
+ * Re-frame an AG-UI event stream (SSE, one event per `data:`) in this library's stream protocol:
+ * `event: meta`, numbered `data:` frames of {@link AgentStreamEvent}, then `event: done` or
+ * `event: error`. Exported for a backend that fetches the stream itself.
+ */
+declare function reframeAgUiStream(source: ReadableStream<Uint8Array>, ids: {
+    threadId: string;
+}): ReadableStream<Uint8Array>;
+
 interface AgentProviderProps {
     /**
      * A backend of your own — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
@@ -1922,4 +1975,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AGENT_RUN_ERROR_CODES, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AGENT_RUN_ERROR_CODES, type AgUiChatStreamOptions, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, b as AttachmentUploadStrategy } from './client-DhHEJi7c.js';
-export { c as AgentBackendUnsupportedError, d as AgentClient, e as AgentClientOptions, f as AgentConnection, g as AgentHttpError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-DhHEJi7c.js';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BuobfZtx.js';
+export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-BuobfZtx.js';
 import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
 export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
@@ -368,6 +368,59 @@ interface ClipboardLikeEvent {
  */
 declare function useAttachments(options?: UseAttachmentsOptions): AttachmentsState;
 
+/**
+ * Talk to an AG-UI 1.0 producer (https://docs.ag-ui.com/spec/1.0) through `useAgentChat`.
+ *
+ * `agUiChatStream` POSTs a `RunAgentInput` and hands the transport the answer re-framed in this
+ * library's stream protocol, so everything built on `useAgentChat` — the transcript, tool activity,
+ * generative UI — renders an AG-UI agent unchanged. Put it behind `openChatStream` of any backend:
+ *
+ * ```ts
+ * const backend: AgentBackend = {
+ *   ...httpBackend,
+ *   openChatStream: (request) => agUiChatStream(request, { url: '/agent/ag-ui' }),
+ * }
+ * ```
+ *
+ * What maps where (the inverse of the producer in `@adonis-agora/agent/ag-ui`):
+ *  - `TEXT_MESSAGE_*` → `text`; `REASONING_MESSAGE_*` → `reasoning`; `STEP_*` → `step-start` /
+ *    `step-finish`;
+ *  - `TOOL_CALL_START` / `ARGS` / `END` → `tool-input-start` / `-delta` / `-available`;
+ *    `TOOL_CALL_RESULT` → `tool-output` (or `tool-output-error` / `-denied`, from
+ *    `metadata['agora.outcome']`);
+ *  - `RUN_ERROR` → the stream's `event: error`; `RUN_FINISHED` → `event: done` (a cancelled
+ *    outcome writes `cancelled` first; an interrupt outcome writes a `ui` part named
+ *    `AgUiInterrupt` carrying the interrupts, for the app to render);
+ *  - `CUSTOM` events a producer of this family writes (`agora.ui`, `agora.title`, `agora.queue`,
+ *    `agora.approval-requested` / `-settled`, `agora.run`) → the frames they stand for. Any other
+ *    `CUSTOM` is ignored, as the protocol requires of a consumer that does not know it.
+ */
+interface AgUiChatStreamOptions {
+    /** The producer's endpoint (`POST`, `RunAgentInput` in, `text/event-stream` out). */
+    url: string;
+    /** Headers for every request (auth, CSRF). Per-request headers from the send win. */
+    headers?: Record<string, string>;
+    /** Defaults to the global `fetch`, with `credentials: 'same-origin'`. */
+    fetch?: typeof fetch;
+    /**
+     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model }` from the
+     * body, whichever are present.
+     */
+    forwardedProps?: (body: Record<string, unknown>) => unknown;
+    /** Read the refusal of a non-2xx answer. Default: the JSON body's `message`, else the status. */
+    refusal?: (response: Response) => Promise<Error>;
+}
+/** Start a turn against an AG-UI producer; the stream comes back in this library's framing. */
+declare function agUiChatStream(request: ChatStreamRequest, options: AgUiChatStreamOptions): Promise<ChatStreamResponse>;
+/**
+ * Re-frame an AG-UI event stream (SSE, one event per `data:`) in this library's stream protocol:
+ * `event: meta`, numbered `data:` frames of {@link AgentStreamEvent}, then `event: done` or
+ * `event: error`. Exported for a backend that fetches the stream itself.
+ */
+declare function reframeAgUiStream(source: ReadableStream<Uint8Array>, ids: {
+    threadId: string;
+}): ReadableStream<Uint8Array>;
+
 interface AgentProviderProps {
     /**
      * A backend of your own — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
@@ -1922,4 +1975,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AGENT_RUN_ERROR_CODES, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AGENT_RUN_ERROR_CODES, type AgUiChatStreamOptions, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.js

@@ -1821,6 +1821,282 @@ function useAttachments(options = {}) {
   }, [items, add, remove, retry, clear, inputProps, dropZoneProps, dragDepth, onPaste]);
 }
 
+// src/ag-ui-backend.ts
+function newId() {
+  return globalThis.crypto.randomUUID();
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function defaultRefusal(response) {
+  try {
+    const body = await response.json();
+    if (typeof body.message === "string" && body.message.length > 0) return new Error(body.message);
+  } catch {
+  }
+  return new Error(`The agent refused the request (${response.status}).`);
+}
+function defaultForwardedProps(body) {
+  const out = {};
+  for (const key of ["pageContext", "agent", "model"]) {
+    if (body[key] !== void 0 && body[key] !== null) out[key] = body[key];
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+async function agUiChatStream(request, options) {
+  const body = request.body;
+  const threadId = typeof body.threadId === "string" ? body.threadId : newId();
+  const message = typeof body.message === "string" ? body.message : "";
+  const forwarded = (options.forwardedProps ?? defaultForwardedProps)(body);
+  const input = {
+    threadId,
+    runId: newId(),
+    protocolVersion: "1.0",
+    messages: [{ id: newId(), role: "user", content: message }],
+    ...forwarded !== void 0 ? { forwardedProps: forwarded } : {}
+  };
+  const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const response = await doFetch(options.url, {
+    method: "POST",
+    credentials: "same-origin",
+    headers: {
+      "content-type": "application/json",
+      accept: "text/event-stream",
+      ...options.headers,
+      ...request.headers
+    },
+    body: JSON.stringify(input),
+    ...request.signal !== void 0 ? { signal: request.signal } : {}
+  });
+  if (!response.ok || response.body === null) {
+    throw await (options.refusal ?? defaultRefusal)(response);
+  }
+  const runId = response.headers.get("x-agent-run-id") ?? void 0;
+  return {
+    body: reframeAgUiStream(response.body, { threadId }),
+    threadId,
+    ...runId !== void 0 ? { runId } : {}
+  };
+}
+function reframeAgUiStream(source, ids) {
+  const encoder = new TextEncoder();
+  const decoder = new TextDecoder();
+  const reframer = createReframer(ids.threadId);
+  const reader = source.getReader();
+  let buffer = "";
+  return new ReadableStream({
+    async pull(controller) {
+      for (; ; ) {
+        const { value, done } = await reader.read();
+        if (done) {
+          controller.close();
+          return;
+        }
+        buffer += decoder.decode(value, { stream: true }).replace(/\r\n?/g, "\n");
+        let out = "";
+        let separator = buffer.indexOf("\n\n");
+        while (separator !== -1) {
+          const block = buffer.slice(0, separator);
+          buffer = buffer.slice(separator + 2);
+          separator = buffer.indexOf("\n\n");
+          const data = block.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart()).join("\n");
+          if (data.length === 0) continue;
+          let event;
+          try {
+            event = JSON.parse(data);
+          } catch {
+            continue;
+          }
+          if (isRecord2(event) && typeof event.type === "string") {
+            out += reframer.push(event);
+          }
+          if (reframer.closed) break;
+        }
+        if (out.length > 0) controller.enqueue(encoder.encode(out));
+        if (reframer.closed) {
+          void reader.cancel().catch(() => void 0);
+          controller.close();
+          return;
+        }
+        if (out.length > 0) return;
+      }
+    },
+    cancel(reason) {
+      return reader.cancel(reason).catch(() => void 0);
+    }
+  });
+}
+function createReframer(threadId) {
+  let seq = 0;
+  let metaSent = false;
+  const tools = /* @__PURE__ */ new Map();
+  const state = {
+    closed: false,
+    push(event) {
+      if (state.closed) return "";
+      let out = "";
+      const frame = (streamEvent) => {
+        seq += 1;
+        out += `id: ${seq}
+data: ${JSON.stringify(streamEvent)}
+
+`;
+      };
+      const meta = (runId, thread) => {
+        if (metaSent) return;
+        metaSent = true;
+        out += `event: meta
+data: ${JSON.stringify({
+          runId: typeof runId === "string" ? runId : "",
+          threadId: typeof thread === "string" ? thread : threadId
+        })}
+
+`;
+      };
+      switch (event.type) {
+        case "RUN_STARTED":
+          pendingStart = { runId: event.runId, threadId: event.threadId };
+          return out;
+        case "CUSTOM": {
+          const value = event.value;
+          if (event.name === "agora.run" && isRecord2(value)) {
+            meta(value.runId, pendingStart?.threadId ?? value.threadId);
+            pendingStart = void 0;
+            return out;
+          }
+          flushStart();
+          if (!isRecord2(value)) return out;
+          if (event.name === "agora.ui") frame({ kind: "ui", ...value });
+          else if (event.name === "agora.title" && typeof value.title === "string") {
+            frame({ kind: "title", title: value.title });
+          } else if (event.name === "agora.queue") frame({ kind: "queue", ...value });
+          else if (event.name === "agora.approval-requested") {
+            frame({ ...value, kind: "approval-requested" });
+          } else if (event.name === "agora.approval-settled") {
+            frame({ ...value, kind: "approval-settled" });
+          }
+          return out;
+        }
+        default:
+          flushStart();
+      }
+      switch (event.type) {
+        case "TEXT_MESSAGE_CONTENT":
+        case "TEXT_MESSAGE_CHUNK":
+          if (typeof event.delta === "string" && event.delta.length > 0) {
+            frame({ kind: "text", text: event.delta });
+          }
+          break;
+        case "REASONING_MESSAGE_CONTENT":
+        case "REASONING_MESSAGE_CHUNK":
+          if (typeof event.delta === "string" && event.delta.length > 0) {
+            frame({ kind: "reasoning", text: event.delta });
+          }
+          break;
+        case "STEP_STARTED":
+          frame({ kind: "step-start" });
+          break;
+        case "STEP_FINISHED":
+          frame({ kind: "step-finish" });
+          break;
+        case "TOOL_CALL_START":
+        case "TOOL_CALL_CHUNK": {
+          const id = String(event.toolCallId ?? "");
+          if (id === "") break;
+          if (!tools.has(id)) {
+            const name = typeof event.toolCallName === "string" ? event.toolCallName : "";
+            tools.set(id, { name, args: "" });
+            frame({ kind: "tool-input-start", id, name, toolKind: "read" });
+          }
+          if (event.type === "TOOL_CALL_CHUNK" && typeof event.delta === "string") {
+            tools.get(id).args += event.delta;
+            frame({ kind: "tool-input-delta", id, delta: event.delta });
+          }
+          break;
+        }
+        case "TOOL_CALL_ARGS": {
+          const call = tools.get(String(event.toolCallId));
+          if (call === void 0 || typeof event.delta !== "string") break;
+          call.args += event.delta;
+          frame({ kind: "tool-input-delta", id: String(event.toolCallId), delta: event.delta });
+          break;
+        }
+        case "TOOL_CALL_END": {
+          const id = String(event.toolCallId);
+          const call = tools.get(id);
+          if (call === void 0) break;
+          frame({
+            kind: "tool-input-available",
+            id,
+            name: call.name,
+            input: parseJson(call.args, {}),
+            toolKind: "read"
+          });
+          break;
+        }
+        case "TOOL_CALL_RESULT": {
+          const id = String(event.toolCallId);
+          const content = contentText(event.content);
+          const outcome = isRecord2(event.metadata) ? event.metadata["agora.outcome"] : void 0;
+          if (outcome === "error") frame({ kind: "tool-output-error", id, error: content });
+          else if (outcome === "denied") frame({ kind: "tool-output-denied", id, reason: content });
+          else frame({ kind: "tool-output", id, output: parseJson(content, content) });
+          break;
+        }
+        case "RUN_ERROR":
+          state.closed = true;
+          out += `event: error
+data: ${JSON.stringify({
+            code: typeof event.code === "string" ? event.code : "run_failed",
+            message: typeof event.message === "string" ? event.message : "The run failed."
+          })}
+
+`;
+          break;
+        case "RUN_FINISHED": {
+          const outcome = isRecord2(event.outcome) ? event.outcome : void 0;
+          if (outcome?.type === "cancelled") frame({ kind: "cancelled" });
+          if (outcome?.type === "interrupt" && Array.isArray(outcome.interrupts)) {
+            frame({
+              kind: "ui",
+              id: `ag-ui:interrupt:${String(event.runId ?? "")}`,
+              component: "AgUiInterrupt",
+              props: { interrupts: outcome.interrupts }
+            });
+          }
+          state.closed = true;
+          out += "event: done\ndata: {}\n\n";
+          break;
+        }
+        default:
+          break;
+      }
+      return out;
+      function flushStart() {
+        if (pendingStart !== void 0) {
+          meta(pendingStart.runId, pendingStart.threadId);
+          pendingStart = void 0;
+        }
+      }
+    }
+  };
+  let pendingStart;
+  return state;
+}
+function parseJson(text, fallback2) {
+  if (text.trim().length === 0) return fallback2;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return fallback2;
+  }
+}
+function contentText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.filter((part) => isRecord2(part) && part.type === "text" && typeof part.text === "string").map((part) => part.text).join("");
+}
+
 // src/catalog/use-agents.ts
 import { useMemo as useMemo5 } from "react";
 
@@ -2473,7 +2749,7 @@ function phraseFor(presentation, input, isSettled2, fallback2 = { running: "Work
 }
 
 // src/presentation/result-view.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function toText(value) {
@@ -2485,18 +2761,18 @@ function toText(value) {
   return "\u2014";
 }
 function inferResultView(output) {
-  if (!isRecord2(output)) return void 0;
+  if (!isRecord3(output)) return void 0;
   for (const [key, value] of Object.entries(output)) {
     if (!Array.isArray(value) || value.length === 0) continue;
     if (value.every((entry) => typeof entry === "string")) {
       return { kind: "log", lines: key };
     }
-    if (value.every(isRecord2)) {
+    if (value.every(isRecord3)) {
       const first = value[0];
       return {
         kind: "table",
         rows: key,
-        columns: Object.keys(first).filter((column) => !isRecord2(first[column])).map((column) => ({ path: column, label: column }))
+        columns: Object.keys(first).filter((column) => !isRecord3(first[column])).map((column) => ({ path: column, label: column }))
       };
     }
   }
@@ -2823,7 +3099,7 @@ function isSettled(state) {
 }
 function toolKind(part) {
   const metadata = part.toolMetadata;
-  return isRecord3(metadata) && typeof metadata.toolKind === "string" ? metadata.toolKind : void 0;
+  return isRecord4(metadata) && typeof metadata.toolKind === "string" ? metadata.toolKind : void 0;
 }
 function isAwaitingApproval(part) {
   if (part.state === "approval-requested") {
@@ -2836,7 +3112,7 @@ function isAwaitingApproval(part) {
 }
 function toolParentId(part) {
   const metadata = part.toolMetadata;
-  return isRecord3(metadata) && typeof metadata.parentId === "string" ? metadata.parentId : null;
+  return isRecord4(metadata) && typeof metadata.parentId === "string" ? metadata.parentId : null;
 }
 function nestToolCalls(calls) {
   const byId = new Map(calls.map((call) => [call.toolCallId, call]));
@@ -2895,12 +3171,12 @@ function buildToolCall(part, options, approval, catalog) {
 }
 function readElicitationRequest(part) {
   const input = part.input;
-  if (!isRecord3(input) || !Array.isArray(input.questions) || input.questions.length === 0) {
+  if (!isRecord4(input) || !Array.isArray(input.questions) || input.questions.length === 0) {
     return null;
   }
   const questions = [];
   for (const candidate of input.questions) {
-    if (!isRecord3(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string") {
+    if (!isRecord4(candidate) || typeof candidate.id !== "string" || typeof candidate.prompt !== "string") {
       return null;
     }
     const input2 = readElicitationInput(candidate.input) ?? null;
@@ -2910,7 +3186,7 @@ function readElicitationRequest(part) {
     }
     const options = [];
     for (const option of rawOptions) {
-      if (!isRecord3(option) || typeof option.value !== "string" || typeof option.label !== "string") {
+      if (!isRecord4(option) || typeof option.value !== "string" || typeof option.label !== "string") {
         return null;
       }
       options.push({
@@ -2937,7 +3213,7 @@ function readElicitationRequest(part) {
 }
 function readElicitationOutcome(part) {
   const output = part.output;
-  if (!isRecord3(output) || !isRecord3(output.answers) || typeof output.skipped !== "boolean") {
+  if (!isRecord4(output) || !isRecord4(output.answers) || typeof output.skipped !== "boolean") {
     return null;
   }
   const answers = {};
@@ -3062,7 +3338,7 @@ function readApprovals(parts) {
       continue;
     }
     const data = part.data;
-    if (!isRecord3(data) || typeof data.id !== "string") {
+    if (!isRecord4(data) || typeof data.id !== "string") {
       continue;
     }
     const approval = entry(data.id);
@@ -3115,7 +3391,7 @@ function statusFromPart(call) {
 }
 function readUiComponent(part) {
   const data = part.data;
-  if (!isRecord3(data) || typeof data.component !== "string") {
+  if (!isRecord4(data) || typeof data.component !== "string") {
     return null;
   }
   const id = typeof data.id === "string" ? data.id : part.id;
@@ -3125,29 +3401,29 @@ function readUiComponent(part) {
   return {
     id,
     component: data.component,
-    props: isRecord3(data.props) ? data.props : {},
+    props: isRecord4(data.props) ? data.props : {},
     version: typeof data.version === "number" ? data.version : null,
     toolCallId: typeof data.toolCallId === "string" ? data.toolCallId : null
   };
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null;
 }
 function readQuery(part) {
   const input = part.input;
-  if (!isRecord3(input) || typeof input.query !== "string") {
+  if (!isRecord4(input) || typeof input.query !== "string") {
     return null;
   }
   return input.query;
 }
 function readPassages(part) {
   const output = part.output;
-  if (!isRecord3(output) || !Array.isArray(output.passages) || output.passages.length === 0) {
+  if (!isRecord4(output) || !Array.isArray(output.passages) || output.passages.length === 0) {
     return null;
   }
   const passages = [];
   for (const candidate of output.passages) {
-    if (!isRecord3(candidate) || typeof candidate.id !== "string" || typeof candidate.text !== "string") {
+    if (!isRecord4(candidate) || typeof candidate.id !== "string" || typeof candidate.text !== "string") {
       return null;
     }
     passages.push({
@@ -3155,7 +3431,7 @@ function readPassages(part) {
       text: candidate.text,
       score: typeof candidate.score === "number" ? candidate.score : 0,
       ...typeof candidate.source === "string" ? { source: candidate.source } : {},
-      ...isRecord3(candidate.metadata) ? { metadata: candidate.metadata } : {}
+      ...isRecord4(candidate.metadata) ? { metadata: candidate.metadata } : {}
     });
   }
   return passages;
@@ -5781,6 +6057,7 @@ export {
   RUN_NOT_ACTIVE_CODE,
   SPEECH_LANGUAGES,
   acceptsFile,
+  agUiChatStream,
   applyCompletion,
   approvalCountdown,
   attachmentFile,
@@ -5813,6 +6090,7 @@ export {
   phraseFor,
   readPath,
   readReasoningMs,
+  reframeAgUiStream,
   requireBackendMethod,
   resolveResultView,
   storedMessageToUiMessage,