@varo-ui/ai 1.2.0 → 2.1.0

package/README.md

@@ -17,7 +17,22 @@ const transport = createAgentSseEventSource()
 const controller = createAgentStreamController()
 
 requestTask.onChunkReceived(({ data }) => transport.feed(data))
-void controller.connect(transport.source)
+await controller.connect(transport.source)
 ```
 
+`connect()` owns the iterator lifecycle: protocol `done`/`error` events settle the connection and request iterator cleanup, while natural iterator exhaustion synthesizes `done`.
+
+## Thread versions
+
+```ts
+import { createAgentThreadController } from '@varo-ui/ai'
+
+const thread = createAgentThreadController()
+thread.append({ id: 'root', label: 'Initial answer' })
+thread.fork('root', { id: 'verified', label: 'Verified branch' })
+thread.select('root')
+```
+
+The controller owns an immutable acyclic version graph. `append()` and `fork()` activate the new version; invalid ids, missing parents, cycles, and post-destroy mutations fail immediately.
+
 [Documentation](https://daguanren21.github.io/Varo/ai/) · [Repository](https://github.com/daguanren21/Varo)

package/dist/index.d.mts

@@ -148,15 +148,21 @@ interface TextStreamSnapshot {
   visible: string;
 }
 interface TextStreamOptions {
+  burstInitialContent?: boolean;
+  burstRevealThresholdChars?: number;
+  catchUpLatencyMs?: number;
   catchUpThreshold?: number;
+  flushOnFinish?: boolean;
   maxCharsPerCommit?: number;
   maxCharsPerSecond?: number;
   maxCommitFps?: number;
   minCharsPerSecond?: number;
+  startDelayMs?: number;
   targetLatencyMs?: number;
 }
 interface TextStreamController {
   destroy: () => void;
+  dispose: () => void;
   enqueue: (chunk: string) => void;
   finish: (options?: {
     flush?: boolean;
@@ -164,7 +170,9 @@ interface TextStreamController {
   flush: () => void;
   getSnapshot: () => TextStreamSnapshot;
   pause: () => void;
-  reset: (content?: string) => void;
+  reset: (content?: string, options?: {
+    prefixKnown?: boolean;
+  }) => void;
   resume: () => void;
   subscribe: (listener: () => void) => () => void;
 }
@@ -183,6 +191,28 @@ interface AgentEventChannel {
   push: (event: AgentStreamEvent) => void;
   source: AsyncIterable<AgentStreamEvent>;
 }
+interface AgentThreadVersion {
+  readonly createdAt?: string;
+  readonly id: string;
+  readonly label?: string;
+  readonly messageId?: string;
+  readonly parentId?: string;
+  readonly pinned?: boolean;
+  readonly summary?: string;
+}
+interface AgentThreadSnapshot {
+  readonly activeVersionId?: string;
+  readonly versions: readonly AgentThreadVersion[];
+}
+interface AgentThreadController {
+  append: (version: AgentThreadVersion) => void;
+  destroy: () => void;
+  fork: (parentId: string, version: Omit<AgentThreadVersion, 'parentId'>) => void;
+  getSnapshot: () => AgentThreadSnapshot;
+  reset: (initial?: AgentThreadSnapshot) => void;
+  select: (id: string) => void;
+  subscribe: (listener: () => void) => () => void;
+}
 //#endregion
 //#region src/agent-stream.d.ts
 interface AgentStreamControllerOptions {
@@ -230,6 +260,15 @@ interface AgentMarkdownViewNode {
   text?: string;
   title?: string;
 }
+type AgentRichTextNode = {
+  text: string;
+  type: 'text';
+} | {
+  attrs?: Record<string, string>;
+  children?: AgentRichTextNode[];
+  name: 'br' | 'code' | 'del' | 'em' | 'ins' | 'mark' | 'span' | 'strong' | 'sub' | 'sup';
+};
+declare function toAgentRichTextNodes(nodes: AgentMarkdownViewNode[]): AgentRichTextNode[] | undefined;
 declare function normalizeMarkdownNode(node: ParsedNode$1): AgentMarkdownViewNode;
 declare function normalizeMarkdownNodes(nodes: ParsedNode$1[]): AgentMarkdownViewNode[];
 //#endregion
@@ -245,5 +284,8 @@ declare function createAgentSseEventSource(): AgentSseEventSource;
 //#region src/text-stream.d.ts
 declare function createTextStream(options?: TextStreamOptions): TextStreamController;
 //#endregion
-export { AgentApprovalPart, AgentApprovalRequiredEvent, AgentApprovalResolvedEvent, AgentDataEvent, AgentDataPart, AgentDoneEvent, AgentErrorEvent, AgentEventChannel, AgentMarkdownNodeKind, AgentMarkdownViewNode, AgentMessageEndEvent, AgentMessageRole, AgentMessageStartEvent, AgentPartStatus, AgentReasoningDeltaEvent, AgentReasoningEndEvent, AgentReasoningPart, AgentReasoningStartEvent, AgentSseEventSource, AgentStreamController, AgentStreamControllerOptions, AgentStreamEvent, AgentStreamMessage, AgentStreamSnapshot, AgentStreamStatus, AgentTextDeltaEvent, AgentToolErrorEvent, AgentToolPart, AgentToolResultEvent, AgentToolStartEvent, AgentToolUpdateEvent, type ParsedNode, StreamingMarkdownParser, StreamingMarkdownParserOptions, TextStreamController, TextStreamOptions, TextStreamSnapshot, createAgentEventChannel, createAgentSseEventSource, createAgentStreamController, createStreamingMarkdownParser, createTextStream, normalizeMarkdownNode, normalizeMarkdownNodes, parseAgentStreamEvent };
+//#region src/thread.d.ts
+declare function createAgentThreadController(initial?: AgentThreadSnapshot): AgentThreadController;
+//#endregion
+export { AgentApprovalPart, AgentApprovalRequiredEvent, AgentApprovalResolvedEvent, AgentDataEvent, AgentDataPart, AgentDoneEvent, AgentErrorEvent, AgentEventChannel, AgentMarkdownNodeKind, AgentMarkdownViewNode, AgentMessageEndEvent, AgentMessageRole, AgentMessageStartEvent, AgentPartStatus, AgentReasoningDeltaEvent, AgentReasoningEndEvent, AgentReasoningPart, AgentReasoningStartEvent, AgentRichTextNode, AgentSseEventSource, AgentStreamController, AgentStreamControllerOptions, AgentStreamEvent, AgentStreamMessage, AgentStreamSnapshot, AgentStreamStatus, AgentTextDeltaEvent, AgentThreadController, AgentThreadSnapshot, AgentThreadVersion, AgentToolErrorEvent, AgentToolPart, AgentToolResultEvent, AgentToolStartEvent, AgentToolUpdateEvent, type ParsedNode, StreamingMarkdownParser, StreamingMarkdownParserOptions, TextStreamController, TextStreamOptions, TextStreamSnapshot, createAgentEventChannel, createAgentSseEventSource, createAgentStreamController, createAgentThreadController, createStreamingMarkdownParser, createTextStream, normalizeMarkdownNode, normalizeMarkdownNodes, parseAgentStreamEvent, toAgentRichTextNodes };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/agent-stream.ts","../src/event-channel.ts","../src/event-parser.ts","../src/markdown.ts","../src/markdown-view.ts","../src/sse.ts","../src/text-stream.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/agent-stream.ts","../src/event-channel.ts","../src/event-parser.ts","../src/markdown.ts","../src/markdown-view.ts","../src/sse.ts","../src/text-stream.ts","../src/thread.ts"],"mappings":"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"}