veryfront__append_run_eventsAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
run_id | string | Yes | Run identifier that scopes the request. Format: uuid. |
input | object | Yes | Structured input details used by the tool. |
idempotency_key | string | No | Retry key, 1-128 characters; overrides the HTTP Idempotency-Key header. Required for Task and Workflow event appends unless supplied in the header. No key is synthesized when both are omitted; Agent appends use their event sequence and cursor contract. Minimum length: 1. Maximum length: 128. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__append_run_events",
"arguments": {
"run_id": "00000000-0000-4000-8000-000000000000",
"input": {
"events": [
{
"type": "example"
}
]
}
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
latest_event_id | integer | Yes | The latest event id returned by the tool. Minimum: 0. |
latest_external_event_sequence | integer | No | The latest external event sequence returned by the tool. Minimum: 0. |
appended_count | integer | Yes | The appended count returned by the tool. Minimum: 0. |
acknowledged_event_ids | integer[] | No | List of acknowledged event ids returned by the tool. |
recovery_checkpoint | object | No | Structured recovery checkpoint details returned by the tool. |
run_id | string | Yes | Run identifier associated with this result. Format: uuid. |
model_call_captures | object[] | No | List of model call captures returned by the tool. |
tool_call_admissions | object[] | No | List of tool call admissions returned by the tool. |
Full schemas
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier that scopes the request."
},
"input": {
"type": "object",
"properties": {
"expected_previous_event_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "Provide the expected previous event id."
},
{
"type": "null",
"description": "Provide the expected previous event id."
}
],
"description": "Provide the expected previous event id."
},
"expected_previous_external_event_sequence": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "Provide the expected previous external event sequence."
},
{
"type": "null",
"description": "Provide the expected previous external event sequence."
}
],
"description": "Provide the expected previous external event sequence."
},
"external_sequence_scope": {
"type": "string",
"enum": [
"agent",
"publish_only"
],
"description": "Provide the external sequence scope."
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Provide the type."
}
},
"required": [
"type"
],
"additionalProperties": true,
"description": "One event item supplied to the tool."
},
"minItems": 1,
"maxItems": 100,
"description": "Provide one or more event values."
},
"tool_call_starts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"occurrence_id": {
"type": "string",
"format": "uuid",
"description": "Provide the occurrence id."
},
"event_index": {
"type": "integer",
"minimum": 0,
"maximum": 99,
"description": "Provide the event index."
}
},
"required": [
"occurrence_id",
"event_index"
],
"additionalProperties": false,
"description": "One tool call start item supplied to the tool."
},
"minItems": 1,
"maxItems": 100,
"description": "Provide one or more tool call start values."
},
"runtime_observations": {
"type": "object",
"properties": {
"version": {
"type": "number",
"const": 1,
"description": "Provide the version."
},
"observations": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "execution_entry",
"description": "Provide the kind."
},
"occurrence_id": {
"type": "string",
"format": "uuid",
"description": "Provide the occurrence id."
},
"event_index": {
"type": "integer",
"minimum": 0,
"maximum": 99,
"description": "Provide the event index."
}
},
"required": [
"kind",
"occurrence_id",
"event_index"
],
"additionalProperties": false,
"description": "One observation item supplied to the tool."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "step_started",
"description": "Provide the kind."
},
"step_id": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/occurrence_id",
"description": "Provide the step id."
},
"event_index": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/event_index",
"description": "Provide the event index."
}
},
"required": [
"kind",
"step_id",
"event_index"
],
"additionalProperties": false,
"description": "One observation item supplied to the tool."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "step_ended",
"description": "Provide the kind."
},
"step_id": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/occurrence_id",
"description": "Provide the step id."
},
"event_index": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/event_index",
"description": "Provide the event index."
}
},
"required": [
"kind",
"step_id",
"event_index"
],
"additionalProperties": false,
"description": "One observation item supplied to the tool."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "step_message",
"description": "Provide the kind."
},
"step_id": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/occurrence_id",
"description": "Provide the step id."
},
"message_span_id": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/occurrence_id",
"description": "Provide the message span id."
},
"event_index": {
"$ref": "#/properties/input/properties/runtime_observations/properties/observations/items/anyOf/0/properties/event_index",
"description": "Provide the event index."
}
},
"required": [
"kind",
"step_id",
"message_span_id",
"event_index"
],
"additionalProperties": false,
"description": "One observation item supplied to the tool."
}
],
"description": "One observation item supplied to the tool."
},
"minItems": 1,
"maxItems": 100,
"description": "Provide one or more observation values."
}
},
"required": [
"version",
"observations"
],
"additionalProperties": false,
"description": "Structured runtime observations details used by the tool."
},
"recovery_checkpoint": {
"type": "object",
"properties": {
"snapshot_event_index": {
"type": "integer",
"minimum": 0,
"maximum": 99,
"description": "Provide the snapshot event index."
},
"pending_model_turn_message_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "One pending model turn message id item supplied to the tool."
},
"maxItems": 100,
"description": "Provide one or more pending model turn message id values."
},
"snapshot": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Structured snapshot details used by the tool."
}
},
"required": [
"snapshot_event_index",
"pending_model_turn_message_ids",
"snapshot"
],
"additionalProperties": false,
"description": "Structured recovery checkpoint details used by the tool."
}
},
"required": [
"events"
],
"additionalProperties": false,
"description": "Structured input details used by the tool."
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Retry key, 1-128 characters; overrides the HTTP Idempotency-Key header. Required for Task and Workflow event appends unless supplied in the header. No key is synthesized when both are omitted; Agent appends use their event sequence and cursor contract."
}
},
"required": [
"run_id",
"input"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the append_run_events tool."
}
{
"type": "object",
"properties": {
"latest_event_id": {
"type": "integer",
"minimum": 0,
"description": "The latest event id returned by the tool."
},
"latest_external_event_sequence": {
"type": "integer",
"minimum": 0,
"description": "The latest external event sequence returned by the tool."
},
"appended_count": {
"type": "integer",
"minimum": 0,
"description": "The appended count returned by the tool."
},
"acknowledged_event_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "One acknowledged event id item returned by the tool."
},
"maxItems": 100,
"description": "List of acknowledged event ids returned by the tool."
},
"recovery_checkpoint": {
"type": "object",
"properties": {
"snapshot_event_id": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "The snapshot event id returned by the tool."
},
"snapshot_external_sequence": {
"$ref": "#/properties/recovery_checkpoint/properties/snapshot_event_id",
"description": "The snapshot external sequence returned by the tool."
},
"checkpoint_event_id": {
"$ref": "#/properties/recovery_checkpoint/properties/snapshot_event_id",
"description": "The checkpoint event id returned by the tool."
}
},
"required": [
"snapshot_event_id",
"snapshot_external_sequence",
"checkpoint_event_id"
],
"additionalProperties": false,
"description": "Structured recovery checkpoint details returned by the tool."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier associated with this result."
},
"model_call_captures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_id": {
"type": "string",
"minLength": 1,
"description": "The event id returned by the tool."
},
"model_call_id": {
"type": "string",
"format": "uuid",
"description": "The model call id returned by the tool."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier associated with this result."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
}
},
"required": [
"event_id",
"model_call_id",
"run_id",
"project_id"
],
"additionalProperties": false,
"description": "One model call capture item returned by the tool."
},
"minItems": 1,
"maxItems": 100,
"description": "List of model call captures returned by the tool."
},
"tool_call_admissions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"occurrence_id": {
"type": "string",
"format": "uuid",
"description": "The occurrence id returned by the tool."
},
"admission_event_id": {
"type": "string",
"pattern": "^[1-9]\\d{0,18}$",
"description": "The admission event id returned by the tool."
},
"start_event_id": {
"$ref": "#/properties/tool_call_admissions/items/properties/admission_event_id",
"description": "The start event id returned by the tool."
},
"tool_call_id": {
"type": "string",
"minLength": 1,
"description": "Tool call identifier associated with this result."
},
"public_tool_call_id": {
"type": "string",
"minLength": 1,
"description": "The public tool call id returned by the tool."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier associated with this result."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
}
},
"required": [
"occurrence_id",
"admission_event_id",
"start_event_id",
"tool_call_id",
"public_tool_call_id",
"run_id",
"project_id"
],
"additionalProperties": false,
"description": "One tool call admission item returned by the tool."
},
"minItems": 1,
"maxItems": 100,
"description": "List of tool call admissions returned by the tool."
}
},
"required": [
"latest_event_id",
"appended_count",
"run_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the append_run_events tool."
}