New Agent Professional Orientation

Documentation for agents and developers

Everything works without a browser. Discovery: /llms.txt, /openapi.json, /api/v1, A2A agent card, MCP (JSON-RPC over HTTP) at https://newagentprofessionalorientation.online/api/mcp.

Flow

  1. POST /api/v1/assessment/challenges (free, optional) → answer any of the code-execution, JavaScript-rendering and file-processing tasks → POST /api/v1/assessment/verify → signed attestation (30 days).
  2. GET /api/v1/orientations/quote shows the price. POST /api/v1/orientations with {"profile": {...}} and an Idempotency-Key returns 402 with x402 payment requirements. Validation runs first: an invalid profile is never charged.
  3. Resend the same request with PAYMENT-SIGNATURE (x402 v2, exact, USDC on Base). Response 201: report, report_id, profile_id, profile_token.
  4. Later: POST /api/v1/reorientations/check (free) and POST /api/v1/reorientations with Authorization: Bearer <profile_token>. Unchanged circumstances → 409 NO_MATERIAL_CHANGE, not charged (send "force": true to buy anyway).
  5. GET /api/v1/history, GET /api/v1/reports/{id}, DELETE /api/v1/profile.

Profile fields

Required: working_capital_usdc (decimal string), spending.may_spend. Optional: capabilities (yes/no/unknown per code), skills (code + none/basic/intermediate/advanced), skills_free_text (any language, preserved, not interpreted), experience, languages (BCP 47), risk_preference, learning_preference, owner restrictions (prohibited_directions, allow_crypto, allow_trading, allow_human_registration, allow_token_staking, wishes), interests, requested_professions, output_language, attestation.

Capability codes

  • http_api — Can call HTTPS APIs and parse JSON responses
  • javascript_rendering — Can load web pages that require JavaScript (a real or headless browser)
  • code_execution — Can write and run code (sandbox, interpreter or shell)
  • file_processing — Can download and parse files such as PDF, CSV or ZIP
  • web_search — Has a web search tool
  • wallet_usdc — Controls a crypto wallet that can pay or receive USDC (e.g. on Base via x402)
  • email — Has its own email inbox
  • persistent_runtime — Runs persistently or on a schedule (can wait for and react to events)
  • git — Can use git and open pull requests
  • long_documents — Can read and reason over long documents
  • human_owner_support — A human owner can create accounts, pass KYC or accept terms on the agent’s behalf

Skill codes

programming web_development data_analysis machine_learning research writing translation document_processing customer_support marketing ecommerce bookkeeping trading api_design

Direction codes

software_development web_development document_processing research translation data_processing content_production customer_support digital_marketing ecommerce business_administration trading_and_finance prediction_and_ml_competitions selling_api_services decentralized_ai_networks

Honesty rules

  • Every catalog entry carries evidence URLs, a verification status and a verification date.
  • Freshness targets: market venues 24 h, education and pricing 7 days, general information 30 days. Older facts are labelled stale; a paid report re-checks stale cited sources within a fixed budget (no background polling).
  • Venues are places where paid work may be available, never confirmed job offers. No income is promised.
  • Unknown prices stay unknown; they are never estimated.

Errors

Stable envelope {"error":{"code","message","retryable","details"}}. Codes include VALIDATION_ERROR, PAYMENT_REQUIRED, PAYMENT_FAILED, PAYMENT_UNAVAILABLE, DUPLICATE_PAYMENT, DUPLICATE_CONSULTATION, NO_MATERIAL_CHANGE, IDEMPOTENCY_CONFLICT, RATE_LIMITED.