@promptbook/node 0.114.0-2 → 0.114.0-21

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 (348) hide show
  1. package/README.md +8 -16
  2. package/esm/index.es.js +1466 -4791
  3. package/esm/index.es.js.map +1 -1
  4. package/esm/scripts/run-agent-messages/messages/buildAgentGoalChatPromptSection.d.ts +26 -0
  5. package/esm/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts +12 -1
  6. package/esm/scripts/run-agent-messages/messages/buildAgentProjectsPromptSection.d.ts +2 -14
  7. package/esm/scripts/run-agent-messages/messages/buildAgentTeamPromptSection.d.ts +12 -0
  8. package/esm/scripts/run-codex-prompts/common/runGoScript/$spawnLoggedBashScript.d.ts +25 -0
  9. package/esm/scripts/run-codex-prompts/common/runGoScript/$terminateLoggedBashProcessTree.d.ts +11 -0
  10. package/esm/scripts/run-codex-prompts/common/runGoScript/scriptExecutionLog.d.ts +11 -0
  11. package/esm/scripts/run-codex-prompts/common/waitForPause.d.ts +92 -0
  12. package/esm/scripts/run-codex-prompts/common/waitForSkippableWorldTimeDeadline.d.ts +15 -0
  13. package/esm/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts +8 -1
  14. package/esm/src/_packages/components.index.d.ts +4 -0
  15. package/esm/src/_packages/types.index.d.ts +4 -0
  16. package/esm/src/avatars/renderAvatarVisualTerminalText.d.ts +80 -0
  17. package/esm/src/avatars/types/AvatarVisualDefinition.d.ts +54 -0
  18. package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts +3 -3
  19. package/esm/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -0
  20. package/esm/src/book-2.0/agent-source/ParsedUnknownCommitment.d.ts +26 -0
  21. package/esm/src/book-2.0/agent-source/getBookCommitmentLineType.d.ts +19 -0
  22. package/esm/src/book-3.0/AgentMessageRunReport.d.ts +46 -0
  23. package/esm/src/book-3.0/AgentPlannedMessagesSidecar.d.ts +127 -0
  24. package/esm/src/book-3.0/AgentTeamConversationWorkspace.d.ts +85 -0
  25. package/esm/src/book-3.0/createAgentMessageSidecarBaseName.d.ts +13 -0
  26. package/esm/src/book-3.0/describeAgentPlannedMessageSchedule.d.ts +31 -0
  27. package/esm/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +1 -9
  28. package/esm/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.d.ts +28 -0
  29. package/esm/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.d.ts +28 -0
  30. package/esm/src/book-components/Chat/Chat/ChatProps.d.ts +3 -2
  31. package/esm/src/book-components/Chat/Chat/renderAgentProjectDiff.d.ts +13 -0
  32. package/esm/src/book-components/Chat/Chat/renderAgentProjectToolCallDetails.d.ts +16 -0
  33. package/esm/src/book-components/Chat/utils/$provideServerDomWindow.d.ts +11 -0
  34. package/esm/src/book-components/Chat/utils/agentProjectToolCall.d.ts +85 -0
  35. package/esm/src/book-components/Chat/utils/externalSourceToolCall.d.ts +38 -0
  36. package/esm/src/book-components/Chat/utils/renderMarkdown.d.ts +68 -3
  37. package/esm/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts +30 -0
  38. package/esm/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.d.ts +7 -0
  39. package/esm/src/cli/cli-commands/coder/GitChangesMode.d.ts +28 -0
  40. package/esm/src/cli/cli-commands/coder/boilerplateCount.d.ts +52 -0
  41. package/esm/src/cli/cli-commands/coder/generate-boilerplates.d.ts +4 -3
  42. package/esm/src/cli/cli-commands/coder/ping.d.ts +2 -5
  43. package/esm/src/cli/cli-commands/coder/verify.d.ts +1 -1
  44. package/esm/src/cli/cli-commands/coder/waitOptions.d.ts +12 -0
  45. package/esm/src/cli/cli-commands/coder.d.ts +1 -1
  46. package/esm/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts +34 -0
  47. package/esm/src/cli/cli-commands/common/harness/$checkHarnessInstallation.d.ts +3 -3
  48. package/esm/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.d.ts +3 -3
  49. package/esm/src/cli/cli-commands/common/harness/HarnessInstallationStatus.d.ts +3 -2
  50. package/esm/src/cli/cli-commands/common/harnessUpdateCliOptions.d.ts +29 -0
  51. package/esm/src/cli/cli-commands/common/{harness/$askForHarnessInstallationApproval.d.ts → npm/$askForNpmPackageInstallationApproval.d.ts} +2 -2
  52. package/{umd/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts → esm/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.d.ts} +2 -3
  53. package/esm/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.d.ts +12 -0
  54. package/esm/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.d.ts +12 -0
  55. package/esm/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.d.ts +12 -0
  56. package/esm/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +9 -2
  57. package/esm/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts +9 -0
  58. package/esm/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts +14 -0
  59. package/esm/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts +12 -0
  60. package/esm/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts +10 -0
  61. package/esm/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.d.ts +66 -0
  62. package/esm/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.d.ts +26 -0
  63. package/esm/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.d.ts +7 -0
  64. package/esm/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.d.ts +7 -0
  65. package/esm/src/cli/common/loadPromptsModule.d.ts +16 -0
  66. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +15 -0
  67. package/esm/src/commitments/{COMPONENT/COMPONENT.d.ts → META_FULLNAME/META_FULLNAME.d.ts} +8 -5
  68. package/esm/src/commitments/META_ID/META_ID.d.ts +32 -0
  69. package/esm/src/commitments/index.d.ts +4 -12
  70. package/esm/src/executables/platforms/locateAppOnWindows.d.ts +1 -1
  71. package/esm/src/llm-providers/agent/Agent.d.ts +1 -1
  72. package/esm/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts +1 -1
  73. package/esm/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts +1 -1
  74. package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts +1 -1
  75. package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.d.ts +2 -2
  76. package/esm/src/llm-providers/openai/OpenAiAssistantExecutionToolsStreamRunner.d.ts +1 -1
  77. package/esm/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.d.ts +1 -1
  78. package/esm/src/llm-providers/openai/OpenAiCompatibleNonChatPromptCaller.d.ts +1 -1
  79. package/esm/src/llm-providers/openai/OpenAiCompatibleRequestManager.d.ts +1 -1
  80. package/esm/src/llm-providers/openai/utils/callOpenAiCompatibleChatModel.d.ts +1 -1
  81. package/esm/src/llm-providers/openai/utils/loadOpenAiAgentsModule.d.ts +203 -0
  82. package/esm/src/llm-providers/openai/utils/uploadFilesToOpenAi.d.ts +1 -1
  83. package/esm/src/{commitments/USE_BROWSER → scrapers/_common/utils}/fetchUrlContent.d.ts +2 -3
  84. package/esm/src/utils/agent-message-runtime/AgentMessageProjectChange.d.ts +76 -0
  85. package/esm/src/utils/agent-message-runtime/AgentMessageTouchedExternalSource.d.ts +45 -0
  86. package/esm/src/utils/agent-message-runtime/parseAgentMessageRuntimeLogEvents.d.ts +62 -0
  87. package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts +3 -3
  88. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.d.ts +18 -0
  89. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.d.ts +19 -0
  90. package/esm/src/utils/agents/terminalAgentAvatarVisual.d.ts +5 -2
  91. package/esm/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts +6 -0
  92. package/esm/src/utils/ascii-art/createAnsiColorCode.d.ts +46 -0
  93. package/esm/src/utils/misc/createLazyModuleLoader.d.ts +14 -0
  94. package/esm/src/utils/misc/debounce.d.ts +4 -2
  95. package/esm/src/version.d.ts +1 -1
  96. package/package.json +2 -5
  97. package/umd/index.umd.js +1478 -4800
  98. package/umd/index.umd.js.map +1 -1
  99. package/umd/scripts/run-agent-messages/messages/buildAgentGoalChatPromptSection.d.ts +26 -0
  100. package/umd/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts +12 -1
  101. package/umd/scripts/run-agent-messages/messages/buildAgentProjectsPromptSection.d.ts +2 -14
  102. package/umd/scripts/run-agent-messages/messages/buildAgentTeamPromptSection.d.ts +12 -0
  103. package/umd/scripts/run-codex-prompts/common/runGoScript/$spawnLoggedBashScript.d.ts +25 -0
  104. package/umd/scripts/run-codex-prompts/common/runGoScript/$terminateLoggedBashProcessTree.d.ts +11 -0
  105. package/umd/scripts/run-codex-prompts/common/runGoScript/scriptExecutionLog.d.ts +11 -0
  106. package/umd/scripts/run-codex-prompts/common/waitForPause.d.ts +92 -0
  107. package/umd/scripts/run-codex-prompts/common/waitForSkippableWorldTimeDeadline.d.ts +15 -0
  108. package/umd/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts +8 -1
  109. package/umd/src/_packages/components.index.d.ts +4 -0
  110. package/umd/src/_packages/types.index.d.ts +4 -0
  111. package/umd/src/avatars/renderAvatarVisualTerminalText.d.ts +80 -0
  112. package/umd/src/avatars/types/AvatarVisualDefinition.d.ts +54 -0
  113. package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts +3 -3
  114. package/umd/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -0
  115. package/umd/src/book-2.0/agent-source/ParsedUnknownCommitment.d.ts +26 -0
  116. package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.unknown.test.d.ts +1 -0
  117. package/umd/src/book-2.0/agent-source/getBookCommitmentLineType.d.ts +19 -0
  118. package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.unknown.test.d.ts +1 -0
  119. package/umd/src/book-3.0/AgentMessageRunReport.d.ts +46 -0
  120. package/umd/src/book-3.0/AgentPlannedMessagesSidecar.d.ts +127 -0
  121. package/umd/src/book-3.0/AgentPlannedMessagesSidecar.test.d.ts +1 -0
  122. package/umd/src/book-3.0/AgentTeamConversationWorkspace.d.ts +85 -0
  123. package/umd/src/book-3.0/createAgentMessageSidecarBaseName.d.ts +13 -0
  124. package/umd/src/book-3.0/describeAgentPlannedMessageSchedule.d.ts +31 -0
  125. package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +1 -9
  126. package/umd/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.d.ts +28 -0
  127. package/umd/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.test.d.ts +1 -0
  128. package/umd/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.d.ts +28 -0
  129. package/umd/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.test.d.ts +1 -0
  130. package/umd/src/book-components/Chat/Chat/ChatProps.d.ts +3 -2
  131. package/umd/src/book-components/Chat/Chat/renderAgentProjectDiff.d.ts +13 -0
  132. package/umd/src/book-components/Chat/Chat/renderAgentProjectToolCallDetails.d.ts +16 -0
  133. package/umd/src/book-components/Chat/utils/$provideServerDomWindow.d.ts +11 -0
  134. package/umd/src/book-components/Chat/utils/agentProjectToolCall.d.ts +85 -0
  135. package/umd/src/book-components/Chat/utils/agentProjectToolCall.test.d.ts +1 -0
  136. package/umd/src/book-components/Chat/utils/externalSourceToolCall.d.ts +38 -0
  137. package/umd/src/book-components/Chat/utils/renderMarkdown.d.ts +68 -3
  138. package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts +30 -0
  139. package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.d.ts +7 -0
  140. package/umd/src/cli/cli-commands/coder/GitChangesMode.d.ts +28 -0
  141. package/umd/src/cli/cli-commands/coder/boilerplateCount.d.ts +52 -0
  142. package/umd/src/cli/cli-commands/coder/boilerplateCount.test.d.ts +1 -0
  143. package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts +4 -3
  144. package/umd/src/cli/cli-commands/coder/generate-boilerplates.test.d.ts +1 -0
  145. package/umd/src/cli/cli-commands/coder/ping.d.ts +2 -5
  146. package/umd/src/cli/cli-commands/coder/verify.d.ts +1 -1
  147. package/umd/src/cli/cli-commands/coder/waitOptions.d.ts +12 -0
  148. package/umd/src/cli/cli-commands/coder.d.ts +1 -1
  149. package/umd/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts +34 -0
  150. package/umd/src/cli/cli-commands/common/coderGitSyncCliOptions.test.d.ts +1 -0
  151. package/umd/src/cli/cli-commands/common/harness/$checkHarnessInstallation.d.ts +3 -3
  152. package/umd/src/cli/cli-commands/common/harness/$checkHarnessInstallation.test.d.ts +1 -0
  153. package/umd/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.d.ts +3 -3
  154. package/umd/src/cli/cli-commands/common/harness/HarnessInstallationStatus.d.ts +3 -2
  155. package/umd/src/cli/cli-commands/common/harnessUpdateCliOptions.d.ts +29 -0
  156. package/umd/src/cli/cli-commands/common/harnessUpdateCliOptions.test.d.ts +1 -0
  157. package/umd/src/cli/cli-commands/common/{harness/$askForHarnessInstallationApproval.d.ts → npm/$askForNpmPackageInstallationApproval.d.ts} +2 -2
  158. package/{esm/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts → umd/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.d.ts} +2 -3
  159. package/umd/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.test.d.ts +1 -0
  160. package/umd/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.d.ts +12 -0
  161. package/umd/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.test.d.ts +1 -0
  162. package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.d.ts +12 -0
  163. package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.test.d.ts +1 -0
  164. package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.d.ts +12 -0
  165. package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.test.d.ts +1 -0
  166. package/umd/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +9 -2
  167. package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts +9 -0
  168. package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.test.d.ts +1 -0
  169. package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts +14 -0
  170. package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.test.d.ts +1 -0
  171. package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts +12 -0
  172. package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.test.d.ts +1 -0
  173. package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts +10 -0
  174. package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.test.d.ts +1 -0
  175. package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.d.ts +66 -0
  176. package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.d.ts +26 -0
  177. package/umd/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.d.ts +7 -0
  178. package/umd/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.d.ts +7 -0
  179. package/umd/src/cli/common/loadPromptsModule.d.ts +16 -0
  180. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +15 -0
  181. package/umd/src/commitments/{COMPONENT/COMPONENT.d.ts → META_FULLNAME/META_FULLNAME.d.ts} +8 -5
  182. package/umd/src/commitments/META_ID/META_ID.d.ts +32 -0
  183. package/umd/src/commitments/index.d.ts +4 -12
  184. package/umd/src/executables/platforms/locateAppOnWindows.d.ts +1 -1
  185. package/umd/src/executables/platforms/locateAppOnWindows.test.d.ts +1 -0
  186. package/umd/src/llm-providers/agent/Agent.d.ts +1 -1
  187. package/umd/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts +1 -1
  188. package/umd/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts +1 -1
  189. package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts +1 -1
  190. package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.d.ts +2 -2
  191. package/umd/src/llm-providers/openai/OpenAiAssistantExecutionToolsStreamRunner.d.ts +1 -1
  192. package/umd/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.d.ts +1 -1
  193. package/umd/src/llm-providers/openai/OpenAiCompatibleNonChatPromptCaller.d.ts +1 -1
  194. package/umd/src/llm-providers/openai/OpenAiCompatibleRequestManager.d.ts +1 -1
  195. package/umd/src/llm-providers/openai/utils/callOpenAiCompatibleChatModel.d.ts +1 -1
  196. package/umd/src/llm-providers/openai/utils/loadOpenAiAgentsModule.d.ts +203 -0
  197. package/umd/src/llm-providers/openai/utils/uploadFilesToOpenAi.d.ts +1 -1
  198. package/umd/src/{commitments/USE_BROWSER → scrapers/_common/utils}/fetchUrlContent.d.ts +2 -3
  199. package/umd/src/utils/agent-message-runtime/AgentMessageProjectChange.d.ts +76 -0
  200. package/umd/src/utils/agent-message-runtime/AgentMessageTouchedExternalSource.d.ts +45 -0
  201. package/umd/src/utils/agent-message-runtime/parseAgentMessageRuntimeLogEvents.d.ts +62 -0
  202. package/umd/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts +3 -3
  203. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.d.ts +18 -0
  204. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.test.d.ts +1 -0
  205. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.d.ts +19 -0
  206. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.test.d.ts +1 -0
  207. package/umd/src/utils/agents/terminalAgentAvatarVisual.d.ts +5 -2
  208. package/umd/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts +6 -0
  209. package/umd/src/utils/ascii-art/createAnsiColorCode.d.ts +46 -0
  210. package/umd/src/utils/misc/createLazyModuleLoader.d.ts +14 -0
  211. package/umd/src/utils/misc/debounce.d.ts +4 -2
  212. package/umd/src/utils/misc/debounce.test.d.ts +1 -0
  213. package/umd/src/utils/random/$generateBookBoilerplate.test.d.ts +1 -0
  214. package/umd/src/version.d.ts +1 -1
  215. package/esm/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts +0 -11
  216. package/esm/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts +0 -9
  217. package/esm/src/commitments/MEMORY/MEMORY.d.ts +0 -48
  218. package/esm/src/commitments/MEMORY/MemoryToolNames.d.ts +0 -11
  219. package/esm/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +0 -149
  220. package/esm/src/commitments/MEMORY/createMemorySystemMessage.d.ts +0 -6
  221. package/esm/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +0 -8
  222. package/esm/src/commitments/MEMORY/createMemoryTools.d.ts +0 -14
  223. package/esm/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +0 -6
  224. package/esm/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  225. package/esm/src/commitments/MEMORY/getMemoryToolTitles.d.ts +0 -7
  226. package/esm/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +0 -61
  227. package/esm/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +0 -8
  228. package/esm/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +0 -13
  229. package/esm/src/commitments/META/META.d.ts +0 -65
  230. package/esm/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts +0 -32
  231. package/esm/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +0 -58
  232. package/esm/src/commitments/USE_BROWSER/fetchUrlContentViaBrowser.d.ts +0 -13
  233. package/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +0 -10
  234. package/esm/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.d.ts +0 -47
  235. package/esm/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +0 -38
  236. package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +0 -21
  237. package/esm/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts +0 -11
  238. package/esm/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +0 -13
  239. package/esm/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts +0 -46
  240. package/esm/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +0 -38
  241. package/esm/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +0 -9
  242. package/esm/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +0 -12
  243. package/esm/src/commitments/USE_TIME/USE_TIME.d.ts +0 -43
  244. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +0 -11
  245. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +0 -212
  246. package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +0 -38
  247. package/esm/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +0 -6
  248. package/esm/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +0 -8
  249. package/esm/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +0 -7
  250. package/esm/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  251. package/esm/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +0 -78
  252. package/esm/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +0 -8
  253. package/esm/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +0 -13
  254. package/esm/src/commitments/WALLET/WALLET.d.ts +0 -21
  255. package/esm/src/commitments/WALLET/WalletToolNames.d.ts +0 -12
  256. package/esm/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +0 -163
  257. package/esm/src/commitments/WALLET/createWalletSystemMessage.d.ts +0 -6
  258. package/esm/src/commitments/WALLET/createWalletToolFunctions.d.ts +0 -8
  259. package/esm/src/commitments/WALLET/createWalletTools.d.ts +0 -7
  260. package/esm/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +0 -6
  261. package/esm/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +0 -16
  262. package/esm/src/commitments/WALLET/getWalletToolTitles.d.ts +0 -7
  263. package/esm/src/commitments/WALLET/parseWalletToolArgs.d.ts +0 -51
  264. package/esm/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +0 -8
  265. package/esm/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +0 -13
  266. package/esm/src/commitments/_common/createSerpSearchToolFunction.d.ts +0 -12
  267. package/umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts +0 -11
  268. package/umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts +0 -9
  269. package/umd/src/commitments/MEMORY/MEMORY.d.ts +0 -48
  270. package/umd/src/commitments/MEMORY/MemoryToolNames.d.ts +0 -11
  271. package/umd/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +0 -149
  272. package/umd/src/commitments/MEMORY/createMemorySystemMessage.d.ts +0 -6
  273. package/umd/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +0 -8
  274. package/umd/src/commitments/MEMORY/createMemoryTools.d.ts +0 -14
  275. package/umd/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +0 -6
  276. package/umd/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  277. package/umd/src/commitments/MEMORY/getMemoryToolTitles.d.ts +0 -7
  278. package/umd/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +0 -61
  279. package/umd/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +0 -8
  280. package/umd/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +0 -13
  281. package/umd/src/commitments/META/META.d.ts +0 -65
  282. package/umd/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts +0 -32
  283. package/umd/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +0 -58
  284. package/umd/src/commitments/USE_BROWSER/fetchUrlContentViaBrowser.d.ts +0 -13
  285. package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +0 -10
  286. package/umd/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.d.ts +0 -47
  287. package/umd/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +0 -38
  288. package/umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +0 -21
  289. package/umd/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts +0 -11
  290. package/umd/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +0 -13
  291. package/umd/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts +0 -46
  292. package/umd/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +0 -38
  293. package/umd/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +0 -9
  294. package/umd/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +0 -12
  295. package/umd/src/commitments/USE_TIME/USE_TIME.d.ts +0 -43
  296. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +0 -11
  297. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +0 -212
  298. package/umd/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +0 -38
  299. package/umd/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +0 -6
  300. package/umd/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +0 -8
  301. package/umd/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +0 -7
  302. package/umd/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  303. package/umd/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +0 -78
  304. package/umd/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +0 -8
  305. package/umd/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +0 -13
  306. package/umd/src/commitments/WALLET/WALLET.d.ts +0 -21
  307. package/umd/src/commitments/WALLET/WalletToolNames.d.ts +0 -12
  308. package/umd/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +0 -163
  309. package/umd/src/commitments/WALLET/createWalletSystemMessage.d.ts +0 -6
  310. package/umd/src/commitments/WALLET/createWalletToolFunctions.d.ts +0 -8
  311. package/umd/src/commitments/WALLET/createWalletTools.d.ts +0 -7
  312. package/umd/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +0 -6
  313. package/umd/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +0 -16
  314. package/umd/src/commitments/WALLET/getWalletToolTitles.d.ts +0 -7
  315. package/umd/src/commitments/WALLET/parseWalletToolArgs.d.ts +0 -51
  316. package/umd/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +0 -8
  317. package/umd/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +0 -13
  318. package/umd/src/commitments/_common/createSerpSearchToolFunction.d.ts +0 -12
  319. /package/esm/src/{book-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts → avatars/renderAvatarVisualTerminalText.test.d.ts} +0 -0
  320. /package/esm/src/{cli/cli-commands/common/harness/extractHarnessVersionFromOutput.test.d.ts → book-2.0/agent-source/createAgentModelRequirements.commitmentAggregation.test.d.ts} +0 -0
  321. /package/esm/src/{cli/cli-commands/common/harness/isHarnessVersionOutdated.test.d.ts → book-2.0/agent-source/createAgentModelRequirementsWithCommitments.unknown.test.d.ts} +0 -0
  322. /package/esm/src/{commitments/MEMORY/MEMORY.test.d.ts → book-2.0/agent-source/parseAgentSourceWithCommitments.unknown.test.d.ts} +0 -0
  323. /package/esm/src/{commitments/USE_BROWSER/USE_BROWSER.test.d.ts → book-3.0/AgentPlannedMessagesSidecar.test.d.ts} +0 -0
  324. /package/esm/src/{commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts → book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.test.d.ts} +0 -0
  325. /package/esm/src/{commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.test.d.ts → book-components/BookEditor/createUnknownCommitmentDiagnostics.test.d.ts} +0 -0
  326. /package/esm/src/{commitments/USE_EMAIL/USE_EMAIL.test.d.ts → book-components/Chat/utils/agentProjectToolCall.test.d.ts} +0 -0
  327. /package/esm/src/{commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts → cli/cli-commands/coder/boilerplateCount.test.d.ts} +0 -0
  328. /package/esm/src/{commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.test.d.ts → cli/cli-commands/coder/generate-boilerplates.test.d.ts} +0 -0
  329. /package/esm/src/{commitments/USE_SPAWN/USE_SPAWN.test.d.ts → cli/cli-commands/common/coderGitSyncCliOptions.test.d.ts} +0 -0
  330. /package/esm/src/{commitments/USE_TIME/USE_TIME.test.d.ts → cli/cli-commands/common/harness/$checkHarnessInstallation.test.d.ts} +0 -0
  331. /package/esm/src/{commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts → cli/cli-commands/common/harnessUpdateCliOptions.test.d.ts} +0 -0
  332. /package/esm/src/{commitments/WALLET/WALLET.test.d.ts → cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.test.d.ts} +0 -0
  333. /package/{umd/src/book-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts → esm/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.test.d.ts} +0 -0
  334. /package/{umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.test.d.ts → esm/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.test.d.ts} +0 -0
  335. /package/{umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.test.d.ts → esm/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.test.d.ts} +0 -0
  336. /package/{umd/src/commitments/MEMORY/MEMORY.test.d.ts → esm/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.test.d.ts} +0 -0
  337. /package/{umd/src/commitments/USE_BROWSER/USE_BROWSER.test.d.ts → esm/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.test.d.ts} +0 -0
  338. /package/{umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts → esm/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.test.d.ts} +0 -0
  339. /package/{umd/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.test.d.ts → esm/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.test.d.ts} +0 -0
  340. /package/esm/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.d.ts +0 -0
  341. /package/{umd/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts → esm/src/executables/platforms/locateAppOnWindows.test.d.ts} +0 -0
  342. /package/{umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts → esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.test.d.ts} +0 -0
  343. /package/{umd/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.test.d.ts → esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.test.d.ts} +0 -0
  344. /package/{umd/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts → esm/src/utils/misc/debounce.test.d.ts} +0 -0
  345. /package/{umd/src/commitments/USE_TIME/USE_TIME.test.d.ts → esm/src/utils/random/$generateBookBoilerplate.test.d.ts} +0 -0
  346. /package/umd/src/{commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts → avatars/renderAvatarVisualTerminalText.test.d.ts} +0 -0
  347. /package/umd/src/{commitments/WALLET/WALLET.test.d.ts → book-2.0/agent-source/createAgentModelRequirements.commitmentAggregation.test.d.ts} +0 -0
  348. /package/umd/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.d.ts +0 -0
@@ -0,0 +1,62 @@
1
+ /**
2
+ * One string-keyed payload of a coding-harness tool invocation.
3
+ *
4
+ * @private internal type of agent-message runtime logs
5
+ */
6
+ type RuntimeLogToolInput = Record<string, unknown>;
7
+ /**
8
+ * One content block of a Claude Code `stream-json` assistant event.
9
+ *
10
+ * @private internal type of agent-message runtime logs
11
+ */
12
+ export type AgentMessageRuntimeLogContentBlock = {
13
+ readonly type?: string;
14
+ readonly text?: string;
15
+ readonly name?: string;
16
+ readonly input?: RuntimeLogToolInput;
17
+ };
18
+ /**
19
+ * One file path touched by a Codex `file_change` item.
20
+ *
21
+ * @private internal type of agent-message runtime logs
22
+ */
23
+ export type AgentMessageRuntimeLogFileChange = {
24
+ readonly path?: string;
25
+ };
26
+ /**
27
+ * Minimal shape of one coding-harness runtime log event.
28
+ *
29
+ * The runtime log mixes two harness formats — Claude Code `stream-json` (`type`/`message`) and
30
+ * Codex JSONL (`type`/`item`) — so both are described by one permissive structure and every
31
+ * consumer reads only the fields it understands.
32
+ *
33
+ * @private internal type of agent-message runtime logs
34
+ */
35
+ export type AgentMessageRuntimeLogEvent = {
36
+ readonly type?: string;
37
+ readonly message?: {
38
+ readonly content?: ReadonlyArray<AgentMessageRuntimeLogContentBlock>;
39
+ };
40
+ readonly item?: {
41
+ readonly type?: string;
42
+ readonly command?: string;
43
+ readonly exit_code?: number | null;
44
+ readonly changes?: ReadonlyArray<AgentMessageRuntimeLogFileChange>;
45
+ readonly server?: string;
46
+ readonly tool?: string;
47
+ readonly query?: string;
48
+ };
49
+ };
50
+ /**
51
+ * Parses every structured event out of one coding-harness runtime log.
52
+ *
53
+ * The local agent runner streams the answering harness output into a live runtime log file, one
54
+ * JSON event per line, optionally prefixed by shell noise. Lines without a usable JSON object are
55
+ * skipped so a partially written or interleaved log never breaks its consumers.
56
+ *
57
+ * @param logText - Raw runtime log content.
58
+ * @returns Structured events in the order they were streamed.
59
+ * @private internal utility of the agent-message runtime
60
+ */
61
+ export declare function parseAgentMessageRuntimeLogEvents(logText: string | null | undefined): ReadonlyArray<AgentMessageRuntimeLogEvent>;
62
+ export {};
@@ -5,9 +5,9 @@
5
5
  * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
