> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Capability map

> A code-anchored index of every platform capability — HTTP API operations, listed plugins, settings groups, and agents & extensions — each linked to its docs page and its source in the public monorepo.

Every capability the platform exposes, one row apiece, linked to its documentation and its source. Feature areas are fixed; rows are derived from machine-readable sources (the generated OpenAPI, the plugin registry, the settings registry, and the agent/extension registrations), never authored by hand.

## HTTP API

### Access Control

| Operation                                                     | What it does                                        | Docs                  | Source                                                                                               |
| ------------------------------------------------------------- | --------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/auth/api-keys/&#123;user_id&#125;`               | Revoke an api key                                   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/auth/public-routes`                              | Unpin a public route                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/auth/roles/&#123;name&#125;`                     | Delete a role                                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/auth/scopes/urls`                                | Remove a URL from all scopes                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/auth/scopes/&#123;scope_id&#125;`                | Delete a scope                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/api-keys/&#123;user_id&#125;/policy/versions`  | List a user's policy version history                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/capabilities`                                  | Report key-mint capabilities                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/me`                                            | The caller's capability projection                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/public-routes`                                 | List public-pinned routes                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/roles`                                         | List roles                                          | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/roles/&#123;name&#125;/versions`               | A role's version history + audit trail              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/routes`                                        | List the app's HTTP routes and their scope mappings | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/scopes`                                        | List all scopes                                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/auth/tokens-payload`                                | List api-key token payloads                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/api-keys`                                     | Create an api key                                   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/api-keys/&#123;user_id&#125;/policy/rollback` | Roll a policy back to a version                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/api-keys/&#123;user_id&#125;/scopes`          | Add/remove scopes on an api key                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/claim-links`                                  | Create a one-time claim link for an API key         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/logout`                                       | Log out the current session                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/public-routes`                                | Pin a route public                                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/roles`                                        | Create a role                                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/roles/&#123;name&#125;/grants`                | Set/remove single tag grants on a role              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/roles/&#123;name&#125;/rollback`              | Roll a role back to a version                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/scopes`                                       | Add a URL to a scope                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/auth/validate-condition`                           | Validate a jq policy condition                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/keys/bootstrap`                                    | Mint the first admin api key                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/auth/api-keys/&#123;user_id&#125;`                  | Edit an api key                                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/auth/roles/&#123;name&#125;`                        | Edit a role's grant map                             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Agents

| Operation                                         | What it does                               | Docs                  | Source                                                                                               |
| ------------------------------------------------- | ------------------------------------------ | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/agents`                                 | List every registered agent                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/agents/spec-runnable`                   | List the spec-runnable (authorable) agents | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/agents/authored/&#123;name&#125;/runs` | Stream a run of an authored agent          | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/agents/&#123;name&#125;/runs`          | Stream a run of an agent                   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Backend

| Operation                       | What it does                  | Docs                  | Source                                                                                               |
| ------------------------------- | ----------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/backend`              | Get the backend identity      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/fleet/workers`        | List the worker fleet         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/fleet/reload-config` | Soft-restart the worker fleet | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Backup

| Operation                  | What it does                     | Docs                  | Source                                                                                               |
| -------------------------- | -------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/backup/sections` | List backup sections             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/backup/export`  | Export the named backup sections | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/backup/import`  | Import a backup document         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Channels

| Operation           | What it does             | Docs                  | Source                                                                                               |
| ------------------- | ------------------------ | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/channels` | List registered channels | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Checkpoints

| Operation                     | What it does                           | Docs                  | Source                                                                                               |
| ----------------------------- | -------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `POST /api/checkpoints/sweep` | Sweep expired conversation checkpoints | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Config

| Operation                                                                | What it does                                                           | Docs                  | Source                                                                                               |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/config/profiles/&#123;name&#125;`                           | Delete a settings profile                                              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/env`                                                    | Read the stored env config and secret-key marks                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/mode`                                                   | Read the active config backend mode                                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/profiles`                                               | List settings profiles                                                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/profiles/&#123;name&#125;`                              | Get a settings profile                                                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/profiles/&#123;name&#125;/versions`                     | List a settings profile's versions                                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/profiles/&#123;name&#125;/versions/&#123;version&#125;` | Get a settings profile version                                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/config/settings-schema`                                        | List settings groups with their resolved field values                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/config/env`                                                   | Merge env overrides and hot-reload the process config                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/config/profiles/&#123;name&#125;/apply`                       | Apply a settings profile — replace the stored env and reload the fleet | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/config/profiles/&#123;name&#125;/diff`                        | Diff a settings profile against the stored env                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/config/profiles/&#123;name&#125;/rollback`                    | Roll a settings profile back to a version                              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/config/reload`                                                | Soft-restart the process from its manifest                             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/config/profiles/&#123;name&#125;`                              | Create or update a settings profile                                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Connectors

| Operation                                                                  | What it does                                      | Docs                  | Source                                                                                               |
| -------------------------------------------------------------------------- | ------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/connectors/connections/&#123;connection_id&#125;`             | Disconnect a connection                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/connectors/connections`                                          | List connections                                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/connectors/connections/&#123;connection_id&#125;`                | Get a connection                                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/connectors/providers`                                            | List connector providers                          | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PATCH /api/connectors/connections/&#123;connection_id&#125;/sub-services` | Patch a connection's enabled sub-services         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/connectors/connections/start`                                   | Start a connection flow                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/connectors/connections/&#123;connection_id&#125;/reconnect`     | Start a reconnect flow                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/connectors/oauth/complete`                                      | Complete an OAuth connection flow                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/connectors/tokens/reencrypt`                                    | Re-encrypt connector tokens under the current KEK | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Conversations

| Operation                                                                          | What it does                                                  | Docs                  | Source                                                                                               |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/conversation-configs/&#123;target_kind&#125;/&#123;target_name&#125;` | Delete a conversation target config                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/conversations/persons/&#123;person_id&#125;`                          | Delete a conversation person                                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/conversations/&#123;route_name&#125;`                                 | Delete a conversation route                                   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/conversations/&#123;route_name&#125;/thread`                          | Delete a conversation thread                                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversation-configs`                                                    | List conversation target configs                              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversation-configs/&#123;target_kind&#125;/&#123;target_name&#125;`    | Get a conversation target config                              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations`                                                           | List conversation routes                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/messages/failed`                                           | List failed conversation deliveries                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/persons/&#123;person_id&#125;`                             | Read a conversation person                                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;`                                    | Get a conversation route                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;/messages/search`                    | Search a conversation route's messages                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;/messages/&#123;message_id&#125;`    | Read one conversation answer record                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;/thread/mode`                        | Read a conversation thread's control mode                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;/threads`                            | List a conversation route's threads                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/conversations/&#123;route_name&#125;/transcript`                         | Read a conversation thread's transcript                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/conversations/&#123;route_name&#125;`                                   | Create or replace a conversation route                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/conversations/&#123;route_name&#125;/events`                            | Deliver a structured event to a conversation thread as a turn | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/conversations/&#123;route_name&#125;/messages`                          | Send a message to a conversation route                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/conversations/&#123;route_name&#125;/thread/messages`                   | Send an operator message into a conversation thread           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/conversation-configs/&#123;target_kind&#125;/&#123;target_name&#125;`    | Create or replace a conversation target config                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/conversations/persons/&#123;person_id&#125;/locale`                      | Set a conversation person's locale                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/conversations/&#123;route_name&#125;/thread/mode`                        | Set a conversation thread's control mode                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Extensions

| Operation                                            | What it does                                    | Docs                  | Source                                                                                               |
| ---------------------------------------------------- | ----------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/extensions`                                | List every registered extension                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tools/&#123;name&#125;/extensions`         | Get a tool's applied extension combos           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tools/&#123;name&#125;/extensions`        | Set a tool's applied extension combos           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tools/&#123;name&#125;/extensions/combos` | Add or remove single extension combos on a tool | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Hooks

| Operation                                             | What it does                       | Docs                  | Source                                                                                               |
| ----------------------------------------------------- | ---------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/hooks/topics/&#123;topic&#125;/verifier` | Unbind a topic's webhook verifier  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/hooks/trigger-links/&#123;name&#125;`    | Delete a trigger link              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/hooks/&#123;name&#125;`                  | Unregister a hook                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/hooks`                                      | List registered hooks              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/hooks/trigger-links`                        | List trigger links                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/hooks/verifiers`                            | List registered webhook verifiers  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/hooks`                                     | Register a hook                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/hooks/trigger-links`                       | Create a trigger link              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/hooks/topics/&#123;topic&#125;/verifier`    | Bind a webhook verifier to a topic | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Interactions

| Operation                                                  | What it does                                        | Docs                  | Source                                                                                               |
| ---------------------------------------------------------- | --------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/interactions`                                    | List pending interactions                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/interactions/callback/&#123;ticket&#125;`        | External interaction callback door                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/interactions/media/&#123;media_id&#125;`         | Serve interaction media stored by reference         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/interactions/pending`                            | List parked (async) interactions awaiting an answer | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/interactions/stream`                             | Stream the interactions inbox live tail             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/interactions/callback/&#123;ticket&#125;`       | External interaction callback door                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/interactions/&#123;interaction_id&#125;/answer` | Answer a pending interaction                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/interactions/&#123;interaction_id&#125;/cancel` | Cancel a pending interaction                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Login

| Operation                | What it does                                    | Docs                  | Source                                                                                               |
| ------------------------ | ----------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/login/methods` | List available login methods                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/login/claim`  | Exchange a one-time claim token for its API key | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Manifest

| Operation                                             | What it does                                                                | Docs                  | Source                                                                                               |
| ----------------------------------------------------- | --------------------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/agents-config/entries/&#123;title&#125;` | Remove one agents config entry by title and hot-reload                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/mcp-config/entries/&#123;title&#125;`    | Remove one MCP config entry by title and hot-reload                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/tools-config/entries/&#123;title&#125;`  | Remove one tools config entry by title and hot-reload                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/manifest`                                   | Read the PRESERVED manifest MCP section and user tools                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/manifest/mcp-env-refs`                      | List the manifest MCP section's !ENV marker refs (names + set/unset only)   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/manifest/preserved`                         | Read the PRESERVED manifest (markers intact) MCP section and user tools     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/mcp-config/schema`                          | Get the JSON schema for one MCP-config entry                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/mcp-status`                                 | Snapshot the live MCP binding status                                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/mcp-status/failed`                          | List MCP servers skipped by the viability check                             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/agents-config/entries`                     | Add or replace agents config entries and hot-reload                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/api-tools`                                 | Add/remove names on the api\_tools include/exclude lists and hot-reload     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/manifest/replace`                          | Replace the whole manifest, persist, and reload the fleet                   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-config`                                | Replace the MCP config section and hot-reload                               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-config/entries`                        | Add or replace MCP config entries and hot-reload                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-config/secret-env`                     | Write a secret env value and its manifest !ENV marker together, then reload | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-status/reload-failed`                  | Re-probe every failed MCP server                                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-status/&#123;title&#125;/deregister`   | Detach a single MCP server's tools by title                                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/mcp-status/&#123;title&#125;/reload`       | Reload a single MCP server by title                                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tools-config/entries`                      | Add or replace tools config entries and hot-reload                          | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Marketplace

| Operation                                                      | What it does                              | Docs                  | Source                                                                                               |
| -------------------------------------------------------------- | ----------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/marketplace/advisories`                              | Get advisories for installed plugins      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/marketplace/categories`                              | List marketplace categories               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/marketplace/installed`                               | List installed marketplace plugins        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/marketplace/kinds`                                   | List marketplace item kinds               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/marketplace/plugins/&#123;ns&#125;/&#123;name&#125;` | Get a marketplace listing's detail        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/marketplace/search`                                  | Search the marketplace                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/marketplace/install`                                | Install a marketplace plugin              | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/marketplace/install/preview`                        | Preview a marketplace install             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/marketplace/uninstall`                              | Uninstall a marketplace plugin            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/marketplace/update`                                 | Update a marketplace plugin               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/marketplace/upgrade-all`                            | Upgrade all installed marketplace plugins | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Notifications

| Operation                 | What it does                        | Docs                  | Source                                                                                               |
| ------------------------- | ----------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/notifications`  | List internal notifications         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/notifications` | Send a human a one-way notification | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Observability

| Operation                                                       | What it does                            | Docs                  | Source                                                                                               |
| --------------------------------------------------------------- | --------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/observability/metrics`                                | Query observability metrics             | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/observability/runs`                                   | List observability runs                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/observability/runs/export`                            | Export runs as a CSV download           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/observability/runs/&#123;trace_id&#125;/trace`        | Get a run's trace                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/observability/runs/&#123;trace_id&#125;/trace/export` | Export a run's trace as a JSON download | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Plugins

| Operation                                                   | What it does                       | Docs                  | Source                                                                                               |
| ----------------------------------------------------------- | ---------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/plugins`                                          | List the registered studio plugins | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/plugins/&#123;name&#125;/studio/&#123;path&#125;` | Serve a studio plugin asset        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Presets

| Operation                                                             | What it does                        | Docs                  | Source                                                                                               |
| --------------------------------------------------------------------- | ----------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/presets/&#123;name&#125;`                                | Delete a preset                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/presets`                                                    | List presets                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/presets/&#123;name&#125;`                                   | Get a preset                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/presets/&#123;name&#125;/referees`                          | List live references to this preset | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/presets/&#123;name&#125;/versions`                          | List a preset's versions            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/presets/&#123;name&#125;/versions/&#123;version&#125;`      | Get a specific preset version       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/presets`                                                   | Create a preset                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/presets/validate`                                          | Validate a preset draft (dry-run)   | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/presets/&#123;name&#125;/rename`                           | Rename a preset                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/presets/&#123;name&#125;/rollback`                         | Roll a preset back to a version     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/presets/&#123;name&#125;/versions`                         | Save a new preset version           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/presets/&#123;name&#125;/versions/&#123;version&#125;/tags` | Set a preset version's tags         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Resources

| Operation                 | What it does                                          | Docs                  | Source                                                                                               |
| ------------------------- | ----------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/resources/get`  | Load a stored resource by id, optionally rendering it | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/resources/get` | Load a stored resource by id, optionally rendering it | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Runs

| Operation              | What it does                  | Docs                  | Source                                                                                               |
| ---------------------- | ----------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/runs`        | List platform runs            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/runs/prune` | Prune the platform runs index | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Sandbox

| Operation          | What it does                                 | Docs                  | Source                                                                                               |
| ------------------ | -------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/sandbox` | Get the sandbox identity and resolved policy | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Schedules

| Operation                                         | What it does                 | Docs                  | Source                                                                                               |
| ------------------------------------------------- | ---------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/schedules/&#123;schedule_name&#125;` | Delete a schedule            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/schedules`                              | List schedules               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/schedules/server-datetime`              | Get the server date and time | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/schedules`                             | Create a schedule            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### States

| Operation                                                                                                                                                    | What it does                                                       | Docs                  | Source                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/state-templates/&#123;name&#125;`                                                                                                               | Delete a state template                                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/states/&#123;name&#125;`                                                                                                                        | Delete a state                                                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/states/&#123;name&#125;/attachments/&#123;template&#125;`                                                                                       | Detach a template from a state                                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;`                               | Erase a subject's record                                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/state-templates`                                                                                                                                   | List state templates                                               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/state-templates/&#123;name&#125;`                                                                                                                  | Get a state template                                               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states`                                                                                                                                            | List declared states                                               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;`                                                                                                                           | Get a state                                                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/attachments`                                                                                                               | List a state's attachments                                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/attachments/&#123;template&#125;`                                                                                          | Get a state's attachment                                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/consumers`                                                                                                                 | A state's consumers                                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;`                                  | Read a subject's record                                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;/template-jq/&#123;program&#125;`  | Evaluate an input-purpose template\_jq program for a subject       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;/writes`                           | A subject's write audit trail                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/stats`                                                                                                                     | A state's record statistics                                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/states/&#123;name&#125;/subjects`                                                                                                                  | List a state's subjects                                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PATCH /api/states/&#123;name&#125;/attachments/&#123;template&#125;`                                                                                        | Update an attachment's declarations                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PATCH /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;`                                | Merge into a subject's record                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/state-retention/prune`                                                                                                                            | Prune expired state records                                        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/states/&#123;name&#125;/records/search`                                                                                                           | Search a state's records                                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;/deltas`                          | Apply ops to a subject's record                                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;/fold`                            | Fold one subject into another                                      | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;/template-jq/&#123;program&#125;` | Apply an update-purpose template\_jq program to a subject's record | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/state-templates/&#123;name&#125;`                                                                                                                  | Create or replace a state template                                 | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/states/&#123;name&#125;`                                                                                                                           | Create or re-declare a state                                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/states/&#123;name&#125;/attachments/&#123;template&#125;`                                                                                          | Attach a template on a state                                       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PUT /api/states/&#123;name&#125;/records/&#123;target_kind&#125;/&#123;target_name&#125;/&#123;kind&#125;/&#123;key&#125;`                                  | Replace a subject's record                                         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Storage

| Operation                                                    | What it does                      | Docs                  | Source                                                                                               |
| ------------------------------------------------------------ | --------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/storage/dirs/&#123;dir_path&#125;`              | Delete a storage directory        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/storage/resources/&#123;resource_id&#125;`      | Delete a storage resource         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/storage`                                           | Get the storage provider identity | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/storage/resources`                                 | List storage resources            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/storage/resources/&#123;resource_id&#125;/content` | Download a storage resource       | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/storage/resources/&#123;resource_id&#125;/stat`    | Stat a storage resource           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/storage/resources`                                | Upload a storage resource         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Sub Mcp

| Operation                              | What it does                     | Docs                  | Source                                                                                               |
| -------------------------------------- | -------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/sub-mcp/&#123;slug&#125;` | Unregister a sub-MCP app         | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/sub-mcp`                     | List the registered sub-MCP apps | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/sub-mcp`                    | Register or reload a sub-MCP app | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### System

| Operation               | What it does               | Docs                  | Source                                                                                               |
| ----------------------- | -------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/system/kinds` | List pluggable-kind status | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Templates

| Operation                         | What it does                    | Docs                  | Source                                                                                               |
| --------------------------------- | ------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/templates`              | List templates                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/clear-templates-cache` | Clear the template render cache | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/delete-template`       | Delete a template               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/delete-template-dir`   | Delete a template directory     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/render-template`       | Render a template               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/template`              | Fetch a template and its schema | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/upload-template`       | Upload a template               | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Tool Runs

| Operation                               | What it does                                  | Docs                  | Source                                                                                               |
| --------------------------------------- | --------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/tool-runs`                    | List background tool runs for a tool          | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tool-runs/&#123;run_id&#125;` | Get a background tool run's status and result | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tool-runs`                   | Submit a tool for background execution        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Tool Meta

| Operation                                                  | What it does                   | Docs                  | Source                                                                                               |
| ---------------------------------------------------------- | ------------------------------ | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `DELETE /api/tool-meta/folders/&#123;folder_id&#125;`      | Delete a folder                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `DELETE /api/tool-meta/tools/&#123;tool_name&#125;`        | Delete a tool's overlay row    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tool-meta`                                       | List the tool-metadata overlay | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `PATCH /api/tool-meta/tools/&#123;tool_name&#125;`         | Upsert a tool's overlay        | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tool-meta/folders`                              | Create a folder                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tool-meta/folders/&#123;folder_id&#125;/move`   | Move a folder                  | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tool-meta/folders/&#123;folder_id&#125;/rename` | Rename a folder                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

### Tools

| Operation                                     | What it does                                                  | Docs                  | Source                                                                                               |
| --------------------------------------------- | ------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| `GET /api/tools`                              | List the registered tool names                                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tools-schema`                       | Get the input/output schema of every tool                     | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tools/tags`                         | List each tool's native tags, declared visibility, and badges | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `GET /api/tools/&#123;tool_name&#125;/schema` | Get one tool's input/output schema                            | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/run-tool`                          | Run a registered tool synchronously                           | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tools/reload`                      | Reload one app tool from its stored definition                | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |
| `POST /api/tools/remove`                      | Remove one app tool from the live registry                    | [API](/reference/api) | [operations](https://github.com/tai42ai/tai42/tree/main/core/skeleton/src/tai42_skeleton/operations) |

## Plugins

| Item                             | What it provides                                                                                                                            | Docs                                                              | Source                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------------------------------- |
| `accounts-oidc`                  | OIDC/OAuth2 login accounts provider — session-based login via an external identity provider with SSO code hand-back.                        | [accounts-oidc](/plugins/tai42/accounts-oidc)                     | `tai42_accounts_oidc.provider`                            |
| `login`                          | The public /api/login/\* login-flow routes.                                                                                                 | [accounts-oidc](/plugins/tai42/accounts-oidc)                     | `tai42_accounts_oidc.routes`                              |
| `accounts-postgres`              | Postgres-backed accounts/identity provider — owns user accounts, password login, sessions, and invites.                                     | [accounts-postgres](/plugins/tai42/accounts-postgres)             | `tai42_accounts_postgres.provider`                        |
| `login`                          | The public /api/login/\* routes.                                                                                                            | [accounts-postgres](/plugins/tai42/accounts-postgres)             | `tai42_accounts_postgres.routes_login`                    |
| `users`                          | The authed /api/auth/users\* user-administration routes.                                                                                    | [accounts-postgres](/plugins/tai42/accounts-postgres)             | `tai42_accounts_postgres.routes_users`                    |
| `langchain_deep_agent`           | Run a deep agent with planning, subagents, skills, and a filesystem backend.                                                                | [agents](/plugins/tai42/agents)                                   | `tai42_agents.langchain_deep_agent`                       |
| `claude_code`                    | Run Claude Code inside a sandbox: it drives the real claude binary over a versioned exec protocol, with tools, skills, and subagents.       | [agents](/plugins/tai42/agents)                                   | `tai42_agents.claude_code`                                |
| `refine_agent`                   | Run an Evaluator-Critic refinement loop until the Critic approves or the budget runs out.                                                   | [agents](/plugins/tai42/agents)                                   | `tai42_agents.refine_agent`                               |
| `voting_agent`                   | Run a voting workflow — voter LLMs answer in parallel, then a judge LLM decides.                                                            | [agents](/plugins/tai42/agents)                                   | `tai42_agents.voting_agent`                               |
| `retrieval_tools_agent`          | A tools agent that retrieves its tools on demand from a vector store.                                                                       | [agents](/plugins/tai42/agents)                                   | `tai42_agents.retrieval_tools_agent`                      |
| `tools_agent`                    | Run a LangGraph tools agent over tools loaded by name (and optional presets).                                                               | [agents](/plugins/tai42/agents)                                   | `tai42_agents.tools_agent`                                |
| `vqa_agent`                      | Analyze an image and answer a query about it using a multimodal LLM.                                                                        | [agents](/plugins/tai42/agents)                                   | `tai42_agents.vqa_agent`                                  |
| `arq`                            | arq execution backend — background tool runs and schedules over Redis.                                                                      | [backend-arq](/plugins/tai42/backend-arq)                         | `tai42_backend_arq.backend`                               |
| `celery`                         | Celery execution backend — worker/beat/flower runtime, prefork-pool turnover on worker-bus ops, and RedBeat scheduling.                     | [backend-celery](/plugins/tai42/backend-celery)                   | `tai42_backend_celery.core.backend`                       |
| `rq`                             | RQ execution backend — background tool runs and schedules over Redis.                                                                       | [backend-rq](/plugins/tai42/backend-rq)                           | `tai42_backend_rq.backend`                                |
| `slack`                          | Deliver ask\_user questions to a Slack channel and bridge the threaded reply back.                                                          | [channel-slack](/plugins/tai42/channel-slack)                     | `tai42_channel_slack.register`                            |
| `telegram`                       | Deliver ask\_user questions to a Telegram chat and bridge the typed reply back.                                                             | [channel-telegram](/plugins/tai42/channel-telegram)               | `tai42_channel_telegram.register`                         |
| `twilio`                         | Deliver ask\_user questions to a phone over Twilio SMS/WhatsApp and bridge the reply back.                                                  | [channel-twilio](/plugins/tai42/channel-twilio)                   | `tai42_channel_twilio.register`                           |
| `web`                            | Deliver ask\_user questions to a visitor in the public chat page and bridge the reply back.                                                 | [channel-web](/plugins/tai42/channel-web)                         | `tai42_channel_web.register`                              |
| `whatsapp`                       | Deliver ask\_user questions to a human on WhatsApp via the Meta Cloud API and bridge the reply back.                                        | [channel-whatsapp](/plugins/tai42/channel-whatsapp)               | `tai42_channel_whatsapp.register`                         |
| `atlassian`                      | OAuth connector for Atlassian (Jira, Confluence, Compass).                                                                                  | [connector-atlassian](/plugins/tai42/connector-atlassian)         | —                                                         |
| `github`                         | OAuth connector for GitHub over GitHub's hosted MCP server.                                                                                 | [connector-github](/plugins/tai42/connector-github)               | —                                                         |
| `google`                         | OAuth connector for Google Workspace on Google's hosted MCP servers.                                                                        | [connector-google](/plugins/tai42/connector-google)               | —                                                         |
| `slack`                          | OAuth connector for Slack over Slack's hosted MCP server.                                                                                   | [connector-slack](/plugins/tai42/connector-slack)                 | —                                                         |
| `identity-oidc`                  | Validate-only OIDC identity provider — resolve an issuer-minted JWT to an authenticated identity.                                           | [identity-oidc](/plugins/tai42/identity-oidc)                     | `tai42_identity_oidc.provider`                            |
| `redis`                          | Redis-backed api-key identity provider — validate inbound tokens and provision keys.                                                        | [identity-redis](/plugins/tai42/identity-redis)                   | `tai42_identity_redis.redis_api_key_provider`             |
| `mcp-dynamic-postgres`           | Schema-driven generator for safe, scoped PostgreSQL DML tools in FastMCP agent systems                                                      | [mcp-dynamic-postgres](/plugins/tai42/mcp-dynamic-postgres)       | —                                                         |
| `langfuse`                       | Langfuse monitoring backend — trace/span emission and the observability read surface.                                                       | [monitoring-langfuse](/plugins/tai42/monitoring-langfuse)         | `tai42_monitoring_langfuse.register`                      |
| `docker`                         | Docker sandbox provider — per-session containers on a remote engine over the Docker Engine API.                                             | [sandbox-docker](/plugins/tai42/sandbox-docker)                   | `tai42_sandbox_docker.provider`                           |
| `local`                          | Direct/host sandbox — runs the session's code as a host subprocess, no isolation.                                                           | [sandbox-local](/plugins/tai42/sandbox-local)                     | `tai42_sandbox_local.provider`                            |
| `github`                         | Storage backend serving text and binary/media content over a GitHub repository.                                                             | [storage-github](/plugins/tai42/storage-github)                   | `tai42_storage_github`                                    |
| `local`                          | Storage backend serving text and binary content from a local directory tree.                                                                | [storage-local](/plugins/tai42/storage-local)                     | `tai42_storage_local`                                     |
| `s3`                             | Storage backend serving text, binary, and media content over an S3 bucket.                                                                  | [storage-s3](/plugins/tai42/storage-s3)                           | `tai42_storage_s3`                                        |
| `current_time_info`              | Return the current time as a structured object.                                                                                             | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.tools.current_time_info`                   |
| `generate_embeddings`            | Generate embeddings for a single string or a list of strings.                                                                               | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.tools.generate_embeddings`                 |
| `generate_uuid`                  | Generate a random UUID (version 4).                                                                                                         | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.tools.generate_uuid`                       |
| `pad_embeddings`                 | Pad each embedding vector with zeros up to a target dimension.                                                                              | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.tools.pad_embeddings`                      |
| `request`                        | Execute an HTTP request through a curl-backed session.                                                                                      | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.tools.request`                             |
| `batch`                          | Branch a tool into a variant that runs many instances at once.                                                                              | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.batch`                          |
| `cache`                          | Branch a tool into a variant that memoizes results by call arguments.                                                                       | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.cache`                          |
| `chain`                          | Branch a tool into a variant that transforms its output and calls a next tool.                                                              | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.chain`                          |
| `output_schema`                  | Branch a tool into a variant that forces a configured JSON Schema as its output schema and validates every result against it.               | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.output_schema`                  |
| `prometheus_metrics`             | Branch a tool into a variant that records a Prometheus call metric.                                                                         | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.prometheus`                     |
| `proxy`                          | Branch a tool into a variant that runs the wrapped tool through a proxy.                                                                    | [toolbox](/plugins/tai42/toolbox)                                 | `tai42_toolbox.extensions.proxy`                          |
| `create_github_webhook`          | Create a repository webhook and return its id, url, events, and active flag.                                                                | [tools-github](/plugins/tai42/tools-github)                       | `tai42_tools_github.tools.create_github_webhook`          |
| `list_github_webhooks`           | List a repository's webhooks, following Link-header pagination to exhaustion.                                                               | [tools-github](/plugins/tai42/tools-github)                       | `tai42_tools_github.tools.list_github_webhooks`           |
| `delete_github_webhook`          | Delete a repository webhook by id.                                                                                                          | [tools-github](/plugins/tai42/tools-github)                       | `tai42_tools_github.tools.delete_github_webhook`          |
| `confirm_stripe_payment`         | Answer a paid checkout ask from a Stripe webhook event.                                                                                     | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.confirm_stripe_payment`         |
| `create_stripe_checkout`         | Create a Stripe Checkout Session and return its hosted payment URL.                                                                         | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.create_stripe_checkout`         |
| `create_stripe_payment_link`     | Create a flexible-amount non-blocking Stripe payment link and return its URL and session id.                                                | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.create_stripe_payment_link`     |
| `create_stripe_webhook_endpoint` | Create a Stripe webhook endpoint and return its id and one-time signing secret.                                                             | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.create_stripe_webhook_endpoint` |
| `delete_stripe_webhook_endpoint` | Delete a Stripe webhook endpoint by id.                                                                                                     | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.delete_stripe_webhook_endpoint` |
| `expire_stripe_checkout`         | Expire an open Stripe Checkout Session early and return its id and status.                                                                  | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.expire_stripe_checkout`         |
| `list_stripe_webhook_endpoints`  | List the account's Stripe webhook endpoints (no signing secrets).                                                                           | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.list_stripe_webhook_endpoints`  |
| `reconcile_stripe_payments`      | Re-answer paid Stripe checkout sessions the webhook path may have lost.                                                                     | [tools-stripe](/plugins/tai42/tools-stripe)                       | `tai42_tools_stripe.tools.reconcile_stripe_payments`      |
| `list_twilio_numbers`            | List a Twilio account's incoming phone numbers with their inbound-message webhook.                                                          | [tools-twilio](/plugins/tai42/tools-twilio)                       | `tai42_tools_twilio.tools.list_twilio_numbers`            |
| `get_twilio_number_webhook`      | Read one Twilio number's inbound-message webhook URL and method.                                                                            | [tools-twilio](/plugins/tai42/tools-twilio)                       | `tai42_tools_twilio.tools.get_twilio_number_webhook`      |
| `set_twilio_number_webhook`      | Set a Twilio number's inbound-message webhook to a given https URL.                                                                         | [tools-twilio](/plugins/tai42/tools-twilio)                       | `tai42_tools_twilio.tools.set_twilio_number_webhook`      |
| `register_whatsapp_template`     | Register a WhatsApp message template on the business account and return Graph's id and status.                                              | [tools-whatsapp](/plugins/tai42/tools-whatsapp)                   | `tai42_tools_whatsapp.tools.register_whatsapp_template`   |
| `list_whatsapp_templates`        | List every WhatsApp message template on the business account, following Graph's paging to exhaustion.                                       | [tools-whatsapp](/plugins/tai42/tools-whatsapp)                   | `tai42_tools_whatsapp.tools.list_whatsapp_templates`      |
| `delete_whatsapp_template`       | Delete a WhatsApp message template by name and return Graph's response.                                                                     | [tools-whatsapp](/plugins/tai42/tools-whatsapp)                   | `tai42_tools_whatsapp.tools.delete_whatsapp_template`     |
| `subscribe_whatsapp_app`         | Subscribe the app to the business account's webhooks, optionally overriding the callback URI and verify token, and return Graph's response. | [tools-whatsapp](/plugins/tai42/tools-whatsapp)                   | `tai42_tools_whatsapp.tools.subscribe_whatsapp_app`       |
| `github`                         | Verify a GitHub webhook delivery's X-Hub-Signature-256 HMAC before dispatch.                                                                | [webhook-verifier-github](/plugins/tai42/webhook-verifier-github) | `tai42_webhook_verifier_github`                           |
| `stripe`                         | Verify a Stripe webhook delivery's Stripe-Signature HMAC before dispatch.                                                                   | [webhook-verifier-stripe](/plugins/tai42/webhook-verifier-stripe) | `tai42_webhook_verifier_stripe`                           |

## Settings

| Group                             | What it configures                                                       | Docs                                                            | Source                                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `AccessControlRedisSettings`      | Access Control Redis Settings (tai42\_skeleton.access\_control.settings) | [Settings](/reference/settings#accesscontrolredissettings)      | [`tai42_skeleton.access_control.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)    |
| `AccessControlSettings`           | Access Control Settings (tai42\_skeleton.access\_control.settings)       | [Settings](/reference/settings#accesscontrolsettings)           | [`tai42_skeleton.access_control.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)    |
| `AppArgsSettings`                 | App Args Settings (tai42\_skeleton.settings.settings)                    | [Settings](/reference/settings#appargssettings)                 | [`tai42_skeleton.settings.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)          |
| `AuditLogSettings`                | Audit Log Settings (tai42\_skeleton.settings.audit\_log)                 | [Settings](/reference/settings#auditlogsettings)                | [`tai42_skeleton.settings.audit_log`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)         |
| `BodyLimitSettings`               | Body Limit Settings (tai42\_skeleton.settings.body\_limit)               | [Settings](/reference/settings#bodylimitsettings)               | [`tai42_skeleton.settings.body_limit`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `BusRedisSettings`                | Bus Redis Settings (tai42\_skeleton.app.bus\_settings)                   | [Settings](/reference/settings#busredissettings)                | [`tai42_skeleton.app.bus_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)           |
| `BusSettings`                     | Bus Settings (tai42\_skeleton.app.bus\_settings)                         | [Settings](/reference/settings#bussettings)                     | [`tai42_skeleton.app.bus_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)           |
| `ClientTrustSettings`             | Client Trust Settings (tai42\_kit.utils.client\_address)                 | [Settings](/reference/settings#clienttrustsettings)             | [`tai42_kit.utils.client_address`](https://github.com/tai42ai/tai42/tree/main/core/kit)                 |
| `ConfigModeSettings`              | Config Mode Settings (tai42\_skeleton.config.config\_mode)               | [Settings](/reference/settings#configmodesettings)              | [`tai42_skeleton.config.config_mode`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)         |
| `ConnectorAdapterSettings`        | Connector Adapter Settings (tai42\_skeleton.connectors.settings)         | [Settings](/reference/settings#connectoradaptersettings)        | [`tai42_skeleton.connectors.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `ConnectorCryptoSecrets`          | Connector Crypto Secrets settings (tai42\_skeleton.connectors.settings)  | [Settings](/reference/settings#connectorcryptosecrets)          | [`tai42_skeleton.connectors.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `ConnectorEngineConfig`           | Connector Engine Config settings (tai42\_skeleton.connectors.settings)   | [Settings](/reference/settings#connectorengineconfig)           | [`tai42_skeleton.connectors.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `ConnectorStoreRedisSettings`     | Connector Store Redis Settings (tai42\_skeleton.connectors.settings)     | [Settings](/reference/settings#connectorstoreredissettings)     | [`tai42_skeleton.connectors.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `ConnectorStoreSettings`          | Connector Store Settings (tai42\_skeleton.connectors.settings)           | [Settings](/reference/settings#connectorstoresettings)          | [`tai42_skeleton.connectors.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `ContextEditingSettings`          | Context Editing Settings (tai42\_kit.llm.settings)                       | [Settings](/reference/settings#contexteditingsettings)          | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `ContextOverflowSettings`         | Context Overflow Settings (tai42\_kit.llm.settings)                      | [Settings](/reference/settings#contextoverflowsettings)         | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `ConversationsRedisSettings`      | Conversations Redis Settings (tai42\_skeleton.conversations.settings)    | [Settings](/reference/settings#conversationsredissettings)      | [`tai42_skeleton.conversations.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)     |
| `ConversationsSettings`           | Conversations Settings (tai42\_skeleton.conversations.settings)          | [Settings](/reference/settings#conversationssettings)           | [`tai42_skeleton.conversations.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)     |
| `CoreSettings`                    | Core Settings (tai42\_skeleton.settings.settings)                        | [Settings](/reference/settings#coresettings)                    | [`tai42_skeleton.settings.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)          |
| `EmbeddingSettings`               | Embedding Settings (tai42\_kit.llm.settings)                             | [Settings](/reference/settings#embeddingsettings)               | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `EnvSecretMarksSettings`          | Env Secret Marks Settings (tai42\_skeleton.settings.env\_secret\_marks)  | [Settings](/reference/settings#envsecretmarkssettings)          | [`tai42_skeleton.settings.env_secret_marks`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)  |
| `FileLoadingSettings`             | File Loading Settings (tai42\_skeleton.template.settings)                | [Settings](/reference/settings#fileloadingsettings)             | [`tai42_skeleton.template.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)          |
| `HooksRedisSettings`              | Hooks Redis Settings (tai42\_skeleton.hooks.settings)                    | [Settings](/reference/settings#hooksredissettings)              | [`tai42_skeleton.hooks.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)             |
| `HooksSettings`                   | Hooks Settings (tai42\_skeleton.hooks.settings)                          | [Settings](/reference/settings#hookssettings)                   | [`tai42_skeleton.hooks.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)             |
| `InteractionsRedisSettings`       | Interactions Redis Settings (tai42\_skeleton.interactions.settings)      | [Settings](/reference/settings#interactionsredissettings)       | [`tai42_skeleton.interactions.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)      |
| `InteractionsSettings`            | Interactions Settings (tai42\_skeleton.interactions.settings)            | [Settings](/reference/settings#interactionssettings)            | [`tai42_skeleton.interactions.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)      |
| `JqSettings`                      | Jq Settings (tai42\_kit.utils.data.jq\_util)                             | [Settings](/reference/settings#jqsettings)                      | [`tai42_kit.utils.data.jq_util`](https://github.com/tai42ai/tai42/tree/main/core/kit)                   |
| `LLMProviderSettings`             | LLMProvider Settings (tai42\_kit.llm.settings)                           | [Settings](/reference/settings#llmprovidersettings)             | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `LLMSettings`                     | LLMSettings (tai42\_kit.llm.settings)                                    | [Settings](/reference/settings#llmsettings)                     | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `LoggingSettings`                 | Logging Settings (tai42\_kit.logging.settings)                           | [Settings](/reference/settings#loggingsettings)                 | [`tai42_kit.logging.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                     |
| `MCPClientSettings`               | MCPClient Settings (tai42\_kit.clients.settings)                         | [Settings](/reference/settings#mcpclientsettings)               | [`tai42_kit.clients.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                     |
| `MCPDispatchSettings`             | MCPDispatch Settings (tai42\_skeleton.settings.mcp\_settings)            | [Settings](/reference/settings#mcpdispatchsettings)             | [`tai42_skeleton.settings.mcp_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)      |
| `MarketplaceSettings`             | Marketplace Settings (tai42\_skeleton.marketplace.settings)              | [Settings](/reference/settings#marketplacesettings)             | [`tai42_skeleton.marketplace.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)       |
| `MetricsSettings`                 | Metrics Settings (tai42\_skeleton.routers.metrics\_settings)             | [Settings](/reference/settings#metricssettings)                 | [`tai42_skeleton.routers.metrics_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)   |
| `PluginPrefixSettings`            | Plugin Prefix Settings (tai42\_skeleton.marketplace.prefix)              | [Settings](/reference/settings#pluginprefixsettings)            | [`tai42_skeleton.marketplace.prefix`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)         |
| `PluginsSettings`                 | Plugins Settings (tai42\_skeleton.plugins.settings)                      | [Settings](/reference/settings#pluginssettings)                 | [`tai42_skeleton.plugins.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)           |
| `RateLimitRedisSettings`          | Rate Limit Redis Settings (tai42\_skeleton.settings.rate\_limit)         | [Settings](/reference/settings#ratelimitredissettings)          | [`tai42_skeleton.settings.rate_limit`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `RateLimitSettings`               | Rate Limit Settings (tai42\_skeleton.settings.rate\_limit)               | [Settings](/reference/settings#ratelimitsettings)               | [`tai42_skeleton.settings.rate_limit`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)        |
| `RunIndexSettings`                | Run Index Settings (tai42\_skeleton.runs.settings)                       | [Settings](/reference/settings#runindexsettings)                | [`tai42_skeleton.runs.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)              |
| `SamplingSettings`                | Sampling Settings (tai42\_skeleton.tools.sampling\_settings)             | [Settings](/reference/settings#samplingsettings)                | [`tai42_skeleton.tools.sampling_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)    |
| `StatesSettings`                  | States Settings (tai42\_skeleton.states.db)                              | [Settings](/reference/settings#statessettings)                  | [`tai42_skeleton.states.db`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)                  |
| `SubMcpRedisSettings`             | Sub Mcp Redis Settings (tai42\_skeleton.sub\_mcp.settings)               | [Settings](/reference/settings#submcpredissettings)             | [`tai42_skeleton.sub_mcp.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)           |
| `SubMcpSettings`                  | Sub Mcp Settings (tai42\_skeleton.sub\_mcp.settings)                     | [Settings](/reference/settings#submcpsettings)                  | [`tai42_skeleton.sub_mcp.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)           |
| `SummarizationMiddlewareSettings` | Summarization Middleware Settings (tai42\_kit.llm.settings)              | [Settings](/reference/settings#summarizationmiddlewaresettings) | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `TemplateCacheSettings`           | Template Cache Settings (tai42\_skeleton.template.settings)              | [Settings](/reference/settings#templatecachesettings)           | [`tai42_skeleton.template.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)          |
| `ToolRunsRedisSettings`           | Tool Runs Redis Settings (tai42\_skeleton.routers.tool\_runs\_settings)  | [Settings](/reference/settings#toolrunsredissettings)           | [`tai42_skeleton.routers.tool_runs_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton) |
| `ToolRunsSettings`                | Tool Runs Settings (tai42\_skeleton.routers.tool\_runs\_settings)        | [Settings](/reference/settings#toolrunssettings)                | [`tai42_skeleton.routers.tool_runs_settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton) |
| `TrimmingMiddlewareSettings`      | Trimming Middleware Settings (tai42\_kit.llm.settings)                   | [Settings](/reference/settings#trimmingmiddlewaresettings)      | [`tai42_kit.llm.settings`](https://github.com/tai42ai/tai42/tree/main/core/kit)                         |
| `TurnSettings`                    | Turn Settings (tai42\_skeleton.settings.turn)                            | [Settings](/reference/settings#turnsettings)                    | [`tai42_skeleton.settings.turn`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)              |
| `UrlGuardSettings`                | Url Guard Settings (tai42\_kit.net.url\_guard)                           | [Settings](/reference/settings#urlguardsettings)                | [`tai42_kit.net.url_guard`](https://github.com/tai42ai/tai42/tree/main/core/kit)                        |
| `WebhookIngressSettings`          | Webhook Ingress Settings (tai42\_skeleton.webhooks.settings)             | [Settings](/reference/settings#webhookingresssettings)          | [`tai42_skeleton.webhooks.settings`](https://github.com/tai42ai/tai42/tree/main/core/skeleton)          |

## Agents & extensions

No agents or extensions are registered in the base runtime; agent- and

extension-kind capabilities are listed under Plugins above.
