pi-fabric 0.76.0 → 0.76.2

package/dist/core/system-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-guidance.d.ts","sourceRoot":"","sources":["../../src/core/system-guidance.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,GAAI,cAAc,OAAO,KAAG,MASzD,CAAC;AAEd,eAAO,MAAM,8BAA8B,GAAI,cAAc,OAAO,KAAG,MAGoQ,CAAC;AAG5U,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAQD,eAAO,MAAM,2BAA2B,GACtC,OAAO,aAAa,CAAC,yBAAyB,CAAC,EAC/C,eAAe,WAAW,CAAC,MAAM,CAAC,KACjC,MAAM,GAAG,SAyBX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,KAAG,MAAM,GAAG,SAQjF,CAAC"}
+{"version":3,"file":"system-guidance.d.ts","sourceRoot":"","sources":["../../src/core/system-guidance.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,6BAA6B,GAAI,cAAc,OAAO,KAAG,MASzD,CAAC;AAEd,eAAO,MAAM,8BAA8B,GAAI,cAAc,OAAO,KAAG,MAGoQ,CAAC;AAG5U,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAqCD,eAAO,MAAM,2BAA2B,GACtC,OAAO,aAAa,CAAC,yBAAyB,CAAC,EAC/C,eAAe,WAAW,CAAC,MAAM,CAAC,KACjC,MAAM,GAAG,SA8BX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,KAAG,MAAM,GAAG,SAQjF,CAAC"}

package/dist/execution-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-service.d.ts","sourceRoot":"","sources":["../src/execution-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-service.d.ts","sourceRoot":"","sources":["../src/execution-service.ts"],"names":[],"mappings":"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"}

package/dist/fabric-exec-arguments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fabric-exec-arguments.d.ts","sourceRoot":"","sources":["../src/fabric-exec-arguments.ts"],"names":[],"mappings":"AAyDA,eAAO,MAAM,yBAAyB,GAAI,QAAQ;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAC8D,CAAC;AAE5F,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,OAwC3D,CAAC"}
+{"version":3,"file":"fabric-exec-arguments.d.ts","sourceRoot":"","sources":["../src/fabric-exec-arguments.ts"],"names":[],"mappings":"AA0DA,eAAO,MAAM,yBAAyB,GAAI,QAAQ;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAC8D,CAAC;AAE5F,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,OA4C3D,CAAC"}

package/dist/fabric-exec-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fabric-exec-tool.d.ts","sourceRoot":"","sources":["../src/fabric-exec-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAa7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,4BAA4B,CAAC;AAQpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA6CjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiDxE,eAAO,MAAM,oBAAoB,GAC/B,OAAO,WAAW,EAClB,qBAAqB,mBAAmB,EACxC,iBAAiB,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAClD,gBAAe,wBAA+C,EAC9D,cAAc,2BAA2B,KACxC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAi1B9B,CAAC"}
+{"version":3,"file":"fabric-exec-tool.d.ts","sourceRoot":"","sources":["../src/fabric-exec-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAa7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,4BAA4B,CAAC;AAQpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA6CjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiDxE,eAAO,MAAM,oBAAoB,GAC/B,OAAO,WAAW,EAClB,qBAAqB,mBAAmB,EACxC,iBAAiB,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAClD,gBAAe,wBAA+C,EAC9D,cAAc,2BAA2B,KACxC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAk1B9B,CAAC"}

package/dist/index.js

@@ -15,10 +15,11 @@ import {
   formatSkillsForPrompt,
   hasPrewalkArmedPrompt,
   prewalkArmedPrompt,
+  repairFabricGuestCode,
   resolveFabricIdentity,
   settleInPlacePrewalk,
   withTrajectoryRearmDirective
-} from "./chunks/chunk-NI3ZXJZD.js";
+} from "./chunks/chunk-PAAXKXWT.js";
 import {
   activeStatuses,
   arcItemStyled,
@@ -1603,6 +1604,8 @@ ${sections.join("\n")}` : "";
 };
 
 // src/core/system-guidance.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import * as path4 from "node:path";
 var fabricExecutionKernelGuidance = (fullCodeMode) => [
   fullCodeMode ? "Pi Fabric full code mode: `fabric_exec` is the only way to call Pi core tools \u2014 use them as `pi.*` inside `code`." : "Pi Fabric is in orchestration-only mode. Pi core and registered extension tools stay on their native direct execution path; inside fabric_exec, `pi.*` and `extensions.*` are unavailable.",
   // Files the model has not opened (images in particular) must be read before
@@ -1611,13 +1614,38 @@ var fabricExecutionKernelGuidance = (fullCodeMode) => [
   `Read every file the user provides (images, screenshots, code, text) with the ${fullCodeMode ? "`pi.read`" : "`read`"} tool before responding \u2014 never assume its contents.`
 ].join(" ");
 var defaultFabricExecutionGuidance = (fullCodeMode) => fullCodeMode ? "Examples and returns: `pi.read('/x')`, `pi.grep('TODO','src')` / `pi.grep({pattern:'TODO', path:'src', ignoreCase:true, context:2})`, `pi.find({pattern:'*.ts', path:'src', limit:20})`, and `pi.ls('src')` return strings; `pi.bash({cmd:'ls'})`, `pi.edit({path:'/x', old:'a', new:'b'})`, and `pi.write({path:'/y', text:'z'})` return `{ok, output, details}` (read `.output`); failed core calls reject, including `bash` on an ordinary nonzero exit; pass `settle: true` to `pi.bash` to get `{ ok: false, exitCode, output, error }` instead. Timeout, cancellation, approval, and security failures still reject.\n`tools` is discovery + generic calls only (`providers`/`catalog`/`list`/`search`/`describe`/`call`/`models`). Call known MCP tools as `mcp.<sanitized_server>.<sanitized_tool>(args)`, captured tools as `extensions.<tool>(args)`, and stable providers as `memory.*`, `state.*`, `schema.*`, or `compact.*`. Use `tools.call({ref,args})` for computed refs. `pi` is the core tools; `\u03C0.<key>` reads named `strings` (not a tool)." : "Call known actions through `mcp.<sanitized_server>.<sanitized_tool>(args)`, `memory.*`, `state.*`, `schema.*`, `components.*`, `compact.*`, `agents.*`, or `mesh.*`; use `tools.catalog`/`search`/`describe`/`list` for discovery and `tools.call({ref,args})` for computed refs. Other surfaces are opt-in via user-loaded skills.";
+var manifestNameCache = /* @__PURE__ */ new Map();
+var packageNameFromManifest = (startPath) => {
+  if (!startPath) return void 0;
+  let directory = path4.dirname(path4.resolve(startPath));
+  while (true) {
+    if (manifestNameCache.has(directory)) return manifestNameCache.get(directory);
+    const manifestPath = path4.join(directory, "package.json");
+    let name;
+    if (existsSync2(manifestPath)) {
+      try {
+        const manifest = JSON.parse(readFileSync2(manifestPath, "utf8"));
+        if (typeof manifest.name === "string" && manifest.name.trim()) name = manifest.name.trim();
+      } catch {
+      }
+    }
+    manifestNameCache.set(directory, name);
+    if (name) return name;
+    const parent = path4.dirname(directory);
+    if (parent === directory) return void 0;
+    directory = parent;
+  }
+};
 var extensionToolRosterGuidance = (tools, coreToolNames) => {
   const extensionTools = tools.filter((tool) => !coreToolNames.has(tool.name));
   if (extensionTools.length === 0) return void 0;
   const namespaceLabel = (tool) => {
     const source = tool.sourceInfo?.source?.trim();
-    if (source) return source;
-    const parts = (tool.sourceInfo?.path ?? "").split(/[\\/]/).filter(Boolean);
+    if (source?.startsWith("npm:")) return source.slice("npm:".length) || source;
+    const manifestName = packageNameFromManifest(tool.sourceInfo?.path) ?? packageNameFromManifest(source && /[\\/]/.test(source) ? source : void 0);
+    if (manifestName) return manifestName;
+    if (source && !/[\\/]/.test(source)) return source;
+    const parts = (tool.sourceInfo?.path ?? source ?? "").split(/[\\/]/).filter(Boolean);
     const base = parts.at(-1)?.trim() ?? "";
     if (/^index\./i.test(base)) return parts.at(-2)?.trim() || base;
     return base || "extensions";
@@ -1851,8 +1879,8 @@ var formatFailureProgress = (trace) => {
   );
   if (completed.length === 0) return void 0;
   const summaries = completed.slice(0, MAX_COMPLETED_CALLS).map((operation) => {
-    const path9 = operation.args.path;
-    return typeof path9 === "string" ? `${operation.ref}(${compactPath(path9)})` : operation.ref;
+    const path10 = operation.args.path;
+    return typeof path10 === "string" ? `${operation.ref}(${compactPath(path10)})` : operation.ref;
   });
   const omitted = completed.length - summaries.length;
   return [
@@ -1901,7 +1929,7 @@ var normalizeFabricExecStrings = (input) => {
 };
 var resolveFabricExecPayloads = (params) => normalizeFabricExecStrings(params.payloads) ?? normalizeFabricExecStrings(params.strings);
 var prepareFabricExecArguments = (input) => {
-  if (typeof input === "string") return { code: input };
+  if (typeof input === "string") return { code: repairFabricGuestCode(input) };
   if (!isRecord4(input)) return input;
   let prepared = input;
   const writable = () => {
@@ -1911,6 +1939,10 @@ var prepareFabricExecArguments = (input) => {
   if (Array.isArray(prepared.code) && prepared.code.every((line) => typeof line === "string")) {
     writable().code = prepared.code.join("\n");
   }
+  if (typeof prepared.code === "string") {
+    const repaired = repairFabricGuestCode(prepared.code);
+    if (repaired !== prepared.code) writable().code = repaired;
+  }
   for (const key of OPTIONAL_FABRIC_EXEC_KEYS) {
     if (!Object.hasOwn(prepared, key)) continue;
     if (prepared[key] === null || prepared[key] === void 0) delete writable()[key];
@@ -1999,6 +2031,7 @@ var CORE_TOOL_PROPERTIES = collectCoreToolProperties(GUEST_TYPE_DECLARATIONS);
 // src/type-error-guidance.ts
 var SYNTAX_ERROR_PATTERN = /expected|unterminated|unexpected|invalid character/i;
 var PAYLOAD_CALL_PATTERN = /\bpi\.(?:edit|write)\s*\(/;
+var UNQUOTED_PATH_HEAD = /\bpi\.(?:read|ls|write|edit)\(\s*(?:https?:\/\/|\/(?![/*])|\.\/|\.\.\/|~\/|[A-Za-z]:[\\/])/;
 var PROMISE_ALL_PATTERN = /\bPromise\.all\s*\(/;
 var TUPLE_ARITY_PATTERN = /Tuple type .* of length '[0-9]+' has no element at index '[0-9]+'/;
 var MISSING_NAME_PATTERN = /^Cannot find name '([^']+)'/;
@@ -2084,6 +2117,11 @@ var typeErrorRecoveryHint = (code, errors) => {
   if (hasLiteralPayloadInterpolation(code, errors)) {
     return "Recovery hint: a `${...}` expression in an edit/write payload is being evaluated by the Fabric TypeScript program. Declare it if intentional; for literal file content, move the payload to top-level `payloads` and reference `\u03C0.key`.";
   }
+  if (UNQUOTED_PATH_HEAD.test(code) && errors.some(
+    (error) => SYNTAX_ERROR_PATTERN.test(error.message) || error.message.includes("Cannot find name") || error.message.includes("Expected 1-2 arguments")
+  )) {
+    return "Recovery hint: quote filesystem paths and URLs as strings, e.g. `pi.read('/x')` or `pi.read({ path: '/x' })`. Unquoted paths are parsed as regex, division, or extra arguments.";
+  }
   if (!PAYLOAD_CALL_PATTERN.test(code)) return void 0;
   if (!errors.some((error) => SYNTAX_ERROR_PATTERN.test(error.message))) {
     return void 0;
@@ -2175,12 +2213,12 @@ var PartialResultObserver = class {
 // src/output-budget.ts
 import { mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import path4 from "node:path";
+import path5 from "node:path";
 var MAX_FAILURE_MODEL_OUTPUT_CHARS = 2e4;
 var modelOutputBudget = (configuredMaxChars, success) => success ? configuredMaxChars : Math.min(configuredMaxChars, MAX_FAILURE_MODEL_OUTPUT_CHARS);
 var writeOutputArtifact = async (content) => {
-  const directory = await mkdtemp(path4.join(tmpdir(), "pi-fabric-output-"));
-  const artifactPath = path4.join(directory, "output.txt");
+  const directory = await mkdtemp(path5.join(tmpdir(), "pi-fabric-output-"));
+  const artifactPath = path5.join(directory, "output.txt");
   await writeFile(artifactPath, content, { encoding: "utf8", mode: 384 });
   return artifactPath;
 };
@@ -2786,7 +2824,8 @@ ${preview}` : ""}${hiddenHint}`,
     },
     async execute(toolCallId, params, signal, onUpdate, context) {
       await state.ensure(context);
-      const code = Array.isArray(params.code) ? params.code.join("\n") : params.code;
+      const joined = Array.isArray(params.code) ? params.code.join("\n") : params.code;
+      const code = repairFabricGuestCode(joined);
       const runDisplay = normalizeRunDisplay(params.display);
       const strings = resolveFabricExecPayloads(params);
       const result = await state.execution.execute({
@@ -2923,7 +2962,7 @@ ${recoveryHint}` : ""}`,
 
 // src/fabric-state.ts
 import fs2 from "node:fs";
-import path5 from "node:path";
+import path6 from "node:path";
 var FabricState = class {
   constructor(pi, capturedTools, options = {}) {
     this.pi = pi;
@@ -3059,10 +3098,10 @@ var FabricState = class {
     const sessionId = context.sessionManager.getSessionId();
     if (resolveFabricIdentity(sessionId).identity.kind !== "main") return false;
     const projectRoot = process.env.PI_FABRIC_PROJECT_ROOT ?? context.cwd;
-    const meshRoot = process.env.PI_FABRIC_MESH_ROOT ?? (this.config.mesh.root ? path5.resolve(projectRoot, this.config.mesh.root) : path5.join(projectRoot, ".pi", "fabric", "mesh"));
-    const actorRoot = this.config.mesh.actorScope === "session" ? path5.join(meshRoot, "actors", sessionId) : path5.join(meshRoot, "actors");
+    const meshRoot = process.env.PI_FABRIC_MESH_ROOT ?? (this.config.mesh.root ? path6.resolve(projectRoot, this.config.mesh.root) : path6.join(projectRoot, ".pi", "fabric", "mesh"));
+    const actorRoot = this.config.mesh.actorScope === "session" ? path6.join(meshRoot, "actors", sessionId) : path6.join(meshRoot, "actors");
     try {
-      const registry = JSON.parse(fs2.readFileSync(path5.join(actorRoot, "actors.json"), "utf8"));
+      const registry = JSON.parse(fs2.readFileSync(path6.join(actorRoot, "actors.json"), "utf8"));
       if (typeof registry !== "object" || registry === null || Array.isArray(registry)) return false;
       const actors = registry.actors;
       return Array.isArray(actors) && actors.some((value) => {
@@ -3267,7 +3306,7 @@ var FabricState = class {
     return activation;
   }
   async #createRuntime() {
-    const module = await (this.#options.runtimeLoader?.() ?? import("./chunks/fabric-runtime-state-FBAJTXB2.js"));
+    const module = await (this.#options.runtimeLoader?.() ?? import("./chunks/fabric-runtime-state-VCLWTB55.js"));
     return new module.FabricRuntimeState(
       this.pi,
       this.capturedTools,
@@ -3291,8 +3330,8 @@ var FabricState = class {
 };
 
 // src/host-compatibility.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, realpathSync as realpathSync2 } from "node:fs";
-import path6 from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, realpathSync as realpathSync2 } from "node:fs";
+import path7 from "node:path";
 var MINIMUM_PI_HOST_VERSION = "0.80.6";
 var PI_HOST_PACKAGE_NAMES = /* @__PURE__ */ new Set([
   "@earendil-works/pi-coding-agent",
@@ -3323,22 +3362,22 @@ var detectPiHostVersion = (cliPath = process.argv[1]) => {
   if (!cliPath) return void 0;
   let directory;
   try {
-    directory = path6.dirname(realpathSync2(cliPath));
+    directory = path7.dirname(realpathSync2(cliPath));
   } catch {
     return void 0;
   }
   while (true) {
-    const manifestPath = path6.join(directory, "package.json");
-    if (existsSync2(manifestPath)) {
+    const manifestPath = path7.join(directory, "package.json");
+    if (existsSync3(manifestPath)) {
       try {
-        const manifest = JSON.parse(readFileSync2(manifestPath, "utf8"));
+        const manifest = JSON.parse(readFileSync3(manifestPath, "utf8"));
         if (typeof manifest.name === "string" && PI_HOST_PACKAGE_NAMES.has(manifest.name) && typeof manifest.version === "string") {
           return manifest.version;
         }
       } catch {
       }
     }
-    const parent = path6.dirname(directory);
+    const parent = path7.dirname(directory);
     if (parent === directory) return void 0;
     directory = parent;
   }
@@ -3351,7 +3390,7 @@ var piHostCompatibilityWarning = (version = detectPiHostVersion()) => {
 };
 
 // src/ui/controller.ts
-import path7 from "node:path";
+import path8 from "node:path";
 
 // src/ui/snapshot.ts
 var MAX_UI_AGENTS = 240;
@@ -4063,7 +4102,7 @@ var FabricUiController = class {
         logFile: actor.worker.logFile
       };
     }
-    const retained = actor.lastRunId && actor.logDir ? path7.join(actor.logDir, actor.lastRunId, "events.jsonl") : void 0;
+    const retained = actor.lastRunId && actor.logDir ? path8.join(actor.logDir, actor.lastRunId, "events.jsonl") : void 0;
     if (retained) return { id: actor.id, status: actor.status, logFile: retained };
     if (actor.sessionFile) {
       return { id: actor.id, status: actor.status, logFile: actor.sessionFile };
@@ -4182,16 +4221,16 @@ var FabricToolDisplayController = class {
 var REFRESH_CARDS_PER_TICK = 3;
 
 // src/index.ts
-import { existsSync as existsSync3 } from "node:fs";
-import path8 from "node:path";
+import { existsSync as existsSync4 } from "node:fs";
+import path9 from "node:path";
 import { fileURLToPath } from "node:url";
-var FABRIC_EXTENSION_ENTRY_PATH = path8.resolve(fileURLToPath(import.meta.url));
-var FABRIC_ENTRY_DIR = path8.dirname(FABRIC_EXTENSION_ENTRY_PATH);
+var FABRIC_EXTENSION_ENTRY_PATH = path9.resolve(fileURLToPath(import.meta.url));
+var FABRIC_ENTRY_DIR = path9.dirname(FABRIC_EXTENSION_ENTRY_PATH);
 var FABRIC_RUNTIME_PATHS = {
   extension: FABRIC_EXTENSION_ENTRY_PATH,
-  worker: path8.join(FABRIC_ENTRY_DIR, "worker.js"),
-  residentHost: path8.join(FABRIC_ENTRY_DIR, "residency", "launcher.js"),
-  skills: path8.resolve(FABRIC_ENTRY_DIR, "..", "skills")
+  worker: path9.join(FABRIC_ENTRY_DIR, "worker.js"),
+  residentHost: path9.join(FABRIC_ENTRY_DIR, "residency", "launcher.js"),
+  skills: path9.resolve(FABRIC_ENTRY_DIR, "..", "skills")
 };
 var FABRIC_SKILLS_DIR = FABRIC_RUNTIME_PATHS.skills;
 var componentRegistrationFrom = (value) => {
@@ -4273,7 +4312,7 @@ async function piFabric(pi) {
     }
   );
   pi.on("resources_discover", async () => {
-    if (existsSync3(FABRIC_SKILLS_DIR)) return { skillPaths: [FABRIC_SKILLS_DIR] };
+    if (existsSync4(FABRIC_SKILLS_DIR)) return { skillPaths: [FABRIC_SKILLS_DIR] };
     return {};
   });
   const fabricTool = createFabricExecTool(