pi-agent-rb 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24f258d02d946aa8752944f4438581126665c94b5ee1253e61c8ebd16ecb6596
-  data.tar.gz: f98727ad546acbc6ea8dee3e2cf52af1cf7694f3875181fdec16c3773fd2e0b7
+  metadata.gz: db7831746ed3cbbd46e215293bb6a6e34dff2e31915b47a733737aa91ae15e4b
+  data.tar.gz: 61af774b3c9125f05aa4cfcafe11e5af31459a7db8a796487ed8857f5b677c1c
 SHA512:
-  metadata.gz: 32e5f3a97a2f6b890a1f1c8aecdd59125a4588b6879e815471ad2257942d291a6ccc5c46d32e4bd04abe13020e8ccb4cde1643dfb9230bea9e7974bb8008513f
-  data.tar.gz: '099b2a2267bd8a7212c6d90473775d54a22e7d80982471682ae339cd01875383561bd77364f9f9fe54c8a9514ae26023811ec24a8bcbe1b2dd035f1412f30377'
+  metadata.gz: cb4424e7698e4481dbda464cd5df382a3a555316ee923d5ca5d55faf9692701b606932d753e13ebf5dacf94c878868c7455e401786e1b5667f0d8daaccbf5c15
+  data.tar.gz: ccc703e5e81c2bf3ff3b47fa2605a391eeea66e9f1cee7603fba83db2e74f948a7c4b14b90db79ade99a5d8024513619c8764595a9d9456a8af6ede8b34815d1

data/CHANGELOG.md

@@ -7,6 +7,84 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-07-30
+
+### Added
+- Added the optional `on_extension_ui_error` callback to `PiAgent.open`,
+  `PiAgent.session`, and `PiAgent::Client`. Applications can now observe an
+  Extension UI handler exception together with its request while the dialog
+  still fails closed as cancelled. Exceptions raised by the observer are also
+  isolated so they cannot prevent the cancellation response.
+
+### Changed
+- Bumped pinned upstream `pi-coding-agent` version to `0.83.0` (from
+  `0.82.1`). This is a CLI/provider/extension batch; none of the changes
+  alter the JSONL RPC command/response shapes this gem drives, so no gem
+  API change is required.
+  - Adds `pi auth print-api-key` and `pi auth print-bearer-token` for
+    exporting configured credentials to external clients, with automatic
+    OAuth refresh and configurable minimum token validity. These are CLI
+    subcommands, outside the RPC surface this gem speaks.
+  - Adds headless OpenRouter sign-in (paste the redirect URL or
+    authorization code when the loopback callback is unavailable) and
+    Claude Opus 5 on GitHub Copilot with adaptive thinking and a 1M
+    context window. Both are provider/`/login` concerns.
+  - Exposes the session's resolved model scope as `ctx.scopedModels` to
+    extensions, adds a `"pending"` stop reason for partial streaming
+    messages, and surfaces raw provider stop reasons across Google,
+    Anthropic, Bedrock, Mistral, and OpenAI (unmapped terminal reasons now
+    surface as provider errors). These are SDK/extension and
+    provider-stream concerns; RPC event payloads still flow through
+    `PiAgent::Event` transparently.
+  - **Breaking for TypeScript extensions only:** upstream upgraded bundled
+    TypeBox aliases to 1.3.7, removing deprecated APIs (`Type.Base`,
+    `Type.Awaited`, `Type.Promise`, `Type.AsyncIterator`, `Type.Iterator`,
+    `Type.Options`, `Value.Mutate`) and fixing nullable-array tool-argument
+    validation. This does not affect this Ruby gem, which does not author
+    TypeBox schemas.
+  - The remainder are inherited fixes (tool-output expansion status line,
+    file-backed `SYSTEM.md`/`APPEND_SYSTEM.md` startup listing, worktree
+    context double-load, llama.cpp usage accounting, session replacement
+    during active responses, Git package install retries, `/model`
+    selector, direct RPC bash bypassing `user_bash` handlers, resource
+    metadata, and assorted provider fixes) that leave the RPC contract
+    unchanged.
+
+## [0.2.1] - 2026-07-25
+
+### Changed
+- Bumped pinned upstream `pi-coding-agent` version to `0.82.1` (from
+  `0.81.1`, rolling up `0.82.0` and `0.82.1`). This is a provider/tooling
+  and reliability batch; none of the changes alter the JSONL RPC
+  command/response shapes this gem drives, so no gem API change is required.
+  - `0.82.1` adds Claude Opus 5 (Anthropic and Amazon Bedrock, with
+    adaptive thinking), `ANTHROPIC_AUTH_TOKEN` bearer auth for
+    Anthropic-compatible gateways, and faster/more resilient model
+    catalogs (pi.dev revalidates with `If-None-Match`). It exposes the
+    `outputPad` setting to custom message renderers and fixes
+    compaction/branch summaries for header-only auth providers, `/models`
+    hiding of unavailable scoped models, startup context-file `EISDIR`
+    warnings, and llama.cpp catalog persistence. All provider/SDK/TUI
+    concerns, leaving the RPC contract unchanged.
+  - `0.82.0` details follow.
+  - Adds constrained tool sampling (`Tool.constrainedSampling` with strict
+    JSON Schema and OpenAI Lark/regex grammars) plus `supportsGrammarTools`
+    / `supportsStrictTools` model capability metadata. This is an
+    SDK/extension tool-configuration concern, not part of the RPC surface.
+  - Adds OpenRouter OAuth PKCE and Kimi Code subscription sign-in via
+    `/login`, and exposes `PI_SESSION_ID`, `PI_SESSION_FILE`, `PI_PROVIDER`,
+    `PI_MODEL`, and `PI_REASONING_LEVEL` to commands run by built-in and
+    factory-created bash tools.
+  - Adds streaming `bash_execution_update` events for direct RPC bash
+    commands, correlated with request IDs. These flow through
+    `PiAgent::Event` transparently — it preserves the native payload on
+    `#raw` and exposes `#type` as a symbol — so no gem change is needed to
+    consume them.
+  - The remainder are inherited provider/retry/model-catalog fixes (DNS
+    lookup retries, OpenRouter cache breakpoints, protobufjs 7.6.5 security
+    bump, catalog mtime and llama.cpp context fixes) that leave the RPC
+    contract unchanged.
+
 ## [0.2.0] - 2026-07-23
 
 Minor (not patch) release: besides the stream-truncation fix, the block form

data/README.md

@@ -14,7 +14,7 @@ building interactive agent UIs (web, TUI) on top of pi.
 
 - Ruby 3.3+
 - `pi` 0.80.4+ on `PATH` (install via `npm i -g @earendil-works/pi-coding-agent`)
-- This gem is pinned against pi `0.81.1`; other versions may work but are not verified.
+- This gem is pinned against pi `0.83.0`; other versions may work but are not verified.
 
 ## Installation
 
@@ -105,7 +105,7 @@ Pi emits `agent_end` after each low-level agent run, but may then retry,
 compact and retry, or process queued continuations. It emits
 `agent_settled` only when no automatic work remains, so high-level streams
 use that as their completion boundary. Upstream added the RPC event in pi
-0.80.4; it is available in this gem's pinned pi 0.81.1.
+0.80.4; it is available in this gem's pinned pi 0.83.0.
 
 `events` is a lower-level, prompt-less drain of the same stream. Because it
 subscribes lazily when iteration begins, it only works when you subscribe
@@ -175,6 +175,32 @@ Returning `nil` from a dialog handler cancels it. With no handler,
 dialogs are auto-cancelled so the agent never hangs. Handlers run on
 their own thread and never block the event stream.
 
