@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
@@ -0,0 +1,233 @@
1
+ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
2
+ import { mkdir, rm, stat, writeFile } from 'fs/promises';
3
+ import { join } from 'path';
4
+ import type { string_agent_url } from '../../../../../src/types/typeAliases';
5
+ import {
6
+ AGENT_TEAM_CONVERSATION_MANIFEST_FILE_NAME,
7
+ AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME,
8
+ createAgentTeamConversationWorkspacePath,
9
+ createAgentTeamTeammateSourceFileName,
10
+ type AgentTeamConversationTeammate,
11
+ type AgentTeamConversationWorkspaceManifest,
12
+ } from '../../../../../src/book-3.0/AgentTeamConversationWorkspace';
13
+ import {
14
+ resolveCachedServerAgentContext,
15
+ resolveCachedServerAgentModelRequirements,
16
+ } from '../cachedServerAgentRuntime';
17
+ import { createServerAgentReferenceResolver } from '../agentReferenceResolver/createServerAgentReferenceResolver';
18
+ import { normalizeLocalServerUrls, resolveLocalAgentRouteReference } from '../localAgentRouteReferences';
19
+ import { resolveCurrentOrInternalServerOrigin } from '../resolveCurrentOrInternalServerOrigin';
20
+ import type { UserChatJobRecord } from '../userChat/UserChatJobRecord';
21
+ import type { LocalAgentFolder } from './ensureLocalAgentFolder';
22
+ import type { LocalUserChatJobMetadata } from './LocalUserChatJobMetadata';
23
+
24
+ /**
25
+ * Resolves local TEAM members and snapshots their sources for one local coding-harness job.
26
+ */
27
+ export async function prepareLocalTeamConversationWorkspace(options: {
28
+ readonly job: Pick<UserChatJobRecord, 'agentPermanentId'>;
29
+ readonly agentFolder: LocalAgentFolder;
30
+ readonly metadata: LocalUserChatJobMetadata;
31
+ readonly primaryAgentName: string;
32
+ }): Promise<void> {
33
+ const workspacePath = join(
34
+ options.agentFolder.directoryPath,
35
+ createAgentTeamConversationWorkspacePath(options.metadata.fileName),
36
+ );
37
+ const manifestPath = join(workspacePath, AGENT_TEAM_CONVERSATION_MANIFEST_FILE_NAME);
38
+
39
+ if (await isExistingPath(manifestPath)) {
40
+ return;
41
+ }
42
+
43
+ const localServerUrl = await resolveCurrentOrInternalServerOrigin();
44
+ const collection = await $provideAgentCollectionForServer();
45
+ const agentReferenceResolver = await createServerAgentReferenceResolver({
46
+ agentCollection: collection,
47
+ localServerUrl,
48
+ });
49
+ const primaryAgentContext = await resolveCachedServerAgentContext({
50
+ collection,
51
+ agentIdentifier: options.job.agentPermanentId,
52
+ localServerUrl,
53
+ fallbackResolver: agentReferenceResolver,
54
+ });
55
+ const preparedRequirements = await resolveCachedServerAgentModelRequirements({
56
+ resolvedAgentContext: primaryAgentContext,
57
+ localServerUrl,
58
+ fallbackResolver: agentReferenceResolver,
59
+ });
60
+ const teammates = await resolveLocalTeamConversationTeammates({
61
+ teammates: getPreparedTeamMetadata(preparedRequirements.modelRequirements._metadata?.teammates),
62
+ collection,
63
+ localServerUrl,
64
+ primaryAgentPermanentId: options.job.agentPermanentId,
65
+ agentReferenceResolver,
66
+ });
67
+
68
+ if (teammates.length === 0) {
69
+ return;
70
+ }
71
+
72
+ const manifest: AgentTeamConversationWorkspaceManifest = {
73
+ version: 1,
74
+ primaryAgent: {
75
+ permanentId: options.job.agentPermanentId,
76
+ agentName: options.primaryAgentName,
77
+ },
78
+ teammates: teammates.map(({ teammate }) => teammate),
79
+ };
80
+
81
+ // Note: The path is deterministically derived from this one queued message, so clearing a stale
82
+ // incomplete workspace cannot affect another user turn.
83
+ await rm(workspacePath, { recursive: true, force: true });
84
+ await mkdir(join(workspacePath, AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME), { recursive: true });
85
+ await Promise.all([
86
+ writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8'),
87
+ ...teammates.map(({ teammate, source }) =>
88
+ writeFile(
89
+ join(workspacePath, AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME, teammate.sourceFileName),
90
+ ensureTrailingNewline(source),
91
+ 'utf-8',
92
+ ),
93
+ ),
94
+ ]);
95
+ }
96
+
97
+ /**
98
+ * TEAM metadata retained by the TEAM commitment while building model requirements.
99
+ */
100
+ type PreparedTeamMetadata = {
101
+ readonly url: string;
102
+ readonly label?: string;
103
+ readonly instructions?: string;
104
+ };
105
+
106
+ /**
107
+ * One workspace teammate paired with its resolved read-only source.
108
+ */
109
+ type LocalTeamConversationTeammate = {
110
+ readonly teammate: AgentTeamConversationTeammate;
111
+ readonly source: string;
112
+ };
113
+
114
+ /**
115
+ * Extracts valid TEAM metadata from untyped commitment metadata.
116
+ */
117
+ function getPreparedTeamMetadata(value: unknown): Array<PreparedTeamMetadata> {
118
+ if (!Array.isArray(value)) {
119
+ return [];
120
+ }
121
+
122
+ return value.filter(isPreparedTeamMetadata);
123
+ }
124
+
125
+ /**
126
+ * Checks one TEAM metadata item from `AgentModelRequirements._metadata`.
127
+ */
128
+ function isPreparedTeamMetadata(value: unknown): value is PreparedTeamMetadata {
129
+ return Boolean(value && typeof value === 'object' && typeof (value as PreparedTeamMetadata).url === 'string');
130
+ }
131
+
132
+ /**
133
+ * Resolves only teammates hosted by this Agents Server, because only their durable histories can be persisted here.
134
+ */
135
+ async function resolveLocalTeamConversationTeammates(options: {
136
+ readonly teammates: ReadonlyArray<PreparedTeamMetadata>;
137
+ readonly collection: Awaited<ReturnType<typeof $provideAgentCollectionForServer>>;
138
+ readonly localServerUrl: string;
139
+ readonly primaryAgentPermanentId: string;
140
+ readonly agentReferenceResolver: Awaited<ReturnType<typeof createServerAgentReferenceResolver>>;
141
+ }): Promise<Array<LocalTeamConversationTeammate>> {
142
+ const localServerUrls = normalizeLocalServerUrls([options.localServerUrl]);
143
+ const seenPermanentIds = new Set<string>();
144
+ const resolvedTeammates: Array<LocalTeamConversationTeammate> = [];
145
+
146
+ for (const preparedTeammate of options.teammates) {
147
+ const routeReference = resolveLocalAgentRouteReference(
148
+ preparedTeammate.url as string_agent_url,
149
+ localServerUrls,
150
+ [],
151
+ );
152
+ if (!routeReference) {
153
+ continue;
154
+ }
155
+
156
+ const basicInformation = await options.collection.findAgentBasicInformation(routeReference.agentIdentifier);
157
+ const teammatePermanentId = basicInformation?.permanentId;
158
+ if (
159
+ !teammatePermanentId ||
160
+ isSamePermanentId(teammatePermanentId, options.primaryAgentPermanentId) ||
161
+ seenPermanentIds.has(teammatePermanentId)
162
+ ) {
163
+ continue;
164
+ }
165
+
166
+ const teammateContext = await resolveCachedServerAgentContext({
167
+ collection: options.collection,
168
+ agentIdentifier: teammatePermanentId,
169
+ localServerUrl: options.localServerUrl,
170
+ fallbackResolver: options.agentReferenceResolver,
171
+ });
172
+ const teammateName = preparedTeammate.label?.trim() || teammateContext.resolvedAgentName;
173
+ if (!teammateName) {
174
+ continue;
175
+ }
176
+
177
+ seenPermanentIds.add(teammatePermanentId);
178
+ resolvedTeammates.push({
179
+ teammate: {
180
+ permanentId: teammatePermanentId,
181
+ agentName: teammateName,
182
+ url: preparedTeammate.url,
183
+ instructions: preparedTeammate.instructions?.trim() || '',
184
+ sourceFileName: createAgentTeamTeammateSourceFileName(teammatePermanentId),
185
+ },
186
+ source: teammateContext.resolvedAgentSource,
187
+ });
188
+ }
189
+
190
+ return resolvedTeammates;
191
+ }
192
+
193
+ /**
194
+ * Compares permanent ids case-insensitively, matching Agents Server routing semantics.
195
+ */
196
+ function isSamePermanentId(firstPermanentId: string, secondPermanentId: string): boolean {
197
+ return firstPermanentId.toLowerCase() === secondPermanentId.toLowerCase();
198
+ }
199
+
200
+ /**
201
+ * Keeps source snapshots friendly to the Book parser and coding harness.
202
+ */
203
+ function ensureTrailingNewline(source: string): string {
204
+ return source.endsWith('\n') ? source : `${source}\n`;
205
+ }
206
+
207
+ /**
208
+ * Checks whether a fixed per-message workspace manifest already exists.
209
+ */
210
+ async function isExistingPath(path: string): Promise<boolean> {
211
+ try {
212
+ await stat(path);
213
+ return true;
214
+ } catch (error) {
215
+ if (isFileNotFoundError(error)) {
216
+ return false;
217
+ }
218
+
219
+ throw error;
220
+ }
221
+ }
222
+
223
+ /**
224
+ * Returns true when one filesystem error indicates a missing path.
225
+ */
226
+ function isFileNotFoundError(error: unknown): boolean {
227
+ return Boolean(
228
+ error &&
229
+ typeof error === 'object' &&
230
+ 'code' in error &&
231
+ ((error as { code?: string }).code === 'ENOENT' || (error as { code?: string }).code === 'ENOTDIR'),
232
+ );
233
+ }
@@ -1,19 +1,25 @@
1
1
  import type { Json } from '@/src/database/schema';
