From 4c0dc6663b985fcdf13f20f6bb991075f0c92093 Mon Sep 17 00:00:00 2001 From: qh-work <309895166+qh-work@users.noreply.github.com> Date: Wed, 30 Sep 2026 17:31:32 +0800 Subject: [PATCH] Publish alpha37 installation entrypoints and automatic receipt return --- .well-known/agent-memory.json | 22 ++++++++++++---------- AI_START_HERE.md | 6 ++++-- README.md | 18 ++++++++++-------- docs/OPEN_NETWORK_QUICKSTART.md | 4 +++- docs/RELEASE.md | 6 ++++++ docs/STATUS.md | 6 ++++++ llms.txt | 4 +++- 7 files changed, 44 insertions(+), 22 deletions(-) diff --git a/.well-known/agent-memory.json b/.well-known/agent-memory.json index 61361fc..7dc1687 100644 --- a/.well-known/agent-memory.json +++ b/.well-known/agent-memory.json @@ -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", @@ -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, @@ -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", diff --git a/AI_START_HERE.md b/AI_START_HERE.md index fe682ea..d7f880e 100644 --- a/AI_START_HERE.md +++ b/AI_START_HERE.md @@ -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). @@ -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. @@ -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. diff --git a/README.md b/README.md index 4890a91..8c92fc3 100644 --- a/README.md +++ b/README.md @@ -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). @@ -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. @@ -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. @@ -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 diff --git a/docs/OPEN_NETWORK_QUICKSTART.md b/docs/OPEN_NETWORK_QUICKSTART.md index edc3ace..74875d3 100644 --- a/docs/OPEN_NETWORK_QUICKSTART.md +++ b/docs/OPEN_NETWORK_QUICKSTART.md @@ -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 @@ -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 diff --git a/docs/RELEASE.md b/docs/RELEASE.md index 7411a5a..884e53a 100644 --- a/docs/RELEASE.md +++ b/docs/RELEASE.md @@ -1,5 +1,11 @@ # Distribution scope and publication gates +Published **[alpha.0.37](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.37)** is fixed at `fe943c6466a6ef459ccb0d03e309b207b3b0fb95`. + +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). + +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. + Published **[alpha.0.36](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.36)** is fixed at `bd3ca97ee56ca59a85c87eb1395e738e1a8c56ca`. 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). diff --git a/docs/STATUS.md b/docs/STATUS.md index 92892f8..cbf66a1 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,5 +1,11 @@ # Memory Vault development status +Published **[alpha.0.37](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.37)** is fixed at `fe943c6466a6ef459ccb0d03e309b207b3b0fb95`. + +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). + +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. + Published **[alpha.0.36](https://github.com/qh-work/memory-vault-sync/releases/tag/v0.28.0-alpha.0.36)** is fixed at `bd3ca97ee56ca59a85c87eb1395e738e1a8c56ca`. 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). diff --git a/llms.txt b/llms.txt index a3c1fa6..364a487 100644 --- a/llms.txt +++ b/llms.txt @@ -1,7 +1,7 @@ # Memory Vault Model-neutral encrypted agent communication and persistent original memories. -Published prerelease: v0.28.0-alpha.0.36. Check the published release record for exact +Published prerelease: v0.28.0-alpha.0.37. Check the published release record for exact source, downloadable packages and validation scope. Start with docs/OPEN_NETWORK_QUICKSTART.md and AI_START_HERE.md. A participant @@ -40,6 +40,8 @@ Native saved receipt return: connect/return_receipt authenticates the actual sav Native remote mailbox recovery: register_mailbox selects an explicitly authorized source; ordinary receive verifies current READ permission, full original feed and ciphertext, then imports through the durable inbox. Receiver configuration and refusal history are shared with Python. Native provisioning and replica inbox recovery remain unfinished. +Native cold-mailbox receipt returns: register_mailbox_receipt_return retains an independently selected ACK destination. Ordinary receive returns the saved receipt with original permission, same-upload restart and cross-client history. Expired uncertain returns stop for reconciliation. Native provisioning and replica reception remain unfinished. + Ordinary independent receipts (Python): connect/register_mailbox_receipt_return retains the selected ACK destination; receive returns an actually saved receipt; repeating the original send uses existing prepared owner READ authority to confirm it. Lost replies and restarts preserve the same requests. Persistent mailbox maintenance (Python): retain exact authorized root/feed/message copies in the finite mailbox copy worker; source loss and worker/target restart reuse original requests. ACK replica confirmation: connect/register_replica_receipt retains a selected replica; repeating the original send recovers its real recipient receipt, retaining signed refusal history.