@kmugalkhod/lightcode 0.2.0 → 0.4.0

package/cli.js

@@ -124,7 +124,7 @@ var init_logger = __esm(() => {
 });
 
 // packages/shared/src/version.ts
-var lightcodeVersion = "0.2.0";
+var lightcodeVersion = "0.4.0";
 
 // packages/shared/src/index.ts
 var productName = "Lightcode";
@@ -998,7 +998,7 @@ var init_slash_page_menu = __esm(() => {
 });
 
 // packages/ai/src/constants.ts
-var MAX_TOOL_TEXT_OUTPUT_CHARS = 12000, MAX_TOOL_LIST_ENTRIES = 200, MAX_TOOL_SEARCH_RESULTS = 200, ANTHROPIC_TOOL_OPTIONAL_PARAMETER_BUDGET = 24;
+var MAX_TOOL_TEXT_OUTPUT_CHARS = 12000, DEFAULT_TOOL_TEXT_OUTPUT_CHARS = 6000, MAX_TOOL_LIST_ENTRIES = 200, MAX_TOOL_SEARCH_RESULTS = 200, ANTHROPIC_TOOL_OPTIONAL_PARAMETER_BUDGET = 24;
 
 // packages/ai/src/coding-agent-modes.ts
 import { z } from "zod";
