{
  "$schema": "https://agentsjson.org/schema/v0.1.json",
  "name": "IncomeOS",
  "description": "Personal income operating system. Discover and transact with trust-verified humans for income opportunities, services, assets, and referrals — without the noise of anonymous marketplaces.",
  "version": "1.1.0",
  "homepage": "https://www.incomeos.app",
  "manifesto": "https://www.incomeos.app/manifesto",
  "principles_document": "https://www.incomeos.app/.well-known/incomeos-principles.json",
  "documentation": "https://www.incomeos.app/for-ai-agents",
  "contact": {
    "email": "agents@incomeos.app",
    "support": "https://www.incomeos.app/contact"
  },
  "auth": {
    "type": "header",
    "header_name": "X-UCP-Agent-Id",
    "registration_url": "https://www.incomeos.app/dashboard/settings/agents",
    "consent_url": "https://www.incomeos.app/agent-authorize",
    "scopes": ["catalog", "intent", "status", "transact"]
  },
  "rate_limits": {
    "anonymous_per_minute": 30,
    "authenticated_per_minute": 100,
    "burst": 200
  },
  "capabilities": {
    "discover": true,
    "negotiate": true,
    "transact": true,
    "trust_filtering": true,
    "n_hop_network": true,
    "human_in_the_loop": true,
    "audit_trail": true
  },
  "endpoints": [
    {
      "name": "Public API root",
      "method": "GET",
      "url": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/public-opportunities-api/",
      "description": "Self-describing manifest of all public read endpoints."
    },
    {
      "name": "Opportunities (JSON-LD ItemList)",
      "method": "GET",
      "url": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/public-opportunities-api/opportunities",
      "params": ["limit", "offset", "category", "country", "min_budget"]
    },
    {
      "name": "Opportunity detail (JSON-LD JobPosting)",
      "method": "GET",
      "url_template": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/public-opportunities-api/opportunities/{id}.json"
    },
    {
      "name": "Opportunity detail (Markdown)",
      "method": "GET",
      "url_template": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/public-opportunities-api/opportunities/{id}.md"
    },
    {
      "name": "UCP Catalog",
      "method": "GET",
      "url": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-catalog",
      "description": "Trust-tier and N-hop filtered discovery for authenticated agents."
    },
    {
      "name": "UCP Intent",
      "method": "POST",
      "url": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-intent",
      "description": "Price check, availability, create order."
    },
    {
      "name": "UCP Status",
      "method": "GET",
      "url": "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-status",
      "description": "Order lifecycle tracking."
    }
  ],
  "principles": {
    "human_first": "Every monetary action by an agent on behalf of a human can be paused for human approval. Default spend cap = 0 until explicitly raised.",
    "trust_required": "Every counterparty has a trust score derived from real human behavior, not algorithmic synthesis.",
    "no_synthetic_actors": "Agents cannot post reviews, send appreciations, or build trust on the human's behalf — those remain human-only.",
    "first_win_promise": "Every new human user is guided toward a real first earning within 24 hours — not a tutorial badge.",
    "transparent_fee": "A flat 2.5% platform fee is the only cut IncomeOS takes from any transaction. No hidden spread, no rake.",
    "proprietary_ai_only": "Inco AI is 100% in-house. No third-party LLMs (OpenAI, Anthropic, Google) process user data or rank opportunities.",
    "opportunity_not_freelance": "IncomeOS is an income operating system, not an anonymous freelance marketplace. Discovery is trust-network-first, not keyword-first.",
    "earn_without_owning": "Users can earn from skills, referrals, partnerships, and shared assets without owning capital.",
    "real_time_real_income": "All earnings, opportunities, and trust changes are live database events. Zero mock data."
  },
  "guarantees": {
    "platform_fee_pct": 2.5,
    "default_agent_spend_cap_cents": 0,
    "third_party_ai_processors": [],
    "mock_data": false
  }
}
