源码索引

本页由 npm run generate:source-index 自动生成，请勿手工编辑。 全书共 353 处源码引用，全部固定在 earendil-works/pi@16787ad。

本页分析版本earendil-works/pi@16787ad2026-09-21

按章节

3.5 Agent 与 Agent Loop

• packages/agent/src/types.ts:485-491 · AgentEvent
• packages/agent/src/agent-loop.ts:162-255 · runLoop
• packages/agent/src/agent-loop.ts:257-291 · executeToolCalls

3.7 Compaction、Extension 与 Skill

• packages/agent/src/harness/compaction/compaction.ts:146-161 · CompactionSettings
• packages/agent/src/harness/compaction/compaction.ts:245-249 · shouldCompact
• packages/coding-agent/src/core/extensions/types.ts:1893-1906 · Extension
• packages/agent/src/harness/types.ts:43-60 · Skill

3.6 Agent Harness、Session 与状态

• packages/ai/package.json:2-4 · @earendil-works/pi-ai
• packages/agent/src/index.ts:41-43 · harness/agent-harness.ts
• packages/agent/src/types.ts:378-417 · AgentState
• packages/coding-agent/src/core/agent-session.ts:921-973 · appendMessage
• packages/agent/src/harness/runtime/drive/response.ts:46-78 · openFrameProgress
• packages/coding-agent/package.json:2-4 · @earendil-works/pi-coding-agent

3.1 LLM 与模型 API

• packages/ai/src/providers/faux.ts:78-101 · fauxAssistantMessage
• packages/coding-agent/test/agent-session-runtime-events.test.ts:42-46 · createRuntimeHost

3.2 消息、上下文与 token

• packages/ai/src/types.ts:491-553 · Message
• packages/ai/src/types.ts:617-621 · Context

3.3 流式输出（Streaming）

• packages/ai/src/types.ts:636-668 · AssistantMessageEvent
• packages/ai/src/api/anthropic-messages.ts:699-711 · parseStreamingJson

3.4 工具调用（Tool Calling）

• packages/ai/src/types.ts:600-605 · Tool
• packages/ai/src/types.ts:386-394 · ToolCall
• packages/ai/src/types.ts:515-537 · AssistantMessage
• packages/ai/src/types.ts:539-551 · ToolResultMessage

2.5 异步编程：Promise 与 async/await

• packages/coding-agent/src/core/tools/write.ts:58-90 · execute
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:1018-1025 · Promise.all

2.6 异步迭代器与 for await

• packages/ai/src/utils/event-stream.ts:26-89 · EventStream
• packages/ai/src/api/anthropic-messages.ts:470-509 · iterateAnthropicEvents

2.9 错误处理与测试基础

• packages/agent/src/harness/types.ts:172-185 · FileError
• packages/agent/src/harness/env/nodejs.ts:101-129 · toFileError
• packages/coding-agent/test/path-utils.test.ts:1-12 · expandPath

2.7 事件、回调与取消（AbortController）

• packages/agent/src/agent.ts:332-340 · abort
• packages/ai/src/utils/abort-signals.ts:6-41 · combineAbortSignals

1.2 运行第一个 TypeScript 程序

• pi-test.sh:57-57 · tsx
• package.json:65-65 · tsx

2.4 泛型、class 与类型收窄

• packages/agent/src/harness/types.ts:8-19 · Result
• packages/agent/src/agent.ts:187-193 · Agent
• packages/agent/src/harness/session/session.ts:224-241 · StorageBackedSession
• packages/agent/src/harness/types.ts:32-41 · toError

2.2 interface、type 与函数类型

• packages/ai/src/types.ts:600-605 · Tool
• packages/agent/src/types.ts:442-468 · AgentTool
• packages/agent/src/types.ts:47-47 · ToolExecutionMode

1.4 模块系统：import 与 export

• packages/agent/package.json:5-5
• packages/agent/src/agent.ts:1-36 · runAgentLoop
• tsconfig.base.json:18-19 · allowImportingTsExtensions
• packages/agent/src/index.ts:1-152

2.8 Node.js 文件、路径与进程 API

• packages/agent/src/harness/tools/read.ts:55-58 · execute
• packages/agent/src/harness/env/nodejs.ts:1-20 · node:fs/promises
• packages/agent/src/harness/env/nodejs.ts:750-776 · readBinaryFile

1.3 npm、package.json 与项目结构

• package.json:5-13 · workspaces
• packages/coding-agent/package.json:51-55 · dependencies
• packages/coding-agent/package.json:9-11 · bin

2.1 类型入门：基本类型与对象

• packages/ai/src/types.ts:380-384 · ImageContent
• packages/ai/src/types.ts:396-417 · Usage

2.3 union、字面量与可辨识联合

• packages/ai/src/types.ts:364-394 · TextContent
• packages/ai/src/types.ts:515-537 · AssistantMessage
• packages/ai/src/types.ts:553-553 · Message
• packages/ai/src/types.ts:652-668 · AssistantMessageEvent

1.1 JavaScript、TypeScript 与 Node.js

• package.json:68-70 · engines
• tsconfig.base.json:2-6

8.5 取消与 Extension Hook

• packages/agent/src/agent.ts:503-526 · runWithLifecycle
• packages/agent/src/agent.ts:332-340 · abort
• packages/agent/src/agent-loop.ts:241-255 · stopReason
• packages/agent/src/agent-loop.ts:773-800 · executePreparedToolCall
• packages/coding-agent/src/core/extensions/types.ts:1715-1716 · ExtensionFactory
• packages/coding-agent/src/core/extensions/loader.ts:537-583 · loadExtension
• packages/coding-agent/src/core/extensions/loader.ts:479-510 · loadExtensionModule
• packages/coding-agent/src/core/extensions/types.ts:1349-1419 · ExtensionAPI
• packages/coding-agent/src/core/event-bus.ts:12-33 · createEventBus
• packages/coding-agent/src/core/extensions/runner.ts:988-1017 · emit
• packages/coding-agent/src/core/extensions/loader.ts:273-285 · registerTool
• packages/coding-agent/src/core/agent-session.ts:3206-3210 · toolRegistry
• packages/coding-agent/src/core/extensions/loader.ts:153-181 · createExtensionRuntime

8.1 最小 CLI 与 Fake Model

• packages/coding-agent/src/main.ts:284-296 · promptConfirm
• packages/coding-agent/src/main.ts:111-122 · resolveAppMode
• packages/ai/src/types.ts:611-621 · Context
• packages/ai/src/types.ts:481-553 · Message
• packages/ai/src/providers/faux.ts:109-116 · FauxResponseStep
• packages/ai/src/providers/faux.ts:505-564 · stream
• packages/agent/src/types.ts:19-37 · StreamFn

8.3 Agent Loop 与工具执行

• packages/agent/src/agent-loop.ts:159-320 · runLoop
• packages/agent/src/agent-loop.ts:475-500 · failToolCallsFromTruncatedMessage
• packages/agent/src/agent-loop.ts:685-687 · shouldTerminateToolBatch
• packages/agent/src/agent-loop.ts:703-771 · prepareToolCall
• packages/ai/src/utils/validation.ts:310-350 · validateToolArguments
• packages/ai/src/types.ts:600-605 · Tool
• packages/agent/src/types.ts:442-468 · AgentTool
• packages/agent/src/types.ts:478-500 · AgentEvent

8.2 消息历史与流式事件

• packages/ai/src/types.ts:636-668 · AssistantMessageEvent
• packages/ai/src/types.ts:335-350 · StreamFunction
• packages/agent/src/types.ts:19-37 · StreamFn
• packages/agent/src/types.ts:478-500 · AgentEvent
• packages/agent/src/agent-loop.ts:411-453 · message_update
• packages/ai/src/utils/event-stream.ts:91-105 · AssistantMessageEventStream
• packages/agent/src/agent-loop.ts:241-255 · stopReason
• packages/ai/src/providers/faux.ts:390-405 · splitStringByTokenSize

8.0 Mini Harness 总览与准备

• packages/ai/src/types.ts:611-621 · Context
• packages/ai/src/types.ts:625-634 · TranscriptContext
• packages/ai/src/types.ts:335-350 · StreamFunction
• packages/ai/src/types.ts:636-668 · AssistantMessageEvent
• packages/agent/src/types.ts:478-500 · AgentEvent
• packages/agent/src/harness/agent-harness.ts:255-375 · HarnessEventPayload
• packages/ai/src/types.ts:17-27 · KnownApi
• packages/ai/src/types.ts:35-76 · KnownProvider
• packages/agent/src/agent.ts:245-251 · toolExecution

8.6 接入真实模型（可选）

• packages/ai/src/providers/anthropic.ts:9-41 · anthropicApiKeyAuth
• packages/coding-agent/src/core/auth-storage.ts:347-350 · AuthStorage
• packages/ai/src/types.ts:335-350 · StreamFunction
• packages/ai/src/api/anthropic-messages.ts:411-468 · iterateSseMessages
• packages/ai/src/api/anthropic-messages.ts:470-509 · iterateAnthropicEvents
• packages/ai/src/api/anthropic-messages.ts:699-711 · input_json_delta
• packages/ai/src/api/anthropic-messages.ts:1494-1521 · mapStopReason

8.4 Session 保存与恢复

• packages/coding-agent/src/core/session-manager.ts:41-50 · SessionHeader
• packages/coding-agent/src/core/session-manager.ts:57-62 · SessionEntryBase
• packages/coding-agent/src/core/session-manager.ts:182-194 · SessionEntry
• packages/coding-agent/src/core/agent-session.ts:921-943 · appendMessage
• packages/coding-agent/src/core/session-manager.ts:1160-1187 · _persist
• packages/coding-agent/src/core/session-manager.ts:626-670 · loadEntriesFromFile
• packages/coding-agent/src/core/session-manager.ts:333-347 · migrateToCurrentVersion
• packages/agent/src/harness/session/jsonl/codec.ts:52-62 · parseJsonlSessionHeader
• packages/coding-agent/src/main.ts:431-433 · continueRecent
• packages/coding-agent/src/core/session-manager.ts:748-768 · findMostRecentSession
• packages/coding-agent/src/core/session-manager.ts:1790-1798 · continueRecent
• packages/coding-agent/src/core/sdk.ts:366-373 · existingSession.messages
• packages/coding-agent/src/core/sdk.ts:402-413 · appendModelChange
• packages/coding-agent/src/core/agent-session.ts:608-632 · _installAgentRequestProjection

