ummaya 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/README.md +15 -2
  2. package/bin/ummaya +10 -1
  3. package/bun.lock +180 -244
  4. package/npm-shrinkwrap.json +760 -1760
  5. package/package.json +39 -22
  6. package/prompts/manifest.yaml +1 -1
  7. package/prompts/system_v1.md +1 -0
  8. package/pyproject.toml +27 -2
  9. package/specs/2803-document-production-hardening/contracts/document-tools.schema.json +1043 -0
  10. package/src/ummaya/_canonical/__init__.py +2 -0
  11. package/src/ummaya/_canonical/baselines.yaml +113 -0
  12. package/src/ummaya/engine/engine.py +29 -132
  13. package/src/ummaya/evidence/__init__.py +21 -2
  14. package/src/ummaya/evidence/dataset_contract.py +193 -0
  15. package/src/ummaya/evidence/document_authoring_cases.py +33 -0
  16. package/src/ummaya/evidence/document_harness.py +313 -0
  17. package/src/ummaya/evidence/document_viewer_ux.py +391 -0
  18. package/src/ummaya/evidence/gates.py +70 -0
  19. package/src/ummaya/evidence/json_types.py +20 -0
  20. package/src/ummaya/evidence/models.py +88 -1
  21. package/src/ummaya/evidence/output_payload.py +89 -0
  22. package/src/ummaya/evidence/payload_documents.py +233 -0
  23. package/src/ummaya/evidence/route_contracts.py +224 -0
  24. package/src/ummaya/evidence/route_helpers.py +150 -0
  25. package/src/ummaya/evidence/runner.py +81 -212
  26. package/src/ummaya/evidence/source_provenance.py +246 -0
  27. package/src/ummaya/evidence/source_provenance_redaction.py +176 -0
  28. package/src/ummaya/evidence/tool_layer.py +39 -0
  29. package/src/ummaya/evidence/tool_layer_models.py +151 -0
  30. package/src/ummaya/ipc/adapter_manifest_emitter.py +26 -10
  31. package/src/ummaya/ipc/document_intent_normalization.py +185 -0
  32. package/src/ummaya/ipc/frame_schema.py +5 -5
  33. package/src/ummaya/ipc/route_diagnostics.py +73 -0
  34. package/src/ummaya/ipc/stdio.py +1109 -477
  35. package/src/ummaya/llm/client.py +102 -3
  36. package/src/ummaya/llm/config.py +8 -3
  37. package/src/ummaya/primitives/__init__.py +6 -2
  38. package/src/ummaya/primitives/delegation.py +1 -1
  39. package/src/ummaya/primitives/document.py +28 -0
  40. package/src/ummaya/settings.py +0 -3
  41. package/src/ummaya/tools/discovery_bridge.py +17 -1
  42. package/src/ummaya/tools/documents/__init__.py +297 -0
  43. package/src/ummaya/tools/documents/adapter_registry.py +487 -0
  44. package/src/ummaya/tools/documents/archive_container_probe.py +167 -0
  45. package/src/ummaya/tools/documents/artifact_store.py +454 -0
  46. package/src/ummaya/tools/documents/authoring.py +283 -0
  47. package/src/ummaya/tools/documents/baselines.py +132 -0
  48. package/src/ummaya/tools/documents/capability.py +331 -0
  49. package/src/ummaya/tools/documents/contracts.py +112 -0
  50. package/src/ummaya/tools/documents/conversion.py +521 -0
  51. package/src/ummaya/tools/documents/diff.py +275 -0
  52. package/src/ummaya/tools/documents/engines.py +163 -0
  53. package/src/ummaya/tools/documents/evaluation.py +291 -0
  54. package/src/ummaya/tools/documents/explicit_values.py +108 -0
  55. package/src/ummaya/tools/documents/fixtures.py +174 -0
  56. package/src/ummaya/tools/documents/format_completion_audit.py +471 -0
  57. package/src/ummaya/tools/documents/formats/__init__.py +2 -0
  58. package/src/ummaya/tools/documents/formats/archive.py +528 -0
  59. package/src/ummaya/tools/documents/formats/base.py +41 -0
  60. package/src/ummaya/tools/documents/formats/code_file.py +211 -0
  61. package/src/ummaya/tools/documents/formats/data_file.py +272 -0
  62. package/src/ummaya/tools/documents/formats/hwp.py +284 -0
  63. package/src/ummaya/tools/documents/formats/hwpx.py +1837 -0
  64. package/src/ummaya/tools/documents/formats/odf.py +435 -0
  65. package/src/ummaya/tools/documents/formats/ooxml.py +1030 -0
  66. package/src/ummaya/tools/documents/formats/passive.py +766 -0
  67. package/src/ummaya/tools/documents/formats/pdf.py +702 -0
  68. package/src/ummaya/tools/documents/formats/text_web.py +268 -0
  69. package/src/ummaya/tools/documents/hwp_conversion_probe.py +178 -0
  70. package/src/ummaya/tools/documents/hwp_direct_candidate.py +141 -0
  71. package/src/ummaya/tools/documents/inspection.py +289 -0
  72. package/src/ummaya/tools/documents/intake.py +1079 -0
  73. package/src/ummaya/tools/documents/legacy_office_promotion_probe.py +366 -0
  74. package/src/ummaya/tools/documents/models.py +1598 -0
  75. package/src/ummaya/tools/documents/odf_promotion_probe.py +167 -0
  76. package/src/ummaya/tools/documents/orchestrator.py +96 -0
  77. package/src/ummaya/tools/documents/passive_capability_probe.py +251 -0
  78. package/src/ummaya/tools/documents/patch.py +170 -0
  79. package/src/ummaya/tools/documents/pdfa_conformance.py +284 -0
  80. package/src/ummaya/tools/documents/pdfa_promotion_probe.py +198 -0
  81. package/src/ummaya/tools/documents/permissions.py +110 -0
  82. package/src/ummaya/tools/documents/planner.py +616 -0
  83. package/src/ummaya/tools/documents/registry.py +2733 -0
  84. package/src/ummaya/tools/documents/render.py +978 -0
  85. package/src/ummaya/tools/documents/render_comparison.py +113 -0
  86. package/src/ummaya/tools/documents/render_comparison_models.py +74 -0
  87. package/src/ummaya/tools/documents/render_comparison_regions.py +73 -0
  88. package/src/ummaya/tools/documents/render_comparison_style.py +161 -0
  89. package/src/ummaya/tools/documents/reread.py +157 -0
  90. package/src/ummaya/tools/documents/runtime_authoring.py +244 -0
  91. package/src/ummaya/tools/documents/runtime_authoring_bundle.py +76 -0
  92. package/src/ummaya/tools/documents/scorecard.py +184 -0
  93. package/src/ummaya/tools/documents/socratic_planner.py +193 -0
  94. package/src/ummaya/tools/documents/style.py +48 -0
  95. package/src/ummaya/tools/documents/tool_defs.py +523 -0
  96. package/src/ummaya/tools/documents/validate.py +347 -0
  97. package/src/ummaya/tools/executor.py +29 -0
  98. package/src/ummaya/tools/live_proxy.py +0 -3
  99. package/src/ummaya/tools/models.py +5 -1
  100. package/src/ummaya/tools/register_all.py +8 -0
  101. package/src/ummaya/tools/registry.py +10 -1
  102. package/src/ummaya/tools/routing/__init__.py +59 -0
  103. package/src/ummaya/tools/routing/builder.py +105 -0
  104. package/src/ummaya/tools/routing/cards.py +29 -0
  105. package/src/ummaya/tools/routing/decision_service.py +534 -0
  106. package/src/ummaya/tools/routing/decision_types.py +74 -0
  107. package/src/ummaya/tools/routing/feasibility.py +122 -0
  108. package/src/ummaya/tools/routing/intent.py +17 -0
  109. package/src/ummaya/tools/routing/intent_extractor.py +207 -0
  110. package/src/ummaya/tools/routing/intent_patterns.py +160 -0
  111. package/src/ummaya/tools/routing/intent_public_data.py +150 -0
  112. package/src/ummaya/tools/routing/intent_types.py +48 -0
  113. package/src/ummaya/tools/routing/lint.py +78 -0
  114. package/src/ummaya/tools/routing/metadata.py +174 -0
  115. package/src/ummaya/tools/routing/projection.py +340 -0
  116. package/src/ummaya/tools/routing/retrieval_policy.py +629 -0
  117. package/src/ummaya/tools/routing/schema.py +81 -0
  118. package/src/ummaya/tools/routing/types.py +96 -0
  119. package/src/ummaya/tools/routing_index.py +2 -2
  120. package/src/ummaya/tools/search.py +34 -746
  121. package/tests/fixtures/documents/public_forms/baselines.yaml +113 -0
  122. package/tui/bun.lock +126 -305
  123. package/tui/package.json +35 -22
  124. package/tui/src/.cc-byte-identical-whitelist.yaml +266 -0
  125. package/tui/src/QueryEngine.ts +12 -8
  126. package/tui/src/bridge/inboundAttachments.ts +3 -3
  127. package/tui/src/cli/handlers/auth.ts +3 -12
  128. package/tui/src/cli/handlers/mcp.tsx +0 -1
  129. package/tui/src/cli/print.ts +8 -9
  130. package/tui/src/commands/insights.ts +1 -1
  131. package/tui/src/commands/install-github-app/types.ts +8 -30
  132. package/tui/src/commands/plugin/types.ts +6 -28
  133. package/tui/src/commands/plugin/unifiedTypes.ts +4 -26
  134. package/tui/src/commands/rename/generateSessionName.ts +1 -1
  135. package/tui/src/components/Feedback.tsx +1 -1
  136. package/tui/src/components/LogoV2/EmergencyTip.tsx +11 -2
  137. package/tui/src/components/LogoV2/WelcomeV2.tsx +1 -3
  138. package/tui/src/components/ScrollKeybindingHandler.tsx +6 -6
  139. package/tui/src/components/Spinner/types.ts +6 -28
  140. package/tui/src/components/agents/generateAgent.ts +1 -1
  141. package/tui/src/components/agents/new-agent-creation/types.ts +4 -26
  142. package/tui/src/components/config/EnvSecretIsolatedEditor.tsx +1 -1
  143. package/tui/src/components/mcp/types.ts +16 -38
  144. package/tui/src/components/messages/AssistantToolUseMessage.tsx +3 -2
  145. package/tui/src/components/messages/UserCrossSessionMessage.ts +16 -4
  146. package/tui/src/components/messages/UserForkBoilerplateMessage.ts +16 -4
  147. package/tui/src/components/messages/UserGitHubWebhookMessage.ts +16 -4
  148. package/tui/src/components/messages/UserToolResultMessage/utils.tsx +3 -2
  149. package/tui/src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.ts +9 -4
  150. package/tui/src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.ts +9 -4
  151. package/tui/src/components/primitive/DocumentSocraticReviewBlock.tsx +129 -0
  152. package/tui/src/components/primitive/DocumentToolResultCard.tsx +224 -0
  153. package/tui/src/components/primitive/documentSocraticReview.ts +215 -0
  154. package/tui/src/components/primitive/index.tsx +43 -1
  155. package/tui/src/components/primitive/types.ts +137 -0
  156. package/tui/src/components/ui/option.ts +4 -26
  157. package/tui/src/constants/common.ts +0 -2
  158. package/tui/src/constants/prompts.ts +4 -3
  159. package/tui/src/constants/querySource.ts +4 -26
  160. package/tui/src/entrypoints/sdk/controlTypes.ts +26 -48
  161. package/tui/src/entrypoints/sdk/coreTypes.generated.ts +3 -25
  162. package/tui/src/entrypoints/sdk/runtimeTypes.ts +38 -60
  163. package/tui/src/entrypoints/sdk/sdkUtilityTypes.ts +4 -26
  164. package/tui/src/entrypoints/sdk/settingsTypes.generated.ts +3 -25
  165. package/tui/src/entrypoints/sdk/toolTypes.ts +3 -25
  166. package/tui/src/hooks/toolPermission/handlers/interactiveHandler.ts +10 -0
  167. package/tui/src/hooks/useApiKeyVerification.ts +1 -1
  168. package/tui/src/hooks/useVirtualScroll.ts +1 -1
  169. package/tui/src/ink/ink.tsx +33 -14
  170. package/tui/src/ink/reconciler.ts +2 -3
  171. package/tui/src/ink/render-to-screen.ts +30 -10
  172. package/tui/src/ipc/bridge.ts +62 -15
  173. package/tui/src/ipc/bridgeSingleton.ts +5 -1
  174. package/tui/src/ipc/codec.ts +3 -3
  175. package/tui/src/ipc/frames.generated.ts +12 -12
  176. package/tui/src/ipc/llmClient.ts +151 -27
  177. package/tui/src/ipc/schema/frame.schema.json +1 -1
  178. package/tui/src/keybindings/defaultBindings.ts +4 -0
  179. package/tui/src/main.tsx +32 -15
  180. package/tui/src/native-ts/file-index/index.ts +33 -3
  181. package/tui/src/observability/surface.ts +2 -2
  182. package/tui/src/probes/toolRegistryProbe.tsx +3 -1
  183. package/tui/src/projectOnboardingState.ts +7 -6
  184. package/tui/src/query/chatMessageTypes.ts +18 -0
  185. package/tui/src/query/chatMessagesBuilder.ts +1 -1
  186. package/tui/src/query/deps.ts +1 -1
  187. package/tui/src/query/messageGuards.ts +106 -0
  188. package/tui/src/query/publicDataTerminalRepair.ts +384 -0
  189. package/tui/src/query/run.ts +1075 -0
  190. package/tui/src/query/supportBoundary.ts +168 -0
  191. package/tui/src/query/toolResultErrors.ts +103 -0
  192. package/tui/src/query/toolRunner.ts +687 -0
  193. package/tui/src/query/unavailableToolRepair.ts +118 -0
  194. package/tui/src/query.ts +9 -2186
  195. package/tui/src/screens/REPL.tsx +40 -29
  196. package/tui/src/services/api/adapterManifest.ts +4 -0
  197. package/tui/src/services/api/backendChat/events.ts +117 -0
  198. package/tui/src/services/api/backendChat/finalMessage.ts +40 -0
  199. package/tui/src/services/api/backendChat/frame.ts +9 -0
  200. package/tui/src/services/api/backendChat/streaming.ts +430 -0
  201. package/tui/src/services/api/backendChat/types.ts +62 -0
  202. package/tui/src/services/api/backendChat.ts +1 -0
  203. package/tui/src/services/api/client.ts +65 -2
  204. package/tui/src/services/api/errorUtils.ts +5 -5
  205. package/tui/src/services/api/errors.ts +1 -1
  206. package/tui/src/services/api/logging.ts +1 -1
  207. package/tui/src/services/api/ummaya/evidence.ts +194 -0
  208. package/tui/src/services/api/ummaya/messages.ts +255 -0
  209. package/tui/src/services/api/ummaya/nonStreaming.ts +66 -0
  210. package/tui/src/services/api/ummaya/provider.ts +200 -0
  211. package/tui/src/services/api/ummaya/reasoning.ts +24 -0
  212. package/tui/src/services/api/ummaya/request.ts +200 -0
  213. package/tui/src/services/api/ummaya/selectionContext.ts +240 -0
  214. package/tui/src/services/api/ummaya/streaming.ts +365 -0
  215. package/tui/src/services/api/ummaya/streamingPayload.ts +129 -0
  216. package/tui/src/services/api/ummaya/streamingReader.ts +40 -0
  217. package/tui/src/services/api/ummaya/toolSelection.ts +217 -0
  218. package/tui/src/services/api/ummaya/types.ts +110 -0
  219. package/tui/src/services/api/ummaya/usage.ts +30 -0
  220. package/tui/src/services/api/ummaya.ts +26 -418
  221. package/tui/src/services/api/withRetry.ts +1 -1
  222. package/tui/src/services/awaySummary.ts +2 -2
  223. package/tui/src/services/claudeAiLimits.ts +1 -1
  224. package/tui/src/services/compact/autoCompact.ts +1 -1
  225. package/tui/src/services/compact/compact.ts +1 -1
  226. package/tui/src/services/lsp/types.ts +8 -30
  227. package/tui/src/services/tips/types.ts +6 -28
  228. package/tui/src/services/tokenEstimation.ts +1 -1
  229. package/tui/src/services/toolRegistry/bootGuard.ts +5 -5
  230. package/tui/src/services/toolUseSummary/toolUseSummaryGenerator.ts +1 -1
  231. package/tui/src/services/tools/toolExecution.ts +94 -1
  232. package/tui/src/store/pendingPermissionSlot.ts +1 -1
  233. package/tui/src/store/session-store.ts +10 -36
  234. package/tui/src/stubs/any-stub.ts +15 -10
  235. package/tui/src/stubs/color-diff-napi.ts +37 -23
  236. package/tui/src/stubs/globals.d.ts +3 -3
  237. package/tui/src/stubs/macro-preload.ts +23 -12
  238. package/tui/src/tools/AdapterTool/AdapterTool.ts +1207 -714
  239. package/tui/src/tools/AdapterTool/routeDiagnostics.ts +75 -0
  240. package/tui/src/tools/AgentTool/AgentTool.tsx +84 -1371
  241. package/tui/src/tools/AgentTool/agentToolHandoff.ts +114 -0
  242. package/tui/src/tools/AgentTool/agentToolPartialResult.ts +16 -0
  243. package/tui/src/tools/AgentTool/agentToolProgress.ts +32 -0
  244. package/tui/src/tools/AgentTool/agentToolResolver.ts +161 -0
  245. package/tui/src/tools/AgentTool/agentToolResult.ts +163 -0
  246. package/tui/src/tools/AgentTool/agentToolUtils.ts +14 -686
  247. package/tui/src/tools/AgentTool/asyncAgentLifecycle.ts +208 -0
  248. package/tui/src/tools/AgentTool/asyncLifecycle.ts +153 -0
  249. package/tui/src/tools/AgentTool/backgroundedCompletion.ts +126 -0
  250. package/tui/src/tools/AgentTool/backgroundedLifecycle.ts +174 -0
  251. package/tui/src/tools/AgentTool/foregroundBackground.ts +83 -0
  252. package/tui/src/tools/AgentTool/foregroundDrain.tsx +133 -0
  253. package/tui/src/tools/AgentTool/foregroundFinalize.ts +98 -0
  254. package/tui/src/tools/AgentTool/foregroundLifecycle.tsx +237 -0
  255. package/tui/src/tools/AgentTool/foregroundProgress.tsx +169 -0
  256. package/tui/src/tools/AgentTool/foregroundTask.ts +89 -0
  257. package/tui/src/tools/AgentTool/forkSubagent.ts +1 -12
  258. package/tui/src/tools/AgentTool/forkSubagentGate.ts +34 -0
  259. package/tui/src/tools/AgentTool/launchRouting.ts +203 -0
  260. package/tui/src/tools/AgentTool/lifecycle.ts +244 -0
  261. package/tui/src/tools/AgentTool/mcpRouting.ts +73 -0
  262. package/tui/src/tools/AgentTool/orchestrationSupport.ts +70 -0
  263. package/tui/src/tools/AgentTool/permissions.ts +39 -0
  264. package/tui/src/tools/AgentTool/promptSetup.ts +181 -0
  265. package/tui/src/tools/AgentTool/remoteRouting.ts +62 -0
  266. package/tui/src/tools/AgentTool/resultMapping.ts +116 -0
  267. package/tui/src/tools/AgentTool/resumeAgent.ts +39 -107
  268. package/tui/src/tools/AgentTool/resumeAgentHelpers.ts +140 -0
  269. package/tui/src/tools/AgentTool/runAgent.ts +1 -1
  270. package/tui/src/tools/AgentTool/runtimeConfig.ts +57 -0
  271. package/tui/src/tools/AgentTool/schemas.ts +196 -0
  272. package/tui/src/tools/AgentTool/sourceVerificationPropagation.ts +263 -0
  273. package/tui/src/tools/AgentTool/worktreeLifecycle.ts +105 -0
  274. package/tui/src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx +174 -202
  275. package/tui/src/tools/BashTool/BashTool.tsx +71 -1072
  276. package/tui/src/tools/BashTool/bashCommandHelpers.ts +12 -12
  277. package/tui/src/tools/BashTool/bashPermissions/astPreflight.ts +173 -0
  278. package/tui/src/tools/BashTool/bashPermissions/classifierChecks.ts +199 -0
  279. package/tui/src/tools/BashTool/bashPermissions/compoundGuards.ts +53 -0
  280. package/tui/src/tools/BashTool/bashPermissions/constants.ts +99 -0
  281. package/tui/src/tools/BashTool/bashPermissions/index.ts +38 -0
  282. package/tui/src/tools/BashTool/bashPermissions/legacyMisparsing.ts +62 -0
  283. package/tui/src/tools/BashTool/bashPermissions/main.ts +135 -0
  284. package/tui/src/tools/BashTool/bashPermissions/normalizedCommands.ts +33 -0
  285. package/tui/src/tools/BashTool/bashPermissions/operatorFlow.ts +98 -0
  286. package/tui/src/tools/BashTool/bashPermissions/permissionChecks.ts +200 -0
  287. package/tui/src/tools/BashTool/bashPermissions/prefixSuggestions.ts +88 -0
  288. package/tui/src/tools/BashTool/bashPermissions/promptClassifierRules.ts +125 -0
  289. package/tui/src/tools/BashTool/bashPermissions/ruleDelegates.ts +19 -0
  290. package/tui/src/tools/BashTool/bashPermissions/ruleMatching.ts +145 -0
  291. package/tui/src/tools/BashTool/bashPermissions/sandboxAutoAllow.ts +75 -0
  292. package/tui/src/tools/BashTool/bashPermissions/subcommandFlow.ts +205 -0
  293. package/tui/src/tools/BashTool/bashPermissions/subcommandGuards.ts +73 -0
  294. package/tui/src/tools/BashTool/bashPermissions/subcommandResultHelpers.ts +116 -0
  295. package/tui/src/tools/BashTool/bashPermissions/types.ts +26 -0
  296. package/tui/src/tools/BashTool/bashPermissions/wrapperStripping.ts +139 -0
  297. package/tui/src/tools/BashTool/bashPermissions.ts +26 -2621
  298. package/tui/src/tools/BashTool/call.ts +202 -0
  299. package/tui/src/tools/BashTool/callLoader.ts +35 -0
  300. package/tui/src/tools/BashTool/commandClassification.ts +151 -0
  301. package/tui/src/tools/BashTool/commandClassificationLoader.ts +40 -0
  302. package/tui/src/tools/BashTool/cwdReset.ts +33 -0
  303. package/tui/src/tools/BashTool/lineTruncation.ts +11 -0
  304. package/tui/src/tools/BashTool/modeValidation.ts +13 -1
  305. package/tui/src/tools/BashTool/outputPersistence.ts +42 -0
  306. package/tui/src/tools/BashTool/permissionClassification.ts +66 -0
  307. package/tui/src/tools/BashTool/permissionLoader.ts +44 -0
  308. package/tui/src/tools/BashTool/resultLoader.ts +29 -0
  309. package/tui/src/tools/BashTool/resultMapping.ts +83 -0
  310. package/tui/src/tools/BashTool/sandboxPolicy.ts +79 -0
  311. package/tui/src/tools/BashTool/schemas.ts +65 -0
  312. package/tui/src/tools/BashTool/sedEditExecution.ts +59 -0
  313. package/tui/src/tools/BashTool/shellExecution.tsx +245 -0
  314. package/tui/src/tools/BashTool/shellOutputUtils.ts +85 -0
  315. package/tui/src/tools/BashTool/shellPermissionGauntlet.ts +97 -0
  316. package/tui/src/tools/BashTool/uiLoader.ts +37 -0
  317. package/tui/src/tools/BriefTool/upload.ts +1 -1
  318. package/tui/src/tools/CalculatorTool/parser.ts +2 -2
  319. package/tui/src/tools/DocumentPrimitive/DocumentPrimitive.ts +262 -0
  320. package/tui/src/tools/DocumentPrimitive/dispatchNormalization.ts +270 -0
  321. package/tui/src/tools/DocumentPrimitive/documentDestinationPath.ts +18 -0
  322. package/tui/src/tools/DocumentPrimitive/documentMutationGuard.ts +22 -0
  323. package/tui/src/tools/DocumentPrimitive/documentPatchNormalization.ts +248 -0
  324. package/tui/src/tools/DocumentPrimitive/documentSourceVerification.ts +245 -0
  325. package/tui/src/tools/DocumentPrimitive/documentSourceVerificationFields.ts +103 -0
  326. package/tui/src/tools/DocumentPrimitive/modelVisibleOutput.ts +40 -0
  327. package/tui/src/tools/DocumentPrimitive/prompt.ts +35 -0
  328. package/tui/src/tools/FileEditTool/FileEditTool.ts +9 -507
  329. package/tui/src/tools/FileEditTool/call.ts +228 -0
  330. package/tui/src/tools/FileEditTool/validateInput.ts +196 -0
  331. package/tui/src/tools/FileReadTool/imageProcessor.ts +13 -0
  332. package/tui/src/tools/FileWriteTool/FileWriteTool.ts +7 -300
  333. package/tui/src/tools/FileWriteTool/call.ts +223 -0
  334. package/tui/src/tools/FileWriteTool/validateInput.ts +80 -0
  335. package/tui/src/tools/ListMcpResourcesTool/ListMcpResourcesTool.ts +19 -3
  336. package/tui/src/tools/LookupPrimitive/LookupPrimitive.ts +25 -32
  337. package/tui/src/tools/LookupPrimitive/prompt.ts +0 -2
  338. package/tui/src/tools/MCPTool/trustPolicy.ts +118 -0
  339. package/tui/src/tools/McpAuthTool/McpAuthTool.ts +21 -3
  340. package/tui/src/tools/NotebookEditTool/NotebookEditTool.ts +7 -326
  341. package/tui/src/tools/NotebookEditTool/call.ts +254 -0
  342. package/tui/src/tools/NotebookEditTool/notebookModel.ts +51 -0
  343. package/tui/src/tools/NotebookEditTool/validateInput.ts +142 -0
  344. package/tui/src/tools/PowerShellTool/PowerShellTool.tsx +46 -937
  345. package/tui/src/tools/PowerShellTool/acceptEditsCommandValidation.ts +162 -0
  346. package/tui/src/tools/PowerShellTool/call.ts +179 -0
  347. package/tui/src/tools/PowerShellTool/callLoader.ts +37 -0
  348. package/tui/src/tools/PowerShellTool/commandClassification.ts +86 -0
  349. package/tui/src/tools/PowerShellTool/modeValidation.ts +25 -332
  350. package/tui/src/tools/PowerShellTool/outputPersistence.ts +42 -0
  351. package/tui/src/tools/PowerShellTool/permissionClassification.ts +28 -0
  352. package/tui/src/tools/PowerShellTool/resultLoader.ts +31 -0
  353. package/tui/src/tools/PowerShellTool/resultMapping.ts +75 -0
  354. package/tui/src/tools/PowerShellTool/schemas.ts +40 -0
  355. package/tui/src/tools/PowerShellTool/shellExecution.tsx +258 -0
  356. package/tui/src/tools/PowerShellTool/symlinkModeValidation.ts +44 -0
  357. package/tui/src/tools/PowerShellTool/uiLoader.ts +37 -0
  358. package/tui/src/tools/PowerShellTool/validation.ts +39 -0
  359. package/tui/src/tools/ReadMcpResourceTool/ReadMcpResourceTool.ts +19 -3
  360. package/tui/src/tools/ResolveLocationPrimitive/ResolveLocationPrimitive.ts +1 -11
  361. package/tui/src/tools/ResolveLocationPrimitive/prompt.ts +2 -6
  362. package/tui/src/tools/SkillTool/SkillTool.ts +2 -2
  363. package/tui/src/tools/SubmitPrimitive/SubmitPrimitive.ts +27 -10
  364. package/tui/src/tools/TaskCreateTool/TaskCreateTool.ts +16 -2
  365. package/tui/src/tools/TaskGetTool/TaskGetTool.ts +23 -3
  366. package/tui/src/tools/TaskListTool/TaskListTool.ts +22 -4
  367. package/tui/src/tools/TaskOutputTool/TaskOutputTool.tsx +46 -547
  368. package/tui/src/tools/TaskOutputTool/lookup.ts +216 -0
  369. package/tui/src/tools/TaskOutputTool/render.tsx +257 -0
  370. package/tui/src/tools/TaskOutputTool/schemas.ts +55 -0
  371. package/tui/src/tools/TaskOutputTool/serialization.ts +36 -0
  372. package/tui/src/tools/TaskStopTool/TaskStopTool.ts +10 -0
  373. package/tui/src/tools/TaskUpdateTool/TaskUpdateTool.ts +14 -364
  374. package/tui/src/tools/TaskUpdateTool/completion.ts +62 -0
  375. package/tui/src/tools/TaskUpdateTool/schemas.ts +62 -0
  376. package/tui/src/tools/TaskUpdateTool/serialization.ts +46 -0
  377. package/tui/src/tools/TaskUpdateTool/statusUpdate.ts +247 -0
  378. package/tui/src/tools/TodoWriteTool/TodoWriteTool.ts +21 -2
  379. package/tui/src/tools/ToolSearchTool/ToolSearchTool.ts +21 -302
  380. package/tui/src/tools/ToolSearchTool/ccSupportTools.ts +223 -0
  381. package/tui/src/tools/ToolSearchTool/descriptionCache.ts +50 -0
  382. package/tui/src/tools/ToolSearchTool/keywordSearch.ts +216 -0
  383. package/tui/src/tools/ToolSearchTool/prompt.ts +10 -4
  384. package/tui/src/tools/ToolSearchTool/resultMapping.ts +30 -0
  385. package/tui/src/tools/ToolSearchTool/schemas.ts +30 -0
  386. package/tui/src/tools/ToolSearchTool/searchPool.ts +47 -0
  387. package/tui/src/tools/ToolSearchTool/supportIntentHints.ts +140 -0
  388. package/tui/src/tools/TranslateTool/TranslateTool.ts +1 -1
  389. package/tui/src/tools/VerifyPrimitive/VerifyPrimitive.ts +2 -1
  390. package/tui/src/tools/WebFetchTool/WebFetchTool.ts +43 -138
  391. package/tui/src/tools/WebFetchTool/call.ts +227 -0
  392. package/tui/src/tools/WebFetchTool/resolvedAddressSafety.ts +78 -0
  393. package/tui/src/tools/WebFetchTool/sourceVerification.ts +204 -0
  394. package/tui/src/tools/WebFetchTool/types.ts +23 -0
  395. package/tui/src/tools/WebFetchTool/urlSafety.ts +181 -0
  396. package/tui/src/tools/WebFetchTool/utils.ts +1 -1
  397. package/tui/src/tools/WebSearchTool/UI.tsx +0 -1
  398. package/tui/src/tools/WebSearchTool/WebSearchTool.ts +9 -313
  399. package/tui/src/tools/WebSearchTool/call.ts +33 -0
  400. package/tui/src/tools/WebSearchTool/responseMapping.ts +190 -0
  401. package/tui/src/tools/WebSearchTool/resultBlock.ts +47 -0
  402. package/tui/src/tools/WebSearchTool/schemas.ts +47 -0
  403. package/tui/src/tools/WebSearchTool/toolSchema.ts +12 -0
  404. package/tui/src/tools/WorkspaceToolAdapter/WorkspaceToolAdapter.ts +79 -0
  405. package/tui/src/tools/WorkspaceToolAdapter/allowedRootPolicy.ts +85 -0
  406. package/tui/src/tools/WorkspaceToolAdapter/documentFormatGuards.ts +73 -0
  407. package/tui/src/tools/WorkspaceToolAdapter/inputNormalization.ts +105 -0
  408. package/tui/src/tools/WorkspaceToolAdapter/mcpExposurePolicy.ts +64 -0
  409. package/tui/src/tools/WorkspaceToolAdapter/toolDefFactory.ts +215 -0
  410. package/tui/src/tools/WorkspaceToolAdapter/toolNames.ts +6 -0
  411. package/tui/src/tools/WorkspaceToolAdapter/workspacePolicy.ts +15 -0
  412. package/tui/src/tools/_shared/dispatchPrimitive.ts +6 -6
  413. package/tui/src/tools/_shared/documentChangeToPatch.ts +125 -0
  414. package/tui/src/tools/_shared/documentDispatchArguments.ts +87 -0
  415. package/tui/src/tools/_shared/documentPrimitiveTimeout.ts +13 -0
  416. package/tui/src/tools/_shared/documentToolResultRender.ts +98 -0
  417. package/tui/src/tools/_shared/pendingCallRegistry.ts +1 -6
  418. package/tui/src/tools/_shared/rootPrimitiveInput.ts +1 -0
  419. package/tui/src/tools/_shared/toolChoiceRepair/documentCompletionPatterns.ts +58 -0
  420. package/tui/src/tools/_shared/toolChoiceRepair/documentCompletionPrompt.ts +271 -0
  421. package/tui/src/tools/_shared/toolChoiceRepair/documentRepair.ts +452 -0
  422. package/tui/src/tools/_shared/toolChoiceRepair/messageAccess.ts +80 -0
  423. package/tui/src/tools/_shared/toolChoiceRepair/publicDataRepair.ts +92 -0
  424. package/tui/src/tools/_shared/toolChoiceRepair/supportRepair.ts +135 -0
  425. package/tui/src/tools/_shared/toolChoiceRepair.ts +55 -860
  426. package/tui/src/tools/shared/mockDisclaimer.ts +1 -1
  427. package/tui/src/tools.ts +39 -190
  428. package/tui/src/types/fileSuggestion.ts +4 -26
  429. package/tui/src/types/generated/events_mono/claude_code/v1/claude_code_internal_event.ts +186 -148
  430. package/tui/src/types/generated/events_mono/common/v1/auth.ts +25 -11
  431. package/tui/src/types/generated/events_mono/growthbook/v1/growthbook_experiment_event.ts +47 -30
  432. package/tui/src/types/generated/google/protobuf/timestamp.ts +21 -7
  433. package/tui/src/types/message.ts +80 -102
  434. package/tui/src/types/messageQueueTypes.ts +6 -28
  435. package/tui/src/types/notebook.ts +16 -38
  436. package/tui/src/types/statusLine.ts +4 -26
  437. package/tui/src/types/tools.ts +24 -46
  438. package/tui/src/types/utils.ts +6 -28
  439. package/tui/src/upstreamproxy/relay.ts +7 -3
  440. package/tui/src/upstreamproxy/upstreamproxy.ts +1 -1
  441. package/tui/src/utils/assistantMessageFactories.ts +9 -3
  442. package/tui/src/utils/auth.ts +129 -139
  443. package/tui/src/utils/bash/ast.ts +23 -23
  444. package/tui/src/utils/bash/bashParser.ts +5 -5
  445. package/tui/src/utils/billing.ts +1 -1
  446. package/tui/src/utils/claudeDesktop.ts +4 -4
  447. package/tui/src/utils/collapseReadSearch.ts +3 -3
  448. package/tui/src/utils/cronTasks.ts +1 -1
  449. package/tui/src/utils/execFileNoThrow.ts +1 -1
  450. package/tui/src/utils/filePersistence/types.ts +16 -38
  451. package/tui/src/utils/forkedAgent.ts +1 -1
  452. package/tui/src/utils/gracefulShutdown.ts +4 -4
  453. package/tui/src/utils/heapDumpService.ts +12 -8
  454. package/tui/src/utils/hooks/apiQueryHookHelper.ts +1 -1
  455. package/tui/src/utils/hooks/execPromptHook.ts +1 -1
  456. package/tui/src/utils/hooks/skillImprovement.ts +1 -1
  457. package/tui/src/utils/mcp/dateTimeParser.ts +1 -1
  458. package/tui/src/utils/messages.ts +18 -0
  459. package/tui/src/utils/migrateSessions.ts +3 -3
  460. package/tui/src/utils/model/model.ts +6 -6
  461. package/tui/src/utils/permissions/yoloClassifier.ts +1 -1
  462. package/tui/src/utils/plugins/headlessPluginInstall.ts +1 -1
  463. package/tui/src/utils/plugins/mcpPluginIntegration.ts +1 -1
  464. package/tui/src/utils/plugins/mcpbHandler.ts +1 -1
  465. package/tui/src/utils/plugins/pluginLoader.ts +8 -8
  466. package/tui/src/utils/protectedNamespace.ts +5 -3
  467. package/tui/src/utils/rawJsonToolCall.ts +242 -0
  468. package/tui/src/utils/ripgrep.ts +16 -7
  469. package/tui/src/utils/sessionTitle.ts +1 -1
  470. package/tui/src/utils/settings/permissionValidation.ts +14 -2
  471. package/tui/src/utils/shell/prefix.ts +1 -1
  472. package/tui/src/utils/sideQuery.ts +1 -1
  473. package/tui/src/utils/systemThemeWatcher.ts +13 -3
  474. package/tui/src/utils/teleport.tsx +1 -1
  475. package/uv.lock +426 -45
  476. package/tui/src/services/api/claude.ts +0 -3540
  477. package/tui/src/tools/_shared/directPublicDataGuard.ts +0 -362
  478. package/tui/src/tools/_shared/kmaAnalysisGuard.ts +0 -197
  479. package/tui/src/tools/_shared/kmaAviationGuard.ts +0 -70
  480. package/tui/src/tools/_shared/nmcAedGuard.ts +0 -234
  481. package/tui/src/tools/_shared/protectedCheckGuard.ts +0 -207
  482. package/tui/src/tools/_shared/textToolCallGuard.ts +0 -91