@@ -1594,13 +1594,13 @@ var init_base_schemas = __esm(() => {
 
 // packages/ai/src/bash/schema.ts
 import { z as z5 } from "zod";
-var bashDescription = "Run a shell command from workspace root with a timeout. Commands are classified before execution and may require approval.", bashInputSchema, bashProviderInputSchema, bashOutputSchema;
+var bashDescription = "Run a shell command from workspace root with a timeout. Bound noisy output at the source (head/tail/grep/wc, or write to a file then read a range) rather than dumping everything \u2014 output is truncated head+tail and wastes tokens. Commands are classified before execution and may require approval.", bashInputSchema, bashProviderInputSchema, bashOutputSchema;
 var init_schema = __esm(() => {
   init_base_schemas();
   bashInputSchema = z5.object({
     command: z5.string().min(1).max(4000),
     timeoutMs: integerRangeSchema(1000, 120000, "timeoutMs").optional().default(30000),
-    maxOutputChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxOutputChars").optional().default(MAX_TOOL_TEXT_OUTPUT_CHARS)
+    maxOutputChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxOutputChars").optional().default(DEFAULT_TOOL_TEXT_OUTPUT_CHARS)
   });
   bashProviderInputSchema = z5.object({
     command: z5.string().min(1).max(4000)
@@ -1710,7 +1710,7 @@ var init_schema5 = __esm(() => {
     path: boundedPathSchema.optional(),
     staged: z9.boolean().optional().default(false),
     statOnly: z9.boolean().optional().default(false),
-    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(MAX_TOOL_TEXT_OUTPUT_CHARS)
+    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(DEFAULT_TOOL_TEXT_OUTPUT_CHARS)
   });
   gitDiffProviderInputSchema = z9.object({
     path: boundedPathSchema.optional(),
@@ -1725,7 +1725,7 @@ var init_schema5 = __esm(() => {
   gitShowInputSchema = z9.object({
     revision: z9.string().min(1).max(240),
     path: boundedPathSchema.optional(),
-    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(MAX_TOOL_TEXT_OUTPUT_CHARS)
+    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(DEFAULT_TOOL_TEXT_OUTPUT_CHARS)
   });
   gitShowProviderInputSchema = z9.object({
     revision: z9.string().min(1).max(240),
@@ -1822,7 +1822,7 @@ var init_schema6 = __esm(() => {
 
 // packages/ai/src/read-file/schema.ts
 import { z as z11 } from "zod";
-var readFileDescription = "Read file content from the working directory with optional line range limits.", readFileInputSchema, readFileProviderInputSchema, readFileOutputSchema;
+var readFileDescription = "Read file content from the working directory. Prefer a startLine/endLine range to read only the region you need instead of the whole file \u2014 large files are truncated (head+tail) and waste tokens. Raise maxChars only when you truly need more.", readFileInputSchema, readFileProviderInputSchema, readFileOutputSchema;
 var init_schema7 = __esm(() => {
   init_base_schemas();
   readFileInputSchema = z11.object({
@@ -2076,12 +2076,12 @@ var init_schema13 = __esm(() => {
 
 // packages/ai/src/web-fetch/schema.ts
 import { z as z19 } from "zod";
-var webFetchDescription = "Fetch a URL and return normalized, bounded text with source metadata. Requires network permission.", webFetchInputSchema, webFetchProviderInputSchema, webFetchErrorSchema, webFetchOutputSchema;
+var webFetchDescription = "Fetch a URL and return normalized, bounded text with source metadata. Keep maxChars modest and request more only if the answer wasn't in the returned text. Requires network permission.", webFetchInputSchema, webFetchProviderInputSchema, webFetchErrorSchema, webFetchOutputSchema;
 var init_schema14 = __esm(() => {
   init_base_schemas();
   webFetchInputSchema = z19.object({
     url: z19.string().url().max(4096),
-    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(MAX_TOOL_TEXT_OUTPUT_CHARS),
+    maxChars: integerRangeSchema(200, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional().default(DEFAULT_TOOL_TEXT_OUTPUT_CHARS),
     timeoutMs: integerRangeSchema(1000, 30000, "timeoutMs").optional().default(1e4)
   });
   webFetchProviderInputSchema = z19.object({
@@ -2857,11 +2857,11 @@ ${toolCallingDisciplineAddendum}` : "");
 var cwdPromptPlaceholder = "{cwd}", defaultCodingAgentSystemPrompt, toolCallingDisciplineAddendum;
 var init_coding_agent_prompt = __esm(() => {
   init_coding_agent_modes();
-  defaultCodingAgentSystemPrompt = "You are a basic coding agent. Use tools for filesystem and codebase tasks instead of guessing. " + "Respect the user's intent, explain changes clearly, and prefer incremental, auditable actions. " + "You can only interact with files under this working directory: {cwd}. " + "Use glob_search for path discovery, grep for text search, structured git tools for repository inspection, and bash only when dedicated tools are not enough. " + "Use todo_write to keep multi-step implementation work visible and current. " + "For risky or uncertain operations, inspect context first and be explicit about assumptions. " + "While working, emit brief progress notes in natural language before major tool actions and after important findings. " + `Keep them short, human, and concrete. Vary wording naturally and avoid repetitive templates or rigid labels.
+  defaultCodingAgentSystemPrompt = "You are a coding agent. Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under this working directory: {cwd}. " + "Prefer dedicated tools \u2014 glob_search for paths, grep for text search, structured git tools for repository inspection \u2014 and bash only when those are not enough. " + `Use todo_write to keep multi-step work visible and current, inspect context before risky operations, and emit a brief, natural progress note before major tool actions and after important findings.
 
-` + "You are an agent \u2014 keep working until the user's request is fully resolved before ending your turn. " + "Never stop with a partial answer. If you say you will do something, do it in the same turn by calling a tool. " + "Use todo_write to track multi-step work and do not finish while any todo is pending or in_progress. " + `Only end your turn when the task is complete or you are blocked on input that only the user can provide.
+` + `You are an agent \u2014 keep working until the request is fully resolved. Never stop with a partial answer; if you say you will do something, do it in the same turn by calling a tool. Do not finish while any todo is pending or in_progress \u2014 end your turn only when the task is complete or you are blocked on input that only the user can provide.
 
-` + "Long-running processes: never run dev servers, watchers, or other non-exiting commands as plain foreground bash \u2014 " + "the bash tool enforces a timeout and the command will be killed. Start them detached with output redirected to a " + 'log file (e.g. on Windows: start /B cmd /c "npm run dev > dev.log 2>&1"; on Unix: nohup npm run dev > dev.log 2>&1 &), ' + "wait briefly, then verify by reading the log file or with a bounded probe like curl --max-time 5. " + "Dev servers do not always get their default port \u2014 read the actual port from the startup log instead of assuming it. " + "Never kill processes or free ports you did not open yourself; other tools (including this agent's own backend) may be using them.";
+` + "Long-running processes (dev servers, watchers): never run them as plain foreground bash \u2014 the bash tool enforces a timeout and will kill them. Start them detached with output redirected to a log " + '(Windows: start /B cmd /c "npm run dev > dev.log 2>&1"; Unix: nohup npm run dev > dev.log 2>&1 &), then read the log to confirm startup and the actual port (do not assume the default). ' + "Never kill processes or free ports you did not open yourself.";
   toolCallingDisciplineAddendum = "Invoke tools only through the function-calling interface. " + "Never write tool calls as XML or plain text such as <tool_call>, <function_call>, <invoke>, or bare JSON in your message. " + "Tool arguments must be valid JSON matching the tool's schema. " + "Call one tool at a time and wait for its result before deciding the next step.";
 });
 
@@ -3646,6 +3646,10 @@ var init_config3 = __esm(() => {
     preserveRecentMessages: z26.number().int().min(2).max(100).optional(),
     contextWindowOverride: z26.number().int().min(8000).max(1e7).optional(),
     summaryMaxChars: z26.number().int().min(200).max(50000).optional(),
+    aggressivePruneWhenUncached: z26.boolean().optional(),
+    uncachedPruneAtFraction: z26.number().min(0.2).max(0.9).optional(),
+    uncachedPruneMinOutputChars: z26.number().int().min(200).max(12000).optional(),
+    uncachedQuantizeUserTurns: z26.number().int().min(1).max(20).optional(),
     maxInputTokens: z26.number().int().min(1).max(1e7).optional()
   }).strict();
   resolvedContextOptimizerConfigSchema = z26.object({
@@ -3654,15 +3658,23 @@ var init_config3 = __esm(() => {
     pruneAtFraction: z26.number().min(0.2).max(0.9),
     preserveRecentMessages: z26.number().int().min(2).max(100),
     contextWindowOverride: z26.number().int().min(8000).max(1e7).nullable(),
-    summaryMaxChars: z26.number().int().min(200).max(50000)
+    summaryMaxChars: z26.number().int().min(200).max(50000),
+    aggressivePruneWhenUncached: z26.boolean(),
+    uncachedPruneAtFraction: z26.number().min(0.2).max(0.9),
+    uncachedPruneMinOutputChars: z26.number().int().min(200).max(12000),
+    uncachedQuantizeUserTurns: z26.number().int().min(1).max(20)
   });
   defaultContextOptimizerConfig = {
     autoCompact: true,
-    compactAtFraction: 0.8,
+    compactAtFraction: 0.7,
     pruneAtFraction: 0.6,
     preserveRecentMessages: 6,
     contextWindowOverride: null,
-    summaryMaxChars: 4000
+    summaryMaxChars: 4000,
+    aggressivePruneWhenUncached: true,
+    uncachedPruneAtFraction: 0.45,
+    uncachedPruneMinOutputChars: 600,
+    uncachedQuantizeUserTurns: 1
   };
 });
 
@@ -4128,9 +4140,13 @@ function buildProviderView(options) {
   }
   let estimate = estimateContextTokens(providerMessages);
   let tier1 = null;
-  if (estimate.tokens > config.pruneAtFraction * contextWindow) {
+  const uncachedActive = options.cacheActive === false && config.aggressivePruneWhenUncached;
+  const pruneFraction = uncachedActive ? config.uncachedPruneAtFraction : config.pruneAtFraction;
+  if (estimate.tokens > pruneFraction * contextWindow) {
     tier1 = pruneToolOutputs(providerMessages, {
-      preserveRecentMessages: config.preserveRecentMessages
+      preserveRecentMessages: config.preserveRecentMessages,
+      minOutputChars: uncachedActive ? config.uncachedPruneMinOutputChars : undefined,
+      quantizeUserTurns: uncachedActive ? config.uncachedQuantizeUserTurns : undefined
     });
     if (tier1.savedChars > 0) {
       providerMessages = tier1.messages;
@@ -4173,6 +4189,43 @@ var init_build_provider_view = __esm(() => {
   init_tier1_prune();
 });
 
+// packages/ai/src/context/normalize-provider-messages.ts
+import { isToolUIPart } from "ai";
+function hasDanglingToolParts(messages) {
+  return messages.some((message) => message.parts.some((part) => isToolUIPart(part) && !terminalToolStates.has(part.state)));
+}
+function resolveDanglingToolParts(messages, errorText = interruptedToolErrorText) {
+  return messages.map((message) => {
+    if (message.role !== "assistant") {
+      return message;
+    }
+    let changed = false;
+    const parts = message.parts.map((part) => {
+      if (!isToolUIPart(part) || terminalToolStates.has(part.state)) {
+        return part;
+      }
+      changed = true;
+      return {
+        ...part,
+        state: "output-error",
+        errorText
+      };
+    });
+    return changed ? { ...message, parts } : message;
+  });
+}
+function normalizeProviderMessages(messages) {
+  return resolveDanglingToolParts(messages);
+}
+var terminalToolStates, interruptedToolErrorText = "Tool call was interrupted by a connection retry. Re-issue the tool call if it is still needed.";
+var init_normalize_provider_messages = __esm(() => {
+  terminalToolStates = new Set([
+    "output-available",
+    "output-error",
+    "output-denied"
+  ]);
+});
+
 // packages/ai/src/context/index.ts
 var init_context = __esm(() => {
   init_build_provider_view();
@@ -4181,6 +4234,7 @@ var init_context = __esm(() => {
   init_estimate();
   init_heuristic_summary();
   init_message_parts();
+  init_normalize_provider_messages();
   init_tier1_prune();
 });
 
@@ -4276,9 +4330,19 @@ function readEnvConfig(env) {
     contextWindowOverride: parseNumberEnv(env.LIGHTCODE_CONTEXT_WINDOW, "LIGHTCODE_CONTEXT_WINDOW"),
     maxInputTokens: parseNumberEnv(env.LIGHTCODE_CONTEXT_MAX_INPUT_TOKENS, "LIGHTCODE_CONTEXT_MAX_INPUT_TOKENS"),
     preserveRecentMessages: parseNumberEnv(env.LIGHTCODE_CONTEXT_PRESERVE_RECENT_MESSAGES, "LIGHTCODE_CONTEXT_PRESERVE_RECENT_MESSAGES"),
-    summaryMaxChars: parseNumberEnv(env.LIGHTCODE_CONTEXT_SUMMARY_MAX_CHARS, "LIGHTCODE_CONTEXT_SUMMARY_MAX_CHARS")
+    summaryMaxChars: parseNumberEnv(env.LIGHTCODE_CONTEXT_SUMMARY_MAX_CHARS, "LIGHTCODE_CONTEXT_SUMMARY_MAX_CHARS"),
+    aggressivePruneWhenUncached: parseBooleanEnv(env.LIGHTCODE_CONTEXT_AGGRESSIVE_PRUNE_UNCACHED, "LIGHTCODE_CONTEXT_AGGRESSIVE_PRUNE_UNCACHED"),
+    uncachedPruneAtFraction: parseNumberEnv(env.LIGHTCODE_CONTEXT_UNCACHED_PRUNE_AT_FRACTION, "LIGHTCODE_CONTEXT_UNCACHED_PRUNE_AT_FRACTION"),
+    uncachedPruneMinOutputChars: parseNumberEnv(env.LIGHTCODE_CONTEXT_UNCACHED_PRUNE_MIN_OUTPUT_CHARS, "LIGHTCODE_CONTEXT_UNCACHED_PRUNE_MIN_OUTPUT_CHARS"),
+    uncachedQuantizeUserTurns: parseNumberEnv(env.LIGHTCODE_CONTEXT_UNCACHED_QUANTIZE_USER_TURNS, "LIGHTCODE_CONTEXT_UNCACHED_QUANTIZE_USER_TURNS")
   };
   const compactContextConfig = Object.fromEntries(Object.entries(contextConfig).filter(([, value]) => value !== undefined));
+  const headroomConfig = {
+    enabled: parseBooleanEnv(env.LIGHTCODE_HEADROOM_ENABLED, "LIGHTCODE_HEADROOM_ENABLED"),
+    proxyUrl: env.LIGHTCODE_HEADROOM_PROXY_URL?.trim() || undefined,
+    failOpen: parseBooleanEnv(env.LIGHTCODE_HEADROOM_FAIL_OPEN, "LIGHTCODE_HEADROOM_FAIL_OPEN")
+  };
+  const compactHeadroomConfig = Object.fromEntries(Object.entries(headroomConfig).filter(([, value]) => value !== undefined));
   const rawConfig = {
     provider: env.LIGHTCODE_PROVIDER,
     model: env.LIGHTCODE_CHAT_MODEL,
@@ -4288,7 +4352,8 @@ function readEnvConfig(env) {
     maxOutputTokens: parseNumberEnv(env.LIGHTCODE_MAX_OUTPUT_TOKENS, "LIGHTCODE_MAX_OUTPUT_TOKENS"),
     maxSteps: parseNumberEnv(env.LIGHTCODE_MAX_STEPS, "LIGHTCODE_MAX_STEPS"),
     maxRetries: parseNumberEnv(env.LIGHTCODE_MAX_RETRIES, "LIGHTCODE_MAX_RETRIES"),
-    context: Object.keys(compactContextConfig).length > 0 ? compactContextConfig : undefined
+    context: Object.keys(compactContextConfig).length > 0 ? compactContextConfig : undefined,
+    headroom: Object.keys(compactHeadroomConfig).length > 0 ? compactHeadroomConfig : undefined
   };
   const compactConfig = Object.fromEntries(Object.entries(rawConfig).filter(([, value]) => value !== undefined));
   const parsedConfig = lightcodeConfigSchema.safeParse(compactConfig);
@@ -4312,6 +4377,10 @@ function mergeConfig(...configs) {
       ...mergedConfig.autoContinue,
       ...config2.autoContinue
     } : mergedConfig.autoContinue,
+    headroom: config2.headroom ? {
+      ...mergedConfig.headroom,
+      ...config2.headroom
+    } : mergedConfig.headroom,
     allowedTools: config2.allowedTools ?? mergedConfig.allowedTools
   }), {});
 }
@@ -4352,6 +4421,10 @@ function loadLightcodeConfig({
     autoContinue: {
       ...defaultAutoContinueConfig,
       ...mergedConfig.autoContinue
+    },
+    headroom: {
+      ...defaultHeadroomConfig,
+      ...mergedConfig.headroom
     }
   };
   return lightcodeConfigLoadResultSchema.parse({
@@ -4359,7 +4432,7 @@ function loadLightcodeConfig({
     loadedFiles: [userConfig.file, projectConfig.file]
   });
 }
-var lightcodeProviderSchema, autoContinueConfigSchema, resolvedAutoContinueConfigSchema, defaultAutoContinueConfig, lightcodeConfigSchema, lightcodeConfigDefaults, loadedConfigFileSchema, lightcodeResolvedConfigSchema, lightcodeConfigLoadResultSchema, lightcodeConfigStatusSchema, LightcodeConfigError;
+var lightcodeProviderSchema, autoContinueConfigSchema, resolvedAutoContinueConfigSchema, defaultAutoContinueConfig, headroomConfigSchema, resolvedHeadroomConfigSchema, defaultHeadroomConfig, lightcodeConfigSchema, lightcodeConfigDefaults, loadedConfigFileSchema, lightcodeResolvedConfigSchema, lightcodeConfigLoadResultSchema, lightcodeConfigStatusSchema, LightcodeConfigError;
 var init_lightcode_config = __esm(() => {
   init_coding_agent_modes();
   init_coding_agent_modes();
@@ -4391,6 +4464,24 @@ var init_lightcode_config = __esm(() => {
     maxErrorRetries: 5,
     stallTimeoutSeconds: 180
   };
+  headroomConfigSchema = z28.object({
+    enabled: z28.boolean().optional(),
+    proxyUrl: z28.string().min(1).max(4096).optional(),
+    providers: z28.array(lightcodeProviderSchema).optional(),
+    failOpen: z28.boolean().optional()
+  }).strict();
+  resolvedHeadroomConfigSchema = z28.object({
+    enabled: z28.boolean(),
+    proxyUrl: z28.string().min(1).max(4096),
+    providers: z28.array(lightcodeProviderSchema).nullable(),
+    failOpen: z28.boolean()
+  });
+  defaultHeadroomConfig = {
+    enabled: false,
+    proxyUrl: "http://127.0.0.1:8787",
+    providers: null,
+    failOpen: true
+  };
   lightcodeConfigSchema = z28.object({
     provider: lightcodeProviderSchema.optional(),
     model: z28.string().min(1).max(240).optional(),
@@ -4402,10 +4493,11 @@ var init_lightcode_config = __esm(() => {
     sandbox: sandboxConfigSchema.optional(),
     mcp: mcpConfigSchema.optional(),
     context: contextOptimizerConfigSchema.optional(),
-    maxOutputTokens: z28.number().int().min(1).max(200000).optional(),
+    maxOutputTokens: z28.number().int().min(1).max(1e6).optional(),
     maxSteps: z28.number().int().min(1).max(100).optional(),
     maxRetries: z28.number().int().min(0).max(10).optional(),
-    autoContinue: autoContinueConfigSchema.optional()
+    autoContinue: autoContinueConfigSchema.optional(),
+    headroom: headroomConfigSchema.optional()
   }).strict();
   lightcodeConfigDefaults = {
     provider: "anthropic",
@@ -4414,7 +4506,8 @@ var init_lightcode_config = __esm(() => {
     maxOutputTokens: 32768,
     maxSteps: 30,
     maxRetries: 5,
-    autoContinue: defaultAutoContinueConfig
+    autoContinue: defaultAutoContinueConfig,
+    headroom: defaultHeadroomConfig
   };
   loadedConfigFileSchema = z28.object({
     scope: z28.enum(["user", "project"]),
@@ -4426,10 +4519,11 @@ var init_lightcode_config = __esm(() => {
     provider: lightcodeProviderSchema,
     defaultMode: codingAgentModeSchema,
     context: resolvedContextOptimizerConfigSchema,
-    maxOutputTokens: z28.number().int().min(1).max(200000),
+    maxOutputTokens: z28.number().int().min(1).max(1e6),
     maxSteps: z28.number().int().min(1).max(100),
     maxRetries: z28.number().int().min(0).max(10),
-    autoContinue: resolvedAutoContinueConfigSchema
+    autoContinue: resolvedAutoContinueConfigSchema,
+    headroom: resolvedHeadroomConfigSchema.optional()
   });
   lightcodeConfigLoadResultSchema = z28.object({
     config: lightcodeResolvedConfigSchema,
@@ -4443,10 +4537,15 @@ var init_lightcode_config = __esm(() => {
     baseUrl: z28.string().nullable(),
     defaultMode: codingAgentModeSchema,
     permissionMode: permissionModeSchema.nullable(),
-    maxOutputTokens: z28.number().int().min(1).max(200000),
+    maxOutputTokens: z28.number().int().min(1).max(1e6),
     maxSteps: z28.number().int().min(1).max(100),
     autoContinue: resolvedAutoContinueConfigSchema,
     contextWindow: z28.number().int().positive(),
+    headroom: z28.object({
+      enabled: z28.boolean(),
+      proxyUrl: z28.string().nullable(),
+      routed: z28.boolean()
+    }),
     missingCredentialHints: z28.array(z28.string())
   });
   LightcodeConfigError = class LightcodeConfigError extends Error {
@@ -4705,6 +4804,21 @@ var init_runtime = __esm(() => {
   init_schema13();
 });
 
+// packages/ai/src/providers/clamp-output-tokens.ts
+function clampMaxOutputTokens(configured, modelMaxCompletionTokens) {
+  if (typeof modelMaxCompletionTokens === "number" && Number.isFinite(modelMaxCompletionTokens) && modelMaxCompletionTokens > 0) {
+    return Math.min(configured, modelMaxCompletionTokens);
+  }
+  return configured;
+}
+function resolveMaxOutputTokens(configured, defaultValue, modelMaxCompletionTokens) {
+  const hasModelCap = typeof modelMaxCompletionTokens === "number" && Number.isFinite(modelMaxCompletionTokens) && modelMaxCompletionTokens > 0;
+  if (configured === defaultValue) {
+    return hasModelCap ? modelMaxCompletionTokens : configured;
+  }
+  return clampMaxOutputTokens(configured, modelMaxCompletionTokens);
+}
+
 // packages/ai/src/providers/model-metadata.ts
 function getModelContextWindow(provider, modelId) {
   if (provider === "anthropic") {
@@ -5855,19 +5969,29 @@ var init_resolve_within_workspace = __esm(() => {
 });
 
 // packages/ai/src/common/output-utils.ts
-function truncateText(text, maxChars = MAX_TOOL_TEXT_OUTPUT_CHARS) {
+function omissionMarker(omitted) {
+  return `
+
+... [${omitted} characters omitted; re-read a line range with read_file or raise maxChars] ...
+
+`;
+}
+function truncateText(text, maxChars = DEFAULT_TOOL_TEXT_OUTPUT_CHARS) {
   if (text.length <= maxChars) {
     return {
       text,
       truncated: false
     };
   }
-  const suffix = `
-
-... output truncated to ${maxChars} characters ...`;
-  const allowedLength = Math.max(0, maxChars - suffix.length);
+  const markerReserve = omissionMarker(text.length).length;
+  const usable = Math.max(0, maxChars - markerReserve);
+  const headChars = Math.floor(usable * 0.7);
+  const tailChars = usable - headChars;
+  const head = text.slice(0, headChars);
+  const tail = tailChars > 0 ? text.slice(text.length - tailChars) : "";
+  const omitted = text.length - head.length - tail.length;
   return {
-    text: `${text.slice(0, allowedLength)}${suffix}`,
+    text: `${head}${omissionMarker(omitted)}${tail}`,
     truncated: true
   };
 }
@@ -6877,7 +7001,7 @@ async function executeReadFile(input, workspaceContext = getDefaultWorkspaceCont
   const { start, end } = clampLineRange(lines.length, parsedInput.startLine, parsedInput.endLine);
   const selectedContent = lines.slice(start - 1, end).join(`
 `);
-  const maxChars = parsedInput.maxChars ?? MAX_TOOL_TEXT_OUTPUT_CHARS;
+  const maxChars = parsedInput.maxChars ?? DEFAULT_TOOL_TEXT_OUTPUT_CHARS;
   const truncated = truncateText(selectedContent, maxChars);
   return readFileOutputSchema.parse({
     path: relativePath,
@@ -7515,9 +7639,12 @@ __export(exports_runtime, {
   sandboxConfigSchema: () => sandboxConfigSchema,
   safeStringify: () => safeStringify,
   runPluginHooks: () => runPluginHooks,
+  resolvedHeadroomConfigSchema: () => resolvedHeadroomConfigSchema,
   resolvedContextOptimizerConfigSchema: () => resolvedContextOptimizerConfigSchema,
   resolvedAutoContinueConfigSchema: () => resolvedAutoContinueConfigSchema,
   resolveWithinWorkspace: () => resolveWithinWorkspace,
+  resolveMaxOutputTokens: () => resolveMaxOutputTokens,
+  resolveDanglingToolParts: () => resolveDanglingToolParts,
   resolveContextWindowTokens: () => resolveContextWindowTokens,
   resolveCodingPermissionMode: () => resolveCodingPermissionMode,
   requestUserInputToolProviderInputSchema: () => requestUserInputToolProviderInputSchema,
@@ -7547,6 +7674,7 @@ __export(exports_runtime, {
   parseCodingToolInput: () => parseCodingToolInput,
   parseChatStreamError: () => parseChatStreamError,
   normalizeSandboxConfig: () => normalizeSandboxConfig,
+  normalizeProviderMessages: () => normalizeProviderMessages,
   normalizeContextOptimizerConfig: () => normalizeContextOptimizerConfig,
   messageUsageMetadataSchema: () => messageUsageMetadataSchema,
   mcpStdioServerConfigSchema: () => mcpStdioServerConfigSchema,
@@ -7577,7 +7705,10 @@ __export(exports_runtime, {
   isRecord: () => isRecord3,
   isPermissionDeniedError: () => isPermissionDeniedError,
   isElidedToolOutput: () => isElidedToolOutput,
+  interruptedToolErrorText: () => interruptedToolErrorText,
+  headroomConfigSchema: () => headroomConfigSchema,
   hasUnresolvedToolWork: () => hasUnresolvedToolWork,
+  hasDanglingToolParts: () => hasDanglingToolParts,
   getToolNameFromPart: () => getToolNameFromPart,
   getTextPartContent: () => getTextPartContent,
   getSandboxRuntimeStatus: () => getSandboxRuntimeStatus,
@@ -7628,6 +7759,7 @@ __export(exports_runtime, {
   describeChatStreamError: () => describeChatStreamError,
   defaultSubagentTaskMode: () => defaultSubagentTaskMode,
   defaultPermissionModeForCodingMode: () => defaultPermissionModeForCodingMode,
+  defaultHeadroomConfig: () => defaultHeadroomConfig,
   defaultContextOptimizerConfig: () => defaultContextOptimizerConfig,
   defaultCodingAgentSystemPrompt: () => defaultCodingAgentSystemPrompt,
   defaultCodingAgentMode: () => defaultCodingAgentMode,
@@ -7663,6 +7795,7 @@ __export(exports_runtime, {
   codingAgentModeSchema: () => codingAgentModeSchema,
   codingAgentModeOrder: () => codingAgentModeOrder,
   codingAgentCallOptionsSchema: () => codingAgentCallOptionsSchema,
+  clampMaxOutputTokens: () => clampMaxOutputTokens,
   chatInteractionUserPromptPayloadSchema: () => chatInteractionUserPromptPayloadSchema,
   chatInteractionUpsertRequestSchema: () => chatInteractionUpsertRequestSchema,
   chatInteractionToolCallIdSchema: () => chatInteractionToolCallIdSchema,
@@ -8026,7 +8159,7 @@ var init_auto_continue = __esm(() => {
 import { useChat } from "@ai-sdk/react";
 import {
   DefaultChatTransport,
-  isToolUIPart,
+  isToolUIPart as isToolUIPart2,
   lastAssistantMessageIsCompleteWithToolCalls,
   safeValidateUIMessages
 } from "ai";
@@ -8118,30 +8251,38 @@ function queueToolOutput(outputResult) {
     console.warn("Failed to add tool output.", outputError);
   });
 }
-function isIncompleteAssistantMessage(message) {
-  if (message.role !== "assistant") {
-    return false;
-  }
-  if (message.parts.length === 0) {
+function isIncompletePart(part) {
+  if ((part.type === "text" || part.type === "reasoning") && Reflect.get(part, "state") === "streaming") {
     return true;
   }
-  return message.parts.some((part) => {
-    if ((part.type === "text" || part.type === "reasoning") && Reflect.get(part, "state") === "streaming") {
-      return true;
-    }
-    return isToolUIPart(part) && part.state === "input-streaming";
-  });
+  return isToolUIPart2(part) && part.state === "input-streaming";
 }
-function trimIncompleteTrailingAssistantMessages(messages) {
-  let endIndex = messages.length;
-  while (endIndex > 0 && isIncompleteAssistantMessage(messages[endIndex - 1])) {
-    endIndex -= 1;
+function pruneIncompleteTrailingAssistantParts(messages) {
+  let result = messages;
+  while (result.length > 0) {
+    const lastIndex = result.length - 1;
+    const last = result[lastIndex];
+    if (last.role !== "assistant") {
+      break;
+    }
+    const completeParts = last.parts.filter((part) => !isIncompletePart(part));
+    if (completeParts.length === last.parts.length) {
+      break;
+    }
+    if (completeParts.length === 0) {
+      result = result.slice(0, lastIndex);
+      continue;
+    }
+    const next = result.slice();
+    next[lastIndex] = { ...last, parts: completeParts };
+    result = next;
+    break;
   }
-  return endIndex === messages.length ? messages : messages.slice(0, endIndex);
+  return result;
 }
 function hasUnresolvedToolParts(messages) {
   return messages.some((message) => message.parts.some((part) => {
-    if (!isToolUIPart(part)) {
+    if (!isToolUIPart2(part)) {
       return false;
     }
     return ![
@@ -8151,26 +8292,21 @@ function hasUnresolvedToolParts(messages) {
     ].includes(part.state);
   }));
 }
-function sanitizeMessagesForRetry(messages) {
-  const trimmed = trimIncompleteTrailingAssistantMessages(messages);
-  return trimmed.map((message) => {
-    if (message.role !== "assistant") {
-      return message;
-    }
-    let changed = false;
-    const parts = message.parts.map((part) => {
-      if (!isToolUIPart(part) || terminalToolPartStates.has(part.state)) {
-        return part;
+function countCompletedWork(messages) {
+  let total = 0;
+  for (const message of messages) {
+    for (const part of message.parts) {
+      if ((part.type === "text" || part.type === "reasoning") && Reflect.get(part, "state") !== "streaming") {
+        total += 1;
+      } else if (isToolUIPart2(part) && terminalToolPartStates.has(part.state)) {
+        total += 1;
       }
-      changed = true;
-      return {
-        ...part,
-        state: "output-error",
-        errorText: interruptedToolRetryErrorText
-      };
-    });
-    return changed ? { ...message, parts } : message;
-  });
+    }
+  }
+  return total;
+}
+function sanitizeMessagesForRetry(messages) {
+  return resolveDanglingToolParts(pruneIncompleteTrailingAssistantParts(messages));
 }
 function hasActiveClientToolWork({
   messages,
@@ -8180,7 +8316,7 @@ function hasActiveClientToolWork({
   const pendingApprovalIds = new Set(pendingApprovals.map((approval) => approval.toolCallId));
   const pendingPromptIds = new Set(pendingUserPrompts.map((prompt) => prompt.toolCallId));
   return messages.some((message) => message.parts.some((part) => {
-    if (!isToolUIPart(part)) {
+    if (!isToolUIPart2(part)) {
       return false;
     }
     if (part.state === "input-streaming" || part.state === "approval-responded") {
@@ -8308,6 +8444,9 @@ function useCodingSessionChat({
   autoContinueLimitsRef.current = autoContinueLimits;
   const maxErrorRetriesRef = useRef(maxErrorRetries);
   maxErrorRetriesRef.current = maxErrorRetries;
+  const maxNoProgressRetries = maxErrorRetries + 3;
+  const maxNoProgressRetriesRef = useRef(maxNoProgressRetries);
+  maxNoProgressRetriesRef.current = maxNoProgressRetries;
   const stallTimeoutMsRef = useRef(stallTimeoutMs);
   stallTimeoutMsRef.current = stallTimeoutMs;
   const lastStreamActivityRef = useRef(Date.now());
@@ -8316,11 +8455,18 @@ function useCodingSessionChat({
   const errorRetriesRef = useRef(0);
   const errorRetryTimerRef = useRef(null);
   const lastDecidedAssistantIdRef = useRef(null);
+  const lastProgressMarkerRef = useRef(0);
+  const noProgressRetriesRef = useRef(0);
+  const taskStuckRef = useRef(false);
+  const messagesRef = useRef([]);
   const advanceTurnKey = useCallback(() => {
     turnCounterRef.current += 1;
     turnKeyRef.current = `turn-${Date.now()}-${turnCounterRef.current}`;
     autoContinuesRef.current = 0;
     errorRetriesRef.current = 0;
+    lastProgressMarkerRef.current = 0;
+    noProgressRetriesRef.current = 0;
+    taskStuckRef.current = false;
     lastDecidedAssistantIdRef.current = null;
     if (errorRetryTimerRef.current) {
       clearTimeout(errorRetryTimerRef.current);
@@ -8328,6 +8474,20 @@ function useCodingSessionChat({
     }
     setAutoContinueState(null);
   }, []);
+  const registerRetryProgress = useCallback((currentMessages) => {
+    const marker = countCompletedWork(currentMessages);
+    if (marker > lastProgressMarkerRef.current) {
+      lastProgressMarkerRef.current = marker;
+      noProgressRetriesRef.current = 0;
+      return true;
+    }
+    noProgressRetriesRef.current += 1;
+    if (noProgressRetriesRef.current > maxNoProgressRetriesRef.current) {
+      taskStuckRef.current = true;
+      return false;
+    }
+    return true;
+  }, []);
   modeRef.current = mode;
   cwdRef.current = cwd;
   permissionModeRef.current = permissionMode;
@@ -8707,6 +8867,9 @@ function useCodingSessionChat({
       lastStreamActivityRef.current = Date.now();
     }
   }, [messages, status]);
+  useEffect(() => {
+    messagesRef.current = messages;
+  }, [messages]);
   useEffect(() => {
     if (status !== "streaming" && status !== "submitted") {
       return;
@@ -8719,7 +8882,15 @@ function useCodingSessionChat({
       })) {
         return;
       }
-      if (stallRecoveryInFlightRef.current || errorRetriesRef.current >= maxErrorRetriesRef.current) {
+      if (taskStuckRef.current || stallRecoveryInFlightRef.current || errorRetriesRef.current >= maxErrorRetriesRef.current) {
+        return;
+      }
+      if (!registerRetryProgress(messagesRef.current)) {
+        setAutoContinueState({
+          attempt: errorRetriesRef.current,
+          kind: "none",
+          guardTripped: "no-progress"
+        });
         return;
       }
       stallRecoveryInFlightRef.current = true;
@@ -8741,12 +8912,12 @@ function useCodingSessionChat({
       })();
     }, 15000);
     return () => clearInterval(intervalId);
-  }, [clearError, sendMessage, setMessages, status, stop]);
+  }, [clearError, registerRetryProgress, sendMessage, setMessages, status, stop]);
   useEffect(() => {
     if (status !== "ready" || error) {
       return;
     }
-    if (isHistoryLoading || pendingApprovals.length > 0 || pendingUserPrompts.length > 0 || hasUnresolvedToolParts(messages)) {
+    if (taskStuckRef.current || isHistoryLoading || pendingApprovals.length > 0 || pendingUserPrompts.length > 0 || hasUnresolvedToolParts(messages)) {
       return;
     }
     const lastMessage = messages[messages.length - 1];
@@ -8798,7 +8969,7 @@ function useCodingSessionChat({
     if (!error?.message || !isRecoverableChatErrorMessage(error.message)) {
       return;
     }
-    if (pendingApprovals.length > 0 || pendingUserPrompts.length > 0 || errorRetryTimerRef.current || stallRecoveryInFlightRef.current) {
+    if (taskStuckRef.current || pendingApprovals.length > 0 || pendingUserPrompts.length > 0 || errorRetryTimerRef.current || stallRecoveryInFlightRef.current) {
       return;
     }
     if (errorRetriesRef.current >= maxErrorRetriesRef.current) {
@@ -8809,6 +8980,14 @@ function useCodingSessionChat({
     const delay = Math.min(errorRetryBaseDelayMs * 2 ** (attempt - 1), errorRetryMaxDelayMs);
     errorRetryTimerRef.current = setTimeout(() => {
       errorRetryTimerRef.current = null;
+      if (!registerRetryProgress(messagesRef.current)) {
+        setAutoContinueState({
+          attempt: errorRetriesRef.current,
+          kind: "none",
+          guardTripped: "no-progress"
+        });
+        return;
+      }
       errorRetriesRef.current = attempt;
       setAutoContinueState({ attempt, kind: "retry-error" });
       setMessages(retryMessages);
@@ -8828,6 +9007,7 @@ function useCodingSessionChat({
     messages,
     pendingApprovals.length,
     pendingUserPrompts.length,
+    registerRetryProgress,
     sendMessage,
     setMessages
   ]);
@@ -8906,7 +9086,7 @@ function useCodingSessionChat({
         if (cancelled) {
           return;
         }
-        const resumableMessages = restoredApprovals.length === 0 && restoredPrompts.length === 0 ? trimIncompleteTrailingAssistantMessages(validatedMessages) : validatedMessages;
+        const resumableMessages = restoredApprovals.length === 0 && restoredPrompts.length === 0 ? pruneIncompleteTrailingAssistantParts(validatedMessages) : validatedMessages;
         setMessagesRef.current(resumableMessages);
         setPendingApprovals(restoredApprovals);
         setPendingUserPrompts(restoredPrompts);
@@ -9027,7 +9207,7 @@ function useCodingSessionChat({
     isSessionIdValid
   };
 }
-var recoverableDisconnectMessage = "Connection interrupted. Please retry or regenerate your last message.", buildModeAutoPromptResponse = "Proceed with implementation in Build mode. Continue without additional plan questions.", chatMessageUpdateThrottleMs = 50, retryCommandPattern, codingToolNameSet, errorRetryBaseDelayMs = 1000, errorRetryMaxDelayMs = 8000, disconnectErrorPattern, transientProviderErrorPattern, interruptedToolRetryErrorText = "Tool call was interrupted by a connection retry. Re-issue the tool call if it is still needed.", terminalToolPartStates;
+var recoverableDisconnectMessage = "Connection interrupted. Please retry or regenerate your last message.", buildModeAutoPromptResponse = "Proceed with implementation in Build mode. Continue without additional plan questions.", chatMessageUpdateThrottleMs = 50, retryCommandPattern, codingToolNameSet, errorRetryBaseDelayMs = 1000, errorRetryMaxDelayMs = 8000, disconnectErrorPattern, transientProviderErrorPattern, terminalToolPartStates;
 var init_use_coding_session_chat = __esm(() => {
   init_agent_tools();
   init_chat_error();
@@ -9040,6 +9220,7 @@ var init_use_coding_session_chat = __esm(() => {
   init_schema9();
   init_runtime12();
   init_auto_continue();
+  init_normalize_provider_messages();
   retryCommandPattern = /^\/?(retry|regenerate)$/i;
   codingToolNameSet = new Set(Object.keys(codingToolInputSchemas));
   disconnectErrorPattern = /(failed to fetch|networkerror|socket|connection|aborted|terminated|timed?\s?out|timeout|econnreset)/i;
@@ -10156,7 +10337,7 @@ var init_chat_message_tool_invocation_part = __esm(() => {
 });
 
 // apps/cli/src/components/chat/chat-message.tsx
-import { isToolUIPart as isToolUIPart2 } from "ai";
+import { isToolUIPart as isToolUIPart3 } from "ai";
 import { TextAttributes as TextAttributes9 } from "@opentui/core";
 import { jsxDEV as jsxDEV13 } from "@opentui/react/jsx-dev-runtime";
 function ChatMessage({ message, pendingApprovalIds }) {
@@ -10173,7 +10354,7 @@ function ChatMessage({ message, pendingApprovalIds }) {
         part
       }, key, false, undefined, this);
     }
-    if (isToolUIPart2(part)) {
+    if (isToolUIPart3(part)) {
       return /* @__PURE__ */ jsxDEV13(ChatMessageToolInvocationPart, {
         part,
         pendingApprovalIds
@@ -11904,7 +12085,7 @@ function ChatScreen() {
           paddingX: 1,
           children: /* @__PURE__ */ jsxDEV21("text", {
             fg: cliTheme.semantic.warning,
-            children: autoContinueState.guardTripped === "doom-loop" ? "Agent appears stuck repeating itself \u2014 automatic continuation stopped. Send a message to resume." : `Reached the automatic continuation limit (${autoContinueState.attempt}). Send a message to resume.`
+            children: autoContinueState.guardTripped === "doom-loop" ? "Agent appears stuck repeating itself \u2014 automatic continuation stopped. Send a message to resume." : autoContinueState.guardTripped === "no-progress" ? "The connection keeps dropping without making progress \u2014 automatic retry stopped. Send a message to resume." : `Reached the automatic continuation limit (${autoContinueState.attempt}). Send a message to resume.`
           }, undefined, false, undefined, this)
         }, undefined, false, undefined, this) : autoContinueState ? /* @__PURE__ */ jsxDEV21("box", {
           paddingX: 1,