René's URL Explorer Experiment


Title: docs(ai-chat): head-start persistence contract and a clearer sessions page by ericallam · Pull Request #3908 · triggerdotdev/trigger.dev · GitHub

Open Graph Title: docs(ai-chat): head-start persistence contract and a clearer sessions page by ericallam · Pull Request #3908 · triggerdotdev/trigger.dev

X Title: docs(ai-chat): head-start persistence contract and a clearer sessions page by ericallam · Pull Request #3908 · triggerdotdev/trigger.dev

Description: Summary Two documentation improvements for the AI chat docs. Head-start persistence contract. The fast starts page now documents what your hooks can rely on across a head-start handover: one stable assistant messageId for the whole turn, onTurnComplete as the canonical persistence point, reasoning parts flowing into durable history, and how Head Start composes with hydrateMessages (the first-turn history arrives as incomingMessages, and the runtime splices the warm partial onto the hydrated chain, deduplicated by id). The hydrate examples on the lifecycle hooks and database persistence pages now upsert their conversation row, since head-start first turns run without a preload to create it. Sessions page. The page opened with "a durable, task-bound, bi-directional I/O channel pair", which reads as jargon and omitted run orchestration entirely. It now leads with the plain mental model (a pair of durable streams: input carries user messages, output carries everything the agent produces) plus the Session's role orchestrating runs, a diagram, a minimal runnable example, and a section on the one-session-many-runs lifecycle. Documents behavior shipping in #3907.

Open Graph Description: Summary Two documentation improvements for the AI chat docs. Head-start persistence contract. The fast starts page now documents what your hooks can rely on across a head-start handover: one stable...

X Description: Summary Two documentation improvements for the AI chat docs. Head-start persistence contract. The fast starts page now documents what your hooks can rely on across a head-start handover: one stable...

