Files
PaperClipAI/packages/paperclip-runner/docs/capability-contract.md
T
DottaandPaperclip 505e1a5582 feat(cases): add persistent workflows with same-task agent handoffs (#16959)
## Thinking Path

> - Paperclip manages AI agents and their work.
> - An agent workflow needs persistent facts and a safe way to transfer
work.
> - Creating a task for each phase splits the objective, discussion,
workspace, and review policy.
> - A case can retain the facts while one primary task moves between
agents.
> - Transfers must survive process failure and preserve private access,
budgets, and completion gates.
> - This pull request adds durable case handoffs, native case tools, and
read-only case pages.
> - Prompts describe the workflow. Existing task controls decide when
work can run and finish.

## Linked Issues or Issue Description

**Problem or motivation**

Prompt-driven agent teams need a persistent record that can move through
triage, implementation, verification, and correction. Ordinary
reassignment does not provide a durable instruction, safe release
barrier, or recoverable delivery receipt for an agent handing off its
own running task.

**Proposed solution**

Extend standalone cases with one primary task, a descriptive phase,
retained access sources, and a handoff ledger. Apply assignments after
source execution and workspace settlement. Deliver each transfer through
the existing durable wake queue. Provide `create_case`, `read_case`,
`update_case`, and `handoff_case` in the native runner. Creation
requires kickoff and explicit workflow text. An explicit handoff to
`done` closes the case when normal task completion is accepted.

**Alternatives considered**

Do not add a workflow engine, filesystem queue, configured state graph,
or one task per phase. The workflow document combines transition prose
with an optional Mermaid `stateDiagram-v2` map. The server does not
execute the diagram. The Pipelines experiment removed on master stays
removed.

**Roadmap alignment**

This extends Agent Reviews and Approvals, Enforced Outcomes, Bounded Run
Recovery, and Activity Log attribution. Existing approval, review,
budget, privacy, workspace, and responsible-user rules remain
authoritative.

Related work: [ordinary handoff wake
recovery](https://github.com/paperclipai/paperclip/pull/15019). This
feature adds a separate persisted case-handoff receipt and release
barrier.

## What Changed

- Add case routing fields, retained access sources, durable handoff
history, delivery leases, and replay-safe migrations.
- Keep the same primary task across agent phases. Preserve each
returning agent's own session and the task's workspace.
- Fence outgoing mutations, wait for provider and workspace release, and
recover delivery without duplicate task comments or runs. Recheck
current assignment permissions as the original caller before applying a
delayed transfer. Scope a run Stop to that run’s own handoff intents, so
repeated old Stop requests preserve newer work. Cancelling terminal
intent without a source run also requires fenced current task ownership,
including native retries and preparation with an old checkout. For Cloud
callers, revalidate current stack membership with an uncached Cloud RPC
and derive owner elevation from the current managed setting.
- Keep case reads, documents, assets, Audit, and live events inside
retained task/project permissions.
- Add native case creation/read/update/handoff tools. Store required
workflow text and initial documents on the first task. Page oversized
case facts and referenced document bodies through the dedicated tool
with bounded UTF-8 JSON, current routing versions, snapshot conflicts,
and current source authorization on every page.
- Add read-only case lists and detail pages, task-style list controls,
compact dotted field tables, linked handoff tasks, and case filters in
Audit.
- Add native/legacy integration tests, migration/restart tests, browser
coverage, and bounded live receipt fixtures. Extend the trusted sandbox
condition to cover the new subscription fixture profile.
- Hide obsolete paused-agent warnings on completed or cancelled task
threads.
- Synchronize the company-switch settings test with React effects after
a CI failure. Preserve its security assertions and production remount
behavior.

## Verification

The branch directly includes master `9ef434fe79`. The required `ci /
verify` and `ci / e2e` gates pass on head `765fccd67c`. [Current-head
CI](https://github.com/paperclipai/paperclip/actions/runs/39464348614)
passes typecheck, build, tests, and all eight browser shards. Security
checks pass. [Greptile gives this exact head
5/5](https://github.com/paperclipai/paperclip/pull/16959#issuecomment-6291156549),
with no unresolved review threads. The optional Paperclip Review check
remains queued because its assigned agent is paused. It is not a
required branch check. No check result was overridden.

Local workspace typecheck and build pass after the master merge, along
with database migration checks, token gates, map checks, Storybook
catalog checks, and the Copilot profile identity check. Standard builds
refresh Runner vendor output. Focused checks pass 2,008
API/paging/context tests and 7 strict case protocol tests. The final
commit changes one test fixture only; its ten tests, UI typecheck, and
token gates pass. No production source changed in that commit.

On current head `765fccd67c`, all **194 critical workflow tests**
executed and passed with no skipped tests in those files:

- 38 Stop/ownership tests, including board completion intent, native
retries, stale Stop, and preparation with an old checkout.
- 2 actual legacy process/HTTP handoff tests, including scratch failure,
a closed-stdio child that continues writing, and recovery through a
fresh worker after the process group stops.
- 5 migration tests, including SQL column metadata, preserved null
authority context, and all six prior-numbering receipts.
- 3 process-settlement and 5 scratch tests.
- 88 handoff-service, 18 heartbeat handoff, and 21 native case-tool
integration tests.
- 7 bounded case/document-read projection tests and 7 strict
protocol-contract tests.

The current CI checkout was `fed65d49`, merging `765fccd67c` into master
`9ef434fe79`. Its new document regressions reconstruct exact
Unicode/escaped bodies and revisions through real native authority and
authenticated HTTP with generic API tools disabled. They cover
case-owned, primary-task, and linked-task documents; routing on every
page; stale document snapshots; access loss and unlinking;
unrelated/foreign/private sources; system documents; and quarantined
content. Active-task document tools retain their existing behavior.
These are current-head test results from the first CI attempt; the
browser-only retry did not rerun these suites.

The full `64fdd3403f` CI failed one separate settings test: after a
company switch, it observed an unsettled API-key draft. The production
component and test were unchanged from prior green source. Production
switches remount both keyed settings layers; the test directly reused an
unkeyed view and used a timer tick instead of waiting for React effects.
The final commit replaces that fixture synchronization with React `act`.
The exact secret-clearing assertions and all timeouts remain unchanged.
The original assertion failure remains recorded; no unchanged retry was
used. The narrow unchanged baseline and fixed fixture each pass 10
tests.

The upstream result-paging merge preserves case capture namespaces and
current asset privacy. Its API integration suite executed 39 of 41 tests
successfully, with two skipped; the optional assigned-result PRP
integration test was skipped. Neither skipped suite is counted in the
194 critical tests or as live provider proof.

All 361 upstream migration entries and SQL bodies remain unchanged. Six
case migrations follow master as 0363–0368 with identical SQL hashes.
Official Drizzle generators produced the combined metadata and five
retained snapshots. Generation reports no schema changes, and the
snapshot drift test passes. The earlier `ce361ae5d0` CI passed on
attempt 1, including its then-current 179 critical tests. Fresh review
later identified unusable document references with generic API tools
disabled; the bounded document reads and ten additional authenticated
HTTP tests address that finding.

The full local `pnpm test:run` attempt was cancelled after this Mac
exhausted PostgreSQL semaphore capacity; it is **not** counted as a
pass. Later database attempts also stopped before assertions or skipped,
including one sandbox socket denial. Two original stale-Stop regressions
did reproduce the bug against the old source. A REST serialization
assertion passed after two preserved database-startup failures. No test
timeout was increased. All 194 assertions listed above executed and
passed in current-head CI. The complete 385-file, 3,963-test UI shard
also passed after the fixture repair.

A configured-provider receipt workflow passed 13 backend checks across
triage → implementation → verification → correction → done, using one
task and four work runs. The saved receipt is revision 2 with total 6
USD; case and task both closed. The original canonical attempt remains
failed because its browser assertion confused the terminal destination
with completed-task tooltips. The corrected full browser verifier passed
on the same retained database and original runs, with no additional
provider calls. The last clean-build browser readback is on
`6a86c54a53`; later changes affect recovery, authorization, bounded
reads, and settlement. Accounted work cost is a $1.010574 rate-card
estimate; provider billing and setup-probe usage are unavailable.

Copilot profile 49 passed the unchanged seven-fixture private protocol
pack (46/46 checks, no retries) and the product file-edit canary after
master's completion-replay change. All 60 bound implementation hashes
remain unchanged on the current source. Historical profile-47/48
identities and results remain intact. See the [profile-49 compatibility
record](https://github.com/paperclipai/paperclip/blob/codex/persistent-case-handoffs/doc/plans/2026-10-20-copilot-completion-recovery-compatibility-v49.json).
This is bounded compatibility evidence, not a fresh full matrix,
installed-package product test, or Daytona rollout.

Preserved CI failures and retries:

- On `20662930ac`, Slack managed setup failed a five-second success
assertion after reload. Its test/application path was unchanged from a
prior green head. One unchanged-source retry passed all 25 tests in that
shard; no source or timeout changed.
- On `9402b4f17a`, two CI workers received shutdown signals at 15:24:19
UTC. Neither log had an assertion failure before interruption. One
unchanged-source retry of each passed all Runner static checks and all
32 tests in browser shard 6; both aggregates passed. The next head,
`7b4374edaf`, passed all CI without retries.
- On `295f289b5a`, serialized shard 9 timed out during its first
device-login test, then the next test found an active login lease.
Direct login/test paths were unchanged from a prior green head. Cold
import plus a timed-out async body using the next test's mutable
actor/store is the supported fixture-race explanation; no request trace
proves that sequence. The original failure remains recorded. One
unchanged-source retry passed all 294 tests in 19 files, including all
41 device-login tests. No login source or timeout changed. The
subsequent `ce361ae5d0` CI passed without retries.
- On `64fdd3403f`, one company-switch settings assertion observed an
unsettled draft. The final test-only commit uses React `act` without
changing assertions, timeouts, or production code. On `765fccd67c`, all
ten settings tests and the complete 385-file, 3,963-test UI shard
passed.
- On `765fccd67c`, browser shard 3 completed the split-handoff
assertions, then cleanup received HTTP 500 from run cancellation after a
one-second PostgreSQL row-lock timeout. The extra chat run was reporting
completed work while teardown began. Cleanup stopped before restoring a
global experiment flag, causing a later assertion to fail. Relevant
production and test paths are unchanged from an earlier green commit.
Stop's lock order is consistent, and no nested self-lock was found; the
exact PostgreSQL blocker was not recorded. One unchanged-shard retry
passed. The original failure, trace, and downstream flag failure remain
recorded. No Stop implementation, cleanup assertion, or timeout changed.
The retry supports intermittent cleanup contention; it does not identify
the original blocking transaction.


## Risks

- Local process transfers require host-owned PID/group absence. Missing
or uncertain termination evidence keeps delivery pending, independently
of scratch setup.
- Handoff admission and task cancellation share execution ownership. New
regression tests cover temporary holds, late source writes, and
uncertain provider termination.
- Retained private sources use an intersection of existing permissions.
This intentionally fails closed when a source is missing or an existing
task cannot preserve that boundary.
- Migrations add tables and indexes. They preserve master history and
can replay over prior feature installs. Migration 0368 adds nullable
internal authorization provenance with no default or authority backfill.
Historical transfers still awaiting release without this context fail
closed; an operator must cancel them and request a new handoff.
- Delayed Cloud handoffs depend on the current Cloud membership RPC. An
unavailable, ambiguous, expired, or mismatched response holds the
handoff for retry; it does not reuse cached authority or grant access.
- Bounded reads reload and reauthorize the selected projection per page.
Underlying work grows with the data size and number of pages. Changed
data or routing requires restarting from offset zero without the old
snapshot.
- Phase names and workflow diagrams remain advisory. They do not satisfy
review or approval gates.
- This is a large, cross-cutting PR. The maintainer requested one PR for
the whole feature; the commits separate data, runtime, UI, and
qualification work.

## Model Used

OpenAI Codex, GPT-6 family, with tool use, code execution, and delegated
code review. The exact deployment model ID and context-window size were
not exposed in the session. Live fixture agents used the explicitly
configured provider model recorded in their test evidence.

## 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
- [x] All Paperclip CI gates are green
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-20 12:46:14 -05:00

31 KiB

Capability Capability Contract

This generated contract is a self-contained derivative of the Paperclip skill, its seven references, the Paperclip Evals corpus, and the legacy MCP tool surface. It does not import or contact the Paperclip control plane.

The skill/reference inventory and eval cases are the only normative behavior sources. Paperclip does not use the legacy MCP calls as a production capability surface; all MCP names below are traceability aliases folded into normative eval rows. Their disposition, grants, assertions, and evidence contract are inherited from the target row rather than classified independently.

Baseline Counts

  • Skill/reference headings: 166
  • Eval cases: 106 across 16 groups
  • Total normative rows: 272
  • Legacy MCP aliases folded into normative rows: 42
Eval group Cases
hb 5
co 6
st 8
cm 6
se 4
su 4
bl 5
dp 3
ix 9
ap 6
ar 4
er 9
rf 22
mh 4
rs 3
wk 8

Regeneration

  • pnpm --dir packages/paperclip-runner generate:capability-inventory imports the canonical baselines and rewrites every generated file.
  • pnpm --dir packages/paperclip-runner check:capability-inventory validates counts, uniqueness, normative dispositions, one-to-one MCP folds, required fields, and generated-file drift without requiring the external eval repository.

Skill / Reference Rows

Capability Primary disposition Source anchor
skill:skills/paperclip/SKILL.md:paperclip-skill:10 optional_agent_tool skills/paperclip/SKILL.md:10
skill:skills/paperclip/SKILL.md:terminology:14 optional_agent_tool skills/paperclip/SKILL.md:14
skill:skills/paperclip/SKILL.md:authentication:20 control_plane_owned skills/paperclip/SKILL.md:20
skill:skills/paperclip/SKILL.md:conversation-tasks:32 optional_agent_tool skills/paperclip/SKILL.md:32
skill:skills/paperclip/SKILL.md:server-verified-external-chat-turns:49 control_plane_owned skills/paperclip/SKILL.md:49
skill:skills/paperclip/SKILL.md:the-heartbeat-procedure:89 optional_agent_tool skills/paperclip/SKILL.md:89
skill:skills/paperclip/SKILL.md:generated-artifacts-and-work-products:200 always_agent_tool skills/paperclip/SKILL.md:200
skill:skills/paperclip/SKILL.md:status-quick-guide:248 control_plane_owned skills/paperclip/SKILL.md:248
skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:258 optional_agent_tool skills/paperclip/SKILL.md:258
skill:skills/paperclip/SKILL.md:delegating-review-tasks:271 always_agent_tool skills/paperclip/SKILL.md:271
skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:282 control_plane_owned skills/paperclip/SKILL.md:282
skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:290 control_plane_owned skills/paperclip/SKILL.md:290
skill:skills/paperclip/SKILL.md:requesting-board-approval:315 optional_agent_tool skills/paperclip/SKILL.md:315
skill:skills/paperclip/SKILL.md:issue-thread-interactions:336 optional_agent_tool skills/paperclip/SKILL.md:336
skill:skills/paperclip/SKILL.md:standalone-decisions:366 optional_agent_tool skills/paperclip/SKILL.md:366
skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:470 optional_agent_tool skills/paperclip/SKILL.md:470
skill:skills/paperclip/SKILL.md:niche-workflow-pointers:512 optional_agent_tool skills/paperclip/SKILL.md:512
skill:skills/paperclip/SKILL.md:cases:522 optional_agent_tool skills/paperclip/SKILL.md:522
skill:skills/paperclip/SKILL.md:company-skills-workflow:527 optional_agent_tool skills/paperclip/SKILL.md:527
skill:skills/paperclip/SKILL.md:routines:538 optional_agent_tool skills/paperclip/SKILL.md:538
skill:skills/paperclip/SKILL.md:task-files-and-workspace-choices:549 optional_agent_tool skills/paperclip/SKILL.md:549
skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:555 optional_agent_tool skills/paperclip/SKILL.md:555
skill:skills/paperclip/SKILL.md:proposing-credentials-safely:562 optional_agent_tool skills/paperclip/SKILL.md:562
skill:skills/paperclip/SKILL.md:reading-granted-secrets:569 optional_agent_tool skills/paperclip/SKILL.md:569
skill:skills/paperclip/SKILL.md:critical-rules:595 optional_agent_tool skills/paperclip/SKILL.md:595
skill:skills/paperclip/SKILL.md:comment-style-required:616 always_agent_tool skills/paperclip/SKILL.md:616
skill:skills/paperclip/SKILL.md:update:648 optional_agent_tool skills/paperclip/SKILL.md:648
skill:skills/paperclip/SKILL.md:task-documents-and-deliverables:658 always_agent_tool skills/paperclip/SKILL.md:658
skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:672 optional_agent_tool skills/paperclip/SKILL.md:672
skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:703 optional_agent_tool skills/paperclip/SKILL.md:703
skill:skills/paperclip/SKILL.md:searching-issues:733 optional_agent_tool skills/paperclip/SKILL.md:733
skill:skills/paperclip/SKILL.md:full-reference:743 optional_agent_tool skills/paperclip/SKILL.md:743
skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:747 always_agent_tool skills/paperclip/SKILL.md:747
skill:skills/paperclip/SKILL.md:incidental-feedback:764 optional_agent_tool skills/paperclip/SKILL.md:764
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
skill:skills/paperclip/references/api-reference.md:company-portability:44 optional_agent_tool skills/paperclip/references/api-reference.md:44
skill:skills/paperclip/references/api-reference.md:issue-with-ancestors-get-api-issues-issueid:116 optional_agent_tool skills/paperclip/references/api-reference.md:116
skill:skills/paperclip/references/api-reference.md:issue-update-response-patch-api-issues-issueid:202 optional_agent_tool skills/paperclip/references/api-reference.md:202
skill:skills/paperclip/references/api-reference.md:blocker-diagnostics-get-api-issues-issueid-diagnostics-blockers:244 control_plane_owned skills/paperclip/references/api-reference.md:244
skill:skills/paperclip/references/api-reference.md:wake-diagnostics-get-api-issues-issueid-diagnostics-wakes:283 control_plane_owned skills/paperclip/references/api-reference.md:283
skill:skills/paperclip/references/api-reference.md:subtree-diagnostics-get-api-issues-issueid-diagnostics-subtree:327 optional_agent_tool skills/paperclip/references/api-reference.md:327
skill:skills/paperclip/references/api-reference.md:execution-policy-fields-on-an-issue:375 optional_agent_tool skills/paperclip/references/api-reference.md:375
skill:skills/paperclip/references/api-reference.md:cross-agent-review-gates:427 always_agent_tool skills/paperclip/references/api-reference.md:427
skill:skills/paperclip/references/api-reference.md:worked-example-ic-heartbeat:460 optional_agent_tool skills/paperclip/references/api-reference.md:460
skill:skills/paperclip/references/api-reference.md:1-identity-skip-if-already-in-context:465 control_plane_owned skills/paperclip/references/api-reference.md:465
skill:skills/paperclip/references/api-reference.md:2-check-inbox:469 control_plane_owned skills/paperclip/references/api-reference.md:469
skill:skills/paperclip/references/api-reference.md:3-already-have-issue-101-inprogress-highest-priority-continue-it:476 optional_agent_tool skills/paperclip/references/api-reference.md:476
skill:skills/paperclip/references/api-reference.md:4-do-the-actual-work-write-code-run-tests:483 optional_agent_tool skills/paperclip/references/api-reference.md:483
skill:skills/paperclip/references/api-reference.md:5-work-is-done-update-status-and-comment-in-one-call:485 always_agent_tool skills/paperclip/references/api-reference.md:485
skill:skills/paperclip/references/api-reference.md:6-still-have-time-checkout-the-next-task:489 control_plane_owned skills/paperclip/references/api-reference.md:489
skill:skills/paperclip/references/api-reference.md:7-made-partial-progress-not-done-yet-comment-and-exit:496 always_agent_tool skills/paperclip/references/api-reference.md:496
skill:skills/paperclip/references/api-reference.md:worked-example-report-a-board-user-s-mine-inbox:501 control_plane_owned skills/paperclip/references/api-reference.md:501
skill:skills/paperclip/references/api-reference.md:board-user-created-the-requesting-issue:506 optional_agent_tool skills/paperclip/references/api-reference.md:506
skill:skills/paperclip/references/api-reference.md:fetch-the-board-user-s-mine-inbox-issues:510 control_plane_owned skills/paperclip/references/api-reference.md:510
skill:skills/paperclip/references/api-reference.md:summarize-it-back-to-the-board-in-a-comment-or-document:524 always_agent_tool skills/paperclip/references/api-reference.md:524
skill:skills/paperclip/references/api-reference.md:worked-example-archive-a-resolved-inbox-item:529 control_plane_owned skills/paperclip/references/api-reference.md:529
skill:skills/paperclip/references/api-reference.md:the-responsible-user-s-id-is-resolved-from-the-authenticated-agent-run:534 optional_agent_tool skills/paperclip/references/api-reference.md:534
skill:skills/paperclip/references/api-reference.md:reverse-the-archive-if-it-was-premature-or-no-longer-desired:543 optional_agent_tool skills/paperclip/references/api-reference.md:543
skill:skills/paperclip/references/api-reference.md:worked-example-reviewer-approver-heartbeat:553 always_agent_tool skills/paperclip/references/api-reference.md:553
skill:skills/paperclip/references/api-reference.md:worked-example-manager-heartbeat:592 optional_agent_tool skills/paperclip/references/api-reference.md:592
skill:skills/paperclip/references/api-reference.md:1-identity-skip-if-already-in-context:595 control_plane_owned skills/paperclip/references/api-reference.md:595
skill:skills/paperclip/references/api-reference.md:2-check-team-status:599 optional_agent_tool skills/paperclip/references/api-reference.md:599
skill:skills/paperclip/references/api-reference.md:3-agent-42-is-blocked-read-comments:606 control_plane_owned skills/paperclip/references/api-reference.md:606
skill:skills/paperclip/references/api-reference.md:4-unblock-reassign-and-comment:610 control_plane_owned skills/paperclip/references/api-reference.md:610
skill:skills/paperclip/references/api-reference.md:5-check-own-assignments:614 optional_agent_tool skills/paperclip/references/api-reference.md:614
skill:skills/paperclip/references/api-reference.md:6-create-subtasks-and-delegate:621 optional_agent_tool skills/paperclip/references/api-reference.md:621
skill:skills/paperclip/references/api-reference.md:load-tests-depend-on-caching-layer-being-done-first-paperclip-will-auto-wake-agent-55-when-the-blocker-resolves:627 control_plane_owned skills/paperclip/references/api-reference.md:627
skill:skills/paperclip/references/api-reference.md:7-dashboard-for-health-check:632 optional_agent_tool skills/paperclip/references/api-reference.md:632
skill:skills/paperclip/references/api-reference.md:comments-and-mentions:638 always_agent_tool skills/paperclip/references/api-reference.md:638
skill:skills/paperclip/references/api-reference.md:update:645 optional_agent_tool skills/paperclip/references/api-reference.md:645
skill:skills/paperclip/references/api-reference.md:cross-team-work-and-delegation:667 optional_agent_tool skills/paperclip/references/api-reference.md:667
skill:skills/paperclip/references/api-reference.md:receiving-cross-team-work:671 optional_agent_tool skills/paperclip/references/api-reference.md:671
skill:skills/paperclip/references/api-reference.md:questions-and-dependencies:681 always_agent_tool skills/paperclip/references/api-reference.md:681
skill:skills/paperclip/references/api-reference.md:company-context:693 optional_agent_tool skills/paperclip/references/api-reference.md:693
skill:skills/paperclip/references/api-reference.md:company-branding-ceo-board:705 optional_agent_tool skills/paperclip/references/api-reference.md:705
skill:skills/paperclip/references/api-reference.md:openclaw-invite-prompt-ceo:725 optional_agent_tool skills/paperclip/references/api-reference.md:725
skill:skills/paperclip/references/api-reference.md:setting-agent-instructions-path:744 optional_agent_tool skills/paperclip/references/api-reference.md:744
skill:skills/paperclip/references/api-reference.md:project-setup-create-workspace:777 optional_agent_tool skills/paperclip/references/api-reference.md:777
skill:skills/paperclip/references/api-reference.md:option-a-one-call-create-with-workspace:801 optional_agent_tool skills/paperclip/references/api-reference.md:801
skill:skills/paperclip/references/api-reference.md:option-b-two-calls-project-first-then-workspace:820 optional_agent_tool skills/paperclip/references/api-reference.md:820
skill:skills/paperclip/references/api-reference.md:governance-and-approvals:849 optional_agent_tool skills/paperclip/references/api-reference.md:849
skill:skills/paperclip/references/api-reference.md:requesting-a-hire-management-only:853 optional_agent_tool skills/paperclip/references/api-reference.md:853
skill:skills/paperclip/references/api-reference.md:ceo-strategy-approval:918 optional_agent_tool skills/paperclip/references/api-reference.md:918
skill:skills/paperclip/references/api-reference.md:questions-and-waiting-for-human-input:927 always_agent_tool skills/paperclip/references/api-reference.md:927
skill:skills/paperclip/references/api-reference.md:issue-thread-confirmations:1031 always_agent_tool skills/paperclip/references/api-reference.md:1031
skill:skills/paperclip/references/api-reference.md:conversational-confirmation-answers:1089 always_agent_tool skills/paperclip/references/api-reference.md:1089
skill:skills/paperclip/references/api-reference.md:checkbox-confirmations:1095 always_agent_tool skills/paperclip/references/api-reference.md:1095
skill:skills/paperclip/references/api-reference.md:item-verdict-requests:1210 optional_agent_tool skills/paperclip/references/api-reference.md:1210
skill:skills/paperclip/references/api-reference.md:checking-approval-status:1320 optional_agent_tool skills/paperclip/references/api-reference.md:1320
skill:skills/paperclip/references/api-reference.md:approval-follow-up-requesting-agent:1326 always_agent_tool skills/paperclip/references/api-reference.md:1326
skill:skills/paperclip/references/api-reference.md:issue-lifecycle:1344 always_agent_tool skills/paperclip/references/api-reference.md:1344
skill:skills/paperclip/references/api-reference.md:error-handling:1374 control_plane_owned skills/paperclip/references/api-reference.md:1374
skill:skills/paperclip/references/api-reference.md:full-api-reference:1388 optional_agent_tool skills/paperclip/references/api-reference.md:1388
skill:skills/paperclip/references/api-reference.md:agents:1390 optional_agent_tool skills/paperclip/references/api-reference.md:1390
skill:skills/paperclip/references/api-reference.md:issues-tasks:1411 optional_agent_tool skills/paperclip/references/api-reference.md:1411
skill:skills/paperclip/references/api-reference.md:companies-projects-goals:1452 optional_agent_tool skills/paperclip/references/api-reference.md:1452
skill:skills/paperclip/references/api-reference.md:routines:1476 optional_agent_tool skills/paperclip/references/api-reference.md:1476
skill:skills/paperclip/references/api-reference.md:approvals-costs-activity-dashboard:1492 optional_agent_tool skills/paperclip/references/api-reference.md:1492
skill:skills/paperclip/references/api-reference.md:secrets:1514 optional_agent_tool skills/paperclip/references/api-reference.md:1514
skill:skills/paperclip/references/api-reference.md:agent-secret-proposals:1527 optional_agent_tool skills/paperclip/references/api-reference.md:1527
skill:skills/paperclip/references/api-reference.md:agent-secret-access:1627 optional_agent_tool skills/paperclip/references/api-reference.md:1627
skill:skills/paperclip/references/api-reference.md:common-mistakes:1667 optional_agent_tool skills/paperclip/references/api-reference.md:1667
skill:skills/paperclip/references/artifacts.md:generated-artifacts-and-work-products:1 always_agent_tool skills/paperclip/references/artifacts.md:1
skill:skills/paperclip/references/artifacts.md:workspace-only-file-references:15 optional_agent_tool skills/paperclip/references/artifacts.md:15
skill:skills/paperclip/references/cases.md:cases:1 optional_agent_tool skills/paperclip/references/cases.md:1
skill:skills/paperclip/references/cases.md:core-model:12 optional_agent_tool skills/paperclip/references/cases.md:12
skill:skills/paperclip/references/cases.md:upsert-semantics:31 optional_agent_tool skills/paperclip/references/cases.md:31
skill:skills/paperclip/references/cases.md:start-and-hand-off-work:69 optional_agent_tool skills/paperclip/references/cases.md:69
skill:skills/paperclip/references/cases.md:example-factory-instructions:218 optional_agent_tool skills/paperclip/references/cases.md:218
skill:skills/paperclip/references/cases.md:read-and-search:241 optional_agent_tool skills/paperclip/references/cases.md:241
skill:skills/paperclip/references/cases.md:task-documents-and-legacy-case-documents:324 always_agent_tool skills/paperclip/references/cases.md:324
skill:skills/paperclip/references/cases.md:fields:358 optional_agent_tool skills/paperclip/references/cases.md:358
skill:skills/paperclip/references/cases.md:issue-links:391 optional_agent_tool skills/paperclip/references/cases.md:391
skill:skills/paperclip/references/cases.md:child-cases:416 optional_agent_tool skills/paperclip/references/cases.md:416
skill:skills/paperclip/references/cases.md:attachments:435 optional_agent_tool skills/paperclip/references/cases.md:435
skill:skills/paperclip/references/cases.md:lifecycle:448 optional_agent_tool skills/paperclip/references/cases.md:448
skill:skills/paperclip/references/cases.md:worked-blog-post-example:462 optional_agent_tool skills/paperclip/references/cases.md:462
skill:skills/paperclip/references/company-skills.md:company-skills-workflow:1 optional_agent_tool skills/paperclip/references/company-skills.md:1
skill:skills/paperclip/references/company-skills.md:what-exists:5 optional_agent_tool skills/paperclip/references/company-skills.md:5
skill:skills/paperclip/references/company-skills.md:permission-model:22 optional_agent_tool skills/paperclip/references/company-skills.md:22
skill:skills/paperclip/references/company-skills.md:core-endpoints:29 optional_agent_tool skills/paperclip/references/company-skills.md:29
skill:skills/paperclip/references/company-skills.md:install-a-skill-into-the-company:65 optional_agent_tool skills/paperclip/references/company-skills.md:65
skill:skills/paperclip/references/company-skills.md:app-shipped-catalog:75 optional_agent_tool skills/paperclip/references/company-skills.md:75
skill:skills/paperclip/references/company-skills.md:external-source-import:101 optional_agent_tool skills/paperclip/references/company-skills.md:101
skill:skills/paperclip/references/company-skills.md:source-types-in-order-of-preference:105 optional_agent_tool skills/paperclip/references/company-skills.md:105
skill:skills/paperclip/references/company-skills.md:example-skills-sh-import-preferred:116 optional_agent_tool skills/paperclip/references/company-skills.md:116
skill:skills/paperclip/references/company-skills.md:example-github-import:138 optional_agent_tool skills/paperclip/references/company-skills.md:138
skill:skills/paperclip/references/company-skills.md:inspect-what-was-installed:164 optional_agent_tool skills/paperclip/references/company-skills.md:164
skill:skills/paperclip/references/company-skills.md:assign-skills-to-an-existing-agent:181 optional_agent_tool skills/paperclip/references/company-skills.md:181
skill:skills/paperclip/references/company-skills.md:include-skills-during-hire-or-create:216 optional_agent_tool skills/paperclip/references/company-skills.md:216
skill:skills/paperclip/references/company-skills.md:notes:256 optional_agent_tool skills/paperclip/references/company-skills.md:256
skill:skills/paperclip/references/issue-documents.md:issue-documents-through-the-api:1 always_agent_tool skills/paperclip/references/issue-documents.md:1
skill:skills/paperclip/references/issue-documents.md:create-a-document:8 always_agent_tool skills/paperclip/references/issue-documents.md:8
skill:skills/paperclip/references/issue-documents.md:update-or-resolve-an-unclear-write:49 optional_agent_tool skills/paperclip/references/issue-documents.md:49
skill:skills/paperclip/references/issue-workspaces.md:issue-workspace-runtime-controls:1 optional_agent_tool skills/paperclip/references/issue-workspaces.md:1
skill:skills/paperclip/references/issue-workspaces.md:discover-the-workspace:5 optional_agent_tool skills/paperclip/references/issue-workspaces.md:5
skill:skills/paperclip/references/issue-workspaces.md:choose-files-and-repositories:23 optional_agent_tool skills/paperclip/references/issue-workspaces.md:23
skill:skills/paperclip/references/issue-workspaces.md:control-services:37 optional_agent_tool skills/paperclip/references/issue-workspaces.md:37
skill:skills/paperclip/references/issue-workspaces.md:start-all-configured-services-waits-for-configured-readiness-checks:42 optional_agent_tool skills/paperclip/references/issue-workspaces.md:42
skill:skills/paperclip/references/issue-workspaces.md:restart-all-configured-services:50 optional_agent_tool skills/paperclip/references/issue-workspaces.md:50
skill:skills/paperclip/references/issue-workspaces.md:stop-all-running-services:58 optional_agent_tool skills/paperclip/references/issue-workspaces.md:58
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/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
skill:skills/paperclip/references/workflows.md:setting-agent-instructions-path:50 optional_agent_tool skills/paperclip/references/workflows.md:50
skill:skills/paperclip/references/workflows.md:company-import-export:79 optional_agent_tool skills/paperclip/references/workflows.md:79
skill:skills/paperclip/references/workflows.md:self-test-playbook-app-level:106 optional_agent_tool skills/paperclip/references/workflows.md:106

Legacy MCP Alias Index

This is a compatibility/traceability index, not a tool catalog. “Inherited disposition” is shown only to make the normative target easy to audit.

Legacy MCP name Folded into normative row Inherited disposition Source anchor
paperclipMe eval:hb-inbox-lite-01 control_plane_owned packages/mcp-server/src/tools.ts:290
paperclipInboxLite eval:hb-inbox-lite-01 control_plane_owned packages/mcp-server/src/tools.ts:296
paperclipListAgents eval:rf-api-mgr-heartbeat-01 optional_agent_tool packages/mcp-server/src/tools.ts:302
paperclipListSkills eval:rf-cskill-audit-01 optional_agent_tool packages/mcp-server/src/tools.ts:308
paperclipGetAgent eval:rf-api-mgr-heartbeat-01 optional_agent_tool packages/mcp-server/src/tools.ts:314
paperclipListIssues eval:se-q-filters-01 optional_agent_tool packages/mcp-server/src/tools.ts:323
paperclipGetIssue eval:se-get-issue-01 optional_agent_tool packages/mcp-server/src/tools.ts:338
paperclipGetHeartbeatContext eval:hb-context-01 control_plane_owned packages/mcp-server/src/tools.ts:344
paperclipListComments eval:se-get-issue-01 optional_agent_tool packages/mcp-server/src/tools.ts:353
paperclipGetComment eval:hb-wake-comment-01 control_plane_owned packages/mcp-server/src/tools.ts:366
paperclipListIssueApprovals eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:373
paperclipListDocuments eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:379
paperclipGetDocument eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:385
paperclipListDocumentRevisions eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:392
paperclipListProjects eval:rf-wf-project-setup-01 optional_agent_tool packages/mcp-server/src/tools.ts:402
paperclipGetProject eval:rf-wf-project-setup-01 optional_agent_tool packages/mcp-server/src/tools.ts:408
paperclipGetIssueWorkspaceRuntime eval:rf-iws-start-url-01 optional_agent_tool packages/mcp-server/src/tools.ts:417
paperclipControlIssueWorkspaceServices eval:rf-iws-start-url-01 optional_agent_tool packages/mcp-server/src/tools.ts:423
paperclipWaitForIssueWorkspaceService eval:rf-iws-target-restart-01 optional_agent_tool packages/mcp-server/src/tools.ts:440
paperclipListGoals eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:466
paperclipGetGoal eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:472
paperclipListApprovals eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:478
paperclipCreateApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:487
paperclipGetApproval eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:496
paperclipGetApprovalIssues eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:502
paperclipListApprovalComments eval:ap-approval-deny-01 optional_agent_tool packages/mcp-server/src/tools.ts:508
paperclipCreateIssue eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:514
paperclipUpdateIssue eval:st-done-comment-01 always_agent_tool packages/mcp-server/src/tools.ts:521
paperclipCheckoutIssue eval:co-body-contract-01 control_plane_owned packages/mcp-server/src/tools.ts:528
paperclipReleaseIssue eval:er-release-01 control_plane_owned packages/mcp-server/src/tools.ts:540
paperclipAddComment eval:cm-multiline-01 always_agent_tool packages/mcp-server/src/tools.ts:546
paperclipSuggestTasks eval:ix-suggest-tasks-01 always_agent_tool packages/mcp-server/src/tools.ts:553
paperclipAskUserQuestions eval:ix-questions-01 always_agent_tool packages/mcp-server/src/tools.ts:565
paperclipRequestConfirmation eval:ix-confirmation-plan-01 always_agent_tool packages/mcp-server/src/tools.ts:577
paperclipRequestCheckboxConfirmation eval:ix-checkbox-01 always_agent_tool packages/mcp-server/src/tools.ts:589
paperclipUpsertIssueDocument eval:dp-plan-doc-01 always_agent_tool packages/mcp-server/src/tools.ts:601
paperclipRestoreIssueDocumentRevision eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:612
paperclipLinkIssueApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:627
paperclipUnlinkIssueApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:636
paperclipApprovalDecision eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:646
paperclipAddApprovalComment eval:ap-approval-deny-01 optional_agent_tool packages/mcp-server/src/tools.ts:668
paperclipApiRequest eval:rf-api-404-report-01 optional_agent_tool packages/mcp-server/src/tools.ts:677