# Tool input reference

Generated from the verified server assembly using the pinned wheel extraction.
This records source-defined input shape only. It does not claim client setup, authorization, live availability, or successful operation.
Descriptions, titles, and examples are omitted from public structural blocks; all structural constraints are retained.

Coverage: **78 tools in 11 static groups**.

## Groups and exact names

### core (36)

`list_zones`, `orient`, `list_available_apps`, `read`, `query`, `list_files`, `search`, `list_skills`, `get_skill`, `list_actions`, `invoke_app_action`, `check_write`, `subscribe`, `poll_answer`, `list_questions`, `list_review_queue`, `get_proposal`, `onboarding_state`, `onboarding_status`, `list_loops`, `get_loop`, `get_case`, `get_loop_metrics`, `list_records`, `get_record`, `get_governance_inbox`, `automation_compose`, `loop_compose`, `propose_write`, `ask`, `resolve_question`, `post_event`, `onboarding_record`, `onboarding_preview`, `onboarding_apply`, `act`

### backup (5)

`backup_status`, `backup_connect_start`, `backup_connect_poll`, `backup_decline`, `recovery_kit_download`

### token-admin (4)

`mint_owner_token`, `list_owner_tokens`, `mint_teammate_token`, `revoke_owner_token`

### identity (2)

`acquire_user_token_v1`, `request_session_assertion_v1`

### feed (1)

`get_feed_v1`

### access-profile (7)

`list_zone_catalog`, `list_access_profiles`, `save_access_profile`, `delete_access_profile`, `assign_access_profile`, `set_access_management`, `set_automation_delegation`

### broker (1)

`broker_call`

### connection (4)

`connection_call`, `list_connections`, `test_connection`, `remove_connection`

### oauth2-connect (3)

`oauth2_connect_start`, `oauth2_connect_poll`, `oauth2_connect_complete`

### task-session (14)

`task_get`, `task_list`, `task_create`, `task_update`, `task_transition`, `task_claim`, `task_link`, `task_sweep`, `task_import`, `task_session_open`, `task_session_heartbeat`, `task_session_close`, `task_release`, `task_handoff`

### app-session (1)

`renew_app_session`

## Tool input schemas

### `list_zones`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `orient`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `list_available_apps`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `read`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "offset": {
      "type": "integer"
    },
    "limit": {
      "type": "integer"
    },
    "mode": {
      "type": "string",
      "enum": [
        "full",
        "head"
      ]
    },
    "memory_view": {
      "type": "string",
      "enum": [
        "current",
        "evidence"
      ]
    }
  },
  "required": [
    "path"
  ]
}
```

### `query`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "memory_view": {
      "type": "string",
      "enum": [
        "current",
        "evidence"
      ]
    },
    "follow_up": {
      "type": "object",
      "properties": {
        "facet": {
          "type": "string",
          "maxLength": 512
        },
        "seen": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10
        }
      },
      "required": [
        "facet"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "text"
  ]
}
```

### `list_files`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "pattern": {
      "type": "string"
    },
    "dir": {
      "type": "string"
    },
    "memory_view": {
      "type": "string",
      "enum": [
        "current",
        "evidence"
      ]
    }
  },
  "required": []
}
```

### `search`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "pattern": {
      "type": "string"
    },
    "glob": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "content",
        "files",
        "count"
      ]
    },
    "context": {
      "type": "integer"
    },
    "max_results": {
      "type": "integer"
    },
    "case_sensitive": {
      "type": "boolean"
    },
    "memory_view": {
      "type": "string",
      "enum": [
        "current",
        "evidence"
      ]
    }
  },
  "required": [
    "pattern"
  ]
}
```

### `list_skills`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "capability": {
      "type": "string",
      "enum": [
        "any",
        "repo-agent"
      ]
    }
  },
  "required": []
}
```

### `get_skill`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "capability": {
      "type": "string",
      "enum": [
        "any",
        "repo-agent"
      ]
    }
  },
  "required": [
    "name"
  ]
}
```

### `list_actions`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `invoke_app_action`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "app_id": {
      "type": "string"
    },
    "action_id": {
      "type": "string"
    },
    "args": {
      "type": "object"
    }
  },
  "required": [
    "app_id",
    "action_id",
    "args"
  ]
}
```

### `check_write`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "changes": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "content": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "content"
            ],
            "not": {
              "required": [
                "op"
              ]
            }
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "create",
                  "replace",
                  "upsert"
                ]
              },
              "content": {
                "type": "string"
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "edit"
                ]
              },
              "content": {
                "type": "string"
              },
              "anchor": {
                "type": "string"
              },
              "mode": {
                "type": "string",
                "enum": [
                  "replace_section",
                  "append_to_section",
                  "insert_after_heading",
                  "delete_section"
                ]
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content",
              "anchor",
              "mode"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "append"
                ]
              },
              "content": {
                "type": "string"
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "delete"
                ]
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op"
            ]
          }
        ]
      }
    }
  },
  "required": [
    "changes"
  ]
}
```

