sparkecoder 0.1.87 → 0.1.94

package/README.md

@@ -139,7 +139,7 @@ Create a `sparkecoder.config.json` file:
 
 | Option | Description | Default |
 |--------|-------------|---------|
-| `defaultModel` | Vercel AI Gateway model string | `anthropic/claude-opus-4-6` |
+| `defaultModel` | Vercel AI Gateway model string | `anthropic/claude-opus-4.7` |
 | `workingDirectory` | Base directory for file operations | Current directory |
 | `toolApprovals` | Which tools require user approval | `{ bash: true }` |
 | `skills.directory` | Directory containing skill files | `./skills` |

package/dist/agent/index.d.ts

@@ -1,6 +1,6 @@
 import 'ai';
-import '../schema-CohdIL13.js';
-export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, C as ContextManager, M as MessageAttachment, d as buildSystemPrompt, e as buildTaskPromptAddendum } from '../index-BvIissiB.js';
-import '../search-CCffrVJE.js';
+import '../schema-D7BJyHLl.js';
+export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, C as ContextManager, M as MessageAttachment, d as buildSystemPrompt, e as buildTaskPromptAddendum } from '../index-C7Kkn5vq.js';
+import '../search-CVVfuBPZ.js';
 import 'drizzle-orm/sqlite-core';
 import 'zod';

package/dist/agent/index.js