@@ -1,47 +1,12 @@
1
- import { dirname, sep } from 'path'
2
- import { logEvent } from 'src/services/analytics/index.js'
3
1
  import { z } from 'zod/v4'
4
- import { getFeatureValue_CACHED_MAY_BE_STALE } from '../../services/analytics/growthbook.js'
5
- import { diagnosticTracker } from '../../services/diagnosticTracking.js'
6
- import { clearDeliveredDiagnosticsForFile } from '../../services/lsp/LSPDiagnosticRegistry.js'
7
- import { getLspServerManager } from '../../services/lsp/manager.js'
8
- import { notifyVscodeFileUpdated } from '../../services/mcp/vscodeSdkMcp.js'
9
- import { checkTeamMemSecrets } from '../../services/teamMemorySync/teamMemSecretGuard.js'
10
- import {
11
- activateConditionalSkillsForPaths,
12
- addSkillDirectories,
13
- discoverSkillDirsForPaths,
14
- } from '../../skills/loadSkillsDir.js'
15
- import type { ToolUseContext } from '../../Tool.js'
16
2
  import { buildTool, type ToolDef } from '../../Tool.js'
17
- import { getCwd } from '../../utils/cwd.js'
18
- import { logForDebugging } from '../../utils/debug.js'
19
- import { countLinesChanged, getPatchForDisplay } from '../../utils/diff.js'
20
- import { isEnvTruthy } from '../../utils/envUtils.js'
21
- import { isENOENT } from '../../utils/errors.js'
22
- import { getFileModificationTime, writeTextContent } from '../../utils/file.js'
23
- import {
24
- fileHistoryEnabled,
25
- fileHistoryTrackEdit,
26
- } from '../../utils/fileHistory.js'
27
- import { logFileOperation } from '../../utils/fileOperationAnalytics.js'
28
- import { readFileSyncWithMetadata } from '../../utils/fileRead.js'
29
- import { getFsImplementation } from '../../utils/fsOperations.js'
30
- import {
31
- fetchSingleFileGitDiff,
32
- type ToolUseDiff,
33
- } from '../../utils/gitDiff.js'
34
3
  import { lazySchema } from '../../utils/lazySchema.js'
