ethagent 1.1.2 → 2.0.0

package/src/identity/hub/flows/ens/ensEditCopy.ts

@@ -0,0 +1,117 @@
+import { getAddress, type Address } from 'viem'
+import type { AgentEnsRecords, AgentRecordDiff } from '../../../ens/agentRecords.js'
+import type { EnsRegistryAction, EnsSetupBlockedPlan } from '../../../ens/ensAutomation.js'
+import type { CustodyMode } from '../../model/custody.js'
+
+export type EnsLinkOptions = {
+  mode: 'simple' | 'advanced'
+  ownerAddress?: Address
+  operatorWallet?: Address
+}
+
+export function recordsDiffHasChanges(recordsDiff: AgentRecordDiff[]): boolean {
+  return recordsDiff.some(diff => diff.changed)
+}
+
+export function recordsHaveCurrentValues(recordsDiff: AgentRecordDiff[]): boolean {
+  return recordsDiff.some(diff => diff.current.trim())
+}
+
+export function emptyAgentEnsRecords(): AgentEnsRecords {
+  return { token: '', profile: '' }
+}
+
+export function unlinkEnsLinkOptions(savedCustodyMode: CustodyMode | undefined, savedOwnerAddress: string): EnsLinkOptions {
+  if (savedCustodyMode === 'advanced' && /^0x[0-9a-fA-F]{40}$/.test(savedOwnerAddress)) {
+    return { mode: 'advanced', ownerAddress: getAddress(savedOwnerAddress as Address) }
+  }
+  return { mode: 'simple' }
+}
+
+export function discoveryErrorMessage(errors: string[]): string {
+  return errors.find(Boolean) ?? 'ENS lookup failed'
+}
+
+export function modeSwitchHeading(
+  currentEnsName: string,
+  currentMode: CustodyMode | undefined,
+  nextEnsName: string,
+  nextMode: 'simple' | 'advanced',
+): string {
+  if (!currentEnsName && !currentMode) return 'Automation'
+  const currentTopology = currentMode === 'advanced' ? 'advanced' : currentMode === 'simple' ? 'simple' : undefined
+  const modeChanged = currentTopology !== undefined && currentTopology !== nextMode
+  if (modeChanged) return 'Prepare ENS Setup Switch'
+  if (currentEnsName !== nextEnsName) return 'Prepare ENS Name Switch'
+  return 'Automation'
+}
+
+export function setupSwitchNotice(
+  currentEnsName: string,
+  currentMode: CustodyMode | undefined,
+  nextEnsName: string,
+  nextMode: 'simple' | 'advanced',
+): string | null {
+  if (!currentEnsName && !currentMode) return null
+  const currentTopology = currentMode === 'advanced' ? 'advanced' : currentMode === 'simple' ? 'simple' : undefined
+  if (currentEnsName === nextEnsName && currentTopology === nextMode) return null
+  return 'This replaces the saved ENS setup directly. Reset is only for clearing the current link.'
+}
+
+export function advancedSubdomainStatusText(action: EnsRegistryAction): string {
+  switch (action) {
+    case 'create-subdomain':
+    case 'create-wrapped-subdomain':
+      return 'Subdomain check: the owner wallet can create this agent ENS name during setup.'
+    case 'set-resolver':
+    case 'set-wrapped-resolver':
+      return 'Subdomain check: the owner wallet can prepare this ENS name during setup.'
+    case 'none':
+      return 'Subdomain check: this ENS name is ready.'
+  }
+}
+
+export function networkLabelForChainId(chainId: number): string {
+  switch (chainId) {
+    case 1: return 'Ethereum Mainnet'
+    case 8453: return 'Base'
+    default: return `Chain ${chainId}`
+  }
+}
+
+export function manualReasonTitle(reason: EnsSetupBlockedPlan['reason']): string {
+  switch (reason) {
+    case 'wrapped-parent':
+    case 'subdomain-wrapped':
+      return 'ENS NameWrapper ownership could not be verified'
+    case 'token-record-collision':
+      return 'Subdomain already points to another token'
+    case 'token-owner-mismatch':
+      return 'Owner wallet does not own this ERC-8004 token'
+    case 'token-owner-lookup-failed':
+      return 'Could not verify ERC-8004 token owner'
+    case 'parent-missing-resolver':
+      return 'Parent ENS name needs a resolver'
+    case 'subdomain-owned-by-other':
+      return 'Subdomain is managed by another wallet'
+    case 'operator-matches-owner':
+      return 'Operator wallet must be separate'
+    case 'root-not-owned':
+      return 'Parent ENS name is not manageable'
+    case 'root-owner-mismatch':
+      return 'Connected wallet does not manage the parent ENS name'
+    case 'invalid-root':
+    case 'invalid-label':
+    case 'missing-token-id':
+    case 'lookup-failed':
+      return 'ENS setup needs attention'
+  }
+}
+
+export function readValidationFromState(state: Record<string, unknown> | undefined): { ok: boolean; reason?: string } | null {
+  const raw = state?.ensValidation
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null
+  const obj = raw as Record<string, unknown>
+  if (typeof obj.ok !== 'boolean') return null
+  return { ok: obj.ok, ...(typeof obj.reason === 'string' ? { reason: obj.reason } : {}) }
+}

package/src/identity/hub/flows/ens/ensEditTypes.ts

@@ -0,0 +1,91 @@
+import type { Address } from 'viem'
+import type { EthagentIdentity } from '../../../../storage/config.js'
+import type {
+  AgentEnsRecordState,
+  AgentEnsRecords,
+  AgentRecordDiff,
+} from '../../../ens/agentRecords.js'
+import type { EnsValidation } from '../../../ens/ensLookup.js'
+import type {
+  EnsRegistryAction,
+  EnsSetupBlockedPlan,
+  EnsSetupPlan,
+  EnsSubdomainDeletePlan,
+} from '../../../ens/ensAutomation.js'
+import type { Erc8004RegistryConfig } from '../../../registry/erc8004.js'
+import type { EnsLinkOptions } from './ensEditCopy.js'
+
+export type EnsIssueValidation = Extract<EnsValidation, { ok: false }>
+
+export type RegisterCommitPhase = {
+  label: string
+  secret: `0x${string}`
+  price: { base: bigint; premium: bigint; total: bigint }
+}
+
+export type SimpleEnsPhase =
+  | { kind: 'discovering' }
+  | { kind: 'pick-parent' }
+  | { kind: 'manual-parent' }
+  | { kind: 'register-root-input'; error?: string }
+  | { kind: 'register-root-pricing'; label: string; secret: `0x${string}`; busy: boolean; error?: string; price?: { base: bigint; premium: bigint; total: bigint } }
+  | { kind: 'register-root-commit-tx'; label: string; secret: `0x${string}`; price: { base: bigint; premium: bigint; total: bigint } }
+  | { kind: 'register-root-wait'; label: string; secret: `0x${string}`; price: { base: bigint; premium: bigint; total: bigint }; commitMinedAt: number }
+  | { kind: 'register-root-tx'; label: string; secret: `0x${string}`; price: { base: bigint; premium: bigint; total: bigint } }
+  | { kind: 'register-root-done'; fullName: string }
+  | { kind: 'pick-subdomain'; parent: string; label?: string; error?: string }
+  | { kind: 'simple-name-missing'; fullName: string; validation: EnsIssueValidation }
+  | { kind: 'simple-create-preflight'; rootName: string; label: string; fullName: string }
+  | { kind: 'simple-create-review'; setup: EnsSetupPlan }
+  | { kind: 'simple-create-blocked'; fallback: EnsSetupBlockedPlan }
+  | { kind: 'validating'; fullName: string; mode: 'simple' | 'advanced'; ownerAddress?: Address; operatorWallet?: Address }
+  | { kind: 'review'; fullName: string; validation: EnsValidation; recordsDiff: AgentRecordDiff[]; currentRecords: AgentEnsRecordState; nextRecords: AgentEnsRecords; mode: 'simple' | 'advanced'; ownerAddress?: Address; operatorWallet?: Address }
+
+export type AdvancedEnsPhase =
+  | { kind: 'advanced-transfer-check' }
+  | { kind: 'advanced-root'; rootName?: string; error?: string }
+  | { kind: 'advanced-root-check'; rootName: string }
+  | { kind: 'advanced-subdomain'; rootName: string; label?: string; error?: string }
+  | { kind: 'advanced-subdomain-check'; rootName: string; label: string }
+  | { kind: 'advanced-operator-wallet'; rootName: string; label: string; registryAction?: EnsRegistryAction; error?: string }
+  | { kind: 'advanced-operator-wallet-manual'; rootName: string; label: string; error?: string }
+  | { kind: 'advanced-operator-wallet-connecting'; rootName: string; label: string }
+  | { kind: 'advanced-preflight'; rootName: string; label: string; operatorWallet: Address }
+  | { kind: 'advanced-review'; setup: EnsSetupPlan }
+  | { kind: 'advanced-manual'; fallback: EnsSetupBlockedPlan }
+
+export type UnlinkEnsPhase =
+  | { kind: 'unlink-loading'; fullName: string }
+  | { kind: 'unlink-review'; fullName: string; currentRecords: AgentEnsRecordState; recordsDiff: AgentRecordDiff[] }
+
+export type DeleteSubdomainPhase =
+  | { kind: 'delete-subdomain-preflight'; fullName: string }
+  | { kind: 'delete-subdomain-confirm'; plan: EnsSubdomainDeletePlan }
+  | { kind: 'delete-subdomain-blocked'; fullName: string; reason: string }
+  | { kind: 'delete-subdomain-tx'; plan: EnsSubdomainDeletePlan }
+  | { kind: 'delete-subdomain-done'; fullName: string }
+
+export type EnsPhase =
+  | { kind: 'mode-select' }
+  | SimpleEnsPhase
+  | AdvancedEnsPhase
+  | UnlinkEnsPhase
+  | DeleteSubdomainPhase
+
+export type DiscoveryState =
+  | { status: 'idle' }
+  | { status: 'loading' }
+  | { status: 'ok'; names: string[]; warning?: string }
+  | { status: 'error'; message: string; names: string[] }
+
+export type EnsEditProps = {
+  identity: EthagentIdentity
+  registry: Erc8004RegistryConfig
+  onEnsLink: (fullName: string, options: EnsLinkOptions) => void
+  onEnsUnlink: () => void
+  onEnsRecordsUpdate: (fullName: string, records: AgentEnsRecords, options: EnsLinkOptions, clearRecords?: boolean, currentRecords?: AgentEnsRecordState) => void
+  onEnsSetup: (setup: EnsSetupPlan) => void
+  onManageOperatorWalletAccess: () => void
+  initialView?: 'advanced'
+  onBack: () => void
+}

