Skip to content

[Agents] Add changelog for resumable Computer JavaScript runs - #34552

Merged
scuffi merged 6 commits into
productionfrom
changelog/computer-durable-javascript
Oct 26, 2026
Merged

scuffi merged 6 commits into
productionfrom
changelog/computer-durable-javascript

Conversation

@scuffi

@scuffi scuffi commented Oct 23, 2026

Copy link
Copy Markdown
Member

Summary

Adds a changelog entry for two experimental features coming in @cloudflare/computer v0.7.0: isolate JavaScript runs that resume after a deploy or crash, and runs that pause until someone answers, for example to approve an action.

The entry links to the "Resume runs after a restart" section added in #34551, which holds the setup details and current limitations, so it should merge together with or after #34551. Hold it until v0.7.0 is released, and update the version and date then if they have changed.

Documentation checklist

@github-actions github-actions Bot added product:changelog product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Oct 23, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://changelog-computer-durable-javascript.previews.developers.cloudflare.com (commit f48de93)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://f13883ef.previews.developers.cloudflare.com f48de93 2026-10-26T15:00:58.707Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://63891c98.previews.developers.cloudflare.com 825f647 2026-10-26T14:10:14.465Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://a3341225.previews.developers.cloudflare.com 7fbea76 2026-10-23T14:21:42.122Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://a972eecf.previews.developers.cloudflare.com dfecb78 2026-10-23T10:23:01.378Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://d433cf77.previews.developers.cloudflare.com f6f2f0b 2026-10-23T10:01:41.427Z Visit the dashboard ↗

@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

@scuffi
scuffi marked this pull request as ready for review October 23, 2026 10:10
@scuffi
scuffi requested review from a team, irvinebroque and rita3ko as code owners October 23, 2026 10:10
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed f48de93 · 2 findings · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #34552 (https://github.com/cloudflare/cloudflare-docs/pull/34552).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit because the next review reads PR comments.

## Code Review
- C-00ed8be2 | src/content/changelog/agents/2026-10-26-computer-durable-javascript.mdx:65 | Undefined `github` identifier in the `postComment` example
  `github` is not declared, imported, or otherwise in scope in this example, so it will not compile or run as written. The equivalent example in `src/content/docs/agents/tools/filesystem.mdx` (`Resume runs after a restart` → `Wait for an answer`) uses `this.postComment(issue, body, { idempotencyKey: ctx.callId })`, and the comment above the module shows that `ws:github` is the module name the agent imports from, not a variable.
  ```txt
  return github.comment(issue, body, { idempotencyKey: ctx.callId });
  ```

## Style Guide
- S-09ca4ca6 | src/content/changelog/agents/2026-10-26-computer-durable-javascript.mdx:46 | Passive voice where active voice would be clearer
  The style guide requires rewriting passive voice in favor of active voice. `User functionality can be provided to the agent's code` is passive; an active construction naming the actor (the reader) would be clearer.

Code Review

Skipped: no new code changes since the last review.

  • src/content/changelog/agents/2026-10-26-computer-durable-javascript.mdx:65 · Undefined github identifier in the postComment example

    github is not declared, imported, or otherwise in scope in this example, so it will not compile or run as written. The equivalent example in src/content/docs/agents/tools/filesystem.mdx (Resume runs after a restart → Wait for an answer) uses this.postComment(issue, body, { idempotencyKey: ctx.callId }), and the comment above the module shows that ws:github is the module name the agent imports from, not a variable.

    return github.comment(issue, body, { idempotencyKey: ctx.callId });

Style Guide

Skipped: no new docs content changes since the last review.

  • src/content/changelog/agents/2026-10-26-computer-durable-javascript.mdx:46 · Passive voice where active voice would be clearer

    The style guide requires rewriting passive voice in favor of active voice. User functionality can be provided to the agent's code is passive; an active construction naming the actor (the reader) would be clearer.

Not reviewed (1)
  • src/assets/images/agents/computer-approval-flow.svg — excluded path or binary file
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.


Once every waiting call in the run has an answer, the run continues, and `ctx.interrupt()` returns the answer. To notify someone when a call starts waiting, give the backend an `onWait` function.

For setup, current limitations, and how replay works, refer to [Resume runs after a restart](/agents/tools/filesystem/#resume-runs-after-a-restart).

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.

Update to point to the docs.

Suggested change
For setup, current limitations, and how replay works, refer to [Resume runs after a restart](/agents/tools/filesystem/#resume-runs-after-a-restart).

loader: this.env.LOADER,
onInterrupt: "replay",
modules: {
"ws:github": {

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.

As the reader at this point I’m not sure in this context I grok immediately what a module is

@irvinebroque irvinebroque 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.

Is there a diagram or visualization you have that could help the reader understand the lifecycle and build a mental model?

@scuffi
scuffi force-pushed the changelog/computer-durable-javascript branch from c4905f9 to f48de93 Compare October 26, 2026 14:49
@scuffi
scuffi enabled auto-merge October 26, 2026 14:51
@scuffi
scuffi added this pull request to the merge queue Oct 26, 2026
Merged via the queue into production with commit a14e46e Oct 26, 2026
13 checks passed
@scuffi
scuffi deleted the changelog/computer-durable-javascript branch October 26, 2026 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:changelog size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants