{
  "components": {
    "schemas": {
      "AccessStatus": {
        "description": "Whether an account has access.",
        "enum": [
          "active",
          "inactive",
          "unknown"
        ],
        "type": "string"
      },
      "AccessStatusRequest": {
        "additionalProperties": false,
        "properties": {
          "user_id": {
            "maxLength": 36,
            "minLength": 8,
            "type": "string"
          }
        },
        "required": [
          "user_id"
        ],
        "type": "object"
      },
      "AccessStatusResponse": {
        "properties": {
          "entitlements": {
            "description": "Empty for an inactive or unknown account",
            "items": {
              "$ref": "#/components/schemas/Entitlement"
            },
            "type": "array"
          },
          "status": {
            "$ref": "#/components/schemas/AccessStatus",
            "description": "`unknown`: this identity has no account"
          },
          "web_session": {
            "description": "Whether an exchange would open a website session now",
            "type": "boolean"
          }
        },
        "required": [
          "status",
          "entitlements",
          "web_session"
        ],
        "type": "object"
      },
      "AccountUsage": {
        "properties": {
          "account": {
            "$ref": "#/components/schemas/AccountView"
          },
          "data_credits_by_day": {
            "description": "every UTC day of the window, oldest first",
            "items": {
              "$ref": "#/components/schemas/DataCreditsByDay"
            },
            "type": "array"
          },
          "generated_at": {
            "description": "when the answer was computed (UTC)",
            "format": "date-time",
            "type": "string"
          },
          "history_from": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "the first UTC day with usage held for the account; null before any use"
          },
          "requests_by_credential": {
            "description": "each key's requests per day in the window",
            "items": {
              "$ref": "#/components/schemas/RequestsByCredential"
            },
            "type": "array"
          }
        },
        "required": [
          "account",
          "requests_by_credential",
          "data_credits_by_day",
          "generated_at"
        ],
        "type": "object"
      },
      "AccountView": {
        "description": "The owner's view: the account and its usage (the pools, the rate card, the per-minute rate, concurrency and\nstorage).",
        "properties": {
          "balance": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CreditBalance"
              },
              {
                "type": "null"
              }
            ],
            "description": "your credit balance, used by either pool once its daily allowance is spent; null when none"
          },
          "concurrency": {
            "$ref": "#/components/schemas/ConcurrencyView"
          },
          "entitlements": {
            "description": "Account entitlements (data, ai, mcp, sessions), shared by all of the account's keys, sessions, and connected apps and narrowed by their kind",
            "items": {
              "$ref": "#/components/schemas/Entitlement"
            },
            "type": "array"
          },
          "id": {
            "description": "account id (opaque)",
            "pattern": "^acct_[0-9A-Za-z]+$",
            "type": "string"
          },
          "pools": {
            "description": "the daily credit pools, always two in this order: `data`, then `ai`",
            "items": {
              "$ref": "#/components/schemas/PoolView"
            },
            "type": "array"
          },
          "rate_limit_per_minute": {
            "description": "requests per minute for the whole account; excess requests return 429 `rate_limit_exceeded` without a charge",
            "type": "integer"
          },
          "rates": {
            "description": "the rate card, the same for every account: always three rows in this order: `input_tokens`, `output_tokens`, then `data_request`",
            "items": {
              "$ref": "#/components/schemas/RateView"
            },
            "type": "array"
          },
          "resets_at": {
            "description": "the next reset of every pool (midnight UTC), RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "storage": {
            "$ref": "#/components/schemas/StorageView"
          },
          "tier": {
            "description": "the account's tier code",
            "type": "string"
          },
          "tier_display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tier name to display to users"
          }
        },
        "required": [
          "pools",
          "rates",
          "rate_limit_per_minute",
          "resets_at",
          "concurrency",
          "storage",
          "id",
          "tier",
          "tier_display_name",
          "entitlements"
        ],
        "type": "object"
      },
      "AnnouncementsResponse": {
        "description": "Product notices and display strings for the TradingAgents CLI.",
        "examples": [
          {
            "announcements": [
              "Trading-R1 Technical Report: [link=https://arxiv.org/abs/2509.11420]https://arxiv.org/abs/2509.11420[/link]"
            ],
            "notices": [
              {
                "id": "technical-report",
                "message": "Trading-R1 Technical Report",
                "severity": "info",
                "url": "https://arxiv.org/abs/2509.11420"
              }
            ],
            "require_attention": false
          }
        ],
        "properties": {
          "announcements": {
            "description": "Notices as Rich markup strings for TradingAgents CLI 0.6.0 and earlier; an empty string represents a blank line. Clients above 0.6.0 use `notices`",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "notices": {
            "description": "Product notices; empty when there are none. Filter `min_version` and `max_version` against your client version and check `expires` each time you display a notice",
            "items": {
              "$ref": "#/components/schemas/ProductNotice"
            },
            "type": "array"
          },
          "require_attention": {
            "description": "Whether TradingAgents CLI 0.6.0 and earlier should highlight the announcements",
            "type": "boolean"
          }
        },
        "required": [
          "announcements",
          "require_attention",
          "notices"
        ],
        "type": "object"
      },
      "AppendReceipt": {
        "properties": {
          "length": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "received_at": {
            "description": "Server acceptance time of the append, in UTC",
            "type": "string"
          }
        },
        "required": [
          "offset",
          "length",
          "received_at"
        ],
        "type": "object"
      },
      "AppendReceiptList": {
        "properties": {
          "data": {
            "description": "the page's rows, in the list's order",
            "items": {
              "$ref": "#/components/schemas/AppendReceipt"
            },
            "type": "array"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; null at the end of the list"
          },
          "object": {
            "const": "list",
            "default": "list",
            "description": "the object's type, constant for a schema (`list` for a page)",
            "type": "string"
          }
        },
        "required": [
          "object",
          "next_cursor",
          "data"
        ],
        "type": "object"
      },
      "AppendResult": {
        "properties": {
          "size": {
            "description": "the session's size after this request",
            "type": "integer"
          },
          "verified_to": {
            "description": "Confirmed upload offset: `Upload-Offset` plus the body's length. Advance your confirmed cursor to this value",
            "type": "integer"
          }
        },
        "required": [
          "size",
          "verified_to"
        ],
        "type": "object"
      },
      "ApplicationList": {
        "properties": {
          "allowance": {
            "$ref": "#/components/schemas/StorageAllowance"
          },
          "data": {
            "description": "the page's rows, in the list's order",
            "items": {
              "$ref": "#/components/schemas/ApplicationStorage"
            },
            "type": "array"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; null at the end of the list"
          },
          "object": {
            "const": "list",
            "default": "list",
            "description": "the object's type, constant for a schema (`list` for a page)",
            "type": "string"
          }
        },
        "required": [
          "object",
          "next_cursor",
          "data",
          "allowance"
        ],
        "type": "object"
      },
      "ApplicationSessionList": {
        "properties": {
          "data": {
            "description": "the page's rows, in the list's order",
            "items": {
              "$ref": "#/components/schemas/ApplicationSessionView"
            },
            "type": "array"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; null at the end of the list"
          },
          "object": {
            "const": "list",
            "default": "list",
            "description": "the object's type, constant for a schema (`list` for a page)",
            "type": "string"
          }
        },
        "required": [
          "object",
          "next_cursor",
          "data"
        ],
        "type": "object"
      },
      "ApplicationSessionView": {
        "properties": {
          "application": {
            "description": "the application's key",
            "type": "string"
          },
          "created_at": {
            "description": "when it was created (UTC)",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "the session's id, chosen by your application: 1 to 128 characters of `A-Z a-z 0-9 . _ -`, starting with a letter or digit, unique per account and application",
            "type": "string"
          },
          "last_append_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "when the session last grew (UTC)"
          },
          "metadata": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "the session's description (key-value pairs)",
            "type": "object"
          },
          "parent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SessionParent"
              },
              {
                "type": "null"
              }
            ]
          },
          "size": {
            "description": "the bytes the session holds (uncompressed)",
            "type": "integer"
          },
          "updated_at": {
            "description": "when it last changed (UTC)",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "application",
          "metadata",
          "size",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "ApplicationStorage": {
        "properties": {
          "application": {
            "description": "the application's key",
            "type": "string"
          },
          "retained_bytes": {
            "deprecated": true,
            "description": "the bytes the application's sessions hold",
            "type": "integer"
          },
          "sessions": {
            "description": "live (not deleted) sessions",
            "type": "integer"
          },
          "used_bytes": {
            "description": "the bytes the application's sessions hold",
            "type": "integer"
          }
        },
        "required": [
          "application",
          "sessions",
          "used_bytes",
          "retained_bytes"
        ],
        "type": "object"
      },
      "ApplicationView": {
        "properties": {
          "id": {
            "description": "the application's name in the session paths (for example `tauric`)",
            "type": "string"
          },
          "name": {
            "description": "the display name",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "BoostRequest": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "description": "the invitation code (any case)",
            "maxLength": 32,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "code"
        ],
        "type": "object"
      },
      "BoostView": {
        "properties": {
          "ends_at": {
            "description": "a midnight UTC, RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "percent": {
            "description": "the percentage added to each boosted pool's allowance",
            "type": "integer"
          },
          "pools": {
            "description": "the pools the boost raises",
            "items": {
              "$ref": "#/components/schemas/Pool"
            },
            "type": "array"
          },
          "starts_at": {
            "description": "RFC 3339",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "percent",
          "pools",
          "starts_at",
          "ends_at"
        ],
        "type": "object"
      },
      "CodeKind": {
        "description": "What an invitation code grants: a boost or a credit balance.",
        "enum": [
          "boost",
          "credit"
        ],
        "type": "string"
      },
      "ConcurrencyView": {
        "properties": {
          "ai": {
            "description": "AI units (model-inference requests, copilot turns, research runs) in flight at once; one more is refused `429 concurrency_limit_reached`",
            "type": "integer"
          },
          "research": {
            "description": "research runs among them",
            "type": "integer"
          }
        },
        "required": [
          "ai",
          "research"
        ],
        "type": "object"
      },
      "CreatedCredential": {
        "properties": {
          "account_id": {
            "description": "account id (opaque)",
            "pattern": "^acct_[0-9A-Za-z]+$",
            "type": "string"
          },
          "client": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "a connected app's client identifier (its metadata URL), which names the app that holds the connection; absent for keys"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "when it was created (UTC)"
          },
          "created_via": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "description": "credential id (opaque)",
            "pattern": "^cred_[0-9A-Za-z]+$",
            "type": "string"
          },
          "key": {
            "description": "Secret key, shown only in this response",
            "type": "string"
          },
          "key_preview": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Public identifier for the key"
          },
          "kind": {
            "$ref": "#/components/schemas/CredentialKind"
          },
          "last_used_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "the display name"
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "$ref": "#/components/schemas/CredentialStatus",
            "description": "Key status, evaluated in order: `revoked` when deactivated, `expired` when past `expires_at`, otherwise `active`. Account status is separate"
          }
        },
        "required": [
          "id",
          "account_id",
          "kind",
          "status",
          "key"
        ],
        "type": "object"
      },
      "CreatedCredentialResponse": {
        "properties": {
          "credential": {
            "$ref": "#/components/schemas/CreatedCredential"
          }
        },
        "required": [
          "credential"
        ],
        "type": "object"
      },
      "CredentialKind": {
        "description": "What kind of credential it is.",
        "enum": [
          "key",
          "web_session",
          "connection"
        ],
        "type": "string"
      },
      "CredentialList": {
        "properties": {
          "data": {
            "description": "the page's rows, in the list's order",
            "items": {
              "$ref": "#/components/schemas/CredentialView"
            },
            "type": "array"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; null at the end of the list"
          },
          "object": {
            "const": "list",
            "default": "list",
            "description": "the object's type, constant for a schema (`list` for a page)",
            "type": "string"
          }
        },
        "required": [
          "object",
          "next_cursor",
          "data"
        ],
        "type": "object"
      },
      "CredentialRequest": {
        "additionalProperties": false,
        "properties": {
          "expires_in_days": {
            "anyOf": [
              {
                "maximum": 365.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "description": "the display name",
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "CredentialStatus": {
        "description": "A credential's state.",
        "enum": [
          "active",
          "revoked",
          "expired"
        ],
        "type": "string"
      },
      "CredentialView": {
        "properties": {
          "account_id": {
            "description": "account id (opaque)",
            "pattern": "^acct_[0-9A-Za-z]+$",
            "type": "string"
          },
          "client": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "a connected app's client identifier (its metadata URL), which names the app that holds the connection; absent for keys"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "when it was created (UTC)"
          },
          "created_via": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "description": "credential id (opaque)",
            "pattern": "^cred_[0-9A-Za-z]+$",
            "type": "string"
          },
          "key_preview": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Public identifier for the key"
          },
          "kind": {
            "$ref": "#/components/schemas/CredentialKind"
          },
          "last_used_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "the display name"
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "$ref": "#/components/schemas/CredentialStatus",
            "description": "Key status, evaluated in order: `revoked` when deactivated, `expired` when past `expires_at`, otherwise `active`. Account status is separate"
          }
        },
        "required": [
          "id",
          "account_id",
          "kind",
          "status"
        ],
        "type": "object"
      },
      "CreditBalance": {
        "properties": {
          "expires_at": {
            "description": "when the first of them expires (a midnight UTC), RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "granted": {
            "description": "credits added by the codes still active",
            "type": "number"
          },
          "remaining": {
            "description": "credits left",
            "type": "number"
          }
        },
        "required": [
          "remaining",
          "granted",
          "expires_at"
        ],
        "type": "object"
      },
      "CreditView": {
        "properties": {
          "amount": {
            "description": "the credits added to your balance",
            "type": "number"
          },
          "expires_at": {
            "description": "a midnight UTC, RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "starts_at": {
            "description": "RFC 3339",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "amount",
          "starts_at",
          "expires_at"
        ],
        "type": "object"
      },
      "DataCreditsByDay": {
        "properties": {
          "credits": {
            "description": "data-pool credits used that day",
            "type": "number"
          },
          "day": {
            "description": "a UTC day",
            "format": "date",
            "type": "string"
          }
        },
        "required": [
          "day",
          "credits"
        ],
        "type": "object"
      },
      "Entitlement": {
        "description": "Something an account's tier permits.",
        "enum": [
          "data",
          "ai",
          "mcp",
          "sessions"
        ],
        "type": "string"
      },
      "Error": {
        "properties": {
          "candidates": {
            "description": "the instruments an ambiguous symbol could mean; send one of their keys",
            "items": {
              "properties": {
                "id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "symbol": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "symbol",
                "name"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "code": {
            "description": "the error code (the consumer guide lists each one)",
            "enum": [
              "not_registered",
              "delisted",
              "not_supported",
              "not_published",
              "temporarily_unavailable",
              "insufficient_history",
              "ambiguous_instrument",
              "invalid_request",
              "not_found",
              "method_not_allowed",
              "request_too_large",
              "conflict",
              "gone",
              "unsupported_media_type",
              "range_not_satisfiable",
              "session_offset_mismatch",
              "session_diverged",
              "session_deleted",
              "storage_full",
              "archive_full",
              "model_not_found",
              "missing_api_key",
              "invalid_api_key",
              "api_key_inactive",
              "api_key_expired",
              "account_inactive",
              "entitlement_required",
              "principal_not_permitted",
              "owner_session_required",
              "credential_limit_reached",
              "code_expired",
              "code_exhausted",
              "code_already_redeemed",
              "boost_active",
              "invalid_session",
              "invalid_exchange_token",
              "invalid_identity_token",
              "csrf_failed",
              "connection_unknown",
              "connection_revoked",
              "connection_replayed",
              "invalid_grant",
              "concurrency_limit_reached",
              "rate_limit_exceeded",
              "quota_exhausted",
              "server_error"
            ],
            "type": "string",
            "x-extensible-enum": [
              "not_registered",
              "delisted",
              "not_supported",
              "not_published",
              "temporarily_unavailable",
              "insufficient_history",
              "ambiguous_instrument",
              "invalid_request",
              "not_found",
              "method_not_allowed",
              "request_too_large",
              "conflict",
              "gone",
              "unsupported_media_type",
              "range_not_satisfiable",
              "session_offset_mismatch",
              "session_diverged",
              "session_deleted",
              "storage_full",
              "archive_full",
              "model_not_found",
              "missing_api_key",
              "invalid_api_key",
              "api_key_inactive",
              "api_key_expired",
              "account_inactive",
              "entitlement_required",
              "principal_not_permitted",
              "owner_session_required",
              "credential_limit_reached",
              "code_expired",
              "code_exhausted",
              "code_already_redeemed",
              "boost_active",
              "invalid_session",
              "invalid_exchange_token",
              "invalid_identity_token",
              "csrf_failed",
              "connection_unknown",
              "connection_revoked",
              "connection_replayed",
              "invalid_grant",
              "concurrency_limit_reached",
              "rate_limit_exceeded",
              "quota_exhausted",
              "server_error"
            ],
            "x-tauric-default-codes": {
              "400": "invalid_request",
              "401": "invalid_api_key",
              "403": "principal_not_permitted",
              "404": "not_found",
              "405": "method_not_allowed",
              "409": "conflict",
              "410": "gone",
              "413": "request_too_large",
              "415": "unsupported_media_type",
              "416": "range_not_satisfiable",
              "422": "invalid_request",
              "429": "rate_limit_exceeded",
              "4XX": "invalid_request",
              "500": "server_error",
              "502": "temporarily_unavailable",
              "503": "temporarily_unavailable",
              "504": "temporarily_unavailable",
              "5XX": "server_error"
            },
            "x-tauric-deprecated-enum": [
              "archive_full"
            ],
            "x-tauric-retry": {
              "account_inactive": "never",
              "ambiguous_instrument": "change_request",
              "api_key_expired": "change_request",
              "api_key_inactive": "change_request",
              "archive_full": "change_request",
              "boost_active": "later",
              "code_already_redeemed": "never",
              "code_exhausted": "never",
              "code_expired": "never",
              "concurrency_limit_reached": "later",
              "conflict": "change_request",
              "connection_replayed": "change_request",
              "connection_revoked": "change_request",
              "connection_unknown": "change_request",
              "credential_limit_reached": "change_request",
              "csrf_failed": "change_request",
              "delisted": "never",
              "entitlement_required": "change_request",
              "gone": "never",
              "insufficient_history": "change_request",
              "invalid_api_key": "change_request",
              "invalid_exchange_token": "change_request",
              "invalid_grant": "change_request",
              "invalid_identity_token": "change_request",
              "invalid_request": "change_request",
              "invalid_session": "change_request",
              "method_not_allowed": "change_request",
              "missing_api_key": "change_request",
              "model_not_found": "change_request",
              "not_found": "change_request",
              "not_published": "never",
              "not_registered": "change_request",
              "not_supported": "never",
              "owner_session_required": "change_request",
              "principal_not_permitted": "change_request",
              "quota_exhausted": "later",
              "range_not_satisfiable": "change_request",
              "rate_limit_exceeded": "later",
              "request_too_large": "change_request",
              "server_error": "later",
              "session_deleted": "never",
              "session_diverged": "change_request",
              "session_offset_mismatch": "change_request",
              "storage_full": "change_request",
              "temporarily_unavailable": "later",
              "unsupported_media_type": "change_request"
            }
          },
          "entitlement": {
            "$ref": "#/components/schemas/Entitlement"
          },
          "in_flight": {
            "description": "how many it has in progress now",
            "type": "integer"
          },
          "limit": {
            "description": "how many runs and requests the account may have in progress at once",
            "type": "integer"
          },
          "message": {
            "description": "a human-readable explanation; do not parse it",
            "type": "string"
          },
          "param": {
            "description": "the parameter the error is about",
            "type": [
              "string",
              "null"
            ]
          },
          "pool": {
            "$ref": "#/components/schemas/Pool"
          },
          "remaining": {
            "description": "the credits left in the spent pool",
            "type": "number"
          },
          "remaining_bytes": {
            "type": "integer"
          },
          "resets_at": {
            "description": "when the pool resets, the next midnight UTC",
            "format": "date-time",
            "type": "string"
          },
          "retry": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Retry"
              }
            ],
            "description": "`later`: request it again later (after `Retry-After` when it is sent); `never`: asking again does not change the answer; `change_request`: a different request (the message names it) can succeed"
          },
          "size": {
            "type": "integer"
          },
          "type": {
            "description": "the error's class: `invalid_request_error` for a request to change, `server_error` for one to retry unchanged",
            "enum": [
              "invalid_request_error",
              "server_error"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "code",
          "message",
          "param",
          "retry"
        ],
        "type": "object"
      },
      "ErrorEnvelope": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/Error"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "ExchangeRequest": {
        "additionalProperties": false,
        "properties": {
          "access_token": {
            "maxLength": 8192,
            "minLength": 1,
            "type": "string"
          },
          "user_id": {
            "maxLength": 36,
            "minLength": 8,
            "type": "string"
          }
        },
        "required": [
          "user_id",
          "access_token"
        ],
        "type": "object"
      },
      "IdentityExchangeResponse": {
        "properties": {
          "account_id": {
            "description": "account id (opaque)",
            "pattern": "^acct_[0-9A-Za-z]+$",
            "type": "string"
          },
          "exchange_token": {
            "description": "One-time token for `POST /v1/auth/session/redeem`; valid for 60 seconds",
            "type": "string"
          }
        },
        "required": [
          "exchange_token",
          "account_id"
        ],
        "type": "object"
      },
      "Pool": {
        "description": "A daily credit pool.",
        "enum": [
          "data",
          "ai"
        ],
        "type": "string"
      },
      "PoolBoost": {
        "properties": {
          "base_allowance": {
            "description": "credits per UTC day without the boost",
            "type": "number"
          },
          "ends_at": {
            "description": "when the boost ends (a midnight UTC), RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "percent": {
            "description": "the percentage added to the pool's allowance",
            "type": "integer"
          }
        },
        "required": [
          "percent",
          "base_allowance",
          "ends_at"
        ],
        "type": "object"
      },
      "PoolView": {
        "properties": {
          "allowance": {
            "description": "credits per UTC day, any boost included",
            "type": "number"
          },
          "boost": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PoolBoost"
              },
              {
                "type": "null"
              }
            ],
            "description": "an active invitation code boost on this pool; null when none"
          },
          "explains": {
            "description": "what the pool pays for, in one line",
            "type": "string"
          },
          "held": {
            "description": "credits reserved for work running now, beside `used` (the AI pool; 0 for data)",
            "type": "number"
          },
          "id": {
            "$ref": "#/components/schemas/Pool",
            "description": "the pool's stable id (the 429 `quota_exhausted` names it in `pool`)"
          },
          "label": {
            "description": "the pool's name to show",
            "type": "string"
          },
          "reported_tokens": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReportedTokens"
              },
              {
                "type": "null"
              }
            ],
            "description": "the AI pool: today's reported tokens"
          },
          "resets_at": {
            "description": "the next reset (midnight UTC), RFC 3339",
            "format": "date-time",
            "type": "string"
          },
          "used": {
            "description": "credits charged today (≤ 2 decimals, exact)",
            "type": "number"
          }
        },
        "required": [
          "id",
          "label",
          "used",
          "held",
          "allowance",
          "resets_at",
          "explains"
        ],
        "type": "object"
      },
      "ProductNotice": {
        "properties": {
          "expires": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Last UTC date on which to show the notice; it is withdrawn from 00:00 UTC the next day. Null means no automatic expiry"
          },
          "id": {
            "description": "Stable identifier, unique within the product's feed",
            "type": "string"
          },
          "max_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Show only to client versions at or below this one (inclusive); null means no upper bound"
          },
          "message": {
            "description": "One line of plain text; formatting characters are literal",
            "type": "string"
          },
          "min_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Show only to client versions at or above this one (inclusive), compared in the product's version scheme (PEP 440 for `tradingagents`); null means no lower bound"
          },
          "severity": {
            "$ref": "#/components/schemas/Severity",
            "default": "info",
            "description": "Display hint only; it never blocks or forces anything"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "An absolute http(s) link to show after the message"
          }
        },
        "required": [
          "id",
          "message"
        ],
        "type": "object"
      },
      "ProductNoticesResponse": {
        "description": "A product's notices.",
        "examples": [
          {
            "data": [
              {
                "id": "technical-report",
                "message": "Trading-R1 Technical Report",
                "severity": "info",
                "url": "https://arxiv.org/abs/2509.11420"
              }
            ],
            "object": "list"
          }
        ],
        "properties": {
          "data": {
            "description": "Product notices; empty when there are none. Filter `min_version` and `max_version` against your client version and check `expires` each time you display a notice",
            "items": {
              "$ref": "#/components/schemas/ProductNotice"
            },
            "type": "array"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; null at the end of the list"
          },
          "object": {
            "const": "list",
            "default": "list",
            "description": "the object's type, constant for a schema (`list` for a page)",
            "type": "string"
          }
        },
        "required": [
          "object",
          "next_cursor",
          "data"
        ],
        "type": "object"
      },
      "RateUnit": {
        "description": "What a rate is charged per.",
        "enum": [
          "input_tokens",
          "output_tokens",
          "data_request"
        ],
        "type": "string"
      },
      "RateView": {
        "properties": {
          "credits": {
            "description": "the price in credits per `per`",
            "type": "number"
          },
          "id": {
            "$ref": "#/components/schemas/RateUnit"
          },
          "label": {
            "description": "the charged quantity's name",
            "type": "string"
          },
          "per": {
            "description": "the quantity the price is for (1,000 tokens; 1 request)",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "label",
          "per",
          "credits"
        ],
        "type": "object"
      },
      "RedeemRequest": {
        "additionalProperties": false,
        "properties": {
          "token": {
            "maxLength": 128,
            "minLength": 16,
            "type": "string"
          }
        },
        "required": [
          "token"
        ],
        "type": "object"
      },
      "RedeemResponse": {
        "properties": {
          "csrf_token": {
            "description": "Send as `X-CSRF-Token` on every mutating request of this session",
            "type": "string"
          }
        },
        "required": [
          "csrf_token"
        ],
        "type": "object"
      },
      "RedeemedCode": {
        "properties": {
          "boost": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BoostView"
              },
              {
                "type": "null"
              }
            ],
            "description": "the boost, for a boost code; null otherwise"
          },
          "credit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CreditView"
              },
              {
                "type": "null"
              }
            ],
            "description": "the credits added to your balance, for a credit code; null otherwise"
          },
          "kind": {
            "$ref": "#/components/schemas/CodeKind",
            "description": "what the code granted"
          }
        },
        "required": [
          "kind"
        ],
        "type": "object"
      },
      "ReportedTokens": {
        "properties": {
          "input_tokens": {
            "description": "input tokens the model reported for work settled today",
            "type": "integer"
          },
          "output_tokens": {
            "description": "output tokens the model reported for work settled today",
            "type": "integer"
          }
        },
        "required": [
          "input_tokens",
          "output_tokens"
        ],
        "type": "object"
      },
      "RequestsByCredential": {
        "properties": {
          "credential_id": {
            "description": "credential id (opaque)",
            "pattern": "^cred_[0-9A-Za-z]+$",
            "type": "string"
          },
          "day": {
            "description": "the UTC day",
            "format": "date",
            "type": "string"
          },
          "requests": {
            "description": "the requests the key made that day",
            "type": "integer"
          }
        },
        "required": [
          "credential_id",
          "day",
          "requests"
        ],
        "type": "object"
      },
      "Retry": {
        "description": "When asking again can succeed: later, never, or with a changed request.",
        "enum": [
          "later",
          "never",
          "change_request"
        ],
        "type": "string"
      },
      "SessionParent": {
        "additionalProperties": false,
        "properties": {
          "offset": {
            "description": "the parent's byte offset at the fork point",
            "minimum": 0.0,
            "type": "integer"
          },
          "session_id": {
            "description": "the id of the session this one forked from (an `ApplicationSessionView.id`, same account and application)",
            "type": "string"
          }
        },
        "required": [
          "session_id",
          "offset"
        ],
        "type": "object"
      },
      "SessionPut": {
        "additionalProperties": false,
        "properties": {
          "metadata": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "the session's description: at most 16 pairs, keys of 1-64 characters A-Z a-z 0-9 . _ -, values plain text of at most 512 characters. It replaces the whole map; `{}` clears it; omitted keeps it (a new session starts with `{}`)."
          },
          "parent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SessionParent"
              },
              {
                "type": "null"
              }
            ],
            "description": "set at creation only (a fork); fixed afterwards"
          }
        },
        "type": "object"
      },
      "Severity": {
        "description": "How serious a notice is.",
        "enum": [
          "info",
          "warning",
          "critical"
        ],
        "type": "string"
      },
      "StorageAllowance": {
        "properties": {
          "allowance_bytes": {
            "description": "the account's tier allowance (not a daily counter)",
            "type": "integer"
          },
          "used_bytes": {
            "description": "retained uncompressed bytes, all applications together",
            "type": "integer"
          }
        },
        "required": [
          "used_bytes",
          "allowance_bytes"
        ],
        "type": "object"
      },
      "StorageView": {
        "properties": {
          "allowance_bytes": {
            "description": "the storage allowance",
            "type": "integer"
          },
          "applications": {
            "description": "the applications with storage",
            "items": {
              "$ref": "#/components/schemas/ApplicationView"
            },
            "type": "array"
          },
          "archive_allowance_bytes": {
            "deprecated": true,
            "description": "the retained archive allowance",
            "type": "integer"
          },
          "archive_applications": {
            "deprecated": true,
            "description": "the applications that archive sessions",
            "items": {
              "$ref": "#/components/schemas/ApplicationView"
            },
            "type": "array"
          },
          "archive_bytes": {
            "deprecated": true,
            "description": "retained session-archive bytes across all applications (does not reset daily; deleting a session releases its bytes)",
            "type": "integer"
          },
          "used_bytes": {
            "description": "stored bytes across all applications (does not reset daily; deleting a session releases its bytes)",
            "type": "integer"
          }
        },
        "required": [
          "used_bytes",
          "allowance_bytes",
          "applications",
          "archive_bytes",
          "archive_allowance_bytes",
          "archive_applications"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "HTTPBearer": {
        "scheme": "bearer",
        "type": "http"
      },
      "SessionCookie": {
        "in": "cookie",
        "name": "tauric_session",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "Accounts, keys, website sessions, application storage, and product notices, for applications built on the API.",
    "title": "Tauric API — applications",
    "version": "1.3.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/account": {
      "get": {
        "description": "Returns your account's tier, entitlements, daily credit pools, and today's use.",
        "operationId": "get_account",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountView"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive / missing_api_key / invalid_api_key / api_key_inactive / api_key_expired"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "principal_not_permitted"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          },
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get your account",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": "read",
          "entitlement": null,
          "exposure": "tool",
          "family": "account",
          "paid_result": false,
          "principal": "user",
          "quota": "exempt",
          "reason": "the caller's own account",
          "transport": "json"
        }
      }
    },
    "/v1/account/codes": {
      "post": {
        "description": "Redeems an invitation code. A boost code raises your daily credit pools by its percentage until the boost ends at midnight UTC; one boost can be active at a time. A credit code adds credits to your balance, used once today's allowance is spent, until they expire. Each code can be redeemed once per account. At most 10 attempts an hour.",
        "operationId": "redeem_code",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BoostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedeemedCode"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request: the request is invalid"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required: the code is not offered to your tier"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such invitation code"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "code_already_redeemed / code_exhausted / boost_active: the code was redeemed by your account before, has no redemptions left, or another boost is active"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "code_expired: the code can no longer be redeemed"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          }
        ],
        "summary": "Redeem a code",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "account",
          "paid_result": false,
          "principal": "owner_session",
          "quota": "exempt",
          "reason": "owner self-service (keys, sessions): the account owner's website session only, never a key",
          "transport": "json"
        }
      }
    },
    "/v1/account/credentials": {
      "get": {
        "description": "Returns your keys as previews and lists your connected apps.",
        "operationId": "list_credentials",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialList"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "owner_session_required / csrf_failed / principal_not_permitted"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          }
        ],
        "summary": "List your keys and connected apps",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "account",
          "paid_result": false,
          "principal": "owner_session",
          "quota": "exempt",
          "reason": "owner self-service (keys, sessions): the account owner's website session only, never a key",
          "transport": "json"
        }
      },
      "post": {
        "description": "Creates a named key with your account tier's entitlements and returns its secret once. Your account can have at\nmost 10 live keys; when two creations race for the last one, exactly one succeeds.",
        "operationId": "create_credential",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CredentialRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatedCredentialResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "owner_session_required / csrf_failed / principal_not_permitted"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "credential_limit_reached: the account already holds 10 live keys; revoke one first"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          }
        ],
        "summary": "Create a key",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "account",
          "paid_result": false,
          "principal": "owner_session",
          "quota": "exempt",
          "reason": "owner self-service (keys, sessions): the account owner's website session only, never a key",
          "transport": "json"
        }
      }
    },
    "/v1/account/credentials/{credential_id}": {
      "delete": {
        "description": "Revokes one of your keys or disconnects a connected app.",
        "operationId": "revoke_credential",
        "parameters": [
          {
            "description": "the credential id",
            "in": "path",
            "name": "credential_id",
            "required": true,
            "schema": {
              "pattern": "^cred_[0-9A-Za-z]+$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "owner_session_required / csrf_failed / principal_not_permitted"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such key or connected app on your account"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          }
        ],
        "summary": "Revoke a key or connected app",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "account",
          "paid_result": false,
          "principal": "owner_session",
          "quota": "exempt",
          "reason": "owner self-service (keys, sessions): the account owner's website session only, never a key",
          "transport": "json"
        }
      }
    },
    "/v1/account/sessions": {
      "delete": {
        "description": "Ends all your website sessions. API keys remain active.",
        "operationId": "sign_out_everywhere",
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "owner_session_required / csrf_failed / principal_not_permitted"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          }
        ],
        "summary": "Sign out everywhere",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "account",
          "paid_result": false,
          "principal": "owner_session",
          "quota": "exempt",
          "reason": "owner self-service (keys, sessions): the account owner's website session only, never a key",
          "transport": "json"
        }
      }
    },
    "/v1/account/usage": {
      "get": {
        "description": "Returns today's allowances, the data-pool credits used per UTC day, and the requests of each key by UTC day.",
        "operationId": "get_account_usage",
        "parameters": [
          {
            "description": "First UTC day (YYYY-MM-DD); default: the 7 days ending at `end`; a window spans at most 31 days",
            "in": "query",
            "name": "start",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "First UTC day (YYYY-MM-DD); default: the 7 days ending at `end`; a window spans at most 31 days"
            }
          },
          {
            "description": "Last UTC day (YYYY-MM-DD); default: today",
            "in": "query",
            "name": "end",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Last UTC day (YYYY-MM-DD); default: today"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountUsage"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_session / account_inactive / missing_api_key / invalid_api_key / api_key_inactive / api_key_expired"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "principal_not_permitted"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "SessionCookie": []
          },
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get your account usage",
        "tags": [
          "account"
        ],
        "x-tauric-operation": {
          "effect": "read",
          "entitlement": null,
          "exposure": "tool",
          "family": "account",
          "paid_result": false,
          "principal": "user",
          "quota": "exempt",
          "reason": "the caller's own account usage",
          "transport": "json"
        }
      }
    },
    "/v1/announcements": {
      "get": {
        "description": "Returns TradingAgents CLI notices matching `/v1/products/tradingagents/notices`, plus `announcements` and\n`require_attention` for CLI 0.6.0 and earlier. Responses can be reused for up to an hour.",
        "operationId": "get_announcements",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AnnouncementsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "quota_exhausted"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [],
        "summary": "Get TradingAgents CLI notices",
        "tags": [
          "notices"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "platform",
          "paid_result": false,
          "principal": "user",
          "quota": "none",
          "reason": "the TradingAgents CLI's product notices",
          "transport": "json"
        }
      }
    },
    "/v1/applications": {
      "get": {
        "description": "Returns the applications you can access, their active session counts and stored bytes, and your account's\nstorage allowance. The allowance covers stored uncompressed bytes across all applications and does not reset daily.",
        "operationId": "list_applications",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationList"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "List applications with storage",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      }
    },
    "/v1/applications/{application}/sessions": {
      "get": {
        "description": "Returns an application's sessions by creation time, newest first, excluding deleted sessions, optionally filtered\nby creation time and metadata.",
        "operationId": "list_application_sessions",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "only sessions created at or after this instant (RFC 3339)",
            "in": "query",
            "name": "start",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "only sessions created at or after this instant (RFC 3339)"
            }
          },
          {
            "description": "only sessions created at or before this instant (RFC 3339)",
            "in": "query",
            "name": "end",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "only sessions created at or before this instant (RFC 3339)"
            }
          },
          {
            "description": "`key=value`; only sessions whose metadata holds the pair. Repeat for several pairs (all must hold).",
            "in": "query",
            "name": "metadata",
            "required": false,
            "schema": {
              "default": [],
              "description": "`key=value`; only sessions whose metadata holds the pair. Repeat for several pairs (all must hold).",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          {
            "description": "Sessions per page, up to 100",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "description": "Sessions per page, up to 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "The `next_cursor` of the previous page, with the same filters",
            "in": "query",
            "name": "after",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The `next_cursor` of the previous page, with the same filters"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationSessionList"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "List an application's sessions",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      }
    },
    "/v1/applications/{application}/sessions/{session_id}": {
      "delete": {
        "description": "Deletes the session's content and metadata and reserves its id, including an id never uploaded. A deleted\nsession answers `410`; repeated deletions return `204`.",
        "operationId": "delete_application_session",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "temporarily_unavailable: nothing was deleted; retry"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "Delete a session",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      },
      "get": {
        "description": "Returns a session's metadata, size, timestamps, and parent, without its content.",
        "operationId": "get_application_session",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationSessionView"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "Get session metadata",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      },
      "put": {
        "description": "Creates the session (`201`) or replaces its `metadata` (`200`). To create a fork, set `parent`\nto an active session in the same account and application, with an offset within that session's size. A session's\nparent is fixed at creation.",
        "operationId": "put_application_session",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionPut"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationSessionView"
                }
              }
            },
            "description": "Successful Response"
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationSessionView"
                }
              }
            },
            "description": "created"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "conflict: a session's parent is fixed at creation"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "Create or describe a session",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      }
    },
    "/v1/applications/{application}/sessions/{session_id}/appends": {
      "get": {
        "description": "Returns each append's offset, length, and confirmation time.",
        "operationId": "list_application_session_appends",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          },
          {
            "description": "Receipts per page, up to 100",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "description": "Receipts per page, up to 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "The `next_cursor` of the previous page, with the same filters",
            "in": "query",
            "name": "after",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The `next_cursor` of the previous page, with the same filters"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppendReceiptList"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "List append receipts",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      }
    },
    "/v1/applications/{application}/sessions/{session_id}/content": {
      "get": {
        "description": "Returns the session's bytes, uncompressed. A single `Range: bytes=a-b` or `Range: bytes=a-` returns\n`206` with `Content-Range`.",
        "operationId": "get_application_session_content",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "the session's bytes"
          },
          "206": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "the requested range"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account lacks `sessions`, or the credential kind may not use this method"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "416": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "range_not_satisfiable: the range does not start within the content"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "Get session content",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      },
      "patch": {
        "description": "Appends bytes starting at `Upload-Offset: n`. Any overlap with existing content must match byte for byte; a retry\nof bytes already held is accepted and not counted again. Success confirms that the append is saved; `verified_to`\nis your new confirmed cursor.",
        "operationId": "append_application_session_content",
        "parameters": [
          {
            "description": "the application's name in the session paths (for example `tauric`)",
            "in": "path",
            "name": "application",
            "required": true,
            "schema": {
              "description": "the application's name in the session paths (for example `tauric`)",
              "type": "string"
            }
          },
          {
            "description": "the session's id (`ApplicationSessionView.id`)",
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "description": "the session's id (`ApplicationSessionView.id`)",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/octet-stream": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppendResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key / api_key_inactive / api_key_expired / account_inactive"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "storage_full / entitlement_required / principal_not_permitted: the allowance cannot hold the append (`remaining_bytes` is given), or the credential may not write"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no such application or session for this account"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_offset_mismatch / session_diverged: the offset is past the stored size, or another writer continued (`size` is given)"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "session_deleted: the session was deleted; its id stays reserved"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "request_too_large: over 4 MiB encoded or decoded; send fewer bytes"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "unsupported_media_type: Content-Encoding gzip or identity"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request: the gzip body is not valid gzip; invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "summary": "Append session content",
        "tags": [
          "application-storage"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": "sessions",
          "exposure": "excluded",
          "family": "application-storage",
          "paid_result": false,
          "principal": "user",
          "quota": "storage",
          "reason": "the account's private application storage (client-side agent records): reached by the owning application's own credential over the HTTP API, never offered to an MCP client",
          "transport": "json"
        }
      }
    },
    "/v1/auth/access/status": {
      "post": {
        "description": "Returns the account's status, its entitlements (empty for an inactive or unknown account) and whether an exchange\nwould open a website session now. It creates nothing.",
        "operationId": "get_access_status",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccessStatusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccessStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "missing_api_key / invalid_api_key: the service key is absent or bad"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "principal_not_permitted: the credential is not this application's service key"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Read what a signed-in identity may use",
        "tags": [
          "authentication"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "operator",
          "paid_result": false,
          "principal": "admin",
          "quota": "exempt",
          "reason": "administration and credential management (not in the consumer document)",
          "transport": "json"
        }
      }
    },
    "/v1/auth/exchange": {
      "post": {
        "description": "Returns a one-time session token, valid for 60 seconds, that the browser redeems at\n`POST /v1/auth/session/redeem`. The first exchange of a new identity creates its account while registration is\nopen. An existing account is not changed.",
        "operationId": "exchange_identity",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExchangeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityExchangeResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_identity_token / missing_api_key / invalid_api_key: the user's access token is expired or invalid, or the service key is absent or bad"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required / principal_not_permitted: the account is not active, its tier includes no website access, sign-up is closed, or the credential is not this application's service key"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "rate_limit_exceeded / quota_exhausted"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "temporarily_unavailable: retry later"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Exchange a signed-in identity for a session token",
        "tags": [
          "authentication"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "operator",
          "paid_result": false,
          "principal": "admin",
          "quota": "data",
          "reason": "administration and credential management (not in the consumer document)",
          "transport": "json"
        }
      }
    },
    "/v1/auth/session": {
      "delete": {
        "description": "Ends the session and clears its cookie, whatever the session's state.",
        "operationId": "end_session",
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "quota_exhausted"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [],
        "summary": "End the website session",
        "tags": [
          "authentication"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "operator",
          "paid_result": false,
          "principal": "user",
          "quota": "none",
          "reason": "administration and credential management (not in the consumer document)",
          "transport": "json"
        }
      }
    },
    "/v1/auth/session/redeem": {
      "post": {
        "description": "Sets the `tauric_session` cookie and returns the CSRF token that mutating requests send as `X-CSRF-Token`. No key\nis needed; a token works once.",
        "operationId": "redeem_session",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RedeemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedeemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_exchange_token / invalid_api_key: the token is invalid, expired or already used"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "principal_not_permitted / entitlement_required: this account cannot open a website session"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "quota_exhausted"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "temporarily_unavailable: retry later"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [],
        "summary": "Redeem a session token for the session cookie",
        "tags": [
          "authentication"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "operator",
          "paid_result": false,
          "principal": "user",
          "quota": "none",
          "reason": "administration and credential management (not in the consumer document)",
          "transport": "json"
        }
      }
    },
    "/v1/products/{product_id}/notices": {
      "get": {
        "description": "Returns the product's unexpired notices. Apply any inclusive client-version bounds before displaying a notice;\nresponses can be reused for up to an hour.",
        "operationId": "get_product_notices",
        "parameters": [
          {
            "description": "The product: `tradingagents` or `tauric`",
            "in": "path",
            "name": "product_id",
            "required": true,
            "schema": {
              "description": "The product: `tradingagents` or `tauric`",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductNoticesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "entitlement_required"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "not_found: no product has this id"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "quota_exhausted"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            },
            "description": "server_error / temporarily_unavailable"
          }
        },
        "security": [],
        "summary": "Get product notices",
        "tags": [
          "notices"
        ],
        "x-tauric-operation": {
          "effect": null,
          "entitlement": null,
          "exposure": "excluded",
          "family": "platform",
          "paid_result": false,
          "principal": "user",
          "quota": "none",
          "reason": "a product's notices for its own clients",
          "transport": "json"
        }
      }
    }
  },
  "security": [
    {
      "SessionCookie": []
    }
  ]
}
