ethagent 1.1.2 → 2.0.1

package/src/identity/hub/identityHubModel.ts

@@ -1,371 +0,0 @@
-import type { EthagentConfig, EthagentIdentity, SelectableNetwork } from '../../storage/config.js'
-import {
-  RegisterAgentPreflightError,
-  supportedErc8004ChainForId,
-  type Erc8004AgentCandidate,
-} from '../registry/erc8004.js'
-import { AgentStateOwnerMismatchError } from '../crypto/backupEnvelope.js'
-import { ContinuitySnapshotOwnerMismatchError } from '../continuity/envelope.js'
-import type { ContinuityWorkingTreeStatus } from '../continuity/storage.js'
-import { resolveSelectedNetwork } from '../registry/registryConfig.js'
-
-export const PREFLIGHT_AGENT_URI = 'ipfs://bafybeigdyrztma2dbfczw7q6ooozbxlqzyw5r7w4f3qw2axvvxqg3w6y7q'
-
-export type IdentityHubErrorView = {
-  title: string
-  detail?: string
-  hint?: string
-}
-
-export function initialAgentState(name: string, description: string, ownerAddress: string): Record<string, unknown> {
-  return {
-    version: 1,
-    name,
-    description,
-    ownerAddress,
-    createdAt: new Date().toISOString(),
-    preferences: {},
-    memory: {},
-  }
-}
-
-export function identityHubErrorView(err: unknown): IdentityHubErrorView {
-  if (err instanceof RegisterAgentPreflightError) {
-    return {
-      title: err.title,
-      detail: err.detail,
-      hint: err.hint,
-    }
-  }
-  if (err instanceof AgentStateOwnerMismatchError) {
-    return {
-      title: 'backup locked to another wallet',
-      detail: `wallet ${shortAddress(err.currentOwner)} cannot read state encrypted for ${shortAddress(err.backupOwner)}.`,
-      hint: 'Use the wallet that created this backup.',
-    }
-  }
-  if (err instanceof ContinuitySnapshotOwnerMismatchError) {
-    return {
-      title: 'continuity locked to another wallet',
-      detail: `wallet ${shortAddress(err.currentOwner)} cannot read SOUL.md or MEMORY.md encrypted for ${shortAddress(err.snapshotOwner)}.`,
-      hint: 'Use the wallet that created this continuity snapshot.',
-    }
-  }
-  const message = err instanceof Error ? err.message : String(err)
-  if (message === 'fetch failed') {
-    return {
-      title: 'storage unavailable',
-      detail: 'could not reach storage.',
-      hint: 'check the connection, then try again.',
-    }
-  }
-  return {
-    title: 'identity error',
-    detail: message,
-  }
-}
-
-export function pinataErrorText(err: unknown): string {
-  const view = identityHubErrorView(err)
-  return view.detail ?? view.title
-}
-
-export function isRegistrationPreflightError(err: unknown): boolean {
-  return err instanceof RegisterAgentPreflightError
-}
-
-export function shortCid(cid: string): string {
-  if (cid.length <= 18) return cid
-  return `${cid.slice(0, 10)}...${cid.slice(-6)}`
-}
-
-export function shortAddress(address: string): string {
-  if (address.length <= 14) return address
-  return `${address.slice(0, 6)}...${address.slice(-4)}`
-}
-
-export function shortHash(value: string): string {
-  if (value.length <= 18) return value
-  return `${value.slice(0, 8)}...${value.slice(-6)}`
-}
-
-export function tokenLabel(candidate: Erc8004AgentCandidate): string {
-  return tokenCandidateLabel(candidate)
-}
-
-export function tokenCandidateLabel(candidate: Erc8004AgentCandidate): string {
-  return candidate.name?.trim() || `Agent Token #${candidate.agentId.toString()}`
-}
-
-export function tokenCandidateSelectLabel(
-  candidate: Erc8004AgentCandidate,
-  current = false,
-): string {
-  return `${tokenCandidateLabel(candidate)}${current ? '  *' : ''}`
-}
-
-export function tokenCandidateHint(candidate: Erc8004AgentCandidate): string {
-  const chain = supportedErc8004ChainForId(candidate.chainId)
-  const network = chain?.network ? networkLabel(chain.network) : chain?.name ?? `chain ${candidate.chainId}`
-  const parts = [
-    candidate.name?.trim() ? `token #${candidate.agentId.toString()}` : null,
-    network,
-    candidate.backup?.createdAt ? `backup ${formatDate(candidate.backup.createdAt)}` : null,
-  ].filter((part): part is string => Boolean(part))
-  return parts.join(' · ')
-}
-
-export function isCurrentAgentCandidate(
-  identity: EthagentIdentity | undefined,
-  candidate: Erc8004AgentCandidate,
-): boolean {
-  if (!identity?.agentId) return false
-  if (identity.agentId !== candidate.agentId.toString()) return false
-
-  const owner = identity.ownerAddress ?? identity.address
-  if (owner && owner.toLowerCase() !== candidate.ownerAddress.toLowerCase()) return false
-  if (identity.chainId !== undefined && identity.chainId !== candidate.chainId) return false
-  if (
-    identity.identityRegistryAddress
-    && identity.identityRegistryAddress.toLowerCase() !== candidate.identityRegistryAddress.toLowerCase()
-  ) {
-    return false
-  }
-  return true
-}
-
-export function storageLabel(apiUrl: string): string {
-  void apiUrl
-  return 'IPFS'
-}
-
-const NETWORK_LABELS: Record<SelectableNetwork, string> = {
-  mainnet:  'ethereum mainnet',
-  arbitrum: 'arbitrum one',
-  base:     'base',
-  optimism: 'optimism',
-  polygon:  'polygon',
-}
-
-export function networkLabel(network: SelectableNetwork): string {
-  return NETWORK_LABELS[network]
-}
-
-const NETWORK_SUBTITLES: Record<SelectableNetwork, string> = {
-  mainnet:  'agent tokens on ethereum mainnet.',
-  arbitrum: 'agent tokens on arbitrum one.',
-  base:     'agent tokens on base.',
-  optimism: 'agent tokens on optimism.',
-  polygon:  'agent tokens on polygon.',
-}
-
-export function networkSubtitle(network: SelectableNetwork): string {
-  return NETWORK_SUBTITLES[network]
-}
-
-export function networkMenuTagline(): string {
-  return 'choose where your agent token is created or found.'
-}
-
-export function currentNetworkLine(config?: EthagentConfig): string {
-  return networkLabel(resolveSelectedNetwork(config))
-}
-
-export function chainSummaryRow(config?: EthagentConfig, identity?: EthagentIdentity): {
-  label: string
-  value: string
-  tone: 'ok' | 'dim'
-} {
-  const network = resolveSelectedNetwork(config)
-  const fromIdentity = identity?.chainId ? supportedErc8004ChainForId(identity.chainId)?.name.toLowerCase() : undefined
-  const value = fromIdentity ?? networkLabel(network)
-  return { label: 'chain', value, tone: identity?.chainId ? 'ok' : 'dim' }
-}
-
-export function lastBackupLabel(identity?: EthagentIdentity): string {
-  const created = identity?.backup?.createdAt
-  return created ? formatDate(created) : 'never'
-}
-
-export function identitySummaryRows(
-  identity: EthagentIdentity | undefined,
-  config?: EthagentConfig,
-): Array<{
-  label: string
-  value: string
-  tone: 'ok' | 'dim'
-}> {
-  const backup = identity?.backup
-  const owner = identity?.ownerAddress ?? identity?.address
-  const ownerValue = owner ? shortAddress(owner) : 'not connected'
-  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 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' },
-    { label: 'token', value: tokenValue, tone: identity?.agentId ? 'ok' : 'dim' },
-    { label: 'network', value: chain.value, tone: chain.tone },
-    { label: 'state', value: stateValue, tone: backup ? 'ok' : 'dim' },
-    { label: 'skills', value: skillsValue, tone: identity?.publicSkills?.cid ? 'ok' : 'dim' },
-    { label: 'card', value: cardValue, tone: identity?.publicSkills?.agentCardCid ? 'ok' : 'dim' },
-    { label: 'image', value: imageValue, tone: imageValue === 'attached' ? 'ok' : 'dim' },
-  ]
-}
-
-export type LocalChangeStatusView = {
-  label: string
-  detail: string
-  tone: 'ok' | 'warn' | 'dim'
-  files: string[]
-  hasLocalChanges: boolean
-}
-
-export function changedContinuitySnapshotFiles(
-  workingStatus?: ContinuityWorkingTreeStatus | null,
-): string[] {
-  if (!workingStatus?.localContentHashes || !workingStatus.publishedContentHashes) return []
-  const files: Array<keyof typeof workingStatus.localContentHashes> = ['SOUL.md', 'MEMORY.md', 'skills.json']
-  return files.filter(file => workingStatus.localContentHashes?.[file] !== workingStatus.publishedContentHashes?.[file])
-}
-
-export function localChangeStatusView(
-  workingStatus?: ContinuityWorkingTreeStatus | null,
-): LocalChangeStatusView {
-  if (!workingStatus) {
-    return {
-      label: 'Local Changes',
-      detail: 'Checking status...',
-      tone: 'dim',
-      files: [],
-      hasLocalChanges: false,
-    }
-  }
-
-  if (workingStatus.publishState === 'published') {
-    return {
-      label: 'Local Changes',
-      detail: 'None detected',
-      tone: 'ok',
-      files: [],
-      hasLocalChanges: false,
-    }
-  }
-
-  if (workingStatus.publishState === 'local-changes') {
-    const files = changedContinuitySnapshotFiles(workingStatus)
-    return {
-      label: 'Local Changes',
-      detail: files.length > 0 ? `Detected: ${files.join(', ')}` : 'Detected: local files differ from saved snapshot',
-      tone: 'warn',
-      files,
-      hasLocalChanges: true,
-    }
-  }
-
-  if (workingStatus.publishState === 'not-published') {
-    return {
-      label: 'Local Changes',
-      detail: 'Snapshot not saved yet',
-      tone: 'warn',
-      files: [],
-      hasLocalChanges: false,
-    }
-  }
-
-  if (workingStatus.publishState === 'verify-needed') {
-    return {
-      label: 'Local Changes',
-      detail: 'Unable to verify saved snapshot',
-      tone: 'warn',
-      files: [],
-      hasLocalChanges: false,
-    }
-  }
-
-  return {
-    label: 'Local Changes',
-    detail: 'Local files not restored',
-    tone: 'warn',
-    files: [],
-    hasLocalChanges: false,
-  }
-}
-
-export type IdentityDetailSection = {
-  title: string
-  rows: Array<{
-    label: string
-    value: string
-    tone: 'ok' | 'dim'
-  }>
-}
-
-export function identityDetailSections(
-  identity: EthagentIdentity | undefined,
-  config?: EthagentConfig,
-): IdentityDetailSection[] {
-  const backup = identity?.backup
-  const owner = identity?.ownerAddress ?? identity?.address
-  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 saved'
-  const agentCardCid = identity?.publicSkills?.agentCardCid ?? 'not saved'
-
-  return [
-    {
-      title: 'Agent',
-      rows: [
-        { label: 'token', value: identity?.agentId ? `#${identity.agentId}` : 'not created', tone: identity?.agentId ? 'ok' : 'dim' },
-        { label: 'network', value: chain.value, tone: chain.tone },
-        { label: 'registration', value: registrationCid, tone: identity?.metadataCid ? 'ok' : 'dim' },
-      ],
-    },
-    {
-      title: 'Owner',
-      rows: [
-        { label: 'wallet', value: owner ?? 'not connected', tone: owner ? 'ok' : 'dim' },
-      ],
-    },
-    {
-      title: 'Recovery',
-      rows: [
-        { label: 'state CID', value: stateCid, tone: backup?.cid ? 'ok' : 'dim' },
-        { label: 'skills CID', value: publicSkillsCid, tone: identity?.publicSkills?.cid ? 'ok' : 'dim' },
-        { label: 'agent card CID', value: agentCardCid, tone: identity?.publicSkills?.agentCardCid ? 'ok' : 'dim' },
-        { label: 'storage', value: backup?.ipfsApiUrl ? storageLabel(backup.ipfsApiUrl) : 'not saved yet', tone: backup?.ipfsApiUrl ? 'ok' : 'dim' },
-        { label: 'created', value: identity?.createdAt ? formatDate(identity.createdAt) : 'not created', tone: identity?.createdAt ? 'ok' : 'dim' },
-        { label: 'last backup', value: backup?.createdAt ? formatDate(backup.createdAt) : 'never', tone: backup?.createdAt ? 'ok' : 'dim' },
-        { label: 'status', value: backup?.status ?? 'unknown', tone: backup?.status ? 'ok' : 'dim' },
-      ],
-    },
-  ]
-}
-
-export type CopyableField = {
-  label: string
-  value: string
-}
-
-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 })
-  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 })
-  return fields
-}
-
-function formatDate(input: string): string {
-  const date = new Date(input)
-  if (Number.isNaN(date.getTime())) return input
-  return date.toISOString().slice(0, 10)
-}

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

@@ -1,156 +0,0 @@
-import React from 'react'
-import { Box, Text } from 'ink'
-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' | 'back'
-type PublicAction = 'edit' | 'skills' | 'back'
-
-type CommonProps = {
-  identity?: EthagentIdentity
-  config?: EthagentConfig
-  workingStatus?: ContinuityWorkingTreeStatus | null
-  ready: boolean
-  notice?: string
-  editorOpened?: boolean
-  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 & {
-  onOpenSoul: () => void
-  onOpenMemory: () => void
-}> = ({
-  identity,
-  config,
-  workingStatus,
-  ready,
-  notice,
-  editorOpened,
-  footer,
-  onOpenSoul,
-  onOpenMemory,
-  onBack,
-}) => (
-  <Surface title="Private Memory Files" subtitle={notice ?? privateSubtitle(ready)} footer={footer}>
-    <IdentitySummary identity={identity} config={config} workingStatus={workingStatus} compact />
-    <PrivateRows identity={identity} ready={ready} />
-    <SaveFromHubHint workingStatus={workingStatus} />
-    {editorOpened && (
-      <Box marginTop={1}>
-        <Text color={theme.accentPeach}>Save with ctrl+s in your editor</Text>
-      </Box>
-    )}
-    <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: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-          { 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()
-          return onBack()
-        }}
-        onCancel={onBack}
-      />
-    </Box>
-  </Surface>
-)
-
-export const PublicSkillsScreen: React.FC<CommonProps & {
-  onEditProfile: () => void
-  onOpenSkills: () => void
-}> = ({ identity, config, workingStatus, notice, editorOpened, 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} workingStatus={workingStatus} compact />
-    <PublicProfileRows identity={identity} />
-    <SaveFromHubHint workingStatus={workingStatus} />
-    {editorOpened && (
-      <Box marginTop={1}>
-        <Text color={theme.accentPeach}>Save with ctrl+s in your editor</Text>
-      </Box>
-    )}
-    <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: 'skills', role: 'section', prefix: '--', label: 'Capabilities' },
-          { 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' },
-        ]}
-        hintLayout="inline"
-        onSubmit={choice => {
-          if (choice === 'edit') return onEditProfile()
-          if (choice === 'skills') return onOpenSkills()
-          return onBack()
-        }}
-        onCancel={onBack}
-      />
-    </Box>
-  </Surface>
-)
-
-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>
-    <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>
-)
-
-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 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 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>
-  </Box>
-)
-
-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 Identity Hub menu to recover files.'
-}
-
-function readStateString(state: Record<string, unknown> | undefined, key: string): string {
-  const value = state?.[key]
-  return typeof value === 'string' ? value.trim() : ''
-}

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

