@kmugalkhod/lightcode 0.18.5 → 0.19.0

package/assets/web/index.html

@@ -7,7 +7,7 @@
     <meta name="theme-color" content="#0B0B0C" />
     <title>Lightcode</title>
     
-  <link rel="stylesheet" crossorigin href="./index-5dh9c5av.css"><script type="module" crossorigin src="./index-89rgdkry.js"></script></head>
+  <link rel="stylesheet" crossorigin href="./index-5dh9c5av.css"><script type="module" crossorigin src="./index-1cpyqcg4.js"></script></head>
   <body>
     <!--
       THESIS: One local coding workspace shared with the CLI; this surface rejects dashboard-card clutter and keeps the project conversation central.

package/cli.js

@@ -124,7 +124,7 @@ var init_logger = __esm(() => {
 });
 
 // packages/shared/src/version.ts
-var lightcodeVersion = "0.18.5";
+var lightcodeVersion = "0.19.0";
 
 // packages/shared/src/index.ts
 var productName = "Lightcode";
@@ -1110,7 +1110,7 @@ var init_route_registry = __esm(() => {
 });
 
 // packages/ai/src/constants.ts
-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, TODO_CONTENT_MAX_CHARS = 200, TODO_ACTIVE_FORM_MAX_CHARS = 80, PROGRESS_NOTE_PRUNE_MIN_CHARS = 200;
+var MAX_TOOL_TEXT_OUTPUT_CHARS = 12000, DEFAULT_TOOL_TEXT_OUTPUT_CHARS = 6000, READ_FILE_OUTPUT_CHARS = 24000, MAX_TOOL_LIST_ENTRIES = 200, MAX_TOOL_SEARCH_RESULTS = 200, ANTHROPIC_TOOL_OPTIONAL_PARAMETER_BUDGET = 24, TODO_CONTENT_MAX_CHARS = 200, TODO_ACTIVE_FORM_MAX_CHARS = 80, PROGRESS_NOTE_PRUNE_MIN_CHARS = 200;
 
 // packages/ai/src/coding-agent-modes.ts
 import { z } from "zod";
@@ -2485,14 +2485,15 @@ var init_schema8 = __esm(() => {
 
 // packages/ai/src/read-file/schema.ts
 import { z as z18 } from "zod";
-var readFileDescription = "Read file content from the working directory. Each call returns about 6,000 characters (roughly 150 lines); longer content is truncated head+tail. Small files: read them whole. Long files: find the spot with grep first, then read a startLine/endLine range of about 100-150 lines around it.", readFileInputSchema, readFileProviderInputSchema, readFileOutputSchema;
+var readFileDescription, readFileInputSchema, readFileProviderInputSchema, readFileOutputSchema;
 var init_schema9 = __esm(() => {
   init_base_schemas();
+  readFileDescription = "Read file content from the working directory. Returns whole lines, up to about 24,000 characters (roughly 600 lines) per call, so read a file in one call instead of in slices. " + "If the file is longer, the result stops at endLine and nextStartLine says where to continue. " + "To inspect one spot in a large file, grep for it first, then read a generous startLine/endLine range around it.";
   readFileInputSchema = z18.object({
     path: boundedPathSchema,
     startLine: positiveLineSchema.optional(),
     endLine: positiveLineSchema.optional(),
-    maxChars: integerRangeSchema(1, MAX_TOOL_TEXT_OUTPUT_CHARS, "maxChars").optional()
+    maxChars: integerRangeSchema(1, READ_FILE_OUTPUT_CHARS, "maxChars").optional()
   }).superRefine((value, ctx) => {
     if (value.startLine !== undefined && value.endLine !== undefined && value.endLine < value.startLine) {
       ctx.addIssue({
@@ -2513,7 +2514,8 @@ var init_schema9 = __esm(() => {
     endLine: z18.number().int().min(1),
     content: z18.string(),
     totalLines: z18.number().int().nonnegative(),
-    truncated: z18.boolean()
+    truncated: z18.boolean(),
+    nextStartLine: z18.number().int().min(1).optional()
   });
 });
 
@@ -2833,7 +2835,7 @@ var init_tool_registry = __esm(() => {
       permissionMode: "read-only",
       execution: "server",
       availability: "git-workspace",
-      activation: "specialized",
+      activation: "core",
       outputPolicy: "artifact-if-large"
     },
     git_diff: {
@@ -2846,7 +2848,7 @@ var init_tool_registry = __esm(() => {
       permissionMode: "read-only",
       execution: "server",
       availability: "git-workspace",
-      activation: "specialized",
+      activation: "core",
       outputPolicy: "artifact-if-large"
     },
     git_log: {
@@ -2859,7 +2861,7 @@ var init_tool_registry = __esm(() => {
       permissionMode: "read-only",
       execution: "server",
       availability: "git-workspace",
-      activation: "specialized",
+      activation: "core",
       outputPolicy: "artifact-if-large"
     },
     git_show: {
@@ -2872,7 +2874,7 @@ var init_tool_registry = __esm(() => {
       permissionMode: "read-only",
       execution: "server",
       availability: "git-workspace",
-      activation: "specialized",
+      activation: "core",
       outputPolicy: "artifact-if-large"
     },
     tool_search: {
@@ -3279,6 +3281,7 @@ var init_agent_tools = __esm(() => {
     contextWindow: z26.number().int().positive().optional(),
     preserveRecentTokens: z26.number().int().nonnegative().optional(),
     originalInputTokens: z26.number().int().nonnegative().optional(),
+    promptCacheActive: z26.boolean().optional(),
     assemblyAbortSignal: z26.custom().optional(),
     turnKey: z26.string().min(1).max(200).optional()
   });
@@ -3608,10 +3611,10 @@ ${environmentContext.trim()}` : "");
 var cwdPromptPlaceholder = "{cwd}", defaultCodingAgentSystemPrompt, toolCallingDisciplineAddendum;
 var init_coding_agent_prompt = __esm(() => {
   init_coding_agent_modes();
-  defaultCodingAgentSystemPrompt = "You are a coding agent working inside the user's project at this working directory: {cwd}. " + 'You can already see the project \u2014 proactively read it. When the user asks you to review, explain, or work on "my code"/"this", inspect the working directory yourself with list_files, glob_search, grep, and read_file; NEVER ask the user to paste or share code that lives in this directory \u2014 open it. ' + "Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under the working directory. " + "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. " + "Gather context efficiently \u2014 every tool round trip costs the user seconds. Locate before you read: use grep or glob_search to find the relevant files and line numbers, then read those regions in generous ranges (about 100-150 lines) instead of many small slices or re-reading the same file. When several reads or searches do not depend on each other, request them together in one step. Skip generated output (dist/, build/, minified bundles, node_modules) unless the task is about it. Stop exploring once you have enough evidence to act or answer. " + "Check the available skill descriptions for every task. When a skill is explicitly named or clearly matches the task, load it with the skill tool before acting and follow its instructions within the user's scope and tool permissions. Skill files may be installed outside the workspace; use the skill tool to read their relative supporting resources. Never claim to have used a skill you have not loaded. " + `Inspect context before risky operations. Progress notes: before a major tool action you may emit ONE short note (one sentence, ~15 words) saying what you are about to do. After a tool returns, mention a finding only if it changes your plan, and state it as fact grounded in what the tool actually returned \u2014 cite the file/line/symbol. NEVER claim you found, changed, or fixed something before a tool result confirms it. Skip notes for routine reads, and do not restate the todo list in prose.
+  defaultCodingAgentSystemPrompt = "You are a coding agent working inside the user's project at this working directory: {cwd}. " + 'You can already see the project \u2014 proactively read it. When the user asks you to review, explain, or work on "my code"/"this", inspect the working directory yourself with list_files, glob_search, grep, and read_file; NEVER ask the user to paste or share code that lives in this directory \u2014 open it. ' + "Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under the working directory. " + "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. " + "Gather context efficiently \u2014 every tool round trip costs the user seconds. The environment section maps the repository's files: use it to go straight to the right paths instead of listing directories. Locate before you read: use grep or glob_search to find the relevant files and line numbers, then read whole files (read_file returns up to about 600 lines per call) or, in larger files, a range of a few hundred lines around the spot \u2014 never many small slices, and never re-read content you already have. When several reads or searches do not depend on each other, request them together in one step. Skip generated output (dist/, build/, minified bundles, node_modules) unless the task is about it. Stop exploring once you have enough evidence to act or answer. " + "Check the available skill descriptions for every task. When a skill is explicitly named or clearly matches the task, load it with the skill tool before acting and follow its instructions within the user's scope and tool permissions. Skill files may be installed outside the workspace; use the skill tool to read their relative supporting resources. Never claim to have used a skill you have not loaded. " + `Inspect context before risky operations. Progress notes: before a major tool action you may emit ONE short note (one sentence, ~15 words) saying what you are about to do. After a tool returns, mention a finding only if it changes your plan, and state it as fact grounded in what the tool actually returned \u2014 cite the file/line/symbol. NEVER claim you found, changed, or fixed something before a tool result confirms it. Skip notes for routine reads, and do not restate the todo list in prose.
 
 ` + `Task list discipline \u2014 use the todo_write tool to keep a visible, evolving checklist:
-` + `- Create the list FIRST. For any task with roughly three or more distinct steps, or any multi-file or multi-stage work, call todo_write as your very first action \u2014 before reading or editing \u2014 with every step listed and all of them set to pending.
+` + `- Create the list in your first step. For any task with roughly three or more distinct steps, or any multi-file or multi-stage work, call todo_write in your first response with every step listed and all of them set to pending \u2014 request it together with your first reads or searches, not as a separate step, and always before any edit.
 ` + `- Keep exactly ONE item in_progress at a time. Mark an item in_progress immediately before you start it; never have two items in_progress at once.
 ` + `- Mark an item completed only after a tool result confirms it is actually done (test passed, file written, build clean) \u2014 not on intent. Do this the MOMENT it is confirmed; do not batch completions or wait until the end of the turn.
 ` + `- Completions are monotonic: once a task is completed, do not silently move it back to pending or in_progress. Reopen it only if it genuinely regressed.
@@ -4021,20 +4024,26 @@ function collectTextFromUnknown(value) {
   }
   return "";
 }
-function getLastUserText(messages, prompt) {
+function getUserTexts(messages, prompt) {
+  const texts = [];
   if (Array.isArray(messages)) {
-    for (let index = messages.length - 1;index >= 0; index -= 1) {
-      const message = messages[index];
+    for (const message of messages) {
       if (!isRecord4(message) || message.role !== "user") {
         continue;
       }
       const text = collectTextFromUnknown(message).trim();
       if (text) {
-        return text;
+        texts.push(text);
       }
     }
   }
-  return collectTextFromUnknown(prompt).trim();
+  if (texts.length === 0) {
+    const promptText = collectTextFromUnknown(prompt).trim();
+    if (promptText) {
+      texts.push(promptText);
+    }
+  }
+  return texts;
 }
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -4060,23 +4069,20 @@ function selectCodingAgentIntentTools({
   messages,
   availableSkillNames = []
 }) {
-  const userText = getLastUserText(messages, prompt);
-  const normalizedText = userText.toLowerCase();
-  if (!normalizedText || casualPromptPattern.test(normalizedText)) {
+  const userTexts = getUserTexts(messages, prompt);
+  if (userTexts.every((text) => casualPromptPattern.test(text))) {
     return [];
   }
+  const latestText = userTexts.at(-1) ?? "";
   const modeTools = getRegistryToolsForMode(mode);
   const selected = new Set(modeTools.filter((toolName) => codingToolRegistry[toolName].activation === "core"));
-  if (gitIntentPattern.test(userText)) {
-    addTools(selected, gitToolNames);
-  }
-  if (webIntentPattern.test(userText)) {
+  if (webIntentPattern.test(latestText)) {
     addTools(selected, webToolNames);
   }
-  if (mcpIntentPattern.test(userText)) {
+  if (userTexts.some((text) => mcpIntentPattern.test(text))) {
     addTools(selected, mcpToolNames);
   }
-  if (skillIntentPattern.test(userText) || requestsAvailableSkill(userText, availableSkillNames)) {
+  if (userTexts.some((text) => skillIntentPattern.test(text) || requestsAvailableSkill(text, availableSkillNames))) {
     selected.add("skill");
   }
   return modeTools.filter((toolName) => selected.has(toolName));
@@ -4156,21 +4162,14 @@ function limitProviderActiveTools(tools, maxTools = maxProviderActiveTools) {
   const toolSet = new Set(tools);
   return providerToolPriority.filter((toolName) => toolSet.has(toolName)).slice(0, maxTools);
 }
-var casualPromptPattern, gitIntentPattern, webIntentPattern, mcpIntentPattern, skillIntentPattern, gitToolNames, webToolNames, mcpToolNames, maxProviderActiveTools = 24, providerToolPriority;
+var casualPromptPattern, webIntentPattern, mcpIntentPattern, skillIntentPattern, webToolNames, mcpToolNames, maxProviderActiveTools = 24, providerToolPriority;
 var init_intent_tool_selection = __esm(() => {
   init_coding_agent_modes();
   init_tool_registry();
   casualPromptPattern = /^(hi|hello|hey|how are you|how r you|what'?s up|whats up|sup|thanks|thank you|ok|okay|yes|no|nice|cool|great)[\s?!.,]*$/i;
-  gitIntentPattern = /(?:\bgit\b|\bcommits?\b|\bstaged?\b|\bunstaged\b|\buntracked\b|\bworking tree\b|\brepositor(?:y|ies)\s+(?:status|diff|history|changes))/i;
   webIntentPattern = /(?:\bhttps?:\/\/|\bwww\.|\bweb(?:site|page)?\b|\binternet\b|\bonline\b|\burl\b|\bbrowser\b|\bsearch\s+(?:the\s+)?web\b|\bbrowse\s+(?:the\s+web|online|for)\b|\blook\s+up\b|\b(?:latest|current|recent|today'?s)\s+(?:news|price|weather|docs?|documentation|release|version)\b)/i;
   mcpIntentPattern = /(?:\bmcp\b|\bmodel context protocol\b)/i;
   skillIntentPattern = /\bskills?\b/i;
-  gitToolNames = [
-    "git_status",
-    "git_diff",
-    "git_log",
-    "git_show"
-  ];
   webToolNames = [
     "web_fetch",
     "web_search"
@@ -5733,19 +5732,44 @@ async function executeReadFile(input, workspaceContext = getDefaultWorkspaceCont
   const fileContent = await fs4.readFile(resolvedPath, "utf8");
   const lines = fileContent.split(/\r?\n/);
   const { start, end } = clampLineRange(lines.length, parsedInput.startLine, parsedInput.endLine);
-  const selectedContent = lines.slice(start - 1, end).join(`
-`);
-  const maxChars = parsedInput.maxChars ?? DEFAULT_TOOL_TEXT_OUTPUT_CHARS;
-  const truncated = truncateText(selectedContent, maxChars);
+  const maxChars = parsedInput.maxChars ?? READ_FILE_OUTPUT_CHARS;
+  const taken = takeWholeLines(lines.slice(start - 1, end), maxChars);
+  const lastLine = start + taken.lineCount - 1;
   return readFileOutputSchema.parse({
     path: relativePath,
     startLine: start,
-    endLine: end,
-    content: truncated.text,
+    endLine: lastLine,
+    content: taken.text,
     totalLines: lines.length,
-    truncated: truncated.truncated
+    truncated: taken.truncated,
+    ...lastLine < end ? { nextStartLine: lastLine + 1 } : {}
   });
 }
+function takeWholeLines(lines, maxChars) {
+  let used = 0;
+  let lineCount = 0;
+  for (const line of lines) {
+    const cost = line.length + (lineCount > 0 ? 1 : 0);
+    if (used + cost > maxChars) {
+      break;
+    }
+    used += cost;
+    lineCount += 1;
+  }
+  if (lineCount === 0 && lines.length > 0) {
+    return {
+      text: truncateText(lines[0] ?? "", maxChars).text,
+      lineCount: 1,
+      truncated: true
+    };
+  }
+  return {
+    text: lines.slice(0, lineCount).join(`
+`),
+    lineCount,
+    truncated: lineCount < lines.length
+  };
+}
 var init_runtime8 = __esm(() => {
   init_resolve_within_workspace();
   init_output_utils();
@@ -7049,10 +7073,12 @@ function buildProviderView(options) {
   }
   const tokenBoundedCutoffIndex = computeTokenBoundedCompactionCutoffIndex(messages, preserveRecentTokens, afterAnchorIndex);
   const userIndicesAfterAnchor = messages.map((message, index) => ({ message, index })).filter(({ message, index }) => index >= afterAnchorIndex && message.role === "user").map(({ index }) => index);
-  const rollingTurnCutoffIndex = userIndicesAfterAnchor.length > config.uncachedRollingCompactionUserTurns ? userIndicesAfterAnchor[userIndicesAfterAnchor.length - config.uncachedRollingCompactionUserTurns] ?? afterAnchorIndex : afterAnchorIndex;
+  const rollingKeepUserTurns = Math.max(1, Math.ceil(config.uncachedRollingCompactionUserTurns / 2));
+  const rollingTurnCutoffIndex = userIndicesAfterAnchor.length > rollingKeepUserTurns ? userIndicesAfterAnchor[userIndicesAfterAnchor.length - rollingKeepUserTurns] ?? afterAnchorIndex : afterAnchorIndex;
   const overCompactThreshold = triggerTokens(estimate.tokens) > config.compactAtFraction * inputBudgetTokens;
+  const rollingActive = (options.rollingCompaction ?? options.cacheActive === false) && config.aggressivePruneWhenUncached;
   const userTurnsAfterAnchor = messages.slice(afterAnchorIndex).filter((message) => message.role === "user").length;
-  const rollingThresholdReached = uncachedActive && userTurnsAfterAnchor > config.uncachedRollingCompactionUserTurns;
+  const rollingThresholdReached = rollingActive && userTurnsAfterAnchor > (options.continueRolling ? rollingKeepUserTurns : config.uncachedRollingCompactionUserTurns);
   const compactionCutoffIndex = rollingThresholdReached ? Math.max(tokenBoundedCutoffIndex, rollingTurnCutoffIndex) : tokenBoundedCutoffIndex;
   const coveredMessages = capCoverageToTokenBudget(messages.slice(afterAnchorIndex, compactionCutoffIndex), config.maxCoverageTokensPerCompaction);
   let compactionBlockedReason = null;
@@ -7509,6 +7535,14 @@ import path12 from "path";
 import {
   toolModelMessageSchema
 } from "ai";
+function resolveToolOutputArtifactThresholds({
+  promptCacheActive
+}) {
+  return {
+    thresholdCharacters: promptCacheActive ? DEFAULT_CURRENT_TURN_TOOL_OUTPUT_THRESHOLD_CHARACTERS : DEFAULT_TOOL_OUTPUT_ARTIFACT_THRESHOLD_CHARACTERS,
+    currentTurnThresholdCharacters: DEFAULT_CURRENT_TURN_TOOL_OUTPUT_THRESHOLD_CHARACTERS
+  };
+}
 function isRecord10(value) {
   return typeof value === "object" && value !== null;
 }
@@ -7798,7 +7832,7 @@ async function toolOutputArtifactExists(handleOrDigest, dataDir = getLightcodeDa
     throw error;
   }
 }
-var TOOL_OUTPUT_ARTIFACT_HANDLE_PREFIX = "lightcode-artifact://tool-output/sha256/", DEFAULT_TOOL_OUTPUT_ARTIFACT_THRESHOLD_CHARACTERS, DEFAULT_CURRENT_TURN_TOOL_OUTPUT_THRESHOLD_CHARACTERS = 16000, DEFAULT_TOOL_OUTPUT_ARTIFACT_PREVIEW_CHARACTERS = 2400, MIN_TOOL_OUTPUT_ARTIFACT_PREVIEW_CHARACTERS = 512, SHA256_PATTERN, ARTIFACT_PREVIEW_MARKER = "[Lightcode tool-output artifact]";
+var TOOL_OUTPUT_ARTIFACT_HANDLE_PREFIX = "lightcode-artifact://tool-output/sha256/", DEFAULT_TOOL_OUTPUT_ARTIFACT_THRESHOLD_CHARACTERS, DEFAULT_CURRENT_TURN_TOOL_OUTPUT_THRESHOLD_CHARACTERS = 32000, DEFAULT_TOOL_OUTPUT_ARTIFACT_PREVIEW_CHARACTERS = 2400, MIN_TOOL_OUTPUT_ARTIFACT_PREVIEW_CHARACTERS = 512, SHA256_PATTERN, ARTIFACT_PREVIEW_MARKER = "[Lightcode tool-output artifact]";
 var init_tool_output_artifacts = __esm(() => {
   init_src();
   DEFAULT_TOOL_OUTPUT_ARTIFACT_THRESHOLD_CHARACTERS = DEFAULT_TOOL_TEXT_OUTPUT_CHARS;
@@ -9218,7 +9252,9 @@ function createCodingAgent({
       });
       const artifactized = await artifactizeLargeToolOutputs(messages, {
         signal: context.assemblyAbortSignal,
-        currentTurnThresholdCharacters: DEFAULT_CURRENT_TURN_TOOL_OUTPUT_THRESHOLD_CHARACTERS
+        ...resolveToolOutputArtifactThresholds({
+          promptCacheActive: context.promptCacheActive ?? false
+        })
       });
       const assembled = assembler.assembleModelMessages(artifactized.messages, {
         preserveRecentTokens: context.preserveRecentTokens
@@ -9284,6 +9320,7 @@ function createCodingAgent({
           reservedOutputTokens: options.maxOutputTokens,
           preserveRecentTokens: options.preserveRecentTokens,
           originalInputTokens: options.originalInputTokens,
+          promptCacheActive: options.promptCacheActive,
           assemblyAbortSignal: options.assemblyAbortSignal
         },
         instructions
@@ -16568,6 +16605,7 @@ __export(exports_runtime, {
   resolveWithinWorkspace: () => resolveWithinWorkspace,
   resolveWebSearchCapability: () => resolveWebSearchCapability,
   resolveWebSearchApiKeys: () => resolveWebSearchApiKeys,
+  resolveToolOutputArtifactThresholds: () => resolveToolOutputArtifactThresholds,
   resolveProviderWebSearchAccess: () => resolveProviderWebSearchAccess,
   resolvePreserveRecentTokens: () => resolvePreserveRecentTokens,
   resolveMaxOutputTokens: () => resolveMaxOutputTokens,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmugalkhod/lightcode",
-  "version": "0.18.5",
+  "version": "0.19.0",
   "description": "Lightcode — a local AI coding agent with terminal and browser interfaces.",
   "type": "module",
   "license": "MIT",