ethagent 3.0.2 → 3.1.0

package/src/chat/slashCommandViews.ts

@@ -0,0 +1,120 @@
+import type { EthagentConfig, ProviderId } from '../storage/config.js'
+import { getConfigPath, localProviderBaseUrlFor } from '../storage/config.js'
+import { detectLlamaCpp } from '../models/llamacpp.js'
+import { detectSpec } from '../models/runtimeDetection.js'
+import { getIdentityStatus } from '../storage/identity.js'
+import { getLocalHfCacheDir } from '../models/huggingface.js'
+import { formatModelDisplayName } from '../models/modelDisplay.js'
+import { providerDisplayName } from '../models/modelPickerOptions.js'
+import type { ModelCatalogResult } from '../models/catalog.js'
+import type { SlashContext } from './commands.js'
+
+export function renderStatus(ctx: SlashContext): string {
+  const elapsedMs = Date.now() - ctx.startedAt
+  const minutes = Math.floor(elapsedMs / 60000)
+  const seconds = Math.floor((elapsedMs % 60000) / 1000)
+  const elapsed = minutes > 0 ? `${minutes}m${seconds.toString().padStart(2, '0')}s` : `${seconds}s`
+  const displayModel = formatModelDisplayName(ctx.config.provider, ctx.config.model, { maxLength: 72 })
+  return [
+    `provider   ${providerDisplayName(ctx.config.provider)}`,
+    `model      ${displayModel}`,
+    `cwd        ${ctx.cwd}`,
+    `session    ${ctx.sessionId.slice(0, 8)}`,
+    'state      active',
+    `turns      ${ctx.turns}`,
+    `tokens     ~${ctx.approxTokens}`,
+    `context    ${ctx.contextUsage.percent}% (~${ctx.contextUsage.usedTokens}/${ctx.contextUsage.windowTokens}, ${ctx.contextUsage.source})`,
+    `elapsed    ${elapsed}`,
+  ].join('\n')
+}
+
+export function renderContext(ctx: SlashContext): string {
+  const usage = ctx.contextUsage
+  const free = Math.max(0, usage.windowTokens - usage.usedTokens)
+  const action =
+    usage.percent >= 90
+      ? 'Context is near the model limit. New requests will ask you to summarize into a new conversation, switch models, ignore and send, or cancel.'
+      : usage.percent >= 75
+        ? 'Context is getting full. Consider /compact before a new task boundary.'
+        : 'Context has comfortable room.'
+  return [
+    'context usage:',
+    `  model      ${providerDisplayName(ctx.config.provider)} · ${formatModelDisplayName(ctx.config.provider, ctx.config.model, { maxLength: 72 })}`,
+    `  used       ~${usage.usedTokens} / ${usage.windowTokens} tokens (${usage.percent}%)`,
+    `  free       ~${free} tokens`,
+    `  estimate   ${usage.confidence} (${usage.source})`,
+    '  session    active',
+    '',
+    action,
+  ].join('\n')
+}
+
+export function renderDoctor(
+  spec: Awaited<ReturnType<typeof detectSpec>>,
+  keys: ReadonlyArray<readonly [ProviderId, boolean]>,
+  identity: Awaited<ReturnType<typeof getIdentityStatus>>,
+  ctx: SlashContext,
+  llamaCpp: Awaited<ReturnType<typeof detectLlamaCpp>>,
+  hfModelCount: number,
+): string {
+  const lines: string[] = ['diagnostics:']
+  lines.push(`  platform   ${spec.platform}/${spec.arch}${spec.isAppleSilicon ? ' (apple silicon)' : ''}`)
+  lines.push(`  ram        ${formatGB(spec.effectiveRamBytes)}${spec.gpuVramBytes ? ` · vram ${formatGB(spec.gpuVramBytes)}` : ''}`)
+  lines.push(`  local run  ${llamaCpp.binaryPresent ? 'installed' : 'not installed'} · server ${llamaCpp.serverUp ? 'up' : 'down'}`)
+  lines.push(`  hf models  ${hfModelCount} downloaded`)
+  lines.push('')
+  lines.push('config:')
+  lines.push(`  provider   ${providerDisplayName(ctx.config.provider)}`)
+  lines.push(`  model      ${formatModelDisplayName(ctx.config.provider, ctx.config.model, { maxLength: 72 })}`)
+  if (ctx.config.baseUrl) lines.push(`  baseUrl    ${ctx.config.baseUrl}`)
+  if (ctx.config.provider === 'llamacpp') lines.push(`  hf cache   ${getLocalHfCacheDir()}`)
+  lines.push(`  path       ${getConfigPath()}`)
+  lines.push('')
+  lines.push('keys:')
+  for (const [provider, present] of keys) {
+    lines.push(`  ${providerDisplayName(provider).padEnd(9)}  ${present ? 'set' : 'not set'}`)
+  }
+  lines.push('')
+  lines.push('identity:')
+  if (identity) {
+    lines.push(`  address    ${identity.address}`)
+    lines.push(`  backend    ${identity.backend}`)
+    if (identity.source) lines.push(`  source     ${identity.source}`)
+    if (identity.agentId) lines.push(`  token      #${identity.agentId}`)
+  } else {
+    lines.push('  address    not set')
+  }
+  return lines.join('\n')
+}
+
+export function renderModelCatalog(catalog: ModelCatalogResult, currentModel: string): string {
+  const title = catalog.status === 'fallback'
+    ? `${providerDisplayName(catalog.provider)} models (fallback${catalog.error ? `: ${catalog.error}` : ''}):`
+    : `${providerDisplayName(catalog.provider)} models:`
+  const lines = catalog.entries.map(entry => {
+    const marker = entry.id === currentModel ? '*' : ' '
+    const suffix = entry.source === 'fallback' ? '  fallback' : ''
+    return `${marker} ${formatModelDisplayName(catalog.provider, entry.id, { maxLength: 72 })}${suffix}`
+  })
+  return [title, ...lines].join('\n')
+}
+
+export function baseUrlForModelSwitch(config: EthagentConfig): string | undefined {
+  if (config.provider === 'llamacpp') return localProviderBaseUrlFor('llamacpp', config.baseUrl)
+  if (config.provider === 'openai') return config.baseUrl
+  return undefined
+}
+
+export function formatBytes(bytes: number): string {
+  if (bytes <= 0) return '—'
+  const gb = bytes / (1024 * 1024 * 1024)
+  if (gb >= 1) return `${gb.toFixed(1)}GB`
+  const mb = bytes / (1024 * 1024)
+  return `${mb.toFixed(0)}MB`
+}
+
+function formatGB(bytes: number): string {
+  const gb = bytes / (1024 * 1024 * 1024)
+  if (gb >= 10) return `${Math.round(gb)}GB`
+  return `${gb.toFixed(1)}GB`
+}

package/src/identity/continuity/challenges.ts

@@ -0,0 +1,123 @@
+import { toChecksumAddress } from '../crypto/eth.js'
+import { normalizeContinuitySnapshotToken, type ContinuitySnapshotToken } from './snapshotToken.js'
+
+const CONTINUITY_SNAPSHOT_CHALLENGE_MESSAGES = [
+  'Save or Restore Identity Files',
+  'Action: encrypt or decrypt local identity files',
+  'Private: SOUL.md, MEMORY.md, skills',
+  'Public: public skills and profile',
+  'Safety: no transaction, spending, or approvals',
+  'Version: 2',
+] as const
+
+export function createContinuitySnapshotChallenge(ownerAddress: string): string {
+  const checksum = toChecksumAddress(ownerAddress)
+  return [
+    CONTINUITY_SNAPSHOT_CHALLENGE_MESSAGES[0],
+    `Owner: ${checksum}`,
+    ...CONTINUITY_SNAPSHOT_CHALLENGE_MESSAGES.slice(1),
+  ].join('\n')
+}
+
+export const TRANSFER_SNAPSHOT_CHALLENGE_HEADER_LEGACY = 'Prepare Transfer Restore Snapshot'
+export const TRANSFER_SNAPSHOT_CHALLENGE_HEADER_SENDER = 'Prepare Transfer Snapshot · Sender Restore Slot'
+export const TRANSFER_SNAPSHOT_CHALLENGE_HEADER_RECEIVER = 'Prepare Transfer Snapshot · Receiver Restore Slot'
+
+export function createTransferContinuitySnapshotChallenge(args: {
+  token: ContinuitySnapshotToken
+  ownerAddress: string
+  targetAddress: string
+  role?: 'sender' | 'receiver'
+}): string {
+  const token = normalizeContinuitySnapshotToken(args.token)
+  const ownerAddress = toChecksumAddress(args.ownerAddress)
+  const targetAddress = toChecksumAddress(args.targetAddress)
+  const header = args.role === 'sender'
+    ? TRANSFER_SNAPSHOT_CHALLENGE_HEADER_SENDER
+    : args.role === 'receiver'
+      ? TRANSFER_SNAPSHOT_CHALLENGE_HEADER_RECEIVER
+      : TRANSFER_SNAPSHOT_CHALLENGE_HEADER_LEGACY
+  return [
+    header,
+    `ERC-8004 Chain ID: ${token.chainId}`,
+    `ERC-8004 Registry: ${token.identityRegistryAddress}`,
+    `ERC-8004 Token ID: ${token.agentId}`,
+    `Sender Owner: ${ownerAddress}`,
+    `Receiver Owner: ${targetAddress}`,
+    'Action: encrypt or decrypt local identity files for this token transfer',
+    'Private: SOUL.md, MEMORY.md, skills',
+    'Public: public skills and profile',
+    'Safety: no transaction, spending, or approvals',
+    'Version: 2',
+  ].join('\n')
+}
+
+export type WalletChallengePurpose =
+  | 'create-agent'
+  | 'update-snapshot'
+  | 'update-ens-snapshot'
+  | 'clear-ens-snapshot'
+  | 'update-profile-snapshot'
+  | 'update-operators-snapshot'
+  | 'refetch-snapshot'
+  | 'operator-proof'
+  | 'restore-owner'
+  | 'restore-operator'
+  | 'transfer-prepare-sender'
+  | 'transfer-prepare-receiver'
+
+const WALLET_CHALLENGE_V2_COPY: Record<WalletChallengePurpose, { title: string; action: string }> = {
+  'create-agent':              { title: 'Create Agent Snapshot Key',                action: 'Action: encrypt the new agent snapshot for owner restore' },
+  'update-snapshot':           { title: 'Save Snapshot Encryption Key',              action: 'Action: encrypt the updated agent snapshot' },
+  'update-ens-snapshot':       { title: 'Update ENS in Agent Snapshot',              action: 'Action: encrypt the snapshot with the new ENS name. No onchain ENS records change.' },
+  'clear-ens-snapshot':        { title: 'Unlink ENS from Agent',                     action: 'Action: encrypt the snapshot with no ENS name. No onchain ENS records change.' },
+  'update-profile-snapshot':   { title: 'Update Public Profile Snapshot Key',        action: 'Action: encrypt the snapshot with the updated profile' },
+  'update-operators-snapshot': { title: 'Update Operator Wallets Snapshot Key',      action: 'Action: encrypt the snapshot with the updated operator list' },
+  'refetch-snapshot':          { title: 'Refetch Latest Snapshot',                   action: 'Action: decrypt the latest published snapshot' },
+  'operator-proof':            { title: 'Authorize Operator Wallet Restore Access',  action: 'Action: prove this operator wallet can decrypt future snapshots' },
+  'restore-owner':             { title: 'Restore Agent with Owner Wallet',           action: 'Action: decrypt the snapshot for the owner wallet' },
+  'restore-operator':          { title: 'Restore Agent with Operator Wallet',        action: 'Action: decrypt the snapshot for the authorized operator wallet' },
+  'transfer-prepare-sender':   { title: 'Prepare Token Transfer (Sender)',           action: 'Action: encrypt the transfer snapshot for the receiver' },
+  'transfer-prepare-receiver': { title: 'Receive Token Transfer (Receiver)',         action: 'Action: prepare receiver decryption for the transfer snapshot' },
+}
+
+export function createWalletRestoreAccessChallenge(args: {
+  token: ContinuitySnapshotToken
+  ownerAddress: string
+  walletAddress: string
+  accessEpoch?: number
+  purpose?: WalletChallengePurpose
+}): string {
+  const token = normalizeContinuitySnapshotToken(args.token)
+  const ownerAddress = toChecksumAddress(args.ownerAddress)
+  const walletAddress = toChecksumAddress(args.walletAddress)
+  if (args.purpose) {
+    const copy = WALLET_CHALLENGE_V2_COPY[args.purpose]
+    return [
+      copy.title,
+      `ERC-8004 Chain ID: ${token.chainId}`,
+      `ERC-8004 Registry: ${token.identityRegistryAddress}`,
+      `ERC-8004 Token ID: ${token.agentId}`,
+      `Owner: ${ownerAddress}`,
+      `Wallet: ${walletAddress}`,
+      `Access Epoch: ${args.accessEpoch ?? 1}`,
+      copy.action,
+      'Private: SOUL.md, MEMORY.md, skills',
+      'Safety: no transaction, spending, or approvals',
+      'Version: 3',
+    ].join('\n')
+  }
+  return [
+    'Authorize Wallet Restore Access',
+    `ERC-8004 Chain ID: ${token.chainId}`,
+    `ERC-8004 Registry: ${token.identityRegistryAddress}`,
+    `ERC-8004 Token ID: ${token.agentId}`,
+    `Owner: ${ownerAddress}`,
+    `Wallet: ${walletAddress}`,
+    `Access Epoch: ${args.accessEpoch ?? 1}`,
+    'Action: create a restore key for encrypted identity snapshots',
+    'Private: SOUL.md, MEMORY.md, skills',
+    'Safety: no transaction, spending, or approvals',
+    'Version: 2',
+  ].join('\n')
+}