@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,15 @@
1
+ import type { AgentMessageProjectChange } from '../../../src/utils/agent-message-runtime/AgentMessageProjectChange';
2
+ /**
3
+ * Commits everything one answered message changed inside one agent project.
4
+ *
5
+ * The project is turned into a git repository first when it is not one yet, so the work of every
6
+ * answer stays recoverable and reviewable as a normal commit history.
7
+ *
8
+ * @param options - Project identity and the commit message describing the answered message.
9
+ * @returns What was committed, or `null` when the project changed nothing or cannot be committed.
10
+ */
11
+ export declare function commitAgentProjectChanges(options: {
12
+ readonly projectPath: string;
13
+ readonly projectName: string;
14
+ readonly commitMessage: string;
15
+ }): Promise<AgentMessageProjectChange | null>;
@@ -0,0 +1,24 @@
1
+ import type { AgentMessageProjectChange } from '../../../src/utils/agent-message-runtime/AgentMessageProjectChange';
2
+ /**
3
+ * Commits what one answered message changed in every project of one agent.
4
+ *
5
+ * Every project of an agent is its own git repository, so each answer which modified one becomes a
6
+ * commit there. The projects are committed one after another because they share the git executable
7
+ * and because an agent works with a handful of projects at most.
8
+ *
9
+ * Committing is best-effort bookkeeping around an answer the agent already produced: a project
10
+ * whose commit fails is reported to the console and skipped instead of failing the message.
11
+ *
12
+ * @param options - Agent folder and the commit message describing the answered message.
13
+ * @returns What was committed, one entry per project the message really changed.
14
+ */
15
+ export declare function commitAnsweredMessageProjectChanges(options: {
16
+ /**
17
+ * Absolute path of the local agent folder owning the projects.
18
+ */
19
+ readonly agentFolderPath: string;
20
+ /**
21
+ * Commit message shared by every project commit of this message.
22
+ */
23
+ readonly commitMessage: string;
24
+ }): Promise<ReadonlyArray<AgentMessageProjectChange>>;
@@ -0,0 +1,20 @@
1
+ /**
2
+ * How one agent project directory relates to git.
3
+ *
4
+ * - `own-repository` is a project whose own history the runner can commit into.
5
+ * - `tracked-elsewhere` is a project belonging to a repository around the agent folder, whose
6
+ * history is already kept by whoever owns that repository.
7
+ * - `unavailable` is a project which cannot be committed, for example because git is missing.
8
+ */
9
+ export type AgentProjectGitRepositoryState = 'own-repository' | 'tracked-elsewhere' | 'unavailable';
10
+ /**
11
+ * Makes sure one agent project is a git repository of its own.
12
+ *
13
+ * A project which is already tracked by a repository around the agent folder is deliberately left
14
+ * alone: initializing a repository inside it would turn it into an embedded repository and break
15
+ * the history that already covers it.
16
+ *
17
+ * @param projectPath - Absolute path of the project directory.
18
+ * @returns How the project relates to git after this call.
19
+ */
20
+ export declare function ensureAgentProjectGitRepository(projectPath: string): Promise<AgentProjectGitRepositoryState>;
@@ -0,0 +1,11 @@
1
+ import type { AgentMessageProjectChange } from '../../../src/utils/agent-message-runtime/AgentMessageProjectChange';
2
+ /**
3
+ * Describes the latest commit of one agent project repository.
4
+ *
5
+ * @param options - Project directory and the project name the description is reported under.
6
+ * @returns Description of the commit, or `null` when git could not describe it.
7
+ */
8
+ export declare function readAgentProjectCommitChange(options: {
9
+ readonly projectPath: string;
10
+ readonly projectName: string;
11
+ }): Promise<AgentMessageProjectChange | null>;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Result of one git command executed inside one agent project.
3
+ */
4
+ export type AgentProjectGitCommandResult = {
5
+ /**
6
+ * Whether git reported success.
7
+ */
8
+ readonly isSuccessful: boolean;
9
+ /**
10
+ * Standard output of the command, with the trailing newline removed.
11
+ */
12
+ readonly output: string;
13
+ };
14
+ /**
15
+ * Runs one git command inside one agent project directory.
16
+ *
17
+ * Commands are executed without a shell and with an explicit argument list, so a project name or
18
+ * a file path can never be interpreted as a shell fragment. A failing command is reported through
19
+ * `isSuccessful` instead of throwing, because git uses the exit code to answer questions such as
20
+ * "is there anything staged" and because auto-committing a project must never fail an answer the
21
+ * agent already produced.
22
+ *
23
+ * @param options - Project directory and the git arguments to run there.
24
+ * @returns Outcome of the command.
25
+ */
26
+ export declare function runAgentProjectGitCommand(options: {
27
+ readonly projectPath: string;
28
+ readonly args: ReadonlyArray<string>;
29
+ }): Promise<AgentProjectGitCommandResult>;
@@ -0,0 +1,26 @@
1
+ import type { AgentPlannedMessageSnapshot } from '../../../src/book-3.0/AgentPlannedMessagesSidecar';
2
+ /**
3
+ * Planned-message sidecar information made visible to one coding-harness prompt.
4
+ */
5
+ export type AgentPlannedMessagesPromptSidecar = {
6
+ /**
7
+ * Portable path of the sidecar inside the agent folder.
8
+ */
9
+ readonly relativeSidecarPath: string;
10
+ /**
11
+ * Planned messages that are already waiting to wake the agent.
12
+ */
13
+ readonly currentPlannedMessages: ReadonlyArray<AgentPlannedMessageSnapshot>;
14
+ };
15
+ /**
16
+ * Builds the planned-message instructions available to an Agents Server-managed coding agent.
17
+ *
18
+ * Planned messages always target the agent's singleton goal chat, regardless of the chat in which the
19
+ * wake-up is planned, and each of them keeps repeating until its schedule is over or it is cancelled.
20
+ * The sidecar file is the only channel that changes them, so an answer that merely claims a follow-up
21
+ * was planned changes nothing — and an answer that changes nothing keeps the current plan running.
22
+ *
23
+ * @param sidecar - Sidecar prepared by the Agents Server for the answered message.
24
+ * @returns Prompt section, or an empty string outside Agents Server-managed runs.
25
+ */
26
+ export declare function buildAgentGoalChatPromptSection(sidecar: AgentPlannedMessagesPromptSidecar | undefined): string;
@@ -1,8 +1,19 @@
1
1
  import { type AgentProjectsPromptSectionOptions } from './buildAgentProjectsPromptSection';
