SDK catalog / Memory
Memory
alpha 0.3.0-rc.3
Published preview for @wf/agent-memory@0.3.0-rc.3. Follow the registry guide and review compatibility before installing.
Join the alpha Sign in with Google, then add your name. We review alpha access requests.
{
"schemaVersion": 1,
"id": "agent-memory",
"package": "@wf/agent-memory",
"version": "0.3.0-rc.3",
"releaseState": "preview",
"exports": [
"./mcp",
".",
"./package.json",
"./cli",
"./tencent-provider"
],
"yamlSchemaVersions": [
1
],
"runtime": {
"node": ">=22.19",
"filesystem": "local persistent filesystem; no NFS, SMB or shared cloud folders"
},
"verifiedCombinations": [
{
"runtime": "Node.js 24.3.0",
"platform": "Windows x64",
"client": "@modelcontextprotocol/client 2.0.0",
"protocol": "2026-07-28",
"proof": "packed-artifact CLI discovery, domain operation, legacy rejection and recovery",
"verifiedOn": "2026-09-08",
"packageVersion": "0.3.0-alpha.1",
"package": "@workforce-sdk/agent-memory"
},
{
"os": "win32",
"architecture": "x64",
"node": "24.3.0",
"proof": "scripts/verify-memory-release.mjs; native filesystem, process kill, restore, isolation, current MCP",
"package": "@brightops/agent-memory",
"packageVersion": "0.3.0-rc.1"
},
{
"os": "darwin",
"architecture": "arm64",
"node": "22.22.2",
"proof": "scripts/verify-memory-release.mjs; native macOS filesystem, identical packed archives",
"package": "@brightops/agent-memory",
"packageVersion": "0.3.0-rc.1"
},
{
"os": "linux",
"architecture": "x64",
"node": "22.20.0",
"proof": "scripts/verify-memory-release.mjs; Ubuntu 22.04 WSL2 native Linux filesystem, identical packed archives",
"package": "@brightops/agent-memory",
"packageVersion": "0.3.0-rc.1"
},
{
"os": "win32",
"architecture": "x64",
"node": "24.3.0",
"proof": "scripts/verify-memory-release.mjs; native filesystem, process kill, restore, isolation, current MCP; installed Tencent 2.0.1, in-flight erasure and process-kill recovery",
"package": "@wf/agent-memory",
"packageVersion": "0.3.0-rc.2"
},
{
"os": "darwin",
"architecture": "arm64",
"node": "22.22.2",
"proof": "scripts/verify-memory-release.mjs; native macOS filesystem, identical packed archives; installed Tencent 2.0.1, in-flight erasure and process-kill recovery",
"package": "@wf/agent-memory",
"packageVersion": "0.3.0-rc.2"
},
{
"os": "linux",
"architecture": "x64",
"node": "22.20.0",
"proof": "scripts/verify-memory-release.mjs; Ubuntu 22.04 WSL2 native Linux filesystem, identical packed archives; installed Tencent 2.0.1, in-flight erasure and process-kill recovery",
"package": "@wf/agent-memory",
"packageVersion": "0.3.0-rc.2"
}
],
"support": {
"firstStableRelease": null,
"currentStableMajor": null,
"supersededMajors": [],
"deprecations": [],
"minimumSupersededMajorMonths": 12,
"minimumDeprecationMonths": 6,
"minimumLegacyMonthsAfterFirstStable": 12
},
"legacy": [
{
"name": "@brightops/agent-memory",
"versions": [
"0.2.0-alpha.1",
"0.2.1-alpha.3",
"0.2.1-alpha.4",
"0.2.1-alpha.5",
"0.3.0-alpha.1",
"0.3.0-rc.1"
]
}
],
"migrations": [
{
"id": "agent-memory-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.2.0-alpha.1"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md.",
"storage": "Preferences read schema 1 and write schema 2; projection checkpoints use schema 2. Stop writers, back up data, and rebuild legacy split projections from retained events; see RELIABILITY.md.",
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
]
},
{
"id": "agent-memory-0.3.0-alpha.2",
"from": {
"package": "@workforce-sdk/agent-memory",
"version": "0.3.0-alpha.1"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md.",
"storage": "Preferences read schema 1 and write schema 2; projection checkpoints use schema 2. Stop writers, back up data, and rebuild legacy split projections from retained events; see RELIABILITY.md.",
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
]
},
{
"id": "agent-memory-0.2.1-alpha.3-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.2.1-alpha.3"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md."
},
{
"id": "agent-memory-0.2.1-alpha.4-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.2.1-alpha.4"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md."
},
{
"id": "agent-memory-0.2.1-alpha.5-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.2.1-alpha.5"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md."
},
{
"id": "agent-memory-0.3.0-alpha.1-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.3.0-alpha.1"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md",
"yaml": "Supply a YAML configuration-file path; set preferences.tencent.enabled to false. Tencent cannot be enabled; inspect retained cleanup evidence and follow TENCENT-MIGRATION.md."
},
{
"id": "agent-memory-0.3.0-rc.1-to-wf",
"from": {
"package": "@brightops/agent-memory",
"version": "0.3.0-rc.1"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"yaml": "Keep schema 1 and pass its file path explicitly. Tencent remains unavailable.",
"storage": "Unchanged from the released rc.1 artifact; back up and stop all writers before changing package names.",
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place.",
"automation": "manual",
"guide": "RELIABILITY.md"
},
{
"id": "agent-memory-wf-scope",
"from": {
"package": "@workforce-sdk/agent-memory",
"version": "0.3.0-alpha.2"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-alpha.2"
},
"yaml": "Keep the YAML configuration file and host-owned secret references unchanged.",
"storage": "Package-name migration only; preserve all application data and model caches.",
"rollback": "Restore the previous exact package archives and dependency lockfile together; preserve application data.",
"automation": "manual",
"guide": "README.md"
},
{
"id": "managed-tencent-erasure-v1",
"from": {
"package": "@brightops/agent-memory",
"version": "0.3.0-rc.1"
},
"to": {
"package": "@wf/agent-memory",
"version": "0.3.0-rc.2"
},
"steps": [
"Update imports and dependencies to @wf/agent-memory. Move legacy engine settings into YAML; keep host identity, callbacks and transports as runtime inputs.",
"Keep authoritative local storage and its host-owned backups.",
"Prepare a separate Tencent 2.0.1 runtime and dataRoot with the installed provider CLI.",
"Bind authenticated users and enable the new endpoint in the SDK YAML.",
"Verify write, forget, restart and absence; retain cleanup status for older provider copies."
],
"rollback": "Stop the provider and restore the previous application configuration. Keep its dataRoot and completion receipts; do not overwrite them with an old backup.",
"automation": "manual",
"guide": "README.md"
},
{
"id": "memory-durability-v2",
"from": "@brightops/agent-memory 0.2.1-alpha.3 through 0.2.1-alpha.5",
"to": "@brightops/agent-memory 0.3.0-rc.1",
"steps": [
"Stop every writer sharing the memory root, including older harness bridges.",
"Back up the complete existing store under the host's encryption and retention policy.",
"Upgrade all writers together; preferences read schema 1 and write schema 2 on their next change.",
"Set preferences.tencent.enabled to false; inspect retained cloud cleanup evidence and follow TENCENT-MIGRATION.md for older uploads.",
"Rebuild legacy split projection state/cursor files from retained authoritative events.",
"Use MCP 2026-07-28 requests and verify a disposable write, process restart, and read."
],
"rollback": "Old SDKs cannot read new preference/checkpoint formats. Use a pre-upgrade backup and reconcile later writes before rollback; never downgrade in place."
}
],
"mcp": {
"current": "2026-07-28",
"supportedVersions": [
"2026-07-28"
],
"legacy": [],
"implementation": "@wf/core@0.3.0-alpha.4",
"transports": [
"stdio",
"http"
],
"requiredClientBehavior": "stateless-per-request-metadata",
"upgradeGuide": "MCP-UPGRADE.md",
"checker": "wf-mcp-check",
"breaking": true
},
"storage": {
"preferences": {
"read": [
1,
2
],
"write": 2
},
"events": {
"read": [
1
],
"write": 1
},
"projectionCheckpoints": {
"read": [
2
],
"write": 2
},
"backup": {
"read": [
1
],
"write": 1
}
}
}