@assistant-ui/react-ag-ui 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +2 -0
  2. package/dist/agUiExtras.js +1 -2
  3. package/dist/hooks.js +1 -2
  4. package/dist/runtime/AgUiThreadController.d.ts +11 -0
  5. package/dist/runtime/AgUiThreadController.d.ts.map +1 -1
  6. package/dist/runtime/AgUiThreadController.js +565 -89
  7. package/dist/runtime/AgUiThreadController.js.map +1 -1
  8. package/dist/runtime/adapter/conversions.d.ts +9 -1
  9. package/dist/runtime/adapter/conversions.d.ts.map +1 -1
  10. package/dist/runtime/adapter/conversions.js +194 -12
  11. package/dist/runtime/adapter/conversions.js.map +1 -1
  12. package/dist/runtime/adapter/replay-content.d.ts +9 -0
  13. package/dist/runtime/adapter/replay-content.d.ts.map +1 -0
  14. package/dist/runtime/adapter/replay-content.js +185 -0
  15. package/dist/runtime/adapter/replay-content.js.map +1 -0
  16. package/dist/runtime/adapter/run-aggregator.d.ts +1 -0
  17. package/dist/runtime/adapter/run-aggregator.d.ts.map +1 -1
  18. package/dist/runtime/adapter/run-aggregator.js +35 -14
  19. package/dist/runtime/adapter/run-aggregator.js.map +1 -1
  20. package/dist/runtime/adapter/subscriber.d.ts +0 -1
  21. package/dist/runtime/adapter/subscriber.d.ts.map +1 -1
  22. package/dist/runtime/adapter/subscriber.js +2 -10
  23. package/dist/runtime/adapter/subscriber.js.map +1 -1
  24. package/dist/runtime/adapter/tool-approval.d.ts +2 -0
  25. package/dist/runtime/adapter/tool-approval.d.ts.map +1 -1
  26. package/dist/runtime/adapter/tool-approval.js +23 -6
  27. package/dist/runtime/adapter/tool-approval.js.map +1 -1
  28. package/dist/runtime/agUiThreadState.d.ts +1 -1
  29. package/dist/runtime/agUiThreadState.d.ts.map +1 -1
  30. package/dist/runtime/agUiThreadState.js +3 -4
  31. package/dist/runtime/agUiThreadState.js.map +1 -1
  32. package/dist/runtime/event-parser.d.ts.map +1 -1
  33. package/dist/runtime/event-parser.js +2 -2
  34. package/dist/runtime/event-parser.js.map +1 -1
  35. package/dist/runtime/interrupt-internals.js +1 -2
  36. package/dist/runtime/logger.js +1 -2
  37. package/dist/runtime/mcp-tool-result.js +1 -2
  38. package/dist/runtime/types.d.ts +2 -0
  39. package/dist/runtime/types.d.ts.map +1 -1
  40. package/dist/runtime/types.js +3 -3
  41. package/dist/runtime/types.js.map +1 -1
  42. package/dist/useAgUiRuntime.js +1 -2
  43. package/package.json +6 -6
  44. package/src/runtime/AgUiThreadController.deferred-results.test.ts +548 -0
  45. package/src/runtime/AgUiThreadController.disconnect.test.ts +914 -0
  46. package/src/runtime/AgUiThreadController.interrupt-history.test.ts +392 -0
  47. package/src/runtime/AgUiThreadController.replay.test.ts +3939 -0
  48. package/src/runtime/AgUiThreadController.snapshot-head-move.test.ts +167 -0
  49. package/src/runtime/AgUiThreadController.subagent-snapshot.test.ts +854 -0
  50. package/src/runtime/AgUiThreadController.test.ts +119 -0
  51. package/src/runtime/AgUiThreadController.ts +1184 -136
  52. package/src/runtime/adapter/conversions.content.test.ts +242 -1
  53. package/src/runtime/adapter/conversions.subagent-messages.test.ts +550 -0
  54. package/src/runtime/adapter/conversions.ts +349 -28
  55. package/src/runtime/adapter/replay-content.test.ts +235 -0
  56. package/src/runtime/adapter/replay-content.ts +306 -0
  57. package/src/runtime/adapter/run-aggregator.metadata.test.ts +151 -0
  58. package/src/runtime/adapter/run-aggregator.ts +52 -9
  59. package/src/runtime/adapter/subscriber.test.ts +1 -1
  60. package/src/runtime/adapter/subscriber.ts +1 -6
  61. package/src/runtime/adapter/tool-approval.ts +41 -3
  62. package/src/runtime/agUiThreadState.test.ts +21 -2
  63. package/src/runtime/agUiThreadState.ts +12 -3
  64. package/src/runtime/event-parser.ts +3 -0
  65. package/src/runtime/types.ts +5 -0
@@ -539,6 +539,46 @@ describe("AgUiThreadController activity deltas", () => {
539
539
  });
540
540
  });
541
541
 
