The harness runner made internal/agentexec import go-git, which the tools module reaches through docsgen, so tools/go.sum needed its entries; tidy also dropped the stale modernc sqlite requirements. Request gained the Harness field, so contracts.json is regenerated with the HarnessSpec schema.
468 lines
12 KiB
JSON
468 lines
12 KiB
JSON
{
|
|
"generatedBy": "tools/docsgen",
|
|
"schemas": {
|
|
"AgentExecutionRequest": {
|
|
"additionalProperties": false,
|
|
"description": "Request is the complete, serializable input for one agent stage.",
|
|
"properties": {
|
|
"attempt": {
|
|
"type": "integer"
|
|
},
|
|
"budget": {
|
|
"$ref": "#/schemas/Budget"
|
|
},
|
|
"capture_tools": {
|
|
"items": {
|
|
"$ref": "#/schemas/CaptureTool"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"context_window": {
|
|
"type": "integer"
|
|
},
|
|
"extra_rules": {
|
|
"type": "string"
|
|
},
|
|
"gate": {
|
|
"$ref": "#/schemas/Gate"
|
|
},
|
|
"harness": {
|
|
"$ref": "#/schemas/HarnessSpec",
|
|
"description": "Harness, when set, runs the stage on an external coding-agent CLI\ninstead of the built-in loop. The worker in a Kit container is the\ndaemon's own archie-agent build, so it always understands this field."
|
|
},
|
|
"mission": {
|
|
"type": "string"
|
|
},
|
|
"model": {
|
|
"type": "string"
|
|
},
|
|
"notes": {
|
|
"type": "string"
|
|
},
|
|
"plugins": {
|
|
"description": "Plugins are bundled Yaegi plugins from the skill's plugins/\ndirectory. Each entry carries the name and source so the agent\ncan register them as tools. PRD section 5 Layer 1.",
|
|
"items": {
|
|
"$ref": "#/schemas/PluginSpec"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"preflight": {
|
|
"items": {
|
|
"$ref": "#/schemas/Command"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"protection": {
|
|
"$ref": "#/schemas/Protection"
|
|
},
|
|
"read_only": {
|
|
"type": "boolean"
|
|
},
|
|
"stage": {
|
|
"type": "string"
|
|
},
|
|
"task_id": {
|
|
"type": "integer"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"workflow": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"version",
|
|
"task_id",
|
|
"attempt",
|
|
"stage",
|
|
"model",
|
|
"mission",
|
|
"budget",
|
|
"gate",
|
|
"protection"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"AgentExecutionResult": {
|
|
"additionalProperties": false,
|
|
"description": "Result is the serializable outcome of one agent stage.",
|
|
"properties": {
|
|
"appended_notes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"attempt": {
|
|
"type": "integer"
|
|
},
|
|
"captures": {
|
|
"additionalProperties": {
|
|
"items": true,
|
|
"type": "array"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"changes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"detail": {
|
|
"type": "string"
|
|
},
|
|
"iterations": {
|
|
"type": "integer"
|
|
},
|
|
"stage": {
|
|
"type": "string"
|
|
},
|
|
"status": {
|
|
"type": "string"
|
|
},
|
|
"stop_reason": {
|
|
"type": "string"
|
|
},
|
|
"summary": {
|
|
"type": "string"
|
|
},
|
|
"task_id": {
|
|
"type": "integer"
|
|
},
|
|
"tokens_used": {
|
|
"type": "integer"
|
|
},
|
|
"usage": {
|
|
"$ref": "#/schemas/Usage"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"version",
|
|
"task_id",
|
|
"attempt",
|
|
"stage",
|
|
"status",
|
|
"usage"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Budget": {
|
|
"additionalProperties": false,
|
|
"description": "Budget bounds one autonomous execution.",
|
|
"properties": {
|
|
"max_steps": {
|
|
"type": "integer"
|
|
},
|
|
"wall_clock": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"CaptureTool": {
|
|
"additionalProperties": false,
|
|
"description": "CaptureTool declares a structured-output tool whose calls are returned to the daemon as data.",
|
|
"properties": {
|
|
"boolean_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"max_calls": {
|
|
"type": "integer"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"non_empty_strings": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"parameters": true,
|
|
"required_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"required_when_true": {
|
|
"additionalProperties": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"description": "RequiredWhenTrue makes fields required only when a boolean field in\nthe same call is true, keyed by that boolean's name. It exists because\na flat RequiredFields entry cannot express \"name a workflow, but only\nwhen you have said one is needed\": the alternatives were forcing a\nmeaningless answer on the other branch, or accepting the omission and\ndefaulting it, which lets the model skip the decision entirely.\nA named field must also be a non-empty string when the trigger is true.",
|
|
"type": "object"
|
|
}
|
|
},
|
|
"required": [
|
|
"name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Command": {
|
|
"additionalProperties": false,
|
|
"description": "Command is one executable gate or preflight command.",
|
|
"properties": {
|
|
"argv": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"expect_failure": {
|
|
"type": "boolean"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"argv"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Gate": {
|
|
"additionalProperties": false,
|
|
"description": "Gate is the quality gate an agent must satisfy.",
|
|
"properties": {
|
|
"commands": {
|
|
"items": {
|
|
"$ref": "#/schemas/Command"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"max_consecutive_failures": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"HarnessSpec": {
|
|
"additionalProperties": false,
|
|
"description": "HarnessSpec is how to drive a Kit's agent headlessly: its launch argv (image entrypoint and cmd) and the agent-sessions@1 verb tails appended to it.",
|
|
"properties": {
|
|
"continue": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"launch": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"prompt": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"resume": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"launch",
|
|
"prompt"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"MediaAttachment": {
|
|
"additionalProperties": false,
|
|
"description": "MediaAttachment describes a file attached to a message.",
|
|
"properties": {
|
|
"duration": {
|
|
"description": "Duration is the play time in seconds for audio and video.",
|
|
"type": "integer"
|
|
},
|
|
"file_id": {
|
|
"description": "FileID is the platform-assigned identifier for download APIs.",
|
|
"type": "string"
|
|
},
|
|
"file_name": {
|
|
"description": "FileName is the original file name when known.",
|
|
"type": "string"
|
|
},
|
|
"file_size": {
|
|
"description": "FileSize is the attachment size in bytes. nil means unknown.",
|
|
"type": "integer"
|
|
},
|
|
"height": {
|
|
"description": "Height is the pixel height for images and video. nil means unknown\nor not applicable.",
|
|
"type": "integer"
|
|
},
|
|
"mime_type": {
|
|
"description": "MIMEType is the content type (e.g. \"image/png\", \"audio/ogg\").",
|
|
"type": "string"
|
|
},
|
|
"path": {
|
|
"description": "Path is a local filesystem path on the host that produced the\nattachment. It is the alternative to URL for outbound delivery: a\nURL is fetched by the platform, a Path is uploaded by us. A file the\nagent wrote has no URL and never gets one -- publishing it would\ntrade a delivery problem for a hosting and access-control one -- so\nsenders that support upload must read this.\n\nExactly one of URL and Path is meaningful for an outbound send.",
|
|
"type": "string"
|
|
},
|
|
"raw": {
|
|
"description": "Raw carries platform-specific fields the common vocabulary does not\ncover, so adapters never need a second attachment type.",
|
|
"type": "object"
|
|
},
|
|
"type": {
|
|
"description": "Type is \"image\", \"video\", \"audio\", or \"document\".",
|
|
"type": "string"
|
|
},
|
|
"url": {
|
|
"description": "URL is a direct download URL when available. May be empty for\nplatforms that require a download API call.",
|
|
"type": "string"
|
|
},
|
|
"width": {
|
|
"description": "Width is the pixel width for images and video. nil means unknown\nor not applicable.",
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"file_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"MessageEvent": {
|
|
"additionalProperties": false,
|
|
"description": "MessageEvent is the rich message model for gateway channels.",
|
|
"properties": {
|
|
"callback_data": {
|
|
"type": "string"
|
|
},
|
|
"channel_id": {
|
|
"type": "string"
|
|
},
|
|
"edited_from": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"media": {
|
|
"items": {
|
|
"$ref": "#/schemas/MediaAttachment"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"platform": {
|
|
"type": "string"
|
|
},
|
|
"raw": {
|
|
"type": "object"
|
|
},
|
|
"reacted_to_id": {
|
|
"type": "string"
|
|
},
|
|
"reaction": {
|
|
"type": "string"
|
|
},
|
|
"reply_to_id": {
|
|
"type": "string"
|
|
},
|
|
"sender_id": {
|
|
"type": "string"
|
|
},
|
|
"sender_name": {
|
|
"type": "string"
|
|
},
|
|
"text": {
|
|
"type": "string"
|
|
},
|
|
"thread_id": {
|
|
"type": "string"
|
|
},
|
|
"timestamp": {
|
|
"type": "integer"
|
|
},
|
|
"type": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"channel_id",
|
|
"platform",
|
|
"sender_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"PluginSpec": {
|
|
"additionalProperties": false,
|
|
"description": "PluginSpec is a bundled Yaegi plugin passed from daemon to agent.",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"src": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"src"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Protection": {
|
|
"additionalProperties": false,
|
|
"description": "Protection describes paths the agent may read but not mutate.",
|
|
"properties": {
|
|
"globs": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"suffixes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"Usage": {
|
|
"additionalProperties": false,
|
|
"description": "Usage preserves provider-reported token economics for evaluation.",
|
|
"properties": {
|
|
"cache_creation_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"cached_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"completion_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"prompt_tokens": {
|
|
"type": "integer"
|
|
},
|
|
"total_tokens": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
}
|
|
}
|
|
}
|