SessionReadResult

session/read result. The viewCursor is the fold head at read time — a point-in-time read, immediately stale if a foreign host is appending.

Fields and variants

• blockedPrompt
• deliveredInputs
• history
• lastTurn
• pendingRequests
• queuedInputs
• recoveryObservation
• session
• viewCursor
• worktree

Source

schema/msp/experimental/msp.schema.json#/types/SessionReadResult

{
  "description": "`session/read` result. The `viewCursor` is the fold head at\nread time — a point-in-time read, immediately stale if a foreign host is\nappending.",
  "properties": {
    "blockedPrompt": {
      "$ref": "#/$defs/BlockedPrompt",
      "description": "Same member as `session/resume`."
    },
    "deliveredInputs": {
      "description": "The inputs the read session's log delivered to its subagents.\nAbsent-when-empty: a missing member means nothing delivered,\nnever an error.",
      "items": {
        "$ref": "#/$defs/DeliveredInput"
      },
      "type": "array"
    },
    "history": {
      "$ref": "#/$defs/SessionHistory",
      "description": "The served history."
    },
    "lastTurn": {
      "$ref": "#/$defs/LastTurn",
      "description": "Same member as `session/resume`."
    },
    "pendingRequests": {
      "description": "The same pointer shape as `session/resume`. Because `session/read`\nnever subscribes this is a point-in-time log read only: no requests\nare re-issued after it.",
      "items": {
        "$ref": "#/$defs/PendingRequestPointer"
      },
      "type": "array"
    },
    "queuedInputs": {
      "description": "The inputs still queued for delivery to the read session. Absent-when-empty:\na missing member means nothing queued, never an error.",
      "items": {
        "$ref": "#/$defs/QueuedInput"
      },
      "type": "array"
    },
    "recoveryObservation": {
      "$ref": "#/$defs/RecoveryObservation",
      "description": "Current local construction only; never inferred from retained history.\nAbsence establishes neither a choice nor supported recovery."
    },
    "session": {
      "$ref": "#/$defs/Session",
      "description": "The session as folded point-in-time."
    },
    "viewCursor": {
      "description": "The fold head at read time.",
      "type": "string"
    },
    "worktree": {
      "$ref": "#/$defs/RuntimeWorktree",
      "description": "The facts of the runtime-owned worktree a child read session's\nsubagent runs in.\nA root read serves it absent; absent means no worktree facts, never\nan error."
    }
  },
  "required": [
    "history",
    "pendingRequests",
    "session",
    "viewCursor"
  ],
  "type": "object"
}