omp-fabric 0.85.0

package/dist/chunks/chunk-YWEXP724.js

@@ -0,0 +1,427 @@
+import {
+  COMPILED_SURFACE_VERSION,
+  MAX_COMPILED_SURFACE_PROPOSALS
+} from "./chunk-4A4MVZQW.js";
+import {
+  writeJsonAtomic,
+  writeJsonAtomicAsync
+} from "./chunk-KAD7UWT2.js";
+
+// src/entropy/compiled-store.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+
+// src/core/file-lock.ts
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+var DEFAULT_LOCK_ATTEMPTS = 50;
+var DEFAULT_LOCK_DELAY_MS = 5;
+var DEFAULT_STALE_LOCK_MS = 3e4;
+var errorCode = (error) => typeof error === "object" && error !== null && "code" in error ? String(error.code) : void 0;
+var sleepSync = (() => {
+  try {
+    const buffer = new Int32Array(new SharedArrayBuffer(4));
+    return (ms) => {
+      Atomics.wait(buffer, 0, 0, ms);
+    };
+  } catch {
+    return () => void 0;
+  }
+})();
+var processAlive = (pid) => {
+  if (!Number.isSafeInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var sleepAsync = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var reapStaleLockAsync = async (lock, verify) => {
+  const claim = `${lock}.reap-${process.pid}-${randomUUID()}`;
+  try {
+    await fs.promises.rename(lock, claim);
+  } catch {
+    return false;
+  }
+  if (!await verify(claim)) {
+    try {
+      await fs.promises.rename(claim, lock);
+    } catch {
+      if (await verify(claim)) {
+        await fs.promises.rm(claim, { recursive: true, force: true });
+      }
+    }
+    return false;
+  }
+  await fs.promises.rm(claim, { recursive: true, force: true });
+  return true;
+};
+var withExclusiveFileLockAsync = async (options, operation) => {
+  const attempts = options.attempts ?? DEFAULT_LOCK_ATTEMPTS;
+  const delayMs = options.delayMs ?? DEFAULT_LOCK_DELAY_MS;
+  const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;
+  await fs.promises.mkdir(options.directory, { recursive: true, mode: 448 });
+  const lock = path.join(options.directory, options.lockName);
+  const ownerPath = path.join(lock, "owner");
+  const token = randomUUID();
+  let acquired = false;
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    try {
+      await fs.promises.mkdir(lock, { mode: 448 });
+      try {
+        await fs.promises.writeFile(ownerPath, `${token}
+${process.pid}
+${Date.now()}
+`, {
+          encoding: "utf-8",
+          mode: 384
+        });
+      } catch (error) {
+        await fs.promises.rm(lock, { recursive: true, force: true });
+        throw error;
+      }
+      acquired = true;
+      break;
+    } catch (error) {
+      if (errorCode(error) !== "EEXIST") throw error;
+      try {
+        const firstOwner = await fs.promises.readFile(ownerPath, "utf8");
+        const [, pidText, createdText] = firstOwner.trim().split("\n");
+        const stale = Date.now() - Number(createdText) > staleMs;
+        if (stale && !processAlive(Number(pidText))) {
+          const secondOwner = await fs.promises.readFile(ownerPath, "utf8");
+          if (secondOwner === firstOwner && await reapStaleLockAsync(lock, async (claimed) => {
+            try {
+              const owner = await fs.promises.readFile(path.join(claimed, "owner"), "utf8");
+              const [, pid, created] = owner.trim().split("\n");
+              return Date.now() - Number(created) > staleMs && !processAlive(Number(pid));
+            } catch {
+              return false;
+            }
+          })) {
+            continue;
+          }
+        }
+      } catch {
+        try {
+          const first = await fs.promises.stat(lock);
+          if (Date.now() - first.mtimeMs > staleMs && await reapStaleLockAsync(lock, async (claimed) => {
+            try {
+              return Date.now() - (await fs.promises.stat(claimed)).mtimeMs > staleMs;
+            } catch {
+              return false;
+            }
+          })) {
+            continue;
+          }
+        } catch {
+        }
+      }
+      if (attempt === attempts - 1) break;
+      await sleepAsync(delayMs);
+    }
+  }
+  if (!acquired) throw new Error(options.timeoutMessage);
+  try {
+    return await operation();
+  } finally {
+    try {
+      const owner = await fs.promises.readFile(ownerPath, "utf8");
+      if (owner.startsWith(`${token}
+`)) {
+        await fs.promises.rm(lock, { recursive: true, force: true });
+      }
+    } catch {
+    }
+  }
+};
+var reapStaleLock = (lock, verify) => {
+  const claim = `${lock}.reap-${process.pid}-${randomUUID()}`;
+  try {
+    fs.renameSync(lock, claim);
+  } catch {
+    return false;
+  }
+  if (!verify(claim)) {
+    try {
+      fs.renameSync(claim, lock);
+    } catch {
+      if (verify(claim)) fs.rmSync(claim, { recursive: true, force: true });
+    }
+    return false;
+  }
+  fs.rmSync(claim, { recursive: true, force: true });
+  return true;
+};
+var withExclusiveFileLock = (options, operation) => {
+  const attempts = options.attempts ?? DEFAULT_LOCK_ATTEMPTS;
+  const delayMs = options.delayMs ?? DEFAULT_LOCK_DELAY_MS;
+  const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;
+  fs.mkdirSync(options.directory, { recursive: true, mode: 448 });
+  const lock = path.join(options.directory, options.lockName);
+  const ownerPath = path.join(lock, "owner");
+  const token = randomUUID();
+  let acquired = false;
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    try {
+      fs.mkdirSync(lock, { mode: 448 });
+      try {
+        fs.writeFileSync(ownerPath, `${token}
+${process.pid}
+${Date.now()}
+`, {
+          encoding: "utf-8",
+          mode: 384
+        });
+      } catch (error) {
+        fs.rmSync(lock, { recursive: true, force: true });
+        throw error;
+      }
+      acquired = true;
+      break;
+    } catch (error) {
+      if (errorCode(error) !== "EEXIST") throw error;
+      try {
+        const firstOwner = fs.readFileSync(ownerPath, "utf8");
+        const [, pidText, createdText] = firstOwner.trim().split("\n");
+        const stale = Date.now() - Number(createdText) > staleMs;
+        if (stale && !processAlive(Number(pidText))) {
+          const secondOwner = fs.readFileSync(ownerPath, "utf8");
+          if (secondOwner === firstOwner && reapStaleLock(lock, (claimed) => {
+            try {
+              const owner = fs.readFileSync(path.join(claimed, "owner"), "utf8");
+              const [, pid, created] = owner.trim().split("\n");
+              return Date.now() - Number(created) > staleMs && !processAlive(Number(pid));
+            } catch {
+              return false;
+            }
+          })) {
+            continue;
+          }
+        }
+      } catch {
+        try {
+          const first = fs.statSync(lock);
+          if (Date.now() - first.mtimeMs > staleMs && reapStaleLock(lock, (claimed) => {
+            try {
+              return Date.now() - fs.statSync(claimed).mtimeMs > staleMs;
+            } catch {
+              return false;
+            }
+          })) {
+            continue;
+          }
+        } catch {
+        }
+      }
+      if (attempt === attempts - 1) break;
+      sleepSync(delayMs);
+    }
+  }
+  if (!acquired) throw new Error(options.timeoutMessage);
+  try {
+    return operation();
+  } finally {
+    try {
+      const owner = fs.readFileSync(ownerPath, "utf8");
+      if (owner.startsWith(`${token}
+`)) {
+        fs.rmSync(lock, { recursive: true, force: true });
+      }
+    } catch {
+    }
+  }
+};
+
+// src/entropy/compiled-store.ts
+var COMPILED_LOCK_ATTEMPTS = 50;
+var COMPILED_LOCK_DELAY_MS = 5;
+var COMPILED_STALE_LOCK_MS = 3e4;
+var compiledSurfaceDirectory = (agentDir) => path2.join(agentDir, "fabric", "entropy");
+var compiledPath = (directory) => path2.join(directory, "compiled.json");
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var errorCode2 = (error) => isRecord(error) && typeof error.code === "string" ? error.code : void 0;
+var errorText = (error) => (error instanceof Error ? error.message : String(error)).slice(0, 200);
+var parseOverlayEntry = (value) => {
+  if (!isRecord(value) || typeof value.ref !== "string" || !value.ref.trim()) return void 0;
+  if (!isRecord(value.inputSchema)) return void 0;
+  if (typeof value.baseSchemaDigest !== "string" || !value.baseSchemaDigest.trim()) {
+    return void 0;
+  }
+  return {
+    ref: value.ref.trim(),
+    inputSchema: value.inputSchema,
+    baseSchemaDigest: value.baseSchemaDigest.trim()
+  };
+};
+var parseQuarantineEntry = (value) => {
+  if (!isRecord(value) || typeof value.ref !== "string" || !value.ref.trim()) return void 0;
+  if (typeof value.baseSchemaDigest !== "string" || !value.baseSchemaDigest.trim()) {
+    return void 0;
+  }
+  return { ref: value.ref.trim(), baseSchemaDigest: value.baseSchemaDigest.trim() };
+};
+var parseAppliedProposal = (value) => {
+  if (!isRecord(value)) return void 0;
+  if (typeof value.kind !== "string" || !value.kind.trim()) return void 0;
+  if (typeof value.ref !== "string" || !value.ref.trim()) return void 0;
+  if (typeof value.detail !== "string" || !value.detail.trim()) return void 0;
+  return {
+    kind: value.kind.trim(),
+    ref: value.ref.trim(),
+    detail: value.detail.trim()
+  };
+};
+var parseGateRecord = (value) => {
+  if (!isRecord(value) || typeof value.passed !== "boolean") return void 0;
+  if (typeof value.beforeScore !== "number" || typeof value.afterScore !== "number") {
+    return void 0;
+  }
+  if (!Array.isArray(value.reasons) || !value.reasons.every((r) => typeof r === "string")) {
+    return void 0;
+  }
+  return {
+    passed: value.passed,
+    beforeScore: value.beforeScore,
+    afterScore: value.afterScore,
+    reasons: value.reasons
+  };
+};
+var parseCompiledSurfaceFile = (value) => {
+  if (!isRecord(value) || value.version !== COMPILED_SURFACE_VERSION) return void 0;
+  if (!Number.isSafeInteger(value.metricVersion) || value.metricVersion < 1) {
+    return void 0;
+  }
+  if (!Array.isArray(value.actions) || !value.actions.every((entry) => parseOverlayEntry(entry))) {
+    return void 0;
+  }
+  if (!Array.isArray(value.quarantined) || !value.quarantined.every((entry) => parseQuarantineEntry(entry))) {
+    return void 0;
+  }
+  if (!Array.isArray(value.applied) || value.applied.length > MAX_COMPILED_SURFACE_PROPOSALS || !value.applied.every((entry) => parseAppliedProposal(entry))) {
+    return void 0;
+  }
+  if (!parseGateRecord(value.gate)) return void 0;
+  if (typeof value.evidenceDigest !== "string" || !value.evidenceDigest.trim()) return void 0;
+  const overlaySeen = /* @__PURE__ */ new Set();
+  for (const entry of value.actions) {
+    const parsed = parseOverlayEntry(entry);
+    if (overlaySeen.has(parsed.ref)) return void 0;
+    overlaySeen.add(parsed.ref);
+  }
+  return {
+    version: COMPILED_SURFACE_VERSION,
+    metricVersion: value.metricVersion,
+    actions: value.actions.map((entry) => parseOverlayEntry(entry)),
+    quarantined: value.quarantined.map((entry) => parseQuarantineEntry(entry)),
+    applied: value.applied.map((entry) => parseAppliedProposal(entry)),
+    gate: parseGateRecord(value.gate),
+    evidenceDigest: value.evidenceDigest.trim()
+  };
+};
+var parseCompiledSurfaceArtifact = (value) => parseCompiledSurfaceFile(value);
+var loadCompiledSurface = (agentDir) => {
+  const file = compiledPath(compiledSurfaceDirectory(agentDir));
+  let raw;
+  try {
+    raw = fs2.readFileSync(file, "utf8");
+  } catch (error) {
+    if (errorCode2(error) === "ENOENT") return {};
+    return { error: `compiled surface is unreadable: ${errorText(error)}` };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return { error: "compiled surface is malformed JSON" };
+  }
+  const parsedFile = parseCompiledSurfaceFile(parsed);
+  if (!parsedFile) return { error: "compiled surface is invalid" };
+  return { file: parsedFile };
+};
+var loadCompiledSurfaceAsync = async (agentDir) => {
+  const file = compiledPath(compiledSurfaceDirectory(agentDir));
+  let raw;
+  try {
+    raw = await fs2.promises.readFile(file, "utf8");
+  } catch (error) {
+    if (errorCode2(error) === "ENOENT") return {};
+    return { error: `compiled surface is unreadable: ${errorText(error)}` };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return { error: "compiled surface is malformed JSON" };
+  }
+  const parsedFile = parseCompiledSurfaceFile(parsed);
+  return parsedFile ? { file: parsedFile } : { error: "compiled surface is invalid" };
+};
+var saveCompiledSurface = (agentDir, file) => withExclusiveFileLock(
+  {
+    directory: compiledSurfaceDirectory(agentDir),
+    lockName: "compiled.lock",
+    timeoutMessage: "Timed out waiting for the compiled entropy surface lock",
+    attempts: COMPILED_LOCK_ATTEMPTS,
+    delayMs: COMPILED_LOCK_DELAY_MS,
+    staleMs: COMPILED_STALE_LOCK_MS
+  },
+  () => {
+    const loaded = loadCompiledSurface(agentDir);
+    if (loaded.error) throw new Error(loaded.error);
+    const target = compiledPath(compiledSurfaceDirectory(agentDir));
+    const serialized = `${JSON.stringify(file, null, 2)}
+`;
+    try {
+      if (fs2.readFileSync(target, "utf8") === serialized) return { file, written: false };
+    } catch {
+    }
+    writeJsonAtomic(target, file, { space: 2, newline: true, mode: 384, dirMode: 448 });
+    return { file, written: true };
+  }
+);
+var saveCompiledSurfaceAsync = async (agentDir, file) => withExclusiveFileLockAsync(
+  {
+    directory: compiledSurfaceDirectory(agentDir),
+    lockName: "compiled.lock",
+    timeoutMessage: "Timed out waiting for the compiled entropy surface lock",
+    attempts: COMPILED_LOCK_ATTEMPTS,
+    delayMs: COMPILED_LOCK_DELAY_MS,
+    staleMs: COMPILED_STALE_LOCK_MS
+  },
+  async () => {
+    const loaded = await loadCompiledSurfaceAsync(agentDir);
+    if (loaded.error) throw new Error(loaded.error);
+    const target = compiledPath(compiledSurfaceDirectory(agentDir));
+    const serialized = `${JSON.stringify(file, null, 2)}
+`;
+    try {
+      if (await fs2.promises.readFile(target, "utf8") === serialized) {
+        return { file, written: false };
+      }
+    } catch {
+    }
+    await writeJsonAtomicAsync(target, file, {
+      space: 2,
+      newline: true,
+      mode: 384,
+      dirMode: 448
+    });
+    return { file, written: true };
+  }
+);
+
+export {
+  withExclusiveFileLockAsync,
+  withExclusiveFileLock,
+  compiledSurfaceDirectory,
+  parseCompiledSurfaceArtifact,
+  loadCompiledSurface,
+  loadCompiledSurfaceAsync,
+  saveCompiledSurface,
+  saveCompiledSurfaceAsync
+};
+//# sourceMappingURL=chunk-YWEXP724.js.map

