[wrangler] Add agent_memory binding support and namespace commands by petebacondarwin · Pull Request #13610 · cloudflare/workers-sdk

petebacondarwin · 2026-04-20T15:45:13Z

Adds support for Cloudflare's Agent Memory service in Wrangler and Miniflare.

Binding

{
  "agent_memory": [
    { "binding": "MY_MEMORY", "namespace": "my-namespace" }
  ]
}

Remote-only — wrangler dev proxies to the live API via a new Miniflare plugin. wrangler deploy provisions missing namespaces automatically. wrangler types emits typed AgentMemoryNamespace bindings (runtime type from cloudflare/workerd#6628).

Commands (private beta)

wrangler agent-memory namespace create <namespace>
wrangler agent-memory namespace list   [--json]
wrangler agent-memory namespace get    <namespace_name> [--json]
wrangler agent-memory namespace delete <namespace_name> [--force]

Adds the agent-memory:write OAuth scope to default login scopes.

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s): feat: agent memory docs cloudflare-docs#30121
- Documentation not necessary because:

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-04-20T15:45:25Z

🦋 Changeset detected

Latest commit: dd0ec30

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
miniflare	Minor
wrangler	Minor
@cloudflare/pages-shared	Patch
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-pool-workers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

ask-bonk · 2026-04-20T15:45:46Z

UnknownError: ProviderInitError

github run

ask-bonk · 2026-04-20T15:45:48Z

@petebacondarwin Bonk workflow failed. Check the logs for details.

View workflow run · To retry, trigger Bonk again.

pkg-pr-new · 2026-04-20T15:50:26Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@13610

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@13610

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@13610

miniflare

npm i https://pkg.pr.new/miniflare@13610

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@13610

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@13610

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@13610

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@13610

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@13610

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@13610

wrangler

npm i https://pkg.pr.new/wrangler@13610

commit: dd0ec30

workers-devprod · 2026-04-20T17:08:07Z

Codeowners approval required for this PR:

@cloudflare/wrangler

Show detailed file reviewers

packages/miniflare/src/plugins/agent-memory/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/plugins/index.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/config.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/environment.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/validation.ts: [@cloudflare/wrangler]
packages/workers-utils/src/map-worker-metadata-bindings.ts: [@cloudflare/wrangler]
packages/workers-utils/src/types.ts: [@cloudflare/wrangler]
packages/workers-utils/src/worker.ts: [@cloudflare/wrangler]
packages/workers-utils/tests/config/validation/normalize-and-validate-config.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/agent-memory.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/miniflare-remote-resources.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/workers/agent-memory.js: [@cloudflare/wrangler]
packages/wrangler/src/tests/agent-memory.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/create-worker-upload-form/bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/deploy/bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/index.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/print-bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/provision.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/type-generation.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/whoami.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/client.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/create.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/delete.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/get.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/list.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/provisioning.ts: [@cloudflare/wrangler]
packages/wrangler/src/api/startDevWorker/utils.ts: [@cloudflare/wrangler]
packages/wrangler/src/core/teams.d.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/check-remote-secrets-override.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/config-diffs.ts: [@cloudflare/wrangler]
packages/wrangler/src/deployment-bundle/bindings.ts: [@cloudflare/wrangler]
packages/wrangler/src/deployment-bundle/create-worker-upload-form.ts: [@cloudflare/wrangler]
packages/wrangler/src/dev/miniflare/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/type-generation/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/user/user.ts: [@cloudflare/wrangler]
packages/wrangler/src/utils/print-bindings.ts: [@cloudflare/wrangler]
tools/e2e/common.ts: [@cloudflare/wrangler]
tools/e2e/e2eCleanup.ts: [@cloudflare/wrangler]

devin-ai-integration

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 4 additional findings.

penalosa

Initial pass. My main concern at this stage is the agentmemory/agent_memory/agent_memory_namespace naming confusion

oliy · 2026-04-21T17:16:52Z

Looks this doesn't include the new OAuth permissions.

oliy · 2026-04-21T17:17:36Z

