sparkecoder 0.1.87 → 0.1.93

package/dist/cli.js

@@ -29,9 +29,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;
@@ -45,14 +45,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;
@@ -598,7 +598,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
@@ -872,7 +872,7 @@ function requiresApproval(toolName, sessionConfig) {
 }
 function createDefaultConfig() {
   return {
-    defaultModel: "anthropic/claude-opus-4-6",
+    defaultModel: "anthropic/claude-opus-4.7",
     // workingDirectory is intentionally not set - defaults to where CLI is run
     toolApprovals: {
       bash: true,
@@ -984,6 +984,14 @@ function loadApiKeysIntoEnv() {
     }
   }
 }
+function isRemoteInferenceConfigured() {
+  try {
+    const config = getConfig();
+    return config.resolvedRemoteServer.isConfigured;
+  } catch {
+    return false;
+  }
+}
 function setApiKey(provider, apiKey) {
   const normalizedProvider = provider.toLowerCase();
   const envVar = PROVIDER_ENV_MAP[normalizedProvider];
@@ -1033,11 +1041,11 @@ function getApiKeyStatus() {
     };
   });
 }
-function maskApiKey(key) {
-  if (key.length <= 12) {
-    return "****" + key.slice(-4);
+function maskApiKey(key2) {
+  if (key2.length <= 12) {
+    return "****" + key2.slice(-4);
   }
-  return key.slice(0, 4) + "..." + key.slice(-4);
+  return key2.slice(0, 4) + "..." + key2.slice(-4);
 }
 var CONFIG_FILE_NAMES, cachedConfig, AUTH_KEY_FILE, API_KEYS_FILE, PROVIDER_ENV_MAP, SUPPORTED_PROVIDERS;
 var init_config = __esm({
@@ -1491,10 +1499,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;
         }
@@ -1507,18 +1515,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;
         }
       }
     }
@@ -2256,9 +2264,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;
@@ -2948,7 +2956,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";
 function isMacOs() {
   return process.platform === "darwin";
 }
@@ -3069,9 +3077,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",
@@ -3167,7 +3175,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 {
@@ -3298,7 +3306,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;
@@ -3620,7 +3628,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 });
@@ -3675,7 +3683,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++) {
@@ -4023,9 +4031,9 @@ function startPersonalAgent(cfg) {
   console.log(`${cfg.dashboardUrl.replace(/\/$/, "")}/admin/devices`);
   console.log("");
   const warned = /* @__PURE__ */ new Set();
-  function warnOnce(key, msg) {
-    if (warned.has(key)) return;
-    warned.add(key);
+  function warnOnce(key2, msg) {
+    if (warned.has(key2)) return;
+    warned.add(key2);
     console.warn(msg);
   }
   async function tick() {
@@ -4109,6 +4117,9 @@ import chalk from "chalk";
 import ora from "ora";
 import "dotenv/config";
 import { createInterface } from "readline";
+import { dirname as dirname8 } from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
+import { hostname as hostname4 } from "os";
 
 // src/server/index.ts
 import "dotenv/config";
@@ -4130,7 +4141,7 @@ import { z as z16 } from "zod";
 import { existsSync as existsSync16, mkdirSync as mkdirSync6, writeFileSync as writeFileSync3, readdirSync as readdirSync2, statSync as statSync2, unlinkSync as unlinkSync3 } from "fs";
 import { readdir as readdir6 } from "fs/promises";
 import { join as join10, basename as basename5, extname as extname8, relative as relative9 } from "path";
-import { nanoid as nanoid6 } from "nanoid";
+import { nanoid as nanoid7 } from "nanoid";
 
 // src/agent/index.ts
 import {
@@ -4305,6 +4316,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();
@@ -4328,7 +4356,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";
@@ -4661,11 +4689,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;
@@ -4804,7 +4832,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);
@@ -4835,8 +4863,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,
@@ -4852,7 +4880,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 });
@@ -4994,13 +5022,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 };
@@ -5891,31 +5919,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;
   }
 }
@@ -7647,6 +7675,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);
@@ -7693,6 +7722,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";
@@ -8027,6 +8087,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;
 }
@@ -8434,9 +8495,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.
@@ -8507,6 +8569,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) {
@@ -8662,6 +8725,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 },
@@ -8998,17 +9062,65 @@ function repairToolPairing(messages) {
 
 // src/agent/index.ts
 init_webhook();
+
+// src/tasks/questions.ts
+var pendingQuestions = /* @__PURE__ */ new Map();
+var answeredQuestions = /* @__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((resolve12, reject) => {
+    pendingQuestions.set(k, {
+      ...question,
+      createdAt: /* @__PURE__ */ new Date(),
+      resolve: resolve12,
+      reject
+    });
+  });
+}
+function answerTaskQuestion(taskId, questionId, answer) {
+  const k = key(taskId, questionId);
+  const pending = pendingQuestions.get(k);
+  if (!pending) return answeredQuestions.has(k) ? "already_answered" : "not_found";
+  pendingQuestions.delete(k);
+  answeredQuestions.set(k, answer);
+  pending.resolve(answer);
+  return "answered";
+}
+function rejectTaskQuestions(taskId, reason) {
+  for (const [k, pending] of pendingQuestions) {
+    if (pending.taskId !== taskId) continue;
+    pendingQuestions.delete(k);
+    pending.reject(new Error(reason));
+  }
+}
+function getPendingTaskQuestion(taskId, questionId) {
+  const pending = pendingQuestions.get(key(taskId, questionId));
+  if (!pending) return null;
+  const { resolve: _resolve, reject: _reject, ...question } = pending;
+  return question;
+}
+function getAnsweredTaskQuestion(taskId, questionId) {
+  return answeredQuestions.get(key(taskId, questionId)) ?? null;
+}
+
+// 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;
@@ -9178,13 +9290,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);
@@ -9231,12 +9337,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;
@@ -9323,7 +9424,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({
@@ -9368,10 +9500,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);
@@ -9658,7 +9787,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,
@@ -10308,7 +10437,7 @@ sessions.post("/:id/attachments", async (c) => {
         return c.json({ error: "No file provided" }, 400);
       }
       const dir = ensureAttachmentsDir(sessionId);
-      const id = nanoid6(10);
+      const id = nanoid7(10);
       const ext = extname8(file.name) || "";
       const safeFilename = `${id}_${basename5(file.name).replace(/[^a-zA-Z0-9._-]/g, "_")}`;
       const filePath = join10(dir, safeFilename);
@@ -10334,7 +10463,7 @@ sessions.post("/:id/attachments", async (c) => {
       return c.json({ error: "Missing filename or data" }, 400);
     }
     const dir = ensureAttachmentsDir(sessionId);
-    const id = nanoid6(10);
+    const id = nanoid7(10);
     const ext = extname8(body.filename) || "";
     const safeFilename = `${id}_${basename5(body.filename).replace(/[^a-zA-Z0-9._-]/g, "_")}`;
     const filePath = join10(dir, safeFilename);
@@ -10626,9 +10755,9 @@ var store = /* @__PURE__ */ new Map();
 var channels = /* @__PURE__ */ new Map();
 var cleanupInterval = setInterval(() => {
   const now = Date.now();
-  for (const [key, data] of store.entries()) {
+  for (const [key2, data] of store.entries()) {
     if (data.expiresAt && data.expiresAt < now) {
-      store.delete(key);
+      store.delete(key2);
     }
   }
 }, 6e4);
@@ -10652,27 +10781,27 @@ var publisher = {
       }
     }
   },
-  set: async (key, value, options) => {
+  set: async (key2, value, options) => {
     const expiresAt = options?.EX ? Date.now() + options.EX * 1e3 : void 0;
-    store.set(key, { value, expiresAt });
+    store.set(key2, { value, expiresAt });
     if (options?.EX) {
-      setTimeout(() => store.delete(key), options.EX * 1e3);
+      setTimeout(() => store.delete(key2), options.EX * 1e3);
     }
   },
-  get: async (key) => {
-    const data = store.get(key);
+  get: async (key2) => {
+    const data = store.get(key2);
     if (!data) return null;
     if (data.expiresAt && data.expiresAt < Date.now()) {
-      store.delete(key);
+      store.delete(key2);
       return null;
     }
     return data.value;
   },
-  incr: async (key) => {
-    const data = store.get(key);
+  incr: async (key2) => {
+    const data = store.get(key2);
     const current = data ? parseInt(data.value, 10) : 0;
     const next = (isNaN(current) ? 0 : current) + 1;
-    store.set(key, { value: String(next), expiresAt: data?.expiresAt });
+    store.set(key2, { value: String(next), expiresAt: data?.expiresAt });
     return next;
   }
 };
@@ -10704,7 +10833,7 @@ var streamContext = createResumableStreamContext({
 });
 
 // src/server/routes/agents.ts
-import { nanoid as nanoid7 } from "nanoid";
+import { nanoid as nanoid8 } from "nanoid";
 init_stream_proxy();
 init_recorder();
 init_remote();
@@ -11263,7 +11392,7 @@ ${prompt}` });
       userMessageContent = prompt;
     }
     await messageQueries.create(id, { role: "user", content: userMessageContent });
-    const streamId = `stream_${id}_${nanoid7(10)}`;
+    const streamId = `stream_${id}_${nanoid8(10)}`;
     console.log(`[STREAM] Creating stream ${streamId} for session ${id}`);
     await activeStreamQueries.create(id, streamId);
     const stream = await streamContext.resumableStream(
@@ -11468,7 +11597,7 @@ agents.post(
     });
     const session = agent.getSession();
     const enrichedPrompt = enrichPromptWithDevtoolsContext(session.id, body.prompt);
-    const streamId = `stream_${session.id}_${nanoid7(10)}`;
+    const streamId = `stream_${session.id}_${nanoid8(10)}`;
     await createCheckpoint(session.id, session.workingDirectory, 0);
     await activeStreamQueries.create(session.id, streamId);
     const createQuickStreamProducer = () => {
@@ -11821,7 +11950,8 @@ health.get("/", async (c) => {
   const config = getConfig();
   const apiKeyStatus = getApiKeyStatus();
   const gatewayKey = apiKeyStatus.find((s) => s.provider === "ai-gateway");
-  const hasApiKey = gatewayKey?.configured ?? false;
+  const remoteInference = isRemoteInferenceConfigured();
+  const hasApiKey = remoteInference || (gatewayKey?.configured ?? false);
   let hwid;
   try {
     hwid = getHardwareIdCached();
@@ -11832,6 +11962,7 @@ health.get("/", async (c) => {
     version: currentVersion,
     uptime: process.uptime(),
     apiKeyConfigured: hasApiKey,
+    inferenceMode: remoteInference ? "remote" : "local",
     hwid,
     config: {
       workingDirectory: config.resolvedWorkingDirectory,
@@ -12258,7 +12389,7 @@ init_db();
 import { Hono as Hono5 } from "hono";
 import { zValidator as zValidator5 } from "@hono/zod-validator";
 import { z as z20 } from "zod";
-import { nanoid as nanoid8 } from "nanoid";
+import { nanoid as nanoid9 } from "nanoid";
 init_config();
 var tasks = new Hono5();
 var taskAbortControllers = /* @__PURE__ */ new Map();
@@ -12332,7 +12463,7 @@ tasks.post(
     const taskId = agent.sessionId;
     const abortController = new AbortController();
     taskAbortControllers.set(taskId, abortController);
-    const streamId = `stream_${taskId}_${nanoid8(10)}`;
+    const streamId = `stream_${taskId}_${nanoid9(10)}`;
     await activeStreamQueries.create(taskId, streamId);
     const taskStreamProducer = () => {
       const { readable, writable } = new TransformStream();
@@ -12459,6 +12590,7 @@ tasks.post("/:id/cancel", async (c) => {
     abortController.abort();
     taskAbortControllers.delete(id);
   }
+  rejectTaskQuestions(id, "Task cancelled by user");
   const cancelledTask = {
     ...task,
     status: "failed",
@@ -12480,6 +12612,52 @@ tasks.post("/:id/cancel", async (c) => {
   }
   return c.json({ taskId: id, status: "failed", error: "Task cancelled by user" });
 });
+var answerQuestionSchema = z20.object({
+  answer: z20.string().min(1),
+  answeredBy: z20.enum(["orchestrator", "user", "system"]).optional()
+});
+tasks.post(
+  "/:id/questions/:questionId/answer",
+  zValidator5("json", answerQuestionSchema),
+  async (c) => {
+    const id = c.req.param("id");
+    const questionId = c.req.param("questionId");
+    const body = c.req.valid("json");
+    const session = await sessionQueries.getById(id);
+    if (!session) {
+      return c.json({ error: "Task not found" }, 404);
+    }
+    const task = session.config?.task;
+    if (!task?.enabled) {
+      return c.json({ error: "Session is not a task" }, 400);
+    }
+    const pending = getPendingTaskQuestion(id, questionId);
+    if (!pending) {
+      if (getAnsweredTaskQuestion(id, questionId)) {
+        return c.json({
+          taskId: id,
+          questionId,
+          status: "answered",
+          alreadyAnswered: true
+        });
+      }
+      return c.json({ error: "Question is not pending" }, 404);
+    }
+    const answerStatus = answerTaskQuestion(id, questionId, {
+      answer: body.answer,
+      answeredBy: body.answeredBy
+    });
+    if (answerStatus === "not_found") {
+      return c.json({ error: "Question is not pending" }, 404);
+    }
+    return c.json({
+      taskId: id,
+      questionId,
+      status: "answered",
+      alreadyAnswered: answerStatus === "already_answered"
+    });
+  }
+);
 var tasks_default = tasks;
 
 // src/server/routes/system.ts
@@ -12575,15 +12753,15 @@ function loadPublicKey(input) {
   if (!input.includes("BEGIN") && existsSync18(input)) {
     pem = readFileSync11(input, "utf8");
   }
-  const key = createPublicKey({ key: pem, format: "pem" });
-  if (key.asymmetricKeyType !== "ed25519") {
+  const key2 = createPublicKey({ key: pem, format: "pem" });
+  if (key2.asymmetricKeyType !== "ed25519") {
     throw new Error(
-      `expected an ed25519 public key, got ${key.asymmetricKeyType}. Generate with personal-agents/scripts/generate-signing-keys.mjs.`
+      `expected an ed25519 public key, got ${key2.asymmetricKeyType}. Generate with personal-agents/scripts/generate-signing-keys.mjs.`
     );
   }
-  _cachedKey = key;
+  _cachedKey = key2;
   _cachedFromInput = input;
-  return key;
+  return key2;
 }
 function bodyHashB64(body) {
   const hash = createHash3("sha256");
@@ -14097,8 +14275,30 @@ function generateOpenAPISpec() {
 init_config();
 init_semantic();
 init_db();
-import { writeFileSync as writeFileSync6, readFileSync as readFileSync12, existsSync as existsSync20 } from "fs";
+import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync6, readFileSync as readFileSync12, existsSync as existsSync20, chmodSync } from "fs";
 import { resolve as resolve11, join as join14 } from "path";
+function getCliVersion() {
+  const here = dirname8(fileURLToPath5(import.meta.url));
+  const candidates = [
+    join14(here, "..", "package.json"),
+    join14(here, "..", "..", "package.json"),
+    join14(process.cwd(), "package.json")
+  ];
+  for (const p of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync12(p, "utf8"));
+      if (pkg.name === "sparkecoder" && pkg.version) return pkg.version;
+    } catch {
+    }
+  }
+  return "0.0.0";
+}
+function shellExport(name, value) {
+  return `export ${name}='${value.replace(/'/g, `'\\''`)}'`;
+}
+function xmlEscape(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
 async function apiRequest(baseUrl, path, options = {}) {
   const url = `${baseUrl}${path}`;
   const init = {
@@ -14661,7 +14861,7 @@ Unexpected error: ${outerError.message}`));
   }
 }
 var program = new Command();
-program.name("sparkecoder").description("AI coding agent - just type sparkecoder to start chatting").version("0.1.0").option("-s, --session <id>", "Resume an existing session").option("-n, --name <name>", "Name for the new session").option("-m, --model <model>", "Model to use").option("-w, --working-dir <path>", "Working directory").option("-c, --config <path>", "Path to config file").option("-p, --port <port>", "Server port", "3141").option("-H, --host <host>", "Server host", "127.0.0.1").option("--no-auto-start", "Do not auto-start server if not running").option("--web-port <port>", "Web UI port", "6969").option("--no-web", "Do not start web UI when auto-starting server").option("--public-url <url>", "Public URL for web UI to connect to API (for Docker/remote access)").option("-v, --verbose", "Enable verbose logging for web server").option("--dangerously-skip-approvals", "Auto-approve all tool calls (no confirmation prompts)").option("--enable-computer-use", "Enable the Anthropic computer use tool for all new sessions by default (macOS only)").action(async (options) => {
+program.name("sparkecoder").description("AI coding agent - just type sparkecoder to start chatting").version(getCliVersion()).option("-s, --session <id>", "Resume an existing session").option("-n, --name <name>", "Name for the new session").option("-m, --model <model>", "Model to use").option("-w, --working-dir <path>", "Working directory").option("-c, --config <path>", "Path to config file").option("-p, --port <port>", "Server port", "3141").option("-H, --host <host>", "Server host", "127.0.0.1").option("--no-auto-start", "Do not auto-start server if not running").option("--web-port <port>", "Web UI port", "6969").option("--no-web", "Do not start web UI when auto-starting server").option("--public-url <url>", "Public URL for web UI to connect to API (for Docker/remote access)").option("-v, --verbose", "Enable verbose logging for web server").option("--dangerously-skip-approvals", "Auto-approve all tool calls (no confirmation prompts)").option("--enable-computer-use", "Enable the Anthropic computer use tool for all new sessions by default (macOS only)").action(async (options) => {
   if (options.enableComputerUse) {
     process.env.SPARKECODER_COMPUTER_USE = "1";
     console.log(chalk.cyan("\u2192 Computer use enabled by default for new sessions."));
@@ -14842,6 +15042,114 @@ program.command("init").description("Create a sparkecoder.config.json file").opt
   console.log(chalk.dim(`  ${configPath}`));
   console.log(chalk.dim("Set AI_GATEWAY_API_KEY and run sparkecoder to start"));
 });
+program.command("personal-agent-setup").description("Create a personal-agent setup folder with env, key, start script, and launchd plist template").option("-d, --dir <path>", "Setup directory", "~/sparkecoder-personal-agent").option("--dashboard <url>", "Personal Agents dashboard URL").option("--device-name <name>", "Friendly device name").option("--device-api-url <url>", "Public API URL for this device (port 3141 tunnel)").option("--device-web-url <url>", "Public web UI URL for this device (port 6969 tunnel)").option("--remote-url <url>", "SparkECoder remote server URL (optional; defaults to production config)").option("--auth-key <key>", "SparkECoder remote server auth key (optional; auto-registers if omitted)").option("--ingest-token <token>", "Dashboard PERSONAL_AGENT_INGEST_TOKEN").option("--public-key <pem>", "Dashboard signing public key PEM string").option("--accept-signed-only", "Include --accept-signed-only in generated commands", true).option("--enable-computer-use", "Include --enable-computer-use in generated commands", true).action(async (options) => {
+  const expandHome = (p) => p.startsWith("~/") ? join14(process.env.HOME || process.cwd(), p.slice(2)) : p;
+  const setupDir = resolve11(expandHome(options.dir));
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (label, fallback = "") => new Promise((resolve12) => {
+    const suffix = fallback ? ` (${fallback})` : "";
+    rl.question(`${label}${suffix}: `, (answer) => resolve12(answer.trim() || fallback));
+  });
+  try {
+    const dashboard = options.dashboard || await ask("Dashboard URL", "https://personal-agents.studyfetchcms.com");
+    const name = options.deviceName || await ask("Device name", hostname4().replace(/\.local$/, ""));
+    const publicUrl = options.deviceApiUrl || await ask("Public API URL (3141 tunnel)");
+    const webUrl = options.deviceWebUrl || await ask("Public web URL (6969 tunnel)", publicUrl.replace(/3141/g, "6969"));
+    const remoteUrl = options.remoteUrl || await ask("SparkECoder remote server URL (blank = default)", "");
+    const authKey3 = options.authKey || "";
+    const ingestToken = options.ingestToken || await ask("PERSONAL_AGENT_INGEST_TOKEN");
+    const publicKey = options.publicKey || await ask("Signing public key PEM (paste single-line with \\n escapes, or leave blank and edit file)");
+    rl.close();
+    mkdirSync9(setupDir, { recursive: true });
+    const normalizedPublicKey = publicKey.replace(/\\n/g, "\n").trim();
+    const keyPath = join14(setupDir, "personal-agent-public-key.pem");
+    const envPath = join14(setupDir, "personal-agent.env");
+    const startPath = join14(setupDir, "start-personal-agent.sh");
+    const plistPath = join14(setupDir, "com.studyfetch.personal-agent.plist");
+    const logsDir = join14(process.env.HOME || setupDir, "Library", "Logs", "PersonalAgents");
+    const sparkecoderBin = process.env.SPARKECODER_BIN || process.argv[1] || "sparkecoder";
+    if (normalizedPublicKey) {
+      writeFileSync6(keyPath, normalizedPublicKey + "\n", { mode: 384 });
+    } else if (!existsSync20(keyPath)) {
+      writeFileSync6(keyPath, "PASTE_PUBLIC_KEY_HERE\n", { mode: 384 });
+    }
+    writeFileSync6(envPath, [
+      shellExport("PERSONAL_AGENT_DASHBOARD", dashboard),
+      shellExport("PERSONAL_AGENT_NAME", name),
+      shellExport("PERSONAL_AGENT_PUBLIC_URL", publicUrl),
+      shellExport("PERSONAL_AGENT_WEB_URL", webUrl),
+      shellExport("PERSONAL_AGENT_INGEST_TOKEN", ingestToken),
+      shellExport("PERSONAL_AGENT_PUBLIC_KEY", keyPath),
+      ...remoteUrl ? [shellExport("SPARKECODER_REMOTE_URL", remoteUrl)] : [],
+      ...authKey3 ? [shellExport("SPARKECODER_AUTH_KEY", authKey3)] : [],
+      ""
+    ].join("\n"), { mode: 384 });
+    const flags = [
+      "server",
+      "--personal-agent-mode",
+      '--personal-agent-dashboard "$PERSONAL_AGENT_DASHBOARD"',
+      '--personal-agent-name "$PERSONAL_AGENT_NAME"',
+      '--personal-agent-public-url "$PERSONAL_AGENT_PUBLIC_URL"',
+      '--personal-agent-web-url "$PERSONAL_AGENT_WEB_URL"',
+      '--personal-agent-ingest-token "$PERSONAL_AGENT_INGEST_TOKEN"',
+      '--personal-agent-public-key "$PERSONAL_AGENT_PUBLIC_KEY"',
+      ...options.acceptSignedOnly ? ["--accept-signed-only"] : [],
+      ...options.enableComputerUse ? ["--enable-computer-use"] : []
+    ];
+    writeFileSync6(startPath, [
+      "#!/usr/bin/env bash",
+      "set -euo pipefail",
+      `source "${envPath}"`,
+      `exec '${sparkecoderBin.replace(/'/g, `'\\''`)}' ${flags.join(" \\\n  ")}`,
+      ""
+    ].join("\n"), { mode: 493 });
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>com.studyfetch.personal-agent</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${xmlEscape(startPath)}</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+    <key>HOME</key><string>${xmlEscape(process.env.HOME || "")}</string>
+  </dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>ThrottleInterval</key><integer>10</integer>
+  <key>StandardOutPath</key><string>${xmlEscape(join14(logsDir, "sparkecoder.log"))}</string>
+  <key>StandardErrorPath</key><string>${xmlEscape(join14(logsDir, "sparkecoder.err.log"))}</string>
+</dict>
+</plist>
+`;
+    writeFileSync6(plistPath, plist, { mode: 384 });
+    mkdirSync9(logsDir, { recursive: true });
+    try {
+      chmodSync(envPath, 384);
+      chmodSync(keyPath, 384);
+      chmodSync(plistPath, 384);
+      chmodSync(startPath, 493);
+    } catch {
+    }
+    console.log(chalk.green("\n\u2713 Personal Agent setup folder created"));
+    console.log(chalk.dim(`  ${setupDir}`));
+    console.log("");
+    console.log(chalk.bold("Smoke test:"));
+    console.log(chalk.cyan(`  "${startPath}"`));
+    console.log("");
+    console.log(chalk.bold("Install launchd unit:"));
+    console.log(chalk.cyan(`  cp "${plistPath}" "$HOME/Library/LaunchAgents/com.studyfetch.personal-agent.plist"`));
+    console.log(chalk.cyan(`  launchctl bootstrap "gui/$UID" "$HOME/Library/LaunchAgents/com.studyfetch.personal-agent.plist"`));
+    console.log(chalk.cyan(`  launchctl kickstart -k "gui/$UID/com.studyfetch.personal-agent"`));
+  } catch (error) {
+    rl.close();
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+});
 program.command("sessions").description("List all sessions").option("-l, --limit <limit>", "Number of sessions to show", "20").option("-p, --port <port>", "Server port", "3141").option("-H, --host <host>", "Server host", "127.0.0.1").action(async (options) => {
   const baseUrl = `http://${options.host}:${options.port}`;
   try {
@@ -15089,10 +15397,10 @@ program.command("search").description("Search indexed repository using semantic
     process.exit(1);
   }
 });
-program.command("api-key").description("Manage API keys for AI providers").argument("[provider]", "Provider name (anthropic, openai, google, xai, ai-gateway)").argument("[key]", "API key to set (if not provided, shows status)").option("-l, --list", "List all API key statuses").action((provider, key, options) => {
+program.command("api-key").description("Manage API keys for AI providers").argument("[provider]", "Provider name (anthropic, openai, google, xai, ai-gateway)").argument("[key]", "API key to set (if not provided, shows status)").option("-l, --list", "List all API key statuses").action((provider, key2, options) => {
   try {
     ensureAppDataDirectory();
-    if (options.list || !provider && !key) {
+    if (options.list || !provider && !key2) {
       console.log(chalk.bold("\nAPI Key Status:\n"));
       const status = getApiKeyStatus();
       for (const s of status) {
@@ -15112,8 +15420,8 @@ program.command("api-key").description("Manage API keys for AI providers").argum
       console.log(chalk.dim(`Usage: sparkecoder api-key <provider> <key>`));
       return;
     }
-    if (provider && key) {
-      setApiKey(provider, key);
+    if (provider && key2) {
+      setApiKey(provider, key2);
       const status = getApiKeyStatus();
       const providerStatus = status.find((s) => s.provider === provider.toLowerCase());
       console.log(chalk.green(`
@@ -15125,7 +15433,7 @@ program.command("api-key").description("Manage API keys for AI providers").argum
 The key is stored securely and will be loaded automatically on startup.`));
       return;
     }
-    if (provider && !key) {
+    if (provider && !key2) {
       const status = getApiKeyStatus();
       const providerStatus = status.find((s) => s.provider === provider.toLowerCase());
       if (!providerStatus) {