tunnel_create
Store a short-lived secret in process memory and return an ID to retrieve it once. Use for passing one-time values like OTP codes between tools without disk persistence.
Instructions
[tunnel] Stash a one-shot or short-lived secret in the q-ring server's process memory and return an ID that can be used to read it back. Use for handing a one-time value to another tool/process without persisting it (npm OTP codes, magic-link tokens, copy/paste between machines via a relay); prefer set_secret with ttlSeconds when you actually want a tracked, auditable secret. Mutates only in-memory state — the value never touches disk and is lost on server restart. Subject to tool policy. Returns JSON { ok, data: { id } } where id is an opaque string to pass to tunnel_read/tunnel_destroy.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | The plaintext value to tunnel. Held only in process memory; never logged. | |
| maxReads | No | Self-destruct after this many successful `tunnel_read` calls. Use 1 for true one-shot delivery. | |
| ttlSeconds | No | Auto-destroy the tunnel after this many seconds. Omit for no time limit (then a `maxReads` is highly recommended). |