Not completely sure how "remote" bindings are implemented, but they don't seem to work.

oliy · 2026-04-21T17:33:49Z

As for naming, you make good points on the consistency. Since we are not constrained by agent week deadlines, we are going to make changes to center on using "agent-memory" in the naming. (and "agent_memory", as necessary).
Unfortunately, this means numerous changes in other systems (EWC, API Gateway, etc.)

github-actions · 2026-04-22T20:30:08Z

✅ All changesets look good

petebacondarwin · 2026-04-24T13:37:27Z

Marking as draft while @oliy works through some backend updates (e.g. around the agentmemory/agent-memory/agent_memory naming etc)

workers-devprod · 2026-04-30T09:11:23Z

Codeowners approval required for this PR:

@cloudflare/wrangler

Show detailed file reviewers

.changeset/agent-memory-binding-support.md: [@cloudflare/wrangler]
.changeset/agent-memory-namespace-commands.md: [@cloudflare/wrangler]
packages/miniflare/src/plugins/agent-memory/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/plugins/index.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/config.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/environment.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/validation.ts: [@cloudflare/wrangler]
packages/workers-utils/src/map-worker-metadata-bindings.ts: [@cloudflare/wrangler]
packages/workers-utils/src/types.ts: [@cloudflare/wrangler]
packages/workers-utils/src/worker.ts: [@cloudflare/wrangler]
packages/workers-utils/tests/config/validation/normalize-and-validate-config.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/agent-memory.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/miniflare-remote-resources.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/workers/agent-memory.js: [@cloudflare/wrangler]
packages/wrangler/src/tests/agent-memory.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/create-worker-upload-form/bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/deploy/bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/index.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/print-bindings.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/provision.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/type-generation.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/whoami.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/client.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/create.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/delete.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/get.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/list.ts: [@cloudflare/wrangler]
packages/wrangler/src/agent-memory/provisioning.ts: [@cloudflare/wrangler]
packages/wrangler/src/api/startDevWorker/utils.ts: [@cloudflare/wrangler]
packages/wrangler/src/core/teams.d.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/check-remote-secrets-override.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/config-diffs.ts: [@cloudflare/wrangler]
packages/wrangler/src/deployment-bundle/bindings.ts: [@cloudflare/wrangler]
packages/wrangler/src/deployment-bundle/create-worker-upload-form.ts: [@cloudflare/wrangler]
packages/wrangler/src/dev/miniflare/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/type-generation/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/user/user.ts: [@cloudflare/wrangler]
packages/wrangler/src/utils/print-bindings.ts: [@cloudflare/wrangler]
tools/e2e/common.ts: [@cloudflare/wrangler]
tools/e2e/e2eCleanup.ts: [@cloudflare/wrangler]

devin-ai-integration

Devin Review found 1 new potential issue.

🐛 1 issue in files not directly in the diff

🐛 Missing `agent_memory` in `pickRemoteBindings` causes binding to be silently dropped during `wrangler dev` (`packages/wrangler/src/api/remoteBindings/index.ts:42-48`)

agent_memory is an always-remote binding (confirmed by the changeset description, the miniflare plugin calling warnOrError("agent_memory", memory.remote, "always-remote") at packages/wrangler/src/dev/miniflare/index.ts:637, and by the miniflare plugin only implementing remote proxy). However, the pickRemoteBindings function at packages/wrangler/src/api/remoteBindings/index.ts:18-52 does not include agent_memory in its list of always-remote types. Every other always-remote binding (ai, media, artifacts, vpc_service, vpc_network, ai_search_namespace, ai_search) is explicitly listed. Without this, an agent_memory binding will only be picked for the remote proxy session if the user explicitly sets remote: true in their config. Since remote is optional (remote?: boolean in packages/workers-utils/src/config/environment.ts:1069), most users won't set it, causing the binding to silently not work during local development.

View 19 additional findings in Devin Review.

Wrap startRemoteProxySession() in retry() to handle transient Cloudflare API 5xx (most commonly edge-preview returning 500), which has been blocking shard 3 of this PR consistently for 2+ days. Test-only change; no runtime behaviour modified. Refs: #13831

Boot the remote proxy session in beforeAll with only the first test case's bindings, then call updateBindings inside each `it` to install that test case's bindings. Previously every test case's bindings were merged into a single startRemoteProxySession call, causing the boot to time out as the suite grew. The new flow makes the boot smaller and attributes any per-binding boot failure to the test that owns that binding rather than to an opaque beforeAll timeout. Also drop the retry wrapper around startRemoteProxySession in both the main and mTLS describe blocks.

The agent-memory worker binding API uses `getProfile()` (not `getContext()`), and the result's text field is `profile` (not `context`). Update the test worker and assertion to match.

- Update unit test to import runInTempDir from @cloudflare/workers-utils/test-helpers (the helper was moved out of packages/wrangler/src/__tests__/helpers/ in main). - Drop the open-beta status warning expectation from the two e2e tests that run with --json. PR #13837 made the status warning honor the printBanner result, so commands with printBanner: (args) => !args.json now suppress the warning in JSON mode.

Adds minimal type declarations for the AgentMemoryNamespace binding so user-facing `wrangler types` output in workers-sdk can reference them. The real runtime API surface is owned by the Agent Memory team and is expected to extend this scaffold. Related: cloudflare/workers-sdk#13610

* Add AgentMemoryNamespace types scaffold Adds minimal type declarations for the AgentMemoryNamespace binding so user-facing `wrangler types` output in workers-sdk can reference them. The real runtime API surface is owned by the Agent Memory team and is expected to extend this scaffold. Related: cloudflare/workers-sdk#13610 * Added real type files for Agent Memory API (#6783) * fix types * fix type snapshots --------- Co-authored-by: Oliver Yu <387030+oliy@users.noreply.github.com> Co-authored-by: Samuel Macleod <smacleod@cloudflare.com>

workers-devprod · 2026-05-28T15:51:54Z

Codeowners approval required for this PR:

✅ @cloudflare/wrangler

Show detailed file reviewers

stale

- Add INHERIT_SYMBOL print-bindings test for agent_memory. - Make the delete confirmation copy consistent with the rest of the agent_memory namespace user-facing copy ('OK to delete the Agent Memory namespace "…"?'). Updated unit tests to match. - Clarify the load() comment on the agent_memory provisioning handler: load() only feeds the interactive 'Connect an existing X?' picker, which is unreachable here because namespace is required in config. isConnectedToExistingResource() (GET /namespaces/:name) is what actually prevents re-creating an existing namespace. - Rewrite the getAgentMemoryNamespace docstring and drop a misleading copy-pasted inline comment. - Lowercase the create-failure telemetry message to match the repo convention.

workers-devprod

Codeowners reviews satisfied

penalosa · 2026-05-28T17:46:05Z

This can go in once cloudflare/workerd#6628 is released (tonight)

workers-devprod added this to workers-sdk Apr 20, 2026

github-project-automation Bot moved this to Untriaged in workers-sdk Apr 20, 2026

petebacondarwin marked this pull request as ready for review April 20, 2026 17:07

petebacondarwin requested a review from workers-devprod as a code owner April 20, 2026 17:07

workers-devprod requested review from a team and ascorbic and removed request for a team April 20, 2026 17:08

devin-ai-integration Bot reviewed Apr 20, 2026

View reviewed changes

penalosa previously requested changes Apr 20, 2026

View reviewed changes

github-project-automation Bot moved this from Untriaged to In Review in workers-sdk Apr 20, 2026

petebacondarwin mentioned this pull request Apr 21, 2026

Add AgentMemoryNamespace types scaffold cloudflare/workerd#6628

Merged

petebacondarwin force-pushed the pbd/agent-memory branch from 79346fe to 230fe18 Compare April 22, 2026 20:29

petebacondarwin marked this pull request as draft April 24, 2026 13:37

petebacondarwin force-pushed the pbd/agent-memory branch from 6ffd5a4 to 181d5f5 Compare April 25, 2026 06:28

petebacondarwin marked this pull request as ready for review April 30, 2026 09:10

