pi-fabric 0.86.0 → 0.87.0

package/README.md

@@ -102,7 +102,7 @@ pi -e /absolute/path/to/pi-fabric
 
 ## What you can ask for
 
-Pi loads advanced patterns after direct user invocation. Run `/skill:fabric-guide` for one recommendation, or invoke the exact `/skill:<name>` yourself. An ordinary coding task keeps Pi on the core `fabric-exec` path.
+Pi loads advanced patterns after direct user invocation. Run `/skill:fabric-guide` for one recommendation, or invoke the exact `/skill:<name>` yourself. An ordinary coding task uses the kernel-matched execution reference (`fabric-exec` for TypeScript, `fabric-exec-python` for Python). The advanced workflows below currently require TypeScript.
 
 | You want | Run |
 | -------- | --- |
@@ -118,7 +118,7 @@ Pi loads advanced patterns after direct user invocation. Run `/skill:fabric-guid
 | A durable team coordinating through versioned tasks | `/skill:fabric-swarm Coordinate this migration across owned task partitions.` |
 | Evidence-gated edits with postconditions | `/skill:fabric-schema Make this parser change only if focused tests stay green.` |
 
-The foundation is the `fabric-exec` reference skill: the model loads it before its first `fabric_exec` call and again when a call errors on argument shape.
+Execution references stay progressive: the model loads the selected kernel's skill after argument-shape errors or when exact advanced contracts are needed. Skills can declare `metadata.fabric-kernel` for runtime selection; see [kernel-specific skills](docs/kernels.md#kernel-specific-skills-and-guidance).
 
 ## Agent conversations
 

package/dist/chunks/{chunk-PPIWZJ4M.js → chunk-7RPCSGQM.js}

@@ -398,4 +398,4 @@ var FabricState = class {
 export {
   FabricState
 };
-//# sourceMappingURL=chunk-PPIWZJ4M.js.map
+//# sourceMappingURL=chunk-7RPCSGQM.js.map

package/dist/chunks/{chunk-Z3AEX7SQ.js → chunk-GRA2PF4H.js}

@@ -568,7 +568,8 @@ export {
   settleInPlacePrewalk,
   runFabricHandoffAtBoundary,
   formatSkillsForPrompt,
+  parseSkillBlock,
   expandSkillDirMarkersInSkillBlock,
   expandSkillDirMarkersForRead
 };
-//# sourceMappingURL=chunk-Z3AEX7SQ.js.map
+//# sourceMappingURL=chunk-GRA2PF4H.js.map

package/dist/core/kernel-skills.d.ts

@@ -0,0 +1,10 @@
+import type { Skill } from "@earendil-works/pi-coding-agent";
+import type { FabricKernel } from "../runtime/kernel.js";
+export declare class KernelSkills {
+    private readonly cache;
+    private declaration;
+    select(skills: readonly Skill[], kernel: FabricKernel): Skill[];
+    private compatible;
+    filterInvocation(text: string, kernel: FabricKernel): string;
+}
+//# sourceMappingURL=kernel-skills.d.ts.map

package/dist/core/kernel-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-skills.d.ts","sourceRoot":"","sources":["../../src/core/kernel-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6D;IAEnF,OAAO,CAAC,WAAW;IA0BnB,MAAM,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE;IAI/D,OAAO,CAAC,UAAU;IAKlB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;CAK7D"}

package/dist/core/skill-prompt.d.ts

@@ -1,3 +1,3 @@
 import type { Skill } from "@earendil-works/pi-coding-agent";
-export declare const restoreSkillsForFullCodePrompt: (systemPrompt: string, skills: readonly Skill[]) => string;
+export declare const restoreSkillsForFullCodePrompt: (systemPrompt: string, skills: readonly Skill[], fullCodeMode?: boolean) => string;
 //# sourceMappingURL=skill-prompt.d.ts.map

package/dist/core/skill-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../src/core/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAW7D,eAAO,MAAM,8BAA8B,GACzC,cAAc,MAAM,EACpB,QAAQ,SAAS,KAAK,EAAE,KACvB,MAiBF,CAAC"}
+{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../src/core/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAW7D,eAAO,MAAM,8BAA8B,GACzC,cAAc,MAAM,EACpB,QAAQ,SAAS,KAAK,EAAE,EACxB,sBAAmB,KAClB,MAkBF,CAAC"}

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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,eAAO,MAAM,6BAA6B,GAAI,cAAc,OAAO,EAAE,SAAQ,YAA2B,EAAE,gBAAe,SAAS,GAAG,OAAiB,KAAG,MAY5I,CAAC;AAEd,eAAO,MAAM,8BAA8B,GAAI,cAAc,OAAO,EAAE,SAAQ,YAA2B,EAAE,gBAAe,SAAS,GAAG,OAAiB,KAAG,MAOiL,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"}
+{"version":3,"file":"system-guidance.d.ts","sourceRoot":"","sources":["../../src/core/system-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,eAAO,MAAM,6BAA6B,GAAI,cAAc,OAAO,EAAE,SAAQ,YAA2B,EAAE,gBAAe,SAAS,GAAG,OAAiB,KAAG,MAa5I,CAAC;AAEd,eAAO,MAAM,8BAA8B,GAAI,cAAc,OAAO,EAAE,SAAQ,YAA2B,EAAE,gBAAe,SAAS,GAAG,OAAiB,KAAG,MAOiL,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/fabric-runtime-state.js

@@ -21,7 +21,7 @@ import {
   claimFabricHandoff,
   expandSkillDirMarkersForRead,
   runFabricHandoffAtBoundary
-} from "./chunks/chunk-Z3AEX7SQ.js";
+} from "./chunks/chunk-GRA2PF4H.js";
 import {
   ApprovalController,
   FABRIC_COMPONENT_PROVIDER_NAMES,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,iCAAiC,CAAC;AA4JzC,wBAA8B,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkvBtE;AAED,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,iCAAiC,CAAC;AA6JzC,wBAA8B,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqvBtE;AAED,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   FabricState
-} from "./chunks/chunk-PPIWZJ4M.js";
+} from "./chunks/chunk-7RPCSGQM.js";
 import {
   arcItemStyled,
   captureFabricAgentPreviews,
@@ -57,10 +57,11 @@ import {
   filterPrewalkContinuationMessages,
   formatSkillsForPrompt,
   hasPrewalkArmedPrompt,
+  parseSkillBlock,
   prewalkArmedPrompt,
   settleInPlacePrewalk,
   withTrajectoryRearmDirective
-} from "./chunks/chunk-Z3AEX7SQ.js";
+} from "./chunks/chunk-GRA2PF4H.js";
 import {
   ApprovalController,
   CapturedToolCatalog,
@@ -1967,6 +1968,7 @@ import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:f
 import * as path4 from "node:path";
 var fabricExecutionKernelGuidance = (fullCodeMode, kernel = "typescript", pythonRuntime = "monty") => [
   kernel === "python" ? `Configured fabric_exec kernel: Python (${pythonRuntime === "monty" ? "Monty sandboxed subset" : "CPython"}). Write Python only in \`code\`: top-level await/return, dicts, True/False/None, and asyncio.gather. There is no per-call language switch.` : "Configured fabric_exec kernel: TypeScript. Write TypeScript only in `code`; top-level await and return are supported.",
+  "The configured kernel is exclusive for Fabric orchestration, including when skills or earlier messages show another language. Do not invoke another interpreter through shell tools or native subprocesses merely to run Fabric orchestration in a different language. Project builds, tests, and explicitly requested interpreter work remain legitimate shell commands.",
   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
   // use; this line rides the turn-stable kernel guidance so provider prefix
@@ -2037,23 +2039,66 @@ var SKILL_SECTION_HEADING = "The following skills provide specialized instructio
 var PI_SKILL_LOAD_INSTRUCTION = "Use the read tool to load a skill's file when the task matches its description.";
 var FABRIC_SKILL_LOAD_INSTRUCTION = "Use `pi.read` inside `fabric_exec` to load a skill's file when the task matches its description.";
 var CWD_MARKER = "\nCurrent working directory:";
-var restoreSkillsForFullCodePrompt = (systemPrompt, skills) => {
+var restoreSkillsForFullCodePrompt = (systemPrompt, skills, fullCodeMode = true) => {
   const section = formatSkillsForPrompt([...skills]).replace(
     PI_SKILL_LOAD_INSTRUCTION,
-    FABRIC_SKILL_LOAD_INSTRUCTION
+    fullCodeMode ? FABRIC_SKILL_LOAD_INSTRUCTION : PI_SKILL_LOAD_INSTRUCTION
   );
-  if (!section) return systemPrompt;
-  if (systemPrompt.includes(SKILL_SECTION_HEADING)) {
-    return systemPrompt.replace(
-      PI_SKILL_LOAD_INSTRUCTION,
-      FABRIC_SKILL_LOAD_INSTRUCTION
-    );
+  const start = systemPrompt.indexOf(SKILL_SECTION_HEADING);
+  const end = start < 0 ? -1 : systemPrompt.indexOf("</available_skills>", start);
+  if (start >= 0 && end >= 0) {
+    return systemPrompt.slice(0, start) + section.trimStart() + systemPrompt.slice(end + "</available_skills>".length);
   }
+  if (!section) return systemPrompt;
   const cwdIndex = systemPrompt.lastIndexOf(CWD_MARKER);
   if (cwdIndex < 0) return `${systemPrompt}${section}`;
   return `${systemPrompt.slice(0, cwdIndex)}${section}${systemPrompt.slice(cwdIndex)}`;
 };
 
+// src/core/kernel-skills.ts
+import { readFileSync as readFileSync3, statSync } from "node:fs";
+import { parse } from "yaml";
+var KernelSkills = class {
+  cache = /* @__PURE__ */ new Map();
+  declaration(filePath) {
+    try {
+      const stat = statSync(filePath);
+      const stamp = `${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
+      const cached = this.cache.get(filePath);
+      if (cached?.stamp === stamp) return cached.kernel;
+      const text = readFileSync3(filePath, "utf8");
+      const frontmatter = /^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text)?.[1];
+      let kernel = "shared";
+      if (frontmatter) {
+        try {
+          const value = parse(frontmatter)?.metadata?.["fabric-kernel"];
+          kernel = value === void 0 ? "shared" : value === "typescript" || value === "python" ? value : "invalid";
+        } catch {
+          kernel = "invalid";
+        }
+      }
+      this.cache.set(filePath, { stamp, kernel });
+      return kernel;
+    } catch {
+      return this.cache.get(filePath)?.kernel ?? "shared";
+    }
+  }
+  select(skills, kernel) {
+    return skills.filter((skill) => this.compatible(skill.filePath, kernel));
+  }
+  compatible(filePath, kernel) {
+    const declared = this.declaration(filePath);
+    return declared === "shared" || declared === kernel;
+  }
+  filterInvocation(text, kernel) {
+    const block = parseSkillBlock(text);
+    if (!block || this.compatible(block.location, kernel)) return text;
+    return `Skill ${block.name} is unavailable for the configured ${kernel} kernel. Do not execute its instructions or switch interpreters to run it. Use a compatible skill or the current kernel's host APIs.${block.userMessage ? `
+
+${block.userMessage}` : ""}`;
+  }
+};
+
 // src/core/proxy-contract.ts
 var PROXY_CONTRACT_CUSTOM_TYPE = "pi-fabric-proxy";
 var FABRIC_EXEC_TOOL = "fabric_exec";
@@ -3510,7 +3555,7 @@ var classifyToolResult = (input) => {
 };
 
 // src/host-compatibility.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4, realpathSync as realpathSync2 } from "node:fs";
 import path6 from "node:path";
 var MINIMUM_PI_HOST_VERSION = "0.80.6";
 var PI_HOST_PACKAGE_NAMES = /* @__PURE__ */ new Set([
@@ -3550,7 +3595,7 @@ var detectPiHostVersion = (cliPath = process.argv[1]) => {
     const manifestPath = path6.join(directory, "package.json");
     if (existsSync3(manifestPath)) {
       try {
-        const manifest = JSON.parse(readFileSync3(manifestPath, "utf8"));
+        const manifest = JSON.parse(readFileSync4(manifestPath, "utf8"));
         if (typeof manifest.name === "string" && PI_HOST_PACKAGE_NAMES.has(manifest.name) && typeof manifest.version === "string") {
           return manifest.version;
         }
@@ -4796,6 +4841,7 @@ async function piFabric(pi) {
       );
     }
   );
+  const kernelSkills = new KernelSkills();
   pi.on("resources_discover", async () => {
     if (existsSync4(FABRIC_SKILLS_DIR)) return { skillPaths: [FABRIC_SKILLS_DIR] };
     return {};
@@ -5176,11 +5222,13 @@ async function piFabric(pi) {
       event.messages,
       (continuationId) => state.initialized && state.prewalk.acceptContinuation(sessionId, continuationId)
     );
+    const kernel = (state.bootstrapped ? state.config : DEFAULT_FABRIC_CONFIG).executor.kernel;
+    const filterSkill = (text) => pi.getActiveTools().includes("fabric_exec") ? kernelSkills.filterInvocation(text, kernel) : text;
     let changed = continuation.changed;
     const messages = continuation.messages.map((message) => {
       if (message.role !== "user") return message;
       if (typeof message.content === "string") {
-        const content2 = expandSkillDirMarkersInSkillBlock(message.content);
+        const content2 = expandSkillDirMarkersInSkillBlock(filterSkill(message.content));
         if (content2 === message.content) return message;
         changed = true;
         return { ...message, content: content2 };
@@ -5188,7 +5236,7 @@ async function piFabric(pi) {
       let messageChanged = false;
       const content = message.content.map((part) => {
         if (part.type !== "text") return part;
-        const text = expandSkillDirMarkersInSkillBlock(part.text);
+        const text = expandSkillDirMarkersInSkillBlock(filterSkill(part.text));
         if (text === part.text) return part;
         changed = true;
         messageChanged = true;
@@ -5204,9 +5252,9 @@ async function piFabric(pi) {
     const schemaMode = config.schema.mode;
     const effectiveFullCodeMode = fullCodeMode || schemaMode === "enforce";
     if (!pi.getActiveTools().includes("fabric_exec")) return;
-    const skills = event.systemPromptOptions.skills ?? [];
+    const skills = kernelSkills.select(event.systemPromptOptions.skills ?? [], config.executor.kernel);
     const captureSnapshot = state.bootstrapped ? capturePolicy() : void 0;
-    const systemPrompt = effectiveFullCodeMode ? restoreSkillsForFullCodePrompt(event.systemPrompt, skills) : event.systemPrompt;
+    const systemPrompt = restoreSkillsForFullCodePrompt(event.systemPrompt, skills, effectiveFullCodeMode);
     const skillReferenceGuidance = effectiveFullCodeMode ? buildSkillReferenceGuidance(event.prompt, skills) : void 0;
     const currentModel = context.model ? `${context.model.provider}/${context.model.id}` : void 0;
     const resolvedGuidance = resolveFabricModelGuidance(state.modelGuidance(), {