Sync public snapshot from freebuff-private

Source: CodebuffAI/freebuff-private@be9ecb0a8d32eaa738ce0747b72f62bb1a82bd79

Author: github-actions[bot]

sdk/CHANGELOG.md

@@ -4,7 +4,7 @@ All notable changes to the @codebuff/sdk package will be documented in this file
 
 ## [Unreleased]
 
-- New `skipSymbolIndex` run option: a fresh session builds the file tree but skips the tree-sitter parse of every project file, leaving `fileTokenScores` and `tokenCallers` empty. Set it when your agents do not use the file-picker, `read_subtree` symbols or `read_files`' `referencedBy`.
+- New `skipSymbolIndex` run option: the run builds the file tree but skips the tree-sitter parse of every project file, leaving `fileTokenScores` and `tokenCallers` empty. Set it when your agents do not use the file-picker, `read_subtree` symbols or `read_files`' `referencedBy`.
 
 - `compactRunState` now rewrites a run's history into at most 12k tokens (`MECHANICAL_HISTORY_TOKENS`) of summary plus a working set of file reads, whatever `maxContextLength` allows; it used to fill the budget. The newest read of each file not edited since comes back whole and every other read becomes an outline stub, so expect a much smaller `nextTokens`. The live request and the newest tool results are kept whole on top of the cap.
 

sdk/src/__tests__/initial-session-state.test.ts

@@ -7,7 +7,7 @@ import { z } from 'zod/v4'
 
 import { getAllFilePaths } from '@codebuff/common/project-file-tree'
 
-import { initialSessionState } from '../run-state'
+import { applyOverridesToSessionState, initialSessionState } from '../run-state'
 
 import type { MockStatResult } from '@codebuff/common/testing/mock-types'
 import type { Logger } from '@codebuff/common/types/contracts/logger'
@@ -198,6 +198,33 @@ describe('Initial Session State', () => {
     expect(readFilePaths.some((p) => p.endsWith('.ts'))).toBe(false)
   })
 
+  test('skipSymbolIndex also holds when a later run passes projectFiles', async () => {
+    const base = await initialSessionState({
+      cwd: '/test-project',
+      projectFiles: {},
+      fs: mockFs,
+      logger: mockLogger,
+    })
+    const projectFiles = {
+      'src/utils.ts':
+        'export function add(a: number, b: number) { return a + b; }',
+    }
+    const parsed = await applyOverridesToSessionState('/test-project', base, {
+      projectFiles,
+    })
+    expect(parsed.fileContext.fileTokenScores).not.toEqual({})
+
+    const skipped = await applyOverridesToSessionState('/test-project', base, {
+      projectFiles,
+      skipSymbolIndex: true,
+    })
+    expect(getAllFilePaths(skipped.fileContext.fileTree)).toEqual([
+      'src/utils.ts',
+    ])
+    expect(skipped.fileContext.fileTokenScores).toEqual({})
+    expect(skipped.fileContext.tokenCallers).toEqual({})
+  })
+
   test('derives knowledgeFiles from projectFiles when not provided', async () => {
     const projectFiles = {
       'src/index.ts': 'console.log("Hello world");',

sdk/src/run-state.ts

@@ -1135,6 +1135,8 @@ export async function applyOverridesToSessionState(
     /** Precomputed index for exactly these `projectFiles` (see
      *  ComputedProjectIndex). Ignored when `projectFiles` is absent. */
     projectIndex?: ComputedProjectIndex
+    /** See InitialSessionStateOptions.skipSymbolIndex. */
+    skipSymbolIndex?: boolean
     knowledgeFiles?: Record<string, string>
     agentDefinitions?: AgentDefinition[]
     customToolDefinitions?: CustomToolDefinition[]
@@ -1166,7 +1168,11 @@ export async function applyOverridesToSessionState(
         cwd,
         projectFiles: overrides.projectFiles,
       })
-      if (projectIndex) {
+      if (projectIndex && overrides.skipSymbolIndex) {
+        sessionState.fileContext.fileTree = projectIndex.fileTree
+        sessionState.fileContext.fileTokenScores = {}
+        sessionState.fileContext.tokenCallers = {}
+      } else if (projectIndex) {
         const { fileTree, fileTokenScores, tokenCallers } =
           await computeProjectIndex(projectIndex)
         sessionState.fileContext.fileTree = fileTree

sdk/src/run.ts

@@ -649,6 +649,7 @@ async function runOnce({
         customToolDefinitions,
         projectFiles,
         projectIndex,
+        skipSymbolIndex,
         maxAgentSteps,
       },
     )