2
+ import { type AgentPlannedMessagesPromptSidecar } from './buildAgentGoalChatPromptSection';
3
+ import { type AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
2
4
  /**
3
5
  * Options adjusting the generated agent message prompt.
4
6
  */
5
- export type BuildAgentMessagePromptOptions = AgentProjectsPromptSectionOptions;
7
+ export type BuildAgentMessagePromptOptions = AgentProjectsPromptSectionOptions & {
8
+ /**
9
+ * Optional local TEAM roster prepared by the Agents Server for this user turn.
10
+ */
11
+ teamWorkspace?: AgentTeamPromptWorkspace;
12
+ /**
13
+ * Planned-message sidecar prepared by the Agents Server for the agent's singleton goal chat.
14
+ */
15
+ plannedMessagesSidecar?: AgentPlannedMessagesPromptSidecar;
16
+ };
6
17
  /**
7
18
  * Builds the prompt sent to the selected coding runner for one queued user-thread book.
8
19
  */
@@ -1,20 +1,8 @@
1
+ import type { AgentServerRuntimePromptApi } from './AgentServerRuntimePromptApi';
1
2
  /**
2
3
  * Internal runtime API details available to Agents Server-managed local agents.
3
4
  */
4
- export type AgentProjectRuntimePromptApi = {
5
- /**
6
- * Permanent id of the agent currently answering the message.
7
- */
8
- readonly agentPermanentId: string;
9
- /**
10
- * Environment variable containing the Agents Server origin.
11
- */
12
- readonly serverUrlEnvironmentVariableName: string;
13
- /**
14
- * Environment variable containing the internal worker token.
15
- */
16
- readonly tokenEnvironmentVariableName: string;
17
- };
5
+ export type AgentProjectRuntimePromptApi = AgentServerRuntimePromptApi;
18
6
  /**
19
7
  * Options of the projects prompt section shared by every coding harness.
20
8
  */
@@ -0,0 +1,12 @@
1
+ import { type AgentTeamConversationWorkspaceManifest } from '../../../src/book-3.0/AgentTeamConversationWorkspace';
2
+ /**
3
+ * TEAM workspace information made visible to one coding-harness prompt.
4
+ */
5
+ export type AgentTeamPromptWorkspace = {
6
+ readonly relativeWorkspacePath: string;
7
+ readonly manifest: AgentTeamConversationWorkspaceManifest;
8
+ };
9
+ /**
10
+ * Builds the optional single-run TEAM consultation instructions for a coding harness.
11
+ */
12
+ export declare function buildAgentTeamPromptSection(workspace: AgentTeamPromptWorkspace | undefined): string;
@@ -1,9 +1,10 @@
1
1
  import type { AgentModelRequirements } from '../../../src/book-2.0/agent-source/AgentModelRequirements';
2
+ import type { CreateAgentModelRequirementsOptions } from '../../../src/book-2.0/agent-source/CreateAgentModelRequirementsOptions';
2
3
  import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
3
4
  /**
4
5
  * Compiles agent source into the behavior text passed to CLI harness runners.
5
6
  */
6
- export declare function createAgentRunnerSystemMessage(agentSource: string_book): Promise<string>;
7
+ export declare function createAgentRunnerSystemMessage(agentSource: string_book, options?: CreateAgentModelRequirementsOptions): Promise<string>;
7
8
  /**
8
9
  * Formats prepared model requirements for a text-only CLI harness prompt.
9
10
  */
@@ -0,0 +1,16 @@
1
+ import type { AgentMessageFile } from './AgentMessageFile';
2
+ import type { AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
3
+ /**
4
+ * TEAM transcript files retained next to the finished user message.
5
+ */
6
+ export type FinishedAgentTeamConversationWorkspace = {
7
+ readonly relativePaths: ReadonlyArray<string>;
8
+ };
9
+ /**
10
+ * Moves harness-created TEAM conversation transcripts into the finished-message history.
11
+ */
12
+ export declare function finalizeAgentTeamConversationWorkspace(options: {
13
+ readonly projectPath: string;
14
+ readonly queuedMessage: AgentMessageFile;
15
+ readonly workspace: AgentTeamPromptWorkspace | null;
16
+ }): Promise<FinishedAgentTeamConversationWorkspace | null>;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Lists the direct project directories of one agent folder.
3
+ *
4
+ * @param agentFolderPath - Absolute path of the local agent folder.
5
+ * @returns Project directory names, or an empty list when the agent has no projects folder.
6
+ */
7
+ export declare function listAgentProjectDirectoryNames(agentFolderPath: string): Promise<ReadonlyArray<string>>;
@@ -0,0 +1,10 @@
1
+ import type { AgentMessageFile } from './AgentMessageFile';
2
+ import type { AgentPlannedMessagesPromptSidecar } from './buildAgentGoalChatPromptSection';
3
+ /**
4
+ * Loads the planned-message sidecar the Agents Server prepared for one queued message.
5
+ *
6
+ * @param projectPath - Absolute path of the current agent runner folder.
7
+ * @param queuedMessage - Queued message currently being answered.
8
+ * @returns Sidecar details for the prompt, or `null` outside Agents Server-managed runs.
9
+ */
10
+ export declare function loadAgentPlannedMessagesSidecar(projectPath: string, queuedMessage: AgentMessageFile): Promise<AgentPlannedMessagesPromptSidecar | null>;
@@ -0,0 +1,6 @@
1
+ import type { AgentMessageFile } from './AgentMessageFile';
2
+ import type { AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
3
+ /**
4
+ * Loads the optional TEAM roster snapshot for one queued message.
5
+ */
6
+ export declare function loadAgentTeamConversationWorkspace(projectPath: string, queuedMessage: AgentMessageFile): Promise<AgentTeamPromptWorkspace | null>;
@@ -0,0 +1,29 @@
1
+ import type { AgentMessageTouchedExternalSource } from '../../../src/utils/agent-message-runtime/AgentMessageTouchedExternalSource';
2
+ /**
3
+ * Everything one answered message worked with, both inside and outside the agent.
4
+ */
5
+ export type AnsweredMessageTouches = {
6
+ /**
7
+ * Directory names of the agent projects the answer viewed or edited.
8
+ */
9
+ readonly touchedProjectNames: ReadonlyArray<string>;
10
+ /**
11
+ * Sources outside the agent the answer reached.
12
+ */
13
+ readonly touchedExternalSources: ReadonlyArray<AgentMessageTouchedExternalSource>;
14
+ };
15
+ /**
16
+ * Resolves which agent projects and which external sources one answered message touched.
17
+ *
18
+ * The runtime log is deleted as soon as the harness run finishes, so this must be called while
19
+ * the log still exists — the Agents Server later shows everything reported here as chips below
20
+ * the answer. Reporting touches is best-effort telemetry: an unreadable log or projects folder
21
+ * simply yields nothing instead of failing the already answered message.
22
+ *
23
+ * @param options - Agent folder path and the live runtime log path of the answered message.
24
+ * @returns Touched projects and external sources, ordered by first appearance in the run.
25
+ */
26
+ export declare function resolveAnsweredMessageTouches(options: {
27
+ readonly projectPath: string;
28
+ readonly runtimeLogPath: string;
29
+ }): Promise<AnsweredMessageTouches>;
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Terminal control key of `ptbk coder run` which the user can press during a run.
3
+ *
4
+ * @private internal type of `ptbk coder` terminal controls
5
+ */
6
+ export type CoderRunControlKey = 'P' | 'S' | 'X';
7
+ /**
8
+ * Meaning of one control answer, which decides how it is colored in the terminal.
9
+ *
10
+ * @private internal type of `ptbk coder` terminal controls
11
+ */
12
+ export type CoderRunControlFeedbackTone = 'success' | 'info' | 'warning';
13
+ /**
14
+ * Answer of the runner to one pressed control key.
15
+ *
16
+ * Every single key press produces one of these, including presses which change nothing, so the user
17
+ * always sees that the key was received.
18
+ *
19
+ * @private internal type of `ptbk coder` terminal controls
20
+ */
21
+ export type CoderRunControlFeedback = {
22
+ /**
23
+ * Control key the answer belongs to.
24
+ */
25
+ readonly controlKey: CoderRunControlKey;
26
+ /**
27
+ * Human-readable description of what the key press did.
28
+ */
29
+ readonly message: string;
30
+ /**
31
+ * Meaning of the answer, used to color it.
32
+ */
33
+ readonly tone: CoderRunControlFeedbackTone;
34
+ };
35
+ /**
36
+ * One control answer together with how many times the very same answer was repeated in a row.
37
+ *
38
+ * Pressing one control twice can produce the identical answer, so the repeat count is what makes the
39
+ * second press change the rendered frame as well.
40
+ *
41
+ * @private internal type of `ptbk coder` terminal controls
42
+ */
43
+ export type CoderRunControlFeedbackNotice = CoderRunControlFeedback & {
44
+ /**
45
+ * How many times this exact answer was given in a row, starting at `1`.
46
+ */
47
+ readonly repeatCount: number;
48
+ };
49
+ /**
50
+ * How long one control answer stays visible in the rich terminal UI.
51
+ *
52
+ * @private internal constant of `ptbk coder` terminal controls
53
+ */
54
+ export declare const CODER_RUN_CONTROL_FEEDBACK_DURATION_MS = 5000;
@@ -0,0 +1,14 @@
1
+ import type { CoderRunControlFeedback } from './CoderRunControlFeedback';
2
+ /**
3
+ * Applies the terminal control bound to one pressed key and describes what that key press did.
4
+ *
5
+ * This is the single place where the `P`, `S` and `X` keys are turned into runner actions, so the
6
+ * plain console listener and the rich terminal UI always perform the same action and always answer
7
+ * the user, even when the pressed control changed nothing.
8
+ *
9
+ * @param keyName Name of the pressed key as reported by the `keypress` event.
10
+ * @returns The answer shown to the user, or `undefined` when the key is not a control key.
11
+ *
12
+ * @private internal utility of `ptbk coder` terminal controls
13
+ */
14
+ export declare function applyCoderRunControlKey(keyName: string | undefined): CoderRunControlFeedback | undefined;
@@ -0,0 +1,7 @@
1
+ import type { CoderRunControlKey } from './CoderRunControlFeedback';
2
+ /**
3
+ * Builds the colored badge of one control key, for example ` S `.
4
+ *
5
+ * @private internal utility of `ptbk coder` terminal controls
6
+ */
7
+ export declare function buildCoderRunControlKeyBadge(controlKey: CoderRunControlKey): string;
@@ -0,0 +1,48 @@
1
+ import type { CodexLoginMethod } from '../../../src/book-3.0/codexLoginMethod';
2
+ import type { CoderRunStep, CoderRunStepKind } from './CoderRunStep';
3
+ /**
4
+ * Progress of one prompt round, reported right before a new step starts.
5
+ */
6
+ export type CoderRunStepProgress = {
7
+ /**
8
+ * Kind of the step which is about to start.
9
+ */
10
+ readonly startedStepKind: CoderRunStepKind;
11
+ /**
12
+ * Steps of the same prompt round which have already finished, in the order they ran.
13
+ */
14
+ readonly finishedSteps: ReadonlyArray<CoderRunStep>;
15
+ /**
16
+ * Authentication method the harness reported, as soon as one of the finished steps revealed it.
17
+ */
18
+ readonly loginMethod?: CodexLoginMethod;
19
+ };
20
+ /**
21
+ * Notified right before one coder run step starts.
22
+ */
23
+ export type OnCoderRunStepStarted = (progress: CoderRunStepProgress) => Promise<void>;
24
+ /**
25
+ * Collects the measured steps of one prompt round and announces every step which starts.
26
+ */
27
+ export type CoderRunStepTracker = {
28
+ /**
29
+ * Steps which have finished so far, in the order they ran.
30
+ */
31
+ readonly steps: ReadonlyArray<CoderRunStep>;
32
+ /**
33
+ * Announces that one step is about to start.
34
+ */
35
+ readonly startStep: (kind: CoderRunStepKind) => Promise<void>;
36
+ /**
37
+ * Records one finished step together with the authentication method its runner reported.
38
+ */
39
+ readonly finishStep: (step: CoderRunStep, loginMethod?: CodexLoginMethod) => void;
40
+ };
41
+ /**
42
+ * Creates the step tracker of one prompt round.
43
+ *
44
+ * The tracker is the single place which knows which steps have finished and which one is running,
45
+ * so both the finished `[x]` status line and the intermediate `[^]` in-progress status lines are
46
+ * built from the very same data.
47
+ */
48
+ export declare function createCoderRunStepTracker(onStepStarted?: OnCoderRunStepStarted): CoderRunStepTracker;
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Measures the free disk space of a run which is already in progress and requests a pause when it became critical.
3
+ *
4
+ * @private internal utility of `ptbk coder` free disk space handling
5
+ */
6
+ export type FreeDiskSpaceGuard = () => Promise<void>;
7
+ /**
8
+ * Creates the guard which watches the free disk space while one `ptbk coder` run is in progress.
9
+ *
10
+ * The guard runs at every pause checkpoint of the run. When the disk became critically full it reports the
11
+ * warning and requests a pause, so the run stops at that checkpoint instead of failing in the middle of a
12
+ * coding round, and continues once the user has freed some space and pressed `P`.
13
+ *
14
+ * @private internal utility of `ptbk coder` free disk space handling
15
+ */
16
+ export declare function createFreeDiskSpaceGuard(options: {
17
+ /**
18
+ * Path whose filesystem is watched, usually the project the coder runs in.
19
+ */
20
+ readonly inspectedPath: string;
21
+ /**
22
+ * Whether the run may stop and wait for somebody to free the disk space, disabled by `--no-questions`.
23
+ */
24
+ readonly isAskingQuestionsEnabled: boolean;
25
+ }): FreeDiskSpaceGuard;
@@ -0,0 +1,13 @@
1
+ import type { CoderRunControlFeedback } from './CoderRunControlFeedback';
2
+ /**
3
+ * Formats one control answer as a single colored terminal line.
4
+ *
5
+ * The same line is printed by the plain console listener and rendered inside the `Controls` box of the
6
+ * rich terminal UI, so both modes answer a pressed control key identically.
7
+ *
8
+ * @param feedback Answer of the runner to the pressed control key.
9
+ * @param repeatCount How many times this exact answer was given in a row, rendered from the second time on.
10
+ *
11
+ * @private internal utility of `ptbk coder` terminal controls
12
+ */
13
+ export declare function formatCoderRunControlFeedback(feedback: CoderRunControlFeedback, repeatCount?: number): string;
@@ -1,4 +1,8 @@
1
1
  /**
2
2
  * Formats one unknown error-like value into readable text for logs and feedback.
3
+ *
4
+ * An `AuthenticationError` is reported without its stack, because its message is written for the user - it
5
+ * says which harness has to be signed in again and how - and the frames of a failure nobody can debug would
6
+ * only push those instructions out of sight.
3
7
  */
4
8
  export declare function formatUnknownErrorDetails(error: unknown): string;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Listens for the terminal control keys while the plain console output is used.
3
+ *
4
+ * Every recognized key press is answered with one printed line, because the plain mode has no frame
5
+ * which could show the new state on its own. The rich terminal UI installs its own listener in
6
+ * [`renderCoderRunUi`](../ui/renderCoderRunUi.ts) and shares the very same key handling through
7
+ * [`applyCoderRunControlKey`](./applyCoderRunControlKey.ts).
8
+ *
9
+ * @private internal utility of `ptbk coder` terminal controls
10
+ */
11
+ export declare function listenForCoderRunControls(): void;
12
+ /**
13
+ * Backwards-compatible alias for the shared terminal controls listener.
14
+ *
15
+ * @private internal utility of `ptbk coder` terminal controls
16
+ */
17
+ export declare function listenForPause(): void;
@@ -1,9 +1,8 @@
1
+ import type { WorkingTreeChangesSnapshot } from '../git/workingTreeChanges';
1
2
  /**
2
3
  * Snapshot of file hashes for files that were already dirty before a coding round started.
3
4
  */
4
- export type ChangedFilesSnapshot = {
5
- readonly changedFileHashes: ReadonlyMap<string, string>;
6
- };
5
+ export type ChangedFilesSnapshot = WorkingTreeChangesSnapshot;
7
6
  /**
8
7
  * Options for normalizing line endings in files changed during one coding round.
9
8
  */
@@ -1,20 +1,49 @@
1
1
  import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
2
2
  /**
3
- * Agent data resolved from the optional `--agent` book file.
3
+ * Source and prompt-routing references resolved from an optional `--agent` book file.
4
4
  */
5
- export type ResolvedCoderAgent = {
5
+ export type ResolvedCoderAgentBook = {
6
6
  /**
7
7
  * Raw source of the agent `.book` file.
8
8
  */
9
9
  readonly agentSource: string_book;
10
+ /**
11
+ * Human-readable name of the agent, as it is reported in prompt status lines and run traces.
12
+ *
13
+ * Comes from the `META FULLNAME` of the Book, or from the plain title on its first line, so it is the
14
+ * display name of the agent and not its normalized identifier.
15
+ */
16
+ readonly agentName: string;
17
+ /**
18
+ * Equivalent references by which a prompt may target this agent.
19
+ *
20
+ * Includes the configured path, relative path, filename, filename without `.book`, and the
21
+ * normalized Book title from its first line.
22
+ */
23
+ readonly agentReferences: ReadonlyArray<string>;
24
+ };
25
+ /**
26
+ * Agent data resolved from the optional `--agent` book file.
27
+ */
28
+ export type ResolvedCoderAgent = ResolvedCoderAgentBook & {
29
+ /** Source with inheritance and imports applied, also used for the coder's agent visual. */
30
+ readonly agentSource: string_book;
10
31
  /**
11
32
  * Compiled system message injected into each coding prompt.
12
33
  */
13
34
  readonly systemMessage: string;
35
+ /** Books created during resolution, committed according to the coder's normal commit setting. */
36
+ readonly createdAgentBookPaths: ReadonlyArray<string>;
14
37
  };
38
+ /**
39
+ * Reads an optional agent `.book` file and prepares the references that route prompts to it.
40
+ *
41
+ * Returns `undefined` when no agent path is provided.
42
+ */
43
+ export declare function resolveCoderAgentBook(agentBookReference: string | undefined, currentWorkingDirectory: string): Promise<ResolvedCoderAgentBook | undefined>;
15
44
  /**
16
45
  * Reads an optional agent `.book` file and compiles its system message for injection into coder prompts.
17
46
  *
18
47
  * Returns `undefined` when no agent path is provided.
19
48
  */
20
- export declare function resolveCoderAgent(agentPath: string | undefined, currentWorkingDirectory: string): Promise<ResolvedCoderAgent | undefined>;
49
+ export declare function resolveCoderAgent(agentBookReference: string | undefined, currentWorkingDirectory: string): Promise<ResolvedCoderAgent | undefined>;
@@ -0,0 +1,25 @@
1
+ /// <reference types="node" />
2
+ import { type ChildProcessWithoutNullStreams } from 'child_process';
3
+ /**
4
+ * Input used to start one temporary logged Bash script.
5
+ *
6
+ * @private internal type of `$spawnLoggedBashScript`
7
+ */
8
+ type SpawnLoggedBashScriptOptions = {
9
+ readonly scriptPath: string;
10
+ readonly logPath?: string;
11
+ /**
12
+ * Process which owns the temporary harness shell. Defaults to the current coder process.
13
+ */
14
+ readonly parentProcessId?: number;
15
+ };
16
+ /**
17
+ * Starts one temporary Bash script in a process tree owned by the current Node process.
18
+ *
19
+ * The wrapper watches the supplied owning process ID. When that process exits abruptly, the wrapper terminates every
20
+ * nested shell and harness process instead of leaving it orphaned.
21
+ *
22
+ * @private internal utility of the coding prompt runner
23
+ */
24
+ export declare function $spawnLoggedBashScript(options: SpawnLoggedBashScriptOptions): ChildProcessWithoutNullStreams;
25
+ export {};
@@ -0,0 +1,11 @@
1
+ /// <reference types="node" />
2
+ import { type ChildProcess } from 'child_process';
3
+ /**
4
+ * Stops one active temporary Bash shell together with the harness process tree it owns.
5
+ *
6
+ * Unix sends `SIGTERM` to the wrapper so its shell trap terminates the separately grouped harness job. Windows does
7
+ * not reliably deliver that signal to Bash, so the native `taskkill` command terminates the direct shell tree instead.
8
+ *
9
+ * @private internal utility of the coding prompt runner
10
+ */
11
+ export declare function $terminateLoggedBashProcessTree(commandProcess: ChildProcess): void;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Turns the arbitrarily chopped chunks of one shell output stream into completed lines.
3
+ *
4
+ * @private internal type of the script runners
5
+ */
6
+ export type ScriptOutputLineReader = {
7
+ /**
8
+ * Returns every line which the given chunk has completed, keeping the unterminated rest for the next chunk.
9
+ */
10
+ readCompletedLines(chunk: string): readonly string[];
11
+ };
12
+ /**
13
+ * Creates a line reader for one shell output stream.
14
+ *
15
+ * A chunk boundary can fall into the middle of a line, so the unterminated rest is remembered until the next chunk
16
+ * completes it. Every observer of the live output therefore sees whole lines only, exactly as the finished output
17
+ * would contain them. One reader belongs to one stream, because interleaving `stdout` and `stderr` into a single
18
+ * buffer would splice two unrelated halves into one nonexistent line.
19
+ *
20
+ * @private internal utility of the script runners
21
+ */
22
+ export declare function createScriptOutputLineReader(): ScriptOutputLineReader;
@@ -9,6 +9,10 @@ export declare const PTBK_CODER_LOG_FILE_ENV_NAME = "PTBK_CODER_LOG_FILE";
9
9
  * without the generated script and the prompt it embeds.
10
10
  */
11
11
  export declare const SCRIPT_EXECUTION_LOG_RAW_OUTPUT_MARKER = "--- raw output ---";
12
+ /**
13
+ * Environment variable that identifies the Node process responsible for a temporary harness shell.
14
+ */
15
+ export declare const PTBK_CODER_PARENT_PROCESS_ID_ENV_NAME = "PTBK_CODER_PARENT_PROCESS_ID";
12
16
  /**
13
17
  * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
14
18
  */
@@ -54,14 +54,6 @@ export declare function waitForSkippableMilliseconds(waitToken: CoderRunSkippabl
54
54
  * Restores all shared terminal controls to their default state.
55
55
  */
56
56
  export declare function resetCoderRunControls(): void;
57
- /**
58
- * Listens for the terminal control keys.
59
- */
60
- export declare function listenForCoderRunControls(): void;
61
- /**
62
- * Backwards-compatible alias for the shared terminal controls listener.
63
- */
64
- export declare function listenForPause(): void;
65
57
  /**
66
58
  * If the execution is paused, it will wait until it is resumed.
67
59
  *