Skip to content

docs(think): multi-chat guide and refresh Think design docs - #2409

Merged
threepointone merged 5 commits into
mainfrom
docs-think-multi-chat-and-design-refresh
Sep 29, 2026
Merged

threepointone merged 5 commits into
mainfrom
docs-think-multi-chat-and-design-refresh

Conversation

@threepointone

@threepointone threepointone commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Documentation only. Part of wrapping up the Project Think roadmap (#1439).

What changed:

  • New docs/think/multi-chat.md: one Think child per conversation under a parent directory. Covers creating, listing and deleting chats, client routing, the shared workspace and MCP boundary, what stays per chat, and known limits. Based on examples/assistant. Linked from docs/think/index.md.
  • design/think.md: rewritten to describe current main (composition with Sessions, Streams and Tasks, the turn pipeline, persistence, recovery, wire protocol, tools and tables).
  • design/think-vs-aichat.md: comparison tables and examples corrected against current APIs.
  • design/chat-shared-layer.md: module list, sanitize/row-size section, protocol notes, tradeoffs and history brought up to date (React hook hoist, Sessions and Streams replatform, Tasks-based recovery).
  • design/chat-improvements.md: rewritten as a short status record of what shipped and what did not.
  • design/AGENTS.md: contents table refreshed, and the row for the deleted think-sessions.md removed. design/README.md: workspace link fixed.

No changeset needed.

Made with Cursor


Devin Review

Add docs/think/multi-chat.md, based on examples/assistant. Refresh
design/think.md, think-vs-aichat.md, chat-shared-layer.md and
chat-improvements.md against current main. Update the design/AGENTS.md
contents table and fix the design/README.md workspace link.

Refs #1439

Co-authored-by: Cursor <cursoragent@cursor.com>
@changeset-bot

changeset-bot Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 8df3fe4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@agent-think

agent-think Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

✅ agents import sizes: no significant changes (484f7abb → 8df3fe4a, workflow run)

@devin-ai-integration devin-ai-integration Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

Newer findings are available below. Devin Review posted a newer report on this PR, in addition to the findings presented here.

Devin Review found 3 potential issues.

Devin Review

Comment thread docs/think/multi-chat.md

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔍 Confirm upstream documentation sync

The docs policy requires a matching cloudflare-docs update. This checkout cannot establish whether the new guide and index link were ported.

Devin Review


Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. The cloudflare-docs port (src/content/docs/agents/) will be a separate PR in cloudflare/cloudflare-docs once this one is merged.

Comment thread design/think-vs-aichat.md Outdated
Comment thread docs/think/multi-chat.md
- docs/think/index.md: Think has no onChatMessage; AIChatAgent stores in
  Sessions; search is per conversation; current compatibility_date
- multi-chat guide: say up front that reference-app chats are facets, and
  drop the hedging about the topology
- think-vs-aichat: only workspace file and Bash tools are on by default
- sub-agent-routing: WebSocket frames go through the root parent
- sessions, chat-api, think-roadmap: point at current docs and fix a
  broken anchor
- think.ts header and assistant persona: one conversation per instance,
  extensions are per chat

Co-authored-by: Cursor <cursoragent@cursor.com>
@pkg-pr-new

pkg-pr-new Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

agents

npm i https://pkg.pr.new/agents@2409

@cloudflare/ai-chat

npm i https://pkg.pr.new/@cloudflare/ai-chat@2409

@cloudflare/codemode

npm i https://pkg.pr.new/@cloudflare/codemode@2409

hono-agents

npm i https://pkg.pr.new/hono-agents@2409

@cloudflare/shell

npm i https://pkg.pr.new/@cloudflare/shell@2409

@cloudflare/think

npm i https://pkg.pr.new/@cloudflare/think@2409

@cloudflare/voice

npm i https://pkg.pr.new/@cloudflare/voice@2409

@cloudflare/worker-bundler

npm i https://pkg.pr.new/@cloudflare/worker-bundler@2409

commit: 8df3fe4

devin-ai-integration[bot]

This comment was marked as resolved.

threepointone and others added 3 commits September 29, 2026 14:26
@threepointone
threepointone merged commit c2a7bc5 into main Sep 29, 2026
8 checks passed
@threepointone
threepointone deleted the docs-think-multi-chat-and-design-refresh branch September 29, 2026 22:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant