mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-25 09:41:04 +01:00
DottaandPaperclip
0f5fafe16b
## Thinking Path > - Paperclip lets people manage AI agents and their work. > - The Runner connects provider sessions to task state, replies, and delegated work. > - Full-stack tests found lost final replies, rejected helper calls that stopped the parent, and unnecessary process restarts. > - A completed child could also receive a new assignment wake that the scheduler then cancelled. > - This change fixes those boundaries and gives agents clearer teammate instructions. > - The tests retain strict completion and process-continuity requirements. ## Linked Issues or Issue Description **What happened?** A generated attachment comment could suppress an agent's final reply. A known Codex helper could stop its parent when it requested a Paperclip tool. Native Daytona processes restarted between turns because Paperclip minted an unused GitHub broker token. Reassigning a completed child queued a run that immediately cancelled. Revision instructions also allowed agents to do work assigned to a named teammate themselves. **Expected behavior** Keep the final reply. Reject helper tool requests without borrowing parent authority or stopping the parent. Keep an unconfigured sandbox process alive between turns. Treat assignment-only changes to completed tasks as metadata changes. Preserve explicit teammate assignments during revisions. **Steps to reproduce** Run the retained Runner E2E cases for file handoff, teammate reuse, Daytona warm continuity, and Legacy Claude interview/plan acceptance. The focused regression tests reproduce the reply, helper, process-lifetime, and assignment-wake defects without provider calls. **Paperclip version or commit** The live lifetime and completion campaign used `db3857807`. This PR replays the changes on master `c65fc9e3c`. See Verification for the limits of that evidence. **Deployment mode** Isolated local instances and native Runner sessions in Daytona sandboxes. Related work: #13546 handles a different queued-run issue after an issue-lock compare-and-set failure. This PR prevents the unnecessary assignment wake earlier. #13410 covers retained user services; this PR covers the provider process. No duplicate fix was found. ## What Changed - Exclude generated deliverable-binding comments from final-reply deduplication. Preserve the attachment and explicit user-facing replies. - Reject Paperclip tool and input requests from known Codex helper threads without terminating the parent. Keep unknown-thread rejection intact. - Explain how to hire or reuse a persistent teammate and preserve named delegation on revisions. Update generated protocol fixtures. - Use stable, token-free GitHub wrappers for unconfigured native sandboxes. Preserve credential isolation, configured-account rotation, and cleanup after partial staging failures. - Do not queue assignment-only wakes for done or cancelled tasks. Keep explicit reopening behavior. - Make warm-continuity fixtures create real review cards. Read the persisted final response selected by production presentation logic. Missing selected evidence still fails. ## Verification - Before rebase: 560 focused route, native-executor, and launcher tests passed. The new regressions were reproduced before their fixes. - Live E2E: Legacy Claude interview/plan acceptance passed 3/3 repetitions. Daytona warm continuity passed 2/3 full repetitions. Each successful run retained one process and provider session for all three turns. - The remaining Daytona repetition stopped after a same-URL browser reload left the page blank. Both completed turns retained the same process. Its failed verdict remains unchanged; this PR does not claim the blank-page cause is fixed. - Reports: https://pages.paperclip.ing/runner-e2e-lifetime-race-20260920/investigation.html and https://pages.paperclip.ing/runner-e2e-behavior-followups-20260919-results/investigation.html - Post-rebase `pnpm build` and `pnpm -r typecheck` passed. All 414 Runner E2E harness unit tests and its typecheck passed. Codex protocol tests: 88 passed, 2 ignored. - Latest-head CI: 55 successful checks and 2 intentional skips. Greptile: 5/5 with no review threads. The unchanged workspace exposure tests hit a fixed-port collision on the first CI attempt; their local suite passed (25 tests, 3 platform skips), and the CI shard passed on one retry. - The duplicate local `pnpm test:run` was stopped after the full hosted general and serialized test shards passed. It did not finish locally and is not counted as a local full-suite pass. ## Risks Configured GitHub accounts retain run-scoped credential rotation and can still restart warm processes. That limitation requires a separate design. Known provider helpers cannot use Paperclip coordination tools directly; they must return findings to the parent. The delegation prompt is an instruction, not an enforced guarantee; Codex Mini hiring/reuse failures remain open. No schema or workflow changes are included. ## Model Used OpenAI GPT-6 through Codex, with repository tools, code execution, and parallel coding agents. The exact deployment suffix and context-window size are not exposed in this session. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub issues and shared reports) - [x] My branch name describes the change and contains no internal Paperclip ticket id or instance-derived details - [x] I have run focused tests locally and they pass; full hosted test shards also pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
2513 lines
62 KiB
JSON
2513 lines
62 KiB
JSON
[
|
||
{
|
||
"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.",
|
||
"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"
|
||
}
|
||
},
|
||
"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": "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",
|
||
"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.",
|
||
"minLength": 1,
|
||
"type": "string"
|
||
},
|
||
"expectedAssigneeActorId": {
|
||
"description": "Current assigneeAgentId from search_tasks; null means unassigned.",
|
||
"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": "Inspect available company projects before selecting a project for new work.",
|
||
"effect": "read",
|
||
"inputSchema": {
|
||
"additionalProperties": false,
|
||
"properties": {},
|
||
"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.",
|
||
"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",
|
||
"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
|
||
}
|
||
]
|