### `subscribe`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "since": {
      "type": "string"
    }
  },
  "required": [
    "since"
  ]
}
```

### `poll_answer`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "qb_id": {
      "type": "string"
    }
  },
  "required": [
    "qb_id"
  ]
}
```

### `list_questions`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `list_review_queue`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "cursor": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "answered"
      ]
    }
  },
  "required": []
}
```

### `get_proposal`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "proposal_id": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "offset": {
      "type": "integer"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "proposal_id"
  ]
}
```

### `onboarding_state`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `onboarding_status`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "preview_id": {
      "type": "string"
    }
  },
  "required": [
    "preview_id"
  ]
}
```

### `list_loops`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `get_loop`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "loop_id": {
      "type": "string"
    }
  },
  "required": [
    "loop_id"
  ]
}
```

### `get_case`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "loop_id": {
      "type": "string"
    },
    "case_id": {
      "type": "string"
    }
  },
  "required": [
    "loop_id",
    "case_id"
  ]
}
```

### `get_loop_metrics`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "loop_id": {
      "type": "string"
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d"
      ]
    }
  },
  "required": [
    "window"
  ]
}
```

### `list_records`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "decision",
        "policy"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "superseded",
        "retired"
      ]
    },
    "overdue": {
      "type": "boolean"
    }
  },
  "required": []
}
```

### `get_record`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}
```

### `get_governance_inbox`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d"
      ]
    }
  },
  "required": []
}
```

### `automation_compose`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "trigger": {
      "type": "object"
    },
    "supersedes": {
      "type": "string"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "app_id": {
            "type": "string"
          },
          "action_id": {
            "type": "string"
          },
          "args": {
            "type": "object"
          }
        },
        "required": [
          "app_id",
          "action_id",
          "args"
        ]
      }
    }
  },
  "required": [
    "name",
    "description",
    "trigger",
    "steps"
  ]
}
```

### `loop_compose`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "spec": {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string"
        },
        "purpose": {
          "type": "string"
        },
        "version": {
          "type": "integer"
        },
        "supersedes": {
          "type": [
            "string",
            "null"
          ]
        },
        "rollout": {
          "type": "string",
          "enum": [
            "shadow"
          ]
        },
        "trigger": {
          "type": "object"
        },
        "inputs": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "nodes": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "quality": {
          "type": "object"
        },
        "escalation": {
          "type": "object"
        },
        "autonomy": {
          "type": "object"
        },
        "budget": {
          "type": "object"
        }
      },
      "required": [
        "purpose",
        "version",
        "trigger",
        "inputs",
        "nodes",
        "quality",
        "escalation",
        "autonomy",
        "budget"
      ]
    }
  },
  "required": [
    "name",
    "description",
    "spec"
  ]
}
```

### `propose_write`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "changes": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "content": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "content"
            ],
            "not": {
              "required": [
                "op"
              ]
            }
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "create",
                  "replace",
                  "upsert"
                ]
              },
              "content": {
                "type": "string"
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "edit"
                ]
              },
              "content": {
                "type": "string"
              },
              "anchor": {
                "type": "string"
              },
              "mode": {
                "type": "string",
                "enum": [
                  "replace_section",
                  "append_to_section",
                  "insert_after_heading",
                  "delete_section"
                ]
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content",
              "anchor",
              "mode"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "append"
                ]
              },
              "content": {
                "type": "string"
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op",
              "content"
            ]
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "delete"
                ]
              },
              "base_sha": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "op"
            ]
          }
        ]
      }
    },
    "rationale": {
      "type": "string"
    },
    "claim_context": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string"
          },
          "generation": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "session_id",
          "generation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "changes"
  ]
}
```

### `ask`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "zone": {
      "type": "string"
    },
    "qb_id": {
      "type": "string"
    },
    "question": {
      "type": "string"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "zone",
    "qb_id",
    "question",
    "options"
  ]
}
```

### `resolve_question`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "qb_id": {
      "type": "string"
    }
  },
  "required": [
    "qb_id"
  ]
}
```

### `post_event`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "event_type": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "object_ref": {
      "type": "string"
    }
  },
  "required": [
    "event_type",
    "title",
    "summary"
  ]
}
```

### `onboarding_record`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    },
    "outcome": {
      "type": "string",
      "enum": [
        "PASS",
        "FAIL"
      ]
    },
    "detail": {
      "type": "string"
    },
    "expected_revision": {
      "type": "integer"
    }
  },
  "required": [
    "task_id",
    "outcome",
    "expected_revision"
  ]
}
```

### `onboarding_preview`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "plan": {
      "type": "object"
    },
    "expected_revision": {
      "type": "integer"
    }
  },
  "required": [
    "plan",
    "expected_revision"
  ]
}
```

### `onboarding_apply`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "preview_id": {
      "type": "string"
    },
    "confirmation": {
      "type": "string"
    }
  },
  "required": [
    "preview_id",
    "confirmation"
  ]
}
```

### `act`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "action": {
      "type": "string"
    },
    "item_id": {
      "type": "string"
    },
    "answer": {
      "type": "string"
    },
    "connection_name": {
      "type": "string"
    },
    "capability": {
      "type": "string"
    },
    "conn_type": {
      "type": "string"
    },
    "config": {
      "type": "object"
    },
    "secret": {
      "type": "string"
    },
    "app_id": {
      "type": "string"
    },
    "action_id": {
      "type": "string"
    },
    "waive_replay": {
      "type": "string"
    },
    "case_id": {
      "type": "string"
    },
    "trigger": {
      "type": "object",
      "oneOf": [
        {
          "properties": {
            "every": {
              "type": "string"
            }
          },
          "required": [
            "every"
          ],
          "additionalProperties": false
        },
        {
          "properties": {
            "daily_at": {
              "type": "string"
            }
          },
          "required": [
            "daily_at"
          ],
          "additionalProperties": false
        },
        {
          "properties": {
            "feed_event": {
              "type": "string"
            }
          },
          "required": [
            "feed_event"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "action",
    "item_id"
  ]
}
```

### `backup_status`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `backup_connect_start`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "repository": {
      "type": "string"
    }
  },
  "required": [
    "repository"
  ]
}
```

### `backup_connect_poll`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `backup_decline`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `recovery_kit_download`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `mint_owner_token`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "label": {
      "type": "string"
    }
  },
  "required": []
}
```

### `list_owner_tokens`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `mint_teammate_token`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "principal_subject": {
      "type": "string"
    },
    "label": {
      "type": "string"
    }
  },
  "required": [
    "principal_subject"
  ]
}
```

### `revoke_owner_token`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "fingerprint": {
      "type": "string"
    }
  },
  "required": []
}
```

### `acquire_user_token_v1`

```json
{
  "type": "object",
  "properties": {
    "assertion": {
      "type": "object"
    },
    "exchange_credential": {
      "type": "string"
    }
  },
  "required": [
    "assertion",
    "exchange_credential"
  ]
}
```

### `request_session_assertion_v1`

```json
{
  "type": "object",
  "properties": {
    "workos_access_token": {
      "type": "string"
    }
  },
  "required": [
    "workos_access_token"
  ]
}
```

### `get_feed_v1`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "cursor": {
      "type": "string"
    }
  },
  "required": []
}
```

### `list_zone_catalog`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `list_access_profiles`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `save_access_profile`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "zone_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name",
    "zone_ids"
  ]
}
```

### `delete_access_profile`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "profile_id": {
      "type": "string"
    }
  },
  "required": [
    "profile_id"
  ]
}
```

### `assign_access_profile`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "profile_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "subject"
  ]
}
```

### `set_access_management`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "admins_can_manage": {
      "type": "boolean"
    }
  },
  "required": [
    "admins_can_manage"
  ]
}
```

### `set_automation_delegation`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "admins_can_manage_automations": {
      "type": "boolean"
    }
  },
  "required": [
    "admins_can_manage_automations"
  ]
}
```

### `broker_call`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "request": {
      "type": "object"
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false
}
```

### `connection_call`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "request": {
      "type": "object"
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false
}
```

### `list_connections`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

### `test_connection`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
```

### `remove_connection`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "cascade": {
      "type": "boolean"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
```

### `oauth2_connect_start`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "provider": {
      "type": "string"
    }
  },
  "required": [
    "provider"
  ]
}
```

### `oauth2_connect_poll`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```

### `oauth2_connect_complete`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "state": {
      "type": "string"
    }
  },
  "required": [
    "code",
    "state"
  ]
}
```

### `task_get`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

### `task_list`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "backlog",
          "active",
          "in-progress",
          "blocked",
          "review",
          "done",
          "cancelled"
        ]
      }
    },
    "assignee": {
      "type": "string"
    },
    "owner": {
      "type": "string"
    },
    "project": {
      "type": "string"
    },
    "initiative": {
      "type": "string"
    },
    "planned_for": {
      "type": "string"
    },
    "env": {
      "type": "string"
    },
    "blocked": {
      "type": "boolean"
    },
    "text": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [],
  "additionalProperties": false
}
```

### `task_create`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "prefix": {
      "type": "string"
    },
    "project": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "active",
        "in-progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "critical",
        "high",
        "normal",
        "low"
      ]
    },
    "workstream": {
      "type": [
        "string",
        "null"
      ]
    },
    "initiative": {
      "type": [
        "string",
        "null"
      ]
    },
    "goal": {
      "type": [
        "string",
        "null"
      ]
    },
    "planned_for": {
      "type": [
        "string",
        "null"
      ]
    },
    "priority_rank": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0
    },
    "lane": {
      "type": [
        "string",
        "null"
      ]
    },
    "owner": {
      "type": [
        "string",
        "null"
      ]
    },
    "assignee": {
      "type": [
        "string",
        "null"
      ]
    },
    "reporter": {
      "type": [
        "string",
        "null"
      ]
    },
    "depends_on": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "finish_gates": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "blocks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "due": {
      "type": [
        "string",
        "null"
      ]
    },
    "env": {
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "type": [
        "string",
        "null"
      ]
    },
    "modified": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "prefix",
    "project",
    "title"
  ],
  "additionalProperties": false
}
```

### `task_update`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "project": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "active",
        "in-progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "critical",
        "high",
        "normal",
        "low"
      ]
    },
    "workstream": {
      "type": [
        "string",
        "null"
      ]
    },
    "initiative": {
      "type": [
        "string",
        "null"
      ]
    },
    "goal": {
      "type": [
        "string",
        "null"
      ]
    },
    "planned_for": {
      "type": [
        "string",
        "null"
      ]
    },
    "priority_rank": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0
    },
    "lane": {
      "type": [
        "string",
        "null"
      ]
    },
    "owner": {
      "type": [
        "string",
        "null"
      ]
    },
    "assignee": {
      "type": [
        "string",
        "null"
      ]
    },
    "reporter": {
      "type": [
        "string",
        "null"
      ]
    },
    "depends_on": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "finish_gates": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "blocks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "due": {
      "type": [
        "string",
        "null"
      ]
    },
    "env": {
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "type": [
        "string",
        "null"
      ]
    },
    "modified": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": [
        "string",
        "null"
      ]
    },
    "body": {
      "type": "string"
    },
    "expected_content": {
      "type": "string"
    },
    "claim_context": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string"
          },
          "generation": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "session_id",
          "generation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

### `task_transition`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "active",
        "in-progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "claim_context": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string"
          },
          "generation": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "session_id",
          "generation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "id",
    "status"
  ],
  "additionalProperties": false
}
```

### `task_claim`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "session": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "session"
  ],
  "additionalProperties": false
}
```

### `task_link`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "target_id": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "depends_on",
        "finish_gates",
        "blocks"
      ]
    },
    "claim_context": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string"
          },
          "generation": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "session_id",
          "generation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "id",
    "target_id",
    "kind"
  ],
  "additionalProperties": false
}
```

### `task_sweep`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "claim_context": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "session_id": {
            "type": "string"
          },
          "generation": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "session_id",
          "generation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [],
  "additionalProperties": false
}
```

### `task_import`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "project": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "active",
        "in-progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "critical",
        "high",
        "normal",
        "low"
      ]
    },
    "workstream": {
      "type": [
        "string",
        "null"
      ]
    },
    "initiative": {
      "type": [
        "string",
        "null"
      ]
    },
    "goal": {
      "type": [
        "string",
        "null"
      ]
    },
    "planned_for": {
      "type": [
        "string",
        "null"
      ]
    },
    "priority_rank": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0
    },
    "lane": {
      "type": [
        "string",
        "null"
      ]
    },
    "owner": {
      "type": [
        "string",
        "null"
      ]
    },
    "assignee": {
      "type": [
        "string",
        "null"
      ]
    },
    "reporter": {
      "type": [
        "string",
        "null"
      ]
    },
    "depends_on": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "finish_gates": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "blocks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "due": {
      "type": [
        "string",
        "null"
      ]
    },
    "env": {
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "type": [
        "string",
        "null"
      ]
    },
    "modified": {
      "type": [
        "string",
        "null"
      ]
    },
    "closed": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "id",
    "project",
    "title"
  ],
  "additionalProperties": false
}
```

### `task_session_open`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "runtime_id": {
      "type": "string"
    },
    "client_label": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    }
  },
  "required": [
    "runtime_id",
    "client_label",
    "request_id"
  ],
  "additionalProperties": false
}
```

### `task_session_heartbeat`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "additionalProperties": false
}
```

### `task_session_close`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "additionalProperties": false
}
```

### `task_release`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "session": {
      "type": "string"
    },
    "generation": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "id",
    "session",
    "generation"
  ],
  "additionalProperties": false
}
```

### `task_handoff`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "session": {
      "type": "string"
    },
    "generation": {
      "type": "integer",
      "minimum": 1
    },
    "target_session": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "cooperative",
        "force"
      ]
    },
    "reason": {
      "type": "string",
      "maxLength": 1024
    }
  },
  "required": [
    "id",
    "session",
    "generation",
    "target_session"
  ],
  "additionalProperties": false
}
```

### `renew_app_session`

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": []
}
```
