ethagent 1.1.0 → 1.1.1

package/README.md

@@ -3,118 +3,59 @@
 
 A privacy-first AI agent with a portable Ethereum identity.
 
-ethagent is a terminal agent for coding and project work. It gives the agent a wallet-owned ERC-8004 identity, keeps private continuity encrypted, and publishes public capability metadata as structured JSON so other applications and agents can understand what it can do.
-
-The identity stays portable. The model can change. The private memory stays under wallet-gated encryption.
+ethagent binds an AI agent to a wallet-owned ERC-8004 token. Persona and memory stay encrypted under your wallet signature and pinned to IPFS. Public skills publish as machine-readable JSON so other agents can discover what it does. Swap models, switch machines, restore the same agent from one onchain pointer.
 
 ## Install
 
 ethagent requires Node.js 20 or newer. Install it from npm with `npm install -g ethagent`, then start it with `ethagent`.
 
-On first run, ethagent guides you through model setup and identity setup. You can use a local GGUF model through llama.cpp, or connect OpenAI, Anthropic, or Gemini.
-
-## What It Does
-
-* Runs an AI coding agent in your terminal.
-* Switches between cloud models and local GGUF models.
-* Creates or loads a wallet-owned ERC-8004 agent identity.
-* Encrypts private continuity before IPFS pinning.
-* Publishes public `skills.json` and Agent Card metadata for discovery.
-* Restores the same agent on another machine from the onchain record.
-* Supports workspace tools, managed edit rewind, session resume, context compaction, and MCP servers.
-
 ## First Run
 
-Start with `ethagent`. The setup flow asks for a model path first, then offers identity setup.
-
-You can create a new ERC-8004 agent with a browser wallet, load an agent token you already own, or skip identity setup and add it later from the Identity Hub.
-
-Use `Alt+P` to switch models and `Alt+I` to open the Identity Hub. Inside the agent, `/help` shows the live command list for the version you are running.
+First run walks model setup, then identity setup. You can use a local GGUF model through llama.cpp, or connect OpenAI, Anthropic, or Gemini.
 
-## Identity Hub
+Create a new ERC-8004 agent with a browser wallet, load an agent token you already own, or skip identity setup and add it later from the Identity Hub.
 
-The Identity Hub is where the portable identity is managed.
+Use `Alt+P` to swap models and `Alt+I` to open the Identity Hub. Inside the agent, `/help` shows the live command list for the version you are running.
 
-| Area | What It Controls |
-| --- | --- |
-| Public Metadata | Profile name, description, image, `skills.json`, and Agent Card. |
-| Private Local Files | `SOUL.md`, `MEMORY.md`, and the local copy of `skills.json`. |
-| Recovery | Publishing the current encrypted snapshot or refetching the latest one from chain. |
-| Storage | The Pinata JWT used to pin continuity and metadata to IPFS. |
-| Agent Token | Registry, owner, token, URI, CID, and copyable identity values. |
-
-The hub is a recovery panel, not a history archive. The current tokenURI is the source of truth for the latest published state.
-
-## Continuity
+## Identity & Continuity
 
-Each identity gets a local continuity vault under `~/.ethagent/continuity`.
+The Identity Hub manages the portable identity. Each identity gets a local continuity vault under `~/.ethagent/continuity`.
 
 | File | Visibility | Purpose |
 | --- | --- | --- |
 | `SOUL.md` | Private | Persona, boundaries, standing instructions, and identity framing. |
 | `MEMORY.md` | Private | Durable preferences, project context, decisions, and operating notes. |
-| `skills.json` | Public | Machine-readable capabilities, input modes, output modes, and discovery metadata. |
-
-`SOUL.md` and `MEMORY.md` are encrypted before they are pinned to IPFS. They are not published as plaintext in token metadata.
-
-`skills.json` is public by design. It uses schema `ethagent.public-skills.v1` and is meant to be easy for other agents, apps, and scanners to parse.
-
-## Recovery
+| `skills.json` | Public | Machine-readable capabilities under schema `ethagent.public-skills.v1`, easy for other agents and apps to parse. |
 
-**Publish Snapshot Now** encrypts the current private continuity, pins the public discovery files, writes current registration metadata, and updates the ERC-8004 tokenURI.
+`SOUL.md` and `MEMORY.md` are encrypted before they reach IPFS. They are never published as plaintext in token metadata.
 
-**Refetch Latest Snapshot** reads the current tokenURI from chain, downloads the encrypted continuity envelope, asks the owner wallet to sign the decrypt challenge, and restores local continuity files from the published state.
-
-Publishing replaces the current onchain pointer. Registration metadata contains the current CIDs only.
-
-## Public Discovery
-
-The public registration metadata is intentionally compact. It describes the current state of the agent, not its history.
-
-It can include:
-
-* Agent name, description, and image.
-* Current encrypted continuity CID.
-* Current public `skills.json` CID.
-* Current Agent Card CID.
-* Service entries with canonical `endpoint` values.
-* Registry linkage through `registrations[]`.
-
-This is enough for baseline agent-to-agent discovery and delegation without exposing private memory or installing executable code.
+**Save Snapshot Now** encrypts the current private continuity, pins the public discovery files, writes registration metadata, and updates the ERC-8004 tokenURI. **Refetch Latest Snapshot** reads the current tokenURI from chain, asks the owner wallet to sign the decrypt challenge, and restores local files from the published state. The current tokenURI is the source of truth.
 
 ## Models
 
 ethagent works with OpenAI, Anthropic, Gemini, and local GGUF models served through a llama.cpp-compatible endpoint.
 
-The model picker can discover provider models, manage cloud API keys, recommend GGUF files for the machine, and start or reconnect to a local runner when supported.
+The model picker discovers provider models, manages API keys, recommends GGUF files for your machine, and starts or attaches to a local runner. The featured local model is [Qwen3.5-9B-Uncensored](https://huggingface.co/HauhauCS/Qwen3.5-9B-Uncensored-HauhauCS-Aggressive); other Hugging Face GGUF models work by repo ID or URL.
 
-The featured local model is [Qwen3.5-9B-Uncensored](https://huggingface.co/HauhauCS/Qwen3.5-9B-Uncensored-HauhauCS-Aggressive). You can also add other Hugging Face GGUF models by repo ID or URL.
+Cloud API keys live in the OS keyring when available, with an encrypted local file under `~/.ethagent` as fallback.
 
-Cloud API keys are stored in the OS keyring when available. If a keyring is unavailable, ethagent uses an encrypted local file under `~/.ethagent`.
+## Tools & Sessions
 
-## Tools And Workspace
+File ops, shell, clipboard, and MCP tools, all permissioned. Managed edits support `/rewind`. Sessions support `/resume`, `/compact`, and `/export`.
 
-ethagent is built for real project work. It can read files, edit files, write new files, delete files, inspect directories, run shell commands, copy text to the clipboard, and connect MCP tools.
-
-Tool use is permissioned. Managed edits are tracked so recent workspace changes can be rewound from inside the agent.
-
-Sessions are local. You can resume prior sessions, export a transcript, compact older context, and review saved project permissions.
+`Shift+Tab` cycles Plan, Accept-Edits, and Chat modes. `Alt+T` toggles reasoning display.
 
 ## Privacy
 
 Public information includes token ownership, tokenURI metadata, public discovery files, and IPFS CIDs.
 
-Private information includes plaintext `SOUL.md`, plaintext `MEMORY.md`, sessions, prompt history, API keys, local permissions, and wallet signatures used for decrypting continuity.
+Private information includes plaintext `SOUL.md`, plaintext `MEMORY.md`, sessions, prompt history, API keys, local permissions, and wallet signatures used for decryption.
 
 Continuity snapshots use an EIP-191 wallet signature as unlock material and encrypt with ML-KEM-1024, HKDF-SHA256, and AES-256-GCM. The unlock signature does not submit a transaction, spend funds, or grant token approval.
 
-If an ERC-8004 token is transferred, the new holder can see public metadata and encrypted backup CIDs. They cannot decrypt private continuity that was encrypted for the previous owner wallet.
-
-## Local Reset
+If an ERC-8004 token is transferred, the new holder can see public metadata and encrypted backup CIDs. They cannot decrypt private continuity that was sealed for the previous owner wallet.
 
-`ethagent reset` deletes local ethagent data from this machine while preserving installed local model assets. It does not burn or transfer ERC-8004 tokens, remove public IPFS content, or mutate onchain metadata.
-
-Before resetting, use **Publish Snapshot Now** if local continuity changes should become the current recoverable state.
+`ethagent reset` deletes local ethagent data from this machine while preserving installed local model assets. It does not burn or transfer ERC-8004 tokens, remove public IPFS content, or mutate onchain metadata. Run **Save Snapshot Now** before resetting if local changes should become the recoverable state.
 
 ## Architecture
 
@@ -129,10 +70,6 @@ Before resetting, use **Publish Snapshot Now** if local continuity changes shoul
 
 The ERC-8004 token is the durable handle. The machine, model, and local session can change around it.
 
-## Links
-
 [npm](https://www.npmjs.com/package/ethagent) · [GitHub](https://github.com/baairon/ethagent) · [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) · [soul.md](https://soul.md/)
 
-## License
-
-MIT
+MIT License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethagent",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A privacy-first AI agent with a portable Ethereum identity",
   "type": "module",
   "main": "bin/ethagent.js",

package/src/chat/chatTurnOrchestrator.ts

@@ -665,7 +665,7 @@ export async function buildIdentityContinuityContextMessages(
       content: [
         '<identity_continuity_files>',
         `Automatic identity continuity load failed: ${(err as Error).message}`,
-        'If the user asks about continuity, surface this failure and route them to the identity hub.',
+        'If the user asks about continuity, surface this failure and route them to the Identity Hub.',
         '</identity_continuity_files>',
       ].join('\n'),
     }]

package/src/identity/hub/screens/ContinuityDashboardScreen.tsx

@@ -135,7 +135,7 @@ const PublicProfileRows: React.FC<{ identity?: EthagentIdentity }> = ({ identity
 function privateSubtitle(ready: boolean): string {
   return ready
     ? 'SOUL.md and MEMORY.md are private local files on this machine.'
-    : 'Use "Refetch Latest Snapshot" from the hub menu to recover files.'
+    : 'Use "Refetch Latest Snapshot" from the Identity Hub menu to recover files.'
 }
 
 function readStateString(state: Record<string, unknown> | undefined, key: string): string {

package/src/identity/hub/screens/ErrorScreen.tsx

@@ -22,7 +22,7 @@ export const ErrorScreen: React.FC<ErrorScreenProps> = ({ error, back, footer, o
         { value: 'back', role: 'section', prefix: '--', label: 'Recovery' },
         { value: 'back', label: 'Go Back', hint: 'Return to the previous identity step' },
         { value: 'close', role: 'section', prefix: '--', label: 'Exit' },
-        { value: 'close', label: 'Close Hub', hint: 'Return to chat without retrying', role: 'utility' },
+        { value: 'close', label: 'Close Identity Hub', hint: 'Return to chat without retrying', role: 'utility' },
       ]}
       hintLayout="inline"
       onSubmit={choice => {

package/src/identity/hub/screens/MenuScreen.tsx

@@ -78,7 +78,7 @@ export const MenuScreen: React.FC<MenuScreenProps> = ({
         { value: 'load', label: 'Switch Agent', hint: 'Load a different token owned by your wallet' },
         { value: 'create', label: 'New Agent', hint: 'Mint another token and make it active here' },
         { value: 'cancel', role: 'section', prefix: '--', label: 'Exit' },
-        { value: 'cancel', label: 'Close Hub', hint: 'Return to chat without changing identity', role: 'utility' },
+        { value: 'cancel', label: 'Close Identity Hub', hint: 'Return to chat without changing identity', role: 'utility' },
       ]
     : [
         { value: 'create', role: 'section', prefix: '--', label: 'Setup' },
@@ -87,7 +87,7 @@ export const MenuScreen: React.FC<MenuScreenProps> = ({
         { value: 'skip', role: 'section', prefix: '--', label: 'Exit' },
         ...(mode === 'first-run'
           ? [{ value: 'skip' as Action, label: 'Skip For Now', hint: 'Continue now; use /identity later', role: 'utility' as const }]
-          : [{ value: 'cancel' as Action, label: 'Close Hub', hint: 'Return to chat without changing identity', role: 'utility' as const }]),
+          : [{ value: 'cancel' as Action, label: 'Close Identity Hub', hint: 'Return to chat without changing identity', role: 'utility' as const }]),
       ]
 
   return (