@promptbook/javascript 0.111.0-7 → 0.112.0-11

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 (467) hide show
  1. package/esm/index.es.js +14 -7
  2. package/esm/index.es.js.map +1 -1
  3. package/esm/src/_packages/components.index.d.ts +2 -0
  4. package/esm/src/_packages/core.index.d.ts +26 -0
  5. package/esm/src/_packages/markdown-utils.index.d.ts +5 -5
  6. package/esm/src/_packages/types.index.d.ts +250 -228
  7. package/esm/src/_packages/utils.index.d.ts +2 -0
  8. package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts +4 -1
  9. package/esm/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -1
  10. package/esm/src/book-2.0/agent-source/createAgentModelRequirements.d.ts +2 -2
  11. package/esm/src/book-2.0/agent-source/createAgentModelRequirements.writing.test.d.ts +1 -0
  12. package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.knowledge.test.d.ts +1 -0
  13. package/esm/src/book-2.0/agent-source/createTeamToolName.d.ts +12 -0
  14. package/esm/src/book-2.0/agent-source/extractOpenTeacherInstructions.d.ts +12 -0
  15. package/esm/src/book-2.0/agent-source/extractOpenTeacherInstructions.test.d.ts +1 -0
  16. package/esm/src/book-2.0/agent-source/parseAgentSourcePrelude.d.ts +38 -0
  17. package/esm/src/book-2.0/agent-source/parseAgentSourceWithCommitments.d.ts +3 -0
  18. package/esm/src/book-2.0/agent-source/parseAgentSourceWithCommitments.title.test.d.ts +1 -0
  19. package/esm/src/book-2.0/agent-source/pseudoAgentReferences.d.ts +110 -0
  20. package/esm/src/book-2.0/agent-source/removeCommentsFromSystemMessage.d.ts +2 -2
  21. package/esm/src/book-components/BookEditor/BookEditor.d.ts +15 -0
  22. package/esm/src/book-components/BookEditor/BookEditorActionbar.d.ts +2 -0
  23. package/esm/src/book-components/BookEditor/BookEditorMonacoConstants.d.ts +1 -0
  24. package/esm/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts +14 -7
  25. package/esm/src/book-components/BookEditor/BookEditorMonacoTokenization.test.d.ts +1 -0
  26. package/esm/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.d.ts +28 -0
  27. package/esm/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.test.d.ts +1 -0
  28. package/esm/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts +27 -0
  29. package/esm/src/book-components/BookEditor/useBookEditorMonacoLanguage.test.d.ts +1 -0
  30. package/esm/src/book-components/Chat/AgentChat/AgentChatProps.d.ts +5 -0
  31. package/esm/src/book-components/Chat/Chat/ChatActionsBar.d.ts +1 -0
  32. package/esm/src/book-components/Chat/Chat/ChatInputArea.d.ts +2 -0
  33. package/esm/src/book-components/Chat/Chat/ChatInputArea.test.d.ts +2 -0
  34. package/esm/src/book-components/Chat/Chat/ChatMessageItem.d.ts +6 -1
  35. package/esm/src/book-components/Chat/Chat/ChatMessageList.d.ts +3 -0
  36. package/esm/src/book-components/Chat/Chat/ChatProps.d.ts +56 -0
  37. package/esm/src/book-components/Chat/Chat/ChatToolCallModal.d.ts +11 -0
  38. package/esm/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts +32 -0
  39. package/esm/src/book-components/Chat/Chat/chatCssClassNames.d.ts +41 -0
  40. package/esm/src/book-components/Chat/Chat/renderAdvancedToolCallDetails.d.ts +44 -0
  41. package/esm/src/book-components/Chat/Chat/renderToolCallDetails.d.ts +36 -0
  42. package/esm/src/book-components/Chat/CodeBlock/CodeBlock.d.ts +5 -0
  43. package/esm/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.d.ts +18 -0
  44. package/esm/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.test.d.ts +1 -0
  45. package/esm/src/book-components/Chat/LlmChat/LlmChatProps.d.ts +16 -0
  46. package/esm/src/book-components/Chat/hooks/useChatAutoScroll.d.ts +1 -1
  47. package/esm/src/book-components/Chat/hooks/useChatAutoScroll.test.d.ts +1 -0
  48. package/esm/src/book-components/Chat/types/ChatMessage.d.ts +16 -0
  49. package/esm/src/book-components/Chat/utils/ChatPersistence.d.ts +16 -0
  50. package/esm/src/book-components/Chat/utils/ChatPersistence.test.d.ts +4 -0
  51. package/esm/src/book-components/Chat/utils/createTeamToolNameFromUrl.d.ts +2 -2
  52. package/esm/src/book-components/Chat/utils/parseMessageButtons.d.ts +22 -5
  53. package/esm/src/book-components/Chat/utils/parseMessageButtons.test.d.ts +1 -0
  54. package/esm/src/book-components/Chat/utils/resolveToolCallFromChatMessages.d.ts +13 -0
  55. package/esm/src/book-components/Chat/utils/resolveToolCallState.d.ts +10 -0
  56. package/esm/src/book-components/Chat/utils/sanitizeStreamingMessageContent.d.ts +29 -1
  57. package/esm/src/book-components/Chat/utils/splitMessageContentIntoSegments.d.ts +16 -3
  58. package/esm/src/book-components/Chat/utils/thinkingMessageVariants.d.ts +24 -0
  59. package/esm/src/book-components/Chat/utils/thinkingMessageVariants.test.d.ts +1 -0
  60. package/esm/src/book-components/Chat/utils/toolCallParsing/RunBrowserToolResult.d.ts +50 -0
  61. package/esm/src/book-components/Chat/utils/toolCallParsing/TeamToolResult.d.ts +30 -0
  62. package/esm/src/book-components/Chat/utils/toolCallParsing/extractSearchResults.d.ts +19 -0
  63. package/esm/src/book-components/Chat/utils/toolCallParsing/getToolCallResultDate.d.ts +9 -0
  64. package/esm/src/book-components/Chat/utils/toolCallParsing/getToolCallTimestamp.d.ts +9 -0
  65. package/esm/src/book-components/Chat/utils/toolCallParsing/parseRunBrowserToolResult.d.ts +10 -0
  66. package/esm/src/book-components/Chat/utils/toolCallParsing/parseTeamToolResult.d.ts +10 -0
  67. package/esm/src/book-components/Chat/utils/toolCallParsing/parseToolCallArguments.d.ts +10 -0
  68. package/esm/src/book-components/Chat/utils/toolCallParsing/parseToolCallResult.d.ts +10 -0
  69. package/esm/src/book-components/Chat/utils/toolCallParsing/resolveRunBrowserArtifactUrl.d.ts +8 -0
  70. package/esm/src/book-components/Chat/utils/toolCallParsing.d.ts +10 -68
  71. package/esm/src/book-components/Chat/utils/toolCallParsing.test.d.ts +1 -0
  72. package/esm/src/book-components/Chat/utils/walletCredentialToolCall.d.ts +52 -0
  73. package/esm/src/book-components/Chat/utils/walletCredentialToolCall.test.d.ts +1 -0
  74. package/esm/src/book-components/PromptbookAgent/PromptbookAgentIntegration.d.ts +14 -0
  75. package/esm/src/book-components/PromptbookAgent/PromptbookAgentSeamlessIntegration.d.ts +3 -0
  76. package/esm/src/book-components/_common/MonacoEditorWithShadowDom.d.ts +17 -0
  77. package/esm/src/book-components/icons/ArrowIcon.d.ts +30 -5
  78. package/esm/src/book-components/icons/SolidArrowButton.d.ts +28 -0
  79. package/esm/src/book-components/icons/StopIcon.d.ts +8 -0
  80. package/esm/src/cli/cli-commands/coder/find-fresh-emoji-tag.d.ts +14 -0
  81. package/esm/src/cli/cli-commands/coder/find-refactor-candidates.d.ts +14 -0
  82. package/esm/src/cli/cli-commands/coder/generate-boilerplates.d.ts +14 -0
  83. package/esm/src/cli/cli-commands/coder/run.d.ts +14 -0
  84. package/esm/src/cli/cli-commands/coder/verify.d.ts +14 -0
  85. package/esm/src/cli/cli-commands/coder.d.ts +21 -0
  86. package/esm/src/collection/agent-collection/CreateAgentInput.d.ts +59 -0
  87. package/esm/src/collection/agent-collection/CreateAgentInput.test.d.ts +1 -0
  88. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +52 -8
  89. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema.d.ts +6 -3
  90. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts +36 -0
  91. package/esm/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts +0 -3
  92. package/esm/src/commitments/MEMORY/MEMORY.d.ts +4 -59
  93. package/esm/src/commitments/MEMORY/MemoryToolNames.d.ts +11 -0
  94. package/esm/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +149 -0
  95. package/esm/src/commitments/MEMORY/createMemorySystemMessage.d.ts +6 -0
  96. package/esm/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +8 -0
  97. package/esm/src/commitments/MEMORY/createMemoryTools.d.ts +14 -0
  98. package/esm/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +6 -0
  99. package/esm/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +17 -0
  100. package/esm/src/commitments/MEMORY/getMemoryToolTitles.d.ts +7 -0
  101. package/esm/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +61 -0
  102. package/esm/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +8 -0
  103. package/esm/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +13 -0
  104. package/esm/src/commitments/MESSAGE/InternalMessageCommitmentDefinition.d.ts +33 -0
  105. package/esm/src/commitments/MESSAGE/MESSAGE.d.ts +2 -2
  106. package/esm/src/commitments/META/META.d.ts +4 -0
  107. package/esm/src/commitments/META_DOMAIN/META_DOMAIN.d.ts +33 -0
  108. package/esm/src/commitments/META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER.d.ts +33 -0
  109. package/esm/src/commitments/META_VOICE/META_VOICE.d.ts +39 -0
  110. package/esm/src/commitments/SAMPLE/SAMPLE.d.ts +13 -13
  111. package/esm/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +1 -1
  112. package/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +10 -0
  113. package/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts +1 -0
  114. package/esm/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +4 -11
  115. package/esm/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts +1 -0
  116. package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +21 -0
  117. package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts +1 -0
  118. package/esm/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +2 -7
  119. package/esm/src/commitments/USE_POPUP/USE_POPUP.d.ts +49 -0
  120. package/esm/src/commitments/USE_PRIVACY/USE_PRIVACY.d.ts +39 -0
  121. package/esm/src/commitments/USE_PRIVACY/USE_PRIVACY.test.d.ts +1 -0
  122. package/esm/src/commitments/USE_PROJECT/USE_PROJECT.d.ts +42 -0
  123. package/esm/src/commitments/USE_PROJECT/USE_PROJECT.test.d.ts +1 -0
  124. package/esm/src/commitments/USE_PROJECT/UseProjectToolNames.d.ts +13 -0
  125. package/esm/src/commitments/USE_PROJECT/UseProjectWallet.d.ts +9 -0
  126. package/esm/src/commitments/USE_PROJECT/callGitHubApi.d.ts +69 -0
  127. package/esm/src/commitments/USE_PROJECT/createUseProjectToolFunctions.d.ts +8 -0
  128. package/esm/src/commitments/USE_PROJECT/createUseProjectTools.d.ts +7 -0
  129. package/esm/src/commitments/USE_PROJECT/getUseProjectToolTitles.d.ts +7 -0
  130. package/esm/src/commitments/USE_PROJECT/normalizeConfiguredProjects.d.ts +16 -0
  131. package/esm/src/commitments/USE_PROJECT/normalizeOptionalToolText.d.ts +12 -0
  132. package/esm/src/commitments/USE_PROJECT/projectReference.d.ts +52 -0
  133. package/esm/src/commitments/USE_PROJECT/projectReference.test.d.ts +1 -0
  134. package/esm/src/commitments/USE_PROJECT/resolveUseProjectToolRuntimeOrWalletCredentialResult.d.ts +34 -0
  135. package/esm/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +41 -0
  136. package/esm/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts +1 -0
  137. package/esm/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +9 -0
  138. package/esm/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +12 -0
  139. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +9 -0
  140. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +90 -0
  141. package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +41 -0
  142. package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts +1 -0
  143. package/esm/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +6 -0
  144. package/esm/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +8 -0
  145. package/esm/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +7 -0
  146. package/esm/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +17 -0
  147. package/esm/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +34 -0
  148. package/esm/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +8 -0
  149. package/esm/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +13 -0
  150. package/esm/src/commitments/WALLET/WALLET.d.ts +24 -0
  151. package/esm/src/commitments/WALLET/WALLET.test.d.ts +1 -0
  152. package/esm/src/commitments/WALLET/WalletToolNames.d.ts +12 -0
  153. package/esm/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +163 -0
  154. package/esm/src/commitments/WALLET/createWalletSystemMessage.d.ts +6 -0
  155. package/esm/src/commitments/WALLET/createWalletToolFunctions.d.ts +8 -0
  156. package/esm/src/commitments/WALLET/createWalletTools.d.ts +7 -0
  157. package/esm/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +6 -0
  158. package/esm/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +16 -0
  159. package/esm/src/commitments/WALLET/getWalletToolTitles.d.ts +7 -0
  160. package/esm/src/commitments/WALLET/parseWalletToolArgs.d.ts +51 -0
  161. package/esm/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +8 -0
  162. package/esm/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +13 -0
  163. package/esm/src/commitments/WRITING_RULES/WRITING_RULES.d.ts +29 -0
  164. package/esm/src/commitments/WRITING_SAMPLE/WRITING_SAMPLE.d.ts +29 -0
  165. package/esm/src/commitments/_base/BaseCommitmentDefinition.d.ts +12 -0
  166. package/esm/src/commitments/_base/CommitmentDefinition.d.ts +23 -0
  167. package/esm/src/commitments/_common/createWritingCommitmentSections.d.ts +19 -0
  168. package/esm/src/commitments/_common/getGroupedCommitmentDefinitions.writing.test.d.ts +1 -0
  169. package/esm/src/commitments/_common/toolExecutionEnvelope.d.ts +22 -0
  170. package/esm/src/commitments/_common/toolRuntimeContext.d.ts +90 -0
  171. package/esm/src/commitments/index.d.ts +12 -1
  172. package/esm/src/config.d.ts +3 -0
  173. package/esm/src/errors/0-index.d.ts +3 -0
  174. package/esm/src/errors/ConflictError.d.ts +9 -0
  175. package/esm/src/execution/LlmExecutionTools.d.ts +12 -1
  176. package/esm/src/execution/Usage.d.ts +4 -0
  177. package/esm/src/execution/utils/usageToHuman.d.ts +1 -0
  178. package/esm/src/file-security-checkers/FileSecurityCheckResult.d.ts +32 -0
  179. package/esm/src/file-security-checkers/FileSecurityChecker.d.ts +34 -0
  180. package/esm/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.d.ts +36 -0
  181. package/esm/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.test.d.ts +1 -0
  182. package/esm/src/llm-providers/agent/Agent.d.ts +2 -2
  183. package/esm/src/llm-providers/agent/AgentLlmExecutionTools.d.ts +2 -2
  184. package/esm/src/llm-providers/agent/RemoteAgent.d.ts +2 -1
  185. package/esm/src/llm-providers/agent/self-learning/SelfLearningManager.test.d.ts +1 -0
  186. package/esm/src/llm-providers/anthropic-claude/computeAnthropicClaudeUsage.d.ts +3 -1
  187. package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts +33 -3
  188. package/esm/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts +2 -2
  189. package/esm/src/llm-providers/openai/OpenAiCompatibleExecutionTools.d.ts +2 -2
  190. package/esm/src/llm-providers/openai/computeOpenAiUsage.d.ts +3 -1
  191. package/esm/src/playground/playground.d.ts +1 -0
  192. package/esm/src/speech-recognition/OpenAiSpeechRecognition.d.ts +49 -1
  193. package/esm/src/types/SpeechRecognition.d.ts +14 -0
  194. package/esm/src/types/ToolCall.d.ts +56 -0
  195. package/esm/src/types/number_usd.d.ts +110 -0
  196. package/esm/src/types/string_filename.d.ts +39 -0
  197. package/esm/src/types/string_knowledge_source_content.d.ts +29 -0
  198. package/esm/src/types/string_markdown.d.ts +138 -0
  199. package/esm/src/types/string_parameter_name.d.ts +170 -0
  200. package/esm/src/types/string_person_fullname.d.ts +85 -0
  201. package/esm/src/types/string_sha256.d.ts +44 -0
  202. package/esm/src/types/string_token.d.ts +58 -0
  203. package/esm/src/types/string_url.d.ts +146 -0
  204. package/esm/src/types/typeAliases.d.ts +9 -741
  205. package/esm/src/utils/chat/chatAttachments/appendChatAttachmentContext.d.ts +10 -0
  206. package/esm/src/utils/chat/chatAttachments/appendChatAttachmentContextWithContent.d.ts +14 -0
  207. package/esm/src/utils/chat/chatAttachments/appendChatContextSections.d.ts +6 -0
  208. package/esm/src/utils/chat/chatAttachments/formatChatAttachmentContentContext.d.ts +9 -0
  209. package/esm/src/utils/chat/chatAttachments/formatChatAttachmentContext.d.ts +9 -0
  210. package/esm/src/utils/chat/chatAttachments/normalizeChatAttachments.d.ts +11 -0
  211. package/esm/src/utils/chat/chatAttachments/resolveChatAttachmentContent.d.ts +11 -0
  212. package/esm/src/utils/chat/chatAttachments/resolveChatAttachmentContents.d.ts +10 -0
  213. package/esm/src/utils/chat/chatAttachments.d.ts +54 -0
  214. package/esm/src/utils/chat/chatAttachments.test.d.ts +1 -0
  215. package/esm/src/utils/chat/constants.d.ts +21 -0
  216. package/esm/src/utils/chat/decodeChatStreamWhitespaceFromTransport.d.ts +7 -0
  217. package/esm/src/utils/chat/encodeChatStreamWhitespaceForTransport.d.ts +7 -0
  218. package/esm/src/utils/chat/escapeRegExp.d.ts +6 -0
  219. package/esm/src/utils/database/uniqueConstraint.d.ts +28 -0
  220. package/esm/src/utils/files/decodeAttachmentAsText.d.ts +81 -0
  221. package/esm/src/utils/files/decodeAttachmentAsText.test.d.ts +1 -0
  222. package/esm/src/utils/files/readResponseBytes.d.ts +14 -0
  223. package/esm/src/utils/random/EnglishNamePool.d.ts +9 -1
  224. package/esm/src/utils/toolCalls/getToolCallIdentity.d.ts +1 -1
  225. package/esm/src/utils/toolCalls/mergeToolCalls.d.ts +12 -0
  226. package/esm/src/utils/toolCalls/resolveToolCallIdempotencyKey.d.ts +10 -0
  227. package/esm/src/utils/validators/url/extractUrlsFromText.d.ts +8 -0
  228. package/esm/src/utils/validators/url/extractUrlsFromText.test.d.ts +1 -0
  229. package/esm/src/utils/validators/url/isHostnameOnPrivateNetwork.d.ts +12 -1
  230. package/esm/src/utils/validators/url/isUrlOnPrivateNetwork.d.ts +8 -2
  231. package/esm/src/utils/validators/url/normalizeDomainForMatching.d.ts +11 -0
  232. package/esm/src/utils/validators/url/normalizeDomainForMatching.test.d.ts +1 -0
  233. package/esm/src/version.d.ts +1 -1
  234. package/package.json +2 -2
  235. package/umd/index.umd.js +14 -7
  236. package/umd/index.umd.js.map +1 -1
  237. package/umd/src/_packages/components.index.d.ts +2 -0
  238. package/umd/src/_packages/core.index.d.ts +26 -0
  239. package/umd/src/_packages/markdown-utils.index.d.ts +5 -5
  240. package/umd/src/_packages/types.index.d.ts +250 -228
  241. package/umd/src/_packages/utils.index.d.ts +2 -0
  242. package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts +4 -1
  243. package/umd/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -1
  244. package/umd/src/book-2.0/agent-source/createAgentModelRequirements.d.ts +2 -2
  245. package/umd/src/book-2.0/agent-source/createAgentModelRequirements.writing.test.d.ts +1 -0
  246. package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.knowledge.test.d.ts +1 -0
  247. package/umd/src/book-2.0/agent-source/createTeamToolName.d.ts +12 -0
  248. package/umd/src/book-2.0/agent-source/extractOpenTeacherInstructions.d.ts +12 -0
  249. package/umd/src/book-2.0/agent-source/extractOpenTeacherInstructions.test.d.ts +1 -0
  250. package/umd/src/book-2.0/agent-source/parseAgentSourcePrelude.d.ts +38 -0
  251. package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.d.ts +3 -0
  252. package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.title.test.d.ts +1 -0
  253. package/umd/src/book-2.0/agent-source/pseudoAgentReferences.d.ts +110 -0
  254. package/umd/src/book-2.0/agent-source/removeCommentsFromSystemMessage.d.ts +2 -2
  255. package/umd/src/book-components/BookEditor/BookEditor.d.ts +15 -0
  256. package/umd/src/book-components/BookEditor/BookEditorActionbar.d.ts +2 -0
  257. package/umd/src/book-components/BookEditor/BookEditorMonacoConstants.d.ts +1 -0
  258. package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts +14 -7
  259. package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.test.d.ts +1 -0
  260. package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.d.ts +28 -0
  261. package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.test.d.ts +1 -0
  262. package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts +27 -0
  263. package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.test.d.ts +1 -0
  264. package/umd/src/book-components/Chat/AgentChat/AgentChatProps.d.ts +5 -0
  265. package/umd/src/book-components/Chat/Chat/ChatActionsBar.d.ts +1 -0
  266. package/umd/src/book-components/Chat/Chat/ChatInputArea.d.ts +2 -0
  267. package/umd/src/book-components/Chat/Chat/ChatInputArea.test.d.ts +2 -0
  268. package/umd/src/book-components/Chat/Chat/ChatMessageItem.d.ts +6 -1
  269. package/umd/src/book-components/Chat/Chat/ChatMessageList.d.ts +3 -0
  270. package/umd/src/book-components/Chat/Chat/ChatProps.d.ts +56 -0
  271. package/umd/src/book-components/Chat/Chat/ChatToolCallModal.d.ts +11 -0
  272. package/umd/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts +32 -0
  273. package/umd/src/book-components/Chat/Chat/chatCssClassNames.d.ts +41 -0
  274. package/umd/src/book-components/Chat/Chat/renderAdvancedToolCallDetails.d.ts +44 -0
  275. package/umd/src/book-components/Chat/Chat/renderToolCallDetails.d.ts +36 -0
  276. package/umd/src/book-components/Chat/CodeBlock/CodeBlock.d.ts +5 -0
  277. package/umd/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.d.ts +18 -0
  278. package/umd/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.test.d.ts +1 -0
  279. package/umd/src/book-components/Chat/LlmChat/LlmChatProps.d.ts +16 -0
  280. package/umd/src/book-components/Chat/hooks/useChatAutoScroll.d.ts +1 -1
  281. package/umd/src/book-components/Chat/hooks/useChatAutoScroll.test.d.ts +1 -0
  282. package/umd/src/book-components/Chat/types/ChatMessage.d.ts +16 -0
  283. package/umd/src/book-components/Chat/utils/ChatPersistence.d.ts +16 -0
  284. package/umd/src/book-components/Chat/utils/ChatPersistence.test.d.ts +4 -0
  285. package/umd/src/book-components/Chat/utils/createTeamToolNameFromUrl.d.ts +2 -2
  286. package/umd/src/book-components/Chat/utils/parseMessageButtons.d.ts +22 -5
  287. package/umd/src/book-components/Chat/utils/parseMessageButtons.test.d.ts +1 -0
  288. package/umd/src/book-components/Chat/utils/resolveToolCallFromChatMessages.d.ts +13 -0
  289. package/umd/src/book-components/Chat/utils/resolveToolCallState.d.ts +10 -0
  290. package/umd/src/book-components/Chat/utils/sanitizeStreamingMessageContent.d.ts +29 -1
  291. package/umd/src/book-components/Chat/utils/splitMessageContentIntoSegments.d.ts +16 -3
  292. package/umd/src/book-components/Chat/utils/thinkingMessageVariants.d.ts +24 -0
  293. package/umd/src/book-components/Chat/utils/thinkingMessageVariants.test.d.ts +1 -0
  294. package/umd/src/book-components/Chat/utils/toolCallParsing/RunBrowserToolResult.d.ts +50 -0
  295. package/umd/src/book-components/Chat/utils/toolCallParsing/TeamToolResult.d.ts +30 -0
  296. package/umd/src/book-components/Chat/utils/toolCallParsing/extractSearchResults.d.ts +19 -0
  297. package/umd/src/book-components/Chat/utils/toolCallParsing/getToolCallResultDate.d.ts +9 -0
  298. package/umd/src/book-components/Chat/utils/toolCallParsing/getToolCallTimestamp.d.ts +9 -0
  299. package/umd/src/book-components/Chat/utils/toolCallParsing/parseRunBrowserToolResult.d.ts +10 -0
  300. package/umd/src/book-components/Chat/utils/toolCallParsing/parseTeamToolResult.d.ts +10 -0
  301. package/umd/src/book-components/Chat/utils/toolCallParsing/parseToolCallArguments.d.ts +10 -0
  302. package/umd/src/book-components/Chat/utils/toolCallParsing/parseToolCallResult.d.ts +10 -0
  303. package/umd/src/book-components/Chat/utils/toolCallParsing/resolveRunBrowserArtifactUrl.d.ts +8 -0
  304. package/umd/src/book-components/Chat/utils/toolCallParsing.d.ts +10 -68
  305. package/umd/src/book-components/Chat/utils/toolCallParsing.test.d.ts +1 -0
  306. package/umd/src/book-components/Chat/utils/walletCredentialToolCall.d.ts +52 -0
  307. package/umd/src/book-components/Chat/utils/walletCredentialToolCall.test.d.ts +1 -0
  308. package/umd/src/book-components/PromptbookAgent/PromptbookAgentIntegration.d.ts +14 -0
  309. package/umd/src/book-components/PromptbookAgent/PromptbookAgentSeamlessIntegration.d.ts +3 -0
  310. package/umd/src/book-components/_common/MonacoEditorWithShadowDom.d.ts +17 -0
  311. package/umd/src/book-components/icons/ArrowIcon.d.ts +30 -5
  312. package/umd/src/book-components/icons/SolidArrowButton.d.ts +28 -0
  313. package/umd/src/book-components/icons/StopIcon.d.ts +8 -0
  314. package/umd/src/cli/cli-commands/coder/find-fresh-emoji-tag.d.ts +14 -0
  315. package/umd/src/cli/cli-commands/coder/find-refactor-candidates.d.ts +14 -0
  316. package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts +14 -0
  317. package/umd/src/cli/cli-commands/coder/run.d.ts +14 -0
  318. package/umd/src/cli/cli-commands/coder/verify.d.ts +14 -0
  319. package/umd/src/cli/cli-commands/coder.d.ts +21 -0
  320. package/umd/src/collection/agent-collection/CreateAgentInput.d.ts +59 -0
  321. package/umd/src/collection/agent-collection/CreateAgentInput.test.d.ts +1 -0
  322. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +52 -8
  323. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema.d.ts +6 -3
  324. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts +36 -0
  325. package/umd/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts +0 -3
  326. package/umd/src/commitments/MEMORY/MEMORY.d.ts +4 -59
  327. package/umd/src/commitments/MEMORY/MemoryToolNames.d.ts +11 -0
  328. package/umd/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +149 -0
  329. package/umd/src/commitments/MEMORY/createMemorySystemMessage.d.ts +6 -0
  330. package/umd/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +8 -0
  331. package/umd/src/commitments/MEMORY/createMemoryTools.d.ts +14 -0
  332. package/umd/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +6 -0
  333. package/umd/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +17 -0
  334. package/umd/src/commitments/MEMORY/getMemoryToolTitles.d.ts +7 -0
  335. package/umd/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +61 -0
  336. package/umd/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +8 -0
  337. package/umd/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +13 -0
  338. package/umd/src/commitments/MESSAGE/InternalMessageCommitmentDefinition.d.ts +33 -0
  339. package/umd/src/commitments/MESSAGE/MESSAGE.d.ts +2 -2
  340. package/umd/src/commitments/META/META.d.ts +4 -0
  341. package/umd/src/commitments/META_DOMAIN/META_DOMAIN.d.ts +33 -0
  342. package/umd/src/commitments/META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER.d.ts +33 -0
  343. package/umd/src/commitments/META_VOICE/META_VOICE.d.ts +39 -0
  344. package/umd/src/commitments/SAMPLE/SAMPLE.d.ts +13 -13
  345. package/umd/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +1 -1
  346. package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +10 -0
  347. package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts +1 -0
  348. package/umd/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +4 -11
  349. package/umd/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts +1 -0
  350. package/umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +21 -0
  351. package/umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts +1 -0
  352. package/umd/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +2 -7
  353. package/umd/src/commitments/USE_POPUP/USE_POPUP.d.ts +49 -0
  354. package/umd/src/commitments/USE_PRIVACY/USE_PRIVACY.d.ts +39 -0
  355. package/umd/src/commitments/USE_PRIVACY/USE_PRIVACY.test.d.ts +1 -0
  356. package/umd/src/commitments/USE_PROJECT/USE_PROJECT.d.ts +42 -0
  357. package/umd/src/commitments/USE_PROJECT/USE_PROJECT.test.d.ts +1 -0
  358. package/umd/src/commitments/USE_PROJECT/UseProjectToolNames.d.ts +13 -0
  359. package/umd/src/commitments/USE_PROJECT/UseProjectWallet.d.ts +9 -0
  360. package/umd/src/commitments/USE_PROJECT/callGitHubApi.d.ts +69 -0
  361. package/umd/src/commitments/USE_PROJECT/createUseProjectToolFunctions.d.ts +8 -0
  362. package/umd/src/commitments/USE_PROJECT/createUseProjectTools.d.ts +7 -0
  363. package/umd/src/commitments/USE_PROJECT/getUseProjectToolTitles.d.ts +7 -0
  364. package/umd/src/commitments/USE_PROJECT/normalizeConfiguredProjects.d.ts +16 -0
  365. package/umd/src/commitments/USE_PROJECT/normalizeOptionalToolText.d.ts +12 -0
  366. package/umd/src/commitments/USE_PROJECT/projectReference.d.ts +52 -0
  367. package/umd/src/commitments/USE_PROJECT/projectReference.test.d.ts +1 -0
  368. package/umd/src/commitments/USE_PROJECT/resolveUseProjectToolRuntimeOrWalletCredentialResult.d.ts +34 -0
  369. package/umd/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +41 -0
  370. package/umd/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts +1 -0
  371. package/umd/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +9 -0
  372. package/umd/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +12 -0
  373. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +9 -0
  374. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +90 -0
  375. package/umd/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +41 -0
  376. package/umd/src/commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts +1 -0
  377. package/umd/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +6 -0
  378. package/umd/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +8 -0
  379. package/umd/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +7 -0
  380. package/umd/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +17 -0
  381. package/umd/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +34 -0
  382. package/umd/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +8 -0
  383. package/umd/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +13 -0
  384. package/umd/src/commitments/WALLET/WALLET.d.ts +24 -0
  385. package/umd/src/commitments/WALLET/WALLET.test.d.ts +1 -0
  386. package/umd/src/commitments/WALLET/WalletToolNames.d.ts +12 -0
  387. package/umd/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +163 -0
  388. package/umd/src/commitments/WALLET/createWalletSystemMessage.d.ts +6 -0
  389. package/umd/src/commitments/WALLET/createWalletToolFunctions.d.ts +8 -0
  390. package/umd/src/commitments/WALLET/createWalletTools.d.ts +7 -0
  391. package/umd/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +6 -0
  392. package/umd/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +16 -0
  393. package/umd/src/commitments/WALLET/getWalletToolTitles.d.ts +7 -0
  394. package/umd/src/commitments/WALLET/parseWalletToolArgs.d.ts +51 -0
  395. package/umd/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +8 -0
  396. package/umd/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +13 -0
  397. package/umd/src/commitments/WRITING_RULES/WRITING_RULES.d.ts +29 -0
  398. package/umd/src/commitments/WRITING_SAMPLE/WRITING_SAMPLE.d.ts +29 -0
  399. package/umd/src/commitments/_base/BaseCommitmentDefinition.d.ts +12 -0
  400. package/umd/src/commitments/_base/CommitmentDefinition.d.ts +23 -0
  401. package/umd/src/commitments/_common/createWritingCommitmentSections.d.ts +19 -0
  402. package/umd/src/commitments/_common/getGroupedCommitmentDefinitions.writing.test.d.ts +1 -0
  403. package/umd/src/commitments/_common/toolExecutionEnvelope.d.ts +22 -0
  404. package/umd/src/commitments/_common/toolRuntimeContext.d.ts +90 -0
  405. package/umd/src/commitments/index.d.ts +12 -1
  406. package/umd/src/config.d.ts +3 -0
  407. package/umd/src/errors/0-index.d.ts +3 -0
  408. package/umd/src/errors/ConflictError.d.ts +9 -0
  409. package/umd/src/execution/LlmExecutionTools.d.ts +12 -1
  410. package/umd/src/execution/Usage.d.ts +4 -0
  411. package/umd/src/execution/utils/usageToHuman.d.ts +1 -0
  412. package/umd/src/file-security-checkers/FileSecurityCheckResult.d.ts +32 -0
  413. package/umd/src/file-security-checkers/FileSecurityChecker.d.ts +34 -0
  414. package/umd/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.d.ts +36 -0
  415. package/umd/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.test.d.ts +1 -0
  416. package/umd/src/llm-providers/agent/Agent.d.ts +2 -2
  417. package/umd/src/llm-providers/agent/AgentLlmExecutionTools.d.ts +2 -2
  418. package/umd/src/llm-providers/agent/RemoteAgent.d.ts +2 -1
  419. package/umd/src/llm-providers/agent/self-learning/SelfLearningManager.test.d.ts +1 -0
  420. package/umd/src/llm-providers/anthropic-claude/computeAnthropicClaudeUsage.d.ts +3 -1
  421. package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts +33 -3
  422. package/umd/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts +2 -2
  423. package/umd/src/llm-providers/openai/OpenAiCompatibleExecutionTools.d.ts +2 -2
  424. package/umd/src/llm-providers/openai/computeOpenAiUsage.d.ts +3 -1
  425. package/umd/src/playground/playground.d.ts +1 -0
  426. package/umd/src/speech-recognition/OpenAiSpeechRecognition.d.ts +49 -1
  427. package/umd/src/types/SpeechRecognition.d.ts +14 -0
  428. package/umd/src/types/ToolCall.d.ts +56 -0
  429. package/umd/src/types/number_usd.d.ts +110 -0
  430. package/umd/src/types/string_filename.d.ts +39 -0
  431. package/umd/src/types/string_knowledge_source_content.d.ts +29 -0
  432. package/umd/src/types/string_markdown.d.ts +138 -0
  433. package/umd/src/types/string_parameter_name.d.ts +170 -0
  434. package/umd/src/types/string_person_fullname.d.ts +85 -0
  435. package/umd/src/types/string_sha256.d.ts +44 -0
  436. package/umd/src/types/string_token.d.ts +58 -0
  437. package/umd/src/types/string_url.d.ts +146 -0
  438. package/umd/src/types/typeAliases.d.ts +9 -741
  439. package/umd/src/utils/chat/chatAttachments/appendChatAttachmentContext.d.ts +10 -0
  440. package/umd/src/utils/chat/chatAttachments/appendChatAttachmentContextWithContent.d.ts +14 -0
  441. package/umd/src/utils/chat/chatAttachments/appendChatContextSections.d.ts +6 -0
  442. package/umd/src/utils/chat/chatAttachments/formatChatAttachmentContentContext.d.ts +9 -0
  443. package/umd/src/utils/chat/chatAttachments/formatChatAttachmentContext.d.ts +9 -0
  444. package/umd/src/utils/chat/chatAttachments/normalizeChatAttachments.d.ts +11 -0
  445. package/umd/src/utils/chat/chatAttachments/resolveChatAttachmentContent.d.ts +11 -0
  446. package/umd/src/utils/chat/chatAttachments/resolveChatAttachmentContents.d.ts +10 -0
  447. package/umd/src/utils/chat/chatAttachments.d.ts +54 -0
  448. package/umd/src/utils/chat/chatAttachments.test.d.ts +1 -0
  449. package/umd/src/utils/chat/constants.d.ts +21 -0
  450. package/umd/src/utils/chat/decodeChatStreamWhitespaceFromTransport.d.ts +7 -0
  451. package/umd/src/utils/chat/encodeChatStreamWhitespaceForTransport.d.ts +7 -0
  452. package/umd/src/utils/chat/escapeRegExp.d.ts +6 -0
  453. package/umd/src/utils/database/uniqueConstraint.d.ts +28 -0
  454. package/umd/src/utils/files/decodeAttachmentAsText.d.ts +81 -0
  455. package/umd/src/utils/files/decodeAttachmentAsText.test.d.ts +1 -0
  456. package/umd/src/utils/files/readResponseBytes.d.ts +14 -0
  457. package/umd/src/utils/random/EnglishNamePool.d.ts +9 -1
  458. package/umd/src/utils/toolCalls/getToolCallIdentity.d.ts +1 -1
  459. package/umd/src/utils/toolCalls/mergeToolCalls.d.ts +12 -0
  460. package/umd/src/utils/toolCalls/resolveToolCallIdempotencyKey.d.ts +10 -0
  461. package/umd/src/utils/validators/url/extractUrlsFromText.d.ts +8 -0
  462. package/umd/src/utils/validators/url/extractUrlsFromText.test.d.ts +1 -0
  463. package/umd/src/utils/validators/url/isHostnameOnPrivateNetwork.d.ts +12 -1
  464. package/umd/src/utils/validators/url/isUrlOnPrivateNetwork.d.ts +8 -2
  465. package/umd/src/utils/validators/url/normalizeDomainForMatching.d.ts +11 -0
  466. package/umd/src/utils/validators/url/normalizeDomainForMatching.test.d.ts +1 -0
  467. package/umd/src/version.d.ts +1 -1
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Parsed payload of one `USE EMAIL` commitment.
3
+ *
4
+ * @private internal USE EMAIL type
5
+ */
6
+ export type ParsedUseEmailCommitmentContent = {
7
+ senderEmail: string | null;
8
+ senderEmailRaw: string | null;
9
+ instructions: string;
10
+ };
11
+ /**
12
+ * Parses `USE EMAIL` commitment content into optional sender email + additional instructions.
13
+ *
14
+ * Examples:
15
+ * - `agent@example.com`
16
+ * - `agent@example.com Keep emails concise`
17
+ * - `Keep emails concise`
18
+ *
19
+ * @private internal utility of USE EMAIL commitment
20
+ */
21
+ export declare function parseUseEmailCommitmentContent(content: string): ParsedUseEmailCommitmentContent;
@@ -4,15 +4,10 @@
4
4
  * This function proxies requests to the Agents Server API endpoint for email queuing,
