ethagent 1.1.1 → 2.0.0

package/src/identity/hub/IdentityHub.tsx

@@ -1,816 +1,14 @@
-import React, { useEffect, useReducer, useState } from 'react'
-import { Text } from 'ink'
-import { theme } from '../../ui/theme.js'
-import { type EthagentConfig, type EthagentIdentity, type SelectableNetwork } from '../../storage/config.js'
-import { clearIdentity, setTokenIdentity } from '../../storage/identity.js'
-import { copyToClipboard } from '../../utils/clipboard.js'
-import { catFromIpfs, DEFAULT_IPFS_API_URL } from '../storage/ipfs.js'
-import { openImageFilePicker } from '../profile/imagePicker.js'
-import { hasPinataJwt, clearPinataJwt, savePinataJwt } from '../storage/pinataJwt.js'
-import { registryConfigFromConfig } from '../registry/registryConfig.js'
-import { identityHubErrorView, isRegistrationPreflightError, pinataErrorText } from './identityHubModel.js'
-import { identityHubReducer, type ProfileUpdates, type Step } from './identityHubReducer.js'
-import {
-  runCreatePreflight,
-  runCreateSigning,
-  runRestoreConnectWallet,
-  runRestoreDiscover,
-  runRestoreTokenIdSubmit,
-  runRestoreFetch,
-  runRestoreAuthorize,
-  runRegistrySubmit,
-  runRestoreRegistrySubmit,
-  runStorageSubmit,
-  runRebackupPreflight,
-  runRebackupSigning,
-  runRebackupStorageSubmit,
-  runRecoveryRefetch,
-  isAgentTokenIdRequiredError,
-  type EffectCallbacks,
-  type RestoreProgress,
-} from './identityHubEffects.js'
-import {
-  continuityVaultRef,
-  continuityVaultStatus,
-  continuityWorkingTreeStatus,
-  ensurePublicSkillsFile,
-  type ContinuityWorkingTreeStatus,
-} from '../continuity/storage.js'
-import { openFileInEditor } from '../continuity/editor.js'
-import { listPublishedContinuitySnapshots } from '../continuity/snapshots.js'
-import type { BrowserWalletReady } from '../wallet/browserWallet.js'
-import { MenuScreen } from './screens/MenuScreen.js'
-import { CreateFlow } from './screens/CreateFlow.js'
-import { RestoreFlow } from './screens/RestoreFlow.js'
-import { NetworkScreen } from './screens/NetworkScreen.js'
-import { DetailsScreen } from './screens/DetailsScreen.js'
-import { ErrorScreen } from './screens/ErrorScreen.js'
-import { WalletApprovalScreen } from './screens/WalletApprovalScreen.js'
-import { RebackupStorageScreen } from './screens/RebackupStorageScreen.js'
-import { BusyScreen } from './screens/BusyScreen.js'
-import { EditProfileFlow } from './screens/EditProfileFlow.js'
-import { StorageCredentialScreen } from './screens/StorageCredentialScreen.js'
-import {
-  PrivateContinuityScreen,
-  PublicSkillsScreen,
-} from './screens/ContinuityDashboardScreen.js'
-import { RecoveryConfirmScreen } from './screens/RecoveryConfirmScreen.js'
-import { chainIdForNetwork, erc8004ConfigForSupportedChain, type Erc8004RegistryConfig } from '../registry/erc8004.js'
-
-const MIN_BUSY_ERROR_MS = 2000
-
-function isWalletCancelled(err: unknown): boolean {
-  if (!err) return false
-  const message = err instanceof Error ? err.message : String(err)
-  return /browser wallet request was cancelled/i.test(message)
-    || /user rejected/i.test(message)
-}
-
-function isStorageError(err: unknown): boolean {
-  const message = err instanceof Error ? err.message : String(err)
-  return /pinata|ipfs|pin|storage/i.test(message)
-}
-
-function waitForMinimumBusyTime(startedAt: number): Promise<void> {
-  const remaining = MIN_BUSY_ERROR_MS - (Date.now() - startedAt)
-  return remaining > 0
-    ? new Promise(resolve => setTimeout(resolve, remaining))
-    : Promise.resolve()
-}
-
-export type IdentityHubResult =
-  | { kind: 'token'; identity: EthagentIdentity }
-  | { kind: 'updated'; config: EthagentConfig; message: string }
-  | { kind: 'skip' }
-  | { kind: 'cancel' }
-
-type IdentityHubProps = {
-  mode: 'first-run' | 'manage'
-  config?: EthagentConfig
-  cwd?: string
-  initialAction?: IdentityHubInitialAction
-  onComplete: (result: IdentityHubResult) => void
-  onConfigChange?: (config: EthagentConfig) => void
-}
-
-export type IdentityHubInitialAction = 'create' | 'load' | 'settings' | 'save-snapshot'
-
-export const IdentityHub: React.FC<IdentityHubProps> = ({ mode, config, initialAction, onComplete, onConfigChange }) => {
-  const identity = config?.identity
-  const [step, dispatch] = useReducer(identityHubReducer, initialStepForAction(initialAction, config))
-  const [walletSession, setWalletSession] = useState<BrowserWalletReady | null>(null)
-  const [restoreProgress, setRestoreProgress] = useState<RestoreProgress | null>(null)
-  const [jwtSaved, setJwtSaved] = useState<boolean>(false)
-  const [copyNotice, setCopyNotice] = useState<string | null>(null)
-  const [continuityReady, setContinuityReady] = useState<boolean>(false)
-  const [workingStatus, setWorkingStatus] = useState<ContinuityWorkingTreeStatus | null>(null)
-  const canRebackup = Boolean(identity?.agentId && (identity?.identityRegistryAddress || config?.erc8004?.identityRegistryAddress))
-
-  const setStep = (s: Step) => dispatch({ type: 'preflightResolved', step: s })
-  const back = () => dispatch({ type: 'back', from: step })
-
-  useEffect(() => { setWalletSession(null) }, [step.kind])
-  useEffect(() => {
-    if (step.kind !== 'restore-authorizing') setRestoreProgress(null)
-  }, [step.kind])
-
-  useEffect(() => {
-    let cancelled = false
-    hasPinataJwt().then(v => { if (!cancelled) setJwtSaved(v) }).catch(() => {})
-    return () => { cancelled = true }
-  }, [step.kind])
-
-  useEffect(() => { setCopyNotice(null) }, [step.kind])
-
-  useEffect(() => {
-    let cancelled = false
-    if (!identity) {
-      setContinuityReady(false)
-      return
-    }
-    if (!step.kind.startsWith('continuity') && step.kind !== 'details' && step.kind !== 'menu') return
-    continuityVaultStatus(identity)
-      .then(status => { if (!cancelled) setContinuityReady(status.ready) })
-      .catch(() => { if (!cancelled) setContinuityReady(false) })
-    return () => { cancelled = true }
-  }, [identity, step.kind])
-
-  const completeTokenIdentity = async (nextIdentity: EthagentIdentity, message: string): Promise<void> => {
-    if (mode === 'first-run' || !config) {
-      onComplete({ kind: 'token', identity: nextIdentity })
-      return
-    }
-    const nextConfig = await setTokenIdentity(config, nextIdentity)
-    onComplete({ kind: 'updated', config: nextConfig, message })
-  }
-
-  const callbacks: EffectCallbacks = {
-    onStep: setStep,
-    onWalletReady: setWalletSession,
-    onIdentityComplete: completeTokenIdentity,
-    onRestoreProgress: setRestoreProgress,
-  }
-
-  const errorStep = (err: unknown, backStep: Step): void => {
-    setStep({ kind: 'error', error: identityHubErrorView(err), back: backStep })
-  }
-
-  const handleStepError = (err: unknown, backStep: Step, softCancel: Step = backStep): void => {
-    if (isWalletCancelled(err)) {
-      setStep(softCancel)
-      return
-    }
-    errorStep(err, backStep)
-  }
-
-  const resolveRegistryForIdentity = (target: EthagentIdentity): Erc8004RegistryConfig | null => {
-    const resolution = registryConfigFromConfig(config)
-    if (target.chainId && target.identityRegistryAddress) {
-      return {
-        chainId: target.chainId,
-        rpcUrl: target.rpcUrl ?? resolution.defaultRpcUrl,
-        identityRegistryAddress: target.identityRegistryAddress as `0x${string}`,
-      }
-    }
-    if (resolution.config) return resolution.config
-    return null
-  }
-
-  const triggerRebackup = (backStep: Step, profileUpdates?: ProfileUpdates): void => {
-    if (!identity) return
-    const registry = resolveRegistryForIdentity(identity)
-    if (!registry) {
-      errorStep(new Error('no agent registry configured for this identity'), backStep)
-      return
-    }
-    runRebackupPreflight(identity, registry, callbacks, profileUpdates, backStep)
-      .catch((err: unknown) => errorStep(err, backStep))
-  }
-
-
-
-  useEffect(() => {
-    if (step.kind !== 'rebackup-start') return
-    triggerRebackup(step.back)
-  }, [step])
-
-  useEffect(() => {
-    let cancelled = false
-    if (!identity) return
-    if (step.kind !== 'menu' && step.kind !== 'continuity-private' && step.kind !== 'continuity-public') return
-
-    const checkStatus = async () => {
-      try {
-        const [latest] = await listPublishedContinuitySnapshots(identity, 1)
-        const status = await continuityWorkingTreeStatus(identity, latest)
-        if (cancelled) return
-        setWorkingStatus(status)
-      } catch {
-        if (cancelled) return
-        setWorkingStatus(null)
-      }
-    }
-
-    void checkStatus()
-
-    return () => {
-      cancelled = true
-    }
-  }, [identity, step.kind])
-
-  useEffect(() => {
-    if (step.kind !== 'create-preflight') return
-    let cancelled = false
-    const startedAt = Date.now()
-    runCreatePreflight(step, config, callbacks)
-      .catch(async (err: unknown) => {
-        await waitForMinimumBusyTime(startedAt)
-        if (!cancelled) errorStep(err, { kind: 'create-network', name: step.name, description: step.description })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'create-signing') return
-    let cancelled = false
-    const backStep: Step = { kind: 'create-network', name: step.name, description: step.description }
-    runCreateSigning(step, callbacks)
-      .catch((err: unknown) => {
-        if (cancelled) return
-        if (isRegistrationPreflightError(err)) {
-          errorStep(err, backStep)
-          return
-        }
-        if (isStorageError(err)) {
-          setStep({
-            kind: 'create-storage',
-            name: step.name,
-            description: step.description,
-            registry: step.registry,
-            error: pinataErrorText(err),
-            pinataJwt: step.pinataJwt,
-          })
-          return
-        }
-        handleStepError(err, backStep)
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'restore-discovering') return
-    let cancelled = false
-    const startedAt = Date.now()
-    runRestoreDiscover(step, config, callbacks)
-      .catch(async (err: unknown) => {
-        await waitForMinimumBusyTime(startedAt)
-        if (cancelled) return
-        if (isAgentTokenIdRequiredError(err)) {
-          setStep({ kind: 'restore-token-id', ownerHandle: err.ownerAddress, registry: err.registry, error: err.message, purpose: step.purpose })
-          return
-        }
-        errorStep(err, { kind: 'restore-network', ownerHandle: step.ownerHandle, purpose: step.purpose })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'restore-wallet') return
-    let cancelled = false
-    runRestoreConnectWallet(step, callbacks)
-      .catch((err: unknown) => { if (!cancelled) handleStepError(err, { kind: 'restore-owner', purpose: step.purpose }) })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'restore-fetching') return
-    let cancelled = false
-    const startedAt = Date.now()
-    runRestoreFetch(step, callbacks)
-      .catch(async (err: unknown) => {
-        await waitForMinimumBusyTime(startedAt)
-        if (!cancelled) errorStep(err, { kind: 'restore-network', ownerHandle: step.candidate.ownerAddress, purpose: step.purpose })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'restore-authorizing') return
-    let cancelled = false
-    runRestoreAuthorize(step, callbacks)
-      .catch((err: unknown) => {
-        if (!cancelled) handleStepError(err, { kind: 'restore-network', ownerHandle: step.candidate.ownerAddress, purpose: step.purpose })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'rebackup-signing') return
-    let cancelled = false
-    runRebackupSigning(step, callbacks)
-      .catch((err: unknown) => {
-        if (cancelled) return
-        if (isStorageError(err)) {
-          setStep({
-            kind: 'rebackup-storage',
-            identity: step.identity,
-            registry: step.registry,
-            error: pinataErrorText(err),
-            pinataJwt: step.pinataJwt,
-            profileUpdates: step.profileUpdates,
-            returnTo: step.returnTo,
-          })
-          return
-        }
-        handleStepError(err, step.returnTo ?? { kind: 'menu' })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-  useEffect(() => {
-    if (step.kind !== 'public-profile-signing') return
-    let cancelled = false
-    runPublicProfileSigning(step, callbacks)
-      .catch((err: unknown) => {
-        if (cancelled) return
-        if (isStorageError(err)) {
-          setStep({
-            kind: 'public-profile-storage',
-            identity: step.identity,
-            registry: step.registry,
-            error: pinataErrorText(err),
-            pinataJwt: step.pinataJwt,
-            profileUpdates: step.profileUpdates,
-            returnTo: step.returnTo,
-          })
-          return
-        }
-        handleStepError(err, step.returnTo ?? { kind: 'continuity-public' })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-
-
-  useEffect(() => {
-    if (step.kind !== 'recovery-refetching') return
-    let cancelled = false
-    runRecoveryRefetch(step.identity, step.registry, callbacks)
-      .then(() => {
-        if (!cancelled) setContinuityReady(true)
-      })
-      .catch((err: unknown) => {
-        if (!cancelled) handleStepError(err, { kind: 'menu' })
-      })
-    return () => { cancelled = true }
-  }, [step])
-
-
-  const openContinuityFile = async (kind: 'soul' | 'memory' | 'skills'): Promise<void> => {
-    if (!identity) return
-    try {
-      if (kind === 'skills') {
-        await ensurePublicSkillsFile(identity, {
-          fallback: () => readPublishedPublicSkills(identity),
-        })
-      }
-      const ref = continuityVaultRef(identity)
-      const file = kind === 'soul' ? ref.soulPath : kind === 'memory' ? ref.memoryPath : ref.publicSkillsPath
-      const result = await openFileInEditor(file)
-      const message = result.ok
-        ? `opened ${kind === 'soul' ? 'SOUL.md' : kind === 'memory' ? 'MEMORY.md' : 'skills.json'} with ${result.method}.`
-        : `open failed: ${result.error}`
-      setStep(kind === 'skills'
-        ? { kind: 'continuity-public', notice: message }
-        : { kind: 'continuity-private', notice: message })
-    } catch (err: unknown) {
-      errorStep(err, kind === 'skills' ? { kind: 'continuity-public' } : { kind: 'continuity-private' })
-    }
-  }
-
-  const footer = <Text color={theme.dim}>enter select · esc back</Text>
-
-  if (step.kind === 'menu') {
-    return (
-      <MenuScreen
-        mode={mode}
-        config={config}
-        identity={identity}
-        workingStatus={workingStatus}
-        canRebackup={canRebackup}
-        footer={footer}
-        onCreate={() => {
-          if (identity) setStep({ kind: 'replace-confirm', next: 'create' })
-          else setStep({ kind: 'create-name' })
-        }}
-        onLoad={() => {
-          setCopyNotice(null)
-          setStep({ kind: 'restore-wallet', purpose: identity ? 'switch' : 'restore' })
-        }}
-        onBackupNow={() => setStep({ kind: 'rebackup-confirm', back: { kind: 'menu' } })}
-        onRefetchLatest={() => setStep({ kind: 'recovery-refetch-confirm', back: { kind: 'menu' } })}
-        onPublicProfile={() => setStep({ kind: 'continuity-public' })}
-        onPrivateMemory={() => setStep({ kind: 'continuity-private' })}
-        onCopyValues={() => setStep({ kind: 'details' })}
-        onStorageCredential={() => setStep({ kind: 'storage-credential' })}
-        onSkip={() => onComplete({ kind: 'skip' })}
-        onCancel={() => onComplete({ kind: 'cancel' })}
-      />
-    )
-  }
-
-  if (isCreateStep(step)) {
-    return (
-      <CreateFlow
-        step={step}
-        walletSession={walletSession}
-        onSetStep={setStep}
-        onNameSubmit={name => setStep({ kind: 'create-description', name })}
-        onDescriptionSubmit={(name, description) => setStep({ kind: 'create-network', name, description })}
-        onRegistrySubmit={async value => {
-          if (step.kind !== 'create-registry') return
-          try {
-            await runRegistrySubmit(value, step, config, onConfigChange, callbacks)
-          } catch (err: unknown) {
-            setStep({ kind: 'create-registry', name: step.name, description: step.description, resolution: step.resolution, error: (err as Error).message })
-          }
-        }}
-        onStorageSubmit={async input => {
-          if (step.kind !== 'create-storage') return
-          try {
-            await runStorageSubmit(input, step, callbacks)
-          } catch (err: unknown) {
-            setStep({
-              kind: 'create-storage',
-              name: step.name,
-              description: step.description,
-              registry: step.registry,
-              error: (err as Error).message,
-              pinataJwt: step.pinataJwt,
-            })
-          }
-        }}
-        onStorageError={error => {
-          if (step.kind !== 'create-storage') return
-          setStep({ ...step, error })
-        }}
-        onBack={back}
-        onMenu={() => setStep({ kind: 'menu' })}
-      />
-    )
-  }
-
-  if (step.kind === 'create-network') {
-    return (
-      <NetworkScreen
-        subtitle="Choose where to create this agent."
-        footer={footer}
-        onSelect={(network: SelectableNetwork) => {
-          setStep({ kind: 'create-preflight', name: step.name, description: step.description, network })
-        }}
-        onCancel={back}
-      />
-    )
-  }
-
-  if (step.kind === 'restore-network') {
-    return (
-      <NetworkScreen
-        subtitle="Choose a network to search for your agents."
-        footer={footer}
-        onSelect={(network: SelectableNetwork) => {
-          try {
-            const registry = erc8004ConfigForSupportedChain(chainIdForNetwork(network))
-            setStep({ kind: 'restore-discovering', ownerHandle: step.ownerHandle, registry, purpose: step.purpose })
-          } catch (err: unknown) {
-            errorStep(err, { kind: 'restore-network', ownerHandle: step.ownerHandle, purpose: step.purpose })
-          }
-        }}
-        onCancel={back}
-      />
-    )
-  }
-
-  if (isRestoreStep(step)) {
-    return (
-      <RestoreFlow
-        step={step}
-        config={config}
-        walletSession={walletSession}
-        restoreProgress={restoreProgress}
-        onConnectWallet={() => {
-          const purpose = step.kind === 'restore-owner' ? step.purpose : undefined
-          setStep({ kind: 'restore-wallet', purpose })
-        }}
-        onRestoreRegistrySubmit={async value => {
-          if (step.kind !== 'restore-registry') return
-          try {
-            await runRestoreRegistrySubmit(value, step, config, onConfigChange, callbacks)
-          } catch (err: unknown) {
-            setStep({ kind: 'restore-registry', ownerHandle: step.ownerHandle, error: (err as Error).message, purpose: step.purpose })
-          }
-        }}
-        onTokenIdSubmit={async value => {
-          if (step.kind !== 'restore-token-id') return
-          try {
-            await runRestoreTokenIdSubmit(value, step, callbacks)
-          } catch (err: unknown) {
-            setStep({ ...step, error: (err as Error).message })
-          }
-        }}
-        onTokenSelect={value => {
-          if (step.kind !== 'restore-select-token') return
-          const candidate = step.candidates.find(item => item.agentId.toString() === value)
-          if (!candidate?.backup?.cid) return
-          setStep({ kind: 'restore-fetching', cid: candidate.backup.cid, apiUrl: DEFAULT_IPFS_API_URL, candidate, purpose: step.purpose })
-        }}
-        onBack={back}
-      />
-    )
-  }
-
-  if (step.kind === 'details') {
-    return (
-      <DetailsScreen
-        identity={identity}
-        config={config}
-        copyNotice={copyNotice}
-        footer={footer}
-        onCopy={async (label, value) => {
-          const result = await copyToClipboard(value)
-          setCopyNotice(result.ok ? `copied ${label} via ${result.method}.` : `copy failed: ${result.error}`)
-          setStep({ kind: 'details' })
-        }}
-        onBack={back}
-      />
-    )
-  }
-
-  const openPublicProfileEdit = (backStep: Step): void => {
-    if (!identity) return
-    const registry = resolveRegistryForIdentity(identity)
-    if (!registry) {
-      errorStep(new Error('no agent registry configured for this identity'), backStep)
-      return
-    }
-    setStep({ kind: 'edit-profile-name', identity, registry, returnTo: backStep })
-  }
-
-  if (step.kind === 'rebackup-confirm') {
-    return (
-      <RecoveryConfirmScreen
-        mode="publish"
-        workingStatus={workingStatus}
-        footer={footer}
-        onConfirm={() => triggerRebackup(step.back)}
-        onBack={back}
-      />
-    )
-  }
-
-  if (step.kind === 'recovery-refetch-confirm') {
-    return (
-      <RecoveryConfirmScreen
-        mode="refetch"
-        workingStatus={workingStatus}
-        footer={footer}
-        onConfirm={() => {
-          if (!identity) return
-          const registry = resolveRegistryForIdentity(identity)
-          if (!registry) {
-            errorStep(new Error('no agent registry configured for this identity'), step.back)
-            return
-          }
-          setStep({ kind: 'recovery-refetching', identity, registry, back: step.back })
-        }}
-        onBack={back}
-      />
-    )
-  }
-
-  if (step.kind === 'recovery-refetching') {
-    return (
-      <WalletApprovalScreen
-        title="Refetch Latest Snapshot"
-        subtitle="Wallet approval decrypts the latest saved snapshot and overwrites local SOUL.md, MEMORY.md, and skills.json."
-        walletSession={walletSession}
-        label={restoreProgress?.label ?? 'fetching latest snapshot from chain...'}
-        onCancel={() => setStep(step.back)}
-      />
-    )
-  }
-
-  if (step.kind === 'continuity-private') {
-    return (
-      <PrivateContinuityScreen
-        identity={identity}
-        config={config}
-        workingStatus={workingStatus}
-        ready={continuityReady}
-        notice={step.notice}
-        footer={footer}
-        onOpenSoul={() => { void openContinuityFile('soul') }}
-        onOpenMemory={() => { void openContinuityFile('memory') }}
-        onBack={back}
-      />
-    )
-  }
-
-  if (step.kind === 'continuity-public') {
-    return (
-      <PublicSkillsScreen
-        identity={identity}
-        config={config}
-        workingStatus={workingStatus}
-        ready={continuityReady}
-        notice={step.notice}
-        footer={footer}
-        onEditProfile={() => openPublicProfileEdit({ kind: 'continuity-public' })}
-        onOpenSkills={() => { void openContinuityFile('skills') }}
-        onBack={back}
-      />
-    )
-  }
-
-  if (step.kind === 'storage-credential' || step.kind === 'storage-credential-input' || step.kind === 'storage-credential-forget-confirm') {
-    return (
-      <StorageCredentialScreen
-        step={step}
-        hasCredential={jwtSaved}
-        footer={footer}
-        onEdit={() => setStep({ kind: 'storage-credential-input' })}
-        onForget={() => setStep({ kind: 'storage-credential-forget-confirm' })}
-        onConfirmForget={async () => {
-          await clearPinataJwt().catch(() => {})
-          setJwtSaved(false)
-          setCopyNotice('IPFS storage credential removed.')
-          setStep({ kind: 'menu' })
-        }}
-        onSubmit={async input => {
-          try {
-            await savePinataJwt(input)
-            setJwtSaved(true)
-            setCopyNotice('IPFS storage credential saved.')
-            setStep({ kind: 'menu' })
-          } catch (err: unknown) {
-            setStep({ kind: 'storage-credential-input', error: (err as Error).message })
-          }
-        }}
-        onCancel={back}
-      />
-    )
-  }
-
-  if (step.kind === 'edit-profile-name' || step.kind === 'edit-profile-description' || step.kind === 'edit-profile-image') {
-    return (
-      <EditProfileFlow
-        step={step}
-        onNameSubmit={name => {
-          if (step.kind !== 'edit-profile-name') return
-          setStep({ kind: 'edit-profile-description', identity: step.identity, registry: step.registry, name, returnTo: step.returnTo })
-        }}
-        onDescriptionSubmit={description => {
-          if (step.kind !== 'edit-profile-description') return
-          setStep({ kind: 'edit-profile-image', identity: step.identity, registry: step.registry, name: step.name, description, returnTo: step.returnTo })
-        }}
-        onImageSubmit={imagePath => {
-          if (step.kind !== 'edit-profile-image') return
-          const updates: ProfileUpdates = { name: step.name, description: step.description, ...(imagePath ? { imagePath } : {}) }
-          triggerRebackup(step.returnTo ?? { kind: 'continuity-public' }, updates)
-        }}
-        onImagePick={() => {
-          if (step.kind !== 'edit-profile-image') return
-          const imageStep = step
-          void openImageFilePicker()
-            .then(result => {
-              if (!result.ok) {
-                setStep({ ...imageStep, error: result.cancelled ? 'image selection cancelled.' : `${result.error}. enter a path manually if needed.` })
-                return
-              }
-              const updates: ProfileUpdates = { name: imageStep.name, description: imageStep.description, imagePath: result.file }
-              triggerRebackup(imageStep.returnTo ?? { kind: 'continuity-public' }, updates)
-            })
-            .catch((err: unknown) => {
-              setStep({ ...imageStep, error: `${(err as Error).message}. enter a path manually if needed.` })
-            })
-        }}
-        onBack={back}
-        onMenu={() => setStep(step.returnTo ?? { kind: 'continuity-public' })}
-      />
-    )
-  }
-
-  if (step.kind === 'rebackup-signing') {
-    return (
-      <WalletApprovalScreen
-        title="Approve Encrypted Snapshot"
-        subtitle="Signs, encrypts private SOUL.md and MEMORY.md, pins them, and refreshes recovery metadata."
-        walletSession={walletSession}
-        label="waiting for wallet approval..."
-        onCancel={() => setStep(step.returnTo ?? { kind: 'menu' })}
-      />
-    )
-  }
-
-
-
-  if (step.kind === 'rebackup-start') {
-    return (
-      <BusyScreen
-        title="Identity Hub"
-        label="preparing encrypted snapshot..."
-        onCancel={back}
-      />
-    )
-  }
-
-
-
-
-  if (step.kind === 'rebackup-storage') {
-    return (
-      <RebackupStorageScreen
-        step={step}
-        footer={footer}
-        onSubmit={async input => {
-          try {
-            await runRebackupStorageSubmit(input, step, callbacks)
-          } catch (err: unknown) {
-            setStep({ ...step, error: (err as Error).message })
-          }
-        }}
-        onCancel={back}
-      />
-    )
-  }
-
-  if (step.kind === 'restore-wallet') {
-    return (
-      <WalletApprovalScreen
-        title="Connect Wallet"
-        subtitle="Select the wallet that owns the agent you want to load."
-        walletSession={walletSession}
-        label="waiting for wallet..."
-        onCancel={back}
-      />
-    )
-  }
-
-  if (step.kind === 'busy') {
-    return (
-      <BusyScreen
-        title="Identity Hub"
-        label={step.label}
-        onCancel={back}
-      />
-    )
-  }
-
-  if (step.kind === 'error') {
-    return (
-      <ErrorScreen
-        error={step.error}
-        back={step.back}
-        footer={footer}
-        onBack={backStep => setStep(backStep)}
-        onClose={() => onComplete({ kind: 'cancel' })}
-      />
-    )
-  }
-
-  return null
-}
-
-async function readPublishedPublicSkills(identity: EthagentIdentity): Promise<string> {
-  const cid = identity.publicSkills?.cid
-  if (!cid) throw new Error('no saved public skills CID')
-  return new TextDecoder().decode(await catFromIpfs(
-    identity.backup?.ipfsApiUrl ?? DEFAULT_IPFS_API_URL,
-    cid,
-  ))
-}
-
-function isCreateStep(step: Step): step is Extract<Step, { kind: 'replace-confirm' | 'create-name' | 'create-description' | 'create-preflight' | 'create-registry' | 'create-signing' | 'create-storage' }> {
-  return step.kind === 'replace-confirm'
-    || step.kind === 'create-name'
-    || step.kind === 'create-description'
-    || step.kind === 'create-preflight'
-    || step.kind === 'create-registry'
-    || step.kind === 'create-signing'
-    || step.kind === 'create-storage'
-}
-
-function isRestoreStep(step: Step): step is Exclude<Extract<Step, { kind: `restore-${string}` }>, { kind: 'restore-wallet' | 'restore-network' }> {
-  return step.kind.startsWith('restore-') && step.kind !== 'restore-wallet' && step.kind !== 'restore-network'
-}
-
-function initialStepForAction(
-  action: IdentityHubInitialAction | undefined,
-  config: EthagentConfig | undefined,
-): Step {
-  if (action === 'create') return config?.identity ? { kind: 'replace-confirm', next: 'create' } : { kind: 'create-name' }
-  if (action === 'load') return { kind: 'restore-wallet', purpose: config?.identity ? 'switch' : 'restore' }
-  if (action === 'save-snapshot') return config?.identity ? { kind: 'rebackup-start', back: { kind: 'menu' } } : { kind: 'menu' }
-  if (action === 'settings') return { kind: 'menu' }
-  return { kind: 'menu' }
+import React from 'react'
+import { IdentityHubRoutes } from './Routes.js'
+import type { IdentityHubProps } from './types.js'
+import { useIdentityHubController } from './useIdentityHubController.js'
+
+export type {
+  IdentityHubInitialAction,
+  IdentityHubResult,
+} from './types.js'
+
+export const IdentityHub: React.FC<IdentityHubProps> = props => {
+  const controller = useIdentityHubController(props)
+  return <IdentityHubRoutes controller={controller} />
 }