6
6
  * message. This helper extracts the most recent natural-language assistant narration so the
7
7
  * durable chat can show what the agent is doing right now instead of a generic thinking
8
- * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
9
- * other technical details are intentionally ignored, and harnesses that do not stream
10
- * structured text simply resolve to `null` so the caller keeps its existing behavior.
8
+ * placeholder. Only concrete, safe activity is surfaced; raw tool payloads, JSON envelopes,
9
+ * and private reasoning are intentionally ignored. When no concrete activity is known, this
10
+ * resolves to `null` so the caller keeps the browser's rotating generic thinking state.
11
11
  *
12
12
  * @param logText - Raw runtime log content.
13
13
  * @returns Latest human-readable activity snippet, or `null` when none can be resolved.
@@ -0,0 +1,18 @@
1
+ import type { AgentMessageTouchedExternalSource } from './AgentMessageTouchedExternalSource';
2
+ /**
3
+ * Resolves which sources outside the agent one coding harness touched while answering a single message.
4
+ *
5
+ * The runtime log streams what the harness really did, so a source counts as touched when the
6
+ * harness reached it in a tool invocation — calling an integration, fetching a web address,
7
+ * searching the web, or running a network client in the shell. Only tool payloads are inspected:
8
+ * tool results and assistant narration are ignored so a service merely mentioned in the
9
+ * conversation is never reported, and addresses of the machine the agent runs on are dropped
10
+ * because they are internal.
11
+ *
12
+ * @param options - Raw runtime log content of one answered message.
13
+ * @returns Touched external sources without duplicates, ordered by first appearance.
14
+ * @private internal utility of the agent-message runtime
15
+ */
16
+ export declare function resolveAgentMessageTouchedExternalSources(options: {
17
+ readonly logText: string | null | undefined;
18
+ }): ReadonlyArray<AgentMessageTouchedExternalSource>;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Resolves which projects one coding harness touched while answering a single message.
3
+ *
4
+ * The runtime log streams what the harness really did, so a project counts as touched when the
5
+ * harness named it in a tool invocation — reading, searching, running, or editing files inside
6
+ * `projects/<project-name>/`. Only tool payloads are inspected: tool results and assistant
7
+ * narration are ignored so a project merely mentioned in the conversation is never reported.
8
+ *
9
+ * Every candidate is matched against the projects that really exist, which both filters prompt
10
+ * placeholders such as `projects/<project-name>/` and keeps the reported names canonical.
11
+ *
12
+ * @param options - Raw runtime log content and the project directory names of the agent.
13
+ * @returns Touched project names in the canonical spelling, ordered by first appearance.
14
+ * @private internal utility of the agent-message runtime
15
+ */
16
+ export declare function resolveAgentMessageTouchedProjectNames(options: {
17
+ readonly logText: string | null | undefined;
18
+ readonly knownProjectNames: ReadonlyArray<string>;
19
+ }): ReadonlyArray<string>;
@@ -75,9 +75,12 @@ export type CreateTerminalAgentAvatarVisualOptions = {
75
75
  */
76
76
  readonly colorDepth?: AsciiArtColorDepth;
77
77
  /**
78
- * Platform-specific canvas factory used to rasterize the visual.
78
+ * Platform-specific canvas factory used to rasterize pixel-based visuals.
79
+ *
80
+ * Character-based visuals such as `AsciiOctopus` paint the terminal grid directly, so they
81
+ * render without any canvas; a pixel-based visual renders an empty frame when it is missing.
79
82
  */
80
- readonly createCanvas: CreateCanvasForAsciiArt;
83
+ readonly createCanvas?: CreateCanvasForAsciiArt;
81
84
  };
