Realtime chat and document editing demo by samwillis · Pull Request #4618 · electric-sql/electric

samwillis · 2026-06-17T18:15:27Z

Summary

This is a realtime chat and document editing demo that combines the realtime agents work with collaborative markdown document tools.

Builds on:

What changed

Keeps realtime sessions listening for inbox wake notifications while the user is in realtime mode.
Adds batched child-completion wake handling so parent agents receive all subagent completions, including fast workers whose manifest-backed wake registration arrives late.
Makes markdown document refs available through parent manifests when child workers create/edit documents.
Improves Horton/worker markdown-editing guidance and worker naming so spawned agents have descriptive names.
Keeps realtime audio sessions alive across split-panel document opens, so opening a markdown editor does not stop the session.
Labels markdown presence cursors with the agent entity name instead of the local dev principal.

Validation

pnpm install
pnpm --filter @electric-ax/agents-server exec vitest run test/wake-registry.test.ts -t "manifest"
pnpm --filter @electric-ax/agents-runtime exec vitest run test/markdown-docs-tools.test.ts
pnpm --filter @electric-ax/agents-runtime typecheck
pnpm --filter @electric-ax/agents-server typecheck
pnpm --filter @electric-ax/agents-runtime stylecheck
pnpm --filter @electric-ax/agents-server stylecheck
pnpm --filter @electric-ax/agents-server-ui exec vitest run src/lib/realtime-session-store.test.ts
pnpm --filter @electric-ax/agents exec vitest run test/spawn-worker-tool.test.ts test/horton-system-prompt.test.ts test/horton-tool-composition.test.ts
pnpm --filter @electric-ax/agents-server-ui typecheck
pnpm --filter @electric-ax/agents typecheck
git diff --check

…me-agents-markdown-docs # Conflicts: # packages/agents-runtime/src/entity-schema.ts # packages/agents-runtime/src/index.ts # packages/agents-server/test/electric-agents-manager-write-validation.test.ts # packages/agents/src/agents/horton.ts

github-actions · 2026-06-17T18:16:16Z

Electric Agents Desktop Builds

Build artifacts for commit c76a1ee.

Platform	Status	Artifact
macOS Apple Silicon	Passed	DMG
macOS Intel	Passed	DMG
Windows x64	Passed	Installer
Linux x64	Passed	AppImage / deb

Workflow run

codecov · 2026-06-17T18:16:52Z

❌ 6 Tests Failed:

Tests completed	Failed	Passed	Skipped
2285	6	2279	41

View the top 3 failed test(s) by shortest run time

test/entity-timeline.test.ts > entity includes query > includes query reactivity > reasoning content remains populated after status flips to completed

Stack Traces | 0.000635s run time

QueryBuilderError: Invalid source for live query: The value provided for alias "realtimeTranscript" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.
 ❯ BaseQueryBuilder._createRefsForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:149:15
 ❯ BaseQueryBuilder._createRefForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:94:23
 ❯ BaseQueryBuilder.from ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:177:27
 ❯ buildEntityTimelineQuery src/entity-timeline.ts:1587:6
 ❯ src/entity-timeline.ts:1502:38
 ❯ buildQuery ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:1370:18
 ❯ buildQueryFromConfig ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/utils.ts:261:9
 ❯ new CollectionConfigBuilder ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/collection-config-builder.ts:174:18
 ❯ liveQueryCollectionOptions ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:83:35
 ❯ Module.createLiveQueryCollection ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:191:21

test/entity-timeline.test.ts > entity includes query > includes query reactivity > reasoning content populates even when text deltas are also present

Stack Traces | 0.000692s run time

QueryBuilderError: Invalid source for live query: The value provided for alias "realtimeTranscript" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.
 ❯ BaseQueryBuilder._createRefsForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:149:15
 ❯ BaseQueryBuilder._createRefForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:94:23
 ❯ BaseQueryBuilder.from ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:177:27
 ❯ buildEntityTimelineQuery src/entity-timeline.ts:1587:6
 ❯ src/entity-timeline.ts:1502:38
 ❯ buildQuery ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:1370:18
 ❯ buildQueryFromConfig ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/utils.ts:261:9
 ❯ new CollectionConfigBuilder ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/collection-config-builder.ts:174:18
 ❯ liveQueryCollectionOptions ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:83:35
 ❯ Module.createLiveQueryCollection ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:191:21

test/entity-timeline.test.ts > entity includes query > includes query reactivity > reasoning content survives multiple run-row updates in sequence

Stack Traces | 0.00107s run time

QueryBuilderError: Invalid source for live query: The value provided for alias "realtimeTranscript" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.
 ❯ BaseQueryBuilder._createRefsForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:149:15
 ❯ BaseQueryBuilder._createRefForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:94:23
 ❯ BaseQueryBuilder.from ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:177:27
 ❯ buildEntityTimelineQuery src/entity-timeline.ts:1587:6
 ❯ src/entity-timeline.ts:1502:38
 ❯ buildQuery ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:1370:18
 ❯ buildQueryFromConfig ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/utils.ts:261:9
 ❯ new CollectionConfigBuilder ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/collection-config-builder.ts:174:18
 ❯ liveQueryCollectionOptions ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:83:35
 ❯ Module.createLiveQueryCollection ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:191:21

test/entity-timeline.test.ts > entity includes query > includes query reactivity > live items.text.content streams in even alongside reasoning (alias-collision regression)

Stack Traces | 0.0114s run time