@@ -1,146 +0,0 @@
-import React from 'react'
-import { Box, Text } from 'ink'
-import { Surface } from '../../../ui/Surface.js'
-import { Select } from '../../../ui/Select.js'
-import { TextInput } from '../../../ui/TextInput.js'
-import { theme } from '../../../ui/theme.js'
-import type { Step } from '../identityHubReducer.js'
-
-type EditProfileFlowProps = {
-  step: Extract<Step, { kind: 'edit-profile-name' | 'edit-profile-description' | 'edit-profile-image' }>
-  onNameSubmit: (name: string) => void
-  onDescriptionSubmit: (description: string) => void
-  onImageSubmit: (imagePath: string) => void
-  onImagePick: () => void
-  onBack: () => void
-  onMenu: () => void
-}
-
-const footerHint = (hint: string) => <Text color={theme.dim}>{hint}</Text>
-
-export const EditProfileFlow: React.FC<EditProfileFlowProps> = ({
-  step,
-  onNameSubmit,
-  onDescriptionSubmit,
-  onImageSubmit,
-  onImagePick,
-  onBack,
-  onMenu,
-}) => {
-  const [manualImagePath, setManualImagePath] = React.useState(false)
-
-  if (step.kind === 'edit-profile-name') {
-    const currentName = readStateString(step.identity.state, 'name')
-    return (
-      <Surface
-        title="Rename Agent Identity"
-        subtitle="This updates public token metadata and the Agent Card."
-        footer={footerHint('enter continues · esc back')}
-      >
-        <Text color={theme.dim}>Currently: {currentName || '(unnamed)'}</Text>
-        <TextInput
-          key="edit-profile-name"
-          initialValue={currentName}
-          placeholder="agent name"
-          validate={value => value.trim().length >= 2 ? null : 'name must be at least 2 characters'}
-          onSubmit={value => onNameSubmit(value.trim())}
-          onCancel={onMenu}
-        />
-      </Surface>
-    )
-  }
-
-  if (step.kind === 'edit-profile-image') {
-    const currentImage = readStateString(step.identity.state, 'imageUrl')
-    if (!manualImagePath) {
-      return (
-        <Surface
-          title="Upload Agent Image"
-          subtitle="Choose a local image. ethagent uploads it to IPFS and attaches it to token metadata."
-          footer={footerHint('enter select · esc back')}
-        >
-          <Box flexDirection="column">
-            <Text color={theme.dim}>Current: {currentImage || '(no image)'}</Text>
-            {step.error ? <Text color="#e87070">{step.error}</Text> : null}
-          </Box>
-          <Box marginTop={1}>
-            <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: 'Save without changing the image' },
-                { value: 'back', role: 'section', prefix: '--', label: 'Navigation' },
-                { value: 'back', label: 'Back', hint: 'Return to description', role: 'utility' },
-              ]}
-              hintLayout="inline"
-              onSubmit={choice => {
-                if (choice === 'choose') return onImagePick()
-                if (choice === 'manual') return setManualImagePath(true)
-                if (choice === 'delete') return onImageSubmit('delete')
-                if (choice === 'skip') return onImageSubmit('')
-                return onBack()
-              }}
-              onCancel={onBack}
-            />
-          </Box>
-        </Surface>
-      )
-    }
-    return (
-      <Surface
-        title="Enter Image Path"
-        subtitle="Fallback path entry. URLs are rejected because ethagent uploads the local file itself."
-        footer={footerHint('enter saves · esc back')}
-      >
-        <Text color={theme.dim}>Current: {currentImage || '(no image)'}</Text>
-        <TextInput
-          key="edit-profile-image"
-          placeholder="local image path"
-          allowEmpty
-          validate={value => validateImagePath(value)}
-          onSubmit={value => onImageSubmit(value.trim())}
-          onCancel={() => setManualImagePath(false)}
-        />
-      </Surface>
-    )
-  }
-
-  const currentDescription = readStateString(step.identity.state, 'description')
-  return (
-    <Surface
-      title="Describe Agent Identity"
-      subtitle="This updates public token metadata and the Agent Card."
-      footer={footerHint('enter continues · esc back')}
-    >
-      <Text color={theme.dim}>Currently: {currentDescription || '(no description)'}</Text>
-      <TextInput
-        key="edit-profile-description"
-        initialValue={currentDescription}
-        placeholder="description"
-        allowEmpty
-        multiline
-        onSubmit={value => onDescriptionSubmit(value.trim())}
-        onCancel={onBack}
-      />
-    </Surface>
-  )
-}
-
-function validateImagePath(value: string): string | null {
-  const trimmed = value.trim()
-  if (!trimmed) return null
-  if (/^https?:\/\//i.test(trimmed) || /^ipfs:\/\//i.test(trimmed)) {
-    return 'enter a local image file path; ethagent will upload it to IPFS'
-  }
-  if (!/\.(png|jpe?g|gif|webp|svg)$/i.test(trimmed)) {
-    return 'image must be png, jpg, gif, webp, or svg'
-  }
-  return null
-}
-
-function readStateString(state: Record<string, unknown> | undefined, key: string): string {
-  const value = state?.[key]
-  return typeof value === 'string' ? value : ''
-}