docs: correct three unverified capability claims - #78
Merged
Conversation
The README comparison table and feature list described behaviour the node does not have. Session length "up to 8 hours" cited limits belonging to other resources. LifecycleConfiguration.maxLifetime (default 28800s) is the AgentCore Runtime instance lifetime, and the 28800s ceiling on SessionConfiguration.sessionTimeoutInSeconds is for MCP Gateway sessions. The only duration this node sends is the per-invocation timeoutSeconds, default 600, so no user could reach eight hours through it. Streaming was listed as shipped. consumeStream() accumulates the event stream and returns a completed result, and the node never calls n8n's sendChunk, so nothing reaches the streaming UI. Renamed to "Structured responses" and moved streaming to the later roadmap row. "Firecracker microVM per session" named a hypervisor AWS public documentation does not name. The table and docs/SPEC.md now say "isolated microVM", matching the AgentCore docs. Same class of error as the AI Agent comparison corrected in #77.
aidandaly24
approved these changes
Aug 20, 2026
notgitika
approved these changes
Aug 20, 2026
notgitika
left a comment
There was a problem hiding this comment.
LGTM
Let's explore changelog changes being auto generated instead of manual code changes
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.
Docs only. Three claims in the README described behaviour the node does not have. Found while doing a pre-release check of the docs going out with the launch, and they are the same class of error as the AI Agent comparison corrected in #77.
1. "Session length: up to 8 hours"
The 28800-second figure appears twice in the SDK types, and neither is a harness session:
LifecycleConfiguration.maxLifetime— default 28800s, but that is the AgentCore Runtime instance lifetime, not a harness sessionSessionConfiguration.sessionTimeoutInSeconds— max 28800s, but that is MCP Gateway session configThe node never sends either field (
grep -rn "maxLifetime\|idleRuntimeSessionTimeout" nodes/ credentials/returns nothing). The only duration it sends is the per-invocationtimeoutSeconds, default 600, described in the UI as "wall-clock timeout for the entire invocation". So no user could reach eight hours through this node.Now reads:
Long-running sessions, with a per-invocation timeout you set2. "Streaming responses" listed as a shipped feature
consumeStream()reads the event stream and accumulates — the doc comment at the top ofhelpers/stream.tssays so.grep -rn "sendChunk\|isStreaming" nodes/returns nothing, so nothing reaches n8n's streaming UI. The node consumes a streaming API; it does not stream.This matters because an n8n user reading the feature list would reasonably expect token-by-token output in the chat panel. An FSI SA asked about exactly this and offered to file a feature request.
Renamed to Structured responses, with the distinction stated explicitly, and streaming moved from the v0.1 roadmap row to
later.3. "Firecracker microVM per session"
AWS public documentation for AgentCore says "isolated microVM" and "session isolation" without naming the hypervisor. The only source for Firecracker in this repo is our own
docs/SPEC.md, so the claim was circular. The comparison table anddocs/SPEC.md(prose plus the ASCII diagram) now say "isolated microVM", matching the AgentCore docs.Why now
npm currently serves the pre-#77 README, so the next release is what puts the corrected text on the npm page. That release lines up with the n8n partner blog and the AWS channel post, so this is the last chance to get the docs right before traffic arrives.
Checks run locally
typecheck,lint,format:check,test(114 passing / 12 files),secrets:check— all pass. No code touched, so no behaviour change and no nodetypeVersionbump.