@chrok/pi-braid 0.1.0 → 0.1.1

package/README.md

@@ -90,7 +90,7 @@ only the current source IDs and diagnoses missing, duplicate or unexpected IDs.
 
 ## Install from npm
 
-Requires Node.js 22.19+ and Pi 0.85.1 (the tested version):
+Requires Node.js 22.19+ and Pi 0.87.1 (the tested version):
 
 ```sh
 pi install npm:@chrok/pi-braid
@@ -100,7 +100,7 @@ Add `-l` for a project-local installation. Run `/reload` after installation.
 The package includes compiled Braid core code from the matching release; it does
 not depend on a source checkout. Pi supplies its core peer packages at runtime.
 Their wildcard ranges follow Pi's packaging convention, not universal version
-compatibility. Development and CI pin Pi 0.85.1.
+compatibility. Development and CI pin Pi 0.87.1.
 
 ## Install this local checkout in Pi
 

package/dist/integrations/pi/index.js

@@ -50,9 +50,9 @@ const BRAID_FILESYSTEM_GUIDANCE = "In a Git repository, execute and decision nod
     "Inspect braid_status for integration outcomes and recovery checkpoint refs, then run tests in the parent. Avoid concurrent parent edits while a merge agent owns the source checkout.";
 const BRAID_USAGE_GUIDANCE = [
     "Braid is a proactive execution primitive, not only a user-requested command.",
-    "Selection rule: for a code review, bug investigation, design comparison, test-planning request, or change spanning multiple files, call braid FIRST when two or more concerns can be analyzed independently. Do this without waiting for the user to say Braid; do not read everything in the parent and then decide whether to delegate.",
+    "Selection rule: for a code review, bug investigation, design comparison, test-planning request, or change spanning multiple files, call braid FIRST when two or more concerns can be handled independently. Nodes can analyze the project and implement changes in isolated Git worktrees. Do this without waiting for the user to say Braid; do not read everything in the parent and then decide whether to delegate.",
     BRAID_FILESYSTEM_GUIDANCE,
-    "When Braid fits, construct and submit the complete DAG in one call: use parallel execute nodes for independent concerns and a final execute node to synthesize their outputs. The tool returns a jobId immediately. Continue independent work or finish your turn while it runs; do not poll repeatedly. A completion reminder will resume you. Use braid_status with the jobId to retrieve terminal outputs before relying on them.",
+    "When Braid fits, construct and submit the complete DAG in one call: use parallel execute nodes for independent analysis or implementation, execute nodes to synthesize findings, and merge nodes to integrate file changes. The tool returns a jobId immediately. Continue independent work or finish your turn while it runs; do not poll repeatedly. A completion reminder will resume you. Use braid_status with the jobId to retrieve terminal outputs before relying on them.",
     "Do not use braid for a simple one-step answer, a trivial direct edit, shell work, or when decomposition adds no value. The parent reviews results, runs tests, and executes shell commands after Braid completes.",
 ].join("\n");
 export function createBraidTools(jobs) {
@@ -69,10 +69,10 @@ export function createBraidTools(jobs) {
             "Do not use it for a simple one-step answer or trivial direct edit. " +
             "Use braid_status(jobId) for progress and results, or braid_cancel(jobId) to stop it. A completion reminder resumes the agent if idle; do independent work or end your turn instead of polling. Humans can open /braid for the live flow panel. " +
             "Read result.status: failed graphs can still return successful terminal outputs.",
-        promptSnippet: "Use FIRST for nontrivial code review/debug/design work; parallelize independent analysis and synthesize",
+        promptSnippet: "Use FIRST for nontrivial code review/debug/design/implementation work; parallelize analysis or edits in isolated Git worktrees and use merge nodes to integrate changes",
         promptGuidelines: [
-            "Call braid before direct repository inspection when a code task has two or more separable review, debugging, design, or test-planning concerns; the Braid nodes can inspect the project and edit isolated Git worktrees.",
-            "Use parallel execute nodes for independent concerns and a final synthesis node. The user does not need to mention Braid or design the graph.",
+            "Call braid before direct repository inspection when a code task has two or more separable review, debugging, design, test-planning, or implementation concerns; the Braid nodes can inspect the project and edit isolated Git worktrees.",
+            "Use parallel execute nodes for independent analysis or implementation, execute nodes to synthesize findings, and merge nodes to integrate file changes. The user does not need to mention Braid or design the graph.",
             "Do not use braid for simple one-step answers or trivial direct edits. Keep shell commands and test execution in the parent; use merge nodes for integration.",
             BRAID_FILESYSTEM_GUIDANCE,
             "Decision nodes additionally receive decide. Nodes cannot call recursive Braid.",

package/dist/integrations/pi/runner.js

@@ -98,7 +98,7 @@ export function createPiRunner(registry, onUsageOrOptions, cwd = process.cwd())
                         ? "You may write and edit files inside your own isolated Git worktree. Use workingDirectory as your cwd; do not write to sourceRoot or any other node's worktree. " +
                             "Nodes start from the current core snapshot of tracked changes and non-ignored untracked files. After merge nodes, newly started workers see the updated source checkout. Inspect predecessor checkpoints with git show when their worktrees have been removed. " +
                             "Describe your changes in your final answer. A merge agent will review your checkpoint and core will clean up the worktree. "
-                        : "This directory is not a Git working tree, so all tools are read-only; you cannot write or edit files. ") +
+                        : "This node has no writable workspace assigned. Its filesystem tools are read-only; you cannot write or edit files. ") +
                 mergeInstructions(request) +
                 "You cannot run shell commands, run tests, or call arbitrary tools. " +
                 (request.node.type === "merge" && workspace.mode === "read-only"

package/dist/src/adapters/openai.js

@@ -65,7 +65,11 @@ function parseCompletion(value) {
 export function createOpenAICompatibleRunner(options = {}) {
     const { apiKey, defaultModel } = options;
     const fetchImpl = options.fetch ?? globalThis.fetch;
-    const url = `${(options.baseURL ?? "https://api.openai.com/v1").replace(/\/+$/, "")}/chat/completions`;
+    const baseURL = options.baseURL ?? "https://api.openai.com/v1";
+    let end = baseURL.length;
+    while (end > 0 && baseURL[end - 1] === "/")
+        end--;
+    const url = `${baseURL.slice(0, end)}/chat/completions`;
     return async (request) => {
         const model = request.model ?? defaultModel;
         if (!model)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrok/pi-braid",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "description": "Pi extension for Braid: background DAG jobs and a live flow panel",
   "type": "module",
@@ -13,9 +13,9 @@
     "@earendil-works/pi-tui": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "0.85.1",
-    "@earendil-works/pi-tui": "0.85.1",
-    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-ai": "0.87.1",
+    "@earendil-works/pi-tui": "0.87.1",
+    "@earendil-works/pi-coding-agent": "0.87.1",
     "typescript": "^5.0.0",
     "tsx": "^4.0.0",
     "@types/node": "^22.0.0"