{
  "id": "tokenops",
  "name": "TokenOps",
  "version": "0.1.9",
  "type": "operating_tool_manifest",
  "owner": "Wever Labs OS",
  "url": "https://weverlabs.com/operating-tools/tokenops/",
  "manifest_url": "https://weverlabs.com/operating-tools/tokenops/manifest.json",
  "description": "Agent-native operating surface for token settlement evidence, agent-paid usage records, digital-asset workflow evidence, usage receipts, settlement references, callback delivery, and TokenOps result packages.",
  "operating_domain": "token_operations",
  "accepted_workflow_types": [
    "token_operations",
    "settlement_evidence_review",
    "agent_paid_usage_review",
    "tokenized_asset_operations",
    "digital_asset_operating_record",
    "agent_exception_ticket",
    "agent_recovery_request",
    "agent_replay_package",
    "agent_handshake_request",
    "agent_preflight_check",
    "agent_run_contract",
    "agent_result_contract_v2",
    "agent_settlement_receipt",
    "settlement_receipt_split",
    "wever_os_support_matrix",
    "agent_rail_binding",
    "os_runtime_execution_plan"
  ],
  "accepted_inputs": [
    "settlement_reference",
    "payment_request_artifact",
    "settlement_webhook_event",
    "agent_task_run",
    "usage_receipt",
    "result_contract",
    "callback_delivery",
    "tokenized_asset_context",
    "distribution_event_context",
    "tokenops_result_package",
    "uploaded_file_manifest",
    "callback_delivery_record",
    "receipt_ledger_entry",
    "agent_callback_payload",
    "callback_payload",
    "callback_retry_state",
    "agent_trust_profile",
    "agent_quote_request",
    "agent_credit_entitlement",
    "agent_status_response",
    "agent_run_state_event",
    "agent_result_attestation",
    "task_ledger_url",
    "result_attestation_url",
    "exception_ticket",
    "recovery_request",
    "replay_package",
    "missing_evidence_list",
    "callback_failure_record",
    "agent_handshake_request",
    "agent_preflight_check",
    "agent_run_contract",
    "contract_id",
    "preflight_id",
    "handshake_id",
    "agent_result_contract",
    "settlement_receipt",
    "result_delivery_envelope",
    "wever_os_support_matrix",
    "agent_rail_binding",
    "os_runtime_execution_plan",
    "support_matrix_url",
    "rail_binding_url"
  ],
  "evidence_requirements": [
    "settlement intent or reference",
    "payment request artifact or provider ID",
    "credit ledger entry or funded entitlement",
    "paid agent task run or Work Order record",
    "usage receipt or metered debit record",
    "result contract or result URL",
    "callback destination and callback status if applicable",
    "public-safe uploaded files or file manifest when the run needs documentary evidence",
    "agent_trust_profile",
    "agent_quote_request",
    "agent_credit_entitlement",
    "agent_status_response",
    "agent task ledger URL or task run record",
    "result attestation when a downstream agent needs proof of completion",
    "exception ticket when the task is paused or partial",
    "recovery request when missing evidence is supplied",
    "replay package before resuming a stopped run",
    "agent run contract before paid TokenOps execution when a requesting agent needs scoped result delivery",
    "rail binding when downstream agents need full OS support context",
    "result contract URL when machine-readable return is requested"
  ],
  "workflow_states": [
    "intake",
    "evidence_review",
    "operating_record_created",
    "review_ready",
    "delivery_ready"
  ],
  "output_modes": [
    "audit_ready_package",
    "data_request",
    "evidence_summary",
    "operating_record",
    "settlement_trail_summary",
    "tokenops_result_package",
    "tokenops_review",
    "usage_receipt_summary",
    "usage_receipt_contract",
    "callback_payload_contract",
    "receipt_ledger_entry",
    "agent_trust_profile",
    "agent_quote_request",
    "agent_credit_entitlement",
    "agent_status_response",
    "agent_task_run_summary",
    "agent_run_state_event",
    "agent_result_attestation",
    "agent_exception_ticket",
    "agent_recovery_request",
    "agent_replay_package",
    "safe_replay_summary",
    "agent_result_contract_v2",
    "settlement_receipt_split",
    "result_delivery_envelope"
  ],
  "os_entrypoints": {
    "agent_run_gateway": "https://os.weverlabs.com/api/agents/run",
    "settlement_intents": "https://os.weverlabs.com/api/agents/settlement-intents",
    "payment_requests": "https://os.weverlabs.com/api/agents/payment-requests/{token}",
    "task_results": "https://os.weverlabs.com/api/agents/tasks/{token}/result",
    "agent_run_gateway_docs": "https://weverlabs.com/agent-run-gateway/",
    "tokenops_result_package_schema": "https://weverlabs.com/schemas/tokenops-result-package.schema.json",
    "usage_receipts": "https://os.weverlabs.com/api/agents/receipts/{receipt_id}",
    "callback_payloads": "https://os.weverlabs.com/api/agents/tasks/{token}/callback-payload",
    "usage_receipt_schema": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json",
    "callback_payload_schema": "https://weverlabs.com/schemas/agent-callback-payload.schema.json",
    "agent_task_ledger": "https://os.weverlabs.com/api/agents/tasks/{token}/ledger",
    "agent_result_attestation": "https://os.weverlabs.com/api/agents/tasks/{token}/attestation",
    "agent_task_ledger_docs": "https://weverlabs.com/agent-task-ledger/",
    "agent_task_run_schema": "https://weverlabs.com/schemas/agent-task-run.schema.json",
    "agent_result_attestation_schema": "https://weverlabs.com/schemas/agent-result-attestation.schema.json",
    "agent_exception_rail": "https://weverlabs.com/agent-exception-rail/",
    "agent_task_exceptions": "https://os.weverlabs.com/api/agents/tasks/{token}/exceptions",
    "agent_task_recover": "https://os.weverlabs.com/api/agents/tasks/{token}/recover",
    "agent_task_replay_package": "https://os.weverlabs.com/api/agents/tasks/{token}/replay-package",
    "agent_exception_ticket_schema": "https://weverlabs.com/schemas/agent-exception-ticket.schema.json",
    "agent_recovery_request_schema": "https://weverlabs.com/schemas/agent-recovery-request.schema.json",
    "agent_replay_package_schema": "https://weverlabs.com/schemas/agent-replay-package.schema.json",
    "agent_result_contract": "https://os.weverlabs.com/api/agents/tasks/{token}/result-contract",
    "settlement_receipt": "https://os.weverlabs.com/api/agents/settlements/{settlement_id}/receipt"
  },
  "agent_to_agent_economy": "TokenOps lets agents and systems preserve settlement, usage, receipt, and operating evidence around token-funded work.",
  "evidence_completion": {
    "status_goal": "Move TokenOps work from partial evidence to sufficient evidence before delivery package generation.",
    "sufficient": "90 to 100 evidence score with the core settlement, payment request, credit, task run, usage receipt, result contract, and delivery path present.",
    "partial": "50 to 89 evidence score or one or more core evidence categories missing. Return preliminary review plus data request.",
    "insufficient": "0 to 49 evidence score or no reliable settlement, payment, task, or receipt context. Return intake review plus data request.",
    "core_evidence_categories": [
      "settlement_reference",
      "payment_request_artifact",
      "credit_ledger_entry",
      "agent_task_run",
      "usage_receipt",
      "result_contract",
      "callback_delivery"
    ]
  },
  "delivery_package": {
    "schema_url": "https://weverlabs.com/schemas/tokenops-result-package.schema.json",
    "example_url": "https://weverlabs.com/examples/tokenops-result-package.json",
    "complete_request_example_url": "https://weverlabs.com/examples/tokenops-complete-agent-run-request.json",
    "usage_receipt_schema_url": "https://weverlabs.com/schemas/tokenops-usage-receipt.schema.json",
    "callback_payload_schema_url": "https://weverlabs.com/schemas/agent-callback-payload.schema.json"
  },
  "receipt_and_callback_contracts": {
    "public_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",
    "evidence_file_manifest_example": "https://weverlabs.com/examples/tokenops-evidence-file-manifest.json",
    "principle": "Return the operating record, not only a success flag."
  },
  "trust_quote_credit_rail": {
    "trust_registry": "https://weverlabs.com/agent-trust-registry/",
    "quote_rail": "https://weverlabs.com/agent-quote-rail/",
    "required_preflight_objects": [
      "agent_trust_profile",
      "agent_quote_request",
      "agent_credit_entitlement"
    ],
    "status_response_schema": "https://weverlabs.com/schemas/agent-status-response.schema.json"
  },
  "task_ledger_and_result_attestation": {
    "purpose": "Connect TokenOps result packages, usage receipts, credit debits, and callback payloads to a paid agent task run ledger.",
    "docs": "https://weverlabs.com/agent-task-ledger/",
    "task_run_example": "https://weverlabs.com/examples/tokenops-agent-task-run.json",
    "result_attestation_example": "https://weverlabs.com/examples/tokenops-result-attestation.json"
  },
  "exception_recovery": {
    "purpose": "Let TokenOps partial runs expose missing evidence, recovery actions, callback retry paths, and safe replay packages.",
    "docs": "https://weverlabs.com/agent-exception-rail/",
    "exception_ticket_example": "https://weverlabs.com/examples/tokenops-agent-exception-ticket.json",
    "recovery_request_example": "https://weverlabs.com/examples/tokenops-recovery-request.json",
    "replay_package_example": "https://weverlabs.com/examples/tokenops-replay-package.json"
  },
  "handshake_preflight_contract": {
    "handshake_docs": "https://weverlabs.com/agent-handshake/",
    "contract_docs": "https://weverlabs.com/agent-run-contracts/",
    "handshake_example": "https://weverlabs.com/examples/tokenops-agent-handshake-request.json",
    "preflight_example": "https://weverlabs.com/examples/tokenops-preflight-check.json",
    "run_contract_example": "https://weverlabs.com/examples/tokenops-run-contract.json",
    "run_contract_schema": "https://weverlabs.com/schemas/agent-run-contract.schema.json"
  },
  "agent_result_contract_v2_settlement_receipt_split": {
    "documentation": "https://weverlabs.com/agent-result-contract/",
    "settlement_receipts": "https://weverlabs.com/settlement-receipts/",
    "result_contract_schema": "https://weverlabs.com/schemas/agent-result-contract-v2.schema.json",
    "settlement_receipt_schema": "https://weverlabs.com/schemas/agent-settlement-receipt.schema.json",
    "tokenops_example": "https://weverlabs.com/examples/tokenops-agent-result-contract-v2.json",
    "receipt_split": "settlement_receipt_funds_credits_usage_receipt_records_consumed_credits"
  },
  "os_support_matrix_runtime_binding": {
    "documentation": "https://weverlabs.com/os-support-matrix/",
    "rail_binding_example": "https://weverlabs.com/examples/tokenops-agent-rail-binding.json",
    "runtime_execution_plan_example": "https://weverlabs.com/examples/tokenops-os-runtime-execution-plan.json"
  },
  "queue_scheduler_monitor": {
    "schema": "https://weverlabs.com/schemas/agent-queue-scheduler-monitor.schema.json",
    "example": "https://weverlabs.com/examples/agent-queue-scheduler-monitor-tokenops.json"
  }
}