Skip to content

Add complete memory module#43

Merged
heimanba merged 2 commits into
mainfrom
codex/complete-memory-module
Jul 20, 2026
Merged

Add complete memory module#43
heimanba merged 2 commits into
mainfrom
codex/complete-memory-module

Conversation

@heimanba

@heimanba heimanba commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a provider-neutral Memory SDK surface for stores, entries, versions, pagination, optimistic concurrency, archive, and Ark batch creation
  • implement Memory adapters for Qoder, Claude, and Volcengine Ark, including provider-specific paths, pagination, beta headers, metadata semantics, and version response mapping
  • add declarative in-place reconciliation that preserves memories learned by running agents
  • expose Memory lifecycle commands in the CLI and document configuration, provider behavior, and examples
  • fix beta npm publishing so immutable snapshot versions use the stable beta dist-tag instead of beta-<sha>-<date>

Why

Memory stores were previously only partially represented as declarative resources. Users could attach stores to agents and deployments, but could not manage the complete Memory lifecycle consistently through the SDK and CLI.

Provider APIs also differ in path formats, version routes, pagination, metadata update semantics, and concurrency controls. Centralizing those differences behind a portable contract prevents provider-specific behavior from leaking into callers.

The beta release workflow computed the correct beta channel but did not pass it to the publish script. The script then inferred the npm dist-tag from the full snapshot suffix and produced tags such as beta-ddef91c-20260720.

Impact

Users can now create, inspect, update, archive, and delete Memory stores and entries through the SDK and CLI. Declarative updates reconcile configured seed entries in place while preserving runtime-learned memories.

Beta packages keep unique immutable versions such as 1.2.3-beta-ddef91c-20260720, while npm consistently publishes them under the beta dist-tag.

Validation

  • bun test packages/sdk/tests — 594 tests passed
  • release regression tests — 16 tests passed
  • bun run verify:scoped
  • pre-push bun scripts/verify.ts push — full workspace typecheck, architecture checks, tests, and changed-file lint passed
  • live lifecycle probe script included for Qoder, Claude, and Ark

heimanba added 2 commits July 21, 2026 00:22
Change-Id: Iea5dbdcf29c9ac1dd1b8d55f824f9e96e82cfb8d
Change-Id: I5e3e201d94cdbe7a239f23a7dbd4d8fd89726b80
@heimanba
heimanba marked this pull request as ready for review July 20, 2026 16:33
@heimanba
heimanba merged commit 24e5370 into main Jul 20, 2026
13 of 23 checks passed
@heimanba
heimanba deleted the codex/complete-memory-module branch July 20, 2026 16:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant