@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,106 @@
1
+ import { AGENTS_FILE_PATH, getDefaultCoderAgentsFileContent } from './agentsFile';
2
+ import type { CoderPromptTemplateDefinition, InitializationStatus } from './boilerplateTemplates';
3
+ import {
4
+ ensureDefaultCoderPromptTemplateFile,
5
+ getDefaultCoderProjectPromptTemplateDefinitions,
6
+ } from './boilerplateTemplates';
7
+ import { CODER_DEVELOPER_AGENT_FILE_PATH, ensureCoderDeveloperAgentFile } from './ensureCoderDeveloperAgentFile';
8
+ import { ensureCoderMarkdownFile } from './ensureCoderMarkdownFile';
9
+
10
+ /**
11
+ * Status of one artifact referenced by the default coder scripts.
12
+ *
13
+ * `not-referenced` means that no newly added script points at the artifact, so `ptbk coder init` left it alone.
14
+ *
15
+ * @private internal utility of `coder init` command
16
+ */
17
+ export type CoderReferencedArtifactStatus = InitializationStatus | 'not-referenced';
18
+
19
+ /**
20
+ * Result of ensuring one artifact referenced by the default coder scripts.
21
+ *
22
+ * @private internal utility of `coder init` command
23
+ */
24
+ export type EnsuredCoderReferencedArtifact = {
25
+ /**
26
+ * Project-relative path of the referenced artifact.
27
+ */
28
+ readonly relativeFilePath: string;
29
+
30
+ /**
31
+ * Status describing whether the artifact had to be created.
32
+ */
33
+ readonly status: CoderReferencedArtifactStatus;
34
+ };
35
+
36
+ /**
37
+ * One project artifact which the default coder scripts point at.
38
+ */
39
+ type CoderReferencedArtifactDefinition = {
40
+ /**
41
+ * Project-relative path which both identifies the artifact and locates it inside the project.
42
+ */
43
+ readonly relativeFilePath: string;
44
+
45
+ /**
46
+ * Creates the artifact when it is missing, never overwriting an existing one.
47
+ */
48
+ readonly ensureArtifactFile: (projectPath: string) => Promise<InitializationStatus>;
49
+ };
50
+
51
+ /**
52
+ * Creates the artifact definition of one project-owned coder prompt template.
53
+ */
54
+ function createCoderPromptTemplateArtifactDefinition(
55
+ definition: CoderPromptTemplateDefinition,
56
+ ): CoderReferencedArtifactDefinition {
57
+ return {
58
+ relativeFilePath: definition.relativeFilePath,
59
+ ensureArtifactFile: (projectPath) => ensureDefaultCoderPromptTemplateFile(projectPath, definition),
60
+ };
61
+ }
62
+
63
+ /**
64
+ * Every artifact which the default coder scripts can reference.
65
+ */
66
+ const CODER_REFERENCED_ARTIFACT_DEFINITIONS: ReadonlyArray<CoderReferencedArtifactDefinition> = [
67
+ {
68
+ relativeFilePath: CODER_DEVELOPER_AGENT_FILE_PATH,
69
+ ensureArtifactFile: ensureCoderDeveloperAgentFile,
70
+ },
71
+ {
72
+ relativeFilePath: AGENTS_FILE_PATH,
73
+ ensureArtifactFile: (projectPath) =>
74
+ ensureCoderMarkdownFile(projectPath, AGENTS_FILE_PATH, getDefaultCoderAgentsFileContent()),
75
+ },
76
+ ...getDefaultCoderProjectPromptTemplateDefinitions().map(createCoderPromptTemplateArtifactDefinition),
77
+ ];
78
+
79
+ /**
80
+ * Creates only those referenced artifacts which the freshly added coder scripts point at.
81
+ *
82
+ * An artifact of a script which the project already defines is intentionally **not** created - the project-owned
83
+ * script is kept as is, so it does not reference the default artifact in the first place.
84
+ *
85
+ * @private function of `initializeCoderProjectConfiguration`
86
+ */
87
+ export async function ensureCoderReferencedArtifacts(
88
+ projectPath: string,
89
+ referencedArtifactPaths: ReadonlySet<string>,
90
+ ): Promise<ReadonlyArray<EnsuredCoderReferencedArtifact>> {
91
+ const ensuredArtifacts: Array<EnsuredCoderReferencedArtifact> = [];
92
+
93
+ for (const { relativeFilePath, ensureArtifactFile } of CODER_REFERENCED_ARTIFACT_DEFINITIONS) {
94
+ if (!referencedArtifactPaths.has(relativeFilePath)) {
95
+ ensuredArtifacts.push({ relativeFilePath, status: 'not-referenced' });
96
+ continue;
97
+ }
98
+
99
+ ensuredArtifacts.push({ relativeFilePath, status: await ensureArtifactFile(projectPath) });
100
+ }
101
+
102
+ return ensuredArtifacts;
103
+ }
104
+
105
+ // Note: [🟡] Code for coder init referenced artifacts [coderReferencedArtifacts](src/cli/cli-commands/coder/coderReferencedArtifacts.ts) should never be published outside of `@promptbook/cli`
106
+ // Note: [💞] Ignore a discrepancy between file name and exported helper names
@@ -1,7 +1,6 @@
1
1
  import { copyFile, stat } from 'fs/promises';
