Skip to content

armgit / avibe

Public Imported from GitHub
0

Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.

22.6 KB
Raw Blame
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "agent-core/transcript-rows.schema.json",
  "title": "TranscriptRowPayloads",
  "description": "C-5 payloads of context rows (transcript.md). Written by the adapter's TranscriptStore for the `harness`; read by projection, fork, resume, and the Workbench model view. All shapes are persisted and versioned.",
  "definitions": {
    "CacheObservation": {
      "description": "Optional request-start diagnostics (system-prompt-cache-tiers.md). Never canonical usage or a C-9 control clock. Damaged diagnostics are ignored by readers; unknown fields permit additions without a migration.",
      "type": "object",
      "required": ["version"],
      "properties": {"version": {"const": 1}}
    },
    "CacheState": {
      "description": "Latest usage-bearing request per served provider/model; bounded sampled prefix hashes, never message content.",
      "type": "array",
      "items": {"$ref": "#/definitions/CacheObservation"}
    },
    "ModelInput": {
      "description": "`messages.content_json.model` on user, harness, agent_initiated, and annotation rows, set when the loop consumes the input.",
      "type": "object",
      "required": [
        "version",
        "message"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "message": {
          "$ref": "message.schema.json#/definitions/UserMessage",
          "description": "The input exactly as sent, including the rendered time and identity prefix and attachments."
        }
      }
    },
    "ModelResponse": {
      "description": "`messages.content_json.model` on assistant and result rows.",
      "type": "object",
      "required": [
        "version",
        "message"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "message": {
          "$ref": "message.schema.json#/definitions/AssistantMessage",
          "description": "Verbatim, including quick-reply blocks and file:// links that the display copy rewrites."
        },
        "cache": {"$ref": "#/definitions/CacheObservation"},
        "request": {
          "type": "object",
          "description": "C-9 (context.md section 2): the request this response answered, as sent, for the estimate anchor. Written only when context management is on.",
          "required": [
            "tokens"
          ],
          "additionalProperties": false,
          "properties": {
            "tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "tokens() of the whole request (context.md section 2): system prompt, tool definitions, and messages at UTF-8 bytes / 4, 1,600 per image, and each opaque reasoning payload at its response's reported reasoning, never as text."
            }
          }
        }
      }
    },
    "ToolResult": {
      "description": "`agent_events.content_json` of a `tool_result` row.",
      "type": "object",
      "required": [
        "version",
        "message"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "message": {
          "$ref": "message.schema.json#/definitions/ToolResultMessage"
        },
        "details": {
          "type": "object",
          "description": "Not sent to the model.",
          "properties": {
            "job_id": {
              "type": "string"
            },
            "watch_id": {
              "type": "string"
            },
            "recovered": {
              "type": "boolean",
              "description": "Committed by T2 settlement (recovery.md) after the call's run ended, not by the tool."
            },
            "exit_code": {
              "type": [
                "integer",
                "null"
              ]
            },
            "full_output_path": {
              "type": "string"
            },
            "truncated": {
              "type": "boolean"
            },
            "diff": {
              "type": "string",
              "description": "edit/write display diff."
            },
            "skills": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  }
                }
              },
              "description": "Set when the result carries skills `vibe skill load` loaded: one entry per top-level `<skill_content name>` block, in load order; the names a checkpoint lists. The result clears like any other."
            }
          }
        }
      }
    },
    "Compaction": {
      "description": "`agent_events.content_json` of a `context_compaction` row (context.md section 7). Its model-facing content (`summary`, `state`) is fixed when it is written, so projection is a pure function of the rows.",
      "type": "object",
      "required": [
        "version",
        "mode",
        "reason",
        "summary",
        "checkpoint",
        "state",
        "first_kept_seq",
        "kept_inputs",
        "summarized_to_seq",
        "files_read",
        "files_read_omitted",
        "files_modified",
        "files_modified_omitted",
        "skills",
        "skills_omitted",
        "tokens_before",
        "tokens_after_estimate",
        "threshold"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "mode": {
          "enum": [
            "normal",
            "rolling",
            "dropped"
          ],
          "description": "`normal`: the fork summarized the whole conversation and the tail stays verbatim; `rolling`: the fork summarized the prefix up to the cut (overflow ladder b); `dropped`: the prefix moved out with no model call (overflow ladder c)."
        },
        "reason": {
          "enum": [
            "threshold",
            "overflow"
          ]
        },
        "summary": {
          "type": "string",
          "description": "The rendered `<context-checkpoint>` message: framing, the mind (sections past their limits cut), the memo, the now, `<artifacts>`, `<skills>`, and `<earlier-record>` (a `checkpoint-v4` row: framing, checkpoint, `<artifacts>`, `<skills-loaded>`, `<earlier-record>`). Model-facing. The in-flight Turn's inputs before the cut (`kept_inputs`) stay in the projected context as they were, right before this message (context.md section 5)."
        },
        "checkpoint": {
          "type": "string",
          "description": "The model-written now: the text of the turn's one checkpoint block (a `checkpoint-v4` row: the whole model-written checkpoint). For `dropped`, the previous checkpoint's, or empty when there was none or it was too large for the route (context.md section 8 c)."
        },
        "state": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "State the adapter rendered from its own stores when the checkpoint was written (the environment's core fields); each is one text block after `summary`. Model-facing."
        },
        "first_kept_seq": {
          "type": "integer",
          "minimum": 1,
          "description": "`context_seq` of the first unit kept verbatim."
        },
        "kept_inputs": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1
          },
          "description": "`context_seq` of each input of the in-flight Turn (its first and every accepted steer) before `first_kept_seq`, ascending: projection keeps them verbatim, in order, right before this row's message (context.md section 5). Empty when the cut did not fall inside that Turn."
        },
        "summarized_to_seq": {
          "type": "integer",
          "minimum": 0,
          "description": "The last `context_seq` moved out of the context; the `<earlier-record>` hint names it."
        },
        "previous_compaction_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "files_read": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "Paths given to `read` and never to `write` or `edit`, cumulative, most recently touched first as the calls gave them: at most 5 (a `checkpoint-v4` row: 50); only the summary's display is cut."
        },
        "files_read_omitted": {
          "type": "boolean",
          "description": "Whether a read path was ever pushed out of `files_read`; once set, it stays set. A mark, not a count: a path pushed out and touched again is the same path."
        },
        "files_modified": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "Paths given to `write` or `edit`, cumulative, most recently touched first as the calls gave them: at most 10 (a `checkpoint-v4` row: 50); only the summary's display is cut."
        },
        "files_modified_omitted": {
          "type": "boolean",
          "description": "Whether a modified path was ever pushed out of `files_modified`; once set, it stays set."
        },
        "skills": {
          "type": "array",
          "description": "Names of the skills the row carries back (`skills_carried`), the most recently loaded first, at most 20. A `checkpoint-v4` row: the skills the summarized rows loaded, cumulative, minus those whose load result was still in the context, listed by name only in `<skills-loaded>`.",
          "items": {
            "type": "object",
            "required": [
              "name"
            ],
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string"
              }
            }
          },
          "maxItems": 20
        },
        "skills_omitted": {
          "type": "boolean",
          "description": "Whether a skill name was ever pushed out of `skills` (`checkpoint-v4` only; false from `checkpoint-v5` on)."
        },
        "mind": {
          "type": "string",
          "description": "The whole mind the checkpoint turn left in `mind.md` (context.md section 7), or the previous checkpoint's when the turn's was rejected (section 10); empty when there is none. `checkpoint-v5`; absent from a `checkpoint-v4` row."
        },
        "mind_truncated": {
          "type": "boolean",
          "description": "Whether `summary` shows the mind with sections cut to their limits; the cut sections point to a read-only copy of the whole (section 10)."
        },
        "memo": {
          "type": "array",
          "description": "The messages a person typed that the next context carries verbatim, in `context_seq` order (section 7).",
          "items": {
            "type": "object",
            "required": [
              "seq",
              "text",
              "truncated"
            ],
            "additionalProperties": false,
            "properties": {
              "seq": {
                "type": "integer",
                "minimum": 1,
                "description": "The message's `context_seq`."
              },
              "text": {
                "type": "string",
                "description": "What the person typed, cut to 300 tokens or to the memo's common share (section 10)."
              },
              "truncated": {
                "type": "boolean"
              }
            }
          }
        },
        "skills_carried": {
          "type": "array",
          "maxItems": 20,
          "description": "The skills the checkpoint carries back, as they read when it was written, the most recently loaded first (section 7).",
          "items": {
            "type": "object",
            "required": [
              "name",
              "revision",
              "loaded_at",
              "content",
              "truncated"
            ],
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string"
              },
              "revision": {
                "type": "string",
                "description": "The host's revision of the text (Vibey: its SHA-256)."
              },
              "loaded_at": {
                "type": "number",
                "description": "Epoch seconds of the result that last really loaded it; a carry is not a load."
              },
              "content": {
                "type": "string",
                "description": "Its text as its load prints it, cut to 5,000 tokens."
              },
              "truncated": {
                "type": "boolean"
              }
            }
          }
        },
        "tokens_before": {
          "type": "integer",
          "minimum": 0
        },
        "tokens_after_estimate": {
          "type": "integer",
          "minimum": 0
        },
        "threshold": {
          "type": "integer",
          "description": "T when the checkpoint was written; ineffective when `tokens_after_estimate >= 0.75 * threshold`."
        },
        "summarizer": {
          "type": [
            "object",
            "null"
          ],
          "description": "The checkpoint turn; null for `dropped`.",
          "required": [
            "origin",
            "prompt_version",
            "rounds"
          ],
          "additionalProperties": false,
          "properties": {
            "origin": {
              "$ref": "message.schema.json#/definitions/Origin"
            },
            "prompt_version": {
              "type": "string"
            },
            "rounds": {
              "type": "integer",
              "minimum": 0,
              "description": "Responses of the checkpoint turn that called tools: at most 5 rounds whose calls ran, plus one answered with the used-up budget text."
            }
          }
        },
        "usage": {
          "$ref": "message.schema.json#/definitions/Usage",
          "description": "Summed over the checkpoint turn's responses."
        }
      }
    },
    "ContextEdit": {
      "description": "`agent_events.content_json` of a `context_edit` row.",
      "type": "object",
      "required": [
        "version",
        "target_event_id",
        "replacement",
        "reason"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "target_event_id": {
          "type": "string",
          "description": "The `tool_result` row whose content is replaced in projection."
        },
        "replacement": {
          "type": "object",
          "required": [
            "text"
          ],
          "properties": {
            "text": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "reason": {
          "enum": [
            "clear_old_tool_result",
            "fit_tool_result"
          ],
          "description": "`clear_old_tool_result` replaces an old result with the cleared placeholder (context.md section 4); `fit_tool_result` shows the newest batch's result cut to fit, ending with its note (section 3). The row keeps the whole output either way."
        }
      }
    },
    "AgentState": {
      "description": "`agent_events.content_json` of an `agent_state` row: hook state at a commit point (loop-control.md section 7). Not projected into messages.",
      "type": "object",
      "required": [
        "version",
        "state"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "state": {
          "type": "object"
        }
      }
    },
    "ForkTurn": {
      "description": "`agent_events.content_json` of a `fork_turn` audit row (`TranscriptStore.append_audit(kind='fork_turn')`, `visibility = 'audit'`, no `context_seq`): one side turn (C-10 fork.md section 7), such as a C-9 checkpoint turn, and the messages it produced, from the attempt ledger. Written once on every exit but an abort (C-10 F7). Never context.",
      "type": "object",
      "required": [
        "version",
        "purpose",
        "policy",
        "point",
        "detail",
        "outcome",
        "messages"
      ],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "purpose": {
          "enum": [
            "checkpoint"
          ],
          "description": "What the side turn is for; grows with its consumers (C-10 section 13)."
        },
        "policy": {
          "enum": [
            "dreaming"
          ],
          "description": "The side-turn policy its calls ran under (C-10 section 6)."
        },
        "point": {
          "type": "object",
          "description": "The fork point (C-10 section 2): the caller's latest committed context_seq, and the number of units of that view the prefix kept (null: all of them).",
          "required": [
            "as_of",
            "units"
          ],
          "additionalProperties": false,
          "properties": {
            "as_of": {
              "type": "integer",
              "minimum": 0
            },
            "units": {
              "type": [
                "integer",
                "null"
              ],
              "minimum": 0
            }
          }
        },
        "detail": {
          "type": "object",
          "description": "Purpose fields, required. For `checkpoint`, the only purpose in v1: the C-9 reason and mode (context.md section 6). A later purpose adds its own shape with a conditional schema.",
          "required": [
            "reason",
            "mode"
          ],
          "additionalProperties": false,
          "properties": {
            "reason": {
              "enum": [
                "threshold",
                "overflow"
              ]
            },
            "mode": {
              "enum": [
                "normal",
                "rolling"
              ]
            }
          }
        },
        "outcome": {
          "enum": [
            "completed",
            "failed"
          ]
        },
        "error": {
          "type": [
            "string",
            "null"
          ]
        },
        "folded_event_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The row the caller's fold committed (for a checkpoint, its `context_compaction` row), or null."
        },
        "rounds": {
          "type": "integer",
          "minimum": 0
        },
        "repair": {
          "type": "string",
          "description": "Present when the side turn sent its one corrective follow-up (C-10 fork.md section 7 step 4): the problem the purpose's check named in it; for a checkpoint, the C-9 validator's (context.md section 6)."
        },
        "messages": {
          "type": "array",
          "description": "Every attempt's response or partial (failed and retried ones included), the turn's tool results, and a repair's follow-up user message, in order; a refused response that JSON cannot hold is left out (context.md section 10, invariant 6).",
          "items": {
            "$ref": "message.schema.json"
          }
        },
        "cache_state": {"$ref": "#/definitions/CacheState"},
        "cache_attempts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["cache"],
            "additionalProperties": false,
            "properties": {
              "cache": {"$ref": "#/definitions/CacheObservation"},
              "usage": {"$ref": "message.schema.json#/definitions/Usage"}
            }
          }
        },
        "usage": {
          "$ref": "message.schema.json#/definitions/Usage"
        }
      }
    },
    "ModelAttempt": {
      "description": "`agent_events.content_json` of a `model_attempt` audit row (`TranscriptStore.append_audit(kind='attempt')`, `visibility = 'audit'`, no `context_seq`): a conversation attempt with usage or cache diagnostics that did not become a response row (retried, relieved, a usage-only terminal, refused at admission, or a failed commit), written by the attempt ledger in every mode, with or without context management (context.md section 10, invariant 4). Never context.",
      "type": "object",
      "required": [
        "version",
        "error"
      ],
      "anyOf": [{"required": ["usage"]}, {"required": ["cache"]}],
      "additionalProperties": false,
      "properties": {
        "version": {
          "const": 1
        },
        "cache": {"$ref": "#/definitions/CacheObservation"},
        "cache_state": {"$ref": "#/definitions/CacheState"},
        "usage": {
          "$ref": "message.schema.json#/definitions/Usage"
        },
        "error": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why the attempt did not become a response: the provider error that ended it (`<kind>: <message>`), or, without one, why the model call ended (a refusal at admission, a failed commit)."
        }
      }
    }
  },
  "examples": [
    {
      "version": 1,
      "mode": "normal",
      "reason": "threshold",
      "summary": "<context-checkpoint>\nThis is your own consolidated memory of the earlier part of this conversation, written for you so you can continue. ...\n\n# 1. Where I stand\n...\n\n# 5. The user's words\n- (#3) ...\n\n# 6. Now\n...\n\n<artifacts>\nRead:\n- tests/test_paths.py\nModified:\n- core/paths.py\n</artifacts>\n<earlier-record>\n...\n</earlier-record>\n</context-checkpoint>",
      "checkpoint": "# 6. Now\n...",
      "state": [
        "<loaded-skills>\n...\n</loaded-skills>"
      ],
      "first_kept_seq": 412,
      "kept_inputs": [],
      "summarized_to_seq": 411,
      "previous_compaction_id": null,
      "files_read": [
        "tests/test_paths.py"
      ],
      "files_modified": [
        "core/paths.py"
      ],
      "files_read_omitted": false,
      "files_modified_omitted": false,
      "skills": [],
      "skills_omitted": false,
      "mind": "# 1. Where I stand\n...",
      "mind_truncated": false,
      "memo": [
        {
          "seq": 3,
          "text": "...",
          "truncated": false
        }
      ],
      "skills_carried": [],
      "tokens_before": 158432,
      "tokens_after_estimate": 31877,
      "threshold": 155808,
      "summarizer": {
        "origin": {
          "provider": "anthropic",
          "api": "anthropic",
          "model": "claude-opus-5-5"
        },
        "prompt_version": "checkpoint-v2",
        "rounds": 0
      },
      "usage": {
        "input_tokens": 1210,
        "output_tokens": 2304,
        "cache_read_tokens": 157020,
        "cache_write_tokens": 0
      }
    }
  ]
}