omp-fabric 1.2.0 → 1.3.1

package/dist/fabric-runtime-state.js

@@ -11,7 +11,7 @@ import {
   MemoryProvider,
   actionArgNormalizer,
   uniqueDeclaredKeyForSpelling
-} from "./chunks/chunk-3TWC6XOS.js";
+} from "./chunks/chunk-2WDZT27Q.js";
 import "./chunks/chunk-2KEWFW56.js";
 import "./chunks/chunk-U5FYOMG5.js";
 import {
@@ -33,7 +33,7 @@ import {
   repairFabricGuestCode,
   resolveFabricIdentity,
   runFabricHandoffAtBoundary
-} from "./chunks/chunk-5YGOVBOZ.js";
+} from "./chunks/chunk-VSSC4IDU.js";
 import "./chunks/chunk-7VIQNUPS.js";
 import {
   AgentTranscriptReader,
@@ -41,7 +41,7 @@ import {
   countContentLines,
   recentTranscriptTools,
   writeContentForPreview
-} from "./chunks/chunk-HDJBUXDX.js";
+} from "./chunks/chunk-WQUMHDOS.js";
 import "./chunks/chunk-DLXPTBPL.js";
 import {
   ActionRegistry,
@@ -63,7 +63,7 @@ import {
   withExclusiveFileLockAsync
 } from "./chunks/chunk-YWEXP724.js";
 import "./chunks/chunk-4A4MVZQW.js";
-import "./chunks/chunk-NX4SNIMR.js";
+import "./chunks/chunk-FX3XLQYI.js";
 import "./chunks/chunk-6QBPSZJ5.js";
 import {
   FABRIC_COMPONENT_DISCOVER_EVENT,
@@ -94,7 +94,7 @@ import {
   resolveAgentCwd,
   resolveOmpBinary,
   validateAgentCwdRequest
-} from "./chunks/chunk-TQL7FKMG.js";
+} from "./chunks/chunk-45URY66G.js";
 import "./chunks/chunk-VPPIJRNZ.js";
 import {
   executeFile,
@@ -114,12 +114,12 @@ import {
   resolveAgentDir,
   resolveAvailableOmpModel,
   resolveFabricModel
-} from "./chunks/chunk-XRJYPNTI.js";
+} from "./chunks/chunk-WZAH7BO2.js";
 import {
   FABRIC_ACTOR_HOST_EVENTS,
   isFabricActorHostEvent,
   readJsonlPage
-} from "./chunks/chunk-UOSJZXJV.js";
+} from "./chunks/chunk-3LI7YO4M.js";
 import {
   isFabricThinking
 } from "./chunks/chunk-JSBTB3P6.js";
@@ -172,7 +172,7 @@ import {
 } from "./chunks/chunk-6N4XGAZY.js";
 
 // src/fabric-runtime-state.ts
