ethagent 0.2.1 → 1.0.0

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

@@ -0,0 +1,50 @@
+import React from 'react'
+import { Text } from 'ink'
+import { Surface } from '../../../ui/Surface.js'
+import { TextInput } from '../../../ui/TextInput.js'
+import { theme } from '../../../ui/theme.js'
+import { extractPinataJwt } from '../../storage/ipfs.js'
+import type { Step } from '../identityHubReducer.js'
+
+const PINATA_API_KEYS_URL = 'https://app.pinata.cloud/developers/api-keys'
+
+type RebackupStorageScreenProps = {
+  step: Extract<Step, { kind: 'rebackup-storage' | 'public-profile-storage' }>
+  footer: React.ReactNode
+  onSubmit: (input: string) => void
+  onCancel: () => void
+}
+
+export const RebackupStorageScreen: React.FC<RebackupStorageScreenProps> = ({ step, footer, onSubmit, onCancel }) => {
+  const publicOnly = step.kind === 'public-profile-storage'
+  return (
+    <Surface
+      title="Connect IPFS Storage"
+      subtitle={step.error ?? (publicOnly
+        ? 'Save a Pinata JWT so ethagent can pin public profile metadata to IPFS.'
+        : 'Save a Pinata JWT so ethagent can pin encrypted state to IPFS.')}
+      footer={footer}
+    >
+    <Text>
+      <Text color={theme.dim}>Paste your Pinata JWT. Get one at </Text>
+      <Text color={theme.accentPrimary} underline>{PINATA_API_KEYS_URL}</Text>
+    </Text>
+    <Text color={theme.dim}>Saved encrypted on this device · used only for IPFS pinning</Text>
+    <TextInput
+      key="rebackup-storage"
+      isSecret
+      placeholder="Pinata JWT"
+      validate={v => {
+        try {
+          extractPinataJwt(v)
+          return null
+        } catch (err: unknown) {
+          return (err as Error).message
+        }
+      }}
+      onSubmit={onSubmit}
+      onCancel={onCancel}
+    />
+    </Surface>
+  )
+}

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

@@ -0,0 +1,85 @@
+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 { ContinuityWorkingTreeStatus } from '../../continuity/storage.js'
+
+export type RecoveryConfirmMode = 'publish' | 'refetch'
+
+type RecoveryConfirmScreenProps = {
+  mode: RecoveryConfirmMode
+  workingStatus?: ContinuityWorkingTreeStatus | null
+  footer: React.ReactNode
+  onConfirm: () => void
+  onBack: () => void
+}
+
+export const RecoveryConfirmScreen: React.FC<RecoveryConfirmScreenProps> = ({ mode, workingStatus, footer, onConfirm, onBack }) => {
+  const isPublish = mode === 'publish'
+  const title = isPublish ? 'Publish Snapshot?' : 'Refetch Latest From Chain?'
+  const subtitle = isPublish
+    ? 'This replaces the current on-chain snapshot pointer.'
+    : 'This overwrites local files with the on-chain version.'
+
+  const headlineColor = isPublish ? theme.accentPeach : theme.accentMint
+  const headline = isPublish
+    ? 'Publishing replaces 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 published state.'
+    : 'Unsaved local edits will be lost. Use this when local files are missing or out of sync with the latest published snapshot.'
+
+  const needsBackup = workingStatus?.publishState === 'local-changes' || workingStatus?.publishState === 'not-published' || workingStatus?.publishState === 'verify-needed'
+  let changedFiles: string[] = []
+  if (isPublish && needsBackup) {
+    if (workingStatus?.localContentHashes && workingStatus?.publishedContentHashes) {
+      if (workingStatus.localContentHashes['SOUL.md'] !== workingStatus.publishedContentHashes['SOUL.md']) changedFiles.push('SOUL.md')
+      if (workingStatus.localContentHashes['MEMORY.md'] !== workingStatus.publishedContentHashes['MEMORY.md']) changedFiles.push('MEMORY.md')
+      if (workingStatus.localContentHashes['skills.json'] !== workingStatus.publishedContentHashes['skills.json']) changedFiles.push('skills.json')
+    } else {
+      changedFiles = ['SOUL.md', 'MEMORY.md', 'skills.json']
+    }
+  }
+
+  return (
+    <Surface title={title} subtitle={subtitle} footer={footer} tone="primary">
+      <Box flexDirection="column">
+        <Text color={headlineColor}>{headline}</Text>
+        <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>
+          </Box>
+        )}
+      </Box>
+      <Box marginTop={1}>
+        <Select<'confirm' | 'back'>
+          options={[
+            { value: 'confirm', role: 'section', prefix: '--', label: isPublish ? 'Publish' : 'Refetch' },
+            {
+              value: 'confirm',
+              label: isPublish ? 'Yes, Publish Snapshot Now' : 'Yes, Refetch From Chain',
+              hint: isPublish ? 'Sign and overwrite the on-chain pointer' : 'Wallet decrypts and overwrites local files',
+            },
+            { value: 'back', role: 'section', prefix: '--', label: 'Cancel' },
+            {
+              value: 'back',
+              label: 'No, Go Back',
+              hint: isPublish ? 'Return without saving anything' : 'Return without changing anything',
+              role: 'utility',
+            },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'confirm') return onConfirm()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}

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

