@kmugalkhod/lightcode 0.3.0 → 0.5.0

package/README.md

@@ -6,6 +6,19 @@ permission-gated tool suite (files, shell, git, web, MCP), and tiered context
 optimization that keeps long sessions inside the model's context window
 without ever losing history.
 
+## Install
+
+```bash
+npm install -g @kmugalkhod/lightcode
+lightcode
+```
+
+Works on macOS (Apple Silicon and Intel), Linux, and Windows. Bun ships with
+the package, so there's nothing else to install — the first `lightcode` run
+uses the bundled runtime automatically (and reuses a system Bun if you already
+have one). The published package is scoped as `@kmugalkhod/lightcode`; the
+command it installs is `lightcode`.
+
 ## Quick start (from source)
 
 ```bash
@@ -13,6 +26,11 @@ bun install
 bun run cli:dev        # starts the TUI; it boots the server automatically
 ```
 
+Lightcode is aware of the directory you launch it in: each turn it reads the
+project's shape (top-level files, git branch/status) and any `AGENTS.md` /
+`CLAUDE.md` / `README.md`, so "review my code" or "explain this" inspects your
+actual files instead of asking you to paste them.
+
 On first run Lightcode walks you through provider setup (Anthropic,
 OpenRouter, OpenCode Zen, or any OpenAI-compatible endpoint) and stores the
 API key in `~/.lightcode/credentials.json`. Environment variables such as
@@ -44,7 +62,8 @@ variables. Notable keys:
 | `context.pruneAtFraction` | Tool-output pruning threshold (default 0.6) |
 | `context.contextWindowOverride` | Override the model context window |
 | `maxRetries` | Provider-call retries for transient errors (default 5) |
-| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default 180) |
+| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default 300; raise for very slow reasoning models) |
+| `autoContinue.maxErrorRetries` | Auto-resends before surfacing a stream error (default 8) |
 
 The local companion server listens on `127.0.0.1:4983` (uncommon on purpose —
 port 3000 belongs to the apps you build). Override with `PORT` for the server

package/cli.js

@@ -124,7 +124,7 @@ var init_logger = __esm(() => {
 });
 
 // packages/shared/src/version.ts
-var lightcodeVersion = "0.3.0";
+var lightcodeVersion = "0.5.0";
 
 // packages/shared/src/index.ts
 var productName = "Lightcode";
@@ -226,7 +226,8 @@ async function ensureServerRunning() {
     stderr: logFile,
     env: {
       ...process.env,
-      PORT: port
+      PORT: port,
+      LIGHTCODE_PARENT_PID: String(process.pid)
     }
   });
   for (let attempt = 0;attempt < startupPollAttempts; attempt += 1) {
@@ -998,7 +999,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 +1595,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 +1711,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 +1726,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 +1823,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 +2077,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({
@@ -2466,7 +2467,8 @@ var init_agent_tools = __esm(() => {
     permissionMode: permissionModeSchema.optional(),
     allowedTools: z21.array(codingAgentToolNameSchema).optional(),
     permissionRules: permissionRulesSchema.optional(),
-    sandbox: sandboxConfigSchema.optional()
+    sandbox: sandboxConfigSchema.optional(),
+    environmentContext: z21.string().optional()
   });
 });
 
@@ -2841,7 +2843,8 @@ function buildCodingAgentSystemPrompt({
   cwd,
   override,
   mode = defaultCodingAgentMode,
-  includeToolDiscipline = false
+  includeToolDiscipline = false,
+  environmentContext
 }) {
   const promptTemplate = override?.trim() ? override : defaultCodingAgentSystemPrompt;
   const normalizedPrompt = normalizePromptTemplate(promptTemplate, cwd);
@@ -2852,16 +2855,18 @@ function buildCodingAgentSystemPrompt({
 ` + `Mode purpose: ${modeDefinition.purpose}
 ` + `${modeDefinition.instructions}` + (includeToolDiscipline ? `
 
-${toolCallingDisciplineAddendum}` : "");
+${toolCallingDisciplineAddendum}` : "") + (environmentContext?.trim() ? `
+
+${environmentContext.trim()}` : "");
 }
 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 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. " + `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.";
 });
 
