vv-agent 0.4.0

VectorVein agent runtime, SDK, CLI, tools, and workspace backends
Documentation
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ThreadReadResponse",
  "type": "object",
  "properties": {
    "activeTurn": {
      "anyOf": [
        {
          "$ref": "#/$defs/AppTurn"
        },
        {
          "type": "null"
        }
      ]
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AppItem"
      }
    },
    "thread": {
      "$ref": "#/$defs/AppThread"
    }
  },
  "required": [
    "thread",
    "items"
  ],
  "$defs": {
    "AppItem": {
      "type": "object",
      "properties": {
        "completedAtMs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "uint128",
          "minimum": 0
        },
        "content": true,
        "createdAtMs": {
          "type": "integer",
          "format": "uint128",
          "minimum": 0
        },
        "id": {
          "type": "string"
        },
        "runEventId": {
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/AppItemStatus"
        },
        "type": {
          "$ref": "#/$defs/AppItemKind"
        }
      },
      "required": [
        "id",
        "runEventId",
        "type",
        "status",
        "createdAtMs"
      ]
    },
    "AppItemKind": {
      "type": "string",
      "enum": [
        "userMessage",
        "agentMessage",
        "toolCall",
        "approvalRequest",
        "approvalResolved",
        "memoryCompact",
        "subRun",
        "handoff",
        "runStatus"
      ]
    },
    "AppItemStatus": {
      "type": "string",
      "enum": [
        "queued",
        "inProgress",
        "completed",
        "failed",
        "interrupted"
      ]
    },
    "AppThread": {
      "type": "object",
      "properties": {
        "activeTurnId": {
          "type": [
            "string",
            "null"
          ]
        },
        "archived": {
          "type": "boolean"
        },
        "createdAtMs": {
          "type": "integer",
          "format": "uint128",
          "minimum": 0
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "ephemeral": {
          "type": "boolean"
        },
        "id": {
          "type": "string"
        },
        "model": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "updatedAtMs": {
          "type": "integer",
          "format": "uint128",
          "minimum": 0
        }
      },
      "required": [
        "id",
        "status",
        "archived",
        "ephemeral",
        "createdAtMs",
        "updatedAtMs"
      ]
    },
    "AppTokenUsage": {
      "type": "object",
      "properties": {
        "inputTokens": {
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        },
        "outputTokens": {
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        },
        "totalTokens": {
          "type": "integer",
          "format": "uint64",
          "minimum": 0
        }
      },
      "required": [
        "inputTokens",
        "outputTokens",
        "totalTokens"
      ]
    },
    "AppTurn": {
      "type": "object",
      "properties": {
        "completedAtMs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "uint128",
          "minimum": 0
        },
        "id": {
          "type": "string"
        },
        "input": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/UserInput"
          }
        },
        "runId": {
          "type": "string"
        },
        "startedAtMs": {
          "type": [
            "integer",
            "null"
          ],
          "format": "uint128",
          "minimum": 0
        },
        "status": {
          "$ref": "#/$defs/TurnStatus"
        },
        "threadId": {
          "type": "string"
        },
        "tokenUsage": {
          "anyOf": [
            {
              "$ref": "#/$defs/AppTokenUsage"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "threadId",
        "runId",
        "status",
        "input"
      ]
    },
    "ThreadStatus": {
      "type": "string",
      "enum": [
        "idle",
        "running",
        "archived"
      ]
    },
    "TurnStatus": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "completed",
        "failed",
        "interrupted"
      ]
    },
    "UserInput": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        }
      },
      "required": [
        "text"
      ]
    }
  }
}