Skip to content

HTTP models: PersistedEventSideEffectPage – ResumeBody

Exact OpenAPI component declarations. $ref values identify other components in the complete schema.

PersistedEventSideEffectPage

Section titled “PersistedEventSideEffectPage”
{
  "properties": {
    "observed_at": {
      "type": "string",
      "format": "date-time",
      "title": "Observed At"
    },
    "deliveries": {
      "items": {
        "$ref": "#/components/schemas/PersistedEventSideEffectInspection"
      },
      "type": "array",
      "title": "Deliveries"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Next Cursor"
    }
  },
  "type": "object",
  "required": [
    "observed_at",
    "deliveries"
  ],
  "title": "PersistedEventSideEffectPage"
}

PriceBook

Section titled “PriceBook”
{
  "properties": {
    "price_book_version": {
      "type": "string",
      "title": "Price Book Version",
      "default": "application"
    },
    "generated_at": {
      "type": "string",
      "title": "Generated At",
      "default": "unspecified"
    },
    "prices": {
      "items": {
        "$ref": "#/components/schemas/ModelPrice"
      },
      "type": "array",
      "minItems": 1,
      "title": "Prices"
    },
    "contextual_pricing_requirements": {
      "items": {
        "$ref": "#/components/schemas/ContextualPricingRequirement"
      },
      "type": "array",
      "title": "Contextual Pricing Requirements",
      "default": []
    },
    "resource_mappings": {
      "items": {
        "$ref": "#/components/schemas/PricingResourceMapping"
      },
      "type": "array",
      "title": "Resource Mappings",
      "default": []
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "prices"
  ],
  "title": "PriceBook",
  "description": "A versioned collection of application-owned commercial model prices."
}

PriceSchedule

Section titled “PriceSchedule”
{
  "properties": {
    "effective_from": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Effective From"
    },
    "effective_through": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Effective Through"
    },
    "pricing": {
      "$ref": "#/components/schemas/TieredPricing"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "pricing",
    "provenance"
  ],
  "title": "PriceSchedule",
  "description": "One price schedule, effective on inclusive UTC calendar dates."
}

PriceTier

Section titled “PriceTier”
{
  "properties": {
    "max_input_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Input Tokens"
    },
    "input_per_million": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "string",
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
        }
      ],
      "title": "Input Per Million"
    },
    "output_per_million": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "string",
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
        }
      ],
      "title": "Output Per Million"
    },
    "cache_read_input_per_million": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "string",
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cache Read Input Per Million"
    },
    "cache_write_input_per_million": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "string",
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cache Write Input Per Million"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "input_per_million",
    "output_per_million"
  ],
  "title": "PriceTier",
  "description": "One context band of tiered pricing.\n\nTiers are ordered ascending by ``max_input_tokens``; the final tier may use\n``None`` to mean \"and above\"."
}

PricingCatalogDiagnostics

Section titled “PricingCatalogDiagnostics”
{
  "properties": {
    "configured": {
      "type": "boolean",
      "title": "Configured"
    },
    "metadata_status": {
      "type": "string",
      "enum": [
        "available",
        "not_configured",
        "omitted"
      ],
      "title": "Metadata Status"
    },
    "price_book_version": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Book Version"
    },
    "generated_at": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256
        },
        {
          "type": "null"
        }
      ],
      "title": "Generated At"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "configured",
    "metadata_status"
  ],
  "title": "PricingCatalogDiagnostics"
}

PricingContext