@@ -3180,6 +3185,17 @@ function selectCodingAgentIntentTools({
     return [];
   }
   const selectedTools = [];
+  const hasContinuationIntent = includesAny(normalizedText, [
+    "continue",
+    "proceed",
+    "go on",
+    "go ahead",
+    "keep going",
+    "carry on",
+    "resume",
+    "finish",
+    "next step"
+  ]);
   const hasCodeIntent = includesAny(normalizedText, [
     "file",
     "folder",
@@ -3226,7 +3242,44 @@ function selectCodingAgentIntentTools({
     "analyze",
     "check"
   ]);
-  const hasWriteIntent = mode === "build" && includesAny(normalizedText, [
+  const workspaceReferents = [
+    "this",
+    "these",
+    "that",
+    "here",
+    "code",
+    "codebase",
+    "repo",
+    "repository",
+    "project",
+    "file",
+    "files",
+    "directory",
+    "folder",
+    "app",
+    "application",
+    "module",
+    "my"
+  ];
+  const strongReviewIntent = includesAny(normalizedText, [
+    "review",
+    "audit",
+    "walk through",
+    "walkthrough",
+    "code review"
+  ]);
+  const softReviewIntent = includesAny(normalizedText, [
+    "explain",
+    "understand",
+    "summarize",
+    "summarise",
+    "overview",
+    "describe",
+    "explore",
+    "look at"
+  ]) && includesAny(normalizedText, workspaceReferents);
+  const hasReviewIntent = strongReviewIntent || softReviewIntent;
+  const hasWriteIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "write",
     "edit",
     "change",
@@ -3237,8 +3290,8 @@ function selectCodingAgentIntentTools({
     "delete",
     "remove",
     "rename"
-  ]);
-  const hasShellIntent = mode === "build" && includesAny(normalizedText, [
+  ]));
+  const hasShellIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "run",
     "command",
     "terminal",
@@ -3250,7 +3303,7 @@ function selectCodingAgentIntentTools({
     "run test",
     "run tests",
     "typecheck"
-  ]);
+  ]));
   const hasGitIntent = includesAny(normalizedText, [
     "git",
     "diff",
@@ -3298,7 +3351,7 @@ function selectCodingAgentIntentTools({
     "mcp tool",
     "mcp server"
   ]);
-  if (hasCodeIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
+  if (hasCodeIntent || hasContinuationIntent || hasReviewIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
     for (const toolName of baseReadTools) {
       pushUniqueTool(selectedTools, toolName);
     }
@@ -3552,7 +3605,8 @@ function createCodingAgent({
           cwd: options.cwd,
           override: promptOverride,
           mode,
-          includeToolDiscipline
+          includeToolDiscipline,
+          environmentContext: options.environmentContext
         })
       };
     }
@@ -3646,6 +3700,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 +3712,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 +4194,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;
@@ -4314,7 +4384,11 @@ 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 = {
@@ -4441,8 +4515,8 @@ var init_lightcode_config = __esm(() => {
   defaultAutoContinueConfig = {
     enabled: true,
     maxAutoContinues: 50,
-    maxErrorRetries: 5,
-    stallTimeoutSeconds: 180
+    maxErrorRetries: 8,
+    stallTimeoutSeconds: 300
   };
   headroomConfigSchema = z28.object({
     enabled: z28.boolean().optional(),
@@ -5949,19 +6023,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
   };
 }
@@ -6971,7 +7055,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,
@@ -13568,7 +13652,12 @@ function OnboardingScreen() {
         ...finalBaseUrl ? { baseUrl: finalBaseUrl } : {}
       });
       const restarted = await restartOwnedServer();
-      setServerRestarted(restarted);
+      let reloaded = false;
+      try {
+        const response = await client.config.reload.$post();
+        reloaded = response.ok;
+      } catch {}
+      setServerRestarted(restarted || reloaded);
       bumpConfigRefresh();
       setStep("done");
     } catch (error) {
@@ -13779,6 +13868,7 @@ var providerChoices;
 var init_onboarding_screen = __esm(() => {
   init_src2();
   init_chat_text_area();
+  init_client();
   init_server_launcher();
   init_app_state();
   init_cli_theme();
@@ -14743,10 +14833,19 @@ var renderer = await createCliRenderer({
 });
 if (serverLaunch.ownedProcess) {
   const ownedProcess = serverLaunch.ownedProcess;
-  process.on("exit", () => {
+  const killOwnedServer = () => {
     try {
       ownedProcess.kill();
     } catch {}
+  };
+  process.on("exit", killOwnedServer);
+  process.on("SIGINT", () => {
+    killOwnedServer();
+    process.exit(0);
+  });
+  process.on("SIGTERM", () => {
+    killOwnedServer();
+    process.exit(0);
   });
 }
 createRoot(renderer).render(/* @__PURE__ */ jsxDEV33(App2, {}, undefined, false, undefined, this));

package/lightcode.cjs

@@ -8,22 +8,67 @@ const path = require("path");
 const fs = require("fs");
 const os = require("os");
 
-// Check if Bun is available
-try {
-  const result = spawnSync("bun", ["--version"], { encoding: "utf8" });
-  if (result.status !== 0) {
-    throw new Error("Bun not found");
+// Resolve a usable Bun (>= 1.3.0). Prefer the Bun bundled as a dependency of
+// this package (so a plain `npm install -g` works with no separate Bun
+// install), then fall back to a Bun already on PATH.
+function isUsableBun(bunCmd) {
+  try {
+    const result = spawnSync(bunCmd, ["--version"], { encoding: "utf8" });
+    if (result.status !== 0 || !result.stdout) {
+      return false;
+    }
+    const [major, minor] = result.stdout.trim().split(".").map(Number);
+    return major > 1 || (major === 1 && minor >= 3);
+  } catch {
+    return false;
+  }
+}
+
+function resolveBun() {
+  // __dirname is the realpath of this launcher even when invoked via npm's
+  // global bin symlink (process.argv[1] would be the symlink path on macOS/Linux).
+  const launcherDir = __dirname;
+  const candidates = [];
+
+  // Bun shipped as a dependency, inside this package's own node_modules. The
+  // npm "bun" package names its executable bin/bun.exe on EVERY platform
+  // (macOS and Linux included), so read the real path from its "bin" field
+  // rather than guessing a filename.
+  try {
+    const bunPkgPath = require.resolve("bun/package.json", {
+      paths: [launcherDir],
+    });
+    const bunDir = path.dirname(bunPkgPath);
+    const bin = JSON.parse(fs.readFileSync(bunPkgPath, "utf8")).bin;
+    const rel = typeof bin === "string" ? bin : bin && bin.bun;
+    if (rel) {
+      candidates.push(path.join(bunDir, rel));
+    }
+  } catch {}
+
+  // npm's bin shim (symlink) and conventional names, as fallbacks.
+  const shim = process.platform === "win32" ? "bun.exe" : "bun";
+  candidates.push(path.join(launcherDir, "node_modules", ".bin", shim));
+  candidates.push(path.join(launcherDir, "node_modules", "bun", "bin", "bun.exe"));
+  candidates.push(path.join(launcherDir, "node_modules", "bun", "bin", "bun"));
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate) && isUsableBun(candidate)) {
+      return candidate;
+    }
   }
-  const version = result.stdout.trim();
-  const [major, minor] = version.split(".").map(Number);
-  // Accept Bun >= 1.3.0
-  if (major < 1 || (major === 1 && minor < 3)) {
-    console.error("Lightcode requires Bun >= 1.3.0. Found: " + version);
-    console.error("Install the latest Bun from https://bun.sh");
-    process.exit(1);
+
+  // Fall back to a system Bun on PATH.
+  if (isUsableBun("bun")) {
+    return "bun";
   }
-} catch {
-  console.error("Lightcode requires Bun >= 1.3.0, which is not installed.");
+
+  return null;
+}
+
+const bunPath = resolveBun();
+if (!bunPath) {
+  console.error("Lightcode requires Bun >= 1.3.0, which could not be found.");
   console.error("Install Bun from https://bun.sh or:");
   console.error("  curl -fsSL https://bun.sh/install | bash");
   console.error("  # on Windows (PowerShell):");
@@ -84,9 +129,9 @@ if (process.platform === "win32" && !process.env.NODE_EXTRA_CA_CERTS) {
   }
 }
 
-// Get the directory of this launcher and find cli.js next to it
-const launcherDir = path.dirname(process.argv[1]);
-const cliPath = path.join(launcherDir, "cli.js");
+// Get the directory of this launcher and find cli.js next to it. Use __dirname
+// (realpath-resolved) so this works when run via npm's global bin symlink.
+const cliPath = path.join(__dirname, "cli.js");
 
 // Ensure cli.js exists
 if (!fs.existsSync(cliPath)) {
@@ -97,7 +142,7 @@ if (!fs.existsSync(cliPath)) {
 // Exec Bun with the cli.js script using spawnSync for proper argument handling
 try {
   const args = process.argv.slice(2);
-  const result = spawnSync("bun", [cliPath, ...args], {
+  const result = spawnSync(bunPath, [cliPath, ...args], {
     stdio: "inherit",
     env: process.env,
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmugalkhod/lightcode",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Lightcode — a personal AI coding agent with a terminal UI and local session storage.",
   "type": "module",
   "license": "MIT",
@@ -18,6 +18,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "bun": "1.3.13",
     "@ai-sdk/anthropic": "3.0.77",
     "@ai-sdk/openai-compatible": "2.0.48",
     "@ai-sdk/react": "3.0.184",