2
2
  import { join } from 'path';
3
- import { spaceTrim } from 'spacetrim';
4
- import { NotAllowed } from '../../../errors/NotAllowed';
3
+ import { resolveBundledAgentBookPath } from '../common/resolveBundledAgentBookPath';
5
4
  import type { InitializationStatus } from './boilerplateTemplates';
6
5
 
7
6
  /**
@@ -36,35 +35,10 @@ export async function ensureCoderDeveloperAgentFile(projectPath: string): Promis
36
35
  return 'unchanged';
37
36
  }
38
37
 
39
- await copyFile(await resolveDefaultCoderDeveloperAgentFilePath(), absoluteFilePath);
38
+ await copyFile(await resolveBundledAgentBookPath(DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH), absoluteFilePath);
40
39
  return 'created';
41
40
  }
42
41
 
43
- /**
44
- * Resolves the bundled developer agent from a source checkout or generated CLI package.
45
- */
46
- async function resolveDefaultCoderDeveloperAgentFilePath(): Promise<string> {
47
- const candidates = [
48
- join(__dirname, '..', DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH),
49
- join(__dirname, '..', '..', '..', '..', DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH),
50
- ];
51
-
52
- for (const candidate of candidates) {
53
- if (await isExistingFile(candidate)) {
54
- return candidate;
55
- }
56
- }
57
-
58
- throw new NotAllowed(
59
- spaceTrim(`
60
- Cannot find the bundled Promptbook developer agent.
61
-
62
- Checked:
63
- ${candidates.map((candidate) => `- \`${candidate}\``).join('\n')}
64
- `),
65
- );
66
- }
67
-
68
42
  /**
69
43
  * Checks whether a path exists and is a file.
70
44
  */
@@ -1,6 +1,8 @@
1
1
  import { getPromptbookTemporaryGitignoreRule } from '../../../utils/filesystem/promptbookTemporaryPath';
2
+ import { PROMPT_RUNNER_HARNESS_NAMES, type PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
3
+ import { getHarnessProjectGitignoreRules } from '../common/harness/HarnessDefinition';
2
4
  import type { InitializationStatus } from './boilerplateTemplates';
3
- import { ensureProjectGitignoreFile } from '../common/projectInitialization';
5
+ import { ensureProjectGitignoreFile, getMissingProjectGitignoreRules } from '../common/projectInitialization';
4
6
 
5
7
  /**
6
8
  * Promptbook temporary root directory that should stay out of version control.
@@ -18,15 +20,47 @@ const CODER_ENV_GITIGNORE_RULE = '.env';
18
20
  const CODER_GITIGNORE_HEADER = '# Promptbook Coder';
19
21
 
20
22
  /**
21
- * Ensures `.gitignore` contains the standalone Promptbook temp entry.
23
+ * Coder-owned local artifacts which every initialized project should ignore.
24
+ */
25
+ const CODER_GITIGNORE_RULES = [PROMPTBOOK_TEMP_GITIGNORE_RULE, CODER_ENV_GITIGNORE_RULE] as const;
26
+
27
+ /**
28
+ * Ensures `.gitignore` contains Promptbook Coder's local artifacts and every supported harness's local artifacts.
22
29
  *
23
30
  * @private function of `initializeCoderProjectConfiguration`
24
31
  */
25
32
  export async function ensureCoderGitignoreFile(projectPath: string): Promise<InitializationStatus> {
33
+ return ensureCoderGitignoreRules(projectPath, [
34
+ ...CODER_GITIGNORE_RULES,
35
+ ...getHarnessProjectGitignoreRules(PROMPT_RUNNER_HARNESS_NAMES),
36
+ ]);
37
+ }
38
+
39
+ /**
40
+ * Lists missing project-local ignore rules for the selected harnesses.
41
+ *
42
+ * @private internal utility of `ptbk coder`
43
+ */
44
+ export async function getMissingCoderHarnessGitignoreRules(
45
+ projectPath: string,
46
+ harnessNames: ReadonlyArray<PromptRunnerHarnessName>,
47
+ ): Promise<ReadonlyArray<string>> {
48
+ return getMissingProjectGitignoreRules(projectPath, getHarnessProjectGitignoreRules(harnessNames));
49
+ }
50
+
51
+ /**
52
+ * Adds the given Promptbook Coder rules to a project's `.gitignore` file.
53
+ *
54
+ * @private internal utility of `ptbk coder`
55
+ */
56
+ export async function ensureCoderGitignoreRules(
57
+ projectPath: string,
58
+ rules: ReadonlyArray<string>,
59
+ ): Promise<InitializationStatus> {
26
60
  return ensureProjectGitignoreFile({
27
61
  projectPath,
28
62
  blockHeader: CODER_GITIGNORE_HEADER,
29
- rules: [PROMPTBOOK_TEMP_GITIGNORE_RULE, CODER_ENV_GITIGNORE_RULE],
63
+ rules,
30
64
  });
31
65
  }
32
66
 
@@ -1,5 +1,5 @@
1
- import type { InitializationStatus } from './boilerplateTemplates';
2
1
  import { getDefaultCoderPackageJsonScripts } from './getDefaultCoderPackageJsonScripts';
2
+ import type { MergedStringRecordJsonFile } from './mergeStringRecordJsonFile';
3
3
  import { mergeStringRecordJsonFile } from './mergeStringRecordJsonFile';
4
4
 
5
5
  /**
@@ -10,9 +10,11 @@ const PACKAGE_JSON_FILE_PATH = 'package.json';
10
10
  /**
11
11
  * Ensures `package.json` contains the standalone Promptbook coder helper scripts.
12
12
  *
13
+ * Scripts which the project already defines are kept as they are, only missing ones are added.
14
+ *
13
15
  * @private function of `initializeCoderProjectConfiguration`
14
16
  */
15
- export async function ensureCoderPackageJsonFile(projectPath: string): Promise<InitializationStatus> {
17
+ export async function ensureCoderPackageJsonFile(projectPath: string): Promise<MergedStringRecordJsonFile> {
16
18
  return mergeStringRecordJsonFile({
17
19
  projectPath,
18
20
  relativeFilePath: PACKAGE_JSON_FILE_PATH,
@@ -15,18 +15,22 @@ const VSCODE_DIRECTORY_PATH = '.vscode';
15
15
  /**
16
16
  * Ensures VS Code routes pasted prompt images into `prompts/screenshots`.
17
17
  *
18
+ * Settings which the project already defines are kept as they are, only missing ones are added.
19
+ *
18
20
  * @private function of `initializeCoderProjectConfiguration`
19
21
  */
20
22
  export async function ensureCoderVscodeSettingsFile(projectPath: string): Promise<InitializationStatus> {
21
23
  const [fieldPath, nextEntries] = resolveDefaultCoderVscodeSettingsEntry();
22
24
 
23
- return mergeStringRecordJsonFile({
25
+ const { status } = await mergeStringRecordJsonFile({
24
26
  projectPath,
25
27
  relativeFilePath: VSCODE_SETTINGS_FILE_PATH,
26
28
  fieldPath,
27
29
  nextEntries,
28
30
  ensureParentDirectoryPath: VSCODE_DIRECTORY_PATH,
29
31
  });
32
+
33
+ return status;
30
34
  }
31
35
 
32
36
  /**
@@ -1,4 +1,4 @@
1
- import { mkdir, stat } from 'fs/promises';
1
+ import { mkdir, readdir, stat } from 'fs/promises';
2
2
  import { join } from 'path';
3
3
  import type { InitializationStatus } from './boilerplateTemplates';
4
4
 
@@ -22,6 +22,25 @@ export async function ensureDirectory(
22
22
  return 'unchanged';
23
23
  }
24
24
 
25
+ /**
26
+ * Checks whether a project-relative directory is missing or contains no entries.
27
+ *
28
+ * @private internal utility of `coder init` command
29
+ */
30
+ export async function isDirectoryEmpty(projectPath: string, relativeDirectoryPath: string): Promise<boolean> {
31
+ const directoryPath = join(projectPath, relativeDirectoryPath);
32
+
33
+ try {
34
+ return (await readdir(directoryPath)).length === 0;
35
+ } catch (error) {
36
+ if (isNodeJsErrorWithCode(error, 'ENOENT')) {
37
+ return true;
38
+ }
39
+
40
+ throw error;
41
+ }
42
+ }
43
+
25
44
  /**
26
45
  * Checks whether a path exists and is a directory.
27
46
  */
@@ -33,4 +52,11 @@ async function isExistingDirectory(path: string): Promise<boolean> {
33
52
  }
34
53
  }
35
54
 
55
+ /**
56
+ * Checks whether a caught value is a Node.js error with the given error code.
57
+ */
58
+ function isNodeJsErrorWithCode(error: unknown, code: string): error is NodeJS.ErrnoException {
59
+ return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
60
+ }
61
+
36
62
  // Note: [🟡] Code for coder init directory creation [ensureDirectory](src/cli/cli-commands/coder/ensureDirectory.ts) should never be published outside of `@promptbook/cli`
@@ -39,7 +39,7 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
39
39
  command.description(
40
40
  spaceTrim(
41
41
  (block) => `
42
- Generate prompt boilerplate files with unique emoji tags
42
+ Generate prompt boilerplate files with one unique emoji tag per file
43
43
 
44
44
  ${block(CODER_GIT_SYNC_DESCRIPTION)}
45
45
  `,
@@ -71,11 +71,11 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
71
71
  const projectPath = process.cwd();
72
72
 
73
73
  // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
74
- const { $commitCoderChanges, $pullCoderChanges } = await import(
74
+ const { $commitCoderChanges, $startCoderGitSync } = await import(
75
75
  '../../../../scripts/run-codex-prompts/git/coderGitSync'
76
76
  );
77
77
 
78
- await $pullCoderChanges({ gitSync, projectPath });
78
+ const commitScope = await $startCoderGitSync({ gitSync, projectPath });
79
79
 
80
80
  await generatePromptBoilerplate({
81
81
  projectPath,
@@ -85,7 +85,7 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
85
85
 
86
86
  await $commitCoderChanges({
87
87
  gitSync,
88
- projectPath,
88
+ commitScope,
89
89
  commitMessage: `Prompts ${formatBoilerplateCount(boilerplateCount)}`,
90
90
  });
91
91
 
@@ -95,7 +95,7 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
95
95
  }
96
96
 
97
97
  /**
98
- * Generates boilerplate prompt files with unique emoji tags.
98
+ * Generates boilerplate prompt files with one unique emoji tag per file.
99
99
  *
100
100
  * @private internal function of `generatePromptBoilerplate` command
101
101
  */
@@ -134,10 +134,10 @@ export async function generatePromptBoilerplate({
134
134
  colors.blue(`Highest existing number for ${promptNumbering.datePrefix} found: ${highestNumberFormatted}`),
135
135
  );
136
136
 
137
- // Note: Every single generated prompt is one separate coding task, so each of them reserves its own fresh emoji tag
138
137
  const promptsCount = filesCount * promptsPerFileCount;
139
138
  const { availableCount, selectedEmojis } = await getFreshPromptEmojiTags({
140
- count: promptsCount,
139
+ // Note: Each generated file reserves one fresh emoji tag shared by all of its prompt sections
140
+ count: filesCount,
141
141
  rootDir: projectPath,
142
142
  });
143
143
 
@@ -154,9 +154,7 @@ export async function generatePromptBoilerplate({
154
154
  for (let i = 0; i < filesCount; i++) {
155
155
  const number = promptNumbering.startNumber + i * promptNumbering.step;
156
156
  const title = titles[i % titles.length]!;
157
- const emojiTags = selectedEmojis
158
- .slice(i * promptsPerFileCount, (i + 1) * promptsPerFileCount)
159
- .map((emoji) => formatPromptEmojiTag(emoji));
157
+ const emojiTag = formatPromptEmojiTag(selectedEmojis[i]!);
160
158
  const filename = buildPromptFilename(
161
159
  promptNumbering.datePrefix,
162
160
  number,
@@ -165,7 +163,8 @@ export async function generatePromptBoilerplate({
165
163
  const filepath = join(PROMPTS_DIRECTORY_PATH, filename);
166
164
  const absoluteFilepath = join(projectPath, filepath);
167
165
  const content = buildBoilerplatePromptFileContent({
168
- emojiTags,
166
+ emojiTag,
167
+ promptsPerFileCount,
169
168
  title,
170
169
  body: promptTemplate.content,
171
170
  });
@@ -175,7 +174,7 @@ export async function generatePromptBoilerplate({
175
174
  absoluteFilepath,
176
175
  filename,
177
176
  content,
178
- emojiTags,
177
+ emojiTag,
179
178
  number,
180
179
  });
181
180
  }
@@ -185,7 +184,7 @@ export async function generatePromptBoilerplate({
185
184
 
186
185
  for (const file of filesToCreate) {
187
186
  writeFileSync(file.absoluteFilepath, file.content, 'utf-8');
188
- console.info(colors.green(`✓ Created: ${file.filename} with ${file.emojiTags.join(' ')}`));
187
+ console.info(colors.green(`✓ Created: ${file.filename} with ${file.emojiTag}`));
189
188
  }
190
189
 
191
190
  console.info(
@@ -196,31 +195,32 @@ export async function generatePromptBoilerplate({
196
195
  }
197
196
 
198
197
  /**
199
- * Builds the markdown content of one generated prompt file with one prompt section per emoji tag.
198
+ * Builds the markdown content of one generated prompt file with one prompt section per prompt.
200
199
  *
201
- * Multiple prompts in one file are separated by the `---` separator, exactly like the prompt runner expects them.
200
+ * Multiple prompts in one file share the file emoji tag and are separated by the `---` separator,
201
+ * exactly like the prompt runner expects them.
202
202
  *
203
203
  * @private internal utility of `generatePromptBoilerplate` command
204
204
  */
205
205
  function buildBoilerplatePromptFileContent({
206
- emojiTags,
206
+ emojiTag,
207
+ promptsPerFileCount,
207
208
  title,
208
209
  body,
209
210
  }: {
210
- readonly emojiTags: ReadonlyArray<string>;
211
+ readonly emojiTag: string;
212
+ readonly promptsPerFileCount: number;
211
213
  readonly title: string;
212
214
  readonly body: string;
213
215
  }): string {
214
- return emojiTags
215
- .map((emojiTag) =>
216
- buildCoderPromptSection({
217
- statusLine: '[-]',
218
- emojiTag,
219
- title,
220
- body,
221
- }),
222
- )
223
- .join('\n\n---\n\n');
216
+ return Array.from({ length: promptsPerFileCount }, () =>
217
+ buildCoderPromptSection({
218
+ statusLine: '[-]',
219
+ emojiTag,
220
+ title,
221
+ body,
222
+ }),
223
+ ).join('\n\n---\n\n');
224
224
  }
225
225
 
226
226
  /**
@@ -1,16 +1,78 @@
1
+ import { AGENTS_FILE_PATH } from './agentsFile';
1
2
  import { DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE } from './boilerplateCount';
3
+ import { COMMON_PROMPT_TEMPLATE_FILE_PATH } from './boilerplateTemplates';
4
+ import { CODER_DEVELOPER_AGENT_FILE_PATH } from './ensureCoderDeveloperAgentFile';
5
+ import { formatDisplayPath } from './formatDisplayPath';
6
+
7
+ /**
8
+ * Name of the npm script which `ptbk coder run` uses to verify the project.
9
+ */
10
+ const CODER_TEST_SCRIPT_NAME = 'test-for-ptbk-coder';
11
+
12
+ /**
13
+ * One npm script initialized by `ptbk coder init`.
14
+ */
15
+ type CoderPackageJsonScriptDefinition = {
16
+ /**
17
+ * Name of the npm script.
18
+ */
19
+ readonly scriptName: string;
20
+
21
+ /**
22
+ * Shell command of the npm script.
23
+ */
24
+ readonly scriptCommand: string;
25
+
26
+ /**
27
+ * Project-relative paths of the artifacts the command points at.
28
+ *
29
+ * They are created only together with the script itself, never for a script the project already defines.
30
+ */
31
+ readonly referencedArtifactPaths: ReadonlyArray<string>;
32
+ };
2
33
 
3
34
  /**
4
35
  * Default npm scripts initialized by `ptbk coder init`.
36
+ *
37
+ * Note: Using NPX because `ptbk` can be installed globally or locally, and NPX will resolve it correctly in either case.
5
38
  */
6
- const DEFAULT_CODER_PACKAGE_JSON_SCRIPTS = {
7
- 'coder:generate-boilerplates': `ptbk coder generate-boilerplates --count ${DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE} --template ./prompts/templates/common.md`,
8
- 'coder:add': 'ptbk coder add --template ./prompts/templates/common.md',
9
- 'coder:run':
10
- 'ptbk coder run --harness openai-codex --model gpt-5.6-terra --thinking-level max --agent agents/developer.book --context AGENTS.md --test-before yes-and-fix',
11
- // 'coder:find-refactor-candidates': 'npx ptbk coder find-refactor-candidates',
12
- 'coder:verify': 'ptbk coder verify',
13
- } as const satisfies Readonly<Record<string, string>>;
39
+ const DEFAULT_CODER_PACKAGE_JSON_SCRIPT_DEFINITIONS: ReadonlyArray<CoderPackageJsonScriptDefinition> = [
40
+ {
41
+ scriptName: 'coder:generate-boilerplates',
42
+ scriptCommand: `npx ptbk coder generate-boilerplates --count ${DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE} --template ${formatCoderScriptFilePath(
43
+ COMMON_PROMPT_TEMPLATE_FILE_PATH,
44
+ )}`,
45
+ referencedArtifactPaths: [COMMON_PROMPT_TEMPLATE_FILE_PATH],
46
+ },
47
+ {
48
+ scriptName: 'coder:add',
49
+ scriptCommand: `npx ptbk coder add --template ${formatCoderScriptFilePath(COMMON_PROMPT_TEMPLATE_FILE_PATH)}`,
50
+ referencedArtifactPaths: [COMMON_PROMPT_TEMPLATE_FILE_PATH],
51
+ },
52
+ {
53
+ scriptName: 'coder:run',
54
+ scriptCommand: [
55
+ 'npx ptbk coder run --harness openai-codex --thinking-level max',
56
+ `--agent ${formatDisplayPath(CODER_DEVELOPER_AGENT_FILE_PATH)}`,
57
+ `--context ${formatDisplayPath(AGENTS_FILE_PATH)}`,
58
+ `--test "npm run ${CODER_TEST_SCRIPT_NAME}" --test-before yes-and-fix`,
59
+ ].join(' '),
60
+ referencedArtifactPaths: [CODER_DEVELOPER_AGENT_FILE_PATH, AGENTS_FILE_PATH],
61
+ },
62
+ // { scriptName: 'coder:find-refactor-candidates', scriptCommand: 'npx ptbk coder find-refactor-candidates', referencedArtifactPaths: [] },
63
+ {
64
+ scriptName: 'coder:verify',
65
+ scriptCommand: 'npx ptbk coder verify',
66
+ referencedArtifactPaths: [],
67
+ },
68
+ {
69
+ // Note: The verification command of `coder:run` is a project-owned script, so every project can decide
70
+ // what "verified" means without touching the `coder:run` script itself
71
+ scriptName: CODER_TEST_SCRIPT_NAME,
72
+ scriptCommand: 'npm test',
73
+ referencedArtifactPaths: [],
74
+ },
75
+ ];
14
76
 
15
77
  /**
16
78
  * Lists the default npm scripts initialized by `ptbk coder init`.
@@ -18,7 +80,35 @@ const DEFAULT_CODER_PACKAGE_JSON_SCRIPTS = {
18
80
  * @private internal utility of `coder init` command
19
81
  */
20
82
  export function getDefaultCoderPackageJsonScripts(): Readonly<Record<string, string>> {
21
- return DEFAULT_CODER_PACKAGE_JSON_SCRIPTS;
83
+ return Object.fromEntries(
84
+ DEFAULT_CODER_PACKAGE_JSON_SCRIPT_DEFINITIONS.map(({ scriptName, scriptCommand }) => [
85
+ scriptName,
86
+ scriptCommand,
87
+ ]),
88
+ );
89
+ }
90
+
91
+ /**
92
+ * Collects the project-relative artifact paths referenced by the given default coder scripts.
93
+ *
94
+ * @private internal utility of `coder init` command
95
+ */
96
+ export function resolveCoderPackageJsonScriptReferencedArtifactPaths(
97
+ scriptNames: ReadonlyArray<string>,
98
+ ): ReadonlySet<string> {
99
+ return new Set(
100
+ DEFAULT_CODER_PACKAGE_JSON_SCRIPT_DEFINITIONS.filter(({ scriptName }) => scriptNames.includes(scriptName))
101
+ .map(({ referencedArtifactPaths }) => referencedArtifactPaths)
102
+ .flat(),
103
+ );
104
+ }
105
+
106
+ /**
107
+ * Formats one project-relative path as an explicitly project-rooted path usable inside a shell command.
108
+ */
109
+ function formatCoderScriptFilePath(relativeFilePath: string): string {
110
+ return `./${formatDisplayPath(relativeFilePath)}`;
22
111
  }
23
112
 
24
113
  // Note: [🟡] Code for coder init package scripts [getDefaultCoderPackageJsonScripts](src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.ts) should never be published outside of `@promptbook/cli`
114
+ // Note: [💞] Ignore a discrepancy between file name and exported helper names
@@ -3,6 +3,7 @@ import type {
3
3
  } from 'commander';
4
4
  import { spaceTrim } from 'spacetrim';
5
5
  import type { $side_effect } from '../../../utils/organization/$side_effect';
6
+ import { ADAM_AGENT_BOOK_RELATIVE_PATH } from '../common/ensureAdamAgentBook';
6
7
  import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
7
8
  import {
8
9
  addCoderGitSyncOptions,
@@ -12,12 +13,18 @@ import {
12
13
  import { handleActionErrors } from '../common/handleActionErrors';
13
14
  import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
14
15
  import { getHarnessDefinition } from '../common/harness/HarnessDefinition';
16
+ import {
17
+ addQuestionsOption,
18
+ normalizeQuestionsCliOptions,
19
+ QUESTIONS_DESCRIPTION,
20
+ type QuestionsCliOptions,
21
+ } from '../common/questionsCliOptions';
15
22
  import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
16
- import { AGENT_CODING_FILE_PATH } from './agentCodingFile';
17
23
  import { AGENTS_FILE_PATH } from './agentsFile';
18
24
  import { DEFAULT_BOILERPLATE_COUNT } from './boilerplateCount';
19
- import { getDefaultCoderProjectPromptTemplateDefinitions } from './boilerplateTemplates';
20
- import { CODER_DEVELOPER_AGENT_FILE_PATH } from './ensureCoderDeveloperAgentFile';
25
+ import { getDefaultCoderProjectPromptTemplateDefinitions, PROMPTS_DIRECTORY_PATH } from './boilerplateTemplates';
26
+ import { CODER_AGENTS_DIRECTORY_PATH, CODER_DEVELOPER_AGENT_FILE_PATH } from './ensureCoderDeveloperAgentFile';
27
+ import { isDirectoryEmpty } from './ensureDirectory';
21
28
  import { formatDisplayPath } from './formatDisplayPath';
22
29
  import { generatePromptBoilerplate } from './generate-boilerplates';
23
30
  import { initializeCoderProjectConfiguration } from './initializeCoderProjectConfiguration';
@@ -55,50 +62,63 @@ export function $initializeCoderInitCommand(program: Program): $side_effect {
55
62
  - prompts/done/
56
63
  ${block(listDefaultCoderProjectPromptTemplateDisplayPaths())}
57
64
  - ${CODER_DEVELOPER_AGENT_FILE_PATH}
65
+ - ${CODER_AGENTS_DIRECTORY_PATH}/${ADAM_AGENT_BOOK_RELATIVE_PATH}
58
66
  - ${AGENTS_FILE_PATH}
59
- - ${AGENT_CODING_FILE_PATH}
60
- - .gitignore
67
+ - .gitignore with local artifacts from every supported harness
61
68
  - package.json
62
69
  - .vscode/settings.json
63
70
 
71
+ Never overwrites what the project already owns:
72
+ - Existing package.json scripts and .vscode/settings.json settings are kept, only missing ones are added
73
+ - Files referenced by a script, like the agent and context of coder:run, are created only together
74
+ with the script which references them
75
+
64
76
  Ensures required coding-agent environment variables in .env:
65
77
  - CODING_AGENT_GIT_NAME
66
78
  - CODING_AGENT_GIT_EMAIL
67
79
  - CODING_AGENT_GIT_SIGNING_KEY
68
80
 
69
- Checks that the coding harnesses are installed globally and up to date:
81
+ Checks that the coding harnesses are installed and up to date unless \`--no-questions\` is used:
70
82
  ${block(listCheckedHarnessLabels())}
71
83
 
72
84
  ${block(CODER_GIT_SYNC_DESCRIPTION)}
85
+
86
+ ${block(QUESTIONS_DESCRIPTION)}
73
87
  `,
74
88
  ),
75
89
  );
76
90
 
77
91
  addCoderGitSyncOptions(command);
92
+ addQuestionsOption(command);
78
93
 
79
94
  command.action(
80
95
  handleActionErrors(async (cliOptions) => {
81
96
  const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
97
+ const questionsOptions = normalizeQuestionsCliOptions(cliOptions as QuestionsCliOptions);
82
98
  const projectPath = process.cwd();
83
99
 
84
100
  // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
85
- const { $commitCoderChanges, $pullCoderChanges } = await import(
101
+ const { $commitCoderChanges, $startCoderGitSync } = await import(
86
102
  '../../../../scripts/run-codex-prompts/git/coderGitSync'
87
103
  );
88
104
 
89
- await $pullCoderChanges({ gitSync, projectPath });
105
+ const commitScope = await $startCoderGitSync({ gitSync, projectPath });
106
+ const isPromptsDirectoryEmpty = await isDirectoryEmpty(projectPath, PROMPTS_DIRECTORY_PATH);
90
107
 
91
108
  const summary = await initializeCoderProjectConfiguration(projectPath);
92
109
  printInitializationSummary(summary);
93
- await generatePromptBoilerplate({ projectPath, boilerplateCount: DEFAULT_BOILERPLATE_COUNT });
110
+
111
+ if (isPromptsDirectoryEmpty) {
112
+ await generatePromptBoilerplate({ projectPath, boilerplateCount: DEFAULT_BOILERPLATE_COUNT });
113
+ }
94
114
 
95
115
  await $commitCoderChanges({
96
116
  gitSync,
97
- projectPath,
117
+ commitScope,
98
118
  commitMessage: 'Initialize Promptbook Coder',
99
119
  });
100
120
 
101
- await $ensureHarnessInstallations(CODER_INIT_CHECKED_HARNESS_NAMES);
121
+ await $ensureHarnessInstallations(CODER_INIT_CHECKED_HARNESS_NAMES, questionsOptions);
102
122
  }),
103
123
  );
104
124
  }