Section titled “PricingContext”
{
  "properties": {
    "dimensions": {
      "additionalProperties": {
        "type": "string"
      },
      "type": "object",
      "title": "Dimensions"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "dimensions"
  ],
  "title": "PricingContext",
  "description": "One exact set of commercial dimensions that may price a dispatch."
}

PricingContextSelector

Section titled “PricingContextSelector”
{
  "properties": {
    "dimensions": {
      "additionalProperties": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "type": "object",
      "title": "Dimensions"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "dimensions"
  ],
  "title": "PricingContextSelector",
  "description": "Exact pricing dimensions accepted by one contextual price row."
}

PricingResourceMapping

Section titled “PricingResourceMapping”
{
  "properties": {
    "provider_name": {
      "type": "string",
      "title": "Provider Name"
    },
    "resource_id": {
      "type": "string",
      "title": "Resource Id"
    },
    "pricing_model": {
      "type": "string",
      "title": "Pricing Model"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "provider_name",
    "resource_id",
    "pricing_model"
  ],
  "title": "PricingResourceMapping",
  "description": "Map one opaque provider resource to an explicit pricing model."
}

Provenance

Section titled “Provenance”
{
  "properties": {
    "source": {
      "type": "string",
      "title": "Source"
    },
    "url": {
      "type": "string",
      "title": "Url"
    },
    "as_of": {
      "type": "string",
      "title": "As Of"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "source",
    "url",
    "as_of"
  ],
  "title": "Provenance",
  "description": "Where model or pricing facts came from and when they were checked."
}

ProviderOperationResolutionAction

Section titled “ProviderOperationResolutionAction”
{
  "type": "string",
  "enum": [
    "fallback_retry",
    "fail"
  ],
  "title": "ProviderOperationResolutionAction",
  "description": "Explicit dispositions for a provider operation Cayu cannot continue exactly."
}

ProviderOperationResolutionBody

Section titled “ProviderOperationResolutionBody”
{
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "title": "Session Id"
    },
    "task_worker_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Task Worker Id"
    },
    "task_handoff_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Task Handoff Id"
    },
    "stage_id": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "title": "Stage Id"
    },
    "expected_run_epoch": {
      "type": "integer",
      "maximum": 9.223372036854776e+18,
      "minimum": 0.0,
      "title": "Expected Run Epoch"
    },
    "action": {
      "$ref": "#/components/schemas/ProviderOperationResolutionAction"
    },
    "reason": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 4096,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Reason"
    },
    "metadata": {
      "additionalProperties": true,
      "type": "object",
      "title": "Metadata"
    },
    "resolved_by": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ResolutionActor"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "type": "object",
  "required": [
    "session_id",
    "stage_id",
    "expected_run_epoch",
    "action"
  ],
  "title": "ProviderOperationResolutionBody",
  "description": "Explicit retry-or-fail disposition for unavailable provider work."
}

ProviderStatePart

Section titled “ProviderStatePart”
{
  "properties": {
    "type": {
      "type": "string",
      "const": "provider_state",
      "title": "Type",
      "default": "provider_state"
    },
    "provider": {
      "type": "string",
      "title": "Provider"
    },
    "state": {
      "additionalProperties": true,
      "type": "object",
      "title": "State"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "provider"
  ],
  "title": "ProviderStatePart"
}

RecoveryBlockerCode

Section titled “RecoveryBlockerCode”
{
  "type": "string",
  "enum": [
    "registration_unavailable",
    "registration_incompatible",
    "active_recovery_claim",
    "active_execution_owner",
    "active_task_claim",
    "model_effect_outcome_unknown",
    "tool_effect_outcome_unknown",
    "tool_effect_continuation_required",
    "tool_approval_required",
    "user_input_required",
    "invalid_durable_state"
  ],
  "title": "RecoveryBlockerCode"
}

ReportedCostObservation

Section titled “ReportedCostObservation”
{
  "properties": {
    "session_id": {
      "type": "string",
      "title": "Session Id"
    },
    "event_id": {
      "type": "string",
      "title": "Event Id"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "title": "Timestamp"
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Request Id"
    },
    "provider_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Provider Name"
    },
    "model": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Model"
    },
    "cost": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 18
        },
        {
          "type": "null"
        }
      ],
      "title": "Cost"
    },
    "currency": {
      "anyOf": [
        {
          "type": "string",
          "const": "USD"
        },
        {
          "type": "null"
        }
      ],
      "title": "Currency"
    },
    "status": {
      "type": "string",
      "enum": [
        "reported",
        "pending",
        "unavailable"
      ],
      "title": "Status"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "session_id",
    "event_id",
    "timestamp",
    "request_id",
    "provider_name",
    "model",
    "cost",
    "currency",
    "status"
  ],
  "title": "ReportedCostObservation"
}

