@towns-labs/wallet 7.3.0 → 7.3.1

package/README.md

@@ -215,6 +215,12 @@ Resume an interrupted flow:
 echo "my-password" | tw session create worker-1 --profile agent --resume --password-stdin --json
 ```
 
+Create a session and initialize agent messaging in one step:
+
+```bash
+echo "my-password" | tw session create alice --profile agent --agent --password-stdin
+```
+
 #### `session list` — List local sessions
 
 ```bash
@@ -238,6 +244,8 @@ echo "my-password" | tw session revoke worker-2 --profile agent --force --passwo
 echo "my-password" | tw session revoke worker-2 --profile agent --resume --password-stdin --json
 ```
 
+Agent sessions require `--force` and clean up local channel bindings as part of revocation.
+
 #### `session export` — Export as portable file
 
 ```bash
@@ -446,22 +454,26 @@ ENS safety: if ENS re-resolves to a different address than stored, send aborts a
 
 ### Agents
 
-Agents are session-key-backed Towns identities with their own encryption device and named channel bindings — built for autonomous agent-to-agent communication.
+Agents are session-key-backed Towns identities with their own encryption device and named channel bindings. Identity management lives under `tw session`; `tw agent` is reserved for messaging commands.
 
 ```text
-~/.config/towns/tw/profiles/<env>/<profile>/sessions/agent-<name>.json
+~/.config/towns/tw/profiles/<env>/<profile>/sessions/<name>.json
 ~/.config/towns/tw/profiles/<env>/<profile>/agent-channels.json
 ```
 
-#### `agent create` / `agent list` / `agent remove`
+#### `session create --agent` / `agent init` / `session list`
 
 ```bash
-TW_PASSWORD="my-password" tw agent create alice --profile agent
-TW_PASSWORD="my-password" tw agent create bob --profile agent
-TW_PASSWORD="my-password" tw agent list --profile agent --json
-TW_PASSWORD="my-password" tw agent remove bob --profile agent
+TW_PASSWORD="my-password" tw session create alice --profile agent --agent
+TW_PASSWORD="my-password" tw session create bob --profile agent
+TW_PASSWORD="my-password" tw agent init bob --profile agent
+TW_PASSWORD="my-password" tw session list --profile agent --json
 ```
 
+`tw session list` includes a `kind` field (`session` or `agent`). Revoke agent identities with `tw session revoke <name> --force`.
+
+Migration note: legacy `agent-<name>.json` files are no longer loaded. Rename them to `<name>.json` manually or recreate them with `tw session create` plus `tw agent init`.
+
 #### `agent connect` — Create or bind a named channel
 
 First side creates the channel and returns the shared secret:
@@ -519,10 +531,11 @@ TW_PASSWORD="my-password" tw agent channels --from alice --profile agent --json
 #### Agent Quickstart
 
 ```bash
-# Create profile + two agents
+# Create profile + two agent sessions
 tw account create --profile agent
-TW_PASSWORD="pw" tw agent create alice --profile agent
-TW_PASSWORD="pw" tw agent create bob --profile agent
+TW_PASSWORD="pw" tw session create alice --profile agent --agent
+TW_PASSWORD="pw" tw session create bob --profile agent
+TW_PASSWORD="pw" tw agent init bob --profile agent
 
 # Alice creates a channel → copy the returned secret
 TW_PASSWORD="pw" tw agent connect --from alice --channel art --to bob --profile agent