pi-fabric 0.110.2 → 0.111.0

package/README.md

@@ -90,6 +90,8 @@ Requires Node.js 24+ and Pi 1.0.0+. Monty's optional native package installs on
 pi install npm:pi-fabric
 ```
 
+Fabric bundles the [Coral Bricks provider](docs/configuration.md#bundled-coral-bricks-provider): run `/login coralbricks` to use `coralbricks/*` models, or opt out with a package filter. Fabric's maintainers work at Coral Bricks.
+
 <details>
 <summary>Other install methods</summary>
 
@@ -156,7 +158,7 @@ See the [interface & commands reference](docs/interface.md) for every view, keyb
 
 ## Reference
 
-- [Configuration](docs/configuration.md): `fabric.json`, code modes, tool capture, approvals, and budgets.
+- [Configuration](docs/configuration.md): `fabric.json`, code modes, tool capture, approvals, budgets, and [third-party model providers](docs/configuration.md#third-party-model-providers).
 - [Execution kernels](docs/kernels.md): exclusive TypeScript/Python selection, Monty sandboxing, CPython escape hatch, agent inheritance, and examples.
 - [Native codemode APIs](docs/codemode-parity.md): additive native tool aliases or opt-in Pi-compatible scripts, collision-safe Fabric discovery, native models/images, branch-local state, and sPTC.
 - [Prompt cache](docs/prompt-cache.md): honest cache observations and optional, time-bounded native warming leases.

package/THIRD_PARTY_NOTICES.md

@@ -8,6 +8,13 @@ Haydn Paterson, licensed under MIT. This private artifact is not loaded by the
 Pi extension, which continues to use Pi's host-provided TypeBox. The complete
 license is distributed at [docs/licenses/typebox-mit.txt](docs/licenses/typebox-mit.txt).
 
+## pi-coralbricks-provider
+
+The package bundles [`pi-coralbricks-provider`](https://github.com/monotykamary/pi-coralbricks-provider)
+unmodified under `node_modules/pi-coralbricks-provider`, at the exact version
+pinned in `package.json`. It is licensed under MIT, and its complete license is
+distributed beside it at `node_modules/pi-coralbricks-provider/LICENSE`.
+
 ## Bend 2.0.36
 
 The generated policy kernel includes Bend's emitted JavaScript trampoline and

package/dist/agents/provider-bridge.d.ts

@@ -0,0 +1,80 @@
+import type { Provider } from "@earendil-works/pi-ai";
+import type { ExtensionAPI, ProviderConfig } from "@earendil-works/pi-coding-agent";
+/**
+ * The `provider/id` key a Pi child launched with `extensions: false` must
+ * resolve. The worker sets it only when it also loads this bridge with `-e`.
+ */
+export declare const PROVIDER_BRIDGE_MODEL_ENV = "PI_FABRIC_EXTENSION_MODEL";
+export interface ExtensionProviderRegistrations {
+    configs: Array<{
+        name: string;
+        config: ProviderConfig;
+        extensionPath: string;
+    }>;
+    natives: Array<{
+        provider: Provider;
+        extensionPath: string;
+    }>;
+}
+export interface ResolveExtensionProvidersOptions {
+    model: string;
+    cwd: string;
+    agentDir: string;
+    /** Extension entry files never probed (Fabric's own entries by default). */
+    exclude?: readonly string[];
+}
+type PiSdk = typeof import("@earendil-works/pi-coding-agent");
+/** Split a canonical `provider/id` key at its first slash. */
+export declare function parseModelKey(key: string): {
+    provider: string;
+    id: string;
+} | undefined;
+/**
+ * Probe extensions whose own path names the provider first (the usual
+ * `pi-<provider>-provider` package), so the common case runs one registration
+ * function instead of every installed extension.
+ */
+export declare function orderProviderCandidates(paths: readonly string[], provider: string): {
+    named: string[];
+    rest: string[];
+};
+/**
+ * Fabric's own manifest entries: they never register chat providers. Entries
+ * of bundled Pi packages (pi-coralbricks-provider) are not Fabric's own: they
+ * stay probe candidates, so the bundled provider resolves without loading
+ * Fabric's main extension.
+ */
+export declare function fabricExtensionEntries(moduleUrl?: string): string[];
+/**
+ * Find the extension registrations that make `model` resolvable in a child
+ * without its other extensions. Returns `undefined` when Pi already knows the
+ * model (built in, models.json, or a cached catalog), so those children keep
+ * their exact extension-free behaviour. Throws an actionable error when no
+ * installed extension registers the provider.
+ */
+export declare function resolveExtensionProviders(options: ResolveExtensionProvidersOptions, sdk?: PiSdk): Promise<ExtensionProviderRegistrations | undefined>;
+/**
+ * The SDK entry of the bundled Pi CLI running this process, if it is one. The
+ * published `pi` bin is `dist/bundle/cli.js`; its `dist/bundle/index.js` SDK
+ * entry is built from the same chunks the CLI has already evaluated.
+ */
+export declare function hostBundleSdkEntry(cliPath?: string | undefined): string | undefined;
+/**
+ * The host's own SDK. Pi imports this bridge natively (it is ESM JavaScript),
+ * so jiti's virtual modules do not apply, and a bare package import from here
+ * evaluates the separate unbundled SDK: about 1,800 more modules in the
+ * bundled CLI. Besides the startup cost, that CLI enables Node's compile cache,
+ * which serializes every one of those modules on exit; with a cold cache that
+ * held a Windows child past the worker's exit grace after it had settled.
+ * The bundle's SDK entry shares the CLI's already loaded chunks instead.
+ */
+export declare function loadHostSdk(cliPath?: string | undefined): Promise<PiSdk>;
+/**
+ * Loaded with `-e` into Pi children launched with `extensions: false`. It
+ * registers only the requested model's provider, as its extension registered
+ * it, so credentials still resolve in the child through auth.json, the
+ * environment, or the credential store. Nothing else from that extension loads.
+ */
+export default function fabricProviderBridge(pi: ExtensionAPI): Promise<void>;
+export {};
+//# sourceMappingURL=provider-bridge.d.ts.map