82
85
  /**
83
86
  * Resolves the built-in avatar visual selected for terminal rendering of one agent source.
@@ -62,6 +62,12 @@ export type ConvertImageDataToAsciiArtOptions = {
62
62
  */
63
63
  readonly alphaThreshold?: number;
64
64
  };
65
+ /**
66
+ * Default alpha channel value below which a cell is rendered as terminal background.
67
+ *
68
+ * @private within the repository
69
+ */
70
+ export declare const DEFAULT_ALPHA_THRESHOLD = 32;
65
71
  /**
66
72
  * Converts raw RGBA image pixels into colored ASCII art for ANSI terminals.
67
73
  *
@@ -0,0 +1,46 @@
1
+ import type { AsciiArtColorDepth } from './convertImageDataToAsciiArt';
2
+ /**
3
+ * ANSI escape sequence that resets all colors and attributes.
4
+ *
5
+ * @private within the repository
6
+ */
7
+ export declare const ANSI_RESET = "\u001B[0m";
8
+ /**
9
+ * One opaque 24-bit color which should be written into an ANSI escape sequence.
10
+ *
11
+ * @private within the repository
12
+ */
13
+ export type AnsiRgbColor = {
14
+ /**
15
+ * Red channel in the range `[0, 255]`.
16
+ */
17
+ readonly red: number;
18
+ /**
19
+ * Green channel in the range `[0, 255]`.
20
+ */
21
+ readonly green: number;
22
+ /**
23
+ * Blue channel in the range `[0, 255]`.
24
+ */
25
+ readonly blue: number;
26
+ };
27
+ /**
28
+ * Creates the ANSI escape code that sets the foreground color of following characters.
29
+ *
30
+ * @param color Color painted onto the characters.
31
+ * @param colorDepth Color depth supported by the target terminal.
32
+ * @returns ANSI escape sequence.
33
+ *
34
+ * @private within the repository
35
+ */
36
+ export declare function createAnsiForegroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;
37
+ /**
38
+ * Creates the ANSI escape code that sets the background color of following characters.
39
+ *
40
+ * @param color Color painted behind the characters.
41
+ * @param colorDepth Color depth supported by the target terminal.
42
+ * @returns ANSI escape sequence.
43
+ *
44
+ * @private within the repository
45
+ */
46
+ export declare function createAnsiBackgroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Creates a loader which imports one module on the first call and reuses the very same module afterwards
3
+ *
4
+ * Note: [🐌] Heavy third-party dependencies are imported lazily to keep the startup of the Promptbook CLI fast.
5
+ * A statically imported dependency is loaded every single time the bundle is loaded, even when the running
6
+ * command never touches it. A lazily imported dependency is loaded only when the feature is really used.
7
+ *
8
+ * @example
9
+ * const loadJsdomModule = createLazyModuleLoader(() => import('jsdom'));
10
+ * const { JSDOM } = await loadJsdomModule();
11
+ *
12
+ * @private internal utility of Promptbook
13
+ */
14
+ export declare function createLazyModuleLoader<TModule>(importModule: () => Promise<TModule>): () => Promise<TModule>;
@@ -1,7 +1,9 @@
1
1
  import type { TODO_any } from '../organization/TODO_any';
