feat(server,web,mobile): agents see snooze state and link to threads

[t3dotgg]

Agents cannot tell which threads are snoozed. When they mention another thread, the user has no way to open it from the chat.

What changed

Snooze state for agents

• t3_thread_list and t3_thread_read report snoozed and snoozedUntil. t3_thread_list takes a snoozed filter.
• isSnoozed in ThreadSettlementService uses the sidebar's rule. A snoozed thread wakes early when it asks for something, fails, or completes after it was snoozed. isAutoSettlementCandidate does not change.

Thread links

• Links have the form [title](t3-thread://v1/<environmentId>/<threadId>) (@t3tools/shared/threadLinks).
• Thread list, read, and launch results include a ready link. Tool descriptions tell agents to paste it.
• Web and desktop chat show these links with the thread's project icon and open the thread in the app.
• Mobile opens the Thread screen. This works in the native selectable markdown renderer and in the fallback renderer.

The screenshot uses isolated dev state seeded from a snapshot.

This was split out of #15975 (Home), which will rebase onto it. queue.hold stays in #15975 because only Home would send it. Main already holds queues through run.interrupt with holdQueue.

Reviewed with sol-loop: 3 rounds with gpt-6.1-sol on high.

Made with Claude Opus 5.5 (1M context) in Claude Code, running in T3 Code.

🤖 Generated with Claude Code

Closes #16194

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This adds a new cross-platform thread-link workflow and changes MCP list/read/launch responses to include computed snooze state and links by default. The shared protocol, server semantics, and new web/mobile navigation span multiple production surfaces, so the change warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Path: .coderabbit.config.ts
• Review profile: CHILL
• Plan: Team
• Run ID: 0347a75b-8f26-45c7-9357-ba9db3615117

📥 Commits

Reviewing files that changed from the base of the PR and between cd41c4a and 6e0b2d9.

📒 Files selected for processing (18)

• apps/mobile/modules/t3-markdown-text/src/markdownLinks.ts
• apps/mobile/src/features/threads/ThreadFeed.tsx
• apps/mobile/src/lib/nativeMarkdownText.test.ts
• apps/server/src/mcp/OrchestratorMcpService.ts
• apps/server/src/mcp/OrchestratorMcpToolkit.integration.test.ts
• apps/server/src/mcp/toolkits/orchestrator/tools.ts
• apps/server/src/mcp/toolkits/project/handlers.test.ts
• apps/server/src/mcp/toolkits/project/handlers.ts
• apps/server/src/mcp/toolkits/project/tools.ts
• apps/server/src/orchestration-v2/ThreadSettlementService.test.ts
• apps/server/src/orchestration-v2/ThreadSettlementService.ts
• apps/web/src/components/ChatMarkdown.tsx
• apps/web/src/components/chat/MarkdownThreadLink.tsx
• docs/orchestration-v2/orchestrator-mcp-server.md
• packages/contracts/src/orchestratorMcp.ts
• packages/shared/package.json
• packages/shared/src/threadLinks.test.ts
• packages/shared/src/threadLinks.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 9 remain after this review.

---

📝 Walkthrough

Walkthrough

The change adds a shared t3-thread:// link format, uses thread links in MCP results, exposes snooze state and filtering in MCP thread list and read results, and enables web and mobile Markdown to preserve and navigate thread links.

Changes

Thread links and snooze metadata

Layer / File(s)	Summary
Shared thread-link format packages/shared/src/threadLinks.ts, packages/shared/src/threadLinks.test.ts, packages/shared/package.json	Adds formatting and parsing for versioned thread links, tests valid and invalid links, and exports the utility from the shared package.
Snooze-state rules apps/server/src/orchestration-v2/ThreadSettlementService.ts, apps/server/src/orchestration-v2/ThreadSettlementService.test.ts	Adds isSnoozed to evaluate deadlines, pending requests, and run outcomes. Tests cover interrupted runs, completed runs, and expired snoozes.
MCP thread responses and launch links packages/contracts/src/orchestratorMcp.ts, apps/server/src/mcp/OrchestratorMcpService.ts, apps/server/src/mcp/toolkits/orchestrator/tools.ts, apps/server/src/mcp/toolkits/project/*, apps/server/src/mcp/OrchestratorMcpToolkit.integration.test.ts, docs/orchestration-v2/orchestrator-mcp-server.md	Adds thread links to list, read, and launch results. List and read results include snooze state and deadline, and thread listing accepts a snoozed-state filter. Tool descriptions, schemas, integration tests, and documentation cover these fields.
Markdown thread-link rendering and navigation apps/web/src/components/ChatMarkdown.tsx, apps/web/src/components/chat/MarkdownThreadLink.tsx, apps/mobile/modules/t3-markdown-text/src/markdownLinks.ts, apps/mobile/src/features/threads/ThreadFeed.tsx, apps/mobile/src/lib/nativeMarkdownText.test.ts	Web and mobile Markdown preserve recognized thread-link URLs. The web renderer displays a dedicated thread-link component, and mobile link handling navigates to the referenced thread. The mobile test checks that the native Markdown run retains the href.

Priority: ➖ Normal

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Feature · Severity of issue fixed: Low

Sequence Diagram(s)

sequenceDiagram
  participant ChatMarkdown
  participant parseThreadLinkHref
  participant MarkdownThreadLink
  participant ThreadRoute
  ChatMarkdown->>parseThreadLinkHref: Validate the thread-link href
  parseThreadLinkHref-->>ChatMarkdown: Return environment and thread IDs
  ChatMarkdown->>MarkdownThreadLink: Render the link with the parsed IDs
  MarkdownThreadLink->>ThreadRoute: Link to the environment and thread

Loading

Suggested reviewers: juliusmarminge

Merge Risk: ⚪ Minimal · up to 6e0b2

No concrete issue remains that blocks merging after normal checks.

🚥 Pre-merge checks | ✅ 3 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	#16194 covers in-chat thread links, not snooze-state reporting or settlement rules. Changes to isSnoozed, snoozed list filtering, snoozed and snoozedUntil response fields, related tests, and doc…	Remove the snooze-state and settlement changes from this PR, including their API fields, filters, tests, and documentation. Submit that work under the relevant snooze/Home scope separately.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	#16194 requires assistant replies to link to an existing thread and open it inside the current client with the correct environment and thread IDs. formatThreadLink and parseThreadLinkHref define a…
Title check	✅ Passed	The title clearly summarizes the main changes: agents can see snooze state and link to threads.
Description check	✅ Passed	The description explains the problem and changes, and includes UI evidence. It does not provide the template’s Scope and approval section or focused verification results.

Full details: Out of Scope Changes check

Explanation

#16194 covers in-chat thread links, not snooze-state reporting or settlement rules. Changes to isSnoozed, snoozed list filtering, snoozed and snoozedUntil response fields, related tests, and documentation add a separate snooze feature. The PR description also identifies that work as split from #15975.

• Fix all pre-merge checks with AI

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

ℹ️ The exact PR base did not have a successful artifact. Baseline uses the latest successful main measurement shown below.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	4.9 KiB	5.0 KiB	+23 B (+0.5%)	6.8 KiB	✅
Codex	Thread snapshot wire	3.8 KiB	3.8 KiB	0 B (0.0%)	4.9 KiB	✅
Codex	Live turn WebSocket wire	1.2 KiB	1.2 KiB	+23 B (+1.9%)	2.0 KiB	✅
Codex	Live turn WebSocket decoded	20.8 KiB	20.9 KiB	+41 B (+0.2%)	29.3 KiB	✅
Codex	Live turn messages	1	2	+1 (+100.0%)	8	✅
Claude	Total thread wire	5.0 KiB	5.0 KiB	−41 B (−0.8%)	6.8 KiB	✅
Claude	Thread snapshot wire	3.8 KiB	3.8 KiB	0 B (0.0%)	4.9 KiB	✅
Claude	Live turn WebSocket wire	1.2 KiB	1.2 KiB	−41 B (−3.3%)	2.0 KiB	✅
Claude	Live turn WebSocket decoded	21.2 KiB	21.2 KiB	−41 B (−0.2%)	29.3 KiB	✅
Claude	Live turn messages	2	1	−1 (−50.0%)	8	✅

Baseline: 250e052 · PR result: 6e0b2d9 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 108.5 KiB
• Claude decoded thread snapshot: 108.8 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.