canon(methods): add CF Agents Week substrates (DOs + Agents SDK, Project Think, Dynamic Workflows, Dynamic Workers)#197
Merged
Conversation
Adds Durable Objects + Agents SDK, Project Think, Dynamic Workflows, and Dynamic Workers to the substrate catalog. Inserts the execution-ladder composition pattern between Mixing Tools and When-To-Pick. Updates decision tree with subscribed-session (4a) and multi-step durable workflow (4b) cases. Adds canonical-session-contract bullet to Things-That-Do-Not-Vary. References klappy://canon/methods/trigger-source-taxonomy for the dispatch-routing convention these triggers feed. Substrate-property framing — hibernation, trigger-surface diversity, composition — is the durable contribution; specific numbers dated to May 2026 and will age.
Canon Quality — Frontmatter Schema ✅All 40 file(s) in Validator: |
Canon Quality —
|
klappy
added a commit
that referenced
this pull request
May 12, 2026
…above the runtime Adds klappy://canon/methods/trigger-source-taxonomy as a Tier-2 method specifying the dispatch-routing layer between trigger sources (HTTP webhooks, AMS frames, alarms, email, RPC, queue messages, object-store events, platform webhooks, push notifications) and runtime.invoke(). Three-method trichotomy: static (deployment-time tuple), lookup (config + table keyed on payload), payload-derived (classifier or rule set). Prior art cited: Hohpe & Woolf EAI patterns, AWS EventBridge rules, k8s admission webhooks. Nine-source enumeration in three categories (transport-level, infrastructure-level, application-level). Worked example: R2/object-store + ESE pipeline for drag-and-drop knowledge ingestion. Resolves the runtime-contract's open question on subscribed-session shape (it's a property of trigger source, not a session dimension). Status proposed; first impl is the AMS audit gate. Resolves forward reference from PR #197.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the Cloudflare Agents Week (April 2026) substrates to
klappy://canon/methods/spawned-agent-session-substrate-options, plus the execution-ladder composition pattern.What this PR does
Eight surgical splices to
canon/methods/spawned-agent-session-substrate-options.md:klappy://canon/methods/spawned-agent-session-runtime-contract.Forward reference
This commit forward-references
klappy://canon/methods/trigger-source-taxonomyin the trigger-surface diversity bullet. That doc is drafted (5962 words on the operator's machine) and pending its own PR; the forward reference is intentional so this doc names the dispatch-routing layer where it belongs.What did NOT change
The substrate-pattern framing — concrete substrates as illustrations of properties, not vendor marketing — is preserved. All existing sections retain their original content. Cost numbers in existing sections were not re-priced; only the new sections carry May 2026 numbers, and the Notes-on-Aging dating note tags the update date for future auditors.
Status
status: drafton the existing doc frontmatter is unchanged. This addition is additive, not a stability promotion.Note
Low Risk
Low risk because this PR only updates a canon markdown method doc; no runtime code paths or configuration are changed.
Overview
Updates
spawned-agent-session-substrate-options.mdto broaden the substrate catalog beyond Sandboxes/Managed Agents by adding Cloudflare Agents Week primitives: Durable Objects + Agents SDK (and preview Project Think), Dynamic Workflows, and Dynamic Workers, including new billing dimensions, defining properties (hibernation, trigger surface, millisecond-boot isolates), and worked cost-shape examples.Expands the selection guidance with an execution-ladder composition section (DO → Dynamic Worker → npm → browser → Sandbox) and a dispatch-capability matrix, adds decision-tree branches for subscribed and multi-step durable session shapes, and cross-links the substrate-independent
spawned-agent-session-runtime-contractplus new dating/see-also references.Reviewed by Cursor Bugbot for commit e3fac03. Bugbot is set up for automated code reviews on this repo. Configure here.