@qduc/term2 0.14.0 → 0.16.0

package/dist/utils/error-helpers.js

@@ -52,6 +52,13 @@ export const describeError = (error) => {
     if (isUndiciSocketCloseError(error)) {
         return 'connection closed by server mid-response';
     }
+    // The SDK wraps anything the fetch impl throws in a generic connection
+    // error, so the wrapper's message would hide the one sentence that tells the
+    // user how to fix this.
+    const reauthentication = findReauthenticationRequiredError(error);
+    if (reauthentication) {
+        return reauthentication.message;
+    }
     const messages = collectErrorMessages(error);
     if (messages.length === 0) {
         if (typeof error === 'object' && error !== null) {
@@ -112,4 +119,5 @@ export const isAbortLikeError = (error) => {
     return abortPatterns.some((pattern) => pattern.test(errorMessage));
 };
 import { isUndiciSocketCloseError } from '../services/retry/retry-error-classification.js';
+import { findReauthenticationRequiredError } from '../providers/common/provider-errors.js';
 //# sourceMappingURL=error-helpers.js.map

package/dist/utils/error-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-helpers.js","sourceRoot":"","sources":["../../source/utils/error-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-helpers.js","sourceRoot":"","sources":["../../source/utils/error-helpers.ts"],"names":[],"mappings":"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"}

package/dist/utils/inject-warning-into-tool-output.d.ts

@@ -1,8 +1,30 @@
+import type { RunBudgetEvidence } from '../services/agent-runtime/run-budget.js';
 export declare function buildTurnLimitWarning(turnsLeft: number): string;
 export interface TurnLimitContext {
     turnCount?: number;
     maxTurns?: number;
 }
+/** The run-loop budget context a tool wrapper can use without knowing budget state. */
+export interface RunBudgetWarningContext {
+    readonly budget?: {
+        takeSoftEvidence?: () => RunBudgetEvidence | undefined;
+        takeStallEvidence?: () => RunBudgetStallEvidence | undefined;
+    };
+}
+export interface RunBudgetStallEvidence {
+    readonly toolName: string;
+    readonly count: number;
+    readonly threshold: number;
+}
+/**
+ * State the repetition as a fact and stop there.
+ *
+ * A red test rerun between edits looks identical to a stall from outside, so
+ * this must not tell the model it is stuck or what to do instead. The run has
+ * the context to decide whether the repetition means anything.
+ */
+export declare function buildToolStallWarning(evidence: RunBudgetStallEvidence): string;
+export declare function buildRunBudgetWarning(evidence: RunBudgetEvidence): string;
 /**
  * Reads the turn budget out of whatever context a tool was invoked with.
  *
@@ -14,5 +36,13 @@ export interface TurnLimitContext {
  */
 export declare function resolveTurnLimitContext(toolContext: unknown): TurnLimitContext | undefined;
 export declare function injectTurnLimitWarning(output: string, context: unknown): string;
+/**
+ * Deliver this run's pending budget and stall evidence on one tool result.
+ *
+ * Both are sensation for the run itself, which is the only judge that can act
+ * before the next request. The legacy turn warning remains as a compatibility
+ * fallback for callers not yet on an application-owned run budget.
+ */
+export declare function injectRunBudgetWarning(output: string, context: unknown): string;
 export declare const injectWarningIntoToolOutput: (output: string, warning: string) => string;
 //# sourceMappingURL=inject-warning-into-tool-output.d.ts.map

package/dist/utils/inject-warning-into-tool-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject-warning-into-tool-output.d.ts","sourceRoot":"","sources":["../../source/utils/inject-warning-into-tool-output.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAO1F;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAS/E;AAED,eAAO,MAAM,2BAA2B,WAAY,MAAM,WAAW,MAAM,KAAG,MA8E7E,CAAC"}
+{"version":3,"file":"inject-warning-into-tool-output.d.ts","sourceRoot":"","sources":["../../source/utils/inject-warning-into-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAIjF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,gBAAgB,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAC;QACvD,iBAAiB,CAAC,EAAE,MAAM,sBAAsB,GAAG,SAAS,CAAC;KAC9D,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAE9E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAUzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAO1F;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAS/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAS/E;AAED,eAAO,MAAM,2BAA2B,WAAY,MAAM,WAAW,MAAM,KAAG,MA8E7E,CAAC"}

package/dist/utils/inject-warning-into-tool-output.js

@@ -4,6 +4,25 @@ export function buildTurnLimitWarning(turnsLeft) {
 
 [Warning: You are approaching the maximum turn limit. You have ${turnsLeft} turns left. Please prepare to wrap up your work and provide a situation update message describing what has been completed and what remains to be done.]`;
 }
+/**
+ * State the repetition as a fact and stop there.
+ *
+ * A red test rerun between edits looks identical to a stall from outside, so
+ * this must not tell the model it is stuck or what to do instead. The run has
+ * the context to decide whether the repetition means anything.
+ */
+export function buildToolStallWarning(evidence) {
+    return `\n\n[Note: This is call ${evidence.count} of \`${evidence.toolName}\` with byte-identical arguments, with no file-modifying call in between. If those calls are making progress, carry on; if they are not, change the approach rather than repeating it.]`;
+}
+export function buildRunBudgetWarning(evidence) {
+    const labels = {
+        usd: 'priced USD budget',
+        unpriced_tokens: 'unpriced-token budget',
+        active_time: 'active-time budget',
+        turns: 'turn backstop',
+    };
+    return `\n\n[Warning: The ${labels[evidence.dimension]} is approaching exhaustion (${evidence.headroom} remaining). Please prepare to wrap up your work and provide a situation update describing what has been completed and what remains.]`;
+}
 /**
  * Reads the turn budget out of whatever context a tool was invoked with.
  *
@@ -31,6 +50,26 @@ export function injectTurnLimitWarning(output, context) {
     }
     return output;
 }
+/**
+ * Deliver this run's pending budget and stall evidence on one tool result.
+ *
+ * Both are sensation for the run itself, which is the only judge that can act
+ * before the next request. The legacy turn warning remains as a compatibility
+ * fallback for callers not yet on an application-owned run budget.
+ */
+export function injectRunBudgetWarning(output, context) {
+    const budget = context?.budget;
+    if (!budget)
+        return injectTurnLimitWarning(output, resolveTurnLimitContext(context));
+    let result = output;
+    const stall = budget.takeStallEvidence?.();
+    if (stall)
+        result = injectWarningIntoToolOutput(result, buildToolStallWarning(stall));
+    const evidence = budget.takeSoftEvidence?.();
+    if (evidence)
+        result = injectWarningIntoToolOutput(result, buildRunBudgetWarning(evidence));
+    return result;
+}
 export const injectWarningIntoToolOutput = (output, warning) => {
     if (!output) {
         return warning;

package/dist/utils/inject-warning-into-tool-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-warning-into-tool-output.js","sourceRoot":"","sources":["../../source/utils/inject-warning-into-tool-output.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO;;iEAEwD,SAAS,0JAA0J,CAAC;AACrO,CAAC;AAOD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,MAAM,SAAS,GAAG,WAAkG,CAAC;IACrH,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,CAAC;IAC7B,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,EAAE,OAAO,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,OAAgB;IACrE,MAAM,YAAY,GAAG,OAAuC,CAAC;IAC7D,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,YAAY,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5G,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC;QACjE,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,wBAAwB,EAAE,CAAC;YAC5D,OAAO,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAc,EAAE,OAAe,EAAU,EAAE;IACrF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,MAA2B,EAAW,EAAE;QAC7D,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YACtE,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,GAAY,EAAW,EAAE;QAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,GAAG,OAAO,CAAC;QAClD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,GAA0B,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAElC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,MAA6B,CAAC;YAE1C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;wBAC3G,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACN,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;oBACtD,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBACtD,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;oBACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;wBAC3G,MAAM,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAC5C,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,GAAG,OAAO,CAAC;IAC1B,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"inject-warning-into-tool-output.js","sourceRoot":"","sources":["../../source/utils/inject-warning-into-tool-output.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/bounded-json.d.ts

@@ -0,0 +1,33 @@
+export type SerializedEnvelope<T> = {
+    value: T;
+    serialized: string;
+    charsUsed: number;
+};
+/**
+ * Builds a JSON envelope until its `charsUsed` field equals the full serialized
+ * envelope length, then admits it only when both output limits accept it.
+ */
+export declare function fitSerializedEnvelope<T>(build: (charsUsed: number) => T, { maxChars, maxBytes }: {
+    maxChars: number;
+    maxBytes?: number;
+}): SerializedEnvelope<T> | null;
+/**
+ * Returns the smallest supported JSON failure that fits both output budgets.
+ *
+ * Normal tool errors retain their complete `{ error: { code, message } }`
+ * shape. Callers use this only after that shape fails. At the 44-byte floor it
+ * preserves the public error code without a message. Below that floor no JSON
+ * error object is possible, so the one-byte JSON literal `0` is deliberately
+ * returned rather than throwing or exceeding the outer cap.
+ */
+export declare function boundedJsonFailure({ maxChars, maxBytes, }: {
+    maxChars: number;
+    maxBytes?: number;
+}): string;
+export declare function fitsSerializedText(serialized: string, { maxChars, maxBytes }: {
+    maxChars: number;
+    maxBytes?: number;
+}): boolean;
+/** Returns a UTF-16 slice after moving either boundary inward around a surrogate pair. */
+export declare function safeUtf16Slice(text: string, start: number, end: number): string;
+//# sourceMappingURL=bounded-json.d.ts.map

package/dist/utils/output/bounded-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-json.d.ts","sourceRoot":"","sources":["../../../source/utils/output/bounded-json.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,CAAC,EAC/B,EAAE,QAAQ,EAAE,QAAsC,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAa9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAsC,GACvC,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAIT;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,EAAE,QAAQ,EAAE,QAAsC,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F,OAAO,CAET;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAc/E"}

package/dist/utils/output/bounded-json.js

@@ -0,0 +1,59 @@
+import { resolveToolResultMaxBytes } from './bound-tool-result.js';
+/**
+ * Builds a JSON envelope until its `charsUsed` field equals the full serialized
+ * envelope length, then admits it only when both output limits accept it.
+ */
+export function fitSerializedEnvelope(build, { maxChars, maxBytes = resolveToolResultMaxBytes() }) {
+    let charsUsed = 0;
+    for (let attempt = 0; attempt < 8; attempt++) {
+        const value = build(charsUsed);
+        const serialized = JSON.stringify(value);
+        const measured = serialized.length;
+        if (charsUsed === measured) {
+            if (measured > maxChars || Buffer.byteLength(serialized, 'utf8') > maxBytes)
+                return null;
+            return { value, serialized, charsUsed: measured };
+        }
+        charsUsed = measured;
+    }
+    throw new Error('Serialized envelope character accounting did not converge.');
+}
+/**
+ * Returns the smallest supported JSON failure that fits both output budgets.
+ *
+ * Normal tool errors retain their complete `{ error: { code, message } }`
+ * shape. Callers use this only after that shape fails. At the 44-byte floor it
+ * preserves the public error code without a message. Below that floor no JSON
+ * error object is possible, so the one-byte JSON literal `0` is deliberately
+ * returned rather than throwing or exceeding the outer cap.
+ */
+export function boundedJsonFailure({ maxChars, maxBytes = resolveToolResultMaxBytes(), }) {
+    const minimal = JSON.stringify({ error: { code: 'output_budget_exceeded' } });
+    if (fitsSerializedText(minimal, { maxChars, maxBytes }))
+        return minimal;
+    return maxChars >= 1 && maxBytes >= 1 ? '0' : '';
+}
+export function fitsSerializedText(serialized, { maxChars, maxBytes = resolveToolResultMaxBytes() }) {
+    return serialized.length <= maxChars && Buffer.byteLength(serialized, 'utf8') <= maxBytes;
+}
+/** Returns a UTF-16 slice after moving either boundary inward around a surrogate pair. */
+export function safeUtf16Slice(text, start, end) {
+    let safeStart = Math.max(0, Math.min(text.length, start));
+    let safeEnd = Math.max(safeStart, Math.min(text.length, end));
+    if (safeStart > 0 && isLowSurrogate(text.charCodeAt(safeStart)) && isHighSurrogate(text.charCodeAt(safeStart - 1)))
+        safeStart++;
+    if (safeEnd > 0 &&
+        safeEnd < text.length &&
+        isHighSurrogate(text.charCodeAt(safeEnd - 1)) &&
+        isLowSurrogate(text.charCodeAt(safeEnd)))
+        safeEnd--;
+    safeEnd = Math.max(safeStart, safeEnd);
+    return text.slice(safeStart, safeEnd);
+}
+function isHighSurrogate(value) {
+    return value >= 0xd800 && value <= 0xdbff;
+}
+function isLowSurrogate(value) {
+    return value >= 0xdc00 && value <= 0xdfff;
+}
+//# sourceMappingURL=bounded-json.js.map

package/dist/utils/output/bounded-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-json.js","sourceRoot":"","sources":["../../../source/utils/output/bounded-json.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/output-trim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-trim.d.ts","sourceRoot":"","sources":["../../../source/utils/output/output-trim.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,EAAE,gBAGjC,CAAC;AAcF;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAsD5F"}
+{"version":3,"file":"output-trim.d.ts","sourceRoot":"","sources":["../../../source/utils/output/output-trim.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,EAAE,gBAGjC,CAAC;AAcF;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAqD5F"}

package/dist/utils/output/output-trim.js

@@ -6,9 +6,9 @@ export const DEFAULT_TRIM_CONFIG = {
 /** Current trim configuration (can be modified at runtime) */
 let trimConfig = { ...DEFAULT_TRIM_CONFIG };
 function trimByCharacters(output, maxCharacters, note) {
-    const keepChars = Math.floor(maxCharacters * 0.4);
+    const keepChars = Math.max(0, Math.floor(maxCharacters * 0.4));
     const head = output.slice(0, keepChars);
-    const tail = output.slice(-keepChars);
+    const tail = keepChars > 0 ? output.slice(-keepChars) : '';
     const trimmedChars = output.length - keepChars * 2;
     const noteSuffix = note ? `; ${note}` : '';
     return `${head}\n... [${trimmedChars} characters trimmed${noteSuffix}] ...\n${tail}`;
@@ -45,10 +45,6 @@ export function trimOutput(output, maxLines, maxCharacters) {
     if (!exceedsLines && !exceedsCharacters) {
         return output;
     }
-    // Special case: single very long line that exceeds character limit
-    if (lines.length === 1 && exceedsCharacters) {
-        return trimByCharacters(output, effectiveMaxCharacters);
-    }
     // Calculate how many lines to keep at beginning and end
     // Keep 40% at the beginning, 40% at the end, trim 20% from the middle
     const keepLines = Math.floor(effectiveMaxLines * 0.4);
@@ -63,7 +59,11 @@ export function trimOutput(output, maxLines, maxCharacters) {
     // Ensure we keep at least some lines
     effectiveKeepLines = Math.max(effectiveKeepLines, 10);
     if (lines.length <= effectiveKeepLines * 2) {
-        // Not enough lines to meaningfully trim
+        // Not enough lines to meaningfully trim by lines alone.
+        // If character limit is exceeded, character trimming is still mandatory.
+        if (exceedsCharacters) {
+            return trimByCharacters(output, effectiveMaxCharacters);
+        }
         return output;
     }
     const headLines = lines.slice(0, effectiveKeepLines);

package/dist/utils/output/output-trim.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-trim.js","sourceRoot":"","sources":["../../../source/utils/output/output-trim.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"output-trim.js","sourceRoot":"","sources":["../../../source/utils/output/output-trim.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/text-snippet.d.ts

@@ -0,0 +1,6 @@
+/** Builds a match-centered, surrogate-safe UTF-16 snippet from source text. */
+export declare function matchCenteredSnippet(content: string, terms: string[], maxChars: number): {
+    text: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=text-snippet.d.ts.map

package/dist/utils/output/text-snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-snippet.d.ts","sourceRoot":"","sources":["../../../source/utils/output/text-snippet.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CA2BtC"}

package/dist/utils/output/text-snippet.js

@@ -0,0 +1,106 @@
+import { safeUtf16Slice } from './bounded-json.js';
+/** Builds a match-centered, surrogate-safe UTF-16 snippet from source text. */
+export function matchCenteredSnippet(content, terms, maxChars) {
+    const limit = Number.isFinite(maxChars) ? Math.max(0, Math.floor(maxChars)) : 0;
+    const match = earliestMatch(content, terms);
+    if (content.length <= limit)
+        return { text: content, truncated: false };
+    if (!match)
+        return prefixSnippet(content, limit);
+    if (limit === 0)
+        return { text: '', truncated: true };
+    if (limit === 1)
+        return { text: '…', truncated: true };
+    let hasPrefix = true;
+    let hasSuffix = true;
+    for (let attempt = 0; attempt < 4; attempt++) {
+        const sourceBudget = limit - Number(hasPrefix) - Number(hasSuffix);
+        const center = Math.floor((match.start + match.end) / 2);
+        const start = Math.max(0, Math.min(content.length - sourceBudget, center - Math.floor(sourceBudget / 2)));
+        const end = Math.min(content.length, start + sourceBudget);
+        const range = safeRange(content, start, end);
+        const nextHasPrefix = range.start > 0;
+        const nextHasSuffix = range.end < content.length;
+        if (nextHasPrefix === hasPrefix && nextHasSuffix === hasSuffix)
+            return {
+                text: `${nextHasPrefix ? '…' : ''}${content.slice(range.start, range.end)}${nextHasSuffix ? '…' : ''}`,
+                truncated: true,
+            };
+        hasPrefix = nextHasPrefix;
+        hasSuffix = nextHasSuffix;
+    }
+    return prefixSnippet(content, limit);
+}
+function earliestMatch(content, terms) {
+    const lowered = content.toLowerCase();
+    const boundaries = lowerCaseBoundaries(content, lowered);
+    let best;
+    for (let termOrder = 0; termOrder < terms.length; termOrder++) {
+        const term = terms[termOrder];
+        if (!term)
+            continue;
+        let loweredStart = lowered.indexOf(term);
+        while (loweredStart !== -1) {
+            const source = sourceRangeForLoweredMatch(boundaries, loweredStart, loweredStart + term.length);
+            if (source && (!best || source.start < best.start || (source.start === best.start && termOrder < best.termOrder)))
+                best = { ...source, termOrder };
+            loweredStart = lowered.indexOf(term, loweredStart + 1);
+        }
+    }
+    return best;
+}
+function lowerCaseBoundaries(content, lowered) {
+    const boundaries = [];
+    let sourceStart = 0;
+    let lowerStart = 0;
+    while (sourceStart < content.length) {
+        const sourceEnd = sourceStart +
+            (isHighSurrogate(content.charCodeAt(sourceStart)) && isLowSurrogate(content.charCodeAt(sourceStart + 1)) ? 2 : 1);
+        const lowerEnd = lowerStart + content.slice(sourceStart, sourceEnd).toLowerCase().length;
+        boundaries.push({ sourceStart, sourceEnd, lowerStart, lowerEnd });
+        sourceStart = sourceEnd;
+        lowerStart = lowerEnd;
+    }
+    // Most strings map per code point. Context-sensitive lowercasing is rare,
+    // but prefix lengths keep source positions correct when it does not.
+    if (lowerStart === lowered.length)
+        return boundaries;
+    return boundaries.map((boundary) => ({
+        ...boundary,
+        lowerStart: content.slice(0, boundary.sourceStart).toLowerCase().length,
+        lowerEnd: content.slice(0, boundary.sourceEnd).toLowerCase().length,
+    }));
+}
+function sourceRangeForLoweredMatch(boundaries, lowerStart, lowerEnd) {
+    const first = boundaries.find((boundary) => boundary.lowerEnd > lowerStart);
+    let last;
+    for (let index = boundaries.length - 1; index >= 0; index--) {
+        const boundary = boundaries[index];
+        if (boundary.lowerStart < lowerEnd) {
+            last = boundary;
+            break;
+        }
+    }
+    return first && last ? { start: first.sourceStart, end: last.sourceEnd } : undefined;
+}
+function safeRange(content, start, end) {
+    const text = safeUtf16Slice(content, start, end);
+    const safeStart = start > 0 && isLowSurrogate(content.charCodeAt(start)) && isHighSurrogate(content.charCodeAt(start - 1))
+        ? start + 1
+        : start;
+    return { start: safeStart, end: safeStart + text.length };
+}
+function prefixSnippet(content, limit) {
+    if (limit === 0)
+        return { text: '', truncated: true };
+    if (limit === 1)
+        return { text: '…', truncated: true };
+    return { text: `${safeUtf16Slice(content, 0, limit - 1)}…`, truncated: true };
+}
+function isHighSurrogate(value) {
+    return value >= 0xd800 && value <= 0xdbff;
+}
+function isLowSurrogate(value) {
+    return value >= 0xdc00 && value <= 0xdfff;
+}
+//# sourceMappingURL=text-snippet.js.map

package/dist/utils/output/text-snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-snippet.js","sourceRoot":"","sources":["../../../source/utils/output/text-snippet.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/tty-osc.d.ts

@@ -3,7 +3,7 @@ export type TtyWriter = (data: string) => void;
  * Returns a function that writes a string to the terminal TTY.
  * Prefers process.stdout when it is a TTY; falls back to opening /dev/tty
  * directly so the sequence reaches the terminal even when stdout is redirected
- * (e.g. through the synchronized-output patch or pipe).
+ * (e.g. through a pipe or file redirect).
  */
 export declare function getTtyWriter(): TtyWriter | null;
 /**

package/dist/utils/output/tty-osc.js

@@ -3,7 +3,7 @@ import fs from 'fs';
  * Returns a function that writes a string to the terminal TTY.
  * Prefers process.stdout when it is a TTY; falls back to opening /dev/tty
  * directly so the sequence reaches the terminal even when stdout is redirected
- * (e.g. through the synchronized-output patch or pipe).
+ * (e.g. through a pipe or file redirect).
  */
 export function getTtyWriter() {
     if (process.stdout.isTTY) {

package/dist/utils/resume-list.d.ts

@@ -10,6 +10,8 @@ interface ConversationListEntry {
     provider?: string;
     messageCount?: number;
 }
-export declare function formatResumeList(entries: ConversationListEntry[]): string;
+export declare function formatResumeList(entries: ConversationListEntry[], options?: {
+    resumeCommand?: (id: string) => string;
+}): string;
 export {};
 //# sourceMappingURL=resume-list.d.ts.map

package/dist/utils/resume-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resume-list.d.ts","sourceRoot":"","sources":["../../source/utils/resume-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4DAA4D,CAAC;AAE/F,UAAU,qBAAqB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM,CA0DzE"}
+{"version":3,"file":"resume-list.d.ts","sourceRoot":"","sources":["../../source/utils/resume-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4DAA4D,CAAC;AAE/F,UAAU,qBAAqB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,qBAAqB,EAAE,EAChC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;CAAO,GACvD,MAAM,CA4DR"}

package/dist/utils/resume-list.js

@@ -13,7 +13,7 @@ function getActiveMode(appMode) {
         return 'mentor';
     return 'standard';
 }
-export function formatResumeList(entries) {
+export function formatResumeList(entries, options = {}) {
     if (entries.length === 0) {
         return 'No saved conversations found.';
     }
@@ -59,7 +59,8 @@ export function formatResumeList(entries) {
             const truncated = entry.firstUserMessage.length > 60 ? entry.firstUserMessage.slice(0, 57) + '...' : entry.firstUserMessage;
             lines.push(`   Prompt:  ${chalk.italic(`"${truncated.replace(/\n/g, ' ')}"`)}`);
         }
-        const resumeCmd = getResumeCommand(entry.id, entry.sshHost, entry.sshHost ? entry.projectPath : undefined);
+        const resumeCmd = options.resumeCommand?.(entry.id) ??
+            getResumeCommand(entry.id, entry.sshHost, entry.sshHost ? entry.projectPath : undefined);
         lines.push(`   Resume:  ${chalk.bold(resumeCmd)}`);
         lines.push('');
     });

package/dist/utils/resume-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"resume-list.js","sourceRoot":"","sources":["../../source/utils/resume-list.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resume-list.js","sourceRoot":"","sources":["../../source/utils/resume-list.ts"],"names":[],"mappings":"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"}

package/dist/utils/settings-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-command.d.ts","sourceRoot":"","sources":["../../source/utils/settings-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAMrG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAqBlD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAkJ3E;AAED,UAAU,yBAAyB;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACxD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACb,EAAE,yBAAyB,GAAG,YAAY,CAsI1C"}
+{"version":3,"file":"settings-command.d.ts","sourceRoot":"","sources":["../../source/utils/settings-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EAEpB,MAAM,0CAA0C,CAAC;AAgClD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAqBlD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAuO3E;AAED,UAAU,yBAAyB;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACxD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACb,EAAE,yBAAyB,GAAG,YAAY,CA2I1C"}