@@ -0,0 +1,206 @@
+import React from 'react'
+import { 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 { normalizeErc8004RegistryConfig } from '../../registry/erc8004.js'
+import {
+  isCurrentAgentCandidate,
+  networkLabel,
+  tokenCandidateHint,
+  tokenCandidateSelectLabel,
+} from '../identityHubModel.js'
+import { registryConfigFromConfig } from '../../registry/registryConfig.js'
+import type { Step } from '../identityHubReducer.js'
+import { WalletApprovalScreen } from './WalletApprovalScreen.js'
+import { BusyScreen } from './BusyScreen.js'
+import type { BrowserWalletReady } from '../../wallet/browserWallet.js'
+import type { EthagentConfig } from '../../../storage/config.js'
+import type { RestoreProgress } from '../identityHubEffects.js'
+
+type RestoreStep = Exclude<Extract<Step, { kind: `restore-${string}` }>, { kind: 'restore-wallet' | 'restore-network' }>
+
+type RestoreFlowProps = {
+  step: RestoreStep
+  config?: EthagentConfig
+  walletSession: BrowserWalletReady | null
+  restoreProgress: RestoreProgress | null
+  onConnectWallet: () => void
+  onRestoreRegistrySubmit: (value: string) => void
+  onTokenIdSubmit: (value: string) => void
+  onTokenSelect: (tokenId: string) => void
+  onBack: () => void
+}
+
+const footerHint = (hint: string) => <Text color={theme.dim}>{hint}</Text>
+
+export const RestoreFlow: React.FC<RestoreFlowProps> = ({
+  step,
+  config,
+  walletSession,
+  restoreProgress,
+  onConnectWallet,
+  onRestoreRegistrySubmit,
+  onTokenIdSubmit,
+  onTokenSelect,
+  onBack,
+}) => {
+  const purpose = 'purpose' in step ? step.purpose ?? 'restore' : 'restore'
+  const isSwitch = purpose === 'switch'
+
+  if (step.kind === 'restore-owner') {
+    return (
+      <Surface
+        title={isSwitch ? 'Switch Agent Identity' : 'Restore an Agent'}
+        subtitle="Connect the wallet that owns the agent you want to load."
+        footer={footerHint('enter select · esc back')}
+      >
+        <Select<'connect'>
+          options={[
+            { value: 'connect', role: 'section', prefix: '--', label: 'Wallet' },
+            { value: 'connect', label: 'connect wallet', hint: 'search tokens owned by browser wallet' },
+          ]}
+          hintLayout="inline"
+          onSubmit={onConnectWallet}
+          onCancel={onBack}
+        />
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'restore-registry') {
+    const resolution = registryConfigFromConfig(config)
+    return (
+      <Surface
+        title={`${resolution.network ? networkLabel(resolution.network).charAt(0).toUpperCase() + networkLabel(resolution.network).slice(1) : ''} Agent Registry`}
+        subtitle={step.error ? `Lookup failed: ${step.error}` : 'Paste the agent registry address for this network.'}
+        footer={footerHint('enter discover · esc back')}
+      >
+        <Text color={theme.dim}>RPC defaults to {resolution.defaultRpcUrl}</Text>
+        <TextInput
+          initialValue={config?.erc8004?.identityRegistryAddress ?? ''}
+          placeholder="0x registry address"
+          validate={value => {
+            try {
+              normalizeErc8004RegistryConfig({
+                chainId: resolution.chainId,
+                rpcUrl: resolution.config?.rpcUrl ?? resolution.defaultRpcUrl,
+                identityRegistryAddress: value.trim(),
+              })
+              return null
+            } catch (err: unknown) {
+              return (err as Error).message
+            }
+          }}
+          onSubmit={onRestoreRegistrySubmit}
+          onCancel={onBack}
+        />
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'restore-discovering') {
+    return (
+      <BusyScreen
+        title={isSwitch ? 'Finding Agent Identities' : 'Finding Agents'}
+        subtitle={step.ownerHandle}
+        label="searching this network..."
+        onCancel={onBack}
+      />
+    )
+  }
+
+  if (step.kind === 'restore-token-id') {
+    return (
+      <Surface
+        title="Enter Agent Token ID"
+        subtitle={step.error ?? `${networkLabelForRegistry(step.registry)} lookup needs the token ID.`}
+        footer={footerHint('enter continue · esc back')}
+      >
+        <TextInput
+          placeholder="#45744"
+          validate={value => parseTokenIdInput(value) ? null : 'enter a token id'}
+          onSubmit={value => onTokenIdSubmit(value.trim())}
+          onCancel={onBack}
+        />
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'restore-select-token') {
+    return (
+      <Surface
+        title={isSwitch ? 'Switch to an Agent' : 'Choose Your Agent'}
+        subtitle={step.ownerHandle}
+        footer={footerHint('enter select · esc back')}
+      >
+        <Select<string>
+          options={[
+            { value: 'section:owned-agents', role: 'section', prefix: '--', label: 'Owned agents' },
+            ...step.candidates.map(candidate => {
+              const current = isSwitch && isCurrentAgentCandidate(config?.identity, candidate)
+              return {
+                value: candidate.agentId.toString(),
+                label: tokenCandidateSelectLabel(candidate, current),
+                hint: tokenCandidateHint(candidate),
+              }
+            }),
+          ]}
+          hintLayout="inline"
+          onSubmit={onTokenSelect}
+          onCancel={onBack}
+        />
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'restore-fetching') {
+    return (
+      <BusyScreen
+        title={isSwitch ? 'Switching Agent Identity' : 'Restoring Your Agent'}
+        subtitle="IPFS"
+        label="opening encrypted state from IPFS..."
+        onCancel={onBack}
+      />
+    )
+  }
+
+  if (step.kind === 'restore-authorizing') {
+    if (restoreProgress) {
+      return (
+        <BusyScreen
+          title={isSwitch ? 'Switching Agent Identity' : 'Restoring Your Agent'}
+          subtitle="Wallet Signature Received"
+          label={restoreProgress.label}
+        />
+      )
+    }
+    return (
+      <WalletApprovalScreen
+        title={isSwitch ? 'Approve Switch' : 'Approve Restore'}
+        subtitle={isSwitch ? 'Use the wallet that owns this agent to switch.' : 'Use the wallet that owns this agent.'}
+        walletSession={walletSession}
+        label="waiting for approval..."
+        onCancel={onBack}
+      />
+    )
+  }
+
+  return null
+}
+
+function parseTokenIdInput(value: string): string | null {
+  const normalized = value.trim().replace(/^#/, '')
+  return /^\d+$/.test(normalized) ? normalized : null
+}
+
+function networkLabelForRegistry(registry: { chainId: number }): string {
+  const network = registry.chainId === 1 ? 'mainnet'
+    : registry.chainId === 42161 ? 'arbitrum'
+      : registry.chainId === 8453 ? 'base'
+        : registry.chainId === 10 ? 'optimism'
+          : registry.chainId === 137 ? 'polygon'
+            : undefined
+  return network ? networkLabel(network) : `chain ${registry.chainId}`
+}

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

@@ -0,0 +1,128 @@
+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 { extractPinataJwt } from '../../storage/ipfs.js'
+import type { Step } from '../identityHubReducer.js'
+
+const PINATA_API_KEYS_URL = 'https://app.pinata.cloud/developers/api-keys'
+
+type StorageCredentialAction = 'edit' | 'forget' | 'back'
+
+export const STORAGE_CREDENTIAL_FORGET_COPY = [
+  'removes the saved IPFS storage token from this machine.',
+  'existing pinned IPFS backups are not deleted.',
+  'ethagent cannot pin new encrypted state with that account until you save a token again.',
+  'agent identity and sessions stay on this machine.',
+] as const
+
+type StorageCredentialScreenProps = {
+  step: Extract<Step, { kind: 'storage-credential' | 'storage-credential-input' | 'storage-credential-forget-confirm' }>
+  hasCredential: boolean
+  footer: React.ReactNode
+  onEdit: () => void
+  onForget: () => void
+  onConfirmForget: () => void
+  onSubmit: (input: string) => void
+  onCancel: () => void
+}
+
+export const StorageCredentialScreen: React.FC<StorageCredentialScreenProps> = ({
+  step,
+  hasCredential,
+  footer,
+  onEdit,
+  onForget,
+  onConfirmForget,
+  onSubmit,
+  onCancel,
+}) => {
+  if (step.kind === 'storage-credential-input') {
+    return (
+      <Surface
+        title="IPFS Storage Credential"
+        subtitle={step.error ?? 'Save the token ethagent uses to pin encrypted state.'}
+        footer={footer}
+      >
+        <Text>
+          <Text color={theme.dim}>Paste your Pinata JWT. Get one at </Text>
+          <Text color={theme.accentPrimary} underline>{PINATA_API_KEYS_URL}</Text>
+        </Text>
+        <Text color={theme.dim}>Stored encrypted on this device. Used only for IPFS pinning.</Text>
+        <TextInput
+          key="storage-credential-input"
+          isSecret
+          placeholder="Pinata JWT"
+          validate={v => {
+            try {
+              extractPinataJwt(v)
+              return null
+            } catch (err: unknown) {
+              return (err as Error).message
+            }
+          }}
+          onSubmit={onSubmit}
+          onCancel={onCancel}
+        />
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'storage-credential-forget-confirm') {
+    return (
+      <Surface
+        title="Forget IPFS Storage Credential?"
+        subtitle="This only removes the local token used for pinning."
+        footer={footer}
+      >
+        <Box flexDirection="column">
+          {STORAGE_CREDENTIAL_FORGET_COPY.map(line => (
+            <Text key={line} color={theme.dim}>- {line}</Text>
+          ))}
+        </Box>
+        <Box marginTop={1}>
+          <Select<StorageCredentialAction>
+            options={[
+              { value: 'forget', role: 'section', prefix: '--', label: 'Credential' },
+              { 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' },
+            ]}
+            hintLayout="inline"
+            onSubmit={choice => choice === 'forget' ? onConfirmForget() : onCancel()}
+            onCancel={onCancel}
+          />
+        </Box>
+      </Surface>
+    )
+  }
+
+  return (
+    <Surface
+      title="IPFS Storage Credential"
+      subtitle="Controls whether ethagent can pin encrypted state from this machine."
+      footer={footer}
+    >
+      <Box marginTop={1}>
+        <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: 'back', role: 'section', prefix: '--', label: 'Navigation' },
+            { value: 'back', label: 'back to identity hub', hint: 'return without changing storage access', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'edit') return onEdit()
+            if (choice === 'forget') return onForget()
+            return onCancel()
+          }}
+          onCancel={onCancel}
+        />
+      </Box>
+    </Surface>
+  )
+}

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

@@ -0,0 +1,43 @@
+import React from 'react'
+import { Box, Text } from 'ink'
+import { exec } from 'node:child_process'
+import { Surface } from '../../../ui/Surface.js'
+import { Spinner } from '../../../ui/Spinner.js'
+import { theme } from '../../../ui/theme.js'
+import { useAppInput } from '../../../app/input/AppInputProvider.js'
+import type { BrowserWalletReady } from '../../wallet/browserWallet.js'
+
+type WalletApprovalScreenProps = {
+  title: string
+  subtitle: string
+  walletSession: BrowserWalletReady | null
+  label: string
+  onCancel?: () => void
+}
+
+export const WalletApprovalScreen: React.FC<WalletApprovalScreenProps> = ({ title, subtitle, walletSession, label, onCancel }) => {
+  useAppInput((_input, key) => {
+    if (key.escape && onCancel) onCancel()
+    if (key.return && walletSession?.url) {
+      const command = process.platform === 'win32' ? 'start ""' : process.platform === 'darwin' ? 'open' : 'xdg-open'
+      exec(`${command} "${walletSession.url}"`).on('error', () => {})
+    }
+  }, { isActive: Boolean(onCancel) || Boolean(walletSession) })
+  const footer = onCancel ? <Text color={theme.dim}>esc cancels</Text> : undefined
+  return (
+    <Surface title={title} subtitle={subtitle} footer={footer}>
+      {walletSession ? (
+        <Box flexDirection="column">
+          <Text color={theme.dim}>open this approval page</Text>
+          <Text color={theme.accentPrimary}>{walletSession.url}</Text>
+          <Text color={theme.dim}>press enter to open in browser...</Text>
+          <Box marginTop={1}>
+            <Spinner label={label} />
+          </Box>
+        </Box>
+      ) : (
+        <Spinner label="preparing wallet approval..." />
+      )}
+    </Surface>
+  )
+}