package/dist/chunks/chunk-YWEXP724.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entropy/compiled-store.ts", "../../src/core/file-lock.ts"],
+  "sourcesContent": ["// Persistence for the compiled entropy surface: <agent dir>/fabric/entropy/\n// compiled.json, locked across OMP processes sharing the agent directory.\n// A damaged artifact surfaces as an error and blocks compiles from\n// overwriting it \u2014 the same discipline as the repair table. The artifact is\n// clock-free, so saving byte-identical content is a no-op.\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { writeJsonAtomic, writeJsonAtomicAsync } from \"../core/atomic-write.js\";\nimport { withExclusiveFileLock, withExclusiveFileLockAsync } from \"../core/file-lock.js\";\nimport {\n  COMPILED_SURFACE_VERSION,\n  MAX_COMPILED_SURFACE_PROPOSALS,\n  type CompiledSurfaceAppliedProposal,\n  type CompiledSurfaceFile,\n  type CompiledSurfaceGateRecord,\n  type CompiledSurfaceOverlayEntry,\n  type CompiledSurfaceQuarantineEntry,\n} from \"./compiled-surface.js\";\n\nconst COMPILED_LOCK_ATTEMPTS = 50;\nconst COMPILED_LOCK_DELAY_MS = 5;\nconst COMPILED_STALE_LOCK_MS = 30_000;\n\nexport const compiledSurfaceDirectory = (agentDir: string): string =>\n  path.join(agentDir, \"fabric\", \"entropy\");\n\nconst compiledPath = (directory: string): string => path.join(directory, \"compiled.json\");\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst errorCode = (error: unknown): string | undefined =>\n  isRecord(error) && typeof error.code === \"string\" ? error.code : undefined;\n\nconst errorText = (error: unknown): string =>\n  (error instanceof Error ? error.message : String(error)).slice(0, 200);\n\nconst parseOverlayEntry = (value: unknown): CompiledSurfaceOverlayEntry | undefined => {\n  if (!isRecord(value) || typeof value.ref !== \"string\" || !value.ref.trim()) return undefined;\n  if (!isRecord(value.inputSchema)) return undefined;\n  if (typeof value.baseSchemaDigest !== \"string\" || !value.baseSchemaDigest.trim()) {\n    return undefined;\n  }\n  return {\n    ref: value.ref.trim(),\n    inputSchema: value.inputSchema,\n    baseSchemaDigest: value.baseSchemaDigest.trim(),\n  };\n};\n\nconst parseQuarantineEntry = (value: unknown): CompiledSurfaceQuarantineEntry | undefined => {\n  if (!isRecord(value) || typeof value.ref !== \"string\" || !value.ref.trim()) return undefined;\n  if (typeof value.baseSchemaDigest !== \"string\" || !value.baseSchemaDigest.trim()) {\n    return undefined;\n  }\n  return { ref: value.ref.trim(), baseSchemaDigest: value.baseSchemaDigest.trim() };\n};\n\nconst parseAppliedProposal = (value: unknown): CompiledSurfaceAppliedProposal | undefined => {\n  if (!isRecord(value)) return undefined;\n  if (typeof value.kind !== \"string\" || !value.kind.trim()) return undefined;\n  if (typeof value.ref !== \"string\" || !value.ref.trim()) return undefined;\n  if (typeof value.detail !== \"string\" || !value.detail.trim()) return undefined;\n  return {\n    kind: value.kind.trim() as CompiledSurfaceAppliedProposal[\"kind\"],\n    ref: value.ref.trim(),\n    detail: value.detail.trim(),\n  };\n};\n\nconst parseGateRecord = (value: unknown): CompiledSurfaceGateRecord | undefined => {\n  if (!isRecord(value) || typeof value.passed !== \"boolean\") return undefined;\n  if (typeof value.beforeScore !== \"number\" || typeof value.afterScore !== \"number\") {\n    return undefined;\n  }\n  if (!Array.isArray(value.reasons) || !value.reasons.every((r) => typeof r === \"string\")) {\n    return undefined;\n  }\n  return {\n    passed: value.passed,\n    beforeScore: value.beforeScore,\n    afterScore: value.afterScore,\n    reasons: value.reasons,\n  };\n};\n\n// Guarded parse of the whole artifact. Any metric version is accepted: the\n// overlay schemas are data gated against recorded calls, so a metric bump\n// does not invalidate them; the version rides along as provenance.\nconst parseCompiledSurfaceFile = (value: unknown): CompiledSurfaceFile | undefined => {\n  if (!isRecord(value) || value.version !== COMPILED_SURFACE_VERSION) return undefined;\n  if (!Number.isSafeInteger(value.metricVersion) || (value.metricVersion as number) < 1) {\n    return undefined;\n  }\n  if (!Array.isArray(value.actions) || !value.actions.every((entry) => parseOverlayEntry(entry))) {\n    return undefined;\n  }\n  if (\n    !Array.isArray(value.quarantined) ||\n    !value.quarantined.every((entry) => parseQuarantineEntry(entry))\n  ) {\n    return undefined;\n  }\n  if (\n    !Array.isArray(value.applied) ||\n    value.applied.length > MAX_COMPILED_SURFACE_PROPOSALS ||\n    !value.applied.every((entry) => parseAppliedProposal(entry))\n  ) {\n    return undefined;\n  }\n  if (!parseGateRecord(value.gate)) return undefined;\n  if (typeof value.evidenceDigest !== \"string\" || !value.evidenceDigest.trim()) return undefined;\n  const overlaySeen = new Set<string>();\n  for (const entry of value.actions) {\n    const parsed = parseOverlayEntry(entry)!;\n    if (overlaySeen.has(parsed.ref)) return undefined;\n    overlaySeen.add(parsed.ref);\n  }\n  return {\n    version: COMPILED_SURFACE_VERSION,\n    metricVersion: value.metricVersion as number,\n    actions: value.actions.map((entry) => parseOverlayEntry(entry)!),\n    quarantined: value.quarantined.map((entry) => parseQuarantineEntry(entry)!),\n    applied: value.applied.map((entry) => parseAppliedProposal(entry)!),\n    gate: parseGateRecord(value.gate)!,\n    evidenceDigest: value.evidenceDigest.trim(),\n  };\n};\n\n// Public guarded parse for artifact files that did not come from this\n// agent dir: exported artifacts being imported, or certification fixtures.\n// The same validation the store applies to its own file, so nothing trusts\n// an artifact shape the store would refuse to load.\nexport const parseCompiledSurfaceArtifact = (\n  value: unknown,\n): CompiledSurfaceFile | undefined => parseCompiledSurfaceFile(value);\n\nexport interface LoadedCompiledSurface {\n  file?: CompiledSurfaceFile;\n  error?: string;\n}\n\nexport const loadCompiledSurface = (agentDir: string): LoadedCompiledSurface => {\n  const file = compiledPath(compiledSurfaceDirectory(agentDir));\n  let raw: string;\n  try {\n    raw = fs.readFileSync(file, \"utf8\");\n  } catch (error) {\n    // A missing artifact means the surface was never compiled; anything\n    // else is damage that callers must surface, not silently rebuild.\n    if (errorCode(error) === \"ENOENT\") return {};\n    return { error: `compiled surface is unreadable: ${errorText(error)}` };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return { error: \"compiled surface is malformed JSON\" };\n  }\n  const parsedFile = parseCompiledSurfaceFile(parsed);\n  if (!parsedFile) return { error: \"compiled surface is invalid\" };\n  return { file: parsedFile };\n};\n\nexport const loadCompiledSurfaceAsync = async (\n  agentDir: string,\n): Promise<LoadedCompiledSurface> => {\n  const file = compiledPath(compiledSurfaceDirectory(agentDir));\n  let raw: string;\n  try {\n    raw = await fs.promises.readFile(file, \"utf8\");\n  } catch (error) {\n    if (errorCode(error) === \"ENOENT\") return {};\n    return { error: `compiled surface is unreadable: ${errorText(error)}` };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return { error: \"compiled surface is malformed JSON\" };\n  }\n  const parsedFile = parseCompiledSurfaceFile(parsed);\n  return parsedFile ? { file: parsedFile } : { error: \"compiled surface is invalid\" };\n};\n\nexport interface SavedCompiledSurface {\n  file: CompiledSurfaceFile;\n  written: boolean;\n}\n\nexport const saveCompiledSurface = (\n  agentDir: string,\n  file: CompiledSurfaceFile,\n): SavedCompiledSurface =>\n  withExclusiveFileLock(\n    {\n      directory: compiledSurfaceDirectory(agentDir),\n      lockName: \"compiled.lock\",\n      timeoutMessage: \"Timed out waiting for the compiled entropy surface lock\",\n      attempts: COMPILED_LOCK_ATTEMPTS,\n      delayMs: COMPILED_LOCK_DELAY_MS,\n      staleMs: COMPILED_STALE_LOCK_MS,\n    },\n    () => {\n      // A damaged artifact must never be silently rebuilt; fail so the\n      // compile records the rejection and leaves the file for recovery.\n      const loaded = loadCompiledSurface(agentDir);\n      if (loaded.error) throw new Error(loaded.error);\n      const target = compiledPath(compiledSurfaceDirectory(agentDir));\n      const serialized = `${JSON.stringify(file, null, 2)}\\n`;\n      try {\n        if (fs.readFileSync(target, \"utf8\") === serialized) return { file, written: false };\n      } catch {\n        // Missing file: proceed to write.\n      }\n      writeJsonAtomic(target, file, { space: 2, newline: true, mode: 0o600, dirMode: 0o700 });\n      return { file, written: true };\n    },\n  );\n\nexport const saveCompiledSurfaceAsync = async (\n  agentDir: string,\n  file: CompiledSurfaceFile,\n): Promise<SavedCompiledSurface> =>\n  withExclusiveFileLockAsync(\n    {\n      directory: compiledSurfaceDirectory(agentDir),\n      lockName: \"compiled.lock\",\n      timeoutMessage: \"Timed out waiting for the compiled entropy surface lock\",\n      attempts: COMPILED_LOCK_ATTEMPTS,\n      delayMs: COMPILED_LOCK_DELAY_MS,\n      staleMs: COMPILED_STALE_LOCK_MS,\n    },\n    async () => {\n      const loaded = await loadCompiledSurfaceAsync(agentDir);\n      if (loaded.error) throw new Error(loaded.error);\n      const target = compiledPath(compiledSurfaceDirectory(agentDir));\n      const serialized = `${JSON.stringify(file, null, 2)}\\n`;\n      try {\n        if (await fs.promises.readFile(target, \"utf8\") === serialized) {\n          return { file, written: false };\n        }\n      } catch {\n        // Missing file: proceed to write.\n      }\n      await writeJsonAtomicAsync(target, file, {\n        space: 2,\n        newline: true,\n        mode: 0o600,\n        dirMode: 0o700,\n      });\n      return { file, written: true };\n    },\n  );\n", "// Cross-process exclusive lock for Fabric's durable stores (the repair\n// table, the compiled entropy surface). Acquisition is a bounded retry over\n// mkdir; stale-lock recovery is an exclusive rename claim, so racing\n// reapers can never delete a lock a fresh writer owns.\n\nimport { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nconst DEFAULT_LOCK_ATTEMPTS = 50;\nconst DEFAULT_LOCK_DELAY_MS = 5;\nconst DEFAULT_STALE_LOCK_MS = 30_000;\n\nexport interface ExclusiveLockOptions {\n  directory: string;\n  lockName: string;\n  /** Error message when acquisition times out. */\n  timeoutMessage: string;\n  staleMs?: number;\n  attempts?: number;\n  delayMs?: number;\n}\n\nconst errorCode = (error: unknown): string | undefined =>\n  typeof error === \"object\" && error !== null && \"code\" in error\n    ? String((error as { code?: unknown }).code)\n    : undefined;\n\nconst sleepSync = (() => {\n  try {\n    const buffer = new Int32Array(new SharedArrayBuffer(4));\n    return (ms: number): void => {\n      Atomics.wait(buffer, 0, 0, ms);\n    };\n  } catch {\n    return (): void => undefined;\n  }\n})();\n\nconst processAlive = (pid: number): boolean => {\n  if (!Number.isSafeInteger(pid) || pid <= 0) return false;\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst sleepAsync = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\nconst reapStaleLockAsync = async (\n  lock: string,\n  verify: (claimed: string) => Promise<boolean>,\n): Promise<boolean> => {\n  const claim = `${lock}.reap-${process.pid}-${randomUUID()}`;\n  try {\n    await fs.promises.rename(lock, claim);\n  } catch {\n    return false;\n  }\n  if (!(await verify(claim))) {\n    try {\n      await fs.promises.rename(claim, lock);\n    } catch {\n      if (await verify(claim)) {\n        await fs.promises.rm(claim, { recursive: true, force: true });\n      }\n    }\n    return false;\n  }\n  await fs.promises.rm(claim, { recursive: true, force: true });\n  return true;\n};\n\nexport const withExclusiveFileLockAsync = async <T>(\n  options: ExclusiveLockOptions,\n  operation: () => T | Promise<T>,\n): Promise<T> => {\n  const attempts = options.attempts ?? DEFAULT_LOCK_ATTEMPTS;\n  const delayMs = options.delayMs ?? DEFAULT_LOCK_DELAY_MS;\n  const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;\n  await fs.promises.mkdir(options.directory, { recursive: true, mode: 0o700 });\n  const lock = path.join(options.directory, options.lockName);\n  const ownerPath = path.join(lock, \"owner\");\n  const token = randomUUID();\n  let acquired = false;\n  for (let attempt = 0; attempt < attempts; attempt++) {\n    try {\n      await fs.promises.mkdir(lock, { mode: 0o700 });\n      try {\n        await fs.promises.writeFile(ownerPath, `${token}\\n${process.pid}\\n${Date.now()}\\n`, {\n          encoding: \"utf-8\",\n          mode: 0o600,\n        });\n      } catch (error) {\n        await fs.promises.rm(lock, { recursive: true, force: true });\n        throw error;\n      }\n      acquired = true;\n      break;\n    } catch (error) {\n      if (errorCode(error) !== \"EEXIST\") throw error;\n      try {\n        const firstOwner = await fs.promises.readFile(ownerPath, \"utf8\");\n        const [, pidText, createdText] = firstOwner.trim().split(\"\\n\");\n        const stale = Date.now() - Number(createdText) > staleMs;\n        if (stale && !processAlive(Number(pidText))) {\n          const secondOwner = await fs.promises.readFile(ownerPath, \"utf8\");\n          if (\n            secondOwner === firstOwner &&\n            await reapStaleLockAsync(lock, async (claimed) => {\n              try {\n                const owner = await fs.promises.readFile(path.join(claimed, \"owner\"), \"utf8\");\n                const [, pid, created] = owner.trim().split(\"\\n\");\n                return Date.now() - Number(created) > staleMs && !processAlive(Number(pid));\n              } catch {\n                return false;\n              }\n            })\n          ) {\n            continue;\n          }\n        }\n      } catch {\n        try {\n          const first = await fs.promises.stat(lock);\n          if (\n            Date.now() - first.mtimeMs > staleMs &&\n            await reapStaleLockAsync(lock, async (claimed) => {\n              try {\n                return Date.now() - (await fs.promises.stat(claimed)).mtimeMs > staleMs;\n              } catch {\n                return false;\n              }\n            })\n          ) {\n            continue;\n          }\n        } catch {\n          // Lock creation or stale recovery raced; retry the bounded acquisition.\n        }\n      }\n      if (attempt === attempts - 1) break;\n      await sleepAsync(delayMs);\n    }\n  }\n  if (!acquired) throw new Error(options.timeoutMessage);\n  try {\n    return await operation();\n  } finally {\n    try {\n      const owner = await fs.promises.readFile(ownerPath, \"utf8\");\n      if (owner.startsWith(`${token}\\n`)) {\n        await fs.promises.rm(lock, { recursive: true, force: true });\n      }\n    } catch {\n      // A recovering process already removed this lock.\n    }\n  }\n};\n\n// Stale-lock recovery must be an exclusive claim. Stat-then-delete is\n// TOCTOU: two reapers (or a reaper and a fresh writer that recreated the\n// lock in between) can both pass their checks, and the slower rm then\n// deletes a lock the faster one already replaced. rename() is the claim \u2014\n// only one process can move the directory, and removal targets the claimed\n// path, never the live lock path. A claim that turns out to hold a live\n// lock is renamed back before any destructive step; a live lock is never\n// deleted, even if the rename-back races a fresh writer.\nconst reapStaleLock = (lock: string, verify: (claimed: string) => boolean): boolean => {\n  const claim = `${lock}.reap-${process.pid}-${randomUUID()}`;\n  try {\n    fs.renameSync(lock, claim);\n  } catch {\n    return false;\n  }\n  if (!verify(claim)) {\n    try {\n      fs.renameSync(claim, lock);\n    } catch {\n      // `lock` was recreated after the claim. Re-verify before any\n      // destructive step so a claimed live lock is only ever abandoned as\n      // garbage, never deleted.\n      if (verify(claim)) fs.rmSync(claim, { recursive: true, force: true });\n    }\n    return false;\n  }\n  fs.rmSync(claim, { recursive: true, force: true });\n  return true;\n};\n\nexport const withExclusiveFileLock = <T>(\n  options: ExclusiveLockOptions,\n  operation: () => T,\n): T => {\n  const attempts = options.attempts ?? DEFAULT_LOCK_ATTEMPTS;\n  const delayMs = options.delayMs ?? DEFAULT_LOCK_DELAY_MS;\n  const staleMs = options.staleMs ?? DEFAULT_STALE_LOCK_MS;\n  fs.mkdirSync(options.directory, { recursive: true, mode: 0o700 });\n  const lock = path.join(options.directory, options.lockName);\n  const ownerPath = path.join(lock, \"owner\");\n  const token = randomUUID();\n  let acquired = false;\n  for (let attempt = 0; attempt < attempts; attempt++) {\n    try {\n      fs.mkdirSync(lock, { mode: 0o700 });\n      try {\n        fs.writeFileSync(ownerPath, `${token}\\n${process.pid}\\n${Date.now()}\\n`, {\n          encoding: \"utf-8\",\n          mode: 0o600,\n        });\n      } catch (error) {\n        fs.rmSync(lock, { recursive: true, force: true });\n        throw error;\n      }\n      acquired = true;\n      break;\n    } catch (error) {\n      if (errorCode(error) !== \"EEXIST\") throw error;\n      try {\n        const firstOwner = fs.readFileSync(ownerPath, \"utf8\");\n        const [, pidText, createdText] = firstOwner.trim().split(\"\\n\");\n        const stale = Date.now() - Number(createdText) > staleMs;\n        if (stale && !processAlive(Number(pidText))) {\n          const secondOwner = fs.readFileSync(ownerPath, \"utf8\");\n          if (\n            secondOwner === firstOwner &&\n            reapStaleLock(lock, (claimed) => {\n              try {\n                const owner = fs.readFileSync(path.join(claimed, \"owner\"), \"utf8\");\n                const [, pid, created] = owner.trim().split(\"\\n\");\n                return Date.now() - Number(created) > staleMs && !processAlive(Number(pid));\n              } catch {\n                return false;\n              }\n            })\n          ) {\n            continue;\n          }\n        }\n      } catch {\n        try {\n          // Ownerless lock (crash between mkdir and the owner write): age is\n          // the only signal, and the claim re-verifies it after the rename.\n          const first = fs.statSync(lock);\n          if (\n            Date.now() - first.mtimeMs > staleMs &&\n            reapStaleLock(lock, (claimed) => {\n              try {\n                return Date.now() - fs.statSync(claimed).mtimeMs > staleMs;\n              } catch {\n                return false;\n              }\n            })\n          ) {\n            continue;\n          }\n        } catch {\n          // Lock creation or stale recovery raced; retry the bounded acquisition.\n        }\n      }\n      if (attempt === attempts - 1) break;\n      sleepSync(delayMs);\n    }\n  }\n  if (!acquired) throw new Error(options.timeoutMessage);\n  try {\n    return operation();\n  } finally {\n    try {\n      const owner = fs.readFileSync(ownerPath, \"utf8\");\n      if (owner.startsWith(`${token}\\n`)) {\n        fs.rmSync(lock, { recursive: true, force: true });\n      }\n    } catch {\n      // A recovering process already removed this lock.\n    }\n  }\n};"],
+  "mappings": "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",
+  "names": ["fs", "path", "path", "errorCode", "fs"]
+}

