[LamaSu]

ADK track item 2: the agent pack tells agents only true things (N75, N76), plus attempt reporting, #427 and the thesis

adk is the agent pack's single writer (steward #3877). Every change here was wrong on master ac86a404. The new agent-pack-truth.test.ts failed 5 of 5 there before the edits.

What	On master	Now
N76, onboarding route	The system prompt and the dashboard skill say POST /api/onboard/session/start, which doesn't exist.	POST /api/onboard/start: template-session is mounted at /api/onboard (server.ts:815, template-session.ts:252). The pcc_onboard_session_start tool already called this route.
N75, kernel_announce_capabilities	"Used by pcc-node daemons … to register what the kernel can do". The route acknowledges and stores nothing.	The description says it stores nothing, and points to create_capability (POST /api/capabilities).
Packages that don't exist	@pcc/operator-agent-runtime, @pcc/evidence-judge, @pcc/decompose-skill in the prompt, an example and the skill.	Removed. Operator polling points to the pcc-node daemon.
Tool counts	The skill says 249; metadata.tool_count says 254; the package holds 253.	The prose says 250+, and the metadata says 253.
Install	pip install pcc-node, which finds nothing while 0.1.0 is yanked. Without the crypto extra, a node cannot register a signing key or sign evidence (register.py and log_capture.py fail closed), so it can never reach a verified run.	pip install 'pcc-node[crypto]>=0.1.1' in the skill, prompt and CLAUDE.md (item 1 publishes 0.1.1). Added in 52015b2.
scripts/polish-agent-package-claude-max.mjs	CLAUDE.md: "Idempotent. Re-run when the framing changes."	Retired: it exits 1. On a scratch copy of master's package, a re-run dropped the "Report failures automatically" trigger that agent-package-auto-feedback.test.ts pins, brought back the dead route and packages, and downgraded the version to 2.19.0.

The package moves to v2.19.2, with a new lastUpdated.

Rehearsal R0 fixes (6b04c23)

Dress rehearsal R0 ran a fresh agent against a master gateway, and it found places where the pack disagreed with the code (refvertical, R0-findings.md). Each one was re-checked in the code first; the triage is in returns/pcc-adk-work/r0-pack-triage.md.

• P1: calls go to the gateway you were given (PCC_BASE), with production only the default. Covers the prompt, the quickstarts and the skills' curl examples.
• P4: /api/capabilities/types is described as it is: templates, registered and CSD types, some with no operator.
• P5: onboard_machine documents operator. Without it the owner is 0x000…/"Unknown".
• P6: JobOffer uses the names the gateway serves (claimedByKernelId, …), and drops the evidence field it doesn't have. The pack no longer says an operator can PATCH an offer (it is poster-only).
• P7 (corrected in 419b3e0): there are two finishes. The node path is POST /api/operator/evidence, then job-status completed; that's what pcc-node does, and the escrow is not released yet (G1). pcc_job_complete is for jobs run through execution scopes, and after a node finish it answers 409.
• P8: the oracle tools no longer claim to be "the critical path"; the gateway has no /api/oracle route.
• G8: register-device's required fields match the route (deviceId, adapterType). type is the role, and the adapter list is the route's (no opentrons).
• G9: storage takes the raw bytes; JSON and multipart are refused.

11 new checks, three of them line-based rules for the skills. Package tests: 109 passed, 1 skipped.

Item 2b: attempt reporting (d74c5c3)

The pack now follows painpoints' contract v1 (returns/pcc-painpoints-work/item3-attempt-reporting-contract-v1.md):

• a typed pcc_report_attempt tool: POST /api/feedback, kind: "attempt", with the phases enum (the runbook's phases plus session), 7 outcomes, and a UUID sessionId plus seq. consent.transcript is fixed at false, and there is no transcript field;
• summary is required until item 3's server side lands;
• a top-level attempt_reporting section;
• an operator-path instruction to report every phase, success or failure. toolCount is now 254.

Merge note: #411's @pcc/adk pin must be regenerated after this merges (pnpm --filter @pcc/adk generate).

Re-freeze with #427 and two text asks (bd2f714, 46354b6, f282e9e)

Reviews are paused until Oct 5 (#4022), so the steward asked (#4191) for #427 to be folded in here rather than reviewed separately. aeo closes #427 once this head is up.

• bd2f714, fix(agent-package): drop node-local pcc_generate_ui from the public package #427 cherry-picked (-x, aeo's commit and its agent-package-public-endpoints.test.ts): the node-local pcc_generate_ui tool is removed. Its endpoint was pcc-node's local UI server, http://localhost:3200/api/generate, not a gateway route. The only conflict was the counts; they are set from the list itself: 253 tools (toolCount = metadata.tool_count = tools.length), version 2.19.2.
• 46354b6: the seven pip install "pcc-node[crypto]>=0.1.1" lines use double quotes, which work in cmd.exe (aeo #4177). Single quotes break there.
• f282e9e: the package description leads with the operator's thesis, with the public-beta sentence beside it (launch #2877, approved in #2574). The polish script writes the same description. CLAUDE.md and both SKILL.md copies no longer say "AWS for the physical world" (launch #4168); the thesis replaces it, with the beta sentence beside it. launch's findClaimViolations (the positioning registry) over the six files: master 3 hits (retired tagline), this head 0.

Tests at f282e9e:

• gateway: 9 files / 119 passed, 1 skipped, including agent-pack-truth (19) and agent-package-public-endpoints (7);
• onboard-cli: agent-package and cli, 21 passed;
• dashboard: OnboardLandingPage, 12 passed.

The guard

packages/gateway/src/__tests__/agent-pack-truth.test.ts reads agent-package.json and all three skill copies. It checks five things:

• only the real onboarding route;
• only @pcc/* names that exist in this repo;
• tool counts the package can back (an exact count must be equal; N+ must be ≤ the count);
• the announce text;
• pcc-node[crypto]>=0.1.1 on every pip install of pcc-node.

With the 7 existing tests that read the package: 98 passed, 1 skipped. Mutation-checked: putting back tool_count: 254 fails it.

Merge-order note (#411)

#411's @pcc/adk pins agent-package.json by sha256 (it is generated in src/generated/agent-pin.ts).

• If this PR merges first, feat(adk): @pcc/adk skeleton with a pinned agent package and a clean external install check (R4 D1) #411 needs pnpm --filter @pcc/adk generate (a narrow confirmation pass).
• If feat(adk): @pcc/adk skeleton with a pinned agent package and a clean external install check (R4 D1) #411 merges first, this PR regenerates the pin.

Not in this PR

• Item 2b: phase-outcome and idea reporting in painpoints' item-3 contract, which I've asked painpoints for (bus #3936).
• Stale items outside the pack's two files, left for their owners:
  • install.html:151 ("230+ tools");
  • CLAUDE.md's MCP counts (63, 56 and 49 disagree);
  • root AGENTS.md:29,47 (pip install pcc-node) and :76 (pcc_setup_* names).

🤖 Generated with Claude Code