7.4 自定义 Provider

• packages/coding-agent/src/core/extensions/types.ts:1604-1605 · registerProvider
• packages/coding-agent/examples/extensions/custom-provider-anthropic/index.ts:581-617 · pi.registerProvider
• packages/coding-agent/src/core/extensions/loader.ts:421-429 · registerProvider
• packages/coding-agent/src/core/extensions/loader.ts:204-211 · pendingProviderRegistrations
• packages/coding-agent/src/core/extensions/runner.ts:442-459 · pendingProviderRegistrations
• packages/coding-agent/src/core/agent-session.ts:3127-3140 · registerNativeProvider
• packages/coding-agent/src/core/model-runtime.ts:753-789 · registerProvider
• packages/coding-agent/src/core/model-runtime.ts:246-268 · recomposeProvider
• packages/coding-agent/src/core/provider-composer.ts:493-513 · streamWith
• packages/coding-agent/src/extensions/index.ts:1-4 · builtInExtensions

7.3 自定义工具与斜杠命令

• packages/coding-agent/src/core/extensions/types.ts:455-504 · ToolDefinition
• packages/coding-agent/src/core/extensions/loader.ts:273-285 · registerTool
• packages/coding-agent/src/core/extensions/runner.ts:586-597 · getAllRegisteredTools
• packages/coding-agent/src/core/agent-session.ts:3144-3210 · _refreshToolRegistry
• packages/coding-agent/src/core/extensions/wrapper.ts:17-19 · wrapRegisteredTool
• packages/agent/src/agent-loop.ts:703-721 · prepareToolCall
• packages/coding-agent/src/core/slash-commands.ts:19-44 · BUILTIN_SLASH_COMMANDS
• packages/coding-agent/src/core/extensions/loader.ts:287-294 · registerCommand
• packages/coding-agent/src/core/agent-session.ts:1766-1790 · _tryExecuteExtensionCommand
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:679-777 · createBaseAutocompleteProvider

7.1 Extension 系统

• packages/coding-agent/src/core/extensions/types.ts:1715-1716 · ExtensionFactory
• packages/coding-agent/src/core/extensions/loader.ts:702-712 · discoverExtensionsInDir
• packages/coding-agent/src/core/extensions/loader.ts:487-501 · createJitiImpl
• packages/coding-agent/src/core/extensions/loader.ts:557-580 · loadExtension
• packages/coding-agent/src/core/extensions/loader.ts:536-555 · initializeExtension
• packages/coding-agent/src/core/extensions/types.ts:1349-1419 · ExtensionAPI
• packages/coding-agent/src/core/extensions/loader.ts:153-221 · createExtensionRuntime
• packages/coding-agent/src/core/extensions/runner.ts:988-1017 · RunnerEmitResult
• packages/coding-agent/src/core/agent-session.ts:529-549 · _installAgentToolHooks
• packages/coding-agent/src/core/event-bus.ts:12-33 · createEventBus
• packages/coding-agent/examples/extensions/pirate.ts:15-46 · pirateExtension

7.2 Skill 系统

• packages/coding-agent/src/core/skills.ts:67-81 · SkillFrontmatter
• packages/coding-agent/src/core/skills.ts:304-332 · frontmatterName || parentDirName
• packages/coding-agent/src/core/package-manager.ts:2385-2401 · userAgentsSkillsDir
• packages/coding-agent/src/core/package-manager.ts:421-430 · shouldIncludeMarkdownFile
• packages/coding-agent/src/core/skills.ts:160-171 · loadSkillsFromDir
• packages/coding-agent/src/core/resource-loader.ts:468-473 · updateSkillsFromPaths
• packages/coding-agent/src/core/agent-session.ts:1371-1395 · _rebuildSystemPrompt
• packages/coding-agent/src/core/system-prompt.ts:165-169 · skillFileReadTool
• packages/coding-agent/src/core/skills.ts:355-383 · formatSkillsForPrompt
• packages/coding-agent/src/core/agent-session.ts:1797-1821 · _expandSkillCommand

6.3 pi-agent-core：Agent 与循环

• packages/agent/src/agent-loop.ts:159-182 · runLoop
• packages/agent/src/agent-loop.ts:244-286 · hasMoreToolCalls
• packages/agent/src/agent-loop.ts:288-319 · getFollowUpMessages
• packages/agent/src/types.ts:485-500 · AgentEvent
• packages/agent/src/agent.ts:367-408 · prompt
• packages/agent/src/agent.ts:492-500 · getSteeringMessages
• packages/agent/src/agent.ts:228-251 · getDefaultStreamFn
• packages/agent/src/harness/agent-harness.ts:614-622 · AgentHarness
• packages/agent/src/harness/runtime/drive.ts:28-106 · driveOperation
• packages/agent/src/harness/runtime/lane.ts:328-381 · command
• packages/agent/src/harness/runtime/lane.ts:1418-1432 · nextRun

6.1 pi-ai：统一的模型接口

• packages/ai/src/providers/all.ts:137-143 · builtinModels
• packages/ai/src/models.ts:163-235 · Models
• packages/ai/src/models.ts:695-701 · complete
• packages/ai/src/types.ts:364-553 · Message
• packages/ai/src/types.ts:652-668 · AssistantMessageEvent
• packages/ai/src/utils/event-stream.ts:26-89 · EventStream
• packages/ai/src/api/anthropic-messages.ts:411-468 · iterateSseMessages
• packages/ai/src/api/anthropic-messages.ts:699-711 · input_json_delta
• packages/ai/src/utils/json-parse.ts:104-124 · parseStreamingJson
• packages/ai/src/providers/faux.ts:687-710 · fauxProvider

6.6 Context 构造与 Compaction

• packages/coding-agent/src/core/session-manager.ts:439-466 · sessionEntryToContextMessages
• packages/coding-agent/src/core/session-manager.ts:476-512 · buildContextEntries
• packages/coding-agent/src/core/session-manager.ts:543-573 · buildSessionProjection
• packages/coding-agent/src/core/messages.ts:148-196 · convertToLlm
• packages/agent/src/agent-loop.ts:380-406 · streamAssistantResponse
• packages/coding-agent/src/core/compaction/compaction.ts:289-292 · shouldCompact
• packages/coding-agent/src/core/agent-session.ts:2599-2735 · _checkCompaction
• packages/ai/src/utils/overflow.ts:136-170 · isContextOverflow
• packages/coding-agent/src/core/compaction/compaction.ts:894-958 · prepareCompaction
• packages/coding-agent/src/core/compaction/compaction.ts:824-892 · findProjectedCutPoint
• packages/coding-agent/src/core/compaction/compaction.ts:641-661 · completeSummarization

6.10 交互模式与 RPC 模式

• packages/coding-agent/src/main.ts:111-126 · resolveAppMode
• packages/coding-agent/src/main.ts:845-849 · createAgentSessionRuntime
• packages/coding-agent/src/core/agent-session-runtime.ts:67-79 · AgentSessionRuntime
• packages/coding-agent/src/main.ts:930-980 · runRpcMode
• packages/coding-agent/src/modes/rpc/jsonl.ts:4-12 · serializeJsonLine
• packages/coding-agent/src/modes/rpc/rpc-types.ts:20-74 · RpcCommand
• packages/coding-agent/src/modes/rpc/rpc-mode.ts:50-62 · runRpcMode
• packages/coding-agent/src/modes/json-event.ts:40-61 · toJsonEvent
• packages/coding-agent/src/modes/rpc/rpc-mode.ts:752-802 · handleInputLine
• packages/coding-agent/src/modes/print-mode.ts:108-127 · getHeader

6.7 系统提示词与 Prompt Templates

• packages/coding-agent/src/core/system-prompt.ts:9-32 · BuildSystemPromptOptions
• packages/coding-agent/src/core/system-prompt.ts:142-161 · promptSections.preamble
• packages/coding-agent/src/core/system-prompt.ts:163-179 · project_context
• packages/coding-agent/src/core/system-prompt.ts:143-145 · customPrompt
• packages/ai/src/types.ts:481-507 · SystemMessage
• packages/coding-agent/src/core/agent-session.ts:1407-1421 · _preparePromptAndToolLoadout
• packages/coding-agent/src/core/agent-session.ts:1371-1395 · _rebuildSystemPrompt
• packages/coding-agent/src/core/resource-loader.ts:526-542 · systemPromptSource
• packages/coding-agent/src/core/resource-loader.ts:54-69 · resolvePromptInput
• packages/coding-agent/src/core/prompt-templates.ts:105-154 · loadTemplateFromFile
• packages/coding-agent/src/core/prompt-templates.ts:304-320 · expandPromptTemplate
• packages/coding-agent/src/core/prompt-templates.ts:71-103 · substituteArgs

6.2 Provider 与模型注册

• packages/ai/src/models.ts:99-156 · Provider
• packages/ai/src/providers/cerebras.ts:6-15 · cerebrasProvider
• packages/ai/src/models.ts:784-884 · createProvider
• packages/ai/src/models.ts:48-64 · RefreshModelsContext
• packages/ai/src/providers/all.ts:90-134 · builtinProviders
• packages/ai/src/providers/all.ts:137-143 · builtinModels
• packages/ai/src/models.generated.ts:46-130 · MODELS
• packages/ai/scripts/generate-models.ts:1733-1738 · loadModelsDevData
• packages/ai/src/api/lazy.ts:73-98 · lazyApi
• packages/coding-agent/src/core/model-resolver.ts:204-257 · parseModelPattern
• packages/ai/src/auth/helpers.ts:9-31 · envApiKeyAuth
• packages/coding-agent/src/core/model-runtime.ts:173-218 · static async create

6.11 SDK：把 Pi 当作库使用

