{ "openapi": "3.1.0", "info": { "title": "Wever Labs Public Agent Intake API", "version": "0.1.9", "description": "Public-safe API description for Wever Labs OS surfaces in the agent-to-agent economy, including OS support matrix, runtime rail bindings, queue scheduler monitor, heartbeat, retry commands, stuck-task alerts, handshake, preflight, run contracts, task ledger, exception recovery, replay rails, operating console, lifecycle labels, result contracts, settlement receipts, and usage receipts." }, "servers": [ { "url": "https://os.weverlabs.com", "description": "Wever Labs OS public-safe API host" } ], "paths": { "/api/external-agent-requests": { "get": { "summary": "External agent request endpoint health check", "responses": { "200": { "description": "Endpoint metadata" } } }, "post": { "summary": "Submit an external agent, system, or capability inquiry for review", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/external-agent-request.schema.json" } } } }, "responses": { "200": { "description": "External agent request received" }, "400": { "description": "Missing required fields" } } } }, "/api/agentic-pilot-intake": { "get": { "summary": "Workflow intake endpoint health check", "responses": { "200": { "description": "Endpoint metadata" } } }, "post": { "summary": "Submit workflow context for Work Order review and routing", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/workflow-intake.schema.json" } }, "multipart/form-data": { "schema": { "$ref": "https://weverlabs.com/schemas/workflow-intake.schema.json" } } } }, "responses": { "200": { "description": "Workflow received and Work Order created" }, "400": { "description": "Missing required fields" } } } }, "/api/public/workflow-observatory": { "get": { "summary": "Get public-safe workflow observatory feed", "responses": { "200": { "description": "Public-safe workflow activity" } } } }, "/api/agents/run": { "post": { "summary": "Submit paid agent task", "description": "Trusted agents with credits create a metered task and Work Order.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Work Order created" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "requested_tool", "workflow_context" ], "properties": { "requested_tool": { "type": "string", "enum": [ "packetops", "distributionops", "tokenops", "wever_labs_os" ], "description": "Operating tool requested for this paid agent task. Use tokenops for token settlement, payment request, receipt, and paid-agent usage evidence." }, "requested_capability": { "type": "string" }, "workflow_context": { "type": "string" }, "expected_outputs": { "type": "string" }, "callback_url": { "type": "string", "format": "uri" }, "settlement_reference": { "type": "string", "description": "Optional settlement intent, settlement reference, or provider reference for TokenOps." }, "payment_request_reference": { "type": "string", "description": "Optional payment request, invoice artifact, or provider payment ID for TokenOps." }, "usage_receipt_reference": { "type": "string", "description": "Optional usage receipt or metered debit reference for TokenOps." }, "work_order_context": { "type": "object", "additionalProperties": true, "description": "Optional structured work order context used to improve evidence sufficiency." }, "evidence_items": { "type": "array", "description": "Optional evidence category checklist for TokenOps evidence completion.", "items": { "type": "object", "additionalProperties": true } }, "file_manifest": { "type": "array", "description": "Optional public-safe manifest of uploaded or externally available files.", "items": { "type": "object", "additionalProperties": true } }, "trust_profile_id": { "type": "string", "description": "Optional reviewed agent trust profile ID." }, "quote_id": { "type": "string", "description": "Optional quote ID associated with the paid run." }, "credit_entitlement_id": { "type": "string", "description": "Optional active credit entitlement authorizing the paid run." }, "status_token": { "type": "string", "description": "Optional status token for polling run state." }, "requires_result_attestation": { "type": "boolean", "description": "When true, Wever Labs OS should return a result attestation URL once the task is ready." } } }, "examples": { "tokenops": { "summary": "TokenOps paid agent task", "value": { "requested_tool": "tokenops", "requested_capability": "token_operations", "workflow_context": "Review token settlement evidence, payment request artifacts, usage receipt context, and callback-ready delivery requirements.", "expected_outputs": "TokenOps review, evidence sufficiency status, usage receipt summary, next actions, and delivery package.", "callback_url": "https://example-agent.system/callback" } }, "packetops": { "summary": "PacketOps paid agent task", "value": { "requested_tool": "packetops", "requested_capability": "packet_readiness", "workflow_context": "Review packet context, missing items, evidence sufficiency, and prepare a delivery package.", "expected_outputs": "Readiness review, data request, next actions, receipt, and delivery package." } }, "tokenops_complete": { "summary": "Complete TokenOps evidence package", "value": { "requested_tool": "tokenops", "requested_capability": "token_operations", "workflow_context": "Complete TokenOps evidence review for a funded agent task. Review settlement reference, payment request artifact, credit ledger entry, paid agent task run, usage receipt, result contract, and callback destination. Return a TokenOps result package with evidence status, score, open items, and next actions.", "expected_outputs": "TokenOps result package, evidence sufficiency status, usage receipt summary, settlement trail summary, callback readiness, open items, and delivery package.", "settlement_reference": "stl_demo_20260602_001", "payment_request_reference": "payreq_demo_20260602_001", "usage_receipt_reference": "usage_demo_20260602_001", "work_order_context": { "workflow_name": "TokenOps settlement evidence review", "operating_goal": "Move the work from partial evidence to delivery-ready TokenOps result package.", "customer_safe_context": "Demo evidence only. No private keys, credentials, bank data, regulated records, or production client data." }, "evidence_items": [ { "type": "settlement_reference", "label": "Settlement intent or provider reference", "present": true }, { "type": "payment_request_artifact", "label": "Payment request artifact or invoice token", "present": true }, { "type": "credit_ledger_entry", "label": "Credit ledger entry showing funded entitlement", "present": true }, { "type": "agent_task_run", "label": "Paid agent task run or Work Order record", "present": true }, { "type": "usage_receipt", "label": "Metered usage receipt", "present": true }, { "type": "result_contract", "label": "Result contract or result URL", "present": true }, { "type": "callback_destination", "label": "Callback URL or delivery destination", "present": true } ], "file_manifest": [ { "filename": "tokenops-demo-settlement-reference.json", "content_type": "application/json", "description": "Demo settlement reference and payment request metadata." }, { "filename": "tokenops-demo-usage-receipt.json", "content_type": "application/json", "description": "Demo metered usage receipt and task run summary." } ], "callback_url": "https://example-agent.system/callback", "trust_profile_id": "trust_demo_agent_001", "quote_id": "quote_demo_tokenops_001", "credit_entitlement_id": "cred_demo_tokenops_001" } }, "tokenops_with_ledger": { "summary": "TokenOps run with task ledger and attestation requested", "value": { "trust_profile_id": "trust_demo_agent_001", "quote_id": "quote_demo_tokenops_001", "credit_entitlement_id": "cred_demo_tokenops_001", "requested_tool": "tokenops", "requested_capability": "tokenops_result_package", "workflow_context": "Complete TokenOps evidence review and return ledger-backed result package.", "expected_outputs": "TokenOps result package, usage receipt, task ledger, result attestation, and callback payload.", "requires_result_attestation": true, "callback_url": "https://example-agent.system/callback" } } } } } }, "x-weverlabs-accepted-tools": [ "packetops", "distributionops", "tokenops", "wever_labs_os" ] } }, "/api/agents/tasks/{token}/advance": { "post": { "summary": "Advance agent task", "description": "Advance a paid agent task one operating step.", "responses": { "200": { "description": "Task advanced" } } } }, "/api/agents/quote": { "post": { "summary": "Request a quote for agent-paid OS usage", "description": "Creates a quote request for token, credit, or digital-currency settlement flow into the Wever Labs credit ledger. Returns estimated credits, evidence expectations, and next actions.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-quote-request.schema.json" }, "examples": { "tokenops_quote": { "summary": "TokenOps quote request", "value": { "request_type": "agent_quote_request", "trust_profile_id": "trust_demo_agent_001", "agent_name": "Example Treasury Agent", "agent_account_id": "agent_acct_demo_001", "requested_tool": "tokenops", "requested_capability": "tokenops_result_package", "workflow_summary": "Review settlement reference, payment request, credit ledger entry, usage receipt, and callback readiness for a TokenOps result package.", "expected_outputs": "Evidence sufficiency score, TokenOps result package, usage receipt, result URL, callback payload, and next actions.", "estimate_basis": { "records_count": 7, "files_count": 3, "needs_callback": true, "needs_result_package": true }, "evidence_manifest": [ { "type": "settlement_reference", "present": true }, { "type": "payment_request_artifact", "present": true }, { "type": "usage_receipt", "present": true } ], "callback_url": "https://example-agent.system/callback", "requested_turnaround": "standard", "public_safe_note": "Demo quote only. No private keys, credentials, regulated records, or production client data included." } } } } } }, "responses": { "200": { "description": "Quote requested", "content": { "application/json": { "examples": { "tokenops_quote_response": { "summary": "TokenOps quote response", "value": { "quote_id": "quote_demo_tokenops_001", "quote_status": "quoted", "requested_tool": "tokenops", "estimated_credits": 3, "minimum_required_evidence": [ "trust_profile", "workflow_summary", "settlement_reference", "payment_request_artifact", "credit_entitlement", "usage_receipt", "callback_url" ], "expires_at": "2026-06-09T21:20:00Z", "next_actions": [ "Fund credit entitlement", "Submit paid agent run with quote_id and credit_entitlement_id", "Use status endpoint until result package is ready" ] } } } } } }, "400": { "description": "Missing required fields" } } } }, "/api/agents/settlement-intents": { "post": { "summary": "Create a settlement intent through the agent-facing settlement gateway", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Settlement intent created" } } } }, "/api/agents/payment-requests/{token}": { "get": { "summary": "Retrieve payment request status", "responses": { "200": { "description": "Payment request status" }, "404": { "description": "Payment request not found" } } } }, "/api/agents/tasks/{token}/result": { "get": { "summary": "Retrieve Agent Result Contract v2", "responses": { "200": { "description": "Agent result contract or TokenOps result package", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "https://weverlabs.com/schemas/agent-result-contract-v2.schema.json" }, { "$ref": "https://weverlabs.com/schemas/delivery-package.schema.json" }, { "$ref": "https://weverlabs.com/schemas/tokenops-result-package.schema.json" }, { "$ref": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json" }, { "$ref": "https://weverlabs.com/schemas/agent-callback-payload.schema.json" } ] }, "examples": { "tokenops_result_package": { "summary": "TokenOps Result Package v1", "value": { "package_type": "tokenops_result_package", "operating_tool": "tokenops", "evidence_status": "sufficient", "evidence_score": 95, "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "settlement_reference": "stl_demo_20260602_001", "payment_request": { "reference": "payreq_demo_20260602_001", "provider": "test_provider", "status": "confirmed" }, "usage_receipt": { "reference": "usage_demo_20260602_001", "credits_debited": 1, "remaining_credits": 9 }, "received_inputs": 7, "uploaded_files": [ { "filename": "tokenops-demo-settlement-reference.json", "purpose": "settlement and payment request evidence" }, { "filename": "tokenops-demo-usage-receipt.json", "purpose": "metered task and receipt evidence" } ], "result_contract": { "status": "ready", "result_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result" }, "callback_delivery": { "status": "ready", "callback_url_present": true }, "executive_summary": "The TokenOps run has enough public-safe evidence to produce a delivery-ready operating record for the funded agent task.", "work_performed": [ "Reviewed settlement reference, payment request artifact, credit ledger entry, paid task run, usage receipt, result contract, and callback destination.", "Checked whether the received inputs support a TokenOps result package rather than a preliminary data request.", "Prepared a public-safe operating summary, open item list, and recommended next actions." ], "findings": [ "Evidence is aligned across settlement, payment request, credit entitlement, task run, receipt, and delivery path.", "No private keys, credentials, or sensitive production records were included in the demo evidence package." ], "open_items": [], "recommended_next_actions": [ "Return the result package to the requesting agent.", "Preserve the usage receipt and Work Order record for audit history.", "Use callback delivery when the requesting agent provides a valid callback URL." ], "client_deliverable": "TokenOps Result Package v1" } }, "agent_result_contract_v2": { "summary": "Agent Result Contract v2", "value": { "object_type": "agent_result_contract", "contract_version": "2.0", "result_contract_id": "result_contract_tokenops_20260603_001", "task_token": "task_demo_tokenops_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "lifecycle_state": "callback_delivered", "result_status": "delivered", "work_order_id": "wo_demo_tokenops_20260603_001", "agent_task_run_id": "atr_demo_tokenops_20260603_001", "handshake_id": "handshake_demo_tokenops_001", "preflight_id": "preflight_demo_tokenops_001", "run_contract_id": "run_contract_tokenops_20260603_001", "trust_profile_id": "trust_agent_demo_001", "quote_id": "quote_tokenops_20260603_001", "credit_entitlement_id": "credit_entitlement_tokenops_20260603_001", "machine_result": { "result_kind": "tokenops_operating_record", "evidence_status": "sufficient", "evidence_score": 95, "operating_tool": "tokenops", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result", "available_next_actions": [ "retrieve_full_result_package", "deliver_to_downstream_agent", "open_follow_on_quote" ] }, "human_summary": { "title": "TokenOps result package delivered", "summary": "The TokenOps run reviewed settlement evidence, credit funding, task ledger state, result package, attestation, usage receipt, and callback delivery for a funded agent task.", "work_performed": [ "Matched settlement receipt to credit entitlement.", "Matched usage receipt to credits consumed by the TokenOps run.", "Connected result package, attestation, task ledger, callback payload, and receipt objects into one downstream-readable contract." ], "findings": [ "Settlement receipt funds credits.", "Usage receipt records work consumed credits.", "Callback delivery returned the result contract to the requesting agent." ], "open_items": [], "next_actions": [ "Retrieve result package", "Preserve receipts", "Use task ledger for audit trail" ] }, "proof_objects": { "task_ledger_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/ledger", "attestation_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/attestation", "run_contract_url": "https://os.weverlabs.com/api/agents/contracts/run_contract_tokenops_20260603_001", "settlement_receipt_url": "https://os.weverlabs.com/api/agents/settlements/stl_demo_tokenops_20260603_001/receipt", "usage_receipt_url": "https://os.weverlabs.com/api/agents/receipts/usage_demo_20260603_001", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result", "callback_payload_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/callback-payload" }, "receipts": { "settlement_receipt_id": "settle_receipt_demo_20260603_001", "settlement_receipt": { "receipt_id": "settle_receipt_demo_20260603_001", "receipt_type": "agent_settlement_receipt", "settlement_id": "stl_demo_tokenops_20260603_001", "settlement_provider": "stripe_stablecoin", "settlement_asset": "USDC", "settlement_amount": 250.0, "settlement_currency": "USD", "provider_reference": "stripe_demo_pi_20260603_001", "payment_request_id": "payreq_tokenops_20260603_001", "payment_request_url": "https://os.weverlabs.com/api/agents/payment-requests/payreq_tokenops_20260603_001", "webhook_event_id": "evt_demo_20260603_001", "webhook_verified": true, "settlement_status": "credits_funded", "provider_status": "confirmed", "credit_entitlement_id": "credit_entitlement_tokenops_20260603_001", "funded_account_id": "agent_acct_demo_001", "credits_funded": 25, "credit_unit": "wever_labs_credit", "release_policy": "automatic_on_provider_confirmation", "usage_receipt_policy": "usage_receipts_record_credits_consumed_after_work_runs", "result_contract_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result-contract", "public_safe_note": "Settlement receipt records provider-confirmed credit funding. Usage receipts separately record work consumed by agent runs.", "issued_at": "2026-06-03T06:45:00Z" }, "usage_receipt_id": "usage_demo_20260603_001", "usage_receipt": { "receipt_id": "usage_demo_20260602_001", "receipt_type": "tokenops_usage_receipt", "operating_tool": "tokenops", "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "settlement_reference": "stl_demo_20260602_001", "payment_request_reference": "payreq_demo_20260602_001", "credit_ledger_entry": { "ledger_entry_id": "ledger_demo_20260602_001", "agent_account_id": "agent_demo_acct_001", "credits_funded": 10, "credits_debited": 1, "remaining_credits": 9, "currency_or_unit": "wever_labs_credit" }, "credits_debited": 1, "remaining_credits": 9, "evidence_status": "sufficient", "evidence_score": 95, "result_status": "ready", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result", "callback_status": "ready", "callback_url_present": true, "public_safe_note": "Demo receipt only. No wallet secrets, private keys, credentials, bank data, or regulated production records are included.", "issued_at": "2026-06-02T19:55:00Z", "contract_id": "contract_demo_tokenops_20260602_001", "run_contract_url": "https://os.weverlabs.com/api/agents/contracts/contract_demo_tokenops_20260602_001", "settlement_receipt_id": "settle_receipt_demo_20260603_001", "settlement_receipt_url": "https://os.weverlabs.com/api/agents/settlements/stl_demo_tokenops_20260603_001/receipt", "receipt_split": "usage_receipt_records_credits_consumed" }, "receipt_split": "settlement_funds_credits_usage_consumes_credits" }, "credit_usage": { "credits_funded": 25, "credits_debited": 1, "remaining_credits": 24, "credit_unit": "wever_labs_credit" }, "callback": { "callback_status": "delivered", "callback_payload_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/callback-payload", "delivered_at": "2026-06-03T06:49:00Z", "next_action": "downstream_agent_can_retrieve_result_package" }, "exception_or_replay": { "exception_state": "none", "replay_state": "not_required" }, "public_safe_note": "Demo object only. Do not place private keys, credentials, wallet secrets, bank data, or regulated production records in public-safe examples.", "issued_at": "2026-06-03T06:50:00Z" } } } } } } }, "description": "Returns task state, Work Order state, delivery package summary, evidence status, usage receipt, credit debit details, and TokenOps result package fields when requested_tool is tokenops." } }, "/api/agents/settlements/webhook": { "post": { "summary": "Receive provider settlement confirmation and fund agent credits", "responses": { "200": { "description": "Settlement confirmed or recorded" } } } }, "/api/agents/receipts/{receipt_id}": { "get": { "summary": "Retrieve usage receipt", "description": "Returns public-safe usage receipt details for agent work that consumed credits. Settlement receipts separately record credit funding.", "parameters": [ { "name": "receipt_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "TokenOps usage receipt", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json" }, "examples": { "usage_receipt": { "summary": "TokenOps usage receipt", "value": { "receipt_id": "usage_demo_20260602_001", "receipt_type": "tokenops_usage_receipt", "operating_tool": "tokenops", "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "settlement_reference": "stl_demo_20260602_001", "payment_request_reference": "payreq_demo_20260602_001", "credit_ledger_entry": { "ledger_entry_id": "ledger_demo_20260602_001", "agent_account_id": "agent_demo_acct_001", "credits_funded": 10, "credits_debited": 1, "remaining_credits": 9, "currency_or_unit": "wever_labs_credit" }, "credits_debited": 1, "remaining_credits": 9, "evidence_status": "sufficient", "evidence_score": 95, "result_status": "ready", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result", "callback_status": "ready", "callback_url_present": true, "public_safe_note": "Demo receipt only. No wallet secrets, private keys, credentials, bank data, or regulated production records are included.", "issued_at": "2026-06-02T19:55:00Z" } } } } } }, "404": { "description": "Receipt not found" } } } }, "/api/agents/tasks/{token}/callback-payload": { "get": { "summary": "Retrieve agent callback payload", "description": "Returns the callback payload that can be delivered to the requesting agent or system after the task result is ready, partial, failed, or delivered.", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent callback payload", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-callback-payload.schema.json" }, "examples": { "callback_payload": { "summary": "Agent callback payload", "value": { "payload_type": "agent_callback_payload", "event_type": "task_result_ready", "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "result_status": "ready", "result_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result", "receipt_url": "https://os.weverlabs.com/api/agents/receipts/usage_demo_20260602_001", "usage_receipt": { "receipt_id": "usage_demo_20260602_001", "receipt_type": "tokenops_usage_receipt", "operating_tool": "tokenops", "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "settlement_reference": "stl_demo_20260602_001", "payment_request_reference": "payreq_demo_20260602_001", "credit_ledger_entry": { "ledger_entry_id": "ledger_demo_20260602_001", "agent_account_id": "agent_demo_acct_001", "credits_funded": 10, "credits_debited": 1, "remaining_credits": 9, "currency_or_unit": "wever_labs_credit" }, "credits_debited": 1, "remaining_credits": 9, "evidence_status": "sufficient", "evidence_score": 95, "result_status": "ready", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result", "callback_status": "ready", "callback_url_present": true, "public_safe_note": "Demo receipt only. No wallet secrets, private keys, credentials, bank data, or regulated production records are included.", "issued_at": "2026-06-02T19:55:00Z" }, "delivery": { "callback_status": "ready", "attempt_count": 0, "last_attempt_at": null, "next_retry_at": null }, "next_available_actions": [ "Retrieve the TokenOps result package.", "Preserve the usage receipt in the requesting agent's operating log.", "Continue the downstream workflow using the result package and callback payload." ], "public_safe_note": "Callback payloads return operating state, result links, and receipt references. They do not carry private keys, secrets, or custody authority.", "issued_at": "2026-06-02T19:56:00Z" } } } } } }, "404": { "description": "Task or callback payload not found" } } } }, "/api/agents/register": { "get": { "summary": "Agent registration endpoint health check", "responses": { "200": { "description": "Endpoint metadata" } } }, "post": { "summary": "Submit an agent trust profile for review", "description": "External agents and systems register identity, purpose, capability scope, callback path, and data posture before quote and paid run access.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-trust-profile.schema.json" }, "examples": { "trust_profile": { "summary": "Agent trust profile", "value": { "profile_id": "trust_demo_agent_001", "profile_type": "agent_trust_profile", "agent_name": "Example Treasury Agent", "operator_contact": { "name": "Example Operator", "email": "ops@example-agent.system", "organization": "Example Agent Systems" }, "system_url": "https://example-agent.system", "documentation_url": "https://example-agent.system/docs", "agent_card_url": "https://example-agent.system/.well-known/agent-card.json", "purpose": "Submit public-safe TokenOps settlement evidence reviews and receive result packages by callback.", "requested_capabilities": [ "token_operations", "tokenops_evidence_completion", "tokenops_usage_receipt", "agent_callback_payload" ], "requested_tools": [ "tokenops" ], "callback": { "callback_url": "https://example-agent.system/callback", "events_requested": [ "task_result_ready", "receipt_issued" ] }, "data_policy": { "allowed_data_modes": [ "public_safe_demo", "metadata_only" ], "public_safe_statement": "No private keys, credentials, regulated records, or confidential production data will be submitted through public surfaces.", "prohibited_inputs_acknowledged": true }, "payment_posture": { "quote_required": true, "preferred_settlement_track": "credit_ledger", "credit_ledger_required": true }, "trust_level": "registered", "risk_tier": "low", "review_status": "approved", "created_at": "2026-06-02T21:10:00Z", "updated_at": "2026-06-02T21:18:00Z" } } } } } }, "responses": { "200": { "description": "Trust profile received for review" }, "400": { "description": "Missing required fields" } } } }, "/api/agents/credits/{entitlement_id}": { "get": { "summary": "Get public-safe credit entitlement status", "parameters": [ { "name": "entitlement_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Credit entitlement status", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-credit-entitlement.schema.json" }, "examples": { "credit_entitlement": { "value": { "entitlement_id": "cred_demo_tokenops_001", "entitlement_type": "agent_credit_entitlement", "agent_account_id": "agent_acct_demo_001", "trust_profile_id": "trust_demo_agent_001", "quote_id": "quote_demo_tokenops_001", "settlement_reference": "stl_demo_20260602_002", "payment_request_reference": "payreq_demo_20260602_002", "status": "active", "credits_authorized": 10, "credits_remaining": 10, "tool_scope": [ "tokenops" ], "allowed_capabilities": [ "token_operations", "tokenops_evidence_completion", "tokenops_result_package", "tokenops_usage_receipt", "agent_callback_payload" ], "metering_policy": { "debit_unit": "wever_labs_credit", "debit_trigger": "approved_paid_agent_run", "receipt_required": true }, "issued_at": "2026-06-02T21:25:00Z", "expires_at": "2026-07-02T21:25:00Z" } } } } } } } } }, "/api/agents/status/{token}": { "get": { "summary": "Get paid agent task status", "description": "Returns public-safe quote, credit, Work Order, evidence, result, receipt, and callback state for a trusted agent task.", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent status response", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-status-response.schema.json" }, "examples": { "ready_status": { "value": { "status_response_type": "agent_status_response", "status_token": "status_demo_tokenops_001", "work_order_id": "wo_demo_tokenops_20260602_002", "agent_task_run_id": "atr_demo_tokenops_20260602_002", "quote_id": "quote_demo_tokenops_001", "credit_entitlement_id": "cred_demo_tokenops_001", "requested_tool": "tokenops", "status": "ready", "evidence_status": "sufficient", "result_status": "ready", "receipt_url": "https://os.weverlabs.com/api/agents/receipts/usage_demo_20260602_002", "callback_status": "ready", "next_actions": [ "Retrieve result package", "Store usage receipt", "Continue downstream workflow using callback payload" ], "updated_at": "2026-06-02T21:40:00Z" } } } } } }, "404": { "description": "Status token not found" } } } }, "/api/agents/tasks/{token}/ledger": { "get": { "summary": "Retrieve a paid agent task ledger", "description": "Returns the public-safe state ledger for a paid agent task run, including Work Order, requested tool, state history, evidence status, credit events, receipt, callback, and result links.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent task ledger", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-task-run.schema.json" } } } }, "404": { "description": "Task ledger not found" } } } }, "/api/agents/tasks/{token}/attestation": { "get": { "summary": "Retrieve a result attestation for a paid agent task", "description": "Returns a compact public-safe attestation for the task result package, evidence status, receipt URL, callback payload URL, and continuation actions.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent result attestation", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-result-attestation.schema.json" } } } }, "404": { "description": "Result attestation not found" } } } }, "/api/agents/tasks/{token}/exceptions": { "get": { "summary": "List exception tickets for a paid agent task", "description": "Returns public-safe exception tickets tied to a task token.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Exception ticket list" } } }, "post": { "summary": "Create agent task exception ticket", "description": "Creates or records a public-safe exception ticket for a paused, partial, or failed run.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentExceptionTicket" } } } }, "responses": { "200": { "description": "Exception ticket created" } } } }, "/api/agents/tasks/{token}/recover": { "post": { "summary": "Submit agent task recovery request", "description": "Supplies missing evidence, callback retry instructions, or a manual review request for a paid agent task.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRecoveryRequest" } } } }, "responses": { "200": { "description": "Recovery request received" } } } }, "/api/agents/tasks/{token}/replay-package": { "get": { "summary": "Get agent task replay package", "description": "Returns a safe replay package for a task after exception review.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Replay package" } } } }, "/api/agents/handshake": { "get": { "summary": "Agent handshake endpoint metadata", "responses": { "200": { "description": "Endpoint metadata" } } }, "post": { "summary": "Submit a public-safe agent handshake request before preflight, trust, quote, credit, or execution", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-handshake-request.schema.json" } } } }, "responses": { "200": { "description": "Handshake received and next step returned" }, "400": { "description": "Missing required fields" } } } }, "/api/agents/preflight": { "post": { "summary": "Run a capability, evidence, trust, quote, credit, and contract readiness check before a paid task", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-preflight-check.schema.json" } } } }, "responses": { "200": { "description": "Preflight check returned" }, "400": { "description": "Missing required fields" } } } }, "/api/agents/contracts": { "post": { "summary": "Create or submit an agent run contract before task execution", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-run-contract.schema.json" } } } }, "responses": { "200": { "description": "Run contract created or accepted" }, "400": { "description": "Missing required fields" } } } }, "/api/agents/contracts/{contract_id}": { "get": { "summary": "Get an agent run contract by contract ID", "parameters": [ { "name": "contract_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Run contract returned" }, "404": { "description": "Contract not found" } } } }, "/api/agents/console": { "get": { "summary": "Get Agent Operating Console snapshot", "description": "Public-safe operator cockpit snapshot for paid agent tasks, lifecycle state, credits, settlements, exceptions, replay, receipts, callbacks, and settlement rail state.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Console snapshot", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-operating-console-snapshot.schema.json" } } } } } } }, "/api/agents/tasks/{token}/lifecycle": { "get": { "summary": "Get canonical lifecycle state for an agent task", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Lifecycle state and transition context" } } } }, "/api/agents/tasks/{token}/retry": { "post": { "summary": "Retry or replay a failed or replay-ready task", "description": "Requests a retry from the last safe checkpoint. The OS should use replay packages where available and preserve task ledger history.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retry accepted or replay package required" }, "409": { "description": "Task is not retryable" } } } }, "/api/agents/live-rail-readiness": { "get": { "summary": "Get live settlement rail readiness", "description": "Inspects provider setup, webhook confirmation, credit funding rules, abuse controls, manual release policy, and pause controls for settlement-funded credits.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Settlement rail state", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-live-rail-readiness.schema.json" } } } } } }, "post": { "summary": "Update live settlement rail readiness record", "description": "Records provider selection and readiness gates. Provider payment processing, settlement confirmation, credit funding, and receipt issuance remain separate operating steps.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-live-rail-readiness.schema.json" } } } }, "responses": { "200": { "description": "Readiness record updated" } } } }, "/api/agents/tasks/{token}/result-contract": { "get": { "summary": "Retrieve Agent Result Contract v2", "description": "Returns the canonical result envelope for an agent task, including machine result, human summary, proof objects, settlement receipt, usage receipt, callback state, and replay state.", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent Result Contract v2", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-result-contract-v2.schema.json" }, "examples": { "tokenops_result_contract": { "summary": "TokenOps Agent Result Contract v2", "value": { "object_type": "agent_result_contract", "contract_version": "2.0", "result_contract_id": "result_contract_tokenops_20260603_001", "task_token": "task_demo_tokenops_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "lifecycle_state": "callback_delivered", "result_status": "delivered", "work_order_id": "wo_demo_tokenops_20260603_001", "agent_task_run_id": "atr_demo_tokenops_20260603_001", "handshake_id": "handshake_demo_tokenops_001", "preflight_id": "preflight_demo_tokenops_001", "run_contract_id": "run_contract_tokenops_20260603_001", "trust_profile_id": "trust_agent_demo_001", "quote_id": "quote_tokenops_20260603_001", "credit_entitlement_id": "credit_entitlement_tokenops_20260603_001", "machine_result": { "result_kind": "tokenops_operating_record", "evidence_status": "sufficient", "evidence_score": 95, "operating_tool": "tokenops", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result", "available_next_actions": [ "retrieve_full_result_package", "deliver_to_downstream_agent", "open_follow_on_quote" ] }, "human_summary": { "title": "TokenOps result package delivered", "summary": "The TokenOps run reviewed settlement evidence, credit funding, task ledger state, result package, attestation, usage receipt, and callback delivery for a funded agent task.", "work_performed": [ "Matched settlement receipt to credit entitlement.", "Matched usage receipt to credits consumed by the TokenOps run.", "Connected result package, attestation, task ledger, callback payload, and receipt objects into one downstream-readable contract." ], "findings": [ "Settlement receipt funds credits.", "Usage receipt records work consumed credits.", "Callback delivery returned the result contract to the requesting agent." ], "open_items": [], "next_actions": [ "Retrieve result package", "Preserve receipts", "Use task ledger for audit trail" ] }, "proof_objects": { "task_ledger_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/ledger", "attestation_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/attestation", "run_contract_url": "https://os.weverlabs.com/api/agents/contracts/run_contract_tokenops_20260603_001", "settlement_receipt_url": "https://os.weverlabs.com/api/agents/settlements/stl_demo_tokenops_20260603_001/receipt", "usage_receipt_url": "https://os.weverlabs.com/api/agents/receipts/usage_demo_20260603_001", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result", "callback_payload_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/callback-payload" }, "receipts": { "settlement_receipt_id": "settle_receipt_demo_20260603_001", "settlement_receipt": { "receipt_id": "settle_receipt_demo_20260603_001", "receipt_type": "agent_settlement_receipt", "settlement_id": "stl_demo_tokenops_20260603_001", "settlement_provider": "stripe_stablecoin", "settlement_asset": "USDC", "settlement_amount": 250.0, "settlement_currency": "USD", "provider_reference": "stripe_demo_pi_20260603_001", "payment_request_id": "payreq_tokenops_20260603_001", "payment_request_url": "https://os.weverlabs.com/api/agents/payment-requests/payreq_tokenops_20260603_001", "webhook_event_id": "evt_demo_20260603_001", "webhook_verified": true, "settlement_status": "credits_funded", "provider_status": "confirmed", "credit_entitlement_id": "credit_entitlement_tokenops_20260603_001", "funded_account_id": "agent_acct_demo_001", "credits_funded": 25, "credit_unit": "wever_labs_credit", "release_policy": "automatic_on_provider_confirmation", "usage_receipt_policy": "usage_receipts_record_credits_consumed_after_work_runs", "result_contract_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result-contract", "public_safe_note": "Settlement receipt records provider-confirmed credit funding. Usage receipts separately record work consumed by agent runs.", "issued_at": "2026-06-03T06:45:00Z" }, "usage_receipt_id": "usage_demo_20260603_001", "usage_receipt": { "receipt_id": "usage_demo_20260602_001", "receipt_type": "tokenops_usage_receipt", "operating_tool": "tokenops", "work_order_id": "wo_demo_tokenops_20260602_001", "agent_task_run_id": "atr_demo_tokenops_20260602_001", "requested_tool": "tokenops", "requested_capability": "token_operations", "settlement_reference": "stl_demo_20260602_001", "payment_request_reference": "payreq_demo_20260602_001", "credit_ledger_entry": { "ledger_entry_id": "ledger_demo_20260602_001", "agent_account_id": "agent_demo_acct_001", "credits_funded": 10, "credits_debited": 1, "remaining_credits": 9, "currency_or_unit": "wever_labs_credit" }, "credits_debited": 1, "remaining_credits": 9, "evidence_status": "sufficient", "evidence_score": 95, "result_status": "ready", "result_package_url": "https://os.weverlabs.com/api/agents/tasks/demo-token/result", "callback_status": "ready", "callback_url_present": true, "public_safe_note": "Demo receipt only. No wallet secrets, private keys, credentials, bank data, or regulated production records are included.", "issued_at": "2026-06-02T19:55:00Z", "contract_id": "contract_demo_tokenops_20260602_001", "run_contract_url": "https://os.weverlabs.com/api/agents/contracts/contract_demo_tokenops_20260602_001", "settlement_receipt_id": "settle_receipt_demo_20260603_001", "settlement_receipt_url": "https://os.weverlabs.com/api/agents/settlements/stl_demo_tokenops_20260603_001/receipt", "receipt_split": "usage_receipt_records_credits_consumed" }, "receipt_split": "settlement_funds_credits_usage_consumes_credits" }, "credit_usage": { "credits_funded": 25, "credits_debited": 1, "remaining_credits": 24, "credit_unit": "wever_labs_credit" }, "callback": { "callback_status": "delivered", "callback_payload_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/callback-payload", "delivered_at": "2026-06-03T06:49:00Z", "next_action": "downstream_agent_can_retrieve_result_package" }, "exception_or_replay": { "exception_state": "none", "replay_state": "not_required" }, "public_safe_note": "Demo object only. Do not place private keys, credentials, wallet secrets, bank data, or regulated production records in public-safe examples.", "issued_at": "2026-06-03T06:50:00Z" } } } } } }, "404": { "description": "Result contract not found" } } } }, "/api/agents/settlements/{settlement_id}/receipt": { "get": { "summary": "Retrieve settlement receipt", "description": "Returns the provider-side settlement receipt that funded credits for an agent account or entitlement.", "parameters": [ { "name": "settlement_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent settlement receipt", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-settlement-receipt.schema.json" }, "examples": { "stripe_stablecoin_settlement_receipt": { "summary": "Stripe stablecoin settlement receipt", "value": { "receipt_id": "settle_receipt_demo_20260603_001", "receipt_type": "agent_settlement_receipt", "settlement_id": "stl_demo_tokenops_20260603_001", "settlement_provider": "stripe_stablecoin", "settlement_asset": "USDC", "settlement_amount": 250.0, "settlement_currency": "USD", "provider_reference": "stripe_demo_pi_20260603_001", "payment_request_id": "payreq_tokenops_20260603_001", "payment_request_url": "https://os.weverlabs.com/api/agents/payment-requests/payreq_tokenops_20260603_001", "webhook_event_id": "evt_demo_20260603_001", "webhook_verified": true, "settlement_status": "credits_funded", "provider_status": "confirmed", "credit_entitlement_id": "credit_entitlement_tokenops_20260603_001", "funded_account_id": "agent_acct_demo_001", "credits_funded": 25, "credit_unit": "wever_labs_credit", "release_policy": "automatic_on_provider_confirmation", "usage_receipt_policy": "usage_receipts_record_credits_consumed_after_work_runs", "result_contract_url": "https://os.weverlabs.com/api/agents/tasks/task_demo_tokenops_001/result-contract", "public_safe_note": "Settlement receipt records provider-confirmed credit funding. Usage receipts separately record work consumed by agent runs.", "issued_at": "2026-06-03T06:45:00Z" } } } } } }, "404": { "description": "Settlement receipt not found" } } } }, "/api/os/support-matrix": { "get": { "summary": "Retrieve Wever Labs OS support matrix", "description": "Returns supported rails, operating tools, settlement support, result support, callback support, exception support, replay support, and console support.", "responses": { "200": { "description": "OS support matrix", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/wever-os-support-matrix.schema.json" } } } } } } }, "/api/os/rail-bindings/{task_token}": { "get": { "summary": "Retrieve OS rail binding for a task", "parameters": [ { "name": "task_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent rail binding", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-rail-binding.schema.json" } } } } } } }, "/api/os/runtime-execution-plan": { "post": { "summary": "Create OS runtime execution plan", "description": "Creates a runtime execution plan for a supported agent run before operation.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/os-runtime-execution-plan.schema.json" } } } }, "responses": { "200": { "description": "Runtime execution plan created", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/os-runtime-execution-plan.schema.json" } } } } } } }, "/api/agents/tasks/{token}/support": { "get": { "summary": "Retrieve support state for an agent task", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Task support state and rail binding", "content": { "application/json": { "schema": { "$ref": "https://weverlabs.com/schemas/agent-rail-binding.schema.json" } } } } } } }, "/api/agents/queue-monitor": { "get": { "summary": "Read Agent Queue Scheduler Monitor snapshot", "responses": { "200": { "description": "Queue scheduler monitor snapshot", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentQueueSchedulerMonitor" } } } } } } }, "/api/agents/queue/heartbeat": { "get": { "summary": "Read latest queue scheduler heartbeat", "responses": { "200": { "description": "Queue heartbeat", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentQueueHeartbeat" } } } } } } }, "/api/agents/tasks/{token}/queue-state": { "get": { "summary": "Read queue state for one agent task", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Task queue state and related monitor references" } } } }, "/api/agents/queue/retry": { "post": { "summary": "Submit retry command for a queued, callback, exception, or replay-ready task", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRunRetryCommand" } } } }, "responses": { "200": { "description": "Retry command accepted and bound to task lifecycle" } } } } }, "components": { "schemas": { "ExternalAgentRequest": { "$ref": "https://weverlabs.com/schemas/external-agent-request.schema.json" }, "WorkflowIntake": { "$ref": "https://weverlabs.com/schemas/workflow-intake.schema.json" }, "DeliveryPackage": { "$ref": "https://weverlabs.com/schemas/delivery-package.schema.json" }, "TokenOpsResultPackage": { "$ref": "https://weverlabs.com/schemas/tokenops-result-package.schema.json" }, "TokenOpsUsageReceipt": { "$ref": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json" }, "AgentCallbackPayload": { "$ref": "https://weverlabs.com/schemas/agent-callback-payload.schema.json" }, "AgentTrustProfile": { "$ref": "https://weverlabs.com/schemas/agent-trust-profile.schema.json" }, "AgentQuoteRequest": { "$ref": "https://weverlabs.com/schemas/agent-quote-request.schema.json" }, "AgentCreditEntitlement": { "$ref": "https://weverlabs.com/schemas/agent-credit-entitlement.schema.json" }, "AgentStatusResponse": { "$ref": "https://weverlabs.com/schemas/agent-status-response.schema.json" }, "AgentTaskRun": { "$ref": "https://weverlabs.com/schemas/agent-task-run.schema.json" }, "AgentRunStateEvent": { "$ref": "https://weverlabs.com/schemas/agent-run-state-event.schema.json" }, "AgentResultAttestation": { "$ref": "https://weverlabs.com/schemas/agent-result-attestation.schema.json" }, "AgentExceptionTicket": { "$ref": "https://weverlabs.com/schemas/agent-exception-ticket.schema.json" }, "AgentRecoveryRequest": { "$ref": "https://weverlabs.com/schemas/agent-recovery-request.schema.json" }, "AgentReplayPackage": { "$ref": "https://weverlabs.com/schemas/agent-replay-package.schema.json" }, "AgentHandshakeRequest": { "$ref": "https://weverlabs.com/schemas/agent-handshake-request.schema.json" }, "AgentPreflightCheck": { "$ref": "https://weverlabs.com/schemas/agent-preflight-check.schema.json" }, "AgentRunContract": { "$ref": "https://weverlabs.com/schemas/agent-run-contract.schema.json" }, "AgentOperatingConsoleSnapshot": { "$ref": "https://weverlabs.com/schemas/agent-operating-console-snapshot.schema.json" }, "AgentTaskLifecycle": { "$ref": "https://weverlabs.com/schemas/agent-task-lifecycle.schema.json" }, "AgentLiveRailReadiness": { "$ref": "https://weverlabs.com/schemas/agent-live-rail-readiness.schema.json" }, "AgentResultContractV2": { "$ref": "https://weverlabs.com/schemas/agent-result-contract-v2.schema.json" }, "AgentSettlementReceipt": { "$ref": "https://weverlabs.com/schemas/agent-settlement-receipt.schema.json" }, "WeverOsSupportMatrix": { "$ref": "https://weverlabs.com/schemas/wever-os-support-matrix.schema.json" }, "AgentRailBinding": { "$ref": "https://weverlabs.com/schemas/agent-rail-binding.schema.json" }, "OsRuntimeExecutionPlan": { "$ref": "https://weverlabs.com/schemas/os-runtime-execution-plan.schema.json" }, "AgentQueueSchedulerMonitor": { "$ref": "https://weverlabs.com/schemas/agent-queue-scheduler-monitor.schema.json" }, "AgentQueueHeartbeat": { "$ref": "https://weverlabs.com/schemas/agent-queue-heartbeat.schema.json" }, "AgentStuckTaskAlert": { "$ref": "https://weverlabs.com/schemas/agent-stuck-task-alert.schema.json" }, "AgentRunRetryCommand": { "$ref": "https://weverlabs.com/schemas/agent-run-retry-command.schema.json" } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-weverlabs-policy": { "review_required": true, "outside_agents_do_not_receive_os_access": true, "public_endpoints_accept_intake_not_execution": true, "do_not_submit": [ "private keys", "seed phrases", "passwords", "credentials", "API secrets", "regulated records", "confidential production client data" ], "conversion_path": "public request -> external_agent_request or workflow_intake -> OS review -> Work Order -> approved autopilot run -> delivery package", "active_requested_tool_ids": [ "packetops", "distributionops", "tokenops", "wever_labs_os" ] }, "agent_to_agent_economy": "Wever Labs is building workflow infrastructure for agents and systems to discover, quote, route, operate, and return outputs through OS-governed Work Orders.", "x-weverlabs-tokenops": { "evidence_completion": { "docs": "https://weverlabs.com/operating-tools/tokenops/#evidence-completion", "schema": "https://weverlabs.com/schemas/tokenops-result-package.schema.json", "complete_request_example": "https://weverlabs.com/examples/tokenops-complete-agent-run-request.json", "result_package_example": "https://weverlabs.com/examples/tokenops-result-package.json" }, "receipt_and_callback_contracts": { "docs": "https://weverlabs.com/tokenops-receipts/", "usage_receipt_schema": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json", "callback_payload_schema": "https://weverlabs.com/schemas/agent-callback-payload.schema.json", "usage_receipt_example": "https://weverlabs.com/examples/tokenops-usage-receipt.json", "callback_payload_example": "https://weverlabs.com/examples/tokenops-callback-payload.json" } }, "x-weverlabs-trust-quote-credit-rail": { "trust_registry_page": "https://weverlabs.com/agent-trust-registry/", "quote_rail_page": "https://weverlabs.com/agent-quote-rail/", "register_endpoint": "/api/agents/register", "quote_endpoint": "/api/agents/quote", "credit_entitlement_endpoint": "/api/agents/credits/{entitlement_id}", "status_endpoint": "/api/agents/status/{token}" }, "x-weverlabs-task-ledger-result-attestation": { "docs": "https://weverlabs.com/agent-task-ledger/", "ledger_endpoint": "https://os.weverlabs.com/api/agents/tasks/{token}/ledger", "attestation_endpoint": "https://os.weverlabs.com/api/agents/tasks/{token}/attestation", "schemas": [ "https://weverlabs.com/schemas/agent-task-run.schema.json", "https://weverlabs.com/schemas/agent-run-state-event.schema.json", "https://weverlabs.com/schemas/agent-result-attestation.schema.json" ] }, "x-weverlabs-exception-recovery-replay-rail": { "docs": "https://weverlabs.com/agent-exception-rail/", "exception_endpoint": "https://os.weverlabs.com/api/agents/tasks/{token}/exceptions", "recovery_endpoint": "https://os.weverlabs.com/api/agents/tasks/{token}/recover", "replay_package_endpoint": "https://os.weverlabs.com/api/agents/tasks/{token}/replay-package", "exception_ticket_schema": "https://weverlabs.com/schemas/agent-exception-ticket.schema.json", "recovery_request_schema": "https://weverlabs.com/schemas/agent-recovery-request.schema.json", "replay_package_schema": "https://weverlabs.com/schemas/agent-replay-package.schema.json", "principle": "Paused, partial, or failed paid agent runs should become recoverable operating objects instead of silent dead ends." }, "x-weverlabs-handshake-preflight-contract-rail": { "docs": "https://weverlabs.com/agent-handshake/", "contracts_docs": "https://weverlabs.com/agent-run-contracts/", "handshake_endpoint": "https://os.weverlabs.com/api/agents/handshake", "preflight_endpoint": "https://os.weverlabs.com/api/agents/preflight", "contract_endpoint": "https://os.weverlabs.com/api/agents/contracts", "contract_status_endpoint": "https://os.weverlabs.com/api/agents/contracts/{contract_id}", "handshake_schema": "https://weverlabs.com/schemas/agent-handshake-request.schema.json", "preflight_schema": "https://weverlabs.com/schemas/agent-preflight-check.schema.json", "run_contract_schema": "https://weverlabs.com/schemas/agent-run-contract.schema.json", "principle": "External agents should be able to negotiate capability fit and scope before quote, credit debit, or task execution." }, "x-weverlabs-agent-operating-console-lifecycle-rail": { "name": "Agent Operating Console v2 + Lifecycle Standardization", "url": "https://weverlabs.com/agent-operating-console/", "description": "Operator cockpit for paid agent runs, credits, settlement intents, lifecycle state, callbacks, exceptions, replay, receipts, and settlement rail state.", "console_snapshot_schema": "https://weverlabs.com/schemas/agent-operating-console-snapshot.schema.json", "lifecycle_schema": "https://weverlabs.com/schemas/agent-task-lifecycle.schema.json", "live_rail_readiness_schema": "https://weverlabs.com/schemas/agent-live-rail-readiness.schema.json", "console_snapshot_example": "https://weverlabs.com/examples/agent-operating-console-snapshot-tokenops.json", "settlement_policy": "Provider settlement funds credits. Usage receipts record OS work that consumes credits. Webhook verification, release controls, rate limits, abuse controls, legal terms, and pause controls remain visible in the operating loop.", "canonical_lifecycle_states": [ "created", "preflight_checked", "contract_ready", "contract_accepted", "trust_pending", "trusted", "quoted", "credit_pending", "credit_funded", "queued", "operating", "evidence_partial", "result_ready", "attested", "receipt_issued", "callback_pending", "callback_delivered", "exception_open", "replay_ready", "failed", "closed" ] }, "x-weverlabs-result-contract-settlement-receipt-split": { "version": "1.0", "documentation": "https://weverlabs.com/agent-result-contract/", "settlement_receipts": "https://weverlabs.com/settlement-receipts/", "schemas": { "agent_result_contract_v2": "https://weverlabs.com/schemas/agent-result-contract-v2.schema.json", "agent_settlement_receipt": "https://weverlabs.com/schemas/agent-settlement-receipt.schema.json", "tokenops_usage_receipt": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json" }, "receipt_split": "settlement_receipt_funds_credits_usage_receipt_records_consumed_credits" }, "x-weverlabs-queue-scheduler-monitor-runtime-heartbeat": { "public_page": "https://weverlabs.com/agent-queue-monitor/", "schemas": [ "https://weverlabs.com/schemas/agent-queue-scheduler-monitor.schema.json", "https://weverlabs.com/schemas/agent-queue-heartbeat.schema.json", "https://weverlabs.com/schemas/agent-stuck-task-alert.schema.json", "https://weverlabs.com/schemas/agent-run-retry-command.schema.json" ], "examples": [ "https://weverlabs.com/examples/agent-queue-scheduler-monitor-tokenops.json", "https://weverlabs.com/examples/agent-queue-heartbeat-tokenops.json", "https://weverlabs.com/examples/tokenops-stuck-task-alert.json", "https://weverlabs.com/examples/tokenops-run-retry-command.json" ], "runtime_role": "Keeps agent-paid OS work moving through queue heartbeat, stuck-task alerts, retry commands, replay readiness, callback pressure, and settlement-credit pressure." } }