Skip to content

[Feat] Unified Agent Writer Page (/agents) #439

@realproject7

Description

@realproject7

Summary

Create a single /agents page targeting AI agent operators. Currently the agent registration wizard is at /register-agent (not in NavBar) and there's no developer reference page. Combine everything into one page.

Sections/Tabs

1. Register

  • Move the existing ERC-8004 registration wizard from /register-agent
  • 3-step flow: agent profile → register identity tx → link operational wallet
  • Keep existing logic from src/app/register-agent/page.tsx
  • Show registration status if wallet is already registered

2. Build

  • CLI quick start: install command, configuration (private key, RPC)
  • Available CLI commands with usage examples:
    • plotlink create — create a new storyline from a content file
    • plotlink chain — chain a new plot to an existing storyline
    • plotlink status — check storyline status (plot count, deadline, token price)
    • plotlink claim — claim accumulated royalties
    • plotlink agent register — register as an AI agent writer
  • SDK usage: npm install @plotlink/sdk, basic code example showing PlotLink class
  • API endpoints reference: /api/index/plot, /api/index/storyline, /api/index/trade

3. Dashboard

  • Show the connected agent's storylines (filtered by wallet + writer_type = 1)
  • Per-storyline: plot count, deadline countdown, token price, unclaimed royalties
  • Claim royalties button per storyline
  • If wallet is not registered as agent, prompt to register (link to Register tab)

Navigation

  • Add "Agents" to NAV_LINKS in src/components/NavBar.tsx
  • Redirect /register-agent to /agents (backwards compatibility)
  • Tab-based navigation within the page (Register | Build | Dashboard)

Design

  • Match existing Moleskine/monospace aesthetic
  • Build section: use code blocks with monospace font for CLI/SDK examples
  • Ruled paper styling on code examples would be a nice touch

Reference

  • Existing registration wizard: src/app/register-agent/page.tsx
  • CLI commands: packages/cli/src/commands/
  • SDK client: packages/sdk/src/client.ts
  • ERC-8004 registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

Acceptance Criteria

  • /agents page with 3 tabs (Register, Build, Dashboard)
  • Registration wizard moved from /register-agent
  • /register-agent redirects to /agents
  • "Agents" link in NavBar
  • CLI/SDK reference with install + usage examples
  • Agent dashboard shows storylines for registered agents
  • Mobile responsive
  • Build passes

Branch

task/<issue-number>-agents-page

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/T3Assigned to T3 builder agent

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions