[
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Create a reusable single-file skill in the company library. Supply a complete SKILL.md whose name and description match the inputs. This saves the skill and shows a card; it does not assign the skill to any agent. Reuse idempotencyKey on retries.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "description": {
          "maxLength": 2000,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "markdown": {
          "description": "Complete SKILL.md including name and description frontmatter and substantive instructions.",
          "maxLength": 200000,
          "minLength": 1,
          "type": "string"
        },
        "name": {
          "description": "Lowercase skill name, matching SKILL.md frontmatter.",
          "maxLength": 120,
          "minLength": 1,
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
          "type": "string"
        },
        "slug": {
          "description": "Optional; must equal name.",
          "maxLength": 120,
          "minLength": 1,
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "name",
        "description",
        "markdown"
      ],
      "type": "object"
    },
    "operationId": "create_skill",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Create skill",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Fallback only: discover Paperclip API operations when the available dedicated tools cannot express the task. Prefer dedicated tools for common operations; do not search before using them. For a persistent hire, first list_agents to reuse a suitable teammate. Search agent-hires for the hiring schema and agent-configurations for compatible adapter/runtime settings, then use call_api with the returned operationId. Supply role-specific instructionsBundle.files as a filename-to-content record. Use the returned agent.id for delegation and obey any pending approval. Provider helper threads are temporary workers, not Paperclip hires. If a hire response is uncertain, reconcile with list_agents before retrying.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "cursor": {
          "maxLength": 200,
          "type": "string"
        },
        "limit": {
          "default": 5,
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        },
        "query": {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "operationId": "search_api",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "api:discover"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Search the Paperclip API",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Fallback only: call a discovered Paperclip API operation when dedicated tools lack the required operation or parameters. Uses your existing permissions. Prefer dedicated tools; never bypass a denial or runner lifecycle tool. For large text responses, read the returned artifact with GET /api/assets/{assetId}/content and responseText; follow nextOffsetBytes until null.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "description": "Request value matching the discovered schema. For JSON object or array requests, pass the object or array directly, never a JSON-encoded string. Strings are for text bodies or endpoints whose schema explicitly accepts a string."
        },
        "contentType": {
          "maxLength": 120,
          "type": "string"
        },
        "files": {
          "items": {
            "additionalProperties": false,
            "oneOf": [
              {
                "properties": {
                  "artifactId": {}
                },
                "required": [
                  "artifactId"
                ]
              },
              {
                "properties": {
                  "path": {}
                },
                "required": [
                  "path"
                ]
              }
            ],
            "properties": {
              "artifactId": {
                "type": "string"
              },
              "field": {
                "type": "string"
              },
              "path": {
                "description": "File relative to the active issue workspace. Remote files must first be uploaded as an artifact.",
                "type": "string"
              }
            },
            "type": "object"
          },
          "maxItems": 10,
          "type": "array"
        },
        "operationId": {
          "description": "Exact operationId returned by search_api, for example GET /api/projects/{id}. Do not guess identifiers.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        "pathParams": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        "query": {
          "additionalProperties": true,
          "type": "object"
        },
        "responseText": {
          "additionalProperties": false,
          "description": "GET only: return a bounded UTF-8 text window inline, including JSON as text, without saving another artifact. Offsets and limits are bytes. Use the returned nextOffsetBytes to continue; null means complete. Prefer reading a saved artifact for a stable snapshot. New live responses have a 1 GiB capture limit and a 4 GiB per-run capture budget. Existing larger assets remain readable in bounded pages. If a live response returns an artifact, continue on its content operation for a stable snapshot.",
          "properties": {
            "limitBytes": {
              "default": 24576,
              "maximum": 24576,
              "minimum": 4,
              "type": "integer"
            },
            "offsetBytes": {
              "default": 0,
              "maximum": 9007199254740991,
              "minimum": 0,
              "type": "integer"
            }
          },
          "type": "object"
        }
      },
      "required": [
        "operationId"
      ],
      "type": "object"
    },
    "operationId": "call_api",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "api:call"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Call the Paperclip API",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read the active task, actor, wake context, ancestors, and budget summary.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "get_task_context",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get active task context",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read bounded comments on the active task.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "limit": {
          "default": 50,
          "maximum": 200,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [],
      "type": "object"
    },
    "operationId": "get_task_history",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get active task history",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "List revisioned documents on the active task.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "list_documents",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "List task documents",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read the current revision of one active-task document.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "key": {
          "description": "Stable issue-document key.",
          "maxLength": 120,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "key"
      ],
      "type": "object"
    },
    "operationId": "read_document",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Read task document",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read bounded revision history for one active-task document.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "key": {
          "description": "Stable issue-document key.",
          "maxLength": 120,
          "minLength": 1,
          "type": "string"
        },
        "limit": {
          "default": 50,
          "maximum": 200,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "key"
      ],
      "type": "object"
    },
    "operationId": "list_document_revisions",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "List document revisions",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Set a concise, descriptive title for the active task. When its titleNeedsGeneration is true, call this early with onlyIfProvisional: true to replace the initial prompt slice without overwriting a user's title. Use false only for an intentional rename. This changes no task status, ownership, or description.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "idempotencyKey": {
          "description": "Reuse this key on retries.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "onlyIfProvisional": {
          "description": "True for automatic initial naming; preserves any title already chosen by a user or agent.",
          "type": "boolean"
        },
        "title": {
          "description": "Short title describing the requested outcome.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "title",
        "onlyIfProvisional"
      ],
      "type": "object"
    },
    "operationId": "set_task_title",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Set task title",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Append a durable progress comment to the active task.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "Multiline progress update.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "body"
      ],
      "type": "object"
    },
    "operationId": "report_progress",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Report durable progress",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Append an answer to a status-only wake without changing task disposition.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "Concise status answer.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "body"
      ],
      "type": "object"
    },
    "operationId": "answer_status_question",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Answer status question",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "planning",
      "skill_test"
    ],
    "description": "Create or update an active-task document with optimistic revision safety.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "baseRevisionId": {
          "description": "Current revision id, or null when creating.",
          "maxLength": 240,
          "type": [
            "string",
            "null"
          ]
        },
        "body": {
          "description": "Markdown document body.",
          "maxLength": 200000,
          "minLength": 1,
          "type": "string"
        },
        "changeSummary": {
          "description": "Optional revision summary.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "key": {
          "description": "Stable issue-document key.",
          "maxLength": 120,
          "minLength": 1,
          "type": "string"
        },
        "title": {
          "description": "Document title.",
          "maxLength": 300,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "key",
        "title",
        "body",
        "baseRevisionId"
      ],
      "type": "object"
    },
    "operationId": "write_document",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Write revisioned document",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Create a typed, durable interaction on the active task.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "continuationPolicy": {
          "enum": [
            "none",
            "wake_assignee",
            "wake_assignee_on_accept"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "interactionKind": {
          "enum": [
            "confirmation",
            "checkbox",
            "questions",
            "suggest_tasks",
            "item_verdicts"
          ]
        },
        "payload": {
          "additionalProperties": true,
          "type": "object"
        },
        "prompt": {
          "description": "Question or decision prompt.",
          "maxLength": 10000,
          "minLength": 1,
          "type": "string"
        },
        "targetRevisionId": {
          "description": "Optional bound document revision.",
          "maxLength": 240,
          "type": [
            "string",
            "null"
          ]
        },
        "title": {
          "description": "Interaction card title.",
          "maxLength": 300,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "interactionKind",
        "title",
        "prompt",
        "continuationPolicy"
      ],
      "type": "object"
    },
    "operationId": "request_human_input",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Request structured human input",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "planning",
      "skill_test"
    ],
    "description": "Register attachment metadata and its work product without returning bytes or credentials.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "byteSize": {
          "maximum": 100000000,
          "minimum": 0,
          "type": "integer"
        },
        "contentRef": {
          "description": "Opaque content reference.",
          "maxLength": 2000,
          "minLength": 1,
          "type": "string"
        },
        "contentType": {
          "description": "Media type.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "filename": {
          "description": "Display filename.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "sha256": {
          "pattern": "^[a-fA-F0-9]{64}$",
          "type": "string"
        },
        "title": {
          "description": "Work-product title.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "filename",
        "contentType",
        "byteSize",
        "sha256",
        "contentRef",
        "title"
      ],
      "type": "object"
    },
    "operationId": "register_deliverable",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Register inspectable deliverable",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Finish the active task with a durable summary.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "summary": {
          "description": "Completion summary.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "summary"
      ],
      "type": "object"
    },
    "operationId": "finish_task",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Finish active task",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Block the active task with a durable reason and optional first-class dependencies.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "blockedByTaskIds": {
          "description": "Task identifiers that block this task.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "reason": {
          "description": "Block reason.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "reason"
      ],
      "type": "object"
    },
    "operationId": "block_task",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Block active task",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Move the active task to review with a durable summary.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "summary": {
          "description": "Review handoff summary.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "summary"
      ],
      "type": "object"
    },
    "operationId": "request_review",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "always",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Request task review",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "List redacted actor profiles in the run company.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "list_agents",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "discovery:agents:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "List company agents",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Create one native Paperclip Runner teammate for the current company and task. The new agent reports to you, inherits your native runtime, and receives no provider, adapter, environment, or credential configuration from the tool. Reuse an existing teammate when appropriate and follow any approval returned by the API.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "capabilities": {
          "description": "Optional concise capability summary.",
          "maxLength": 2000,
          "type": [
            "string",
            "null"
          ]
        },
        "instructions": {
          "description": "Optional persona or task instructions.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "description": "Name for the new teammate.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "role": {
          "default": "general",
          "enum": [
            "ceo",
            "cto",
            "cmo",
            "cfo",
            "security",
            "engineer",
            "designer",
            "pm",
            "qa",
            "devops",
            "researcher",
            "general"
          ]
        },
        "title": {
          "description": "Optional teammate title.",
          "maxLength": 300,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "operationId": "hire_agent",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "delegation:agents:create"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Hire a native agent",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read one redacted actor profile in the run company.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "actorId": {
          "description": "Actor identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "actorId"
      ],
      "type": "object"
    },
    "operationId": "get_agent",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "discovery:agents:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get company agent",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Search tasks by text and status within the run company.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "limit": {
          "default": 50,
          "maximum": 200,
          "minimum": 1,
          "type": "integer"
        },
        "query": {
          "maxLength": 500,
          "type": "string"
        },
        "statuses": {
          "items": {
            "enum": [
              "backlog",
              "todo",
              "in_progress",
              "in_review",
              "done",
              "blocked",
              "cancelled"
            ]
          },
          "maxItems": 7,
          "type": "array",
          "uniqueItems": true
        }
      },
      "required": [],
      "type": "object"
    },
    "operationId": "search_tasks",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "discovery:tasks:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Search company tasks",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "List approvals in the run company.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "list_approvals",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "List approvals",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read one approval without protected data.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "approvalId": {
          "description": "Approval identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "approvalId"
      ],
      "type": "object"
    },
    "operationId": "get_approval",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get approval",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read one approval, its comments, and linked tasks.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "approvalId": {
          "description": "Approval identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "approvalId"
      ],
      "type": "object"
    },
    "operationId": "get_approval_context",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get approval context",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Read active-task workspace services.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "get_workspace_runtime",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "workspace:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Get workspace runtime",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Start or stop one active-task workspace service.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "action": {
          "enum": [
            "start",
            "stop"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "serviceId": {
          "description": "Workspace service identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "serviceId",
        "action"
      ],
      "type": "object"
    },
    "operationId": "control_workspace_service",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "workspace:control"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Control workspace service",
    "version": 1
  },
  {
    "allowedModes": [
      "standard"
    ],
    "description": "Reassign an existing task to another company agent. Read search_tasks first and supply its current assignee and statusVersion to prevent overwriting a concurrent change. Preserve the task, documents, dependencies, and blocked/backlog status. Active work is stopped before handoff. Use a stable idempotency key for retries. Cannot reassign this run’s own task, conversations, completed tasks, or pending reviews; use create_task for delegation from the current task.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "assigneeActorId": {
          "description": "New company agent ID from list_agents; null when assigning a person.",
          "type": [
            "string",
            "null"
          ]
        },
        "assigneeUserId": {
          "description": "Company person ID from list_people. Mutually exclusive with assigneeActorId.",
          "type": [
            "string",
            "null"
          ]
        },
        "expectedAssigneeActorId": {
          "description": "Current assigneeAgentId from search_tasks; null means unassigned.",
          "type": [
            "string",
            "null"
          ]
        },
        "expectedAssigneeUserId": {
          "description": "Current assigneeUserId from search_tasks; omit only when there is no person assigned.",
          "type": [
            "string",
            "null"
          ]
        },
        "expectedStatusVersion": {
          "description": "Current statusVersion from search_tasks.",
          "minimum": 0,
          "type": "integer"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "reason": {
          "description": "Why the task should move and context for the new owner.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        },
        "taskId": {
          "description": "Existing task ID from search_tasks.",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "taskId",
        "assigneeActorId",
        "expectedAssigneeActorId",
        "expectedStatusVersion",
        "reason"
      ],
      "type": "object"
    },
    "operationId": "reassign_task",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "delegation:tasks:assign"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Reassign task",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Replace the active task's first-class blocker set.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "blockedByTaskIds": {
          "description": "Replacement blocker task identifiers.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "blockedByTaskIds"
      ],
      "type": "object"
    },
    "operationId": "set_dependencies",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "dependencies:write"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Set task dependencies",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "List company project summaries (IDs, names, status, and up to 1,000 characters of description). Returns up to 50 projects and nextCursor; continue with cursor until it is null. Read a project's API resource for full details.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "cursor": {
          "description": "The nextCursor returned by the previous page.",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
          "type": "string"
        },
        "limit": {
          "description": "Page size (default 50).",
          "maximum": 50,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [],
      "type": "object"
    },
    "operationId": "list_projects",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "discovery:projects:read"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "List projects",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "List authorized repositories with stable IDs and names. Consider appropriate repositories before creating a project; never invent IDs.",
    "effect": "read",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {},
      "required": [],
      "type": "object"
    },
    "operationId": "list_project_repositories",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "List available repositories",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Create a project after considering existing projects and available repositories. repositoryIds and repositoryUrls accept multiple existing repositories. Use HTTPS GitHub repositoryUrls when an accessible repo is not in the catalog; this registers project repositories, not remote GitHub repositories. Non-code projects may omit repositories. Cannot combine repositoryIds/repositoryUrls with workspace. Reuse the idempotency key on retries.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "archivedAt": {
          "description": "Archive timestamp.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "color": {
          "description": "Project color.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "description": "Project outcome and context.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "env": {
          "additionalProperties": true,
          "type": "object"
        },
        "executionWorkspacePolicy": {
          "additionalProperties": true,
          "type": "object"
        },
        "goalId": {
          "description": "Goal ID.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "goalIds": {
          "description": "Goal IDs.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "icon": {
          "description": "Project icon.",
          "enum": [
            "folder",
            "rocket",
            "code",
            "terminal",
            "database",
            "globe",
            "package",
            "boxes",
            "box",
            "layers",
            "briefcase",
            "compass",
            "target",
            "flame",
            "zap",
            "star",
            "bug",
            "wrench",
            "hammer",
            "lightbulb",
            "sparkles",
            "shield",
            "lock",
            "search",
            "cog",
            "brain",
            "cpu",
            "git-branch",
            "file-code",
            "puzzle",
            "gem",
            "atom",
            "heart",
            "mail",
            "message-square",
            "crown",
            "radar",
            "telescope",
            "hexagon",
            null
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "leadAgentId": {
          "description": "Lead agent ID.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "description": "Project name.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        "repositoryIds": {
          "description": "Authorized repository IDs from list_project_repositories; may contain multiple repositories.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "repositoryUrls": {
          "description": "Existing HTTPS GitHub repository URLs, including repos absent from the catalog.",
          "items": {
            "maxLength": 2000,
            "pattern": "^https://github\\.com/(?!\\.{1,2}/)[A-Za-z0-9_.-]+/(?!\\.{1,2}/?$)[A-Za-z0-9_.-]+/?$",
            "type": "string"
          },
          "maxItems": 100,
          "type": "array",
          "uniqueItems": true
        },
        "status": {
          "enum": [
            "backlog",
            "planned",
            "in_progress",
            "completed",
            "cancelled"
          ]
        },
        "targetDate": {
          "description": "Target date.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "workspace": {
          "additionalProperties": true,
          "type": "object"
        }
      },
      "required": [
        "idempotencyKey",
        "name"
      ],
      "type": "object"
    },
    "operationId": "create_project",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Create project",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Create an assigned task. In a conversation, create a project task with no parent; otherwise create a child of the active task. Include initialPlan to persist its plan before execution. Set status to backlog when the user wants to save or plan work without starting it; backlog tasks never wake an agent. Omitted status means todo, subject to blockers.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "assigneeActorId": {
          "description": "Optional actor assignee. Mutually exclusive with assigneeUserId.",
          "maxLength": 200,
          "type": [
            "string",
            "null"
          ]
        },
        "assigneeUserId": {
          "description": "Company person ID from list_people. Mutually exclusive with assigneeActorId.",
          "maxLength": 200,
          "type": [
            "string",
            "null"
          ]
        },
        "blockedByTaskIds": {
          "description": "Initial blocker task identifiers.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "description": {
          "description": "Child task description.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "initialPlan": {
          "description": "Remaining execution steps to persist as the task plan. Exclude completed planning, approval, and handoff steps; cite the source plan revision and approval. A copied plan is not a new approval gate.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "priority": {
          "enum": [
            "critical",
            "high",
            "medium",
            "low"
          ]
        },
        "projectId": {
          "description": "Project identifier for the new task.",
          "maxLength": 20000,
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "description": "Initial status. Use backlog to save work without execution. Defaults to todo (blocked when dependencies are unresolved).",
          "enum": [
            "backlog",
            "todo"
          ]
        },
        "title": {
          "description": "Task title.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "title"
      ],
      "type": "object"
    },
    "operationId": "create_task",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "delegation:tasks:create"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Create task",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Create a governed approval and waiting posture.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "approvalType": {
          "description": "Stable approval type.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "payload": {
          "additionalProperties": true,
          "type": "object"
        }
      },
      "required": [
        "idempotencyKey",
        "approvalType",
        "payload"
      ],
      "type": "object"
    },
    "operationId": "request_approval",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:request"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Request approval",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "allowedRoles": [
      "board",
      "approver",
      "security"
    ],
    "description": "Decide an approval as an explicitly authorized approver.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "approvalId": {
          "description": "Approval identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "decision": {
          "enum": [
            "approved",
            "rejected",
            "cancelled"
          ]
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "note": {
          "description": "Decision note.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "approvalId",
        "decision",
        "note"
      ],
      "type": "object"
    },
    "operationId": "decide_approval",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:decide"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Decide approval",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "ask",
      "planning",
      "skill_test"
    ],
    "description": "Add a durable comment to an approval.",
    "effect": "governance",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "approvalId": {
          "description": "Approval identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "body": {
          "description": "Approval comment.",
          "maxLength": 20000,
          "minLength": 1,
          "type": "string"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "approvalId",
        "body"
      ],
      "type": "object"
    },
    "operationId": "comment_on_approval",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "governance:approvals:comment"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Comment on approval",
    "version": 1
  },
  {
    "allowedModes": [
      "standard"
    ],
    "description": "Schedule, replace or clear a persisted one-shot monitor on an owned task.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "idempotencyKey": {
          "description": "Reuse with identical arguments on retries.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "monitor": {
          "additionalProperties": false,
          "properties": {
            "externalRef": {
              "maxLength": 500,
              "minLength": 1,
              "type": [
                "string",
                "null"
              ]
            },
            "kind": {
              "enum": [
                "external_service",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "maxAttempts": {
              "description": "Optional cumulative attempt limit for this task's monitor.",
              "maximum": 100,
              "minimum": 1,
              "type": [
                "integer",
                "null"
              ]
            },
            "nextCheckAt": {
              "description": "Future UTC timestamp for the next check. This is one shot, not a recurring interval.",
              "type": "string"
            },
            "notes": {
              "description": "What to check on the next run; do not include secrets.",
              "maxLength": 500,
              "minLength": 1,
              "type": "string"
            },
            "recoveryPolicy": {
              "enum": [
                "wake_owner",
                "create_recovery_issue",
                "escalate_to_board",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "serviceName": {
              "maxLength": 120,
              "minLength": 1,
              "type": [
                "string",
                "null"
              ]
            },
            "timeoutAt": {
              "description": "Optional deadline later than nextCheckAt.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "nextCheckAt",
            "notes"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "taskId": {
          "description": "Owned task UUID. Omit for the active task.",
          "type": "string"
        }
      },
      "required": [
        "idempotencyKey",
        "monitor"
      ],
      "type": "object"
    },
    "operationId": "set_task_monitor",
    "outputSchema": {
      "additionalProperties": true,
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [],
    "schema": "paperclip.semantic-action.v1",
    "title": "Set task monitor",
    "version": 1
  },
  {
    "allowedModes": [
      "standard",
      "skill_test"
    ],
    "description": "Schedule a bounded continuation wake.",
    "effect": "write",
    "inputSchema": {
      "additionalProperties": false,
      "properties": {
        "delaySeconds": {
          "maximum": 86400,
          "minimum": 1,
          "type": "integer"
        },
        "idempotencyKey": {
          "description": "Caller-stable retry key.",
          "maxLength": 240,
          "minLength": 1,
          "type": "string"
        },
        "payload": {
          "additionalProperties": true,
          "type": "object"
        },
        "reason": {
          "enum": [
            "manual",
            "issue_commented",
            "interaction_resolved",
            "approval_resolved",
            "blockers_resolved",
            "scheduled_retry",
            "resume"
          ]
        }
      },
      "required": [
        "idempotencyKey",
        "reason",
        "delaySeconds"
      ],
      "type": "object"
    },
    "operationId": "schedule_wake",
    "outputSchema": {
      "additionalProperties": false,
      "properties": {
        "commandId": {
          "description": "Stable command identifier.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "disposition": {
          "enum": [
            "applied",
            "duplicate"
          ]
        },
        "entityRefs": {
          "description": "Entities affected by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "scheduledWakeIds": {
          "description": "Wake identifiers scheduled by the operation.",
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "maxItems": 200,
          "type": "array",
          "uniqueItems": true
        },
        "stateRevision": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "commandId",
        "disposition",
        "stateRevision",
        "entityRefs",
        "scheduledWakeIds"
      ],
      "type": "object"
    },
    "placement": "optional",
    "requiredClaims": [
      "control_plane:wakes"
    ],
    "schema": "paperclip.semantic-action.v1",
    "title": "Schedule bounded wake",
    "version": 1
  }
]