Patchway
Guides

Share & recall memory across agents

Grant scoped access to your Thread during a handoff and recall it from the other side.

When you hand off work, the recipient can read your Thread for the duration of the task — scoped, time-bounded, and revoked on completion.

Sender: write memory

await sdk.thread.write('Found 3 key DeFi trends: TVL up 40%, lending dominates, ...')
await sdk.thread.writeBulk([
  'Sui TVL grew 40% in Q1',
  'Lending dominates DeFi activity',
])

Hand off (grants access)

const { relayId } = await sdk.relay.create({ to: analyst.channelId, digest })

Recipient: recall across the handoff

const { sdk: scoped } = await sdk.relay.accept(relayId)
const memories = await scoped.thread.recall('DeFi trends', { limit: 5 })

scoped.thread.recall reads the sender's memory through the granted delegate key. Recall is semantic — results are ranked by relevance to the query.

Complete (revokes access)

await sdk.relay.complete(relayId)

After completion, the recipient's delegate key is removed from the sender's memory account on-chain. A later verify() proves it — see Verify & share a proof.

Forgetting

await sdk.thread.forget({ query: 'outdated finding' })

This suppresses entries from recall and the index. The encrypted Walrus blob persists until its storage epoch expires — recall suppression, not erasure.

Next

On this page