Ensure child run - Veryfront

veryfront__upsert_child_agent_run

Access

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
`parent_run_id`	`string`	Yes	Run that delegates the work; the caller must hold its current execution credential. Minimum length: `1`. Maximum length: `128`.
`tool_call_id`	`string`	Yes	Tool call in the parent run that starts the child; the pair identifies the child run. Minimum length: `1`. Maximum length: `128`.
`request`	`object`	Yes	Child agent and the input to start it with.

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__upsert_child_agent_run",
    "arguments": {
      "parent_run_id": "example",
      "tool_call_id": "example",
      "request": {}
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

Field	Type	Required	Description and constraints
`child_conversation_id`	`string`	Yes	Task conversation the child run belongs to. Format: `uuid`.
`child_run_id`	`string`	Yes	Child run ID. Minimum length: `1`.
`child_message_id`	`string`	Yes	Message that starts the child run. Format: `uuid`.
`agent_id`	`string`	Yes	Agent that runs the child. Minimum length: `1`.
`duplicate`	`boolean`	Yes	True when the child already existed and was returned instead of created.

Full schemas

{
  "type": "object",
  "properties": {
    "parent_run_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Run that delegates the work; the caller must hold its current execution credential."
    },
    "tool_call_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Tool call in the parent run that starts the child; the pair identifies the child run."
    },
    "request": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "minLength": 1,
          "description": "Provide the prompt."
        },
        "task_id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
          "description": "Provide the task id."
        },
        "context_mode": {
          "type": "string",
          "enum": [
            "continue",
            "fresh"
          ],
          "description": "Provide the context mode."
        },
        "idempotency_scope": {
          "type": "string",
          "enum": [
            "durable_task"
          ],
          "description": "Provide the idempotency scope."
        },
        "context": {
          "type": "object",
          "additionalProperties": {
            "description": "Additional structured values supplied to the tool."
          },
          "description": "Provide the context.",
          "default": {}
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Unique identifier for the target record."
              },
              "run_id": {
                "type": "string",
                "minLength": 1,
                "description": "Run identifier that scopes the request."
              },
              "message_id": {
                "type": "string",
                "minLength": 1,
                "description": "Provide the message id."
              },
              "tool_call_id": {
                "type": "string",
                "minLength": 1,
                "description": "Tool call identifier that links this request to a prior tool invocation."
              },
              "result_path": {
                "type": "string",
                "minLength": 1,
                "description": "Provide the result path."
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "description": "Provide the label."
              },
              "summary": {
                "type": "string",
                "minLength": 1,
                "description": "Provide the summary."
              }
            },
            "additionalProperties": true,
            "description": "One evidence ref item supplied to the tool."
          },
          "maxItems": 50,
          "description": "Provide the evidence refs."
        },
        "description": {
          "type": "string",
          "minLength": 1,
          "description": "Human-readable description that clarifies the request."
        },
        "agent_id": {
          "type": "string",
          "minLength": 1,
          "description": "Provide the agent id."
        },
        "project_id": {
          "type": "string",
          "format": "uuid",
          "description": "Project identifier for the target project."
        },
        "runtime_target_kind": {
          "type": "string",
          "enum": [
            "main_branch",
            "environment",
            "preview_branch"
          ],
          "description": "Provide the runtime target kind."
        },
        "target_environment_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "description": "Provide the target environment id."
            },
            {
              "type": "null",
              "description": "Provide the target environment id."
            }
          ],
          "description": "Provide the target environment id."
        },
        "target_branch_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "description": "Provide the target branch id."
            },
            {
              "type": "null",
              "description": "Provide the target branch id."
            }
          ],
          "description": "Provide the target branch id."
        },
        "source_target_kind": {
          "type": "string",
          "enum": [
            "project",
            "main_branch",
            "environment",
            "preview_branch"
          ],
          "description": "Provide the source target kind."
        },
        "allow_delegation": {
          "type": "boolean",
          "description": "Provide the allow delegation."
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "description": "One tool item supplied to the tool."
          },
          "maxItems": 500,
          "description": "Provide the tools."
        },
        "model": {
          "type": "string",
          "minLength": 1,
          "description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
        },
        "thinking": {
          "anyOf": [
            {
              "type": "boolean",
              "const": false,
              "description": "Provide the option 1."
            },
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "description": "Provide the option 2."
            }
          ],
          "description": "Provide the thinking."
        },
        "max_steps": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "Provide the max steps."
        }
      },
      "additionalProperties": true,
      "description": "Child agent and the input to start it with."
    }
  },
  "required": [
    "parent_run_id",
    "tool_call_id",
    "request"
  ],
  "additionalProperties": false,
  "description": "Arguments for the upsert_child_agent_run tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "child_conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Task conversation the child run belongs to."
    },
    "child_run_id": {
      "type": "string",
      "minLength": 1,
      "description": "Child run ID."
    },
    "child_message_id": {
      "type": "string",
      "format": "uuid",
      "description": "Message that starts the child run."
    },
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent that runs the child."
    },
    "duplicate": {
      "type": "boolean",
      "description": "True when the child already existed and was returned instead of created."
    }
  },
  "required": [
    "child_conversation_id",
    "child_run_id",
    "child_message_id",
    "agent_id",
    "duplicate"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the upsert_child_agent_run tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}