-import path18 from "node:path";
+import path19 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/actors/global-registry.ts
@@ -294,6 +294,7 @@ var GlobalActorRegistry = class {
       ...patch.thinking !== void 0 ? { thinking: patch.thinking } : existing.thinking ? { thinking: existing.thinking } : {},
       ...patch.tools !== void 0 ? { tools: patch.tools } : existing.tools ? { tools: existing.tools } : {},
       ...patch.transport !== void 0 ? { transport: patch.transport } : existing.transport ? { transport: existing.transport } : {},
+      ...patch.cwd !== void 0 ? { cwd: patch.cwd } : existing.cwd ? { cwd: existing.cwd } : {},
       ...patch.timeoutMs !== void 0 ? { timeoutMs: patch.timeoutMs } : existing.timeoutMs ? { timeoutMs: existing.timeoutMs } : {},
       ...patch.extensions !== void 0 ? { extensions: patch.extensions } : typeof existing.extensions === "boolean" ? { extensions: existing.extensions } : {},
       ...patch.validWhile !== void 0 ? { validWhile: patch.validWhile } : existing.validWhile ? { validWhile: existing.validWhile } : {}
@@ -347,6 +348,7 @@ var GlobalActorRegistry = class {
       ...def.thinking ? { thinking: def.thinking } : {},
       ...def.tools ? { tools: [...def.tools] } : {},
       ...def.transport ? { transport: def.transport } : {},
+      ...def.cwd ? { cwd: def.cwd } : {},
       ...def.timeoutMs ? { timeoutMs: def.timeoutMs } : {},
       ...typeof def.extensions === "boolean" ? { extensions: def.extensions } : {},
       ...def.validWhile ? { validWhile: clone(def.validWhile) } : {}
@@ -387,6 +389,7 @@ var GlobalActorRegistry = class {
     const thinking = def.thinking !== void 0 && isFabricThinking(def.thinking) ? def.thinking : void 0;
     const tools = Array.isArray(def.tools) ? [...new Set(def.tools.filter((tool) => typeof tool === "string"))] : void 0;
     const transport = def.transport !== void 0 && TRANSPORTS.has(def.transport) ? def.transport : void 0;
+    const cwd = typeof def.cwd === "string" && def.cwd.trim().length > 0 ? def.cwd : void 0;
     const timeoutMs = typeof def.timeoutMs === "number" ? def.timeoutMs : void 0;
     const extensions = typeof def.extensions === "boolean" ? def.extensions : void 0;
     const requires = normalizeRequirements(def.requires);
@@ -407,6 +410,7 @@ var GlobalActorRegistry = class {
       ...thinking ? { thinking } : {},
       ...tools ? { tools } : {},
       ...transport ? { transport } : {},
+      ...cwd ? { cwd } : {},
       ...timeoutMs ? { timeoutMs } : {},
       ...extensions !== void 0 ? { extensions } : {},
       ...requires && requires.length > 0 ? { requires } : {},
@@ -443,6 +447,7 @@ var GlobalActorRegistry = class {
       const thinking = isFabricThinking(record2.thinking) ? record2.thinking : void 0;
       const tools = Array.isArray(record2.tools) ? record2.tools.filter((tool) => typeof tool === "string") : void 0;
       const transport = record2.transport !== void 0 && TRANSPORTS.has(record2.transport) ? record2.transport : void 0;
+      const cwd = typeof record2.cwd === "string" && record2.cwd.trim().length > 0 ? record2.cwd : void 0;
       const timeoutMs = typeof record2.timeoutMs === "number" ? record2.timeoutMs : void 0;
       const extensions = typeof record2.extensions === "boolean" ? record2.extensions : void 0;
       let requires;
@@ -470,6 +475,7 @@ var GlobalActorRegistry = class {
         ...thinking ? { thinking } : {},
         ...tools ? { tools } : {},
         ...transport ? { transport } : {},
+        ...cwd ? { cwd } : {},
         ...timeoutMs ? { timeoutMs } : {},
         ...extensions !== void 0 ? { extensions } : {},
         ...requires && requires.length > 0 ? { requires } : {},
@@ -2219,10 +2225,10 @@ var FabricComponentSupervisor = class {
       adjacent.set(edge.from, targets);
     }
     const cycles = /* @__PURE__ */ new Map();
-    const visit = (node, path19, positions) => {
+    const visit = (node, path20, positions) => {
       const position = positions.get(node);
       if (position !== void 0) {
-        const cycle = path19.slice(position);
+        const cycle = path20.slice(position);
         const rotations = cycle.map((_, index) => [
           ...cycle.slice(index),
           ...cycle.slice(0, index)
@@ -2232,10 +2238,10 @@ var FabricComponentSupervisor = class {
         cycles.set(canonical.join("\0"), canonical);
         return;
       }
-      if (path19.length > this.#components.size) return;
-      const nextPositions = new Map(positions).set(node, path19.length);
+      if (path20.length > this.#components.size) return;
+      const nextPositions = new Map(positions).set(node, path20.length);
       for (const target of adjacent.get(node) ?? []) {
-        visit(target, [...path19, node], nextPositions);
+        visit(target, [...path20, node], nextPositions);
       }
     };
     for (const id of this.#components.keys()) visit(id, [], /* @__PURE__ */ new Map());
@@ -4198,9 +4204,28 @@ var runProperties = {
     enum: ["off", "minimal", "low", "medium", "high", "xhigh", "max"]
   },
   tools: { type: "array", items: { type: "string" } },
+  addTools: {
+    type: "array",
+    items: { type: "string" },
+    description: "Extra tools merged onto the resolved tool list instead of replacing it; use with or without tools."
+  },
+  images: {
+    type: "array",
+    description: "Image blocks delivered with the task on the child agent's first turn.",
+    items: {
+      type: "object",
+      properties: {
+        type: { const: "image" },
+        data: { type: "string", description: "Base64-encoded image bytes." },
+        mimeType: { type: "string" }
+      },
+      required: ["type", "data", "mimeType"],
+      additionalProperties: false
+    }
+  },
   timeoutMs: {
     type: "number",
-    description: "Optional longer wall-clock limit in milliseconds. Omit to use agents.timeoutMs (60 minutes by default); values below the configured default are ignored."
+    description: "Optional wall-clock limit in milliseconds, raising or lowering agents.timeoutMs (60 minutes by default). Clamped to the supported range of 1 second to 24 hours."
   },
   extensions: { type: "boolean" },
   recursive: { type: "boolean" },
@@ -4493,6 +4518,10 @@ var AGENTS_ACTION_DESCRIPTORS = [
         thinking: runProperties.thinking,
         tools: runProperties.tools,
         transport: runProperties.transport,
+        cwd: {
+          ...runProperties.cwd,
+          description: "Filesystem execution directory for every activation; relative paths resolve from the host cwd. An OMP actor must also pass extensions: false, because recursive Fabric activations do not support cwd."
+        },
         timeoutMs: runProperties.timeoutMs,
         extensions: runProperties.extensions,
         requires: {
@@ -5287,27 +5316,37 @@ var actorRunBinding = (args) => ({
   ...typeof args.model === "string" && args.model.trim() ? { model: args.model.trim() } : {},
   ...isFabricThinking(args.thinking) ? { thinking: args.thinking } : {}
 });
-var longerTimeoutOverride = (value, manager) => {
+var imageContents = (value) => {
+  if (!Array.isArray(value)) return void 0;
+  const images = value.filter(
+    (entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry) && entry.type === "image" && typeof entry.data === "string" && typeof entry.mimeType === "string"
+  );
+  return images.length > 0 ? images : void 0;
+};
+var boundedTimeoutOverride = (value, manager) => {
   if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
-  const effective = effectiveAgentTimeoutMs(manager.config.timeoutMs, value);
-  return effective > manager.config.timeoutMs ? effective : void 0;
+  return effectiveAgentTimeoutMs(manager.config.timeoutMs, value);
 };
 var runRequest = (args, context, manager, options = {}) => {
   const transport = args.transport === "auto" || args.transport === "process" || args.transport === "tmux" || args.transport === "screen" || args.transport === "localterm" || args.transport === "herdr" ? args.transport : void 0;
   const thinking = isFabricThinking(args.thinking) ? args.thinking : void 0;
   const tools = stringArray(args.tools);
-  const timeoutMs = longerTimeoutOverride(args.timeoutMs, manager);
+  const addTools = stringArray(args.addTools);
+  const images = imageContents(args.images);
+  const timeoutMs = boundedTimeoutOverride(args.timeoutMs, manager);
   const runner = args.runner === "omp" || args.runner === "claude" || args.runner === "veda" ? args.runner : manager.config.runner;
   const inheritedModel = runner === "omp" && !manager.config.model && context.extensionContext.model ? `${context.extensionContext.model.provider}/${context.extensionContext.model.id}` : void 0;
   return {
     task: String(args.task),
     runner,
+    ...images ? { images } : {},
     ...typeof args.name === "string" ? { name: args.name } : {},
     ...transport ? { transport } : {},
     ...typeof args.model === "string" ? { model: args.model } : inheritedModel ? { model: inheritedModel } : {},
     ...typeof args.persona === "string" && args.persona.trim() ? { persona: args.persona.trim() } : {},
     ...thinking ? { thinking } : {},
     ...tools ? { tools } : {},
+    ...addTools ? { addTools } : {},
     ...timeoutMs !== void 0 ? { timeoutMs } : {},
     ...typeof args.extensions === "boolean" ? { extensions: args.extensions } : {},
     ...typeof args.recursive === "boolean" ? { recursive: args.recursive } : {},
@@ -5365,7 +5404,7 @@ var actorRequest = (args, context, manager, inheritModel = true) => {
     },
     []
   ) : void 0;
-  const timeoutMs = longerTimeoutOverride(args.timeoutMs, manager);
+  const timeoutMs = boundedTimeoutOverride(args.timeoutMs, manager);
   const validWhile = typeof args.validWhile === "object" && args.validWhile !== null && !Array.isArray(args.validWhile) && args.validWhile.version === 1 && typeof args.validWhile.source === "string" ? { version: 1, source: args.validWhile.source } : void 0;
   const runner = args.runner === "omp" || args.runner === "claude" || args.runner === "veda" ? args.runner : manager.config.runner;
   if (runner === "veda") {
@@ -5373,6 +5412,12 @@ var actorRequest = (args, context, manager, inheritModel = true) => {
       'The Veda runner does not support persistent actors: Veda executes one headless prompt per invocation. Use an OMP or Claude actor, or agents.run({ runner: "veda" }).'
     );
   }
+  const requestedCwd = typeof args.cwd === "string" ? args.cwd : void 0;
+  validateAgentCwdRequest({
+    ...requestedCwd === void 0 ? {} : { cwd: requestedCwd },
+    recursive: (typeof args.extensions === "boolean" ? args.extensions : true) && runner === "omp"
+  });
+  const cwd = requestedCwd === void 0 ? void 0 : manager.resolveCwd(requestedCwd);
   const inheritedModel = inheritModel && runner === "omp" && !manager.config.model && context.extensionContext.model ? `${context.extensionContext.model.provider}/${context.extensionContext.model.id}` : void 0;
   return {
     ...args.scope === "session" || args.scope === "project" ? { scope: args.scope } : {},
@@ -5390,6 +5435,7 @@ var actorRequest = (args, context, manager, inheritModel = true) => {
     ...isFabricThinking(args.thinking) ? { thinking: args.thinking } : {},
     ...tools ? { tools } : {},
     ...args.transport === "auto" || args.transport === "process" || args.transport === "tmux" || args.transport === "screen" || args.transport === "localterm" || args.transport === "herdr" ? { transport: args.transport } : {},
+    ...cwd ? { cwd } : {},
     ...timeoutMs !== void 0 ? { timeoutMs } : {},
     ...typeof args.extensions === "boolean" ? { extensions: args.extensions } : {},
     ...requires ? { requires } : {},
@@ -6764,6 +6810,8 @@ var CapturedToolsProvider = class {
 };
 
 // src/providers/codemap-provider.ts
+import { statSync as statSync2 } from "node:fs";
+import path9 from "node:path";
 import { Type } from "@oh-my-pi/pi-coding-agent/extensibility/legacy-typebox";
 import { validateJsonSchemaValue } from "@oh-my-pi/pi-ai/utils/schema";
 
@@ -7457,6 +7505,12 @@ var KIND_RANK = {
   const: 1
 };
 var MATCH_TIMEOUT_MS = 12e4;
+var isBudgetTimeout = (error, budgetMs, startedAt) => {
+  if (budgetMs === void 0) return false;
+  if (Date.now() - startedAt >= budgetMs) return true;
+  const message2 = error instanceof Error ? error.message : String(error);
+  return /timeout/i.test(message2);
+};
 var MAX_FALLBACK_BYTES = 2e6;
 var extensionOf = (file) => {
   const slash = file.lastIndexOf("/");
@@ -7557,12 +7611,13 @@ var gitTrackedFiles = async (root, matcher, signal) => {
   }
   return found;
 };
-var walkFiles = async (root, matcher, signal) => {
+var walkFiles = async (root, matcher, signal, expired) => {
   const found = [];
   const pending = [""];
   while (pending.length > 0) {
     const directory = pending.pop() ?? "";
     throwIfAborted(signal);
+    if (expired?.() === true) break;
     let entries;
     try {
       entries = await readdir(directory === "" ? root : path8.join(root, directory), {
@@ -7587,7 +7642,7 @@ var walkFiles = async (root, matcher, signal) => {
   }
   return found;
 };
-var discoverFiles = async (root, matcher, signal) => await gitTrackedFiles(root, matcher, signal) ?? await walkFiles(root, matcher, signal);
+var discoverFiles = async (root, matcher, signal, expired) => await gitTrackedFiles(root, matcher, signal) ?? await walkFiles(root, matcher, signal, expired);
 var COMMENT_HEAD = /^(?:\/\/|\/\*|\*|#|--|<!--|;|%)/;
 var IMPORT_HEAD = /^(?:import|from|require|include|use|using|package|open|load|source)\b/;
 var DECLARATION_HEAD = /^(?:export|pub|public|private|protected|internal|static|final|abstract|override|virtual|inline|async|unsafe|extern|shared|readonly|declare|local|def|defp|defmodule|defstruct|defmacro|class|module|namespace|record|object|data|struct|enum|union|interface|trait|protocol|actor|impl|extension|fn|func|function|sub|procedure|method|const|let|var|val|type|typedef|typealias|template|operator|constructor|init|property|event|signal|macro|task)\b/;
@@ -7749,13 +7804,19 @@ var compareSymbols = (left, right) => {
 };
 async function buildSymbolIndex(request) {
   const startedAt = Date.now();
+  const budgetMs = request.maxMs !== void 0 && request.maxMs > 0 ? request.maxMs : void 0;
+  const remainingMs = () => budgetMs === void 0 ? void 0 : Math.max(0, budgetMs - (Date.now() - startedAt));
+  const outOfTime = () => {
+    const left = remainingMs();
+    return left !== void 0 && left <= 0;
+  };
   const signal = request.signal;
   throwIfAborted(signal);
   const root = path8.resolve(request.root);
   const matcher = request.glob === void 0 ? void 0 : globToRegExp(request.glob);
-  const discovered = await discoverFiles(root, matcher, signal);
+  const discovered = await discoverFiles(root, matcher, signal, outOfTime);
   discovered.sort();
-  let truncated = false;
+  let truncated = outOfTime();
   let files = discovered;
   if (files.length > request.maxFiles) {
     files = discovered.slice(0, request.maxFiles);
@@ -7784,19 +7845,31 @@ async function buildSymbolIndex(request) {
   for (const spec of LANGUAGE_SPECS) {
     if (!activeSpecs.has(spec.id)) continue;
     throwIfAborted(signal);
+    if (outOfTime()) {
+      truncated = true;
+      break;
+    }
     const scoped = [];
     for (const [file, id] of assigned) if (id === spec.id) scoped.push(file);
     const prefix = commonDirectory(scoped);
-    const result = await natives.astGrep({
-      patterns: spec.patterns,
-      lang: spec.lang,
-      path: prefix === "" ? root : path8.join(root, prefix),
-      glob: spec.glob,
-      includeMeta: true,
-      limit: matchLimit,
-      timeoutMs: MATCH_TIMEOUT_MS,
-      ...signal ? { signal } : {}
-    });
+    let result;
+    try {
+      result = await natives.astGrep({
+        patterns: spec.patterns,
+        lang: spec.lang,
+        path: prefix === "" ? root : path8.join(root, prefix),
+        glob: spec.glob,
+        includeMeta: true,
+        limit: matchLimit,
+        timeoutMs: Math.min(MATCH_TIMEOUT_MS, remainingMs() ?? MATCH_TIMEOUT_MS),
+        ...signal ? { signal } : {}
+      });
+    } catch (error) {
+      throwIfAborted(signal);
+      if (!isBudgetTimeout(error, budgetMs, startedAt)) throw error;
+      truncated = true;
+      break;
+    }
     if (result.limitReached) truncated = true;
     for (const match of result.matches) {
       const relative = toPosix2(match.path);
@@ -7816,6 +7889,10 @@ async function buildSymbolIndex(request) {
   }
   for (const file of fallbackFiles) {
     throwIfAborted(signal);
+    if (outOfTime()) {
+      truncated = true;
+      break;
+    }
     let code;
     try {
       code = await readFile(path8.join(root, file), "utf8");
@@ -7861,7 +7938,12 @@ async function buildSymbolIndex(request) {
 
 // src/providers/codemap-provider.ts
 var INDEX_TTL_MS = 3e4;
+var pathField = Type.Optional(Type.String({
+  maxLength: 4096,
+  description: "Directory to index. Relative paths resolve against the session directory; defaults to it. Point this at a project root when the session runs elsewhere."
+}));
 var mapSchema = Type.Object({
+  path: pathField,
   maxTokens: Type.Optional(Type.Number({
     minimum: 200,
     maximum: 2e5,
@@ -7884,6 +7966,7 @@ var mapSchema = Type.Object({
   }))
 }, { additionalProperties: false });
 var cascadeSchema = Type.Object({
+  path: pathField,
   seeds: Type.Array(Type.String({ maxLength: 1024 }), {
     minItems: 1,
     maxItems: 32,
@@ -7900,6 +7983,24 @@ var checked = (action, schema, args) => {
   }
   return args;
 };
+var resolveRoot = (requested, cwd) => {
+  if (requested === void 0) return cwd;
+  const trimmed = requested.trim();
+  if (trimmed.length === 0) {
+    throw new Error("Invalid codemap path: expected a non-empty directory");
+  }
+  const resolved = path9.isAbsolute(trimmed) ? trimmed : path9.resolve(cwd, trimmed);
+  let stats;
+  try {
+    stats = statSync2(resolved);
+  } catch {
+    throw new Error(`Invalid codemap path: ${resolved} does not exist`);
+  }
+  if (!stats.isDirectory()) {
+    throw new Error(`Invalid codemap path: ${resolved} is not a directory`);
+  }
+  return resolved;
+};
 var descriptors = [
   {
     name: "map",
@@ -7943,6 +8044,7 @@ var CodemapProvider = class {
       ...glob !== void 0 ? { glob } : {},
       maxFiles: this.config.maxFiles,
       maxSymbols: this.config.maxSymbols,
+      maxMs: this.config.maxMs,
       ...signal !== void 0 ? { signal } : {}
     });
     this.#cache.set(key, { index, at: Date.now() });
@@ -7952,11 +8054,12 @@ var CodemapProvider = class {
     switch (actionName) {
       case "map": {
         const input = checked("map", mapSchema, args);
-        const index = await this.#index(context.cwd, input.glob, input.refresh === true, context.signal);
+        const target = resolveRoot(input.path, context.cwd);
+        const index = await this.#index(target, input.glob, input.refresh === true, context.signal);
         let cascade;
         if (input.seeds && input.seeds.length > 0) {
           cascade = await coChange({
-            root: context.cwd,
+            root: target,
             seeds: input.seeds,
             maxCommits: this.config.cascadeCommits,
             limit: this.config.cascadeLimit
@@ -7974,6 +8077,7 @@ var CodemapProvider = class {
         });
         return {
           ...budgeted,
+          root: index.root,
           indexed: {
             files: index.files.length,
             symbols: index.symbols.length,
@@ -7988,7 +8092,7 @@ var CodemapProvider = class {
       case "cascade": {
         const input = checked("cascade", cascadeSchema, args);
         const graph = await coChange({
-          root: context.cwd,
+          root: resolveRoot(input.path, context.cwd),
           seeds: input.seeds,
           maxCommits: input.maxCommits ?? this.config.cascadeCommits,
           limit: input.limit ?? this.config.cascadeLimit
@@ -8219,7 +8323,7 @@ var ComponentsProvider = class {
 import fs5 from "node:fs/promises";
 import fsSync from "node:fs";
 import os from "node:os";
-import path9 from "node:path";
+import path10 from "node:path";
 var MCP_DESCRIPTOR_CACHE_VERSION = 1;
 var homeDir = () => {
   const home = process.env.HOME;
@@ -8230,25 +8334,25 @@ var expandHome = (input) => {
   const home = homeDir();
   if (input === "~") return home;
   if (input.startsWith("~/") || input.startsWith("~\\")) {
-    return path9.join(home, input.slice(2));
+    return path10.join(home, input.slice(2));
   }
   return input;
 };
-var legacyMcporterDir = () => path9.join(homeDir(), ".mcporter");
+var legacyMcporterDir = () => path10.join(homeDir(), ".mcporter");
 var mcporterConfigDir = () => {
   const raw = process.env.XDG_CONFIG_HOME;
   if (raw && raw.trim().length > 0) {
     const resolved = expandHome(raw.trim());
-    if (path9.isAbsolute(resolved)) return path9.join(resolved, "mcporter");
+    if (path10.isAbsolute(resolved)) return path10.join(resolved, "mcporter");
   }
   return legacyMcporterDir();
 };
 var mcporterConfigCandidates = () => {
   const base = mcporterConfigDir();
-  const candidates = [path9.join(base, "mcporter.json"), path9.join(base, "mcporter.jsonc")];
+  const candidates = [path10.join(base, "mcporter.json"), path10.join(base, "mcporter.jsonc")];
   const legacy = legacyMcporterDir();
   if (base !== legacy) {
-    candidates.push(path9.join(legacy, "mcporter.json"), path9.join(legacy, "mcporter.jsonc"));
+    candidates.push(path10.join(legacy, "mcporter.json"), path10.join(legacy, "mcporter.jsonc"));
   }
   return candidates;
 };
@@ -8263,12 +8367,12 @@ var pathExists = (filePath) => {
 var mcpConfigLayerPaths = (rootDir, configPath) => {
   const explicitRaw = configPath ?? process.env.MCPORTER_CONFIG;
   if (explicitRaw && explicitRaw.trim().length > 0) {
-    return [path9.resolve(expandHome(explicitRaw.trim()))];
+    return [path10.resolve(expandHome(explicitRaw.trim()))];
   }
   const paths = [];
   const home = mcporterConfigCandidates().find(pathExists);
   if (home) paths.push(home);
-  const projectPath = path9.resolve(rootDir, "config", "mcporter.json");
+  const projectPath = path10.resolve(rootDir, "config", "mcporter.json");
   if (pathExists(projectPath)) paths.push(projectPath);
   return paths;
 };
@@ -8319,8 +8423,8 @@ var parseCacheFile = (value) => {
     servers: value.servers
   };
 };
-var projectMcpCachePath = (projectRoot) => path9.join(projectRoot, ".omp", "fabric", "mcp-cache.json");
-var globalMcpCachePath = (agentDir) => path9.join(agentDir, "fabric", "mcp-descriptors.json");
+var projectMcpCachePath = (projectRoot) => path10.join(projectRoot, ".omp", "fabric", "mcp-cache.json");
+var globalMcpCachePath = (agentDir) => path10.join(agentDir, "fabric", "mcp-descriptors.json");
 var tempCounter = 0;
 var McpDescriptorCacheStore = class {
   constructor(filePath) {
@@ -8337,9 +8441,9 @@ var McpDescriptorCacheStore = class {
   // Atomic-ish write: temp file then rename, so a concurrent reader either
   // sees the previous cache or the next one, never a torn document.
   async save(file) {
-    const directory = path9.dirname(this.filePath);
+    const directory = path10.dirname(this.filePath);
     await fs5.mkdir(directory, { recursive: true });
-    const tempPath = path9.join(
+    const tempPath = path10.join(
       directory,
       `.mcp-cache-${process.pid}-${Date.now()}-${tempCounter++}.tmp`
     );
@@ -8354,7 +8458,7 @@ var McpDescriptorCacheStore = class {
 };
 
 // src/providers/mcp-provider.ts
-import path10 from "node:path";
+import path11 from "node:path";
 var TOOL_METADATA_TTL_MS = 6e4;
 var REVALIDATE_CONCURRENCY = 3;
 var REVALIDATE_SERVER_TIMEOUT_MS = 2e4;
@@ -8362,6 +8466,7 @@ var MIN_REVALIDATE_SERVER_TIMEOUT_MS = 5e3;
 var NOTIFY_DEBOUNCE_MS = 100;
 var PERSIST_DEBOUNCE_MS = 150;
 var COLD_LIST_WAIT_MS = 2500;
+var MAX_CALL_TIMEOUT_MS = 9e5;
 var emptyObjectSchema = {
   type: "object",
   properties: {},
@@ -8412,7 +8517,12 @@ var managementDescriptors = [
       properties: {
         server: { type: "string" },
         tool: { type: "string" },
-        args: { type: "object", additionalProperties: true }
+        args: { type: "object", additionalProperties: true },
+        timeoutMs: {
+          type: "number",
+          minimum: 1,
+          description: `Per-call timeout overriding mcp.callTimeoutMs, clamped to ${MAX_CALL_TIMEOUT_MS}ms.`
+        }
       },
       required: ["server", "tool"],
       additionalProperties: false
@@ -8421,6 +8531,7 @@ var managementDescriptors = [
     namespace: "management"
   }
 ];
+var resolveMcpCallTimeoutMs = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value >= 1 ? Math.min(Math.floor(value), MAX_CALL_TIMEOUT_MS) : fallback;
 var normalizeSchema = (schema) => typeof schema === "object" && schema !== null && !Array.isArray(schema) ? schema : emptyObjectSchema;
 var normalizeMcpResult = (result) => {
   if (typeof result !== "object" || result === null || Array.isArray(result)) return result;
@@ -8608,7 +8719,13 @@ var McpProvider = class {
       const server = String(args.server);
       const tool = String(args.tool);
       const toolArgs = typeof args.args === "object" && args.args !== null && !Array.isArray(args.args) ? args.args : {};
-      return this.#call(server, tool, toolArgs, context.signal);
+      return this.#call(
+        server,
+        tool,
+        toolArgs,
+        context.signal,
+        resolveMcpCallTimeoutMs(args.timeoutMs, this.config.callTimeoutMs)
+      );
     }
     const parsed = this.#parseToolName(actionName);
     if (!parsed) throw new Error(`Invalid MCP action: ${actionName}`);
@@ -8681,8 +8798,8 @@ var McpProvider = class {
     }
     if (this.#dirtyPersist) await this.#persistNow().catch(() => void 0);
   }
-  async #call(serverName, toolName, args, signal) {
-    if (!this.#cacheOn) return this.#callLegacy(serverName, toolName, args, signal);
+  async #call(serverName, toolName, args, signal, timeoutMs) {
+    if (!this.#cacheOn) return this.#callLegacy(serverName, toolName, args, signal, timeoutMs);
     if (signal?.aborted) throw new Error("MCP call cancelled");
     await this.#hydrate();
     const server = await this.#resolveKnownServer(serverName);
@@ -8700,7 +8817,7 @@ var McpProvider = class {
     if (firstContact) this.#recontacted.add(server);
     const operation = runtime.callTool(server, tool.name, {
       args,
-      timeoutMs: this.config.callTimeoutMs,
+      timeoutMs: timeoutMs ?? this.config.callTimeoutMs,
       disableOAuth: this.config.disableOAuth
     });
     try {
@@ -9065,7 +9182,7 @@ var McpProvider = class {
           kind: "stdio",
           command: args.command,
           args: commandArgs,
-          cwd: path10.resolve(this.cwd, typeof args.cwd === "string" ? args.cwd : ".")
+          cwd: path11.resolve(this.cwd, typeof args.cwd === "string" ? args.cwd : ".")
         },
         ...env ? { env } : {}
       };
@@ -9148,7 +9265,7 @@ var McpProvider = class {
     const tool = await this.#findToolLegacy(runtime, server, parsed.tool);
     return tool ? this.#toolDescriptor(server, tool) : void 0;
   }
-  async #callLegacy(serverName, toolName, args, signal) {
+  async #callLegacy(serverName, toolName, args, signal, timeoutMs) {
     if (signal?.aborted) throw new Error("MCP call cancelled");
     const runtime = await this.#getRuntime();
     const server = this.#resolveServerName(runtime, serverName);
@@ -9158,7 +9275,7 @@ var McpProvider = class {
     if (!tool) throw new Error(`Unknown MCP tool: ${serverName}.${toolName}`);
     const operation = runtime.callTool(server, tool.name, {
       args,
-      timeoutMs: this.config.callTimeoutMs,
+      timeoutMs: timeoutMs ?? this.config.callTimeoutMs,
       disableOAuth: this.config.disableOAuth
     });
     try {
@@ -9262,7 +9379,11 @@ var descriptors4 = [
           items: { type: "string", enum: ["root", "agent", "actor"] }
         },
         includeStale: { type: "boolean" },
-        limit: { type: "number", minimum: 1 }
+        limit: { type: "number", minimum: 1 },
+        withTotal: {
+          type: "boolean",
+          description: "Return { members, total, truncated } instead of a bare array, so a clipped page is distinguishable from a complete one."
+        }
       },
       additionalProperties: false
     },
@@ -9288,7 +9409,11 @@ var descriptors4 = [
       type: "object",
       properties: {
         prefix: { type: "string" },
-        limit: { type: "number", minimum: 1 }
+        limit: { type: "number", minimum: 1 },
+        withTotal: {
+          type: "boolean",
+          description: "Return { entries, total, truncated } instead of a bare array, so a clipped page is distinguishable from a complete one."
+        }
       },
       additionalProperties: false
     },
@@ -9379,11 +9504,13 @@ var MeshProvider = class {
         ) : void 0;
         const scope = args.scope === "local" || args.scope === "lineage" || args.scope === "project" ? args.scope : "project";
         const limit = Math.max(1, Math.floor(typeof args.limit === "number" ? args.limit : 100));
-        return this.participants.list({
+        const matched = this.participants.list({
           scope,
           ...kinds ? { kinds } : {},
           ...args.includeStale === true ? { includeStale: true } : {}
-        }).slice(0, limit);
+        });
+        const members = matched.slice(0, limit);
+        return args.withTotal === true ? { members, total: matched.length, truncated: matched.length > members.length } : members;
       }
       case "get": {
         const key = String(args.key);
@@ -9400,11 +9527,13 @@ var MeshProvider = class {
             this.store.maxReadEvents
           )
         );
-        return this.store.listAll(prefix).filter(
+        const matched = this.store.listAll(prefix).filter(
           (entry) => !PRIVATE_STATE_PREFIXES.some(
             (privatePrefix) => entry.key.startsWith(privatePrefix)
           )
-        ).slice(0, limit);
+        );
+        const entries = matched.slice(0, limit);
+        return args.withTotal === true ? { entries, total: matched.length, truncated: matched.length > entries.length } : entries;
       }
       case "put": {
         const key = String(args.key);
@@ -9431,13 +9560,14 @@ var MeshProvider = class {
 };
 
 // src/providers/omp-tools-provider.ts
-import { mkdirSync as mkdirSync2, mkdtempSync, readFileSync as readFileSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { mkdirSync as mkdirSync2, mkdtempSync, readFileSync as readFileSync2, statSync as statSync4, writeFileSync as writeFileSync2 } from "node:fs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import os2 from "node:os";
-import path13 from "node:path";
+import path14 from "node:path";
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { BashTool } from "@oh-my-pi/pi-coding-agent/tools/bash";
 import { EditTool } from "@oh-my-pi/pi-coding-agent/edit";
+import { GlobTool } from "@oh-my-pi/pi-coding-agent/tools/glob";
 import { GrepTool, MULTI_FILE_PER_FILE_MATCHES, SINGLE_FILE_MATCHES } from "@oh-my-pi/pi-coding-agent/tools/grep";
 import { ReadTool } from "@oh-my-pi/pi-coding-agent/tools/read";
 import { piEscapeRegexLiteral, piJoinPath } from "@oh-my-pi/pi-ai/providers/cursor-pi-args";
@@ -9450,7 +9580,7 @@ import {
 
 // src/agents/bash-worktree-add.ts
 import fs6 from "node:fs";
-import path11 from "node:path";
+import path12 from "node:path";
 var BARE_SAFE = /^[A-Za-z0-9_./:@%+=,-]+$/;
 var parseGitWorktreeAdd = (command) => {
   const trimmed = command.trim();
@@ -9513,8 +9643,8 @@ var tryExecuteGitWorktreeAdd = async (args, sessionCwd) => {
   if (typeof command !== "string") return void 0;
   const parsed = parseGitWorktreeAdd(command);
   if (!parsed) return void 0;
-  const gitCwd = parsed.gitCwd ? path11.resolve(sessionCwd, parsed.gitCwd) : typeof args.cwd === "string" ? args.cwd : sessionCwd;
-  const dest = path11.resolve(gitCwd, parsed.dest);
+  const gitCwd = parsed.gitCwd ? path12.resolve(sessionCwd, parsed.gitCwd) : typeof args.cwd === "string" ? args.cwd : sessionCwd;
+  const dest = path12.resolve(gitCwd, parsed.dest);
   let gitRoot;
   try {
     const root = await executeFile("git", ["rev-parse", "--show-toplevel"], {
@@ -9542,8 +9672,8 @@ var tryExecuteGitWorktreeAdd = async (args, sessionCwd) => {
 };
 
 // src/providers/omp-bash-cwd.ts
-import { accessSync, constants, statSync as statSync2 } from "node:fs";
-import path12 from "node:path";
+import { accessSync, constants, statSync as statSync3 } from "node:fs";
+import path13 from "node:path";
 import { createBashToolDefinition } from "@oh-my-pi/pi-coding-agent/extensibility/legacy-pi-coding-agent-shim";
 import { Type as Type3 } from "@oh-my-pi/pi-coding-agent/extensibility/legacy-typebox";
 var OMP_BASH_CWD_KEY = "cwd";
@@ -9553,9 +9683,9 @@ var resolveOmpShellCwd = (toolName, sessionCwd, requested) => {
       `Invalid omp.${toolName} cwd ${JSON.stringify(requested)}: path must be a non-empty string`
     );
   }
-  const resolved = path12.isAbsolute(requested) ? path12.resolve(requested) : path12.resolve(sessionCwd, requested);
+  const resolved = path13.isAbsolute(requested) ? path13.resolve(requested) : path13.resolve(sessionCwd, requested);
   try {
-    if (!statSync2(resolved).isDirectory()) throw new Error("path is not a directory");
+    if (!statSync3(resolved).isDirectory()) throw new Error("path is not a directory");
     accessSync(resolved, constants.R_OK | constants.X_OK);
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error);
@@ -9628,28 +9758,49 @@ var BashCwdDefinitions = class extends ShellCwdDefinitions {
 
 // src/providers/write-preview.ts
 import { homedir } from "node:os";
-import { dirname, isAbsolute, resolve } from "node:path";
+import { dirname, isAbsolute, resolve, win32 } from "node:path";
 import { mkdir, readFile as readFile2, stat, writeFile } from "node:fs/promises";
 import { Type as Type4 } from "@oh-my-pi/pi-coding-agent/extensibility/legacy-typebox";
 var mutationQueues = /* @__PURE__ */ new Map();
-var withFileMutationQueue = async (path19, operation) => {
-  const previous = mutationQueues.get(path19) ?? Promise.resolve();
+var withFileMutationQueue = async (path20, operation) => {
+  const previous = mutationQueues.get(path20) ?? Promise.resolve();
   let release;
   const current = new Promise((resolve2) => {
     release = resolve2;
   });
-  mutationQueues.set(path19, current);
+  mutationQueues.set(path20, current);
   await previous;
   try {
     return await operation();
   } finally {
     release();
-    if (mutationQueues.get(path19) === current) mutationQueues.delete(path19);
+    if (mutationQueues.get(path20) === current) mutationQueues.delete(path20);
   }
 };
+var URI_LIKE_WRITE_TARGET_RE = /^([a-z][a-z0-9+.-]*):\/{1,2}/i;
+var OmpWriteUriTargetError = class extends Error {
+  path;
+  constructor(message2, path20) {
+    super(message2);
+    this.name = "OmpWriteUriTargetError";
+    this.path = path20;
+  }
+};
+var assertFilesystemWriteTarget = (candidate, reported) => {
+  const trimmed = candidate.trim();
+  if (win32.isAbsolute(trimmed)) return;
+  const scheme = URI_LIKE_WRITE_TARGET_RE.exec(trimmed)?.[1]?.toLowerCase();
+  if (scheme === void 0) return;
+  const guidance = scheme === "xd" ? "Tool devices are dispatched by the top-level `write` tool, which carries the xd:// transport; omp.write writes files." : "omp.write resolves filesystem paths only.";
+  throw new OmpWriteUriTargetError(
+    `Refusing to write '${reported}': '${scheme}://' is a URI scheme, not a directory. ${guidance} Prefix the path with './' to create a literal file by that name.`,
+    reported
+  );
+};
 var resolvePreviewPath = (filePath, cwd) => {
   let expanded = filePath.startsWith("@") ? filePath.slice(1) : filePath;
   expanded = expanded.replace(/[\u00a0\u2000-\u200a\u202f\u205f\u3000]/g, " ");
+  assertFilesystemWriteTarget(expanded, filePath);
   if (expanded === "~") expanded = homedir();
   else if (expanded.startsWith("~/")) expanded = homedir() + expanded.slice(1);
   return isAbsolute(expanded) ? expanded : resolve(cwd, expanded);
@@ -9697,14 +9848,14 @@ var createPreviewWriteToolDefinition = (cwd) => {
   return {
     ...original,
     async execute(_toolCallId, params, signal) {
-      const { path: path19, content } = params;
-      const absolutePath = resolvePreviewPath(path19, cwd);
+      const { path: path20, content } = params;
+      const absolutePath = resolvePreviewPath(path20, cwd);
       return withFileMutationQueue(absolutePath, async () => {
         const throwIfAborted2 = () => {
           if (signal?.aborted) throw new Error("Operation aborted");
         };
         throwIfAborted2();
-        const before = await readExistingFileForPreview(path19, cwd, content);
+        const before = await readExistingFileForPreview(path20, cwd, content);
         throwIfAborted2();
         await mkdir(dirname(absolutePath), { recursive: true });
         throwIfAborted2();
@@ -9714,7 +9865,7 @@ var createPreviewWriteToolDefinition = (cwd) => {
           content: [
             {
               type: "text",
-              text: `Successfully wrote ${Buffer.byteLength(content, "utf8")} bytes to ${path19}`
+              text: `Successfully wrote ${Buffer.byteLength(content, "utf8")} bytes to ${path20}`
             }
           ],
           details: { codePreviewBeforeWrite: before }
@@ -9729,7 +9880,7 @@ var MAX_RENDERER_ARGUMENT_CHARS = 2e5;
 var GUEST_READ_LINE_LIMIT = 1e5;
 var MAX_REPLACE_ALL_FILE_CHARS = 2e6;
 var createNativeSession = (cwd, artifactPaths) => {
-  const artifactRoot = artifactPaths ? mkdtempSync(path13.join(os2.tmpdir(), "omp-fabric-bash-")) : void 0;
+  const artifactRoot = artifactPaths ? mkdtempSync(path14.join(os2.tmpdir(), "omp-fabric-bash-")) : void 0;
   return {
     cwd,
     hasUI: false,
@@ -9746,7 +9897,7 @@ var createNativeSession = (cwd, artifactPaths) => {
         try {
           mkdirSync2(artifactRoot, { recursive: true, mode: 448 });
           const id = randomUUID3();
-          const artifactPath = path13.join(artifactRoot, `${toolType}-${id}.log`);
+          const artifactPath = path14.join(artifactRoot, `${toolType}-${id}.log`);
           writeFileSync2(artifactPath, "", { mode: 384 });
           artifactPaths.set(id, artifactPath);
           artifactAllocations.getStore()?.push(artifactPath);
@@ -9787,12 +9938,28 @@ var GREP_SKIP_PROPERTY = {
   type: "number",
   description: "Files to skip before collecting results \u2014 paginate when a search hit the file limit"
 };
-var withGrepSkipSchema = (document) => {
-  const schema = asRecord(document);
+var GITIGNORE_PROPERTY = {
+  type: "boolean",
+  description: "Respect gitignore rules; pass false to search ignored files such as build output or .env"
+};
+var HIDDEN_PROPERTY = {
+  type: "boolean",
+  description: "Include dotfiles and hidden directories"
+};
+var withExtraProperties = (document, extras) => {
+  const source = typeof document === "function" && "toJsonSchema" in document ? document.toJsonSchema() : document;
+  const schema = asRecord(source);
   const properties = asRecord(schema?.properties);
-  if (!schema || !properties || Object.hasOwn(properties, "skip")) return document;
-  return { ...schema, properties: { ...properties, skip: GREP_SKIP_PROPERTY } };
+  if (!schema || !properties) return document;
+  const additions = {};
+  for (const [name, property] of Object.entries(extras)) {
+    if (!Object.hasOwn(properties, name)) additions[name] = property;
+  }
+  if (Object.keys(additions).length === 0) return document;
+  return { ...schema, properties: { ...properties, ...additions } };
 };
+var withGrepSkipSchema = (document) => withExtraProperties(document, { skip: GREP_SKIP_PROPERTY, gitignore: GITIGNORE_PROPERTY });
+var withFindFilterSchema = (document) => withExtraProperties(document, { gitignore: GITIGNORE_PROPERTY, hidden: HIDDEN_PROPERTY });
 var grepSession = (cwd, context) => ({
   cwd,
   hasUI: false,
@@ -9822,7 +9989,37 @@ var createGrepDefinitionWithSkip = (cwd) => {
           pattern: record2.literal === true ? piEscapeRegexLiteral(rawPattern) : rawPattern,
           path: glob ? piJoinPath(searchPath, glob) : searchPath,
           case: record2.ignoreCase === true ? false : void 0,
-          ...skip === void 0 ? {} : { skip }
+          ...skip === void 0 ? {} : { skip },
+          ...typeof record2.gitignore === "boolean" ? { gitignore: record2.gitignore } : {}
+        },
+        signal,
+        onUpdate,
+        context
+      );
+    }
+  };
+};
+var createFindDefinitionWithFilters = (cwd) => {
+  const legacy = createFindToolDefinition(cwd);
+  const tool = new GlobTool(grepSession(cwd));
+  return {
+    ...legacy,
+    parameters: withFindFilterSchema(legacy.parameters),
+    execute: (toolCallId, params, signal, onUpdate, context) => {
+      const record2 = asRecord(params) ?? {};
+      if (typeof record2.gitignore !== "boolean" && typeof record2.hidden !== "boolean") {
+        return legacy.execute(toolCallId, params, signal, onUpdate, context);
+      }
+      const pattern = typeof record2.pattern === "string" ? record2.pattern : void 0;
+      const searchPath = typeof record2.path === "string" ? record2.path : void 0;
+      const limit = typeof record2.limit === "number" ? record2.limit : void 0;
+      return tool.execute(
+        toolCallId,
+        {
+          path: piJoinPath(searchPath ?? ".", pattern ?? "*"),
+          ...limit === void 0 ? {} : { limit },
+          ...typeof record2.gitignore === "boolean" ? { gitignore: record2.gitignore } : {},
+          ...typeof record2.hidden === "boolean" ? { hidden: record2.hidden } : {}
         },
         signal,
         onUpdate,
@@ -9853,7 +10050,7 @@ var normalizeEditArguments = (args, replaceAll, cwd) => {
       ...replaceAll || record2.all === true || record2.replace_all === true ? { replace_all: true } : {}
     };
   });
-  const resolvedPath = path13.resolve(cwd, filePath.startsWith("@") ? filePath.slice(1) : filePath);
+  const resolvedPath = path14.resolve(cwd, filePath.startsWith("@") ? filePath.slice(1) : filePath);
   const current = readFileSync2(resolvedPath, "utf8");
   if (current.length > MAX_REPLACE_ALL_FILE_CHARS) {
     throw new Error(`omp.edit refuses files over ${MAX_REPLACE_ALL_FILE_CHARS} characters`);
@@ -10007,7 +10204,7 @@ var restoreBashOutput = (artifactPath, maxChars, delivered) => {
   if (!artifactPath || maxChars <= 0) return void 0;
   let size;
   try {
-    size = statSync3(artifactPath).size;
+    size = statSync4(artifactPath).size;
   } catch {
     return void 0;
   }
@@ -10249,7 +10446,7 @@ var OmpToolsProvider = class _OmpToolsProvider {
       edit: createNativeReplaceEditToolDefinition(cwd),
       write: createPreviewWriteToolDefinition(cwd),
       grep: createGrepDefinitionWithSkip(cwd),
-      find: createFindToolDefinition(cwd),
+      find: createFindDefinitionWithFilters(cwd),
       ls: createLsToolDefinition(cwd)
     };
     this.#catalog = catalog;
@@ -10654,7 +10851,7 @@ var OmpToolsProvider = class _OmpToolsProvider {
 import { spawn } from "node:child_process";
 import { createHash as createHash3, randomBytes, randomUUID as randomUUID4 } from "node:crypto";
 import fs8 from "node:fs";
-import path15 from "node:path";
+import path16 from "node:path";
 
 // src/schema/types.ts
 var stateBinding = (head) => head ? { transitionId: head.transitionId, version: head.version, to: head.to } : null;
@@ -10663,7 +10860,7 @@ var stateBinding = (head) => head ? { transitionId: head.transitionId, version:
 import { execFileSync } from "node:child_process";
 import { createHash as createHash2 } from "node:crypto";
 import fs7 from "node:fs";
-import path14 from "node:path";
+import path15 from "node:path";
 var SNAPSHOT_MAX_FILES = 2e4;
 var SNAPSHOT_MAX_BYTES = 512 * 1024 * 1024;
 var FALLBACK_SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
@@ -10681,10 +10878,10 @@ var git = (cwd, args) => execFileSync("git", ["-C", cwd, ...args], {
   stdio: ["ignore", "pipe", "ignore"]
 });
 var nulPaths = (buffer) => buffer.toString("utf8").split("\0").filter((item) => item.length > 0);
-var normalizeRelative = (value) => value.split(path14.sep).join("/");
+var normalizeRelative = (value) => value.split(path15.sep).join("/");
 var isInside = (root, candidate) => {
-  const relative = path14.relative(root, candidate);
-  return relative === "" || !path14.isAbsolute(relative) && relative !== ".." && !relative.startsWith(`..${path14.sep}`);
+  const relative = path15.relative(root, candidate);
+  return relative === "" || !path15.isAbsolute(relative) && relative !== ".." && !relative.startsWith(`..${path15.sep}`);
 };
 var excluded = (absolute, exclusions) => exclusions.some((root) => isInside(root, absolute));
 var entryDigest = (absolute) => {
@@ -10710,12 +10907,12 @@ var buildSnapshot = (cwd, paths, metadata, exclusions) => {
   let bytes = 0;
   const unique = [...new Set(paths)].sort((left, right) => left.localeCompare(right));
   for (const relativeInput of unique) {
-    const absolute = path14.resolve(cwd, relativeInput);
+    const absolute = path15.resolve(cwd, relativeInput);
     if (!isInside(cwd, absolute) || excluded(absolute, exclusions)) continue;
     if (Object.keys(entries).length >= SNAPSHOT_MAX_FILES) {
       throw new Error(`Schema workspace snapshot exceeds ${SNAPSHOT_MAX_FILES} files`);
     }
-    const relative = normalizeRelative(path14.relative(cwd, absolute));
+    const relative = normalizeRelative(path15.relative(cwd, absolute));
     const entry = entryDigest(absolute);
     bytes += entry.bytes;
     if (bytes > SNAPSHOT_MAX_BYTES) {
@@ -10744,9 +10941,9 @@ var fallbackPaths = (cwd, exclusions) => {
     const entries = fs7.readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
     for (const entry of entries) {
       if (FALLBACK_SKIPPED_DIRECTORIES.has(entry.name)) continue;
-      const absolute = path14.join(directory, entry.name);
+      const absolute = path15.join(directory, entry.name);
       if (excluded(absolute, exclusions)) continue;
-      const relative = normalizeRelative(path14.relative(cwd, absolute));
+      const relative = normalizeRelative(path15.relative(cwd, absolute));
       if (entry.isDirectory()) visit(absolute);
       else paths.push(relative);
       if (paths.length > SNAPSHOT_MAX_FILES) {
@@ -10760,7 +10957,7 @@ var fallbackPaths = (cwd, exclusions) => {
 var snapshotWorkspace = (cwdInput, excludedRoots = []) => {
   const cwd = fs7.realpathSync(cwdInput);
   const exclusions = excludedRoots.map((root) => {
-    const absolute = path14.resolve(root);
+    const absolute = path15.resolve(root);
     try {
       return fs7.realpathSync(absolute);
     } catch {
@@ -10798,18 +10995,18 @@ var snapshotWorkspace = (cwdInput, excludedRoots = []) => {
   );
 };
 var resolveWorkspaceFile = (cwdInput, requestedPath, options) => {
-  if (!requestedPath.trim() || path14.isAbsolute(requestedPath)) {
+  if (!requestedPath.trim() || path15.isAbsolute(requestedPath)) {
     throw new Error(`Schema paths must be non-empty project-relative paths: ${requestedPath}`);
   }
   const cwd = fs7.realpathSync(cwdInput);
-  const absolute = path14.resolve(cwd, requestedPath);
+  const absolute = path15.resolve(cwd, requestedPath);
   if (!isInside(cwd, absolute) || absolute === cwd) {
     throw new Error(`Schema path escapes the project workspace: ${requestedPath}`);
   }
-  const relativeParts = path14.relative(cwd, absolute).split(path14.sep);
+  const relativeParts = path15.relative(cwd, absolute).split(path15.sep);
   let cursor = cwd;
   for (let index = 0; index < relativeParts.length; index++) {
-    cursor = path14.join(cursor, relativeParts[index]);
+    cursor = path15.join(cursor, relativeParts[index]);
     let stat2;
     try {
       stat2 = fs7.lstatSync(cursor);
@@ -10818,9 +11015,9 @@ var resolveWorkspaceFile = (cwdInput, requestedPath, options) => {
         if (index !== relativeParts.length - 1 || !options.allowAbsent) {
           throw new Error(`Schema path does not exist: ${requestedPath}`);
         }
-        const parentReal = fs7.realpathSync(path14.dirname(cursor));
+        const parentReal = fs7.realpathSync(path15.dirname(cursor));
         if (!isInside(cwd, parentReal)) throw new Error(`Schema path parent escapes the workspace: ${requestedPath}`);
-        return { absolute, relative: normalizeRelative(path14.relative(cwd, absolute)), exists: false };
+        return { absolute, relative: normalizeRelative(path15.relative(cwd, absolute)), exists: false };
       }
       throw error;
     }
@@ -10832,7 +11029,7 @@ var resolveWorkspaceFile = (cwdInput, requestedPath, options) => {
       throw new Error(`Schema transaction paths must name regular files: ${requestedPath}`);
     }
   }
-  return { absolute, relative: normalizeRelative(path14.relative(cwd, absolute)), exists: true };
+  return { absolute, relative: normalizeRelative(path15.relative(cwd, absolute)), exists: true };
 };
 var sha256File = (absolute) => `sha256:${digest(fs7.readFileSync(absolute))}`;
 
@@ -10883,8 +11080,8 @@ var SchemaController = class {
     this.identity = identity;
     this.state = state;
     this.cwd = fs8.realpathSync(cwd);
-    this.#journalRoot = path15.join(mesh.root, "schema-transactions");
-    this.#lockPath = path15.join(this.#journalRoot, ".commit.lock");
+    this.#journalRoot = path16.join(mesh.root, "schema-transactions");
+    this.#lockPath = path16.join(this.#journalRoot, ".commit.lock");
     this.#recoverJournals();
   }
   #activeHypotheses = /* @__PURE__ */ new Map();
@@ -11083,7 +11280,7 @@ var SchemaController = class {
     this.#assertPayloadBound(input);
     const release = this.#acquireCommitLock();
     const transactionId = randomUUID4();
-    const journalPath = path15.join(this.#journalRoot, `${transactionId}.json`);
+    const journalPath = path16.join(this.#journalRoot, `${transactionId}.json`);
     let journal;
     let consumed = false;
     let committed = false;
@@ -11564,7 +11761,7 @@ ${Date.now()}
     }
     for (const name of fs8.readdirSync(this.#journalRoot)) {
       if (!name.endsWith(".json")) continue;
-      const filePath = path15.join(this.#journalRoot, name);
+      const filePath = path16.join(this.#journalRoot, name);
       try {
         const journal = JSON.parse(fs8.readFileSync(filePath, "utf8"));
         if (journal.format !== 1 || journal.status !== "applying" || !Array.isArray(journal.before)) continue;
@@ -11818,11 +12015,11 @@ var SchemaProvider = class {
 
 // src/state/store.ts
 import { createHash as createHash5 } from "node:crypto";
-import path17 from "node:path";
+import path18 from "node:path";
 
 // src/state/complexity.ts
 import fs9 from "node:fs";
-import path16 from "node:path";
+import path17 from "node:path";
 var isWordStart = (character) => character !== void 0 && (character >= "a" && character <= "z" || character >= "A" && character <= "Z" || character === "_" || character === "$");
 var isWordPart = (character) => isWordStart(character) || character !== void 0 && character >= "0" && character <= "9";
 var regularExpressionPrefixWords = /* @__PURE__ */ new Set([
@@ -12054,7 +12251,7 @@ var languageComplexities = [
   typeScriptJavaScriptComplexity
 ];
 var complexityForFile = (file, languages = languageComplexities) => {
-  const extension = path16.extname(file).toLowerCase();
+  const extension = path17.extname(file).toLowerCase();
   return languages.find((language) => language.extensions.includes(extension));
 };
 var countFileComplexity = (file) => {
@@ -12945,7 +13142,7 @@ var StateStore = class {
     const files = [];
     let netDelta = 0;
     for (const file of this.normalizeComplexityFiles(requestedFiles, input.cwd)) {
-      const measured = countFileComplexity(path17.resolve(input.cwd, file));
+      const measured = countFileComplexity(path18.resolve(input.cwd, file));
       if (!measured) {
         files.push({ file, supported: false });
         continue;
@@ -12972,7 +13169,7 @@ var StateStore = class {
     const updates = [];
     let netDelta = 0;
     for (const file of this.normalizeComplexityFiles(files, cwd)) {
-      const measured = countFileComplexity(path17.resolve(cwd, file));
+      const measured = countFileComplexity(path18.resolve(cwd, file));
       if (!measured) {
         deltas.push({ file, supported: false });
         continue;
@@ -13022,11 +13219,11 @@ var StateStore = class {
     const normalized = /* @__PURE__ */ new Set();
     for (const file of files) {
       if (!file.trim()) continue;
-      const relative = path17.relative(cwd, path17.resolve(cwd, file));
-      if (relative === ".." || relative.startsWith(`..${path17.sep}`) || path17.isAbsolute(relative)) {
+      const relative = path18.relative(cwd, path18.resolve(cwd, file));
+      if (relative === ".." || relative.startsWith(`..${path18.sep}`) || path18.isAbsolute(relative)) {
         throw new Error(`State complexity file must be inside the project cwd: ${file}`);
       }
-      normalized.add(relative.split(path17.sep).join("/"));
+      normalized.add(relative.split(path18.sep).join("/"));
     }
     return [...normalized];
   }
@@ -14020,7 +14217,7 @@ var FabricRuntimeState = class {
     this.#mainAgent = mainAgent;
     const projectRoot = process.env.OMP_FABRIC_PROJECT_ROOT ?? context.cwd;
     const configuredMeshRoot = this.#config.mesh.root;
-    const meshRoot = process.env.OMP_FABRIC_MESH_ROOT ?? (configuredMeshRoot ? path18.resolve(projectRoot, configuredMeshRoot) : path18.join(projectRoot, ".omp", "fabric", "mesh"));
+    const meshRoot = process.env.OMP_FABRIC_MESH_ROOT ?? (configuredMeshRoot ? path19.resolve(projectRoot, configuredMeshRoot) : path19.join(projectRoot, ".omp", "fabric", "mesh"));
     this.#mesh = new MeshStore(
       meshRoot,
       this.#config.mesh.maxEventBytes,
@@ -14194,8 +14391,8 @@ var FabricRuntimeState = class {
     };
     const lineageAlive = (rootId) => this.#participants?.get(rootId) !== void 0;
     const actorRoots = {
-      project: path18.join(meshRoot, "actors"),
-      session: path18.join(meshRoot, "actors", fabricSessionId)
+      project: path19.join(meshRoot, "actors"),
+      session: path19.join(meshRoot, "actors", fabricSessionId)
     };
     const acquireActorCapabilityView = (requirements, signal) => this.#registry.acquireCapabilityView(requirements, {
       cwd: context.cwd,