• packages/coding-agent/src/core/sdk.ts:175-191 · createAgentSession
• packages/coding-agent/src/core/sdk.ts:375-386 · streamFn
• packages/coding-agent/src/core/agent-session.ts:608-633 · _installAgentRequestProjection
• packages/coding-agent/src/core/sdk.ts:415-439 · new AgentSession
• packages/coding-agent/src/core/session-manager.ts:1800-1803 · static inMemory
• packages/coding-agent/src/core/session-manager.ts:1160-1161 · _persist
• packages/coding-agent/src/core/agent-session-runtime.ts:422-440 · createAgentSessionRuntime
• packages/coding-agent/src/index.ts:386-403
• packages/coding-agent/src/modes/rpc/rpc-client.ts:74-98 · async start
• packages/ai/src/providers/faux.ts:687-710 · fauxProvider
• packages/coding-agent/src/core/model-runtime.ts:744-751 · registerNativeProvider

6.5 Session 存储格式与会话树

• packages/agent/src/harness/session/types.ts:455-471 · interface Storage
• packages/agent/src/harness/session/session.ts:422-454 · appendToBranch
• packages/agent/src/harness/session/types.ts:592-602 · interface SessionRepo
• packages/coding-agent/src/core/session-manager.ts:183-195 · export type SessionEntry
• packages/agent/src/harness/session/types.ts:16-64 · export type Entry
• packages/agent/src/harness/session/session.ts:355-368 · createBranch
• packages/agent/src/harness/session/in-memory-storage-state.ts:273-301 · scanBranch
• packages/agent/src/harness/session/jsonl/storage.ts:138-151 · applyCommit
• packages/agent/src/harness/session/jsonl/repo.ts:146-196 · fork
• packages/agent/src/harness/session/memory.ts:37-60 · MemoryStorage
• packages/session-backends/sqlite-node/src/sqlite/repo.ts:157-173 · SqliteSessionRepo

6.8 配置系统

• packages/coding-agent/src/config.ts:528-534 · getAgentDir
• packages/coding-agent/src/core/settings-manager.ts:230-239 · FileSettingsStorage
• packages/coding-agent/src/core/settings-manager.ts:110-163 · export interface Settings
• packages/coding-agent/src/core/settings-manager.ts:165-191 · deepMergeSettings
• packages/coding-agent/src/core/settings-manager.ts:410-426 · loadFromStorage
• packages/coding-agent/src/core/project-trust.ts:46-96 · resolveProjectTrusted
• packages/coding-agent/src/core/settings-manager.ts:637-666 · persistScopedSettings
• packages/coding-agent/src/main.ts:675-679 · getSessionDir
• packages/coding-agent/src/core/sdk.ts:231-249 · getDefaultThinkingLevel
• packages/coding-agent/src/core/sdk.ts:258-265 · getDefaultTools

6.4 工具系统：定义、校验与执行

• packages/ai/src/types.ts:600-605 · Tool
• packages/agent/src/types.ts:443-468 · AgentTool
• packages/coding-agent/src/core/extensions/types.ts:455-492 · ToolDefinition
• packages/agent/src/agent-loop.ts:719-721 · validateToolArguments
• packages/ai/src/utils/validation.ts:317-339 · validateToolArguments
• packages/coding-agent/src/core/tools/index.ts:182-193 · createAllToolDefinitions
• packages/coding-agent/src/core/tools/read.ts:101-131 · resolveReadPathAsync
• packages/coding-agent/src/core/tools/truncate.ts:168-213 · truncateTail
• packages/coding-agent/src/core/tools/output-accumulator.ts:91-119 · snapshot
• packages/coding-agent/src/core/tools/file-mutation-queue.ts:32-61 · withFileMutationQueue

6.9 pi-tui：终端界面库

• packages/tui/src/tui.ts:111-136 · Component
• packages/tui/src/tui.ts:366-378 · render(width: number): string[]
• packages/tui/src/tui-main-screen.ts:363-389 · firstChanged
• packages/tui/src/tui.ts:952-1004 · requestRender
• packages/tui/src/tui-alt-screen.ts:383-406 · afterTerminalStop
• packages/coding-agent/src/modes/interactive/tui-renderer.ts:21-48 · createInteractiveTui
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:827-833 · mountInteractiveTui
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:3401-3434 · message_update
• packages/coding-agent/src/modes/interactive/components/assistant-message.ts:91-106 · updateContent
• packages/coding-agent/src/modes/interactive/components/footer.ts:84-106 · render(width: number): string[]

4.3 monorepo 与 package 地图

• package.json:5-13 · workspaces
• packages/coding-agent/package.json:9-11 · bin

4.1 Pi 是什么

• pi-test.sh:57 · tsx

4.4 从哪里开始读源码

• packages/coding-agent/src/cli.ts:6 · main
• packages/coding-agent/src/cli/setup.ts:4-13 · setupCli
• packages/coding-agent/src/main.ts:566 · export async function main
• packages/coding-agent/src/main.ts:111-122 · resolveAppMode

5.6 取消与错误处理

• packages/coding-agent/src/modes/interactive/interactive-mode.ts:2965-2991 · onEscape
• packages/agent/src/agent.ts:332-340 · abort
• packages/agent/src/agent-loop.ts:398-406 · streamFunction
• packages/ai/src/api/anthropic-messages.ts:817-826 · stopReason
• packages/agent/src/agent-loop.ts:244-255 · stopReason
• packages/ai/src/api/transform-messages.ts:191-203 · closePendingToolCalls
• packages/ai/src/utils/provider-retry.ts:105-125 · retryProviderRequest
• packages/ai/src/utils/retry.ts:237-242 · isRetryableAssistantError
• packages/ai/src/utils/overflow.ts:136-169 · isContextOverflow
• packages/coding-agent/src/core/agent-session.ts:1492-1529 · _handlePostAgentRun

5.5 Session 的创建、保存与恢复

• packages/coding-agent/src/core/session-manager.ts:589-594 · getDefaultSessionDirPath
• packages/coding-agent/src/core/session-manager.ts:1057-1083 · newSession
• packages/coding-agent/src/core/session-manager.ts:43-62 · SessionEntryBase
• packages/coding-agent/src/core/sdk.ts:402-413 · appendModelChange
• packages/coding-agent/src/core/agent-session.ts:894-943 · _handleAgentEvent
• packages/coding-agent/src/core/session-manager.ts:1160-1187 · _persist
• packages/coding-agent/src/core/session-manager.ts:1566-1586 · branch
• packages/coding-agent/src/core/session-manager.ts:1103-1122 · _buildIndex
• packages/coding-agent/src/main.ts:357-448 · createSessionManager

5.2 一次普通请求的完整路径

• packages/coding-agent/src/modes/interactive/interactive-mode.ts:1184-1193 · getUserInput
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:3265-3275 · onInputCallback
• packages/coding-agent/src/core/agent-session.ts:1606-1625 · async prompt
• packages/coding-agent/src/core/agent-session.ts:1673-1691 · hasConfiguredAuth
• packages/coding-agent/src/core/agent-session.ts:1468-1490 · _runAgentPrompt
• packages/agent/src/agent.ts:429-443 · runPromptMessages
• packages/agent/src/agent-loop.ts:178-255 · hasMoreToolCalls
• packages/agent/src/agent-loop.ts:387-406 · streamFunction
• packages/coding-agent/src/core/sdk.ts:366-386 · streamFn
• packages/coding-agent/src/core/agent-session.ts:894-942 · _handleAgentEvent

5.1 启动：pi 命令如何跑起来

• scripts/build-coding-agent-bundle.mjs:209-215 · cliLauncher
• packages/coding-agent/src/cli.ts:1-6 · main
• packages/coding-agent/src/cli/setup.ts:4-13 · setupCli
• packages/coding-agent/src/main.ts:584-588 · getAgentDir
• packages/coding-agent/src/cli/args.ts:71-77 · parseArgs
• packages/coding-agent/src/config.ts:527-534 · getAgentDir
• packages/coding-agent/src/core/settings-manager.ts:234-239 · projectSettingsPath
• packages/coding-agent/src/core/settings-manager.ts:410-413 · loadFromStorage
• packages/coding-agent/src/core/project-trust.ts:46-96 · resolveProjectTrusted
• packages/coding-agent/src/main.ts:357-365 · createSessionManager
• packages/coding-agent/src/main.ts:735-741 · createAgentSessionServices
• packages/coding-agent/src/core/agent-session-runtime.ts:422-440 · createAgentSessionRuntime

5.4 流式事件如何传播到界面

• packages/ai/src/types.ts:652-668 · AssistantMessageEvent
• packages/ai/src/api/anthropic-messages.ts:674-686 · content_block_delta
• packages/ai/src/utils/event-stream.ts:43-58 · push
• packages/agent/src/types.ts:485-500 · AgentEvent
• packages/agent/src/agent-loop.ts:411-438 · message_update
• packages/agent/src/agent.ts:561-608 · processEvents
• packages/coding-agent/src/core/agent-session.ts:164-205 · AgentSessionEvent
• packages/coding-agent/src/core/agent-session.ts:894-919 · _handleAgentEvent
• packages/coding-agent/src/modes/interactive/interactive-mode.ts:3401-3434 · message_update
• packages/coding-agent/src/modes/print-mode.ts:106-127 · writeRawStdout
• packages/coding-agent/src/modes/json-event.ts:40-61 · toJsonEvent

5.3 一次 Tool Call 的完整循环

• packages/ai/src/types.ts:386-394 · ToolCall
• packages/agent/src/agent-loop.ts:258-277 · hasMoreToolCalls
• packages/agent/src/agent-loop.ts:475-500 · failToolCallsFromTruncatedMessage
• packages/agent/src/agent-loop.ts:505-520 · executeToolCalls
• packages/agent/src/agent-loop.ts:703-771 · prepareToolCall
• packages/ai/src/utils/validation.ts:317-350 · validateToolArguments
• packages/agent/src/agent-loop.ts:773-814 · executePreparedToolCall
• packages/coding-agent/src/core/tools/read.ts:66-108 · createReadToolDefinition
• packages/coding-agent/src/core/tools/truncate.ts:78-119 · truncateHead
• packages/agent/src/agent-loop.ts:880-898 · createToolResultMessage

按 package 与文件

packages/agent

• packages/agent/package.json
• packages/agent/src/agent-loop.ts
  • runLoop → 见 3.5 Agent 与 Agent Loop
  • executeToolCalls → 见 3.5 Agent 与 Agent Loop
  • stopReason → 见 8.5 取消与 Extension Hook
  • executePreparedToolCall → 见 8.5 取消与 Extension Hook
  • failToolCallsFromTruncatedMessage → 见 8.3 Agent Loop 与工具执行
  • shouldTerminateToolBatch → 见 8.3 Agent Loop 与工具执行
  • prepareToolCall → 见 8.3 Agent Loop 与工具执行
  • message_update → 见 8.2 消息历史与流式事件
  • hasMoreToolCalls → 见 6.3 pi-agent-core：Agent 与循环
  • getFollowUpMessages → 见 6.3 pi-agent-core：Agent 与循环
  • streamAssistantResponse → 见 6.6 Context 构造与 Compaction
  • validateToolArguments → 见 6.4 工具系统：定义、校验与执行
  • streamFunction → 见 5.6 取消与错误处理
  • createToolResultMessage → 见 5.3 一次 Tool Call 的完整循环
• packages/agent/src/agent.ts
  • abort → 见 2.7 事件、回调与取消（AbortController）
  • Agent → 见 2.4 泛型、class 与类型收窄
  • runAgentLoop → 见 1.4 模块系统：import 与 export
  • runWithLifecycle → 见 8.5 取消与 Extension Hook
  • toolExecution → 见 8.0 Mini Harness 总览与准备
  • prompt → 见 6.3 pi-agent-core：Agent 与循环
  • getSteeringMessages → 见 6.3 pi-agent-core：Agent 与循环
  • getDefaultStreamFn → 见 6.3 pi-agent-core：Agent 与循环
  • runPromptMessages → 见 5.2 一次普通请求的完整路径
  • processEvents → 见 5.4 流式事件如何传播到界面
• packages/agent/src/harness/agent-harness.ts
  • HarnessEventPayload → 见 8.0 Mini Harness 总览与准备
  • AgentHarness → 见 6.3 pi-agent-core：Agent 与循环
• packages/agent/src/harness/compaction/compaction.ts
  • CompactionSettings → 见 3.7 Compaction、Extension 与 Skill
  • shouldCompact → 见 3.7 Compaction、Extension 与 Skill
• packages/agent/src/harness/env/nodejs.ts
  • toFileError → 见 2.9 错误处理与测试基础
  • node:fs/promises → 见 2.8 Node.js 文件、路径与进程 API
  • readBinaryFile → 见 2.8 Node.js 文件、路径与进程 API
• packages/agent/src/harness/runtime/drive.ts
  • driveOperation → 见 6.3 pi-agent-core：Agent 与循环
• packages/agent/src/harness/runtime/drive/response.ts
  • openFrameProgress → 见 3.6 Agent Harness、Session 与状态
• packages/agent/src/harness/runtime/lane.ts
  • command → 见 6.3 pi-agent-core：Agent 与循环
  • nextRun → 见 6.3 pi-agent-core：Agent 与循环
• packages/agent/src/harness/session/in-memory-storage-state.ts
  • scanBranch → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/session/jsonl/codec.ts
  • parseJsonlSessionHeader → 见 8.4 Session 保存与恢复
• packages/agent/src/harness/session/jsonl/repo.ts
  • fork → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/session/jsonl/storage.ts
  • applyCommit → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/session/memory.ts
  • MemoryStorage → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/session/session.ts
  • StorageBackedSession → 见 2.4 泛型、class 与类型收窄
  • appendToBranch → 见 6.5 Session 存储格式与会话树
  • createBranch → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/session/types.ts
  • interface Storage → 见 6.5 Session 存储格式与会话树
  • interface SessionRepo → 见 6.5 Session 存储格式与会话树
  • export type Entry → 见 6.5 Session 存储格式与会话树
• packages/agent/src/harness/tools/read.ts
  • execute → 见 2.8 Node.js 文件、路径与进程 API
• packages/agent/src/harness/types.ts
  • Skill → 见 3.7 Compaction、Extension 与 Skill
  • FileError → 见 2.9 错误处理与测试基础
  • Result → 见 2.4 泛型、class 与类型收窄
  • toError → 见 2.4 泛型、class 与类型收窄
• packages/agent/src/index.ts
  • harness/agent-harness.ts → 见 3.6 Agent Harness、Session 与状态
• packages/agent/src/types.ts
  • AgentEvent → 见 3.5 Agent 与 Agent Loop
  • AgentState → 见 3.6 Agent Harness、Session 与状态
  • AgentTool → 见 2.2 interface、type 与函数类型
  • ToolExecutionMode → 见 2.2 interface、type 与函数类型
  • StreamFn → 见 8.1 最小 CLI 与 Fake Model

packages/ai

• packages/ai/package.json
  • @earendil-works/pi-ai → 见 3.6 Agent Harness、Session 与状态
• packages/ai/scripts/generate-models.ts
  • loadModelsDevData → 见 6.2 Provider 与模型注册
• packages/ai/src/api/anthropic-messages.ts
  • parseStreamingJson → 见 3.3 流式输出（Streaming）
  • iterateAnthropicEvents → 见 2.6 异步迭代器与 for await
  • iterateSseMessages → 见 8.6 接入真实模型（可选）
  • input_json_delta → 见 8.6 接入真实模型（可选）
  • mapStopReason → 见 8.6 接入真实模型（可选）
  • stopReason → 见 5.6 取消与错误处理
  • content_block_delta → 见 5.4 流式事件如何传播到界面
• packages/ai/src/api/lazy.ts
  • lazyApi → 见 6.2 Provider 与模型注册
• packages/ai/src/api/transform-messages.ts
  • closePendingToolCalls → 见 5.6 取消与错误处理
• packages/ai/src/auth/helpers.ts
  • envApiKeyAuth → 见 6.2 Provider 与模型注册
• packages/ai/src/models.generated.ts
  • MODELS → 见 6.2 Provider 与模型注册
• packages/ai/src/models.ts
  • Models → 见 6.1 pi-ai：统一的模型接口
  • complete → 见 6.1 pi-ai：统一的模型接口
  • Provider → 见 6.2 Provider 与模型注册
  • createProvider → 见 6.2 Provider 与模型注册
  • RefreshModelsContext → 见 6.2 Provider 与模型注册
• packages/ai/src/providers/all.ts
  • builtinModels → 见 6.1 pi-ai：统一的模型接口
  • builtinProviders → 见 6.2 Provider 与模型注册
• packages/ai/src/providers/anthropic.ts
  • anthropicApiKeyAuth → 见 8.6 接入真实模型（可选）
• packages/ai/src/providers/cerebras.ts
  • cerebrasProvider → 见 6.2 Provider 与模型注册
• packages/ai/src/providers/faux.ts
  • fauxAssistantMessage → 见 3.1 LLM 与模型 API
  • FauxResponseStep → 见 8.1 最小 CLI 与 Fake Model
  • stream → 见 8.1 最小 CLI 与 Fake Model
  • splitStringByTokenSize → 见 8.2 消息历史与流式事件
  • fauxProvider → 见 6.1 pi-ai：统一的模型接口
• packages/ai/src/types.ts
  • Message → 见 3.2 消息、上下文与 token
  • Context → 见 3.2 消息、上下文与 token
  • AssistantMessageEvent → 见 3.3 流式输出（Streaming）
  • Tool → 见 3.4 工具调用（Tool Calling）
  • ToolCall → 见 3.4 工具调用（Tool Calling）
  • AssistantMessage → 见 3.4 工具调用（Tool Calling）
  • ToolResultMessage → 见 3.4 工具调用（Tool Calling）
  • ImageContent → 见 2.1 类型入门：基本类型与对象
  • Usage → 见 2.1 类型入门：基本类型与对象
  • TextContent → 见 2.3 union、字面量与可辨识联合
  • StreamFunction → 见 8.2 消息历史与流式事件
  • TranscriptContext → 见 8.0 Mini Harness 总览与准备
  • KnownApi → 见 8.0 Mini Harness 总览与准备
  • KnownProvider → 见 8.0 Mini Harness 总览与准备
  • SystemMessage → 见 6.7 系统提示词与 Prompt Templates
• packages/ai/src/utils/abort-signals.ts
  • combineAbortSignals → 见 2.7 事件、回调与取消（AbortController）
• packages/ai/src/utils/event-stream.ts
  • EventStream → 见 2.6 异步迭代器与 for await
  • AssistantMessageEventStream → 见 8.2 消息历史与流式事件
  • push → 见 5.4 流式事件如何传播到界面
• packages/ai/src/utils/json-parse.ts
  • parseStreamingJson → 见 6.1 pi-ai：统一的模型接口
• packages/ai/src/utils/overflow.ts
  • isContextOverflow → 见 6.6 Context 构造与 Compaction
• packages/ai/src/utils/provider-retry.ts
  • retryProviderRequest → 见 5.6 取消与错误处理
• packages/ai/src/utils/retry.ts
  • isRetryableAssistantError → 见 5.6 取消与错误处理
• packages/ai/src/utils/validation.ts
  • validateToolArguments → 见 8.3 Agent Loop 与工具执行

packages/coding-agent

• packages/coding-agent/examples/extensions/custom-provider-anthropic/index.ts
  • pi.registerProvider → 见 7.4 自定义 Provider
• packages/coding-agent/examples/extensions/pirate.ts
  • pirateExtension → 见 7.1 Extension 系统
• packages/coding-agent/package.json
  • @earendil-works/pi-coding-agent → 见 3.6 Agent Harness、Session 与状态
  • dependencies → 见 1.3 npm、package.json 与项目结构
  • bin → 见 1.3 npm、package.json 与项目结构
• packages/coding-agent/src/cli.ts
  • main → 见 4.4 从哪里开始读源码
• packages/coding-agent/src/cli/args.ts
  • parseArgs → 见 5.1 启动：pi 命令如何跑起来
• packages/coding-agent/src/cli/setup.ts
  • setupCli → 见 4.4 从哪里开始读源码
• packages/coding-agent/src/config.ts
  • getAgentDir → 见 6.8 配置系统
• packages/coding-agent/src/core/agent-session-runtime.ts
  • AgentSessionRuntime → 见 6.10 交互模式与 RPC 模式
  • createAgentSessionRuntime → 见 6.11 SDK：把 Pi 当作库使用
• packages/coding-agent/src/core/agent-session.ts
  • appendMessage → 见 3.6 Agent Harness、Session 与状态
  • toolRegistry → 见 8.5 取消与 Extension Hook
  • _installAgentRequestProjection → 见 8.4 Session 保存与恢复
  • registerNativeProvider → 见 7.4 自定义 Provider
  • _refreshToolRegistry → 见 7.3 自定义工具与斜杠命令
  • _tryExecuteExtensionCommand → 见 7.3 自定义工具与斜杠命令
  • _installAgentToolHooks → 见 7.1 Extension 系统
  • _rebuildSystemPrompt → 见 7.2 Skill 系统
  • _expandSkillCommand → 见 7.2 Skill 系统
  • _checkCompaction → 见 6.6 Context 构造与 Compaction
  • _preparePromptAndToolLoadout → 见 6.7 系统提示词与 Prompt Templates
  • _handlePostAgentRun → 见 5.6 取消与错误处理
  • _handleAgentEvent → 见 5.5 Session 的创建、保存与恢复
  • async prompt → 见 5.2 一次普通请求的完整路径
  • hasConfiguredAuth → 见 5.2 一次普通请求的完整路径
  • _runAgentPrompt → 见 5.2 一次普通请求的完整路径
  • AgentSessionEvent → 见 5.4 流式事件如何传播到界面
• packages/coding-agent/src/core/auth-storage.ts
  • AuthStorage → 见 8.6 接入真实模型（可选）
• packages/coding-agent/src/core/compaction/compaction.ts
  • shouldCompact → 见 6.6 Context 构造与 Compaction
  • prepareCompaction → 见 6.6 Context 构造与 Compaction
  • findProjectedCutPoint → 见 6.6 Context 构造与 Compaction
  • completeSummarization → 见 6.6 Context 构造与 Compaction
• packages/coding-agent/src/core/event-bus.ts
  • createEventBus → 见 8.5 取消与 Extension Hook
• packages/coding-agent/src/core/extensions/loader.ts
  • loadExtension → 见 8.5 取消与 Extension Hook
  • loadExtensionModule → 见 8.5 取消与 Extension Hook
  • registerTool → 见 8.5 取消与 Extension Hook
  • createExtensionRuntime → 见 8.5 取消与 Extension Hook
  • registerProvider → 见 7.4 自定义 Provider
  • pendingProviderRegistrations → 见 7.4 自定义 Provider
  • registerCommand → 见 7.3 自定义工具与斜杠命令
  • discoverExtensionsInDir → 见 7.1 Extension 系统
  • createJitiImpl → 见 7.1 Extension 系统
  • initializeExtension → 见 7.1 Extension 系统
• packages/coding-agent/src/core/extensions/runner.ts
  • emit → 见 8.5 取消与 Extension Hook
  • pendingProviderRegistrations → 见 7.4 自定义 Provider
  • getAllRegisteredTools → 见 7.3 自定义工具与斜杠命令
  • RunnerEmitResult → 见 7.1 Extension 系统
• packages/coding-agent/src/core/extensions/types.ts
  • Extension → 见 3.7 Compaction、Extension 与 Skill
  • ExtensionFactory → 见 8.5 取消与 Extension Hook
  • ExtensionAPI → 见 8.5 取消与 Extension Hook
  • registerProvider → 见 7.4 自定义 Provider
  • ToolDefinition → 见 7.3 自定义工具与斜杠命令
• packages/coding-agent/src/core/extensions/wrapper.ts
  • wrapRegisteredTool → 见 7.3 自定义工具与斜杠命令
• packages/coding-agent/src/core/messages.ts
  • convertToLlm → 见 6.6 Context 构造与 Compaction
• packages/coding-agent/src/core/model-resolver.ts
  • parseModelPattern → 见 6.2 Provider 与模型注册
• packages/coding-agent/src/core/model-runtime.ts
  • registerProvider → 见 7.4 自定义 Provider
  • recomposeProvider → 见 7.4 自定义 Provider
  • static async create → 见 6.2 Provider 与模型注册
  • registerNativeProvider → 见 6.11 SDK：把 Pi 当作库使用
• packages/coding-agent/src/core/package-manager.ts
  • userAgentsSkillsDir → 见 7.2 Skill 系统
  • shouldIncludeMarkdownFile → 见 7.2 Skill 系统
• packages/coding-agent/src/core/project-trust.ts
  • resolveProjectTrusted → 见 6.8 配置系统
• packages/coding-agent/src/core/prompt-templates.ts
  • loadTemplateFromFile → 见 6.7 系统提示词与 Prompt Templates
  • expandPromptTemplate → 见 6.7 系统提示词与 Prompt Templates
  • substituteArgs → 见 6.7 系统提示词与 Prompt Templates
• packages/coding-agent/src/core/provider-composer.ts
  • streamWith → 见 7.4 自定义 Provider
• packages/coding-agent/src/core/resource-loader.ts
  • updateSkillsFromPaths → 见 7.2 Skill 系统
  • systemPromptSource → 见 6.7 系统提示词与 Prompt Templates
  • resolvePromptInput → 见 6.7 系统提示词与 Prompt Templates
• packages/coding-agent/src/core/sdk.ts
  • existingSession.messages → 见 8.4 Session 保存与恢复
  • appendModelChange → 见 8.4 Session 保存与恢复
  • createAgentSession → 见 6.11 SDK：把 Pi 当作库使用
  • streamFn → 见 6.11 SDK：把 Pi 当作库使用
  • new AgentSession → 见 6.11 SDK：把 Pi 当作库使用
  • getDefaultThinkingLevel → 见 6.8 配置系统
  • getDefaultTools → 见 6.8 配置系统
• packages/coding-agent/src/core/session-manager.ts
  • SessionHeader → 见 8.4 Session 保存与恢复
  • SessionEntryBase → 见 8.4 Session 保存与恢复
  • SessionEntry → 见 8.4 Session 保存与恢复
  • _persist → 见 8.4 Session 保存与恢复
  • loadEntriesFromFile → 见 8.4 Session 保存与恢复
  • migrateToCurrentVersion → 见 8.4 Session 保存与恢复
  • findMostRecentSession → 见 8.4 Session 保存与恢复
  • continueRecent → 见 8.4 Session 保存与恢复
  • sessionEntryToContextMessages → 见 6.6 Context 构造与 Compaction
  • buildContextEntries → 见 6.6 Context 构造与 Compaction
  • buildSessionProjection → 见 6.6 Context 构造与 Compaction
  • static inMemory → 见 6.11 SDK：把 Pi 当作库使用
  • export type SessionEntry → 见 6.5 Session 存储格式与会话树
  • getDefaultSessionDirPath → 见 5.5 Session 的创建、保存与恢复
  • newSession → 见 5.5 Session 的创建、保存与恢复
  • branch → 见 5.5 Session 的创建、保存与恢复
  • _buildIndex → 见 5.5 Session 的创建、保存与恢复
• packages/coding-agent/src/core/settings-manager.ts
  • FileSettingsStorage → 见 6.8 配置系统
  • export interface Settings → 见 6.8 配置系统
  • deepMergeSettings → 见 6.8 配置系统
  • loadFromStorage → 见 6.8 配置系统
  • persistScopedSettings → 见 6.8 配置系统
  • projectSettingsPath → 见 5.1 启动：pi 命令如何跑起来
• packages/coding-agent/src/core/skills.ts
  • SkillFrontmatter → 见 7.2 Skill 系统
  • frontmatterName || parentDirName → 见 7.2 Skill 系统
  • loadSkillsFromDir → 见 7.2 Skill 系统
  • formatSkillsForPrompt → 见 7.2 Skill 系统
• packages/coding-agent/src/core/slash-commands.ts
  • BUILTIN_SLASH_COMMANDS → 见 7.3 自定义工具与斜杠命令
• packages/coding-agent/src/core/system-prompt.ts
  • skillFileReadTool → 见 7.2 Skill 系统
  • BuildSystemPromptOptions → 见 6.7 系统提示词与 Prompt Templates
  • promptSections.preamble → 见 6.7 系统提示词与 Prompt Templates
  • project_context → 见 6.7 系统提示词与 Prompt Templates
  • customPrompt → 见 6.7 系统提示词与 Prompt Templates
• packages/coding-agent/src/core/tools/file-mutation-queue.ts
  • withFileMutationQueue → 见 6.4 工具系统：定义、校验与执行
• packages/coding-agent/src/core/tools/index.ts
  • createAllToolDefinitions → 见 6.4 工具系统：定义、校验与执行
• packages/coding-agent/src/core/tools/output-accumulator.ts
  • snapshot → 见 6.4 工具系统：定义、校验与执行
• packages/coding-agent/src/core/tools/read.ts
  • resolveReadPathAsync → 见 6.4 工具系统：定义、校验与执行
  • createReadToolDefinition → 见 5.3 一次 Tool Call 的完整循环
• packages/coding-agent/src/core/tools/truncate.ts
  • truncateTail → 见 6.4 工具系统：定义、校验与执行
  • truncateHead → 见 5.3 一次 Tool Call 的完整循环
• packages/coding-agent/src/core/tools/write.ts
  • execute → 见 2.5 异步编程：Promise 与 async/await
• packages/coding-agent/src/extensions/index.ts
  • builtInExtensions → 见 7.4 自定义 Provider
