read_context

Generated automatically from the published contract sources.

Build metadata: Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/actions/read_context, with a bearer credential and the action's payload as the JSON body. It also accepts GET.

Contract description

Read one entry `list_context` listed — a contract, a guide, a skill, or a documentation tree — by its context ID. Results contain a bounded text chunk. Continue with `next_offset` and the returned `stamp` until `next_offset` is null; if the content changes, restart at offset zero without a stamp.

Access and action metadata

{
  "name": "read_context",
  "resource": "platform_context",
  "tier": "observe",
  "access": "anonymous",
  "summary": "Read a catalog content ID. Follow next_offset with its stamp to read the complete contracts, guide or live skill text.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

MCP catalog entry

{
  "name": "read_context",
  "tier": "observe",
  "scenario": "CHI-L0-05",
  "summary": "Read one entry `list_context` listed — a contract, a guide, a skill, or a documentation tree — by its context ID. Results contain a bounded text chunk. Continue with `next_offset` and the returned `stamp` until `next_offset` is null; if the content changes, restart at offset zero without a stamp.",
  "owners": []
}

request

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["id"]
Additional properties: false
/properties/offset Zero-based Unicode code-point offset in the complete text; defaults to 0. Use the previous response's next_offset for continuation. A nonzero offset requires its stamp.

Type: integer
Minimum: 0
Maximum: 9007199254740991
/properties/stamp The `stamp` member of the previous answer of this same read, copied unchanged: 64 lower-case hexadecimal characters, the SHA-256 of the text. Required with a nonzero offset, beside that answer's `next_offset`; a first read sends none. A change to the text returns context_changed; restart at offset 0 without a stamp. The stamp does not grant access.

Type: string
Pattern: ^[a-f0-9]{64}$
/properties/limit Maximum Unicode code points returned in this chunk: 1 through 16000, default 8000. Offsets and limits count code points, not UTF-8 bytes or UTF-16 code units.

Type: integer
Minimum: 1
Maximum: 16000
/properties/id A content ID returned by list_context whose tool is read_context. IDs select listed platform content, not arbitrary filesystem paths.

Type: string
Minimum length: 1
Maximum length: 160

response

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["contract_version","stamp","offset","total","next_offset","id","mime_type","text"]
Additional properties: false
/properties/contract_version Required value: 1
/properties/stamp Type: string
Pattern: ^[a-f0-9]{64}$
/properties/offset Type: integer
Minimum: 0
Maximum: 9007199254740991
/properties/total Type: integer
Minimum: 0
Maximum: 9007199254740991
/properties/next_offset Type: ["integer","null"]
Minimum: 0
Maximum: 9007199254740991
/properties/id Type: string
/properties/mime_type Type: string
/properties/continuation Present where this answer holds only part of the text: in words, the characters read of the total, then either the call that reads on, with next_offset as offset and this answer's stamp, or that this chunk is the last. Absent where one answer holds the whole text. The chunks' text joined in order is the whole text.

Type: string
/properties/text Type: string

Complete payload contract

{
  "request": {
    "type": "object",
    "properties": {
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Zero-based Unicode code-point offset in the complete text; defaults to 0. Use the previous response's next_offset for continuation. A nonzero offset requires its stamp."
      },
      "stamp": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$",
        "description": "The `stamp` member of the previous answer of this same read, copied unchanged: 64 lower-case hexadecimal characters, the SHA-256 of the text. Required with a nonzero offset, beside that answer's `next_offset`; a first read sends none. A change to the text returns context_changed; restart at offset 0 without a stamp. The stamp does not grant access."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 16000,
        "description": "Maximum Unicode code points returned in this chunk: 1 through 16000, default 8000. Offsets and limits count code points, not UTF-8 bytes or UTF-16 code units."
      },
      "id": {
        "type": "string",
        "minLength": 1,
        "maxLength": 160,
        "description": "A content ID returned by list_context whose tool is read_context. IDs select listed platform content, not arbitrary filesystem paths."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "properties": {
      "contract_version": {
        "const": 1
      },
      "stamp": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$"
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991
      },
      "total": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991
      },
      "next_offset": {
        "type": [
          "integer",
          "null"
        ],
        "minimum": 0,
        "maximum": 9007199254740991
      },
      "id": {
        "type": "string"
      },
      "mime_type": {
        "type": "string"
      },
      "continuation": {
        "type": "string",
        "description": "Present where this answer holds only part of the text: in words, the characters read of the total, then either the call that reads on, with next_offset as offset and this answer's stamp, or that this chunk is the last. Absent where one answer holds the whole text. The chunks' text joined in order is the whole text."
      },
      "text": {
        "type": "string"
      }
    },
    "required": [
      "contract_version",
      "stamp",
      "offset",
      "total",
      "next_offset",
      "id",
      "mime_type",
      "text"
    ],
    "additionalProperties": false
  }
}

Shared contracts