Skip to main content

Module platform

Module platform 

Source
Expand description

Cross-platform product integration seams.

Each submodule ports a TypeScript utils/ surface and exposes it as an injectable, argv-testable boundary so the cross-platform behavior contracts can be unit-tested on any host without spawning real platform tools:

  • command: typed command descriptions and the injectable process runner.
  • clipboard: clipboard text/image I/O with OSC 52 fallback.
  • image: image MIME sniff and the inline-image pipeline facade (decoding delegates to the read-tool pipeline so the decoder is unique).
  • open_browser: cross-platform “open URL in browser” launcher.
  • external_editor: external editor lifecycle with cancellation and guaranteed temporary-file cleanup.
  • debug_dump: /debug support dump renderer, redaction, and atomic write.
  • first_run: first-run setup gating and persistence.
  • release_packaging: release cargo/archive plan, runner, path safety, and reproducibility.

Modules§

clipboard
Cross-platform clipboard text and image I/O.
command
Typed platform command descriptions and process execution seams.
debug_dump
/debug support dump: rendered TUI lines plus session messages, written to {agent}/pi-debug.log.
external_editor
External editor lifecycle with cancellation and guaranteed temporary-file cleanup.
first_run
First-run setup gating and persistence.
image
Image MIME sniffing and the inline-image pipeline facade.
open_browser
Cross-platform “open URL in browser” launcher.
release_packaging
Release packaging plan, runner, path safety, and reproducibility rules.