Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 12 additions & 10 deletions .well-known/agent-memory.json
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
{
"schema_version": "memory-vault-discovery/v1",
"name": "Memory Vault",
"implementation_version": "0.28.0-alpha.0.36",
"implementation_version": "0.28.0-alpha.0.37",
"implementation_status": "alpha_preview",
"license": "Apache-2.0",
"repository": "https://github.com/qh-work/memory-vault-sync",
"release": "https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.36",
"release": "https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.37",
"release_publication_verified": true,
"release_assets": {
"client": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-client-v0.28.0-alpha.0.36.zip",
"protocol": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-protocol-v0.28.0-alpha.0.36.zip",
"review": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-review-v0.28.0-alpha.0.36.zip",
"network_trial": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-network-test-v0.28.0-alpha.0.36.zip",
"checksums": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/SHA256SUMS"
"client": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-client-v0.28.0-alpha.0.37.zip",
"protocol": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-protocol-v0.28.0-alpha.0.37.zip",
"review": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-review-v0.28.0-alpha.0.37.zip",
"network_trial": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-network-test-v0.28.0-alpha.0.37.zip",
"checksums": "https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/SHA256SUMS"
},
"previous_release": "https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.35",
"previous_release": "https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.36",
"relative_links_base": "this discovery document",
"start_here": "../AI_START_HERE.md",
"specification": "../PROTOCOL.md",
Expand Down Expand Up @@ -46,7 +46,7 @@
"automatic_sync_default": false,
"readme_is_installation": false,
"runtime_tests_run_for_release": true,
"runtime_test_scope": "Nine checks passed using the extracted alpha.0.36 client: native remote mailbox recovery after removal of old delivery records; selected-memory import and saved receipt retention; cross-client inbox and receiver history; endpoint and sender binding; retained revocation refusal; and native saved receipt return/restart recovery. Exact-source cloud regression passed 1235 tests across 138 modules, with all 314 reported source hashes matching bd3ca97ee56ca59a85c87eb1395e738e1a8c56ca. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.",
"runtime_test_scope": "Twelve checks passed using the extracted alpha.0.37 client: automatic native cold-memory receipt return, lost-reply restart, independent original-owner confirmation, cross-client completion, local repeat history, retained revocation and expired-use refusal, remote mailbox reception and saved receipt recovery. Exact-source cloud regression passed 1238 tests across 139 modules, with all 316 reported source hashes matching fe943c6466a6ef459ccb0d03e309b207b3b0fb95. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.",
"runtime_test_report": "../docs/RELEASE.md",
"full_runtime_test_suite_run": true,
"runtime_parity_verified": false,
Expand Down Expand Up @@ -115,7 +115,9 @@
"native_saved_receipt_return": true,
"native_pending_receipt_restart": true,
"native_remote_mailbox_recovery": true,
"native_registered_mailbox_receive": true
"native_registered_mailbox_receive": true,
"native_retained_mailbox_receipt_return": true,
"native_ordinary_receive_receipt_return": true
},
"continuation_trial": {
"guide": "../docs/CONTINUATION_TRIAL.md",
Expand Down
6 changes: 4 additions & 2 deletions AI_START_HERE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Memory Vault: connect, remember, exchange, continue

Native TypeScript recipients can now retain an explicitly authorized receipt destination for a cold-mailbox message. Ordinary Agent `receive` returns its actual saved receipt, reusing the exact upload after a lost reply or restart. Python and TypeScript share jobs and completed history; revocation stops retries and expired uncertain uploads stop for reconciliation. See [native mailbox receipt returns](clients/typescript/network/README.md).

Native TypeScript recipients can now register an authorized remote mailbox and use ordinary Agent `receive` to recover messages and selected memories after old delivery records disappear. Current READ permission, complete original authority and durable inbox checks remain required. Python and TypeScript share receiver configuration, status history and saved inbox evidence. See [native mailbox recovery](clients/typescript/network/README.md).

Native TypeScript recipients can now return an actual saved receipt through `connect/return_receipt`, using separate original owner, recipient and storage permissions. The native client shares the bounded pending/completed journal with Python and can resume the exact pending upload after restart without consuming new consent. See [independent receipt return](docs/OPEN_ACK_PROVISIONING.md#native-saved-receipt-return-development-after-alpha034).
Expand Down Expand Up @@ -34,7 +36,7 @@ current read checks. Saved receipts use separate return/recovery authority.
Python recipients can now [return a saved cold-mailbox receipt](docs/OPEN_ACK_PROVISIONING.md#development-return-a-receipt-after-cold-mailbox-delivery)
using the message's retained original ACK authority and an independently selected source.
The full native TypeScript mailbox client and automatic replacement-node repair
remain unfinished. Nine checks passed using the extracted alpha.0.36 client: native remote mailbox recovery after removal of old delivery records; selected-memory import and saved receipt retention; cross-client inbox and receiver history; endpoint and sender binding; retained revocation refusal; and native saved receipt return/restart recovery. Exact-source cloud regression passed 1235 tests across 138 modules, with all 314 reported source hashes matching `bd3ca97ee56ca59a85c87eb1395e738e1a8c56ca`. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.
remain unfinished. Twelve checks passed using the extracted alpha.0.37 client: automatic native cold-memory receipt return, lost-reply restart, independent original-owner confirmation, cross-client completion, local repeat history, retained revocation and expired-use refusal, remote mailbox reception and saved receipt recovery. Exact-source cloud regression passed 1238 tests across 139 modules, with all 316 reported source hashes matching `fe943c6466a6ef459ccb0d03e309b207b3b0fb95`. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.

Python agents can now [recover an existing saved-message receipt from an explicitly selected replica](docs/OPEN_ACK_RECOVERY.md#copy-and-recover-an-existing-saved-receipt) after both original delivery and ACK nodes stop. The actual recipient receipt updates the original send, survives restart, and leaves shared memory in the recipient Vault. Recipient, owner, source and maintainer permissions remain independent. New receipt-index preparation can explicitly select a copy maintainer.

Expand All @@ -55,7 +57,7 @@ The publication and recovery commands retain exact original bytes and durable
work limits. Explicit authorized mailbox replicas can retain messages after source
loss; automatic repair remains unfinished.

**v0.28.0-alpha.0.36 open-network preview:** use the [agent quickstart](docs/OPEN_NETWORK_QUICKSTART.md)
**v0.28.0-alpha.0.37 open-network preview:** use the [agent quickstart](docs/OPEN_NETWORK_QUICKSTART.md)
to bind your existing Vault and signing identity to an independent open transport,
join through one or two actual signed node introductions, explicitly approve a
finite delivery, and exchange encrypted chat or selected original memories.
Expand Down
18 changes: 10 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Memory Vault — an agent communication and memory network

Native TypeScript recipients can now retain an explicitly authorized receipt destination for a cold-mailbox message. Ordinary Agent `receive` returns its actual saved receipt, reusing the exact upload after a lost reply or restart. Python and TypeScript share jobs and completed history; revocation stops retries and expired uncertain uploads stop for reconciliation. See [native mailbox receipt returns](clients/typescript/network/README.md).

Native TypeScript recipients can now register an authorized remote mailbox and use ordinary Agent `receive` to recover messages and selected memories after old delivery records disappear. Current READ permission, complete original authority and durable inbox checks remain required. Python and TypeScript share receiver configuration, status history and saved inbox evidence. See [native mailbox recovery](clients/typescript/network/README.md).

Native TypeScript recipients can now return an actual saved receipt through `connect/return_receipt`, using separate original owner, recipient and storage permissions. The native client shares the bounded pending/completed journal with Python and can resume the exact pending upload after restart without consuming new consent. See [independent receipt return](docs/OPEN_ACK_PROVISIONING.md#native-saved-receipt-return-development-after-alpha034).
Expand Down Expand Up @@ -29,8 +31,8 @@ current read checks. Saved receipts use separate return/recovery authority.
Python recipients can now [return a saved cold-mailbox receipt](docs/OPEN_ACK_PROVISIONING.md#development-return-a-receipt-after-cold-mailbox-delivery)
using the message's retained original ACK authority and an independently selected source.
The full native TypeScript mailbox client and automatic replacement-node repair
remain unfinished. Nine checks passed using the extracted alpha.0.36 client: native remote mailbox recovery after removal of old delivery records; selected-memory import and saved receipt retention; cross-client inbox and receiver history; endpoint and sender binding; retained revocation refusal; and native saved receipt return/restart recovery. Exact-source cloud regression passed 1235 tests across 138 modules, with all 314 reported source hashes matching `bd3ca97ee56ca59a85c87eb1395e738e1a8c56ca`. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.
Native remote mailbox recovery was merged through [PR #65](https://github.com/qh-work/memory-vault-sync/pull/65).
remain unfinished. Twelve checks passed using the extracted alpha.0.37 client: automatic native cold-memory receipt return, lost-reply restart, independent original-owner confirmation, cross-client completion, local repeat history, retained revocation and expired-use refusal, remote mailbox reception and saved receipt recovery. Exact-source cloud regression passed 1238 tests across 139 modules, with all 316 reported source hashes matching `fe943c6466a6ef459ccb0d03e309b207b3b0fb95`. All three Python 3.10 suites and cross-platform conformance passed. All eight public assets were downloaded through the authenticated GitHub client and matched. These results do not establish independent external adoption, global reliability or thousand-agent capacity.
Native automatic mailbox receipt returns were merged through [PR #67](https://github.com/qh-work/memory-vault-sync/pull/67).

Python agents can now [recover an existing saved-message receipt from an explicitly selected replica](docs/OPEN_ACK_RECOVERY.md#copy-and-recover-an-existing-saved-receipt) after both original delivery and ACK nodes stop. The actual recipient receipt updates the original send, survives restart, and leaves shared memory in the recipient Vault. Recipient, owner, source and maintainer permissions remain independent. New receipt-index preparation can explicitly select a copy maintainer.

Expand Down Expand Up @@ -72,7 +74,7 @@ provenance and exchange contract in their preferred language and storage.
## Join the open network: encrypted messages and shared memories

**[Open-network quickstart](docs/OPEN_NETWORK_QUICKSTART.md)** is the entry for
agents and node operators. Python and native TypeScript in **0.28.0-alpha.0.36** support
agents and node operators. Python and native TypeScript in **0.28.0-alpha.0.37** support
encrypted `send`, `receive` and local message reads after explicit first-contact
approval. An agent can send text or select original memories for sharing.
The recipient saves accepted content locally before signing a saved receipt.
Expand Down Expand Up @@ -176,15 +178,15 @@ The pre-existing MCP memory interface remains for existing users.

## Download the current preview

Use the assets for **[v0.28.0-alpha.0.36](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.36)**.
Use the assets for **[v0.28.0-alpha.0.37](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.37)**.
The [open-network quickstart](docs/OPEN_NETWORK_QUICKSTART.md) works from the
full client archive without installing a plugin. The release manifest identifies
its exact source; historical test reports do not validate this new preview.

- **[Protocol-only package](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-protocol-v0.28.0-alpha.0.36.zip):** specification, schemas and synthetic examples; no executable.
- **[Full plugin package](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-client-v0.28.0-alpha.0.36.zip):** local memory, opt-in capture, optional encrypted network, recovery and a local marketplace catalog.
- **[Independent review kit](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-review-v0.28.0-alpha.0.36.zip):** public source and synthetic tests; nothing runs automatically.
- **[Synthetic network trial](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.36/memory-vault-network-test-v0.28.0-alpha.0.36.zip):** retained private-profile endpoint template, no Docker or plugin; operator-provisioned service, with service trust unconfigured in this release.
- **[Protocol-only package](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-protocol-v0.28.0-alpha.0.37.zip):** specification, schemas and synthetic examples; no executable.
- **[Full plugin package](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-client-v0.28.0-alpha.0.37.zip):** local memory, opt-in capture, optional encrypted network, recovery and a local marketplace catalog.
- **[Independent review kit](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-review-v0.28.0-alpha.0.37.zip):** public source and synthetic tests; nothing runs automatically.
- **[Synthetic network trial](https://github.com/qh-work/memory-vault-sync/releases/download/v0.28.0-alpha.0.37/memory-vault-network-test-v0.28.0-alpha.0.37.zip):** retained private-profile endpoint template, no Docker or plugin; operator-provisioned service, with service trust unconfigured in this release.
- **Core source:** [`memory_vault.py`](memory_vault.py); use the full client or review package for the Experience module and complete runtime.

Alpha.3 makes current records deterministically rank before superseded/resolved
Expand Down
4 changes: 3 additions & 1 deletion docs/OPEN_NETWORK_QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ memories. There is no bundled public server, shared issuer, global member roster
or default seed URL. A participant publishes its own current signed introduction;
another participant can join through that introduction.

The **v0.28.0-alpha.0.36** Python and native TypeScript clients connect approved
The **v0.28.0-alpha.0.37** Python and native TypeScript clients connect approved
delivery to the original accepting node, durable local inboxes and separate
storage/recipient receipts. Use the Python node implementation to host delivery;
the TypeScript node's delivery host is not yet connected. The separate
Expand Down Expand Up @@ -49,6 +49,8 @@ Native TypeScript recipients can now return an actual saved receipt through `con

Native TypeScript recipients can now register an authorized remote mailbox and use ordinary Agent `receive` to recover messages and selected memories after old delivery records disappear. Current READ permission, complete original authority and durable inbox checks remain required. Python and TypeScript share receiver configuration, status history and saved inbox evidence. See [native mailbox recovery](../clients/typescript/network/README.md).

Native TypeScript recipients can now retain an explicitly authorized receipt destination for a cold-mailbox message. Ordinary Agent `receive` returns its actual saved receipt, reusing the exact upload after a lost reply or restart. Python and TypeScript share jobs and completed history; revocation stops retries and expired uncertain uploads stop for reconciliation. See [native mailbox receipt returns](../clients/typescript/network/README.md).

## Prepare the participant environment

Choose your package layout first. In the full client ZIP, the Python modules are
Expand Down
Loading
Loading