package/dist/agents/provider-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/provider-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,iCAAiC,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,KAAK,KAAK,GAAG,cAAc,iCAAiC,CAAC,CAAC;AAE9D,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKvF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CASrC;AAcD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,SAAkB,GAAG,MAAM,EAAE,CAgB5E;AA0CD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,EACzC,GAAG,CAAC,EAAE,KAAK,GACV,OAAO,CAAC,8BAA8B,GAAG,SAAS,CAAC,CA4CrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAM,GAAG,SAA2B,GAAG,MAAM,GAAG,SAAS,CAiBpG;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,MAAM,GAAG,SAA2B,GAAG,OAAO,CAAC,KAAK,CAAC,CAU/F;AAED;;;;;GAKG;AACH,wBAA8B,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF"}

package/dist/agents/provider-bridge.js

@@ -0,0 +1,143 @@
+// src/agents/provider-bridge.ts
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+var PROVIDER_BRIDGE_MODEL_ENV = "PI_FABRIC_EXTENSION_MODEL";
+function parseModelKey(key) {
+  const value = key.trim();
+  const slash = value.indexOf("/");
+  if (slash <= 0 || slash === value.length - 1) return void 0;
+  return { provider: value.slice(0, slash), id: value.slice(slash + 1) };
+}
+function orderProviderCandidates(paths, provider) {
+  const needle = provider.toLowerCase();
+  const named = [];
+  const rest = [];
+  for (const candidate of paths) {
+    const tail = candidate.split(/[\\/]+/).filter(Boolean).slice(-3);
+    (tail.some((segment) => segment.toLowerCase().includes(needle)) ? named : rest).push(candidate);
+  }
+  return { named, rest };
+}
+var realPath = (file) => {
+  try {
+    return fs.realpathSync(file);
+  } catch {
+    return path.resolve(file);
+  }
+};
+var isBundledPackageEntry = (entry) => entry.replace(/\\/g, "/").replace(/^(?:\.\/)+/, "").startsWith("node_modules/");
+function fabricExtensionEntries(moduleUrl = import.meta.url) {
+  const root = path.resolve(path.dirname(fileURLToPath(moduleUrl)), "..", "..");
+  try {
+    const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+    if (manifest.name !== "pi-fabric") return [];
+    const entries = [manifest.main, ...Array.isArray(manifest.pi?.extensions) ? manifest.pi.extensions : []];
+    return entries.filter((entry) => typeof entry === "string" && !isBundledPackageEntry(entry)).map((entry) => path.resolve(root, entry));
+  } catch {
+    return [];
+  }
+}
+var emptyRegistrations = () => ({ configs: [], natives: [] });
+async function loadProviderRegistrations(sdk, paths, provider, options, failures) {
+  if (paths.length === 0) return emptyRegistrations();
+  const loader = new sdk.DefaultResourceLoader({
+    cwd: options.cwd,
+    agentDir: options.agentDir,
+    settingsManager: options.settingsManager,
+    noExtensions: true,
+    additionalExtensionPaths: [...paths],
+    noSkills: true,
+    noPromptTemplates: true,
+    noThemes: true,
+    noContextFiles: true
+  });
+  await loader.reload();
+  const { runtime, errors } = loader.getExtensions();
+  failures.push(...errors.map((error) => error.path));
+  return {
+    configs: runtime.pendingProviderRegistrations.filter((registration) => registration.name === provider).map(({ name, config, extensionPath }) => ({ name, config, extensionPath })),
+    natives: runtime.pendingNativeProviderRegistrations.filter((registration) => registration.provider.id === provider).map(({ provider: registered, extensionPath }) => ({ provider: registered, extensionPath }))
+  };
+}
+async function resolveExtensionProviders(options, sdk) {
+  const key = parseModelKey(options.model);
+  if (!key) return void 0;
+  const pi = sdk ?? await import("@earendil-works/pi-coding-agent");
+  const models = await pi.ModelRuntime.create({
+    authPath: path.join(options.agentDir, "auth.json"),
+    modelsPath: path.join(options.agentDir, "models.json"),
+    refreshOnCreate: false
+  });
+  if (models.getModel(key.provider, key.id)) return void 0;
+  await models.refresh({ allowNetwork: false, signal: AbortSignal.timeout(15e3) });
+  if (models.getModel(key.provider, key.id)) return void 0;
+  const untrusted = pi.SettingsManager.create(options.cwd, options.agentDir, { projectTrusted: false });
+  const trusted = !pi.hasTrustRequiringProjectResources(options.cwd) || (new pi.ProjectTrustStore(options.agentDir).get(options.cwd) ?? untrusted.getDefaultProjectTrust() === "always");
+  const settingsManager = trusted ? pi.SettingsManager.create(options.cwd, options.agentDir, { projectTrusted: true }) : untrusted;
+  const resolved = await new pi.DefaultPackageManager({
+    cwd: options.cwd,
+    agentDir: options.agentDir,
+    settingsManager
+  }).resolve();
+  const excluded = new Set((options.exclude ?? fabricExtensionEntries()).map(realPath));
+  const candidates = resolved.extensions.filter((resource) => resource.enabled && !resource.path.startsWith("builtin:")).map((resource) => resource.path).filter((candidate) => !excluded.has(realPath(candidate)));
+  const { named, rest } = orderProviderCandidates(candidates, key.provider);
+  const context = { cwd: options.cwd, agentDir: options.agentDir, settingsManager };
+  const failures = [];
+  for (const group of [named, rest]) {
+    const found = await loadProviderRegistrations(pi, group, key.provider, context, failures);
+    if (found.configs.length > 0 || found.natives.length > 0) return found;
+  }
+  throw new Error(
+    `Model "${options.model}" needs provider "${key.provider}", which is not built into Pi or defined in models.json, and no installed Pi extension registers it for this extensions: false child. Install the extension that provides it, or run the child with extensions: true.` + (failures.length > 0 ? ` Extensions that failed to load while searching: ${[...new Set(failures)].join(", ")}.` : "")
+  );
+}
+function hostBundleSdkEntry(cliPath = process.argv[1]) {
+  if (!cliPath) return void 0;
+  let cli;
+  try {
+    cli = fs.realpathSync(cliPath);
+  } catch {
+    return void 0;
+  }
+  const bundle = path.dirname(cli);
+  if (path.basename(cli) !== "cli.js" || path.basename(bundle) !== "bundle") return void 0;
+  const entry = path.join(bundle, "index.js");
+  try {
+    const manifest = JSON.parse(fs.readFileSync(path.join(bundle, "..", "..", "package.json"), "utf8"));
+    return manifest.name === "@earendil-works/pi-coding-agent" && fs.existsSync(entry) ? entry : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function loadHostSdk(cliPath = process.argv[1]) {
+  const entry = hostBundleSdkEntry(cliPath);
+  if (entry) {
+    try {
+      return await import(pathToFileURL(entry).href);
+    } catch {
+    }
+  }
+  return import("@earendil-works/pi-coding-agent");
+}
+async function fabricProviderBridge(pi) {
+  const model = process.env[PROVIDER_BRIDGE_MODEL_ENV]?.trim();
+  if (!model) return;
+  const sdk = await loadHostSdk();
+  const found = await resolveExtensionProviders({ model, cwd: process.cwd(), agentDir: sdk.getAgentDir() }, sdk);
+  if (!found) return;
+  for (const { name, config } of found.configs) pi.registerProvider(name, config);
+  for (const { provider } of found.natives) pi.registerProvider(provider);
+}
+export {
+  PROVIDER_BRIDGE_MODEL_ENV,
+  fabricProviderBridge as default,
+  fabricExtensionEntries,
+  hostBundleSdkEntry,
+  loadHostSdk,
+  orderProviderCandidates,
+  parseModelKey,
+  resolveExtensionProviders
+};
+//# sourceMappingURL=provider-bridge.js.map

package/dist/agents/provider-bridge.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/agents/provider-bridge.ts"],
+  "sourcesContent": ["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { Provider } from \"@earendil-works/pi-ai\";\nimport type { ExtensionAPI, ProviderConfig, SettingsManager } from \"@earendil-works/pi-coding-agent\";\n\n/**\n * The `provider/id` key a Pi child launched with `extensions: false` must\n * resolve. The worker sets it only when it also loads this bridge with `-e`.\n */\nexport const PROVIDER_BRIDGE_MODEL_ENV = \"PI_FABRIC_EXTENSION_MODEL\";\n\nexport interface ExtensionProviderRegistrations {\n  configs: Array<{ name: string; config: ProviderConfig; extensionPath: string }>;\n  natives: Array<{ provider: Provider; extensionPath: string }>;\n}\n\nexport interface ResolveExtensionProvidersOptions {\n  model: string;\n  cwd: string;\n  agentDir: string;\n  /** Extension entry files never probed (Fabric's own entries by default). */\n  exclude?: readonly string[];\n}\n\ntype PiSdk = typeof import(\"@earendil-works/pi-coding-agent\");\n\n/** Split a canonical `provider/id` key at its first slash. */\nexport function parseModelKey(key: string): { provider: string; id: string } | undefined {\n  const value = key.trim();\n  const slash = value.indexOf(\"/\");\n  if (slash <= 0 || slash === value.length - 1) return undefined;\n  return { provider: value.slice(0, slash), id: value.slice(slash + 1) };\n}\n\n/**\n * Probe extensions whose own path names the provider first (the usual\n * `pi-<provider>-provider` package), so the common case runs one registration\n * function instead of every installed extension.\n */\nexport function orderProviderCandidates(\n  paths: readonly string[],\n  provider: string,\n): { named: string[]; rest: string[] } {\n  const needle = provider.toLowerCase();\n  const named: string[] = [];\n  const rest: string[] = [];\n  for (const candidate of paths) {\n    const tail = candidate.split(/[\\\\/]+/).filter(Boolean).slice(-3);\n    (tail.some((segment) => segment.toLowerCase().includes(needle)) ? named : rest).push(candidate);\n  }\n  return { named, rest };\n}\n\nconst realPath = (file: string): string => {\n  try {\n    return fs.realpathSync(file);\n  } catch {\n    return path.resolve(file);\n  }\n};\n\n/** A manifest entry that loads a Pi package Fabric bundles (`node_modules/<package>/...`). */\nconst isBundledPackageEntry = (entry: string): boolean =>\n  entry.replace(/\\\\/g, \"/\").replace(/^(?:\\.\\/)+/, \"\").startsWith(\"node_modules/\");\n\n/**\n * Fabric's own manifest entries: they never register chat providers. Entries\n * of bundled Pi packages (pi-coralbricks-provider) are not Fabric's own: they\n * stay probe candidates, so the bundled provider resolves without loading\n * Fabric's main extension.\n */\nexport function fabricExtensionEntries(moduleUrl = import.meta.url): string[] {\n  const root = path.resolve(path.dirname(fileURLToPath(moduleUrl)), \"..\", \"..\");\n  try {\n    const manifest = JSON.parse(fs.readFileSync(path.join(root, \"package.json\"), \"utf8\")) as {\n      name?: unknown;\n      main?: unknown;\n      pi?: { extensions?: unknown };\n    };\n    if (manifest.name !== \"pi-fabric\") return [];\n    const entries = [manifest.main, ...(Array.isArray(manifest.pi?.extensions) ? manifest.pi.extensions : [])];\n    return entries\n      .filter((entry): entry is string => typeof entry === \"string\" && !isBundledPackageEntry(entry))\n      .map((entry) => path.resolve(root, entry));\n  } catch {\n    return [];\n  }\n}\n\nconst emptyRegistrations = (): ExtensionProviderRegistrations => ({ configs: [], natives: [] });\n\n/**\n * Load extension paths with Pi's own loader into an isolated runtime and keep\n * only the requested provider's registrations. The loaded extensions are\n * discarded: their tools, commands, flags, shortcuts, renderers, and event\n * handlers never bind to the child session, and their event bus is private.\n */\nasync function loadProviderRegistrations(\n  sdk: PiSdk,\n  paths: readonly string[],\n  provider: string,\n  options: { cwd: string; agentDir: string; settingsManager: SettingsManager },\n  failures: string[],\n): Promise<ExtensionProviderRegistrations> {\n  if (paths.length === 0) return emptyRegistrations();\n  const loader = new sdk.DefaultResourceLoader({\n    cwd: options.cwd,\n    agentDir: options.agentDir,\n    settingsManager: options.settingsManager,\n    noExtensions: true,\n    additionalExtensionPaths: [...paths],\n    noSkills: true,\n    noPromptTemplates: true,\n    noThemes: true,\n    noContextFiles: true,\n  });\n  await loader.reload();\n  const { runtime, errors } = loader.getExtensions();\n  failures.push(...errors.map((error) => error.path));\n  return {\n    configs: runtime.pendingProviderRegistrations\n      .filter((registration) => registration.name === provider)\n      .map(({ name, config, extensionPath }) => ({ name, config, extensionPath })),\n    natives: runtime.pendingNativeProviderRegistrations\n      .filter((registration) => registration.provider.id === provider)\n      .map(({ provider: registered, extensionPath }) => ({ provider: registered, extensionPath })),\n  };\n}\n\n/**\n * Find the extension registrations that make `model` resolvable in a child\n * without its other extensions. Returns `undefined` when Pi already knows the\n * model (built in, models.json, or a cached catalog), so those children keep\n * their exact extension-free behaviour. Throws an actionable error when no\n * installed extension registers the provider.\n */\nexport async function resolveExtensionProviders(\n  options: ResolveExtensionProvidersOptions,\n  sdk?: PiSdk,\n): Promise<ExtensionProviderRegistrations | undefined> {\n  const key = parseModelKey(options.model);\n  if (!key) return undefined;\n  const pi = sdk ?? await import(\"@earendil-works/pi-coding-agent\");\n  const models = await pi.ModelRuntime.create({\n    authPath: path.join(options.agentDir, \"auth.json\"),\n    modelsPath: path.join(options.agentDir, \"models.json\"),\n    refreshOnCreate: false,\n  });\n  if (models.getModel(key.provider, key.id)) return undefined;\n  await models.refresh({ allowNetwork: false, signal: AbortSignal.timeout(15_000) });\n  if (models.getModel(key.provider, key.id)) return undefined;\n\n  // Same trust a headless child applies without consulting extension\n  // project_trust handlers: those belong to the extensions left out here.\n  const untrusted = pi.SettingsManager.create(options.cwd, options.agentDir, { projectTrusted: false });\n  const trusted = !pi.hasTrustRequiringProjectResources(options.cwd) ||\n    (new pi.ProjectTrustStore(options.agentDir).get(options.cwd) ?? untrusted.getDefaultProjectTrust() === \"always\");\n  const settingsManager = trusted\n    ? pi.SettingsManager.create(options.cwd, options.agentDir, { projectTrusted: true })\n    : untrusted;\n  const resolved = await new pi.DefaultPackageManager({\n    cwd: options.cwd,\n    agentDir: options.agentDir,\n    settingsManager,\n  }).resolve();\n  const excluded = new Set((options.exclude ?? fabricExtensionEntries()).map(realPath));\n  const candidates = resolved.extensions\n    .filter((resource) => resource.enabled && !resource.path.startsWith(\"builtin:\"))\n    .map((resource) => resource.path)\n    .filter((candidate) => !excluded.has(realPath(candidate)));\n  const { named, rest } = orderProviderCandidates(candidates, key.provider);\n  const context = { cwd: options.cwd, agentDir: options.agentDir, settingsManager };\n  const failures: string[] = [];\n  for (const group of [named, rest]) {\n    const found = await loadProviderRegistrations(pi, group, key.provider, context, failures);\n    if (found.configs.length > 0 || found.natives.length > 0) return found;\n  }\n  throw new Error(\n    `Model \"${options.model}\" needs provider \"${key.provider}\", which is not built into Pi or defined in models.json, ` +\n      \"and no installed Pi extension registers it for this extensions: false child. \" +\n      \"Install the extension that provides it, or run the child with extensions: true.\" +\n      (failures.length > 0 ? ` Extensions that failed to load while searching: ${[...new Set(failures)].join(\", \")}.` : \"\"),\n  );\n}\n\n/**\n * The SDK entry of the bundled Pi CLI running this process, if it is one. The\n * published `pi` bin is `dist/bundle/cli.js`; its `dist/bundle/index.js` SDK\n * entry is built from the same chunks the CLI has already evaluated.\n */\nexport function hostBundleSdkEntry(cliPath: string | undefined = process.argv[1]): string | undefined {\n  if (!cliPath) return undefined;\n  let cli: string;\n  try {\n    cli = fs.realpathSync(cliPath);\n  } catch {\n    return undefined;\n  }\n  const bundle = path.dirname(cli);\n  if (path.basename(cli) !== \"cli.js\" || path.basename(bundle) !== \"bundle\") return undefined;\n  const entry = path.join(bundle, \"index.js\");\n  try {\n    const manifest = JSON.parse(fs.readFileSync(path.join(bundle, \"..\", \"..\", \"package.json\"), \"utf8\")) as { name?: unknown };\n    return manifest.name === \"@earendil-works/pi-coding-agent\" && fs.existsSync(entry) ? entry : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The host's own SDK. Pi imports this bridge natively (it is ESM JavaScript),\n * so jiti's virtual modules do not apply, and a bare package import from here\n * evaluates the separate unbundled SDK: about 1,800 more modules in the\n * bundled CLI. Besides the startup cost, that CLI enables Node's compile cache,\n * which serializes every one of those modules on exit; with a cold cache that\n * held a Windows child past the worker's exit grace after it had settled.\n * The bundle's SDK entry shares the CLI's already loaded chunks instead.\n */\nexport async function loadHostSdk(cliPath: string | undefined = process.argv[1]): Promise<PiSdk> {\n  const entry = hostBundleSdkEntry(cliPath);\n  if (entry) {\n    try {\n      return await import(pathToFileURL(entry).href) as PiSdk;\n    } catch {\n      // Unexpected bundle layout: fall back to the package entry.\n    }\n  }\n  return import(\"@earendil-works/pi-coding-agent\");\n}\n\n/**\n * Loaded with `-e` into Pi children launched with `extensions: false`. It\n * registers only the requested model's provider, as its extension registered\n * it, so credentials still resolve in the child through auth.json, the\n * environment, or the credential store. Nothing else from that extension loads.\n */\nexport default async function fabricProviderBridge(pi: ExtensionAPI): Promise<void> {\n  const model = process.env[PROVIDER_BRIDGE_MODEL_ENV]?.trim();\n  if (!model) return;\n  const sdk = await loadHostSdk();\n  const found = await resolveExtensionProviders({ model, cwd: process.cwd(), agentDir: sdk.getAgentDir() }, sdk);\n  if (!found) return;\n  for (const { name, config } of found.configs) pi.registerProvider(name, config);\n  for (const { provider } of found.natives) pi.registerProvider(provider);\n}\n"],
+  "mappings": ";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,eAAe,qBAAqB;AAQtC,IAAM,4BAA4B;AAkBlC,SAAS,cAAc,KAA2D;AACvF,QAAM,QAAQ,IAAI,KAAK;AACvB,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,MAAI,SAAS,KAAK,UAAU,MAAM,SAAS,EAAG,QAAO;AACrD,SAAO,EAAE,UAAU,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,MAAM,MAAM,QAAQ,CAAC,EAAE;AACvE;AAOO,SAAS,wBACd,OACA,UACqC;AACrC,QAAM,SAAS,SAAS,YAAY;AACpC,QAAM,QAAkB,CAAC;AACzB,QAAM,OAAiB,CAAC;AACxB,aAAW,aAAa,OAAO;AAC7B,UAAM,OAAO,UAAU,MAAM,QAAQ,EAAE,OAAO,OAAO,EAAE,MAAM,EAAE;AAC/D,KAAC,KAAK,KAAK,CAAC,YAAY,QAAQ,YAAY,EAAE,SAAS,MAAM,CAAC,IAAI,QAAQ,MAAM,KAAK,SAAS;AAAA,EAChG;AACA,SAAO,EAAE,OAAO,KAAK;AACvB;AAEA,IAAM,WAAW,CAAC,SAAyB;AACzC,MAAI;AACF,WAAO,GAAG,aAAa,IAAI;AAAA,EAC7B,QAAQ;AACN,WAAO,KAAK,QAAQ,IAAI;AAAA,EAC1B;AACF;AAGA,IAAM,wBAAwB,CAAC,UAC7B,MAAM,QAAQ,OAAO,GAAG,EAAE,QAAQ,cAAc,EAAE,EAAE,WAAW,eAAe;AAQzE,SAAS,uBAAuB,YAAY,YAAY,KAAe;AAC5E,QAAM,OAAO,KAAK,QAAQ,KAAK,QAAQ,cAAc,SAAS,CAAC,GAAG,MAAM,IAAI;AAC5E,MAAI;AACF,UAAM,WAAW,KAAK,MAAM,GAAG,aAAa,KAAK,KAAK,MAAM,cAAc,GAAG,MAAM,CAAC;AAKpF,QAAI,SAAS,SAAS,YAAa,QAAO,CAAC;AAC3C,UAAM,UAAU,CAAC,SAAS,MAAM,GAAI,MAAM,QAAQ,SAAS,IAAI,UAAU,IAAI,SAAS,GAAG,aAAa,CAAC,CAAE;AACzG,WAAO,QACJ,OAAO,CAAC,UAA2B,OAAO,UAAU,YAAY,CAAC,sBAAsB,KAAK,CAAC,EAC7F,IAAI,CAAC,UAAU,KAAK,QAAQ,MAAM,KAAK,CAAC;AAAA,EAC7C,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,IAAM,qBAAqB,OAAuC,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC,EAAE;AAQ7F,eAAe,0BACb,KACA,OACA,UACA,SACA,UACyC;AACzC,MAAI,MAAM,WAAW,EAAG,QAAO,mBAAmB;AAClD,QAAM,SAAS,IAAI,IAAI,sBAAsB;AAAA,IAC3C,KAAK,QAAQ;AAAA,IACb,UAAU,QAAQ;AAAA,IAClB,iBAAiB,QAAQ;AAAA,IACzB,cAAc;AAAA,IACd,0BAA0B,CAAC,GAAG,KAAK;AAAA,IACnC,UAAU;AAAA,IACV,mBAAmB;AAAA,IACnB,UAAU;AAAA,IACV,gBAAgB;AAAA,EAClB,CAAC;AACD,QAAM,OAAO,OAAO;AACpB,QAAM,EAAE,SAAS,OAAO,IAAI,OAAO,cAAc;AACjD,WAAS,KAAK,GAAG,OAAO,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC;AAClD,SAAO;AAAA,IACL,SAAS,QAAQ,6BACd,OAAO,CAAC,iBAAiB,aAAa,SAAS,QAAQ,EACvD,IAAI,CAAC,EAAE,MAAM,QAAQ,cAAc,OAAO,EAAE,MAAM,QAAQ,cAAc,EAAE;AAAA,IAC7E,SAAS,QAAQ,mCACd,OAAO,CAAC,iBAAiB,aAAa,SAAS,OAAO,QAAQ,EAC9D,IAAI,CAAC,EAAE,UAAU,YAAY,cAAc,OAAO,EAAE,UAAU,YAAY,cAAc,EAAE;AAAA,EAC/F;AACF;AASA,eAAsB,0BACpB,SACA,KACqD;AACrD,QAAM,MAAM,cAAc,QAAQ,KAAK;AACvC,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,KAAK,OAAO,MAAM,OAAO,iCAAiC;AAChE,QAAM,SAAS,MAAM,GAAG,aAAa,OAAO;AAAA,IAC1C,UAAU,KAAK,KAAK,QAAQ,UAAU,WAAW;AAAA,IACjD,YAAY,KAAK,KAAK,QAAQ,UAAU,aAAa;AAAA,IACrD,iBAAiB;AAAA,EACnB,CAAC;AACD,MAAI,OAAO,SAAS,IAAI,UAAU,IAAI,EAAE,EAAG,QAAO;AAClD,QAAM,OAAO,QAAQ,EAAE,cAAc,OAAO,QAAQ,YAAY,QAAQ,IAAM,EAAE,CAAC;AACjF,MAAI,OAAO,SAAS,IAAI,UAAU,IAAI,EAAE,EAAG,QAAO;AAIlD,QAAM,YAAY,GAAG,gBAAgB,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE,gBAAgB,MAAM,CAAC;AACpG,QAAM,UAAU,CAAC,GAAG,kCAAkC,QAAQ,GAAG,MAC9D,IAAI,GAAG,kBAAkB,QAAQ,QAAQ,EAAE,IAAI,QAAQ,GAAG,KAAK,UAAU,uBAAuB,MAAM;AACzG,QAAM,kBAAkB,UACpB,GAAG,gBAAgB,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE,gBAAgB,KAAK,CAAC,IACjF;AACJ,QAAM,WAAW,MAAM,IAAI,GAAG,sBAAsB;AAAA,IAClD,KAAK,QAAQ;AAAA,IACb,UAAU,QAAQ;AAAA,IAClB;AAAA,EACF,CAAC,EAAE,QAAQ;AACX,QAAM,WAAW,IAAI,KAAK,QAAQ,WAAW,uBAAuB,GAAG,IAAI,QAAQ,CAAC;AACpF,QAAM,aAAa,SAAS,WACzB,OAAO,CAAC,aAAa,SAAS,WAAW,CAAC,SAAS,KAAK,WAAW,UAAU,CAAC,EAC9E,IAAI,CAAC,aAAa,SAAS,IAAI,EAC/B,OAAO,CAAC,cAAc,CAAC,SAAS,IAAI,SAAS,SAAS,CAAC,CAAC;AAC3D,QAAM,EAAE,OAAO,KAAK,IAAI,wBAAwB,YAAY,IAAI,QAAQ;AACxE,QAAM,UAAU,EAAE,KAAK,QAAQ,KAAK,UAAU,QAAQ,UAAU,gBAAgB;AAChF,QAAM,WAAqB,CAAC;AAC5B,aAAW,SAAS,CAAC,OAAO,IAAI,GAAG;AACjC,UAAM,QAAQ,MAAM,0BAA0B,IAAI,OAAO,IAAI,UAAU,SAAS,QAAQ;AACxF,QAAI,MAAM,QAAQ,SAAS,KAAK,MAAM,QAAQ,SAAS,EAAG,QAAO;AAAA,EACnE;AACA,QAAM,IAAI;AAAA,IACR,UAAU,QAAQ,KAAK,qBAAqB,IAAI,QAAQ,2NAGrD,SAAS,SAAS,IAAI,oDAAoD,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM;AAAA,EACtH;AACF;AAOO,SAAS,mBAAmB,UAA8B,QAAQ,KAAK,CAAC,GAAuB;AACpG,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;AACJ,MAAI;AACF,UAAM,GAAG,aAAa,OAAO;AAAA,EAC/B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,MAAI,KAAK,SAAS,GAAG,MAAM,YAAY,KAAK,SAAS,MAAM,MAAM,SAAU,QAAO;AAClF,QAAM,QAAQ,KAAK,KAAK,QAAQ,UAAU;AAC1C,MAAI;AACF,UAAM,WAAW,KAAK,MAAM,GAAG,aAAa,KAAK,KAAK,QAAQ,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAClG,WAAO,SAAS,SAAS,qCAAqC,GAAG,WAAW,KAAK,IAAI,QAAQ;AAAA,EAC/F,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWA,eAAsB,YAAY,UAA8B,QAAQ,KAAK,CAAC,GAAmB;AAC/F,QAAM,QAAQ,mBAAmB,OAAO;AACxC,MAAI,OAAO;AACT,QAAI;AACF,aAAO,MAAM,OAAO,cAAc,KAAK,EAAE;AAAA,IAC3C,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,OAAO,iCAAiC;AACjD;AAQA,eAAO,qBAA4C,IAAiC;AAClF,QAAM,QAAQ,QAAQ,IAAI,yBAAyB,GAAG,KAAK;AAC3D,MAAI,CAAC,MAAO;AACZ,QAAM,MAAM,MAAM,YAAY;AAC9B,QAAM,QAAQ,MAAM,0BAA0B,EAAE,OAAO,KAAK,QAAQ,IAAI,GAAG,UAAU,IAAI,YAAY,EAAE,GAAG,GAAG;AAC7G,MAAI,CAAC,MAAO;AACZ,aAAW,EAAE,MAAM,OAAO,KAAK,MAAM,QAAS,IAAG,iBAAiB,MAAM,MAAM;AAC9E,aAAW,EAAE,SAAS,KAAK,MAAM,QAAS,IAAG,iBAAiB,QAAQ;AACxE;",
+  "names": []
+}

package/dist/agents.js

@@ -1,10 +1,10 @@
-import {
-  validateAgentResult
-} from "./chunks/chunk-VYQV5JRT.js";
 import {
   AGENTS_ACTION_DESCRIPTORS,
   normalizeAgentRunRequest
 } from "./chunks/chunk-JJQECUUA.js";
+import {
+  validateAgentResult
+} from "./chunks/chunk-VYQV5JRT.js";
 import {
   AgentAdmission,
   assertAgentTask,

package/dist/capture/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/capture/interceptor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AASnD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAUxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAyBD,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AAaF,eAAO,MAAM,iCAAiC,GAC5C,WAAW,MAAM,KAChB,OAAO,CAAC,0BAA0B,EAAE,CAuBtC,CAAC;AAiIF,eAAO,MAAM,4BAA4B,GACvC,SAAS,4BAA4B,KACpC,OAAO,CAAC,+BAA+B,CA0CzC,CAAC"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/capture/interceptor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AASnD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAUxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAiCD,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AAaF,eAAO,MAAM,iCAAiC,GAC5C,WAAW,MAAM,KAChB,OAAO,CAAC,0BAA0B,EAAE,CAuBtC,CAAC;AAqIF,eAAO,MAAM,4BAA4B,GACvC,SAAS,4BAA4B,KACpC,OAAO,CAAC,+BAA+B,CA0CzC,CAAC"}

package/dist/chunks/{chunk-6C7FX3WA.js → chunk-BEP6VFL2.js}

@@ -561,6 +561,7 @@ import { createRequire } from "node:module";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 var HUB_SYMBOL = Symbol.for("pi-fabric.registered-tool-capture.v1");
+var HOST_RUNNERS_SYMBOL = Symbol.for("pi-fabric.host-extension-runners.v1");
 var ANCHOR_SYMBOL = Symbol.for("pi-fabric.registered-tool-anchor.v1");
 var definitionDelegatesTo = (definition, target) => {
   let current = definition;
@@ -694,6 +695,10 @@ var extensionRunnerConstructors = async () => {
       constructors.add(Runner);
     }
   }
+  const advertised = globalThis[HOST_RUNNERS_SYMBOL];
+  for (const Runner of advertised instanceof Set ? advertised : []) {
+    if (isExtensionRunnerConstructor(Runner)) constructors.add(Runner);
+  }
   if (constructors.size === 0) {
     try {
       const hostModule = await import("@earendil-works/pi-coding-agent");
@@ -6597,4 +6602,4 @@ export {
   FABRIC_MANAGED_HOST_VERSION,
   createFabricExtension
 };
-//# sourceMappingURL=chunk-6C7FX3WA.js.map
+//# sourceMappingURL=chunk-BEP6VFL2.js.map