This comment was marked as resolved.

Sign in to view

oliy force-pushed the pbd/agent-memory branch 2 times, most recently from 779c979 to dd9bf72 Compare May 4, 2026 16:11

devin-ai-integration Bot reviewed May 4, 2026

View reviewed changes

petebacondarwin added 7 commits May 22, 2026 12:31

fix e2e test colon mismatch in agent-memory create output

f0fb5bc

expect open-beta warning in agent-memory e2e test stderr

1f0f210

fix up e2e test and cleanup logic

d9159dc

test: fix agent-memory e2e to match runtime binding API

30aba27

The agent-memory worker binding API uses `getProfile()` (not `getContext()`), and the result's text field is `profile` (not `context`). Update the test worker and assertion to match.

petebacondarwin force-pushed the pbd/agent-memory branch from 91d2b28 to 33d40b8 Compare May 22, 2026 11:35

This comment was marked as resolved.

Sign in to view

petebacondarwin force-pushed the pbd/agent-memory branch 2 times, most recently from 5308f7a to a0db0f6 Compare May 22, 2026 12:04

Switch commands from 'open beta' to 'private beta'

19d4cf6

petebacondarwin force-pushed the pbd/agent-memory branch from a0db0f6 to 19d4cf6 Compare May 22, 2026 12:05

petebacondarwin added the product:agent-memory Relating to Cloudflare Agent Memory: https://developers.cloudflare.com/agent-memory/ label May 22, 2026

Merge remote-tracking branch 'origin/main' into pbd/agent-memory

907eb41

penalosa added 2 commits May 28, 2026 17:03

fixup after merge

1061073

penalosa approved these changes May 28, 2026

View reviewed changes

workers-devprod approved these changes May 28, 2026

View reviewed changes

github-project-automation Bot moved this from In Review to Approved in workers-sdk May 28, 2026

Merge branch 'main' into pbd/agent-memory

dd0ec30

penalosa merged commit cbb39bd into main May 29, 2026
53 checks passed

penalosa deleted the pbd/agent-memory branch May 29, 2026 11:00

github-project-automation Bot moved this from Approved to Done in workers-sdk May 29, 2026

workers-devprod mentioned this pull request May 29, 2026

Version Packages #14082

Merged

Uh oh!

Conversation

petebacondarwin commented Apr 20, 2026 • edited by penalosa Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Binding

Commands (private beta)

Uh oh!

changeset-bot Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

ask-bonk Bot commented Apr 20, 2026

Uh oh!

ask-bonk Bot commented Apr 20, 2026

Uh oh!

pkg-pr-new Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

workers-devprod commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

✅ Devin Review: No Issues Found

Uh oh!

penalosa left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

oliy commented Apr 21, 2026

Uh oh!

oliy commented Apr 21, 2026

Uh oh!

oliy commented Apr 21, 2026

Uh oh!

github-actions Bot commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

petebacondarwin commented Apr 24, 2026

Uh oh!

workers-devprod commented Apr 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

🐛 Missing agent_memory in pickRemoteBindings causes binding to be silently dropped during wrangler dev (packages/wrangler/src/api/remoteBindings/index.ts:42-48)

Uh oh!

This comment was marked as resolved.

Uh oh!

workers-devprod commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

workers-devprod left a comment

Choose a reason for hiding this comment

Uh oh!

penalosa commented May 28, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

petebacondarwin commented Apr 20, 2026 •

edited by penalosa

Loading

changeset-bot Bot commented Apr 20, 2026 •

edited

Loading

pkg-pr-new Bot commented Apr 20, 2026 •

edited

Loading

workers-devprod commented Apr 20, 2026 •

edited

Loading

github-actions Bot commented Apr 22, 2026 •

edited

Loading

workers-devprod commented Apr 30, 2026 •

edited

Loading

🐛 Missing `agent_memory` in `pickRemoteBindings` causes binding to be silently dropped during `wrangler dev` (`packages/wrangler/src/api/remoteBindings/index.ts:42-48`)

workers-devprod commented May 28, 2026 •

edited

Loading