• packages/coding-agent/src/index.ts
• packages/coding-agent/src/main.ts
  • promptConfirm → 见 8.1 最小 CLI 与 Fake Model
  • resolveAppMode → 见 8.1 最小 CLI 与 Fake Model
  • continueRecent → 见 8.4 Session 保存与恢复
  • createAgentSessionRuntime → 见 6.10 交互模式与 RPC 模式
  • runRpcMode → 见 6.10 交互模式与 RPC 模式
  • getSessionDir → 见 6.8 配置系统
  • export async function main → 见 4.4 从哪里开始读源码
  • createSessionManager → 见 5.5 Session 的创建、保存与恢复
  • getAgentDir → 见 5.1 启动：pi 命令如何跑起来
  • createAgentSessionServices → 见 5.1 启动：pi 命令如何跑起来
• packages/coding-agent/src/modes/interactive/components/assistant-message.ts
  • updateContent → 见 6.9 pi-tui：终端界面库
• packages/coding-agent/src/modes/interactive/components/footer.ts
  • render(width: number): string[] → 见 6.9 pi-tui：终端界面库
• packages/coding-agent/src/modes/interactive/interactive-mode.ts
  • Promise.all → 见 2.5 异步编程：Promise 与 async/await
  • createBaseAutocompleteProvider → 见 7.3 自定义工具与斜杠命令
  • mountInteractiveTui → 见 6.9 pi-tui：终端界面库
  • message_update → 见 6.9 pi-tui：终端界面库
  • onEscape → 见 5.6 取消与错误处理
  • getUserInput → 见 5.2 一次普通请求的完整路径
  • onInputCallback → 见 5.2 一次普通请求的完整路径
• packages/coding-agent/src/modes/interactive/tui-renderer.ts
  • createInteractiveTui → 见 6.9 pi-tui：终端界面库
• packages/coding-agent/src/modes/json-event.ts
  • toJsonEvent → 见 6.10 交互模式与 RPC 模式
• packages/coding-agent/src/modes/print-mode.ts
  • getHeader → 见 6.10 交互模式与 RPC 模式
  • writeRawStdout → 见 5.4 流式事件如何传播到界面
• packages/coding-agent/src/modes/rpc/jsonl.ts
  • serializeJsonLine → 见 6.10 交互模式与 RPC 模式
• packages/coding-agent/src/modes/rpc/rpc-client.ts
  • async start → 见 6.11 SDK：把 Pi 当作库使用
• packages/coding-agent/src/modes/rpc/rpc-mode.ts
  • runRpcMode → 见 6.10 交互模式与 RPC 模式
  • handleInputLine → 见 6.10 交互模式与 RPC 模式
• packages/coding-agent/src/modes/rpc/rpc-types.ts
  • RpcCommand → 见 6.10 交互模式与 RPC 模式
• packages/coding-agent/test/agent-session-runtime-events.test.ts
  • createRuntimeHost → 见 3.1 LLM 与模型 API
• packages/coding-agent/test/path-utils.test.ts
  • expandPath → 见 2.9 错误处理与测试基础

packages/session-backends

• packages/session-backends/sqlite-node/src/sqlite/repo.ts
  • SqliteSessionRepo → 见 6.5 Session 存储格式与会话树

packages/tui

• packages/tui/src/tui-alt-screen.ts
  • afterTerminalStop → 见 6.9 pi-tui：终端界面库
• packages/tui/src/tui-main-screen.ts
  • firstChanged → 见 6.9 pi-tui：终端界面库
• packages/tui/src/tui.ts
  • Component → 见 6.9 pi-tui：终端界面库
  • render(width: number): string[] → 见 6.9 pi-tui：终端界面库
  • requestRender → 见 6.9 pi-tui：终端界面库

（仓库根目录）

• package.json
  • tsx → 见 1.2 运行第一个 TypeScript 程序
  • workspaces → 见 1.3 npm、package.json 与项目结构
  • engines → 见 1.1 JavaScript、TypeScript 与 Node.js
• pi-test.sh
  • tsx → 见 1.2 运行第一个 TypeScript 程序
• scripts/build-coding-agent-bundle.mjs
  • cliLauncher → 见 5.1 启动：pi 命令如何跑起来
• tsconfig.base.json
  • allowImportingTsExtensions → 见 1.4 模块系统：import 与 export

按 symbol

