@wrongstack/core 0.289.0 → 0.291.1

package/dist/utils/index.js

@@ -492,6 +492,12 @@ var TerminalLifecycle = class {
    * raw mode. Null when `acquire()` has never been called.
    */
   _wasRaw = null;
+  /**
+   * Whether stdin was paused before the TUI took ownership. Readline closes
+   * its interface by pausing the shared process stream, so raw mode alone is
+   * not enough to make Ink receive bytes during the boot-prompt -> TUI handoff.
+   */
+  _wasPaused = null;
   /**
    * Request the process to exit. Set the flag, trigger any registered
    * `onRequestExit` callback (typically Ink's `unmount()`), and arm a
@@ -543,8 +549,10 @@ var TerminalLifecycle = class {
     if (stdin?.isTTY !== true) return false;
     if (typeof stdin.setRawMode !== "function") return false;
     this._wasRaw = stdin.isRaw ?? false;
+    this._wasPaused = stdin.isPaused();
     this._stdin = stdin;
     stdin.setRawMode(true);
+    stdin.resume();
     this._active = true;
     if (process.platform === "win32") {
       setImmediate(() => {
@@ -573,9 +581,11 @@ var TerminalLifecycle = class {
     const stdin = this._stdin;
     if (stdin?.isTTY === true) {
       stdin.setRawMode?.(this._wasRaw ?? false);
+      if (this._wasPaused) stdin.pause();
     }
     this._stdin = void 0;
     this._wasRaw = null;
+    this._wasPaused = null;
   }
   /**
    * Synchronously reset all terminal state written by the TUI layer:
@@ -686,11 +696,42 @@ function stripAnsi(s) {
   return s.replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
 }
 
-// src/utils/config-json.ts
+// src/utils/config-backup.ts
 import * as fs2 from "node:fs/promises";
+import * as path2 from "node:path";
+function configHistoryDir(globalRoot) {
+  return path2.join(globalRoot, "config-history");
+}
+function configSlug(absolutePath, globalRoot) {
+  const rel = path2.relative(globalRoot, absolutePath);
+  const normalized = rel.replace(/\\/g, "/").replace(/\.json$/i, "");
+  return normalized.replace(/\//g, "-");
+}
+async function backupConfigFile(filePath, paths) {
+  let currentContent;
+  try {
+    currentContent = await fs2.readFile(filePath, "utf8");
+    if (!currentContent.trim()) return;
+  } catch {
+    return;
+  }
+  const now = /* @__PURE__ */ new Date();
+  const ts = now.toISOString().replace(/[:.]/g, "-").replace(/Z$/, "");
+  const slug = configSlug(filePath, paths.globalRoot);
+  const backupDir = configHistoryDir(paths.globalRoot);
+  const backupFile = path2.join(backupDir, `${slug}-${ts}.json`);
+  try {
+    await fs2.mkdir(backupDir, { recursive: true });
+    await fs2.writeFile(backupFile, currentContent, { mode: 384, encoding: "utf8" });
+  } catch {
+  }
+}
+
+// src/utils/config-json.ts
+import * as fs3 from "node:fs/promises";
 async function readJsonObjectFile(filePath) {
   try {
-    const parsed = JSON.parse(await fs2.readFile(filePath, "utf8"));
+    const parsed = JSON.parse(await fs3.readFile(filePath, "utf8"));
     return isJsonObject(parsed) ? parsed : {};
   } catch {
     return {};
@@ -698,7 +739,7 @@ async function readJsonObjectFile(filePath) {
 }
 async function jsonObjectFileExists(filePath) {
   try {
-    await fs2.access(filePath);
+    await fs3.access(filePath);
     return true;
   } catch {
     return false;
@@ -714,9 +755,9 @@ async function updateJsonObjectFile(filePath, mutator) {
   await writeJsonObjectFile(filePath, next);
   return next;
 }
-function getJsonPath(root, path5) {
+function getJsonPath(root, path6) {
   let current = root;
-  for (const segment of path5) {
+  for (const segment of path6) {
     if (typeof segment === "number") {
       if (!Array.isArray(current)) return void 0;
       current = current[segment];
@@ -727,13 +768,13 @@ function getJsonPath(root, path5) {
   }
   return current;
 }
-function setJsonPath(root, path5, value) {
-  if (path5.length === 0) {
+function setJsonPath(root, path6, value) {
+  if (path6.length === 0) {
     if (!isJsonObject(value)) throw new Error("Root config value must be an object");
     return value;
   }
-  const parent = ensureJsonParent(root, path5);
-  const leaf = lastPathSegment(path5);
+  const parent = ensureJsonParent(root, path6);
+  const leaf = lastPathSegment(path6);
   if (typeof leaf === "number") {
     if (!Array.isArray(parent)) throw new Error(`Cannot set numeric segment ${leaf} on non-array parent`);
     parent[leaf] = value;
@@ -743,10 +784,10 @@ function setJsonPath(root, path5, value) {
   }
   return root;
 }
-function removeJsonPath(root, path5) {
-  if (path5.length === 0) return false;
-  const parent = getJsonPath(root, path5.slice(0, -1));
-  const leaf = lastPathSegment(path5);
+function removeJsonPath(root, path6) {
+  if (path6.length === 0) return false;
+  const parent = getJsonPath(root, path6.slice(0, -1));
+  const leaf = lastPathSegment(path6);
   if (typeof leaf === "number") {
     if (!Array.isArray(parent) || leaf < 0 || leaf >= parent.length) return false;
     parent.splice(leaf, 1);
@@ -756,27 +797,27 @@ function removeJsonPath(root, path5) {
   delete parent[leaf];
   return true;
 }
-async function setJsonPathInFile(filePath, path5, value) {
-  return updateJsonObjectFile(filePath, (config) => setJsonPath(config, path5, value));
+async function setJsonPathInFile(filePath, path6, value) {
+  return updateJsonObjectFile(filePath, (config) => setJsonPath(config, path6, value));
 }
-async function removeJsonPathInFile(filePath, path5) {
+async function removeJsonPathInFile(filePath, path6) {
   return updateJsonObjectFile(filePath, (config) => {
-    removeJsonPath(config, path5);
+    removeJsonPath(config, path6);
   });
 }
 function isJsonObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function lastPathSegment(path5) {
-  const segment = path5[path5.length - 1];
+function lastPathSegment(path6) {
+  const segment = path6[path6.length - 1];
   if (segment === void 0) throw new Error("Invalid empty JSON path");
   return segment;
 }
-function ensureJsonParent(root, path5) {
+function ensureJsonParent(root, path6) {
   let current = root;
-  for (let i = 0; i < path5.length - 1; i += 1) {
-    const segment = path5[i];
-    const nextSegment = path5[i + 1];
+  for (let i = 0; i < path6.length - 1; i += 1) {
+    const segment = path6[i];
+    const nextSegment = path6[i + 1];
     if (segment === void 0) throw new Error("Invalid empty JSON path segment");
     const nextContainer = typeof nextSegment === "number" ? [] : {};
     if (typeof segment === "number") {
@@ -793,7 +834,7 @@ function ensureJsonParent(root, path5) {
 }
 
 // src/utils/context-evidence.ts
-import * as path2 from "node:path";
+import * as path3 from "node:path";
 var MAX_TOOL_CALLS = 80;
 var MAX_FACTS = 40;
 var MAX_ERRORS = 20;
@@ -1033,10 +1074,10 @@ function addPath(ctx, out, raw) {
   if (!clean || clean.length > 260) return;
   let normalized = clean.replace(/\\/g, "/");
   try {
-    const abs = path2.isAbsolute(clean) ? path2.resolve(clean) : null;
+    const abs = path3.isAbsolute(clean) ? path3.resolve(clean) : null;
     if (abs) {
-      const rel = path2.relative(ctx.projectRoot, abs);
-      if (!rel.startsWith("..") && !path2.isAbsolute(rel)) {
+      const rel = path3.relative(ctx.projectRoot, abs);
+      if (!rel.startsWith("..") && !path3.isAbsolute(rel)) {
         normalized = rel.replace(/\\/g, "/");
       }
     }
@@ -1154,7 +1195,7 @@ function implicitFactFor(metadata) {
 function metadataReferencedByText(metadata, haystack) {
   for (const file of metadata.files) {
     const f = file.toLowerCase();
-    const base = path2.basename(file).toLowerCase();
+    const base = path3.basename(file).toLowerCase();
     if (f && haystack.includes(f)) return true;
     if (base && haystack.includes(base)) return true;
   }
@@ -1860,10 +1901,10 @@ function validateAgainstSchema(value, schema) {
   return { ok: errors.length === 0, errors };
 }
 var MAX_SCHEMA_DEPTH = 64;
-function walk(value, schema, path5, errors, depth) {
+function walk(value, schema, path6, errors, depth) {
   if (depth > MAX_SCHEMA_DEPTH) {
     errors.push({
-      path: path5 || "<root>",
+      path: path6 || "<root>",
       message: `schema nesting exceeds maximum depth (${MAX_SCHEMA_DEPTH})`
     });
     return;
@@ -1871,7 +1912,7 @@ function walk(value, schema, path5, errors, depth) {
   if (schema.enum !== void 0) {
     if (!enumIncludes(schema.enum, value)) {
       errors.push({
-        path: path5 || "<root>",
+        path: path6 || "<root>",
         message: `expected one of ${JSON.stringify(schema.enum)}, got ${JSON.stringify(value)}`
       });
       return;
@@ -1880,7 +1921,7 @@ function walk(value, schema, path5, errors, depth) {
   if (typeof schema.type === "string") {
     if (!checkType(value, schema.type)) {
       errors.push({
-        path: path5 || "<root>",
+        path: path6 || "<root>",
         message: `expected ${schema.type}, got ${describeType(value)} (${previewValue(value)})`
       });
       return;
@@ -1892,7 +1933,7 @@ function walk(value, schema, path5, errors, depth) {
       if (!(req in obj)) {
         const expected = schema.properties?.[req]?.type;
         errors.push({
-          path: joinPath(path5, req),
+          path: joinPath(path6, req),
           message: `required property missing${typeof expected === "string" ? ` (expected ${expected})` : ""}`
         });
       }
@@ -1900,14 +1941,14 @@ function walk(value, schema, path5, errors, depth) {
     if (schema.properties) {
       for (const [key, subSchema] of Object.entries(schema.properties)) {
         if (key in obj) {
-          walk(obj[key], subSchema, joinPath(path5, key), errors, depth + 1);
+          walk(obj[key], subSchema, joinPath(path6, key), errors, depth + 1);
         }
       }
     }
   }
   if (schema.type === "array" && Array.isArray(value) && schema.items) {
     for (let i = 0; i < value.length; i++) {
-      walk(value[i], schema.items, `${path5}[${i}]`, errors, depth + 1);
+      walk(value[i], schema.items, `${path6}[${i}]`, errors, depth + 1);
     }
   }
 }
@@ -2204,9 +2245,23 @@ function mapContent(msg, fn) {
   }
   return { ...msg, content: next };
 }
+function hasMeaningfulContent(content) {
+  if (typeof content === "string") return content.trim().length > 0;
+  for (const block of content) {
+    if (block.type === "text") {
+      if (block.text.trim().length > 0) return true;
+      continue;
+    }
+    if (block.type === "thinking") {
+      if (block.thinking.trim().length > 0 || block.signature) return true;
+      continue;
+    }
+    return true;
+  }
+  return false;
+}
 function isEmptyMessage(msg) {
-  if (typeof msg.content === "string") return msg.content.trim().length === 0;
-  return msg.content.length === 0;
+  return !hasMeaningfulContent(msg.content);
 }
 
 // src/utils/newline-normalize.ts
@@ -2279,7 +2334,7 @@ function compileUserRegex(pattern, flags) {
 
 // src/utils/safe-json.ts
 function safeParse(input, maxBytes = 5e6) {
-  if (input.length > maxBytes) {
+  if (Buffer.byteLength(input, "utf8") > maxBytes) {
     return { ok: false, error: `Input exceeds limit (${maxBytes} bytes)` };
   }
   try {
@@ -2314,7 +2369,7 @@ function safeStringify(value, pretty = false) {
 }
 function sanitizeJsonString(s) {
   let out = s.trim();
-  out = stripSingleLineComments(out);
+  out = stripJsonComments(out);
   out = out.replace(/,(\s*[}\]])/g, "$1");
   out = escapeControlCharsInStrings(out);
   try {
@@ -2372,34 +2427,59 @@ function escapeControlCharsInStrings(s) {
   }
   return out;
 }
-function stripSingleLineComments(s) {
+function stripJsonComments(s) {
   let inString = false;
+  let escaped = false;
   const chars = [];
   let i = 0;
   while (i < s.length) {
     const c = s.charAt(i);
-    if (c === '"' && (i === 0 || s.charAt(i - 1) !== "\\")) {
-      inString = !inString;
+    if (inString) {
       chars.push(c);
-    } else if (c === "/" && s.charAt(i + 1) === "/" && !inString) {
-      while (i < s.length && s.charAt(i) !== "\n") i++;
-    } else {
+      if (escaped) {
+        escaped = false;
+      } else if (c === "\\") {
+        escaped = true;
+      } else if (c === '"') {
+        inString = false;
+      }
+      i++;
+      continue;
+    }
+    if (c === '"') {
+      inString = true;
       chars.push(c);
+      i++;
+      continue;
+    }
+    if (c === "/" && s.charAt(i + 1) === "/") {
+      while (i < s.length && s.charAt(i) !== "\n") i++;
+      continue;
     }
+    if (c === "/" && s.charAt(i + 1) === "*") {
+      const end = s.indexOf("*/", i + 2);
+      if (end === -1) {
+        chars.push(s.slice(i));
+        break;
+      }
+      i = end + 2;
+      continue;
+    }
+    chars.push(c);
     i++;
   }
   return chars.join("");
 }
 
 // src/utils/session-scoped-path.ts
-import * as path3 from "node:path";
+import * as path4 from "node:path";
 function sessionScopedPath(dir, sessionId, suffix) {
   if (!sessionId || sessionId.includes("\\") || sessionId.includes("..")) {
     throw invalid(sessionId);
   }
-  const resolved = path3.resolve(dir, `${sessionId}${suffix}`);
-  const rel = path3.relative(path3.resolve(dir), resolved);
-  if (rel.startsWith("..") || path3.isAbsolute(rel)) {
+  const resolved = path4.resolve(dir, `${sessionId}${suffix}`);
+  const rel = path4.relative(path4.resolve(dir), resolved);
+  if (rel.startsWith("..") || path4.isAbsolute(rel)) {
     throw invalid(sessionId);
   }
   return resolved;
@@ -2413,51 +2493,16 @@ function invalid(sessionId) {
   });
 }
 
-// src/utils/slug.ts
-function slugify(name, fallback = "prompt", maxLen = 64) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLen).replace(/-+$/g, "") || fallback;
-}
-
-// src/utils/ulid.ts
-import { randomBytes as randomBytes2 } from "node:crypto";
-var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-var ENCODING_LEN = ENCODING.length;
-var TIME_LEN = 10;
-var RANDOM_LEN = 16;
-function encodeTime(now, len) {
-  let mod;
-  let str = "";
-  for (let i = len - 1; i >= 0; i--) {
-    mod = now % ENCODING_LEN;
-    str = ENCODING[mod] + str;
-    now = (now - mod) / ENCODING_LEN;
-  }
-  return str;
-}
-function encodeRandom(len) {
-  const bytes = randomBytes2(len);
-  let str = "";
-  for (let i = 0; i < len; i++) {
-    str += ENCODING[bytes[i] % ENCODING_LEN];
-  }
-  return str;
-}
-function ulid(seedTime = Date.now()) {
-  return encodeTime(seedTime, TIME_LEN) + encodeRandom(RANDOM_LEN);
-}
-function isUlid(value) {
-  if (value.length !== TIME_LEN + RANDOM_LEN) return false;
-  for (const ch of value) {
-    if (!ENCODING.includes(ch)) return false;
-  }
-  return true;
-}
-
 // src/utils/sleep.ts
 function sleep(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 
+// src/utils/slug.ts
+function slugify(name, fallback = "prompt", maxLen = 64) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLen).replace(/-+$/g, "") || fallback;
+}
+
 // src/utils/string.ts
 function truncate(s, max) {
   return s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
@@ -2591,41 +2636,6 @@ function hasOpenTodos(todos) {
   return todos.some((t) => t.status === "pending" || t.status === "in_progress");
 }
 
-// src/utils/tool-subject.ts
-var GLOB_METACHARACTERS = /[*?[\]]/g;
-function escapeGlobSubject(value) {
-  return value.replace(GLOB_METACHARACTERS, (char) => `\\${char}`);
-}
-function normalizePathSubject(value) {
-  return escapeGlobSubject(value.replace(/\\/g, "/"));
-}
-function isPathSubjectKey(subjectKey) {
-  return subjectKey === "path" || subjectKey === "file" || subjectKey === "files";
-}
-function subjectForToolInput(toolName, input, subjectKey) {
-  if (!input || typeof input !== "object") return void 0;
-  const obj = input;
-  if (subjectKey) {
-    const value = obj[subjectKey];
-    if (typeof value === "string") {
-      return isPathSubjectKey(subjectKey) ? normalizePathSubject(value) : escapeGlobSubject(value);
-    }
-  }
-  if (toolName === "bash" && typeof obj.command === "string") {
-    return escapeGlobSubject(obj.command);
-  }
-  if (typeof obj.path === "string") {
-    return normalizePathSubject(obj.path);
-  }
-  if (typeof obj.url === "string") {
-    return escapeGlobSubject(obj.url);
-  }
-  if (typeof obj.name === "string") {
-    return escapeGlobSubject(obj.name);
-  }
-  return void 0;
-}
-
 // src/utils/tool-wire-compact.ts
 var TOOL_DESCRIPTION_MAX_CHARS = 400;
 var SCHEMA_DESCRIPTION_MAX_CHARS = 120;
@@ -2642,9 +2652,11 @@ function compactToolDefinitionForWire(tool, opts = {}) {
       tool.description ?? "",
       opts.descriptionMaxChars ?? TOOL_DESCRIPTION_MAX_CHARS
     ),
-    inputSchema: compactSchemaDescriptions(
-      tool.inputSchema,
-      opts.schemaDescriptionMaxChars ?? SCHEMA_DESCRIPTION_MAX_CHARS
+    inputSchema: normalizeTopLevelToolSchema(
+      compactSchemaDescriptions(
+        tool.inputSchema,
+        opts.schemaDescriptionMaxChars ?? SCHEMA_DESCRIPTION_MAX_CHARS
+      )
     )
   };
   if (useDefaultOptions && typeof tool === "object" && tool !== null) {
@@ -2652,6 +2664,44 @@ function compactToolDefinitionForWire(tool, opts = {}) {
   }
   return compact;
 }
+function normalizeTopLevelToolSchema(schema) {
+  const combinators = ["oneOf", "anyOf", "allOf"].map((keyword) => ({ keyword, branches: schema[keyword] })).filter(
+    (entry) => Array.isArray(entry.branches)
+  );
+  if (combinators.length === 0) return schema;
+  const out = { ...schema, type: "object" };
+  delete out["oneOf"];
+  delete out["anyOf"];
+  delete out["allOf"];
+  const properties = isRecord(schema["properties"]) ? { ...schema["properties"] } : {};
+  let required = stringSet(schema["required"]);
+  for (const { keyword, branches } of combinators) {
+    const objectBranches = branches.filter(isRecord);
+    for (const branch of objectBranches) {
+      if (isRecord(branch["properties"])) Object.assign(properties, branch["properties"]);
+    }
+    const branchRequired = objectBranches.map((branch) => stringSet(branch["required"]));
+    if (keyword === "allOf") {
+      for (const fields of branchRequired) for (const field of fields) required.add(field);
+    } else if (branchRequired.length > 0) {
+      const common = new Set(
+        [...branchRequired[0]].filter(
+          (field) => branchRequired.slice(1).every((fields) => fields.has(field))
+        )
+      );
+      required = /* @__PURE__ */ new Set([...required, ...common]);
+    }
+  }
+  out["properties"] = properties;
+  if (required.size > 0) out["required"] = [...required];
+  else delete out["required"];
+  return out;
+}
+function stringSet(value) {
+  return new Set(
+    Array.isArray(value) ? value.filter((item) => typeof item === "string") : []
+  );
+}
 function compactSchemaDescriptions(schema, maxDescriptionChars = SCHEMA_DESCRIPTION_MAX_CHARS) {
   const compact = compactSchemaNode(schema, maxDescriptionChars);
   return isRecord(compact) ? compact : { type: "object", properties: {} };
@@ -2892,6 +2942,114 @@ function resetCalibration(calibrationKey) {
   _cals.delete(calibrationKey);
 }
 
+// src/utils/tool-description-mode.ts
+var DEFAULT_TOOL_DESCRIPTION_MODE = "extend";
+var ORIGINAL_TOOL_DESCRIPTION = /* @__PURE__ */ Symbol.for("wrongstack.tool.originalDescription");
+function normalizeToolDescriptionMode(value) {
+  if (typeof value !== "string") return void 0;
+  const raw = value.trim().toLowerCase();
+  if (raw === "extend" || raw === "extended" || raw === "full") return "extend";
+  if (raw === "simple" || raw === "short" || raw === "brief") return "simple";
+  return void 0;
+}
+function resolveToolDescriptionMode(modes, toolName) {
+  return normalizeToolDescriptionMode(modes?.[toolName]) ?? DEFAULT_TOOL_DESCRIPTION_MODE;
+}
+function simplifyToolDescription(text, opts = {}) {
+  const maxSentences = Math.max(1, opts.maxSentences ?? 2);
+  const maxChars = Math.max(40, opts.maxChars ?? 180);
+  const normalized = text.replace(/\r\n?/g, "\n").split("\n").map((line) => line.trim()).filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
+  if (normalized.length <= maxChars) return normalized;
+  const sentences = normalized.match(/[^.!?]+[.!?]+(?=\s|$)|[^.!?]+$/g) ?? [normalized];
+  const selected = [];
+  for (const sentence of sentences) {
+    selected.push(sentence.trim());
+    const candidate = selected.join(" ");
+    if (selected.length >= maxSentences || candidate.length >= maxChars) break;
+  }
+  const summary = selected.join(" ").trim() || normalized;
+  if (summary.length <= maxChars) return summary;
+  const hardLimit = maxChars - 4;
+  const boundary = findWordBoundary(summary, hardLimit);
+  return `${summary.slice(0, boundary > 0 ? boundary : hardLimit).trimEnd()} ...`;
+}
+function applyToolDescriptionModeToTool(tool, mode) {
+  const existingOriginal = getOriginalDescription(tool);
+  if (mode === "extend" && !existingOriginal) return tool;
+  const original = existingOriginal ?? {
+    description: tool.description,
+    usageHint: tool.usageHint
+  };
+  const next = mode === "simple" ? withDescription(tool, {
+    description: simplifyToolDescription(original.description),
+    usageHint: original.usageHint === void 0 ? void 0 : simplifyToolDescription(original.usageHint)
+  }) : withDescription(tool, original);
+  return attachOriginalDescription(next, original);
+}
+function setToolDescriptionMode(registry, name, mode) {
+  if (typeof registry.setDescriptionMode === "function") {
+    return registry.setDescriptionMode(name, mode);
+  }
+  if (!registry.get(name) || typeof registry.wrap !== "function") return false;
+  registry.wrap(
+    name,
+    (tool) => applyToolDescriptionModeToTool(tool, mode),
+    "tool-description-mode"
+  );
+  return true;
+}
+function getToolDescriptionMode(registry, name) {
+  return registry.getDescriptionMode?.(name) ?? DEFAULT_TOOL_DESCRIPTION_MODE;
+}
+function applyToolDescriptionModes(registry, modes) {
+  if (typeof registry.applyDescriptionModes === "function") {
+    return registry.applyDescriptionModes(modes);
+  }
+  const entries = Object.entries(modes ?? {});
+  const missing = [];
+  let applied = 0;
+  for (const [name, rawMode] of entries) {
+    const mode = normalizeToolDescriptionMode(rawMode);
+    if (!mode) continue;
+    if (setToolDescriptionMode(registry, name, mode)) applied++;
+    else missing.push(name);
+  }
+  return { applied, missing };
+}
+function getOriginalDescription(tool) {
+  return tool[ORIGINAL_TOOL_DESCRIPTION];
+}
+function attachOriginalDescription(tool, original) {
+  Object.defineProperty(tool, ORIGINAL_TOOL_DESCRIPTION, {
+    configurable: true,
+    enumerable: false,
+    value: original,
+    writable: true
+  });
+  return tool;
+}
+function withDescription(tool, next) {
+  const copy = {
+    ...tool,
+    description: next.description,
+    usageHint: next.usageHint
+  };
+  if (next.usageHint === void 0) {
+    delete copy.usageHint;
+  }
+  return copy;
+}
+function findWordBoundary(text, limit) {
+  const semantic = Math.max(
+    text.lastIndexOf(". ", limit),
+    text.lastIndexOf("; ", limit),
+    text.lastIndexOf(", ", limit)
+  );
+  if (semantic > 40) return semantic + 1;
+  const space = text.lastIndexOf(" ", limit);
+  return space > 40 ? space : limit;
+}
+
 // src/utils/tool-output-serializer.ts
 var DEFAULT_LIST_LIMIT = 500;
 var LOG_ENTRY_LIMIT = 200;
@@ -3555,114 +3713,6 @@ function isScalar(value) {
   return value === null || ["string", "number", "boolean"].includes(typeof value);
 }
 
-// src/utils/tool-description-mode.ts
-var DEFAULT_TOOL_DESCRIPTION_MODE = "extend";
-var ORIGINAL_TOOL_DESCRIPTION = /* @__PURE__ */ Symbol.for("wrongstack.tool.originalDescription");
-function normalizeToolDescriptionMode(value) {
-  if (typeof value !== "string") return void 0;
-  const raw = value.trim().toLowerCase();
-  if (raw === "extend" || raw === "extended" || raw === "full") return "extend";
-  if (raw === "simple" || raw === "short" || raw === "brief") return "simple";
-  return void 0;
-}
-function resolveToolDescriptionMode(modes, toolName) {
-  return normalizeToolDescriptionMode(modes?.[toolName]) ?? DEFAULT_TOOL_DESCRIPTION_MODE;
-}
-function simplifyToolDescription(text, opts = {}) {
-  const maxSentences = Math.max(1, opts.maxSentences ?? 2);
-  const maxChars = Math.max(40, opts.maxChars ?? 180);
-  const normalized = text.replace(/\r\n?/g, "\n").split("\n").map((line) => line.trim()).filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
-  if (normalized.length <= maxChars) return normalized;
-  const sentences = normalized.match(/[^.!?]+[.!?]+(?=\s|$)|[^.!?]+$/g) ?? [normalized];
-  const selected = [];
-  for (const sentence of sentences) {
-    selected.push(sentence.trim());
-    const candidate = selected.join(" ");
-    if (selected.length >= maxSentences || candidate.length >= maxChars) break;
-  }
-  const summary = selected.join(" ").trim() || normalized;
-  if (summary.length <= maxChars) return summary;
-  const hardLimit = maxChars - 4;
-  const boundary = findWordBoundary(summary, hardLimit);
-  return `${summary.slice(0, boundary > 0 ? boundary : hardLimit).trimEnd()} ...`;
-}
-function applyToolDescriptionModeToTool(tool, mode) {
-  const existingOriginal = getOriginalDescription(tool);
-  if (mode === "extend" && !existingOriginal) return tool;
-  const original = existingOriginal ?? {
-    description: tool.description,
-    usageHint: tool.usageHint
-  };
-  const next = mode === "simple" ? withDescription(tool, {
-    description: simplifyToolDescription(original.description),
-    usageHint: original.usageHint === void 0 ? void 0 : simplifyToolDescription(original.usageHint)
-  }) : withDescription(tool, original);
-  return attachOriginalDescription(next, original);
-}
-function setToolDescriptionMode(registry, name, mode) {
-  if (typeof registry.setDescriptionMode === "function") {
-    return registry.setDescriptionMode(name, mode);
-  }
-  if (!registry.get(name) || typeof registry.wrap !== "function") return false;
-  registry.wrap(
-    name,
-    (tool) => applyToolDescriptionModeToTool(tool, mode),
-    "tool-description-mode"
-  );
-  return true;
-}
-function getToolDescriptionMode(registry, name) {
-  return registry.getDescriptionMode?.(name) ?? DEFAULT_TOOL_DESCRIPTION_MODE;
-}
-function applyToolDescriptionModes(registry, modes) {
-  if (typeof registry.applyDescriptionModes === "function") {
-    return registry.applyDescriptionModes(modes);
-  }
-  const entries = Object.entries(modes ?? {});
-  const missing = [];
-  let applied = 0;
-  for (const [name, rawMode] of entries) {
-    const mode = normalizeToolDescriptionMode(rawMode);
-    if (!mode) continue;
-    if (setToolDescriptionMode(registry, name, mode)) applied++;
-    else missing.push(name);
-  }
-  return { applied, missing };
-}
-function getOriginalDescription(tool) {
-  return tool[ORIGINAL_TOOL_DESCRIPTION];
-}
-function attachOriginalDescription(tool, original) {
-  Object.defineProperty(tool, ORIGINAL_TOOL_DESCRIPTION, {
-    configurable: true,
-    enumerable: false,
-    value: original,
-    writable: true
-  });
-  return tool;
-}
-function withDescription(tool, next) {
-  const copy = {
-    ...tool,
-    description: next.description,
-    usageHint: next.usageHint
-  };
-  if (next.usageHint === void 0) {
-    delete copy.usageHint;
-  }
-  return copy;
-}
-function findWordBoundary(text, limit) {
-  const semantic = Math.max(
-    text.lastIndexOf(". ", limit),
-    text.lastIndexOf("; ", limit),
-    text.lastIndexOf(", ", limit)
-  );
-  if (semantic > 40) return semantic + 1;
-  const space = text.lastIndexOf(" ", limit);
-  return space > 40 ? space : limit;
-}
-
 // src/utils/tool-result-render-mode.ts
 var DEFAULT_TOOL_RESULT_RENDER_MODE = "extend";
 function normalizeToolResultRenderMode(value) {
@@ -3700,25 +3750,95 @@ function applyToolResultRenderModes(registry, modes) {
   return { applied, missing };
 }
 
+// src/utils/tool-subject.ts
+var GLOB_METACHARACTERS = /[*?[\]]/g;
+function escapeGlobSubject(value) {
+  return value.replace(GLOB_METACHARACTERS, (char) => `\\${char}`);
+}
+function normalizePathSubject(value) {
+  return escapeGlobSubject(value.replace(/\\/g, "/"));
+}
+function isPathSubjectKey(subjectKey) {
+  return subjectKey === "path" || subjectKey === "file" || subjectKey === "files";
+}
+function subjectForToolInput(toolName, input, subjectKey) {
+  if (!input || typeof input !== "object") return void 0;
+  const obj = input;
+  if (subjectKey) {
+    const value = obj[subjectKey];
+    if (typeof value === "string") {
+      return isPathSubjectKey(subjectKey) ? normalizePathSubject(value) : escapeGlobSubject(value);
+    }
+  }
+  if (toolName === "bash" && typeof obj.command === "string") {
+    return escapeGlobSubject(obj.command);
+  }
+  if (typeof obj.path === "string") {
+    return normalizePathSubject(obj.path);
+  }
+  if (typeof obj.url === "string") {
+    return escapeGlobSubject(obj.url);
+  }
+  if (typeof obj.name === "string") {
+    return escapeGlobSubject(obj.name);
+  }
+  return void 0;
+}
+
+// src/utils/ulid.ts
+import { randomBytes as randomBytes2 } from "node:crypto";
+var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var ENCODING_LEN = ENCODING.length;
+var TIME_LEN = 10;
+var RANDOM_LEN = 16;
+function encodeTime(now, len) {
+  let mod;
+  let str = "";
+  for (let i = len - 1; i >= 0; i--) {
+    mod = now % ENCODING_LEN;
+    str = ENCODING[mod] + str;
+    now = (now - mod) / ENCODING_LEN;
+  }
+  return str;
+}
+function encodeRandom(len) {
+  const bytes = randomBytes2(len);
+  let str = "";
+  for (let i = 0; i < len; i++) {
+    str += ENCODING[bytes[i] % ENCODING_LEN];
+  }
+  return str;
+}
+function ulid(seedTime = Date.now()) {
+  return encodeTime(seedTime, TIME_LEN) + encodeRandom(RANDOM_LEN);
+}
+function isUlid(value) {
+  if (value.length !== TIME_LEN + RANDOM_LEN) return false;
+  for (const ch of value) {
+    if (!ENCODING.includes(ch)) return false;
+  }
+  return true;
+}
+
 // src/utils/wstack-paths.ts
 import { createHash } from "node:crypto";
-import * as fs3 from "node:fs";
+import * as fs4 from "node:fs";
 import * as os from "node:os";
-import * as path4 from "node:path";
+import * as path5 from "node:path";
 function canonicalProjectRoot(absRoot) {
-  const checkoutRoot = path4.resolve(absRoot);
-  const dotGit = path4.join(checkoutRoot, ".git");
+  const checkoutRoot = path5.resolve(absRoot);
+  const dotGit = path5.join(checkoutRoot, ".git");
   try {
-    if (!fs3.statSync(dotGit).isFile()) return checkoutRoot;
-    const gitDirLine = fs3.readFileSync(dotGit, "utf8").trim();
+    if (!fs4.statSync(dotGit).isFile()) return checkoutRoot;
+    const gitDirLine = fs4.readFileSync(dotGit, "utf8").trim();
     const match = /^gitdir:\s*(.+)$/i.exec(gitDirLine);
     if (!match?.[1]) return checkoutRoot;
-    const gitDir = path4.resolve(checkoutRoot, match[1].trim());
-    const commonDirFile = path4.join(gitDir, "commondir");
-    if (!fs3.statSync(commonDirFile).isFile()) return checkoutRoot;
-    const commonDir = path4.resolve(gitDir, fs3.readFileSync(commonDirFile, "utf8").trim());
-    if (path4.basename(commonDir).toLowerCase() !== ".git") return checkoutRoot;
-    return path4.dirname(commonDir);
+    const gitDir = path5.resolve(checkoutRoot, match[1].trim());
+    const commonDirFile = path5.join(gitDir, "commondir");
+    if (!fs4.statSync(commonDirFile).isFile()) return checkoutRoot;
+    const commonDir = path5.resolve(gitDir, fs4.readFileSync(commonDirFile, "utf8").trim());
+    if (path5.basename(commonDir).toLowerCase() !== ".git") return checkoutRoot;
+    return path5.dirname(commonDir);
   } catch {
     return checkoutRoot;
   }
@@ -3728,7 +3848,7 @@ function projectHash(absRoot) {
 }
 function projectSlug(absRoot) {
   const identityRoot = canonicalProjectRoot(absRoot);
-  const base = slugify2(path4.basename(identityRoot));
+  const base = slugify2(path5.basename(identityRoot));
   const hash = createHash("sha256").update(identityRoot).digest("hex").slice(0, 6);
   return `${base}-${hash}`;
 }
@@ -3737,61 +3857,83 @@ function slugify2(name) {
 }
 function wstackGlobalRoot() {
   const fromEnv = process.env["WRONGSTACK_HOME"];
-  if (fromEnv && fromEnv.trim().length > 0) return path4.resolve(fromEnv);
-  return path4.join(os.homedir(), ".wrongstack");
+  if (fromEnv && fromEnv.trim().length > 0) return path5.resolve(fromEnv);
+  return path5.join(os.homedir(), ".wrongstack");
 }
 function resolveWstackPaths(opts) {
-  const globalRoot = opts.globalRoot ?? (opts.userHome ? path4.join(opts.userHome, ".wrongstack") : wstackGlobalRoot());
+  const globalRoot = opts.globalRoot ?? (opts.userHome ? path5.join(opts.userHome, ".wrongstack") : wstackGlobalRoot());
   const homeDir = opts.userHome ?? os.homedir();
   const hash = projectHash(opts.projectRoot);
   const slug = projectSlug(opts.projectRoot);
-  const projectDir = path4.join(globalRoot, "projects", slug);
+  const projectDir = path5.join(globalRoot, "projects", slug);
   return {
     globalRoot,
     projectRoot: opts.projectRoot,
     homeDir,
     configDir: globalRoot,
-    globalConfig: path4.join(globalRoot, "config.json"),
-    secretsKey: path4.join(globalRoot, ".key"),
-    globalMemory: path4.join(globalRoot, "memory.md"),
-    globalSkills: path4.join(globalRoot, "skills"),
-    globalClaudeSkills: path4.join(homeDir, ".claude", "skills"),
-    globalDesignKits: path4.join(globalRoot, "design-kits"),
-    globalPrompts: path4.join(globalRoot, "prompts"),
-    globalInstructions: path4.join(globalRoot, "instructions"),
-    promptUsage: path4.join(globalRoot, "prompt-usage.json"),
-    cacheDir: path4.join(globalRoot, "cache"),
-    modelsCache: path4.join(globalRoot, "cache", "models.dev.json"),
-    modelsOverlayCache: path4.join(globalRoot, "cache", "models-overlay.json"),
-    historyFile: path4.join(globalRoot, "history"),
-    logFile: path4.join(globalRoot, "logs", "wrongstack.log"),
+    globalConfig: path5.join(globalRoot, "config.json"),
+    profilesDir: path5.join(globalRoot, "profiles"),
+    profileConfig: (name) => {
+      const safe = name.replace(/[/\\:]/g, "_").replace(/\.\./g, "_");
+      return path5.join(globalRoot, "profiles", safe || "default", "config.json");
+    },
+    profileStatuslineConfig: (name) => {
+      const safe = name.replace(/[/\\:]/g, "_").replace(/\.\./g, "_");
+      return path5.join(globalRoot, "profiles", safe || "default", "statusline.json");
+    },
+    profileModeConfig: (name) => {
+      const safe = name.replace(/[/\\:]/g, "_").replace(/\.\./g, "_");
+      return path5.join(globalRoot, "profiles", safe || "default", "mode.json");
+    },
+    profileProviderStatus: (name) => {
+      const safe = name.replace(/[/\\:]/g, "_").replace(/\.\./g, "_");
+      return path5.join(globalRoot, "profiles", safe || "default", "provider-status.json");
+    },
+    profileUpdateCache: (name) => {
+      const safe = name.replace(/[/\\:]/g, "_").replace(/\.\./g, "_");
+      return path5.join(globalRoot, "profiles", safe || "default", "update-cache.json");
+    },
+    secretsKey: path5.join(globalRoot, ".key"),
+    globalMemory: path5.join(globalRoot, "memory.md"),
+    globalSkills: path5.join(globalRoot, "skills"),
+    globalClaudeSkills: path5.join(homeDir, ".claude", "skills"),
+    globalDesignKits: path5.join(globalRoot, "design-kits"),
+    globalPrompts: path5.join(globalRoot, "prompts"),
+    globalInstructions: path5.join(globalRoot, "instructions"),
+    promptUsage: path5.join(globalRoot, "prompt-usage.json"),
+    cacheDir: path5.join(globalRoot, "cache"),
+    modelsCache: path5.join(globalRoot, "cache", "models.dev.json"),
+    modelsOverlayCache: path5.join(globalRoot, "cache", "models-overlay.json"),
+    historyFile: path5.join(globalRoot, "history"),
+    logFile: path5.join(globalRoot, "logs", "wrongstack.log"),
     projectDir,
-    projectCodebaseIndex: path4.join(projectDir, "codebase-index"),
-    projectMemory: path4.join(projectDir, "memory.md"),
-    projectSessions: path4.join(projectDir, "sessions"),
-    projectTrust: path4.join(projectDir, "trust.json"),
-    projectMeta: path4.join(projectDir, "meta.json"),
-    projectLocalConfig: path4.join(projectDir, "config.local.json"),
-    inProjectConfig: path4.join(opts.projectRoot, ".wrongstack", "config.json"),
-    inProjectAgentsFile: path4.join(opts.projectRoot, ".wrongstack", "AGENTS.md"),
-    inProjectSkills: path4.join(opts.projectRoot, ".wrongstack", "skills"),
-    inProjectClaudeSkills: path4.join(opts.projectRoot, ".claude", "skills"),
-    inProjectPrompts: path4.join(opts.projectRoot, ".wrongstack", "prompts"),
-    inProjectInstructions: path4.join(opts.projectRoot, ".wrongstack", "instructions"),
-    inProjectDesignKits: path4.join(opts.projectRoot, ".wrongstack", "design-kits"),
-    inProjectWorktrees: path4.join(opts.projectRoot, ".wrongstack", "worktrees"),
+    projectCodebaseIndex: path5.join(projectDir, "codebase-index"),
+    projectMemory: path5.join(projectDir, "memory.md"),
+    projectSessions: path5.join(projectDir, "sessions"),
+    projectTrust: path5.join(projectDir, "trust.json"),
+    projectMeta: path5.join(projectDir, "meta.json"),
+    projectLocalConfig: path5.join(projectDir, "config.local.json"),
+    inProjectConfig: path5.join(opts.projectRoot, ".wrongstack", "config.json"),
+    inProjectAgentsFile: path5.join(opts.projectRoot, ".wrongstack", "AGENTS.md"),
+    inProjectSkills: path5.join(opts.projectRoot, ".wrongstack", "skills"),
+    inProjectClaudeSkills: path5.join(opts.projectRoot, ".claude", "skills"),
+    inProjectPrompts: path5.join(opts.projectRoot, ".wrongstack", "prompts"),
+    inProjectInstructions: path5.join(opts.projectRoot, ".wrongstack", "instructions"),
+    inProjectDesignKits: path5.join(opts.projectRoot, ".wrongstack", "design-kits"),
+    inProjectWorktrees: path5.join(opts.projectRoot, ".wrongstack", "worktrees"),
     projectHash: hash,
     projectSlug: slug,
-    projectGoal: path4.join(projectDir, "goal.json"),
-    projectInputHistory: path4.join(projectDir, "input-history.json"),
-    projectSpecs: path4.join(projectDir, "specs"),
-    projectTaskGraphs: path4.join(projectDir, "task-graphs"),
-    projectSddSession: path4.join(projectDir, "sdd-session.json"),
-    projectPlan: path4.join(projectDir, "plan.json"),
-    projectAutophase: path4.join(projectDir, "autophase"),
-    projectSddBoards: path4.join(projectDir, "sdd-boards"),
-    syncConfig: path4.join(globalRoot, "sync.json"),
-    projectStatus: (projectHash2) => path4.join(globalRoot, "projects", projectHash2, "status.json")
+    projectGoal: path5.join(projectDir, "goal.json"),
+    projectInputHistory: path5.join(projectDir, "input-history.json"),
+    projectSpecs: path5.join(projectDir, "specs"),
+    projectTaskGraphs: path5.join(projectDir, "task-graphs"),
+    projectSddSession: path5.join(projectDir, "sdd-session.json"),
+    projectPlan: path5.join(projectDir, "plan.json"),
+    projectAutophase: path5.join(projectDir, "autophase"),
+    projectSddBoards: path5.join(projectDir, "sdd-boards"),
+    syncConfig: path5.join(globalRoot, "sync.json"),
+    configHistoryDir: path5.join(globalRoot, "config-history"),
+    projectStatus: (projectHash2) => path5.join(globalRoot, "projects", projectHash2, "status.json")
   };
 }
 export {
@@ -3810,6 +3952,7 @@ export {
   assertNever,
   assertNotPrivateHost,
   atomicWrite,
+  backupConfigFile,
   buildChildEnv,
   buildCompletedWorkLedgerBlock,
   buildContextEvidenceDigest,
@@ -3826,6 +3969,7 @@ export {
   completePartialObject,
   computeMessageTokens,
   computeTaskItemProgress,
+  configHistoryDir,
   configureChildEnvGitIdentity,
   createContextEvidenceState,
   createToolOutputSerializer,
@@ -3853,6 +3997,7 @@ export {
   getJsonPath,
   getToolDescriptionMode,
   getToolResultRenderMode,
+  hasMeaningfulContent,
   hasOpenTodos,
   isJsonObject,
   isPathSubjectKey,
@@ -3870,6 +4015,7 @@ export {
   normalizeToLf,
   normalizeToolDescriptionMode,
   normalizeToolResultRenderMode,
+  normalizeTopLevelToolSchema,
   parseIncomingImages,
   projectHash,
   projectSlug,