Ardaro Agent Runtime Utilities
Advisory context, intent, budget and API-ledger checks with free examples and x402 payments.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~11,994token 数（工具定义）
~23.5 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 9.37%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"ardaro-agent-utilities": {
"url": "https://agents.getardaro.com/mcp/utilities"
}
}
}远程端点
https://agents.getardaro.com/mcp/utilitiesstreamable-http它能做什么
工具清单
工具（6）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢compress_agent_context(raw_conversation_history)
Return a blank-line compaction candidate for human review. Preserves words and role headers. No verified token savings, semantic equivalence or speed improvement. Paid: 0.05 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='compress_agent_context' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
输入模式
{
"type": "object",
"properties": {
"raw_conversation_history": {
"type": "string",
"minLength": 1,
"maxLength": 32768,
"description": "Caller-supplied text; do not submit secrets or private tenant data."
}
},
"required": [
"raw_conversation_history"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.compress_agent_context"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "REVIEW_CANDIDATE"
},
"compressed_prompt_payload": {
"type": "string",
"minLength": 1,
"maxLength": 32768
},
"transformation": {
"type": "string",
"const": "Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed"
},
"original_characters": {
"type": "integer",
"minimum": 1,
"maximum": 32768
},
"candidate_characters": {
"type": "integer",
"minimum": 1,
"maximum": 32768
},
"characters_removed": {
"type": "integer",
"minimum": 0,
"maximum": 32767
},
"tokens_saved": {
"type": "null"
},
"tokenizer_used": {
"type": "null"
},
"compression_ratio": {
"type": "null"
},
"semantic_preservation_verified": {
"type": "boolean",
"const": false
},
"human_review_required": {
"type": "boolean",
"const": true
},
"latency_or_cost_savings_verified": {
"type": "boolean",
"const": false
}
},
"required": [
"status",
"compressed_prompt_payload",
"transformation",
"original_characters",
"candidate_characters",
"characters_removed",
"tokens_saved",
"tokenizer_used",
"compression_ratio",
"semantic_preservation_verified",
"human_review_required",
"latency_or_cost_savings_verified"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity",
"payment_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"message": {
"type": "string",
"maxLength": 300
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"service_code",
"message",
"retryable",
"remediation"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"service_code": {
"enum": [
"ARDARO_ARITHMETIC_MISMATCH",
"ARDARO_DOCUMENT_TOO_LARGE",
"ARDARO_DUPLICATE_SUSPECTED",
"ARDARO_EXTRACTION_LOW_CONFIDENCE",
"ARDARO_IDEMPOTENCY_CONFLICT",
"ARDARO_INPUT_UNSUPPORTED",
"ARDARO_PAYMENT_INVALID",
"ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
"ARDARO_PAYMENT_REQUIRED",
"ARDARO_RATE_LIMITED",
"ARDARO_SERVICE_UNAVAILABLE"
]
},
"message": {
"type": "string",
"maxLength": 280
},
"retryable": {
"type": "boolean"
},
"remediation": {
"type": "string",
"maxLength": 280
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"service",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "not_ready"
},
"service": {
"const": "ardaro-receipt-intelligence"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"message": {
"const": "Service is not ready."
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"accepts"
],
"properties": {
"x402Version": {
"type": "integer",
"const": 2,
"default": 2
},
"error": {
"type": [
"string",
"null"
]
},
"resource": {
"oneOf": [
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"mimeType": {
"type": [
"string",
"null"
]
},
"serviceName": {
"type": [
"string",
"null"
]
},
"tags": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"iconUrl": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds"
],
"properties": {
"scheme": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"amount": {
"type": "string"
},
"payTo": {
"type": "string"
},
"maxTimeoutSeconds": {
"type": "integer"
},
"extra": {
"type": "object",
"additionalProperties": true
}
}
}
},
"extensions": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"message": {
"type": "string"
}
}
}
]
}🟢route_model_intent(intent_payload)
Classify text with a bounded keyword heuristic for human review. Does not execute a model, select a verified cheapest model or prove routing savings. Paid: 0.15 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='route_model_intent' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
输入模式
{
"type": "object",
"properties": {
"intent_payload": {
"type": "string",
"minLength": 1,
"maxLength": 32768,
"description": "Caller-supplied text; do not submit secrets or private tenant data."
}
},
"required": [
"intent_payload"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.route_model_intent"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "ADVISORY_ROUTE"
},
"route_category": {
"type": "string",
"enum": [
"structured-calculation-review",
"general-text-review"
]
},
"routing_basis": {
"type": "string",
"const": "Keyword heuristic only; no model capability, availability or price comparison"
},
"recommended_model": {
"type": "null"
},
"route_executed": {
"type": "boolean",
"const": false
},
"human_review_required": {
"type": "boolean",
"const": true
}
},
"required": [
"status",
"route_category",
"routing_basis",
"recommended_model",
"route_executed",
"human_review_required"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity",
"payment_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"message": {
"type": "string",
"maxLength": 300
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"service_code",
"message",
"retryable",
"remediation"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"service_code": {
"enum": [
"ARDARO_ARITHMETIC_MISMATCH",
"ARDARO_DOCUMENT_TOO_LARGE",
"ARDARO_DUPLICATE_SUSPECTED",
"ARDARO_EXTRACTION_LOW_CONFIDENCE",
"ARDARO_IDEMPOTENCY_CONFLICT",
"ARDARO_INPUT_UNSUPPORTED",
"ARDARO_PAYMENT_INVALID",
"ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
"ARDARO_PAYMENT_REQUIRED",
"ARDARO_RATE_LIMITED",
"ARDARO_SERVICE_UNAVAILABLE"
]
},
"message": {
"type": "string",
"maxLength": 280
},
"retryable": {
"type": "boolean"
},
"remediation": {
"type": "string",
"maxLength": 280
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"service",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "not_ready"
},
"service": {
"const": "ardaro-receipt-intelligence"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"message": {
"const": "Service is not ready."
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"accepts"
],
"properties": {
"x402Version": {
"type": "integer",
"const": 2,
"default": 2
},
"error": {
"type": [
"string",
"null"
]
},
"resource": {
"oneOf": [
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"mimeType": {
"type": [
"string",
"null"
]
},
"serviceName": {
"type": [
"string",
"null"
]
},
"tags": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"iconUrl": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds"
],
"properties": {
"scheme": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"amount": {
"type": "string"
},
"payTo": {
"type": "string"
},
"maxTimeoutSeconds": {
"type": "integer"
},
"extra": {
"type": "object",
"additionalProperties": true
}
}
}
},
"extensions": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"message": {
"type": "string"
}
}
}
]
}🟢authorize_agent_spend(proposed_cost, currency, policy, history)
Compare a proposed downstream cost with caller-supplied limits and history. Advisory only: does not authenticate policy, reserve funds, issue authorization or block external API calls. Evaluation excludes this service fee. Paid: 0.10 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='authorize_agent_spend' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
输入模式
{
"type": "object",
"properties": {
"proposed_cost": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"policy": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"max_per_transaction": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"max_per_hour": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"max_checks_per_minute": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
}
},
"required": [
"currency",
"max_per_transaction",
"max_per_hour",
"max_checks_per_minute"
],
"additionalProperties": false
},
"history": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"committed_last_hour": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"pending_reserved": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"checks_last_minute": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"currency",
"committed_last_hour",
"pending_reserved",
"checks_last_minute"
],
"additionalProperties": false
}
},
"required": [
"proposed_cost",
"currency",
"policy",
"history"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.authorize_agent_spend"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"tool": {
"const": "authorize_agent_spend"
},
"authorization_status": {
"enum": [
"WITHIN_SUBMITTED_LIMITS",
"EXCEEDS_SUBMITTED_LIMITS",
"RATE_THRESHOLD_EXCEEDED",
"CURRENCY_MISMATCH"
]
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"policy_currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"history_currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"proposed_cost": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"submitted_budget_in_use": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"proposed_hour_total": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"hourly_remaining_after_proposal": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"checks": {
"type": "object",
"properties": {
"currency_consistent": {
"type": "boolean"
},
"transaction_within_limit": {
"type": [
"boolean",
"null"
]
},
"hourly_within_limit": {
"type": [
"boolean",
"null"
]
},
"rate_within_limit": {
"type": "boolean"
}
},
"required": [
"currency_consistent",
"transaction_within_limit",
"hourly_within_limit",
"rate_within_limit"
],
"additionalProperties": false
},
"findings": {
"type": "array",
"maxItems": 3,
"uniqueItems": true,
"items": {
"enum": [
"CURRENCY_MISMATCH",
"TRANSACTION_LIMIT_EXCEEDED",
"HOURLY_LIMIT_EXCEEDED",
"RATE_THRESHOLD_EXCEEDED"
]
}
},
"policy": {
"type": "object",
"properties": {
"advisory_only": {
"const": true
},
"stateless": {
"const": true
},
"submitted_records_retained": {
"const": false
},
"caller_identity_authenticated": {
"const": false
},
"submitted_evidence_verified": {
"const": false
},
"external_spend_enforced": {
"const": false
},
"downstream_payment_authorized": {
"const": false
},
"reservation_created": {
"const": false
},
"ledger_updated": {
"const": false
},
"credentials_issued": {
"const": false
},
"delivery_verified": {
"const": false
},
"model_calls": {
"const": 0
},
"human_review_required": {
"const": true
},
"policy_authenticated": {
"const": false
},
"history_verified": {
"const": false
},
"checks_exclude_service_fee": {
"const": true
},
"scope": {
"const": "Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled."
},
"fee_scope": {
"const": "The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed."
},
"history_scope": {
"const": "The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified."
}
},
"required": [
"advisory_only",
"stateless",
"submitted_records_retained",
"caller_identity_authenticated",
"submitted_evidence_verified",
"external_spend_enforced",
"downstream_payment_authorized",
"reservation_created",
"ledger_updated",
"credentials_issued",
"delivery_verified",
"model_calls",
"human_review_required",
"policy_authenticated",
"history_verified",
"checks_exclude_service_fee",
"scope",
"fee_scope",
"history_scope"
],
"additionalProperties": false
}
},
"required": [
"tool",
"authorization_status",
"currency",
"policy_currency",
"history_currency",
"proposed_cost",
"submitted_budget_in_use",
"proposed_hour_total",
"hourly_remaining_after_proposal",
"checks",
"findings",
"policy"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity",
"payment_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"message": {
"type": "string",
"maxLength": 300
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"service_code",
"message",
"retryable",
"remediation"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"service_code": {
"enum": [
"ARDARO_ARITHMETIC_MISMATCH",
"ARDARO_DOCUMENT_TOO_LARGE",
"ARDARO_DUPLICATE_SUSPECTED",
"ARDARO_EXTRACTION_LOW_CONFIDENCE",
"ARDARO_IDEMPOTENCY_CONFLICT",
"ARDARO_INPUT_UNSUPPORTED",
"ARDARO_PAYMENT_INVALID",
"ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
"ARDARO_PAYMENT_REQUIRED",
"ARDARO_RATE_LIMITED",
"ARDARO_SERVICE_UNAVAILABLE"
]
},
"message": {
"type": "string",
"maxLength": 280
},
"retryable": {
"type": "boolean"
},
"remediation": {
"type": "string",
"maxLength": 280
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"service",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "not_ready"
},
"service": {
"const": "ardaro-receipt-intelligence"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"message": {
"const": "Service is not ready."
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"accepts"
],
"properties": {
"x402Version": {
"type": "integer",
"const": 2,
"default": 2
},
"error": {
"type": [
"string",
"null"
]
},
"resource": {
"oneOf": [
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"mimeType": {
"type": [
"string",
"null"
]
},
"serviceName": {
"type": [
"string",
"null"
]
},
"tags": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"iconUrl": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds"
],
"properties": {
"scheme": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"amount": {
"type": "string"
},
"payTo": {
"type": "string"
},
"maxTimeoutSeconds": {
"type": "integer"
},
"extra": {
"type": "object",
"additionalProperties": true
}
}
}
},
"extensions": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"message": {
"type": "string"
}
}
}
]
}🟢reconcile_api_ledger(billing_records, usage_records)
Compare supplied billing and usage records by request ID, exact amount and currency. Flags missing or mismatched records. Does not authenticate telemetry, verify delivery or post to accounting. Paid: 0.25 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='reconcile_api_ledger' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
输入模式
{
"type": "object",
"properties": {
"billing_records": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"amount": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
}
},
"required": [
"request_id",
"amount",
"currency"
],
"additionalProperties": false
}
},
"usage_records": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"amount": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
}
},
"required": [
"request_id",
"amount",
"currency"
],
"additionalProperties": false
}
}
},
"required": [
"billing_records",
"usage_records"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.reconcile_api_ledger"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"tool": {
"const": "reconcile_api_ledger"
},
"reconciliation_status": {
"enum": [
"NO_RECORDS",
"MATCHED_SUBMITTED_RECORDS",
"DISCREPANCIES_FOUND"
]
},
"records_compared": {
"type": "integer",
"minimum": 0,
"maximum": 200
},
"matched_record_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"issues": {
"type": "array",
"maxItems": 200,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"codes": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": {
"enum": [
"MISSING_BILLING_RECORD",
"MISSING_USAGE_RECORD",
"CURRENCY_MISMATCH",
"AMOUNT_MISMATCH"
]
}
}
},
"required": [
"request_id",
"codes"
],
"additionalProperties": false
}
},
"totals_by_currency": {
"type": "array",
"maxItems": 2,
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"billing_total": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"usage_total": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"billing_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"usage_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"currency",
"billing_total",
"usage_total",
"billing_count",
"usage_count"
],
"additionalProperties": false
}
},
"policy": {
"type": "object",
"properties": {
"advisory_only": {
"const": true
},
"stateless": {
"const": true
},
"submitted_records_retained": {
"const": false
},
"caller_identity_authenticated": {
"const": false
},
"submitted_evidence_verified": {
"const": false
},
"external_spend_enforced": {
"const": false
},
"downstream_payment_authorized": {
"const": false
},
"reservation_created": {
"const": false
},
"ledger_updated": {
"const": false
},
"credentials_issued": {
"const": false
},
"delivery_verified": {
"const": false
},
"model_calls": {
"const": 0
},
"human_review_required": {
"const": true
},
"telemetry_independently_verified": {
"const": false
},
"scope": {
"const": "Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected."
}
},
"required": [
"advisory_only",
"stateless",
"submitted_records_retained",
"caller_identity_authenticated",
"submitted_evidence_verified",
"external_spend_enforced",
"downstream_payment_authorized",
"reservation_created",
"ledger_updated",
"credentials_issued",
"delivery_verified",
"model_calls",
"human_review_required",
"telemetry_independently_verified",
"scope"
],
"additionalProperties": false
}
},
"required": [
"tool",
"reconciliation_status",
"records_compared",
"matched_record_count",
"issues",
"totals_by_currency",
"policy"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity",
"payment_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"message": {
"type": "string",
"maxLength": 300
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "error"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"service_code",
"message",
"retryable",
"remediation"
],
"properties": {
"code": {
"type": "string",
"maxLength": 80
},
"service_code": {
"enum": [
"ARDARO_ARITHMETIC_MISMATCH",
"ARDARO_DOCUMENT_TOO_LARGE",
"ARDARO_DUPLICATE_SUSPECTED",
"ARDARO_EXTRACTION_LOW_CONFIDENCE",
"ARDARO_IDEMPOTENCY_CONFLICT",
"ARDARO_INPUT_UNSUPPORTED",
"ARDARO_PAYMENT_INVALID",
"ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
"ARDARO_PAYMENT_REQUIRED",
"ARDARO_RATE_LIMITED",
"ARDARO_SERVICE_UNAVAILABLE"
]
},
"message": {
"type": "string",
"maxLength": 280
},
"retryable": {
"type": "boolean"
},
"remediation": {
"type": "string",
"maxLength": 280
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"status",
"service",
"error"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.response.v1"
},
"status": {
"const": "not_ready"
},
"service": {
"const": "ardaro-receipt-intelligence"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"message": {
"const": "Service is not ready."
}
}
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"accepts"
],
"properties": {
"x402Version": {
"type": "integer",
"const": 2,
"default": 2
},
"error": {
"type": [
"string",
"null"
]
},
"resource": {
"oneOf": [
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"mimeType": {
"type": [
"string",
"null"
]
},
"serviceName": {
"type": [
"string",
"null"
]
},
"tags": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"iconUrl": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
},
"accepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds"
],
"properties": {
"scheme": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"amount": {
"type": "string"
},
"payTo": {
"type": "string"
},
"maxTimeoutSeconds": {
"type": "integer"
},
"extra": {
"type": "object",
"additionalProperties": true
}
}
}
},
"extensions": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
}
}
},
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"message"
],
"properties": {
"status": {
"const": "error"
},
"message": {
"type": "string"
}
}
}
]
}🟢get_utility_example(service)
Inspect a fixed synthetic request and expected result before integrating or paying. Select service from the enum; no caller document is accepted, processed or stored. Returns service and details containing that service's example. Free; no wallet authorization. Use get_utility_service_status for current readiness, prices and retention instead.
输入模式
{
"type": "object",
"properties": {
"service": {
"type": "string",
"enum": [
"compress_agent_context",
"route_model_intent",
"authorize_agent_spend",
"reconcile_api_ledger"
],
"description": "Service whose fixed example or current terms to inspect."
}
},
"required": [
"service"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "compress_agent_context"
},
"details": {
"type": "object",
"additionalProperties": false,
"required": [
"example_version",
"service_id",
"synthetic_only",
"request",
"response",
"policy"
],
"properties": {
"example_version": {
"const": "ardaro.agent-utilities.example.v1"
},
"service_id": {
"const": "ardaro.compress_agent_context"
},
"synthetic_only": {
"const": true
},
"request": {
"type": "object",
"properties": {
"raw_conversation_history": {
"type": "string",
"minLength": 1,
"maxLength": 32768,
"description": "Caller-supplied text; do not submit secrets or private tenant data."
}
},
"required": [
"raw_conversation_history"
],
"additionalProperties": false
},
"response": {
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.compress_agent_context"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "REVIEW_CANDIDATE"
},
"compressed_prompt_payload": {
"type": "string",
"minLength": 1,
"maxLength": 32768
},
"transformation": {
"type": "string",
"const": "Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed"
},
"original_characters": {
"type": "integer",
"minimum": 1,
"maximum": 32768
},
"candidate_characters": {
"type": "integer",
"minimum": 1,
"maximum": 32768
},
"characters_removed": {
"type": "integer",
"minimum": 0,
"maximum": 32767
},
"tokens_saved": {
"type": "null"
},
"tokenizer_used": {
"type": "null"
},
"compression_ratio": {
"type": "null"
},
"semantic_preservation_verified": {
"type": "boolean",
"const": false
},
"human_review_required": {
"type": "boolean",
"const": true
},
"latency_or_cost_savings_verified": {
"type": "boolean",
"const": false
}
},
"required": [
"status",
"compressed_prompt_payload",
"transformation",
"original_characters",
"candidate_characters",
"characters_removed",
"tokens_saved",
"tokenizer_used",
"compression_ratio",
"semantic_preservation_verified",
"human_review_required",
"latency_or_cost_savings_verified"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
"policy": {
"type": "object",
"required": [
"payment_required",
"human_review_required",
"financial_posting_supported"
],
"properties": {
"payment_required": {
"const": false
},
"human_review_required": {
"const": true
},
"financial_posting_supported": {
"const": false
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "route_model_intent"
},
"details": {
"type": "object",
"additionalProperties": false,
"required": [
"example_version",
"service_id",
"synthetic_only",
"request",
"response",
"policy"
],
"properties": {
"example_version": {
"const": "ardaro.agent-utilities.example.v1"
},
"service_id": {
"const": "ardaro.route_model_intent"
},
"synthetic_only": {
"const": true
},
"request": {
"type": "object",
"properties": {
"intent_payload": {
"type": "string",
"minLength": 1,
"maxLength": 32768,
"description": "Caller-supplied text; do not submit secrets or private tenant data."
}
},
"required": [
"intent_payload"
],
"additionalProperties": false
},
"response": {
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.route_model_intent"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "ADVISORY_ROUTE"
},
"route_category": {
"type": "string",
"enum": [
"structured-calculation-review",
"general-text-review"
]
},
"routing_basis": {
"type": "string",
"const": "Keyword heuristic only; no model capability, availability or price comparison"
},
"recommended_model": {
"type": "null"
},
"route_executed": {
"type": "boolean",
"const": false
},
"human_review_required": {
"type": "boolean",
"const": true
}
},
"required": [
"status",
"route_category",
"routing_basis",
"recommended_model",
"route_executed",
"human_review_required"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
"policy": {
"type": "object",
"required": [
"payment_required",
"human_review_required",
"financial_posting_supported"
],
"properties": {
"payment_required": {
"const": false
},
"human_review_required": {
"const": true
},
"financial_posting_supported": {
"const": false
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "authorize_agent_spend"
},
"details": {
"type": "object",
"additionalProperties": false,
"required": [
"example_version",
"service_id",
"synthetic_only",
"request",
"response",
"policy"
],
"properties": {
"example_version": {
"const": "ardaro.agent-utilities.example.v1"
},
"service_id": {
"const": "ardaro.authorize_agent_spend"
},
"synthetic_only": {
"const": true
},
"request": {
"type": "object",
"properties": {
"proposed_cost": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"policy": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"max_per_transaction": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"max_per_hour": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"max_checks_per_minute": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
}
},
"required": [
"currency",
"max_per_transaction",
"max_per_hour",
"max_checks_per_minute"
],
"additionalProperties": false
},
"history": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"committed_last_hour": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"pending_reserved": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"checks_last_minute": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"currency",
"committed_last_hour",
"pending_reserved",
"checks_last_minute"
],
"additionalProperties": false
}
},
"required": [
"proposed_cost",
"currency",
"policy",
"history"
],
"additionalProperties": false
},
"response": {
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.authorize_agent_spend"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"tool": {
"const": "authorize_agent_spend"
},
"authorization_status": {
"enum": [
"WITHIN_SUBMITTED_LIMITS",
"EXCEEDS_SUBMITTED_LIMITS",
"RATE_THRESHOLD_EXCEEDED",
"CURRENCY_MISMATCH"
]
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"policy_currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"history_currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"proposed_cost": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"submitted_budget_in_use": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"proposed_hour_total": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"hourly_remaining_after_proposal": {
"anyOf": [
{
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
{
"type": "null"
}
]
},
"checks": {
"type": "object",
"properties": {
"currency_consistent": {
"type": "boolean"
},
"transaction_within_limit": {
"type": [
"boolean",
"null"
]
},
"hourly_within_limit": {
"type": [
"boolean",
"null"
]
},
"rate_within_limit": {
"type": "boolean"
}
},
"required": [
"currency_consistent",
"transaction_within_limit",
"hourly_within_limit",
"rate_within_limit"
],
"additionalProperties": false
},
"findings": {
"type": "array",
"maxItems": 3,
"uniqueItems": true,
"items": {
"enum": [
"CURRENCY_MISMATCH",
"TRANSACTION_LIMIT_EXCEEDED",
"HOURLY_LIMIT_EXCEEDED",
"RATE_THRESHOLD_EXCEEDED"
]
}
},
"policy": {
"type": "object",
"properties": {
"advisory_only": {
"const": true
},
"stateless": {
"const": true
},
"submitted_records_retained": {
"const": false
},
"caller_identity_authenticated": {
"const": false
},
"submitted_evidence_verified": {
"const": false
},
"external_spend_enforced": {
"const": false
},
"downstream_payment_authorized": {
"const": false
},
"reservation_created": {
"const": false
},
"ledger_updated": {
"const": false
},
"credentials_issued": {
"const": false
},
"delivery_verified": {
"const": false
},
"model_calls": {
"const": 0
},
"human_review_required": {
"const": true
},
"policy_authenticated": {
"const": false
},
"history_verified": {
"const": false
},
"checks_exclude_service_fee": {
"const": true
},
"scope": {
"const": "Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled."
},
"fee_scope": {
"const": "The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed."
},
"history_scope": {
"const": "The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified."
}
},
"required": [
"advisory_only",
"stateless",
"submitted_records_retained",
"caller_identity_authenticated",
"submitted_evidence_verified",
"external_spend_enforced",
"downstream_payment_authorized",
"reservation_created",
"ledger_updated",
"credentials_issued",
"delivery_verified",
"model_calls",
"human_review_required",
"policy_authenticated",
"history_verified",
"checks_exclude_service_fee",
"scope",
"fee_scope",
"history_scope"
],
"additionalProperties": false
}
},
"required": [
"tool",
"authorization_status",
"currency",
"policy_currency",
"history_currency",
"proposed_cost",
"submitted_budget_in_use",
"proposed_hour_total",
"hourly_remaining_after_proposal",
"checks",
"findings",
"policy"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
"policy": {
"type": "object",
"required": [
"payment_required",
"human_review_required",
"financial_posting_supported"
],
"properties": {
"payment_required": {
"const": false
},
"human_review_required": {
"const": true
},
"financial_posting_supported": {
"const": false
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "reconcile_api_ledger"
},
"details": {
"type": "object",
"additionalProperties": false,
"required": [
"example_version",
"service_id",
"synthetic_only",
"request",
"response",
"policy"
],
"properties": {
"example_version": {
"const": "ardaro.agent-utilities.example.v1"
},
"service_id": {
"const": "ardaro.reconcile_api_ledger"
},
"synthetic_only": {
"const": true
},
"request": {
"type": "object",
"properties": {
"billing_records": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"amount": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
}
},
"required": [
"request_id",
"amount",
"currency"
],
"additionalProperties": false
}
},
"usage_records": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"amount": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
"not": {
"pattern": "\\n"
}
},
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
}
},
"required": [
"request_id",
"amount",
"currency"
],
"additionalProperties": false
}
}
},
"required": [
"billing_records",
"usage_records"
],
"additionalProperties": false
},
"response": {
"type": "object",
"additionalProperties": false,
"required": [
"contract_version",
"service_id",
"status",
"result",
"identities"
],
"properties": {
"contract_version": {
"const": "ardaro.agent-utilities.response.v1"
},
"service_id": {
"const": "ardaro.reconcile_api_ledger"
},
"status": {
"const": "review_required"
},
"result": {
"type": "object",
"properties": {
"tool": {
"const": "reconcile_api_ledger"
},
"reconciliation_status": {
"enum": [
"NO_RECORDS",
"MATCHED_SUBMITTED_RECORDS",
"DISCREPANCIES_FOUND"
]
},
"records_compared": {
"type": "integer",
"minimum": 0,
"maximum": 200
},
"matched_record_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"issues": {
"type": "array",
"maxItems": 200,
"items": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
"not": {
"pattern": "\\n"
}
},
"codes": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": {
"enum": [
"MISSING_BILLING_RECORD",
"MISSING_USAGE_RECORD",
"CURRENCY_MISMATCH",
"AMOUNT_MISMATCH"
]
}
}
},
"required": [
"request_id",
"codes"
],
"additionalProperties": false
}
},
"totals_by_currency": {
"type": "array",
"maxItems": 2,
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"USDC"
]
},
"billing_total": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"usage_total": {
"type": "string",
"minLength": 8,
"maxLength": 18,
"pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$"
},
"billing_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"usage_count": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"currency",
"billing_total",
"usage_total",
"billing_count",
"usage_count"
],
"additionalProperties": false
}
},
"policy": {
"type": "object",
"properties": {
"advisory_only": {
"const": true
},
"stateless": {
"const": true
},
"submitted_records_retained": {
"const": false
},
"caller_identity_authenticated": {
"const": false
},
"submitted_evidence_verified": {
"const": false
},
"external_spend_enforced": {
"const": false
},
"downstream_payment_authorized": {
"const": false
},
"reservation_created": {
"const": false
},
"ledger_updated": {
"const": false
},
"credentials_issued": {
"const": false
},
"delivery_verified": {
"const": false
},
"model_calls": {
"const": 0
},
"human_review_required": {
"const": true
},
"telemetry_independently_verified": {
"const": false
},
"scope": {
"const": "Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected."
}
},
"required": [
"advisory_only",
"stateless",
"submitted_records_retained",
"caller_identity_authenticated",
"submitted_evidence_verified",
"external_spend_enforced",
"downstream_payment_authorized",
"reservation_created",
"ledger_updated",
"credentials_issued",
"delivery_verified",
"model_calls",
"human_review_required",
"telemetry_independently_verified",
"scope"
],
"additionalProperties": false
}
},
"required": [
"tool",
"reconciliation_status",
"records_compared",
"matched_record_count",
"issues",
"totals_by_currency",
"policy"
],
"additionalProperties": false
},
"identities": {
"type": "object",
"additionalProperties": false,
"required": [
"analysis_result_identity"
],
"properties": {
"analysis_result_identity": {
"type": "string",
"pattern": "^res_[0-9a-f]{64}$"
},
"payment_identity": {
"type": "object",
"additionalProperties": false,
"required": [
"protocol",
"reference",
"replayed"
],
"properties": {
"protocol": {
"const": "x402-v2"
},
"reference": {
"type": "string",
"pattern": "^pay_[0-9a-f]{64}$"
},
"replayed": {
"type": "boolean"
}
}
}
}
}
}
},
"policy": {
"type": "object",
"required": [
"payment_required",
"human_review_required",
"financial_posting_supported"
],
"properties": {
"payment_required": {
"const": false
},
"human_review_required": {
"const": true
},
"financial_posting_supported": {
"const": false
}
}
}
}
}
}
}
]
}🟢get_utility_service_status(service)
Check the selected service's current runtime readiness, input limits, pricing and retention before use. Returns service and details; ready=false means the underlying service is unavailable. Free cached runtime read; no external probe, payment, analysis or historical document retrieval. Use get_utility_example for a fixed integration sample instead.
输入模式
{
"type": "object",
"properties": {
"service": {
"type": "string",
"enum": [
"compress_agent_context",
"route_model_intent",
"authorize_agent_spend",
"reconcile_api_ledger"
],
"description": "Service whose fixed example or current terms to inspect."
}
},
"required": [
"service"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "compress_agent_context"
},
"details": {
"type": "object",
"required": [
"status_version",
"service_id",
"ready",
"reason",
"price",
"policy",
"retention",
"limits",
"endpoints"
],
"properties": {
"status_version": {
"const": "ardaro.agent-utilities.status.v1"
},
"service_id": {
"const": "ardaro.compress_agent_context"
},
"ready": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"type": "object",
"required": [
"amount",
"amount_atomic",
"currency",
"network"
],
"properties": {
"amount": {
"type": "string"
},
"amount_atomic": {
"type": "string",
"pattern": "^[0-9]+$"
},
"currency": {
"const": "USDC"
},
"network": {
"type": "string"
}
}
},
"policy": {
"type": "object"
},
"retention": {
"type": "object"
},
"limits": {
"type": "object"
},
"endpoints": {
"type": "object"
},
"settlement_proven": {
"type": "boolean"
},
"settlement_proven_transport": {
"type": [
"string",
"null"
]
},
"acceptance_evidence": {
"type": [
"object",
"null"
]
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "route_model_intent"
},
"details": {
"type": "object",
"required": [
"status_version",
"service_id",
"ready",
"reason",
"price",
"policy",
"retention",
"limits",
"endpoints"
],
"properties": {
"status_version": {
"const": "ardaro.agent-utilities.status.v1"
},
"service_id": {
"const": "ardaro.route_model_intent"
},
"ready": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"type": "object",
"required": [
"amount",
"amount_atomic",
"currency",
"network"
],
"properties": {
"amount": {
"type": "string"
},
"amount_atomic": {
"type": "string",
"pattern": "^[0-9]+$"
},
"currency": {
"const": "USDC"
},
"network": {
"type": "string"
}
}
},
"policy": {
"type": "object"
},
"retention": {
"type": "object"
},
"limits": {
"type": "object"
},
"endpoints": {
"type": "object"
},
"settlement_proven": {
"type": "boolean"
},
"settlement_proven_transport": {
"type": [
"string",
"null"
]
},
"acceptance_evidence": {
"type": [
"object",
"null"
]
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "authorize_agent_spend"
},
"details": {
"type": "object",
"required": [
"status_version",
"service_id",
"ready",
"reason",
"price",
"policy",
"retention",
"limits",
"endpoints"
],
"properties": {
"status_version": {
"const": "ardaro.agent-utilities.status.v1"
},
"service_id": {
"const": "ardaro.authorize_agent_spend"
},
"ready": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"type": "object",
"required": [
"amount",
"amount_atomic",
"currency",
"network"
],
"properties": {
"amount": {
"type": "string"
},
"amount_atomic": {
"type": "string",
"pattern": "^[0-9]+$"
},
"currency": {
"const": "USDC"
},
"network": {
"type": "string"
}
}
},
"policy": {
"type": "object"
},
"retention": {
"type": "object"
},
"limits": {
"type": "object"
},
"endpoints": {
"type": "object"
},
"settlement_proven": {
"type": "boolean"
},
"settlement_proven_transport": {
"type": [
"string",
"null"
]
},
"acceptance_evidence": {
"type": [
"object",
"null"
]
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"service",
"details"
],
"properties": {
"service": {
"const": "reconcile_api_ledger"
},
"details": {
"type": "object",
"required": [
"status_version",
"service_id",
"ready",
"reason",
"price",
"policy",
"retention",
"limits",
"endpoints"
],
"properties": {
"status_version": {
"const": "ardaro.agent-utilities.status.v1"
},
"service_id": {
"const": "ardaro.reconcile_api_ledger"
},
"ready": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"type": "object",
"required": [
"amount",
"amount_atomic",
"currency",
"network"
],
"properties": {
"amount": {
"type": "string"
},
"amount_atomic": {
"type": "string",
"pattern": "^[0-9]+$"
},
"currency": {
"const": "USDC"
},
"network": {
"type": "string"
}
}
},
"policy": {
"type": "object"
},
"retention": {
"type": "object"
},
"limits": {
"type": "object"
},
"endpoints": {
"type": "object"
},
"settlement_proven": {
"type": "boolean"
},
"settlement_proven_transport": {
"type": [
"string",
"null"
]
},
"acceptance_evidence": {
"type": [
"object",
"null"
]
}
}
}
}
}
]
}社区
证据
最近观测
已验证未记录版本6 个工具
已验证未记录版本6 个工具
已验证未记录版本6 个工具