2
+ import type { ToolCall } from '@promptbook-local/types';
2
3
  import { mkdir, readFile, rm, writeFile } from 'fs/promises';
3
4
  import { join } from 'path';
4
5
  import { parseAgentSource } from '../../../../../src/book-2.0/agent-source/parseAgentSource';
5
6
  import {
6
7
  buildAgentMessageRunReportPath,
7
8
  parseAgentMessageRunReport,
9
+ type AgentMessageRunReport,
8
10
  } from '../../../../../src/book-3.0/AgentMessageRunReport';
11
+ import type { AgentMessageProjectChange } from '../../../../../src/utils/agent-message-runtime/AgentMessageProjectChange';
12
+ import type { AgentMessageTouchedExternalSource } from '../../../../../src/utils/agent-message-runtime/AgentMessageTouchedExternalSource';
13
+ import { createAnsweredMessageChipToolCalls } from '../chatMessageChips/createAnsweredMessageChipToolCalls';
9
14
  import { createUserChatJobFailureDetails } from '../userChat/createUserChatJobFailureDetails';
10
15
  import { claimNextQueuedUserChatJob } from '../userChat/claimNextQueuedUserChatJob';
11
16
  import { finalizeUserChatJob } from '../userChat/finalizeUserChatJob';
12
- import { getUserChat } from '../userChat/getUserChat';
17
+ import { getUserChatForJobRunner } from '../userChat/getUserChatForJobRunner';
13
18
  import { getUserChatJobById } from '../userChat/getUserChatJobById';
14
19
  import { persistUserChatJobTerminalState } from '../userChat/persistUserChatJobTerminalState';
15
20
  import { provideUserChatJobTable } from '../userChat/provideUserChatJobTable';
16
21
  import { updateUserChatAssistantMessage } from '../userChat/updateUserChatAssistantMessage';
22
+ import { resolveUserChatJobExecutionTiming } from '../userChat/userChatJobRunReport';
17
23
  import type { UserChatJobRecord } from '../userChat/UserChatJobRecord';
18
24
  import type { UserChatJobRow } from '../userChat/UserChatJobRow';
19
25
  import { createUserChatRunnerThreadMessages } from '../userChat/userChatMessageLifecycle';
@@ -32,11 +38,20 @@ import {
32
38
  parseLocalChatFinishedMessageBook,
33
39
  } from './localChatMessageBook';
34
40
  import { LOCAL_USER_CHAT_JOB_ANSWER_TIMEOUT_MS, LOCAL_USER_CHAT_JOB_PROVIDER } from './localChatRunnerConstants';
41
+ import {
42
+ applyLocalAgentPlannedMessageCommands,
43
+ removeLocalAgentPlannedMessagesSidecar,
44
+ type AppliedAgentPlannedMessageCommand,
45
+ } from './applyLocalAgentPlannedMessageCommands';
46
+ import { prepareLocalAgentPlannedMessagesSidecar } from './prepareLocalAgentPlannedMessagesSidecar';
35
47
  import {
36
48
  ensureLocalAgentFolder,
37
49
  loadLocalAgentSourceSnapshot,
38
50
  resolveLocalAgentRootPath,
39
51
  } from './ensureLocalAgentFolder';
52
+ import { parseFinishedLocalTeamConversations } from './parseLocalTeamConversations';
53
+ import { prepareLocalTeamConversationWorkspace } from './prepareLocalTeamConversationWorkspace';
54
+ import { persistLocalTeamConversations } from './persistLocalTeamConversations';
40
55
  import { persistLocalUserChatJobProgressFromRuntimeLog } from './persistLocalUserChatJobProgressFromRuntimeLog';
41
56
 
42
57
  /**
@@ -145,11 +160,7 @@ async function enqueueLocalUserChatJobWithinTerminalCapture(
145
160
  job: UserChatJobRecord,
146
161
  ): Promise<ProcessLocalUserChatJobResult> {
147
162
  const [chat, agentSourceSnapshot] = await Promise.all([
148
- getUserChat({
149
- userId: job.userId,
150
- agentPermanentId: job.agentPermanentId,
151
- chatId: job.chatId,
152
- }),
163
+ getUserChatForJobRunner(job),
153
164
  loadLocalAgentSourceSnapshot(job.agentPermanentId),
154
165
  ]);
155
166
 
@@ -186,6 +197,13 @@ async function enqueueLocalUserChatJobWithinTerminalCapture(
186
197
  });
187
198
  const queuedMessagePath = join(agentFolder.directoryPath, metadata.queuedPath);
188
199
 
200
+ await prepareLocalTeamConversationWorkspaceIfPossible({
201
+ job,
202
+ agentFolder,
203
+ metadata,
204
+ primaryAgentName: agentSourceSnapshot.agentName,
205
+ });
206
+ await prepareLocalAgentPlannedMessagesSidecarIfPossible({ job, agentFolder, metadata });
189
207
  await mkdir(join(agentFolder.directoryPath, 'messages', 'queued'), { recursive: true });
190
208
  await writeFile(queuedMessagePath, createLocalChatQueuedMessageBook({ messages: threadMessages }), 'utf-8');
191
209
 
@@ -207,6 +225,38 @@ async function enqueueLocalUserChatJobWithinTerminalCapture(
207
225
  return { didMutate: true, outcome: 'queued' };
208
226
  }
209
227
 
228
+ /**
229
+ * Creates the optional TEAM workspace without preventing a normal answer when a teammate cannot be resolved.
230
+ */
231
+ async function prepareLocalTeamConversationWorkspaceIfPossible(
232
+ options: Parameters<typeof prepareLocalTeamConversationWorkspace>[0],
233
+ ): Promise<void> {
234
+ try {
235
+ await prepareLocalTeamConversationWorkspace(options);
236
+ } catch (error) {
237
+ console.warn('[local-chat-runner] team_workspace_prepare_failed', {
238
+ agentPermanentId: options.job.agentPermanentId,
239
+ error,
240
+ });
241
+ }
242
+ }
243
+
244
+ /**
245
+ * Prepares the planned-message sidecar without preventing an answer when planned messages cannot be read.
246
+ */
247
+ async function prepareLocalAgentPlannedMessagesSidecarIfPossible(
248
+ options: Parameters<typeof prepareLocalAgentPlannedMessagesSidecar>[0],
249
+ ): Promise<void> {
250
+ try {
251
+ await prepareLocalAgentPlannedMessagesSidecar(options);
252
+ } catch (error) {
253
+ console.warn('[local-chat-runner] planned_messages_sidecar_prepare_failed', {
254
+ agentPermanentId: options.job.agentPermanentId,
255
+ error,
256
+ });
257
+ }
258
+ }
259
+
210
260
  /**
211
261
  * Synchronizes one already queued local job with message-folder output.
212
262
  */