35
- import { logError } from '../../utils/log.js'
36
4
  import { expandPath } from '../../utils/path.js'
37
- import {
38
- checkWritePermissionForTool,
39
- matchingRuleForInput,
40
- } from '../../utils/permissions/filesystem.js'
5
+ import { checkWritePermissionForTool } from '../../utils/permissions/filesystem.js'
41
6
  import type { PermissionDecision } from '../../utils/permissions/PermissionResult.js'
42
7
  import { matchWildcardPattern } from '../../utils/permissions/shellRuleMatching.js'
43
- import { FILE_UNEXPECTEDLY_MODIFIED_ERROR } from '../FileEditTool/constants.js'
44
8
  import { gitDiffSchema, hunkSchema } from '../FileEditTool/types.js'
9
+ import { callFileWriteTool } from './call.js'
45
10
  import { FILE_WRITE_TOOL_NAME, getWriteToolDescription } from './prompt.js'
46
11
  import {
47
12
  getToolUseSummary,
@@ -52,6 +17,7 @@ import {
52
17
  renderToolUseRejectedMessage,
53
18
  userFacingName,
54
19
  } from './UI.js'
20
+ import { validateFileWriteInput } from './validateInput.js'
55
21
 
56
22
  const inputSchema = lazySchema(() =>
57
23
  z.strictObject({
@@ -150,270 +116,11 @@ export const FileWriteTool = buildTool({
150
116
  // shown — phantom. Under-count: tool_use already indexes file_path.
151
117
  return ''
152
118
  },
153
- async validateInput({ file_path, content }, toolUseContext: ToolUseContext) {
154
- const fullFilePath = expandPath(file_path)
155
-
156
- // Reject writes to team memory files that contain secrets
157
- const secretError = checkTeamMemSecrets(fullFilePath, content)
158
- if (secretError) {
159
- return { result: false, message: secretError, errorCode: 0 }
160
- }
161
-
162
- // Check if path should be ignored based on permission settings
163
- const appState = toolUseContext.getAppState()
164
- const denyRule = matchingRuleForInput(
165
- fullFilePath,
166
- appState.toolPermissionContext,
167
- 'edit',
168
- 'deny',
169
- )
170
- if (denyRule !== null) {
171
- return {
172
- result: false,
173
- message:
174
- 'File is in a directory that is denied by your permission settings.',
175
- errorCode: 1,
176
- }
177
- }
178
-
179
- // SECURITY: Skip filesystem operations for UNC paths to prevent NTLM credential leaks.
180
- // On Windows, fs.existsSync() on UNC paths triggers SMB authentication which could
181
- // leak credentials to malicious servers. Let the permission check handle UNC paths.
182
- if (fullFilePath.startsWith('\\\\') || fullFilePath.startsWith('//')) {
183
- return { result: true }
184
- }
185
-
186
- const fs = getFsImplementation()
187
- let fileMtimeMs: number
188
- try {
189
- const fileStat = await fs.stat(fullFilePath)
190
- fileMtimeMs = fileStat.mtimeMs
191
- } catch (e) {
192
- if (isENOENT(e)) {
193
- return { result: true }
194
- }
195
- throw e
196
- }
197
-
198
- const readTimestamp = toolUseContext.readFileState.get(fullFilePath)
199
- if (!readTimestamp || readTimestamp.isPartialView) {
200
- return {
201
- result: false,
202
- message:
203
- 'File has not been read yet. Read it first before writing to it.',
204
- errorCode: 2,
205
- }
206
- }
207
-
208
- // Reuse mtime from the stat above — avoids a redundant statSync via
209
- // getFileModificationTime. The readTimestamp guard above ensures this
210
- // block is always reached when the file exists.
211
- const lastWriteTime = Math.floor(fileMtimeMs)
212
- if (lastWriteTime > readTimestamp.timestamp) {
213
- return {
214
- result: false,
215
- message:
216
- 'File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.',
217
- errorCode: 3,
218
- }
219
- }
220
-
221
- return { result: true }
119
+ async validateInput(input, toolUseContext) {
120
+ return validateFileWriteInput(input, toolUseContext)
222
121
  },
223
- async call(
224
- { file_path, content },
225
- { readFileState, updateFileHistoryState, dynamicSkillDirTriggers },
226
- _,
227
- parentMessage,
228
- ) {
229
- const fullFilePath = expandPath(file_path)
230
- const dir = dirname(fullFilePath)
231
-
232
- // Discover skills from this file's path (fire-and-forget, non-blocking)
233
- const cwd = getCwd()
234
- const newSkillDirs = await discoverSkillDirsForPaths([fullFilePath], cwd)
235
- if (newSkillDirs.length > 0) {
236
- // Store discovered dirs for attachment display
237
- for (const dir of newSkillDirs) {
238
- dynamicSkillDirTriggers?.add(dir)
239
- }
240
- // Don't await - let skill loading happen in the background
241
- addSkillDirectories(newSkillDirs).catch(() => {})
242
- }
243
-
244
- // Activate conditional skills whose path patterns match this file
245
- activateConditionalSkillsForPaths([fullFilePath], cwd)
246
-
247
- await diagnosticTracker.beforeFileEdited(fullFilePath)
248
-
249
- // Ensure parent directory exists before the atomic read-modify-write section.
250
- // Must stay OUTSIDE the critical section below (a yield between the staleness
251
- // check and writeTextContent lets concurrent edits interleave), and BEFORE the
252
- // write (lazy-mkdir-on-ENOENT would fire a spurious tengu_atomic_write_error
253
- // inside writeFileSyncAndFlush_DEPRECATED before ENOENT propagates back).
254
- await getFsImplementation().mkdir(dir)
255
- if (fileHistoryEnabled()) {
256
- // Backup captures pre-edit content — safe to call before the staleness
257
- // check (idempotent v1 backup keyed on content hash; if staleness fails
258
- // later we just have an unused backup, not corrupt state).
259
- await fileHistoryTrackEdit(
260
- updateFileHistoryState,
261
- fullFilePath,
262
- parentMessage.uuid,
263
- )
264
- }
265
-
266
- // Load current state and confirm no changes since last read.
267
- // Please avoid async operations between here and writing to disk to preserve atomicity.
268
- let meta: ReturnType<typeof readFileSyncWithMetadata> | null
269
- try {
270
- meta = readFileSyncWithMetadata(fullFilePath)
271
- } catch (e) {
272
- if (isENOENT(e)) {
273
- meta = null
274
- } else {
275
- throw e
276
- }
277
- }
278
-
279
- if (meta !== null) {
280
- const lastWriteTime = getFileModificationTime(fullFilePath)
281
- const lastRead = readFileState.get(fullFilePath)
282
- if (!lastRead || lastWriteTime > lastRead.timestamp) {
283
- // Timestamp indicates modification, but on Windows timestamps can change
284
- // without content changes (cloud sync, antivirus, etc.). For full reads,
285
- // compare content as a fallback to avoid false positives.
286
- const isFullRead =
287
- lastRead &&
288
- lastRead.offset === undefined &&
289
- lastRead.limit === undefined
290
- // meta.content is CRLF-normalized — matches readFileState's normalized form.
291
- if (!isFullRead || meta.content !== lastRead.content) {
292
- throw new Error(FILE_UNEXPECTEDLY_MODIFIED_ERROR)
293
- }
294
- }
295
- }
296
-
297
- const enc = meta?.encoding ?? 'utf8'
298
- const oldContent = meta?.content ?? null
299
-
300
- // Write is a full content replacement — the model sent explicit line endings
301
- // in `content` and meant them. Do not rewrite them. Previously we preserved
302
- // the old file's line endings (or sampled the repo via ripgrep for new
303
- // files), which silently corrupted e.g. bash scripts with \r on Linux when
304
- // overwriting a CRLF file or when binaries in cwd poisoned the repo sample.
305
- writeTextContent(fullFilePath, content, enc, 'LF')
306
-
307
- // Notify LSP servers about file modification (didChange) and save (didSave)
308
- const lspManager = getLspServerManager()
309
- if (lspManager) {
310
- // Clear previously delivered diagnostics so new ones will be shown
311
- clearDeliveredDiagnosticsForFile(`file://${fullFilePath}`)
312
- // didChange: Content has been modified
313
- lspManager.changeFile(fullFilePath, content).catch((err: Error) => {
314
- logForDebugging(
315
- `LSP: Failed to notify server of file change for ${fullFilePath}: ${err.message}`,
316
- )
317
- logError(err)
318
- })
319
- // didSave: File has been saved to disk (triggers diagnostics in TypeScript server)
320
- lspManager.saveFile(fullFilePath).catch((err: Error) => {
321
- logForDebugging(
322
- `LSP: Failed to notify server of file save for ${fullFilePath}: ${err.message}`,
323
- )
324
- logError(err)
325
- })
326
- }
327
-
328
- // Notify VSCode about the file change for diff view
329
- notifyVscodeFileUpdated(fullFilePath, oldContent, content)
330
-
331
- // Update read timestamp, to invalidate stale writes
332
- readFileState.set(fullFilePath, {
333
- content,
334
- timestamp: getFileModificationTime(fullFilePath),
335
- offset: undefined,
336
- limit: undefined,
337
- })
338
-
339
- // Log when writing to CLAUDE.md
340
- if (fullFilePath.endsWith(`${sep}CLAUDE.md`)) {
341
- logEvent('tengu_write_claudemd', {})
342
- }
343
-
344
- let gitDiff: ToolUseDiff | undefined
345
- if (
346
- isEnvTruthy(process.env.CLAUDE_CODE_REMOTE) &&
347
- getFeatureValue_CACHED_MAY_BE_STALE('tengu_quartz_lantern', false)
348
- ) {
349
- const startTime = Date.now()
350
- const diff = await fetchSingleFileGitDiff(fullFilePath)
351
- if (diff) gitDiff = diff
352
- logEvent('tengu_tool_use_diff_computed', {
353
- isWriteTool: true,
354
- durationMs: Date.now() - startTime,
355
- hasDiff: !!diff,
356
- })
357
- }
358
-
359
- if (oldContent) {
360
- const patch = getPatchForDisplay({
361
- filePath: file_path,
362
- fileContents: oldContent,
363
- edits: [
364
- {
365
- old_string: oldContent,
366
- new_string: content,
367
- replace_all: false,
368
- },
369
- ],
370
- })
371
-
372
- const data = {
373
- type: 'update' as const,
374
- filePath: file_path,
375
- content,
376
- structuredPatch: patch,
377
- originalFile: oldContent,
378
- ...(gitDiff && { gitDiff }),
379
- }
380
- // Track lines added and removed for file updates, right before yielding result
381
- countLinesChanged(patch)
382
-
383
- logFileOperation({
384
- operation: 'write',
385
- tool: 'FileWriteTool',
386
- filePath: fullFilePath,
387
- type: 'update',
388
- })
389
-
390
- return {
391
- data,
392
- }
393
- }
394
-
395
- const data = {
396
- type: 'create' as const,
397
- filePath: file_path,
398
- content,
399
- structuredPatch: [],
400
- originalFile: null,
401
- ...(gitDiff && { gitDiff }),
402
- }
403
-
404
- // For creation of new files, count all lines as additions, right before yielding the result
405
- countLinesChanged([], content)
406
-
407
- logFileOperation({
408
- operation: 'write',
409
- tool: 'FileWriteTool',
410
- filePath: fullFilePath,
411
- type: 'create',
412
- })
413
-
414
- return {
415
- data,
416
- }
122
+ async call(input, context, _, parentMessage) {
123
+ return callFileWriteTool(input, context, parentMessage)
417
124
  },
418
125
  mapToolResultToToolResultBlockParam({ filePath, type }, toolUseID) {
419
126
  switch (type) {
@@ -0,0 +1,223 @@
1
+ import { dirname, sep } from 'path'
2
+ import { logEvent } from 'src/services/analytics/index.js'
3
+ import { getFeatureValue_CACHED_MAY_BE_STALE } from '../../services/analytics/growthbook.js'
4
+ import { diagnosticTracker } from '../../services/diagnosticTracking.js'
5
+ import { clearDeliveredDiagnosticsForFile } from '../../services/lsp/LSPDiagnosticRegistry.js'
6
+ import { notifyVscodeFileUpdated } from '../../services/mcp/vscodeSdkMcp.js'
7
+ import {
8
+ activateConditionalSkillsForPaths,
9
+ addSkillDirectories,
10
+ discoverSkillDirsForPaths,
11
+ } from '../../skills/loadSkillsDir.js'
12
+ import type { ToolResult, ToolUseContext } from '../../Tool.js'
13
+ import type { AssistantMessage } from '../../types/message.js'
14
+ import { getCwd } from '../../utils/cwd.js'
15
+ import { logForDebugging } from '../../utils/debug.js'
16
+ import { countLinesChanged, getPatchForDisplay } from '../../utils/diff.js'
17
+ import { isEnvTruthy } from '../../utils/envUtils.js'
18
+ import { isENOENT } from '../../utils/errors.js'
19
+ import { getFileModificationTime, writeTextContent } from '../../utils/file.js'
20
+ import { logFileOperation } from '../../utils/fileOperationAnalytics.js'
21
+ import { readFileSyncWithMetadata } from '../../utils/fileRead.js'
22
+ import { getFsImplementation } from '../../utils/fsOperations.js'
23
+ import {
24
+ fetchSingleFileGitDiff,
25
+ type ToolUseDiff,
26
+ } from '../../utils/gitDiff.js'
27
+ import { logError } from '../../utils/log.js'
28
+ import { expandPath } from '../../utils/path.js'
29
+ import { documentDerivativeMutationValidationForResolvedTarget } from '../DocumentPrimitive/documentMutationGuard.js'
30
+ import { FILE_UNEXPECTEDLY_MODIFIED_ERROR } from '../FileEditTool/constants.js'
31
+ import type { FileWriteInput } from './validateInput.js'
32
+
33
+ type FileWritePatch = ReturnType<typeof getPatchForDisplay>
34
+
35
+ type FileWriteUpdateData = {
36
+ type: 'update'
37
+ filePath: string
38
+ content: string
39
+ structuredPatch: FileWritePatch
40
+ originalFile: string
41
+ gitDiff?: ToolUseDiff
42
+ }
43
+
44
+ type FileWriteCreateData = {
45
+ type: 'create'
46
+ filePath: string
47
+ content: string
48
+ structuredPatch: FileWritePatch
49
+ originalFile: null
50
+ gitDiff?: ToolUseDiff
51
+ }
52
+
53
+ type FileWriteData = FileWriteUpdateData | FileWriteCreateData
54
+
55
+ export async function callFileWriteTool(
56
+ { file_path, content }: FileWriteInput,
57
+ {
58
+ readFileState,
59
+ updateFileHistoryState,
60
+ dynamicSkillDirTriggers,
61
+ }: ToolUseContext,
62
+ parentMessage: AssistantMessage,
63
+ ): Promise<ToolResult<FileWriteData>> {
64
+ const fullFilePath = expandPath(file_path)
65
+ const documentValidation =
66
+ documentDerivativeMutationValidationForResolvedTarget(fullFilePath)
67
+ if (documentValidation !== null) throw new Error(documentValidation.message)
68
+
69
+ const dir = dirname(fullFilePath)
70
+
71
+ const cwd = getCwd()
72
+ const newSkillDirs = await discoverSkillDirsForPaths([fullFilePath], cwd)
73
+ if (newSkillDirs.length > 0) {
74
+ for (const dir of newSkillDirs) {
75
+ dynamicSkillDirTriggers?.add(dir)
76
+ }
77
+ addSkillDirectories(newSkillDirs).catch(() => {})
78
+ }
79
+
80
+ activateConditionalSkillsForPaths([fullFilePath], cwd)
81
+
82
+ await diagnosticTracker.beforeFileEdited(fullFilePath)
83
+
84
+ await getFsImplementation().mkdir(dir)
85
+ const { fileHistoryEnabled, fileHistoryTrackEdit } = await import(
86
+ '../../utils/fileHistory.js'
87
+ )
88
+ if (fileHistoryEnabled()) {
89
+ await fileHistoryTrackEdit(
90
+ updateFileHistoryState,
91
+ fullFilePath,
92
+ parentMessage.uuid,
93
+ )
94
+ }
95
+
96
+ let meta: ReturnType<typeof readFileSyncWithMetadata> | null
97
+ try {
98
+ meta = readFileSyncWithMetadata(fullFilePath)
99
+ } catch (e) {
100
+ if (isENOENT(e)) {
101
+ meta = null
102
+ } else {
103
+ throw e
104
+ }
105
+ }
106
+
107
+ if (meta !== null) {
108
+ const lastWriteTime = getFileModificationTime(fullFilePath)
109
+ const lastRead = readFileState.get(fullFilePath)
110
+ if (!lastRead || lastWriteTime > lastRead.timestamp) {
111
+ const isFullRead =
112
+ lastRead &&
113
+ lastRead.offset === undefined &&
114
+ lastRead.limit === undefined
115
+ if (!isFullRead || meta.content !== lastRead.content) {
116
+ throw new Error(FILE_UNEXPECTEDLY_MODIFIED_ERROR)
117
+ }
118
+ }
119
+ }
120
+
121
+ const enc = meta?.encoding ?? 'utf8'
122
+ const oldContent = meta?.content ?? null
123
+ writeTextContent(fullFilePath, content, enc, 'LF')
124
+
125
+ const { getLspServerManager } = await import('../../services/lsp/manager.js')
126
+ const lspManager = getLspServerManager()
127
+ if (lspManager) {
128
+ clearDeliveredDiagnosticsForFile(`file://${fullFilePath}`)
129
+ lspManager.changeFile(fullFilePath, content).catch((err: Error) => {
130
+ logForDebugging(
131
+ `LSP: Failed to notify server of file change for ${fullFilePath}: ${err.message}`,
132
+ )
133
+ logError(err)
134
+ })
135
+ lspManager.saveFile(fullFilePath).catch((err: Error) => {
136
+ logForDebugging(
137
+ `LSP: Failed to notify server of file save for ${fullFilePath}: ${err.message}`,
138
+ )
139
+ logError(err)
140
+ })
141
+ }
142
+
143
+ notifyVscodeFileUpdated(fullFilePath, oldContent, content)
144
+
145
+ readFileState.set(fullFilePath, {
146
+ content,
147
+ timestamp: getFileModificationTime(fullFilePath),
148
+ offset: undefined,
149
+ limit: undefined,
150
+ })
151
+
152
+ if (fullFilePath.endsWith(`${sep}CLAUDE.md`)) {
153
+ logEvent('tengu_write_claudemd', {})
154
+ }
155
+
156
+ let gitDiff: ToolUseDiff | undefined
157
+ if (
158
+ isEnvTruthy(process.env.CLAUDE_CODE_REMOTE) &&
159
+ getFeatureValue_CACHED_MAY_BE_STALE('tengu_quartz_lantern', false)
160
+ ) {
161
+ const startTime = Date.now()
162
+ const diff = await fetchSingleFileGitDiff(fullFilePath)
163
+ if (diff) gitDiff = diff
164
+ logEvent('tengu_tool_use_diff_computed', {
165
+ isWriteTool: true,
166
+ durationMs: Date.now() - startTime,
167
+ hasDiff: !!diff,
168
+ })
169
+ }
170
+
171
+ if (oldContent) {
172
+ const patch = getPatchForDisplay({
173
+ filePath: file_path,
174
+ fileContents: oldContent,
175
+ edits: [
176
+ {
177
+ old_string: oldContent,
178
+ new_string: content,
179
+ replace_all: false,
180
+ },
181
+ ],
182
+ })
183
+
184
+ const data: FileWriteUpdateData = {
185
+ type: 'update',
186
+ filePath: file_path,
187
+ content,
188
+ structuredPatch: patch,
189
+ originalFile: oldContent,
190
+ ...(gitDiff && { gitDiff }),
191
+ }
192
+ countLinesChanged(patch)
193
+
194
+ logFileOperation({
195
+ operation: 'write',
196
+ tool: 'FileWriteTool',
197
+ filePath: fullFilePath,
198
+ type: 'update',
199
+ })
200
+
201
+ return { data }
202
+ }
203
+
204
+ const data: FileWriteCreateData = {
205
+ type: 'create',
206
+ filePath: file_path,
207
+ content,
208
+ structuredPatch: [],
209
+ originalFile: null,
210
+ ...(gitDiff && { gitDiff }),
211
+ }
212
+
213
+ countLinesChanged([], content)
214
+
215
+ logFileOperation({
216
+ operation: 'write',
217
+ tool: 'FileWriteTool',
218
+ filePath: fullFilePath,
219
+ type: 'create',
220
+ })
221
+
222
+ return { data }
223
+ }
@@ -0,0 +1,80 @@
1
+ import type { ToolUseContext, ValidationResult } from '../../Tool.js'
2
+ import { checkTeamMemSecrets } from '../../services/teamMemorySync/teamMemSecretGuard.js'
3
+ import { isENOENT } from '../../utils/errors.js'
4
+ import { getFsImplementation } from '../../utils/fsOperations.js'
5
+ import { expandPath } from '../../utils/path.js'
6
+ import { matchingRuleForInput } from '../../utils/permissions/filesystem.js'
7
+ import { documentDerivativeMutationValidationForResolvedTarget } from '../DocumentPrimitive/documentMutationGuard.js'
8
+
9
+ export type FileWriteInput = {
10
+ file_path: string
11
+ content: string
12
+ }
13
+
14
+ export async function validateFileWriteInput(
15
+ { file_path, content }: FileWriteInput,
16
+ toolUseContext: ToolUseContext,
17
+ ): Promise<ValidationResult> {
18
+ const fullFilePath = expandPath(file_path)
19
+ const documentValidation =
20
+ documentDerivativeMutationValidationForResolvedTarget(fullFilePath)
21
+ if (documentValidation !== null) return documentValidation
22
+
23
+ const secretError = checkTeamMemSecrets(fullFilePath, content)
24
+ if (secretError) {
25
+ return { result: false, message: secretError, errorCode: 0 }
26
+ }
27
+
28
+ const appState = toolUseContext.getAppState()
29
+ const denyRule = matchingRuleForInput(
30
+ fullFilePath,
31
+ appState.toolPermissionContext,
32
+ 'edit',
33
+ 'deny',
34
+ )
35
+ if (denyRule !== null) {
36
+ return {
37
+ result: false,
38
+ message:
39
+ 'File is in a directory that is denied by your permission settings.',
40
+ errorCode: 1,
41
+ }
42
+ }
43
+
44
+ if (fullFilePath.startsWith('\\\\') || fullFilePath.startsWith('//')) {
45
+ return { result: true }
46
+ }
47
+
48
+ const fs = getFsImplementation()
49
+ let fileMtimeMs: number
50
+ try {
51
+ const fileStat = await fs.stat(fullFilePath)
52
+ fileMtimeMs = fileStat.mtimeMs
53
+ } catch (e) {
54
+ if (isENOENT(e)) {
55
+ return { result: true }
56
+ }
57
+ throw e
58
+ }
59
+
60
+ const readTimestamp = toolUseContext.readFileState.get(fullFilePath)
61
+ if (!readTimestamp || readTimestamp.isPartialView) {
62
+ return {
63
+ result: false,
64
+ message: 'File has not been read yet. Read it first before writing to it.',
65
+ errorCode: 2,
66
+ }
67
+ }
68
+
69
+ const lastWriteTime = Math.floor(fileMtimeMs)
70
+ if (lastWriteTime > readTimestamp.timestamp) {
71
+ return {
72
+ result: false,
73
+ message:
74
+ 'File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.',
75
+ errorCode: 3,
76
+ }
77
+ }
78
+
79
+ return { result: true }
80
+ }
@@ -9,6 +9,10 @@ import { lazySchema } from '../../utils/lazySchema.js'
9
9
  import { logMCPError } from '../../utils/log.js'
10
10
  import { jsonStringify } from '../../utils/slowOperations.js'
11
11
  import { isOutputLineTruncated } from '../../utils/terminal.js'
12
+ import {
13
+ assertTrustedMcpServerForResourceAccess,
14
+ isTrustedMcpServer,
15
+ } from '../MCPTool/trustPolicy.js'
12
16
  import { DESCRIPTION, LIST_MCP_RESOURCES_TOOL_NAME, PROMPT } from './prompt.js'
13
17
  import { renderToolResultMessage, renderToolUseMessage } from './UI.js'
14
18
 
@@ -16,6 +20,8 @@ const inputSchema = lazySchema(() =>
16
20
  z.object({
17
21
  server: z
18
22
  .string()
23
+ .trim()
24
+ .min(1, 'Server name cannot be empty')
19
25
  .optional()
20
26
  .describe('Optional server name to filter resources by'),
21
27
  }),
@@ -49,7 +55,7 @@ export const ListMcpResourcesTool = buildTool({
49
55
  },
50
56
  shouldDefer: true,
51
57
  name: LIST_MCP_RESOURCES_TOOL_NAME,
52
- searchHint: 'list resources from connected MCP servers',
58
+ searchHint: 'list resources from connected MCP servers with trust boundary checks',
53
59
  maxResultSizeChars: 100_000,
54
60
  async description() {
55
61
  return DESCRIPTION
@@ -63,12 +69,19 @@ export const ListMcpResourcesTool = buildTool({
63
69
  get outputSchema(): OutputSchema {
64
70
  return outputSchema()
65
71
  },
66
- async call(input, { options: { mcpClients } }) {
72
+ async call(input, { options: { mcpClients }, getAppState }) {
67
73
  const { server: targetServer } = input
74
+ const permissionContext = getAppState().toolPermissionContext
75
+
76
+ if (targetServer !== undefined) {
77
+ assertTrustedMcpServerForResourceAccess(permissionContext, targetServer)
78
+ }
68
79
 
69
80
  const clientsToProcess = targetServer
70
81
  ? mcpClients.filter(client => client.name === targetServer)
71
- : mcpClients
82
+ : mcpClients.filter(client =>
83
+ isTrustedMcpServer(permissionContext, client.name),
84
+ )
72
85
 
73
86
  if (targetServer && clientsToProcess.length === 0) {
74
87
  throw new Error(
@@ -88,6 +101,9 @@ export const ListMcpResourcesTool = buildTool({
88
101
  const fresh = await ensureConnectedClient(client)
89
102
  return await fetchResourcesForClient(fresh)
90
103
  } catch (error) {
104
+ if (!(error instanceof Error)) {
105
+ throw error
106
+ }
91
107
  // One server's reconnect failure shouldn't sink the whole result.
92
108
  logMCPError(client.name, errorMessage(error))
93
109
  return []