+If a handler raises, the dialog is cancelled as a fail-safe. Use
+`on_extension_ui_error` when the application needs to observe those failures:
+
+```ruby
+on_ui_error = lambda do |error, request|
+  logger.error(
+    "Extension UI handler failed",
+    error: error.class.name,
+    request_id: request.id,
+    method: request.method
+  )
+end
+
+PiAgent.session(
+  extension_ui: handler,
+  on_extension_ui_error: on_ui_error
+) do |session|
+  session.prompt("Refactor the parser") { |e| ... }
+end
+```
+
+The observer runs on the same worker thread and cannot change the fail-safe
+cancellation. If it raises, the dialog is still cancelled. Requests can contain
+sensitive titles, messages, options, or prefilled text, so avoid logging
+`request.raw` without application-specific filtering.
+
 ## Forking
 
 ```ruby

data/lib/pi_agent/client.rb

@@ -52,8 +52,9 @@ module PiAgent
     end
 
     def initialize(bin: nil, args: DEFAULT_ARGS, env: {}, cwd: nil, approve: nil,
-                   extension_ui: nil, transport_factory: nil)
+                   extension_ui: nil, on_extension_ui_error: nil, transport_factory: nil)
       @extension_ui_handler = extension_ui
+      @extension_ui_error_handler = on_extension_ui_error
       args = [*args, approve ? "--approve" : "--no-approve"] unless approve.nil?
       @transport_factory = transport_factory || build_subprocess_factory(bin, args, env, cwd)
       @pending = {}
@@ -70,7 +71,11 @@ module PiAgent
         on_message: method(:handle_message),
         on_stderr: method(:handle_stderr)
       )
-      @extension_ui = ExtensionUI.new(writer: @transport, handler: @extension_ui_handler)
+      @extension_ui = ExtensionUI.new(
+        writer: @transport,
+        handler: @extension_ui_handler,
+        on_error: @extension_ui_error_handler
+      )
       @transport.start
       self
     end

data/lib/pi_agent/extension_ui.rb

@@ -19,6 +19,7 @@ module PiAgent
   #   - fire-and-forget methods : return value ignored
   #
   # With no handler, dialogs are auto-cancelled so the agent never hangs.
+  # Handler failures also cancel the dialog; pass `on_error` to observe them.
   class ExtensionUI
     DIALOG_METHODS = %i[select confirm input editor].freeze
 
@@ -50,9 +51,10 @@ module PiAgent
       end
     end
 
-    def initialize(writer:, handler: nil)
+    def initialize(writer:, handler: nil, on_error: nil)
       @writer = writer
       @handler = handler
+      @on_error = on_error
       @threads = []
       @mutex = Mutex.new
     end
@@ -75,7 +77,21 @@ module PiAgent
     private
 
     def handle(request)
-      result = invoke_handler(request)
+      result, error = invoke_handler(request)
+      write_response(request, result)
+      notify_error(error, request) if error
+    end
+
+    def invoke_handler(request)
+      return [nil, nil] if @handler.nil?
+
+      [@handler.call(request), nil]
+    rescue StandardError => e
+      # A raising handler cancels the dialog rather than hanging the agent.
+      [nil, e]
+    end
+
+    def write_response(request, result)
       return unless request.dialog?
 
       @writer.write(response_for(request, result))
@@ -83,12 +99,10 @@ module PiAgent
       # Transport closed during shutdown; the response is moot.
     end
 
-    def invoke_handler(request)
-      return nil if @handler.nil?
-
-      @handler.call(request)
+    def notify_error(error, request)
+      @on_error&.call(error, request)
     rescue StandardError
-      # A raising handler cancels the dialog rather than hanging the agent.
+      # Error observers cannot prevent the fail-closed response.
       nil
     end
 

data/lib/pi_agent/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module PiAgent
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 
   # Pinned upstream pi-coding-agent version this gem is verified against.
   # See: https://www.npmjs.com/package/@earendil-works/pi-coding-agent
-  SUPPORTED_PI_VERSION = "0.81.1"
+  SUPPORTED_PI_VERSION = "0.83.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pi-agent-rb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - chagel
@@ -85,7 +85,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby client for the pi coding agent (drives `pi --mode rpc`)
 test_files: []