@@ -224,13 +274,40 @@ async function synchronizeLocalUserChatJob(
224
274
  });
225
275
 
226
276
  if (content) {
227
- await persistLocalUserChatJobRunReportIfPresent(job, agentDirectoryPath, metadata);
277
+ const runReport = await persistLocalUserChatJobRunReportIfPresent(job, agentDirectoryPath, metadata);
278
+ const executionTiming = resolveUserChatJobExecutionTiming(runReport);
279
+ // Note: Planned messages are applied before the answer becomes terminal, so a wake-up the
280
+ // agent announced in its answer is already stored when the answer becomes visible.
281
+ const appliedPlannedMessageCommands = await applyLocalAgentPlannedMessageCommandsIfPossible({
282
+ job,
283
+ agentDirectoryPath,
284
+ metadata,
285
+ });
286
+ const teamConversations = await parseFinishedLocalTeamConversations({
287
+ agentDirectoryPath,
288
+ metadata,
289
+ job,
290
+ });
291
+ const teamToolCalls = await persistLocalTeamConversations({
292
+ job,
293
+ conversations: teamConversations,
294
+ });
295
+ const chipToolCalls = await createAnsweredMessageChipToolCallsIfPossible({
296
+ job,
297
+ appliedPlannedMessageCommands,
298
+ touchedProjectNames: runReport?.touchedProjectNames || [],
299
+ projectChanges: runReport?.projectChanges || [],
300
+ touchedExternalSources: runReport?.touchedExternalSources || [],
301
+ });
302
+ const toolCalls = [...teamToolCalls, ...chipToolCalls];
228
303
  await persistUserChatJobTerminalState({
229
304
  job,
230
305
  status: 'COMPLETED',
231
306
  provider: LOCAL_USER_CHAT_JOB_PROVIDER,
232
307
  content,
233
- generationDurationMs: resolveLocalUserChatJobDurationMs(metadata.queuedAt),
308
+ toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
309
+ executedAt: executionTiming?.executedAt,
310
+ generationDurationMs: executionTiming?.generationDurationMs,
234
311
  });
235
312
  return { didMutate: true, outcome: 'completed' };
236
313
  }
@@ -247,26 +324,26 @@ async function synchronizeLocalUserChatJob(
247
324
  return { didMutate: false, outcome: 'waiting' };
248
325
  }
249
326
 
327
+ await removeLocalAgentPlannedMessagesSidecar(agentDirectoryPath, metadata);
250
328
  await persistUserChatJobTerminalState({
251
329
  job,
252
330
  status: 'FAILED',
253
331
  provider: LOCAL_USER_CHAT_JOB_PROVIDER,
254
332
  failureReason,
255
333
  failureDetails: createLocalUserChatJobFailureDetails(job, failureReason, 'localRunnerFailedFile'),
256
- generationDurationMs: resolveLocalUserChatJobDurationMs(metadata.queuedAt),
257
334
  });
258
335
  return { didMutate: true, outcome: 'failed' };
259
336
  }
260
337
 
261
338
  if (isLocalUserChatJobTimedOut(metadata) && job.status !== 'FAILED') {
262
339
  const failureReason = 'Local agent runner did not finish the queued message within 30 minutes.';
340
+ await removeLocalAgentPlannedMessagesSidecar(agentDirectoryPath, metadata);
263
341
  await persistUserChatJobTerminalState({
264
342
  job,
265
343
  status: 'FAILED',
266
344
  provider: LOCAL_USER_CHAT_JOB_PROVIDER,
267
345
  failureReason,
268
346
  failureDetails: createLocalUserChatJobFailureDetails(job, failureReason, 'localRunnerTimeout'),
269
- generationDurationMs: resolveLocalUserChatJobDurationMs(metadata.queuedAt),
270
347
  });
271
348
  return { didMutate: true, outcome: 'failed' };
272
349
  }