ReportedCostPage

Section titled “ReportedCostPage”
{
  "properties": {
    "records": {
      "items": {
        "$ref": "#/components/schemas/ReportedCostObservation"
      },
      "type": "array",
      "maxItems": 100,
      "title": "Records",
      "default": []
    },
    "truncated": {
      "type": "boolean",
      "title": "Truncated",
      "default": false
    }
  },
  "additionalProperties": false,
  "type": "object",
  "title": "ReportedCostPage",
  "description": "Latest retained observations, not a total or a current financial readback."
}

RequestCostRoute

Section titled “RequestCostRoute”
{
  "properties": {
    "method": {
      "type": "string",
      "maxLength": 16,
      "title": "Method"
    },
    "route": {
      "type": "string",
      "maxLength": 512,
      "title": "Route"
    },
    "requests": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Requests"
    },
    "requests_per_minute": {
      "type": "number",
      "minimum": 0.0,
      "title": "Requests Per Minute"
    },
    "streaming_requests": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Streaming Requests"
    },
    "status_2xx": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Status 2Xx"
    },
    "status_3xx": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Status 3Xx"
    },
    "status_4xx": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Status 4Xx"
    },
    "status_5xx": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Status 5Xx"
    },
    "wall_ms_p50": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Wall Ms P50"
    },
    "wall_ms_p95": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Wall Ms P95"
    },
    "wall_ms_max": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Wall Ms Max"
    },
    "cpu_seconds": {
      "type": "number",
      "minimum": 0.0,
      "title": "Cpu Seconds"
    },
    "cpu_seconds_per_minute": {
      "type": "number",
      "minimum": 0.0,
      "title": "Cpu Seconds Per Minute"
    },
    "vcpu_share": {
      "type": "number",
      "minimum": 0.0,
      "title": "Vcpu Share"
    },
    "response_bytes": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Response Bytes"
    },
    "clients": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Clients"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "method",
    "route",
    "requests",
    "requests_per_minute",
    "streaming_requests",
    "status_2xx",
    "status_3xx",
    "status_4xx",
    "status_5xx",
    "cpu_seconds",
    "cpu_seconds_per_minute",
    "vcpu_share",
    "response_bytes",
    "clients"
  ],
  "title": "RequestCostRoute",
  "description": "Aggregated cost of one method and route template inside the window."
}

RequestCostSummary

Section titled “RequestCostSummary”
{
  "properties": {
    "observed_at": {
      "type": "string",
      "format": "date-time",
      "title": "Observed At"
    },
    "enabled": {
      "type": "boolean",
      "title": "Enabled"
    },
    "requested_window_seconds": {
      "type": "number",
      "maximum": 86400.0,
      "exclusiveMinimum": 0.0,
      "title": "Requested Window Seconds"
    },
    "window_seconds": {
      "type": "number",
      "maximum": 86400.0,
      "minimum": 0.0,
      "title": "Window Seconds"
    },
    "truncated": {
      "type": "boolean",
      "title": "Truncated"
    },
    "buffer_capacity": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Buffer Capacity"
    },
    "vcpu": {
      "type": "number",
      "exclusiveMinimum": 0.0,
      "title": "Vcpu"
    },
    "requests": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Requests"
    },
    "requests_per_minute": {
      "type": "number",
      "minimum": 0.0,
      "title": "Requests Per Minute"
    },
    "cpu_seconds": {
      "type": "number",
      "minimum": 0.0,
      "title": "Cpu Seconds"
    },
    "cpu_seconds_per_minute": {
      "type": "number",
      "minimum": 0.0,
      "title": "Cpu Seconds Per Minute"
    },
    "vcpu_share": {
      "type": "number",
      "minimum": 0.0,
      "title": "Vcpu Share"
    },
    "route_count": {
      "type": "integer",
      "minimum": 0.0,
      "title": "Route Count"
    },
    "routes": {
      "items": {
        "$ref": "#/components/schemas/RequestCostRoute"
      },
      "type": "array",
      "maxItems": 200,
      "title": "Routes"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "observed_at",
    "enabled",
    "requested_window_seconds",
    "window_seconds",
    "truncated",
    "buffer_capacity",
    "vcpu",
    "requests",
    "requests_per_minute",
    "cpu_seconds",
    "cpu_seconds_per_minute",
    "vcpu_share",
    "route_count",
    "routes"
  ],
  "title": "RequestCostSummary",
  "description": "Per-route request rate, latency, and CPU over a recent window.\n\n``window_seconds`` is the span actually covered by retained records: it is\nshorter than ``requested_window_seconds`` when the process started more\nrecently or when the bounded buffer has already evicted records from the\nrequested span (``truncated``). Rates and the vCPU share use the covered\nspan. ``vcpu_share`` is request CPU seconds per second divided by ``vcpu``.\n``routes`` is ordered by CPU seconds, highest first; latency percentiles\nexclude streaming responses, whose duration is the stream lifetime."
}

ResolutionActor

Section titled “ResolutionActor”
{
  "properties": {
    "subject": {
      "type": "string",
      "title": "Subject"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tenant"
    },
    "source": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ResolutionActorSource"
        },
        {
          "type": "null"
        }
      ]
    },
    "claims": {
      "additionalProperties": true,
      "type": "object",
      "title": "Claims"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "subject"
  ],
  "title": "ResolutionActor",
  "description": "Typed actor identity for trusted runtime operator actions.\n\nStamped into approval, user-input, recovery, and interruption event payloads\nso the audit trail answers who performed an operator action without\nconsulting app-side state. ``reason`` and ``metadata`` on requests remain\ncaller-claimed free-form data; this model is the provenance field."
}

ResolutionActorSource

Section titled “ResolutionActorSource”
{
  "type": "string",
  "enum": [
    "http_auth",
    "request",
    "system"
  ],
  "title": "ResolutionActorSource",
  "description": "How a ``ResolutionActor``'s identity claim was established.\n\n``HTTP_AUTH`` is produced only by the server layer from a verified\n``AuthContext``; ``REQUEST`` marks a caller-asserted identity (SDK or\nopen-access HTTP body); ``SYSTEM`` marks runtime-generated actors such as\ndeterministic approval expiry. Direct SDK callers are a trusted boundary\nand may construct system actors; HTTP bodies cannot \u2014 the server re-stamps\nopen-access bodies to ``REQUEST`` and rejects them entirely under auth."
}

ResumeBody

Section titled “ResumeBody”
{
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "title": "Session Id"
    },
    "task_worker_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Task Worker Id"
    },
    "task_handoff_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Task Handoff Id"
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "title": "Prompt"
    },
    "profile_adoption": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ExecutionProfileAdoptionBody"
        },
        {
          "type": "null"
        }
      ]
    },
    "failover": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ModelFailoverPolicy"
        },
        {
          "type": "null"
        }
      ]
    },
    "max_steps": {
      "type": "integer",
      "maximum": 9007199254740991.0,
      "minimum": 1.0,
      "title": "Max Steps",
      "default": 64
    },
    "limits": {
      "$ref": "#/components/schemas/RunLimits"
    },
    "budget_limits": {
      "items": {
        "$ref": "#/components/schemas/BudgetLimit"
      },
      "type": "array",
      "title": "Budget Limits"
    },
    "retry_policy": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/RetryPolicy"
        },
        {
          "type": "null"
        }
      ]
    },
    "tool_completion": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ToolCompletionPolicy"
        },
        {
          "type": "null"
        }
      ]
    },
    "structured_output": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/StructuredOutputSpec"
        },
        {
          "type": "null"
        }
      ]
    },
    "thinking": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/ThinkingConfig"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "type": "object",
  "required": [
    "session_id",
    "prompt"
  ],
  "title": "ResumeBody"
}