chainlesschain 0.166.25 → 0.166.26

package/src/runtime/agent-core.js

@@ -16,7 +16,10 @@
 
 import fs from "fs";
 import path from "path";
-import { buildReadFilePage } from "../lib/read-file-page.js";
+import {
+  buildReadFilePage,
+  buildReadFileOutline,
+} from "../lib/read-file-page.js";
 import { ReadFileLoopGuard } from "../lib/read-file-loop-guard.js";
 import broker from "../lib/process-execution-broker/index.js";
 import os from "os";
@@ -1088,6 +1091,7 @@ Key behaviors:
 - For long-running commands (builds, full test suites, dev servers) set run_shell { run_in_background: true } to get a task_id back immediately, then poll output and completion with check_shell { task_id }. Kill a backgrounded server with check_shell { task_id, kill: true } when finished
 - When asked about git status, diff, log, or other repository operations, use the git tool instead of run_shell
 - When asked about files or code, use search_files to locate relevant sections, then read_file with offset/limit. Follow nextRead for large files. Reuse unchanged content already in context instead of repeatedly reading the same page; re-read when the file changes or the earlier content is no longer available.
+- Large task documents include a sampled outline with line numbers. Use it to locate relevant unfinished work and inspect those sections instead of scanning the entire document unless the task requires full coverage. File coverage and excerpts survive compaction; reading to EOF is not completing the user's task.
 - Before renaming or changing a symbol, use code_intelligence (action: references/definition) to find every real usage instead of guessing with text search. It degrades to "unavailable" when no language server is installed — fall back to search_files then.
 - After an edit, if the tool result includes a "newDiagnostics" array, you just introduced (or exposed) those errors/warnings — read them and fix before moving on. You can also run code_intelligence (action: diagnostics) on any file to check it on demand.
 - If a tool result includes a "subtreeInstructions" array, you just entered a subdirectory that carries its own cc.md/CLAUDE.md/AGENTS.md — treat that content as authoritative project rules for work in that subtree (it is injected once, the first time you touch the subtree).
@@ -3633,6 +3637,7 @@ export async function executeTool(name, args, context = {}) {
       sessionBudget: context.sessionBudget || null,
       hostResourceBudget: context.hostResourceBudget || null,
       readFileCache: context.readFileCache || null,
+      readFileLoopGuard: context.readFileLoopGuard || null,
       // Effective contract of THIS loop (parent ceiling for a nested spawn) +
       // the MCP tool definitions this loop exposes (inheritable by a spawn).
       subAgentContract: context.subAgentContract || null,
@@ -5178,6 +5183,7 @@ async function executeToolInner(
     toolAdmission = null,
     hostResourceBudget = null,
     readFileCache = null,
+    readFileLoopGuard = null,
     unattendedActionPolicy = null,
     managedCheckpoint = false,
     fileMutationScope = null,
@@ -5253,61 +5259,79 @@ async function executeToolInner(
         });
       }
       const fileVersion = `${fileStat.size}:${fileStat.mtimeMs}:${fileStat.ctimeMs}`;
-      const cacheKey = JSON.stringify([
-        filePath,
-        args.offset ?? null,
-        args.limit ?? null,
-        args.column ?? null,
-        args.hashed === true,
-        args.raw === true,
-      ]);
-      const cached = readFileCache?.get(cacheKey);
-      if (cached?.fileVersion === fileVersion) {
-        // All permission checks ran before this point. A fresh stat still
-        // invalidates changed/deleted files; cache only bounded pages per run.
-        _recordFileObservation(filePath);
-        readFileCache.delete(cacheKey);
-        readFileCache.set(cacheKey, cached);
-        return attachDescriptor(
-          await _withSubtreeInstructions(
-            structuredClone(cached.page),
-            filePath,
-            cwd,
-            subtreeInstructionScope,
-          ),
-        );
-      }
-      const content = fs.readFileSync(filePath, "utf8");
-      // Record the mtime so a later edit can detect an external change that
-      // happened between this read and the edit (read-freshness guard).
       _recordFileObservation(filePath);
