@wrongstack/core 0.77.0 → 0.84.1

package/dist/utils/index.d.ts

@@ -1,19 +1,19 @@
-import { N as TodoItem, M as Message, J as JSONSchema } from '../context-y87Jc5ei.js';
-export { W as WstackPathOptions, a as WstackPaths, p as projectHash, b as projectSlug, r as resolveWstackPaths } from '../wstack-paths-D7evAFWM.js';
-import { M as ModelsDevPayload } from '../models-registry-BcYJDKLm.js';
-import { k as CustomModelDefinition } from '../config-Dy0CK_o6.js';
+import { N as TodoItem, M as Message, J as JSONSchema } from '../context-ToHAp4-U.js';
+export { W as WstackPathOptions, a as WstackPaths, p as projectHash, b as projectSlug, r as resolveWstackPaths } from '../wstack-paths-BQMvEllz.js';
+import { M as ModelsDevPayload } from '../models-registry-Be3osGt5.js';
+import { k as CustomModelDefinition } from '../config-_DZ7dN-T.js';
 
 interface AtomicWriteOptions {
-    mode?: number;
-    encoding?: BufferEncoding;
+    mode?: number | undefined;
+    encoding?: BufferEncoding | undefined;
 }
 declare function atomicWrite(targetPath: string, content: string | Uint8Array, opts?: AtomicWriteOptions): Promise<void>;
 declare function ensureDir(dir: string): Promise<void>;
 
 interface SafeParseResult<T> {
     ok: boolean;
-    value?: T;
-    error?: string;
+    value?: T | undefined;
+    error?: string | undefined;
 }
 declare function safeParse<T = unknown>(input: string, maxBytes?: number): SafeParseResult<T>;
 declare function safeStringify(value: unknown, pretty?: boolean): string;
@@ -116,6 +116,33 @@ declare function onResize(cb: (size: {
  * `if (input.isTTY) input.setRawMode(...)` ceremony at every call site.
  */
 declare function setRawMode(input: NodeJS.ReadStream, mode: boolean): boolean;
+/**
+ * Bracket installed by the interactive input reader while a `readline`
+ * prompt is on screen. Out-of-band terminal writes — logger WARN/INFO
+ * lines, async activity from the Telegram bridge, etc. — go to the same
+ * physical terminal as the half-typed prompt but readline has no idea they
+ * happened, so it never repaints. The result is the classic corruption the
+ * user sees: every async line strands the in-progress draft as a fresh
+ * scrollback row (sometimes with its cursor underline).
+ *
+ * The guard closes that gap. `suspend()` wipes the draft row so the message
+ * prints clean; `resume()` repaints the prompt + draft (cursor preserved).
+ * When no prompt is active the guard is `null` and writes pass straight
+ * through — so agent-turn output (spinner, renderer) is untouched.
+ */
+interface OutputLineGuard {
+    /** Clear the current input row right before an out-of-band write. */
+    suspend(): void;
+    /** Repaint the prompt + in-progress draft right after the write. */
+    resume(): void;
+}
+/**
+ * Register (or clear, with `null`) the guard that brackets out-of-band
+ * writes. Installed by {@link writeOut}/{@link writeErr} consumers — in
+ * practice the CLI's readline input reader — only while a prompt is live.
+ * Idempotent; the most recent caller wins.
+ */
+declare function setOutputLineGuard(guard: OutputLineGuard | null): void;
 /**
  * Write `s` to `stream` (defaults to `process.stdout`). Returns `false`
  * when the stream is missing or doesn't expose `write` so callers can
@@ -175,13 +202,6 @@ declare function writeErr(s: string, stream?: NodeJS.WriteStream): boolean;
  */
 declare function formatTodosList(todos: TodoItem[]): string;
 
-/**
- * Minimal glob matcher for trust patterns.
- * Supports: *, **, ?, character classes [abc], [a-z], negation [!...] or [^...].
- *
- * Compiled regexes are cached so repeated calls with the same pattern
- * avoid recompilation overhead.
- */
 declare function compileGlob(pattern: string): RegExp;
 declare function matchGlob(pattern: string, input: string): boolean;
 declare function matchAny(patterns: string[], input: string): boolean;
@@ -191,9 +211,9 @@ declare function matchAny(patterns: string[], input: string): boolean;
  * Operates on arrays of lines (newline-terminated or stripped).
  */
 interface UnifiedDiffOptions {
-    context?: number;
-    fromFile?: string;
-    toFile?: string;
+    context?: number | undefined;
+    fromFile?: string | undefined;
+    toFile?: string | undefined;
 }
 declare function unifiedDiff(oldText: string, newText: string, opts?: UnifiedDiffOptions): string;
 
@@ -218,9 +238,9 @@ declare function unifiedDiff(oldText: string, newText: string, opts?: UnifiedDif
  */
 interface BuildChildEnvOptions {
     /** Session ID to inject as WRONGSTACK_SESSION_ID. */
-    sessionId?: string;
+    sessionId?: string | undefined;
     /** Additional env vars to merge (takes priority over filtered parent env). */
-    extra?: NodeJS.ProcessEnv;
+    extra?: NodeJS.ProcessEnv | undefined;
 }
 /**
  * Build a filtered child-process environment suitable for bash, exec, and
@@ -229,13 +249,24 @@ interface BuildChildEnvOptions {
  */
 declare function buildChildEnv(optsOrSessionId?: BuildChildEnvOptions | string): NodeJS.ProcessEnv;
 
+/** Resolve a promise after `ms` milliseconds. Prefer this over raw
+ *  `setTimeout` wrappers so all delay sites use a single implementation
+ *  and an abortable variant can be introduced without a codebase-wide hunt. */
+declare function sleep(ms: number): Promise<void>;
+
+/** Assert a value is neither null nor undefined. Throws if it is.
+ *  Useful after optional chaining and indexed access when the
+ *  control flow guarantees the value exists but TypeScript can't
+ *  prove it (e.g. after a check on a related field). */
+declare function expectDefined<T>(value: T | null | undefined): T;
+
 /**
  * Tool output serialization utilities.
  * Extracted from Agent.executeTools to allow reuse and consistent output handling.
  */
 interface ToolOutputSerializerOptions {
-    perIterationOutputCapBytes?: number;
-    estimator?: (text: string) => number;
+    perIterationOutputCapBytes?: number | undefined;
+    estimator?: ((text: string) => number) | undefined;
 }
 declare function createToolOutputSerializer(opts?: ToolOutputSerializerOptions): {
     serialize: (value: unknown) => string;
@@ -246,25 +277,6 @@ declare function createToolOutputSerializer(opts?: ToolOutputSerializerOptions):
     capBytes: number;
 };
 
-/**
- * Shared token estimation with JSON.stringify caching.
- * Avoids repeated stringification of tool input objects.
- *
- * ## Calibration
- *
- * `estimateRequestTokens` uses a fixed 3.5 chars/token heuristic — a
- * conservative overestimate that prevents underestimation but reduces
- * accuracy. After each API call, call `recordActualUsage()` with the
- * real `usage.input` from the provider response. The module maintains a
- * rolling average of `actual / estimated` ratio (EWM, α=0.3) and
- * applies it to subsequent calls via `estimateRequestTokensCalibrated`.
- *
- * Calibration is per-module (shared across all callers), which is
- * sufficient: the chars/token ratio is a property of the tokenizer,
- * not the model. Uncalibrated calls (before any samples, or when
- * `recordActualUsage` is not called) fall back to the uncalibrated
- * estimate so nothing breaks.
- */
 /**
  * Estimate tokens for a tool_use block input.
  * Caches the stringified result keyed by the stable string representation
@@ -286,7 +298,7 @@ declare function estimateTextTokens(text: string): number;
  */
 declare function estimateToolDefTokens(tool: {
     name: string;
-    description?: string;
+    description?: string | undefined;
     inputSchema: unknown;
 }): number;
 /**
@@ -309,7 +321,7 @@ interface RequestTokenBreakdown {
 }
 declare function estimateRequestTokens(messages: unknown, systemPrompt: unknown, tools: {
     name: string;
-    description?: string;
+    description?: string | undefined;
     inputSchema: unknown;
 }[]): RequestTokenBreakdown;
 /**
@@ -345,7 +357,7 @@ declare function getCalibrationState(): {
  */
 declare function estimateRequestTokensCalibrated(messages: unknown, systemPrompt: unknown, tools: {
     name: string;
-    description?: string;
+    description?: string | undefined;
     inputSchema: unknown;
 }[]): RequestTokenBreakdown;
 /**
@@ -489,4 +501,4 @@ declare function mergeModelsPayload(base: ModelsDevPayload, overlay: ModelsDevPa
  */
 declare function mergeCustomModelDefs(providerCustomModels: Record<string, CustomModelDefinition> | undefined, configModels: Record<string, CustomModelDefinition> | undefined): Record<string, CustomModelDefinition> | undefined;
 
-export { type AtomicWriteOptions, type BuildChildEnvOptions, type CompileFail, type CompileResult, type MessageRepairReport, type MessageRepairResult, type NewlineStyle, type RequestTokenBreakdown, type SafeParseResult, type ToolOutputSerializerOptions, type UnifiedDiffOptions, type ValidationError, type ValidationResult, atomicWrite, buildChildEnv, color, compileGlob, compileUserRegex, completePartialObject, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, expandGlob, formatTodosList, getCalibrationState, getTermSize, isInteractive, isStdinTTY, isStdoutTTY, matchAny, matchGlob, mergeCustomModelDefs, mergeModelsPayload, normalizeToLf, onResize, recordActualUsage, repairToolUseAdjacency, resetCalibration, safeParse, safeStringify, sanitizeJsonString, setRawMode, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema, writeErr, writeOut };
+export { type AtomicWriteOptions, type BuildChildEnvOptions, type CompileFail, type CompileResult, type MessageRepairReport, type MessageRepairResult, type NewlineStyle, type OutputLineGuard, type RequestTokenBreakdown, type SafeParseResult, type ToolOutputSerializerOptions, type UnifiedDiffOptions, type ValidationError, type ValidationResult, atomicWrite, buildChildEnv, color, compileGlob, compileUserRegex, completePartialObject, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, expandGlob, expectDefined, formatTodosList, getCalibrationState, getTermSize, isInteractive, isStdinTTY, isStdoutTTY, matchAny, matchGlob, mergeCustomModelDefs, mergeModelsPayload, normalizeToLf, onResize, recordActualUsage, repairToolUseAdjacency, resetCalibration, safeParse, safeStringify, sanitizeJsonString, setOutputLineGuard, setRawMode, sleep, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema, writeErr, writeOut };

package/dist/utils/index.js

@@ -121,7 +121,7 @@ function escapeControlCharsInStrings(s) {
   let inString = false;
   let out = "";
   for (let i = 0; i < s.length; i++) {
-    const c = s[i];
+    const c = s.charAt(i);
     if (c === '"' && (i === 0 || s[i - 1] !== "\\")) {
       inString = !inString;
       out += c;
@@ -159,12 +159,12 @@ function stripSingleLineComments(s) {
   const chars = [];
   let i = 0;
   while (i < s.length) {
-    const c = s[i];
-    if (c === '"' && (i === 0 || s[i - 1] !== "\\")) {
+    const c = s.charAt(i);
+    if (c === '"' && (i === 0 || s.charAt(i - 1) !== "\\")) {
       inString = !inString;
       chars.push(c);
-    } else if (c === "/" && s[i + 1] === "/" && !inString) {
-      while (i < s.length && s[i] !== "\n") i++;
+    } else if (c === "/" && s.charAt(i + 1) === "/" && !inString) {
+      while (i < s.length && s.charAt(i) !== "\n") i++;
     } else {
       chars.push(c);
     }
@@ -244,9 +244,20 @@ function setRawMode(input, mode) {
   input.setRawMode(mode);
   return true;
 }
+var activeOutputGuard = null;
+function setOutputLineGuard(guard) {
+  activeOutputGuard = guard;
+}
 function writeTo(s, stream) {
   if (!stream || typeof stream.write !== "function") return false;
+  const guard = activeOutputGuard;
+  if (!guard) {
+    stream.write(s);
+    return true;
+  }
+  guard.suspend();
   stream.write(s);
+  guard.resume();
   return true;
 }
 function writeOut(s, stream = process.stdout) {
@@ -306,6 +317,12 @@ function formatTodosList(todos) {
 }
 
 // src/utils/glob-match.ts
+function expectDefined(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
 function escapeRegex(s) {
   return s.replace(/[.+^${}()|\\]/g, "\\$&");
 }
@@ -317,7 +334,7 @@ function getCachedGlob(pattern) {
   if (COMPILED_GLOB_CACHE.size >= CACHE_MAX_SIZE) {
     const keys = [...COMPILED_GLOB_CACHE.keys()];
     for (let i = 0; i < Math.floor(CACHE_MAX_SIZE / 4); i++) {
-      COMPILED_GLOB_CACHE.delete(keys[i]);
+      COMPILED_GLOB_CACHE.delete(expectDefined(keys[i]));
     }
   }
   const re = compileGlob(pattern);
@@ -673,6 +690,19 @@ function buildChildEnv(optsOrSessionId) {
   return out;
 }
 
+// src/utils/sleep.ts
+function sleep(ms) {
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
+}
+
+// src/utils/expect-defined.ts
+function expectDefined2(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
+
 // src/utils/tool-output-serializer.ts
 function createToolOutputSerializer(opts = {}) {
   const capBytes = opts.perIterationOutputCapBytes ?? 1e5;
@@ -718,6 +748,12 @@ function createToolOutputSerializer(opts = {}) {
 }
 
 // src/utils/token-estimate.ts
+function expectDefined3(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
 var RoughTokenEstimate = (text, charsPerToken = 3.5) => Math.max(1, Math.ceil(text.length / charsPerToken));
 var _cal = {
   ratio: 1,
@@ -738,7 +774,7 @@ function getCachedEstimate(key, compute) {
   if (ESTIMATE_CACHE.size >= ESTIMATE_CACHE_MAX_SIZE) {
     const keys = [...ESTIMATE_CACHE.keys()];
     for (let i = 0; i < Math.floor(ESTIMATE_CACHE_MAX_SIZE / 4); i++) {
-      ESTIMATE_CACHE.delete(keys[i]);
+      ESTIMATE_CACHE.delete(expectDefined3(keys[i]));
     }
   }
   const estimate = compute();
@@ -851,6 +887,12 @@ function resetCalibration() {
 }
 
 // src/utils/message-invariants.ts
+function expectDefined4(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
 function repairToolUseAdjacency(messages) {
   const removedToolUses = [];
   const removedToolResults = [];
@@ -858,7 +900,7 @@ function repairToolUseAdjacency(messages) {
   let changed = false;
   const out = [];
   for (let i = 0; i < messages.length; i++) {
-    const original = messages[i];
+    const original = expectDefined4(messages[i]);
     let msg = original;
     if (hasToolUse(msg)) {
       const nextIds = toolResultIds(messages[i + 1]);
@@ -1071,6 +1113,12 @@ function compileUserRegex(pattern, flags) {
     };
   }
 }
+function expectDefined5(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
 var GLOB_CHARS = /* @__PURE__ */ new Set(["*", "?", "["]);
 var IS_WINDOWS = process.platform === "win32";
 var SEP = IS_WINDOWS ? "\\" : "/";
@@ -1084,7 +1132,7 @@ function globToRegex(pat) {
   let i = 0;
   let re = "^";
   while (i < pat.length) {
-    const c = pat[i];
+    const c = expectDefined5(pat[i]);
     if (c === "*") {
       if (pat[i + 1] === "*") {
         re += ".*";
@@ -1123,7 +1171,7 @@ function globToRegex(pat) {
 }
 function baseDir(pat) {
   let i = pat.length - 1;
-  while (i >= 0 && !GLOB_CHARS.has(pat[i]) && pat[i] !== SEP && pat[i] !== "/") i--;
+  while (i >= 0 && !GLOB_CHARS.has(expectDefined5(pat[i])) && pat[i] !== SEP && pat[i] !== "/") i--;
   const cut = i >= 0 ? pat.lastIndexOf(SEP, i) : pat.lastIndexOf("/", i);
   return cut < 0 ? "." : pat.slice(0, cut);
 }
@@ -1188,6 +1236,12 @@ async function expandGlob(pattern) {
 }
 
 // src/utils/json-repair.ts
+function expectDefined6(value) {
+  if (value === null || value === void 0) {
+    throw new Error("Expected value to be defined");
+  }
+  return value;
+}
 function completePartialObject(s) {
   if (!s.trim().startsWith("{")) return s;
   if (tryParse(s).ok) return s;
@@ -1199,7 +1253,7 @@ function completePartialObject(s) {
   let contentEnd = 0;
   let stringBraceDepth = 0;
   for (let i = 0; i < s.length; i++) {
-    const ch = s[i];
+    const ch = expectDefined6(s[i]);
     if (inString) {
       contentEnd = i + 1;
       if (escaped) {
@@ -1356,6 +1410,6 @@ function mergeCustomModelDefs(providerCustomModels, configModels) {
   return out;
 }
 
-export { atomicWrite, buildChildEnv, color, compileGlob, compileUserRegex, completePartialObject, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, expandGlob, formatTodosList, getCalibrationState, getTermSize, isInteractive, isStdinTTY, isStdoutTTY, matchAny, matchGlob, mergeCustomModelDefs, mergeModelsPayload, normalizeToLf, onResize, projectHash, projectSlug, recordActualUsage, repairToolUseAdjacency, resetCalibration, resolveWstackPaths, safeParse, safeStringify, sanitizeJsonString, setRawMode, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema, writeErr, writeOut };
+export { atomicWrite, buildChildEnv, color, compileGlob, compileUserRegex, completePartialObject, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateRequestTokens, estimateRequestTokensCalibrated, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, expandGlob, expectDefined2 as expectDefined, formatTodosList, getCalibrationState, getTermSize, isInteractive, isStdinTTY, isStdoutTTY, matchAny, matchGlob, mergeCustomModelDefs, mergeModelsPayload, normalizeToLf, onResize, projectHash, projectSlug, recordActualUsage, repairToolUseAdjacency, resetCalibration, resolveWstackPaths, safeParse, safeStringify, sanitizeJsonString, setOutputLineGuard, setRawMode, sleep, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema, writeErr, writeOut };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map