Decisions / Audit

Agent decisions queued for approval.

3 actions. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

`decisions.list`

GET

List agent decisions (the audit trail), optionally filtered by mission.

AI tool: decisions_list
API: GET /api/invoke/decisions.list

Input

Field	Type	Required
`missionId`	string	—
`limit`	integer	—
`offset`	integer	—
`orderBy`	string	—
`orderDir`	"asc" \| "desc"	—
`q`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "missionId": {
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "orderBy": {
      "type": "string"
    },
    "orderDir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "q": {
      "type": "string"
    }
  }
}

`decisions.approve`

POST · mutating

Approve an agent-proposed decision; the agent then executes it.

AI tool: decisions_approve
API: POST /api/invoke/decisions.approve

Input

Field	Type	Required	Description
`id`	string	yes
`approvedBy`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "approvedBy": {
      "default": "human",
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

`decisions.reject`

POST · mutating

Reject an agent-proposed decision with a reason.

AI tool: decisions_reject
API: POST /api/invoke/decisions.reject

Input

Field	Type	Required
`id`	string	yes
`reason`	string	yes
`rejectedBy`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "reason": {
      "type": "string"
    },
    "rejectedBy": {
      "default": "human",
      "type": "string"
    }
  },
  "required": [
    "id",
    "reason"
  ]
}