5
5
  * making it safe to use in browser environments.
6
6
  *
7
- * @param args Email payload containing recipients, subject, and body
7
+ * @param args Email payload forwarded to the server-side `send_email` tool
8
8
  * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
9
9
  * @returns Result string from the server-side send_email tool
10
10
  *
11
11
  * @private internal utility for USE EMAIL commitment
12
12
  */
13
- export declare function sendEmailViaBrowser(args: {
14
- to: string[];
15
- cc?: string[];
16
- subject: string;
17
- body: string;
18
- }, agentsServerUrl?: string): Promise<string>;
13
+ export declare function sendEmailViaBrowser(args: Record<string, unknown>, agentsServerUrl?: string): Promise<string>;
@@ -0,0 +1,49 @@
1
+ import { string_javascript_name } from '../../_packages/types.index';
2
+ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
3
+ import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
4
+ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
+ /**
6
+ * USE POPUP commitment definition
7
+ *
8
+ * The `USE POPUP` commitment indicates that the agent can open a popup window with a specific website.
9
+ * This is useful, for example, when the agent writes a post on Facebook but wants the user to post it on Facebook.
10
+ *
11
+ * Example usage in agent source:
12
+ *
13
+ * ```book
14
+ * USE POPUP Allow to open Facebook and Linkedin
15
+ * ```
16
+ *
17
+ * @private [🪔] Maybe export the commitments through some package
18
+ */
19
+ export declare class UsePopupCommitmentDefinition extends BaseCommitmentDefinition<'USE POPUP'> {
20
+ constructor();
21
+ /**
22
+ * The `USE POPUP` commitment is standalone or with instructions.
23
+ */
24
+ get requiresContent(): boolean;
25
+ /**
26
+ * Short one-line description of USE POPUP.
27
+ */
28
+ get description(): string;
29
+ /**
30
+ * Icon for this commitment.
31
+ */
32
+ get icon(): string;
33
+ /**
34
+ * Markdown documentation for USE POPUP commitment.
35
+ */
36
+ get documentation(): string;
37
+ applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
38
+ /**
39
+ * Gets human-readable titles for tool functions provided by this commitment.
40
+ */
41
+ getToolTitles(): Record<string_javascript_name, string>;
42
+ /**
43
+ * Gets the `open_popup` tool function implementation.
44
+ */
45
+ getToolFunctions(): Record<string_javascript_name, ToolFunction>;
46
+ }
47
+ /**
48
+ * Note: [💞] Ignore a discrepancy between file name and entity name
49
+ */
@@ -0,0 +1,39 @@
1
+ import { string_javascript_name } from '../../_packages/types.index';
2
+ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
3
+ import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
4
+ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
+ /**
6
+ * USE PRIVACY commitment definition.
7
+ *
8
+ * The `USE PRIVACY` commitment enables an agent to request enabling private mode.
9
+ *
10
+ * @private [🪔] Maybe export the commitments through some package
11
+ */
12
+ export declare class UsePrivacyCommitmentDefinition extends BaseCommitmentDefinition<'USE PRIVACY'> {
13
+ constructor();
14
+ get requiresContent(): boolean;
15
+ /**
16
+ * Short one-line description of USE PRIVACY.
17
+ */
18
+ get description(): string;
19
+ /**
20
+ * Icon for this commitment.
21
+ */
22
+ get icon(): string;
23
+ /**
24
+ * Markdown documentation for USE PRIVACY commitment.
25
+ */
26
+ get documentation(): string;
27
+ applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
28
+ /**
29
+ * Gets human-readable titles for tool functions provided by this commitment.
30
+ */
31
+ getToolTitles(): Record<string_javascript_name, string>;
32
+ /**
33
+ * Gets the `turn_privacy_on` tool function implementation.
34
+ */
35
+ getToolFunctions(): Record<string_javascript_name, ToolFunction>;
36
+ }
37
+ /**
38
+ * Note: [💞] Ignore a discrepancy between file name and entity name
39
+ */
@@ -0,0 +1,42 @@
1
+ import type { string_javascript_name } from '../../_packages/types.index';
2
+ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
3
+ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
4
+ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
+ /**
6
+ * USE PROJECT commitment definition.
7
+ *
8
+ * `USE PROJECT` enables GitHub repository tooling so the agent can browse source files,
9
+ * edit code, and open pull requests against declared repositories.
10
+ *
11
+ * Authentication is expected through runtime context provided by the host app UI.
12
+ * Hosts can provide manual wallet tokens or auto-issued integration tokens (for example via GitHub App).
13
+ *
14
+ * @private [🪔] Maybe export the commitments through some package
15
+ */
16
+ export declare class UseProjectCommitmentDefinition extends BaseCommitmentDefinition<'USE PROJECT'> {
17
+ constructor();
18
+ /**
19
+ * Short one-line description of USE PROJECT.
20
+ */
21
+ get description(): string;
22
+ /**
23
+ * Icon for this commitment.
24
+ */
25
+ get icon(): string;
26
+ /**
27
+ * Markdown documentation for USE PROJECT commitment.
28
+ */
29
+ get documentation(): string;
30
+ applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
31
+ /**
32
+ * Gets human-readable titles for tool functions provided by this commitment.
33
+ */
34
+ getToolTitles(): Record<string_javascript_name, string>;
35
+ /**
36
+ * Gets GitHub project tool function implementations.
37
+ */
38
+ getToolFunctions(): Record<string_javascript_name, ToolFunction>;
39
+ }
40
+ /**
41
+ * Note: [💞] Ignore a discrepancy between file name and entity name
42
+ */
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Names of tools used by the USE PROJECT commitment.
3
+ *
4
+ * @private constant of UseProjectCommitmentDefinition
5
+ */
6
+ export declare const UseProjectToolNames: {
7
+ readonly listFiles: string;
8
+ readonly readFile: string;
9
+ readonly upsertFile: string;
10
+ readonly deleteFile: string;
11
+ readonly createBranch: string;
12
+ readonly createPullRequest: string;
13
+ };
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Wallet metadata used by USE PROJECT when resolving GitHub credentials.
3
+ *
4
+ * @private constant of UseProjectCommitmentDefinition
5
+ */
6
+ export declare const UseProjectWallet: {
7
+ readonly service: "github";
8
+ readonly key: "use-project-github-token";
9
+ };
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Minimal shape returned by GitHub content APIs.
3
+ *
4
+ * @private type of UseProjectCommitmentDefinition
5
+ */
6
+ export type UseProjectGitHubContentsItem = {
7
+ type: string;
8
+ name: string;
9
+ path: string;
10
+ sha?: string;
11
+ size?: number;
12
+ content?: string;
13
+ html_url?: string;
14
+ download_url?: string;
15
+ };
16
+ /**
17
+ * Minimal shape of GitHub branch reference API response.
18
+ *
19
+ * @private type of UseProjectCommitmentDefinition
20
+ */
21
+ export type UseProjectGitHubGitRefResponse = {
22
+ object?: {
23
+ sha?: string;
24
+ };
25
+ };
26
+ /**
27
+ * Minimal shape of GitHub repository API response.
28
+ *
29
+ * @private type of UseProjectCommitmentDefinition
30
+ */
31
+ export type UseProjectGitHubRepositoryResponse = {
32
+ default_branch?: string;
33
+ };
34
+ /**
35
+ * Minimal shape of GitHub pull request response.
36
+ *
37
+ * @private type of UseProjectCommitmentDefinition
38
+ */
39
+ export type UseProjectGitHubPullRequestResponse = {
40
+ number?: number;
41
+ html_url?: string;
42
+ title?: string;
43
+ state?: string;
44
+ head?: {
45
+ ref?: string;
46
+ };
47
+ base?: {
48
+ ref?: string;
49
+ };
50
+ };
51
+ /**
52
+ * Options for one GitHub API call.
53
+ *
54
+ * @private type of callGitHubApi
55
+ */
56
+ type CallGitHubApiOptions = {
57
+ method: 'GET' | 'POST' | 'PUT' | 'DELETE';
58
+ path: string;
59
+ query?: Record<string, string>;
60
+ body?: Record<string, unknown>;
61
+ allowNotFound?: boolean;
62
+ };
63
+ /**
64
+ * Runs one GitHub API request and parses JSON response payload.
65
+ *
66
+ * @private function of UseProjectCommitmentDefinition
67
+ */
68
+ export declare function callGitHubApi<TResponse = unknown>(token: string, options: CallGitHubApiOptions): Promise<TResponse | null>;
69
+ export {};
@@ -0,0 +1,8 @@
1
+ import type { string_javascript_name } from '../../_packages/types.index';
2
+ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
3
+ /**
4
+ * Gets GitHub project tool function implementations.
5
+ *
6
+ * @private function of UseProjectCommitmentDefinition
7
+ */
8
+ export declare function createUseProjectToolFunctions(): Record<string_javascript_name, ToolFunction>;
@@ -0,0 +1,7 @@
1
+ import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
2
+ /**
3
+ * Adds USE PROJECT tool definitions while keeping already registered tools untouched.
4
+ *
5
+ * @private function of UseProjectCommitmentDefinition
6
+ */
7
+ export declare function createUseProjectTools(existingTools: ReadonlyArray<LlmToolDefinition>): Array<LlmToolDefinition>;
@@ -0,0 +1,7 @@
1
+ import type { string_javascript_name } from '../../_packages/types.index';
2
+ /**
3
+ * Returns human-readable titles for USE PROJECT tool functions.
4
+ *
5
+ * @private function of UseProjectCommitmentDefinition
6
+ */
7
+ export declare function getUseProjectToolTitles(): Record<string_javascript_name, string>;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Configured project reference stored in model requirements metadata.
3
+ *
4
+ * @private type of UseProjectCommitmentDefinition
5
+ */
6
+ export type UseProjectConfiguredProjectReference = {
7
+ url: string;
8
+ slug: string;
9
+ defaultBranch?: string;
10
+ };
11
+ /**
12
+ * Parses previously stored metadata value into a normalized project list.
13
+ *
14
+ * @private function of UseProjectCommitmentDefinition
15
+ */
16
+ export declare function normalizeConfiguredProjects(rawValue: unknown): Array<UseProjectConfiguredProjectReference>;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Normalizes optional text argument to `string | null`.
3
+ *
4
+ * @private function of UseProjectCommitmentDefinition
5
+ */
6
+ export declare function normalizeOptionalToolText(value: unknown): string | null;
7
+ /**
8
+ * Normalizes required text argument and throws when missing.
9
+ *
10
+ * @private function of UseProjectCommitmentDefinition
11
+ */
12
+ export declare function normalizeRequiredToolText(value: unknown, fieldName: string): string;
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Canonical GitHub repository reference resolved from commitment content.
3
+ *
4
+ * @private internal utility of USE PROJECT commitment
5
+ */
6
+ export type GitHubRepositoryReference = {
7
+ owner: string;
8
+ repository: string;
9
+ slug: string;
10
+ url: string;
11
+ defaultBranch?: string;
12
+ };
13
+ /**
14
+ * Parsed `USE PROJECT` payload.
15
+ *
16
+ * @private internal utility of USE PROJECT commitment
17
+ */
18
+ export type ParsedUseProjectCommitmentContent = {
19
+ repository: GitHubRepositoryReference | null;
20
+ repositoryReferenceRaw: string | null;
21
+ instructions: string;
22
+ };
23
+ /**
24
+ * Parses a repository reference into canonical owner/repository details.
25
+ *
26
+ * Supported input forms:
27
+ * - `https://github.com/owner/repository`
28
+ * - `github.com/owner/repository`
29
+ * - `owner/repository`
30
+ * - optional `.git` suffix and trailing slash are supported
31
+ *
32
+ * @private internal utility of USE PROJECT commitment
33
+ */
34
+ export declare function parseGitHubRepositoryReference(rawReference: string): GitHubRepositoryReference | null;
35
+ /**
36
+ * Parses `USE PROJECT` commitment content into repository reference + optional instructions.
37
+ *
38
+ * @private internal utility of USE PROJECT commitment
39
+ */
40
+ export declare function parseUseProjectCommitmentContent(content: string): ParsedUseProjectCommitmentContent;
41
+ /**
42
+ * Extracts canonical repository URLs from parsed commitments.
43
+ *
44
+ * @private internal utility of USE PROJECT commitment
45
+ */
46
+ export declare function extractUseProjectRepositoryUrlsFromCommitments(commitments: ReadonlyArray<{
47
+ type: string;
48
+ content: string;
49
+ }>): string[];
50
+ /**
51
+ * Note: [💞] Ignore a discrepancy between file name and entity name
52
+ */
@@ -0,0 +1,34 @@
1
+ import { type GitHubRepositoryReference } from './projectReference';
2
+ /**
3
+ * Shared hidden arguments potentially injected into any USE PROJECT tool call.
4
+ *
5
+ * @private type of UseProjectCommitmentDefinition
6
+ */
7
+ export type UseProjectToolArgsBase = {
8
+ repository?: string;
9
+ __promptbookToolRuntimeContext?: unknown;
10
+ };
11
+ /**
12
+ * Resolved runtime payload used by USE PROJECT tools.
13
+ *
14
+ * @private type of resolveUseProjectToolRuntimeOrWalletCredentialResult
15
+ */
16
+ type UseProjectResolvedRuntime = {
17
+ repositoryReference: GitHubRepositoryReference;
18
+ token: string;
19
+ };
20
+ /**
21
+ * Runtime resolution result for USE PROJECT tools.
22
+ *
23
+ * @private type of UseProjectCommitmentDefinition
24
+ */
25
+ export type UseProjectToolRuntimeResolution = UseProjectResolvedRuntime | {
26
+ walletResult: string;
27
+ };
28
+ /**
29
+ * Resolves project runtime or returns a wallet-credential-required payload when missing.
30
+ *
31
+ * @private function of UseProjectCommitmentDefinition
32
+ */
33
+ export declare function resolveUseProjectToolRuntimeOrWalletCredentialResult(args: UseProjectToolArgsBase): UseProjectToolRuntimeResolution;
34
+ export {};
@@ -0,0 +1,41 @@
1
+ import { string_javascript_name } from '../../_packages/types.index';
2
+ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
3
+ import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
4
+ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
+ /**
6
+ * USE SPAWN commitment definition.
7
+ *
8
+ * The `USE SPAWN` commitment enables creating new persistent child agents through one tool call.
9
+ *
10
+ * @private [🪔] Maybe export the commitments through some package
11
+ */
12
+ export declare class UseSpawnCommitmentDefinition extends BaseCommitmentDefinition<'USE SPAWN'> {
13
+ constructor();
14
+ get requiresContent(): boolean;
15
+ /**
16
+ * Short one-line description of USE SPAWN.
17
+ */
18
+ get description(): string;
19
+ /**
20
+ * Icon for this commitment.
21
+ */
22
+ get icon(): string;
23
+ /**
24
+ * Markdown documentation for USE SPAWN commitment.
25
+ */
26
+ get documentation(): string;
27
+ applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
28
+ /**
29
+ * Gets human-readable titles for tool functions provided by this commitment.
30
+ */
31
+ getToolTitles(): Record<string_javascript_name, string>;
32
+ /**
33
+ * Gets browser-safe `spawn_agent` implementation.
34
+ *
35
+ * Node.js runtime overrides this through `getAllCommitmentsToolFunctionsForNode`.
36
+ */
37
+ getToolFunctions(): Record<string_javascript_name, ToolFunction>;
38
+ }
39
+ /**
40
+ * Note: [💞] Ignore a discrepancy between file name and entity name
41
+ */
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { ToolFunction } from '../../_packages/types.index';
2
+ /**
3
+ * Resolves the server-side `spawn_agent` tool for Node.js runtimes.
4
+ *
5
+ * Uses lazy require so core package can load outside Agents Server.
6
+ *
7
+ * @private internal utility for USE SPAWN commitment
8
+ */
9
+ export declare function resolveSpawnAgentToolForNode(): ToolFunction;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Browser-safe wrapper for spawning one persisted Agents Server agent.
3
+ *
4
+ * This function proxies requests to the Agents Server `/api/spawn-agent` endpoint.
5
+ *
6
+ * @param args Tool payload forwarded to server-side `spawn_agent` tool.
7
+ * @param agentsServerUrl Optional explicit agents server base URL.
8
+ * @returns JSON string with structured spawn result.
9
+ *
10
+ * @private internal utility for USE SPAWN commitment
11
+ */
12
+ export declare function spawnAgentViaBrowser(args: Record<string, unknown>, agentsServerUrl?: string): Promise<string>;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Tool names provided by the `USE TIMEOUT` commitment.
3
+ *
4
+ * @private internal USE TIMEOUT constant
5
+ */
6
+ export declare const TimeoutToolNames: {
7
+ readonly set: string;
8
+ readonly cancel: string;
9
+ };
@@ -0,0 +1,90 @@
1
+ import type { TODO_any } from '../../_packages/types.index';
2
+ /**
3
+ * Tool arguments for scheduling one timeout.
4
+ *
5
+ * @private type of UseTimeoutCommitmentDefinition
6
+ */
7
+ export type SetTimeoutToolArgs = {
8
+ milliseconds?: number;
9
+ message?: string;
10
+ [key: string]: TODO_any;
11
+ };
12
+ /**
13
+ * Tool arguments for cancelling one timeout.
14
+ *
15
+ * @private type of UseTimeoutCommitmentDefinition
16
+ */
17
+ export type CancelTimeoutToolArgs = {
18
+ timeoutId?: string;
19
+ [key: string]: TODO_any;
20
+ };
21
+ /**
22
+ * Runtime context available to `USE TIMEOUT` tools.
23
+ *
24
+ * @private type of UseTimeoutCommitmentDefinition
25
+ */
26
+ export type TimeoutToolRuntimeContext = {
27
+ readonly enabled: boolean;
28
+ readonly chatId?: string;
29
+ readonly userId?: number;
30
+ readonly agentId?: string;
31
+ readonly agentName?: string;
32
+ readonly promptParameters: Record<string, string>;
33
+ };
34
+ /**
35
+ * Result payload returned by `set_timeout`.
36
+ *
37
+ * @private type of UseTimeoutCommitmentDefinition
38
+ */
39
+ export type SetTimeoutToolResult = {
40
+ action: 'set';
41
+ status: 'set' | 'disabled' | 'error';
42
+ timeoutId?: string;
43
+ dueAt?: string;
44
+ message?: string;
45
+ };
46
+ /**
47
+ * Result payload returned by `cancel_timeout`.
48
+ *
49
+ * @private type of UseTimeoutCommitmentDefinition
50
+ */
51
+ export type CancelTimeoutToolResult = {
52
+ action: 'cancel';
53
+ status: 'cancelled' | 'not_found' | 'disabled' | 'error';
54
+ timeoutId?: string;
55
+ dueAt?: string;
56
+ message?: string;
57
+ };
58
+ /**
59
+ * Union of all `USE TIMEOUT` tool actions.
60
+ *
61
+ * @private type of UseTimeoutCommitmentDefinition
62
+ */
63
+ export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'];
64
+ /**
65
+ * Union of all `USE TIMEOUT` tool results.
66
+ *
67
+ * @private type of UseTimeoutCommitmentDefinition
68
+ */
69
+ export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult;
70
+ /**
71
+ * Runtime adapter used by `USE TIMEOUT` tools.
72
+ *
73
+ * @private type of UseTimeoutCommitmentDefinition
74
+ */
75
+ export type TimeoutToolRuntimeAdapter = {
76
+ scheduleTimeout(args: {
77
+ milliseconds: number;
78
+ message?: string;
79
+ }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
80
+ timeoutId: string;
81
+ dueAt: string;
82
+ }>;
83
+ cancelTimeout(args: {
84
+ timeoutId: string;
85
+ }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
86
+ timeoutId: string;
87
+ dueAt?: string;
88
+ status: 'cancelled' | 'not_found';
89
+ }>;
90
+ };
@@ -0,0 +1,41 @@
1
+ import type { string_javascript_name } from '../../_packages/types.index';
2
+ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
3
+ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
4
+ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
5
+ export { setTimeoutToolRuntimeAdapter } from './setTimeoutToolRuntimeAdapter';
6
+ export type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
7
+ /**
8
+ * `USE TIMEOUT` commitment definition.
9
+ *
10
+ * The `USE TIMEOUT` commitment enables thread-scoped timers that wake the same chat later.
11
+ *
12
+ * @private [🪔] Maybe export the commitments through some package
13
+ */
14
+ export declare class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition<'USE TIMEOUT'> {
15
+ constructor();
16
+ get requiresContent(): boolean;
17
+ /**
18
+ * Short one-line description of `USE TIMEOUT`.
19
+ */
20
+ get description(): string;
21
+ /**
22
+ * Icon for this commitment.
23
+ */
24
+ get icon(): string;
25
+ /**
26
+ * Markdown documentation for `USE TIMEOUT`.
27
+ */
28
+ get documentation(): string;
29
+ applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
30
+ /**
31
+ * Gets human-readable titles for tool functions provided by this commitment.
32
+ */
33
+ getToolTitles(): Record<string_javascript_name, string>;
34
+ /**
35
+ * Gets `USE TIMEOUT` tool function implementations.
36
+ */
37
+ getToolFunctions(): Record<string_javascript_name, ToolFunction>;
38
+ }
39
+ /**
40
+ * Note: [💞] Ignore a discrepancy between file name and entity name
41
+ */
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Creates system-message instructions for `USE TIMEOUT`.
3
+ *
4
+ * @private internal utility of USE TIMEOUT
5
+ */
6
+ export declare function createTimeoutSystemMessage(extraInstructions: string): string;
@@ -0,0 +1,8 @@
1
+ import type { string_javascript_name } from '../../_packages/types.index';
2
+ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
3
+ /**
4
+ * Gets `USE TIMEOUT` tool function implementations.
5
+ *
6
+ * @private internal utility of USE TIMEOUT
7
+ */
8
+ export declare function createTimeoutToolFunctions(): Record<string_javascript_name, ToolFunction>;