Opengraph URL: https://github.com/triggerdotdev/trigger.dev/pull/3908

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:72011e31-e957-1020-aac1-029695f9dcf0
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idBD90:3222F:A7EF45:E64C0B:6AFBDC20
html-safe-nonce8d4e1a254c80f2075b7f3b997a604b478418a2179b6f031b36e01ba6014a990a
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCRDkwOjMyMjJGOkE3RUY0NTpFNjRDMEI6NkFGQkRDMjAiLCJ2aXNpdG9yX2lkIjoiMzkxNjU5NzY2NTYxMjk0NjQ2NCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmacbcce3cbff727ff0880ca2962613a7107d475498e798f4d4882333bbdea380a79
hovercard-subject-tagpull_request:3848593972
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/triggerdotdev/trigger.dev/pull/3908/files
twitter:imagehttps://avatars.githubusercontent.com/u/534?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/534?s=400&v=4
og:image:altSummary Two documentation improvements for the AI chat docs. Head-start persistence contract. The fast starts page now documents what your hooks can rely on across a head-start handover: one stable...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None18742cb872ec73544356e60359266b67aafece70c4ce008042e06227924cdd07
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/triggerdotdev/trigger.dev git https://github.com/triggerdotdev/trigger.dev.git
octolytics-dimension-user_id95297378
octolytics-dimension-user_logintriggerdotdev
octolytics-dimension-repository_id572570113
octolytics-dimension-repository_nwotriggerdotdev/trigger.dev
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id572570113
octolytics-dimension-repository_network_root_nwotriggerdotdev/trigger.dev
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release820be804f18e1ef3940bd74a00d41d73d02e2b91
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Ftriggerdotdev%2Ftrigger.dev%2Fpull%2F3908%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Ftriggerdotdev%2Ftrigger.dev%2Fpull%2F3908%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=triggerdotdev%2Ftrigger.dev
Reloadhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
Reloadhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
Reloadhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
triggerdotdevhttps://github.com/triggerdotdev
trigger.devhttps://github.com/triggerdotdev/trigger.dev
Codehttps://github.com/triggerdotdev/trigger.dev
Issues203 (203)https://github.com/triggerdotdev/trigger.dev/issues
Pull requests67 (67)https://github.com/triggerdotdev/trigger.dev/pulls
Discussionshttps://github.com/triggerdotdev/trigger.dev/discussions
Actionshttps://github.com/triggerdotdev/trigger.dev/actions
Projectshttps://github.com/triggerdotdev/trigger.dev/projects
Security and quality39 (39)https://github.com/triggerdotdev/trigger.dev/security
Insightshttps://github.com/triggerdotdev/trigger.dev/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Ftriggerdotdev%2Ftrigger.dev%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Ftriggerdotdev%2Ftrigger.dev%2Fissues%2Fnew%2Fchoose
ericallamhttps://github.com/ericallam
mainhttps://github.com/triggerdotdev/trigger.dev/tree/main
docs/headstart-persistence-contracthttps://github.com/triggerdotdev/trigger.dev/tree/docs/headstart-persistence-contract
Conversation 14 https://github.com/triggerdotdev/trigger.dev/pull/3908
Commits 5 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits
Checks 25 https://github.com/triggerdotdev/trigger.dev/pull/3908/checks
Files changed https://github.com/triggerdotdev/trigger.dev/pull/3908/files
Please reload this pagehttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
docs(ai-chat): head-start persistence contract and a clearer sessions page https://github.com/triggerdotdev/trigger.dev/pull/3908/files#top
Show all changes 5 commits https://github.com/triggerdotdev/trigger.dev/pull/3908/files
d2924d2 docs(ai-chat): document the head-start persistence and handover contract ericallam Jun 11, 2026 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits/d2924d272b98e1aa60ad2186648a43abca489954
e4c81d0 docs(ai-chat): lead the sessions page with a plain definition ericallam Jun 11, 2026 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits/e4c81d0566e3a7138fbeb47adf6916f04f2d37d9
b80d6c4 docs(ai-chat): soften the incomingMessages cardinality claim ericallam Jun 11, 2026 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits/b80d6c49118eb3a32fef1bf46b75c0c9f448f94d
d89c04d docs(ai-chat): fix the second incomingMessages cardinality claim ericallam Jun 11, 2026 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits/d89c04d6de88e16e03576e7465980397b02b1a34
864711c docs(ai-chat): upsert the hydrate row in the persistence-and-replay e… ericallam Jun 11, 2026 https://github.com/triggerdotdev/trigger.dev/pull/3908/commits/864711c3876cdc0f91a29d93b18a2895ffb978e8
Clear filters https://github.com/triggerdotdev/trigger.dev/pull/3908/files
Please reload this pagehttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
Please reload this pagehttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
fast-starts.mdx https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-08c505bdbdd4d7c4e8227461df62a19bcf73ffee36f392fbed504190c435c6f7
lifecycle-hooks.mdx https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
database-persistence.mdx https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-9e1981eb3bb0ae457c24136ae88ab15803a55ded25461102059ad0c6d32614c9
persistence-and-replay.mdx https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-bc5d1cbfd7d45233081b9c0a7996f96fb86b6e52b092f3f4a83bfa44575c91ae
sessions.mdx https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-04e9b0f42163aa711ad3c8379caacb32e9a280844d37de6efd586fac464c2a70
docs/ai-chat/fast-starts.mdxhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-08c505bdbdd4d7c4e8227461df62a19bcf73ffee36f392fbed504190c435c6f7
View file https://github.com/triggerdotdev/trigger.dev/blob/864711c3876cdc0f91a29d93b18a2895ffb978e8/docs/ai-chat/fast-starts.mdx
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/triggerdotdev/trigger.dev/pull/3908/{{ revealButtonHref }}
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-08c505bdbdd4d7c4e8227461df62a19bcf73ffee36f392fbed504190c435c6f7
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-08c505bdbdd4d7c4e8227461df62a19bcf73ffee36f392fbed504190c435c6f7
docs/ai-chat/lifecycle-hooks.mdxhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
View file https://github.com/triggerdotdev/trigger.dev/blob/864711c3876cdc0f91a29d93b18a2895ffb978e8/docs/ai-chat/lifecycle-hooks.mdx
Open in desktop https://desktop.github.com
Please reload this pagehttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
https://github.co/hiddenchars
https://github.com/triggerdotdev/trigger.dev/pull/3908/{{ revealButtonHref }}
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
Please reload this pagehttps://github.com/triggerdotdev/trigger.dev/pull/3908/files
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-3730a31f18496bdcec2571bbe6ab9622739c0446facb32f4cbbd6a155eb04b35
docs/ai-chat/patterns/database-persistence.mdxhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-9e1981eb3bb0ae457c24136ae88ab15803a55ded25461102059ad0c6d32614c9
View file https://github.com/triggerdotdev/trigger.dev/blob/864711c3876cdc0f91a29d93b18a2895ffb978e8/docs/ai-chat/patterns/database-persistence.mdx
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/triggerdotdev/trigger.dev/pull/3908/{{ revealButtonHref }}
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-9e1981eb3bb0ae457c24136ae88ab15803a55ded25461102059ad0c6d32614c9
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-9e1981eb3bb0ae457c24136ae88ab15803a55ded25461102059ad0c6d32614c9
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-9e1981eb3bb0ae457c24136ae88ab15803a55ded25461102059ad0c6d32614c9
docs/ai-chat/patterns/persistence-and-replay.mdxhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-bc5d1cbfd7d45233081b9c0a7996f96fb86b6e52b092f3f4a83bfa44575c91ae
View file https://github.com/triggerdotdev/trigger.dev/blob/864711c3876cdc0f91a29d93b18a2895ffb978e8/docs/ai-chat/patterns/persistence-and-replay.mdx
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/triggerdotdev/trigger.dev/pull/3908/{{ revealButtonHref }}
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-bc5d1cbfd7d45233081b9c0a7996f96fb86b6e52b092f3f4a83bfa44575c91ae
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-bc5d1cbfd7d45233081b9c0a7996f96fb86b6e52b092f3f4a83bfa44575c91ae
docs/ai-chat/sessions.mdxhttps://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-04e9b0f42163aa711ad3c8379caacb32e9a280844d37de6efd586fac464c2a70
View file https://github.com/triggerdotdev/trigger.dev/blob/864711c3876cdc0f91a29d93b18a2895ffb978e8/docs/ai-chat/sessions.mdx
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/triggerdotdev/trigger.dev/pull/3908/{{ revealButtonHref }}
https://github.com/triggerdotdev/trigger.dev/pull/3908/files#diff-04e9b0f42163aa711ad3c8379caacb32e9a280844d37de6efd586fac464c2a70
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.