@@ -107,7 +107,7 @@ var init_types = __esm({
     }).optional();
     SparkcoderConfigSchema = z.object({
       // Default model to use (Vercel AI Gateway format)
-      defaultModel: z.string().default("anthropic/claude-opus-4-6"),
+      defaultModel: z.string().default("anthropic/claude-opus-4.7"),
       // Working directory for file operations
       workingDirectory: z.string().optional(),
       // Tool approval settings
@@ -225,9 +225,9 @@ __export(remote_exports, {
   remoteToolExecutionQueries: () => remoteToolExecutionQueries,
   storageQueries: () => storageQueries
 });
-function initRemoteDatabase(serverUrl, key) {
+function initRemoteDatabase(serverUrl, key2) {
   remoteServerUrl = serverUrl.replace(/\/$/, "");
-  authKey = key;
+  authKey = key2;
 }
 function closeRemoteDatabase() {
   remoteServerUrl = null;
@@ -241,14 +241,14 @@ function parseDates(obj) {
   if (Array.isArray(obj)) return obj.map(parseDates);
   if (typeof obj !== "object" || obj instanceof Date) return obj;
   const result = { ...obj };
-  for (const key of Object.keys(result)) {
-    if (MODEL_MESSAGE_FIELDS.includes(key)) {
+  for (const key2 of Object.keys(result)) {
+    if (MODEL_MESSAGE_FIELDS.includes(key2)) {
       continue;
     }
-    if (DATE_FIELDS.includes(key) && typeof result[key] === "string") {
-      result[key] = new Date(result[key]);
-    } else if (typeof result[key] === "object") {
-      result[key] = parseDates(result[key]);
+    if (DATE_FIELDS.includes(key2) && typeof result[key2] === "string") {
+      result[key2] = new Date(result[key2]);
+    } else if (typeof result[key2] === "object") {
+      result[key2] = parseDates(result[key2]);
     }
   }
   return result;
@@ -729,10 +729,10 @@ function parseSkillFrontmatter(content) {
       }
       const colonIndex = line.indexOf(":");
       if (colonIndex > 0) {
-        const key = line.slice(0, colonIndex).trim();
+        const key2 = line.slice(0, colonIndex).trim();
         let value = line.slice(colonIndex + 1).trim();
         if (value === "" || value === "[]") {
-          currentArrayKey = key;
+          currentArrayKey = key2;
           currentArray = [];
           continue;
         }
@@ -745,18 +745,18 @@ function parseSkillFrontmatter(content) {
             }
             return trimmed;
           }).filter((item) => item.length > 0);
-          data[key] = items;
+          data[key2] = items;
           continue;
         }
         if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
           value = value.slice(1, -1);
         }
         if (value === "true") {
-          data[key] = true;
+          data[key2] = true;
         } else if (value === "false") {
-          data[key] = false;
+          data[key2] = false;
         } else {
-          data[key] = value;
+          data[key2] = value;
         }
       }
     }
@@ -1088,9 +1088,9 @@ var init_chunker = __esm({
 });
 
 // src/semantic/client.ts
-function initVectorClient(serverUrl, key) {
+function initVectorClient(serverUrl, key2) {
   remoteServerUrl2 = serverUrl.replace(/\/$/, "");
-  authKey2 = key;
+  authKey2 = key2;
 }
 function isVectorClientConfigured() {
   return !!remoteServerUrl2 && !!authKey2;
@@ -1636,7 +1636,7 @@ import { promisify as promisify6 } from "util";
 import { writeFile as writeFile5, mkdir as mkdir4, readFile as readFile11, unlink as unlink2, readdir as readdir5, rm } from "fs/promises";
 import { join as join9 } from "path";
 import { tmpdir as tmpdir2 } from "os";
-import { nanoid as nanoid4 } from "nanoid";
+import { nanoid as nanoid5 } from "nanoid";
 async function checkFfmpeg() {
   try {
     await execAsync6("ffmpeg -version", { timeout: 5e3 });
@@ -1691,7 +1691,7 @@ var init_recorder = __esm({
        */
       async encode() {
         if (this.frames.length === 0) return null;
-        const workDir = join9(tmpdir2(), `sparkecoder-recording-${nanoid4(8)}`);
+        const workDir = join9(tmpdir2(), `sparkecoder-recording-${nanoid5(8)}`);
         await mkdir4(workDir, { recursive: true });
         try {
           for (let i = 0; i < this.frames.length; i++) {
@@ -1911,6 +1911,23 @@ function isAnthropicModel(modelId) {
   const normalized = modelId.trim().toLowerCase();
   return normalized.startsWith(ANTHROPIC_PREFIX) || normalized.startsWith("claude-");
 }
+function requiresAdaptiveThinking(modelId) {
+  const m = modelId.toLowerCase().match(/claude-(?:opus|sonnet|haiku)-(\d+)[.-](\d{1,2})(?!\d)/);
+  if (!m) return false;
+  const major = Number(m[1]);
+  const minor = Number(m[2]);
+  if (Number.isNaN(major) || Number.isNaN(minor)) return false;
+  if (major > 4) return true;
+  if (major === 4 && minor >= 6) return true;
+  return false;
+}
+function getAnthropicProviderOptions(modelId, opts = {}) {
+  const { toolStreaming, budgetTokens = 1e4 } = opts;
+  const thinking = requiresAdaptiveThinking(modelId) ? { type: "adaptive" } : { type: "enabled", budgetTokens };
+  const out = { thinking };
+  if (toolStreaming) out.toolStreaming = true;
+  return out;
+}
 function resolveModel(modelId) {
   try {
     const config = getConfig();
@@ -1934,7 +1951,7 @@ var SUBAGENT_MODELS = {
 init_db();
 init_config();
 import { z as z15 } from "zod";
-import { nanoid as nanoid5 } from "nanoid";
+import { nanoid as nanoid6 } from "nanoid";
 
 // src/tools/bash.ts
 import { tool } from "ai";
@@ -2219,11 +2236,11 @@ async function sendInput(terminalId, input, options = {}) {
     return false;
   }
 }
-async function sendKey(terminalId, key) {
+async function sendKey(terminalId, key2) {
   const session = getSessionName(terminalId);
   try {
     await execAsync(`tmux has-session -t ${session}`, { timeout: 1e3 });
-    await execAsync(`tmux send-keys -t ${session} ${key}`, { timeout: 1e3 });
+    await execAsync(`tmux send-keys -t ${session} ${key2}`, { timeout: 1e3 });
     return true;
   } catch {
     return false;
@@ -2362,7 +2379,7 @@ bash({ id: "abc123", input: "my text" })  // send text input
 Terminal output is stored in the global SparkECoder data directory. Use the \`tail\` option to read recent output.`,
     inputSchema: bashInputSchema,
     execute: async (inputArgs) => {
-      const { command, background, id, kill, tail, input: textInput, key } = inputArgs;
+      const { command, background, id, kill, tail, input: textInput, key: key2 } = inputArgs;
       if (id) {
         if (kill) {
           const success = await killTerminal(id);
@@ -2393,8 +2410,8 @@ Terminal output is stored in the global SparkECoder data directory. Use the \`ta
             message: `Sent input "${textInput}" to terminal`
           };
         }
-        if (key) {
-          const success = await sendKey(id, key);
+        if (key2) {
+          const success = await sendKey(id, key2);
           if (!success) {
             return {
               success: false,
@@ -2410,7 +2427,7 @@ Terminal output is stored in the global SparkECoder data directory. Use the \`ta
             id,
             output: truncatedOutput2,
             status: status2,
-            message: `Sent key "${key}" to terminal`
+            message: `Sent key "${key2}" to terminal`
           };
         }
         const { output, status } = await getLogs(id, options.workingDirectory, { tail, sessionId: options.sessionId });
@@ -2552,13 +2569,13 @@ async function resizeImageIfNeeded(buffer, mediaType) {
   const needsResize = longEdge > MAX_LONG_EDGE;
   const needsShrink = buffer.length > MAX_FILE_BYTES;
   if (!needsResize && !needsShrink) return { buffer, mediaType: inputMediaType };
-  const key = cacheKey(buffer);
+  const key2 = cacheKey(buffer);
   const cacheDir = getCacheDir();
   const isPng = inputMediaType.includes("png");
   const willConvertToJpeg = isPng && (needsShrink || buffer.length > 2 * 1024 * 1024);
   const outputMediaType = willConvertToJpeg || !isPng ? "image/jpeg" : "image/png";
   const ext = outputMediaType === "image/png" ? ".png" : ".jpg";
-  const cachePath = join3(cacheDir, key + ext);
+  const cachePath = join3(cacheDir, key2 + ext);
   if (existsSync3(cachePath)) {
     console.log(`[image-resize] Cache hit for ${width}x${height} image`);
     return { buffer: readFileSync2(cachePath), mediaType: outputMediaType };
@@ -3313,31 +3330,31 @@ async function getClientForFile(filePath) {
     return null;
   }
   const root = dirname4(normalized);
-  const key = `${serverDef.id}:${root}`;
-  const existing = state.clients.get(key);
+  const key2 = `${serverDef.id}:${root}`;
+  const existing = state.clients.get(key2);
   if (existing) {
     return existing;
   }
-  if (state.broken.has(key)) {
+  if (state.broken.has(key2)) {
     return null;
   }
   try {
     const handle = await serverDef.spawn(root);
     if (!handle) {
-      state.broken.add(key);
+      state.broken.add(key2);
       return null;
     }
     console.log(`[lsp] Started ${serverDef.name} for ${root}`);
     const client = await createClient(serverDef.id, handle, root);
-    state.clients.set(key, client);
+    state.clients.set(key2, client);
     handle.process.on("exit", (code) => {
       console.log(`[lsp] ${serverDef.name} exited with code ${code}`);
-      state.clients.delete(key);
+      state.clients.delete(key2);
     });
     return client;
   } catch (error) {
     console.error(`[lsp] Failed to start ${serverDef.name}:`, error);
-    state.broken.add(key);
+    state.broken.add(key2);
     return null;
   }
 }
@@ -5437,6 +5454,7 @@ init_semantic_search();
 import { tool as tool11 } from "ai";
 import { z as z12 } from "zod";
 import Ajv from "ajv";
+import { nanoid as nanoid3 } from "nanoid";
 var ajv = new Ajv({ allErrors: true });
 function createCompleteTaskTool(options) {
   const validate = ajv.compile(options.outputSchema);
@@ -5483,6 +5501,37 @@ function createTaskFailedTool(options) {
     }
   });
 }
+function createAskQuestionToUserTool(options) {
+  return tool11({
+    description: "Ask the user a blocking clarification question when you cannot safely continue without more information. Use this only after trying to infer the answer from the available context. The task will pause until the orchestrator or user answers.",
+    inputSchema: z12.object({
+      question: z12.string().min(1).describe("The concise question you need answered."),
+      context: z12.string().optional().describe("Brief context explaining why this answer is needed and what you already tried."),
+      choices: z12.array(z12.string().min(1)).max(10).optional().describe("Optional suggested answer choices when the question is multiple choice.")
+    }),
+    execute: async (input) => {
+      if (!options.onQuestion) {
+        return {
+          status: "unavailable",
+          message: "Question routing is not configured for this task. Continue with the best safe assumption or call task_failed if blocked."
+        };
+      }
+      const questionId = `q_${nanoid3(12)}`;
+      const answer = await options.onQuestion({
+        questionId,
+        question: input.question,
+        context: input.context,
+        choices: input.choices
+      });
+      return {
+        status: "answered",
+        questionId,
+        answer: answer.answer,
+        answeredBy: answer.answeredBy ?? "unknown"
+      };
+    }
+  });
+}
 
 // src/tools/upload-file.ts
 import { tool as tool12 } from "ai";
@@ -5588,7 +5637,7 @@ import { promisify as promisify5 } from "util";
 import { mkdirSync as mkdirSync5, existsSync as existsSync15, readFileSync as readFileSync7, unlinkSync as unlinkSync2 } from "fs";
 import { join as join8 } from "path";
 import { tmpdir } from "os";
-import { nanoid as nanoid3 } from "nanoid";
+import { nanoid as nanoid4 } from "nanoid";
 var execAsync5 = promisify5(exec5);
 var DEFAULT_WIDTH = 1280;
 var DEFAULT_HEIGHT = 800;
@@ -5712,9 +5761,9 @@ async function runScroll(dx, dy) {
     { timeout: 5e3 }
   );
 }
-function translateKeyForCliclick(key) {
-  if (!key) return [];
-  const parts = key.split("+").map((p) => p.trim()).filter(Boolean);
+function translateKeyForCliclick(key2) {
+  if (!key2) return [];
+  const parts = key2.split("+").map((p) => p.trim()).filter(Boolean);
   if (parts.length === 0) return [];
   const modMap = {
     ctrl: "ctrl",
@@ -5810,7 +5859,7 @@ function createComputerUseTool(options) {
       try {
         switch (input.action) {
           case "screenshot": {
-            const path = join8(tmpdir(), `cu-${nanoid3(8)}.png`);
+            const path = join8(tmpdir(), `cu-${nanoid4(8)}.png`);
             await runScreencapture(path);
             const resized = await resizeScreenshotToPoints(path, displayWidth, displayHeight);
             try {
@@ -5941,7 +5990,7 @@ function createComputerUseTool(options) {
           case "zoom": {
             const region = input.region ?? [0, 0, displayWidth, displayHeight];
             const [x1, y1, x2, y2] = region;
-            const tmpPath = join8(tmpdir(), `cu-zoom-${nanoid3(8)}.png`);
+            const tmpPath = join8(tmpdir(), `cu-zoom-${nanoid4(8)}.png`);
             await runScreencapture(tmpPath);
             const sharpModule = await import("sharp");
             const sharp2 = sharpModule.default || sharpModule;
@@ -6220,6 +6269,7 @@ async function createTools(options) {
   if (options.taskTools) {
     tools.complete_task = createCompleteTaskTool(options.taskTools);
     tools.task_failed = createTaskFailedTool(options.taskTools);
+    tools.ask_question_to_user = createAskQuestionToUserTool(options.taskTools);
   }
   return tools;
 }
@@ -6626,9 +6676,10 @@ If you need to give the user a downloadable file (report, image, export, etc.),
 ### Rules
 1. Work independently \u2014 no human will approve tool calls. All tools run without approval.
 2. Keep working until the task is fully complete \u2014 and then VERIFY it is complete before finishing.
-3. When done, call the \`complete_task\` tool with a JSON result matching the output schema below.
-4. If you determine the task is impossible or encounter an unrecoverable error, call the \`task_failed\` tool with a clear reason.
-5. Do NOT stop without calling one of these two tools.
+3. If you are blocked by missing information, call \`ask_question_to_user\` with a concise question. The run will pause until the orchestrator or user answers, then you should continue from that answer.
+4. When done, call the \`complete_task\` tool with a JSON result matching the output schema below.
+5. If you determine the task is impossible or encounter an unrecoverable error, call the \`task_failed\` tool with a clear reason.
+6. Do NOT stop without calling \`complete_task\`, \`task_failed\`, or \`ask_question_to_user\` when blocked.
 
 ### Verification \u2014 BE EXTREMELY THOROUGH
 Before calling \`complete_task\`, you MUST verify your work completely. Do not just assume it worked. Actually check.
@@ -6699,6 +6750,7 @@ ${JSON.stringify(outputSchema, null, 2)}
 ### Completion Tools
 - **\`complete_task({ result: ... })\`** \u2014 Call ONLY after thorough verification. The result is validated against the schema above. If validation fails you will get errors back \u2014 fix and retry.
 - **\`task_failed({ reason: "..." })\`** \u2014 Call only if the task truly cannot be completed.
+- **\`ask_question_to_user({ question, context?, choices? })\`** \u2014 Call only when you need information that is not available in the repo, task prompt, files, logs, or tools. Ask one clear question; after the answer is returned, continue working.
 `;
 }
 function createSummaryPrompt(conversationHistory) {
@@ -6854,6 +6906,7 @@ function sanitizeModelMessages(messages) {
 
 // src/agent/model-limits.ts
 var MODEL_LIMITS = {
+  "anthropic/claude-opus-4.7": { contextWindow: 2e5, rollingTarget: 15e4 },
   "anthropic/claude-opus-4-6": { contextWindow: 2e5, rollingTarget: 15e4 },
   "anthropic/claude-sonnet-4": { contextWindow: 2e5, rollingTarget: 15e4 },
   "anthropic/claude-3.5-sonnet": { contextWindow: 2e5, rollingTarget: 15e4 },
@@ -7231,18 +7284,38 @@ async function sendWebhook(url, event) {
   }
 }
 
+// src/tasks/questions.ts
+var pendingQuestions = /* @__PURE__ */ new Map();
+function key(taskId, questionId) {
+  return `${taskId}:${questionId}`;
+}
+function waitForTaskQuestionAnswer(question) {
+  const k = key(question.taskId, question.questionId);
+  if (pendingQuestions.has(k)) {
+    return Promise.reject(new Error(`Question already pending: ${question.questionId}`));
+  }
+  return new Promise((resolve10, reject) => {
+    pendingQuestions.set(k, {
+      ...question,
+      createdAt: /* @__PURE__ */ new Date(),
+      resolve: resolve10,
+      reject
+    });
+  });
+}
+
 // src/agent/index.ts
 var MAX_SSE_FIELD_LENGTH = 8 * 1024;
 var SSE_PREVIEW_LENGTH = 2 * 1024;
 function truncateWriteFileInput(input) {
   const out = { ...input };
-  for (const key of ["content", "old_string", "new_string"]) {
-    const val = out[key];
+  for (const key2 of ["content", "old_string", "new_string"]) {
+    const val = out[key2];
     if (typeof val === "string" && val.length > MAX_SSE_FIELD_LENGTH) {
-      out[key] = `${val.slice(0, SSE_PREVIEW_LENGTH)}
+      out[key2] = `${val.slice(0, SSE_PREVIEW_LENGTH)}
 ... (truncated)`;
-      out[`${key}Truncated`] = true;
-      out[`${key}Length`] = val.length;
+      out[`${key2}Truncated`] = true;
+      out[`${key2}Length`] = val.length;
     }
   }
   return out;
@@ -7412,13 +7485,7 @@ ${prompt}` });
       abortSignal: options.abortSignal,
       // Enable extended thinking/reasoning for models that support it
       providerOptions: useAnthropic ? {
-        anthropic: {
-          toolStreaming: true,
-          thinking: {
-            type: "enabled",
-            budgetTokens: 1e4
-          }
-        }
+        anthropic: getAnthropicProviderOptions(this.session.model, { toolStreaming: true })
       } : void 0,
       onStepFinish: async (step) => {
         options.onStepFinish?.(step);
@@ -7465,12 +7532,7 @@ ${prompt}` });
       stopWhen: stepCountIs2(500),
       // Enable extended thinking/reasoning for models that support it
       providerOptions: useAnthropic ? {
-        anthropic: {
-          thinking: {
-            type: "enabled",
-            budgetTokens: 1e4
-          }
-        }
+        anthropic: getAnthropicProviderOptions(this.session.model)
       } : void 0
     });
     const responseMessages = result.response.messages;
@@ -7557,7 +7619,38 @@ ${prompt}` });
       },
       taskTools: {
         outputSchema: options.taskConfig.outputSchema,
-        onComplete
+        onComplete,
+        onQuestion: async (question) => {
+          const payload = {
+            questionId: question.questionId,
+            question: question.question,
+            context: question.context,
+            choices: question.choices,
+            status: "pending"
+          };
+          const answerPromise = waitForTaskQuestionAnswer({
+            taskId: this.session.id,
+            questionId: question.questionId,
+            question: question.question,
+            context: question.context,
+            choices: question.choices
+          });
+          fireWebhook("task.question", payload);
+          if (emit) {
+            await emit(JSON.stringify({ type: "task-question", data: payload }));
+          }
+          const answer = await answerPromise;
+          const answeredPayload = {
+            questionId: question.questionId,
+            answer: answer.answer,
+            answeredBy: answer.answeredBy
+          };
+          fireWebhook("task.question_answered", answeredPayload);
+          if (emit) {
+            await emit(JSON.stringify({ type: "task-question-answered", data: answeredPayload }));
+          }
+          return answer;
+        }
       }
     });
     const baseSystemPrompt = await buildSystemPrompt({
@@ -7602,10 +7695,7 @@ ${taskAddendum}`;
         stopWhen: stepCountIs2(500),
         abortSignal: options.abortSignal,
         providerOptions: useAnthropic ? {
-          anthropic: {
-            toolStreaming: true,
-            thinking: { type: "enabled", budgetTokens: 1e4 }
-          }
+          anthropic: getAnthropicProviderOptions(this.session.model, { toolStreaming: true })
         } : void 0,
         onStepFinish: async (step) => {
           options.onStepFinish?.(step);
@@ -7892,7 +7982,7 @@ ${taskAddendum}`;
         description: originalTool.description || "",
         inputSchema: originalTool.inputSchema || z15.object({}),
         execute: async (input, toolOptions) => {
-          const toolCallId = toolOptions.toolCallId || nanoid5();
+          const toolCallId = toolOptions.toolCallId || nanoid6();
           const execution = toolExecutionQueries.create({
             sessionId: this.session.id,
             toolName: name,