@vaclav-synacek/pi-coding-agent-termux 0.46.0 → 0.47.0-0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.47.0] - 2026-01-16
+
+### Breaking Changes
+
+- Extensions using `Editor` directly must now pass `TUI` as the first constructor argument: `new Editor(tui, theme)`. The `tui` parameter is available in extension factory functions. ([#732](https://github.com/badlogic/pi-mono/issues/732))
+
+### Added
+
+- **OpenAI Codex official support**: Full compatibility with OpenAI's Codex CLI models (`gpt-5.1`, `gpt-5.2`, `gpt-5.1-codex-mini`, `gpt-5.2-codex`). Features include static system prompt for OpenAI allowlisting, prompt caching via session ID, and reasoning signature retention across turns. Set `OPENAI_API_KEY` and use `--provider openai-codex` or select a Codex model. ([#737](https://github.com/badlogic/pi-mono/pull/737))
+- `pi-internal://` URL scheme in read tool for accessing internal documentation. The model can read files from the coding-agent package (README, docs, examples) to learn about extending pi.
+- New `input` event in extension system for intercepting, transforming, or handling user input before the agent processes it. Supports three result types: `continue` (pass through), `transform` (modify text/images), `handled` (respond without LLM). Handlers chain transforms and short-circuit on handled. ([#761](https://github.com/badlogic/pi-mono/pull/761) by [@nicobailon](https://github.com/nicobailon))
+- Extension example: `input-transform.ts` demonstrating input interception patterns (quick mode, instant commands, source routing) ([#761](https://github.com/badlogic/pi-mono/pull/761) by [@nicobailon](https://github.com/nicobailon))
+- Custom tool HTML export: extensions with `renderCall`/`renderResult` now render in `/share` and `/export` output with ANSI-to-HTML color conversion ([#702](https://github.com/badlogic/pi-mono/pull/702) by [@aliou](https://github.com/aliou))
+- Direct filter shortcuts in Tree mode: Ctrl+D (default), Ctrl+T (no-tools), Ctrl+U (user-only), Ctrl+L (labeled-only), Ctrl+A (all) ([#747](https://github.com/badlogic/pi-mono/pull/747) by [@kaofelix](https://github.com/kaofelix))
+
+### Changed
+
+- Skill commands (`/skill:name`) are now expanded in AgentSession instead of interactive mode. This enables skill commands in RPC and print modes, and allows the `input` event to intercept `/skill:name` before expansion.
+
+### Fixed
+
+- Editor no longer corrupts terminal display when loading large prompts via `setEditorText`. Content now scrolls vertically with indicators showing lines above/below the viewport. ([#732](https://github.com/badlogic/pi-mono/issues/732))
+- Piped stdin now works correctly: `echo foo | pi` is equivalent to `pi -p foo`. When stdin is piped, print mode is automatically enabled since interactive mode requires a TTY ([#708](https://github.com/badlogic/pi-mono/issues/708))
+- Session tree now preserves branch connectors and indentation when filters hide intermediate entries so descendants attach to the nearest visible ancestor and sibling branches align. Fixed in both TUI and HTML export ([#739](https://github.com/badlogic/pi-mono/pull/739) by [@w-winter](https://github.com/w-winter))
+- Added `upstream connect`, `connection refused`, and `reset before headers` patterns to auto-retry error detection ([#733](https://github.com/badlogic/pi-mono/issues/733))
+- Multi-line YAML frontmatter in skills and prompt templates now parses correctly. Centralized frontmatter parsing using the `yaml` library. ([#728](https://github.com/badlogic/pi-mono/pull/728) by [@richardgill](https://github.com/richardgill))
+- `ctx.shutdown()` now waits for pending UI renders to complete before exiting, ensuring notifications and final output are visible ([#756](https://github.com/badlogic/pi-mono/issues/756))
+- OpenAI Codex provider now retries on transient errors (429, 5xx, connection failures) with exponential backoff ([#733](https://github.com/badlogic/pi-mono/issues/733))
+
 ## [0.46.0] - 2026-01-15
 
 ### Fixed

package/README.md

@@ -12,330 +12,4 @@ This repository maintains a Termux-compatible fork of pi-coding-agent. The port
 npm install -g @vaclav-synacek/pi-coding-agent-termux
 ```
 
-Or build from source (on a development machine):
-
-```bash
-git clone https://github.com/VaclavSynacek/pi-coding-agent-termux.git
-cd pi-coding-agent-termux
-npm install
-npm run build
-cd packages/coding-agent
-npm pack
-# Transfer the .tgz file to Termux and install it
-```
-
-On Termux:
-```bash
-npm install -g /path/to/vaclav-synacek-pi-coding-agent-termux-0.45.7.tgz
-```
-
-**Note**: Building on Termux is not supported because the build tool (`tsgo`) doesn't have ARM64 binaries. Build on a regular machine and transfer the package, or install directly from npm.
-
-For clipboard support, install Termux:API:
-
-```bash
-pkg install termux-api
-```
-
-## Functional Changes in this Port
-
-This port modifies the upstream pi-coding-agent to work on Termux by:
-
-### 1. Clipboard Integration
-- **Changed**: `@mariozechner/clipboard` made optional (native bindings incompatible with Termux)
-- **Added**: Termux clipboard support via `termux-clipboard-set` and `termux-clipboard-get` commands
-- **Behavior**: Text clipboard works via Termux:API; image clipboard operations are disabled on Termux
-- **Files modified**: 
-  - `packages/coding-agent/src/utils/clipboard.ts`
-  - `packages/coding-agent/src/utils/clipboard-image.ts`
-  - `packages/coding-agent/package.json` (clipboard moved to optionalDependencies)
-
-### 2. Image Processing
-- **Changed**: Uses `wasm-vips` for image processing
-- **Note**: Upstream v0.45.7+ migrated from `photon-node` to `wasm-vips` which is WebAssembly-based
-- **Behavior**: Image resizing and conversion work correctly (wasm-vips is platform-independent)
-- **Files modified**: None required - wasm-vips works on all platforms including Termux
-
-### 3. Update Notification
-- **Changed**: Version check and update notification system
-- **Behavior**: Checks for updates against `@vaclav-synacek/pi-coding-agent-termux` on npm (instead of upstream package)
-- **Display**: Shows correct command: `npm install -g @vaclav-synacek/pi-coding-agent-termux`
-- **Files modified**: 
-  - `packages/coding-agent/src/modes/interactive/interactive-mode.ts` (npm registry URL and install command)
-
-### 4. Optional Dependencies
-- **Changed**: `canvas` moved to optionalDependencies in `packages/ai/package.json`
-- **Reason**: Canvas cannot build on Termux (requires pixman-1), but is only used for ai tests
-- **Behavior**: npm install succeeds on Termux even if canvas build fails
-- **Files modified**: `packages/ai/package.json`
-
-### 5. TypeScript Target
-- **Changed**: `tsconfig.base.json` target set to ES2024
-- **Reason**: Support for regex `v` flag (required by some dependencies)
-- **Files modified**: `tsconfig.base.json`
-
-## Repository Structure & Maintenance
-
-This repository follows a structured branching strategy to track upstream releases while maintaining Termux-specific patches:
-
-### Branches
-
-- **`master`** - The main Termux port branch
-  - Contains Termux-specific modifications applied on top of upstream
-  - Rebased onto new upstream versions when they are released
-  - Force-pushed after each rebase (history is rewritten)
-  
-- **`upstream`** - Clean upstream tracking branch
-  - Mirrors `https://github.com/badlogic/pi-mono.git` main branch
-  - Used as the base for rebasing master
-  - Never contains Termux-specific changes
-  - Helps maintain transparency about what's changed in the port
-
-### Tags
-
-Tags follow the naming convention: `v{UPSTREAM_VERSION}-{PORT_REVISION}`
-
-Examples:
-- `v0.45.7-0` - First Termux port of upstream v0.45.7
-- `v0.45.7-1` - Second Termux port of upstream v0.45.7 (port bugfix)
-- `v0.46.0-0` - First Termux port of upstream v0.46.0
-
-**Tags are immutable** - once published to npm, a tag is never changed or deleted. This preserves the complete version history.
-
-### Remotes
-
-- `origin` - This repository (`VaclavSynacek/pi-coding-agent-termux`)
-- `upstream` - Upstream repository (`badlogic/pi-mono`)
-
-## Maintenance Workflow
-
-### When a New Upstream Version is Released
-
-Example: Upstream releases `v0.46.0`
-
-1. **Update upstream branch**
-   ```bash
-   git checkout upstream
-   git fetch upstream
-   git merge upstream/main  # or git reset --hard upstream/main
-   git push origin upstream
-   ```
-
-2. **Rebase master onto new upstream version**
-   ```bash
-   git checkout master
-   git rebase v0.46.0  # rebase onto the upstream tag
-   ```
-
-3. **Resolve conflicts**
-   - Fix any rebase conflicts in Termux-specific patches
-   - Pay special attention to files listed in "Functional Changes" section above
-   - Ensure patches still apply cleanly and make sense
-
-4. **Test thoroughly**
-   - Build the project: `npm install && npm run build`
-   - Test on actual Termux device
-   - Verify clipboard operations (with Termux:API installed)
-   - Test that image operations degrade gracefully
-   - Check that all core features work
-
-5. **Update package.json version**
-   ```bash
-   cd packages/coding-agent
-   # Update version to match upstream (e.g., "0.46.0")
-   ```
-
-6. **Create immutable release tag**
-   ```bash
-   git tag -a v0.46.0-0 -m "Termux port of upstream v0.46.0"
-   git push origin v0.46.0-0
-   ```
-
-7. **Publish to npm**
-   ```bash
-   cd packages/coding-agent
-   npm publish
-   ```
-
-8. **Push rebased master**
-   ```bash
-   git push origin master --force-with-lease
-   ```
-
-### When Port Needs a Bugfix (Without Upstream Change)
-
-Example: Fix a bug in the Termux port of v0.46.0
-
-1. **Make fixes on master branch**
-   ```bash
-   git checkout master
-   # Make your fixes
-   git commit -m "fix: describe the port-specific fix"
-   ```
-
-2. **Update package.json version** (increment port revision)
-   ```bash
-   cd packages/coding-agent
-   # Version stays "0.46.0" (or use "0.46.0-termux.1" if needed)
-   ```
-
-3. **Create new port revision tag**
-   ```bash
-   git tag -a v0.46.0-1 -m "Termux port of upstream v0.46.0 (bugfix)"
-   git push origin v0.46.0-1
-   ```
-
-4. **Publish to npm**
-   ```bash
-   cd packages/coding-agent
-   npm publish
-   ```
-
-5. **Push master**
-   ```bash
-   git push origin master
-   ```
-
-### Initial Setup (Already Done)
-
-This was the initial setup of this repository:
-
-1. Created new repository
-2. Added upstream remote: `git remote add upstream https://github.com/badlogic/pi-mono.git`
-3. Fetched upstream: `git fetch upstream --tags`
-4. Created `upstream` branch: `git checkout -b upstream upstream/main`
-5. Created `master` branch from upstream v0.45.7: `git checkout -b master v0.45.7`
-6. Applied Termux patches as focused commits
-7. Tagged first release: `v0.45.7-0`
-
-## Termux Port Commits
-
-The Termux port consists of these focused commits (applied on top of upstream):
-
-1. **docs: Add comprehensive Termux port README** - Complete documentation and maintenance instructions
-2. **feat: Update TypeScript target to ES2024** - Enable modern JavaScript features
-3. **feat: Make @mariozechner/clipboard optional for Termux compatibility** - Optional require() for clipboard
-4. **feat: Add Termux clipboard support** - Integration with termux-clipboard-set/get
-5. **feat: Make @mariozechner/clipboard optional dependency** - Move to optionalDependencies in package.json
-6. **feat: Update version check to use Termux port package** - Point to @vaclav-synacek/pi-coding-agent-termux
-7. **feat: Update package.json for Termux port** - Package name and metadata
-8. **feat: Make canvas optional dependency in ai package** - Allow clean build on Termux
-9. **chore: Remove package-lock.json** - Platform-independent dependency resolution
-
-## Commit Strategy for Rebasing
-
-To make rebasing easier, Termux-specific changes are organized as **minimal, focused commits**:
-
-- One commit per logical change
-- Clear commit messages explaining why the change is needed for Termux
-- Avoid mixing unrelated changes
-- Keep patches as small as possible while maintaining functionality
-
-This approach ensures that when rebasing onto new upstream versions, conflicts are:
-- Easier to understand and resolve
-- Less likely to occur
-- Clearly attributable to specific Termux requirements
-
-## Development Notes
-
-### Building (Development Machine Required)
-
-**Important**: Building requires `tsgo` which doesn't have Android ARM64 binaries. Build on a regular development machine (Linux/macOS/Windows).
-
-This is a monorepo. To build all packages:
-
-```bash
-# From repository root (on development machine)
-npm install
-npm run build
-```
-
-To build only the coding-agent package:
-
-```bash
-cd packages/coding-agent
-npm run build
-```
-
-**For Termux deployment**: Build on a development machine, then either:
-1. Publish to npm and install from there
-2. Use `npm pack` to create a .tgz file and transfer it to Termux
-
-**Note**: The optional dependency `canvas` (in packages/ai) may fail to build due to missing native libraries (pixman-1). This is expected and harmless - npm will skip it and continue. Canvas is only used for ai package tests.
-
-### Testing on Termux
-
-1. Install Termux from F-Droid
-2. Install dependencies:
-   ```bash
-   pkg update && pkg install git nodejs-lts
-   pkg install termux-api  # For clipboard support
-   ```
-3. Install the package:
-   ```bash
-   npm install -g @vaclav-synacek/pi-coding-agent-termux
-   ```
-4. Run: `pi`
-
-**For development/testing unreleased changes**: Build on a development machine, create a tarball with `npm pack`, transfer to Termux, and install with `npm install -g /path/to/package.tgz`.
-
-### Comparison with Upstream
-
-To see all Termux-specific changes:
-
-```bash
-git diff upstream master
-```
-
-To see changes in a specific file:
-
-```bash
-git diff upstream master packages/coding-agent/src/utils/clipboard.ts
-```
-
-## Publishing to npm
-
-The package is published as `@vaclav-synacek/pi-coding-agent-termux` on npm.
-
-**Publishing steps:**
-
-```bash
-cd packages/coding-agent
-npm publish
-```
-
-**Key package.json fields:**
-- `name`: `@vaclav-synacek/pi-coding-agent-termux` (different from upstream to avoid conflicts)
-- `version`: Matches upstream version (e.g., `0.46.0`)
-- `description`: "Termux port of pi-coding-agent - Coding agent CLI with read, bash, edit, write tools and session management"
-- `repository`: Points to this repository (`VaclavSynacek/pi-coding-agent-termux`)
-- `homepage`: https://github.com/VaclavSynacek/pi-coding-agent-termux#readme
-
-## Why This Approach?
-
-This maintenance strategy provides:
-
-1. **Clean separation** - Clear distinction between upstream code and Termux patches
-2. **Easy updates** - Rebasing makes it straightforward to adopt new upstream features
-3. **Version history** - Immutable tags preserve every published version
-4. **Transparency** - Easy to see exactly what's different from upstream
-5. **Maintainability** - Future maintainers can understand the port structure
-6. **No upstream dependency** - Port can continue indefinitely without upstream acceptance
-
-## Contributing
-
-When contributing Termux-specific changes:
-
-1. Fork this repository
-2. Create a feature branch from `master`
-3. Make focused commits with clear messages
-4. Test on actual Termux device
-5. Submit pull request
-
-For general pi-coding-agent features/bugs, contribute to the [upstream repository](https://github.com/badlogic/pi-mono) instead.
-
-## License
-
-Same as upstream: MIT License
-
-See [LICENSE](LICENSE) file for details.
+**For full documentation, maintenance workflow, and technical details, see the [main repository README](https://github.com/VaclavSynacek/pi-coding-agent-termux#readme).**

package/dist/core/agent-session.d.ts

@@ -16,7 +16,7 @@ import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLe
 import type { ImageContent, Model, TextContent } from "@mariozechner/pi-ai";
 import { type BashResult } from "./bash-executor.js";
 import { type CompactionResult } from "./compaction/index.js";
-import type { ExtensionRunner } from "./extensions/index.js";
+import type { ExtensionRunner, InputSource } from "./extensions/index.js";
 import type { CustomMessage } from "./messages.js";
 import type { ModelRegistry } from "./model-registry.js";
 import { type PromptTemplate } from "./prompt-templates.js";
@@ -80,6 +80,8 @@ export interface PromptOptions {
     images?: ImageContent[];
     /** When streaming, how to queue the message: "steer" (interrupt) or "followUp" (wait). Required if streaming. */
     streamingBehavior?: "steer" | "followUp";
+    /** Source of input for extension input event handlers. Defaults to "interactive". */
+    source?: InputSource;
 }
 /** Result from cycleModel() */
 export interface ModelCycleResult {
@@ -239,17 +241,23 @@ export declare class AgentSession {
      */
     prompt(text: string, options?: PromptOptions): Promise<void>;
     private _tryExecuteExtensionCommand;
+    /**
+     * Expand skill commands (/skill:name args) to their full content.
+     * Returns the expanded text, or the original text if not a skill command or skill not found.
+     * Emits errors via extension runner if file read fails.
+     */
+    private _expandSkillCommand;
     /**
      * Queue a steering message to interrupt the agent mid-run.
      * Delivered after current tool execution, skips remaining tools.
-     * Expands file-based prompt templates. Errors on extension commands.
+     * Expands skill commands and prompt templates. Errors on extension commands.
      * @throws Error if text is an extension command
      */
     steer(text: string): Promise<void>;
     /**
      * Queue a follow-up message to be processed after the agent finishes.
      * Delivered only when agent has no more tool calls or steering messages.
-     * Expands file-based prompt templates. Errors on extension commands.
+     * Expands skill commands and prompt templates. Errors on extension commands.
      * @throws Error if text is an extension command
      */
     followUp(text: string): Promise<void>;