-      // Jupyter notebooks: render a compact cell listing (index/id/type/source,
-      // outputs summarized) so the model can find cells for notebook_edit
-      // without ingesting raw JSON / base64 output blobs. `raw:true` returns the
-      // underlying JSON. Non-.ipynb reads are unchanged.
-      const nbView =
-        args.raw !== true && /\.ipynb$/i.test(filePath)
-          ? renderNotebook(content)
-          : null;
-      // Hashline mode: prefix each line with a 6-char content hash tag
-      // so downstream edit_file_hashed calls can anchor by hash.
-      const rendered =
-        nbView || (args.hashed === true ? annotateLines(content) : content);
-      const page = buildReadFilePage(rendered, args, {
-        filePath,
-        fileVersion,
-        maxChars: MAX_TOOL_RESULT_CHARS,
-      });
-      if (nbView) page.notebook = true;
-      if (readFileCache && !page.error) {
-        readFileCache.delete(cacheKey);
-        readFileCache.set(cacheKey, {
+      let rendered;
+      let nbView;
+      let outline;
+      const render = () => {
+        if (rendered !== undefined) return rendered;
+        const content = fs.readFileSync(filePath, "utf8");
+        nbView =
+          args.raw !== true && /\.ipynb$/i.test(filePath)
+            ? renderNotebook(content)
+            : null;
+        rendered =
+          nbView || (args.hashed === true ? annotateLines(content) : content);
+        // Excerpts are data, never subtree instructions. Keep the index
+        // separate from read coverage so it cannot claim the file was read.
+        outline =
+          ((args.offset == null && args.limit == null) ||
+            Number(args.limit) >= 2000) &&
+          content.length > MAX_TOOL_RESULT_CHARS &&
+          /\.(?:md|mdx|txt)$/i.test(filePath)
+            ? buildReadFileOutline(content)
+            : null;
+        return rendered;
+      };
+      const readPage = (request) => {
+        const cacheKey = JSON.stringify([
+          filePath,
+          request.offset ?? null,
+          request.limit ?? null,
+          request.column ?? null,
+          args.hashed === true,
+          args.raw === true,
+        ]);
+        const cached = readFileCache?.get(cacheKey);
+        if (cached?.fileVersion === fileVersion)
+          return structuredClone(cached.page);
+        render();
+        const page = buildReadFilePage(rendered, request, {
+          filePath,
           fileVersion,
-          page: structuredClone(page),
+          // An unbounded large-document request starts with an index and a
+          // small preview. A task-specific search can then avoid a full scan.
+          maxChars:
+            outline && request.offset == null && request.limit == null
+              ? Math.min(MAX_TOOL_RESULT_CHARS, 12000)
+              : MAX_TOOL_RESULT_CHARS,
+          outline,
         });
-        while (readFileCache.size > 8)
-          readFileCache.delete(readFileCache.keys().next().value);
-      }
+        if (nbView) page.notebook = true;
+        if (readFileCache && !page.error) {
+          readFileCache.delete(cacheKey);
+          readFileCache.set(cacheKey, {
+            fileVersion,
+            page: structuredClone(page),
+          });
+          while (readFileCache.size > 8)
+            readFileCache.delete(readFileCache.keys().next().value);
+        }
+        return page;
+      };
+      const page = readFileLoopGuard
+        ? readFileLoopGuard.read(
+            args,
+            { filePath, fileVersion },
+            readPage,
+            (charOffset) => {
+              const prefix = render().slice(0, charOffset);
+              const offset = (prefix.match(/\n/g) || []).length + 1;
+              const column = charOffset - prefix.lastIndexOf("\n");
+              return readPage({ ...args, offset, column, limit: 2000 });
+            },
+          )
+        : readPage(args);
       return attachDescriptor(
         await _withSubtreeInstructions(
           page,
@@ -13708,6 +13732,7 @@ export async function* agentLoop(messages, options) {
   // rather than looping forever (the iteration budget is the hard backstop).
   let emptyThinkingReprompted = false;
   const readFileLoopGuard = new ReadFileLoopGuard();
+  toolContext.readFileLoopGuard = readFileLoopGuard;
 
   while (budget.hasRemaining()) {
     readFileLoopGuard.finishBatch();
@@ -13718,7 +13743,7 @@ export async function* agentLoop(messages, options) {
       );
       yield* _drainSubAgentUsage(subAgentUsageSink);
       const error = new Error(
-        "Repeated unchanged file reads: stopped after three tool batches made no new reading progress, including a recovery attempt. The task is not complete. Continue with a different file section or a targeted search.",
+        "Repeated unchanged file reads: the model did not resume the task after automatic page continuation and six no-progress batches with retained findings. The task is not complete. Use a targeted section or revise the task before retrying.",
       );
       error.code = "CC_AGENT_REPEATED_FILE_READ";
       throw error;
@@ -14275,11 +14300,74 @@ export async function* agentLoop(messages, options) {
     // prepareCall runs fresh each iteration and returns an ephemeral
     // system-message supplement that is NOT persisted to messages history.
     let callMessages = messages;
+    // Give a looping model a turn focused on search/action rather than another
+    // whole-file request. This changes discovery for one request only; runtime
+    // permissions are untouched and ordinary reads return on the next turn.
+    const readRecoveryTurn = readFileLoopGuard.takeRecoveryTurn();
+    const iterationToolOptions = readRecoveryTurn
+      ? {
+          ...effectiveToolOptions,
+          disabledTools: [
+            ...(effectiveToolOptions.disabledTools || []),
+            "read_file",
+          ],
+        }
+      : effectiveToolOptions;
+    const readContext = [
+      readFileLoopGuard.findingsHint,
+      readFileLoopGuard.progressHint,
+    ].filter(Boolean);
+    if (readContext.length) {
+      // Preserve the last conversational turn and never split a tool call
+      // from its results. Source data must neither become system authority
+      // nor create an assistant prefill / a new generic user request.
+      const resultIndex = messages.findLastIndex(
+        (message) => message.role === "tool",
+      );
+      if (resultIndex >= 0) {
+        const result = messages[resultIndex];
+        const original =
+          typeof result.content === "string"
+            ? result.content
+            : safeStringifyToolResult(result.content);
+        let content;
+        try {
+          const value = JSON.parse(original);
+          content = JSON.stringify({
+            ...value,
+            retainedReadContext: readContext,
+          });
+        } catch {
+          content = original + "\n\n" + readContext.join("\n\n");
+        }
+        // Enrich only the ephemeral copy. This preserves signed assistant
+        // thinking blocks, the last tool result, and the persisted transcript.
+        callMessages = messages.map((message, index) =>
+          index === resultIndex ? { ...result, content } : message,
+        );
+      } else {
+        // Full compaction can leave only the pinned request. Reiterate that
+        // exact request after the source data, not a replacement objective.
+        const request = messages.findLast((message) => message.role === "user");
+        callMessages = [
+          ...messages,
+          ...readContext.map((content) => ({ role: "assistant", content })),
+          {
+            role: "user",
+            content: request?.content || "Continue the original user task.",
+          },
+        ];
+      }
+    }
     const contextMemoryTrustedSystemIndexes = [];
-    if (readFileLoopGuard.progressHint) {
+    if (readRecoveryTurn) {
       callMessages = [
         ...callMessages,
-        { role: "system", content: readFileLoopGuard.progressHint },
+        {
+          role: "system",
+          content:
+            "File-read loop recovery: read_file is temporarily omitted for this model turn. Use the retained findings to choose a concrete next action or a focused search. Do not claim the user's task is complete merely because the file was read. Normal read_file availability resumes on the following turn.",
+        },
       ];
       contextMemoryTrustedSystemIndexes.push(callMessages.length - 1);
     }
@@ -14328,7 +14416,7 @@ export async function* agentLoop(messages, options) {
         {
           ...options,
           contextMemoryToolDefinitions:
-            getEffectiveToolDefinitions(effectiveToolOptions),
+            getEffectiveToolDefinitions(iterationToolOptions),
           contextMemoryTrustedSystemIndexes,
         },
       );
@@ -14358,13 +14446,13 @@ export async function* agentLoop(messages, options) {
     );
     const plannedProviderOptions = canonicalProviderContext?.plan
       ? {
-          ...effectiveToolOptions,
+          ...iterationToolOptions,
           contextEngine: null,
           contextMemoryPreplanned: true,
           contextMemorySelectedToolNames:
             canonicalProviderContext.selectedToolNames,
         }
-      : effectiveToolOptions;
+      : iterationToolOptions;
     const requestOptions = providerRequestId
       ? { ...plannedProviderOptions, providerRequestId }
       : plannedProviderOptions;
@@ -14694,7 +14782,7 @@ export async function* agentLoop(messages, options) {
 
     // Add assistant message with tool calls
     messages.push(msg);
-    readFileLoopGuard.startBatch(toolCalls.length);
+    readFileLoopGuard.startBatch();
 
     // Concurrent READ-ONLY batch (latency optimization). When every call in the
     // turn is a well-formed read-only built-in (pure fs/DB reads — no mutation,

package/src/assets/web-panel/assets/ChatBubbleRenderer-t1enanwz.js

@@ -1 +0,0 @@
-import{I as v,P as u,J as S,U as s,R as a,S as y,K as C,Q as x,V as w,_ as B,b as n}from"./vendor-Bn1JzzAn.js";import{_ as k}from"./index-CXmpR6N3.js";import"./icons-DG5UD-6K.js";const N={__name:"ChatBubbleRenderer",props:{event:{type:Object,required:!0}},setup(c,{expose:d}){d();const t=c,r=n(()=>{const e=t.event.content||{};return e.text||e.body||e.message||e.title||JSON.stringify(e).slice(0,200)}),i=n(()=>{const e=t.event.content||{};return e.from||e.sender||e.senderName||t.event.actor||"(unknown)"}),l=n(()=>{const e=(t.event.actor||"").toLowerCase();return e.includes("self")||e==="me"||e.endsWith("_self")}),o=n(()=>{const e=t.event.source.adapter||"";return e.startsWith("messaging-qq")?"magenta":e==="wechat"?"green":"blue"}),m=n(()=>{if(!t.event.occurredAt)return"";try{const e=new Date(t.event.occurredAt),p=e.getFullYear(),f=String(e.getMonth()+1).padStart(2,"0"),g=String(e.getDate()).padStart(2,"0"),b=String(e.getHours()).padStart(2,"0"),h=String(e.getMinutes()).padStart(2,"0");return`${p}-${f}-${g} ${b}:${h}`}catch{return""}}),_={props:t,messageText:r,actorLabel:i,isMine:l,adapterColor:o,formattedTime:m,computed:n};return Object.defineProperty(_,"__isScriptSetup",{enumerable:!1,value:!0}),_}},T={class:"bubble"},M={class:"meta"},R={class:"actor"},V={class:"time"},q={class:"body"};function D(c,d,t,r,i,l){const o=v("a-tag");return u(),S("div",{class:B(["chat-row",{mine:r.isMine}])},[s("div",T,[s("div",M,[s("span",R,a(r.actorLabel),1),s("span",V,a(r.formattedTime),1)]),s("div",q,a(r.messageText),1),t.event.source.adapter?(u(),y(o,{key:0,class:"src",color:r.adapterColor},{default:C(()=>[x(a(t.event.source.adapter),1)]),_:1},8,["color"])):w("v-if",!0)])],2)}const A=k(N,[["render",D],["__scopeId","data-v-49238629"],["__file","/tmp/cc-web-panel-d2aftn/repo/packages/web-panel/src/components/pdh/renderers/ChatBubbleRenderer.vue"]]);export{A as default};

package/src/assets/web-panel/assets/Logs-CS0G057y.js

@@ -1,2 +0,0 @@
-import{I as s,J as g,U as d,c as o,K as _,V as k,S as W,R as S,F as K,Z as Q,w as M,n as C,o as R,b as T,r,P as p,Q as O,_ as U}from"./vendor-Bn1JzzAn.js";import{_ as E,u as N}from"./index-CXmpR6N3.js";import{R as j}from"./icons-DG5UD-6K.js";const q={__name:"Logs",setup(V,{expose:a}){a();const x=N(),e=r("status"),y=r(!1),v=r(""),i=r(""),c=r(""),f=r(!0),n=r(null),h={status:"status",doctor:"doctor","skill-sources":"skill sources","llm-providers":"llm providers"},m=T(()=>i.value.split(`
-`)),b=T(()=>{if(!c.value)return m.value;const t=c.value.toLowerCase();return m.value.filter(u=>u.toLowerCase().includes(t))});function L(t){return t.includes("✖")||t.includes("error")||t.includes("Error")||t.includes("failed")?"line-error":t.includes("✔")||t.includes("✓")||t.includes("success")||t.includes("running")?"line-success":t.includes("warn")||t.includes("Warn")||t.includes("○")?"line-warn":t.startsWith("  ")||t.startsWith("	")?"line-indent":""}function l(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function w(t){if(!c.value)return t;const u=c.value.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return t.replace(new RegExp(`(${u})`,"gi"),"<mark>$1</mark>")}async function B(){y.value=!0,v.value="",i.value="";const t=h[e.value]||"status";try{const{output:u}=await x.execute(t,3e4);i.value=u,f.value&&(await C(),n.value&&(n.value.scrollTop=n.value.scrollHeight))}catch(u){v.value=`执行失败: ${u.message}`,i.value=v.value}finally{y.value=!1}}M(b,async()=>{f.value&&(await C(),n.value&&(n.value.scrollTop=n.value.scrollHeight))}),R(B);const H={ws:x,activeTab:e,loading:y,error:v,rawOutput:i,searchQuery:c,autoScroll:f,logContainer:n,TAB_COMMANDS:h,allLines:m,filteredLines:b,lineClass:L,escapeHtml:l,highlightSearch:w,loadLog:B,ref:r,computed:T,watch:M,nextTick:C,onMounted:R,get ReloadOutlined(){return j},get useWsStore(){return N}};return Object.defineProperty(H,"__isScriptSetup",{enumerable:!1,value:!0}),H}},z={style:{display:"flex","align-items":"center","justify-content":"space-between","margin-bottom":"24px"}},A={style:{display:"flex",gap:"10px",margin:"12px 0"}},D={ref:"logContainer",class:"log-box"},F={key:0,style:{"text-align":"center",padding:"40px",color:"var(--text-muted)"}},I={key:1,style:{"text-align":"center",padding:"40px",color:"var(--text-muted)"}},P={key:2},J=["innerHTML"];function Z(V,a,x,e,y,v){const i=s("a-checkbox"),c=s("a-button"),f=s("a-space"),n=s("a-tab-pane"),h=s("a-tabs"),m=s("a-input-search"),b=s("a-tag"),L=s("a-spin");return p(),g("div",null,[d("div",z,[a[5]||(a[5]=d("div",null,[d("h2",{class:"page-title"},"日志查看"),d("p",{class:"page-sub"},"系统运行日志与诊断输出")],-1)),o(f,null,{default:_(()=>[o(i,{checked:e.autoScroll,"onUpdate:checked":a[0]||(a[0]=l=>e.autoScroll=l)},{default:_(()=>[...a[3]||(a[3]=[O("自动滚动",-1)])]),_:1},8,["checked"]),o(c,{type:"primary",ghost:"",loading:e.loading,onClick:e.loadLog},{icon:_(()=>[o(e.ReloadOutlined)]),default:_(()=>[a[4]||(a[4]=O(" 刷新 ",-1))]),_:1},8,["loading"])]),_:1})]),k(" Tab Selector "),o(h,{activeKey:e.activeTab,"onUpdate:activeKey":a[1]||(a[1]=l=>e.activeTab=l),onChange:e.loadLog,style:{"margin-bottom":"0"}},{default:_(()=>[o(n,{key:"status",tab:"系统状态"}),o(n,{key:"doctor",tab:"环境诊断"}),o(n,{key:"skill-sources",tab:"技能来源"}),o(n,{key:"llm-providers",tab:"LLM 提供商"})]),_:1},8,["activeKey"]),k(" Search Bar "),d("div",A,[o(m,{value:e.searchQuery,"onUpdate:value":a[2]||(a[2]=l=>e.searchQuery=l),placeholder:"搜索日志内容...","allow-clear":"",style:{flex:"1"}},null,8,["value"]),e.filteredLines.length!==e.allLines.length?(p(),W(b,{key:0,color:"blue"},{default:_(()=>[O(S(e.filteredLines.length)+" / "+S(e.allLines.length)+" 行 ",1)]),_:1})):k("v-if",!0)]),k(" Log Output "),d("div",D,[e.loading?(p(),g("div",F,[o(L,{size:"large"}),a[6]||(a[6]=d("div",{style:{"margin-top":"10px"}},"加载中...",-1))])):e.filteredLines.length?(p(),g("div",P,[(p(!0),g(K,null,Q(e.filteredLines,(l,w)=>(p(),g("div",{key:w,class:U(["log-line",e.lineClass(l)]),innerHTML:e.highlightSearch(e.escapeHtml(l))},null,10,J))),128))])):(p(),g("div",I,S(e.error||"暂无日志内容，点击刷新加载"),1))],512)])}const $=E(q,[["render",Z],["__scopeId","data-v-8c2906e0"],["__file","/tmp/cc-web-panel-d2aftn/repo/packages/web-panel/src/views/Logs.vue"]]);export{$ as default};

package/src/assets/web-panel/assets/MarkdownRenderer-BxIIB4k3.js

@@ -1 +0,0 @@
-import{P as c,J as d,b as a}from"./vendor-Bn1JzzAn.js";import{r as s}from"./markdown-Yo_c6Krv.js";import{_ as p}from"./index-CXmpR6N3.js";const _={__name:"MarkdownRenderer",props:{content:{type:String,default:""}},setup(t,{expose:o}){o();const e=t,r=a(()=>s(e.content||"")),n={props:e,rendered:r,computed:a,get renderMarkdown(){return s}};return Object.defineProperty(n,"__isScriptSetup",{enumerable:!1,value:!0}),n}},i=["innerHTML"];function m(t,o,e,r,n,u){return c(),d("div",{class:"markdown-content",innerHTML:r.rendered},null,8,i)}const w=p(_,[["render",m],["__scopeId","data-v-0b0b9f63"],["__file","/tmp/cc-web-panel-d2aftn/repo/packages/web-panel/src/components/MarkdownRenderer.vue"]]);export{w as M};

package/src/assets/web-panel/assets/devWarning-DuGrUMAS.js

@@ -1 +0,0 @@
-import{Q as r}from"./index-CXmpR6N3.js";const o=((n,a,e)=>{r(n,`[ant-design-vue: ${a}] ${e}`)});export{o as d};

package/src/assets/web-panel/assets/index-DvFfMAux.js

@@ -1 +0,0 @@
-import{C as o}from"./Col-DkPTQ2Gl.js";import{a0 as t}from"./index-CXmpR6N3.js";import"./vendor-Bn1JzzAn.js";import"./index-BxctzdYQ.js";import"./icons-DG5UD-6K.js";const s=t(o);export{s as default};

package/src/assets/web-panel/assets/index-n6p-1A77.js

@@ -1 +0,0 @@
-import{A as o}from"./Row-DivbeDE-.js";import{a0 as t}from"./index-CXmpR6N3.js";import"./vendor-Bn1JzzAn.js";import"./responsiveObserve-DTD02LAO.js";import"./useFlexGapSupport-BeozAWOo.js";import"./styleChecker-CFWD63T-.js";import"./index-BxctzdYQ.js";import"./icons-DG5UD-6K.js";const l=t(o);export{l as default};