Changelog
From CHANGELOG.md.
Unreleased
Fixed
- The release workflow no longer reports the wrong npm credential path.
actions/setup-nodewrites the literal_authToken=${NODE_AUTH_TOKEN}into the runner npmrc, and the check read that placeholder as a token, so a run publishing through Trusted Publishing was told it was taking the legacy token path. - The post-publish check waits five minutes for the registry instead of one. npm served 0.4.0 later than that, which failed the release workflow over a publish that had succeeded.
0.4.0 (2026-11-13)
Fixed
ppd releasewaits for npm to serve the new version before it creates the GitHub release, and says what to run if the publish never lands. A failed publish used to leave a release page, and a registry PR linking to it, for a version npm had never served.- The release workflow publishes through Trusted Publishing alone. An
_authTokenline left byactions/setup-nodewith an emptyNODE_AUTH_TOKENmade npm refuse withENEEDAUTHbefore OIDC was attempted, which is why 0.3.0 was tagged but never published. The workflow now reports which credential path it took, pins npm to the major that supports Trusted Publishing, publishes a prerelease under thenexttag, and fails when the registry does not serve what it just published. ppd releaseresumes a release whose tag reached origin but whose GitHub release did not, instead of refusing every version that is not higher than the one in package.json. An npm publish that never serves the version stops the run before the release; the rerun finishes it.- The
agent-hooktemplate appends its card again on Paseo 0.14 and later. Those releases emitagent.turn_endedwith an emptytimeline, so the template saw no tool calls and silently appended nothing; it now reads the turn back from the agent's timeline when the event carries none. ppd checkapplies the app's theme schema toclient.addTheme: a bad hex color, a missing or extra color, an extra key, a missing name, a name over 60 characters or an appearance other thanlightordarkmakes the app throw and drop the whole client, andppd checknow reports each one instead of passing the plugin.
Changed
- Verified on Paseo 0.15.4: daemon, compiler and web UI, with the full opt-in end-to-end suite green against the installed app.
ppd daemon upandppd doctorno longer print the version note on it. client-evalsays where its rules come from instead of claiming they are the host's:contributions: addWorkspacePanel (checked as Paseo 0.15.4, rules copied from 0.13.0 and confirmed through 0.15.4), and warns when the host is newer than the last release the rules were read against.test/rules-drift.test.tshashes the four upstream files the client rules are copied from against a Paseo checkout (PASEO_SOURCE), so a rule that drifts fails the weekly CI job instead of going stale unnoticed.
0.3.0 (2026-11-10)
- Add
PaseoWeb.openFiles,openFile,fileTab,chooseFilePanel,openWith,pinFile,closeFileandreloadfor native file-panel tests. Paths identify tabs by their full workspace-relative name. Tree traversal distinguishes repeated folder names and file basenames. - Add
ppd web --open-file PATH --with PANELfor file-panel screenshots. openFilescrolls long Files trees to find the row. A requested panel without a picker, an unknown panel or a missing file fail with a clear message.- Without a Paseo host and without
requirements.paseo,ppd checknow applies the Paseo 0.15.3 client contract instead of 0.12.0, including the 0.13.0 rules. - Verify the daemon, compiler and web UI on Paseo 0.15.3. Add an isolated nested-file regression covering panel selection, changes, deletion, restoration, reload and reopening.
- Close the browser when initial app navigation fails.
- A panel title that several plugins offer fails with the matching labels in
openFile,chooseFilePanelandopenWith; pass the full label ("Title \u2014 owner") to choose one. Panels with identical full labels fail as indistinguishable. Before, Playwright's strict-mode error surfaced. - Add
FileOpenOptions.pickerTimeoutMsandppd web --picker-timeout MSto change the 10 s panel picker wait. openFilewaits for the Files controls afterreloadinstead of failing when the restored sidebar mounts late.
0.2.0 (2026-10-30)
- Verified on Paseo 0.12.0:
ppd daemon upandppd doctorno longer print the version note on it. ppd checkapplies the client registration rules of the Paseo version it checks against: the app's or source checkout's version, or without a host the oldest releaserequirements.paseoadmits. From 0.13.0 that includes file panels (client.addFilePanel, getpaseo/paseo#7411), agent panels (client.addAgentPanel), workspace panels withoutcontext, translated labels,{ svg }and component icons, and thenotificationtimeline item. Before, every plugin that used them failedclient-eval.- On an app version without a method,
client.<method>is undefined like in the app: a guarded call passes, an unguarded one failsclient-eval. client-evalwarns when the host accepts the client but the oldest releaserequirements.paseoadmits would reject it.ppd installandppd devprint the same warning as a note.- A source checkout's version is raised to the release of the newer client methods its evaluator defines, since its package version lags main until a release is cut.
- When
requirements.paseoexcludes the installed app (a prerelease counts by its stable core, like in Paseo),client-evalchecks against the range's lower bound and warns that the app would not load the plugin. - From 0.13.0 a label is a non-empty string or a message from the SDK's
message(); anything else gets the SDK's error text."addFilePanel" in clientworks as a guard. - Docs: React Native, React and SDK versions come from the Paseo app at runtime; how to review their upgrades and keep Dependabot within a React Native series.
0.1.0 (2026-10-18)
First public release. Verified on macOS with Paseo 0.11.4.
Dev daemon:
ppd daemon up|down|status: a detached Paseo daemon in a fresh home under$TMPDIRon a free port (7800-7899), with plugins and the web UI on and relay, MCP and speech off. Port 6767 and~/.paseoare refused, only homes carrying the.ppd-homemarker are deleted, only pids whose command line carries the dev home are signalled, and inheritedPASEO_*variables never reach the daemon or CLI calls.--workspace,--fake-agent,--caffeinate,--port,--name.ppd install [dir]: installs a plugin, reloads it (same directory) or replaces an installed id, and checks the client against the app's registration rules: a client the app would drop is reported asclient-rejected(exit 1).--gitinstalls committed HEAD through the manifestbuild, also from a repo subfolder.ppd dev [dir]: install, then reload on every change, re-check the client and stream plugin logs. Pauses when something keeps writing into the plugin folder.ppd paseo -- <args>: any Paseo CLI call against the dev daemon.ppd weband thePaseoWebpage object (paseo-plugin-devkit/web): screenshots at any viewport, Command Center items and clicks by accessible name; reports console errors and plugin clients the app failed to evaluate (exit 1).ppd android up|down|status:adb reverseto the dev daemon, with read-only device checks.ppd doctor: toolchain report.
Host contract:
ppd check,paseo-plugin-devkit/testingandpaseo-plugin-devkit/vitest: compile and evaluate with the installed Paseo app's own compiler and evaluator (or aPASEO_SOURCEcheckout), else an esbuild replica labeledAPPROXIMATION(--approxforces it). Plugin code runs in child processes with a time limit, so a hang orprocess.exitfails; the returned cleanup is called and handles left open are warnings. Also: the app's client registration rules, manifest rules from Paseo's schema, Lucide icon names from the app, Hermes class syntax, parse and VM smoke run, bundle sizes, import boundaries, dependency placement and an RPC budget helper.
Agent-facing plugins:
ppd daemon up --fake-agentinstalls a credential-free provider plugin that runs a scripted turn per prompt. Steps:say,think,write,edit,bash,mcp(calls tools on the MCP servers plugins inject),sleep,fail.bashwithrun: trueexecutes only in a daemonppd daemon upstarted.- Library:
runFakeAgentTurn,sendFakeAgentTurn,agentTimeline(plugin rows included),pluginRows,fakeAgentPrompt,installFakeAgent.
Start and ship:
ppd create <dir> [--template panel|agent-hook]: wrapspaseo plugin init(built-in base without it) and adds tsconfig node types, an@types/node~22 pin,.gitignore, vitest with a host-contract suite,npm run check|test|devand a README. The result passesppd checkand installs as is.ppd registry precheck|update|submitandppd release(checks the remote before committing and tagging; a rerun after a failed push resumes).examples/hello-plugin,examples/ci.ymland the Claude Code skillpaseo-plugin-dev.
Compatibility and licensing:
- When the installed Paseo does not look like 0.11.4 (app bundle layout, daemon start, web UI labels), errors name what was expected, the verified and found versions, and the workaround.
ppd doctorandppd daemon upnote a different Paseo version.ppd --version. - Files adapted from Paseo (Apache-2.0) carry per-file notices, and
THIRD_PARTY_NOTICESships in the package. The package license isMIT AND Apache-2.0.