symbol	文件	章节
_buildIndex	packages/coding-agent/src/core/session-manager.ts	5.5 Session 的创建、保存与恢复
_checkCompaction	packages/coding-agent/src/core/agent-session.ts	6.6 Context 构造与 Compaction
_expandSkillCommand	packages/coding-agent/src/core/agent-session.ts	7.2 Skill 系统
_handleAgentEvent	packages/coding-agent/src/core/agent-session.ts	5.5 Session 的创建、保存与恢复
_handlePostAgentRun	packages/coding-agent/src/core/agent-session.ts	5.6 取消与错误处理
_installAgentRequestProjection	packages/coding-agent/src/core/agent-session.ts	8.4 Session 保存与恢复
_installAgentToolHooks	packages/coding-agent/src/core/agent-session.ts	7.1 Extension 系统
_persist	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
_preparePromptAndToolLoadout	packages/coding-agent/src/core/agent-session.ts	6.7 系统提示词与 Prompt Templates
_rebuildSystemPrompt	packages/coding-agent/src/core/agent-session.ts	7.2 Skill 系统
_refreshToolRegistry	packages/coding-agent/src/core/agent-session.ts	7.3 自定义工具与斜杠命令
_runAgentPrompt	packages/coding-agent/src/core/agent-session.ts	5.2 一次普通请求的完整路径
_tryExecuteExtensionCommand	packages/coding-agent/src/core/agent-session.ts	7.3 自定义工具与斜杠命令
@earendil-works/pi-ai	packages/ai/package.json	3.6 Agent Harness、Session 与状态
@earendil-works/pi-coding-agent	packages/coding-agent/package.json	3.6 Agent Harness、Session 与状态
abort	packages/agent/src/agent.ts	2.7 事件、回调与取消（AbortController）
afterTerminalStop	packages/tui/src/tui-alt-screen.ts	6.9 pi-tui：终端界面库
Agent	packages/agent/src/agent.ts	2.4 泛型、class 与类型收窄
AgentEvent	packages/agent/src/types.ts	3.5 Agent 与 Agent Loop
AgentHarness	packages/agent/src/harness/agent-harness.ts	6.3 pi-agent-core：Agent 与循环
AgentSessionEvent	packages/coding-agent/src/core/agent-session.ts	5.4 流式事件如何传播到界面
AgentSessionRuntime	packages/coding-agent/src/core/agent-session-runtime.ts	6.10 交互模式与 RPC 模式
AgentState	packages/agent/src/types.ts	3.6 Agent Harness、Session 与状态
AgentTool	packages/agent/src/types.ts	2.2 interface、type 与函数类型
allowImportingTsExtensions	tsconfig.base.json	1.4 模块系统：import 与 export
anthropicApiKeyAuth	packages/ai/src/providers/anthropic.ts	8.6 接入真实模型（可选）
appendMessage	packages/coding-agent/src/core/agent-session.ts	3.6 Agent Harness、Session 与状态
appendModelChange	packages/coding-agent/src/core/sdk.ts	8.4 Session 保存与恢复
appendToBranch	packages/agent/src/harness/session/session.ts	6.5 Session 存储格式与会话树
applyCommit	packages/agent/src/harness/session/jsonl/storage.ts	6.5 Session 存储格式与会话树
AssistantMessage	packages/ai/src/types.ts	3.4 工具调用（Tool Calling）
AssistantMessageEvent	packages/ai/src/types.ts	3.3 流式输出（Streaming）
AssistantMessageEventStream	packages/ai/src/utils/event-stream.ts	8.2 消息历史与流式事件
async prompt	packages/coding-agent/src/core/agent-session.ts	5.2 一次普通请求的完整路径
async start	packages/coding-agent/src/modes/rpc/rpc-client.ts	6.11 SDK：把 Pi 当作库使用
AuthStorage	packages/coding-agent/src/core/auth-storage.ts	8.6 接入真实模型（可选）
bin	packages/coding-agent/package.json	1.3 npm、package.json 与项目结构
branch	packages/coding-agent/src/core/session-manager.ts	5.5 Session 的创建、保存与恢复
buildContextEntries	packages/coding-agent/src/core/session-manager.ts	6.6 Context 构造与 Compaction
buildSessionProjection	packages/coding-agent/src/core/session-manager.ts	6.6 Context 构造与 Compaction
BuildSystemPromptOptions	packages/coding-agent/src/core/system-prompt.ts	6.7 系统提示词与 Prompt Templates
BUILTIN_SLASH_COMMANDS	packages/coding-agent/src/core/slash-commands.ts	7.3 自定义工具与斜杠命令
builtInExtensions	packages/coding-agent/src/extensions/index.ts	7.4 自定义 Provider
builtinModels	packages/ai/src/providers/all.ts	6.1 pi-ai：统一的模型接口
builtinProviders	packages/ai/src/providers/all.ts	6.2 Provider 与模型注册
cerebrasProvider	packages/ai/src/providers/cerebras.ts	6.2 Provider 与模型注册
cliLauncher	scripts/build-coding-agent-bundle.mjs	5.1 启动：pi 命令如何跑起来
closePendingToolCalls	packages/ai/src/api/transform-messages.ts	5.6 取消与错误处理
combineAbortSignals	packages/ai/src/utils/abort-signals.ts	2.7 事件、回调与取消（AbortController）
command	packages/agent/src/harness/runtime/lane.ts	6.3 pi-agent-core：Agent 与循环
CompactionSettings	packages/agent/src/harness/compaction/compaction.ts	3.7 Compaction、Extension 与 Skill
complete	packages/ai/src/models.ts	6.1 pi-ai：统一的模型接口
completeSummarization	packages/coding-agent/src/core/compaction/compaction.ts	6.6 Context 构造与 Compaction
Component	packages/tui/src/tui.ts	6.9 pi-tui：终端界面库
content_block_delta	packages/ai/src/api/anthropic-messages.ts	5.4 流式事件如何传播到界面
Context	packages/ai/src/types.ts	3.2 消息、上下文与 token
continueRecent	packages/coding-agent/src/main.ts	8.4 Session 保存与恢复
convertToLlm	packages/coding-agent/src/core/messages.ts	6.6 Context 构造与 Compaction
createAgentSession	packages/coding-agent/src/core/sdk.ts	6.11 SDK：把 Pi 当作库使用
createAgentSessionRuntime	packages/coding-agent/src/main.ts	6.10 交互模式与 RPC 模式
createAgentSessionServices	packages/coding-agent/src/main.ts	5.1 启动：pi 命令如何跑起来
createAllToolDefinitions	packages/coding-agent/src/core/tools/index.ts	6.4 工具系统：定义、校验与执行
createBaseAutocompleteProvider	packages/coding-agent/src/modes/interactive/interactive-mode.ts	7.3 自定义工具与斜杠命令
createBranch	packages/agent/src/harness/session/session.ts	6.5 Session 存储格式与会话树
createEventBus	packages/coding-agent/src/core/event-bus.ts	8.5 取消与 Extension Hook
createExtensionRuntime	packages/coding-agent/src/core/extensions/loader.ts	8.5 取消与 Extension Hook
createInteractiveTui	packages/coding-agent/src/modes/interactive/tui-renderer.ts	6.9 pi-tui：终端界面库
createJitiImpl	packages/coding-agent/src/core/extensions/loader.ts	7.1 Extension 系统
createProvider	packages/ai/src/models.ts	6.2 Provider 与模型注册
createReadToolDefinition	packages/coding-agent/src/core/tools/read.ts	5.3 一次 Tool Call 的完整循环
createRuntimeHost	packages/coding-agent/test/agent-session-runtime-events.test.ts	3.1 LLM 与模型 API
createSessionManager	packages/coding-agent/src/main.ts	5.5 Session 的创建、保存与恢复
createToolResultMessage	packages/agent/src/agent-loop.ts	5.3 一次 Tool Call 的完整循环
customPrompt	packages/coding-agent/src/core/system-prompt.ts	6.7 系统提示词与 Prompt Templates
deepMergeSettings	packages/coding-agent/src/core/settings-manager.ts	6.8 配置系统
dependencies	packages/coding-agent/package.json	1.3 npm、package.json 与项目结构
discoverExtensionsInDir	packages/coding-agent/src/core/extensions/loader.ts	7.1 Extension 系统
driveOperation	packages/agent/src/harness/runtime/drive.ts	6.3 pi-agent-core：Agent 与循环
emit	packages/coding-agent/src/core/extensions/runner.ts	8.5 取消与 Extension Hook
engines	package.json	1.1 JavaScript、TypeScript 与 Node.js
envApiKeyAuth	packages/ai/src/auth/helpers.ts	6.2 Provider 与模型注册
EventStream	packages/ai/src/utils/event-stream.ts	2.6 异步迭代器与 for await
execute	packages/coding-agent/src/core/tools/write.ts	2.5 异步编程：Promise 与 async/await
executePreparedToolCall	packages/agent/src/agent-loop.ts	8.5 取消与 Extension Hook
executeToolCalls	packages/agent/src/agent-loop.ts	3.5 Agent 与 Agent Loop
existingSession.messages	packages/coding-agent/src/core/sdk.ts	8.4 Session 保存与恢复
expandPath	packages/coding-agent/test/path-utils.test.ts	2.9 错误处理与测试基础
expandPromptTemplate	packages/coding-agent/src/core/prompt-templates.ts	6.7 系统提示词与 Prompt Templates
export async function main	packages/coding-agent/src/main.ts	4.4 从哪里开始读源码
export interface Settings	packages/coding-agent/src/core/settings-manager.ts	6.8 配置系统
export type Entry	packages/agent/src/harness/session/types.ts	6.5 Session 存储格式与会话树
export type SessionEntry	packages/coding-agent/src/core/session-manager.ts	6.5 Session 存储格式与会话树
Extension	packages/coding-agent/src/core/extensions/types.ts	3.7 Compaction、Extension 与 Skill
ExtensionAPI	packages/coding-agent/src/core/extensions/types.ts	8.5 取消与 Extension Hook
ExtensionFactory	packages/coding-agent/src/core/extensions/types.ts	8.5 取消与 Extension Hook
failToolCallsFromTruncatedMessage	packages/agent/src/agent-loop.ts	8.3 Agent Loop 与工具执行
fauxAssistantMessage	packages/ai/src/providers/faux.ts	3.1 LLM 与模型 API
fauxProvider	packages/ai/src/providers/faux.ts	6.1 pi-ai：统一的模型接口
FauxResponseStep	packages/ai/src/providers/faux.ts	8.1 最小 CLI 与 Fake Model
FileError	packages/agent/src/harness/types.ts	2.9 错误处理与测试基础
FileSettingsStorage	packages/coding-agent/src/core/settings-manager.ts	6.8 配置系统
findMostRecentSession	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
findProjectedCutPoint	packages/coding-agent/src/core/compaction/compaction.ts	6.6 Context 构造与 Compaction
firstChanged	packages/tui/src/tui-main-screen.ts	6.9 pi-tui：终端界面库
fork	packages/agent/src/harness/session/jsonl/repo.ts	6.5 Session 存储格式与会话树
formatSkillsForPrompt	packages/coding-agent/src/core/skills.ts	7.2 Skill 系统
`frontmatterName		parentDirName`
getAgentDir	packages/coding-agent/src/config.ts	6.8 配置系统
getAllRegisteredTools	packages/coding-agent/src/core/extensions/runner.ts	7.3 自定义工具与斜杠命令
getDefaultSessionDirPath	packages/coding-agent/src/core/session-manager.ts	5.5 Session 的创建、保存与恢复
getDefaultStreamFn	packages/agent/src/agent.ts	6.3 pi-agent-core：Agent 与循环
getDefaultThinkingLevel	packages/coding-agent/src/core/sdk.ts	6.8 配置系统
getDefaultTools	packages/coding-agent/src/core/sdk.ts	6.8 配置系统
getFollowUpMessages	packages/agent/src/agent-loop.ts	6.3 pi-agent-core：Agent 与循环
getHeader	packages/coding-agent/src/modes/print-mode.ts	6.10 交互模式与 RPC 模式
getSessionDir	packages/coding-agent/src/main.ts	6.8 配置系统
getSteeringMessages	packages/agent/src/agent.ts	6.3 pi-agent-core：Agent 与循环
getUserInput	packages/coding-agent/src/modes/interactive/interactive-mode.ts	5.2 一次普通请求的完整路径
handleInputLine	packages/coding-agent/src/modes/rpc/rpc-mode.ts	6.10 交互模式与 RPC 模式
harness/agent-harness.ts	packages/agent/src/index.ts	3.6 Agent Harness、Session 与状态
HarnessEventPayload	packages/agent/src/harness/agent-harness.ts	8.0 Mini Harness 总览与准备
hasConfiguredAuth	packages/coding-agent/src/core/agent-session.ts	5.2 一次普通请求的完整路径
hasMoreToolCalls	packages/agent/src/agent-loop.ts	6.3 pi-agent-core：Agent 与循环
ImageContent	packages/ai/src/types.ts	2.1 类型入门：基本类型与对象
initializeExtension	packages/coding-agent/src/core/extensions/loader.ts	7.1 Extension 系统
input_json_delta	packages/ai/src/api/anthropic-messages.ts	8.6 接入真实模型（可选）
interface SessionRepo	packages/agent/src/harness/session/types.ts	6.5 Session 存储格式与会话树
interface Storage	packages/agent/src/harness/session/types.ts	6.5 Session 存储格式与会话树
isContextOverflow	packages/ai/src/utils/overflow.ts	6.6 Context 构造与 Compaction
isRetryableAssistantError	packages/ai/src/utils/retry.ts	5.6 取消与错误处理
iterateAnthropicEvents	packages/ai/src/api/anthropic-messages.ts	2.6 异步迭代器与 for await
iterateSseMessages	packages/ai/src/api/anthropic-messages.ts	8.6 接入真实模型（可选）
KnownApi	packages/ai/src/types.ts	8.0 Mini Harness 总览与准备
KnownProvider	packages/ai/src/types.ts	8.0 Mini Harness 总览与准备
lazyApi	packages/ai/src/api/lazy.ts	6.2 Provider 与模型注册
loadEntriesFromFile	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
loadExtension	packages/coding-agent/src/core/extensions/loader.ts	8.5 取消与 Extension Hook
loadExtensionModule	packages/coding-agent/src/core/extensions/loader.ts	8.5 取消与 Extension Hook
loadFromStorage	packages/coding-agent/src/core/settings-manager.ts	6.8 配置系统
loadModelsDevData	packages/ai/scripts/generate-models.ts	6.2 Provider 与模型注册
loadSkillsFromDir	packages/coding-agent/src/core/skills.ts	7.2 Skill 系统
loadTemplateFromFile	packages/coding-agent/src/core/prompt-templates.ts	6.7 系统提示词与 Prompt Templates
main	packages/coding-agent/src/cli.ts	4.4 从哪里开始读源码
mapStopReason	packages/ai/src/api/anthropic-messages.ts	8.6 接入真实模型（可选）
MemoryStorage	packages/agent/src/harness/session/memory.ts	6.5 Session 存储格式与会话树
Message	packages/ai/src/types.ts	3.2 消息、上下文与 token
message_update	packages/agent/src/agent-loop.ts	8.2 消息历史与流式事件
migrateToCurrentVersion	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
Models	packages/ai/src/models.ts	6.1 pi-ai：统一的模型接口
MODELS	packages/ai/src/models.generated.ts	6.2 Provider 与模型注册
mountInteractiveTui	packages/coding-agent/src/modes/interactive/interactive-mode.ts	6.9 pi-tui：终端界面库
new AgentSession	packages/coding-agent/src/core/sdk.ts	6.11 SDK：把 Pi 当作库使用
newSession	packages/coding-agent/src/core/session-manager.ts	5.5 Session 的创建、保存与恢复
nextRun	packages/agent/src/harness/runtime/lane.ts	6.3 pi-agent-core：Agent 与循环
node:fs/promises	packages/agent/src/harness/env/nodejs.ts	2.8 Node.js 文件、路径与进程 API
onEscape	packages/coding-agent/src/modes/interactive/interactive-mode.ts	5.6 取消与错误处理
onInputCallback	packages/coding-agent/src/modes/interactive/interactive-mode.ts	5.2 一次普通请求的完整路径
openFrameProgress	packages/agent/src/harness/runtime/drive/response.ts	3.6 Agent Harness、Session 与状态
parseArgs	packages/coding-agent/src/cli/args.ts	5.1 启动：pi 命令如何跑起来
parseJsonlSessionHeader	packages/agent/src/harness/session/jsonl/codec.ts	8.4 Session 保存与恢复
parseModelPattern	packages/coding-agent/src/core/model-resolver.ts	6.2 Provider 与模型注册
parseStreamingJson	packages/ai/src/api/anthropic-messages.ts	3.3 流式输出（Streaming）
pendingProviderRegistrations	packages/coding-agent/src/core/extensions/loader.ts	7.4 自定义 Provider
persistScopedSettings	packages/coding-agent/src/core/settings-manager.ts	6.8 配置系统
pi.registerProvider	packages/coding-agent/examples/extensions/custom-provider-anthropic/index.ts	7.4 自定义 Provider
pirateExtension	packages/coding-agent/examples/extensions/pirate.ts	7.1 Extension 系统
prepareCompaction	packages/coding-agent/src/core/compaction/compaction.ts	6.6 Context 构造与 Compaction
prepareToolCall	packages/agent/src/agent-loop.ts	8.3 Agent Loop 与工具执行
processEvents	packages/agent/src/agent.ts	5.4 流式事件如何传播到界面
project_context	packages/coding-agent/src/core/system-prompt.ts	6.7 系统提示词与 Prompt Templates
projectSettingsPath	packages/coding-agent/src/core/settings-manager.ts	5.1 启动：pi 命令如何跑起来
Promise.all	packages/coding-agent/src/modes/interactive/interactive-mode.ts	2.5 异步编程：Promise 与 async/await
prompt	packages/agent/src/agent.ts	6.3 pi-agent-core：Agent 与循环
promptConfirm	packages/coding-agent/src/main.ts	8.1 最小 CLI 与 Fake Model
promptSections.preamble	packages/coding-agent/src/core/system-prompt.ts	6.7 系统提示词与 Prompt Templates
Provider	packages/ai/src/models.ts	6.2 Provider 与模型注册
push	packages/ai/src/utils/event-stream.ts	5.4 流式事件如何传播到界面
readBinaryFile	packages/agent/src/harness/env/nodejs.ts	2.8 Node.js 文件、路径与进程 API
recomposeProvider	packages/coding-agent/src/core/model-runtime.ts	7.4 自定义 Provider
RefreshModelsContext	packages/ai/src/models.ts	6.2 Provider 与模型注册
registerCommand	packages/coding-agent/src/core/extensions/loader.ts	7.3 自定义工具与斜杠命令
registerNativeProvider	packages/coding-agent/src/core/agent-session.ts	7.4 自定义 Provider
registerProvider	packages/coding-agent/src/core/extensions/types.ts	7.4 自定义 Provider
registerTool	packages/coding-agent/src/core/extensions/loader.ts	8.5 取消与 Extension Hook
render(width: number): string[]	packages/tui/src/tui.ts	6.9 pi-tui：终端界面库
requestRender	packages/tui/src/tui.ts	6.9 pi-tui：终端界面库
resolveAppMode	packages/coding-agent/src/main.ts	8.1 最小 CLI 与 Fake Model
resolveProjectTrusted	packages/coding-agent/src/core/project-trust.ts	6.8 配置系统
resolvePromptInput	packages/coding-agent/src/core/resource-loader.ts	6.7 系统提示词与 Prompt Templates
resolveReadPathAsync	packages/coding-agent/src/core/tools/read.ts	6.4 工具系统：定义、校验与执行
Result	packages/agent/src/harness/types.ts	2.4 泛型、class 与类型收窄
retryProviderRequest	packages/ai/src/utils/provider-retry.ts	5.6 取消与错误处理
RpcCommand	packages/coding-agent/src/modes/rpc/rpc-types.ts	6.10 交互模式与 RPC 模式
runAgentLoop	packages/agent/src/agent.ts	1.4 模块系统：import 与 export
runLoop	packages/agent/src/agent-loop.ts	3.5 Agent 与 Agent Loop
RunnerEmitResult	packages/coding-agent/src/core/extensions/runner.ts	7.1 Extension 系统
runPromptMessages	packages/agent/src/agent.ts	5.2 一次普通请求的完整路径
runRpcMode	packages/coding-agent/src/main.ts	6.10 交互模式与 RPC 模式
runWithLifecycle	packages/agent/src/agent.ts	8.5 取消与 Extension Hook
scanBranch	packages/agent/src/harness/session/in-memory-storage-state.ts	6.5 Session 存储格式与会话树
serializeJsonLine	packages/coding-agent/src/modes/rpc/jsonl.ts	6.10 交互模式与 RPC 模式
SessionEntry	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
SessionEntryBase	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
sessionEntryToContextMessages	packages/coding-agent/src/core/session-manager.ts	6.6 Context 构造与 Compaction
SessionHeader	packages/coding-agent/src/core/session-manager.ts	8.4 Session 保存与恢复
setupCli	packages/coding-agent/src/cli/setup.ts	4.4 从哪里开始读源码
shouldCompact	packages/agent/src/harness/compaction/compaction.ts	3.7 Compaction、Extension 与 Skill
shouldIncludeMarkdownFile	packages/coding-agent/src/core/package-manager.ts	7.2 Skill 系统
shouldTerminateToolBatch	packages/agent/src/agent-loop.ts	8.3 Agent Loop 与工具执行
Skill	packages/agent/src/harness/types.ts	3.7 Compaction、Extension 与 Skill
skillFileReadTool	packages/coding-agent/src/core/system-prompt.ts	7.2 Skill 系统
SkillFrontmatter	packages/coding-agent/src/core/skills.ts	7.2 Skill 系统
snapshot	packages/coding-agent/src/core/tools/output-accumulator.ts	6.4 工具系统：定义、校验与执行
splitStringByTokenSize	packages/ai/src/providers/faux.ts	8.2 消息历史与流式事件
SqliteSessionRepo	packages/session-backends/sqlite-node/src/sqlite/repo.ts	6.5 Session 存储格式与会话树
static async create	packages/coding-agent/src/core/model-runtime.ts	6.2 Provider 与模型注册
static inMemory	packages/coding-agent/src/core/session-manager.ts	6.11 SDK：把 Pi 当作库使用
stopReason	packages/agent/src/agent-loop.ts	8.5 取消与 Extension Hook
StorageBackedSession	packages/agent/src/harness/session/session.ts	2.4 泛型、class 与类型收窄
stream	packages/ai/src/providers/faux.ts	8.1 最小 CLI 与 Fake Model
streamAssistantResponse	packages/agent/src/agent-loop.ts	6.6 Context 构造与 Compaction
streamFn	packages/coding-agent/src/core/sdk.ts	6.11 SDK：把 Pi 当作库使用
StreamFn	packages/agent/src/types.ts	8.1 最小 CLI 与 Fake Model
streamFunction	packages/agent/src/agent-loop.ts	5.6 取消与错误处理
StreamFunction	packages/ai/src/types.ts	8.2 消息历史与流式事件
streamWith	packages/coding-agent/src/core/provider-composer.ts	7.4 自定义 Provider
substituteArgs	packages/coding-agent/src/core/prompt-templates.ts	6.7 系统提示词与 Prompt Templates
SystemMessage	packages/ai/src/types.ts	6.7 系统提示词与 Prompt Templates
systemPromptSource	packages/coding-agent/src/core/resource-loader.ts	6.7 系统提示词与 Prompt Templates
TextContent	packages/ai/src/types.ts	2.3 union、字面量与可辨识联合
toError	packages/agent/src/harness/types.ts	2.4 泛型、class 与类型收窄
toFileError	packages/agent/src/harness/env/nodejs.ts	2.9 错误处理与测试基础
toJsonEvent	packages/coding-agent/src/modes/json-event.ts	6.10 交互模式与 RPC 模式
Tool	packages/ai/src/types.ts	3.4 工具调用（Tool Calling）
ToolCall	packages/ai/src/types.ts	3.4 工具调用（Tool Calling）
ToolDefinition	packages/coding-agent/src/core/extensions/types.ts	7.3 自定义工具与斜杠命令
toolExecution	packages/agent/src/agent.ts	8.0 Mini Harness 总览与准备
ToolExecutionMode	packages/agent/src/types.ts	2.2 interface、type 与函数类型
toolRegistry	packages/coding-agent/src/core/agent-session.ts	8.5 取消与 Extension Hook
ToolResultMessage	packages/ai/src/types.ts	3.4 工具调用（Tool Calling）
TranscriptContext	packages/ai/src/types.ts	8.0 Mini Harness 总览与准备
truncateHead	packages/coding-agent/src/core/tools/truncate.ts	5.3 一次 Tool Call 的完整循环
truncateTail	packages/coding-agent/src/core/tools/truncate.ts	6.4 工具系统：定义、校验与执行
tsx	pi-test.sh	1.2 运行第一个 TypeScript 程序
updateContent	packages/coding-agent/src/modes/interactive/components/assistant-message.ts	6.9 pi-tui：终端界面库
updateSkillsFromPaths	packages/coding-agent/src/core/resource-loader.ts	7.2 Skill 系统
Usage	packages/ai/src/types.ts	2.1 类型入门：基本类型与对象
userAgentsSkillsDir	packages/coding-agent/src/core/package-manager.ts	7.2 Skill 系统
validateToolArguments	packages/ai/src/utils/validation.ts	8.3 Agent Loop 与工具执行
withFileMutationQueue	packages/coding-agent/src/core/tools/file-mutation-queue.ts	6.4 工具系统：定义、校验与执行
workspaces	package.json	1.3 npm、package.json 与项目结构
wrapRegisteredTool	packages/coding-agent/src/core/extensions/wrapper.ts	7.3 自定义工具与斜杠命令
writeRawStdout	packages/coding-agent/src/modes/print-mode.ts	5.4 流式事件如何传播到界面