@@ -284,28 +361,34 @@ async function synchronizeLocalUserChatJob(
284
361
  *
285
362
  * The report is best-effort telemetry shown in the admin task details, so any read or
286
363
  * persistence failure only logs a warning instead of failing the finished chat answer.
364
+ *
365
+ * @returns The report of the answered message, or `null` when the runner wrote none.
287
366
  */
288
367
  async function persistLocalUserChatJobRunReportIfPresent(
289
368
  job: UserChatJobRecord,
290
369
  agentDirectoryPath: string,
291
370
  metadata: LocalUserChatJobMetadata,
292
- ): Promise<void> {
371
+ ): Promise<AgentMessageRunReport | null> {
293
372
  try {
294
373
  const reportFileContent = await readOptionalTextFile(
295
374
  join(agentDirectoryPath, buildAgentMessageRunReportPath(metadata.finishedPath)),
296
375
  );
297
376
  const report = reportFileContent === null ? null : parseAgentMessageRunReport(reportFileContent);
298
377
  if (!report) {
299
- return;
378
+ return null;
300
379
  }
301
380
 
302
381
  await persistUserChatJobRunReport(job, report);
382
+
383
+ return report;
303
384
  } catch (error) {
304
385
  console.warn('[local-chat-runner] run_report_sync_failed', {
305
386
  chatId: job.chatId,
306
387
  jobId: job.id,
307
388
  error,
308
389
  });
390
+
391
+ return null;
309
392
  }
310
393
  }
311
394
 
@@ -420,9 +503,65 @@ async function removeQueuedLocalMessageIfPresent(metadata: LocalUserChatJobMetad
420
503
  return;
421
504
  }
422
505
 
423
- await rm(join(resolveLocalAgentRootPath(), metadata.agentDirectoryName, metadata.queuedPath), {
424
- force: true,
425
- }).catch(() => undefined);
506
+ const agentDirectoryPath = join(resolveLocalAgentRootPath(), metadata.agentDirectoryName);
507
+
508
+ await rm(join(agentDirectoryPath, metadata.queuedPath), { force: true }).catch(() => undefined);
509
+ await removeLocalAgentPlannedMessagesSidecar(agentDirectoryPath, metadata);
510
+ }
511
+
512
+ /**
513
+ * Applies planned-message commands without preventing an already answered message from completing.
514
+ *
515
+ * @returns The applied commands, or an empty list when the sidecar could not be applied.
516
+ */
517
+ async function applyLocalAgentPlannedMessageCommandsIfPossible(
518
+ options: Parameters<typeof applyLocalAgentPlannedMessageCommands>[0],
519
+ ): Promise<ReadonlyArray<AppliedAgentPlannedMessageCommand>> {
520
+ try {
521
+ return await applyLocalAgentPlannedMessageCommands(options);
522
+ } catch (error) {
523
+ console.warn('[local-chat-runner] planned_messages_sidecar_apply_failed', {
524
+ chatId: options.job.chatId,
525
+ jobId: options.job.id,
526
+ error,
527
+ });
528
+
529
+ return [];
530
+ }
531
+ }
532
+
533
+ /**
534
+ * Builds the chips of one answered message without preventing it from completing.
535
+ *
536
+ * The chips only enrich the answer, so a failure to resolve them never hides an answer the
537
+ * agent already produced.
538
+ *
539
+ * @returns Tool calls rendered as chips below the answer, or an empty list when they failed.
540
+ */
541
+ async function createAnsweredMessageChipToolCallsIfPossible(options: {
542
+ readonly job: UserChatJobRecord;
543
+ readonly appliedPlannedMessageCommands: ReadonlyArray<AppliedAgentPlannedMessageCommand>;
544
+ readonly touchedProjectNames: ReadonlyArray<string>;
545
+ readonly projectChanges: ReadonlyArray<AgentMessageProjectChange>;
546
+ readonly touchedExternalSources: ReadonlyArray<AgentMessageTouchedExternalSource>;
547
+ }): Promise<ReadonlyArray<ToolCall>> {
548
+ try {
549
+ return await createAnsweredMessageChipToolCalls({
550
+ agentPermanentId: options.job.agentPermanentId,
551
+ appliedPlannedMessageCommands: options.appliedPlannedMessageCommands,
552
+ touchedProjectNames: options.touchedProjectNames,
553
+ projectChanges: options.projectChanges,
554
+ touchedExternalSources: options.touchedExternalSources,
555
+ });
556
+ } catch (error) {
557
+ console.warn('[local-chat-runner] message_chips_build_failed', {
558
+ chatId: options.job.chatId,
559
+ jobId: options.job.id,
560
+ error,
561
+ });
562
+
563
+ return [];
564
+ }
426
565
  }
427
566
 
