Skip to content

pi: add agent-desktop extension package - #72

Merged
cmpadden merged 1 commit into
mainfrom
pi/agent-desktop
Nov 13, 2026
Merged

cmpadden merged 1 commit into
mainfrom
pi/agent-desktop

Conversation

@cmpadden

Copy link
Copy Markdown
Owner

Summary

  • Add a self-contained Pi extension at pi/.pi/agent/extensions/agent-desktop, scoped as @colton.padden/pi-agent-desktop and kept private/unpublished.
  • Expose one typed desktop tool backed by the separately installed Vercel agent-desktop CLI: app/window discovery, accessibility snapshots, ref actions, text input, scrolling, and screenshot attachments.
  • Default to headless delivery, pipe typed text over stdin, serialize calls, bound execution/output, preserve upstream errors, and clean up isolated temporary CLI state on reload/shutdown.
  • Include standalone development scripts, a lockfile, MIT license, changelog, setup/privacy documentation, and a six-file npm publish allowlist. Pi loads TypeScript directly through the package manifest; no build or bundled desktop binary.

Validation

  • npm ci --ignore-scripts --no-audit --no-fund
  • npm run check — type-checking and all 17 offline tests pass, including Pi manifest discovery and subprocess cancellation/output handling.
  • npm pack --dry-run --json --ignore-scripts — exactly the two source files, manifest, README, changelog, and license; no tests, tooling, dependencies, or runtime state.
  • Standalone-copy installation and extracted-tarball loading/execution through Pi were also exercised with a fake desktop executable.
  • Staged-file pre-commit checks and git diff --cached --check pass; staged changes audited for credentials and machine-specific/runtime state.
  • make format passes without changes.
  • make lint is blocked only by the missing shellcheck executable in the local environment; its other checks pass.

Limitations

Live desktop behavior and macOS permissions have not been validated. The adapter targets the agent-desktop 1.3.0 / JSON 2.6 source contract. The CLI remains an external prerequisite, calls are serialized only within one extension instance, and these guardrails are not a security sandbox. Nothing is published to npm by this PR.

@cmpadden
cmpadden merged commit 9add38b into main Nov 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant