@trydecember/cli 0.3.28 → 0.3.29

package/dist/december.js

@@ -65,7 +65,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@trydecember/cli",
-    version: "0.3.28",
+    version: "0.3.29",
     description: "a coding agent for terminal and cloud.",
     homepage: "https://trydecember.com",
     repository: {
@@ -107052,6 +107052,28 @@ async function exchangeGitHubTokenForCopilot(githubOAuthToken) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => "");
+    let parsedJson = null;
+    try {
+      parsedJson = JSON.parse(text);
+    } catch {}
+    if (res.status === 403) {
+      const errorDetails = parsedJson?.error_details;
+      if (errorDetails?.notification_id === "no_copilot_access") {
+        const detailMsg = errorDetails.message || "";
+        const userMatch = detailMsg.match(/logged in as ([^.]+)/i);
+        const userNotice = userMatch ? ` for account @${userMatch[1].trim()}` : "";
+        throw new Error(`No active GitHub Copilot subscription found${userNotice}. ${detailMsg} Please sign up at https://github.com/github-copilot/signup or ensure your browser is logged into an authorized GitHub account.`);
+      }
+      if (errorDetails?.message) {
+        throw new Error(`GitHub Copilot subscription verification failed (403): ${errorDetails.message}`);
+      }
+      if (parsedJson?.message) {
+        throw new Error(`GitHub Copilot subscription verification failed (403): ${parsedJson.message}`);
+      }
+    }
+    if (parsedJson?.message) {
+      throw new Error(`Failed to exchange GitHub token for Copilot token (${res.status}): ${parsedJson.message}`);
+    }
     throw new Error(`Failed to exchange GitHub token for Copilot token (${res.status}): ${text}`);
   }
   const data = await res.json();
@@ -107207,7 +107229,11 @@ var init_copilot2 = __esm(() => {
       try {
         exchangeResult = await exchangeGitHubTokenForCopilot(ghOAuthToken);
       } catch (err) {
-        throw new Error(`GitHub Copilot subscription verification failed. Please make sure your GitHub account has an active Copilot subscription and that external integrations are allowed by your organization. (${err?.message || err})`, { cause: err });
+        const msg = err?.message || String(err);
+        if (msg.includes("No active GitHub Copilot subscription") || msg.includes("GitHub Copilot subscription verification failed")) {
+          throw err;
+        }
+        throw new Error(`GitHub Copilot subscription verification failed. Please make sure your GitHub account has an active Copilot subscription and that external integrations are allowed by your organization. (${msg})`, { cause: err });
       }
       const copilotToken = exchangeResult.token;
       const endpoint = exchangeResult.endpoint;
@@ -109462,6 +109488,9 @@ Initiating subscription login for ${providerName}...`);
       console.log(`
 Please open ${uri} in your browser and enter code: ${code}
 Waiting for authorization...`);
+      if (targetProvider === "copilot" || targetProvider === "github") {
+        console.log("*(Note: Ensure your browser is signed into the GitHub account that owns your active Copilot subscription)*");
+      }
     });
     const configToSave = await loadConfig();
     configToSave.subscriptions = configToSave.subscriptions || {};
@@ -114460,10 +114489,11 @@ function formatError(e) {
   } catch {}
   return String(e) || "Unknown error";
 }
-async function* runAgentLoop(agent, userInput) {
+async function* runAgentLoop(agent, userInput, options) {
   const eventQueue = new AsyncQueue2;
   const abortController = new AbortController;
   agent.activeAbortController = abortController;
+  const isReadOnly = Boolean(options?.readOnly || typeof userInput === "object" && userInput !== null && userInput.readOnly);
   if (userInput) {
     if (typeof userInput === "string") {
       agent.addMessage({ role: "user", content: userInput });
@@ -114486,7 +114516,9 @@ async function* runAgentLoop(agent, userInput) {
         });
       } catch {}
       eventQueue.push({ type: "AgentStart" });
-      await runOuterLoop(agent, eventQueue, abortController.signal);
+      await runOuterLoop(agent, eventQueue, abortController.signal, {
+        readOnly: isReadOnly
+      });
       try {
         if (abortController.signal.aborted) {
           agent.tracer?.endSession("ABORTED");
@@ -114525,9 +114557,9 @@ async function* runAgentLoop(agent, userInput) {
   })();
   yield* eventQueue;
 }
-async function runOuterLoop(agent, eventQueue, signal) {
+async function runOuterLoop(agent, eventQueue, signal, options) {
   while (!signal.aborted) {
-    await runInnerLoop(agent, eventQueue, signal);
+    await runInnerLoop(agent, eventQueue, signal, options);
     if (signal.aborted)
       break;
     if (agent.followUpQueue.length > 0) {
@@ -114540,7 +114572,7 @@ async function runOuterLoop(agent, eventQueue, signal) {
     break;
   }
 }
-async function runInnerLoop(agent, eventQueue, signal) {
+async function runInnerLoop(agent, eventQueue, signal, options) {
   let isDone = false;
   let turnCount = 0;
   while (!isDone && turnCount < 100 && !signal.aborted) {
@@ -114561,7 +114593,7 @@ async function runInnerLoop(agent, eventQueue, signal) {
       }
     }
     eventQueue.push({ type: "TurnStart" });
-    const { assistantMessage, toolCalls, error } = await streamAssistantResponse(agent, eventQueue, signal, turnCount);
+    const { assistantMessage, toolCalls, error } = await streamAssistantResponse(agent, eventQueue, signal, turnCount, options);
     if (error || signal.aborted) {
       break;
     }
@@ -114574,7 +114606,7 @@ async function runInnerLoop(agent, eventQueue, signal) {
         content: assistantMessage,
         toolCalls
       });
-      await executeToolCalls(agent, toolCalls, eventQueue, signal);
+      await executeToolCalls(agent, toolCalls, eventQueue, signal, options);
     }
     await agent.saveContext();
     eventQueue.push({ type: "TurnEnd" });
@@ -114595,7 +114627,7 @@ async function runInnerLoop(agent, eventQueue, signal) {
     }
   }
 }
-async function streamAssistantResponse(agent, eventQueue, signal, turnCount = 1) {
+async function streamAssistantResponse(agent, eventQueue, signal, turnCount = 1, options) {
   let assistantMessage = "";
   let toolCalls = [];
   let thinkingText = "";
@@ -114621,7 +114653,7 @@ async function streamAssistantResponse(agent, eventQueue, signal, turnCount = 1)
         });
       }
       const isConversational = isSimpleConversationalTurn(agent.messages);
-      const activeTools = isConversational ? Array.from(agent.tools.values()).filter((t) => ["read_file", "ls", "ask_question"].includes(t.name)) : Array.from(agent.tools.values());
+      const activeTools = options?.readOnly ? Array.from(agent.tools.values()).filter((t) => READ_ONLY_TOOLS.has(t.name)) : isConversational ? Array.from(agent.tools.values()).filter((t) => ["read_file", "ls", "ask_question"].includes(t.name)) : Array.from(agent.tools.values());
       const toolsArray = activeTools.map((t, idx) => ({
         name: t.name,
         description: t.description ? t.description.replace(/\s+/g, " ").trim() : "",
@@ -114858,7 +114890,7 @@ ${errorMsg}`;
     return { assistantMessage, toolCalls, error: errorMsg };
   }
 }
-async function executeToolCalls(agent, toolCalls, eventQueue, signal) {
+async function executeToolCalls(agent, toolCalls, eventQueue, signal, options) {
   const isSequentialTool = (tc) => {
     const tool = agent.tools.get(tc.name);
     return tool?.executionMode === "sequential" || ["bash", "write_file", "edit_file", "edit_diff"].includes(tc.name);
@@ -114873,18 +114905,34 @@ async function executeToolCalls(agent, toolCalls, eventQueue, signal) {
     }
   }
   if (parallelReadCalls.length > 0) {
-    await executeToolCallsParallel(agent, parallelReadCalls, eventQueue, signal);
+    await executeToolCallsParallel(agent, parallelReadCalls, eventQueue, signal, options);
   }
   if (sequentialWriteCalls.length > 0 && !signal.aborted) {
-    await executeToolCallsSequential(agent, sequentialWriteCalls, eventQueue, signal);
+    await executeToolCallsSequential(agent, sequentialWriteCalls, eventQueue, signal, options);
   }
 }
-async function executeSingleTool(agent, toolCall, eventQueue, signal) {
+async function executeSingleTool(agent, toolCall, eventQueue, signal, options) {
   const toolStartTime = Date.now();
   eventQueue.push({ type: "ToolCallStart", toolCall });
   const tool = agent.tools.get(toolCall.name);
   let resultStr = "";
   let errorStr = undefined;
+  if (options?.readOnly && !READ_ONLY_TOOLS.has(toolCall.name)) {
+    errorStr = `Tool execution blocked: '${toolCall.name}' is not permitted in read-only / ask mode.`;
+    const res = { toolCallId: toolCall.id, result: "", error: errorStr };
+    eventQueue.push({ type: "ToolCallResult", result: res });
+    try {
+      agent.tracer?.recordToolExecution({
+        toolCallId: toolCall.id,
+        toolName: toolCall.name,
+        input: toolCall.input,
+        output: "",
+        error: errorStr,
+        durationMs: Date.now() - toolStartTime
+      });
+    } catch {}
+    return { toolCall, toolResult: res, resultStr: "", errorStr };
+  }
   if (agent.operations?.ui?.requestPermission) {
     const hookRes = await agent.operations.ui.requestPermission(toolCall);
     if (hookRes?.block) {
@@ -114949,11 +114997,11 @@ async function executeSingleTool(agent, toolCall, eventQueue, signal) {
   eventQueue.push({ type: "ToolCallResult", result: toolResult });
   return { toolCall, toolResult, resultStr: toolResult.result, errorStr: toolResult.error };
 }
-async function executeToolCallsSequential(agent, toolCalls, eventQueue, signal) {
+async function executeToolCallsSequential(agent, toolCalls, eventQueue, signal, options) {
   for (const toolCall of toolCalls) {
     if (signal.aborted)
       break;
-    const r = await executeSingleTool(agent, toolCall, eventQueue, signal);
+    const r = await executeSingleTool(agent, toolCall, eventQueue, signal, options);
     let finalContent = r.resultStr || "";
     if (r.errorStr) {
       finalContent = `Tool execution failed: ${r.errorStr}
@@ -114966,8 +115014,8 @@ Please adjust your arguments and try again.`;
     });
   }
 }
-async function executeToolCallsParallel(agent, toolCalls, eventQueue, signal) {
-  const promises = toolCalls.map((tc) => executeSingleTool(agent, tc, eventQueue, signal));
+async function executeToolCallsParallel(agent, toolCalls, eventQueue, signal, options) {
+  const promises = toolCalls.map((tc) => executeSingleTool(agent, tc, eventQueue, signal, options));
   const results = await Promise.all(promises);
   for (const r of results) {
     let finalContent = r.resultStr || "";
@@ -114982,7 +115030,7 @@ Please adjust your arguments and try again.`;
     });
   }
 }
-var AsyncQueue2;
+var AsyncQueue2, READ_ONLY_TOOLS;
 var init_agent_loop = __esm(() => {
   init_src();
   init_p_retry();
@@ -115023,6 +115071,15 @@ var init_agent_loop = __esm(() => {
       }
     }
   };
+  READ_ONLY_TOOLS = new Set([
+    "read_file",
+    "ls",
+    "find_files",
+    "grep_search",
+    "web_search",
+    "browser",
+    "ask_question"
+  ]);
 });
 // ../../packages/agent/src/harness/agent-harness.ts
 import fs22 from "node:fs";
@@ -115032,18 +115089,21 @@ function isReasoningModel(model, thinkingLevel) {
     return thinkingLevel !== undefined && thinkingLevel !== "off";
   }
   const m = model.toLowerCase();
-  if (m.includes("o1") || m.includes("o3") || m.includes("deepseek-reasoner") || m.includes("deepseek-r1")) {
+  if (m.includes("o1") || m.includes("o3") || m.includes("deepseek-reasoner") || m.includes("deepseek-r1") || m.includes("thinking")) {
     return true;
   }
   if (m.includes("claude") && thinkingLevel && thinkingLevel !== "off") {
     return true;
   }
+  if (m.includes("gemini") && (m.includes("gemini-2.5") || thinkingLevel !== undefined && thinkingLevel !== "off")) {
+    return true;
+  }
   return false;
 }
 function getModelFamilyPrompt(options) {
   const model = options.model?.toLowerCase() || "";
   const reasoning = isReasoningModel(options.model, options.thinkingLevel);
-  if (reasoning) {
+  if (reasoning && !model.includes("gemini")) {
     return {
       roleGuidelines: `### Model Specialization (Autonomous Reasoning & Verification)
 - Persistent Problem Solving: Keep going until the user's task or bug is completely resolved and empirically verified before ending your turn.
@@ -115068,24 +115128,26 @@ function getModelFamilyPrompt(options) {
     };
   }
   if (model.includes("gemini")) {
+    const isGeminiThinking = model.includes("thinking") || model.includes("gemini-2.5") || options.thinkingLevel !== undefined && options.thinkingLevel !== "off";
     return {
       roleGuidelines: `### Model Specialization (Gemini)
 - Structured Execution: Follow clear operational phases: 1) Explore and gather context, 2) Formulate targeted edits, 3) Verify thoroughly.
 - Absolute File Paths: STRICTLY specify absolute file paths when referencing, viewing, or editing files. NEVER output ambiguous relative paths.`,
-      reasoningProtocol: `### Reasoning & Communication Protocol
+      reasoningProtocol: isGeminiThinking ? `### Communication Protocol
+- Conciseness & Chat Focus: Be direct and concise. In chat messages, provide ONLY high-level status updates, architectural decisions, and tool confirmations. Do not repeat file contents in chat.
+- Execution Summary: At the end of your work, provide a concise summary (max 4-5 lines, single cohesive paragraph) highlighting key actions, modified files, and test verification results.` : `### Reasoning & Communication Protocol
 - Thought Enclosure: Before calling any tool, you MUST enclose your step-by-step reasoning inside <thought>...</thought> tags. Write thoughts directly as natural, concise reasoning steps without outline scaffolding, markdown headers, or bullet lists (do NOT write labels like "* **Goal Understanding:**" or structured outlines).
 - Conciseness & Chat Focus: Be direct and concise. In chat messages, provide ONLY high-level status updates, architectural decisions, and tool confirmations. Do not repeat file contents in chat.
 - Execution Summary: At the end of your work, provide a concise summary (max 4-5 lines, single cohesive paragraph) highlighting key actions, modified files, and test verification results.`,
-      suppressThoughtTags: false
+      suppressThoughtTags: isGeminiThinking
     };
   }
   return {
     roleGuidelines: "",
-    reasoningProtocol: `### Reasoning & Communication Protocol
-- Thought Enclosure: Before calling any tool, you MUST enclose your step-by-step reasoning inside <thought>...</thought> tags. Write thoughts directly as natural, concise reasoning steps without outline scaffolding, markdown headers, or bullet lists (do NOT write labels like "* **Goal Understanding:**" or structured outlines).
+    reasoningProtocol: `### Communication Protocol
 - Conciseness & Chat Focus: Be direct and concise. In chat messages, provide ONLY high-level status updates, architectural decisions, and tool confirmations. Do not repeat file contents in chat.
 - Execution Summary: At the end of your work, provide a concise summary (max 4-5 lines, single cohesive paragraph) highlighting key actions, modified files, and test verification results.`,
-    suppressThoughtTags: false
+    suppressThoughtTags: true
   };
 }
 function buildDynamicToolGuidelines(activeTools) {
@@ -115503,6 +115565,20 @@ Select an option or type your answer: `).then((answer) => {
     });
   };
   agent.operations.ui.requestPermission = async (toolCall) => {
+    if (options.readOnly && ![
+      "read_file",
+      "ls",
+      "find_files",
+      "grep_search",
+      "web_search",
+      "browser",
+      "ask_question"
+    ].includes(toolCall.name)) {
+      return {
+        block: true,
+        reason: `Tool '${toolCall.name}' is not allowed in read-only / ask mode.`
+      };
+    }
     if (isNonInteractive) {
       return { block: false };
     }
@@ -115546,7 +115622,7 @@ Execute ${toolCall.name}? (y/n): `);
         effectivePrompt = resolved.expandedPrompt;
       } catch {}
     }
-    const stream = runAgentLoop(agent, effectivePrompt);
+    const stream = runAgentLoop(agent, options.readOnly ? { content: effectivePrompt, readOnly: true } : effectivePrompt);
     for await (const event of stream) {
       switch (event.type) {
         case "StreamChunk":
@@ -168564,6 +168640,92 @@ var init_provider_factory = __esm(() => {
   init_subscription_manager();
 });
 
+// src/constants/prompts.ts
+var exports_prompts = {};
+__export(exports_prompts, {
+  getAskPrompt: () => getAskPrompt,
+  getGrillPrompt: () => getGrillPrompt,
+  getPlanExecutionPrompt: () => getPlanExecutionPrompt,
+  getPlanPrompt: () => getPlanPrompt,
+  getPlanRefinePrompt: () => getPlanRefinePrompt
+});
+var getGrillPrompt = (userPrompt, projectContext) => `You are a principal software architect interviewing a developer to align on a technical specification before implementation.
+
+The user wants to implement: "${userPrompt}"
+
+${projectContext ? `<project_context>
+${projectContext}
+</project_context>
+` : ""}
+Analyze the user's request and the project context. Generate between 1 and 4 targeted, high-impact multiple-choice questions to clarify critical requirements, architectural choices, tech stack decisions, and edge cases. If the task is simple and unambiguous, generate fewer questions (e.g. 1 or 2). Do not ask more than 4 questions.
+
+Requirements for questions:
+1. Focus on technical depth: probe architectural tradeoffs, API design, state management, edge cases, and error handling.
+2. Each question MUST have 2 to 3 distinct, concrete options representing clear design choices.
+3. Leverage the provided project context (if available) to tailor choices specifically to the existing codebase patterns.
+
+Return the output strictly as a JSON array of objects with the following schema:
+[
+  {
+    "question": "Question text?",
+    "options": ["Option 1 (Design choice A)", "Option 2 (Design choice B)", "Option 3 (Design choice C)"]
+  }
+]
+
+Do not include any other text, markdown formatting, or code blocks. Return raw JSON only.`, getPlanPrompt = (originalPrompt, qaPairs) => `You are an autonomous software engineer.
+The user wants to implement: "${originalPrompt}"
+${qaPairs && qaPairs.length > 0 ? `Here is the alignment interview results:
+${qaPairs.map((qa) => `Q: ${qa.question}
+A: ${qa.answer}`).join(`
+
+`)}
+` : ""}
+Please create a detailed, step-by-step implementation plan based on these requirements.
+Do NOT execute any tools. Only describe the plan.
+Start your response with '### Implementation Plan' and list the concrete steps.
+Explain which files need to be created, modified, or deleted, and what the changes will be.`, getPlanExecutionPrompt = (originalPrompt, planText, qaPairs) => `You are an autonomous software engineer.
+The user has approved the implementation plan for: "${originalPrompt}".
+
+${qaPairs && qaPairs.length > 0 ? `Key alignment decisions from the interview:
+${qaPairs.map((qa) => `Q: ${qa.question}
+A: ${qa.answer}`).join(`
+
+`)}
+
+` : ""}Approved Implementation Plan:
+${planText}
+
+You are now in execution mode. Proceed with implementation immediately.
+Execute the plan step-by-step using your available tools (file editing, file creation, bash commands).
+Do not wait for further confirmation before starting tool execution.
+Report your progress as you complete each step.
+If a tool execution fails or encounters unexpected errors, do not repeat the failing action in a loop. Assess the failure, adjust your approach or remaining steps, and if critical information is missing, ask for clarification.`, getPlanRefinePrompt = (originalPrompt, previousPlan, feedback, qaPairs) => `You are an autonomous software engineer.
+The user wants to implement: "${originalPrompt}"
+
+${qaPairs && qaPairs.length > 0 ? `Previous alignment interview results:
+${qaPairs.map((qa) => `Q: ${qa.question}
+A: ${qa.answer}`).join(`
+
+`)}
+
+` : ""}Previous Implementation Plan:
+${previousPlan}
+
+The user provided the following feedback to refine the plan:
+"${feedback}"
+
+Please update and refine the detailed, step-by-step implementation plan based on this feedback.
+Do NOT execute any tools. Only describe the updated plan.
+Start your response with '### Implementation Plan' and list the concrete updated steps.
+Explain which files need to be created, modified, or deleted, and what the changes will be.`, getAskPrompt = (question) => `You are in Ask mode (read-only Q&A).
+The user is asking: "${question}"
+
+Guidelines:
+1. Answer the user's question thoroughly, clearly, and accurately based on the codebase.
+2. You can use your available tools (search, read files, list directories, search web) to inspect and verify code facts.
+3. You CANNOT and MUST NOT modify any files, write new files, or run bash/terminal commands.
+4. Provide comprehensive explanations, referencing relevant file paths, types, functions, and code snippets directly in your answer.`;
+
 // ../../node_modules/.bun/react@19.2.7/node_modules/react/cjs/react.development.js
 var require_react_development = __commonJS(function(exports, module) {
   (function() {
@@ -207370,6 +207532,12 @@ var init_commands2 = __esm(() => {
   init_clipboard();
   init_handoff();
   COMMANDS = [
+    {
+      name: "ask",
+      description: "Ask a question about the codebase (read-only Q&A mode)",
+      value: "/ask",
+      action: (ctx) => {}
+    },
     {
       name: "clear",
       description: "Clear conversation history",
@@ -208573,6 +208741,7 @@ var init_input_bar = __esm(async () => {
       setValue("");
       handleContentChange("");
       const forwardCommands = [
+        "/ask",
         "/grill",
         "/grill-me",
         "/login",
@@ -253981,19 +254150,114 @@ function formatThought(raw) {
   return cleanedLines.join(`
 `);
 }
-function ThoughtView({ content }) {
+function CollapsibleThought({
+  content,
+  isStreaming,
+  forceExpanded,
+  durationMs
+}) {
+  const [elapsedSeconds, setElapsedSeconds] = import_react47.useState(0);
+  const startTimeRef = import_react47.useRef(null);
+  const finalDurationRef = import_react47.useRef(null);
+  import_react47.useEffect(() => {
+    if (!isStreaming) {
+      if (startTimeRef.current) {
+        const totalElapsed = (Date.now() - startTimeRef.current) / 1000;
+        const finalSec = Math.round(totalElapsed * 10) / 10;
+        finalDurationRef.current = Math.max(0.1, finalSec);
+        setElapsedSeconds(finalSec);
+        startTimeRef.current = null;
+      }
+      return;
+    }
+    if (!startTimeRef.current) {
+      startTimeRef.current = Date.now();
+    }
+    const timer = setInterval(() => {
+      if (startTimeRef.current) {
+        const diff = (Date.now() - startTimeRef.current) / 1000;
+        setElapsedSeconds(Math.round(diff * 10) / 10);
+      }
+    }, 100);
+    return () => clearInterval(timer);
+  }, [isStreaming]);
   const formatted = formatThought(content);
-  if (!formatted)
+  if (!formatted && !isStreaming)
     return null;
-  return /* @__PURE__ */ jsx_runtime14.jsx(Box_default, {
+  const words = formatted.trim() ? formatted.trim().split(/\s+/).length : 0;
+  const tokenCount = Math.max(1, Math.round(words * 1.33));
+  const displayDuration = durationMs !== undefined ? (durationMs / 1000).toFixed(1) : finalDurationRef.current !== null && finalDurationRef.current > 0 ? finalDurationRef.current.toFixed(1) : elapsedSeconds > 0 ? elapsedSeconds.toFixed(1) : Math.max(0.5, Math.round(words / 25 * 10) / 10).toFixed(1);
+  if (isStreaming) {
+    return /* @__PURE__ */ jsx_runtime14.jsxs(Box_default, {
+      flexDirection: "row",
+      marginY: 0,
+      gap: 1,
+      alignItems: "center",
+      children: [
+        /* @__PURE__ */ jsx_runtime14.jsx(Text3, {
+          color: THEME.colors.brand,
+          bold: true,
+          children: "✱"
+        }),
+        /* @__PURE__ */ jsx_runtime14.jsx(Text3, {
+          color: THEME.colors.text,
+          children: "Thinking"
+        }),
+        /* @__PURE__ */ jsx_runtime14.jsxs(Text3, {
+          color: THEME.colors.muted,
+          children: [
+            "(",
+            displayDuration,
+            "s)..."
+          ]
+        })
+      ]
+    });
+  }
+  const isExpanded = forceExpanded ?? false;
+  const formattedLines = formatted.split(/\r?\n/).filter((l) => l.trim() !== "");
+  return /* @__PURE__ */ jsx_runtime14.jsxs(Box_default, {
     flexDirection: "column",
-    paddingLeft: 1,
     marginY: 0,
-    children: /* @__PURE__ */ jsx_runtime14.jsx(Text3, {
-      color: THEME.colors.muted,
-      italic: true,
-      children: formatted
-    })
+    children: [
+      /* @__PURE__ */ jsx_runtime14.jsxs(Box_default, {
+        flexDirection: "row",
+        gap: 1,
+        alignItems: "center",
+        children: [
+          /* @__PURE__ */ jsx_runtime14.jsx(Text3, {
+            color: THEME.colors.muted,
+            children: "✱"
+          }),
+          /* @__PURE__ */ jsx_runtime14.jsxs(Text3, {
+            color: THEME.colors.muted,
+            children: [
+              "Thought for ",
+              displayDuration,
+              "s (",
+              tokenCount,
+              " tokens)"
+            ]
+          }),
+          /* @__PURE__ */ jsx_runtime14.jsxs(Text3, {
+            color: THEME.colors.muted,
+            children: [
+              "· ctrl+o to ",
+              isExpanded ? "collapse" : "view"
+            ]
+          })
+        ]
+      }),
+      isExpanded && formattedLines.length > 0 && /* @__PURE__ */ jsx_runtime14.jsx(Box_default, {
+        flexDirection: "column",
+        paddingLeft: 2,
+        marginTop: 0,
+        children: formattedLines.map((line, lidx) => /* @__PURE__ */ jsx_runtime14.jsx(Text3, {
+          color: THEME.colors.muted,
+          children: line
+        }, lidx))
+      })
+    ]
   });
 }
 function StyledCommand({ command, truncate = true }) {
@@ -254192,9 +254456,13 @@ var init_bot_message = __esm(async () => {
                 }),
                 parts.map((part, pidx) => {
                   if (/^<(?:thought|think)(?:>| [^>]*>)/i.test(part)) {
+                    const isClosed = /<\/(?:thought|think)>$/i.test(part);
+                    const isStreaming = !isClosed && idx === blocks.length - 1 && pidx === parts.length - 1;
                     const thoughtContent = part.replace(/^<(?:thought|think)(?:>| [^>]*>)/i, "").replace(/<\/(?:thought|think)>$/i, "").trim();
-                    return /* @__PURE__ */ jsx_runtime14.jsx(ThoughtView, {
-                      content: thoughtContent
+                    return /* @__PURE__ */ jsx_runtime14.jsx(CollapsibleThought, {
+                      content: thoughtContent,
+                      isStreaming,
+                      forceExpanded: expandCommands
                     }, pidx);
                   }
                   if (part.trim() === "")
@@ -254248,8 +254516,11 @@ var init_bot_message = __esm(async () => {
             }, idx);
           }
           case "thinking": {
-            return /* @__PURE__ */ jsx_runtime14.jsx(ThoughtView, {
-              content: block.content
+            return /* @__PURE__ */ jsx_runtime14.jsx(CollapsibleThought, {
+              content: block.content,
+              isStreaming: block.isStreaming,
+              durationMs: block.durationMs,
+              forceExpanded: expandCommands
             }, idx);
           }
           case "compaction": {
@@ -257402,6 +257673,17 @@ function SubscriptionSelectMenu(props) {
             /* @__PURE__ */ jsx_runtime32.jsx(Text3, {
               color: isSelected ? THEME.colors.brand : THEME.colors.text,
               children: item.label
+            }),
+            item.hint && /* @__PURE__ */ jsx_runtime32.jsx(Box_default, {
+              marginLeft: 1,
+              children: /* @__PURE__ */ jsx_runtime32.jsxs(Text3, {
+                color: THEME.colors.muted,
+                children: [
+                  "(",
+                  item.hint,
+                  ")"
+                ]
+              })
             })
           ]
         }, item.value);
@@ -257432,19 +257714,23 @@ var init_subscription_select_menu = __esm(async () => {
   SUBSCRIPTION_MENU_ITEMS = [
     {
       label: "Anthropic (Claude)",
-      value: "claude"
+      value: "claude",
+      hint: "Requires Claude Pro or Max"
     },
     {
       label: "GitHub (Copilot)",
-      value: "copilot"
+      value: "copilot",
+      hint: "Requires active Copilot plan"
     },
     {
       label: "Google (Gemini / Antigravity)",
-      value: "gemini"
+      value: "gemini",
+      hint: "Requires Gemini Advanced / Antigravity"
     },
     {
       label: "OpenAI (ChatGPT)",
-      value: "codex"
+      value: "codex",
+      hint: "Requires ChatGPT Plus / Pro"
     }
   ];
 });
@@ -259038,77 +259324,6 @@ var init_messages5 = __esm(() => {
   };
 });
 
-// src/constants/prompts.ts
-var getGrillPrompt = (userPrompt, projectContext) => `You are a principal software architect interviewing a developer to align on a technical specification before implementation.
-
-The user wants to implement: "${userPrompt}"
-
-${projectContext ? `<project_context>
-${projectContext}
-</project_context>
-` : ""}
-Analyze the user's request and the project context. Generate between 1 and 4 targeted, high-impact multiple-choice questions to clarify critical requirements, architectural choices, tech stack decisions, and edge cases. If the task is simple and unambiguous, generate fewer questions (e.g. 1 or 2). Do not ask more than 4 questions.
-
-Requirements for questions:
-1. Focus on technical depth: probe architectural tradeoffs, API design, state management, edge cases, and error handling.
-2. Each question MUST have 2 to 3 distinct, concrete options representing clear design choices.
-3. Leverage the provided project context (if available) to tailor choices specifically to the existing codebase patterns.
-
-Return the output strictly as a JSON array of objects with the following schema:
-[
-  {
-    "question": "Question text?",
-    "options": ["Option 1 (Design choice A)", "Option 2 (Design choice B)", "Option 3 (Design choice C)"]
-  }
-]
-
-Do not include any other text, markdown formatting, or code blocks. Return raw JSON only.`, getPlanPrompt = (originalPrompt, qaPairs) => `You are an autonomous software engineer.
-The user wants to implement: "${originalPrompt}"
-${qaPairs && qaPairs.length > 0 ? `Here is the alignment interview results:
-${qaPairs.map((qa) => `Q: ${qa.question}
-A: ${qa.answer}`).join(`
-
-`)}
-` : ""}
-Please create a detailed, step-by-step implementation plan based on these requirements.
-Do NOT execute any tools. Only describe the plan.
-Start your response with '### Implementation Plan' and list the concrete steps.
-Explain which files need to be created, modified, or deleted, and what the changes will be.`, getPlanExecutionPrompt = (originalPrompt, planText, qaPairs) => `You are an autonomous software engineer.
-The user has approved the implementation plan for: "${originalPrompt}".
-
-${qaPairs && qaPairs.length > 0 ? `Key alignment decisions from the interview:
-${qaPairs.map((qa) => `Q: ${qa.question}
-A: ${qa.answer}`).join(`
-
-`)}
-
-` : ""}Approved Implementation Plan:
-${planText}
-
-You are now in execution mode. Proceed with implementation immediately.
-Execute the plan step-by-step using your available tools (file editing, file creation, bash commands).
-Do not wait for further confirmation before starting tool execution.
-Report your progress as you complete each step.
-If a tool execution fails or encounters unexpected errors, do not repeat the failing action in a loop. Assess the failure, adjust your approach or remaining steps, and if critical information is missing, ask for clarification.`, getPlanRefinePrompt = (originalPrompt, previousPlan, feedback, qaPairs) => `You are an autonomous software engineer.
-The user wants to implement: "${originalPrompt}"
-
-${qaPairs && qaPairs.length > 0 ? `Previous alignment interview results:
-${qaPairs.map((qa) => `Q: ${qa.question}
-A: ${qa.answer}`).join(`
-
-`)}
-
-` : ""}Previous Implementation Plan:
-${previousPlan}
-
-The user provided the following feedback to refine the plan:
-"${feedback}"
-
-Please update and refine the detailed, step-by-step implementation plan based on this feedback.
-Do NOT execute any tools. Only describe the updated plan.
-Start your response with '### Implementation Plan' and list the concrete updated steps.
-Explain which files need to be created, modified, or deleted, and what the changes will be.`;
-
 // ../../node_modules/.bun/zustand@5.0.14+93dbe784b8baa420/node_modules/zustand/esm/vanilla.mjs
 var createStoreImpl = (createState) => {
   let state;
@@ -260126,6 +260341,8 @@ function parseErrorMessage(err, context) {
           if (extracted)
             return extracted;
         }
+        if (typeof parsed.error_details?.message === "string")
+          return parsed.error_details.message;
         if (typeof parsed.error?.message === "string")
           return parsed.error.message;
         if (typeof parsed.message === "string")
@@ -260140,6 +260357,8 @@ function parseErrorMessage(err, context) {
       const jsonStr = str.slice(firstBrace, lastBrace + 1);
       try {
         const parsed = JSON.parse(jsonStr);
+        if (parsed?.error_details?.message && typeof parsed.error_details.message === "string")
+          return parsed.error_details.message;
         if (parsed?.error?.message && typeof parsed.error.message === "string")
           return parsed.error.message;
         if (parsed?.message && typeof parsed.message === "string")
@@ -260253,6 +260472,26 @@ function parseError(err, context) {
       hint: "Please switch models using `/model` (e.g. glm-5.2, gpt-5.5, claude-opus-4-6, glm-4-plus)."
     };
   }
+  const isCopilotNoAccess = combined.includes("no_copilot_access") || combined.includes("no access to github copilot") || combined.includes("no active github copilot subscription");
+  if (isCopilotNoAccess) {
+    let cause = explicitCause;
+    if (!cause) {
+      const match = fullMessage.match(/No access to GitHub Copilot found[^\n]*/i);
+      if (match) {
+        cause = match[0].trim();
+      } else {
+        const parts = fullMessage.split(`
+`);
+        cause = parts.length > 1 ? parts.slice(1).join(`
+`).trim() : fullMessage;
+      }
+    }
+    return {
+      message: "No active GitHub Copilot subscription found.",
+      cause,
+      hint: "Please subscribe at https://github.com/github-copilot/signup, ensure your browser is logged into the correct GitHub account, or use BYOK / Ollama instead."
+    };
+  }
   const isAuthError = combined.includes("401") || combined.includes("unauthorized") || combined.includes("invalid token") || combined.includes("access token expired") || combined.includes("session expired") || combined.includes("session not found");
   if (isAuthError) {
     const parts = fullMessage.split(`
@@ -260863,6 +261102,21 @@ async function processAgentStream({
 }) {
   let pendingEvents = [];
   let flushTimeout = null;
+  let thinkingStartTime = null;
+  const finalizeThinking = (bList) => {
+    if (thinkingStartTime) {
+      const elapsed = Date.now() - thinkingStartTime;
+      for (let i = bList.length - 1;i >= 0; i--) {
+        const b = bList[i];
+        if (b && b.type === "thinking" && b.isStreaming) {
+          b.isStreaming = false;
+          b.durationMs = elapsed;
+          break;
+        }
+      }
+      thinkingStartTime = null;
+    }
+  };
   const flush = () => {
     if (pendingEvents.length === 0)
       return;
@@ -260879,6 +261133,7 @@ async function processAgentStream({
             blocks.push({ type: "text", content: "Thinking..." });
             break;
           case "AgentError": {
+            finalizeThinking(blocks);
             const lastBlock = blocks[blocks.length - 1];
             if (lastBlock && (lastBlock.type === "thinking" || lastBlock.type === "text" && isStatusMessage(lastBlock.content))) {
               blocks.pop();
@@ -260893,6 +261148,7 @@ async function processAgentStream({
             break;
           }
           case "AgentInterrupt": {
+            finalizeThinking(blocks);
             const lastBlock = blocks[blocks.length - 1];
             if (lastBlock && lastBlock.type === "text" && isStatusMessage(lastBlock.content)) {
               lastBlock.content = "";
@@ -260918,6 +261174,7 @@ async function processAgentStream({
             break;
           }
           case "StreamChunk": {
+            finalizeThinking(blocks);
             if (!event.content)
               break;
             const lastBlock = blocks[blocks.length - 1];
@@ -260936,18 +261193,23 @@ async function processAgentStream({
             const chunk = event.content || "";
             if (!chunk)
               break;
+            if (!thinkingStartTime) {
+              thinkingStartTime = Date.now();
+            }
             const lastBlock = blocks[blocks.length - 1];
             if (lastBlock && lastBlock.type === "thinking") {
               lastBlock.content += chunk;
+              lastBlock.isStreaming = true;
             } else {
               if (lastBlock && lastBlock.type === "text" && isStatusMessage(lastBlock.content)) {
                 blocks.pop();
               }
-              blocks.push({ type: "thinking", content: chunk });
+              blocks.push({ type: "thinking", content: chunk, isStreaming: true });
             }
             break;
           }
           case "ToolCallStart": {
+            finalizeThinking(blocks);
             const lastBlock = blocks[blocks.length - 1];
             if (lastBlock && lastBlock.type === "text" && isStatusMessage(lastBlock.content)) {
               blocks.pop();
@@ -261017,7 +261279,17 @@ async function processAgentStream({
   setActiveMessages((prev) => prev.map((msg) => {
     if (msg.id !== assistantMsgId)
       return msg;
-    const blocks = (msg.blocks || []).filter((b) => !(b.type === "text" && isStatusMessage(b.content)));
+    const finalElapsed = thinkingStartTime ? Date.now() - thinkingStartTime : undefined;
+    const blocks = (msg.blocks || []).map((b) => {
+      if (b.type === "thinking" && b.isStreaming) {
+        return {
+          ...b,
+          isStreaming: false,
+          durationMs: b.durationMs ?? finalElapsed
+        };
+      }
+      return b;
+    }).filter((b) => !(b.type === "text" && isStatusMessage(b.content)));
     return { ...msg, blocks };
   }));
 }
@@ -261271,6 +261543,10 @@ Please open [${uri}](${uri}) in your browser to authorize.`;
             if (code && !code.endsWith("-AUTH")) {
               promptText = `
 Please open [${uri}](${uri}) on your device and enter code: \`${code}\``;
+            }
+            if (item.value === "copilot") {
+              promptText += `
+*(Note: Ensure your browser is logged into the GitHub account that owns your active Copilot subscription)*`;
             }
             setActiveMessages([
               {
@@ -261332,7 +261608,7 @@ ${formatSubscriptionCard(bundle, targetModel)}`
           addToast(formatSubscriptionToast(bundle, targetModel), "success");
         } catch (err) {
           const parsed = parseError(err);
-          const errorText = `Subscription verification failed: ${parsed.message}`;
+          const errorText = parsed.message.startsWith("Subscription verification failed") || parsed.message.startsWith("No active GitHub Copilot subscription") ? parsed.message : `Subscription verification failed: ${parsed.message}`;
           setAuthError(errorText);
           setStaticMessages((prev) => [...prev, ...useCliStore.getState().activeMessages]);
           setActiveMessages([
@@ -261661,6 +261937,7 @@ ${formatSubscriptionCard(bundle, targetModel)}`
     try {
       await agent.loadContext(item.value);
       const resumedMessages = convertAgentMessagesToTuiMessages(agent.messages);
+      console.clear();
       setStaticMessages([{ id: "header", role: "header" }, ...resumedMessages]);
       setStaticKey((k) => k + 1);
       setActiveMessages([]);
@@ -262089,8 +262366,13 @@ function useAgentSession({
       } catch {}
       const nonSystem = (agent.messages || []).filter((m) => m.role !== "system");
       if (nonSystem.length > 0) {
+        const currentStatic = useCliStore.getState().staticMessages;
+        if (currentStatic.length > 1) {
+          return;
+        }
         const resumed = convertAgentMessagesToTuiMessages(agent.messages);
         if (resumed.length > 0) {
+          console.clear();
           setStaticMessages([{ id: "header", role: "header" }, ...resumed]);
           setStaticKey((k) => k + 1);
         }
@@ -263290,6 +263572,10 @@ ${decStatus}
       }
       return;
     }
+    if (text.trim() === "/ask") {
+      addToast("Please enter your question after /ask (e.g. /ask how does auth work?)", "info");
+      return;
+    }
     if (text.trim() === "/plan" || text.trim().startsWith("/plan ")) {
       const goal = text.trim().slice("/plan".length).trim();
       if (!goal) {
@@ -263567,7 +263853,16 @@ If it doesn't open automatically, please click here:
       const promptToProcess = currentRawPrompt;
       let displayText = promptToProcess;
       let executionPrompt = promptToProcess;
-      if (promptToProcess.startsWith("/")) {
+      let isAskPrompt = false;
+      if (promptToProcess.trim() === "/ask" || promptToProcess.trim().startsWith("/ask ") || promptToProcess.trim().startsWith("/ask\t")) {
+        const question = promptToProcess.trim().replace(/^\/ask\s*/, "").trim();
+        if (question) {
+          isAskPrompt = true;
+          executionPrompt = getAskPrompt(question);
+          displayText = `/ask ${question}`;
+        }
+      }
+      if (!isAskPrompt && promptToProcess.startsWith("/")) {
         const [firstToken, ...restArgs] = promptToProcess.split(/\s+/);
         let potentialCmd = firstToken ? firstToken.slice(1).toLowerCase() : "";
         const isExplicitSkillPrefix = potentialCmd.startsWith("skill:");
@@ -263575,6 +263870,7 @@ If it doesn't open automatically, please click here:
           potentialCmd = potentialCmd.slice("skill:".length);
         }
         const coreBuiltins = new Set([
+          "ask",
           "clear",
           "context",
           "copy",
@@ -263638,7 +263934,8 @@ If it doesn't open automatically, please click here:
       try {
         const stream = runAgentLoop(agent, {
           content: executionPrompt,
-          displayText
+          displayText,
+          readOnly: isAskPrompt
         });
         await processAgentStream({
           stream,
@@ -263706,6 +264003,7 @@ If it doesn't open automatically, please click here:
     setSessionsData,
     setSettingsFollowUpMode,
     setSettingsNonWorkspace,
+    setSettingsPathGuard,
     setSettingsSteeringMode,
     setSettingsThinkingLevel,
     setSettingsToolPermission,
@@ -263713,7 +264011,6 @@ If it doesn't open automatically, please click here:
     setStaticMessages,
     setStaticKey,
     setOllamaModels,
-    setCurrentPlannedPrompt,
     authMethod,
     selectedProvider,
     setActiveModel,
@@ -264083,7 +264380,8 @@ function parseCliArgs(args) {
       "link",
       "key",
       "resume",
-      "docs"
+      "docs",
+      "ask"
     ];
     let command;
     let prompt;
@@ -264136,6 +264434,7 @@ a coding agent that lives in your terminal.
 Usage:
   december                          Launch interactive TUI session
   december "<prompt>"               Execute headless agent task
+  december ask "<question>"         Ask a question about the codebase (read-only Q&A mode)
   december resume [session-id]      Resume the most recent session or specified session ID
   december auth [status|import]     Inspect active subscriptions and authentication status
   december link <provider>          Link AI subscription (copilot, claude, chatgpt, gemini)
@@ -264273,6 +264572,17 @@ ${formattedStdin}`;
     await handleDocsCommand({ section });
     process.exit(0);
   }
+  const isAskMode = parsedArgs.command === "ask";
+  if (isAskMode) {
+    const question = parsedArgs.positionals.slice(1).join(" ").trim() || parsedArgs.prompt;
+    if (!question) {
+      console.error("Error: Please provide a question to ask.");
+      console.error(`Usage: december ask "<question>"
+`);
+      process.exit(1);
+    }
+    parsedArgs.prompt = question;
+  }
   if (parsedArgs.prompt) {
     const [
       { AgentHarness },
@@ -264283,7 +264593,8 @@ ${formattedStdin}`;
       { runHeadlessTask },
       { localOperations, setActiveScopeDir },
       { instantiateProvider },
-      { ensureValidModelForProvider }
+      { ensureValidModelForProvider },
+      { getAskPrompt }
     ] = await Promise.all([
       Promise.resolve().then(() => (init_src4(), exports_src3)),
       Promise.resolve().then(() => (init_src3(), exports_src2)),
@@ -264293,7 +264604,8 @@ ${formattedStdin}`;
       Promise.resolve().then(() => (init_headless_runner(), exports_headless_runner)),
       Promise.resolve().then(() => (init_local_operations(), exports_local_operations)),
       Promise.resolve().then(() => (init_provider_factory(), exports_provider_factory)),
-      Promise.resolve().then(() => (init_models5(), exports_models2))
+      Promise.resolve().then(() => (init_models5(), exports_models2)),
+      Promise.resolve().then(() => exports_prompts)
     ]);
     if (parsedArgs.scope) {
       setActiveScopeDir(parsedArgs.scope);
@@ -264323,22 +264635,31 @@ ${formattedStdin}`;
     const config = await loadConfig();
     const activeProvider = providerConfig?.provider || config.activeProvider || "gemini";
     const initialModel = providerConfig?.authMethod === "december" ? "december-auto" : parsedArgs.model || providerConfig?.model || ensureValidModelForProvider(activeProvider, config.activeModel);
+    const effectiveTools = isAskMode ? [
+      ReadFileTool,
+      LsTool,
+      FindFilesTool,
+      GrepSearchTool,
+      AskQuestionTool,
+      BrowserTool,
+      WebSearchTool
+    ] : [
+      BashTool,
+      ReadFileTool,
+      WriteFileTool,
+      LsTool,
+      EditFileTool,
+      EditDiffTool,
+      FindFilesTool,
+      GrepSearchTool,
+      AskQuestionTool,
+      ManageTaskTool,
+      BrowserTool,
+      WebSearchTool
+    ];
     const harness = new AgentHarness({
       llm,
-      tools: [
-        BashTool,
-        ReadFileTool,
-        WriteFileTool,
-        LsTool,
-        EditFileTool,
-        EditDiffTool,
-        FindFilesTool,
-        GrepSearchTool,
-        AskQuestionTool,
-        ManageTaskTool,
-        BrowserTool,
-        WebSearchTool
-      ],
+      tools: effectiveTools,
       operations: localOperations,
       modelOptions: {
         model: initialModel,
@@ -264355,14 +264676,18 @@ ${formattedStdin}`;
     const agent = harness.getAgent();
     await agent.loadContext();
     if (!parsedArgs.json) {
-      console.log(`
+      console.log(isAskMode ? `
+Executing Ask Q&A: "${parsedArgs.prompt}"
+` : `
 Executing Headless Task: "${parsedArgs.prompt}"
 `);
     }
-    const result = await runHeadlessTask(parsedArgs.prompt, {
+    const effectivePrompt = isAskMode ? getAskPrompt(parsedArgs.prompt) : parsedArgs.prompt;
+    const result = await runHeadlessTask(effectivePrompt, {
       agent,
       nonInteractive: parsedArgs.yes,
-      json: parsedArgs.json
+      json: parsedArgs.json,
+      readOnly: isAskMode
     });
     process.exit(result.success ? 0 : 1);
   }
@@ -264465,7 +264790,19 @@ Executing Headless Task: "${parsedArgs.prompt}"
     followUpMode: config.followUpMode || "all"
   });
   const agent = harness.getAgent();
-  agent.loadContext().catch(() => {});
+  if (targetSessionId) {
+    await agent.loadContext().catch(() => {});
+    const nonSystem = (agent.messages || []).filter((m) => m.role !== "system");
+    if (nonSystem.length > 0) {
+      await Promise.resolve().then(() => init_use_agent_runner());
+      const resumed = convertAgentMessagesToTuiMessages(agent.messages);
+      if (resumed.length > 0) {
+        useCliStore.getState().setStaticMessages([{ id: "header", role: "header" }, ...resumed]);
+      }
+    }
+  } else {
+    agent.loadContext().catch(() => {});
+  }
   function AppWrapper(props) {
     const [latestVersion, setLatestVersion] = React.useState(undefined);
     React.useEffect(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@trydecember/cli",
-    "version": "0.3.28",
+    "version": "0.3.29",
     "description": "a coding agent for terminal and cloud.",
     "homepage": "https://trydecember.com",
     "repository": {