542
+ describe("AgUiThreadController run state", () => {
543
+ type Subscriber = {
544
+ onStateSnapshotEvent?: (payload: {
545
+ event: { type: "STATE_SNAPSHOT"; snapshot: { count: number } };
546
+ }) => void;
547
+ };
548
+
549
+ it("sends an empty state when no snapshot exists and preserves null", async () => {
550
+ const runAgent = vi.fn(
551
+ async (_input: { state: unknown }, subscriber: Subscriber) => {
552
+ if (runAgent.mock.calls.length === 1) {
553
+ subscriber.onStateSnapshotEvent?.({
554
+ event: { type: "STATE_SNAPSHOT", snapshot: { count: 1 } },
555
+ });
556
+ }
557
+ },
558
+ );
559
+ const agent = {
560
+ runAgent,
561
+ abortRun: vi.fn(),
562
+ } as unknown as AbstractAgent;
563
+ const { core } = createCore(undefined, agent);
564
+
565
+ await core.append({ ...userMessage("initial"), startRun: true });
566
+ expect(runAgent.mock.calls[0]?.[0].state).toEqual({});
567
+ expect(agent.state).toEqual({});
568
+
569
+ core.resetState();
570
+ expect(core.getState()).toBeUndefined();
571
+ await core.append({ ...userMessage("after reset"), startRun: true });
572
+ expect(runAgent.mock.calls[1]?.[0].state).toEqual({});
573
+ expect(agent.state).toEqual({});
574
+
575
+ core.setState(null);
576
+ await core.append({ ...userMessage("explicit null"), startRun: true });
577
+ expect(runAgent.mock.calls[2]?.[0].state).toBeNull();
578
+ expect(agent.state).toBeNull();
579
+ });
580
+ });
581
+
542
582
  describe("AgUiThreadController setState", () => {
543
583
  it("keeps a cancel the updater makes while a send waits for history", async () => {
544
584
  const { history, finish } = deferredHistory();
@@ -567,3 +607,82 @@ describe("AgUiThreadController setState", () => {
567
607
  expect(runAgent).not.toHaveBeenCalled();
568
608
  });
569
609
  });
610
+
611
+ describe("AgUiThreadController resuming a disconnected run", () => {
612
+ type Subscriber = {
613
+ onTextMessageStartEvent?: (payload: { event: unknown }) => void;
614
+ onTextMessageContentEvent?: (payload: { event: unknown }) => void;
615
+ onTextMessageEndEvent?: (payload: { event: unknown }) => void;
616
+ onRunFinishedEvent?: (payload: { event: unknown }) => void;
617
+ };
618
+ const sendText = (
619
+ subscriber: Subscriber,
620
+ messageId: string,
621
+ text: string,
622
+ end = true,
623
+ ) => {
624
+ subscriber.onTextMessageStartEvent?.({
625
+ event: { type: "TEXT_MESSAGE_START", messageId },
626
+ });
627
+ subscriber.onTextMessageContentEvent?.({
628
+ event: { type: "TEXT_MESSAGE_CONTENT", messageId, delta: text },
629
+ });
630
+ if (end) {
631
+ subscriber.onTextMessageEndEvent?.({
632
+ event: { type: "TEXT_MESSAGE_END", messageId },
633
+ });
634
+ }
635
+ };
636
+
637
+ it.each(["user", "assistant"] as const)(
638
+ "preserves replayed IDs and content when resume uses the %s parent",
639
+ async (parent) => {
640
+ const runAgent = vi.fn(
641
+ async (input: { runId: string }, subscriber: Subscriber) => {
642
+ if (runAgent.mock.calls.length === 1) {
643
+ sendText(subscriber, "assistant-a", "first", false);
644
+ throw new Error("stream disconnected");
645
+ }
646
+ sendText(subscriber, "assistant-a", "first and more");
647
+ sendText(subscriber, "assistant-b", "second answer");
648
+ subscriber.onRunFinishedEvent?.({
649
+ event: { type: "RUN_FINISHED", runId: input.runId },
650
+ });
651
+ },
652
+ );
653
+ const { core } = createCore(undefined, {
654
+ runAgent,
655
+ abortRun: vi.fn(),
656
+ } as unknown as AbstractAgent);
657
+
658
+ await expect(
659
+ core.append({ ...userMessage("question"), startRun: true }),
660
+ ).rejects.toThrow("stream disconnected");
661
+ const userId = core.getMessages()[0]!.id;
662
+ expect(core.getMessages()[1]).toMatchObject({
663
+ id: "assistant-a",
664
+ content: [{ type: "text", text: "first" }],
665
+ });
666
+
667
+ await core.resume({
668
+ parentId: parent === "user" ? userId : "assistant-a",
669
+ sourceId: null,
670
+ runConfig: {},
671
+ });
672
+
673
+ expect(runAgent).toHaveBeenCalledTimes(2);
674
+ expect(core.getMessages().map((message) => message.id)).toEqual([
675
+ userId,
676
+ "assistant-a",
677
+ "assistant-b",
678
+ ]);
679
+ expect(core.getMessages().slice(1)).toMatchObject([
680
+ { content: [{ type: "text", text: "first and more" }] },
681
+ { content: [{ type: "text", text: "second answer" }] },
682
+ ]);
683
+ expect(
684
+ core.getMessageRepository().messages.map(({ parentId }) => parentId),
685
+ ).toEqual([null, userId, "assistant-a"]);
686
+ },
687
+ );
688
+ });