QueryBuilderError: Invalid source for live query: The value provided for alias "realtimeTranscript" is not a Collection or subquery. Live queries only accept Collection instances or subqueries. Please ensure you're passing a valid Collection or QueryBuilder, not a plain array or other data type.
 ❯ BaseQueryBuilder._createRefsForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:149:15
 ❯ BaseQueryBuilder._createRefForSource ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:94:23
 ❯ BaseQueryBuilder.from ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:177:27
 ❯ buildEntityTimelineQuery src/entity-timeline.ts:1587:6
 ❯ src/entity-timeline.ts:1502:38
 ❯ buildQuery ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/builder/index.ts:1370:18
 ❯ buildQueryFromConfig ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/utils.ts:261:9
 ❯ new CollectionConfigBuilder ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../query/live/collection-config-builder.ts:174:18
 ❯ liveQueryCollectionOptions ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:83:35
 ❯ Module.createLiveQueryCollection ../../node_modules/.pnpm/@tanstack+db@0.6.7_typescript@5.9.3/node_modules/@.../src/query/live-query-collection.ts:191:21

test/process-wake.test.ts > processWake > collapses wake batches only until a later message batch and then handles the message next

Stack Traces | 0.205s run time

AssertionError: expected [ 'message:', …(2) ] to deeply equal [ 'message:', …(2) ]

- Expected
+ Received

  [
    "message:",
-   "wake:/child/second",
+   "wake:http://localhost:3000/test-agent/agent-1",
    "message:follow-up",
  ]

 ❯ test/process-wake.test.ts:2649:27

test/process-wake.test.ts > processWake > collapses consecutive pending wake batches into one handler pass using the newest wake

Stack Traces | 0.21s run time

AssertionError: expected [ 'message:', …(1) ] to deeply equal [ 'message:', 'wake:/child/second' ]

- Expected
+ Received

  [
    "message:",
-   "wake:/child/second",
+   "wake:http://localhost:3000/test-agent/agent-1",
  ]

 ❯ test/process-wake.test.ts:2487:27

To view more test analytics, go to the Test Analytics Dashboard
_{📋 Got 3 mins? Take this short survey to help us improve Test Analytics.}

github-actions · 2026-06-17T18:20:31Z

Electric Agents Mobile Build

Local mobile checks ran for commit c76a1ee.

The EAS Android preview build was skipped because the mobile-eas-build label is not present.
Add the mobile-eas-build label to this PR to produce an installable preview build.

Workflow run

samwillis added 30 commits June 17, 2026 10:47

Add streaming tool call argument support

bd11fb5

Preserve legacy tool call start status

28b15f0

Address streaming tool call review feedback

a4e79ee

Add collaborative markdown documents

69b7333

Avoid bundling Yjs in agents client entry

a5cd78d

Align yjs example CodeMirror dependencies

c4c7722

Fix manifest schema after markdown docs rebase

835b8df

feat(agents): add realtime stream foundations

366b763

feat(agents-runtime): add realtime handler API

f1ef114

feat(agents-server): add realtime session route

a282191

feat(agents-runtime): add realtime session client

6e6996a

feat(agents-runtime): add openai realtime provider

12d55fe

feat(agents-runtime): bridge realtime durable streams

614eee0

feat(agents): route horton realtime sessions

749c992

feat(agents-ui): add realtime voice toggle

ca8781f

feat(agents-ui): route realtime text input

0f2eac5

fix(agents): harden realtime session lifecycle

2cea387

fix(agents): make realtime voice input activate reliably

70b7269

fix(agents): avoid inactive realtime response cancel

1e0bc36

fix(agents): use supported OpenAI realtime model

3dc5e98

fix(agents): wire realtime audio path

7d8ae27

fix(agents): clamp realtime audio truncation

9cc3f01

feat(agents): persist realtime transcripts

fc78938

feat(agents-ui): start realtime from spawn screen

9e523f0

fix(agents): anchor realtime transcripts at speech start

4adcf20

fix(agents-ui): keep send button in realtime mode

774bfb0

fix(agents): interleave realtime transcripts

2895414

fix(agents): order realtime tool runs by visible items

46e6839

fix(agents): batch realtime durable stream appends

19ccda7

fix(agents): capture realtime audio in worklet

9d95f5e

samwillis added 10 commits June 17, 2026 12:11

fix(agents): title realtime sessions from user transcript

d3bf32d

Improve Horton realtime audio streaming

f6db31e

fix(agents): use gpt-realtime-2

60c29d4

feat(agents): expose realtime settings

bf42065

fix(agents): gate realtime controls on credentials

e5f2220

feat(agents): polish realtime voice mode

4b24479

chore: add realtime agents changeset

26a51b6

fix(agents): address realtime review feedback

8de1e24

feat(agents): demo realtime markdown editing

c76a1ee

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Realtime chat and document editing demo#4618

Realtime chat and document editing demo#4618
samwillis wants to merge 40 commits into
mainfrom
codex/draft-realtime-agents-markdown-docs

samwillis commented Jun 17, 2026

Uh oh!

github-actions Bot commented Jun 17, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Jun 17, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

samwillis commented Jun 17, 2026

Summary

What changed

Validation

Uh oh!

github-actions Bot commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Electric Agents Desktop Builds

Uh oh!

codecov Bot commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❌ 6 Tests Failed:

Uh oh!

github-actions Bot commented Jun 17, 2026

Electric Agents Mobile Build

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions Bot commented Jun 17, 2026 •

edited

Loading

codecov Bot commented Jun 17, 2026 •

edited

Loading