package/dist/chunks/chunk-YZZIKJX6.js

@@ -0,0 +1,60 @@
+// src/protocol.ts
+var FABRIC_PROVIDER_REGISTER_EVENT = "omp-fabric:provider:register:v1";
+var FABRIC_PROVIDER_DISCOVER_EVENT = "omp-fabric:provider:discover:v1";
+var FABRIC_COMPONENT_REGISTER_EVENT = "omp-fabric:component:register:v1";
+var FABRIC_COMPONENT_DISCOVER_EVENT = "omp-fabric:component:discover:v1";
+var FABRIC_PREWALK_REQUEST_EVENT = "omp-fabric:prewalk:request:v1";
+var readFabricPrewalkRequestV1 = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  if (record.version !== 1 || typeof record.context !== "object" || record.context === null || typeof record.claim !== "function" || typeof record.respond !== "function") {
+    return void 0;
+  }
+  return value;
+};
+var FABRIC_PEER_CARDS_EVENT = "omp-fabric:peers:cards:v1";
+var FABRIC_PEER_AWAIT_SETTLE_EVENT = "omp-fabric:peer:await-settle:v1";
+var readFabricPeerCardsRequestV1 = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  if (record.version !== 1 || typeof record.context !== "object" || record.context === null || typeof record.claim !== "function" || typeof record.respond !== "function") {
+    return void 0;
+  }
+  return value;
+};
+var readFabricPeerAwaitSettleRequestV1 = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  const signal = record.signal;
+  if (record.version !== 1 || typeof record.context !== "object" || record.context === null || typeof record.claim !== "function" || typeof record.respond !== "function" || record.selector !== void 0 && typeof record.selector !== "string" || record.settledForMs !== void 0 && typeof record.settledForMs !== "number" || signal !== void 0 && typeof signal.aborted !== "boolean" || record.update !== void 0 && typeof record.update !== "function") {
+    return void 0;
+  }
+  return value;
+};
+var FABRIC_NESTED_TOOL_CALL_ID_PREFIX = "fabric_";
+var FABRIC_TOOL_RESULT_PROXY_KIND = "omp-fabric.tool-result-proxy.v1";
+var readFabricToolResultProxyDetailsV1 = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  if (record.kind !== FABRIC_TOOL_RESULT_PROXY_KIND || typeof record.ref !== "string" || !Object.prototype.hasOwnProperty.call(record, "result")) {
+    return void 0;
+  }
+  return record;
+};
+
+export {
+  FABRIC_PROVIDER_REGISTER_EVENT,
+  FABRIC_PROVIDER_DISCOVER_EVENT,
+  FABRIC_COMPONENT_REGISTER_EVENT,
+  FABRIC_COMPONENT_DISCOVER_EVENT,
+  FABRIC_PREWALK_REQUEST_EVENT,
+  readFabricPrewalkRequestV1,
+  FABRIC_PEER_CARDS_EVENT,
+  FABRIC_PEER_AWAIT_SETTLE_EVENT,
+  readFabricPeerCardsRequestV1,
+  readFabricPeerAwaitSettleRequestV1,
+  FABRIC_NESTED_TOOL_CALL_ID_PREFIX,
+  FABRIC_TOOL_RESULT_PROXY_KIND,
+  readFabricToolResultProxyDetailsV1
+};
+//# sourceMappingURL=chunk-YZZIKJX6.js.map

