@promptbook/cli 0.114.0-4 → 0.114.0-41

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 (1027) hide show
  1. package/README.md +9 -9
  2. package/agents/default/.core/adam.book +33 -0
  3. package/agents/default/developer.book +14 -19
  4. package/apps/agents-server/README.md +1 -1
  5. package/apps/agents-server/next.config.ts +28 -0
  6. package/apps/agents-server/package.json +7 -7
  7. package/apps/agents-server/scripts/build-agents-server.js +47 -7
  8. package/apps/agents-server/scripts/build-e2e.js +12 -2
  9. package/apps/agents-server/scripts/generate-reserved-paths/generate-reserved-paths.ts +30 -16
  10. package/apps/agents-server/scripts/kill-port.js +163 -0
  11. package/apps/agents-server/scripts/run-e2e-tests.js +21 -8
  12. package/apps/agents-server/scripts/run-npm.js +81 -5
  13. package/apps/agents-server/src/app/admin/_components/AdminFilterFields.tsx +84 -0
  14. package/apps/agents-server/src/app/admin/_components/AdminMetricCard.tsx +36 -0
  15. package/apps/agents-server/src/app/admin/_components/AdminTaskManagerTabs.tsx +97 -0
  16. package/apps/agents-server/src/app/admin/about/page.tsx +1 -1
  17. package/apps/agents-server/src/app/admin/email-server/page.tsx +17 -18
  18. package/apps/agents-server/src/app/admin/messages/MessageParticipants.tsx +84 -0
  19. package/apps/agents-server/src/app/admin/messages/MessageStatus.tsx +96 -0
  20. package/apps/agents-server/src/app/admin/messages/MessagesClient.tsx +29 -33
  21. package/apps/agents-server/src/app/admin/messages/messageAdminPresentation.ts +289 -0
  22. package/apps/agents-server/src/app/admin/messages/send-email/SendEmailClient.tsx +193 -63
  23. package/apps/agents-server/src/app/admin/messages/send-email/actions.ts +25 -28
  24. package/apps/agents-server/src/app/admin/messages/send-email/emailTesting.ts +153 -0
  25. package/apps/agents-server/src/app/admin/messages/send-email/emailTestingAccess.ts +30 -0
  26. package/apps/agents-server/src/app/admin/messages/send-email/page.tsx +18 -5
  27. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerClient.tsx +103 -0
  28. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerEditDialog.tsx +232 -0
  29. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerFiltersCard.tsx +195 -0
  30. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerRow.tsx +189 -0
  31. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerSummaryMetrics.tsx +60 -0
  32. package/apps/agents-server/src/app/admin/planned-messages/PlannedMessageManagerTableCard.tsx +147 -0
  33. package/apps/agents-server/src/app/admin/planned-messages/page.tsx +17 -0
  34. package/apps/agents-server/src/app/admin/planned-messages/plannedMessageEditForm.ts +186 -0
  35. package/apps/agents-server/src/app/admin/planned-messages/plannedMessageManagerDialogs.ts +46 -0
  36. package/apps/agents-server/src/app/admin/planned-messages/plannedMessageManagerPresentation.tsx +188 -0
  37. package/apps/agents-server/src/app/admin/planned-messages/resolvePlannedMessageSortValue.ts +115 -0
  38. package/apps/agents-server/src/app/admin/planned-messages/usePlannedMessageManagerData.ts +116 -0
  39. package/apps/agents-server/src/app/admin/planned-messages/usePlannedMessageManagerState.ts +289 -0
  40. package/apps/agents-server/src/app/admin/task-manager/TaskManagerClient.tsx +7 -2
  41. package/apps/agents-server/src/app/admin/task-manager/TaskManagerFiltersCard.tsx +7 -73
  42. package/apps/agents-server/src/app/admin/task-manager/TaskManagerSummaryMetrics.tsx +5 -30
  43. package/apps/agents-server/src/app/admin/task-manager/TaskManagerTaskRow.tsx +2 -0
  44. package/apps/agents-server/src/app/admin/task-manager/[taskId]/TaskManagerTaskDetailClient.tsx +3 -1
  45. package/apps/agents-server/src/app/admin/task-manager/taskManagerTaskPresentation.tsx +23 -0
  46. package/apps/agents-server/src/app/agents/[agentName]/AgentChatWrapper.tsx +8 -9
  47. package/apps/agents-server/src/app/agents/[agentName]/AgentProfileChat.tsx +5 -9
  48. package/apps/agents-server/src/app/agents/[agentName]/api/book/reference-diagnostics/route.ts +30 -7
  49. package/apps/agents-server/src/app/agents/[agentName]/api/book/route.ts +9 -0
  50. package/apps/agents-server/src/app/agents/[agentName]/api/book/test.http +3 -3
  51. package/apps/agents-server/src/app/agents/[agentName]/api/chat/resolveAgentChatRouteContext.ts +3 -4
  52. package/apps/agents-server/src/app/agents/[agentName]/api/timeouts/[timeoutId]/route.ts +10 -153
  53. package/apps/agents-server/src/app/agents/[agentName]/api/timeouts/route.ts +9 -4
  54. package/apps/agents-server/src/app/agents/[agentName]/api/user-chats/[chatId]/route.ts +3 -0
  55. package/apps/agents-server/src/app/agents/[agentName]/api/user-chats/[chatId]/stream/route.ts +2 -0
  56. package/apps/agents-server/src/app/agents/[agentName]/api/user-chats/resolveUserChatScope.ts +8 -1
  57. package/apps/agents-server/src/app/agents/[agentName]/api/user-chats/route.ts +15 -7
  58. package/apps/agents-server/src/app/agents/[agentName]/book/BookEditorMissingReferences.tsx +106 -12
  59. package/apps/agents-server/src/app/agents/[agentName]/book/BookEditorWrapper.tsx +3 -0
  60. package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorDiagnostics.ts +12 -0
  61. package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorSaving.ts +18 -28
  62. package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorWrapper.tsx +2 -0
  63. package/apps/agents-server/src/app/agents/[agentName]/chat/AgentChatHistoryClient.tsx +19 -1
  64. package/apps/agents-server/src/app/agents/[agentName]/chat/AgentChatSidebarDefault.tsx +17 -5
  65. package/apps/agents-server/src/app/agents/[agentName]/chat/AgentGoalChatNotice.tsx +23 -0
  66. package/apps/agents-server/src/app/agents/[agentName]/chat/AgentGoalChatPlannedMessages.tsx +226 -0
  67. package/apps/agents-server/src/app/agents/[agentName]/chat/CanonicalAgentChatPanel.tsx +6 -0
  68. package/apps/agents-server/src/app/agents/[agentName]/chat/CanonicalAgentChatSurface.tsx +32 -12
  69. package/apps/agents-server/src/app/agents/[agentName]/chat/ExternalUserChatAdminActions.tsx +51 -3
  70. package/apps/agents-server/src/app/agents/[agentName]/chat/TeamMemberFrozenChatPrimaryAgentLink.tsx +31 -0
  71. package/apps/agents-server/src/app/agents/[agentName]/chat/page.tsx +2 -20
  72. package/apps/agents-server/src/app/agents/[agentName]/chat/useAgentChatSidebarState.ts +26 -2
  73. package/apps/agents-server/src/app/agents/[agentName]/goal/page.tsx +35 -0
  74. package/apps/agents-server/src/app/agents/[agentName]/page.tsx +2 -1
  75. package/apps/agents-server/src/app/agents/[agentName]/projectReferenceActions.ts +61 -0
  76. package/apps/agents-server/src/app/agents/[agentName]/projectRuntimeActions.ts +97 -0
  77. package/apps/agents-server/src/app/agents/[agentName]/projects/[projectName]/actions.ts +5 -50
  78. package/apps/agents-server/src/app/agents/[agentName]/projects/[projectName]/page.tsx +2 -2
  79. package/apps/agents-server/src/app/api/admin/default-agents/reinstate/route.ts +5 -1
  80. package/apps/agents-server/src/app/api/admin/dns-records/cloudflare/route.ts +26 -16
  81. package/apps/agents-server/src/app/api/admin/planned-messages/[timeoutId]/route.ts +80 -0
  82. package/apps/agents-server/src/app/api/admin/planned-messages/route.ts +19 -0
  83. package/apps/agents-server/src/app/api/emails/incoming/stalwart/route.ts +9 -2
  84. package/apps/agents-server/src/app/api/internal/agent-goal-chat-planned-messages/route.ts +201 -0
  85. package/apps/agents-server/src/app/page.tsx +1 -1
  86. package/apps/agents-server/src/app/superadmin/servers/ServersRegistryTable.tsx +31 -39
  87. package/apps/agents-server/src/app/swagger/SwaggerPageClient.tsx +35 -19
  88. package/apps/agents-server/src/components/AgentNaming/legacyAgentTextTranslations.cs.yaml +7 -0
  89. package/apps/agents-server/src/components/AgentProfile/AgentProfile.tsx +10 -3
  90. package/apps/agents-server/src/components/AgentProjects/AgentProjectIcon.tsx +137 -0
  91. package/apps/agents-server/src/components/AgentProjects/AgentProjectItem.tsx +26 -10
  92. package/apps/agents-server/src/components/AgentProjects/resolveLatestCompletedAgentMessageKey.ts +32 -0
  93. package/apps/agents-server/src/components/AgentProjects/useAgentProjectMarkdownReferences.ts +306 -0
  94. package/apps/agents-server/src/components/CloudflareDnsWizard/CloudflareDnsApiTokenImportStep.tsx +5 -6
  95. package/apps/agents-server/src/components/CloudflareDnsWizard/CloudflareDnsCheckStep.tsx +6 -5
  96. package/apps/agents-server/src/components/CloudflareDnsWizard/CloudflareDnsManualStep.tsx +10 -14
  97. package/apps/agents-server/src/components/CloudflareDnsWizard/CloudflareDnsWizard.tsx +11 -20
  98. package/apps/agents-server/src/components/CloudflareDnsWizard/useCloudflareDnsRecordImport.ts +5 -6
  99. package/apps/agents-server/src/components/DefaultAgents/ReinstateBundledAgentsButton.tsx +7 -0
  100. package/apps/agents-server/src/components/DefaultAgents/coreAgentsAdminRoute.ts +6 -0
  101. package/apps/agents-server/src/components/DnsRecordsInstructions/DnsRecordsInstructions.tsx +91 -57
  102. package/apps/agents-server/src/components/DnsRecordsInstructions/DnsRecordsSectionPanel.tsx +63 -0
  103. package/apps/agents-server/src/components/DnsRecordsInstructions/DnsRecordsSectionVariantTabs.tsx +67 -0
  104. package/apps/agents-server/src/components/DnsRecordsInstructions/DnsRecordsTable.tsx +40 -0
  105. package/apps/agents-server/src/components/Header/buildActiveAgentViewItems.ts +5 -4
  106. package/apps/agents-server/src/components/Header/buildHeaderSystemMenuItems.ts +7 -0
  107. package/apps/agents-server/src/components/Header/createAgentViewLabel.tsx +4 -4
  108. package/apps/agents-server/src/components/Header/resolveActiveAgentNavigation.ts +2 -2
  109. package/apps/agents-server/src/components/Homepage/DefaultAgentsStatusNotice.tsx +1 -7
  110. package/apps/agents-server/src/components/Homepage/useAgentsListImportExportState.ts +22 -10
  111. package/apps/agents-server/src/components/_utils/generateMetaTxt.ts +1 -1
  112. package/apps/agents-server/src/constants/federatedAgentImport.ts +7 -0
  113. package/apps/agents-server/src/database/migratePrefix.ts +13 -12
  114. package/apps/agents-server/src/database/migrations/2026-08-0100-agent-goal-chat-source.sql +10 -0
  115. package/apps/agents-server/src/database/migrations/2026-08-1800-user-chat-timeout-schedule.sql +11 -0
  116. package/apps/agents-server/src/generated/reservedPaths.ts +42 -42
  117. package/apps/agents-server/src/instrumentation-node.ts +18 -0
  118. package/apps/agents-server/src/languages/ServerTranslationKeys.ts +16 -1
  119. package/apps/agents-server/src/languages/translations/czech.yaml +16 -1
  120. package/apps/agents-server/src/languages/translations/english.yaml +16 -1
  121. package/apps/agents-server/src/message-providers/email/stalwart/StalwartMessageProvider.ts +59 -19
  122. package/apps/agents-server/src/message-providers/email/stalwart/parseInboundStalwartEmail.ts +17 -2
  123. package/apps/agents-server/src/middleware/createMiddlewareRequestContext/loadRegisteredServers.ts +8 -0
  124. package/apps/agents-server/src/tools/$provideServer.ts +2 -1
  125. package/apps/agents-server/src/tools/agentGoalChatTimeoutToolFunctions.ts +249 -0
  126. package/apps/agents-server/src/tools/agentGoalChatTimeoutTools.ts +147 -0
  127. package/apps/agents-server/src/tools/createServerChatRuntimeTools.ts +20 -0
  128. package/apps/agents-server/src/tools/getAllToolFunctionsForServer.ts +2 -0
  129. package/apps/agents-server/src/tools/mapRegisteredServerContexts.ts +1 -1
  130. package/apps/agents-server/src/types/swagger-ui-dist.d.ts +5 -0
  131. package/apps/agents-server/src/utils/adminEntityLookups/loadAgentNamesByPermanentId.ts +45 -0
  132. package/apps/agents-server/src/utils/adminEntityLookups/loadUsernamesByUserId.ts +36 -0
  133. package/apps/agents-server/src/utils/adminEntityLookups.ts +2 -0
  134. package/apps/agents-server/src/utils/agentGoalChat/agentGoalChatConstants.ts +14 -0
  135. package/apps/agents-server/src/utils/agentGoalChat/agentGoalChatIdentity.ts +28 -0
  136. package/apps/agents-server/src/utils/agentGoalChat/agentGoalChatPlannedMessageActions.ts +583 -0
  137. package/apps/agents-server/src/utils/agentGoalChat/appendAgentGoalChatNote.ts +43 -0
  138. package/apps/agents-server/src/utils/agentGoalChat/canAccessAgentGoalChat.ts +14 -0
  139. package/apps/agents-server/src/utils/agentGoalChat/createAgentGoalChatNoteContent.ts +129 -0
  140. package/apps/agents-server/src/utils/agentGoalChat/enqueueAgentGoalChatTurn.ts +167 -0
  141. package/apps/agents-server/src/utils/agentGoalChat/ensureAgentGoalChat.ts +66 -0
  142. package/apps/agents-server/src/utils/agentGoalChat/prependAgentGoalChatSummarySeed.ts +40 -0
  143. package/apps/agents-server/src/utils/agentGoalChat/recordAgentGoalChatLifecycleNote.ts +53 -0
  144. package/apps/agents-server/src/utils/agentGoalChat/resolveAgentGoalChatOwnerUserId.ts +104 -0
  145. package/apps/agents-server/src/utils/agentGoalChat/resolveEffectiveAgentGoal.ts +29 -0
  146. package/apps/agents-server/src/utils/agentGoalChat/scheduleAgentGoalChatModifiedNote.ts +85 -0
  147. package/apps/agents-server/src/utils/agentGoalChat.ts +25 -0
  148. package/apps/agents-server/src/utils/agentProjects/AgentProjectInfo.ts +10 -1
  149. package/apps/agents-server/src/utils/agentProjects/AgentProjectReferenceInfo.ts +5 -2
  150. package/apps/agents-server/src/utils/agentProjects/AgentProjectRuntimeActionResult.ts +14 -0
  151. package/apps/agents-server/src/utils/agentProjects/agentProjectFileNames.ts +21 -0
  152. package/apps/agents-server/src/utils/agentProjects/agentProjectHrefs.ts +20 -11
  153. package/apps/agents-server/src/utils/agentProjects/agentProjectIdentity.ts +46 -0
  154. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimeAutostartScheduler.ts +162 -0
  155. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimeDesiredState.ts +252 -0
  156. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimeDisplay.ts +6 -3
  157. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimeDomains.ts +2 -44
  158. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimePaths.ts +25 -0
  159. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimePm2.ts +60 -13
  160. package/apps/agents-server/src/utils/agentProjects/agentProjectRuntimeRegistry.ts +77 -24
  161. package/apps/agents-server/src/utils/agentProjects/agentProjectStateMutationQueue.ts +58 -0
  162. package/apps/agents-server/src/utils/agentProjects/agentProjectsPaths.ts +15 -5
  163. package/apps/agents-server/src/utils/agentProjects/createAgentProjectInitials.ts +36 -0
  164. package/apps/agents-server/src/utils/agentProjects/createAgentProjectMarkdownReferences.ts +124 -19
  165. package/apps/agents-server/src/utils/agentProjects/createAgentProjectsDnsRecordsSection.ts +113 -0
  166. package/apps/agents-server/src/utils/agentProjects/createStaticAgentProjectServer.ts +2 -6
  167. package/apps/agents-server/src/utils/agentProjects/humanizeAgentProjectName.ts +25 -0
  168. package/apps/agents-server/src/utils/agentProjects/listAgentProjectChatReferences.ts +10 -3
  169. package/apps/agents-server/src/utils/agentProjects/listAgentProjectNames.ts +35 -0
  170. package/apps/agents-server/src/utils/agentProjects/listAgentProjects.ts +6 -23
  171. package/apps/agents-server/src/utils/agentProjects/listAllAgentProjectSummaries.ts +2 -1
  172. package/apps/agents-server/src/utils/agentProjects/listAllLocalAgentProjectIdentities.ts +48 -0
  173. package/apps/agents-server/src/utils/agentProjects/parseAgentProjectIndexHtml.ts +167 -0
  174. package/apps/agents-server/src/utils/agentProjects/readAgentProjectIndexHtmlProfile.ts +24 -0
  175. package/apps/agents-server/src/utils/agentProjects/readAgentProjectReadme.ts +3 -53
  176. package/apps/agents-server/src/utils/agentProjects/readAgentProjectRootTextFile.ts +73 -0
  177. package/apps/agents-server/src/utils/agentProjects/resolveAgentChatProjectReferences.ts +25 -0
  178. package/apps/agents-server/src/utils/agentProjects/resolveAgentProjectFaviconRelativePath.ts +108 -0
  179. package/apps/agents-server/src/utils/agentProjects/resolveAgentProjectInfo.ts +12 -3
  180. package/apps/agents-server/src/utils/agentProjects/{resolveAgentProjectReadmeProfile.ts → resolveAgentProjectProfile.ts} +33 -33
  181. package/apps/agents-server/src/utils/agentProjects/resolveAgentProjectPublicUrls.ts +34 -0
  182. package/apps/agents-server/src/utils/agentProjects/resolveAgentProjectRuntimeEnvironmentFlag.ts +23 -0
  183. package/apps/agents-server/src/utils/agentProjects/resolveAgentProjectRuntimeStatus.ts +73 -0
  184. package/apps/agents-server/src/utils/agentProjects/startDefaultAgentProjectRuntimes.ts +110 -0
  185. package/apps/agents-server/src/utils/agentReferenceResolver/AgentReferenceResolutionIssue.ts +1 -69
  186. package/apps/agents-server/src/utils/agentReferenceResolver/MissingCoreAgentRecovery.ts +19 -0
  187. package/apps/agents-server/src/utils/agentReferenceResolver/bookScopedAgentReferences.ts +7 -0
  188. package/apps/agents-server/src/utils/agentReferenceResolver/createAgentInheritanceDiagnostics.ts +457 -0
  189. package/apps/agents-server/src/utils/agentReferenceResolver/createUnresolvedAgentReferenceDiagnostics.ts +27 -0
  190. package/apps/agents-server/src/utils/agentReferenceResolver/extractAgentReferenceTokens.ts +1 -61
  191. package/apps/agents-server/src/utils/agentReferenceResolver/resolveCoreAgentAwareMissingReferences.ts +156 -0
  192. package/apps/agents-server/src/utils/bookLanguageDocumentation/createBookLanguageDocumentationPdfResponse.ts +19 -17
  193. package/apps/agents-server/src/utils/chatMessageChips/createAnsweredMessageChipToolCalls.ts +49 -0
  194. package/apps/agents-server/src/utils/chatMessageChips/createPlannedMessageChipToolCalls.ts +44 -0
  195. package/apps/agents-server/src/utils/chatMessageChips/createTouchedExternalSourceChipToolCalls.ts +39 -0
  196. package/apps/agents-server/src/utils/chatMessageChips/createTouchedProjectChipResult.ts +45 -0
  197. package/apps/agents-server/src/utils/chatMessageChips/createTouchedProjectChipToolCalls.ts +109 -0
  198. package/apps/agents-server/src/utils/chatTasksAdmin.ts +9 -0
  199. package/apps/agents-server/src/utils/createAgentWithDefaultVisibility.ts +8 -0
  200. package/apps/agents-server/src/utils/createWellKnownAgentUrl.ts +17 -0
  201. package/apps/agents-server/src/utils/cronExpression/CronExpression.ts +63 -0
  202. package/apps/agents-server/src/utils/cronExpression/normalizeCronExpression.ts +34 -0
  203. package/apps/agents-server/src/utils/cronExpression/normalizeCronExpressionWhitespace.ts +11 -0
  204. package/apps/agents-server/src/utils/cronExpression/parseCronExpression.ts +41 -0
  205. package/apps/agents-server/src/utils/cronExpression/parseCronExpressionField.ts +140 -0
  206. package/apps/agents-server/src/utils/cronExpression/resolveNextCronRun.ts +100 -0
  207. package/apps/agents-server/src/utils/cronExpression/throwInvalidCronExpressionField.ts +20 -0
  208. package/apps/agents-server/src/utils/cronExpression.ts +10 -0
  209. package/apps/agents-server/src/utils/currentServerRegistryContext.ts +2 -1
  210. package/apps/agents-server/src/utils/customDomainRouting.ts +143 -10
  211. package/apps/agents-server/src/utils/dnsRecords/DnsRecordInstruction.ts +20 -0
  212. package/apps/agents-server/src/utils/dnsRecords/DnsRecordsSection.ts +77 -0
  213. package/apps/agents-server/src/utils/dnsRecords/createServerDnsRecordsSections.ts +58 -0
  214. package/apps/agents-server/src/utils/dnsRecords/createServerDomainDnsRecordsSection.ts +48 -0
  215. package/apps/agents-server/src/utils/dnsRecords/dnsRecordGroups.ts +52 -0
  216. package/apps/agents-server/src/utils/dnsRecords/resolveDnsRecordBatchPlan.ts +47 -1
  217. package/apps/agents-server/src/utils/email/agentEmailAddress.ts +14 -0
  218. package/apps/agents-server/src/utils/email/sendEmailThroughStalwart.ts +2 -1
  219. package/apps/agents-server/src/utils/explicitFromCommitment.ts +1 -0
  220. package/apps/agents-server/src/utils/getAdminChatTasksResponse/getAdminChatTasks/adminChatTaskSqlQuery.ts +41 -36
  221. package/apps/agents-server/src/utils/getAdminChatTasksResponse/getAdminChatTasks/loadAdminChatTaskFallbackData.ts +3 -77
  222. package/apps/agents-server/src/utils/getAdminChatTasksResponse/getAdminChatTasks/mapAdminChatTaskFallbackRows.ts +3 -0
  223. package/apps/agents-server/src/utils/getAdminChatTasksResponse/getAdminChatTasks/mapAdminChatTaskSqlRows.ts +2 -0
  224. package/apps/agents-server/src/utils/getFederatedServers.ts +5 -15
  225. package/apps/agents-server/src/utils/getWellKnownAgentUrl.ts +2 -3
  226. package/apps/agents-server/src/utils/handleChatCompletion/createHandleChatCompletionPromptContext.ts +3 -1
  227. package/apps/agents-server/src/utils/localChatRunner/applyLocalAgentPlannedMessageCommands.ts +261 -0
  228. package/apps/agents-server/src/utils/localChatRunner/parseLocalTeamConversations.ts +281 -0
  229. package/apps/agents-server/src/utils/localChatRunner/persistLocalTeamConversations.ts +71 -0
  230. package/apps/agents-server/src/utils/localChatRunner/prepareLocalAgentPlannedMessagesSidecar.ts +74 -0
  231. package/apps/agents-server/src/utils/localChatRunner/prepareLocalTeamConversationWorkspace.ts +233 -0
  232. package/apps/agents-server/src/utils/localChatRunner/processLocalUserChatJob.ts +154 -27
  233. package/apps/agents-server/src/utils/manGoOnboarding/manGoOnboardingAgentBooks.ts +5 -11
  234. package/apps/agents-server/src/utils/manGoOnboarding/manGoOnboardingAgentRuntime.ts +2 -2
  235. package/apps/agents-server/src/utils/managementApi/managementApiSchemas.ts +2 -2
  236. package/apps/agents-server/src/utils/parseFederatedServers.ts +14 -0
  237. package/apps/agents-server/src/utils/plannedMessageManager/cancelManagedPlannedMessage.ts +35 -0
  238. package/apps/agents-server/src/utils/plannedMessageManager/collectPlannedMessageAgentOptions.ts +56 -0
  239. package/apps/agents-server/src/utils/plannedMessageManager/createPlannedMessageManagerCounters.ts +104 -0
  240. package/apps/agents-server/src/utils/plannedMessageManager/filterPlannedMessages.ts +191 -0
  241. package/apps/agents-server/src/utils/plannedMessageManager/getPlannedMessageManagerResponse.ts +55 -0
  242. package/apps/agents-server/src/utils/plannedMessageManager/isPlannedMessageStillPlanned.ts +18 -0
  243. package/apps/agents-server/src/utils/plannedMessageManager/loadPlannedMessageManagerRecord.ts +32 -0
  244. package/apps/agents-server/src/utils/plannedMessageManager/mapPlannedMessageManagerRecord.ts +73 -0
  245. package/apps/agents-server/src/utils/plannedMessageManager/parsePlannedMessageManagerUpdateRequest.ts +76 -0
  246. package/apps/agents-server/src/utils/plannedMessageManager/resolvePlannedMessageEndReason.ts +59 -0
  247. package/apps/agents-server/src/utils/plannedMessageManager/resolvePlannedMessageLifecycle.ts +99 -0
  248. package/apps/agents-server/src/utils/plannedMessageManager/resolvePlannedMessageRecurrenceKind.ts +40 -0
  249. package/apps/agents-server/src/utils/plannedMessageManager/updateManagedPlannedMessage.ts +121 -0
  250. package/apps/agents-server/src/utils/plannedMessagesAdmin.ts +200 -0
  251. package/apps/agents-server/src/utils/resolveInheritedAgentSource.ts +33 -799
  252. package/apps/agents-server/src/utils/serverManagement/createManagedServer/insertManagedServerRegistryRow.ts +2 -2
  253. package/apps/agents-server/src/utils/serverManagement/createManagedServer/seedServerCoreAgents.ts +7 -6
  254. package/apps/agents-server/src/utils/serverManagement/createManagedServer/seedServerDefaultAgents.ts +5 -4
  255. package/apps/agents-server/src/utils/serverManagement/createManagedServer/seedServerMetadata.ts +3 -2
  256. package/apps/agents-server/src/utils/serverManagement/createManagedServer/seedServerUsers.ts +3 -2
  257. package/apps/agents-server/src/utils/serverManagement/deleteManagedServer.ts +2 -2
  258. package/apps/agents-server/src/utils/serverManagement/getManagedServerById.ts +1 -1
  259. package/apps/agents-server/src/utils/serverManagement/listManagedServers.ts +1 -1
  260. package/apps/agents-server/src/utils/serverRegistry.ts +0 -24
  261. package/apps/agents-server/src/utils/serverRegistryNode.ts +27 -0
  262. package/apps/agents-server/src/utils/stalwart/createEmailDnsRecordsSection.ts +53 -0
  263. package/apps/agents-server/src/utils/userChat/UserChatRecord.ts +13 -0
  264. package/apps/agents-server/src/utils/userChat/UserChatSource.ts +14 -0
  265. package/apps/agents-server/src/utils/userChat/appendQueuedUserChatTurn.ts +9 -2
  266. package/apps/agents-server/src/utils/userChat/createImmediateUserChatAnswerModelRequirements.ts +1 -0
  267. package/apps/agents-server/src/utils/userChat/createRunUserChatJobExecutionContext.ts +2 -5
  268. package/apps/agents-server/src/utils/userChat/createUserChatSummary.ts +10 -2
  269. package/apps/agents-server/src/utils/userChat/finalizeUserChatJob.ts +3 -2
  270. package/apps/agents-server/src/utils/userChat/getUserChat.ts +16 -1
  271. package/apps/agents-server/src/utils/userChat/getUserChatForJobRunner.ts +31 -0
  272. package/apps/agents-server/src/utils/userChat/listUserChats.ts +113 -110
  273. package/apps/agents-server/src/utils/userChat/persistFrozenUserChat.ts +21 -6
  274. package/apps/agents-server/src/utils/userChat/persistUserChatJobTerminalState.ts +5 -0
  275. package/apps/agents-server/src/utils/userChat/resolveUserChatWorkerInternalToken.ts +5 -4
  276. package/apps/agents-server/src/utils/userChat/runImmediateUserChatAnswer.ts +2 -6
  277. package/apps/agents-server/src/utils/userChat/runUserChatJob.ts +2 -6
  278. package/apps/agents-server/src/utils/userChat/teamMemberUserChatContext.ts +63 -0
  279. package/apps/agents-server/src/utils/userChat/userChatJobRunReport.ts +30 -0
  280. package/apps/agents-server/src/utils/userChat/userChatMessageLifecycle.ts +6 -1
  281. package/apps/agents-server/src/utils/userChat.ts +5 -1
  282. package/apps/agents-server/src/utils/userChatClient/cancelAgentUserTimeout.ts +2 -2
  283. package/apps/agents-server/src/utils/userChatClient/fetchAgentUserTimeouts.ts +2 -2
  284. package/apps/agents-server/src/utils/userChatClient.ts +13 -31
  285. package/apps/agents-server/src/utils/userChatTimeout/UserChatTimeoutRecord.ts +47 -3
  286. package/apps/agents-server/src/utils/userChatTimeout/agentScopedTimeoutBulkActions.ts +11 -17
  287. package/apps/agents-server/src/utils/userChatTimeout/createTimeoutWakeUpMessage.ts +38 -6
  288. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/PlannedMessageSchedule.ts +52 -0
  289. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/hasPlannedMessageRecurrence.ts +13 -0
  290. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/isPlannedMessageScheduleFinished.ts +30 -0
  291. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/normalizePlannedMessageScheduleValues.ts +62 -0
  292. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/parsePlannedMessageSchedule.ts +202 -0
  293. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule/resolvePlannedMessageDueAt.ts +121 -0
  294. package/apps/agents-server/src/utils/userChatTimeout/plannedMessageSchedule.ts +12 -0
  295. package/apps/agents-server/src/utils/userChatTimeout/setAgentScopedUserChatTimeoutPausedState.ts +66 -0
  296. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/claimNextDueUserChatTimeout.ts +28 -25
  297. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/createUserChatTimeout.ts +76 -5
  298. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/getAgentScopedUserChatTimeout.ts +8 -4
  299. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/listAgentUserChatTimeouts.ts +4 -1
  300. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/listAllUserChatTimeouts.ts +37 -0
  301. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/mapUserChatTimeoutRow.ts +9 -0
  302. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/recoverExpiredRunningUserChatTimeouts.ts +3 -2
  303. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/repeatFiredUserChatTimeout.ts +84 -0
  304. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore/updateAgentScopedUserChatTimeout.ts +39 -6
  305. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutStore.ts +2 -0
  306. package/apps/agents-server/src/utils/userChatTimeout/userChatTimeoutWorker.ts +220 -57
  307. package/apps/agents-server/src/utils/userChatTimeout.ts +16 -0
  308. package/apps/agents-server/src/utils/vpsSelfUpdate/vpsSelfUpdateCron.ts +23 -316
  309. package/apps/agents-server/tests/e2e/support/AgentManagementApi.ts +3 -3
  310. package/esm/apps/agents-server/src/constants/federatedAgentImport.d.ts +6 -0
  311. package/esm/index.es.js +14405 -7058
  312. package/esm/index.es.js.map +1 -1
  313. package/esm/scripts/run-agent-messages/git/commitAgentProjectChanges.d.ts +15 -0
  314. package/esm/scripts/run-agent-messages/git/commitAnsweredMessageProjectChanges.d.ts +24 -0
  315. package/esm/scripts/run-agent-messages/git/ensureAgentProjectGitRepository.d.ts +20 -0
  316. package/esm/scripts/run-agent-messages/git/readAgentProjectCommitChange.d.ts +11 -0
  317. package/esm/scripts/run-agent-messages/git/runAgentProjectGitCommand.d.ts +29 -0
  318. package/esm/scripts/run-agent-messages/messages/buildAgentGoalChatPromptSection.d.ts +26 -0
  319. package/esm/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts +12 -1
  320. package/esm/scripts/run-agent-messages/messages/buildAgentProjectsPromptSection.d.ts +2 -14
  321. package/esm/scripts/run-agent-messages/messages/buildAgentTeamPromptSection.d.ts +12 -0
  322. package/esm/scripts/run-agent-messages/messages/createAgentRunnerSystemMessage.d.ts +2 -1
  323. package/esm/scripts/run-agent-messages/messages/finalizeAgentTeamConversationWorkspace.d.ts +16 -0
  324. package/esm/scripts/run-agent-messages/messages/listAgentProjectDirectoryNames.d.ts +7 -0
  325. package/esm/scripts/run-agent-messages/messages/loadAgentPlannedMessagesSidecar.d.ts +10 -0
  326. package/esm/scripts/run-agent-messages/messages/loadAgentTeamConversationWorkspace.d.ts +6 -0
  327. package/esm/scripts/run-agent-messages/messages/resolveAnsweredMessageTouches.d.ts +29 -0
  328. package/esm/scripts/run-codex-prompts/common/CoderRunControlFeedback.d.ts +54 -0
  329. package/esm/scripts/run-codex-prompts/common/applyCoderRunControlKey.d.ts +14 -0
  330. package/esm/scripts/run-codex-prompts/common/buildCoderRunControlKeyBadge.d.ts +7 -0
  331. package/esm/scripts/run-codex-prompts/common/createCoderRunStepTracker.d.ts +48 -0
  332. package/esm/scripts/run-codex-prompts/common/createFreeDiskSpaceGuard.d.ts +25 -0
  333. package/esm/scripts/run-codex-prompts/common/formatCoderRunControlFeedback.d.ts +13 -0
  334. package/esm/scripts/run-codex-prompts/common/formatUnknownErrorDetails.d.ts +4 -0
  335. package/esm/scripts/run-codex-prompts/common/listenForCoderRunControls.d.ts +17 -0
  336. package/esm/scripts/run-codex-prompts/common/normalizeLineEndingsInChangedFiles.d.ts +2 -3
  337. package/esm/scripts/run-codex-prompts/common/resolveCoderAgent.d.ts +32 -3
  338. package/esm/scripts/run-codex-prompts/common/runGoScript/$spawnLoggedBashScript.d.ts +25 -0
  339. package/esm/scripts/run-codex-prompts/common/runGoScript/$terminateLoggedBashProcessTree.d.ts +11 -0
  340. package/esm/scripts/run-codex-prompts/common/runGoScript/createScriptOutputLineReader.d.ts +22 -0
  341. package/esm/scripts/run-codex-prompts/common/runGoScript/scriptExecutionLog.d.ts +4 -0
  342. package/esm/scripts/run-codex-prompts/common/waitForPause.d.ts +0 -8
  343. package/esm/scripts/run-codex-prompts/common/waitForSkippableWorldTimeDeadline.d.ts +15 -0
  344. package/esm/scripts/run-codex-prompts/git/coderCommitScope.d.ts +31 -0
  345. package/esm/scripts/run-codex-prompts/git/coderGitSync.d.ts +15 -2
  346. package/esm/scripts/run-codex-prompts/git/commitChanges.d.ts +9 -3
  347. package/esm/scripts/run-codex-prompts/git/commitInitializedAgentBooks.d.ts +5 -0
  348. package/esm/scripts/run-codex-prompts/git/workingTreeChanges.d.ts +40 -0
  349. package/esm/scripts/run-codex-prompts/main/listCoderPrompts.d.ts +20 -0
  350. package/esm/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts +5 -8
  351. package/esm/scripts/run-codex-prompts/main/runPromptRound.d.ts +2 -4
  352. package/esm/scripts/run-codex-prompts/ping/pingCoderHarnessPeriodically.d.ts +22 -0
  353. package/esm/scripts/run-codex-prompts/prompts/buildPromptLabel.d.ts +6 -0
  354. package/esm/scripts/run-codex-prompts/prompts/buildPromptRunTraceContent.d.ts +65 -0
  355. package/esm/scripts/run-codex-prompts/prompts/buildPromptRunTracePath.d.ts +10 -0
  356. package/esm/scripts/run-codex-prompts/prompts/buildPromptStatusDetails.d.ts +39 -0
  357. package/esm/scripts/run-codex-prompts/prompts/findFirstNonEmptyLineIndex.d.ts +6 -0
  358. package/esm/scripts/run-codex-prompts/prompts/formatCoderRunSteps.d.ts +6 -3
  359. package/esm/scripts/run-codex-prompts/prompts/formatRunnerSignature.d.ts +14 -1
  360. package/esm/scripts/run-codex-prompts/prompts/isPromptCompatibleWithRunner.d.ts +11 -6
  361. package/esm/scripts/run-codex-prompts/prompts/isPromptSectionUnfinished.d.ts +8 -0
  362. package/esm/scripts/run-codex-prompts/prompts/listPromptsByStatus.d.ts +7 -0
  363. package/esm/scripts/run-codex-prompts/prompts/loadPromptFiles.d.ts +1 -1
  364. package/esm/scripts/run-codex-prompts/prompts/markPromptDone.d.ts +15 -4
  365. package/esm/scripts/run-codex-prompts/prompts/markPromptFailed.d.ts +28 -1
  366. package/esm/scripts/run-codex-prompts/prompts/markPromptInProgress.d.ts +27 -0
  367. package/esm/scripts/run-codex-prompts/prompts/promptRunnerAttribution.d.ts +30 -0
  368. package/esm/scripts/run-codex-prompts/prompts/resolveInterruptedPrompt.d.ts +9 -0
  369. package/esm/scripts/run-codex-prompts/prompts/resolvePromptStatusLine.d.ts +19 -0
  370. package/esm/scripts/run-codex-prompts/prompts/writePromptRunTrace.d.ts +19 -0
  371. package/esm/scripts/run-codex-prompts/prompts/writePromptStatusLine.d.ts +10 -0
  372. package/esm/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeRunner.d.ts +25 -0
  373. package/esm/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeOutputEvents.d.ts +3 -0
  374. package/esm/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeSubscriptionUsage.d.ts +11 -0
  375. package/esm/scripts/run-codex-prompts/runners/common/buildHarnessAuthenticationError.d.ts +20 -0
  376. package/esm/scripts/run-codex-prompts/runners/common/createAuthenticationAwarePromptRunner.d.ts +11 -0
  377. package/esm/scripts/run-codex-prompts/runners/common/estimateUsageFromTextLength.d.ts +33 -0
  378. package/esm/scripts/run-codex-prompts/runners/common/extractHarnessAuthenticationFailureReason.d.ts +9 -0
  379. package/esm/scripts/run-codex-prompts/runners/common/modelPricing.d.ts +41 -0
  380. package/esm/scripts/run-codex-prompts/runners/gemini/GeminiRunner.d.ts +1 -1
  381. package/esm/scripts/run-codex-prompts/runners/gemini/gemini-pricing.d.ts +5 -18
  382. package/esm/scripts/run-codex-prompts/runners/openai-codex/OpenAiCodexRunner.d.ts +8 -0
  383. package/esm/scripts/run-codex-prompts/runners/openai-codex/buildCodexUsageFromOutput.d.ts +4 -1
  384. package/esm/scripts/run-codex-prompts/runners/openai-codex/getCodexSubscriptionUsage.d.ts +19 -0
  385. package/esm/scripts/run-codex-prompts/runners/qwen-code/QwenCodeRunner.d.ts +23 -0
  386. package/esm/scripts/run-codex-prompts/runners/qwen-code/buildQwenCodeScript.d.ts +8 -0
  387. package/esm/scripts/run-codex-prompts/runners/qwen-code/parseQwenCodeUsageFromOutput.d.ts +9 -0
  388. package/esm/scripts/run-codex-prompts/runners/qwen-code/qwen-code-pricing.d.ts +30 -0
  389. package/esm/scripts/run-codex-prompts/runners/types/HarnessSubscriptionUsage.d.ts +43 -0
  390. package/esm/scripts/run-codex-prompts/server/buildCoderServerPromptResponse.d.ts +1 -1
  391. package/esm/scripts/run-codex-prompts/server/coderServerHtml.d.ts +1 -1
  392. package/esm/scripts/run-codex-prompts/server/updatePromptSection.d.ts +1 -1
  393. package/esm/scripts/run-codex-prompts/testing/runPromptWithTestFeedback.d.ts +6 -0
  394. package/esm/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts +21 -1
  395. package/esm/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts +5 -5
  396. package/esm/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts +11 -1
  397. package/esm/scripts/run-codex-prompts/ui/buildCoderRunUiTerminalFrameUpdate.d.ts +27 -0
  398. package/esm/scripts/run-codex-prompts/ui/buildRunUiFrameShared.d.ts +11 -0
  399. package/esm/scripts/run-codex-prompts/ui/buildSubscriptionUsageSessionRows.d.ts +11 -0
  400. package/esm/scripts/run-codex-prompts/ui/refreshCoderRunUiSubscriptionUsage.d.ts +14 -0
  401. package/esm/scripts/run-codex-prompts/ui/startCoderRunUiSubscriptionUsageRefresh.d.ts +37 -0
  402. package/esm/scripts/utils/emojiTags/validSinglePictogramEmojis.d.ts +17 -0
  403. package/esm/scripts/verify-prompts/$orderPromptFiles.d.ts +9 -0
  404. package/esm/scripts/verify-prompts/VerifyPromptsOrder.d.ts +26 -0
  405. package/esm/scripts/verify-prompts/verify-prompts.d.ts +3 -2
  406. package/esm/src/_packages/components.index.d.ts +4 -0
  407. package/esm/src/_packages/types.index.d.ts +4 -0
  408. package/esm/src/avatars/renderAvatarVisualTerminalText.d.ts +80 -0
  409. package/esm/src/avatars/types/AvatarVisualDefinition.d.ts +54 -0
  410. package/esm/src/book-2.0/agent-source/AgentReferenceResolutionIssue.d.ts +45 -0
  411. package/esm/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -0
  412. package/esm/src/book-2.0/agent-source/ParsedUnknownCommitment.d.ts +26 -0
  413. package/esm/src/book-2.0/agent-source/deduplicateSystemMessage.d.ts +14 -0
  414. package/esm/src/book-2.0/agent-source/explicitFromCommitment.d.ts +62 -0
  415. package/esm/src/book-2.0/agent-source/extractAgentReferenceTokens.d.ts +32 -0
  416. package/esm/src/book-2.0/agent-source/getBookCommitmentLineType.d.ts +19 -0
  417. package/esm/src/book-2.0/agent-source/parseAgentSourceWithCommitments.unknown.test.d.ts +1 -0
  418. package/esm/src/book-2.0/agent-source/resolveInheritedAgentSource.d.ts +73 -0
  419. package/esm/src/book-2.0/book-language-documentation/getSafeCodeBlock.d.ts +1 -1
  420. package/esm/src/book-3.0/AgentMessageRunReport.d.ts +46 -0
  421. package/esm/src/book-3.0/AgentPlannedMessagesSidecar.d.ts +127 -0
  422. package/esm/src/book-3.0/AgentPlannedMessagesSidecar.test.d.ts +1 -0
  423. package/esm/src/book-3.0/AgentTeamConversationWorkspace.d.ts +85 -0
  424. package/esm/src/book-3.0/cliAgentEnv.d.ts +3 -3
  425. package/esm/src/book-3.0/createAgentMessageSidecarBaseName.d.ts +13 -0
  426. package/esm/src/book-3.0/describeAgentPlannedMessageSchedule.d.ts +31 -0
  427. package/esm/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +1 -9
  428. package/esm/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.d.ts +28 -0
  429. package/esm/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.test.d.ts +1 -0
  430. package/esm/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.d.ts +28 -0
  431. package/esm/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.test.d.ts +1 -0
  432. package/esm/src/book-components/Chat/Chat/ChatProps.d.ts +3 -2
  433. package/esm/src/book-components/Chat/Chat/renderAgentProjectDiff.d.ts +13 -0
  434. package/esm/src/book-components/Chat/Chat/renderAgentProjectToolCallDetails.d.ts +16 -0
  435. package/esm/src/book-components/Chat/MockedChat/MockedChat.test.d.ts +2 -0
  436. package/esm/src/book-components/Chat/utils/agentProjectToolCall.d.ts +85 -0
  437. package/esm/src/book-components/Chat/utils/agentProjectToolCall.test.d.ts +1 -0
  438. package/esm/src/book-components/Chat/utils/externalSourceToolCall.d.ts +38 -0
  439. package/esm/src/book-components/Chat/utils/renderMarkdown.d.ts +68 -3
  440. package/esm/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts +30 -0
  441. package/esm/src/cli/$initializePromptbookCliProgram.d.ts +8 -0
  442. package/esm/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.d.ts +10 -0
  443. package/esm/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.test.d.ts +1 -0
  444. package/esm/src/cli/cli-commands/coder/GitChangesMode.d.ts +28 -0
  445. package/esm/src/cli/cli-commands/coder/agentCliOptions.d.ts +21 -0
  446. package/esm/src/cli/cli-commands/coder/boilerplateCount.d.ts +1 -1
  447. package/esm/src/cli/cli-commands/coder/boilerplateTemplates.d.ts +8 -21
  448. package/esm/src/cli/cli-commands/coder/coderReferencedArtifacts.d.ts +33 -0
  449. package/esm/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts +14 -1
  450. package/esm/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.d.ts +4 -2
  451. package/esm/src/cli/cli-commands/coder/ensureCoderVscodeSettingsFile.d.ts +2 -0
  452. package/esm/src/cli/cli-commands/coder/ensureDirectory.d.ts +6 -0
  453. package/esm/src/cli/cli-commands/coder/generate-boilerplates.d.ts +1 -1
  454. package/esm/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.d.ts +6 -0
  455. package/esm/src/cli/cli-commands/coder/init.test.d.ts +1 -0
  456. package/esm/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +8 -5
  457. package/esm/src/cli/cli-commands/coder/list.d.ts +10 -0
  458. package/esm/src/cli/cli-commands/coder/list.test.d.ts +1 -0
  459. package/esm/src/cli/cli-commands/coder/mergeStringRecordJsonFile.d.ts +19 -1
  460. package/esm/src/cli/cli-commands/coder/printCoderRunFailure.d.ts +6 -0
  461. package/esm/src/cli/cli-commands/coder/server.test.d.ts +1 -0
  462. package/esm/src/cli/cli-commands/coder/verify.d.ts +1 -1
  463. package/esm/src/cli/cli-commands/coder/waitOptions.d.ts +12 -0
  464. package/esm/src/cli/cli-commands/coder.d.ts +1 -0
  465. package/esm/src/cli/cli-commands/common/$askForConfirmation.d.ts +11 -0
  466. package/esm/src/cli/cli-commands/common/$askForConfirmation.test.d.ts +1 -0
  467. package/esm/src/cli/cli-commands/common/LocalAgentBookCollection.d.ts +46 -0
  468. package/esm/src/cli/cli-commands/common/createLocalAgentReferenceResolver.d.ts +8 -0
  469. package/esm/src/cli/cli-commands/common/disk-space/$assertSufficientFreeDiskSpace.d.ts +12 -0
  470. package/esm/src/cli/cli-commands/common/disk-space/$assertSufficientFreeDiskSpace.test.d.ts +1 -0
  471. package/esm/src/cli/cli-commands/common/disk-space/$readFreeDiskSpaceStatus.d.ts +11 -0
  472. package/esm/src/cli/cli-commands/common/disk-space/$readFreeDiskSpaceStatus.test.d.ts +1 -0
  473. package/esm/src/cli/cli-commands/common/disk-space/FreeDiskSpaceStatus.d.ts +33 -0
  474. package/esm/src/cli/cli-commands/common/disk-space/formatFreeDiskSpaceBytes.d.ts +6 -0
  475. package/esm/src/cli/cli-commands/common/disk-space/formatFreeDiskSpaceBytes.test.d.ts +1 -0
  476. package/esm/src/cli/cli-commands/common/disk-space/formatLowFreeDiskSpaceWarning.d.ts +10 -0
  477. package/esm/src/cli/cli-commands/common/disk-space/freeDiskSpaceConstants.d.ts +28 -0
  478. package/esm/src/cli/cli-commands/common/disk-space/resolveFreeDiskSpaceLevel.d.ts +7 -0
  479. package/esm/src/cli/cli-commands/common/disk-space/resolveFreeDiskSpaceLevel.test.d.ts +1 -0
  480. package/esm/src/cli/cli-commands/common/ensureAdamAgentBook.d.ts +12 -0
  481. package/esm/src/cli/cli-commands/common/harness/$applyHarnessInstallationStatus.d.ts +3 -2
  482. package/esm/src/cli/cli-commands/common/harness/$checkHarnessInstallation.d.ts +3 -3
  483. package/esm/src/cli/cli-commands/common/harness/$checkHarnessInstallation.test.d.ts +1 -0
  484. package/esm/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.d.ts +4 -3
  485. package/esm/src/cli/cli-commands/common/harness/$resolveHarnessCommandPath.d.ts +14 -0
  486. package/esm/src/cli/cli-commands/common/harness/$resolveHarnessInstallationOrigin.d.ts +10 -0
  487. package/esm/src/cli/cli-commands/common/harness/$runHarnessInstallationCommand.d.ts +43 -0
  488. package/esm/src/cli/cli-commands/common/harness/HARNESS_DEFAULT_MODELS.d.ts +25 -0
  489. package/esm/src/cli/cli-commands/common/harness/HarnessDefinition.d.ts +62 -0
  490. package/esm/src/cli/cli-commands/common/harness/HarnessInstallationOrigin.d.ts +36 -0
  491. package/esm/src/cli/cli-commands/common/harness/HarnessInstallationStatus.d.ts +8 -2
  492. package/esm/src/cli/cli-commands/common/harness/HarnessUpdatePlan.d.ts +23 -0
  493. package/esm/src/cli/cli-commands/common/harness/buildHarnessInstallCommand.d.ts +4 -1
  494. package/esm/src/cli/cli-commands/common/harness/formatHarnessManualUpdateInstruction.d.ts +8 -0
  495. package/esm/src/cli/cli-commands/common/harness/formatHarnessManualUpdateInstruction.test.d.ts +1 -0
  496. package/esm/src/cli/cli-commands/common/harness/resolveHarnessInstallationMethodFromPaths.d.ts +31 -0
  497. package/esm/src/cli/cli-commands/common/harness/resolveHarnessInstallationMethodFromPaths.test.d.ts +1 -0
  498. package/esm/src/cli/cli-commands/common/harness/resolveHarnessUpdatePlan.d.ts +12 -0
  499. package/esm/src/cli/cli-commands/common/harness/resolveHarnessUpdatePlan.test.d.ts +1 -0
  500. package/esm/src/cli/cli-commands/common/npm/$askForNpmPackageInstallationApproval.d.ts +11 -0
  501. package/{umd/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts → esm/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.d.ts} +2 -3
  502. package/esm/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.test.d.ts +1 -0
  503. package/esm/src/cli/cli-commands/common/npm/$resolveNpmGlobalPrefixPath.d.ts +9 -0
  504. package/esm/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.d.ts +12 -0
  505. package/esm/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.test.d.ts +1 -0
  506. package/esm/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.d.ts +12 -0
  507. package/esm/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.test.d.ts +1 -0
  508. package/esm/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.d.ts +12 -0
  509. package/esm/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.test.d.ts +1 -0
  510. package/esm/src/cli/cli-commands/common/projectInitialization.d.ts +6 -0
  511. package/esm/src/cli/cli-commands/common/promptPriorityCliOptions.d.ts +7 -0
  512. package/esm/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +17 -4
  513. package/esm/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts +9 -0
  514. package/esm/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.test.d.ts +1 -0
  515. package/esm/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts +15 -0
  516. package/esm/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.test.d.ts +1 -0
  517. package/esm/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts +12 -0
  518. package/esm/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.test.d.ts +1 -0
  519. package/esm/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts +10 -0
  520. package/esm/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.test.d.ts +1 -0
  521. package/esm/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.d.ts +66 -0
  522. package/esm/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.d.ts +26 -0
  523. package/esm/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.d.ts +7 -0
  524. package/esm/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.d.ts +7 -0
  525. package/esm/src/cli/cli-commands/common/questionsCliOptions.d.ts +45 -0
  526. package/esm/src/cli/cli-commands/common/questionsCliOptions.test.d.ts +1 -0
  527. package/esm/src/cli/cli-commands/common/resolveBundledAgentBookPath.d.ts +6 -0
  528. package/esm/src/cli/cli-commands/common/resolveLocalAgentSource.d.ts +19 -0
  529. package/esm/src/cli/common/$deprecateCliCommand.d.ts +3 -0
  530. package/esm/src/cli/common/$hideCliCommandFromHelp.d.ts +11 -0
  531. package/esm/src/cli/common/$hideCliCommandFromHelp.test.d.ts +1 -0
  532. package/esm/src/cli/common/$requireCliSubcommand.d.ts +18 -0
  533. package/esm/src/cli/common/$requireCliSubcommand.test.d.ts +1 -0
  534. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +15 -0
  535. package/esm/src/commitments/WRITING_RULES/WRITING_RULES.d.ts +14 -7
  536. package/esm/src/commitments/index.d.ts +1 -1
  537. package/esm/src/executables/platforms/locateAppOnWindows.d.ts +1 -1
  538. package/esm/src/executables/platforms/locateAppOnWindows.test.d.ts +1 -0
  539. package/esm/src/llm-providers/vercel/VercelExecutionToolsOptions.d.ts +5 -2
  540. package/esm/src/utils/agent-message-runtime/AgentMessageProjectChange.d.ts +76 -0
  541. package/esm/src/utils/agent-message-runtime/AgentMessageTouchedExternalSource.d.ts +45 -0
  542. package/esm/src/utils/agent-message-runtime/parseAgentMessageRuntimeLogEvents.d.ts +62 -0
  543. package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts +3 -3
  544. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.d.ts +18 -0
  545. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.test.d.ts +1 -0
  546. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.d.ts +19 -0
  547. package/esm/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.test.d.ts +1 -0
  548. package/esm/src/utils/agents/terminalAgentAvatarVisual.d.ts +5 -2
  549. package/esm/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts +6 -0
  550. package/esm/src/utils/ascii-art/createAnsiColorCode.d.ts +46 -0
  551. package/esm/src/utils/files/findFilesByGlob.d.ts +28 -0
  552. package/esm/src/utils/misc/debounce.d.ts +4 -2
  553. package/esm/src/utils/misc/debounce.test.d.ts +1 -0
  554. package/esm/src/utils/misc/emojis.d.ts +3 -2
  555. package/esm/src/utils/random/$generateBookBoilerplate.test.d.ts +1 -0
  556. package/esm/src/version.d.ts +1 -1
  557. package/package.json +21 -27
  558. package/src/_packages/components.index.ts +4 -0
  559. package/src/_packages/types.index.ts +4 -0
  560. package/src/avatars/renderAvatarVisualTerminalText.ts +249 -0
  561. package/src/avatars/types/AvatarVisualDefinition.ts +60 -0
  562. package/src/avatars/visuals/asciiOctopusAvatarVisual.ts +144 -22
  563. package/src/book-2.0/agent-source/AgentReferenceResolutionIssue.ts +75 -0
  564. package/src/book-2.0/agent-source/AgentSourceParseResult.ts +6 -0
  565. package/src/book-2.0/agent-source/ParsedUnknownCommitment.ts +29 -0
  566. package/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/augmentAgentModelRequirementsFromSource.ts +38 -1
  567. package/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.ts +3 -2
  568. package/src/book-2.0/agent-source/deduplicateSystemMessage.ts +327 -0
  569. package/src/book-2.0/agent-source/explicitFromCommitment.ts +132 -0
  570. package/src/book-2.0/agent-source/extractAgentReferenceTokens.ts +65 -0
  571. package/src/book-2.0/agent-source/getBookCommitmentLineType.ts +36 -0
  572. package/src/book-2.0/agent-source/parseAgentSourceWithCommitments.ts +128 -61
  573. package/src/book-2.0/agent-source/resolveInheritedAgentSource.ts +841 -0
  574. package/src/book-2.0/agent-source/string_book.ts +1 -1
  575. package/src/book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown.ts +5 -4
  576. package/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.ts +6 -1
  577. package/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.ts +6 -1
  578. package/src/book-2.0/book-language-documentation/getSafeCodeBlock.ts +1 -1
  579. package/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.ts +1 -4
  580. package/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.ts +4 -17
  581. package/src/book-3.0/AgentMessageRunReport.ts +135 -0
  582. package/src/book-3.0/AgentPlannedMessagesSidecar.ts +284 -0
  583. package/src/book-3.0/AgentTeamConversationWorkspace.ts +170 -0
  584. package/src/book-3.0/cliAgentEnv.ts +3 -2
  585. package/src/book-3.0/createAgentMessageSidecarBaseName.ts +20 -0
  586. package/src/book-3.0/describeAgentPlannedMessageSchedule.ts +94 -0
  587. package/src/book-components/BookEditor/BookEditorMonaco.tsx +8 -1
  588. package/src/book-components/BookEditor/BookEditorMonacoTokenization.ts +3 -1
  589. package/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.ts +3 -11
  590. package/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.ts +71 -0
  591. package/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.ts +50 -0
  592. package/src/book-components/BookEditor/useBookEditorMonacoStyles.ts +56 -55
  593. package/src/book-components/Chat/Chat/Chat.module.css +172 -27
  594. package/src/book-components/Chat/Chat/ChatMessageMap.tsx +7 -4
  595. package/src/book-components/Chat/Chat/ChatProps.tsx +3 -2
  596. package/src/book-components/Chat/Chat/renderAgentProjectDiff.tsx +85 -0
  597. package/src/book-components/Chat/Chat/renderAgentProjectToolCallDetails.tsx +206 -0
  598. package/src/book-components/Chat/Chat/renderToolCallDetails.tsx +9 -12
  599. package/src/book-components/Chat/MarkdownContent/MarkdownContent.module.css +85 -17
  600. package/src/book-components/Chat/MarkdownContent/MarkdownContent.tsx +115 -2
  601. package/src/book-components/Chat/MockedChat/MockedChat.tsx +25 -1
  602. package/src/book-components/Chat/save/react/exports/chat-preview-2025-10-13 (1).jsx +95 -5
  603. package/src/book-components/Chat/utils/agentProjectToolCall.ts +151 -0
  604. package/src/book-components/Chat/utils/externalSourceToolCall.ts +65 -0
  605. package/src/book-components/Chat/utils/getToolCallChipletInfo.ts +64 -0
  606. package/src/book-components/Chat/utils/renderMarkdown.ts +658 -96
  607. package/src/book-components/Chat/utils/timeoutToolCallPresentation.ts +34 -3
  608. package/src/cli/$initializePromptbookCliProgram.ts +87 -0
  609. package/src/cli/cli-commands/agent-folder.ts +2 -6
  610. package/src/cli/cli-commands/agent.ts +2 -6
  611. package/src/cli/cli-commands/agents-server/startAgentsServer/createLocalAgentRunOptions.ts +1 -1
  612. package/src/cli/cli-commands/agents-server.ts +2 -6
  613. package/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.ts +54 -0
  614. package/src/cli/cli-commands/coder/GitChangesMode.ts +35 -0
  615. package/src/cli/cli-commands/coder/add.ts +30 -5
  616. package/src/cli/cli-commands/coder/agentCliOptions.ts +32 -0
  617. package/src/cli/cli-commands/coder/boilerplateCount.ts +1 -1
  618. package/src/cli/cli-commands/coder/boilerplateTemplates.ts +20 -59
  619. package/src/cli/cli-commands/coder/coderReferencedArtifacts.ts +106 -0
  620. package/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.ts +2 -28
  621. package/src/cli/cli-commands/coder/ensureCoderGitignoreFile.ts +37 -3
  622. package/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.ts +4 -2
  623. package/src/cli/cli-commands/coder/ensureCoderVscodeSettingsFile.ts +5 -1
  624. package/src/cli/cli-commands/coder/ensureDirectory.ts +27 -1
  625. package/src/cli/cli-commands/coder/generate-boilerplates.ts +27 -27
  626. package/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.ts +99 -9
  627. package/src/cli/cli-commands/coder/init.ts +31 -11
  628. package/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.ts +23 -27
  629. package/src/cli/cli-commands/coder/list.ts +91 -0
  630. package/src/cli/cli-commands/coder/mergeStringRecordJsonFile.ts +31 -7
  631. package/src/cli/cli-commands/coder/ping.ts +60 -19
  632. package/src/cli/cli-commands/coder/printCoderRunFailure.ts +14 -0
  633. package/src/cli/cli-commands/coder/printInitializationSummary.ts +29 -16
  634. package/src/cli/cli-commands/coder/run.ts +53 -31
  635. package/src/cli/cli-commands/coder/server.ts +49 -39
  636. package/src/cli/cli-commands/coder/verify.ts +29 -5
  637. package/src/cli/cli-commands/coder/waitOptions.ts +33 -0
  638. package/src/cli/cli-commands/coder.ts +6 -6
  639. package/src/cli/cli-commands/common/$askForConfirmation.ts +41 -0
  640. package/src/cli/cli-commands/common/LocalAgentBookCollection.ts +220 -0
  641. package/src/cli/cli-commands/common/coderGitSyncCliOptions.ts +6 -2
  642. package/src/cli/cli-commands/common/createLocalAgentReferenceResolver.ts +62 -0
  643. package/src/cli/cli-commands/common/disk-space/$assertSufficientFreeDiskSpace.ts +35 -0
  644. package/src/cli/cli-commands/common/disk-space/$readFreeDiskSpaceStatus.ts +37 -0
  645. package/src/cli/cli-commands/common/disk-space/FreeDiskSpaceStatus.ts +39 -0
  646. package/src/cli/cli-commands/common/disk-space/formatFreeDiskSpaceBytes.ts +26 -0
  647. package/src/cli/cli-commands/common/disk-space/formatLowFreeDiskSpaceWarning.ts +33 -0
  648. package/src/cli/cli-commands/common/disk-space/freeDiskSpaceConstants.ts +33 -0
  649. package/src/cli/cli-commands/common/disk-space/resolveFreeDiskSpaceLevel.ts +21 -0
  650. package/src/cli/cli-commands/common/ensureAdamAgentBook.ts +40 -0
  651. package/src/cli/cli-commands/common/harness/$applyHarnessInstallationStatus.ts +79 -11
  652. package/src/cli/cli-commands/common/harness/$checkHarnessInstallation.ts +32 -9
  653. package/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.ts +12 -4
  654. package/src/cli/cli-commands/common/harness/$resolveHarnessCommandPath.ts +46 -0
  655. package/src/cli/cli-commands/common/harness/$resolveHarnessInstallationOrigin.ts +36 -0
  656. package/src/cli/cli-commands/common/harness/$resolveInstalledHarnessVersion.ts +2 -2
  657. package/src/cli/cli-commands/common/harness/$runHarnessInstallationCommand.ts +100 -0
  658. package/src/cli/cli-commands/common/harness/HARNESS_DEFAULT_MODELS.ts +37 -0
  659. package/src/cli/cli-commands/common/harness/HarnessDefinition.ts +101 -0
  660. package/src/cli/cli-commands/common/harness/HarnessInstallationOrigin.ts +44 -0
  661. package/src/cli/cli-commands/common/harness/HarnessInstallationStatus.ts +9 -2
  662. package/src/cli/cli-commands/common/harness/HarnessUpdatePlan.ts +27 -0
  663. package/src/cli/cli-commands/common/harness/buildHarnessInstallCommand.ts +6 -2
  664. package/src/cli/cli-commands/common/harness/formatHarnessInstallationWarning.ts +28 -6
  665. package/src/cli/cli-commands/common/harness/formatHarnessManualUpdateInstruction.ts +41 -0
  666. package/src/cli/cli-commands/common/harness/resolveHarnessInstallationMethodFromPaths.ts +111 -0
  667. package/src/cli/cli-commands/common/harness/resolveHarnessUpdatePlan.ts +47 -0
  668. package/src/cli/cli-commands/common/npm/$askForNpmPackageInstallationApproval.ts +20 -0
  669. package/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.ts +49 -0
  670. package/src/cli/cli-commands/common/npm/$resolveNpmGlobalPrefixPath.ts +51 -0
  671. package/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.ts +28 -0
  672. package/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.ts +25 -0
  673. package/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.ts +165 -0
  674. package/src/cli/cli-commands/common/projectInitialization.ts +35 -3
  675. package/src/cli/cli-commands/common/promptPriorityCliOptions.ts +30 -0
  676. package/src/cli/cli-commands/common/promptRunnerCliOptions.ts +51 -17
  677. package/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.ts +69 -0
  678. package/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.ts +128 -0
  679. package/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.ts +259 -0
  680. package/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.ts +55 -0
  681. package/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.ts +76 -0
  682. package/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.ts +32 -0
  683. package/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.ts +13 -0
  684. package/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.ts +45 -0
  685. package/src/cli/cli-commands/common/questionsCliOptions.ts +89 -0
  686. package/src/cli/cli-commands/common/resolveBundledAgentBookPath.ts +38 -0
  687. package/src/cli/cli-commands/common/resolveLocalAgentSource.ts +127 -0
  688. package/src/cli/cli-commands/prettify.ts +2 -2
  689. package/src/cli/cli-commands/run.ts +3 -1
  690. package/src/cli/cli-commands/test-command.ts +2 -2
  691. package/src/cli/common/$deprecateCliCommand.ts +5 -0
  692. package/src/cli/common/$hideCliCommandFromHelp.ts +27 -0
  693. package/src/cli/common/$requireCliSubcommand.ts +35 -0
  694. package/src/cli/promptbookCli.ts +6 -87
  695. package/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.ts +47 -3
  696. package/src/commands/FORMAT/formatCommandParser.ts +4 -2
  697. package/src/commitments/FROM/FROM.ts +13 -0
  698. package/src/commitments/WRITING_RULES/WRITING_RULES.ts +16 -8
  699. package/src/commitments/index.ts +2 -1
  700. package/src/executables/platforms/locateAppOnWindows.ts +12 -9
  701. package/src/execution/translation/automatic-translate/translateMessages.ts +4 -2
  702. package/src/llm-providers/openai/utils/buildToolInvocationScript.ts +21 -18
  703. package/src/llm-providers/vercel/VercelExecutionToolsOptions.ts +7 -2
  704. package/src/llm-providers/vercel/createExecutionToolsFromVercelProvider.ts +18 -17
  705. package/src/other/templates/getTemplatesPipelineCollection.ts +820 -723
  706. package/src/utils/agent-message-runtime/AgentMessageProjectChange.ts +183 -0
  707. package/src/utils/agent-message-runtime/AgentMessageTouchedExternalSource.ts +80 -0
  708. package/src/utils/agent-message-runtime/parseAgentMessageRuntimeLogEvents.ts +108 -0
  709. package/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.ts +78 -75
  710. package/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.ts +341 -0
  711. package/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.ts +147 -0
  712. package/src/utils/agents/terminalAgentAvatarVisual.ts +31 -3
  713. package/src/utils/ascii-art/convertImageDataToAsciiArt.ts +9 -109
  714. package/src/utils/ascii-art/createAnsiColorCode.ts +132 -0
  715. package/src/utils/files/findFilesByGlob.ts +46 -0
  716. package/src/utils/misc/debounce.ts +26 -5
  717. package/src/utils/misc/emojis.ts +3 -3
  718. package/src/utils/random/$generateBookBoilerplate.ts +1 -1
  719. package/src/version.ts +2 -2
  720. package/src/versions.txt +35 -0
  721. package/umd/apps/agents-server/src/constants/federatedAgentImport.d.ts +6 -0
  722. package/umd/index.umd.js +14401 -7055
  723. package/umd/index.umd.js.map +1 -1
  724. package/umd/scripts/run-agent-messages/git/commitAgentProjectChanges.d.ts +15 -0
  725. package/umd/scripts/run-agent-messages/git/commitAnsweredMessageProjectChanges.d.ts +24 -0
  726. package/umd/scripts/run-agent-messages/git/ensureAgentProjectGitRepository.d.ts +20 -0
  727. package/umd/scripts/run-agent-messages/git/readAgentProjectCommitChange.d.ts +11 -0
  728. package/umd/scripts/run-agent-messages/git/runAgentProjectGitCommand.d.ts +29 -0
  729. package/umd/scripts/run-agent-messages/messages/buildAgentGoalChatPromptSection.d.ts +26 -0
  730. package/umd/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts +12 -1
  731. package/umd/scripts/run-agent-messages/messages/buildAgentProjectsPromptSection.d.ts +2 -14
  732. package/umd/scripts/run-agent-messages/messages/buildAgentTeamPromptSection.d.ts +12 -0
  733. package/umd/scripts/run-agent-messages/messages/createAgentRunnerSystemMessage.d.ts +2 -1
  734. package/umd/scripts/run-agent-messages/messages/finalizeAgentTeamConversationWorkspace.d.ts +16 -0
  735. package/umd/scripts/run-agent-messages/messages/listAgentProjectDirectoryNames.d.ts +7 -0
  736. package/umd/scripts/run-agent-messages/messages/loadAgentPlannedMessagesSidecar.d.ts +10 -0
  737. package/umd/scripts/run-agent-messages/messages/loadAgentTeamConversationWorkspace.d.ts +6 -0
  738. package/umd/scripts/run-agent-messages/messages/resolveAnsweredMessageTouches.d.ts +29 -0
  739. package/umd/scripts/run-codex-prompts/common/CoderRunControlFeedback.d.ts +54 -0
  740. package/umd/scripts/run-codex-prompts/common/applyCoderRunControlKey.d.ts +14 -0
  741. package/umd/scripts/run-codex-prompts/common/buildCoderRunControlKeyBadge.d.ts +7 -0
  742. package/umd/scripts/run-codex-prompts/common/createCoderRunStepTracker.d.ts +48 -0
  743. package/umd/scripts/run-codex-prompts/common/createFreeDiskSpaceGuard.d.ts +25 -0
  744. package/umd/scripts/run-codex-prompts/common/formatCoderRunControlFeedback.d.ts +13 -0
  745. package/umd/scripts/run-codex-prompts/common/formatUnknownErrorDetails.d.ts +4 -0
  746. package/umd/scripts/run-codex-prompts/common/listenForCoderRunControls.d.ts +17 -0
  747. package/umd/scripts/run-codex-prompts/common/normalizeLineEndingsInChangedFiles.d.ts +2 -3
  748. package/umd/scripts/run-codex-prompts/common/resolveCoderAgent.d.ts +32 -3
  749. package/umd/scripts/run-codex-prompts/common/runGoScript/$spawnLoggedBashScript.d.ts +25 -0
  750. package/umd/scripts/run-codex-prompts/common/runGoScript/$terminateLoggedBashProcessTree.d.ts +11 -0
  751. package/umd/scripts/run-codex-prompts/common/runGoScript/createScriptOutputLineReader.d.ts +22 -0
  752. package/umd/scripts/run-codex-prompts/common/runGoScript/scriptExecutionLog.d.ts +4 -0
  753. package/umd/scripts/run-codex-prompts/common/waitForPause.d.ts +0 -8
  754. package/umd/scripts/run-codex-prompts/common/waitForSkippableWorldTimeDeadline.d.ts +15 -0
  755. package/umd/scripts/run-codex-prompts/git/coderCommitScope.d.ts +31 -0
  756. package/umd/scripts/run-codex-prompts/git/coderGitSync.d.ts +15 -2
  757. package/umd/scripts/run-codex-prompts/git/commitChanges.d.ts +9 -3
  758. package/umd/scripts/run-codex-prompts/git/commitInitializedAgentBooks.d.ts +5 -0
  759. package/umd/scripts/run-codex-prompts/git/workingTreeChanges.d.ts +40 -0
  760. package/umd/scripts/run-codex-prompts/main/listCoderPrompts.d.ts +20 -0
  761. package/umd/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts +5 -8
  762. package/umd/scripts/run-codex-prompts/main/runPromptRound.d.ts +2 -4
  763. package/umd/scripts/run-codex-prompts/ping/pingCoderHarnessPeriodically.d.ts +22 -0
  764. package/umd/scripts/run-codex-prompts/prompts/buildPromptLabel.d.ts +6 -0
  765. package/umd/scripts/run-codex-prompts/prompts/buildPromptRunTraceContent.d.ts +65 -0
  766. package/umd/scripts/run-codex-prompts/prompts/buildPromptRunTracePath.d.ts +10 -0
  767. package/umd/scripts/run-codex-prompts/prompts/buildPromptStatusDetails.d.ts +39 -0
  768. package/umd/scripts/run-codex-prompts/prompts/findFirstNonEmptyLineIndex.d.ts +6 -0
  769. package/umd/scripts/run-codex-prompts/prompts/formatCoderRunSteps.d.ts +6 -3
  770. package/umd/scripts/run-codex-prompts/prompts/formatRunnerSignature.d.ts +14 -1
  771. package/umd/scripts/run-codex-prompts/prompts/isPromptCompatibleWithRunner.d.ts +11 -6
  772. package/umd/scripts/run-codex-prompts/prompts/isPromptSectionUnfinished.d.ts +8 -0
  773. package/umd/scripts/run-codex-prompts/prompts/listPromptsByStatus.d.ts +7 -0
  774. package/umd/scripts/run-codex-prompts/prompts/loadPromptFiles.d.ts +1 -1
  775. package/umd/scripts/run-codex-prompts/prompts/markPromptDone.d.ts +15 -4
  776. package/umd/scripts/run-codex-prompts/prompts/markPromptFailed.d.ts +28 -1
  777. package/umd/scripts/run-codex-prompts/prompts/markPromptInProgress.d.ts +27 -0
  778. package/umd/scripts/run-codex-prompts/prompts/promptRunnerAttribution.d.ts +30 -0
  779. package/umd/scripts/run-codex-prompts/prompts/resolveInterruptedPrompt.d.ts +9 -0
  780. package/umd/scripts/run-codex-prompts/prompts/resolvePromptStatusLine.d.ts +19 -0
  781. package/umd/scripts/run-codex-prompts/prompts/writePromptRunTrace.d.ts +19 -0
  782. package/umd/scripts/run-codex-prompts/prompts/writePromptStatusLine.d.ts +10 -0
  783. package/umd/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeRunner.d.ts +25 -0
  784. package/umd/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeOutputEvents.d.ts +3 -0
  785. package/umd/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeSubscriptionUsage.d.ts +11 -0
  786. package/umd/scripts/run-codex-prompts/runners/common/buildHarnessAuthenticationError.d.ts +20 -0
  787. package/umd/scripts/run-codex-prompts/runners/common/createAuthenticationAwarePromptRunner.d.ts +11 -0
  788. package/umd/scripts/run-codex-prompts/runners/common/estimateUsageFromTextLength.d.ts +33 -0
  789. package/umd/scripts/run-codex-prompts/runners/common/extractHarnessAuthenticationFailureReason.d.ts +9 -0
  790. package/umd/scripts/run-codex-prompts/runners/common/modelPricing.d.ts +41 -0
  791. package/umd/scripts/run-codex-prompts/runners/gemini/GeminiRunner.d.ts +1 -1
  792. package/umd/scripts/run-codex-prompts/runners/gemini/gemini-pricing.d.ts +5 -18
  793. package/umd/scripts/run-codex-prompts/runners/openai-codex/OpenAiCodexRunner.d.ts +8 -0
  794. package/umd/scripts/run-codex-prompts/runners/openai-codex/buildCodexUsageFromOutput.d.ts +4 -1
  795. package/umd/scripts/run-codex-prompts/runners/openai-codex/getCodexSubscriptionUsage.d.ts +19 -0
  796. package/umd/scripts/run-codex-prompts/runners/qwen-code/QwenCodeRunner.d.ts +23 -0
  797. package/umd/scripts/run-codex-prompts/runners/qwen-code/buildQwenCodeScript.d.ts +8 -0
  798. package/umd/scripts/run-codex-prompts/runners/qwen-code/parseQwenCodeUsageFromOutput.d.ts +9 -0
  799. package/umd/scripts/run-codex-prompts/runners/qwen-code/qwen-code-pricing.d.ts +30 -0
  800. package/umd/scripts/run-codex-prompts/runners/types/HarnessSubscriptionUsage.d.ts +43 -0
  801. package/umd/scripts/run-codex-prompts/server/buildCoderServerPromptResponse.d.ts +1 -1
  802. package/umd/scripts/run-codex-prompts/server/coderServerHtml.d.ts +1 -1
  803. package/umd/scripts/run-codex-prompts/server/updatePromptSection.d.ts +1 -1
  804. package/umd/scripts/run-codex-prompts/testing/runPromptWithTestFeedback.d.ts +6 -0
  805. package/umd/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts +21 -1
  806. package/umd/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts +5 -5
  807. package/umd/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts +11 -1
  808. package/umd/scripts/run-codex-prompts/ui/buildCoderRunUiTerminalFrameUpdate.d.ts +27 -0
  809. package/umd/scripts/run-codex-prompts/ui/buildRunUiFrameShared.d.ts +11 -0
  810. package/umd/scripts/run-codex-prompts/ui/buildSubscriptionUsageSessionRows.d.ts +11 -0
  811. package/umd/scripts/run-codex-prompts/ui/refreshCoderRunUiSubscriptionUsage.d.ts +14 -0
  812. package/umd/scripts/run-codex-prompts/ui/startCoderRunUiSubscriptionUsageRefresh.d.ts +37 -0
  813. package/umd/scripts/utils/emojiTags/validSinglePictogramEmojis.d.ts +17 -0
  814. package/umd/scripts/verify-prompts/$orderPromptFiles.d.ts +9 -0
  815. package/umd/scripts/verify-prompts/VerifyPromptsOrder.d.ts +26 -0
  816. package/umd/scripts/verify-prompts/verify-prompts.d.ts +3 -2
  817. package/umd/src/_packages/components.index.d.ts +4 -0
  818. package/umd/src/_packages/types.index.d.ts +4 -0
  819. package/umd/src/avatars/renderAvatarVisualTerminalText.d.ts +80 -0
  820. package/umd/src/avatars/renderAvatarVisualTerminalText.test.d.ts +1 -0
  821. package/umd/src/avatars/types/AvatarVisualDefinition.d.ts +54 -0
  822. package/umd/src/book-2.0/agent-source/AgentReferenceResolutionIssue.d.ts +45 -0
  823. package/umd/src/book-2.0/agent-source/AgentSourceParseResult.d.ts +5 -0
  824. package/umd/src/book-2.0/agent-source/ParsedUnknownCommitment.d.ts +26 -0
  825. package/umd/src/book-2.0/agent-source/createAgentModelRequirements.deduplication.test.d.ts +1 -0
  826. package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.unknown.test.d.ts +1 -0
  827. package/umd/src/book-2.0/agent-source/deduplicateSystemMessage.d.ts +14 -0
  828. package/umd/src/book-2.0/agent-source/deduplicateSystemMessage.test.d.ts +1 -0
  829. package/umd/src/book-2.0/agent-source/explicitFromCommitment.d.ts +62 -0
  830. package/umd/src/book-2.0/agent-source/extractAgentReferenceTokens.d.ts +32 -0
  831. package/umd/src/book-2.0/agent-source/getBookCommitmentLineType.d.ts +19 -0
  832. package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.unknown.test.d.ts +1 -0
  833. package/umd/src/book-2.0/agent-source/resolveInheritedAgentSource.d.ts +73 -0
  834. package/umd/src/book-2.0/book-language-documentation/getSafeCodeBlock.d.ts +1 -1
  835. package/umd/src/book-3.0/AgentMessageRunReport.d.ts +46 -0
  836. package/umd/src/book-3.0/AgentPlannedMessagesSidecar.d.ts +127 -0
  837. package/umd/src/book-3.0/AgentPlannedMessagesSidecar.test.d.ts +1 -0
  838. package/umd/src/book-3.0/AgentTeamConversationWorkspace.d.ts +85 -0
  839. package/umd/src/book-3.0/cliAgentEnv.d.ts +3 -3
  840. package/umd/src/book-3.0/createAgentMessageSidecarBaseName.d.ts +13 -0
  841. package/umd/src/book-3.0/describeAgentPlannedMessageSchedule.d.ts +31 -0
  842. package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +1 -9
  843. package/umd/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.d.ts +28 -0
  844. package/umd/src/book-components/BookEditor/createDuplicateFromCommitmentDiagnostics.test.d.ts +1 -0
  845. package/umd/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.d.ts +28 -0
  846. package/umd/src/book-components/BookEditor/createUnknownCommitmentDiagnostics.test.d.ts +1 -0
  847. package/umd/src/book-components/Chat/Chat/ChatProps.d.ts +3 -2
  848. package/umd/src/book-components/Chat/Chat/renderAgentProjectDiff.d.ts +13 -0
  849. package/umd/src/book-components/Chat/Chat/renderAgentProjectToolCallDetails.d.ts +16 -0
  850. package/umd/src/book-components/Chat/MockedChat/MockedChat.test.d.ts +2 -0
  851. package/umd/src/book-components/Chat/utils/agentProjectToolCall.d.ts +85 -0
  852. package/umd/src/book-components/Chat/utils/agentProjectToolCall.test.d.ts +1 -0
  853. package/umd/src/book-components/Chat/utils/externalSourceToolCall.d.ts +38 -0
  854. package/umd/src/book-components/Chat/utils/renderMarkdown.d.ts +68 -3
  855. package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts +30 -0
  856. package/umd/src/cli/$initializePromptbookCliProgram.d.ts +8 -0
  857. package/umd/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.d.ts +10 -0
  858. package/umd/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.test.d.ts +1 -0
  859. package/umd/src/cli/cli-commands/coder/GitChangesMode.d.ts +28 -0
  860. package/umd/src/cli/cli-commands/coder/agentCliOptions.d.ts +21 -0
  861. package/umd/src/cli/cli-commands/coder/boilerplateCount.d.ts +1 -1
  862. package/umd/src/cli/cli-commands/coder/boilerplateTemplates.d.ts +8 -21
  863. package/umd/src/cli/cli-commands/coder/coderReferencedArtifacts.d.ts +33 -0
  864. package/umd/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts +14 -1
  865. package/umd/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.d.ts +4 -2
  866. package/umd/src/cli/cli-commands/coder/ensureCoderVscodeSettingsFile.d.ts +2 -0
  867. package/umd/src/cli/cli-commands/coder/ensureDirectory.d.ts +6 -0
  868. package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts +1 -1
  869. package/umd/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.d.ts +6 -0
  870. package/umd/src/cli/cli-commands/coder/init.test.d.ts +1 -0
  871. package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +8 -5
  872. package/umd/src/cli/cli-commands/coder/list.d.ts +10 -0
  873. package/umd/src/cli/cli-commands/coder/list.test.d.ts +1 -0
  874. package/umd/src/cli/cli-commands/coder/mergeStringRecordJsonFile.d.ts +19 -1
  875. package/umd/src/cli/cli-commands/coder/printCoderRunFailure.d.ts +6 -0
  876. package/umd/src/cli/cli-commands/coder/server.test.d.ts +1 -0
  877. package/umd/src/cli/cli-commands/coder/verify.d.ts +1 -1
  878. package/umd/src/cli/cli-commands/coder/waitOptions.d.ts +12 -0
  879. package/umd/src/cli/cli-commands/coder.d.ts +1 -0
  880. package/umd/src/cli/cli-commands/common/$askForConfirmation.d.ts +11 -0
  881. package/umd/src/cli/cli-commands/common/$askForConfirmation.test.d.ts +1 -0
  882. package/umd/src/cli/cli-commands/common/LocalAgentBookCollection.d.ts +46 -0
  883. package/umd/src/cli/cli-commands/common/createLocalAgentReferenceResolver.d.ts +8 -0
  884. package/umd/src/cli/cli-commands/common/disk-space/$assertSufficientFreeDiskSpace.d.ts +12 -0
  885. package/umd/src/cli/cli-commands/common/disk-space/$assertSufficientFreeDiskSpace.test.d.ts +1 -0
  886. package/umd/src/cli/cli-commands/common/disk-space/$readFreeDiskSpaceStatus.d.ts +11 -0
  887. package/umd/src/cli/cli-commands/common/disk-space/$readFreeDiskSpaceStatus.test.d.ts +1 -0
  888. package/umd/src/cli/cli-commands/common/disk-space/FreeDiskSpaceStatus.d.ts +33 -0
  889. package/umd/src/cli/cli-commands/common/disk-space/formatFreeDiskSpaceBytes.d.ts +6 -0
  890. package/umd/src/cli/cli-commands/common/disk-space/formatFreeDiskSpaceBytes.test.d.ts +1 -0
  891. package/umd/src/cli/cli-commands/common/disk-space/formatLowFreeDiskSpaceWarning.d.ts +10 -0
  892. package/umd/src/cli/cli-commands/common/disk-space/freeDiskSpaceConstants.d.ts +28 -0
  893. package/umd/src/cli/cli-commands/common/disk-space/resolveFreeDiskSpaceLevel.d.ts +7 -0
  894. package/umd/src/cli/cli-commands/common/disk-space/resolveFreeDiskSpaceLevel.test.d.ts +1 -0
  895. package/umd/src/cli/cli-commands/common/ensureAdamAgentBook.d.ts +12 -0
  896. package/umd/src/cli/cli-commands/common/harness/$applyHarnessInstallationStatus.d.ts +3 -2
  897. package/umd/src/cli/cli-commands/common/harness/$checkHarnessInstallation.d.ts +3 -3
  898. package/umd/src/cli/cli-commands/common/harness/$checkHarnessInstallation.test.d.ts +1 -0
  899. package/umd/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.d.ts +4 -3
  900. package/umd/src/cli/cli-commands/common/harness/$resolveHarnessCommandPath.d.ts +14 -0
  901. package/umd/src/cli/cli-commands/common/harness/$resolveHarnessInstallationOrigin.d.ts +10 -0
  902. package/umd/src/cli/cli-commands/common/harness/$runHarnessInstallationCommand.d.ts +43 -0
  903. package/umd/src/cli/cli-commands/common/harness/HARNESS_DEFAULT_MODELS.d.ts +25 -0
  904. package/umd/src/cli/cli-commands/common/harness/HarnessDefinition.d.ts +62 -0
  905. package/umd/src/cli/cli-commands/common/harness/HarnessInstallationOrigin.d.ts +36 -0
  906. package/umd/src/cli/cli-commands/common/harness/HarnessInstallationStatus.d.ts +8 -2
  907. package/umd/src/cli/cli-commands/common/harness/HarnessUpdatePlan.d.ts +23 -0
  908. package/umd/src/cli/cli-commands/common/harness/buildHarnessInstallCommand.d.ts +4 -1
  909. package/umd/src/cli/cli-commands/common/harness/formatHarnessManualUpdateInstruction.d.ts +8 -0
  910. package/umd/src/cli/cli-commands/common/harness/formatHarnessManualUpdateInstruction.test.d.ts +1 -0
  911. package/umd/src/cli/cli-commands/common/harness/resolveHarnessInstallationMethodFromPaths.d.ts +31 -0
  912. package/umd/src/cli/cli-commands/common/harness/resolveHarnessInstallationMethodFromPaths.test.d.ts +1 -0
  913. package/umd/src/cli/cli-commands/common/harness/resolveHarnessUpdatePlan.d.ts +12 -0
  914. package/umd/src/cli/cli-commands/common/harness/resolveHarnessUpdatePlan.test.d.ts +1 -0
  915. package/umd/src/cli/cli-commands/common/npm/$askForNpmPackageInstallationApproval.d.ts +11 -0
  916. package/{esm/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts → umd/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.d.ts} +2 -3
  917. package/umd/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.test.d.ts +1 -0
  918. package/umd/src/cli/cli-commands/common/npm/$resolveNpmGlobalPrefixPath.d.ts +9 -0
  919. package/umd/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.d.ts +12 -0
  920. package/umd/src/cli/cli-commands/common/npm/buildNpmPackageInstallCommand.test.d.ts +1 -0
  921. package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.d.ts +12 -0
  922. package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.test.d.ts +1 -0
  923. package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.d.ts +12 -0
  924. package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.test.d.ts +1 -0
  925. package/umd/src/cli/cli-commands/common/projectInitialization.d.ts +6 -0
  926. package/umd/src/cli/cli-commands/common/promptPriorityCliOptions.d.ts +7 -0
  927. package/umd/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +17 -4
  928. package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts +9 -0
  929. package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.test.d.ts +1 -0
  930. package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts +15 -0
  931. package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.test.d.ts +1 -0
  932. package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts +12 -0
  933. package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.test.d.ts +1 -0
  934. package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts +10 -0
  935. package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.test.d.ts +1 -0
  936. package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.d.ts +66 -0
  937. package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.d.ts +26 -0
  938. package/umd/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.d.ts +7 -0
  939. package/umd/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.d.ts +7 -0
  940. package/umd/src/cli/cli-commands/common/questionsCliOptions.d.ts +45 -0
  941. package/umd/src/cli/cli-commands/common/questionsCliOptions.test.d.ts +1 -0
  942. package/umd/src/cli/cli-commands/common/resolveBundledAgentBookPath.d.ts +6 -0
  943. package/umd/src/cli/cli-commands/common/resolveLocalAgentSource.d.ts +19 -0
  944. package/umd/src/cli/common/$deprecateCliCommand.d.ts +3 -0
  945. package/umd/src/cli/common/$hideCliCommandFromHelp.d.ts +11 -0
  946. package/umd/src/cli/common/$hideCliCommandFromHelp.test.d.ts +1 -0
  947. package/umd/src/cli/common/$requireCliSubcommand.d.ts +18 -0
  948. package/umd/src/cli/common/$requireCliSubcommand.test.d.ts +1 -0
  949. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +15 -0
  950. package/umd/src/commitments/WRITING_RULES/WRITING_RULES.d.ts +14 -7
  951. package/umd/src/commitments/index.d.ts +1 -1
  952. package/umd/src/executables/platforms/locateAppOnWindows.d.ts +1 -1
  953. package/umd/src/executables/platforms/locateAppOnWindows.test.d.ts +1 -0
  954. package/umd/src/llm-providers/vercel/VercelExecutionToolsOptions.d.ts +5 -2
  955. package/umd/src/utils/agent-message-runtime/AgentMessageProjectChange.d.ts +76 -0
  956. package/umd/src/utils/agent-message-runtime/AgentMessageTouchedExternalSource.d.ts +45 -0
  957. package/umd/src/utils/agent-message-runtime/parseAgentMessageRuntimeLogEvents.d.ts +62 -0
  958. package/umd/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts +3 -3
  959. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.d.ts +18 -0
  960. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedExternalSources.test.d.ts +1 -0
  961. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.d.ts +19 -0
  962. package/umd/src/utils/agent-message-runtime/resolveAgentMessageTouchedProjectNames.test.d.ts +1 -0
  963. package/umd/src/utils/agents/terminalAgentAvatarVisual.d.ts +5 -2
  964. package/umd/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts +6 -0
  965. package/umd/src/utils/ascii-art/createAnsiColorCode.d.ts +46 -0
  966. package/umd/src/utils/files/findFilesByGlob.d.ts +28 -0
  967. package/umd/src/utils/misc/debounce.d.ts +4 -2
  968. package/umd/src/utils/misc/debounce.test.d.ts +1 -0
  969. package/umd/src/utils/misc/emojis.d.ts +3 -2
  970. package/umd/src/utils/random/$generateBookBoilerplate.test.d.ts +1 -0
  971. package/umd/src/version.d.ts +1 -1
  972. package/apps/agents-server/scripts/ignore-kill-eperm.js +0 -31
  973. package/apps/agents-server/src/app/admin/task-manager/TaskManagerScopeTabs.tsx +0 -74
  974. package/apps/agents-server/src/app/agents/[agentName]/api/timeouts/actions/route.ts +0 -103
  975. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsClient.tsx +0 -43
  976. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsEditDialog.tsx +0 -98
  977. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsFiltersCard.tsx +0 -75
  978. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsHeader.tsx +0 -53
  979. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsSummaryMetrics.tsx +0 -70
  980. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsTableCard.tsx +0 -58
  981. package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsTableRow.tsx +0 -242
  982. package/apps/agents-server/src/app/agents/[agentName]/timeouts/loading.tsx +0 -15
  983. package/apps/agents-server/src/app/agents/[agentName]/timeouts/page.tsx +0 -28
  984. package/apps/agents-server/src/app/agents/[agentName]/timeouts/useAgentTimeoutsClientState.ts +0 -769
  985. package/apps/agents-server/src/components/AgentProjectDnsInstructions/AgentProjectDnsInstructions.tsx +0 -182
  986. package/apps/agents-server/src/utils/userChatClient/runAgentUserTimeoutBulkAction.ts +0 -24
  987. package/apps/agents-server/src/utils/userChatClient/updateAgentUserTimeout.ts +0 -25
  988. package/esm/apps/agents-server/src/database/sqlite/$provideAgentsServerSqliteDatabase.d.ts +0 -69
  989. package/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/ensureTable.d.ts +0 -7
  990. package/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteSql.d.ts +0 -30
  991. package/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteTableSchema.d.ts +0 -76
  992. package/esm/apps/agents-server/src/database/sqlite/resolveAgentsServerSqliteDatabasePath.d.ts +0 -4
  993. package/esm/apps/agents-server/src/database/sqlite/resolveServerSqliteDatabasePath.d.ts +0 -28
  994. package/esm/apps/agents-server/src/database/sqlite/standaloneServerRegistryStore.d.ts +0 -110
  995. package/esm/scripts/find-fresh-emoji-tags/utils/emojis.d.ts +0 -16
  996. package/esm/scripts/run-codex-prompts/prompts/replacePromptTodoStatusLine.d.ts +0 -7
  997. package/esm/scripts/run-codex-prompts/ui/buildCoderRunOctopusVisual.d.ts +0 -13
  998. package/esm/src/cli/cli-commands/coder/agentCodingFile.d.ts +0 -13
  999. package/esm/src/cli/cli-commands/common/harness/$askForHarnessInstallationApproval.d.ts +0 -9
  1000. package/esm/src/cli/cli-commands/common/harness/$installHarness.d.ts +0 -13
  1001. package/esm/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts +0 -11
  1002. package/esm/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts +0 -9
  1003. package/src/cli/cli-commands/coder/agentCodingFile.ts +0 -25
  1004. package/src/cli/cli-commands/common/harness/$askForHarnessInstallationApproval.ts +0 -31
  1005. package/src/cli/cli-commands/common/harness/$installHarness.ts +0 -56
  1006. package/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.ts +0 -34
  1007. package/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.ts +0 -28
  1008. package/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.ts +0 -39
  1009. package/umd/apps/agents-server/src/database/sqlite/$provideAgentsServerSqliteDatabase.d.ts +0 -69
  1010. package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/ensureTable.d.ts +0 -7
  1011. package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteSql.d.ts +0 -30
  1012. package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteTableSchema.d.ts +0 -76
  1013. package/umd/apps/agents-server/src/database/sqlite/resolveAgentsServerSqliteDatabasePath.d.ts +0 -4
  1014. package/umd/apps/agents-server/src/database/sqlite/resolveServerSqliteDatabasePath.d.ts +0 -28
  1015. package/umd/apps/agents-server/src/database/sqlite/standaloneServerRegistryStore.d.ts +0 -110
  1016. package/umd/scripts/find-fresh-emoji-tags/utils/emojis.d.ts +0 -16
  1017. package/umd/scripts/run-codex-prompts/prompts/replacePromptTodoStatusLine.d.ts +0 -7
  1018. package/umd/scripts/run-codex-prompts/ui/buildCoderRunOctopusVisual.d.ts +0 -13
  1019. package/umd/src/cli/cli-commands/coder/agentCodingFile.d.ts +0 -13
  1020. package/umd/src/cli/cli-commands/common/harness/$askForHarnessInstallationApproval.d.ts +0 -9
  1021. package/umd/src/cli/cli-commands/common/harness/$installHarness.d.ts +0 -13
  1022. package/umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts +0 -11
  1023. package/umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts +0 -9
  1024. /package/esm/src/{cli/cli-commands/common/harness/extractHarnessVersionFromOutput.test.d.ts → avatars/renderAvatarVisualTerminalText.test.d.ts} +0 -0
  1025. /package/esm/src/{cli/cli-commands/common/harness/isHarnessVersionOutdated.test.d.ts → book-2.0/agent-source/createAgentModelRequirements.deduplication.test.d.ts} +0 -0
  1026. /package/{umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.test.d.ts → esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.unknown.test.d.ts} +0 -0
  1027. /package/{umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.test.d.ts → esm/src/book-2.0/agent-source/deduplicateSystemMessage.test.d.ts} +0 -0
@@ -46,8 +46,9 @@ export async function augmentAgentModelRequirementsFromSource(
46
46
  requirements = await importReferencedFiles(requirements);
47
47
  requirements = appendMcpServers(requirements, agentSource);
48
48
  requirements = appendNonCommitmentContent(requirements, parseResult);
49
+ requirements = appendExampleInteractions(requirements, parseResult);
49
50
 
50
- return appendExampleInteractions(requirements, parseResult);
51
+ return appendUnknownCommitmentContent(requirements, parseResult);
51
52
  }
52
53
 
53
54
  /**
@@ -188,6 +189,42 @@ function appendNonCommitmentContent(
188
189
  return appendSystemMessageSection(requirements, nonCommitmentContent);
189
190
  }
190
191
 
192
+ /**
193
+ * Appends unknown commitment blocks as final extra context without applying commitment side effects.
194
+ *
195
+ * @param requirements - Current requirements snapshot.
196
+ * @param parseResult - Parsed source including unknown commitment blocks.
197
+ * @returns Requirements with unknown commitment context appended at the end of the system message.
198
+ *
199
+ * @private internal utility of `augmentAgentModelRequirementsFromSource`
200
+ */
201
+ function appendUnknownCommitmentContent(
202
+ requirements: AgentModelRequirements,
203
+ parseResult: ParsedAgentSourceWithCommitments,
204
+ ): AgentModelRequirements {
205
+ const unknownCommitmentContent = getUnknownCommitmentContent(parseResult);
206
+ if (!unknownCommitmentContent) {
207
+ return requirements;
208
+ }
209
+
210
+ return appendSystemMessageSection(requirements, unknownCommitmentContent);
211
+ }
212
+
213
+ /**
214
+ * Joins unknown commitment blocks into their final extra-context representation.
215
+ *
216
+ * @param parseResult - Parsed source including unknown commitment blocks.
217
+ * @returns Unknown commitment source blocks in their original order.
218
+ *
219
+ * @private internal utility of `appendUnknownCommitmentContent`
220
+ */
221
+ function getUnknownCommitmentContent(parseResult: ParsedAgentSourceWithCommitments): string {
222
+ return parseResult.unknownCommitments
223
+ .map((commitment) => commitment.source)
224
+ .filter(Boolean)
225
+ .join('\n\n');
226
+ }
227
+
191
228
  /**
192
229
  * Collects plain-text lines that were not parsed as commitments and should still become part of the final system message.
193
230
  *
@@ -6,6 +6,7 @@ import { applyCommitmentsToAgentModelRequirements } from './createAgentModelRequ
6
6
  import { augmentAgentModelRequirementsFromSource } from './createAgentModelRequirementsWithCommitments/augmentAgentModelRequirementsFromSource';
7
7
  import { filterCommitmentsForAgentModelRequirements } from './createAgentModelRequirementsWithCommitments/filterCommitmentsForAgentModelRequirements';
8
8
  import { materializeInlineKnowledgeSources } from './createAgentModelRequirementsWithCommitments/materializeInlineKnowledgeSources';
9
+ import { deduplicateSystemMessage } from './deduplicateSystemMessage';
9
10
  import { parseAgentSourceWithCommitments } from './parseAgentSourceWithCommitments';
10
11
  import { removeCommentsFromSystemMessage } from './removeCommentsFromSystemMessage';
11
12
  import type { string_book } from './string_book';
@@ -73,13 +74,13 @@ function createInitialAgentModelRequirements(
73
74
  * Performs the final system-message cleanup pass after all other augmentation steps are complete.
74
75
  *
75
76
  * @param requirements - Fully built requirements before final cleanup.
76
- * @returns Requirements with comment lines removed from the final system message.
77
+ * @returns Requirements with comment lines removed and repeated instructions deduplicated in the final system message.
77
78
  *
78
79
  * @private internal utility of `createAgentModelRequirementsWithCommitments`
79
80
  */
