{"openapi":"3.1.0","info":{"title":"AIDNode Global Beta API","version":"0.4.0-engines-beta","description":"Free AI-agent utilities. 100 beta accounts, 500 successful uses each. No billing or retroactive charges."},"servers":[{"url":"https://botstop-dev.botstop-dev-lab-2026.workers.dev"}],"tags":[{"name":"Discovery"},{"name":"Enrollment"},{"name":"Tools"},{"name":"Feedback"}],"paths":{"/health":{"get":{"tags":["Discovery"],"summary":"Public health information","responses":{"200":{"description":"Public service status"}}}},"/beta":{"get":{"tags":["Discovery"],"summary":"Public beta capacity and terms","responses":{"200":{"description":"Current beta enrollment status"}}}},"/beta/join":{"post":{"tags":["Enrollment"],"summary":"Enroll one self-declared operator in the free beta","description":"Only with operator authorization. Keys are returned exactly once. Enrollment is capped and rate-limited.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operator_id":{"type":"string","minLength":8,"maxLength":120},"agent_name":{"type":"string","minLength":2,"maxLength":100},"agree_beta_terms":{"type":"boolean","const":true}},"required":["operator_id","agent_name","agree_beta_terms"],"additionalProperties":false}}}},"responses":{"201":{"description":"Credentials returned once; no payment"},"409":{"description":"Cohort full or operator already enrolled"},"429":{"description":"Registration rate limit exceeded"}}}},"/account":{"get":{"tags":["Tools"],"summary":"Current usage and remaining free operations","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Account usage"},"401":{"description":"Unauthorized"}}}},"/tools/repair":{"post":{"tags":["Tools"],"summary":"AIDNode Repair v2: classify HTTP/transport failures, retry safety, idempotency, Retry-After, bounded backoff. Advisory only.","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer","minimum":100,"maximum":599},"network_error":{"type":"string","enum":["ECONNRESET","ETIMEDOUT","ECONNREFUSED","EAI_AGAIN","DNS_ERROR","NETWORK_ERROR","TLS_ERROR"]},"method":{"type":"string","enum":["GET","HEAD","OPTIONS","PUT","DELETE","POST","PATCH"]},"attempt":{"type":"integer"},"max_attempts":{"type":"integer"},"idempotency_key_present":{"type":"boolean"},"request_may_have_committed":{"type":"boolean"},"response_headers":{"type":"object"},"retry_after_seconds":{"type":"number"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result; identical retries recover original result without another counted use"},"409":{"description":"idempotency_conflict or legacy_result_unavailable"},"422":{"description":"Invalid input; no counted use"}}}},"/tools/verify":{"post":{"tags":["Tools"],"summary":"AIDNode Verify v2: text diff/hash, canonical JSON change paths, or independent digest of retrieved public HTTPS source from strict host allowlist.","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["compare_text","compare_json","public_http"]},"previous":{},"current":{},"url":{"type":"string"},"expected_sha256":{"type":"string"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result; identical retries recover original result without another counted use"},"409":{"description":"idempotency_conflict or legacy_result_unavailable"},"422":{"description":"Invalid input; no counted use"}}}},"/tools/witness":{"post":{"tags":["Tools"],"summary":"AIDNode Witness v2: validate supplied structured evidence and issue HMAC-signed, hash-based validation receipt; not real-world action attestation.","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"object"},"required_fields":{"type":"array","items":{"type":"string"}},"expected_values":{"type":"object"},"expected_types":{"type":"object"},"field_rules":{"type":"object","additionalProperties":{"type":"object","properties":{"non_empty":{"type":"boolean"},"min_length":{"type":"integer","minimum":0,"maximum":100000},"max_length":{"type":"integer","minimum":0,"maximum":100000},"format":{"type":"string","enum":["uuid","sha256","date-time"]},"minimum":{"type":"number"},"maximum":{"type":"number"},"enum":{"type":"array","minItems":1,"maxItems":100}},"additionalProperties":false}},"expected_sha256":{"type":"string"},"external_evidence":{"type":"object","properties":{"url":{"type":"string"},"expected_sha256":{"type":"string"}},"required":["url","expected_sha256"]}},"required":["document","required_fields"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result; identical retries recover original result without another counted use"},"409":{"description":"idempotency_conflict or legacy_result_unavailable"},"422":{"description":"Invalid input; no counted use"}}}},"/beta/feedback":{"post":{"tags":["Feedback"],"summary":"Optional nonbinding bot feedback after usage checkpoint","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"checkpoint":{"type":"integer","enum":[10,50,100,250,500]},"service":{"type":"string","enum":["repair","verify","witness","overall"]},"helpful":{"type":"string","enum":["yes","no","unsure"]},"would_reuse":{"type":"string","enum":["yes","no","unsure"]},"would_pay_half_cent":{"type":"string","enum":["yes","no","unsure"]},"outcome":{"type":"string","enum":["resolved","partially_resolved","not_resolved","not_applicable"]},"comment":{"type":"string","maxLength":500}},"required":["checkpoint","service","helpful","would_reuse","would_pay_half_cent","outcome"]}}}},"responses":{"200":{"description":"Feedback recorded without charge"}}}},"/mcp":{"post":{"tags":["Tools"],"summary":"Stateless MCP Streamable HTTP JSON-RPC interface","description":"initialize, ping, tools/list are public. tools/call requires a beta Bearer API key. Supports MCP protocol 2025-06-18.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC result"},"202":{"description":"Notification accepted"}}}},"/tools/monitor":{"post":{"tags":["Tools"],"summary":"On-demand approved-host HTTPS endpoint health probe","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Independent HTTP observation"}}}},"/tools/recovery":{"post":{"tags":["Tools"],"summary":"Dependency-aware safe recovery plan for failed agent workflows; no execution","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Recovery plan"}}}},"/receipts/verify":{"post":{"tags":["Discovery"],"summary":"Verify an AIDNode Witness receipt HMAC (not proof of real-world completion)","responses":{"200":{"description":"Receipt signature verification"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Free beta API key returned once by /beta/join. Never include in URLs or public prompts."}}}}