package/dist/chunks/chunk-YZZIKJX6.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/protocol.ts"],
+  "sourcesContent": ["import type { ExtensionContext } from \"@oh-my-pi/pi-coding-agent\";\n\nexport const FABRIC_PROVIDER_REGISTER_EVENT = \"omp-fabric:provider:register:v1\";\nexport const FABRIC_PROVIDER_DISCOVER_EVENT = \"omp-fabric:provider:discover:v1\";\nexport const FABRIC_COMPONENT_REGISTER_EVENT = \"omp-fabric:component:register:v1\";\nexport const FABRIC_COMPONENT_DISCOVER_EVENT = \"omp-fabric:component:discover:v1\";\nexport const FABRIC_PREWALK_REQUEST_EVENT = \"omp-fabric:prewalk:request:v1\";\n\nexport type FabricPrewalkRequestResultV1 =\n  | { ok: true }\n  | { ok: false; error: string };\n\n/** Host-local request used by queue extensions that need an acknowledged prewalk arm. */\nexport interface FabricPrewalkRequestV1 {\n  version: 1;\n  context: ExtensionContext;\n  claim: () => boolean;\n  respond: (result: FabricPrewalkRequestResultV1) => void;\n}\n\nexport const readFabricPrewalkRequestV1 = (\n  value: unknown,\n): FabricPrewalkRequestV1 | undefined => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (\n    record.version !== 1 ||\n    typeof record.context !== \"object\" ||\n    record.context === null ||\n    typeof record.claim !== \"function\" ||\n    typeof record.respond !== \"function\"\n  ) {\n    return undefined;\n  }\n  return value as FabricPrewalkRequestV1;\n};\n\nexport const FABRIC_PEER_CARDS_EVENT = \"omp-fabric:peers:cards:v1\";\nexport const FABRIC_PEER_AWAIT_SETTLE_EVENT = \"omp-fabric:peer:await-settle:v1\";\n\n/** One root peer session on the project mesh, for pickers and status lines. */\nexport interface FabricPeerCardV1 {\n  id: string;\n  /** Linear-style project label (e.g. \"PQS-2\") minted by the owning host. */\n  label: string;\n  status: \"idle\" | \"running\";\n  model?: string;\n  cwd?: string;\n  startedAt: number;\n  updatedAt: number;\n  pendingMessages: boolean;\n}\n\nexport type FabricPeerCardsResultV1 =\n  | { ok: true; cards: FabricPeerCardV1[] }\n  | { ok: false; error: string };\n\n/** Host-local request used by queue extensions to enumerate live peer sessions. */\nexport interface FabricPeerCardsRequestV1 {\n  version: 1;\n  context: ExtensionContext;\n  claim: () => boolean;\n  respond: (result: FabricPeerCardsResultV1) => void;\n}\n\nexport const readFabricPeerCardsRequestV1 = (\n  value: unknown,\n): FabricPeerCardsRequestV1 | undefined => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (\n    record.version !== 1 ||\n    typeof record.context !== \"object\" ||\n    record.context === null ||\n    typeof record.claim !== \"function\" ||\n    typeof record.respond !== \"function\"\n  ) {\n    return undefined;\n  }\n  return value as FabricPeerCardsRequestV1;\n};\n\nexport interface FabricPeerSettleProgressV1 {\n  waiting: Array<{ label: string; status: \"idle\" | \"running\" }>;\n}\n\nexport type FabricPeerAwaitSettleResultV1 =\n  | { ok: true }\n  | { ok: false; error: string };\n\n/**\n * Host-local request used by queue extensions to hold dispatch until peer\n * sessions settle. A peer counts as settled once it has been quiet\n * (status-wide) for settledForMs; peers that vanish from the mesh count as\n * settled since they can no longer conflict. Selector matches a peer label\n * (case-insensitive) or exact participant id; omitted waits on all peers.\n */\nexport interface FabricPeerAwaitSettleRequestV1 {\n  version: 1;\n  context: ExtensionContext;\n  selector?: string;\n  settledForMs?: number;\n  signal?: AbortSignal;\n  update?: (progress: FabricPeerSettleProgressV1) => void;\n  claim: () => boolean;\n  respond: (result: FabricPeerAwaitSettleResultV1) => void;\n}\n\nexport const readFabricPeerAwaitSettleRequestV1 = (\n  value: unknown,\n): FabricPeerAwaitSettleRequestV1 | undefined => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  const signal = record.signal as AbortSignal | undefined;\n  if (\n    record.version !== 1 ||\n    typeof record.context !== \"object\" ||\n    record.context === null ||\n    typeof record.claim !== \"function\" ||\n    typeof record.respond !== \"function\" ||\n    (record.selector !== undefined && typeof record.selector !== \"string\") ||\n    (record.settledForMs !== undefined && typeof record.settledForMs !== \"number\") ||\n    (signal !== undefined && typeof signal.aborted !== \"boolean\") ||\n    (record.update !== undefined && typeof record.update !== \"function\")\n  ) {\n    return undefined;\n  }\n  return value as FabricPeerAwaitSettleRequestV1;\n};\n\n/** Identifies host-side tool lifecycle events replayed for a nested Fabric call. */\nexport const FABRIC_NESTED_TOOL_CALL_ID_PREFIX = \"fabric_\";\n\n/** Discriminant for the transient details envelope on a proxied provider result. */\nexport const FABRIC_TOOL_RESULT_PROXY_KIND = \"omp-fabric.tool-result-proxy.v1\";\n\n/**\n * Host-only middleware details for non-OMP Fabric providers. `result` is the\n * exact value before maxNestedResultChars is enforced and is not persisted as\n * a separate OMP tool-result message.\n */\nexport interface FabricToolResultProxyDetailsV1 {\n  kind: typeof FABRIC_TOOL_RESULT_PROXY_KIND;\n  ref: string;\n  result: unknown;\n}\n\nexport const readFabricToolResultProxyDetailsV1 = (\n  value: unknown,\n): FabricToolResultProxyDetailsV1 | undefined => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (\n    record.kind !== FABRIC_TOOL_RESULT_PROXY_KIND ||\n    typeof record.ref !== \"string\" ||\n    !Object.prototype.hasOwnProperty.call(record, \"result\")\n  ) {\n    return undefined;\n  }\n  return record as unknown as FabricToolResultProxyDetailsV1;\n};\n\nexport type FabricRisk = \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\nexport type FabricEffectKind = \"none\" | \"scoped\" | \"transactional\" | \"emission\";\nexport type FabricEffectOrdering = \"commutative\" | \"ordered\" | \"unknown\";\n\nexport interface FabricActionEffect {\n  kind: FabricEffectKind;\n  resources?: string[];\n  ordering?: FabricEffectOrdering;\n}\n\n/** MCP tool annotations (Model Context Protocol ToolAnnotations), cached when a runtime surfaces them. */\nexport interface FabricToolAnnotations {\n  readOnlyHint?: boolean;\n  idempotentHint?: boolean;\n  destructiveHint?: boolean;\n  openWorldHint?: boolean;\n}\nexport type FabricActivityEntityKind =\n  | \"agent\"\n  | \"actor\"\n  | \"tool\"\n  | \"extension\"\n  | \"mcp\"\n  | \"mesh\"\n  | \"task\"\n  | \"custom\";\n\nexport type FabricInvocationActivityUpdate =\n  | { type: \"progress\"; message: string }\n  | { type: \"entity\"; id: string; kind: FabricActivityEntityKind; name?: string }\n  | { type: \"metrics\"; tokens?: number; toolCalls?: number; cost?: number };\n\nexport interface FabricMediaBlock {\n  type: \"image\";\n  data: string;\n  mimeType: string;\n}\n\nexport interface FabricActionDescriptor {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n  outputSchema?: Record<string, unknown>;\n  risk: FabricRisk;\n  namespace?: string;\n  effect?: FabricActionEffect;\n  annotations?: FabricToolAnnotations;\n}\n\nexport interface FabricCapabilityActionHead {\n  key: string;\n  parentKey: string;\n  ref: string;\n  name: string;\n  description: string;\n  descriptorHash: string;\n  risk: FabricRisk;\n  namespace?: string;\n  effect?: FabricActionEffect;\n}\n\nexport interface FabricCapabilityProviderHead {\n  key: string;\n  parentKey: string;\n  name: string;\n  description: string;\n  descriptorHash: string;\n  actions: FabricCapabilityActionHead[];\n}\n\nexport interface FabricCapabilityBindingView {\n  ref: string;\n  provider: string;\n  providerBindingId: string;\n  generation: number;\n  descriptorHash: string;\n}\n\nexport interface FabricCommittedCapabilityView {\n  id: string;\n  /** Runtime-local digest including provider binding generations. */\n  digest: string;\n  /** Portable digest of exact refs and descriptor semantics across runtimes. */\n  semanticDigest: string;\n  bindings: Record<string, FabricCapabilityBindingView>;\n}\n\nexport interface FabricCapabilityResolution {\n  satisfied: boolean;\n  missing: string[];\n  optionalMissing: string[];\n  view?: FabricCommittedCapabilityView;\n}\n\nexport interface FabricCapabilityCatalog {\n  kind: \"omp-fabric.capability-catalog\";\n  version: 1;\n  root: {\n    key: \"capability:fabric\";\n    name: \"Fabric capabilities\";\n    description: string;\n    descriptorHash: string;\n  };\n  providers: FabricCapabilityProviderHead[];\n  totalActions: number;\n  indexedActions: number;\n  complete: boolean;\n  reasons: string[];\n}\n\nexport interface FabricProviderListRequest {\n  namespace?: string;\n  query?: string;\n  limit?: number;\n}\n\n/** One named action whose arguments should be typed in guest declarations. */\nexport interface FabricNamedActionTypeSource {\n  name: string;\n  inputSchema: Record<string, unknown>;\n}\n\n/** One MCP server plus the tools to type for `mcp.<server>.*` guest calls. */\nexport interface FabricMcpServerTypeSource {\n  server: string;\n  tools: FabricNamedActionTypeSource[];\n}\n\n/**\n * Live descriptor snapshot the registry hands to the guest declaration\n * builder so dynamic surfaces (mcp, extensions) get argument checking before\n * the sandbox runs. Empty/absent sections keep the loose static declarations.\n */\nexport interface FabricGuestTypeSources {\n  mcpServers?: FabricMcpServerTypeSource[];\n  extensionTools?: FabricNamedActionTypeSource[];\n}\n\n/**\n * Pre-rendered `declare const` blocks replacing the loose mcp/extensions\n * declaration lines. Values are full replacement text (helpers + declare).\n */\nexport interface FabricDynamicGuestDeclarations {\n  mcp?: string;\n  extensions?: string;\n}\n\nexport interface FabricInvocationContext {\n  cwd: string;\n  signal: AbortSignal | undefined;\n  parentToolCallId: string;\n  nestedToolCallId: string;\n  extensionContext: ExtensionContext;\n  update(message: string): void;\n  activity?(update: FabricInvocationActivityUpdate): void;\n  /** Host-supplied inside fabric_exec so agents.handoff schedules the outer-call boundary. */\n  deferHandoff?(args: Record<string, unknown>): Record<string, unknown>;\n  // Out-of-band image content blocks a provider (currently only omp.read of an\n  // image file) wants attached to the call audit, so the single-call render can\n  // re-attach them to the fabric_exec result content for OMP core's kitty image\n  // preview. Bypasses the result char bound that would truncate the base64.\n  // `note` is the read tool's own text output (e.g. \"Read image file [image/png]\"),\n  // captured after any tool_result patch so a handoff that strips OMP's\n  // non-vision note has run; used as the single-call body + content text so the\n  // preview shows the clean note instead of the swapped description.\n  attachMedia?(blocks: FabricMediaBlock[], note?: string): void;\n  // Providers call this after mutable tool_call middleware has run so live and\n  // durable audit surfaces reflect the arguments actually passed to the tool.\n  updateArguments?(args: Record<string, unknown>): void;\n  // Ephemeral renderer-only metadata. It is exposed to live Fabric previews but\n  // never projected into the durable execution trace.\n  attachPreview?(preview: unknown): void;\n  capabilityView?: FabricCommittedCapabilityView;\n  /** Advisory for ordinary calls; strict components reject concurrent conflicting effects. */\n  effectPolicy?: \"advisory\" | \"strict\";\n}\n\nexport interface FabricScopedProviderResult {\n  value: unknown;\n  dispose(): void | Promise<void>;\n}\n\nexport interface FabricProvider {\n  name: string;\n  description: string;\n  list(\n    request: FabricProviderListRequest,\n    context: FabricInvocationContext,\n  ): Promise<FabricActionDescriptor[]>;\n  describe(\n    actionName: string,\n    context: FabricInvocationContext,\n  ): Promise<FabricActionDescriptor | undefined>;\n  prepareArguments?(\n    actionName: string,\n    args: Record<string, unknown>,\n    context: FabricInvocationContext,\n  ): Record<string, unknown> | Promise<Record<string, unknown>>;\n  invoke(\n    actionName: string,\n    args: Record<string, unknown>,\n    context: FabricInvocationContext,\n  ): Promise<unknown>;\n  acquire?(\n    actionName: string,\n    args: Record<string, unknown>,\n    context: FabricInvocationContext,\n  ): Promise<FabricScopedProviderResult>;\n  invocationEnded?(parentToolCallId: string): Promise<void>;\n  subscribeCatalog?(listener: () => void): () => void;\n  close?(): Promise<void>;\n}\n\nexport interface FabricProviderRegistration {\n  version: 1;\n  provider: FabricProvider;\n  overwrite?: boolean;\n}\n\nexport interface FabricProviderDiscovery {\n  version: 1;\n  register(provider: FabricProvider, options?: { overwrite?: boolean }): void;\n}\n\nexport type {\n  FabricCapabilityRequirement,\n  FabricComponentChildOptions,\n  FabricComponentContext,\n  FabricComponentDefinition,\n  FabricComponentDiscovery,\n  FabricComponentDisposer,\n  FabricComponentEffect,\n  FabricComponentEffectConflict,\n  FabricComponentEffectInfo,\n  FabricComponentEffectOptions,\n  FabricComponentEffectRegistration,\n  FabricComponentEntry,\n  FabricComponentGraph,\n  FabricComponentGuarantee,\n  FabricComponentHandle,\n  FabricComponentInfo,\n  FabricComponentProviderLease,\n  FabricModelGuidance,\n  FabricModelGuidanceInfo,\n  FabricModelGuidancePlacement,\n  FabricModelGuidanceTarget,\n  FabricComponentProvision,\n  FabricComponentRegistration,\n  FabricComponentState,\n  FabricComponentStopOptions,\n} from \"./components/types.js\";\n\nexport {\n  FABRIC_EXECUTION_GUIDANCE_SLOT,\n  MAX_FABRIC_MODEL_GUIDANCE_CONTENT_CHARS,\n  MAX_FABRIC_MODEL_GUIDANCE_PER_COMPONENT,\n  MAX_FABRIC_MODEL_GUIDANCE_REGISTRATIONS,\n  MAX_FABRIC_MODEL_GUIDANCE_SNAPSHOT_CHARS,\n  MAX_FABRIC_MODEL_GUIDANCE_TOTAL_CHARS,\n} from \"./components/model-guidance.js\";\n"],
+  "mappings": ";AAEO,IAAM,iCAAiC;AACvC,IAAM,iCAAiC;AACvC,IAAM,kCAAkC;AACxC,IAAM,kCAAkC;AACxC,IAAM,+BAA+B;AAcrC,IAAM,6BAA6B,CACxC,UACuC;AACvC,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,YAC1B;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,IAAM,0BAA0B;AAChC,IAAM,iCAAiC;AA2BvC,IAAM,+BAA+B,CAC1C,UACyC;AACzC,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,YAC1B;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AA4BO,IAAM,qCAAqC,CAChD,UAC+C;AAC/C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,QAAM,SAAS,OAAO;AACtB,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,cACzB,OAAO,aAAa,UAAa,OAAO,OAAO,aAAa,YAC5D,OAAO,iBAAiB,UAAa,OAAO,OAAO,iBAAiB,YACpE,WAAW,UAAa,OAAO,OAAO,YAAY,aAClD,OAAO,WAAW,UAAa,OAAO,OAAO,WAAW,YACzD;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGO,IAAM,oCAAoC;AAG1C,IAAM,gCAAgC;AAatC,IAAM,qCAAqC,CAChD,UAC+C;AAC/C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,SAAS,iCAChB,OAAO,OAAO,QAAQ,YACtB,CAAC,OAAO,UAAU,eAAe,KAAK,QAAQ,QAAQ,GACtD;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;",
+  "names": []
+}