package/src/identity/hub/flows/profile/EditProfileFlow.tsx

@@ -0,0 +1,271 @@
+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 { AgentEnsRecordState, AgentEnsRecords } from '../../../ens/agentRecords.js'
+import type { EnsSetupPlan } from '../../../ens/ensAutomation.js'
+import type { Step } from '../../identityHubReducer.js'
+import { readIdentityStateString } from '../../model/custody.js'
+import { FlowTimeline } from '../../components/FlowTimeline.js'
+import { validateAgentIconReference } from '../../../profile/agentIcon.js'
+import { EnsEditFlow, type EnsLinkOptions } from '../ens/EnsEditFlow.js'
+
+type EditProfileFlowProps = {
+  step: Extract<Step, { kind: 'edit-profile-name' | 'edit-profile-description' | 'edit-profile-image' | 'edit-profile-review' | 'edit-profile-ens' }>
+  onNameSubmit: (name: string) => void
+  onDescriptionSubmit: (description: string) => void
+  onIconSubmit: (iconPath?: string) => void
+  onIconPick: () => void
+  onReviewSave: () => void
+  onEnsLink: (fullName: string, options: EnsLinkOptions) => void
+  onEnsUnlink: () => void
+  onEnsRecordsUpdate: (fullName: string, records: AgentEnsRecords, options: EnsLinkOptions, clearRecords?: boolean, currentRecords?: AgentEnsRecordState) => void
+  onEnsSetup: (setup: EnsSetupPlan) => void
+  onManageOperatorWalletAccess: () => void
+  onBack: () => void
+  onMenu: () => void
+}
+
+const footerHint = (hint: string) => <Text color={theme.dim}>{hint}</Text>
+export const EDIT_PROFILE_STEPS = ['Name', 'Description', 'Icon', 'Review', 'Save']
+const EDIT_NEXT_FOOTER = 'enter next · esc back'
+const EDIT_DESCRIPTION_FOOTER = 'enter next · shift+enter newline · esc back'
+
+export const EditProfileFlow: React.FC<EditProfileFlowProps> = ({
+  step,
+  onNameSubmit,
+  onDescriptionSubmit,
+  onIconSubmit,
+  onIconPick,
+  onReviewSave,
+  onEnsLink,
+  onEnsUnlink,
+  onEnsRecordsUpdate,
+  onEnsSetup,
+  onManageOperatorWalletAccess,
+  onBack,
+  onMenu,
+}) => {
+  if (step.kind === 'edit-profile-name') {
+    const currentName = step.name ?? readIdentityStateString(step.identity.state, 'name')
+    return (
+      <Surface
+        title="Edit Name, Description, Icon"
+        subtitle={<FlowTimeline steps={EDIT_PROFILE_STEPS} current={1} />}
+        footer={footerHint(EDIT_NEXT_FOOTER)}
+      >
+        <Text color={theme.dim}>Saved: {readIdentityStateString(step.identity.state, 'name') || '(unnamed)'}</Text>
+        <Box marginTop={1}>
+          <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}
+          />
+        </Box>
+      </Surface>
+    )
+  }
+
+  if (step.kind === 'edit-profile-image') {
+    return <AgentIconStep step={step} onIconSubmit={onIconSubmit} onIconPick={onIconPick} onBack={onBack} />
+  }
+
+  if (step.kind === 'edit-profile-review') {
+    return (
+      <EditProfileReviewStep
+        step={step}
+        onSave={onReviewSave}
+        onBack={onBack}
+      />
+    )
+  }
+
+  if (step.kind === 'edit-profile-ens') {
+    return (
+      <EnsEditFlow
+        identity={step.identity}
+        registry={step.registry}
+        onEnsLink={onEnsLink}
+        onEnsUnlink={onEnsUnlink}
+        onEnsRecordsUpdate={onEnsRecordsUpdate}
+        onEnsSetup={onEnsSetup}
+        onManageOperatorWalletAccess={onManageOperatorWalletAccess}
+        initialView={step.initialView}
+        onBack={onBack}
+      />
+    )
+  }
+
+  const currentDescription = readIdentityStateString(step.identity.state, 'description')
+  const draftDescription = step.description ?? currentDescription
+  return (
+    <Surface
+      title="Edit Name, Description, Icon"
+      subtitle={<FlowTimeline steps={EDIT_PROFILE_STEPS} current={2} />}
+      footer={footerHint(EDIT_DESCRIPTION_FOOTER)}
+    >
+      <Text color={theme.dim}>Saved: {currentDescription || '(no description)'}</Text>
+      <Box marginTop={1}>
+        <TextInput
+          key="edit-profile-description"
+          initialValue={draftDescription}
+          placeholder="description"
+          allowEmpty
+          multiline
+          onSubmit={value => onDescriptionSubmit(value.trim())}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+const AgentIconStep: React.FC<{
+  step: Extract<Step, { kind: 'edit-profile-image' }>
+  onIconSubmit: (iconPath?: string) => void
+  onIconPick: () => void
+  onBack: () => void
+}> = ({ step, onIconSubmit, onIconPick, onBack }) => {
+  const [entryMode, setEntryMode] = React.useState(false)
+  const currentIcon = readIdentityStateString(step.identity.state, 'imageUrl')
+  const selectedIcon = describeDraftIcon(step.imagePath, currentIcon)
+
+  if (entryMode) {
+    return (
+      <Surface
+        title="Edit Name, Description, Icon"
+        subtitle={<FlowTimeline steps={EDIT_PROFILE_STEPS} current={3} />}
+        footer={footerHint(EDIT_NEXT_FOOTER)}
+      >
+        <Text color={theme.dim}>Current: {currentIcon ? shortIconReference(currentIcon) : '(no icon)'}</Text>
+        <Box marginTop={1}>
+          <TextInput
+            key="edit-profile-icon-entry"
+            placeholder="https://.../icon.png or C:\\path\\icon.png"
+            validate={validateAgentIconReference}
+            onSubmit={value => onIconSubmit(value.trim())}
+            onCancel={onBack}
+          />
+        </Box>
+      </Surface>
+    )
+  }
+
+  return (
+    <Surface
+      title="Edit Name, Description, Icon"
+      subtitle={<FlowTimeline steps={EDIT_PROFILE_STEPS} current={3} />}
+      footer={footerHint('enter select · esc back')}
+    >
+      <Box flexDirection="column">
+        <Text color={theme.dim}>Agent Icon: {selectedIcon}</Text>
+        {step.error ? <Text color={theme.accentError}>{step.error}</Text> : null}
+      </Box>
+      <Box marginTop={1}>
+        <Select<'choose' | 'enter' | 'skip' | 'delete' | 'back'>
+          options={[
+            { value: 'choose', role: 'section', label: 'Icon Source' },
+            { value: 'choose', label: 'Choose Local File', hint: 'Open the operating system file picker' },
+            { value: 'enter', label: 'Enter URL Or Path', hint: 'Use https, ipfs, or a local media path' },
+            { value: 'skip', role: 'section', label: 'Current Icon' },
+            { value: 'skip', label: currentIcon ? 'Keep Current Icon' : 'No Icon', hint: 'Continue without changing the icon' },
+            { value: 'delete', label: 'Remove Agent Icon', hint: 'Clear the public profile icon', disabled: !currentIcon },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: 'Return to description', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'choose') return onIconPick()
+            if (choice === 'enter') { setEntryMode(true); return }
+            if (choice === 'delete') return onIconSubmit('delete')
+            if (choice === 'skip') return onIconSubmit(undefined)
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+const EditProfileReviewStep: React.FC<{
+  step: Extract<Step, { kind: 'edit-profile-review' }>
+  onSave: () => void
+  onBack: () => void
+}> = ({ step, onSave, onBack }) => {
+  const currentIcon = readIdentityStateString(step.identity.state, 'imageUrl')
+  return (
+    <Surface
+      title="Edit Name, Description, Icon"
+      subtitle={<FlowTimeline steps={EDIT_PROFILE_STEPS} current={4} />}
+      footer={footerHint('enter save · esc back')}
+    >
+      <Box flexDirection="column">
+        <ReviewRow label="Name" value={step.name || '(unnamed)'} />
+        <ReviewRow label="Description" value={step.description || '(no description)'} />
+        <ReviewRow label="Agent Icon" value={describeDraftIcon(step.imagePath, currentIcon)} />
+      </Box>
+      <Box marginTop={1}>
+        <Select<'save' | 'back'>
+          options={[
+            { value: 'save', label: 'Save Public Profile', hint: 'Publish public profile and update the token URI' },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: 'Return to Agent Icon', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => choice === 'save' ? onSave() : onBack()}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+const ReviewRow: React.FC<{ label: string; value: string }> = ({ label, value }) => {
+  const lines = value.split('\n')
+  return (
+    <Box flexDirection="row">
+      <Box width={13} flexShrink={0}>
+        <Text color={theme.dim}>{label}</Text>
+      </Box>
+      <Box flexDirection="column" flexGrow={1}>
+        {lines.map((line, i) => (
+          <Text key={i} color={theme.text}>{line || ' '}</Text>
+        ))}
+      </Box>
+    </Box>
+  )
+}
+
+function describeDraftIcon(imagePath: string | undefined, currentIcon: string): string {
+  if (imagePath === 'delete') return 'Remove current icon'
+  if (imagePath) return shortIconReference(imagePath)
+  return currentIcon ? shortIconReference(currentIcon) : '(no icon)'
+}
+
+function shortIconReference(value: string): string {
+  const trimmed = value.trim()
+  if (trimmed.length <= 56) return trimmed
+  const url = shortUrlReference(trimmed)
+  if (url) return url
+  return `${trimmed.slice(0, 24)}...${trimmed.slice(-20)}`
+}
+
+function shortUrlReference(value: string): string | null {
+  if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(value)) return null
+  try {
+    const url = new URL(value)
+    const parts = url.pathname.split('/').filter(Boolean)
+    const file = parts.at(-1)
+    if (!file) return `${url.protocol}//${url.hostname}`
+    return `${url.protocol}//${url.hostname}/.../${file}`
+  } catch {
+    if (!/^ipfs:\/\//i.test(value)) return null
+    return `${value.slice(0, 22)}...${value.slice(-18)}`
+  }
+}