record_run_step

Record run step

Record the current result of an agent-driven workflow run, in score order.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Can delete or overwrite: Can delete, overwrite, cancel or withdraw something the caller already has, so a host should confirm it.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Inputs

run_idstring · required
uuid
step_idstring · required
matches ^[a-z][a-z0-9_]*$
resultobject or object (approved: true) · required

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "record_run_step",
    "arguments": {
      "run_id": "00000000-0000-4000-8000-000000000000",
      "step_id": "<step_id>",
      "result": {
        "text": "<text>"
      }
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid"
    },
    "step_id": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_]*$"
    },
    "result": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "text": {
              "type": "string"
            }
          },
          "required": [
            "text"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "items"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "records": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  ]
                }
              }
            }
          },
          "required": [
            "records"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "generation_ids": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid"
              },
              "minItems": 1,
              "maxItems": 30
            }
          },
          "required": [
            "generation_ids"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "transcription_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "transcription_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "approved": {
              "type": "boolean",
              "const": true
            }
          },
          "required": [
            "approved"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "generation_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "generation_id"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "run_id",
    "step_id",
    "result"
  ],
  "additionalProperties": false
}

Related tools

generate_image
Make an image in the user's Kuro account.
generate_clip
Start a short video clip generation.
animate_image
Animate an existing image or upload into a clip.
generate_voiceover
Start a voice-over generation from text.
generate_music
Start a music generation from a creative brief.
set_recipe_gallery
Put a ready generation made with a recipe on that recipe's public gallery — the examples a reader sees under the recipe — or take it off with `listed: fal…
quote_generation
Price a request exactly, and compare it to the balance, without creating anything.
set_brand_note
Replace the user's brand note (at most 2000 characters): who they are, what they sell, their tone, colours and words to avoid.

Every tool· This page as Markdown