mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-21 02:43:25 +01:00
feat(routines): let agents list and change their person's routines in plain terms (#22274)
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - Routines are recurring work that an agent runs on a schedule, webhook or request. People file them under their responsibilities. > - #22253 and #22261 let agents read and change areas and responsibilities. Agents still have no dedicated routine tools, and they can change only routines assigned to themselves. > - When a person says "move my weekly digest to Monday mornings" or "map my routines to my responsibilities", the agent must use the generic API, write cron, and it is refused for the person's routines. > - This pull request adds `list_routines` and `update_routine`. It also lets an agent change routines that the person its run works for is responsible for. > - The benefit is that an agent can find routines under no responsibility, file them, and change their schedule in plain terms. Each change is a routine revision the person can restore. ## Linked Issues or Issue Description Refs #22261 (phase 2; this pull request is stacked on it), #22253 (phase 1). **Subsystem affected** Server (routine routes, native runner tool authority), the native runner tool catalog, and the `paperclip` skill. **Problem or motivation** An agent can list and change only its own routines through the generic API. It cannot change the schedule of a routine its person is responsible for. It must write cron expressions, and it cannot find the routines that are filed under no responsibility. **Proposed solution** Make the existing scenario operation `list_routines` live, with filters for words, status, agent, project, responsible person, a responsibility and "unfiled". Add `update_routine` for the title, instructions, agent, project, status, priority, a plain `schedule`, and filing under a responsibility. Let an agent manage a routine when the person its run works for is responsible for it. Handing the routine to another agent needs that person to have `tasks:assign`. **Alternatives considered** A new `routines` permission grant would add a setting with no current need. Routine revisions already give an undo path, so this change adds no new history. ## What Changed - `list_routines` is now live (it was a scenario-only mock) and keeps its scenario mock. - Add `update_routine`. A `schedule` such as `{ frequency: "weekly", dayOfWeek: "monday", time: "09:00", timezone }` maps to the routine's schedule trigger through the existing routine-offer cadence helpers. `schedule: null` turns the schedule off. `fileUnder` files the routine under a responsibility. - Add `server/src/services/routine-tools.ts`. It calls the routine routes with the run token. Fields and schedule go in one `PATCH /routines/:id` (one transaction and revision, guarded by `baseRevisionId`); filing follows, and if it fails after the routine changed the tool reports what was saved. Each part reports its own undo: the routine revision, or the Dashboard history for filing. - `PATCH /routines/:id` takes `schedule` (`{ cronExpression, timezone? }` or `null`) and replaces the schedule under the routine row lock, so racing changes leave one schedule. Without a zone it keeps the current schedule's, else uses the person's saved time zone, else answers 422. - `GET /companies/:companyId/routines` filters `q`, `status`, `assigneeAgentId`, `responsibleUserId`, `responsibilityId` and `unfiled=true` in SQL. - In `routes/routines.ts`, an agent may manage routines assigned to itself or routines its person is responsible for. On a routine the agent does not run, taking it from another agent (or handing it on), turning it on, changing its schedule (also through the trigger routes), starting a run, or restoring a revision requires that person's `tasks:assign`, as for a person. The person must have directed the run (see #22261). `routine.updated` activity records `onBehalfOfUserId`. - The routine and responsibility routes share one rule, `agentPersonInCompany` in `routes/agent-person-authz.ts`. - The catalog keeps each live action's `requiredClaims` (`list_routines` is `routines:read`). - The routine tools stay visible when Responsibilities is off. Only `responsibilityId`, `unfiled` and `fileUnder` need it. - Update `search_api` tool pointers, the routines reference, the skill section, the chat directive, the operation-groups spec and the pinned counts. ## Verification - Server: `routine-tools.test.ts` (new), `routines-routes.test.ts` (new: an agent changes its person's routine, hands it off only with `tasks:assign`, and is refused for another person's routine), the `responsibilit*` tests, `paperclip-runner-tool-authority` and `runner-api`: all pass. The first test in `routines-routes.test.ts` (Fireflies) times out at 15 s in my sandbox on a cold import, with or without this change. It passes with `--testTimeout=60000`. - Server `node scripts/typecheck-layers.mjs`: passed. - Runner: catalog, semantic-tool, eval, scenario and permission-policy tests (316) pass. All generator checks pass. ## Risks - Medium-low. Agents get write access to their person's routines. The route still checks the company, the routine revision guard and `tasks:assign` for a hand-off. The person can restore any earlier routine revision. - `list_routines` changes from a scenario-only mock to a live tool, so the reconciled catalog counts change. ## Model Used Claude Opus 5.5 (`claude-opus-5-5`) in Claude Code, with tool use and code execution. ## 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 `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they 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 - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Paperclip <noreply@paperclip.ing>
This commit is contained in:
40 files changed
+1386
-337
No files matched your search
@@ -50,36 +50,36 @@ The skill/reference inventory and eval cases are the only normative behavior sou
|
||||
| skill:skills/paperclip/SKILL.md:generated-artifacts-and-work-products:206 | always_agent_tool | skills/paperclip/SKILL.md:206 |
|
||||
| skill:skills/paperclip/SKILL.md:offer-a-routine-after-recurring-work:252 | optional_agent_tool | skills/paperclip/SKILL.md:252 |
|
||||
| skill:skills/paperclip/SKILL.md:areas-and-responsibilities:275 | optional_agent_tool | skills/paperclip/SKILL.md:275 |
|
||||
| skill:skills/paperclip/SKILL.md:propose-a-bar-in-a-bar-conversation:293 | optional_agent_tool | skills/paperclip/SKILL.md:293 |
|
||||
| skill:skills/paperclip/SKILL.md:propose-an-automation-in-an-automation-conversation:297 | optional_agent_tool | skills/paperclip/SKILL.md:297 |
|
||||
| skill:skills/paperclip/SKILL.md:write-a-responsibility-s-status:301 | optional_agent_tool | skills/paperclip/SKILL.md:301 |
|
||||
| skill:skills/paperclip/SKILL.md:status-quick-guide:307 | control_plane_owned | skills/paperclip/SKILL.md:307 |
|
||||
| skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:317 | optional_agent_tool | skills/paperclip/SKILL.md:317 |
|
||||
| skill:skills/paperclip/SKILL.md:delegating-review-tasks:338 | always_agent_tool | skills/paperclip/SKILL.md:338 |
|
||||
| skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:349 | control_plane_owned | skills/paperclip/SKILL.md:349 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:357 | control_plane_owned | skills/paperclip/SKILL.md:357 |
|
||||
| skill:skills/paperclip/SKILL.md:requesting-board-approval:382 | optional_agent_tool | skills/paperclip/SKILL.md:382 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-thread-interactions:403 | optional_agent_tool | skills/paperclip/SKILL.md:403 |
|
||||
| skill:skills/paperclip/SKILL.md:standalone-decisions:433 | optional_agent_tool | skills/paperclip/SKILL.md:433 |
|
||||
| skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:537 | optional_agent_tool | skills/paperclip/SKILL.md:537 |
|
||||
| skill:skills/paperclip/SKILL.md:niche-workflow-pointers:579 | optional_agent_tool | skills/paperclip/SKILL.md:579 |
|
||||
| skill:skills/paperclip/SKILL.md:cases:589 | optional_agent_tool | skills/paperclip/SKILL.md:589 |
|
||||
| skill:skills/paperclip/SKILL.md:company-skills-workflow:594 | optional_agent_tool | skills/paperclip/SKILL.md:594 |
|
||||
| skill:skills/paperclip/SKILL.md:routines:605 | optional_agent_tool | skills/paperclip/SKILL.md:605 |
|
||||
| skill:skills/paperclip/SKILL.md:task-files-and-workspace-choices:617 | optional_agent_tool | skills/paperclip/SKILL.md:617 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:625 | optional_agent_tool | skills/paperclip/SKILL.md:625 |
|
||||
| skill:skills/paperclip/SKILL.md:proposing-credentials-safely:632 | optional_agent_tool | skills/paperclip/SKILL.md:632 |
|
||||
| skill:skills/paperclip/SKILL.md:reading-granted-secrets:639 | optional_agent_tool | skills/paperclip/SKILL.md:639 |
|
||||
| skill:skills/paperclip/SKILL.md:critical-rules:665 | optional_agent_tool | skills/paperclip/SKILL.md:665 |
|
||||
| skill:skills/paperclip/SKILL.md:comment-style-required:686 | always_agent_tool | skills/paperclip/SKILL.md:686 |
|
||||
| skill:skills/paperclip/SKILL.md:update:722 | optional_agent_tool | skills/paperclip/SKILL.md:722 |
|
||||
| skill:skills/paperclip/SKILL.md:task-documents-and-deliverables:732 | always_agent_tool | skills/paperclip/SKILL.md:732 |
|
||||
| skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:746 | optional_agent_tool | skills/paperclip/SKILL.md:746 |
|
||||
| skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:777 | optional_agent_tool | skills/paperclip/SKILL.md:777 |
|
||||
| skill:skills/paperclip/SKILL.md:searching-issues:807 | optional_agent_tool | skills/paperclip/SKILL.md:807 |
|
||||
| skill:skills/paperclip/SKILL.md:full-reference:817 | optional_agent_tool | skills/paperclip/SKILL.md:817 |
|
||||
| skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:821 | always_agent_tool | skills/paperclip/SKILL.md:821 |
|
||||
| skill:skills/paperclip/SKILL.md:incidental-feedback:838 | optional_agent_tool | skills/paperclip/SKILL.md:838 |
|
||||
| skill:skills/paperclip/SKILL.md:propose-a-bar-in-a-bar-conversation:294 | optional_agent_tool | skills/paperclip/SKILL.md:294 |
|
||||
| skill:skills/paperclip/SKILL.md:propose-an-automation-in-an-automation-conversation:298 | optional_agent_tool | skills/paperclip/SKILL.md:298 |
|
||||
| skill:skills/paperclip/SKILL.md:write-a-responsibility-s-status:302 | optional_agent_tool | skills/paperclip/SKILL.md:302 |
|
||||
| skill:skills/paperclip/SKILL.md:status-quick-guide:308 | control_plane_owned | skills/paperclip/SKILL.md:308 |
|
||||
| skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:318 | optional_agent_tool | skills/paperclip/SKILL.md:318 |
|
||||
| skill:skills/paperclip/SKILL.md:delegating-review-tasks:339 | always_agent_tool | skills/paperclip/SKILL.md:339 |
|
||||
| skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:350 | control_plane_owned | skills/paperclip/SKILL.md:350 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:358 | control_plane_owned | skills/paperclip/SKILL.md:358 |
|
||||
| skill:skills/paperclip/SKILL.md:requesting-board-approval:383 | optional_agent_tool | skills/paperclip/SKILL.md:383 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-thread-interactions:404 | optional_agent_tool | skills/paperclip/SKILL.md:404 |
|
||||
| skill:skills/paperclip/SKILL.md:standalone-decisions:434 | optional_agent_tool | skills/paperclip/SKILL.md:434 |
|
||||
| skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:538 | optional_agent_tool | skills/paperclip/SKILL.md:538 |
|
||||
| skill:skills/paperclip/SKILL.md:niche-workflow-pointers:580 | optional_agent_tool | skills/paperclip/SKILL.md:580 |
|
||||
| skill:skills/paperclip/SKILL.md:cases:590 | optional_agent_tool | skills/paperclip/SKILL.md:590 |
|
||||
| skill:skills/paperclip/SKILL.md:company-skills-workflow:595 | optional_agent_tool | skills/paperclip/SKILL.md:595 |
|
||||
| skill:skills/paperclip/SKILL.md:routines:606 | optional_agent_tool | skills/paperclip/SKILL.md:606 |
|
||||
| skill:skills/paperclip/SKILL.md:task-files-and-workspace-choices:618 | optional_agent_tool | skills/paperclip/SKILL.md:618 |
|
||||
| skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:626 | optional_agent_tool | skills/paperclip/SKILL.md:626 |
|
||||
| skill:skills/paperclip/SKILL.md:proposing-credentials-safely:633 | optional_agent_tool | skills/paperclip/SKILL.md:633 |
|
||||
| skill:skills/paperclip/SKILL.md:reading-granted-secrets:640 | optional_agent_tool | skills/paperclip/SKILL.md:640 |
|
||||
| skill:skills/paperclip/SKILL.md:critical-rules:666 | optional_agent_tool | skills/paperclip/SKILL.md:666 |
|
||||
| skill:skills/paperclip/SKILL.md:comment-style-required:687 | always_agent_tool | skills/paperclip/SKILL.md:687 |
|
||||
| skill:skills/paperclip/SKILL.md:update:723 | optional_agent_tool | skills/paperclip/SKILL.md:723 |
|
||||
| skill:skills/paperclip/SKILL.md:task-documents-and-deliverables:733 | always_agent_tool | skills/paperclip/SKILL.md:733 |
|
||||
| skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:747 | optional_agent_tool | skills/paperclip/SKILL.md:747 |
|
||||
| skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:778 | optional_agent_tool | skills/paperclip/SKILL.md:778 |
|
||||
| skill:skills/paperclip/SKILL.md:searching-issues:808 | optional_agent_tool | skills/paperclip/SKILL.md:808 |
|
||||
| skill:skills/paperclip/SKILL.md:full-reference:818 | optional_agent_tool | skills/paperclip/SKILL.md:818 |
|
||||
| skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:822 | always_agent_tool | skills/paperclip/SKILL.md:822 |
|
||||
| skill:skills/paperclip/SKILL.md:incidental-feedback:839 | optional_agent_tool | skills/paperclip/SKILL.md:839 |
|
||||
| skill:skills/paperclip/references/api-reference.md:paperclip-api-reference:1 | optional_agent_tool | skills/paperclip/references/api-reference.md:1 |
|
||||
| skill:skills/paperclip/references/api-reference.md:response-schemas:9 | optional_agent_tool | skills/paperclip/references/api-reference.md:9 |
|
||||
| skill:skills/paperclip/references/api-reference.md:agent-record-get-api-agents-me-or-get-api-agents-agentid:11 | optional_agent_tool | skills/paperclip/references/api-reference.md:11 |
|
||||
@@ -197,20 +197,20 @@ The skill/reference inventory and eval cases are the only normative behavior sou
|
||||
| skill:skills/paperclip/references/issue-workspaces.md:read-the-url:77 | optional_agent_tool | skills/paperclip/references/issue-workspaces.md:77 |
|
||||
| skill:skills/paperclip/references/issue-workspaces.md:mcp-tools:86 | optional_agent_tool | skills/paperclip/references/issue-workspaces.md:86 |
|
||||
| skill:skills/paperclip/references/routines.md:paperclip-routines:1 | optional_agent_tool | skills/paperclip/references/routines.md:1 |
|
||||
| skill:skills/paperclip/references/routines.md:lifecycle:16 | optional_agent_tool | skills/paperclip/references/routines.md:16 |
|
||||
| skill:skills/paperclip/references/routines.md:creating-a-routine:27 | optional_agent_tool | skills/paperclip/references/routines.md:27 |
|
||||
| skill:skills/paperclip/references/routines.md:concurrency-policies:64 | optional_agent_tool | skills/paperclip/references/routines.md:64 |
|
||||
| skill:skills/paperclip/references/routines.md:catch-up-policies:76 | optional_agent_tool | skills/paperclip/references/routines.md:76 |
|
||||
| skill:skills/paperclip/references/routines.md:activity-gated-scheduled-runs:87 | optional_agent_tool | skills/paperclip/references/routines.md:87 |
|
||||
| skill:skills/paperclip/references/routines.md:example-skip-quiet-nights:107 | optional_agent_tool | skills/paperclip/references/routines.md:107 |
|
||||
| skill:skills/paperclip/references/routines.md:adding-triggers:126 | optional_agent_tool | skills/paperclip/references/routines.md:126 |
|
||||
| skill:skills/paperclip/references/routines.md:schedule-cron:136 | optional_agent_tool | skills/paperclip/references/routines.md:136 |
|
||||
| skill:skills/paperclip/references/routines.md:webhook:150 | optional_agent_tool | skills/paperclip/references/routines.md:150 |
|
||||
| skill:skills/paperclip/references/routines.md:api-manual-only:167 | optional_agent_tool | skills/paperclip/references/routines.md:167 |
|
||||
| skill:skills/paperclip/references/routines.md:updating-and-deleting-triggers:179 | optional_agent_tool | skills/paperclip/references/routines.md:179 |
|
||||
| skill:skills/paperclip/references/routines.md:manual-run:196 | optional_agent_tool | skills/paperclip/references/routines.md:196 |
|
||||
| skill:skills/paperclip/references/routines.md:updating-a-routine:212 | optional_agent_tool | skills/paperclip/references/routines.md:212 |
|
||||
| skill:skills/paperclip/references/routines.md:reading-routines-and-runs:223 | optional_agent_tool | skills/paperclip/references/routines.md:223 |
|
||||
| skill:skills/paperclip/references/routines.md:lifecycle:18 | optional_agent_tool | skills/paperclip/references/routines.md:18 |
|
||||
| skill:skills/paperclip/references/routines.md:creating-a-routine:29 | optional_agent_tool | skills/paperclip/references/routines.md:29 |
|
||||
| skill:skills/paperclip/references/routines.md:concurrency-policies:66 | optional_agent_tool | skills/paperclip/references/routines.md:66 |
|
||||
| skill:skills/paperclip/references/routines.md:catch-up-policies:78 | optional_agent_tool | skills/paperclip/references/routines.md:78 |
|
||||
| skill:skills/paperclip/references/routines.md:activity-gated-scheduled-runs:89 | optional_agent_tool | skills/paperclip/references/routines.md:89 |
|
||||
| skill:skills/paperclip/references/routines.md:example-skip-quiet-nights:109 | optional_agent_tool | skills/paperclip/references/routines.md:109 |
|
||||
| skill:skills/paperclip/references/routines.md:adding-triggers:128 | optional_agent_tool | skills/paperclip/references/routines.md:128 |
|
||||
| skill:skills/paperclip/references/routines.md:schedule-cron:138 | optional_agent_tool | skills/paperclip/references/routines.md:138 |
|
||||
| skill:skills/paperclip/references/routines.md:webhook:152 | optional_agent_tool | skills/paperclip/references/routines.md:152 |
|
||||
| skill:skills/paperclip/references/routines.md:api-manual-only:169 | optional_agent_tool | skills/paperclip/references/routines.md:169 |
|
||||
| skill:skills/paperclip/references/routines.md:updating-and-deleting-triggers:181 | optional_agent_tool | skills/paperclip/references/routines.md:181 |
|
||||
| skill:skills/paperclip/references/routines.md:manual-run:198 | optional_agent_tool | skills/paperclip/references/routines.md:198 |
|
||||
| skill:skills/paperclip/references/routines.md:updating-a-routine:214 | optional_agent_tool | skills/paperclip/references/routines.md:214 |
|
||||
| skill:skills/paperclip/references/routines.md:reading-routines-and-runs:225 | optional_agent_tool | skills/paperclip/references/routines.md:225 |
|
||||
| skill:skills/paperclip/references/workflows.md:paperclip-workflow-playbooks:1 | optional_agent_tool | skills/paperclip/references/workflows.md:1 |
|
||||
| skill:skills/paperclip/references/workflows.md:project-setup-ceo-manager:7 | optional_agent_tool | skills/paperclip/references/workflows.md:7 |
|
||||
| skill:skills/paperclip/references/workflows.md:openclaw-invite-ceo:22 | optional_agent_tool | skills/paperclip/references/workflows.md:22 |
|
||||
|
||||
@@ -83,270 +83,270 @@
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:293",
|
||||
"id": "skill:skills/paperclip/SKILL.md:294",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L293:propose-a-bar-in-a-bar-conversation",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L294:propose-a-bar-in-a-bar-conversation",
|
||||
"heading": "Propose a bar in a bar conversation",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:297",
|
||||
"id": "skill:skills/paperclip/SKILL.md:298",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L297:propose-an-automation-in-an-automation-conversation",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L298:propose-an-automation-in-an-automation-conversation",
|
||||
"heading": "Propose an automation in an automation conversation",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:301",
|
||||
"id": "skill:skills/paperclip/SKILL.md:302",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L301:write-a-responsibility-s-status",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L302:write-a-responsibility-s-status",
|
||||
"heading": "Write a responsibility's status",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:307",
|
||||
"id": "skill:skills/paperclip/SKILL.md:308",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L307:status-quick-guide",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L308:status-quick-guide",
|
||||
"heading": "Status Quick Guide",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:317",
|
||||
"id": "skill:skills/paperclip/SKILL.md:318",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L317:monitors-and-watchers-say-only-what-you-actually-scheduled",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L318:monitors-and-watchers-say-only-what-you-actually-scheduled",
|
||||
"heading": "Monitors and Watchers (say only what you actually scheduled)",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:338",
|
||||
"id": "skill:skills/paperclip/SKILL.md:339",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L338:delegating-review-tasks",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L339:delegating-review-tasks",
|
||||
"heading": "Delegating review tasks",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:349",
|
||||
"id": "skill:skills/paperclip/SKILL.md:350",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L349:managing-a-user-s-inbox",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L350:managing-a-user-s-inbox",
|
||||
"heading": "Managing A User's Inbox",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:357",
|
||||
"id": "skill:skills/paperclip/SKILL.md:358",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L357:issue-dependencies-blockers",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L358:issue-dependencies-blockers",
|
||||
"heading": "Issue Dependencies (Blockers)",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:382",
|
||||
"id": "skill:skills/paperclip/SKILL.md:383",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L382:requesting-board-approval",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L383:requesting-board-approval",
|
||||
"heading": "Requesting Board Approval",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:403",
|
||||
"id": "skill:skills/paperclip/SKILL.md:404",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L403:issue-thread-interactions",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L404:issue-thread-interactions",
|
||||
"heading": "Issue-Thread Interactions",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
"semanticOperation": "request_human_input",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:433",
|
||||
"id": "skill:skills/paperclip/SKILL.md:434",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L433:standalone-decisions",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L434:standalone-decisions",
|
||||
"heading": "Standalone Decisions",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:537",
|
||||
"id": "skill:skills/paperclip/SKILL.md:538",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L537:mcp-tool-approval-gates",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L538:mcp-tool-approval-gates",
|
||||
"heading": "MCP Tool Approval Gates",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:579",
|
||||
"id": "skill:skills/paperclip/SKILL.md:580",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L579:niche-workflow-pointers",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L580:niche-workflow-pointers",
|
||||
"heading": "Niche Workflow Pointers",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:589",
|
||||
"id": "skill:skills/paperclip/SKILL.md:590",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L589:cases",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L590:cases",
|
||||
"heading": "Cases",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:594",
|
||||
"id": "skill:skills/paperclip/SKILL.md:595",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L594:company-skills-workflow",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L595:company-skills-workflow",
|
||||
"heading": "Company Skills Workflow",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:605",
|
||||
"id": "skill:skills/paperclip/SKILL.md:606",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L605:routines",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L606:routines",
|
||||
"heading": "Routines",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:617",
|
||||
"id": "skill:skills/paperclip/SKILL.md:618",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L617:task-files-and-workspace-choices",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L618:task-files-and-workspace-choices",
|
||||
"heading": "Task Files and Workspace Choices",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:625",
|
||||
"id": "skill:skills/paperclip/SKILL.md:626",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L625:issue-workspace-runtime-controls",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L626:issue-workspace-runtime-controls",
|
||||
"heading": "Issue Workspace Runtime Controls",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:632",
|
||||
"id": "skill:skills/paperclip/SKILL.md:633",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L632:proposing-credentials-safely",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L633:proposing-credentials-safely",
|
||||
"heading": "Proposing Credentials Safely",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:639",
|
||||
"id": "skill:skills/paperclip/SKILL.md:640",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L639:reading-granted-secrets",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L640:reading-granted-secrets",
|
||||
"heading": "Reading Granted Secrets",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:665",
|
||||
"id": "skill:skills/paperclip/SKILL.md:666",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L665:critical-rules",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L666:critical-rules",
|
||||
"heading": "Critical Rules",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:686",
|
||||
"id": "skill:skills/paperclip/SKILL.md:687",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L686:comment-style-required",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L687:comment-style-required",
|
||||
"heading": "Comment Style (Required)",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
"semanticOperation": "report_progress",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:722",
|
||||
"id": "skill:skills/paperclip/SKILL.md:723",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L722:update",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L723:update",
|
||||
"heading": "Update",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:732",
|
||||
"id": "skill:skills/paperclip/SKILL.md:733",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L732:task-documents-and-deliverables",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L733:task-documents-and-deliverables",
|
||||
"heading": "Task Documents and Deliverables",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
"semanticOperation": "write_document",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:746",
|
||||
"id": "skill:skills/paperclip/SKILL.md:747",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L746:planning-required-when-planning-requested",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L747:planning-required-when-planning-requested",
|
||||
"heading": "Planning (Required when planning requested)",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
"semanticOperation": "write_document",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:777",
|
||||
"id": "skill:skills/paperclip/SKILL.md:778",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L777:key-endpoints-hot-routes",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L778:key-endpoints-hot-routes",
|
||||
"heading": "Key Endpoints (Hot Routes)",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:807",
|
||||
"id": "skill:skills/paperclip/SKILL.md:808",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L807:searching-issues",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L808:searching-issues",
|
||||
"heading": "Searching Issues",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:817",
|
||||
"id": "skill:skills/paperclip/SKILL.md:818",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L817:full-reference",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L818:full-reference",
|
||||
"heading": "Full Reference",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:821",
|
||||
"id": "skill:skills/paperclip/SKILL.md:822",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L821:conversational-confirmation-answers",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L822:conversational-confirmation-answers",
|
||||
"heading": "Conversational confirmation answers",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
"semanticOperation": "call_api",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:838",
|
||||
"id": "skill:skills/paperclip/SKILL.md:839",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L838:incidental-feedback",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md#L839:incidental-feedback",
|
||||
"heading": "Incidental feedback",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
@@ -1415,126 +1415,126 @@
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:16",
|
||||
"id": "skill:skills/paperclip/references/routines.md:18",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L16:lifecycle",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L18:lifecycle",
|
||||
"heading": "Lifecycle",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:27",
|
||||
"id": "skill:skills/paperclip/references/routines.md:29",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L27:creating-a-routine",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L29:creating-a-routine",
|
||||
"heading": "Creating a Routine",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:64",
|
||||
"id": "skill:skills/paperclip/references/routines.md:66",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L64:concurrency-policies",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L66:concurrency-policies",
|
||||
"heading": "Concurrency Policies",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:76",
|
||||
"id": "skill:skills/paperclip/references/routines.md:78",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L76:catch-up-policies",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L78:catch-up-policies",
|
||||
"heading": "Catch-Up Policies",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:87",
|
||||
"id": "skill:skills/paperclip/references/routines.md:89",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L87:activity-gated-scheduled-runs",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L89:activity-gated-scheduled-runs",
|
||||
"heading": "Activity-Gated Scheduled Runs",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:107",
|
||||
"id": "skill:skills/paperclip/references/routines.md:109",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L107:example-skip-quiet-nights",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L109:example-skip-quiet-nights",
|
||||
"heading": "Example: skip quiet nights",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:126",
|
||||
"id": "skill:skills/paperclip/references/routines.md:128",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L126:adding-triggers",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L128:adding-triggers",
|
||||
"heading": "Adding Triggers",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:136",
|
||||
"id": "skill:skills/paperclip/references/routines.md:138",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L136:schedule-cron",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L138:schedule-cron",
|
||||
"heading": "Schedule (cron)",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:150",
|
||||
"id": "skill:skills/paperclip/references/routines.md:152",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L150:webhook",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L152:webhook",
|
||||
"heading": "Webhook",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:167",
|
||||
"id": "skill:skills/paperclip/references/routines.md:169",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L167:api-manual-only",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L169:api-manual-only",
|
||||
"heading": "API (manual only)",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:179",
|
||||
"id": "skill:skills/paperclip/references/routines.md:181",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L179:updating-and-deleting-triggers",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L181:updating-and-deleting-triggers",
|
||||
"heading": "Updating and Deleting Triggers",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:196",
|
||||
"id": "skill:skills/paperclip/references/routines.md:198",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L196:manual-run",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L198:manual-run",
|
||||
"heading": "Manual Run",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
"semanticOperation": "runtime_reconciliation",
|
||||
"expectedMockState": "runtime_decision_record"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:212",
|
||||
"id": "skill:skills/paperclip/references/routines.md:214",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L212:updating-a-routine",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L214:updating-a-routine",
|
||||
"heading": "Updating a Routine",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
"expectedMockState": "operation_result"
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:223",
|
||||
"id": "skill:skills/paperclip/references/routines.md:225",
|
||||
"kind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L223:reading-routines-and-runs",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md#L225:reading-routines-and-runs",
|
||||
"heading": "Reading Routines and Runs",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
"semanticOperation": "scoped_discovery",
|
||||
|
||||
@@ -5,6 +5,6 @@ Generated by `scripts/generate-capability-contract.mjs`; do not edit generated f
|
||||
- Skill/reference headings: 177
|
||||
- Legacy MCP tools: 42
|
||||
- Eval cases: 106 across 16 groups
|
||||
- Deterministic content SHA-256: `c1a6851834fcc32068729a2fc8310ad2a6713031778038d5bdcd9ade32d81fa3`
|
||||
- Deterministic content SHA-256: `dd7574b1a482ef12d5c5adc4cd038efb95b278e6c5f66520b8fa3151808ae35f`
|
||||
|
||||
Every row has exactly one primary disposition, a source anchor, a semantic operation, and a mock-state expectation.
|
||||
@@ -1 +1 @@
|
||||
[{"annotations":{"exposure":"always","operationId":"get_task_context","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read the active task and actor, including the exact approved Markdown revision when this issue has an accepted plan.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"get_task_context","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"get_task_history","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read bounded comments on the active task only. Calling get_task does not change the active task. This is not a status or assignment audit. For progress chronology and handoff actors, use search_api to discover the company timeline or issue activity, then call_api.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},"required":[],"type":"object"},"name":"get_task_history","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"list_documents","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"List revisioned documents on the active task.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_documents","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"read_document","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read the current revision of one active-task document.","inputSchema":{"additionalProperties":false,"properties":{"key":{"description":"Stable document identifier, not a filename or path (for example reconciliation, not reconciliation.md). After trimming whitespace and lowercasing: 1–64 characters, starting with a letter or digit and containing only a–z, 0–9, _ or -. The raw input is limited to 120 characters.","maxLength":120,"minLength":1,"pattern":"^[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*[A-Za-z0-9\\u212a][A-Za-z0-9_\\u212a-]{0,63}[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*$","type":"string"}},"required":["key"],"type":"object"},"name":"read_document","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"list_document_revisions","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read bounded revision history for one active-task document.","inputSchema":{"additionalProperties":false,"properties":{"key":{"description":"Stable document identifier, not a filename or path (for example reconciliation, not reconciliation.md). After trimming whitespace and lowercasing: 1–64 characters, starting with a letter or digit and containing only a–z, 0–9, _ or -. The raw input is limited to 120 characters.","maxLength":120,"minLength":1,"pattern":"^[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*[A-Za-z0-9\\u212a][A-Za-z0-9_\\u212a-]{0,63}[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*$","type":"string"},"limit":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},"required":["key"],"type":"object"},"name":"list_document_revisions","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"report_progress","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Append a durable progress comment to the active task.","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"},"name":"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"}},{"annotations":{"exposure":"always","operationId":"answer_status_question","requiredClaims":[],"semanticContract":"paperclip.Line truncated
|
||||
[{"annotations":{"exposure":"always","operationId":"get_task_context","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read the active task and actor, including the exact approved Markdown revision when this issue has an accepted plan.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"get_task_context","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"get_task_history","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read bounded comments on the active task only. Calling get_task does not change the active task. This is not a status or assignment audit. For progress chronology and handoff actors, use search_api to discover the company timeline or issue activity, then call_api.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},"required":[],"type":"object"},"name":"get_task_history","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"list_documents","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"List revisioned documents on the active task.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_documents","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"read_document","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read the current revision of one active-task document.","inputSchema":{"additionalProperties":false,"properties":{"key":{"description":"Stable document identifier, not a filename or path (for example reconciliation, not reconciliation.md). After trimming whitespace and lowercasing: 1–64 characters, starting with a letter or digit and containing only a–z, 0–9, _ or -. The raw input is limited to 120 characters.","maxLength":120,"minLength":1,"pattern":"^[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*[A-Za-z0-9\\u212a][A-Za-z0-9_\\u212a-]{0,63}[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*$","type":"string"}},"required":["key"],"type":"object"},"name":"read_document","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"list_document_revisions","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Read bounded revision history for one active-task document.","inputSchema":{"additionalProperties":false,"properties":{"key":{"description":"Stable document identifier, not a filename or path (for example reconciliation, not reconciliation.md). After trimming whitespace and lowercasing: 1–64 characters, starting with a letter or digit and containing only a–z, 0–9, _ or -. The raw input is limited to 120 characters.","maxLength":120,"minLength":1,"pattern":"^[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*[A-Za-z0-9\\u212a][A-Za-z0-9_\\u212a-]{0,63}[\\u0009-\\u000d\\u0020\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff]*$","type":"string"},"limit":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},"required":["key"],"type":"object"},"name":"list_document_revisions","outputSchema":{"additionalProperties":true,"type":"object"}},{"annotations":{"exposure":"always","operationId":"report_progress","requiredClaims":[],"semanticContract":"paperclip.semantic-tool.v1","version":1},"description":"Append a durable progress comment to the active task.","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"},"name":"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"}},{"annotations":{"exposure":"always","operationId":"answer_status_question","requiredClaims":[],"semanticContract":"paperclip.Line truncated
|
||||
@@ -3656,6 +3656,213 @@
|
||||
"title": "Remove work from responsibility",
|
||||
"version": 1
|
||||
},
|
||||
{
|
||||
"allowedModes": [
|
||||
"standard",
|
||||
"ask",
|
||||
"planning",
|
||||
"skill_test"
|
||||
],
|
||||
"description": "List the company's routines (recurring work an agent runs on a schedule, webhook or request) with their agent, project, responsible person, schedules and last run. Filter by words, status, agent, project, person, a responsibility, or unfiled for routines under no responsibility; every filter applies before the limit.",
|
||||
"effect": "read",
|
||||
"inputSchema": {
|
||||
"additionalProperties": false,
|
||||
"properties": {
|
||||
"assigneeAgentId": {
|
||||
"description": "Only routines this agent runs.",
|
||||
"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": "Default 50.",
|
||||
"maximum": 200,
|
||||
"minimum": 1,
|
||||
"type": "integer"
|
||||
},
|
||||
"projectId": {
|
||||
"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"
|
||||
},
|
||||
"query": {
|
||||
"description": "Words in the title or instructions.",
|
||||
"maxLength": 200,
|
||||
"minLength": 1,
|
||||
"type": "string"
|
||||
},
|
||||
"responsibilityId": {
|
||||
"description": "Only routines under this responsibility, filed directly or through its project. Needs Responsibilities on.",
|
||||
"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"
|
||||
},
|
||||
"responsibleUserId": {
|
||||
"description": "Only routines this person is responsible for.",
|
||||
"maxLength": 200,
|
||||
"minLength": 1,
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"enum": [
|
||||
"active",
|
||||
"paused",
|
||||
"archived"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"unfiled": {
|
||||
"description": "Only routines filed under no proposed or active responsibility, directly or through their project. Combine with status, such as active. Needs Responsibilities on.",
|
||||
"type": "boolean"
|
||||
}
|
||||
},
|
||||
"required": [],
|
||||
"type": "object"
|
||||
},
|
||||
"operationId": "list_routines",
|
||||
"outputSchema": {
|
||||
"additionalProperties": true,
|
||||
"type": "object"
|
||||
},
|
||||
"placement": "optional",
|
||||
"requiredClaims": [
|
||||
"routines:read"
|
||||
],
|
||||
"schema": "paperclip.semantic-action.v1",
|
||||
"title": "List routines",
|
||||
"version": 1
|
||||
},
|
||||
{
|
||||
"allowedModes": [
|
||||
"standard"
|
||||
],
|
||||
"description": "Change a routine: its title, instructions, agent, project, status (active, paused, archived) or priority; set its schedule in plain terms (no cron), or null to turn its schedule off; and file it under a responsibility. You may change your own routines, and those the person who directed your run (their own chat or task, or their message woke you) is responsible for; on a routine you do not run, changing its agent, turning it on or changing its schedule needs that person to be allowed to assign work. The routine and its schedule change together as one routine revision the person can restore from the routine's history; filing is saved separately in their Dashboard history (see filedUnder.undo).",
|
||||
"effect": "write",
|
||||
"inputSchema": {
|
||||
"additionalProperties": false,
|
||||
"properties": {
|
||||
"assigneeAgentId": {
|
||||
"description": "The agent that runs it.",
|
||||
"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",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"fileUnder": {
|
||||
"description": "A responsibility ID to file the routine under.",
|
||||
"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"
|
||||
},
|
||||
"instructions": {
|
||||
"description": "What each run should do, written out in full.",
|
||||
"maxLength": 200000,
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"priority": {
|
||||
"enum": [
|
||||
"critical",
|
||||
"high",
|
||||
"medium",
|
||||
"low"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"projectId": {
|
||||
"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",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"routineId": {
|
||||
"description": "Routine ID from list_routines.",
|
||||
"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"
|
||||
},
|
||||
"schedule": {
|
||||
"additionalProperties": false,
|
||||
"description": "When it runs, in the person's local time. null turns its schedule off.",
|
||||
"properties": {
|
||||
"dayOfMonth": {
|
||||
"description": "For monthly.",
|
||||
"maximum": 28,
|
||||
"minimum": 1,
|
||||
"type": "integer"
|
||||
},
|
||||
"dayOfWeek": {
|
||||
"description": "For weekly.",
|
||||
"enum": [
|
||||
"monday",
|
||||
"tuesday",
|
||||
"wednesday",
|
||||
"thursday",
|
||||
"friday",
|
||||
"saturday",
|
||||
"sunday"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"frequency": {
|
||||
"enum": [
|
||||
"daily",
|
||||
"weekdays",
|
||||
"weekly",
|
||||
"monthly"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"time": {
|
||||
"description": "24-hour HH:MM.",
|
||||
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
|
||||
"type": "string"
|
||||
},
|
||||
"timezone": {
|
||||
"description": "IANA zone such as Europe/Berlin. Default: the routine's current schedule zone, else the person's own time zone.",
|
||||
"maxLength": 100,
|
||||
"minLength": 1,
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"frequency",
|
||||
"time"
|
||||
],
|
||||
"type": [
|
||||
"object",
|
||||
"null"
|
||||
]
|
||||
},
|
||||
"status": {
|
||||
"enum": [
|
||||
"active",
|
||||
"paused",
|
||||
"archived"
|
||||
],
|
||||
"type": "string"
|
||||
},
|
||||
"title": {
|
||||
"maxLength": 200,
|
||||
"minLength": 1,
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"routineId"
|
||||
],
|
||||
"type": "object"
|
||||
},
|
||||
"operationId": "update_routine",
|
||||
"outputSchema": {
|
||||
"additionalProperties": true,
|
||||
"type": "object"
|
||||
},
|
||||
"placement": "optional",
|
||||
"requiredClaims": [],
|
||||
"schema": "paperclip.semantic-action.v1",
|
||||
"title": "Update routine",
|
||||
"version": 1
|
||||
},
|
||||
{
|
||||
"allowedModes": [
|
||||
"standard",
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
"prpVersion": 1,
|
||||
"nativeExecutionVersion": 1,
|
||||
"catalogVersion": 1,
|
||||
"catalogSha256": "sha256:07b66fcf0101d7a7addc5319fee46b89405bc5ca4104f6c519a8deeb286f97a6",
|
||||
"catalogSha256": "sha256:93905f19b7e648e8f3326dd86bb8007105a31ce6cd20b2f1f7b2d926f1f2a1b5",
|
||||
"driverContractVersion": 1,
|
||||
"driverKind": "paperclip-deterministic",
|
||||
"driverVersion": "1.0.0"
|
||||
|
||||
@@ -190,7 +190,7 @@
|
||||
},
|
||||
{
|
||||
"path": "fixtures/evals/native-execution-seeded.json",
|
||||
"sha256": "a015d66b9075def305c189c35e920d84141830b89c17dbbd8d331f53c9a09b86",
|
||||
"sha256": "edac8c5ff3a97674e92455d7abf983efd57ee7abc71e2a659b72f7063f96565a",
|
||||
"expectation": "accept",
|
||||
"compatibilityCase": "canonical"
|
||||
},
|
||||
|
||||
@@ -150,9 +150,9 @@
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:propose-a-bar-in-a-bar-conversation:293",
|
||||
"id": "skill:skills/paperclip/SKILL.md:propose-a-bar-in-a-bar-conversation:294",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:293",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:294",
|
||||
"title": "Propose a bar in a bar conversation",
|
||||
"expectedSemantics": "Skill guidance headed “Propose a bar in a bar conversation”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -161,13 +161,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:293"
|
||||
"skill:skills/paperclip/SKILL.md:294"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:propose-an-automation-in-an-automation-conversation:297",
|
||||
"id": "skill:skills/paperclip/SKILL.md:propose-an-automation-in-an-automation-conversation:298",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:297",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:298",
|
||||
"title": "Propose an automation in an automation conversation",
|
||||
"expectedSemantics": "Skill guidance headed “Propose an automation in an automation conversation”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -176,13 +176,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:297"
|
||||
"skill:skills/paperclip/SKILL.md:298"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:write-a-responsibility-s-status:301",
|
||||
"id": "skill:skills/paperclip/SKILL.md:write-a-responsibility-s-status:302",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:301",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:302",
|
||||
"title": "Write a responsibility's status",
|
||||
"expectedSemantics": "Skill guidance headed “Write a responsibility's status”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -191,13 +191,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:301"
|
||||
"skill:skills/paperclip/SKILL.md:302"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:status-quick-guide:307",
|
||||
"id": "skill:skills/paperclip/SKILL.md:status-quick-guide:308",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:307",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:308",
|
||||
"title": "Status Quick Guide",
|
||||
"expectedSemantics": "Skill guidance headed “Status Quick Guide”.",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
@@ -206,13 +206,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:307"
|
||||
"skill:skills/paperclip/SKILL.md:308"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:317",
|
||||
"id": "skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:318",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:317",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:318",
|
||||
"title": "Monitors and Watchers (say only what you actually scheduled)",
|
||||
"expectedSemantics": "Skill guidance headed “Monitors and Watchers (say only what you actually scheduled)”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -221,13 +221,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:317"
|
||||
"skill:skills/paperclip/SKILL.md:318"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:delegating-review-tasks:338",
|
||||
"id": "skill:skills/paperclip/SKILL.md:delegating-review-tasks:339",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:338",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:339",
|
||||
"title": "Delegating review tasks",
|
||||
"expectedSemantics": "Skill guidance headed “Delegating review tasks”.",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
@@ -236,13 +236,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:338"
|
||||
"skill:skills/paperclip/SKILL.md:339"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:349",
|
||||
"id": "skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:350",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:349",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:350",
|
||||
"title": "Managing A User's Inbox",
|
||||
"expectedSemantics": "Skill guidance headed “Managing A User's Inbox”.",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
@@ -251,13 +251,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:349"
|
||||
"skill:skills/paperclip/SKILL.md:350"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:357",
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:358",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:357",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:358",
|
||||
"title": "Issue Dependencies (Blockers)",
|
||||
"expectedSemantics": "Skill guidance headed “Issue Dependencies (Blockers)”.",
|
||||
"primaryDisposition": "control_plane_owned",
|
||||
@@ -266,13 +266,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:357"
|
||||
"skill:skills/paperclip/SKILL.md:358"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:requesting-board-approval:382",
|
||||
"id": "skill:skills/paperclip/SKILL.md:requesting-board-approval:383",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:382",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:383",
|
||||
"title": "Requesting Board Approval",
|
||||
"expectedSemantics": "Skill guidance headed “Requesting Board Approval”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -281,13 +281,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:382"
|
||||
"skill:skills/paperclip/SKILL.md:383"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-thread-interactions:403",
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-thread-interactions:404",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:403",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:404",
|
||||
"title": "Issue-Thread Interactions",
|
||||
"expectedSemantics": "Skill guidance headed “Issue-Thread Interactions”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -296,13 +296,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:403"
|
||||
"skill:skills/paperclip/SKILL.md:404"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:standalone-decisions:433",
|
||||
"id": "skill:skills/paperclip/SKILL.md:standalone-decisions:434",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:433",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:434",
|
||||
"title": "Standalone Decisions",
|
||||
"expectedSemantics": "Skill guidance headed “Standalone Decisions”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -311,13 +311,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:433"
|
||||
"skill:skills/paperclip/SKILL.md:434"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:537",
|
||||
"id": "skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:538",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:537",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:538",
|
||||
"title": "MCP Tool Approval Gates",
|
||||
"expectedSemantics": "Skill guidance headed “MCP Tool Approval Gates”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -326,13 +326,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:537"
|
||||
"skill:skills/paperclip/SKILL.md:538"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:niche-workflow-pointers:579",
|
||||
"id": "skill:skills/paperclip/SKILL.md:niche-workflow-pointers:580",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:579",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:580",
|
||||
"title": "Niche Workflow Pointers",
|
||||
"expectedSemantics": "Skill guidance headed “Niche Workflow Pointers”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -341,13 +341,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:579"
|
||||
"skill:skills/paperclip/SKILL.md:580"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:cases:589",
|
||||
"id": "skill:skills/paperclip/SKILL.md:cases:590",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:589",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:590",
|
||||
"title": "Cases",
|
||||
"expectedSemantics": "Skill guidance headed “Cases”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -356,13 +356,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:589"
|
||||
"skill:skills/paperclip/SKILL.md:590"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:company-skills-workflow:594",
|
||||
"id": "skill:skills/paperclip/SKILL.md:company-skills-workflow:595",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:594",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:595",
|
||||
"title": "Company Skills Workflow",
|
||||
"expectedSemantics": "Skill guidance headed “Company Skills Workflow”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -371,13 +371,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:594"
|
||||
"skill:skills/paperclip/SKILL.md:595"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:routines:605",
|
||||
"id": "skill:skills/paperclip/SKILL.md:routines:606",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:605",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:606",
|
||||
"title": "Routines",
|
||||
"expectedSemantics": "Skill guidance headed “Routines”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -386,13 +386,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:605"
|
||||
"skill:skills/paperclip/SKILL.md:606"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:task-files-and-workspace-choices:617",
|
||||
"id": "skill:skills/paperclip/SKILL.md:task-files-and-workspace-choices:618",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:617",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:618",
|
||||
"title": "Task Files and Workspace Choices",
|
||||
"expectedSemantics": "Skill guidance headed “Task Files and Workspace Choices”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -401,13 +401,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:617"
|
||||
"skill:skills/paperclip/SKILL.md:618"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:625",
|
||||
"id": "skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:626",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:625",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:626",
|
||||
"title": "Issue Workspace Runtime Controls",
|
||||
"expectedSemantics": "Skill guidance headed “Issue Workspace Runtime Controls”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -416,13 +416,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:625"
|
||||
"skill:skills/paperclip/SKILL.md:626"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:proposing-credentials-safely:632",
|
||||
"id": "skill:skills/paperclip/SKILL.md:proposing-credentials-safely:633",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:632",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:633",
|
||||
"title": "Proposing Credentials Safely",
|
||||
"expectedSemantics": "Skill guidance headed “Proposing Credentials Safely”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -431,13 +431,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:632"
|
||||
"skill:skills/paperclip/SKILL.md:633"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:reading-granted-secrets:639",
|
||||
"id": "skill:skills/paperclip/SKILL.md:reading-granted-secrets:640",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:639",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:640",
|
||||
"title": "Reading Granted Secrets",
|
||||
"expectedSemantics": "Skill guidance headed “Reading Granted Secrets”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -446,13 +446,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:639"
|
||||
"skill:skills/paperclip/SKILL.md:640"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:critical-rules:665",
|
||||
"id": "skill:skills/paperclip/SKILL.md:critical-rules:666",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:665",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:666",
|
||||
"title": "Critical Rules",
|
||||
"expectedSemantics": "Skill guidance headed “Critical Rules”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -461,13 +461,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:665"
|
||||
"skill:skills/paperclip/SKILL.md:666"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:comment-style-required:686",
|
||||
"id": "skill:skills/paperclip/SKILL.md:comment-style-required:687",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:686",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:687",
|
||||
"title": "Comment Style (Required)",
|
||||
"expectedSemantics": "Skill guidance headed “Comment Style (Required)”.",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
@@ -476,13 +476,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:686"
|
||||
"skill:skills/paperclip/SKILL.md:687"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:update:722",
|
||||
"id": "skill:skills/paperclip/SKILL.md:update:723",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:722",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:723",
|
||||
"title": "Update",
|
||||
"expectedSemantics": "Skill guidance headed “Update”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -491,13 +491,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:722"
|
||||
"skill:skills/paperclip/SKILL.md:723"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:task-documents-and-deliverables:732",
|
||||
"id": "skill:skills/paperclip/SKILL.md:task-documents-and-deliverables:733",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:732",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:733",
|
||||
"title": "Task Documents and Deliverables",
|
||||
"expectedSemantics": "Skill guidance headed “Task Documents and Deliverables”.",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
@@ -506,13 +506,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:732"
|
||||
"skill:skills/paperclip/SKILL.md:733"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:746",
|
||||
"id": "skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:747",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:746",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:747",
|
||||
"title": "Planning (Required when planning requested)",
|
||||
"expectedSemantics": "Skill guidance headed “Planning (Required when planning requested)”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -521,13 +521,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:746"
|
||||
"skill:skills/paperclip/SKILL.md:747"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:777",
|
||||
"id": "skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:778",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:777",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:778",
|
||||
"title": "Key Endpoints (Hot Routes)",
|
||||
"expectedSemantics": "Skill guidance headed “Key Endpoints (Hot Routes)”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -536,13 +536,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:777"
|
||||
"skill:skills/paperclip/SKILL.md:778"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:searching-issues:807",
|
||||
"id": "skill:skills/paperclip/SKILL.md:searching-issues:808",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:807",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:808",
|
||||
"title": "Searching Issues",
|
||||
"expectedSemantics": "Skill guidance headed “Searching Issues”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -551,13 +551,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:807"
|
||||
"skill:skills/paperclip/SKILL.md:808"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:full-reference:817",
|
||||
"id": "skill:skills/paperclip/SKILL.md:full-reference:818",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:817",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:818",
|
||||
"title": "Full Reference",
|
||||
"expectedSemantics": "Skill guidance headed “Full Reference”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -566,13 +566,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:817"
|
||||
"skill:skills/paperclip/SKILL.md:818"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:821",
|
||||
"id": "skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:822",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:821",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:822",
|
||||
"title": "Conversational confirmation answers",
|
||||
"expectedSemantics": "Skill guidance headed “Conversational confirmation answers”.",
|
||||
"primaryDisposition": "always_agent_tool",
|
||||
@@ -581,13 +581,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:821"
|
||||
"skill:skills/paperclip/SKILL.md:822"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/SKILL.md:incidental-feedback:838",
|
||||
"id": "skill:skills/paperclip/SKILL.md:incidental-feedback:839",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:838",
|
||||
"sourceAnchor": "skills/paperclip/SKILL.md:839",
|
||||
"title": "Incidental feedback",
|
||||
"expectedSemantics": "Skill guidance headed “Incidental feedback”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -596,7 +596,7 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/SKILL.md:838"
|
||||
"skill:skills/paperclip/SKILL.md:839"
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -2355,9 +2355,9 @@
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:lifecycle:16",
|
||||
"id": "skill:skills/paperclip/references/routines.md:lifecycle:18",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:16",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:18",
|
||||
"title": "Lifecycle",
|
||||
"expectedSemantics": "Skill guidance headed “Lifecycle”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2366,13 +2366,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:16"
|
||||
"skill:skills/paperclip/references/routines.md:18"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:creating-a-routine:27",
|
||||
"id": "skill:skills/paperclip/references/routines.md:creating-a-routine:29",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:27",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:29",
|
||||
"title": "Creating a Routine",
|
||||
"expectedSemantics": "Skill guidance headed “Creating a Routine”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2381,13 +2381,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:27"
|
||||
"skill:skills/paperclip/references/routines.md:29"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:concurrency-policies:64",
|
||||
"id": "skill:skills/paperclip/references/routines.md:concurrency-policies:66",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:64",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:66",
|
||||
"title": "Concurrency Policies",
|
||||
"expectedSemantics": "Skill guidance headed “Concurrency Policies”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2396,13 +2396,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:64"
|
||||
"skill:skills/paperclip/references/routines.md:66"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:catch-up-policies:76",
|
||||
"id": "skill:skills/paperclip/references/routines.md:catch-up-policies:78",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:76",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:78",
|
||||
"title": "Catch-Up Policies",
|
||||
"expectedSemantics": "Skill guidance headed “Catch-Up Policies”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2411,13 +2411,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:76"
|
||||
"skill:skills/paperclip/references/routines.md:78"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:activity-gated-scheduled-runs:87",
|
||||
"id": "skill:skills/paperclip/references/routines.md:activity-gated-scheduled-runs:89",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:87",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:89",
|
||||
"title": "Activity-Gated Scheduled Runs",
|
||||
"expectedSemantics": "Skill guidance headed “Activity-Gated Scheduled Runs”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2426,13 +2426,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:87"
|
||||
"skill:skills/paperclip/references/routines.md:89"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:example-skip-quiet-nights:107",
|
||||
"id": "skill:skills/paperclip/references/routines.md:example-skip-quiet-nights:109",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:107",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:109",
|
||||
"title": "Example: skip quiet nights",
|
||||
"expectedSemantics": "Skill guidance headed “Example: skip quiet nights”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2441,13 +2441,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:107"
|
||||
"skill:skills/paperclip/references/routines.md:109"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:adding-triggers:126",
|
||||
"id": "skill:skills/paperclip/references/routines.md:adding-triggers:128",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:126",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:128",
|
||||
"title": "Adding Triggers",
|
||||
"expectedSemantics": "Skill guidance headed “Adding Triggers”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2456,13 +2456,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:126"
|
||||
"skill:skills/paperclip/references/routines.md:128"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:schedule-cron:136",
|
||||
"id": "skill:skills/paperclip/references/routines.md:schedule-cron:138",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:136",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:138",
|
||||
"title": "Schedule (cron)",
|
||||
"expectedSemantics": "Skill guidance headed “Schedule (cron)”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2471,13 +2471,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:136"
|
||||
"skill:skills/paperclip/references/routines.md:138"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:webhook:150",
|
||||
"id": "skill:skills/paperclip/references/routines.md:webhook:152",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:150",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:152",
|
||||
"title": "Webhook",
|
||||
"expectedSemantics": "Skill guidance headed “Webhook”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2486,13 +2486,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:150"
|
||||
"skill:skills/paperclip/references/routines.md:152"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:api-manual-only:167",
|
||||
"id": "skill:skills/paperclip/references/routines.md:api-manual-only:169",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:167",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:169",
|
||||
"title": "API (manual only)",
|
||||
"expectedSemantics": "Skill guidance headed “API (manual only)”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2501,13 +2501,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:167"
|
||||
"skill:skills/paperclip/references/routines.md:169"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:updating-and-deleting-triggers:179",
|
||||
"id": "skill:skills/paperclip/references/routines.md:updating-and-deleting-triggers:181",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:179",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:181",
|
||||
"title": "Updating and Deleting Triggers",
|
||||
"expectedSemantics": "Skill guidance headed “Updating and Deleting Triggers”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2516,13 +2516,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:179"
|
||||
"skill:skills/paperclip/references/routines.md:181"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:manual-run:196",
|
||||
"id": "skill:skills/paperclip/references/routines.md:manual-run:198",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:196",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:198",
|
||||
"title": "Manual Run",
|
||||
"expectedSemantics": "Skill guidance headed “Manual Run”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2531,13 +2531,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:196"
|
||||
"skill:skills/paperclip/references/routines.md:198"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:updating-a-routine:212",
|
||||
"id": "skill:skills/paperclip/references/routines.md:updating-a-routine:214",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:212",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:214",
|
||||
"title": "Updating a Routine",
|
||||
"expectedSemantics": "Skill guidance headed “Updating a Routine”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2546,13 +2546,13 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:212"
|
||||
"skill:skills/paperclip/references/routines.md:214"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "skill:skills/paperclip/references/routines.md:reading-routines-and-runs:223",
|
||||
"id": "skill:skills/paperclip/references/routines.md:reading-routines-and-runs:225",
|
||||
"sourceKind": "skill_heading",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:223",
|
||||
"sourceAnchor": "skills/paperclip/references/routines.md:225",
|
||||
"title": "Reading Routines and Runs",
|
||||
"expectedSemantics": "Skill guidance headed “Reading Routines and Runs”.",
|
||||
"primaryDisposition": "optional_agent_tool",
|
||||
@@ -2561,7 +2561,7 @@
|
||||
"control_plane_invariant"
|
||||
],
|
||||
"evidenceIds": [
|
||||
"skill:skills/paperclip/references/routines.md:223"
|
||||
"skill:skills/paperclip/references/routines.md:225"
|
||||
]
|
||||
},
|
||||
{
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
"src/scenarios/scenario-plan.ts"
|
||||
],
|
||||
"counts": {
|
||||
"actions": 81,
|
||||
"actions": 82,
|
||||
"legacyRequirements": 106
|
||||
},
|
||||
"actions": [
|
||||
@@ -545,6 +545,25 @@
|
||||
"src/scenarios/scenario-explorer.test.ts::renders every scenario with exposure, control plane, authorization, diff, and parity"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "update_routine",
|
||||
"ownership": "optional_agent_tool",
|
||||
"surfaces": [
|
||||
"live"
|
||||
],
|
||||
"legacyAliases": [],
|
||||
"contractCase": "protocol-action:update_routine",
|
||||
"contractOwner": "src/catalog/protocol-action-contracts.test.ts::update_routine has a schema-valid canonical example and every declared projection",
|
||||
"legacyBehavioralCases": [],
|
||||
"deterministicCases": [
|
||||
"protocol-action:update_routine"
|
||||
],
|
||||
"legacyRequirementCases": [],
|
||||
"deterministicOwners": [
|
||||
"src/catalog/protocol-action-contracts.test.ts::update_routine has a schema-valid canonical example and every declared projection",
|
||||
"src/scenarios/scenario-explorer.test.ts::renders every scenario with exposure, control plane, authorization, diff, and parity"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "search_api",
|
||||
"ownership": "optional_agent_tool",
|
||||
@@ -1638,7 +1657,8 @@
|
||||
"id": "list_routines",
|
||||
"ownership": "optional_agent_tool",
|
||||
"surfaces": [
|
||||
"scenario"
|
||||
"scenario",
|
||||
"live"
|
||||
],
|
||||
"legacyAliases": [],
|
||||
"contractCase": "protocol-action:list_routines",
|
||||
|
||||
@@ -151,10 +151,11 @@
|
||||
},
|
||||
{
|
||||
"id": "routines",
|
||||
"description": "Inspect or manage company routines.",
|
||||
"description": "List routines and change them (title, instructions, agent, project, status, priority, schedule, filing) through the live company/run authority; manage_routine remains a scenario mock.",
|
||||
"operationIds": [
|
||||
"list_routines",
|
||||
"manage_routine"
|
||||
"manage_routine",
|
||||
"update_routine"
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -530,6 +531,7 @@
|
||||
"update_workflow",
|
||||
"list_routines",
|
||||
"manage_routine",
|
||||
"update_routine",
|
||||
"create_skill",
|
||||
"update_skill",
|
||||
"list_company_skills",
|
||||
@@ -571,7 +573,7 @@
|
||||
"fault"
|
||||
],
|
||||
"prpEvidence": "bounded domain projections, redacted broker receipts, company diffs, and audit references",
|
||||
"gap": "Instruction read/update/history/restore require the live canonical revision service, current responsible-user permissions, and pinned base revisions for writes. Their service, authority, and product E2E tests are separate from the legacy mock scenarios. Project and skill creation and API tools require the live server authority; generic_api_request is test-only. Workflow definition tools are live-only company-scoped prompt authoring and bounded retrieval under the Cases flag. create_case, read_case and update_case are live-only authorized case creation, projections and fact mutations; list_cases and upsert_case remain scenario mocks. Other domain operations remain scenario-only. Broad administer_company is deferred and cannot claim product coverage. Production API and paired dedicated-tool regressions are recorded separately in paperclip-evals/evals/runner-api-tools; the legacy scenario count is not evidence of that coverage. Feedback actions are live-only: shared persistence, authority, API, and actual Codex smoke tests cover them; the legacy scenario count does not claim feedback coverage. Responsibility and area changes are live-only and bound to the person the run works for; the mock dispatcher does not implement them."
|
||||
"gap": "Instruction read/update/history/restore require the live canonical revision service, current responsible-user permissions, and pinned base revisions for writes. Their service, authority, and product E2E tests are separate from the legacy mock scenarios. Project and skill creation and API tools require the live server authority; generic_api_request is test-only. Workflow definition tools are live-only company-scoped prompt authoring and bounded retrieval under the Cases flag. create_case, read_case and update_case are live-only authorized case creation, projections and fact mutations; list_cases and upsert_case remain scenario mocks. list_routines and update_routine are live through the routine routes for the agent's own routines and its person's; manage_routine and other domain operations remain scenario-only. Broad administer_company is deferred and cannot claim product coverage. Production API and paired dedicated-tool regressions are recorded separately in paperclip-evals/evals/runner-api-tools; the legacy scenario count is not evidence of that coverage. Feedback actions are live-only: shared persistence, authority, API, and actual Codex smoke tests cover them; the legacy scenario count does not claim feedback coverage. Responsibility and area changes are live-only and bound to the person the run works for; the mock dispatcher does not implement them."
|
||||
},
|
||||
{
|
||||
"id": "mh",
|
||||
|
||||
@@ -6,7 +6,7 @@ Status: canonical explanatory contract for the Paperclip runner V1 surface.
|
||||
|
||||
This document keeps three independent meanings of **group** separate. PRP families describe wire evidence and controller commands; capability placement decides who owns an operation; behavioral eval groups organize the 106 scenario corpus. None of the three axes can be used as a substitute for another.
|
||||
|
||||
The generated totals are **108 PRP events in 32 event families**, **18 controller commands in 7 command families**, **10 control-plane operations**, **81 reconciled semantic operations** (19 always, 62 optional), and **106 scenarios in 16 behavior groups**.
|
||||
The generated totals are **108 PRP events in 32 event families**, **18 controller commands in 7 command families**, **10 control-plane operations**, **82 reconciled semantic operations** (19 always, 63 optional), and **106 scenarios in 16 behavior groups**.
|
||||
|
||||
## Axis 1: PRP v1 event and command families
|
||||
|
||||
@@ -88,7 +88,7 @@ Placement has exactly three outcomes:
|
||||
|
||||
`answer_status_question`, `block_task`, `finish_task`, `get_agent_instruction_history`, `get_task_context`, `get_task_history`, `inspect_operation_result`, `list_document_revisions`, `list_documents`, `read_agent_instructions`, `read_document`, `register_deliverable`, `report_progress`, `request_human_input`, `request_review`, `restore_agent_instructions`, `send_chat_message`, `update_agent_instructions`, `write_document`.
|
||||
|
||||
### Optional operations (62) and grant groups (15)
|
||||
### Optional operations (63) and grant groups (15)
|
||||
|
||||
Grant groups are documentation/exposure bundles, not additional authority. The operation descriptor's exact `requiredClaims` remains decisive.
|
||||
|
||||
@@ -103,7 +103,7 @@ Grant groups are documentation/exposure bundles, not additional authority. The o
|
||||
| `responsibilities` | `list_responsibilities`<br>`get_responsibility`<br>`find_responsibilities_for`<br>`create_area`<br>`update_area`<br>`delete_area`<br>`create_responsibility`<br>`update_responsibility`<br>`delete_responsibility`<br>`file_under_responsibility`<br>`remove_from_responsibility` | none | Read and change a person's areas and responsibilities and file work under them, through the live company/run authority. Acting for the person the run works for, an agent may do what that person could; each change is an undoable Dashboard version and a permanent delete waits for the person's confirmation card. Hidden while the instance has Responsibilities off. |
|
||||
| `workspace_runtime` | `get_workspace_runtime`<br>`control_workspace_service`<br>`get_workspace`<br>`list_workspaces`<br>`select_workspace`<br>`prepare_repository` | `workspace:control`<br>`workspace:read` | Inspect and select task workspaces, prepare repositories, and control workspace runtime services. |
|
||||
| `wake_scheduling` | `schedule_wake`<br>`set_task_monitor` | `control_plane:wakes` | Schedule a bounded continuation wake when the current task owns the future check. |
|
||||
| `routines` | `list_routines`<br>`manage_routine` | `routines:read`<br>`routines:write` | Inspect or manage company routines. |
|
||||
| `routines` | `list_routines`<br>`manage_routine`<br>`update_routine` | `routines:read`<br>`routines:write` | List routines and change them (title, instructions, agent, project, status, priority, schedule, filing) through the live company/run authority; manage_routine remains a scenario mock. |
|
||||
| `company_skills` | `create_skill`<br>`update_skill`<br>`list_company_skills`<br>`sync_company_skills` | `company_skills:read`<br>`company_skills:write` | Create, update, or inspect company skills and synchronize the current agent's skills. |
|
||||
| `secrets` | `list_secret_metadata`<br>`read_secret_value` | `secrets:metadata:read`<br>`secrets:values:read` | Inspect secret metadata or use a brokered secret value without exposing plaintext evidence. |
|
||||
| `portability_admin` | `export_company`<br>`administer_company` | `company:admin`<br>`portability:export` | Export portable company state; broad administration remains deferred until split into governed operations. |
|
||||
@@ -159,7 +159,7 @@ Grant groups are documentation/exposure bundles, not additional authority. The o
|
||||
| `list_project_repositories` | `optional_agent_tool` | none | `standard`<br>`ask`<br>`planning`<br>`skill_test` | `read` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `PaperclipRunnerToolAuthority`<br>Authenticated project tools, persisted projects and repository workspaces, and run-bound activity.<br>catalog PRP status: `bound` |
|
||||
| `list_projects` | `optional_agent_tool` | `discovery:projects:read` | `standard`<br>`ask`<br>`planning`<br>`skill_test` | `read` | `none` | no | `mock_extension:discovery.projects` | `scenario` + `live`<br>`live_codex` | `PaperclipRunnerToolAuthority`<br>Authenticated project tools, persisted projects and repository workspaces, and run-bound activity.<br>catalog PRP status: `bound` |
|
||||
| `list_responsibilities` | `optional_agent_tool` | none | `standard`<br>`ask`<br>`planning`<br>`skill_test` | `read` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `callResponsibilityTool`<br>Authenticated responsibility routes with the reader's task and project visibility.<br>catalog PRP status: `bound` |
|
||||
| `list_routines` | `optional_agent_tool` | `routines:read` | `standard`<br>`skill_test` | `read` | `none` | no | `mock_extension:routines.list` | `scenario`<br>`scenario_mock` | `unbound`<br>read projection surfaced via a tool-result item event; no control-plane state diff<br>catalog PRP status: `audit_pending` |
|
||||
| `list_routines` | `optional_agent_tool` | `routines:read` | `standard`<br>`ask`<br>`planning`<br>`skill_test` | `read` | `none` | no | `mock_extension:routines.list` | `scenario` + `live`<br>`live_codex` | `callRoutineTool`<br>Authenticated routine and responsibility routes read with the run's agent token.<br>catalog PRP status: `bound` |
|
||||
| `list_secret_metadata` | `optional_agent_tool` | `secrets:metadata:read` | `standard`<br>`skill_test` | `read` | `none` | no | `mock_extension:secrets.metadata` | `scenario`<br>`scenario_mock` | `unbound`<br>read projection surfaced via a tool-result item event; no control-plane state diff<br>catalog PRP status: `audit_pending` |
|
||||
| `list_workflows` | `optional_agent_tool` | none | `standard` | `read` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `executeNativeWorkflowTool`<br>Authorized case read projection<br>catalog PRP status: `bound` |
|
||||
| `list_workspaces` | `optional_agent_tool` | none | `standard`<br>`ask`<br>`planning`<br>`skill_test` | `read` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `PaperclipRunnerToolAuthority`<br>Authenticated task workspace routes and durable selection/repository receipts.<br>catalog PRP status: `bound` |
|
||||
@@ -193,6 +193,7 @@ Grant groups are documentation/exposure bundles, not additional authority. The o
|
||||
| `update_area` | `optional_agent_tool` | none | `standard` | `company_write` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `callResponsibilityTool`<br>Authenticated responsibility routes with run-bound activity for the person the agent works for.<br>catalog PRP status: `bound` |
|
||||
| `update_case` | `optional_agent_tool` | none | `standard` | `company_write` | `required` | no | inline/no mapping | `live`<br>`live_codex` | `executeNativeCaseTool`<br>Authorized case mutation and durable operation receipt<br>catalog PRP status: `bound` |
|
||||
| `update_responsibility` | `optional_agent_tool` | none | `standard` | `company_write` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `callResponsibilityTool`<br>Authenticated responsibility routes with run-bound activity for the person the agent works for.<br>catalog PRP status: `bound` |
|
||||
| `update_routine` | `optional_agent_tool` | none | `standard` | `company_write` | `none` | no | inline/no mapping | `live`<br>`live_codex` | `callRoutineTool`<br>Authenticated routine routes with routine revisions and run-bound activity for the person the agent works for.<br>catalog PRP status: `bound` |
|
||||
| `update_skill` | `optional_agent_tool` | none | `standard`<br>`skill_test` | `company_write` | `required` | no | `semantic_command:update_skill` | `scenario` + `live`<br>`live_codex` | `PaperclipRunnerToolAuthority`<br>Authenticated skill file API with version guard, durable receipt, and attributed activity.<br>catalog PRP status: `bound` |
|
||||
| `update_workflow` | `optional_agent_tool` | none | `standard` | `company_write` | `required` | no | inline/no mapping | `live`<br>`live_codex` | `executeNativeWorkflowTool`<br>Authorized case mutation and durable operation receipt<br>catalog PRP status: `bound` |
|
||||
| `upsert_case` | `optional_agent_tool` | `cases:write` | `standard`<br>`skill_test` | `company_write` | `required` | no | `mock_extension:cases.upsert` | `scenario`<br>`scenario_mock` | `unbound`<br>semantic-operation item event plus company-entity state diff and audit record<br>catalog PRP status: `audit_pending` |
|
||||
@@ -218,7 +219,7 @@ Behavior groups describe expected outcomes and trajectories. They do not grant t
|
||||
| [`ap` — Approvals](#behavior-group-ap-approvals) | optional governance tools + governed approver | `list_approvals`<br>`get_approval`<br>`get_approval_context`<br>`request_approval`<br>`decide_approval`<br>`comment_on_approval` | `route_wake`<br>`append_audit_record` | company approval, decision, issue-link, comment, and governed-action services | `company`<br>`task`<br>`approvals`<br>`actor`<br>`wake`<br>`audit`<br>`idempotency` | 6 | governed semantic receipts, audit references, and attention/continuation linkage | Production binding and additive governed-action receipts are unbound; board-only authority stays outside grants. |
|
||||
| [`ar` — Artifacts](#behavior-group-ar-artifacts) | always tools + artifact/work-product services | `register_deliverable` | `append_audit_record` | attachment upload and issue work-product routes | `task`<br>`artifacts`<br>`workProducts`<br>`workspace`<br>`audit`<br>`idempotency` | 4 | artifact/work-product reference and durable inspectability receipt; never binary bytes | Production upload/register composite and additive durable-reference receipt are unbound. |
|
||||
| [`er` — Errors and critical rules](#behavior-group-er-errors-and-critical-rules) | runner/control plane + optional workspace/wake tools | `get_workspace_runtime`<br>`control_workspace_service`<br>`get_workspace`<br>`list_workspaces`<br>`select_workspace`<br>`prepare_repository`<br>`schedule_wake`<br>`inspect_operation_result` | `release_task`<br>`enforce_budget`<br>`persist_run`<br>`replay_run`<br>`reconcile_run` | workspace runtime, monitor/recovery, budget, run persistence/replay, release, and terminal services | `workspace`<br>`budget`<br>`run`<br>`wake`<br>`audit`<br>`idempotency`<br>`fault` | 9 | runtime/workspace/attention/run lifecycle, typed denials, replay facts, and terminal causality | Budget stop reasons and semantic denial/conflict receipts require additive v1 envelopes; inspect_operation_result remains scenario-only. Task workspace inspection, discovery, selection and repository preparation use live authenticated service contracts; the legacy scenarios do not claim coverage for these operations. |
|
||||
| [`rf` — Reference files](#behavior-group-rf-reference-files) | always instruction tools + optional domain tools + test-only escape hatch | `list_cases`<br>`upsert_case`<br>`create_case`<br>`read_case`<br>`update_case`<br>`list_workflows`<br>`read_workflow`<br>`create_workflow`<br>`update_workflow`<br>`list_routines`<br>`manage_routine`<br>`create_skill`<br>`update_skill`<br>`list_company_skills`<br>`sync_company_skills`<br>`list_secret_metadata`<br>`read_secret_value`<br>`export_company`<br>`administer_company`<br>`generic_api_request`<br>`search_api`<br>`call_api`<br>`create_project`<br>`read_agent_instructions`<br>`update_agent_instructions`<br>`get_agent_instruction_history`<br>`restore_agent_instructions`<br>`submit_complaint`<br>`submit_suggestion`<br>`create_area`<br>`update_area`<br>`delete_area`<br>`create_responsibility`<br>`update_responsibility`<br>`delete_responsibility`<br>`file_under_responsibility`<br>`remove_from_responsibility` | `append_audit_record` | agent instruction revisions, project, case, routine, company-skill, secret, portability, and administration services, and run-attributed agent commentary; responsibility and area routes | `company`<br>`cases`<br>`routines`<br>`skills`<br>`secrets`<br>`audit`<br>`fault` | 22 | bounded domain projections, redacted broker receipts, company diffs, and audit references | Instruction read/update/history/restore require the live canonical revision service, current responsible-user permissions, and pinned base revisions for writes. Their service, authority, and product E2E tests are separate from the legacy mock scenarios. Project and skill creation and API tools require the live server authority; generic_api_request is test-only. Workflow definition tools are live-only company-scoped prompt authoring and bounded retrieval under the Cases flag. create_case, read_case and update_case are live-only authorized case creation, projections and fact mutations; list_cases and upsert_case remain scenario mocks. Other domain operations remain scenario-only. Broad administer_company is deferred and cannot claim product coverage. Production API and paired dedicated-tool regressions are recorded separately in paperclip-evals/evals/runner-api-tools; the legacy scenario count is not evidence of that coverage. Feedback actions are live-only: shared persistence, authority, API, and actual Codex smoke tests cover them; the legacy scenario count does not claim feedback coverage. Responsibility and area changes are live-only and bound to the person the run works for; the mock dispatcher does not implement them. |
|
||||
| [`rf` — Reference files](#behavior-group-rf-reference-files) | always instruction tools + optional domain tools + test-only escape hatch | `list_cases`<br>`upsert_case`<br>`create_case`<br>`read_case`<br>`update_case`<br>`list_workflows`<br>`read_workflow`<br>`create_workflow`<br>`update_workflow`<br>`list_routines`<br>`manage_routine`<br>`update_routine`<br>`create_skill`<br>`update_skill`<br>`list_company_skills`<br>`sync_company_skills`<br>`list_secret_metadata`<br>`read_secret_value`<br>`export_company`<br>`administer_company`<br>`generic_api_request`<br>`search_api`<br>`call_api`<br>`create_project`<br>`read_agent_instructions`<br>`update_agent_instructions`<br>`get_agent_instruction_history`<br>`restore_agent_instructions`<br>`submit_complaint`<br>`submit_suggestion`<br>`create_area`<br>`update_area`<br>`delete_area`<br>`create_responsibility`<br>`update_responsibility`<br>`delete_responsibility`<br>`file_under_responsibility`<br>`remove_from_responsibility` | `append_audit_record` | agent instruction revisions, project, case, routine, company-skill, secret, portability, and administration services, and run-attributed agent commentary; responsibility and area routes | `company`<br>`cases`<br>`routines`<br>`skills`<br>`secrets`<br>`audit`<br>`fault` | 22 | bounded domain projections, redacted broker receipts, company diffs, and audit references | Instruction read/update/history/restore require the live canonical revision service, current responsible-user permissions, and pinned base revisions for writes. Their service, authority, and product E2E tests are separate from the legacy mock scenarios. Project and skill creation and API tools require the live server authority; generic_api_request is test-only. Workflow definition tools are live-only company-scoped prompt authoring and bounded retrieval under the Cases flag. create_case, read_case and update_case are live-only authorized case creation, projections and fact mutations; list_cases and upsert_case remain scenario mocks. list_routines and update_routine are live through the routine routes for the agent's own routines and its person's; manage_routine and other domain operations remain scenario-only. Broad administer_company is deferred and cannot claim product coverage. Production API and paired dedicated-tool regressions are recorded separately in paperclip-evals/evals/runner-api-tools; the legacy scenario count is not evidence of that coverage. Feedback actions are live-only: shared persistence, authority, API, and actual Codex smoke tests cover them; the legacy scenario count does not claim feedback coverage. Responsibility and area changes are live-only and bound to the person the run works for; the mock dispatcher does not implement them. |
|
||||
| [`mh` — Multi-hop](#behavior-group-mh-multi-hop) | composed semantic operations + control-plane continuation | `create_task`<br>`set_dependencies`<br>`request_human_input`<br>`request_approval`<br>`register_deliverable` | `route_wake`<br>`reconcile_run` | delegation, dependency, interaction, approval, artifact, and terminal orchestration services | `task`<br>`blockers`<br>`interactions`<br>`approvals`<br>`artifacts`<br>`wake`<br>`run`<br>`audit` | 4 | correlated operation receipts, state diffs, attention hops, work assessment, status decision, and terminal outcome | No generic transaction tool is allowed; shared mock/real conformance must prove each composed effect. |
|
||||
| [`rs` — Restraint and no-call](#behavior-group-rs-restraint-and-no-call) | policy/exposure layer | `answer_status_question`<br>`read_secret_value`<br>`generic_api_request` | `enforce_budget` | task-mode, secret-broker, test-scope, pause, and budget policy checks | `actor`<br>`task`<br>`budget`<br>`secrets`<br>`audit`<br>`fault` | 3 | absence of forbidden effects plus typed policy denial/redaction receipts when a call is attempted | Typed redaction/authorization receipts need additive v1 evidence; generic_api_request is never a product fallback. |
|
||||
| [`wk` — Wake situations](#behavior-group-wk-wake-situations) | control plane + always context/history tools | `get_task_context`<br>`get_task_history`<br>`schedule_wake`<br>`set_task_monitor` | `select_work`<br>`route_wake` | wakeup requests, heartbeat context, comment/interaction/approval/blocker wake routing, and scheduled wake services | `wake`<br>`task`<br>`comments`<br>`interactions`<br>`approvals`<br>`blockers`<br>`run` | 8 | attention request routing/resolution plus resumed session/run causality | set_task_monitor binds the one-shot monitor scheduler in production; schedule_wake remains mock-backed. Control-plane routing remains non-callable. |
|
||||
@@ -495,10 +496,10 @@ Current responsibility-based paths are normative. Numbered `phase-*` or mileston
|
||||
### Catalog split and deliberate replacement
|
||||
|
||||
- Scenario/eval catalog: **40** operations.
|
||||
- Live dispatcher catalog: **69** operations.
|
||||
- Shared: **28**; union/canonical authority: **81**.
|
||||
- Scenario-only: `administer_company`, `export_company`, `inspect_operation_result`, `list_cases`, `list_company_skills`, `list_goals`, `list_routines`, `list_secret_metadata`, `manage_routine`, `read_secret_value`, `sync_company_skills`, `upsert_case`.
|
||||
- Live-only: `call_api`, `create_area`, `create_case`, `create_project`, `create_responsibility`, `create_workflow`, `delete_area`, `delete_responsibility`, `file_under_responsibility`, `find_responsibilities_for`, `get_agent`, `get_agent_instruction_history`, `get_approval`, `get_approval_context`, `get_responsibility`, `get_workspace`, `handoff_case`, `hire_agent`, `list_project_repositories`, `list_responsibilities`, `list_workflows`, `list_workspaces`, `prepare_repository`, `read_agent_instructions`, `read_case`, `read_workflow`, `remove_from_responsibility`, `restore_agent_instructions`, `schedule_wake`, `search_api`, `select_workspace`, `send_chat_message`, `set_task_monitor`, `set_task_title`, `submit_complaint`, `submit_suggestion`, `update_agent_instructions`, `update_area`, `update_case`, `update_responsibility`, `update_workflow`.
|
||||
- Live dispatcher catalog: **71** operations.
|
||||
- Shared: **29**; union/canonical authority: **82**.
|
||||
- Scenario-only: `administer_company`, `export_company`, `inspect_operation_result`, `list_cases`, `list_company_skills`, `list_goals`, `list_secret_metadata`, `manage_routine`, `read_secret_value`, `sync_company_skills`, `upsert_case`.
|
||||
- Live-only: `call_api`, `create_area`, `create_case`, `create_project`, `create_responsibility`, `create_workflow`, `delete_area`, `delete_responsibility`, `file_under_responsibility`, `find_responsibilities_for`, `get_agent`, `get_agent_instruction_history`, `get_approval`, `get_approval_context`, `get_responsibility`, `get_workspace`, `handoff_case`, `hire_agent`, `list_project_repositories`, `list_responsibilities`, `list_workflows`, `list_workspaces`, `prepare_repository`, `read_agent_instructions`, `read_case`, `read_workflow`, `remove_from_responsibility`, `restore_agent_instructions`, `schedule_wake`, `search_api`, `select_workspace`, `send_chat_message`, `set_task_monitor`, `set_task_title`, `submit_complaint`, `submit_suggestion`, `update_agent_instructions`, `update_area`, `update_case`, `update_responsibility`, `update_routine`, `update_workflow`.
|
||||
- The generated provider contract contains exactly the live catalog; the canonical union remains the migration authority until all scenario-only operations are either implemented, deferred, or removed by an explicit reconciliation decision.
|
||||
- `generic_api_request` stays exported only for controlled tests and cannot be cited as real-surface, mock-parity, or PRP product coverage.
|
||||
|
||||
|
||||
@@ -20,9 +20,9 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
it("pins the reconciled op-set relationship between the two catalogs", () => {
|
||||
const summary = capabilityCatalogReconciliation();
|
||||
expect(summary.scenarioCount).toBe(40);
|
||||
expect(summary.liveCount).toBe(69);
|
||||
expect(summary.sharedCount).toBe(28);
|
||||
expect(summary.unionCount).toBe(81);
|
||||
expect(summary.liveCount).toBe(71);
|
||||
expect(summary.sharedCount).toBe(29);
|
||||
expect(summary.unionCount).toBe(82);
|
||||
// Any operation added to or removed from either catalog without a
|
||||
// reconciliation decision changes these exact sets and fails the gate.
|
||||
expect(summary.liveOnly).toEqual([
|
||||
@@ -66,6 +66,7 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
"update_area",
|
||||
"update_case",
|
||||
"update_responsibility",
|
||||
"update_routine",
|
||||
"update_workflow",
|
||||
]);
|
||||
expect(summary.scenarioOnly).toEqual([
|
||||
@@ -75,7 +76,6 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
"list_cases",
|
||||
"list_company_skills",
|
||||
"list_goals",
|
||||
"list_routines",
|
||||
"list_secret_metadata",
|
||||
"manage_routine",
|
||||
"read_secret_value",
|
||||
@@ -85,7 +85,7 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
});
|
||||
|
||||
it("is the single source both catalogs derive their operation set from", () => {
|
||||
expect(CAPABILITY_CANONICAL_OPERATIONS).toHaveLength(81);
|
||||
expect(CAPABILITY_CANONICAL_OPERATIONS).toHaveLength(82);
|
||||
const canonicalIds = new Set(CAPABILITY_CANONICAL_OPERATIONS.map((operation) => operation.operationId));
|
||||
// Neither catalog may contain an operation absent from the canonical source.
|
||||
for (const tool of SCENARIO_CATALOG) expect(canonicalIds.has(tool.operationId)).toBe(true);
|
||||
@@ -119,7 +119,7 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
});
|
||||
|
||||
it("names placement, claims, task modes, side-effect class, idempotency, redaction, mock mapping, real binding status, and PRP evidence for every operation", () => {
|
||||
expect(CAPABILITY_CANONICAL_CATALOG).toHaveLength(81);
|
||||
expect(CAPABILITY_CANONICAL_CATALOG).toHaveLength(82);
|
||||
for (const operation of CAPABILITY_CANONICAL_CATALOG) {
|
||||
expect(operation.placement).toMatch(/^(always|optional)_agent_tool$/);
|
||||
expect(Array.isArray(operation.requiredClaims)).toBe(true);
|
||||
@@ -145,8 +145,8 @@ describe("canonical semantic-catalog reconciliation authority", () => {
|
||||
it("classifies real binding status so generic_api_request is never product coverage", () => {
|
||||
const summary = capabilityCatalogReconciliation();
|
||||
expect(summary.byRealBindingStatus).toEqual({
|
||||
live_codex: 68,
|
||||
scenario_mock: 12,
|
||||
live_codex: 70,
|
||||
scenario_mock: 11,
|
||||
test_only: 1,
|
||||
});
|
||||
expect(capabilityCanonicalOperation("generic_api_request")?.realBindingStatus).toBe("test_only");
|
||||
|
||||
@@ -10,6 +10,8 @@ import { readDocumentAction } from "../protocol-actions/read-document.js";
|
||||
import { writeDocumentAction } from "../protocol-actions/write-document.js";
|
||||
import { listDocumentRevisionsAction } from "../protocol-actions/list-document-revisions.js";
|
||||
import { handoffCaseAction } from "../protocol-actions/handoff-case.js";
|
||||
import { listRoutinesAction } from "../protocol-actions/list-routines.js";
|
||||
import { updateRoutineAction } from "../protocol-actions/update-routine.js";
|
||||
import { toolInputVariantError } from "../contracts/tool-input-variants.js";
|
||||
import type { ValidateFunction } from "ajv/dist/2020.js";
|
||||
|
||||
@@ -158,7 +160,7 @@ describe("semantic action catalog", () => {
|
||||
(action) => action.operationId,
|
||||
);
|
||||
|
||||
expect(operationIds).toHaveLength(61);
|
||||
expect(operationIds).toHaveLength(63);
|
||||
expect(operationIds).toContain("set_task_monitor");
|
||||
expect(operationIds).toContain("send_chat_message");
|
||||
expect(new Set(operationIds).size).toBe(operationIds.length);
|
||||
@@ -180,6 +182,13 @@ describe("semantic action catalog", () => {
|
||||
expect(hire?.inputSchema.properties).not.toHaveProperty("env");
|
||||
});
|
||||
|
||||
it("keeps each live action's required claims in the catalog", () => {
|
||||
for (const action of [listRoutinesAction, updateRoutineAction]) {
|
||||
expect(paperclipSemanticAction(action.id)?.requiredClaims).toEqual(action.live.descriptor.requiredClaims);
|
||||
}
|
||||
expect(paperclipSemanticAction("list_routines")?.requiredClaims).toEqual(["routines:read"]);
|
||||
});
|
||||
|
||||
it("compiles every operation input and output schema", () => {
|
||||
const ajv = new Ajv2020({
|
||||
allErrors: true,
|
||||
|
||||
@@ -12,6 +12,8 @@ import { listProjectsDescription, listProjectsInputSchema } from "../protocol-ac
|
||||
import { setTaskTitleAction } from "../protocol-actions/set-task-title.js";
|
||||
import { sendChatMessageAction } from "../protocol-actions/send-chat-message.js";
|
||||
import { reassignTaskAction } from "../protocol-actions/reassign-task.js";
|
||||
import { listRoutinesAction } from "../protocol-actions/list-routines.js";
|
||||
import { updateRoutineAction } from "../protocol-actions/update-routine.js";
|
||||
import {
|
||||
createAreaAction, createResponsibilityAction, deleteAreaAction, deleteResponsibilityAction, fileUnderResponsibilityAction,
|
||||
findResponsibilitiesForAction, getResponsibilityAction, listResponsibilitiesAction, removeFromResponsibilityAction,
|
||||
@@ -523,12 +525,14 @@ const descriptors: readonly PaperclipSemanticActionDescriptor[] = [
|
||||
createAreaAction, updateAreaAction, deleteAreaAction,
|
||||
createResponsibilityAction, updateResponsibilityAction, deleteResponsibilityAction,
|
||||
fileUnderResponsibilityAction, removeFromResponsibilityAction,
|
||||
listRoutinesAction, updateRoutineAction,
|
||||
].map((action) => descriptor({
|
||||
operationId: action.id,
|
||||
title: action.documentation.title,
|
||||
description: action.documentation.description,
|
||||
placement: "optional",
|
||||
effect: action.canonical.sideEffectClass === "read" ? "read" : "write",
|
||||
requiredClaims: action.live.descriptor.requiredClaims,
|
||||
allowedModes: action.live.descriptor.allowedModes,
|
||||
inputSchema: action.live.descriptor.inputSchema,
|
||||
outputSchema: openObject,
|
||||
|
||||
@@ -48,6 +48,8 @@ export type PaperclipSemanticActionId =
|
||||
| "delete_responsibility"
|
||||
| "file_under_responsibility"
|
||||
| "remove_from_responsibility"
|
||||
| "list_routines"
|
||||
| "update_routine"
|
||||
| "create_task"
|
||||
| "handoff_case"
|
||||
| "read_case"
|
||||
|
||||
@@ -28,6 +28,8 @@ const AUTOMATIC_PAPERCLIP_WORKFLOW_ACTIONS = new Set([
|
||||
// every change is an undoable Dashboard version, and a delete waits for their card.
|
||||
"create_area", "update_area", "delete_area", "create_responsibility", "update_responsibility",
|
||||
"delete_responsibility", "file_under_responsibility", "remove_from_responsibility",
|
||||
// Routines the agent runs, or the person it works for is responsible for; each change is a routine revision.
|
||||
"update_routine",
|
||||
]);
|
||||
|
||||
export const CLAUDE_SELF_SCHEDULING_TOOLS: readonly string[] = Object.freeze(["CronCreate", "CronDelete", "CronList", "ScheduleWakeup"]);
|
||||
|
||||
@@ -466,13 +466,13 @@ describe("workflow reports and stress traceability", () => {
|
||||
candidateFailures: 36,
|
||||
});
|
||||
expect(report.coverage).toMatchObject({
|
||||
canonicalOperations: 81,
|
||||
canonicalOperations: 82,
|
||||
capabilityCases: 106,
|
||||
workflows: 12,
|
||||
stressFindings: 44,
|
||||
stressExclusions: 1,
|
||||
});
|
||||
expect(report.coverage.operations).toHaveLength(81);
|
||||
expect(report.coverage.operations).toHaveLength(82);
|
||||
expect(report.coverage.operations).toEqual(expect.arrayContaining(
|
||||
["create_case", "read_case", "update_case", "handoff_case", "list_workflows", "read_workflow", "create_workflow", "update_workflow", "send_chat_message"].map(operationId =>
|
||||
expect.objectContaining({ operationId, workflowIds: [] })),
|
||||
@@ -484,7 +484,7 @@ describe("workflow reports and stress traceability", () => {
|
||||
)?.workflowIds.length,
|
||||
).toBeGreaterThan(0);
|
||||
expect(renderRunnerWorkflowMarkdown(report)).toContain(
|
||||
"81 operations · 106 capability cases · 12 workflows",
|
||||
"82 operations · 106 capability cases · 12 workflows",
|
||||
);
|
||||
expect(renderRunnerWorkflowJUnit(report)).toContain(
|
||||
'tests="36" failures="36" skipped="0"',
|
||||
|
||||
@@ -15,6 +15,7 @@ import { createSkillAction } from "./create-skill.js";
|
||||
import { updateSkillAction } from "./update-skill.js";
|
||||
import { createProjectAction } from "./create-project.js";
|
||||
import { listProjectRepositoriesAction } from "./list-project-repositories.js";
|
||||
import { updateRoutineAction } from "./update-routine.js";
|
||||
import {
|
||||
createAreaAction, createResponsibilityAction, deleteAreaAction, deleteResponsibilityAction, fileUnderResponsibilityAction,
|
||||
findResponsibilitiesForAction, getResponsibilityAction, listResponsibilitiesAction, removeFromResponsibilityAction,
|
||||
@@ -100,6 +101,7 @@ export const PAPERCLIP_PROTOCOL_ACTIONS = deepFreezeProtocolAction([
|
||||
deleteResponsibilityAction,
|
||||
fileUnderResponsibilityAction,
|
||||
removeFromResponsibilityAction,
|
||||
updateRoutineAction,
|
||||
searchApiAction,
|
||||
callApiAction,
|
||||
administerCompanyAction,
|
||||
|
||||
@@ -1,10 +1,31 @@
|
||||
const uuidPattern = "^[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}$";
|
||||
|
||||
export const listRoutinesInputSchema = {
|
||||
type: "object",
|
||||
properties: {
|
||||
query: { type: "string", minLength: 1, maxLength: 200, description: "Words in the title or instructions." },
|
||||
status: { type: "string", enum: ["active", "paused", "archived"] },
|
||||
assigneeAgentId: { type: "string", pattern: uuidPattern, description: "Only routines this agent runs." },
|
||||
projectId: { type: "string", pattern: uuidPattern },
|
||||
responsibleUserId: { type: "string", minLength: 1, maxLength: 200, description: "Only routines this person is responsible for." },
|
||||
responsibilityId: { type: "string", pattern: uuidPattern, description: "Only routines under this responsibility, filed directly or through its project. Needs Responsibilities on." },
|
||||
unfiled: { type: "boolean", description: "Only routines filed under no proposed or active responsibility, directly or through their project. Combine with status, such as active. Needs Responsibilities on." },
|
||||
limit: { type: "integer", minimum: 1, maximum: 200, description: "Default 50." },
|
||||
},
|
||||
required: [],
|
||||
additionalProperties: false,
|
||||
} as const;
|
||||
|
||||
export const listRoutinesDescription = "List the company's routines (recurring work an agent runs on a schedule, webhook or request) with their agent, project, responsible person, schedules and last run. Filter by words, status, agent, project, person, a responsibility, or unfiled for routines under no responsibility; every filter applies before the limit.";
|
||||
|
||||
/** Canonical definition and documentation for `list_routines`. */
|
||||
export const listRoutinesAction = {
|
||||
"id": "list_routines",
|
||||
"canonical": {
|
||||
"operationId": "list_routines",
|
||||
"surfaces": [
|
||||
"scenario"
|
||||
"scenario",
|
||||
"live"
|
||||
],
|
||||
"placement": "optional_agent_tool",
|
||||
"optionalGroup": "routines",
|
||||
@@ -13,22 +34,23 @@ export const listRoutinesAction = {
|
||||
],
|
||||
"taskModes": [
|
||||
"standard",
|
||||
"ask",
|
||||
"planning",
|
||||
"skill_test"
|
||||
],
|
||||
"sideEffectClass": "read",
|
||||
"idempotency": "none",
|
||||
"disabledByDefault": false,
|
||||
"realBindingStatus": "scenario_mock",
|
||||
"realServiceBinding": "unbound",
|
||||
"prpEvidence": "read projection surfaced via a tool-result item event; no control-plane state diff",
|
||||
"prpBindingStatus": "audit_pending",
|
||||
"legacyAliases": [],
|
||||
"note": "Scenario/eval-only mock extension."
|
||||
"realBindingStatus": "live_codex",
|
||||
"realServiceBinding": "callRoutineTool",
|
||||
"prpEvidence": "Authenticated routine and responsibility routes read with the run's agent token.",
|
||||
"prpBindingStatus": "bound",
|
||||
"legacyAliases": []
|
||||
},
|
||||
"documentation": {
|
||||
"title": "List Routines",
|
||||
"description": "List Routines through the Capability routines capability set.",
|
||||
"note": "Scenario/eval-only mock extension."
|
||||
"title": "List routines",
|
||||
"description": listRoutinesDescription,
|
||||
"note": null
|
||||
},
|
||||
"examples": {
|
||||
"call": {
|
||||
@@ -49,20 +71,40 @@ export const listRoutinesAction = {
|
||||
}
|
||||
}
|
||||
},
|
||||
"live": null,
|
||||
"live": {
|
||||
"order": 95,
|
||||
"descriptor": {
|
||||
"schema": "paperclip.semantic-tool.v1",
|
||||
"operationId": "list_routines",
|
||||
"version": 1,
|
||||
"title": "List routines",
|
||||
"description": listRoutinesDescription,
|
||||
"effect": "read",
|
||||
"requiredClaims": [
|
||||
"routines:read"
|
||||
],
|
||||
"allowedModes": [
|
||||
"standard",
|
||||
"ask",
|
||||
"planning",
|
||||
"skill_test"
|
||||
],
|
||||
"inputSchema": listRoutinesInputSchema,
|
||||
"outputSchema": {
|
||||
"type": "object",
|
||||
"additionalProperties": true
|
||||
},
|
||||
"exposure": "optional"
|
||||
}
|
||||
},
|
||||
"scenario": {
|
||||
"order": 28,
|
||||
"descriptor": {
|
||||
"operationId": "list_routines",
|
||||
"version": 1,
|
||||
"title": "List Routines",
|
||||
"description": "List Routines through the Capability routines capability set.",
|
||||
"inputSchema": {
|
||||
"type": "object",
|
||||
"properties": {},
|
||||
"required": [],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"title": "List routines",
|
||||
"description": listRoutinesDescription,
|
||||
"inputSchema": listRoutinesInputSchema,
|
||||
"outputSchema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -105,6 +147,8 @@ export const listRoutinesAction = {
|
||||
],
|
||||
"taskModes": [
|
||||
"standard",
|
||||
"ask",
|
||||
"planning",
|
||||
"skill_test"
|
||||
],
|
||||
"sideEffectClass": "read",
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
const uuidPattern = "^[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}$";
|
||||
const description = "Change a routine: its title, instructions, agent, project, status (active, paused, archived) or priority; set its schedule in plain terms (no cron), or null to turn its schedule off; and file it under a responsibility. You may change your own routines, and those the person who directed your run (their own chat or task, or their message woke you) is responsible for; on a routine you do not run, changing its agent, turning it on or changing its schedule needs that person to be allowed to assign work. The routine and its schedule change together as one routine revision the person can restore from the routine's history; filing is saved separately in their Dashboard history (see filedUnder.undo).";
|
||||
|
||||
export const updateRoutineInputSchema = {
|
||||
type: "object", additionalProperties: false, required: ["routineId"],
|
||||
properties: {
|
||||
routineId: { type: "string", pattern: uuidPattern, description: "Routine ID from list_routines." },
|
||||
title: { type: "string", minLength: 1, maxLength: 200 },
|
||||
instructions: { type: ["string", "null"], maxLength: 200000, description: "What each run should do, written out in full." },
|
||||
assigneeAgentId: { type: ["string", "null"], pattern: uuidPattern, description: "The agent that runs it." },
|
||||
projectId: { type: ["string", "null"], pattern: uuidPattern },
|
||||
status: { type: "string", enum: ["active", "paused", "archived"] },
|
||||
priority: { type: "string", enum: ["critical", "high", "medium", "low"] },
|
||||
schedule: {
|
||||
type: ["object", "null"], additionalProperties: false, required: ["frequency", "time"],
|
||||
description: "When it runs, in the person's local time. null turns its schedule off.",
|
||||
properties: {
|
||||
frequency: { type: "string", enum: ["daily", "weekdays", "weekly", "monthly"] },
|
||||
dayOfWeek: { type: "string", enum: ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"], description: "For weekly." },
|
||||
dayOfMonth: { type: "integer", minimum: 1, maximum: 28, description: "For monthly." },
|
||||
time: { type: "string", pattern: "^([01]\\d|2[0-3]):[0-5]\\d$", description: "24-hour HH:MM." },
|
||||
timezone: { type: "string", minLength: 1, maxLength: 100, description: "IANA zone such as Europe/Berlin. Default: the routine's current schedule zone, else the person's own time zone." },
|
||||
},
|
||||
},
|
||||
fileUnder: { type: "string", pattern: uuidPattern, description: "A responsibility ID to file the routine under." },
|
||||
},
|
||||
} as const;
|
||||
|
||||
/** Canonical definition and documentation for `update_routine`. */
|
||||
export const updateRoutineAction = {
|
||||
id: "update_routine",
|
||||
canonical: {
|
||||
operationId: "update_routine", surfaces: ["live"], placement: "optional_agent_tool", optionalGroup: "routines",
|
||||
requiredClaims: [], taskModes: ["standard"], sideEffectClass: "company_write", idempotency: "none",
|
||||
disabledByDefault: false, realBindingStatus: "live_codex", realServiceBinding: "callRoutineTool",
|
||||
prpEvidence: "Authenticated routine routes with routine revisions and run-bound activity for the person the agent works for.",
|
||||
prpBindingStatus: "bound", legacyAliases: [],
|
||||
},
|
||||
documentation: { title: "Update routine", description, note: null },
|
||||
examples: {
|
||||
call: { operationId: "update_routine", input: { routineId: "00000000-0000-4000-8000-000000000002", schedule: { frequency: "weekly", dayOfWeek: "monday", time: "09:00" } } },
|
||||
scenarioCall: null,
|
||||
success: { ok: true, operationId: "update_routine", result: {} },
|
||||
},
|
||||
live: { order: 96, descriptor: {
|
||||
schema: "paperclip.semantic-tool.v1", operationId: "update_routine", version: 1,
|
||||
title: "Update routine", description, exposure: "optional", requiredClaims: [],
|
||||
allowedModes: ["standard"], inputSchema: updateRoutineInputSchema, outputSchema: { type: "object", additionalProperties: true },
|
||||
} },
|
||||
scenario: null,
|
||||
} as const;
|
||||
@@ -44,6 +44,7 @@ const NAMESPACE: Readonly<Record<CapabilitySemanticOperationId, string>> = Objec
|
||||
create_area: "responsibilities", update_area: "responsibilities", delete_area: "responsibilities",
|
||||
create_responsibility: "responsibilities", update_responsibility: "responsibilities", delete_responsibility: "responsibilities",
|
||||
file_under_responsibility: "responsibilities", remove_from_responsibility: "responsibilities",
|
||||
list_routines: "routines", update_routine: "routines",
|
||||
set_dependencies: "delegation", reassign_task: "delegation", list_approvals: "governance", get_approval: "governance",
|
||||
get_approval_context: "governance", request_approval: "governance",
|
||||
decide_approval: "governance", comment_on_approval: "governance",
|
||||
|
||||
@@ -209,6 +209,7 @@ export class CapabilitySemanticDispatcher {
|
||||
"delete_responsibility" as const,
|
||||
"file_under_responsibility" as const,
|
||||
"remove_from_responsibility" as const,
|
||||
"update_routine" as const,
|
||||
"handoff_case" as const,
|
||||
"read_case" as const,
|
||||
"update_case" as const,
|
||||
|
||||
@@ -50,6 +50,7 @@ const NAMESPACE: Readonly<Record<PaperclipSemanticActionId, string>> =
|
||||
create_area: "responsibilities", update_area: "responsibilities", delete_area: "responsibilities",
|
||||
create_responsibility: "responsibilities", update_responsibility: "responsibilities", delete_responsibility: "responsibilities",
|
||||
file_under_responsibility: "responsibilities", remove_from_responsibility: "responsibilities",
|
||||
list_routines: "routines", update_routine: "routines",
|
||||
request_approval: "governance",
|
||||
decide_approval: "governance",
|
||||
comment_on_approval: "governance",
|
||||
|
||||
@@ -113,7 +113,7 @@ describe("Capability semantic catalog and authorization", () => {
|
||||
it("publishes a stable narrow catalog without credentials or control-plane-owned tools", () => {
|
||||
const names = CAPABILITY_SEMANTIC_TOOL_CATALOG.map((tool) => tool.operationId);
|
||||
expect(new Set(names).size).toBe(names.length);
|
||||
expect(names).toHaveLength(69);
|
||||
expect(names).toHaveLength(71);
|
||||
expect(names).toContain("send_chat_message");
|
||||
expect(names).toEqual(expect.arrayContaining(["list_workflows", "read_workflow", "create_workflow", "update_workflow"]));
|
||||
expect(names).toContain("set_task_monitor");
|
||||
|
||||
@@ -68,6 +68,8 @@ export type CapabilitySemanticOperationId =
|
||||
| "delete_responsibility"
|
||||
| "file_under_responsibility"
|
||||
| "remove_from_responsibility"
|
||||
| "list_routines"
|
||||
| "update_routine"
|
||||
| "create_task"
|
||||
| "handoff_case"
|
||||
| "read_case"
|
||||
|
||||
@@ -85,6 +85,17 @@ export type CreateRoutine = z.infer<typeof createRoutineSchema>;
|
||||
export const updateRoutineSchema = objectWithoutDefaults(createRoutineSchema).partial().extend({
|
||||
baseRevisionId: z.string().guid().optional().nullable(),
|
||||
responsibleUserId: z.string().trim().min(1).optional(),
|
||||
/**
|
||||
* Replace the routine's schedule in the same change and revision: one
|
||||
* enabled schedule trigger at this time (other schedule triggers are turned
|
||||
* off), or null to turn every schedule off. Other triggers are left alone.
|
||||
* Without a timezone it keeps the current schedule's, else uses the
|
||||
* responsible person's own time zone.
|
||||
*/
|
||||
schedule: z.object({
|
||||
cronExpression: z.string().trim().min(1).max(200),
|
||||
timezone: z.string().trim().min(1).max(100).optional(),
|
||||
}).strict().nullable().optional(),
|
||||
});
|
||||
export type UpdateRoutine = z.infer<typeof updateRoutineSchema>;
|
||||
|
||||
|
||||
@@ -0,0 +1,130 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { callRoutineTool } from "../services/routine-tools.js";
|
||||
|
||||
const COMPANY = "11111111-1111-4111-8111-111111111111";
|
||||
const ROUTINE = "44444444-4444-4444-8444-444444444444";
|
||||
const OTHER = "55555555-5555-4555-8555-555555555555";
|
||||
const RESPONSIBILITY = "33333333-3333-4333-8333-333333333333";
|
||||
const TRIGGER = "66666666-6666-4666-8666-666666666666";
|
||||
|
||||
function routine(overrides: Record<string, unknown> = {}) {
|
||||
return {
|
||||
id: ROUTINE, companyId: COMPANY, projectId: null, title: "Weekly pipeline", description: "Review the pipeline",
|
||||
assigneeAgentId: "agent-1", priority: "medium", status: "active", responsibleUserId: "person-1",
|
||||
latestRevisionId: "rev-1", latestRevisionNumber: 3, triggers: [], lastRun: null, ...overrides,
|
||||
};
|
||||
}
|
||||
|
||||
/** A response with a status or headers; plain values answer 200. */
|
||||
class Reply {
|
||||
constructor(readonly body: unknown, readonly status = 200, readonly headers: Record<string, string> = {}) {}
|
||||
}
|
||||
|
||||
/** Answers by "METHOD path" or path, and records each request. */
|
||||
function fakeApi(routes: Record<string, unknown | (() => unknown)>) {
|
||||
const calls: Array<{ method: string; path: string; body?: unknown }> = [];
|
||||
const fetcher = (async (url: string | URL, init?: RequestInit) => {
|
||||
const method = init?.method ?? "GET";
|
||||
const path = String(url).replace("http://paperclip.test/api", "");
|
||||
calls.push({ method, path, ...(init?.body ? { body: JSON.parse(String(init.body)) } : {}) });
|
||||
const route = routes[`${method} ${path}`] ?? routes[path];
|
||||
if (route === undefined) throw new Error(`unexpected request ${method} ${path}`);
|
||||
const value = typeof route === "function" ? (route as () => unknown)() : route;
|
||||
const reply = value instanceof Reply ? value : new Reply(value);
|
||||
return new Response(JSON.stringify(reply.body), { status: reply.status, headers: { "content-type": "application/json", ...reply.headers } });
|
||||
}) as typeof fetch;
|
||||
return { calls, fetcher };
|
||||
}
|
||||
|
||||
const base = { apiUrl: "http://paperclip.test/api", token: "agent-token", companyId: COMPANY, companyPrefix: "PAP" };
|
||||
|
||||
describe("routine tools", () => {
|
||||
it("passes every filter to the routine list, so they apply before the limit", async () => {
|
||||
const query = new URLSearchParams({ q: "pipeline", status: "paused", responsibleUserId: "person-1", responsibilityId: RESPONSIBILITY, unfiled: "true" });
|
||||
const api = fakeApi({
|
||||
[`/companies/${COMPANY}/routines?${query}`]: [
|
||||
routine({ status: "paused", triggers: [{ id: TRIGGER, kind: "schedule", enabled: true, cronExpression: "0 9 * * 1", timezone: "Europe/Berlin", nextRunAt: null }] }),
|
||||
routine({ id: OTHER, status: "paused" }),
|
||||
],
|
||||
});
|
||||
const result = await callRoutineTool({ ...base, name: "list_routines", arguments: {
|
||||
query: "pipeline", status: "paused", responsibleUserId: "person-1", responsibilityId: RESPONSIBILITY, unfiled: true, limit: 1,
|
||||
} }, api.fetcher);
|
||||
expect(result).toMatchObject({
|
||||
total: 2,
|
||||
routines: [{ id: ROUTINE, title: "Weekly pipeline", triggers: [{ triggerId: TRIGGER, cronExpression: "0 9 * * 1", timezone: "Europe/Berlin" }], href: `/PAP/routines/${ROUTINE}` }],
|
||||
truncated: true,
|
||||
});
|
||||
});
|
||||
|
||||
it("changes a routine and its schedule in one call, files it, and reports each undo", async () => {
|
||||
let reads = 0;
|
||||
const scheduled = [{ id: TRIGGER, kind: "schedule", enabled: true, cronExpression: "30 9 * * 1", timezone: "Europe/Berlin", nextRunAt: null }];
|
||||
const api = fakeApi({
|
||||
[`GET /routines/${ROUTINE}`]: () => (reads++ === 0 ? routine() : routine({ title: "Pipeline review", latestRevisionNumber: 4, triggers: scheduled })),
|
||||
[`PATCH /routines/${ROUTINE}`]: routine({ title: "Pipeline review" }),
|
||||
[`POST /responsibilities/${RESPONSIBILITY}/file`]: new Reply({ filed: [], unfiled: [] }, 200,
|
||||
{ "x-paperclip-dashboard-version": "version-7", "x-paperclip-dashboard-owner": "person-1" }),
|
||||
});
|
||||
const result = await callRoutineTool({ ...base, name: "update_routine", arguments: {
|
||||
routineId: ROUTINE, title: "Pipeline review", instructions: "Review the pipeline and flag stalled deals",
|
||||
schedule: { frequency: "weekly", dayOfWeek: "monday", time: "09:30", timezone: "Europe/Berlin" }, fileUnder: RESPONSIBILITY,
|
||||
} }, api.fetcher);
|
||||
expect(api.calls.filter((call) => call.method !== "GET")).toEqual([
|
||||
{ method: "PATCH", path: `/routines/${ROUTINE}`, body: {
|
||||
title: "Pipeline review", description: "Review the pipeline and flag stalled deals",
|
||||
schedule: { cronExpression: "30 9 * * 1", timezone: "Europe/Berlin" }, baseRevisionId: "rev-1",
|
||||
} },
|
||||
{ method: "POST", path: `/responsibilities/${RESPONSIBILITY}/file`, body: { items: [{ kind: "routine", id: ROUTINE }] } },
|
||||
]);
|
||||
expect(result).toMatchObject({
|
||||
routine: { title: "Pipeline review", revision: 4 },
|
||||
schedule: { label: "Every Monday at 9:30 AM", cronExpression: "30 9 * * 1", timezone: "Europe/Berlin" },
|
||||
filedUnder: { responsibilityId: RESPONSIBILITY, dashboardVersionId: "version-7", dashboardOwnerUserId: "person-1", undo: expect.stringContaining("Dashboard history") },
|
||||
undo: expect.stringMatching(/restoring revision 3 .*not the filing/),
|
||||
});
|
||||
});
|
||||
|
||||
it("says what was saved when filing fails after the routine changed", async () => {
|
||||
let reads = 0;
|
||||
const api = fakeApi({
|
||||
[`GET /routines/${ROUTINE}`]: () => (reads++ === 0 ? routine() : routine({ title: "Pipeline review", latestRevisionNumber: 4 })),
|
||||
[`PATCH /routines/${ROUTINE}`]: routine({ title: "Pipeline review" }),
|
||||
[`POST /responsibilities/${RESPONSIBILITY}/file`]: new Reply({ error: "Responsibilities are not enabled", code: "responsibilities_disabled" }, 404),
|
||||
});
|
||||
const result = await callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE, title: "Pipeline review", fileUnder: RESPONSIBILITY } }, api.fetcher);
|
||||
expect(result).toMatchObject({
|
||||
routine: { title: "Pipeline review", revision: 4 },
|
||||
filedUnder: { responsibilityId: RESPONSIBILITY, failed: true, error: "Responsibilities are not enabled", note: expect.stringContaining("was saved") },
|
||||
undo: expect.stringContaining("restoring revision 3"),
|
||||
});
|
||||
|
||||
// A filing on its own still fails loudly: nothing else was saved.
|
||||
await expect(callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE, fileUnder: RESPONSIBILITY } }, api.fetcher))
|
||||
.rejects.toMatchObject({ status: 404 });
|
||||
});
|
||||
|
||||
it("leaves the zone to the server when none is given, and turns schedules off with null", async () => {
|
||||
const add = fakeApi({
|
||||
[`GET /routines/${ROUTINE}`]: routine(),
|
||||
[`PATCH /routines/${ROUTINE}`]: routine(),
|
||||
});
|
||||
await callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE, schedule: { frequency: "weekdays", time: "08:00" } } }, add.fetcher);
|
||||
expect(add.calls.find((call) => call.method === "PATCH")?.body).toEqual({ schedule: { cronExpression: "0 8 * * 1-5" }, baseRevisionId: "rev-1" });
|
||||
|
||||
const off = fakeApi({
|
||||
[`GET /routines/${ROUTINE}`]: routine({ triggers: [{ id: TRIGGER, kind: "schedule", enabled: true, cronExpression: "0 9 * * 1", timezone: "UTC", nextRunAt: null }] }),
|
||||
[`PATCH /routines/${ROUTINE}`]: routine(),
|
||||
});
|
||||
const result = await callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE, schedule: null } }, off.fetcher);
|
||||
expect(off.calls.find((call) => call.method === "PATCH")?.body).toEqual({ schedule: null, baseRevisionId: "rev-1" });
|
||||
expect(result).toMatchObject({ schedule: { turnedOff: 1 } });
|
||||
});
|
||||
|
||||
it("refuses an empty change and a weekly schedule without its day", async () => {
|
||||
const api = fakeApi({ [`GET /routines/${ROUTINE}`]: routine() });
|
||||
await expect(callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE } }, api.fetcher)).rejects.toMatchObject({ status: 422 });
|
||||
await expect(callRoutineTool({ ...base, name: "update_routine", arguments: { routineId: ROUTINE, schedule: { frequency: "weekly", time: "09:00" } } }, api.fetcher))
|
||||
.rejects.toThrow(/dayOfWeek/);
|
||||
});
|
||||
});
|
||||
@@ -27,10 +27,14 @@ import {
|
||||
principalPermissionGrants,
|
||||
projectWorkspaces,
|
||||
projects,
|
||||
responsibilities,
|
||||
responsibilityLinks,
|
||||
routineDocuments,
|
||||
routineRevisions,
|
||||
routineRuns,
|
||||
routines,
|
||||
routineTriggers,
|
||||
userWorkspacePreferences,
|
||||
} from "@paperclipai/db";
|
||||
import {
|
||||
getEmbeddedPostgresTestSupport,
|
||||
@@ -115,6 +119,9 @@ describeEmbeddedPostgres("routine routes end-to-end", () => {
|
||||
await db.delete(documentAnnotationAnchorSnapshots);
|
||||
await db.delete(documentAnnotationComments);
|
||||
await db.delete(documentAnnotationThreads);
|
||||
await db.delete(responsibilityLinks);
|
||||
await db.delete(responsibilities);
|
||||
await db.delete(userWorkspacePreferences);
|
||||
await db.delete(routineRuns);
|
||||
await db.delete(routineTriggers);
|
||||
await db.delete(heartbeatRunEvents);
|
||||
@@ -1057,4 +1064,148 @@ describeEmbeddedPostgres("routine routes end-to-end", () => {
|
||||
executionWorkspaceSettings: { mode: "isolated_workspace" },
|
||||
});
|
||||
});
|
||||
|
||||
describe("an agent acting for the routine's person", () => {
|
||||
/** A second agent, working in the person's own chat, so it acts for them. */
|
||||
async function helperFor(companyId: string, personUserId: string) {
|
||||
const [helper] = await db.insert(agents).values({
|
||||
companyId, name: "Helper", role: "general", status: "active", adapterType: "codex_local", adapterConfig: {}, runtimeConfig: {}, permissions: {},
|
||||
}).returning();
|
||||
const [chat] = await db.insert(issues).values({ companyId, title: "Chat", createdByUserId: personUserId, responsibleUserId: personUserId }).returning();
|
||||
const [run] = await db.insert(heartbeatRuns).values({ companyId, agentId: helper!.id, issueId: chat!.id, scopeKind: "issue", status: "running", contextSnapshot: { issueId: chat!.id } }).returning();
|
||||
const app = await createApp({
|
||||
type: "agent", agentId: helper!.id, companyId, runId: run!.id, source: "agent_jwt",
|
||||
onBehalfOfUserId: personUserId, onBehalfOfMemberships: [{ companyId, membershipRole: "owner", status: "active" }],
|
||||
});
|
||||
return { app, helperId: helper!.id };
|
||||
}
|
||||
|
||||
async function personRoutine(companyId: string, agentId: string, userId: string, values: Record<string, unknown> = {}) {
|
||||
const board = await createApp({ type: "board", source: "local_implicit", userId, isInstanceAdmin: true });
|
||||
const created = await request(board).post(`/api/companies/${companyId}/routines`).send({ assigneeAgentId: agentId, title: "Weekly pipeline", ...values });
|
||||
expect(created.status, JSON.stringify(created.body)).toBe(201);
|
||||
return created.body.id as string;
|
||||
}
|
||||
|
||||
it("reschedules its person's routine run by another agent in one revision, with one schedule however often it races", async () => {
|
||||
const { companyId, agentId, userId } = await seedFixture();
|
||||
const routineId = await personRoutine(companyId, agentId, userId);
|
||||
const { app } = await helperFor(companyId, userId);
|
||||
const revisions = async () => db.select().from(routineRevisions).where(eq(routineRevisions.routineId, routineId));
|
||||
const before = (await revisions()).length;
|
||||
|
||||
// No zone given, none on the routine and none saved for the person: the agent must name one.
|
||||
const unnamed = await request(app).patch(`/api/routines/${routineId}`).send({ title: "Pipeline review", schedule: { cronExpression: "30 9 * * 1" } });
|
||||
expect(unnamed.status).toBe(422);
|
||||
expect((await revisions()).length).toBe(before);
|
||||
|
||||
await db.insert(userWorkspacePreferences).values({ userId, timeZone: "Europe/Berlin" });
|
||||
const changed = await request(app).patch(`/api/routines/${routineId}`).send({ title: "Pipeline review", schedule: { cronExpression: "30 9 * * 1" } });
|
||||
expect(changed.status, JSON.stringify(changed.body)).toBe(200);
|
||||
const after = await revisions();
|
||||
expect(after.length).toBe(before + 1);
|
||||
expect(after.find((revision) => revision.revisionNumber === Math.max(...after.map((r) => r.revisionNumber)))?.changeSummary).toBe("Updated routine and schedule");
|
||||
const schedules = async () => db.select().from(routineTriggers).where(eq(routineTriggers.routineId, routineId));
|
||||
expect(await schedules()).toMatchObject([{ kind: "schedule", enabled: true, cronExpression: "30 9 * * 1", timezone: "Europe/Berlin" }]);
|
||||
|
||||
// Two changes at once: the routine lock keeps one enabled schedule.
|
||||
await db.delete(routineTriggers).where(eq(routineTriggers.routineId, routineId));
|
||||
const raced = await Promise.all([
|
||||
request(app).patch(`/api/routines/${routineId}`).send({ schedule: { cronExpression: "0 8 * * *", timezone: "UTC" } }),
|
||||
request(app).patch(`/api/routines/${routineId}`).send({ schedule: { cronExpression: "0 18 * * *", timezone: "UTC" } }),
|
||||
]);
|
||||
expect(raced.map((res) => res.status)).toEqual([200, 200]);
|
||||
expect((await schedules()).filter((trigger) => trigger.enabled)).toHaveLength(1);
|
||||
|
||||
const off = await request(app).patch(`/api/routines/${routineId}`).send({ schedule: null });
|
||||
expect(off.status).toBe(200);
|
||||
expect((await schedules()).every((trigger) => !trigger.enabled)).toBe(true);
|
||||
|
||||
// Handing the routine to another person with a new time: the time is in the new person's zone.
|
||||
const nextPerson = randomUUID();
|
||||
await accessService(db).ensureMembership(companyId, "user", nextPerson, "operator", "active");
|
||||
await db.insert(userWorkspacePreferences).values({ userId: nextPerson, timeZone: "Asia/Tokyo" });
|
||||
await db.delete(routineTriggers).where(eq(routineTriggers.routineId, routineId));
|
||||
const board = await createApp({ type: "board", source: "local_implicit", userId, isInstanceAdmin: true });
|
||||
const handed = await request(board).patch(`/api/routines/${routineId}`).send({ responsibleUserId: nextPerson, schedule: { cronExpression: "0 9 * * *" } });
|
||||
expect(handed.status, JSON.stringify(handed.body)).toBe(200);
|
||||
expect(await schedules()).toMatchObject([{ enabled: true, timezone: "Asia/Tokyo" }]);
|
||||
});
|
||||
|
||||
it("refuses another person's routine, and needs the person's tasks:assign to take, turn on or reschedule one it does not run", async () => {
|
||||
const { companyId, agentId, userId } = await seedFixture();
|
||||
const memberId = randomUUID();
|
||||
await accessService(db).ensureMembership(companyId, "user", memberId, "operator", "active");
|
||||
// A member who may not assign tasks, as under a restricted assignment policy.
|
||||
vi.doMock("../services/index.js", async () => {
|
||||
const [{ accessService: realAccess }, { documentAnnotationService }, { logActivity }, { routineService }] = await Promise.all([
|
||||
import("../services/access.js"), import("../services/document-annotations.js"),
|
||||
import("../services/activity-log.js"), import("../services/routines.js"),
|
||||
]);
|
||||
const accessService = (database: typeof db) => {
|
||||
const access = realAccess(database);
|
||||
return { ...access, canUser: async (...args: Parameters<typeof access.canUser>) =>
|
||||
(args[1] === memberId && args[2] === "tasks:assign" ? false : access.canUser(...args)) };
|
||||
};
|
||||
return { accessService, documentAnnotationService, logActivity, routineService };
|
||||
});
|
||||
const ownersRoutine = await personRoutine(companyId, agentId, userId);
|
||||
const membersRoutine = await personRoutine(companyId, agentId, userId, { status: "paused" });
|
||||
await db.update(routines).set({ responsibleUserId: memberId }).where(eq(routines.id, membersRoutine));
|
||||
|
||||
const { app: forMember, helperId } = await helperFor(companyId, memberId);
|
||||
// Not the member's routine: no change at all.
|
||||
expect((await request(forMember).patch(`/api/routines/${ownersRoutine}`).send({ title: "x" })).status).toBe(403);
|
||||
// The member's routine: an ordinary change is fine, but the member may not assign tasks.
|
||||
expect((await request(forMember).patch(`/api/routines/${membersRoutine}`).send({ title: "Member pipeline" })).status).toBe(200);
|
||||
expect((await request(forMember).patch(`/api/routines/${membersRoutine}`).send({ assigneeAgentId: helperId })).status).toBe(403);
|
||||
expect((await request(forMember).patch(`/api/routines/${membersRoutine}`).send({ status: "active" })).status).toBe(403);
|
||||
expect((await request(forMember).patch(`/api/routines/${membersRoutine}`).send({ schedule: { cronExpression: "0 9 * * 1", timezone: "UTC" } })).status).toBe(403);
|
||||
expect((await request(forMember).post(`/api/routines/${membersRoutine}/triggers`).send({ kind: "schedule", cronExpression: "0 9 * * 1", timezone: "UTC" })).status).toBe(403);
|
||||
// Nor change an existing trigger, start the routine, or restore a revision of it.
|
||||
const board = await createApp({ type: "board", source: "local_implicit", userId, isInstanceAdmin: true });
|
||||
const trigger = await request(board).post(`/api/routines/${membersRoutine}/triggers`).send({ kind: "schedule", cronExpression: "0 9 * * 1", timezone: "UTC", enabled: false });
|
||||
expect(trigger.status, JSON.stringify(trigger.body)).toBe(201);
|
||||
expect((await request(forMember).patch(`/api/routine-triggers/${trigger.body.trigger.id}`).send({ enabled: true })).status).toBe(403);
|
||||
expect((await request(forMember).delete(`/api/routine-triggers/${trigger.body.trigger.id}`)).status).toBe(403);
|
||||
expect((await request(forMember).post(`/api/routines/${membersRoutine}/run`).send({})).status).toBe(403);
|
||||
const [revision] = await db.select().from(routineRevisions).where(eq(routineRevisions.routineId, membersRoutine)).limit(1);
|
||||
expect((await request(forMember).post(`/api/routines/${membersRoutine}/revisions/${revision!.id}/restore`).send({})).status).toBe(403);
|
||||
|
||||
// The owner may assign tasks, so an agent acting for them may take the routine.
|
||||
const { app: forOwner, helperId: ownersHelper } = await helperFor(companyId, userId);
|
||||
const taken = await request(forOwner).patch(`/api/routines/${ownersRoutine}`).send({ assigneeAgentId: ownersHelper });
|
||||
expect(taken.status, JSON.stringify(taken.body)).toBe(200);
|
||||
// The agent that runs a routine still reschedules its own, also through its trigger.
|
||||
const runner = await createApp({ type: "agent", agentId, companyId });
|
||||
expect((await request(runner).patch(`/api/routines/${membersRoutine}`).send({ schedule: { cronExpression: "0 9 * * 1", timezone: "UTC" } })).status).toBe(200);
|
||||
expect((await request(runner).patch(`/api/routine-triggers/${trigger.body.trigger.id}`).send({ cronExpression: "0 10 * * 1" })).status).toBe(200);
|
||||
});
|
||||
|
||||
it("filters the list in the query: words, status and routines filed under no responsibility", async () => {
|
||||
const { companyId, agentId, userId } = await seedFixture();
|
||||
await db.delete(instanceSettings);
|
||||
await db.insert(instanceSettings).values({ experimental: { enableResponsibilities: true } });
|
||||
const filed = await personRoutine(companyId, agentId, userId, { title: "Pipeline filed" });
|
||||
const loose = await personRoutine(companyId, agentId, userId, { title: "Pipeline loose", status: "paused" });
|
||||
await personRoutine(companyId, agentId, userId, { title: "Standup" });
|
||||
const [hiring] = await db.insert(responsibilities).values({ companyId, ownerUserId: userId, title: "Hiring", status: "active" }).returning();
|
||||
await db.insert(responsibilityLinks).values({ companyId, responsibilityId: hiring!.id, routineId: filed });
|
||||
const board = await createApp({ type: "board", source: "local_implicit", userId, isInstanceAdmin: true });
|
||||
const list = async (query: string) => (await request(board).get(`/api/companies/${companyId}/routines?${query}`)).body.map((routine: { id: string }) => routine.id);
|
||||
|
||||
expect(await list("q=PIPELINE")).toEqual(expect.arrayContaining([filed, loose]));
|
||||
expect(await list("q=PIPELINE")).toHaveLength(2);
|
||||
expect(await list("q=pipeline&unfiled=true&status=paused")).toEqual([loose]);
|
||||
expect(await list(`responsibilityId=${hiring!.id}`)).toEqual([filed]);
|
||||
|
||||
// The responsibility filters are part of the Responsibilities experiment; plain searches are not.
|
||||
await db.update(instanceSettings).set({ experimental: { enableResponsibilities: false } });
|
||||
(await import("../services/instance-settings-cache.js")).invalidateInstanceSettingsCache();
|
||||
const off = await request(board).get(`/api/companies/${companyId}/routines?unfiled=true`);
|
||||
expect(off.status).toBe(404);
|
||||
expect(off.body.code).toBe("responsibilities_disabled");
|
||||
expect(await list("q=standup")).toHaveLength(1);
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -135,6 +135,15 @@ const mockGetTelemetryClient = vi.hoisted(() => vi.fn());
|
||||
|
||||
function registerModuleMocks() {
|
||||
vi.doMock("../routes/authz.js", async () => vi.importActual("../routes/authz.js"));
|
||||
// Whether the person directed the run reads the database these tests mock away; routines-e2e covers it.
|
||||
// Here every run with a person was directed by them.
|
||||
vi.doMock("../routes/agent-person-authz.js", () => ({
|
||||
agentPersonInCompany: async (_db: unknown, req: { actor: { type: string; onBehalfOfUserId?: string; onBehalfOfMemberships?: Array<{ companyId: string; status?: string; membershipRole?: string | null }> } }, companyId: string) => {
|
||||
if (req.actor.type !== "agent" || !req.actor.onBehalfOfUserId) return null;
|
||||
const membership = req.actor.onBehalfOfMemberships?.find((item) => item.companyId === companyId && item.status === "active");
|
||||
return membership ? { userId: req.actor.onBehalfOfUserId, role: membership.membershipRole ?? null } : null;
|
||||
},
|
||||
}));
|
||||
|
||||
vi.doMock("@paperclipai/shared/telemetry", () => ({
|
||||
trackRoutineCreated: mockTrackRoutineCreated,
|
||||
@@ -568,6 +577,35 @@ describe("routine routes", () => {
|
||||
expect(res.body).not.toHaveProperty("previousResponsibleUserId");
|
||||
});
|
||||
|
||||
it("lets an agent change a routine the person it works for is responsible for", async () => {
|
||||
const personsRoutine = { ...routine, assigneeAgentId: otherAgentId, responsibleUserId: "person-1" };
|
||||
mockRoutineService.get.mockResolvedValue(personsRoutine);
|
||||
mockRoutineService.update.mockResolvedValue({ ...personsRoutine, title: "Weekly digest" });
|
||||
const forPerson = await createApp({
|
||||
type: "agent", agentId, companyId, onBehalfOfUserId: "person-1",
|
||||
onBehalfOfMemberships: [{ companyId, membershipRole: "member", status: "active" }],
|
||||
});
|
||||
const res = await request(forPerson).patch(`/api/routines/${routineId}`).send({ title: "Weekly digest" });
|
||||
expect(res.status).toBe(200);
|
||||
expect(mockLogActivity).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
|
||||
action: "routine.updated", details: expect.objectContaining({ onBehalfOfUserId: "person-1" }),
|
||||
}));
|
||||
|
||||
// Handing it to another agent is an assignment the person must be allowed to make.
|
||||
const handOff = await request(forPerson).patch(`/api/routines/${routineId}`).send({ assigneeAgentId: projectId });
|
||||
expect(handOff.status).toBe(403);
|
||||
mockAccessService.canUser.mockResolvedValue(true);
|
||||
expect((await request(forPerson).patch(`/api/routines/${routineId}`).send({ assigneeAgentId: projectId })).status).toBe(200);
|
||||
expect(mockAccessService.canUser).toHaveBeenCalledWith(companyId, "person-1", "tasks:assign");
|
||||
|
||||
// An agent working for someone else may not.
|
||||
const forOther = await createApp({
|
||||
type: "agent", agentId, companyId, onBehalfOfUserId: "person-2",
|
||||
onBehalfOfMemberships: [{ companyId, membershipRole: "owner", status: "active" }],
|
||||
});
|
||||
expect((await request(forOther).patch(`/api/routines/${routineId}`).send({ title: "x" })).status).toBe(403);
|
||||
});
|
||||
|
||||
it("prevents even the assigned agent from transferring routine responsibility", async () => {
|
||||
const app = await createApp({ type: "agent", agentId, companyId });
|
||||
mockRoutineService.getDetail.mockResolvedValue(routine);
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
import { Router, type Request } from "express";
|
||||
import { z } from "zod";
|
||||
import { triggerUpdateActivityAction } from "../services/routine-trigger-update-plan.js";
|
||||
import { listProtectedEnvironmentKeyHolders, protectedEnvironmentKeyWarnings } from "../services/protected-environment-keys.js";
|
||||
import type { Db } from "@paperclipai/db";
|
||||
@@ -7,6 +8,7 @@ import {
|
||||
createDocumentAnnotationCommentSchema,
|
||||
createDocumentAnnotationThreadSchema,
|
||||
createRoutineTriggerSchema,
|
||||
ROUTINE_STATUSES,
|
||||
rotateRoutineTriggerSecretSchema,
|
||||
runRoutineSchema,
|
||||
updateDocumentAnnotationThreadSchema,
|
||||
@@ -16,11 +18,25 @@ import {
|
||||
import { trackRoutineCreated } from "@paperclipai/shared/telemetry";
|
||||
import { validate, validateIssueMutationBody } from "../middleware/validate.js";
|
||||
import { accessService, documentAnnotationService, instanceSettingsService, logActivity, routineService } from "../services/index.js";
|
||||
import { instanceSettingsService as experimentSettings } from "../services/instance-settings.js";
|
||||
import { responsibilitiesDisabledError } from "../services/responsibilities-disabled.js";
|
||||
import { agentPersonInCompany } from "./agent-person-authz.js";
|
||||
import { assertCompanyAccess, getAccessibleResource, getActorInfo, hasCompanyAccess } from "./authz.js";
|
||||
import { badRequest, forbidden, unauthorized, unprocessable, unsupportedMediaType } from "../errors.js";
|
||||
import { getTelemetryClient } from "../telemetry.js";
|
||||
import type { PluginWorkerManager } from "../services/plugin-worker-manager.js";
|
||||
|
||||
/** Filters for the routine list; all are applied in the query, before any limit. */
|
||||
const listRoutinesQuerySchema = z.object({
|
||||
projectId: z.string().optional(),
|
||||
q: z.string().trim().min(1).max(200).optional(),
|
||||
status: z.enum(ROUTINE_STATUSES).optional(),
|
||||
assigneeAgentId: z.string().guid().optional(),
|
||||
responsibleUserId: z.string().trim().min(1).max(200).optional(),
|
||||
responsibilityId: z.string().guid().optional(),
|
||||
unfiled: z.enum(["true", "false"]).optional(),
|
||||
});
|
||||
|
||||
export function routineRoutes(
|
||||
db: Db,
|
||||
options: { pluginWorkerManager?: PluginWorkerManager } = {},
|
||||
@@ -118,14 +134,37 @@ export function routineRoutes(
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* The person an agent acts for on this routine: the person who directed its
|
||||
* run, when that person is responsible for the routine. Null otherwise.
|
||||
*/
|
||||
async function agentActsForRoutinePerson(req: Request, routine: { companyId: string; responsibleUserId: string | null }) {
|
||||
const person = await agentPersonInCompany(db, req, routine.companyId);
|
||||
return person && routine.responsibleUserId === person.userId ? person.userId : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* What a person needs tasks:assign for (who runs a routine, turning it on,
|
||||
* its schedule): an agent may do it on a routine it runs and keeps running,
|
||||
* and on any other only when the person it acts for may assign tasks.
|
||||
*/
|
||||
async function assertAgentCanAssign(req: Request, routine: { companyId: string; responsibleUserId: string | null }, runsIt: boolean) {
|
||||
if (req.actor.type !== "agent" || runsIt) return;
|
||||
const actsFor = await agentActsForRoutinePerson(req, routine);
|
||||
if (!actsFor || !(await access.canUser(routine.companyId, actsFor, "tasks:assign"))) {
|
||||
throw forbidden("Agents can change who runs a routine, turn it on or change its schedule only on routines they run, unless the person they act for may assign tasks");
|
||||
}
|
||||
}
|
||||
|
||||
async function assertCanManageExistingRoutine(req: Request, routineId: string) {
|
||||
const routine = await svc.get(routineId);
|
||||
if (!routine || !hasCompanyAccess(req, routine.companyId)) return null;
|
||||
assertCompanyAccess(req, routine.companyId);
|
||||
if (req.actor.type === "board") return routine;
|
||||
if (req.actor.type !== "agent" || !req.actor.agentId) throw unauthorized();
|
||||
if (routine.assigneeAgentId !== req.actor.agentId) {
|
||||
throw forbidden("Agents can only manage routines assigned to themselves");
|
||||
// An agent manages its own routines, and those of the person its run works for.
|
||||
if (routine.assigneeAgentId !== req.actor.agentId && !(await agentActsForRoutinePerson(req, routine))) {
|
||||
throw forbidden("Agents can only manage routines assigned to themselves, or routines the person they work for is responsible for");
|
||||
}
|
||||
return routine;
|
||||
}
|
||||
@@ -162,8 +201,13 @@ export function routineRoutes(
|
||||
router.get("/companies/:companyId/routines", async (req, res) => {
|
||||
const companyId = req.params.companyId as string;
|
||||
assertCompanyAccess(req, companyId);
|
||||
const projectId = typeof req.query.projectId === "string" ? req.query.projectId : undefined;
|
||||
const result = await svc.list(companyId, { projectId });
|
||||
const { q, unfiled, ...filters } = listRoutinesQuerySchema.parse(req.query);
|
||||
// The responsibility filters read filed work, which is part of the Responsibilities experiment.
|
||||
if ((filters.responsibilityId || unfiled === "true")
|
||||
&& (await experimentSettings(db).getExperimental()).enableResponsibilities !== true) {
|
||||
throw responsibilitiesDisabledError();
|
||||
}
|
||||
const result = await svc.list(companyId, { ...filters, ...(q ? { query: q } : {}), ...(unfiled === "true" ? { unfiled: true } : {}) });
|
||||
res.json(result);
|
||||
});
|
||||
|
||||
@@ -393,21 +437,18 @@ export function routineRoutes(
|
||||
}
|
||||
if (assigneeWillChange) {
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
// Taking a routine from another agent, or handing one on, is an assignment the person must be allowed to make.
|
||||
await assertAgentCanAssign(req, routine, false);
|
||||
}
|
||||
const statusWillActivate =
|
||||
req.body.status !== undefined &&
|
||||
req.body.status === "active" &&
|
||||
routine.status !== "active";
|
||||
if (statusWillActivate) {
|
||||
if (statusWillActivate || req.body.schedule !== undefined) {
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId && !assigneeWillChange);
|
||||
}
|
||||
if (
|
||||
req.actor.type === "agent" &&
|
||||
req.body.assigneeAgentId !== undefined &&
|
||||
req.body.assigneeAgentId !== req.actor.agentId
|
||||
) {
|
||||
throw forbidden("Agents can only assign routines to themselves");
|
||||
}
|
||||
const actsFor = req.actor.type === "agent" ? await agentActsForRoutinePerson(req, routine) : null;
|
||||
const updated = await svc.update(routine.id, req.body, {
|
||||
agentId: req.actor.type === "agent" ? req.actor.agentId : null,
|
||||
userId: req.actor.type === "board" ? req.actor.userId ?? "board" : null,
|
||||
@@ -426,6 +467,7 @@ export function routineRoutes(
|
||||
entityId: routine.id,
|
||||
details: {
|
||||
title: updated?.title ?? routine.title,
|
||||
...(actsFor ? { onBehalfOfUserId: actsFor } : {}),
|
||||
...(req.body.responsibleUserId !== undefined ? {
|
||||
previousResponsibleUserId: updated?.previousResponsibleUserId,
|
||||
responsibleUserId: updated?.responsibleUserId,
|
||||
@@ -460,6 +502,10 @@ export function routineRoutes(
|
||||
return;
|
||||
}
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
// A restore can make the agent run the routine and turn it on: on a routine it does not run, the
|
||||
// person it acts for must be allowed to assign. (The service refuses any agent restore that would
|
||||
// hand the routine to another agent.)
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId);
|
||||
const result = await svc.restoreRevision(routine.id, req.params.revisionId as string, {
|
||||
agentId: req.actor.type === "agent" ? req.actor.agentId : null,
|
||||
userId: req.actor.type === "board" ? req.actor.userId ?? "board" : null,
|
||||
@@ -503,6 +549,7 @@ export function routineRoutes(
|
||||
return;
|
||||
}
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId);
|
||||
// A standing check runs on its agent's heartbeat wake-ups, which only
|
||||
// happens while the responsibilities experiment is on.
|
||||
if (req.body.kind === "heartbeat" && (await instanceSettingsService(db).getExperimental()).enableResponsibilities !== true) {
|
||||
@@ -549,6 +596,7 @@ export function routineRoutes(
|
||||
return;
|
||||
}
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId);
|
||||
const updated = await svc.updateTrigger(trigger.id, req.body, {
|
||||
agentId: req.actor.type === "agent" ? req.actor.agentId : null,
|
||||
userId: req.actor.type === "board" ? req.actor.userId ?? "board" : null,
|
||||
@@ -591,6 +639,8 @@ export function routineRoutes(
|
||||
res.status(404).json({ error: "Routine trigger not found" });
|
||||
return;
|
||||
}
|
||||
// Removing a schedule changes when the routine runs, like changing it.
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId);
|
||||
const deleted = await svc.deleteTrigger(trigger.id, {
|
||||
agentId: req.actor.type === "agent" ? req.actor.agentId : null,
|
||||
userId: req.actor.type === "board" ? req.actor.userId ?? "board" : null,
|
||||
@@ -673,6 +723,8 @@ export function routineRoutes(
|
||||
return;
|
||||
}
|
||||
await assertBoardCanAssignTasks(req, routine.companyId);
|
||||
// Starting another agent's routine starts that agent's work, as an assignment does.
|
||||
await assertAgentCanAssign(req, routine, routine.assigneeAgentId === req.actor.agentId);
|
||||
const input = req.actor.type === "agent" ? { ...req.body, source: "manual" as const } : req.body;
|
||||
const run = await svc.runRoutine(routine.id, input, {
|
||||
agentId: req.actor.type === "agent" ? req.actor.agentId : null,
|
||||
|
||||
@@ -124,7 +124,7 @@ Keep discussion here and leave the conversation available for the next message.
|
||||
/** Rendered only while the instance enables the Cases experiment. */
|
||||
export const CASES_CHAT_DIRECTIVE = `This instance has Cases enabled. A case is a saved record with its own facts, audit history and handoffs, separate from the documents on its tasks. Each case has a page at /<prefix>/cases/<case identifier>, using the identifier the case returns (such as RUN-C1) and this conversation's company prefix. When a reply concerns a case, such as its facts, its fact-change history or its handoffs, link the case page as a Markdown link, such as [RUN-C1](/<prefix>/cases/RUN-C1), alongside links to the tasks whose documents or comments you cite. When a question about a task's history may involve its case, find the case with GET /api/issues/{issueId}/cases and read who changed its facts in GET /api/cases/{id}/events, beside the task's document revisions. When the person opens a case from a brief, such as an attached file or a document here, save that brief as a document on the case's primary task with initialDocuments on POST /api/companies/{companyId}/case-handoffs, in the same request that creates the task, so it is saved before work starts. Case fields do not replace the brief: they hold the structured facts, and the document keeps the person's source for the assignee.`;
|
||||
/** Rendered only while the instance enables the Responsibilities experiment. */
|
||||
export const RESPONSIBILITIES_CHAT_DIRECTIVE = `This instance has areas and responsibilities enabled. A person's responsibilities are saved Paperclip records, grouped under areas, each with a bar (how success is measured) and the projects, tasks and routines filed under it; they are listed at /<prefix>/responsibilities. When the person mentions what they are responsible for or asks to map, sort or check work against their responsibilities or areas, read them first with list_responsibilities: it defaults to this person and also lists company work filed under no responsibility. Open one with get_responsibility, and check where a project, task or routine is filed with find_responsibilities_for. Do not ask the person what their responsibilities are or where they are written down before reading them; ask only when the list is empty. When they ask you to add, rename, move, file or let go of something, do it for them with create_area, update_area, create_responsibility, update_responsibility, file_under_responsibility and remove_from_responsibility, then say what you changed and that they can undo it from their Dashboard history. Prefer archiving or letting go over deleting; a delete waits for the person to accept a card. Link a responsibility with the href the tool returns.`;
|
||||
export const RESPONSIBILITIES_CHAT_DIRECTIVE = `This instance has areas and responsibilities enabled. A person's responsibilities are saved Paperclip records, grouped under areas, each with a bar (how success is measured) and the projects, tasks and routines filed under it; they are listed at /<prefix>/responsibilities. When the person mentions what they are responsible for or asks to map, sort or check work against their responsibilities or areas, read them first with list_responsibilities: it defaults to this person and also lists company work filed under no responsibility. Open one with get_responsibility, and check where a project, task or routine is filed with find_responsibilities_for. Do not ask the person what their responsibilities are or where they are written down before reading them; ask only when the list is empty. When they ask you to add, rename, move, file or let go of something, do it for them with create_area, update_area, create_responsibility, update_responsibility, file_under_responsibility and remove_from_responsibility (list_routines and update_routine for their routines), then say what you changed and that they can undo it from their Dashboard history. Prefer archiving or letting go over deleting; a delete waits for the person to accept a card. Link a responsibility with the href the tool returns.`;
|
||||
/** Rendered while the Responsibilities experiment is off, so an agent can tell "turned off" from "none". */
|
||||
export const RESPONSIBILITIES_OFF_CHAT_DIRECTIVE = RESPONSIBILITIES_OFF_GUIDANCE;
|
||||
/** Rendered only while the instance enables the Status Cards experiment. */
|
||||
|
||||
@@ -211,10 +211,10 @@ describe("PaperclipRunnerToolAuthority", () => {
|
||||
issueId,
|
||||
runId,
|
||||
});
|
||||
expect(authority.definitions()).toHaveLength(54);
|
||||
expect(authority.definitions()).toHaveLength(56);
|
||||
expect(authority.definitions().map(tool => tool.name)).toEqual(expect.arrayContaining([
|
||||
"get_workspace", "list_workspaces", "select_workspace", "prepare_repository",
|
||||
"search_skills", "load_skill",
|
||||
"search_skills", "load_skill", "list_routines", "update_routine",
|
||||
]));
|
||||
// The read-only response export is its own tool, so call_api offers no save flag on writes.
|
||||
const save = authority.definitions().find(tool => tool.name === "save_api_response")!;
|
||||
|
||||
@@ -51,6 +51,7 @@ import { handoffPlanContext } from "./handoff-plan-context.js";
|
||||
import { callCreateSkillTool, callUpdateSkillTool } from "../skill-tools.js";
|
||||
import { callProjectTool } from "../project-tools.js";
|
||||
import { callResponsibilityTool, isResponsibilityTool, RESPONSIBILITY_TOOL_NAMES, responsibilityToolsDisabledError } from "../responsibility-tools.js";
|
||||
import { callRoutineTool, ROUTINE_TOOL_NAMES } from "../routine-tools.js";
|
||||
import { isConnectorTool, executeConnectorTool, type ConnectorAssignment } from "../connector-runtime.js";
|
||||
import { resolveNativeRuntimeMcpSnapshot } from "./runtime-context.js";
|
||||
import { connectionIntentService } from "../connection-intents.js";
|
||||
@@ -160,7 +161,7 @@ const IMPLEMENTED_OPERATIONS = new Set([
|
||||
"get_workspace", "list_workspaces", "select_workspace", "prepare_repository", "create_skill", "update_skill", "create_task", "reassign_task", "set_dependencies", "create_project", "list_project_repositories", "list_projects", "register_deliverable",
|
||||
"list_documents", "read_document", "list_document_revisions", "write_document",
|
||||
"list_agents", "get_agent", "list_approvals", "get_approval", "get_approval_context",
|
||||
...RESPONSIBILITY_TOOL_NAMES,
|
||||
...RESPONSIBILITY_TOOL_NAMES, ...ROUTINE_TOOL_NAMES,
|
||||
]);
|
||||
|
||||
/** Closed first-party native Muse profile. No connector, generic API, credential or workspace grants. */
|
||||
@@ -982,6 +983,14 @@ export class PaperclipRunnerToolAuthority {
|
||||
companyId: this.binding.companyId, issueId: this.binding.issueId, agentId: this.binding.agentId,
|
||||
companyPrefix: await this.#companyPagePrefix() });
|
||||
}
|
||||
case "list_routines":
|
||||
case "update_routine": {
|
||||
const apiUrl = this.binding.apiUrl ?? process.env.PAPERCLIP_API_URL;
|
||||
const token = this.#apiToken(context);
|
||||
if (!apiUrl || !token) throw new Error("Routine tool authentication is unavailable");
|
||||
return callRoutineTool({ name: call.tool, arguments: input, apiUrl, token,
|
||||
companyId: this.binding.companyId, companyPrefix: await this.#companyPagePrefix() });
|
||||
}
|
||||
case "search_api": return withCompanyPagePaths(searchRunnerApi(call.arguments), await this.#companyPagePrefix());
|
||||
case "hire_agent": {
|
||||
return hireAgentResult(await this.#callApi(call.callId, hireAgentApiRequest(input, this.binding)), context.actor.adapterConfig?.provider);
|
||||
|
||||
@@ -58,6 +58,10 @@ function dedicatedTools(method: string, path: string): string[] {
|
||||
if (/\/companies\/\{[^}]+\}\/agent-hires$/.test(path) && method === "POST") return ["hire_agent"];
|
||||
if (/\/projects$/.test(path)) return method === "GET" ? ["list_projects"] : method === "POST" ? ["create_project"] : [];
|
||||
if (/\/project-repositories$/.test(path) && method === "GET") return ["list_project_repositories"];
|
||||
if (/\/companies\/\{[^}]+\}\/routines$/.test(path) && method === "GET") return ["list_routines"];
|
||||
if (/\/routines\/\{[^}]+\}$/.test(path) && method === "PATCH") return ["update_routine"];
|
||||
if (/\/routines\/\{[^}]+\}\/triggers$/.test(path) && method === "POST") return ["update_routine"];
|
||||
if (/\/routine-triggers\/\{[^}]+\}$/.test(path) && method === "PATCH") return ["update_routine"];
|
||||
if (/\/companies\/\{[^}]+\}\/responsibilities$/.test(path)) return method === "GET" ? ["list_responsibilities"] : method === "POST" ? ["create_responsibility"] : [];
|
||||
if (/\/companies\/\{[^}]+\}\/responsibility-areas$/.test(path)) return method === "GET" ? ["list_responsibilities"] : method === "POST" ? ["create_area"] : [];
|
||||
if (/\/responsibility-areas\/\{[^}]+\}$/.test(path)) return method === "PATCH" ? ["update_area"] : method === "DELETE" ? ["delete_area"] : [];
|
||||
|
||||
@@ -0,0 +1,205 @@
|
||||
import {
|
||||
ISSUE_PRIORITIES,
|
||||
ROUTINE_STATUSES,
|
||||
routineSuggestionCadenceLabel,
|
||||
routineSuggestionCadenceSchema,
|
||||
routineSuggestionCronExpression,
|
||||
type RoutineDetail,
|
||||
type RoutineListItem,
|
||||
type RoutineTrigger,
|
||||
} from "@paperclipai/shared";
|
||||
import { z } from "zod";
|
||||
import { HttpError } from "../errors.js";
|
||||
import { fetchPaperclipApi } from "./paperclip-api-loopback.js";
|
||||
|
||||
/**
|
||||
* Native agent tools for routines. Like the responsibility tools they call the
|
||||
* authenticated HTTP API with the run's agent token, so the routine routes'
|
||||
* rules apply: an agent manages its own routines and those of the person who
|
||||
* directed its run (when that person is responsible for them). A change to a
|
||||
* routine and its schedule is one routine revision the person can restore;
|
||||
* filing it under a responsibility is saved in their Dashboard history.
|
||||
*/
|
||||
export const ROUTINE_TOOL_NAMES = ["list_routines", "update_routine"] as const;
|
||||
export type RoutineToolName = (typeof ROUTINE_TOOL_NAMES)[number];
|
||||
|
||||
export function isRoutineTool(name: string): name is RoutineToolName {
|
||||
return (ROUTINE_TOOL_NAMES as readonly string[]).includes(name);
|
||||
}
|
||||
|
||||
const uuid = z.string().guid();
|
||||
|
||||
export const listRoutinesToolInput = z.object({
|
||||
query: z.string().trim().min(1).max(200).optional(),
|
||||
status: z.enum(ROUTINE_STATUSES).optional(),
|
||||
assigneeAgentId: uuid.optional(),
|
||||
projectId: uuid.optional(),
|
||||
responsibleUserId: z.string().trim().min(1).max(200).optional(),
|
||||
responsibilityId: uuid.optional(),
|
||||
unfiled: z.boolean().optional(),
|
||||
limit: z.number().int().min(1).max(200).optional().default(50),
|
||||
}).strict();
|
||||
|
||||
/** A cadence (the same one routine offers use) plus an optional IANA time zone. */
|
||||
function parseSchedule(value: unknown) {
|
||||
const { timezone, ...cadence } = z.object({ timezone: z.string().trim().min(1).max(100).optional() }).loose().parse(value);
|
||||
return { ...routineSuggestionCadenceSchema.parse(cadence), timezone };
|
||||
}
|
||||
|
||||
export const updateRoutineToolInput = z.object({
|
||||
routineId: uuid,
|
||||
title: z.string().trim().min(1).max(200).optional(),
|
||||
instructions: z.string().max(200_000).nullable().optional(),
|
||||
assigneeAgentId: uuid.nullable().optional(),
|
||||
projectId: uuid.nullable().optional(),
|
||||
status: z.enum(ROUTINE_STATUSES).optional(),
|
||||
priority: z.enum(ISSUE_PRIORITIES).optional(),
|
||||
schedule: z.unknown().optional(),
|
||||
fileUnder: uuid.optional(),
|
||||
}).strict();
|
||||
|
||||
/** What a write reports beside its body: the Dashboard version it saved, if any, and whose Dashboard it is. */
|
||||
type ApiMeta = { version?: string | null; owner?: string | null };
|
||||
type ApiCall = (method: "GET" | "POST" | "PATCH", path: string, body?: unknown, meta?: ApiMeta) => Promise<unknown>;
|
||||
|
||||
function apiCaller(input: { apiUrl: string; token: string }, fetcher: typeof fetch): ApiCall {
|
||||
return async (method, path, body, meta) => {
|
||||
const response = await fetchPaperclipApi({ ...input, method, path, body, fetcher });
|
||||
const result = await response.json().catch(() => ({}));
|
||||
if (meta) {
|
||||
meta.version = response.headers.get("x-paperclip-dashboard-version");
|
||||
meta.owner = response.headers.get("x-paperclip-dashboard-owner");
|
||||
}
|
||||
if (!response.ok) {
|
||||
throw new HttpError(response.status, typeof result?.error === "string" ? result.error : `Routine tool failed (${response.status})`,
|
||||
typeof result?.code === "string" ? { code: result.code } : undefined);
|
||||
}
|
||||
return result;
|
||||
};
|
||||
}
|
||||
|
||||
function pageHref(prefix: string | null | undefined, path: string) {
|
||||
return prefix ? `/${encodeURIComponent(prefix)}${path}` : null;
|
||||
}
|
||||
|
||||
type ScheduleTrigger = Pick<RoutineTrigger, "id" | "kind" | "enabled" | "cronExpression" | "timezone" | "nextRunAt"> & { label?: string | null; archived?: boolean };
|
||||
|
||||
function schedules(triggers: readonly ScheduleTrigger[]) {
|
||||
return triggers.filter((trigger) => !trigger.archived).map((trigger) => ({
|
||||
triggerId: trigger.id, kind: trigger.kind, enabled: trigger.enabled,
|
||||
cronExpression: trigger.cronExpression, timezone: trigger.timezone, nextRunAt: trigger.nextRunAt,
|
||||
}));
|
||||
}
|
||||
|
||||
async function listRoutines(call: ApiCall, companyId: string, args: unknown, prefix: string | null | undefined) {
|
||||
const input = listRoutinesToolInput.parse(args);
|
||||
// Every filter runs in the routine list's query, so nothing is cut before it is matched.
|
||||
const params = new URLSearchParams();
|
||||
if (input.query) params.set("q", input.query);
|
||||
for (const key of ["status", "assigneeAgentId", "projectId", "responsibleUserId", "responsibilityId"] as const) {
|
||||
const value = input[key];
|
||||
if (value) params.set(key, value);
|
||||
}
|
||||
if (input.unfiled) params.set("unfiled", "true");
|
||||
const query = params.toString() ? `?${params}` : "";
|
||||
const matches = await call("GET", `/companies/${encodeURIComponent(companyId)}/routines${query}`) as RoutineListItem[];
|
||||
return {
|
||||
total: matches.length,
|
||||
routines: matches.slice(0, input.limit).map((routine) => ({
|
||||
id: routine.id,
|
||||
title: routine.title,
|
||||
status: routine.status,
|
||||
assigneeAgentId: routine.assigneeAgentId,
|
||||
projectId: routine.projectId,
|
||||
responsibleUserId: routine.responsibleUserId,
|
||||
triggers: schedules(routine.triggers),
|
||||
lastRun: routine.lastRun ? { status: routine.lastRun.status, at: routine.lastRun.triggeredAt } : null,
|
||||
href: pageHref(prefix, `/routines/${encodeURIComponent(routine.id)}`),
|
||||
})),
|
||||
truncated: matches.length > input.limit,
|
||||
};
|
||||
}
|
||||
|
||||
function errorMessage(error: unknown) {
|
||||
return error instanceof Error ? error.message : String(error);
|
||||
}
|
||||
|
||||
async function updateRoutine(call: ApiCall, args: unknown, prefix: string | null | undefined) {
|
||||
const input = updateRoutineToolInput.parse(args);
|
||||
const schedule = input.schedule === undefined || input.schedule === null ? input.schedule : parseSchedule(input.schedule);
|
||||
const id = encodeURIComponent(input.routineId);
|
||||
const before = await call("GET", `/routines/${id}`) as RoutineDetail;
|
||||
const patch: Record<string, unknown> = {};
|
||||
if (input.title !== undefined) patch.title = input.title;
|
||||
if (input.instructions !== undefined) patch.description = input.instructions;
|
||||
for (const key of ["assigneeAgentId", "projectId", "status", "priority"] as const) {
|
||||
if (input[key] !== undefined) patch[key] = input[key];
|
||||
}
|
||||
if (schedule !== undefined) {
|
||||
// Without a zone the server keeps the current schedule's, else uses the person's own.
|
||||
patch.schedule = schedule === null ? null
|
||||
: { cronExpression: routineSuggestionCronExpression(schedule), ...(schedule.timezone ? { timezone: schedule.timezone } : {}) };
|
||||
}
|
||||
if (Object.keys(patch).length === 0 && !input.fileUnder) {
|
||||
throw new HttpError(422, "Send at least one field to change");
|
||||
}
|
||||
// The fields and the schedule are one change and one revision; a change made since `before` makes it fail instead of mixing.
|
||||
if (Object.keys(patch).length > 0) {
|
||||
await call("PATCH", `/routines/${id}`, { ...patch, baseRevisionId: before.latestRevisionId });
|
||||
}
|
||||
// Filing is a separate change in the person's Dashboard history. If it fails after the routine changed, say what was saved.
|
||||
let filedUnder: Record<string, unknown> | null = null;
|
||||
if (input.fileUnder) {
|
||||
const meta: ApiMeta = {};
|
||||
try {
|
||||
await call("POST", `/responsibilities/${encodeURIComponent(input.fileUnder)}/file`, { items: [{ kind: "routine", id: input.routineId }] }, meta);
|
||||
filedUnder = {
|
||||
responsibilityId: input.fileUnder,
|
||||
undo: meta.version
|
||||
? "Saved as a version in the Dashboard history of the person in dashboardOwnerUserId, where they can undo it; remove_from_responsibility also unfiles it."
|
||||
: "Not in the person's Dashboard history; remove_from_responsibility unfiles it.",
|
||||
...(meta.version ? { dashboardVersionId: meta.version, dashboardOwnerUserId: meta.owner ?? null } : {}),
|
||||
};
|
||||
} catch (error) {
|
||||
if (Object.keys(patch).length === 0) throw error;
|
||||
filedUnder = { responsibilityId: input.fileUnder, failed: true, error: errorMessage(error), note: "The routine change above was saved; only the filing failed." };
|
||||
}
|
||||
}
|
||||
const after = await call("GET", `/routines/${id}`) as RoutineDetail;
|
||||
const enabledSchedules = (triggers: readonly ScheduleTrigger[]) =>
|
||||
triggers.filter((trigger) => trigger.kind === "schedule" && trigger.enabled && !trigger.archived);
|
||||
const current = enabledSchedules(after.triggers)[0];
|
||||
return {
|
||||
routine: {
|
||||
id: after.id, title: after.title, status: after.status, assigneeAgentId: after.assigneeAgentId,
|
||||
projectId: after.projectId, priority: after.priority, responsibleUserId: after.responsibleUserId,
|
||||
triggers: schedules(after.triggers), revision: after.latestRevisionNumber,
|
||||
href: pageHref(prefix, `/routines/${encodeURIComponent(after.id)}`),
|
||||
},
|
||||
...(schedule === null ? { schedule: { turnedOff: enabledSchedules(before.triggers).length } } : {}),
|
||||
...(schedule && current ? {
|
||||
schedule: { label: routineSuggestionCadenceLabel(schedule), cronExpression: current.cronExpression, timezone: current.timezone },
|
||||
} : {}),
|
||||
...(filedUnder ? { filedUnder } : {}),
|
||||
...(after.latestRevisionNumber !== before.latestRevisionNumber ? {
|
||||
undo: `The routine${schedule !== undefined ? " and its schedule" : ""} saved as revision ${after.latestRevisionNumber}; restoring revision ${before.latestRevisionNumber} from the routine's history undoes that${input.fileUnder ? " (not the filing; see filedUnder)" : ""}.`,
|
||||
} : {}),
|
||||
};
|
||||
}
|
||||
|
||||
/** All transports use the normal authenticated API, including its validation and audit path. */
|
||||
export async function callRoutineTool(input: {
|
||||
name: RoutineToolName;
|
||||
arguments: Record<string, unknown>;
|
||||
apiUrl: string;
|
||||
token: string;
|
||||
companyId: string;
|
||||
/** The company's issue prefix; results then carry page hrefs. */
|
||||
companyPrefix?: string | null;
|
||||
}, fetcher: typeof fetch = fetch) {
|
||||
const call = apiCaller(input, fetcher);
|
||||
switch (input.name) {
|
||||
case "list_routines": return listRoutines(call, input.companyId, input.arguments, input.companyPrefix);
|
||||
case "update_routine": return updateRoutine(call, input.arguments, input.companyPrefix);
|
||||
}
|
||||
}
|
||||
@@ -8,7 +8,7 @@ import { verifyAppWebhook } from "./app-webhook.js";
|
||||
import { authenticateWebhookCreationRun, validateCreationRun } from "./task-creation-provenance.js";
|
||||
import crypto from "node:crypto";
|
||||
import { verifyFirefliesWebhook } from "./fireflies-webhook.js";
|
||||
import { and, asc, desc, eq, gt, inArray, isNotNull, isNull, lte, ne, not, or, sql } from "drizzle-orm";
|
||||
import { and, asc, desc, eq, gt, inArray, isNotNull, isNull, lte, ne, not, or, sql, type SQL } from "drizzle-orm";
|
||||
import type { Db } from "@paperclipai/db";
|
||||
import {
|
||||
agents,
|
||||
@@ -28,12 +28,15 @@ import {
|
||||
pluginManagedResources,
|
||||
plugins,
|
||||
projects,
|
||||
responsibilities,
|
||||
responsibilityLinks,
|
||||
routineRevisions,
|
||||
routineRuns,
|
||||
routineDocuments,
|
||||
routines,
|
||||
routineTriggers,
|
||||
routineWebhookTestReceipts,
|
||||
userWorkspacePreferences,
|
||||
} from "@paperclipai/db";
|
||||
import type {
|
||||
CreateRoutine,
|
||||
@@ -1035,6 +1038,64 @@ export function routineService(
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Makes `schedule` the routine's one enabled schedule trigger, reusing its
|
||||
* first one, or turns every schedule off for null. Runs under the routine's
|
||||
* lock, so two changes cannot both add a schedule. Returns whether anything
|
||||
* changed; the caller saves the revision.
|
||||
*/
|
||||
async function replaceSchedule(
|
||||
txDb: Db,
|
||||
routine: Pick<RoutineRow, "id" | "companyId" | "responsibleUserId">,
|
||||
requested: { cronExpression: string; timezone?: string } | null,
|
||||
actor: Actor,
|
||||
) {
|
||||
const existing = await txDb.select().from(routineTriggers)
|
||||
.where(and(eq(routineTriggers.routineId, routine.id), eq(routineTriggers.kind, "schedule"), eq(routineTriggers.archived, false)))
|
||||
.orderBy(desc(routineTriggers.enabled), asc(routineTriggers.createdAt), asc(routineTriggers.id));
|
||||
const now = new Date();
|
||||
const by = { updatedByAgentId: actor.agentId ?? null, updatedByUserId: actor.userId ?? null, updatedAt: now };
|
||||
let changed = false;
|
||||
const [first] = existing;
|
||||
const keep = requested ? first?.id ?? null : null;
|
||||
if (requested) {
|
||||
// A time with no zone keeps the current schedule's, else is in the responsible person's own zone.
|
||||
const known = requested.timezone || first?.timezone || null;
|
||||
const timezone = known ?? (!routine.responsibleUserId ? null : await txDb
|
||||
.select({ timeZone: userWorkspacePreferences.timeZone })
|
||||
.from(userWorkspacePreferences)
|
||||
.where(eq(userWorkspacePreferences.userId, routine.responsibleUserId))
|
||||
.then((rows) => rows[0]?.timeZone ?? null));
|
||||
if (!timezone) {
|
||||
throw unprocessable("Name a time zone for this schedule: the routine has no schedule yet and its person has no time zone saved");
|
||||
}
|
||||
assertTimeZone(timezone);
|
||||
const schedule = { cronExpression: requested.cronExpression, timezone };
|
||||
const nextRunAt = nextCronTickInTimeZone(schedule.cronExpression, schedule.timezone, now);
|
||||
if (!first) {
|
||||
await txDb.insert(routineTriggers).values({
|
||||
companyId: routine.companyId, routineId: routine.id, kind: "schedule", label: null, enabled: true,
|
||||
cronExpression: schedule.cronExpression, timezone: schedule.timezone, nextRunAt,
|
||||
createdByAgentId: actor.agentId ?? null, createdByUserId: actor.userId ?? null,
|
||||
updatedByAgentId: actor.agentId ?? null, updatedByUserId: actor.userId ?? null,
|
||||
});
|
||||
changed = true;
|
||||
} else if (!first.enabled || first.cronExpression !== schedule.cronExpression || first.timezone !== schedule.timezone) {
|
||||
await txDb.update(routineTriggers)
|
||||
.set({ enabled: true, cronExpression: schedule.cronExpression, timezone: schedule.timezone, nextRunAt, ...by })
|
||||
.where(eq(routineTriggers.id, first.id));
|
||||
changed = true;
|
||||
}
|
||||
}
|
||||
// One schedule: the others are turned off (a restore can turn them back on), so it does not also run at an old time.
|
||||
const turnOff = existing.filter((trigger) => trigger.enabled && trigger.id !== keep).map((trigger) => trigger.id);
|
||||
if (turnOff.length > 0) {
|
||||
await txDb.update(routineTriggers).set({ enabled: false, ...by }).where(inArray(routineTriggers.id, turnOff));
|
||||
changed = true;
|
||||
}
|
||||
return changed;
|
||||
}
|
||||
|
||||
async function assertRoutineAccess(companyId: string, routineId: string) {
|
||||
const routine = await getRoutineById(routineId);
|
||||
if (!routine) throw notFound("Routine not found");
|
||||
@@ -2110,10 +2171,36 @@ export function routineService(
|
||||
|
||||
list: async (
|
||||
companyId: string,
|
||||
filters?: { projectId?: string | null },
|
||||
filters?: {
|
||||
projectId?: string | null;
|
||||
/** Words in the title or description, ignoring case. */
|
||||
query?: string;
|
||||
status?: string;
|
||||
assigneeAgentId?: string;
|
||||
responsibleUserId?: string;
|
||||
/** Filed under this responsibility, directly or through its project. */
|
||||
responsibilityId?: string;
|
||||
/** Filed under no proposed or active responsibility, directly or through its project. */
|
||||
unfiled?: boolean;
|
||||
},
|
||||
): Promise<RoutineListItem[]> => {
|
||||
const conditions = [eq(routines.companyId, companyId)];
|
||||
if (filters?.projectId) conditions.push(eq(routines.projectId, filters.projectId));
|
||||
if (filters?.query) {
|
||||
const pattern = `%${filters.query.replace(/[\\%_]/g, (char) => `\\${char}`)}%`;
|
||||
conditions.push(or(sql`${routines.title} ilike ${pattern}`, sql`coalesce(${routines.description}, '') ilike ${pattern}`)!);
|
||||
}
|
||||
if (filters?.status) conditions.push(eq(routines.status, filters.status));
|
||||
if (filters?.assigneeAgentId) conditions.push(eq(routines.assigneeAgentId, filters.assigneeAgentId));
|
||||
if (filters?.responsibleUserId) conditions.push(eq(routines.responsibleUserId, filters.responsibleUserId));
|
||||
// The same "filed" rule as a responsibility's detail and its loose work: a link to the routine or to its project.
|
||||
const filedUnder = (responsibility: SQL) => sql`exists (
|
||||
select 1 from ${responsibilityLinks} fl
|
||||
join ${responsibilities} fr on fr.id = fl.responsibility_id
|
||||
where ${responsibility} and fr.company_id = ${companyId}
|
||||
and (fl.routine_id = ${routines.id} or (${routines.projectId} is not null and fl.project_id = ${routines.projectId})))`;
|
||||
if (filters?.responsibilityId) conditions.push(filedUnder(sql`fr.id = ${filters.responsibilityId}`));
|
||||
if (filters?.unfiled) conditions.push(sql`not ${filedUnder(sql`fr.status in ('proposed', 'active')`)}`);
|
||||
|
||||
const rows = await db
|
||||
.select()
|
||||
@@ -2517,6 +2604,12 @@ export function routineService(
|
||||
if (patch.goalId) await assertGoal(existing.companyId, patch.goalId);
|
||||
if (patch.parentIssueId) await assertParentIssue(existing.companyId, patch.parentIssueId);
|
||||
assertRoutineVariableDefinitions(nextVariables);
|
||||
if (patch.schedule) {
|
||||
if (patch.schedule.timezone) assertTimeZone(patch.schedule.timezone);
|
||||
const cronError = validateCron(patch.schedule.cronExpression);
|
||||
if (cronError) throw unprocessable(cronError);
|
||||
assertScheduleCompatibleVariables(nextVariables);
|
||||
}
|
||||
const enabledScheduleTriggers = await db
|
||||
.select({ id: routineTriggers.id })
|
||||
.from(routineTriggers)
|
||||
@@ -2604,8 +2697,12 @@ export function routineService(
|
||||
updatedByUserId: actor.userId ?? null,
|
||||
};
|
||||
|
||||
// The schedule changes under the same lock and in the same revision as the fields.
|
||||
// With the routine as it will be saved, so a schedule without a zone uses the new responsible person's.
|
||||
const scheduleChanged = patch.schedule !== undefined && await replaceSchedule(txDb, candidate, patch.schedule, actor);
|
||||
const fieldsMatch = routineCurrentFieldsMatch(locked, candidate);
|
||||
const folderChanged = patch.folderId !== undefined && locked.folderId !== candidate.folderId;
|
||||
if (locked.latestRevisionId && routineCurrentFieldsMatch(locked, candidate)) {
|
||||
if (locked.latestRevisionId && fieldsMatch && !scheduleChanged) {
|
||||
if (!folderChanged) return locked;
|
||||
const [updated] = await txDb
|
||||
.update(routines)
|
||||
@@ -2673,7 +2770,7 @@ export function routineService(
|
||||
.returning();
|
||||
if (!updated) return null;
|
||||
const { routine } = await appendRoutineRevision(txDb, updated, actor, {
|
||||
changeSummary: "Updated routine",
|
||||
changeSummary: !scheduleChanged ? "Updated routine" : fieldsMatch ? "Updated schedule" : "Updated routine and schedule",
|
||||
});
|
||||
if (patch.env !== undefined) {
|
||||
await secretsSvc.syncEnvBindingsForTarget(
|
||||
|
||||
@@ -287,6 +287,7 @@ To change them, you act for the person your run works for when they directed it:
|
||||
- `create_area`, `update_area` (rename, describe, reorder, archive or restore) and `delete_area`.
|
||||
- `create_responsibility` (a title is enough; `areaTitle` reuses or creates the area; `fileItems` files work under it), `update_responsibility` (title, sentence, metric as `bar`, area, the agent that runs it, health override, or status such as `let_go`) and `delete_responsibility`.
|
||||
- `file_under_responsibility` files projects, tasks and routines in one step; `moveFrom` (a responsibility ID, or `all`) makes it a move. `remove_from_responsibility` unfiles items; no link IDs are needed.
|
||||
- To map routines to responsibilities, read them with `list_routines` (`unfiled: true` lists those under no responsibility; add `status: "active"` for the running ones), then file them; `update_routine` also changes a routine's schedule, agent or instructions (see `references/routines.md`).
|
||||
|
||||
Each change is saved as a version in the person's Dashboard history, where they can undo it; say so when you report what you changed. Prefer what can be undone: archive an area or let a responsibility go instead of deleting it. A delete is permanent, so the first call posts a confirmation card and returns `awaiting_confirmation`: tell the person, then stop; when they accept you are woken, and the same call deletes. Otherwise (a task someone else made for them, a routine, or no person), your changes are saved as proposals for a person to confirm.
|
||||
|
||||
|
||||
@@ -1479,7 +1479,7 @@ Terminal states: `done`, `cancelled`
|
||||
|
||||
| Method | Path | Description |
|
||||
| ------ | ---- | ----------- |
|
||||
| GET | `/api/companies/:companyId/routines` | List all routines in company |
|
||||
| GET | `/api/companies/:companyId/routines` | List the company's routines. Optional filters, all applied before any limit: `projectId`, `q` (words in the title or description), `status`, `assigneeAgentId`, `responsibleUserId`, `responsibilityId` (filed under it, directly or through its project), `unfiled=true` (under no proposed or active responsibility); those two need Responsibilities on |
|
||||
| GET | `/api/routines/:routineId` | Routine details including triggers |
|
||||
| POST | `/api/companies/:companyId/routines` | Create routine (`assigneeAgentId` + `projectId` required; agents: own only) |
|
||||
| PATCH | `/api/routines/:routineId` | Update routine (agents: own only, cannot reassign) |
|
||||
|
||||
@@ -9,7 +9,9 @@ A routine has:
|
||||
- A catch-up policy (what to do with missed scheduled runs)
|
||||
- An activity gate policy (whether quiet scheduled ticks should be skipped)
|
||||
|
||||
**Authorization:** Agents can read all routines in their company but can only create or manage routines assigned to themselves. Board operators have full access, including reassignment.
|
||||
**Authorization:** Agents can read all routines in their company. They can create routines assigned to themselves, and manage routines assigned to themselves or routines the person their run works for is responsible for. Handing a routine to another agent needs that person to be allowed to assign work. Board operators have full access, including reassignment.
|
||||
|
||||
**Dedicated tools:** prefer `list_routines` (filter by words, status, agent, project, responsible person, a responsibility, or `unfiled`) and `update_routine` (title, instructions, agent, project, status, priority, a plain `schedule` such as `{ frequency: "weekly", dayOfWeek: "monday", time: "09:00", timezone }` or `null` to turn it off, and `fileUnder` a responsibility). The routine and its schedule change together as one routine revision the person can restore from the routine's history; filing is saved separately in their Dashboard history (`filedUnder.undo`). Say which when you report it. Without a `timezone`, a schedule keeps the routine's current zone, else uses the person's own. On a routine you do not run, changing its agent, turning it on or changing its schedule needs the person you act for to be allowed to assign work. The routes below remain for everything else; `PATCH /api/routines/{id}` also takes `schedule: { cronExpression, timezone? }` or `null`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -526,7 +526,7 @@
|
||||
"packages/shared/src/validators/resource-memberships.ts": "b124ac8a8f24b4dbb03ae82bcc87541f6b4ecdfd",
|
||||
"packages/shared/src/validators/responsibility.ts": "b466feab326f0ec79754962761a2fd0c26594221",
|
||||
"packages/shared/src/validators/routine.test.ts": "1501907ade577c1ab4c4b3098397e5d080446878",
|
||||
"packages/shared/src/validators/routine.ts": "95f04abf9cbafad8ad121ece7642b8cba1a6eb36",
|
||||
"packages/shared/src/validators/routine.ts": "01f8adabca5e89784515e55bec964013c225415a",
|
||||
"packages/shared/src/validators/runtime-exposure.test.ts": "31175388dbab9f3d5dba920cd711ea6e0e6c6ece",
|
||||
"packages/shared/src/validators/runtime-exposure.ts": "362cfc4721581beb4f495987bde60028e6f390f0",
|
||||
"packages/shared/src/validators/search.ts": "3b81dae383682c42f0582b644009b520da4031dc",
|
||||
|
||||
Reference in new issue
Block a user