80
81
  function finalizeRequirements(requirements: AgentModelRequirements): AgentModelRequirements {
81
82
  return {
82
83
  ...requirements,
83
- systemMessage: removeCommentsFromSystemMessage(requirements.systemMessage),
84
+ systemMessage: deduplicateSystemMessage(removeCommentsFromSystemMessage(requirements.systemMessage)),
84
85
  };
85
86
  }
@@ -0,0 +1,327 @@
1
+ /**
2
+ * Pattern matching a markdown section heading (`## Title`) that separates system-message sections
3
+ *
4
+ * @private internal constant of `deduplicateSystemMessage`
5
+ */
6
+ const SYSTEM_MESSAGE_SECTION_HEADING_PATTERN = /^##(?!#)\s*(.+?)\s*$/;
7
+
8
+ /**
9
+ * Pattern matching a fenced code block delimiter which suspends section and block splitting
10
+ *
11
+ * @private internal constant of `deduplicateSystemMessage`
12
+ */
13
+ const CODE_FENCE_PATTERN = /^\s*(?:```|~~~)/;
14
+
15
+ /**
16
+ * Pattern matching a markdown list item which keeps merged bullet lists visually compact
17
+ *
18
+ * @private internal constant of `deduplicateSystemMessage`
19
+ */
20
+ const LIST_ITEM_PATTERN = /^\s*(?:[-*+]|\d+[.)])\s/;
21
+
22
+ /**
23
+ * One block of a system-message region, which is a group of lines surrounded by blank lines
24
+ *
25
+ * @private internal type of `deduplicateSystemMessage`
26
+ */
27
+ type SystemMessageBlock = {
28
+ /**
29
+ * Exact text of the block
30
+ */
31
+ readonly text: string;
32
+
33
+ /**
34
+ * Whether the block opens a section occurrence merged into an earlier section with the same heading
35
+ */
36
+ readonly isOpeningMergedSection: boolean;
37
+ };
38
+
39
+ /**
40
+ * One region of the system message, which is either the intro before the first heading or one `## Title` section
41
+ *
42
+ * @private internal type of `deduplicateSystemMessage`
43
+ */
44
+ type SystemMessageRegion = {
45
+ /**
46
+ * Case-insensitive key used to merge regions sharing one heading, `null` for the intro before the first heading
47
+ */
48
+ readonly titleKey: string | null;
49
+
50
+ /**
51
+ * Original heading line kept so the rendered heading preserves its exact original text
52
+ */
53
+ readonly headingLine: string | null;
54
+
55
+ /**
56
+ * Whether the original region separated its heading from the body by a blank line
57
+ */
58
+ readonly isBodySeparatedByBlankLine: boolean;
59
+
60
+ /**
61
+ * Body blocks of the region in their original order
62
+ */
63
+ readonly blocks: ReadonlyArray<SystemMessageBlock>;
64
+ };
65
+
66
+ /**
67
+ * Removes duplicated instructions from a generated system message
68
+ *
69
+ * Commitments are applied one by one, so a commitment used multiple times in one book repeats its whole
70
+ * section, including the shared guidance preamble. For example two `WRITING RULES` commitments emit the
71
+ * `## Writing rules` heading and its guidance paragraph twice. This function merges all sections sharing
72
+ * one heading into the position of their first occurrence and keeps every identical block only once.
73
+ *
74
+ * @param systemMessage The assembled system message which may contain repeated sections and blocks
75
+ * @returns The system message where each section heading and each identical block appears exactly once
76
+ *
77
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
78
+ */
79
+ export function deduplicateSystemMessage(systemMessage: string): string {
80
+ if (!systemMessage.trim()) {
81
+ return systemMessage;
82
+ }
83
+
84
+ return splitSystemMessageIntoRegions(systemMessage)
85
+ .reduce(mergeRegionSharingHeading, [])
86
+ .map(removeDuplicateBlocksFromRegion)
87
+ .map(renderRegion)
88
+ .filter((renderedRegion) => renderedRegion !== '')
89
+ .join('\n\n');
90
+ }
91
+
92
+ /**
93
+ * Splits the system message into the intro region and one region per `## Title` section
94
+ *
95
+ * @param systemMessage The system message to split
96
+ * @returns Regions in their original order, without empty ones
97
+ *
98
+ * @private internal utility of `deduplicateSystemMessage`
99
+ */
100
+ function splitSystemMessageIntoRegions(systemMessage: string): ReadonlyArray<SystemMessageRegion> {
101
+ const regions: SystemMessageRegion[] = [];
102
+ let headingLine: string | null = null;
103
+ let bodyLines: string[] = [];
104
+ let isInsideCodeFence = false;
105
+
106
+ for (const line of systemMessage.split(/\r?\n/)) {
107
+ if (CODE_FENCE_PATTERN.test(line)) {
108
+ isInsideCodeFence = !isInsideCodeFence;
109
+ }
110
+
111
+ if (isInsideCodeFence || !SYSTEM_MESSAGE_SECTION_HEADING_PATTERN.test(line)) {
112
+ bodyLines.push(line);
113
+ continue;
114
+ }
115
+
116
+ regions.push(createRegion(headingLine, bodyLines));
117
+ headingLine = line;
118
+ bodyLines = [];
119
+ }
120
+
121
+ regions.push(createRegion(headingLine, bodyLines));
122
+
123
+ return regions.filter((region) => region.headingLine !== null || region.blocks.length > 0);
124
+ }
125
+
126
+ /**
127
+ * Creates one region from its heading line and its raw body lines
128
+ *
129
+ * @param headingLine The original `## Title` line, or `null` for the intro before the first heading
130
+ * @param bodyLines The raw lines following the heading line
131
+ * @returns The region with its body already split into blocks
132
+ *
133
+ * @private internal utility of `splitSystemMessageIntoRegions`
134
+ */
135
+ function createRegion(headingLine: string | null, bodyLines: ReadonlyArray<string>): SystemMessageRegion {
136
+ return {
137
+ titleKey: headingLine === null ? null : normalizeSectionTitle(headingLine),
138
+ headingLine,
139
+ isBodySeparatedByBlankLine: bodyLines[0] !== undefined && bodyLines[0].trim() === '',
140
+ blocks: splitBodyIntoBlocks(bodyLines),
141
+ };
142
+ }
143
+
144
+ /**
145
+ * Normalizes a heading line into a key usable for matching sections which belong together
146
+ *
147
+ * @param headingLine The original `## Title` line
148
+ * @returns Lowercased title without the markdown heading prefix
149
+ *
150
+ * @private internal utility of `createRegion`
151
+ */
152
+ function normalizeSectionTitle(headingLine: string): string {
153
+ return (SYSTEM_MESSAGE_SECTION_HEADING_PATTERN.exec(headingLine)?.[1] ?? headingLine).toLowerCase();
154
+ }
155
+
156
+ /**
157
+ * Splits raw body lines into blocks separated by blank lines while keeping fenced code blocks intact
158
+ *
159
+ * @param bodyLines The raw lines of one region body
160
+ * @returns Non-empty blocks in their original order
161
+ *
162
+ * @private internal utility of `createRegion`
163
+ */
164
+ function splitBodyIntoBlocks(bodyLines: ReadonlyArray<string>): ReadonlyArray<SystemMessageBlock> {
165
+ const blockTexts: string[] = [];
166
+ let blockLines: string[] = [];
167
+ let isInsideCodeFence = false;
168
+
169
+ for (const line of bodyLines) {
170
+ if (CODE_FENCE_PATTERN.test(line)) {
171
+ isInsideCodeFence = !isInsideCodeFence;
172
+ }
173
+
174
+ if (!isInsideCodeFence && line.trim() === '') {
175
+ blockTexts.push(blockLines.join('\n'));
176
+ blockLines = [];
177
+ continue;
178
+ }
179
+
180
+ blockLines.push(line);
181
+ }
182
+
183
+ blockTexts.push(blockLines.join('\n'));
184
+
185
+ return blockTexts
186
+ .filter((blockText) => blockText.trim() !== '')
187
+ .map((blockText) => ({ text: blockText, isOpeningMergedSection: false }));
188
+ }
189
+
190
+ /**
191
+ * Appends one region to the already merged regions, merging it into an earlier region with the same heading
192
+ *
193
+ * @param mergedRegions Regions merged so far, used as the reducer accumulator
194
+ * @param region The next region in original order
195
+ * @returns The accumulator with the region either appended or merged into its earlier twin
196
+ *
197
+ * @private internal utility of `deduplicateSystemMessage`
198
+ */
199
+ function mergeRegionSharingHeading(
200
+ mergedRegions: ReadonlyArray<SystemMessageRegion>,
201
+ region: SystemMessageRegion,
202
+ ): ReadonlyArray<SystemMessageRegion> {
203
+ const existingRegionIndex = mergedRegions.findIndex(
204
+ (mergedRegion) => region.titleKey !== null && mergedRegion.titleKey === region.titleKey,
205
+ );
206
+
207
+ if (existingRegionIndex === -1) {
208
+ return [...mergedRegions, region];
209
+ }
210
+
211
+ return mergedRegions.map((mergedRegion, index) =>
212
+ index !== existingRegionIndex
213
+ ? mergedRegion
214
+ : {
215
+ ...mergedRegion,
216
+ blocks: [...mergedRegion.blocks, ...markFirstBlockAsOpeningMergedSection(region.blocks)],
217
+ },
218
+ );
219
+ }
220
+
221
+ /**
222
+ * Marks the first block of a merged section occurrence so the merge seam can be rendered as one list
223
+ *
224
+ * @param blocks The blocks of the section occurrence being merged into an earlier section
225
+ * @returns The same blocks with the first one marked as opening a merged section
226
+ *
227
+ * @private internal utility of `mergeRegionSharingHeading`
228
+ */
229
+ function markFirstBlockAsOpeningMergedSection(
230
+ blocks: ReadonlyArray<SystemMessageBlock>,
231
+ ): ReadonlyArray<SystemMessageBlock> {
232
+ return blocks.map((block, index) => (index === 0 ? { ...block, isOpeningMergedSection: true } : block));
233
+ }
234
+
235
+ /**
236
+ * Keeps only the first occurrence of every identical block inside one region
237
+ *
238
+ * @param region The region whose blocks may repeat
239
+ * @returns The region without repeated blocks
240
+ *
241
+ * @private internal utility of `deduplicateSystemMessage`
242
+ */
243
+ function removeDuplicateBlocksFromRegion(region: SystemMessageRegion): SystemMessageRegion {
244
+ const alreadyRenderedTexts = new Set<string>();
245
+ const uniqueBlocks: SystemMessageBlock[] = [];
246
+ let isMergeSeamPending = false;
247
+
248
+ for (const block of region.blocks) {
249
+ if (alreadyRenderedTexts.has(block.text)) {
250
+ // Note: A removed block must still hand its merge seam over to the next block which survives
251
+ isMergeSeamPending = isMergeSeamPending || block.isOpeningMergedSection;
252
+ continue;
253
+ }
254
+
255
+ alreadyRenderedTexts.add(block.text);
256
+ uniqueBlocks.push({
257
+ text: block.text,
258
+ isOpeningMergedSection: block.isOpeningMergedSection || isMergeSeamPending,
259
+ });
260
+ isMergeSeamPending = false;
261
+ }
262
+
263
+ return { ...region, blocks: uniqueBlocks };
264
+ }
265
+
266
+ /**
267
+ * Renders one region back into its markdown representation
268
+ *
269
+ * @param region The region to render
270
+ * @returns The heading line together with its joined blocks
271
+ *
272
+ * @private internal utility of `deduplicateSystemMessage`
273
+ */
274
+ function renderRegion(region: SystemMessageRegion): string {
275
+ const body = joinBlocks(region.blocks);
276
+
277
+ if (region.headingLine === null) {
278
+ return body;
279
+ }
280
+
281
+ if (body === '') {
282
+ return region.headingLine;
283
+ }
284
+
285
+ return `${region.headingLine}${region.isBodySeparatedByBlankLine ? '\n\n' : '\n'}${body}`;
286
+ }
287
+
288
+ /**
289
+ * Joins blocks of one region back together
290
+ *
291
+ * @param blocks The blocks to join in their original order
292
+ * @returns The joined body of one region
293
+ *
294
+ * @private internal utility of `renderRegion`
295
+ */
296
+ function joinBlocks(blocks: ReadonlyArray<SystemMessageBlock>): string {
297
+ return blocks
298
+ .map((block, index) =>
299
+ index === 0 ? block.text : `${createBlockSeparator(blocks[index - 1]!, block)}${block.text}`,
300
+ )
301
+ .join('');
302
+ }
303
+
304
+ /**
305
+ * Chooses the separator between two neighboring blocks
306
+ *
307
+ * Blocks are normally separated by a blank line, exactly as they were written. Only where two sections were
308
+ * merged together their lists are joined into one compact list instead of two separate ones.
309
+ *
310
+ * @param previousBlock The block rendered before the separator
311
+ * @param nextBlock The block rendered after the separator
312
+ * @returns Either a single or a double newline
313
+ *
314
+ * @private internal utility of `joinBlocks`
315
+ */
316
+ function createBlockSeparator(previousBlock: SystemMessageBlock, nextBlock: SystemMessageBlock): string {
317
+ if (!nextBlock.isOpeningMergedSection) {
318
+ return '\n\n';
319
+ }
320
+
321
+ const previousBlockLines = previousBlock.text.split('\n');
322
+ const isListContinuing =
323
+ LIST_ITEM_PATTERN.test(previousBlockLines[previousBlockLines.length - 1]!) &&
324
+ LIST_ITEM_PATTERN.test(nextBlock.text.split('\n')[0]!);
325
+
326
+ return isListContinuing ? '\n' : '\n\n';
327
+ }
@@ -0,0 +1,132 @@
1
+ import type { string_book } from './string_book';
2
+
3
+ /**
4
+ * Commitment keyword that declares the parent agent of one book.
5
+ *
6
+ * @private utility of Agents Server inheritance resolution
7
+ */
8
+ const FROM_COMMITMENT_TYPE = 'FROM';
9
+
10
+ /**
11
+ * Matches one standalone `FROM` commitment line and captures its inline content.
12
+ *
13
+ * The Book parser accepts horizontal whitespace between a commitment keyword and its value, so inheritance resolution
14
+ * must do the same. Keeping this pattern here makes every server-side consumer agree on which `FROM` lines are real.
15
+ *
16
+ * @private utility of Agents Server inheritance resolution
17
+ */
18
+ const FROM_COMMITMENT_LINE_PATTERN = new RegExp(`^${FROM_COMMITMENT_TYPE}(?:\\s+(.*))?$`);
19
+
20
+ /**
21
+ * One explicit `FROM` commitment written in a book.
22
+ *
23
+ * @private utility of Agents Server inheritance resolution
24
+ */
25
+ export type ExplicitFromCommitment = {
26
+ /**
27
+ * Zero-based index of the line the commitment was found on, within the scanned lines.
28
+ */
29
+ readonly lineIndex: number;
30
+
31
+ /**
32
+ * Trimmed commitment content, empty string for a blank `FROM`.
33
+ */
34
+ readonly content: string;
35
+ };
36
+
37
+ /**
38
+ * Collects every explicit single-line `FROM` commitment of one book.
39
+ *
40
+ * This lightweight parser is intentionally limited to the subset needed by inheritance
41
+ * resolution so it stays safe to bundle into the Next.js proxy path.
42
+ *
43
+ * @param sourceLines - Book source already split into lines.
44
+ * @returns Found `FROM` commitments in source order, empty when the book declares no parent.
45
+ *
46
+ * @private utility of Agents Server inheritance resolution
47
+ */
48
+ export function collectExplicitFromCommitments(
49
+ sourceLines: ReadonlyArray<string>,
50
+ ): ReadonlyArray<ExplicitFromCommitment> {
51
+ const explicitFromCommitments: Array<ExplicitFromCommitment> = [];
52
+ let hasSeenTitle = false;
53
+ let isInsideCodeBlock = false;
54
+
55
+ for (let lineIndex = 0; lineIndex < sourceLines.length; lineIndex++) {
56
+ const trimmedLine = (sourceLines[lineIndex] || '').trim();
57
+
58
+ if (!hasSeenTitle) {
59
+ if (!trimmedLine) {
60
+ continue;
61
+ }
62
+
63
+ hasSeenTitle = true;
64
+ continue;
65
+ }
66
+
67
+ if (trimmedLine.startsWith('```')) {
68
+ isInsideCodeBlock = !isInsideCodeBlock;
69
+ continue;
70
+ }
71
+
72
+ if (isInsideCodeBlock) {
73
+ continue;
74
+ }
75
+
76
+ const fromCommitmentMatch = FROM_COMMITMENT_LINE_PATTERN.exec(trimmedLine);
77
+ if (fromCommitmentMatch) {
78
+ explicitFromCommitments.push({
79
+ lineIndex,
80
+ content: (fromCommitmentMatch[1] || '').trim(),
81
+ });
82
+ }
83
+ }
84
+
85
+ return explicitFromCommitments;
86
+ }
87
+
88
+ /**
89
+ * Returns the effective explicit `FROM` commitment of one book.
90
+ *
91
+ * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
92
+ *
93
+ * @param agentSource - Raw book source.
94
+ * @returns The last explicit `FROM` commitment, or `undefined` when the book declares no parent.
95
+ *
96
+ * @private utility of Agents Server inheritance resolution
97
+ */
98
+ export function getEffectiveExplicitFromCommitment(agentSource: string_book): ExplicitFromCommitment | undefined {
99
+ const explicitFromCommitments = collectExplicitFromCommitments(agentSource.split(/\r?\n/));
100
+ return explicitFromCommitments[explicitFromCommitments.length - 1];
101
+ }
102
+
103
+ /**
104
+ * Returns the effective explicit `FROM` commitment content of one book.
105
+ *
106
+ * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
107
+ *
108
+ * @param agentSource - Raw book source.
109
+ * @returns Trimmed commitment content, empty string for a blank explicit `FROM`, or `undefined` when `FROM` is absent.
110
+ *
111
+ * @private utility of Agents Server inheritance resolution
112
+ */
113
+ export function getExplicitFromCommitmentContent(agentSource: string_book): string | undefined {
114
+ return getEffectiveExplicitFromCommitment(agentSource)?.content;
115
+ }
116
+
117
+ /**
118
+ * Returns true when one book declares no parent at all and therefore implicitly inherits from `@Adam`.
119
+ *
120
+ * Writing no `FROM` commitment is equivalent to writing `FROM @Adam`, so only an explicit
121
+ * `FROM @Null` / `FROM {Void}` turns the inheritance off.
122
+ *
123
+ * @param agentSource - Raw book source.
124
+ * @returns True when the implicit `@Adam` ancestor applies to this book.
125
+ *
126
+ * @private utility of Agents Server inheritance resolution
127
+ */
128
+ export function isImplicitAdamInheritance(agentSource: string_book): boolean {
129
+ return getExplicitFromCommitmentContent(agentSource) === undefined;
130
+ }
131
+
132
+ // Note: [💞] Ignore a discrepancy between file name and exported helper names.
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Matched compact agent reference token inside commitment content.
3
+ *
4
+ * @private internal utility of agent reference resolution
5
+ */
6
+ export type AgentReferenceTokenMatch = {
7
+ /**
8
+ * Original token text, for example `{Agent Name}` or `@AgentId`.
9
+ */
10
+ readonly token: string;
11
+
12
+ /**
13
+ * Token payload used for lookup.
14
+ */
15
+ readonly reference: string;
16
+
17
+ /**
18
+ * Zero-based character offset of `token` in the scanned content.
19
+ */
20
+ readonly index: number;
21
+
22
+ /**
23
+ * Length of `token` in characters.
24
+ */
25
+ readonly length: number;
26
+ };
27
+
28
+ /**
29
+ * Matches supported compact reference token syntaxes in commitment content.
30
+ */
31
+ const AGENT_REFERENCE_TOKEN_REGEX = /(\{([^}]+)\}|@([A-Za-z0-9_-]+))/g;
32
+
33
+ /**
34
+ * Extracts compact agent-reference tokens from commitment content.
35
+ *
36
+ * @param content - Commitment content to inspect.
37
+ * @returns Matched compact reference tokens.
38
+ *
39
+ * @private internal utility of agent reference resolution
40
+ */
41
+ export function extractAgentReferenceTokens(content: string): Array<AgentReferenceTokenMatch> {
42
+ const matches: Array<AgentReferenceTokenMatch> = [];
43
+ let match: RegExpExecArray | null;
44
+
45
+ AGENT_REFERENCE_TOKEN_REGEX.lastIndex = 0;
46
+
47
+ while ((match = AGENT_REFERENCE_TOKEN_REGEX.exec(content)) !== null) {
48
+ const token = match[1];
49
+ const reference = (match[2] ?? match[3] ?? '').trim();
50
+ const index = match.index;
51
+
52
+ if (!token || index === undefined) {
53
+ continue;
54
+ }
55
+
56
+ matches.push({
57
+ token,
58
+ reference,
59
+ index,
60
+ length: token.length,
61
+ });
62
+ }
63
+
64
+ return matches;
65
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Pattern shared by Book parsing and editor highlighting for a commitment-like line.
3
+ *
4
+ * A Book commitment keyword consists of one or more all-uppercase words with at least
5
+ * two characters each. This deliberately mirrors the Book editor syntax rule so an
6
+ * unknown keyword starts a new source block everywhere it is interpreted.
7
+ *
8
+ * @private internal constant of `getBookCommitmentLineType`
9
+ */
10
+ const BOOK_COMMITMENT_LINE_TYPE_REGEX = /^\s*(?<type>[A-Z][A-Z0-9]+(?:\s+[A-Z][A-Z0-9]+)*)(?=\s|$)/;
11
+
12
+ /**
13
+ * Creates the regex used to recognize the uppercase commitment type at the beginning of a Book line.
14
+ *
15
+ * A fresh regular expression keeps Monaco tokenizer state isolated from parser calls.
16
+ *
17
+ * @returns Regular expression matching one Book commitment-like line.
18
+ *
19
+ * @private internal utility of Book parsing and `<BookEditor/>`
20
+ */
21
+ export function createBookCommitmentLineTypeRegex(): RegExp {
22
+ return new RegExp(BOOK_COMMITMENT_LINE_TYPE_REGEX.source);
23
+ }
24
+
25
+ /**
26
+ * Extracts the uppercase commitment type from a Book line, including types not registered by Promptbook.
27
+ *
28
+ * @param line - One raw Book source line.
29
+ * @returns Matched commitment type or `null` when the line does not begin with commitment syntax.
30
+ *
31
+ * @private internal utility of Book parsing and `<BookEditor/>`
32
+ */
33
+ export function getBookCommitmentLineType(line: string): string | null {
34
+ const match = BOOK_COMMITMENT_LINE_TYPE_REGEX.exec(line);
35
+ return match?.groups?.type || null;
36
+ }