428
567
  /**
@@ -448,18 +587,6 @@ function isLocalUserChatJobTimedOut(metadata: LocalUserChatJobMetadata): boolean
448
587
  return Number.isFinite(queuedAtMs) && Date.now() - queuedAtMs >= LOCAL_USER_CHAT_JOB_ANSWER_TIMEOUT_MS;
449
588
  }
450
589
 
451
- /**
452
- * Resolves elapsed time since the local message was queued.
453
- */
454
- function resolveLocalUserChatJobDurationMs(queuedAt: string): number | undefined {
455
- const queuedAtMs = Date.parse(queuedAt);
456
- if (!Number.isFinite(queuedAtMs)) {
457
- return undefined;
458
- }
459
-
460
- return Math.max(0, Date.now() - queuedAtMs);
461
- }
462
-
463
590
  /**
464
591
  * Returns true when one filesystem error indicates a missing path.
465
592
  */
@@ -8,7 +8,7 @@ import { spaceTrim } from 'spacetrim';
8
8
  export const MAN_GO_BOOK_EXPERT_BOOK = spaceTrim(`
9
9
  Book expert
10
10
 
11
- PERSONA You are expert in book language
11
+ GOAL Help users work with Book language.
12
12
  RULE You can work with the book language and write, modify, or consult the agents based on the book language.
13
13
 
14
14
  KNOWLEDGE https://live.ptbk.io/api/docs/book-language.md?language=en
@@ -20,9 +20,7 @@ export const MAN_GO_BOOK_EXPERT_BOOK = spaceTrim(`
20
20
  \`\`\`book
21
21
  Paul Smith & Associés
22
22
 
23
- PERSONA You are a company lawyer.
24
- Your job is to provide legal advice and support to the company and its employees.
25
- You are knowledgeable, professional, and detail-oriented.
23
+ GOAL Provide knowledgeable, professional, and detail-oriented legal advice and support to the company and its employees.
26
24
  \`\`\`
27
25
 
28
26
  RULE You are writing a book in the language the user will ask you.
@@ -36,9 +34,7 @@ export const MAN_GO_BOOK_EXPERT_BOOK = spaceTrim(`
36
34
  \`\`\`book
37
35
  Mario Ferrari
38
36
 
39
- PERSONA You are an Italian teacher.
40
- You teach the Italian language.
41
- You are knowledgeable, professional and detail-oriented.
37
+ GOAL Teach Italian as a knowledgeable, professional, and detail-oriented teacher.
42
38
  RULE Do not chat about anything other than Italian. You can speak Italian or discuss Italian grammar in English.
43
39
  LANGUAGES Italian, English
44
40
  \`\`\`
@@ -51,9 +47,7 @@ export const MAN_GO_BOOK_EXPERT_BOOK = spaceTrim(`
51
47
  \`\`\`book
52
48
  Mario Ferrari
53
49
 
54
- PERSONA Jste učitel italštiny.
55
- Učíte italský jazyk.
56
- Jste znalý, profesionální a dbáte na detaily.
50
+ GOAL Učte italštinu jako znalý, profesionální učitel, který dbá na detaily.
57
51
  RULE Nepovídejte si o ničem jiném než o italštině. Můžete mluvit italsky nebo diskutovat o italské gramatice v angličtině.
58
52
  LANGUAGES Italština, čeština, angličtina
59
53
  \`\`\`
@@ -69,6 +63,6 @@ export const MAN_GO_BOOK_EXPERT_BOOK = spaceTrim(`
69
63
  export const MAN_GO_REPLY_REVIEWER_BOOK = spaceTrim(`
70
64
  Kontrolor odpovědí
71
65
 
72
- PERSONA Jste přísný kontrolor odpovědí zákaznické podpory. Porovnáváte návrh odpovědi s definicí agenta (book) - tonalita, délka, jazyk, zakázaná témata a dodržení instrukcí.
66
+ GOAL Přísně kontrolujte návrhy odpovědí zákaznické podpory proti definici agenta (book): tonalitu, délku, jazyk, zakázaná témata a dodržení instrukcí.
73
67
  RULE Odpovídáte výhradně požadovaným JSON polem v jednom \`json\` bloku, nic jiného.
74
68
  `);
@@ -65,7 +65,7 @@ export type EvaluateManGoAgentReplyInput = {
65
65
  const MAN_GO_TEST_FALLBACK_BOOK = spaceTrim(`
66
66
  Agent
67
67
 
68
- PERSONA Jste užitečný asistent.
68
+ GOAL Pomáhejte uživatelům jako užitečný asistent.
69
69
  RULE Odpovídejte stručně a prakticky.
70
70
  CLOSED
71
71
  `);
@@ -127,7 +127,7 @@ function createBookPrompt(input: GenerateManGoBookInput): string {
127
127
  Requirements:
128
128
  - Use the provided name as the agent title.
129
129
  - Write natural-language commitments in Czech unless the brief clearly asks for another language.
130
- - Include a useful PERSONA, GOAL, and practical RULE commitments derived from the description.
130
+ - Include a clear GOAL and practical RULE commitments derived from the description.
131
131
  - Keep commitment keywords in English.
132
132
  - Use Book-language commitments such as WRITING SAMPLE, WRITING RULES, MESSAGE SUFFIX, and NOTE when they fit the agent.
133
133
  - Do not use Markdown headings such as \`##\` as a substitute for Book-language commitments.
@@ -332,7 +332,7 @@ export const MANAGEMENT_API_EXAMPLES = {
332
332
  },
333
333
  source: spaceTrim(`
334
334
  Support Concierge
335
- PERSONA You triage support tickets.
335
+ GOAL Triage support tickets.
336
336
  RULE Escalate billing issues.
337
337
  `),
338
338
  profile: {
@@ -346,7 +346,7 @@ export const MANAGEMENT_API_EXAMPLES = {
346
346
  createAgentRequest: {
347
347
  source: spaceTrim(`
348
348
  Support Concierge
349
- PERSONA You triage support tickets.
349
+ GOAL Triage support tickets.
350
350
  RULE Escalate billing issues.
351
351
  `),
352
352
  folderId: 12,
@@ -0,0 +1,14 @@
1
+ import type { string_promptbook_server_url } from '@promptbook-local/types';
2
+
3
+ /**
4
+ * Parses a comma-separated federated-server metadata value.
5
+ *
6
+ * @param value - Raw stored metadata value.
7
+ * @returns Normalized non-empty server URL values.
8
+ */
9
+ export function parseFederatedServers(value: string | null | undefined): Array<string_promptbook_server_url> {
10
+ return (value || '')
11
+ .split(',')
12
+ .map((serverUrl) => serverUrl.trim())
13
+ .filter((serverUrl): serverUrl is string_promptbook_server_url => serverUrl !== '');
14
+ }
@@ -0,0 +1,35 @@
1
+ import { AGENT_GOAL_CHAT_PLANNED_MESSAGE_ACTIONS } from '../agentGoalChat/agentGoalChatPlannedMessageActions';
2
+ import { getUserChatTimeoutById } from '../userChatTimeout';
3
+
4
+ /**
5
+ * Outcome of cancelling one planned message from the admin manager.
6
+ *
7
+ * @private internal admin utility of Agents Server
8
+ */
9
+ export type CancelManagedPlannedMessageResult = 'cancelled' | 'not_found';
10
+
11
+ /**
12
+ * Cancels one planned message of any agent, so it never wakes that agent again.
13
+ *
14
+ * The cancelled planned message is kept and keeps being listed as cancelled, because the manager is
15
+ * also the place where an administrator asks what a planned message did before it stopped.
16
+ *
17
+ * @param timeoutId - Id of the planned message being cancelled.
18
+ * @returns Whether the planned message was cancelled.
19
+ *
20
+ * @private internal admin utility of Agents Server
21
+ */
22
+ export async function cancelManagedPlannedMessage(timeoutId: string): Promise<CancelManagedPlannedMessageResult> {
23
+ const existingPlannedMessage = await getUserChatTimeoutById(timeoutId);
24
+
25
+ if (!existingPlannedMessage) {
26
+ return 'not_found';
27
+ }
28
+
29
+ const cancelResult = await AGENT_GOAL_CHAT_PLANNED_MESSAGE_ACTIONS.cancel({
30
+ agentPermanentId: existingPlannedMessage.agentPermanentId,
31
+ timeoutId,
32
+ });
33
+
34
+ return cancelResult.status === 'cancelled' ? 'cancelled' : 'not_found';
35
+ }