localpi 0.6.2 → 0.6.3

package/README.md

@@ -109,6 +109,10 @@ Localpi launches Pi with:
 - in-session `/thinking` (Pi's own command) and `/approval` (localpi's) for changing session settings
 - local state under `~/.local/state/localpi`
 
+Pi owns stdout. Localpi writes its own diagnostics, including the connection summary and catalog
+warnings, to stderr. A machine-readable Pi mode such as `--mode rpc` or `--mode json` therefore stays
+parseable, and a batch run keeps a clean stdout.
+
 The approval gate makes failed or denied tool calls explicit to the model so the model does not claim that a blocked command ran.
 
 ## Skills

package/dist/src/cli/cli.js

@@ -307,7 +307,13 @@ async function launchResolvedRuntime(app, connection) {
     if (code !== 0) {
         return { code, stdout: "", stderr: "" };
     }
-    return ok(connection.warnings.length === 0 ? "" : connectionStatus(connection));
+    // Pi owns stdout. Localpi reports its own diagnostics on stderr, so a machine-readable Pi mode
+    // such as --mode rpc or --mode json stays parseable.
+    return {
+        code: 0,
+        stdout: "",
+        stderr: connection.warnings.length === 0 ? "" : connectionStatus(connection)
+    };
 }
 /**
  * ACP mode keeps stdout for the protocol only, so localpi reports its own diagnostics on stderr and

package/docs/runtime-specification.md

@@ -201,6 +201,10 @@ Localpi installs two default extensions:
 - tool approval gate: ask before each tool call, and tell the model clearly when a tool call was blocked
 - token status: show live generation speed while streaming, then final prefill and generation rates when usage data is available
 
+Pi owns stdout. Localpi writes its own diagnostics, including the connection summary
+and catalog warnings, to stderr, so a machine-readable Pi mode such as `--mode rpc`
+or `--mode json` stays parseable and a batch run keeps a clean stdout.
+
 ## System Prompt
 
 Localpi appends a short system prompt that tells the model:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localpi",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Swiss army knife for running Pi with local inference engines.",
   "type": "module",
   "license": "MIT",