2
2
  /**
3
- * Handles debounce.
3
+ * Creates a debounced function that runs after calls have been quiet for the given delay.
4
4
  *
5
5
  * @public exported from `@promptbook/utils`
6
6
  */
7
- export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
7
+ export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): ((...args: Parameters<T>) => void) & {
8
+ cancel: () => void;
9
+ };
@@ -0,0 +1 @@
1
+ export {};
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.113.1-0`).
18
+ * It follows semantic versioning (e.g., `0.114.0-20`).
19
19
  *
20
20
  * @generated
21
21
  */
@@ -1,11 +0,0 @@
1
- /**
2
- * Extracts the version from the raw output of a harness `--version` command.
3
- *
4
- * Harness CLIs print their version in many shapes, for example `2.1.199 (Claude Code)`,
5
- * `codex-cli 0.144.4`, `GitHub Copilot CLI 1.0.61.` or after unrelated deprecation warning lines,
6
- * so the first version-looking token of the first matching line wins.
7
- *
8
- * @returns The parsed version or `null` when the output contains no version
9
- * @private internal utility of `promptbookCli`
10
- */
11
- export declare function extractHarnessVersionFromOutput(output: string): string | null;
@@ -1,9 +0,0 @@
1
- /**
2
- * Compares the installed harness version with the newest version published to npm.
3
- *
4
- * Only the numeric `major.minor.patch` segments are compared and pre-release suffixes are ignored,
5
- * so a harness installed from a pre-release build of the newest version is not reported as outdated.
6
- *
7
- * @private internal utility of `promptbookCli`
8
- */
9
- export declare function isHarnessVersionOutdated(installedVersion: string, latestVersion: string): boolean;
@@ -1,48 +0,0 @@
1
- import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
2
- import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
3
- import type { string_javascript_name } from '../../types/string_person_fullname';
4
- import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
- export type { MemoryToolRecord, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
6
- export { setMemoryToolRuntimeAdapter } from './setMemoryToolRuntimeAdapter';
7
- /**
8
- * MEMORY commitment definition
9
- *
10
- * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
11
- * interactions and user preferences. It helps the agent maintain context about the
12
- * user's history, preferences, and previous conversations.
13
- *
14
- * Example usage in agent source:
15
- *
16
- * ```book
17
- * MEMORY User prefers detailed technical explanations
18
- * MEMORY Previously worked on React projects
19
- * MEMORY Timezone: UTC-5 (Eastern Time)
20
- * ```
21
- *
22
- * @private [🪔] Maybe export the commitments through some package
23
- */
24
- export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
25
- constructor(type?: 'MEMORY' | 'MEMORIES');
26
- get requiresContent(): boolean;
27
- /**
28
- * Short one-line description of MEMORY.
29
- */
30
- get description(): string;
31
- /**
32
- * Icon for this commitment.
33
- */
34
- get icon(): string;
35
- /**
36
- * Markdown documentation for MEMORY commitment.
37
- */
38
- get documentation(): string;
39
- applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
40
- /**
41
- * Gets human-readable titles for MEMORY tool functions.
42
- */
43
- getToolTitles(): Record<string_javascript_name, string>;
44
- /**
45
- * Gets MEMORY tool function implementations.
46
- */
47
- getToolFunctions(): Record<string_javascript_name, ToolFunction>;
48
- }
@@ -1,11 +0,0 @@
1
- /**
2
- * Names of tools used by the MEMORY commitment.
3
- *
4
- * @private function of MemoryCommitmentDefinition
5
- */
6
- export declare const MemoryToolNames: {
7
- readonly retrieve: string;
8
- readonly store: string;
9
- readonly update: string;
10
- readonly delete: string;
11
- };
@@ -1,149 +0,0 @@
1
- import type { TODO_any } from '../../utils/organization/TODO_any';
2
- /**
3
- * Tool arguments for retrieving memory.
4
- *
5
- * @private type of MemoryCommitmentDefinition
6
- */
7
- export type RetrieveMemoryToolArgs = {
8
- query?: string;
9
- limit?: number;
10
- [key: string]: TODO_any;
11
- };
12
- /**
13
- * Tool arguments for storing memory.
14
- *
15
- * @private type of MemoryCommitmentDefinition
16
- */
17
- export type StoreMemoryToolArgs = {
18
- content?: string;
19
- isGlobal?: boolean;
20
- [key: string]: TODO_any;
21
- };
22
- /**
23
- * Tool arguments for updating memory.
24
- *
25
- * @private type of MemoryCommitmentDefinition
26
- */
27
- export type UpdateMemoryToolArgs = {
28
- memoryId?: string;
29
- content?: string;
30
- isGlobal?: boolean;
31
- [key: string]: TODO_any;
32
- };
33
- /**
34
- * Tool arguments for deleting memory.
35
- *
36
- * @private type of MemoryCommitmentDefinition
37
- */
38
- export type DeleteMemoryToolArgs = {
39
- memoryId?: string;
40
- [key: string]: TODO_any;
41
- };
42
- /**
43
- * Memory record returned by runtime adapters.
44
- *
45
- * @private type of MemoryCommitmentDefinition
46
- */
47
- export type MemoryToolRecord = {
48
- id?: string;
49
- content: string;
50
- isGlobal: boolean;
51
- createdAt?: string;
52
- updatedAt?: string;
53
- };
54
- /**
55
- * Runtime context for MEMORY tools resolved from hidden tool arguments.
56
- *
57
- * @private type of MemoryCommitmentDefinition
58
- */
59
- export type MemoryToolRuntimeContext = {
60
- readonly enabled: boolean;
61
- readonly userId?: number;
62
- readonly username?: string;
63
- readonly agentId?: string;
64
- readonly agentName?: string;
65
- readonly isTeamConversation: boolean;
66
- readonly isPrivateMode: boolean;
67
- };
68
- /**
69
- * Result payload returned by retrieve memory tool.
70
- *
71
- * @private type of MemoryCommitmentDefinition
72
- */
73
- export type RetrieveMemoryToolResult = {
74
- action: 'retrieve';
75
- status: 'ok' | 'disabled' | 'error';
76
- query?: string;
77
- memories: MemoryToolRecord[];
78
- message?: string;
79
- };
80
- /**
81
- * Result payload returned by store memory tool.
82
- *
83
- * @private type of MemoryCommitmentDefinition
84
- */
85
- export type StoreMemoryToolResult = {
86
- action: 'store';
87
- status: 'stored' | 'disabled' | 'error';
88
- memory?: MemoryToolRecord;
89
- message?: string;
90
- };
91
- /**
92
- * Result payload returned by update memory tool.
93
- *
94
- * @private type of MemoryCommitmentDefinition
95
- */
96
- export type UpdateMemoryToolResult = {
97
- action: 'update';
98
- status: 'updated' | 'disabled' | 'error';
99
- memory?: MemoryToolRecord;
100
- message?: string;
101
- };
102
- /**
103
- * Result payload returned by delete memory tool.
104
- *
105
- * @private type of MemoryCommitmentDefinition
106
- */
107
- export type DeleteMemoryToolResult = {
108
- action: 'delete';
109
- status: 'deleted' | 'disabled' | 'error';
110
- memoryId?: string;
111
- message?: string;
112
- };
113
- /**
114
- * Union of all MEMORY tool actions.
115
- *
116
- * @private type of MemoryCommitmentDefinition
117
- */
118
- export type MemoryToolAction = RetrieveMemoryToolResult['action'] | StoreMemoryToolResult['action'] | UpdateMemoryToolResult['action'] | DeleteMemoryToolResult['action'];
119
- /**
120
- * Union of all MEMORY tool result payloads.
121
- *
122
- * @private type of MemoryCommitmentDefinition
123
- */
124
- export type MemoryToolResult = RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult;
125
- /**
126
- * Runtime adapter interface used by MEMORY tools.
127
- *
128
- * @private type of MemoryCommitmentDefinition
129
- */
130
- export type MemoryToolRuntimeAdapter = {
131
- retrieveMemories(args: {
132
- query?: string;
133
- limit?: number;
134
- }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
135
- storeMemory(args: {
136
- content: string;
137
- isGlobal: boolean;
138
- }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
139
- updateMemory(args: {
140
- memoryId: string;
141
- content: string;
142
- isGlobal?: boolean;
143
- }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
144
- deleteMemory(args: {
145
- memoryId: string;
146
- }, runtimeContext: MemoryToolRuntimeContext): Promise<{
147
- id?: string;
148
- }>;
149
- };
@@ -1,6 +0,0 @@
1
- /**
2
- * Builds the MEMORY instruction block appended to the system message.
3
- *
4
- * @private function of MemoryCommitmentDefinition
5
- */
6
- export declare function createMemorySystemMessage(extraInstructions: string): string;
@@ -1,8 +0,0 @@
1
- import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
2
- import type { string_javascript_name } from '../../types/string_person_fullname';
3
- /**
4
- * Gets MEMORY tool function implementations.
5
- *
6
- * @private function of MemoryCommitmentDefinition
7
- */
8
- export declare function createMemoryToolFunctions(): Record<string_javascript_name, ToolFunction>;
@@ -1,14 +0,0 @@
1
- import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
2
- /**
3
- * Concrete type of tool definitions in `AgentModelRequirements`.
4
- *
5
- * @private type of MemoryCommitmentDefinition
6
- */
7
- type AgentModelTools = NonNullable<AgentModelRequirements['tools']>;
8
- /**
9
- * Creates MEMORY tool definitions while preserving already-registered tools.
10
- *
11
- * @private function of MemoryCommitmentDefinition
12
- */
13
- export declare function createMemoryTools(existingTools: AgentModelRequirements['tools']): AgentModelTools;
14
- export {};
@@ -1,6 +0,0 @@
1
- /**
2
- * Markdown documentation for MEMORY commitment.
3
- *
4
- * @private function of MemoryCommitmentDefinition
5
- */
6
- export declare function getMemoryCommitmentDocumentation(type: 'MEMORY' | 'MEMORIES'): string;
@@ -1,17 +0,0 @@
1
- import type { DeleteMemoryToolResult, MemoryToolAction, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext, RetrieveMemoryToolResult, StoreMemoryToolResult, UpdateMemoryToolResult } from './MemoryToolRuntimeAdapter';
2
- /**
3
- * Return type of MEMORY adapter resolution helper.
4
- *
5
- * @private type of MemoryCommitmentDefinition
6
- */
7
- type MemoryToolRuntimeAdapterResolution = {
8
- adapter: MemoryToolRuntimeAdapter | null;
9
- disabledResult: RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult | null;
10
- };
11
- /**
12
- * Gets the runtime adapter and returns a disabled result when unavailable.
13
- *
14
- * @private function of MemoryCommitmentDefinition
15
- */
16
- export declare function getMemoryToolRuntimeAdapterOrDisabledResult(action: MemoryToolAction, runtimeContext: MemoryToolRuntimeContext): MemoryToolRuntimeAdapterResolution;
17
- export {};
@@ -1,7 +0,0 @@
1
- import type { string_javascript_name } from '../../types/string_person_fullname';
2
- /**
3
- * Gets human-readable titles for MEMORY tool functions.
4
- *
5
- * @private function of MemoryCommitmentDefinition
6
- */
7
- export declare function getMemoryToolTitles(): Record<string_javascript_name, string>;
@@ -1,61 +0,0 @@
1
- import type { DeleteMemoryToolArgs, RetrieveMemoryToolArgs, StoreMemoryToolArgs, UpdateMemoryToolArgs } from './MemoryToolRuntimeAdapter';
2
- /**
3
- * Parsed retrieve memory arguments.
4
- *
5
- * @private type of MemoryCommitmentDefinition
6
- */
7
- type ParsedRetrieveMemoryArgs = {
8
- query?: string;
9
- limit?: number;
10
- };
11
- /**
12
- * Parsed store memory arguments.
13
- *
14
- * @private type of MemoryCommitmentDefinition
15
- */
16
- type ParsedStoreMemoryArgs = {
17
- content: string;
18
- isGlobal: boolean;
19
- };
20
- /**
21
- * Parsed update memory arguments.
22
- *
23
- * @private type of MemoryCommitmentDefinition
24
- */
25
- type ParsedUpdateMemoryArgs = {
26
- memoryId: string;
27
- content: string;
28
- isGlobal?: boolean;
29
- };
30
- /**
31
- * Parsed delete memory arguments.
32
- *
33
- * @private type of MemoryCommitmentDefinition
34
- */
35
- type ParsedDeleteMemoryArgs = {
36
- memoryId: string;
37
- };
38
- /**
39
- * Collection of MEMORY tool argument parsers.
40
- *
41
- * @private function of MemoryCommitmentDefinition
42
- */
43
- export declare const parseMemoryToolArgs: {
44
- /**
45
- * Parses retrieve memory arguments.
46
- */
47
- retrieve(args: RetrieveMemoryToolArgs): ParsedRetrieveMemoryArgs;
48
- /**
49
- * Parses store memory arguments.
50
- */
51
- store(args: StoreMemoryToolArgs): ParsedStoreMemoryArgs;
52
- /**
53
- * Parses update memory arguments.
54
- */
55
- update(args: UpdateMemoryToolArgs): ParsedUpdateMemoryArgs;
56
- /**
57
- * Parses delete memory arguments.
58
- */
59
- delete(args: DeleteMemoryToolArgs): ParsedDeleteMemoryArgs;
60
- };
61
- export {};
@@ -1,8 +0,0 @@
1
- import type { TODO_any } from '../../utils/organization/TODO_any';
2
- import type { MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
3
- /**
4
- * Resolves runtime context from hidden tool arguments.
5
- *
6
- * @private function of MemoryCommitmentDefinition
7
- */
8
- export declare function resolveMemoryRuntimeContext(args: Record<string, TODO_any>): MemoryToolRuntimeContext;
@@ -1,13 +0,0 @@
1
- import type { MemoryToolRuntimeAdapter } from './MemoryToolRuntimeAdapter';
2
- /**
3
- * Sets runtime adapter used by MEMORY commitment tools.
4
- *
5
- * @private function of MemoryCommitmentDefinition
6
- */
7
- export declare function setMemoryToolRuntimeAdapter(adapter: MemoryToolRuntimeAdapter | null): void;
8
- /**
9
- * Gets runtime adapter used by MEMORY commitment tools.
10
- *
11
- * @private function of MemoryCommitmentDefinition
12
- */
13
- export declare function getMemoryToolRuntimeAdapter(): MemoryToolRuntimeAdapter | null;