ethagent 1.0.9 → 1.1.1

package/src/identity/hub/identityHubModel.ts

@@ -93,7 +93,7 @@ export function tokenLabel(candidate: Erc8004AgentCandidate): string {
 }
 
 export function tokenCandidateLabel(candidate: Erc8004AgentCandidate): string {
-  return candidate.name?.trim() || `agent token #${candidate.agentId.toString()}`
+  return candidate.name?.trim() || `Agent Token #${candidate.agentId.toString()}`
 }
 
 export function tokenCandidateSelectLabel(
@@ -200,8 +200,8 @@ export function identitySummaryRows(
   const tokenValue = identity?.agentId ? `#${identity.agentId}` : 'not created'
   const chain = chainSummaryRow(config, identity)
   const stateValue = backup?.cid ? shortCid(backup.cid) : 'not saved yet'
-  const skillsValue = identity?.publicSkills?.cid ? shortCid(identity.publicSkills.cid) : 'not published'
-  const cardValue = identity?.publicSkills?.agentCardCid ? shortCid(identity.publicSkills.agentCardCid) : 'not published'
+  const skillsValue = identity?.publicSkills?.cid ? shortCid(identity.publicSkills.cid) : 'not saved'
+  const cardValue = identity?.publicSkills?.agentCardCid ? shortCid(identity.publicSkills.agentCardCid) : 'not saved'
   const imageValue = typeof identity?.state?.imageUrl === 'string' && identity.state.imageUrl.trim() ? 'attached' : 'not attached'
   return [
     { label: 'owner', value: ownerValue, tone: identity ? 'ok' : 'dim' },
@@ -232,8 +232,8 @@ export function identityDetailSections(
   const chain = chainSummaryRow(config, identity)
   const stateCid = backup?.cid ?? 'not saved yet'
   const registrationCid = identity?.metadataCid ?? 'not saved yet'
-  const publicSkillsCid = identity?.publicSkills?.cid ?? 'not published'
-  const agentCardCid = identity?.publicSkills?.agentCardCid ?? 'not published'
+  const publicSkillsCid = identity?.publicSkills?.cid ?? 'not saved'
+  const agentCardCid = identity?.publicSkills?.agentCardCid ?? 'not saved'
 
   return [
     {
@@ -273,14 +273,14 @@ export type CopyableField = {
 export function copyableIdentityFields(identity?: EthagentIdentity): CopyableField[] {
   if (!identity) return []
   const fields: CopyableField[] = []
-  if (identity.backup?.cid) fields.push({ label: 'state CID', value: identity.backup.cid })
-  if (identity.publicSkills?.cid) fields.push({ label: 'skills CID', value: identity.publicSkills.cid })
-  if (identity.publicSkills?.agentCardCid) fields.push({ label: 'agent card CID', value: identity.publicSkills.agentCardCid })
-  if (identity.metadataCid) fields.push({ label: 'registration CID', value: identity.metadataCid })
-  if (identity.agentUri) fields.push({ label: 'agent URI', value: identity.agentUri })
+  if (identity.backup?.cid) fields.push({ label: 'State CID', value: identity.backup.cid })
+  if (identity.publicSkills?.cid) fields.push({ label: 'Skills CID', value: identity.publicSkills.cid })
+  if (identity.publicSkills?.agentCardCid) fields.push({ label: 'Agent Card CID', value: identity.publicSkills.agentCardCid })
+  if (identity.metadataCid) fields.push({ label: 'Registration CID', value: identity.metadataCid })
+  if (identity.agentUri) fields.push({ label: 'Agent URI', value: identity.agentUri })
   const owner = identity.ownerAddress ?? identity.address
-  if (owner) fields.push({ label: 'owner address', value: owner })
-  if (identity.agentId) fields.push({ label: 'token id', value: identity.agentId })
+  if (owner) fields.push({ label: 'Owner Address', value: owner })
+  if (identity.agentId) fields.push({ label: 'Token ID', value: identity.agentId })
   return fields
 }
 

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

@@ -4,57 +4,66 @@ import { Surface } from '../../../ui/Surface.js'
 import { Select } from '../../../ui/Select.js'
 import { theme } from '../../../ui/theme.js'
 import type { EthagentConfig, EthagentIdentity } from '../../../storage/config.js'
+import type { ContinuityWorkingTreeStatus } from '../../continuity/storage.js'
 import { IdentitySummary } from './IdentitySummary.js'
 import { shortCid } from '../identityHubModel.js'
 
-type PrivateAction = 'soul' | 'memory' | 'backup' | 'back'
-type PublicAction = 'edit' | 'skills' | 'publish' | 'back'
+type PrivateAction = 'soul' | 'memory' | 'back'
+type PublicAction = 'edit' | 'skills' | 'back'
 
 type CommonProps = {
   identity?: EthagentIdentity
   config?: EthagentConfig
+  workingStatus?: ContinuityWorkingTreeStatus | null
   ready: boolean
   notice?: string
   footer: React.ReactNode
   onBack: () => void
 }
 
+const SaveFromHubHint: React.FC<{ workingStatus?: ContinuityWorkingTreeStatus | null }> = ({ workingStatus }) => {
+  const needsBackup = workingStatus?.publishState === 'local-changes'
+    || workingStatus?.publishState === 'not-published'
+    || workingStatus?.publishState === 'verify-needed'
+  if (!needsBackup) return null
+  return (
+    <Box marginTop={1}>
+      <Text color={theme.accentPeach}>Save path: Identity Hub &gt; Save Snapshot Now &gt; Yes, Save Snapshot Now.</Text>
+    </Box>
+  )
+}
+
 export const PrivateContinuityScreen: React.FC<CommonProps & {
-  canBackup: boolean
   onOpenSoul: () => void
   onOpenMemory: () => void
-  onBackup: () => void
 }> = ({
   identity,
   config,
+  workingStatus,
   ready,
   notice,
   footer,
-  canBackup,
   onOpenSoul,
   onOpenMemory,
-  onBackup,
   onBack,
 }) => (
   <Surface title="Private Memory Files" subtitle={notice ?? privateSubtitle(ready)} footer={footer}>
-    <IdentitySummary identity={identity} config={config} compact />
+    <IdentitySummary identity={identity} config={config} workingStatus={workingStatus} compact />
     <PrivateRows identity={identity} ready={ready} />
+    <SaveFromHubHint workingStatus={workingStatus} />
     <Box marginTop={1}>
       <Select<PrivateAction>
         options={[
-          { value: 'soul', role: 'section', prefix: '--', label: 'Open local files' },
-          { value: 'soul', label: 'open SOUL.md', hint: 'edit persona and operating preferences', disabled: !ready },
-          { value: 'memory', label: 'open MEMORY.md', hint: 'edit private working memory for this agent', disabled: !ready },
-          { value: 'backup', role: 'section', prefix: '--', label: 'Recovery' },
-          { value: 'backup', label: 'save snapshot now', hint: 'encrypts and publishes local SOUL.md and MEMORY.md changes, as well as skills.json and public metadata', disabled: !ready || !canBackup },
+          { value: 'soul', role: 'section', prefix: '--', label: 'Open Local Files' },
+          { value: 'soul', label: 'Open SOUL.md', hint: 'Edit persona and operating preferences', disabled: !ready },
+          { value: 'memory', label: 'Open MEMORY.md', hint: 'Edit private working memory for this agent', disabled: !ready },
           { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-          { value: 'back', label: 'back to identity hub', hint: 'return without changing private files', role: 'utility' },
+          { value: 'back', label: 'Back To Identity Hub', hint: 'Return without changing private files', role: 'utility' },
         ]}
         hintLayout="inline"
         onSubmit={choice => {
           if (choice === 'soul') return onOpenSoul()
           if (choice === 'memory') return onOpenMemory()
-          if (choice === 'backup') return onBackup()
           return onBack()
         }}
         onCancel={onBack}
@@ -64,31 +73,27 @@ export const PrivateContinuityScreen: React.FC<CommonProps & {
 )
 
 export const PublicSkillsScreen: React.FC<CommonProps & {
-  canPublish: boolean
   onEditProfile: () => void
   onOpenSkills: () => void
-  onPublish: () => void
-}> = ({ identity, config, notice, footer, canPublish, onEditProfile, onOpenSkills, onPublish, onBack }) => (
+}> = ({ identity, config, workingStatus, notice, footer, onEditProfile, onOpenSkills, onBack }) => (
   <Surface title="Public Profile" subtitle={notice ?? 'Manage public metadata, skills.json, and the agent card.'} footer={footer}>
-    <IdentitySummary identity={identity} config={config} compact />
+    <IdentitySummary identity={identity} config={config} workingStatus={workingStatus} compact />
     <PublicProfileRows identity={identity} />
+    <SaveFromHubHint workingStatus={workingStatus} />
     <Box marginTop={1}>
       <Select<PublicAction>
         options={[
           { value: 'edit', role: 'section', prefix: '--', label: 'Profile' },
-          { value: 'edit', label: 'edit name, description, image', hint: 'upload a local image to IPFS automatically' },
+          { value: 'edit', label: 'Edit Name, Description, Image', hint: 'Upload a local image to IPFS automatically' },
           { value: 'skills', role: 'section', prefix: '--', label: 'Capabilities' },
-          { value: 'skills', label: 'open skills.json', hint: 'edit public capabilities and notes' },
-          { value: 'publish', role: 'section', prefix: '--', label: 'Recovery' },
-          { value: 'publish', label: 'save snapshot now', hint: 'publishes local memory, skills, and metadata', disabled: !canPublish },
+          { value: 'skills', label: 'Open skills.json', hint: 'Edit public capabilities and notes' },
           { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-          { value: 'back', label: 'back to identity hub', hint: 'return without changing public metadata', role: 'utility' },
+          { value: 'back', label: 'Back To Identity Hub', hint: 'Return without changing public metadata', role: 'utility' },
         ]}
         hintLayout="inline"
         onSubmit={choice => {
           if (choice === 'edit') return onEditProfile()
           if (choice === 'skills') return onOpenSkills()
-          if (choice === 'publish') return onPublish()
           return onBack()
         }}
         onCancel={onBack}
@@ -100,12 +105,12 @@ export const PublicSkillsScreen: React.FC<CommonProps & {
 const PrivateRows: React.FC<{ identity?: EthagentIdentity; ready: boolean }> = ({ identity, ready }) => (
   <Box flexDirection="column" marginTop={1}>
     <Text>
-      <Text color={theme.dim}>{'local files'.padEnd(13)}</Text>
-      <Text color={ready ? theme.text : theme.dim}>{ready ? 'SOUL.md and MEMORY.md ready' : 'missing local working files'}</Text>
+      <Text color={theme.dim}>{'Local Files'.padEnd(13)}</Text>
+      <Text color={ready ? theme.text : theme.dim}>{ready ? 'SOUL.md and MEMORY.md Ready' : 'Missing Local Working Files'}</Text>
     </Text>
     <Text>
-      <Text color={theme.dim}>{'snapshot'.padEnd(13)}</Text>
-      <Text color={identity?.backup?.cid ? theme.text : theme.dim}>{identity?.backup?.cid ? shortCid(identity.backup.cid) : 'not saved yet'}</Text>
+      <Text color={theme.dim}>{'Snapshot'.padEnd(13)}</Text>
+      <Text color={identity?.backup?.cid ? theme.text : theme.dim}>{identity?.backup?.cid ? shortCid(identity.backup.cid) : 'Not Saved Yet'}</Text>
     </Text>
   </Box>
 )
@@ -114,15 +119,15 @@ const PublicProfileRows: React.FC<{ identity?: EthagentIdentity }> = ({ identity
   <Box flexDirection="column" marginTop={1}>
     <Text>
       <Text color={theme.dim}>{'skills.json'.padEnd(13)}</Text>
-      <Text color={identity?.publicSkills?.cid ? theme.text : theme.dim}>{identity?.publicSkills?.cid ? shortCid(identity.publicSkills.cid) : 'not published'}</Text>
+      <Text color={identity?.publicSkills?.cid ? theme.text : theme.dim}>{identity?.publicSkills?.cid ? shortCid(identity.publicSkills.cid) : 'Not Saved'}</Text>
     </Text>
     <Text>
-      <Text color={theme.dim}>{'agent card'.padEnd(13)}</Text>
-      <Text color={identity?.publicSkills?.agentCardCid ? theme.text : theme.dim}>{identity?.publicSkills?.agentCardCid ? shortCid(identity.publicSkills.agentCardCid) : 'not published'}</Text>
+      <Text color={theme.dim}>{'Agent Card'.padEnd(13)}</Text>
+      <Text color={identity?.publicSkills?.agentCardCid ? theme.text : theme.dim}>{identity?.publicSkills?.agentCardCid ? shortCid(identity.publicSkills.agentCardCid) : 'Not Saved'}</Text>
     </Text>
     <Text>
-      <Text color={theme.dim}>{'image'.padEnd(13)}</Text>
-      <Text color={readStateString(identity?.state, 'imageUrl') ? theme.text : theme.dim}>{readStateString(identity?.state, 'imageUrl') ? 'attached' : 'not attached'}</Text>
+      <Text color={theme.dim}>{'Image'.padEnd(13)}</Text>
+      <Text color={readStateString(identity?.state, 'imageUrl') ? theme.text : theme.dim}>{readStateString(identity?.state, 'imageUrl') ? 'Attached' : 'Not Attached'}</Text>
     </Text>
   </Box>
 )
@@ -130,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/CreateFlow.tsx

@@ -81,10 +81,10 @@ export const CreateFlow: React.FC<CreateFlowProps> = ({
         </Box>
         <Select<'replace' | 'back'>
           options={[
-            { value: 'back', role: 'section', prefix: '--', label: 'Current identity' },
-            { value: 'back', label: 'keep current agent', hint: 'return without minting anything', role: 'utility' },
-            { value: 'replace', role: 'section', prefix: '--', label: 'New identity' },
-            { value: 'replace', label: 'mint and use new agent', hint: 'create separate token and make it active' },
+            { value: 'back', role: 'section', prefix: '--', label: 'Current Identity' },
+            { value: 'back', label: 'Keep Current Agent', hint: 'Return without minting anything', role: 'utility' },
+            { value: 'replace', role: 'section', prefix: '--', label: 'New Identity' },
+            { value: 'replace', label: 'Mint and Use New Agent', hint: 'Create separate token and make it active' },
           ]}
           hintLayout="inline"
           onSubmit={choice => {

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

@@ -33,9 +33,9 @@ export const DetailsScreen: React.FC<DetailsScreenProps> = ({
       label: field.label,
       hint: shortPreview(field.value),
     })),
-    ...(copyable.length === 0 ? [{ value: 'back' as const, role: 'notice' as const, label: 'no values available yet' }] : []),
+    ...(copyable.length === 0 ? [{ value: 'back' as const, role: 'notice' as const, label: 'No Values Available Yet' }] : []),
     { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-    { value: 'back', label: 'back to identity hub', hint: 'return without copying', role: 'utility' },
+    { value: 'back', label: 'Back To Identity Hub', hint: 'Return without copying', role: 'utility' },
   ]
 
   return (

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

@@ -67,12 +67,12 @@ export const EditProfileFlow: React.FC<EditProfileFlowProps> = ({
             <Select<'choose' | 'manual' | 'skip' | 'delete' | 'back'>
               options={[
                 { value: 'choose', role: 'section', prefix: '--', label: 'Image' },
-                { value: 'choose', label: 'choose image file', hint: 'open the operating system file picker' },
-                { value: 'manual', label: 'enter path manually', hint: 'fallback if a file picker is unavailable' },
-                ...(currentImage ? [{ value: 'delete' as const, label: 'delete current image', hint: 'remove the attached image from public profile' }] : []),
-                { value: 'skip', label: currentImage ? 'keep current image' : 'no image', hint: 'publish without changing the image' },
+                { value: 'choose', label: 'Choose Image File', hint: 'Open the operating system file picker' },
+                { value: 'manual', label: 'Enter Path Manually', hint: 'Fallback if a file picker is unavailable' },
+                ...(currentImage ? [{ value: 'delete' as const, label: 'Delete Current Image', hint: 'Remove the attached image from public profile' }] : []),
+                { value: 'skip', label: currentImage ? 'Keep Current Image' : 'No Image', hint: 'Save without changing the image' },
                 { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-                { value: 'back', label: 'back', hint: 'return to description', role: 'utility' },
+                { value: 'back', label: 'Back', hint: 'Return to description', role: 'utility' },
               ]}
               hintLayout="inline"
               onSubmit={choice => {

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

@@ -20,9 +20,9 @@ export const ErrorScreen: React.FC<ErrorScreenProps> = ({ error, back, footer, o
     <Select<'back' | 'close'>
       options={[
         { value: 'back', role: 'section', prefix: '--', label: 'Recovery' },
-        { value: 'back', label: 'go back', hint: 'return to the previous identity step' },
+        { 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 the 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/IdentitySummary.tsx

@@ -14,7 +14,7 @@ export const IdentitySummary: React.FC<{
 }> = ({ identity, config, workingStatus, compact = false }) => {
   if (!identity) {
     return (
-      <Text color={theme.dim}>no agent yet. create or load one.</Text>
+      <Text color={theme.dim}>No agent yet. Create or load one.</Text>
     )
   }
 
@@ -39,32 +39,52 @@ export const IdentitySummary: React.FC<{
   }
 
   const lastSavedRow = needsBackup
-    ? { label: 'unsaved', value: changedFiles.length > 0 ? changedFiles.join(', ') : 'markdown files', tone: 'warn' as const, highlight: true }
-    : { label: 'last saved', value: lastBackup, tone: lastBackup === 'never' ? 'dim' as const : 'ok' as const }
+    ? { label: 'Unsaved', value: changedFiles.length > 0 ? changedFiles.join(', ') : 'Markdown files', tone: 'warn' as const, highlight: true }
+    : { label: 'Last Saved', value: lastBackup, tone: lastBackup === 'never' ? 'dim' as const : 'ok' as const }
 
   const summaryRows = [
-    { label: 'token', value: row('token')?.value ?? 'not created', tone: row('token')?.tone ?? 'dim', highlight: true },
-    { label: 'network', value: row('network')?.value ?? 'unknown', tone: row('network')?.tone ?? 'dim' },
-    { label: 'owner', value: row('owner')?.value ?? 'not connected', tone: row('owner')?.tone ?? 'dim' },
-    { label: 'snapshot', value: row('state')?.value ?? 'not saved yet', tone: row('state')?.tone ?? 'dim', highlight: true },
+    { label: 'Token', value: row('token')?.value ?? 'Not Created', tone: row('token')?.tone ?? 'dim', highlight: true },
+    { label: 'Network', value: row('network')?.value ?? 'Unknown', tone: row('network')?.tone ?? 'dim' },
+    { label: 'Owner', value: row('owner')?.value ?? 'Not Connected', tone: row('owner')?.tone ?? 'dim' },
+    { label: 'Snapshot', value: row('state')?.value ?? 'Not Saved Yet', tone: row('state')?.tone ?? 'dim', highlight: true },
     lastSavedRow,
-    { label: 'skills', value: row('skills')?.value ?? 'not published', tone: row('skills')?.tone ?? 'dim' },
-    { label: 'agent card', value: row('card')?.value ?? 'not published', tone: row('card')?.tone ?? 'dim' },
-    { label: 'image', value: row('image')?.value ?? 'not attached', tone: row('image')?.tone ?? 'dim' },
+    { label: 'Skills', value: row('skills')?.value ?? 'Not Saved', tone: row('skills')?.tone ?? 'dim' },
+    { label: 'Agent Card', value: row('card')?.value ?? 'Not Saved', tone: row('card')?.tone ?? 'dim' },
+    { label: 'Image', value: row('image')?.value ?? 'Not Attached', tone: row('image')?.tone ?? 'dim' },
   ]
 
   return (
     <Box flexDirection="column">
-      <Text color={theme.accentPrimary} bold>{stateName || 'active agent'}</Text>
+      <Text color={theme.accentPrimary} bold>{stateName || 'Active Agent'}</Text>
       {summaryRows.map(row => {
         const valueColor = row.tone === 'warn' ? 'red' : (row.tone === 'ok' ? theme.text : theme.dim)
         return (
           <Text key={row.label}>
             <Text color={theme.dim}>{row.label.padEnd(12)}</Text>
-            <Text color={valueColor} bold={row.highlight}>{row.value}</Text>
+            <Text color={valueColor} bold={row.highlight}>{displayValue(row.value)}</Text>
           </Text>
         )
       })}
     </Box>
   )
 }
+
+function displayValue(value: string): string {
+  const mapped = DISPLAY_VALUES[value]
+  return mapped ?? value
+}
+
+const DISPLAY_VALUES: Record<string, string> = {
+  'not attached': 'Not Attached',
+  'not connected': 'Not Connected',
+  'not created': 'Not Created',
+  'not saved': 'Not Saved',
+  'not saved yet': 'Not Saved Yet',
+  'never': 'Never',
+  'unknown': 'Unknown',
+  'ethereum mainnet': 'Ethereum Mainnet',
+  'arbitrum one': 'Arbitrum One',
+  'base': 'Base',
+  'optimism': 'Optimism',
+  'polygon': 'Polygon',
+}

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

@@ -55,7 +55,7 @@ export const MenuScreen: React.FC<MenuScreenProps> = ({
   onSkip,
   onCancel,
 }) => {
-  const title = mode === 'first-run' ? 'Set Up Agent Identity' : 'Agent Identity'
+  const title = mode === 'first-run' ? 'Set Up Agent Identity' : 'Identity Hub'
   const subtitle = mode === 'first-run'
     ? 'Create a portable agent or load one you already own.'
     : 'Public, private, recovery, storage, and device controls are separate.'
@@ -64,30 +64,30 @@ export const MenuScreen: React.FC<MenuScreenProps> = ({
 
   const options: Array<SelectOption<Action>> = identity
     ? [
-        { value: 'public-profile', role: 'section', prefix: '--', label: 'Public metadata' },
-        { value: 'public-profile', label: 'public profile', hint: 'name, image, skills.json, agent card' },
-        { value: 'private-memory', role: 'section', prefix: '--', label: 'Private local files' },
-        { value: 'private-memory', label: 'memory and persona', hint: 'SOUL.md and MEMORY.md only on this device' },
+        { value: 'public-profile', role: 'section', prefix: '--', label: 'Public Metadata' },
+        { value: 'public-profile', label: 'Public Profile', hint: 'Name, image, skills.json, Agent Card' },
+        { value: 'private-memory', role: 'section', prefix: '--', label: 'Private Local Files' },
+        { value: 'private-memory', label: 'Memory and Persona', hint: 'SOUL.md and MEMORY.md only on this device' },
         { value: 'backup', role: 'section', prefix: '--', label: 'Recovery' },
-        { value: 'backup', label: 'save snapshot now', hint: 'publishes SOUL.md, MEMORY.md, skills.json, and metadata', disabled: !canRebackup },
-        { value: 'refetch', label: 'refetch latest snapshot', hint: 'restore local files from the latest published snapshot', disabled: !canRefetch },
+        { value: 'backup', label: 'Save Snapshot Now', hint: 'Saves any local edits to SOUL.md, MEMORY.md, skills.json, and public profile', disabled: !canRebackup },
+        { value: 'refetch', label: 'Refetch Latest Snapshot', hint: 'Restore local files from the latest saved snapshot', disabled: !canRefetch },
         { value: 'storage-credential', role: 'section', prefix: '--', label: 'Storage' },
-        { value: 'storage-credential', label: 'IPFS credential', hint: 'save, replace, or forget Pinata JWT' },
-        { value: 'copy', role: 'section', prefix: '--', label: 'Agent token' },
-        { value: 'copy', label: 'copy values', hint: 'copy CIDs, token id, URI, or owner' },
-        { 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: 'storage-credential', label: 'IPFS Credential', hint: 'Save, replace, or forget Pinata JWT' },
+        { value: 'copy', role: 'section', prefix: '--', label: 'Agent Token' },
+        { value: 'copy', label: 'Copy Values', hint: 'Copy CIDs, token ID, URI, or owner' },
+        { 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 the 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' },
-        { value: 'create', label: 'create new agent', hint: 'mint a wallet-owned token for this machine' },
-        { value: 'load', label: 'load existing agent', hint: 'find an agent token your wallet already owns' },
+        { value: 'create', label: 'Create New Agent', hint: 'Mint a wallet-owned token for this machine' },
+        { value: 'load', label: 'Load Existing Agent', hint: 'Find an agent token your wallet already owns' },
         { 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 the chat without changing identity', role: 'utility' as const }]),
+          ? [{ value: 'skip' as Action, label: 'Skip For Now', hint: 'Continue now; use /identity later', role: 'utility' as const }]
+          : [{ value: 'cancel' as Action, label: 'Close Identity Hub', hint: 'Return to chat without changing identity', role: 'utility' as const }]),
       ]
 
   return (

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

@@ -14,9 +14,9 @@ type NetworkScreenProps = {
 
 export const NetworkScreen: React.FC<NetworkScreenProps> = ({ subtitle, footer, onSelect, onCancel }) => {
   const options: Array<SelectOption<SelectableNetwork>> = [
-    { value: 'mainnet', role: 'section', prefix: '--', label: 'Main network' },
+    { value: 'mainnet', role: 'section', prefix: '--', label: 'Main Network' },
     networkOption('mainnet'),
-    { value: 'arbitrum', role: 'section', prefix: '--', label: 'Lower-fee networks' },
+    { value: 'arbitrum', role: 'section', prefix: '--', label: 'Lower-Fee Networks' },
     ...SELECTABLE_NETWORKS.filter(network => network !== 'mainnet').map(networkOption),
   ]
 
@@ -35,7 +35,11 @@ export const NetworkScreen: React.FC<NetworkScreenProps> = ({ subtitle, footer,
 function networkOption(network: SelectableNetwork): SelectOption<SelectableNetwork> {
   return {
     value: network,
-    label: networkLabel(network),
+    label: titleCase(networkLabel(network)),
     hint: networkSubtitle(network),
   }
 }
+
+function titleCase(value: string): string {
+  return value.replace(/\b[a-z]/g, letter => letter.toUpperCase())
+}

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

@@ -20,16 +20,16 @@ export const RecoveryConfirmScreen: React.FC<RecoveryConfirmScreenProps> = ({ mo
   const isPublish = mode === 'publish'
   const title = isPublish ? 'Save Snapshot?' : 'Refetch Latest From Chain?'
   const subtitle = isPublish
-    ? 'This replaces the current on-chain snapshot pointer.'
+    ? 'Saves any local edits to SOUL.md, MEMORY.md, skills.json, and public profile.'
     : 'This overwrites local files with the on-chain version.'
 
   const headlineColor = isPublish ? theme.accentPeach : theme.accentMint
   const headline = isPublish
-    ? 'Saving replaces the on-chain pointer for this agent.'
+    ? 'Saving updates the on-chain pointer for this agent.'
     : 'Refetching replaces local SOUL.md, MEMORY.md, and skills.json with what is on chain.'
   const detail = isPublish
-    ? 'The old snapshot pointer is overwritten. Local edits become the saved state.'
-    : 'Unsaved local edits will be lost. Use this when local files are missing or out of sync with the latest published snapshot.'
+    ? 'Any local edits to SOUL.md, MEMORY.md, skills.json, and public profile become the saved state. The previous snapshot pointer is overwritten.'
+    : 'Unsaved local edits will be lost. Use this when local files are missing or out of sync with the latest saved snapshot.'
 
   const needsBackup = workingStatus?.publishState === 'local-changes' || workingStatus?.publishState === 'not-published' || workingStatus?.publishState === 'verify-needed'
   let changedFiles: string[] = []
@@ -50,8 +50,10 @@ export const RecoveryConfirmScreen: React.FC<RecoveryConfirmScreenProps> = ({ mo
         <Text color={theme.textSubtle}>{detail}</Text>
         {isPublish && changedFiles.length > 0 && (
           <Box marginTop={1}>
-            <Text color={theme.textSubtle}>unsaved changes: </Text>
-            <Text color="red" bold>{changedFiles.join(', ')}</Text>
+            <Text>
+              <Text color={theme.textSubtle}>ready to save: </Text>
+              <Text color={theme.accentMint} bold>{changedFiles.join(', ')}</Text>
+            </Text>
           </Box>
         )}
       </Box>
@@ -62,7 +64,7 @@ export const RecoveryConfirmScreen: React.FC<RecoveryConfirmScreenProps> = ({ mo
             {
               value: 'confirm',
               label: isPublish ? 'Yes, Save Snapshot Now' : 'Yes, Refetch From Chain',
-              hint: isPublish ? 'Sign and overwrite the on-chain pointer' : 'Wallet decrypts and overwrites local files',
+              hint: isPublish ? 'Sign and save the encrypted snapshot' : 'Wallet decrypts and overwrites local files',
             },
             { value: 'back', role: 'section', prefix: '--', label: 'Cancel' },
             {

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

@@ -59,7 +59,7 @@ export const RestoreFlow: React.FC<RestoreFlowProps> = ({
         <Select<'connect'>
           options={[
             { value: 'connect', role: 'section', prefix: '--', label: 'Wallet' },
-            { value: 'connect', label: 'connect wallet', hint: 'search tokens owned by browser wallet' },
+            { value: 'connect', label: 'Connect Wallet', hint: 'Search tokens owned by browser wallet' },
           ]}
           hintLayout="inline"
           onSubmit={onConnectWallet}
@@ -137,7 +137,7 @@ export const RestoreFlow: React.FC<RestoreFlowProps> = ({
       >
         <Select<string>
           options={[
-            { value: 'section:owned-agents', role: 'section', prefix: '--', label: 'Owned agents' },
+            { value: 'section:owned-agents', role: 'section', prefix: '--', label: 'Owned Agents' },
             ...step.candidates.map(candidate => {
               const current = isSwitch && isCurrentAgentCandidate(config?.identity, candidate)
               return {

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

@@ -86,9 +86,9 @@ export const StorageCredentialScreen: React.FC<StorageCredentialScreenProps> = (
           <Select<StorageCredentialAction>
             options={[
               { value: 'forget', role: 'section', prefix: '--', label: 'Credential' },
-              { value: 'forget', label: 'forget credential', hint: 'remove local IPFS pinning token' },
+              { value: 'forget', label: 'Forget Credential', hint: 'Remove local IPFS pinning token' },
               { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-              { value: 'back', label: 'keep credential', hint: 'return without changing storage access', role: 'utility' },
+              { value: 'back', label: 'Keep Credential', hint: 'Return without changing storage access', role: 'utility' },
             ]}
             hintLayout="inline"
             onSubmit={choice => choice === 'forget' ? onConfirmForget() : onCancel()}
@@ -109,10 +109,10 @@ export const StorageCredentialScreen: React.FC<StorageCredentialScreenProps> = (
         <Select<StorageCredentialAction>
           options={[
             { value: 'edit', role: 'section', prefix: '--', label: 'Credential' },
-            { value: 'edit', label: hasCredential ? 'replace credential' : 'save credential', hint: 'store Pinata JWT for IPFS pinning' },
-            { value: 'forget', label: 'forget credential', hint: 'remove the local pinning token; existing pins remain', disabled: !hasCredential },
+            { value: 'edit', label: hasCredential ? 'Replace Credential' : 'Save Credential', hint: 'Store Pinata JWT for IPFS pinning' },
+            { value: 'forget', label: 'Forget Credential', hint: 'Remove the local pinning token; existing pins remain', disabled: !hasCredential },
             { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-            { value: 'back', label: 'back to identity hub', hint: 'return without changing storage access', role: 'utility' },
+            { value: 'back', label: 'Back To Identity Hub', hint: 'Return without changing storage access', role: 'utility' },
           ]}
           hintLayout="inline"
           onSubmit={choice => {