agents-starter.

// Module 09: src/strategies/my-strategy/index.ts
// Extend BaseStrategy, implement initialize / tick / shutdown / getStats.
// The base class drives the loop: it calls tick() on a timer and executes
// each TradeDecision via SDKTradingClient. DRY_RUN is honoured automatically.
//
// Note: imports use the .js extension because the repo is ESM ("type":"module").

import {
  BaseStrategy,
  StrategyConfig,
  TradeDecision,
  StrategyStats,
} from '../base-strategy.js';
import { LimitlessClient } from '../../core/limitless/markets.js';
import { SDKTradingClient } from '../../core/limitless/sdk-trading.js';

export class MyStrategy extends BaseStrategy {
  constructor(
    config: StrategyConfig,
    deps: { limitless: LimitlessClient; trading: SDKTradingClient },
  ) {
    super(config, deps);
    this.tickIntervalMs = 30_000; // how often tick() runs; default is 60_000
  }

  async initialize(): Promise<void> {
    // One-time setup: warm caches, load state, check approvals.
    this.logger.info('MyStrategy initialised');
  }

  async tick(): Promise<TradeDecision[]> {
    // 1. Discover candidate markets (CLOB venue only).
    const markets = await this.limitless.getActiveMarkets({ tradeType: 'clob' });

    // 2. Decide. TradeDecision shape is the contract: see base-strategy.ts.
    const decisions: TradeDecision[] = [];
    for (const market of markets) {
      const yesPrice = market.prices[0] / 100; // prices are 0–100
      if (yesPrice < 0.45) {
        decisions.push({
          action:     'BUY',
          marketSlug: market.slug,
          side:       'YES',
          amountUsd:  1.0,
          priceLimit: Math.floor((yesPrice + 0.02) * 100), // cents
          reason:     `YES at ${yesPrice.toFixed(2)} below 0.45 floor`,
        });
      }
    }
    return decisions; // the base class submits these via this.trading.createOrder()
  }

  async shutdown(): Promise<void> {
    this.logger.info('MyStrategy shutting down');
  }

  getStats(): StrategyStats {
    return { activePositions: 0, totalVolumeUsd: 0, pnlUsd: 0, lastTickDurationMs: 0 };
  }
}

// Add a runner at src/strategies/my-strategy/run.ts that wires LimitlessClient
// and SDKTradingClient together (mirror src/strategies/oracle-arb/run.ts).
// Then a package.json script:
//   "my-strategy": "npx tsx src/strategies/my-strategy/run.ts"
//
// Then: npm run my-strategy

# Module 09: SKILL.md (what Claude Code / OpenClaw reads on open)
#
# SKILL.md is Markdown at the repo root, not a Python file. It's shown
# here in the Python tab as reference text because the starter repo
# itself is TypeScript only. Paraphrased outline of the real ~3,300-line
# file:

# ---------------------------------------------------------------
# # Limitless Prediction Market Trading Agent
# Complete SDK and strategy framework. This file is the operating
# manual: an agent with shell access can go zero-to-live by following it.
#
# ## Quick Start Prompt
# A copy-pasteable prompt that hands the wizard off to a coding agent.
# (or just: install.sh, then npm run cross-market-mm:init)
#
# ## Agent Setup Wizard (7 steps)
#   1. Clone & install
#   2. Configure credentials (PRIVATE_KEY + LMTS_TOKEN_ID/LMTS_TOKEN_SECRET in .env)
#   3. Verify wallet (one-shot viem snippet to read USDC balance on Base)
#   4. Dry run        →  npm run certainty-closer
#   4b. Token approvals (CRITICAL before going live)
#         npx tsx src/index.ts approve 
#   5. Go live         →  set DRY_RUN=false, run under PM2
#   6. Monitor         →  per-strategy :status JSON (data/-status.json),
#                         optional Telegram alerts; redeem claim-all
#   7. Iterate         →  npm run :analyze, tune .env/YAML, restart
#   Emergency stop     →  pm2 stop ; redeem claim-all
#
# ## Available Strategies (npm run )
#   cross-market-mm     cross-venue market maker, delta-neutral (flagship)
#   oracle-arb          Pyth Hermes SSE arb (FOK orders)
#   certainty-closer    near-resolution favourites, fractional Kelly (SDK-only)
#
# ## Live Documentation (MCP): the source of truth
#   POST https://docs.limitless.exchange/mcp   (JSON-RPC + SSE)
#   Tools:
#     - search_limitless_exchange(query)             # semantic search
#     - query_docs_filesystem_limitless_exchange(cmd)  # rg/cat/tree on docs
#   Use this BEFORE writing any new API call. Cached docs in this file
#   may lag; the MCP endpoint always reflects the current state.
#
# ## Building Your Own Strategy
#   Extend BaseStrategy in src/strategies//index.ts.
#   Implement initialize(), tick(), shutdown(), getStats().
#   Create src/strategies//run.ts (mirror oracle-arb/run.ts) and
#   add a package.json script.
#
# ## Safety & Risk Management
#   Per-strategy sizing (ORACLE_BET_SIZE; CC_BANKROLL/CC_MAX_RISK/
#   CC_KELLY_FRACTION; cross-market-mm order_size + max_loss_usd circuit
#   breaker in YAML). PM2 supervises long-running strategies; auto-restart
#   with backoff.
# ---------------------------------------------------------------

# The coding agent uses SKILL.md like a runbook. When you tell it "dry-run
# certainty-closer for an hour and report PnL", it opens the file, finds
# the right npm command, runs it, and tails the status file.