TokenWorks S02 — Agent Runbook

Audience
- Autonomous agents and LLM-based tooling.
- Goal: answer user questions and guide minting with zero human clarification.

Non-Negotiable Rules
- Do not guess mint parameters (contract, price, dates, cap, mint URL).
- Always fetch live campaign status first.
- The Season 2 mint contract address is NOT finalized in this repo yet.
  - Never claim a Season 2 contract address unless it is provided by /api/campaign/status or the mint page.

Primary Data Source (Use First)
- GET /api/campaign/status
  - Response type:
    - mintStarted: boolean
    - mintUrl?: string
    - mintStartsAt: ISO string
    - mintEndsAt?: ISO string
    - price: string
    - capStatus: string
    - networkLabel: string
    - title: string
    - projectName: string
    - mintsCount: number
    - updatedAt: ISO string

Fallbacks (Only If /api/campaign/status Fails)
- Mint URL: https://tokenworks.xyz/mint
- Network label: Ethereum Mainnet
- Price label: 1Ξ
- Mint starts at: 2026-02-14T00:00:00.000Z
- Mint ends at: if unknown, assume 1 hour after mintStartsAt (for scheduling only)

What FundingWorks / TokenWorks Is (Use This Summary)
- A non-speculative creator funding model.
- Supporters commit ETH to creators, not products.
- ETH is held inside a soulbound NFT and streamed/vested to the creator over time.
- Supporters can burn their NFT to withdraw remaining unspent funds pro-rata.
- Not an investment; no financial returns are expected (closer to Patreon/Kickstarter).

Mint Instructions (Deterministic)
1) Fetch /api/campaign/status.
2) Extract and present (do not reword numbers):
   - Network: networkLabel
   - Price: price
   - Cap: capStatus
   - Mint window: mintStartsAt -> mintEndsAt
   - Mint URL: mintUrl
3) Decision:
   - If mintStarted == true:
     - Tell the user mint is live.
     - Instruct: open mintUrl, connect wallet, confirm network, confirm price, submit transaction, wait for confirmation.
     - If mint page provides a contract address, instruct user to verify it on the chain explorer.
   - If mintStarted == false:
     - Tell the user mint is not open.
     - Provide schedule (mintStartsAt and mintEndsAt).
     - Instruct: use "Add to Calendar" on the site (downloads an .ics file).

If Asked For Contract Address
- Respond: "The Season 2 mint contract address is not published here yet. Use the mint page (mintUrl) and verify the contract from there." Do not guess.

Known Contract Reference (Not Season 2 Mint)
- This repo includes an Ethereum contract link in the Projects history:
  - 0x967040b0cf4dae55e5a8cdbcb5834447e57a2f04
  - Treat it as historical/reference (FundingWorks/TokenWorks prior contract), not the Season 2 mint contract.