typebulb 0.28.2 → 0.29.0

package/dist/agents/pi/matchu-patchu.ts

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { Type } from "typebox";
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/utils/textUtils.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/textUtils.js
 var TextUtils = class _TextUtils {
   static NormalizeToLf(text) {
     return (text ?? "").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
@@ -103,7 +103,7 @@ var TextUtils = class _TextUtils {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/utils/arrayUtils.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/arrayUtils.js
 var ArrayUtils = class {
   /// <summary>
   /// Groups items by key, preserving first-seen key order (like LINQ's GroupBy).
@@ -141,7 +141,7 @@ var ArrayUtils = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/models.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/models.js
 var PatchInputFile = class {
   Key;
   InputFullText;
@@ -201,12 +201,6 @@ var PatchOutput = class {
   constructor(Files) {
     this.Files = Files;
   }
-  // Patch-scoped errors that belong to no input file: hunks naming files outside
-  // the input set (FileMismatch). Kept off the per-file channel so one foreign
-  // hunk cannot mark otherwise-clean files as failed — per-file Errors are about
-  // that file only. Loudness is preserved: throw-mode still throws these, and
-  // callers composing success replies must consult BOTH channels.
-  Errors = [];
 };
 var LineType;
 (function(LineType2) {
@@ -252,6 +246,11 @@ var Hunk = class {
   // Set by the parser under ControlCharPolicy 'warn' when this hunk's insert
   // lines carried raw control characters.
   ControlCharsSuspected = false;
+  // Error-reporting stand-in Chunk for a hunk that was never anchored: its lines
+  // and diff location, no match.
+  ToUnanchoredChunk() {
+    return new Chunk([], this.Lines.filter((l) => l.Type == LineType.Delete).map((l) => l.Text), this.Lines.filter((l) => l.Type == LineType.Insert).map((l) => l.Text), [], UniqueMatch.NotFound, new DiffLocation(this));
+  }
 };
 var Edit = class _Edit {
   LineIndex;
@@ -370,7 +369,7 @@ var UniqueMatch = class _UniqueMatch {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/utils/yaml.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/yaml.js
 var Yaml = class _Yaml {
   _sb = [];
   // -------- Public API --------
@@ -427,7 +426,7 @@ var Yaml = class _Yaml {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/exceptions.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/exceptions.js
 var PatchException = class extends Error {
   Error;
   constructor(error) {
@@ -443,13 +442,17 @@ var PatchParserException = class extends Error {
 var PatchError = class {
   Type;
   FailedMatch;
-  // For FileMismatch: the foreign file key the hunk group named, so callers can
-  // say WHICH file's hunks were ignored (and match it against their own target).
+  // The file key(s) the error concerns: the foreign key a FileMismatch named, or
+  // the comma-joined candidate keys of an ambiguous headerless routing; null otherwise.
   FileKey;
-  constructor(errorType, chunk, fileKey = null) {
+  // Diagnosis computed against the file at error time (e.g. the quoted line
+  // occurs inside one longer file line); null when no confident diagnosis.
+  Hint;
+  constructor(errorType, chunk, fileKey = null, hint = null) {
     this.Type = errorType;
     this.FailedMatch = chunk;
     this.FileKey = fileKey;
+    this.Hint = hint;
   }
   toString() {
     return `Failed to patch text with the diff provided.
@@ -470,6 +473,8 @@ ${this.SuggestedFixYaml}`;
     if (this.FileKey != null)
       y.Scalar("  File", this.FileKey);
     y.Folded("  Summary", SummaryFor(this.Type));
+    if (this.Hint != null)
+      y.Folded("  Hint", this.Hint);
     y.Section("  Details");
     y.Section("    FailedMatch");
     y.Block("      ContextBefore", this.FailedMatch.ContextBefore);
@@ -483,7 +488,7 @@ ${this.SuggestedFixYaml}`;
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/applier/guards.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/guards.js
 var DuplicateGuard = class _DuplicateGuard {
   // Two chunks that resolve to the same anchor with the same deletes and inserts are
   // provably the same edit (an LLM re-emitting a hunk). Applying it once is
@@ -533,7 +538,7 @@ var OverlapGuard = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/applier/editMinimizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/editMinimizer.js
 var EditMinimizer = class _EditMinimizer {
   static Same(a, b) {
     return a === b;
@@ -567,7 +572,7 @@ var EditMinimizer = class _EditMinimizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/applier/indenter.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/indenter.js
 var Anchor = class {
   BaseIndent;
   Shift;
@@ -658,7 +663,40 @@ var Indenter = class _Indenter {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/applier/chunkApplier.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/matchHint.js
+var MatchHint = class _MatchHint {
+  // A quoted line inside exactly one longer file line is the prose line-model
+  // mistake: the author's "line" (a sentence of an unwrapped paragraph, or a
+  // re-flowed hard wrap) is a slice of the file's physical line. Matching stays
+  // refused — a head fragment is byte-identical to an elided whole-line delete,
+  // so either auto-reading risks silent corruption — but naming the line is
+  // correct under both readings: the retry re-quotes it whole.
+  static SubLine(chunk, lines) {
+    for (const q of chunk.DeleteLinesWithContext()) {
+      if (q.trim().length < _MatchHint.MinHintLineContent)
+        continue;
+      if (lines.includes(q))
+        continue;
+      const containing = [];
+      for (let i = 0; i < lines.length && containing.length < 2; i++)
+        if (lines[i].length > q.length && lines[i].includes(q))
+          containing.push(i);
+      if (containing.length != 1)
+        continue;
+      return `The diff line "${_MatchHint.Preview(q)}" matches only PART of line ${containing[0] + 1}, which is ${lines[containing[0]].length} characters long \u2014 in prose, a whole paragraph is often one physical line. Re-send the diff quoting entire lines exactly.`;
+    }
+    return null;
+  }
+  static Preview(s) {
+    const t = s.trim();
+    return t.length <= 60 ? t : t.slice(0, 57) + "...";
+  }
+  // Trimmed length a quoted line must reach before containment counts as
+  // evidence: short strings occur inside longer lines by coincidence.
+  static MinHintLineContent = 12;
+};
+
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/chunkApplier.js
 var InputChunks = class {
   InputFullText;
   Chunks;
@@ -722,12 +760,12 @@ var ChunkApplier = class _ChunkApplier {
     if (match.IsAmbiguous)
       throw new PatchException(new PatchError("MatchAmbiguous", chunk));
     if (match.IsNotFound)
-      throw new PatchException(new PatchError("MatchNotFound", chunk));
+      throw new PatchException(new PatchError("MatchNotFound", chunk, null, MatchHint.SubLine(chunk, lines)));
     return new Edit(match.LineIndex, Array.from(chunk.DeleteLines), Indenter.AlignInsert(lines, chunk), match.Fuzz);
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/heuristics.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/heuristics.js
 var DiffContentHeuristics = class _DiffContentHeuristics {
   /**
    * Checks if a line starts with a doubled marker (++ or --)
@@ -952,7 +990,7 @@ var DiffContentHeuristics = class _DiffContentHeuristics {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/hunkBuilder.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/hunkBuilder.js
 var Header = class _Header {
   Path;
   OldStart;
@@ -1160,7 +1198,7 @@ ${h.NewText}`;
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/unifiedDiffParser.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/unifiedDiffParser.js
 var UnifiedDiffParser = class _UnifiedDiffParser {
   /**
    * Parse a unified diff into structured hunks.
@@ -1399,7 +1437,7 @@ var UnifiedDiffParser = class _UnifiedDiffParser {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/anchorer/hunkSlicer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/hunkSlicer.js
 var Block = class {
   StartIndex;
   EndIndex;
@@ -1452,7 +1490,7 @@ var HunkSlicer = class _HunkSlicer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/anchorer/search.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/search.js
 var Match = class {
   LineIndex;
   Fuzz;
@@ -1590,7 +1628,7 @@ var Search = class _Search {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/anchorer/blockAnchorer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/blockAnchorer.js
 var BlockAnchorer = class _BlockAnchorer {
   static AnchorBlocks(hunk, blocks, lines, options) {
     return blocks.map((focus, index) => {
@@ -1708,7 +1746,7 @@ var BlockAnchorer = class _BlockAnchorer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/anchorer/hunkAnchorer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/hunkAnchorer.js
 var AnchorOutcome = class {
   Chunks;
   AlreadyAppliedCount;
@@ -1876,7 +1914,7 @@ var HunkAnchorer = class _HunkAnchorer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/selectionTarget.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/selectionTarget.js
 var SelectionTarget = class {
   FullText;
   SelectedText;
@@ -1908,7 +1946,7 @@ var SelectionTarget = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/shared.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/shared.js
 function isDiffMarker(line) {
   return line.startsWith("--- ") || line.startsWith("+++ ") || line.startsWith("@@") || line.startsWith("diff --git");
 }
@@ -1965,7 +2003,7 @@ function isLikelyFileHeader(trimmed) {
   return trimmed.startsWith("diff --git") || (trimmed.startsWith("--- ") || trimmed.startsWith("+++ ")) && (trimmed.includes(".") || trimmed.includes("/") || trimmed.includes("\\"));
 }
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/customFormatSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/customFormatSanitizer.js
 var CustomFormatSanitizer = class _CustomFormatSanitizer {
   static OPERATIONS = [
     { header: /^\s*\*\*\* Update File: (.+)$/i, fromPath: (p) => `a/${p}`, toPath: (p) => `b/${p}` },
@@ -1990,7 +2028,7 @@ var CustomFormatSanitizer = class _CustomFormatSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/decoratedHeaderSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/decoratedHeaderSanitizer.js
 var DecoratedHeaderSanitizer = class _DecoratedHeaderSanitizer {
   static DECORATED_HEADER_REGEX = /^(---|\+\+\+)\s+(.+?)\s+(---|\+\+\+)+\s*$/;
   static process(text) {
@@ -2003,7 +2041,7 @@ var DecoratedHeaderSanitizer = class _DecoratedHeaderSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/decorativeMarkerSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/decorativeMarkerSanitizer.js
 var DecorativeMarkerSanitizer = class _DecorativeMarkerSanitizer {
   static process(text) {
     return transformOutsideHunkBodies(text, (line) => _DecorativeMarkerSanitizer.isDecorativeMarker(line.trim()) ? null : line);
@@ -2024,14 +2062,14 @@ var DecorativeMarkerSanitizer = class _DecorativeMarkerSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/backtickSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/backtickSanitizer.js
 var BacktickSanitizer = class {
   static process(text) {
     return text.replace(/^```+\s*diff\b/gmi, "```diff").replace(/^```+$/gm, "```");
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/diffBlockReunifier.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/diffBlockReunifier.js
 var DiffBlockReunifier = class {
   static process(text) {
     const lines = text.split("\n");
@@ -2067,7 +2105,7 @@ var DiffBlockReunifier = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/devNullSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/devNullSanitizer.js
 var DevNullSanitizer = class {
   static process(text, fileKeys) {
     if (!fileKeys?.length)
@@ -2110,7 +2148,7 @@ var DevNullSanitizer = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/sanitizers/prefixInjector.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/prefixInjector.js
 var PrefixInjector = class {
   static process(text) {
     const lines = text.split("\n");
@@ -2169,7 +2207,7 @@ var PrefixInjector = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/parser/diffSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/diffSanitizer.js
 var DiffSanitizer = class {
   static Process(diff, fileKeys) {
     if (!diff?.trim())
@@ -2185,17 +2223,49 @@ var DiffSanitizer = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.2.0/node_modules/matchu-patchu/dist/patcher.js
-var Patcher = class _Patcher {
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/headerlessRouter.js
+var HeaderlessRouter = class {
+  static Route(fileHunks, files, options) {
+    const group = fileHunks.find((g) => g.Key == "");
+    if (group == null || files.some((f) => f.Key == ""))
+      return [];
+    const probeOptions = Object.assign(new PatchOptions(), options, { ContinueOnError: true });
+    const candidates = files.filter((f) => {
+      const target = new SelectionTarget(f.InputFullText, f.InputSelectedText).TargetText;
+      const anchored = HunkAnchorer.Anchor(target, group.Hunks, probeOptions);
+      return ChunkApplier.Apply(target, anchored.Chunks, probeOptions).Errors.length == 0;
+    });
+    if (candidates.length == 1) {
+      fileHunks.splice(fileHunks.indexOf(group), 1);
+      const existing = fileHunks.find((g) => g.Key == candidates[0].Key);
+      if (existing)
+        existing.Hunks.push(...group.Hunks);
+      else
+        fileHunks.push(new FileHunkGroup(candidates[0].Key, group.Hunks));
+      return [];
+    }
+    return [candidates.length == 0 ? new PatchError("MatchNotFound", group.Hunks[0].ToUnanchoredChunk(), null, "The diff has no file headers and its content did not match any file being patched. Make sure context and deleted lines match the target file, and add '--- <file>' / '+++ <file>' headers naming it.") : new PatchError("MatchAmbiguous", group.Hunks[0].ToUnanchoredChunk(), candidates.map((f) => f.Key).join(", "), "The diff has no file headers and its content matched more than one file being patched. Add '--- <file>' / '+++ <file>' headers naming the intended file.")];
+  }
+};
+
+// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/patcher.js
+var Patcher = class {
   static Apply(diff, files, options) {
     options = options ?? new PatchOptions();
     const fileKeys = files.map((f) => f.Key);
     const fileContents = new Map(files.map((f) => [f.Key, f.InputFullText]));
     diff = options.SanitizeDiff ? DiffSanitizer.Process(diff, fileKeys) : diff;
     const fileHunks = UnifiedDiffParser.Parse(diff, fileContents, options.Truncation, options.ControlChars);
-    const foreignErrors = fileHunks.filter((g) => g.Key != "" && !fileContents.has(g.Key)).map((g) => new PatchError("FileMismatch", _Patcher.ForeignChunk(g.Hunks[0]), g.Key));
-    if (foreignErrors.length > 0 && !options.ContinueOnError)
-      throw new PatchException(foreignErrors[0]);
+    const routingErrors = HeaderlessRouter.Route(fileHunks, files, options);
+    const namedKeys = fileKeys.filter((k) => k != "");
+    const rosterHint = namedKeys.length > 0 ? `Files being patched: ${namedKeys.join(", ")}.` : null;
+    const reportEntry = (key, errors) => new PatchOutputFile(key, 0, [], "", "", "", errors);
+    const reportFiles = fileHunks.filter((g) => g.Key != "" && !fileContents.has(g.Key)).map((g) => reportEntry(g.Key, [new PatchError("FileMismatch", g.Hunks[0].ToUnanchoredChunk(), g.Key, rosterHint)]));
+    if (routingErrors.length > 0)
+      reportFiles.unshift(reportEntry("", routingErrors));
+    const reportErrors = reportFiles.flatMap((f) => f.Errors);
+    if (reportErrors.length > 0 && !options.ContinueOnError)
+      throw new PatchException(reportErrors[0]);
     const patchOutputFiles = files.map((f) => {
       const targetSelection = new SelectionTarget(f.InputFullText, f.InputSelectedText);
       const targetText = targetSelection.TargetText;
@@ -2204,20 +2274,13 @@ var Patcher = class _Patcher {
       const outputEdits = ChunkApplier.Apply(targetText, anchored.Chunks, options);
       return new PatchOutputFile(f.Key, outputEdits.Edits.map((h) => h.Fuzz).reduce((a, b) => a + b, 0), outputEdits.Edits.map((e) => e.Shift(targetSelection.LineOffset)), f.InputSelectedText, f.InputFullText, targetSelection.Replace(outputEdits.OutputText), [...outputEdits.Errors], anchored.AlreadyAppliedCount, hunks.flatMap((h) => h.Lines).filter((l) => l.CollapsedFrom != null).map((l) => l.CollapsedFrom), hunks.some((h) => h.TruncationSuspected), hunks.some((h) => h.ControlCharsSuspected));
     });
-    const output = new PatchOutput(patchOutputFiles);
-    output.Errors = foreignErrors;
-    return output;
-  }
-  // Error-reporting stand-in for a hunk that was never anchored (it names a file
-  // that isn't being patched): its lines and diff location, no match.
-  static ForeignChunk(h) {
-    return new Chunk([], h.Lines.filter((l) => l.Type == LineType.Delete).map((l) => l.Text), h.Lines.filter((l) => l.Type == LineType.Insert).map((l) => l.Text), [], UniqueMatch.NotFound, new DiffLocation(h));
+    return new PatchOutput([...patchOutputFiles, ...reportFiles]);
   }
 };
 
 // cli/agents/pi/server/piPatcherExtension.ts
 var DESCRIPTION = true ? "Apply unified diffs to files \u2014 tolerant of form, strict about intent. Repairs sloppy AI-generated diffs (mangled headers, whitespace drift, missing prefixes; line numbers can be wrong or absent \u2014 hunks anchor by fuzzy-matched context lines) and applies all hunks atomically when the intent is unambiguous; fails with a precise, typed error when it isn't. Use for multi-hunk edits in one step, or when exact string-replacement editing fails on whitespace or invisible characters." : "Apply unified diffs to files.";
-var BUILD_TAG = true ? "matchu-patchu-pi 0.2.0, built 2026-07-16 09:47:20" : "matchu-patchu-pi dev";
+var BUILD_TAG = true ? "matchu-patchu-pi 0.3.1, built 2026-07-17 07:41:42" : "matchu-patchu-pi dev";
 var errorBlocks = (errors) => {
   const parts = [`Patch failed with ${errors.length} error(s):`];
   for (const e of errors) parts.push("", e.toString());
@@ -2227,8 +2290,8 @@ var noOpMessage = (target, alreadyApplied) => alreadyApplied > 0 ? `Applied 0 ed
 var fuzzNote = (fuzz) => fuzz > 0 ? ` (applied with fuzz factor ${fuzz})` : "";
 function discoverDiffKeys(diff) {
   const keys = [];
-  for (const e of Patcher.Apply(diff, []).Errors) {
-    if (e.FileKey && !keys.includes(e.FileKey)) keys.push(e.FileKey);
+  for (const f of Patcher.Apply(diff, []).Files) {
+    if (f.Key && !keys.includes(f.Key)) keys.push(f.Key);
   }
   return keys;
 }
@@ -2256,7 +2319,7 @@ function applyMulti(cwd, diff, dryRun) {
     return { ok: false, message: missing.map((k) => `Error: file not found: ${k}`).join("\n") };
   const inputs = keys.map((k) => new PatchInputFile(k, readFileSync(resolve(cwd, k), "utf-8")));
   const result = Patcher.Apply(diff, inputs);
-  const errors = [...result.Errors, ...result.Files.flatMap((f) => f.Errors)];
+  const errors = result.Files.flatMap((f) => f.Errors);
   if (errors.length > 0) return { ok: false, message: errorBlocks(errors) };
   const lines = [];
   const dryOutputs = [];

package/dist/dts/tbTypings.d.ts

@@ -9,9 +9,9 @@
  * TypeChecker, and the CLI's emitted typecheck dirs.
  */
 /** Typebulb globals available in browser-side code (code.tsx). */
-export declare const clientTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace.\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Async value inspector for tensor-like objects.\n   *\n   * Materializes lazy values (like GPU tensors) and logs them with metadata.\n   * Handles objects with `.js()`, `.data()`, `.array()`, `.arraySync()`, etc.\n   *\n   * @remarks\n   * - Always use `await` - materialization may be async (GPU\u2192CPU readback)\n   * - Large values are truncated (max 1000 elements)\n   * - Promises are logged as `[Promise]` (not awaited - could hang)\n   */\n  dump(...args: any[]): Promise<void>;\n  /**\n   * Trigger inference to generate new insight data.\n   *\n   * Opens a confirmation modal showing the data to be analyzed, then streams\n   * the inference result. On success, updates the insight so subsequent\n   * `tb.insight()` calls return the new value.\n   *\n   * @param opts - Options for inference\n   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.\n   * @returns Promise that resolves with the parsed insight JSON\n   * @throws If inference is already in progress, or on network/parse/rate limit errors\n   */\n  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;\n  /**\n   * Get the current inference state.\n   *\n   * @returns 'idle' | 'running' | 'complete' | 'error'\n   */\n  inferenceState(): 'idle' | 'running' | 'complete' | 'error';\n  /**\n   * Set a data chunk for the next inference call.\n   *\n   * Use this to programmatically set data that will be sent when `tb.infer()` is called\n   * without the `data` option.\n   *\n   * @param index - The chunk index (0-based)\n   * @param content - The content for this chunk\n   */\n  setData(index: number, content: string): void;\n  /**\n   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.\n   *\n   * In the sandbox, prepends `/proxy/` so the URL is served from the same origin.\n   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.\n   *\n   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)\n   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)\n   */\n  proxy(url: string): string;\n  /**\n   * Copy text to clipboard.\n   * Must be called synchronously within a user gesture (click/keydown).\n   * @returns true if successful, false otherwise\n   */\n  copy(text: string): Promise<boolean>;\n  /**\n   * Get the canonical URL of this bulb.\n   *\n   * Returns the parent typebulb.com URL (including path, query, and `#tb=` fragment),\n   * resolving correctly from inside the cross-origin sandbox iframe.\n   * Use this instead of `location.href` or `document.referrer`.\n   *\n   * @returns The full canonical URL\n   */\n  url(): Promise<string>;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\n   * `tb.server.log(...)` is a built-in that prints to CLI stdout (falls back to console.log on web).\n   * User exports override built-ins of the same name.\n   *\n   * A normal export is awaited for its result (`await tb.server.fn()`). An `async function*`\n   * export streams: `for await (const chunk of tb.server.gen())`. The call object supports both;\n   * break the `for await` to cancel and tear down the server generator.\n   */\n  server: Record<string, (...args: any[]) => Promise<any> & AsyncIterable<any>>;\n  /**\n   * Subscribe to a value pushed from the terminal via `typebulb send <file> [message]`.\n   *\n   * The dual of `tb.server.log` (data out): a value sent *in* from the CLI, no `--trust` required.\n   * Use it to start expensive work on demand instead of on load \u2014 e.g. `tb.onMessage(() => start())`\n   * \u2014 so hot reloads don't re-trigger it while you edit, and an agent kicks off one run when ready.\n   *\n   * The message is the JSON-parsed value of what `send` was given (or the raw string if it isn't\n   * JSON; `undefined` for a bare `typebulb send <file>`). Returns an unsubscribe function. Inert in\n   * an embedded bulb (no sender) \u2014 the handler is registered but never fires.\n   *\n   * @param handler - Called with each pushed message.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => void): () => void;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Relative paths resolve against the bulb's data folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * The bulb's data folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`.\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\n  /**\n   * The bulb's theme override (`<html data-theme>`).\n   *\n   * - Get: the current override \u2014 `'dark'` | `'light'`, or `undefined` when\n   *   following the OS preference.\n   * - Set `'dark'`/`'light'` to force and persist it (per-bulb); set\n   *   `undefined` to clear the override and follow the OS again.\n   *\n   * Drives `<html data-theme>`, so render off `html[data-theme=\"\u2026\"]` selectors\n   * (or observe the attribute) rather than reading `tb.theme`.\n   */\n  theme: 'light' | 'dark' | undefined;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+export declare const clientTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace.\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Async value inspector for tensor-like objects.\n   *\n   * Materializes lazy values (like GPU tensors) and logs them with metadata.\n   * Handles objects with `.js()`, `.data()`, `.array()`, `.arraySync()`, etc.\n   *\n   * @remarks\n   * - Always use `await` - materialization may be async (GPU\u2192CPU readback)\n   * - Large values are truncated (max 1000 elements)\n   * - Promises are logged as `[Promise]` (not awaited - could hang)\n   */\n  dump(...args: any[]): Promise<void>;\n  /**\n   * Trigger inference to generate new insight data.\n   *\n   * Opens a confirmation modal showing the data to be analyzed, then streams\n   * the inference result. On success, updates the insight so subsequent\n   * `tb.insight()` calls return the new value.\n   *\n   * @param opts - Options for inference\n   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.\n   * @returns Promise that resolves with the parsed insight JSON\n   * @throws If inference is already in progress, or on network/parse/rate limit errors\n   */\n  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;\n  /**\n   * Get the current inference state.\n   *\n   * @returns 'idle' | 'running' | 'complete' | 'error'\n   */\n  inferenceState(): 'idle' | 'running' | 'complete' | 'error';\n  /**\n   * Set a data chunk for the next inference call.\n   *\n   * Use this to programmatically set data that will be sent when `tb.infer()` is called\n   * without the `data` option.\n   *\n   * @param index - The chunk index (0-based)\n   * @param content - The content for this chunk\n   */\n  setData(index: number, content: string): void;\n  /**\n   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.\n   *\n   * In the sandbox, prepends `/proxy/` so the URL is served from the same origin.\n   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.\n   *\n   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)\n   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)\n   */\n  proxy(url: string): string;\n  /**\n   * Copy text to clipboard.\n   * Must be called synchronously within a user gesture (click/keydown).\n   * @returns true if successful, false otherwise\n   */\n  copy(text: string): Promise<boolean>;\n  /**\n   * Get the canonical URL of this bulb.\n   *\n   * Returns the parent typebulb.com URL (including path, query, and `#tb=` fragment),\n   * resolving correctly from inside the cross-origin sandbox iframe.\n   * Use this instead of `location.href` or `document.referrer`.\n   *\n   * @returns The full canonical URL\n   */\n  url(): Promise<string>;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\n   * `tb.server.log(...)` is a built-in that prints to CLI stdout (falls back to console.log on web).\n   * User exports override built-ins of the same name.\n   *\n   * A normal export is awaited for its result (`await tb.server.fn()`). An `async function*`\n   * export streams: `for await (const chunk of tb.server.gen())`. The call object supports both;\n   * break the `for await` to cancel and tear down the server generator.\n   */\n  server: Record<string, (...args: any[]) => Promise<any> & AsyncIterable<any>>;\n  /**\n   * Subscribe to a value pushed from the terminal via `typebulb send <file> [message]`.\n   *\n   * The dual of `tb.server.log` (data out): a value sent *in* from the CLI, no `--trust` required.\n   * Use it to start expensive work on demand instead of on load \u2014 e.g. `tb.onMessage(() => start())`\n   * \u2014 so hot reloads don't re-trigger it while you edit, and an agent kicks off one run when ready.\n   *\n   * The message is the JSON-parsed value of what `send` was given (or the raw string if it isn't\n   * JSON; `undefined` for a bare `typebulb send <file>`). Returns an unsubscribe function. Inert in\n   * an embedded bulb (no sender) \u2014 the handler is registered but never fires.\n   *\n   * @param handler - Called with each pushed message.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => void): () => void;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Relative paths resolve against the bulb's folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its subfolder when the run is scoped with `--dir`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\n  /**\n   * The bulb's theme override (`<html data-theme>`).\n   *\n   * - Get: the current override \u2014 `'dark'` | `'light'`, or `undefined` when\n   *   following the OS preference.\n   * - Set `'dark'`/`'light'` to force and persist it (per-bulb); set\n   *   `undefined` to clear the override and follow the OS again.\n   *\n   * Drives `<html data-theme>`, so render off `html[data-theme=\"\u2026\"]` selectors\n   * (or observe the attribute) rather than reading `tb.theme`.\n   */\n  theme: 'light' | 'dark' | undefined;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
 /** Typebulb globals available in Node-side code (server.ts).
  *  The AI subset only — server.ts is otherwise plain Node (its own `fs`, `console.log`), so the
  *  browser-only `tb` helpers are intentionally absent here and must match serverTb.ts's runtime surface. */
-export declare const serverTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace (server-side).\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * The bulb's data folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`.\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+export declare const serverTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace (server-side).\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its subfolder when the run is scoped with `--dir`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
 //# sourceMappingURL=tbTypings.d.ts.map

package/dist/dts/tbTypings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6PH,kEAAkE;AAClE,eAAO,MAAM,eAAe,u+VAO3B,CAAA;AAED;;4GAE4G;AAC5G,eAAO,MAAM,eAAe,iuJAO3B,CAAA"}
+{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8PH,kEAAkE;AAClE,eAAO,MAAM,eAAe,0hWAO3B,CAAA;AAED;;4GAE4G;AAC5G,eAAO,MAAM,eAAe,yxJAO3B,CAAA"}

package/dist/dts/tbTypings.js

@@ -126,7 +126,7 @@ const fs = `
   /**
    * Local filesystem access (CLI only).
    *
-   * Relative paths resolve against the bulb's data folder (\`tb.dir\` —
+   * Relative paths resolve against the bulb's folder (\`tb.dir\` —
    * \`<bulb-dir>/<filename-stem>/\`, created on demand), so
    * \`tb.fs.write('results.json')\` lands beside the bulb. \`../\` reaches sibling
    * bulbs' folders; everything stays confined to the project (the launch cwd).
@@ -142,7 +142,8 @@ const fs = `
   };`;
 const dir = `
   /**
-   * The bulb's data folder — absolute path to \`<bulb-dir>/<filename-stem>/\`.
+   * The bulb's folder — absolute path to \`<bulb-dir>/<filename-stem>/\`
+   * (or its subfolder when the run is scoped with \`--dir\`).
    *
    * For interop only (handing a path to \`server.ts\` or a spawned tool):
    * \`tb.fs\` already resolves relative paths against it, so bulb code writing

package/dist/dts/tbTypings.js.map

@@ -1 +1 @@
-{"version":3,"file":"tbTypings.js","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,GAAG;;;;;;;;;;;uCAWmB,CAAA;AAEvC,MAAM,OAAO,GAAG;;;;;;;;;yCASyB,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,SAAS,GAAG;;;;;;;;;;;IAWd,CAAA;AAEJ,oGAAoG;AACpG,MAAM,WAAW,GAAG;;;;;CAKnB,CAAA;AAED,MAAM,EAAE,GAAG;;;;;;;;;OASJ,SAAS;;;;;;;;;;;;;;aAcH,SAAS;KACjB,CAAA;AAEL,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;kCAsBmB,CAAA;AAElC,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;KAiBN,CAAA;AAEL,MAAM,GAAG,GAAG;;;;;;;;wBAQY,CAAA;AAExB,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;0DAewC,CAAA;AAE1D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;iFAYuD,CAAA;AAEjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAErI,CAAA;AAED;;4GAE4G;AAC5G,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI;;CAE5C,CAAA"}
+{"version":3,"file":"tbTypings.js","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,GAAG;;;;;;;;;;;uCAWmB,CAAA;AAEvC,MAAM,OAAO,GAAG;;;;;;;;;yCASyB,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,SAAS,GAAG;;;;;;;;;;;IAWd,CAAA;AAEJ,oGAAoG;AACpG,MAAM,WAAW,GAAG;;;;;CAKnB,CAAA;AAED,MAAM,EAAE,GAAG;;;;;;;;;OASJ,SAAS;;;;;;;;;;;;;;aAcH,SAAS;KACjB,CAAA;AAEL,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;kCAsBmB,CAAA;AAElC,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;KAiBN,CAAA;AAEL,MAAM,GAAG,GAAG;;;;;;;;;wBASY,CAAA;AAExB,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;0DAewC,CAAA;AAE1D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;iFAYuD,CAAA;AAEjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAErI,CAAA;AAED;;4GAE4G;AAC5G,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI;;CAE5C,CAAA"}