@promptbook/azure-openai 0.112.0-99 → 0.113.0-0

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 (170) hide show
  1. package/README.md +76 -44
  2. package/esm/index.es.js +3 -3
  3. package/esm/index.es.js.map +1 -1
  4. package/esm/src/_packages/components.index.d.ts +4 -0
  5. package/esm/src/_packages/core.index.d.ts +22 -2
  6. package/esm/src/_packages/node.index.d.ts +40 -0
  7. package/esm/src/_packages/types.index.d.ts +20 -0
  8. package/esm/src/avatars/avatarAnimationScheduler.d.ts +4 -0
  9. package/esm/src/avatars/types/AvatarVisualDefinition.d.ts +1 -1
  10. package/esm/src/avatars/visuals/octopus3d3AvatarVisual.d.ts +7 -0
  11. package/esm/src/avatars/visuals/octopus3d4AvatarVisual.d.ts +7 -0
  12. package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts +2 -0
  13. package/esm/src/book-2.0/agent-source/agentSourceVisibility.d.ts +97 -0
  14. package/esm/src/book-2.0/agent-source/agentSourceVisibility.test.d.ts +1 -0
  15. package/esm/src/book-3.0/BookNodeAgentSource.d.ts +38 -0
  16. package/esm/src/book-3.0/CliAgent.d.ts +66 -0
  17. package/esm/src/book-3.0/CliAgent.test.d.ts +1 -0
  18. package/esm/src/book-3.0/LiteAgent.d.ts +68 -0
  19. package/esm/src/book-3.0/LiteAgent.test.d.ts +1 -0
  20. package/esm/src/book-3.0/agentFolderPaths.d.ts +30 -0
  21. package/esm/src/book-3.0/cliAgentEnv.d.ts +33 -0
  22. package/esm/src/book-components/BookEditor/BookEditor.d.ts +6 -5
  23. package/esm/src/book-components/BookEditor/BookEditorAboutPromptbookInformation.d.ts +12 -0
  24. package/esm/src/book-components/BookEditor/BookEditorBrowserConfig.d.ts +2 -0
  25. package/esm/src/book-components/BookEditor/BookEditorForClient.d.ts +7 -0
  26. package/esm/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts +2 -0
  27. package/esm/src/book-components/BookEditor/BookEditorTheme.d.ts +24 -0
  28. package/esm/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +9 -0
  29. package/esm/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts +1 -6
  30. package/esm/src/book-components/BookEditor/useBookEditorMonacoLifecycle.d.ts +1 -4
  31. package/esm/src/book-components/BookEditor/useBookEditorMonacoStyles.d.ts +2 -1
  32. package/esm/src/book-components/Chat/Chat/ChatCitationModal.d.ts +2 -0
  33. package/esm/src/book-components/Chat/Chat/ChatMessageItem.d.ts +4 -0
  34. package/esm/src/book-components/Chat/Chat/ChatMessageList.d.ts +4 -0
  35. package/esm/src/book-components/Chat/Chat/ChatProps.d.ts +5 -0
  36. package/esm/src/book-components/Chat/Chat/ChatToolCallModal.d.ts +2 -0
  37. package/esm/src/book-components/Chat/Chat/ChatToolCallModalContent.d.ts +3 -1
  38. package/esm/src/book-components/Chat/Chat/CitationIframePreview.d.ts +20 -0
  39. package/esm/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts +2 -0
  40. package/esm/src/book-components/Chat/MarkdownContent/MarkdownContent.d.ts +1 -0
  41. package/esm/src/book-components/Chat/SourceChip/SourceChip.d.ts +6 -1
  42. package/esm/src/book-components/Chat/hooks/useResolvedCitationLabel.d.ts +12 -0
  43. package/esm/src/book-components/Chat/types/ChatMessage.d.ts +4 -0
  44. package/esm/src/book-components/Chat/types/ChatParticipant.d.ts +1 -1
  45. package/esm/src/book-components/Chat/types/CitationLabelResolver.d.ts +8 -0
  46. package/esm/src/book-components/Chat/utils/citationHelpers.d.ts +9 -0
  47. package/esm/src/book-components/Chat/utils/decodeJsonUnicodeEscapesInMarkdownText.d.ts +14 -0
  48. package/esm/src/book-components/Chat/utils/decodeJsonUnicodeEscapesInMarkdownText.test.d.ts +1 -0
  49. package/esm/src/book-components/Chat/utils/isVisibleChatToolCall.d.ts +10 -0
  50. package/esm/src/book-components/Chat/utils/parseCitationsFromContent.d.ts +4 -0
  51. package/esm/src/book-components/_common/Dropdown/Dropdown.d.ts +1 -1
  52. package/esm/src/book-components/_common/MenuHoisting/MenuHoistingContext.d.ts +1 -1
  53. package/esm/src/book-components/_common/Modal/Modal.d.ts +1 -1
  54. package/esm/src/book-components/icons/AboutIcon.d.ts +1 -1
  55. package/esm/src/book-components/icons/DownloadIcon.d.ts +1 -1
  56. package/esm/src/book-components/icons/ExitFullscreenIcon.d.ts +1 -1
  57. package/esm/src/book-components/icons/FullscreenIcon.d.ts +1 -1
  58. package/esm/src/cli/cli-commands/agent/agentCliOptions.d.ts +38 -0
  59. package/esm/src/cli/cli-commands/agent/chat.d.ts +10 -0
  60. package/esm/src/cli/cli-commands/agent/exec.d.ts +10 -0
  61. package/esm/src/cli/cli-commands/agent/run.test.d.ts +1 -0
  62. package/esm/src/cli/cli-commands/agent-folder/agentProjectPaths.d.ts +2 -24
  63. package/esm/src/cli/cli-commands/agent.d.ts +14 -0
  64. package/esm/src/cli/cli-commands/agents-server/buildAgentsServer.d.ts +23 -1
  65. package/esm/src/cli/cli-commands/agents-server/run.d.ts +6 -0
  66. package/esm/src/cli/cli-commands/agents-server/startAgentsServer.d.ts +9 -2
  67. package/esm/src/cli/cli-commands/coder/ThinkingLevel.d.ts +1 -1
  68. package/esm/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts +25 -0
  69. package/esm/src/cli/cli-commands/coder/find-unwritten.d.ts +10 -0
  70. package/esm/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +2 -0
  71. package/esm/src/cli/cli-commands/coder/server.d.ts +13 -0
  72. package/esm/src/cli/cli-commands/coder/waitOptions.d.ts +14 -0
  73. package/esm/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +9 -25
  74. package/esm/src/collection/agent-collection/CreateAgentInput.d.ts +2 -1
  75. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +22 -0
  76. package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts +21 -1
  77. package/esm/src/commitments/META_VISIBILITY/META_VISIBILITY.d.ts +27 -0
  78. package/esm/src/commitments/_common/teamInternalAgentAccess.d.ts +9 -1
  79. package/esm/src/commitments/index.d.ts +2 -1
  80. package/esm/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts +1 -1
  81. package/esm/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts +1 -1
  82. package/esm/src/scrapers/website/utils/createShowdownConverter.d.ts +2 -2
  83. package/esm/src/utils/isTimingSafeEqualString.d.ts +25 -0
  84. package/esm/src/utils/validators/url/isValidAgentUrl.d.ts +5 -0
  85. package/esm/src/version.d.ts +1 -1
  86. package/package.json +3 -3
  87. package/umd/index.umd.js +7 -6
  88. package/umd/index.umd.js.map +1 -1
  89. package/umd/src/_packages/components.index.d.ts +4 -0
  90. package/umd/src/_packages/core.index.d.ts +22 -2
  91. package/umd/src/_packages/node.index.d.ts +40 -0
  92. package/umd/src/_packages/types.index.d.ts +20 -0
  93. package/umd/src/avatars/avatarAnimationScheduler.d.ts +4 -0
  94. package/umd/src/avatars/types/AvatarVisualDefinition.d.ts +1 -1
  95. package/umd/src/avatars/visuals/octopus3d3AvatarVisual.d.ts +7 -0
  96. package/umd/src/avatars/visuals/octopus3d4AvatarVisual.d.ts +7 -0
  97. package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts +2 -0
  98. package/umd/src/book-2.0/agent-source/agentSourceVisibility.d.ts +97 -0
  99. package/umd/src/book-2.0/agent-source/agentSourceVisibility.test.d.ts +1 -0
  100. package/umd/src/book-3.0/BookNodeAgentSource.d.ts +38 -0
  101. package/umd/src/book-3.0/CliAgent.d.ts +66 -0
  102. package/umd/src/book-3.0/CliAgent.test.d.ts +1 -0
  103. package/umd/src/book-3.0/LiteAgent.d.ts +68 -0
  104. package/umd/src/book-3.0/LiteAgent.test.d.ts +1 -0
  105. package/umd/src/book-3.0/agentFolderPaths.d.ts +30 -0
  106. package/umd/src/book-3.0/cliAgentEnv.d.ts +33 -0
  107. package/umd/src/book-components/BookEditor/BookEditor.d.ts +6 -5
  108. package/umd/src/book-components/BookEditor/BookEditorAboutPromptbookInformation.d.ts +12 -0
  109. package/umd/src/book-components/BookEditor/BookEditorBrowserConfig.d.ts +2 -0
  110. package/umd/src/book-components/BookEditor/BookEditorForClient.d.ts +7 -0
  111. package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts +2 -0
  112. package/umd/src/book-components/BookEditor/BookEditorTheme.d.ts +24 -0
  113. package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.browser.d.ts +9 -0
  114. package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts +1 -6
  115. package/umd/src/book-components/BookEditor/useBookEditorMonacoLifecycle.d.ts +1 -4
  116. package/umd/src/book-components/BookEditor/useBookEditorMonacoStyles.d.ts +2 -1
  117. package/umd/src/book-components/Chat/Chat/ChatCitationModal.d.ts +2 -0
  118. package/umd/src/book-components/Chat/Chat/ChatMessageItem.d.ts +4 -0
  119. package/umd/src/book-components/Chat/Chat/ChatMessageList.d.ts +4 -0
  120. package/umd/src/book-components/Chat/Chat/ChatProps.d.ts +5 -0
  121. package/umd/src/book-components/Chat/Chat/ChatToolCallModal.d.ts +2 -0
  122. package/umd/src/book-components/Chat/Chat/ChatToolCallModalContent.d.ts +3 -1
  123. package/umd/src/book-components/Chat/Chat/CitationIframePreview.d.ts +20 -0
  124. package/umd/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts +2 -0
  125. package/umd/src/book-components/Chat/MarkdownContent/MarkdownContent.d.ts +1 -0
  126. package/umd/src/book-components/Chat/SourceChip/SourceChip.d.ts +6 -1
  127. package/umd/src/book-components/Chat/hooks/useResolvedCitationLabel.d.ts +12 -0
  128. package/umd/src/book-components/Chat/types/ChatMessage.d.ts +4 -0
  129. package/umd/src/book-components/Chat/types/ChatParticipant.d.ts +1 -1
  130. package/umd/src/book-components/Chat/types/CitationLabelResolver.d.ts +8 -0
  131. package/umd/src/book-components/Chat/utils/citationHelpers.d.ts +9 -0
  132. package/umd/src/book-components/Chat/utils/decodeJsonUnicodeEscapesInMarkdownText.d.ts +14 -0
  133. package/umd/src/book-components/Chat/utils/decodeJsonUnicodeEscapesInMarkdownText.test.d.ts +1 -0
  134. package/umd/src/book-components/Chat/utils/isVisibleChatToolCall.d.ts +10 -0
  135. package/umd/src/book-components/Chat/utils/parseCitationsFromContent.d.ts +4 -0
  136. package/umd/src/book-components/_common/Dropdown/Dropdown.d.ts +1 -1
  137. package/umd/src/book-components/_common/MenuHoisting/MenuHoistingContext.d.ts +1 -1
  138. package/umd/src/book-components/_common/Modal/Modal.d.ts +1 -1
  139. package/umd/src/book-components/icons/AboutIcon.d.ts +1 -1
  140. package/umd/src/book-components/icons/DownloadIcon.d.ts +1 -1
  141. package/umd/src/book-components/icons/ExitFullscreenIcon.d.ts +1 -1
  142. package/umd/src/book-components/icons/FullscreenIcon.d.ts +1 -1
  143. package/umd/src/cli/cli-commands/agent/agentCliOptions.d.ts +38 -0
  144. package/umd/src/cli/cli-commands/agent/chat.d.ts +10 -0
  145. package/umd/src/cli/cli-commands/agent/exec.d.ts +10 -0
  146. package/umd/src/cli/cli-commands/agent/run.test.d.ts +1 -0
  147. package/umd/src/cli/cli-commands/agent-folder/agentProjectPaths.d.ts +2 -24
  148. package/umd/src/cli/cli-commands/agent.d.ts +14 -0
  149. package/umd/src/cli/cli-commands/agents-server/buildAgentsServer.d.ts +23 -1
  150. package/umd/src/cli/cli-commands/agents-server/run.d.ts +6 -0
  151. package/umd/src/cli/cli-commands/agents-server/startAgentsServer.d.ts +9 -2
  152. package/umd/src/cli/cli-commands/coder/ThinkingLevel.d.ts +1 -1
  153. package/umd/src/cli/cli-commands/coder/ensureCoderDeveloperAgentFile.d.ts +25 -0
  154. package/umd/src/cli/cli-commands/coder/find-unwritten.d.ts +10 -0
  155. package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts +2 -0
  156. package/umd/src/cli/cli-commands/coder/server.d.ts +13 -0
  157. package/umd/src/cli/cli-commands/coder/waitOptions.d.ts +14 -0
  158. package/umd/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts +9 -25
  159. package/umd/src/collection/agent-collection/CreateAgentInput.d.ts +2 -1
  160. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts +22 -0
  161. package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts +21 -1
  162. package/umd/src/commitments/META_VISIBILITY/META_VISIBILITY.d.ts +27 -0
  163. package/umd/src/commitments/_common/teamInternalAgentAccess.d.ts +9 -1
  164. package/umd/src/commitments/index.d.ts +2 -1
  165. package/umd/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts +1 -1
  166. package/umd/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts +1 -1
  167. package/umd/src/scrapers/website/utils/createShowdownConverter.d.ts +2 -2
  168. package/umd/src/utils/isTimingSafeEqualString.d.ts +25 -0
  169. package/umd/src/utils/validators/url/isValidAgentUrl.d.ts +5 -0
  170. package/umd/src/version.d.ts +1 -1
package/README.md CHANGED
@@ -27,6 +27,25 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
27
27
 
28
28
 
29
29
 
30
+ ### Standalone VPS
31
+
32
+ Run the standalone VPS installer only on a fresh server. Interactive mode asks for the installation values:
33
+
34
+ ```bash
35
+ sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash
36
+ ```
37
+
38
+ Non-interactive mode takes defaults from command-line options. When `--openai-api-key` is provided with the default OpenAI Codex runner, the installer installs and configures Codex automatically; other runner authentication can be configured later from the UI or SSH:
39
+
40
+ ```bash
41
+ sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash -s -- \
42
+ --non-interactive \
43
+ --yes-i-understand-that-script-should-be-run-on-fresh-server \
44
+ --domain my-server.com \
45
+ --openai-api-key sk-proj-xxx \
46
+ --admin-password xxx
47
+ ```
48
+
30
49
 
31
50
 
32
51
  <blockquote style="color: #ff8811">
@@ -263,7 +282,7 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
263
282
 
264
283
  Promptbook lets you create **persistent AI agents** that work on real goals for your company. The [**Agents Server**](https://gallery.ptbk.io/) is the heart of the project - a place where your AI agents live, remember context, collaborate in teams, and get things done.
265
284
 
266
- Nowadays, the biggest challenge for most business applications isn't the raw capabilities of AI models. Large language models such as GPT-5.2 and Claude-4.5 are incredibly capable.
285
+ Nowadays, the biggest challenge for most business applications isn't the raw capabilities of AI models. Large language models such as Claude Mythos, GPT-5.6 or Kimi K2.7 are incredibly capable.
267
286
 
268
287
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
269
288
 
@@ -271,17 +290,20 @@ In Promptbook, you define your agents **using simple Books** - a human-readable
271
290
 
272
291
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
273
292
 
274
- **<ins>Paul Smith</ins>**<br/>
293
+ **<ins>Lawyer</ins>**<br/>
275
294
  <br/>
276
- **PERSONA** You are a company lawyer.<br/>
295
+ GOAL You are a company lawyer.<br/>
277
296
  Your job is to provide legal advice and support to the company and its employees.<br/>
278
- **GOAL** Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
297
+ Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
298
+ <br/>
279
299
  **RULE** You are knowledgeable, professional, and detail-oriented.<br/>
280
300
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
281
301
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
282
- **USE EMAIL**<br/>
283
- **USE BROWSER**<br/>
284
- **TEAM** You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
302
+ <br/>
303
+ USE EMAIL<br/>
304
+ USE BROWSER<br/>
305
+ <br/>
306
+ TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
285
307
 
286
308
  </td></tr></table>
287
309
 
@@ -314,12 +336,12 @@ Goals define what the agent should actively work toward. Unlike a chatbot that o
314
336
 
315
337
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
316
338
 
317
- **<ins>Paul Smith & Associés</ins>**<br/>
339
+ **<ins>Company Lawyer</ins>**<br/>
318
340
  <br/>
319
- **PERSONA** You are a company lawyer.<br/>
341
+ GOAL<br/>
320
342
  Your job is to provide legal advice and support to the company and its employees.<br/>
321
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
322
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
343
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
344
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
323
345
 
324
346
  </td></tr></table>
325
347
 
@@ -337,8 +359,8 @@ Promptbook Engine will automatically enforce this knowledge during interactions.
337
359
  <br/>
338
360
  **PERSONA** You are a company lawyer.<br/>
339
361
  Your job is to provide legal advice and support to the company and its employees.<br/>
340
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
341
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
362
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
363
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
342
364
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
343
365
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
344
366
 
@@ -356,8 +378,8 @@ Depending on rule strictness, Promptbook will either propagate it to the prompt
356
378
  <br/>
357
379
  **PERSONA** You are a company lawyer.<br/>
358
380
  Your job is to provide legal advice and support to the company and its employees.<br/>
359
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
360
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
381
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
382
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
361
383
  **RULE** Always ensure compliance with local laws and regulations.<br/>
362
384
  **RULE** Never provide legal advice outside your area of expertise.<br/>
363
385
  **RULE** Never provide legal advice about criminal law.<br/>
@@ -378,16 +400,16 @@ These are what turn a chatbot into a persistent agent that actually does work.
378
400
  <br/>
379
401
  **PERSONA** You are a company lawyer.<br/>
380
402
  Your job is to provide legal advice and support to the company and its employees.<br/>
381
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
382
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
403
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
404
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
383
405
  **RULE** Always ensure compliance with local laws and regulations.<br/>
384
406
  **RULE** Never provide legal advice outside your area of expertise.<br/>
385
407
  **RULE** Never provide legal advice about criminal law.<br/>
386
408
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
387
409
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
388
- **USE EMAIL**<br/>
389
- **USE BROWSER**<br/>
390
- **USE SEARCH ENGINE**<br/>
410
+ USE EMAIL<br/>
411
+ USE BROWSER<br/>
412
+ USE SEARCH ENGINE<br/>
391
413
 
392
414
  </td></tr></table>
393
415
 
@@ -401,20 +423,22 @@ Team commitment allows you to define the team structure and advisory fellow memb
401
423
  <br/>
402
424
  **PERSONA** You are a company lawyer.<br/>
403
425
  Your job is to provide legal advice and support to the company and its employees.<br/>
404
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
405
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
426
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
427
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
406
428
  **RULE** Always ensure compliance with local laws and regulations.<br/>
407
429
  **RULE** Never provide legal advice outside your area of expertise.<br/>
408
430
  **RULE** Never provide legal advice about criminal law.<br/>
409
431
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
410
432
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
411
- **USE EMAIL**<br/>
412
- **USE BROWSER**<br/>
413
- **USE SEARCH ENGINE**<br/>
414
- **TEAM** You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
433
+ USE EMAIL<br/>
434
+ USE BROWSER<br/>
435
+ USE SEARCH ENGINE<br/>
436
+ TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
415
437
 
416
438
  </td></tr></table>
417
439
 
440
+
441
+
418
442
  ### Promptbook Ecosystem
419
443
 
420
444
  Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
@@ -437,6 +461,8 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
437
461
 
438
462
 
439
463
 
464
+
465
+
440
466
  ## 💜 The Promptbook Project
441
467
 
442
468
  Promptbook project is an ecosystem centered around the **Agents Server** - a platform for creating, deploying, and running persistent AI agents. Following is a list of the most important pieces of the project:
@@ -474,6 +500,8 @@ Promptbook project is an ecosystem centered around the **Agents Server** - a pla
474
500
  </tbody>
475
501
  </table>
476
502
 
503
+
504
+
477
505
  ### 🌐 Community & Social Media
478
506
 
479
507
  Join our growing community of developers and users:
@@ -530,6 +558,8 @@ Join our growing community of developers and users:
530
558
 
531
559
 
532
560
 
561
+
562
+
533
563
  ## 📚 Documentation
534
564
 
535
565
  See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -621,9 +651,9 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
621
651
  #### Features
622
652
 
623
653
  - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
624
- - **Context injection:** `--context AGENTS.md` or inline extra instructions
654
+ - **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
625
655
  - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
626
- - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
656
+ - **Unattended or interactive runs:** default auto mode, or `--no-auto` to wait for user confirmation before each prompt
627
657
  - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
628
658
  - **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
629
659
  - **Prompt triage:** `--priority` to process only more important tasks first
@@ -641,11 +671,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
641
671
 
642
672
  npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
643
673
 
644
- npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
674
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md
645
675
 
646
- npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
676
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
647
677
 
648
- npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
678
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --ignore-git-changes
649
679
 
650
680
  npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
651
681
 
@@ -667,11 +697,11 @@ ptbk coder generate-boilerplates
667
697
 
668
698
  ptbk coder generate-boilerplates --template prompts/templates/common.md
669
699
 
670
- ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
700
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test
671
701
 
672
- ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
702
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
673
703
 
674
- ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
704
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test --ignore-git-changes
675
705
 
676
706
  ptbk coder find-refactor-candidates
677
707
 
@@ -684,24 +714,24 @@ ptbk coder verify
684
714
 
685
715
  #### What each command does
686
716
 
687
- | Command | What it does |
688
- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
717
+ | Command | What it does |
718
+ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
689
719
  | `ptbk coder init` | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
690
- | `ptbk coder generate-boilerplates` | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root. |
691
- | `ptbk coder run` | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled. |
692
- | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
693
- | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
720
+ | `ptbk coder generate-boilerplates` | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root. |
721
+ | `ptbk coder run` | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled. |
722
+ | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
723
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
694
724
 
695
725
  #### Most useful `ptbk coder run` flags
696
726
 
697
727
  | Flag | Purpose |
698
728
  | -------------------------- | -------------------------------------------------------------------------------------------------- |
699
- | `--agent <name>` | Selects the coding backend. |
729
+ | `--harness <name>` | Selects the coding harness. |
700
730
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
701
731
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
702
732
  | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
703
733
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
704
- | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
734
+ | `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
705
735
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
706
736
  | `--priority <n>` | Runs only prompts at or above the given priority. |
707
737
  | `--dry-run` | Prints which prompts are ready instead of executing them. |
@@ -713,8 +743,8 @@ ptbk coder verify
713
743
 
714
744
  1. Initialize once with `ptbk coder init`.
715
745
  2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
716
- 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--context AGENTS.md`.
717
- 4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
746
+ 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--agent agents/coding/developer.book --context AGENTS.md`.
747
+ 4. Run unattended batches by default, or pass `--no-auto` to confirm each prompt interactively.
718
748
  5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
719
749
 
720
750
 
@@ -737,6 +767,8 @@ The following glossary is used to clarify certain concepts:
737
767
 
738
768
  _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
739
769
 
770
+
771
+
740
772
  ### 💯 Core concepts
741
773
 
742
774
  - [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)
package/esm/index.es.js CHANGED
@@ -2,7 +2,7 @@ import { OpenAIClient, AzureKeyCredential } from '@azure/openai';
2
2
  import Bottleneck from 'bottleneck';
3
3
  import colors from 'colors';
4
4
  import { spaceTrim as spaceTrim$1 } from 'spacetrim';
5
- import { randomBytes } from 'crypto';
5
+ import CryptoJS from 'crypto-js';
6
6
 
7
7
  // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
8
8
  /**
@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
18
18
  * @generated
19
19
  * @see https://github.com/webgptorg/promptbook
20
20
  */
21
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-99';
21
+ const PROMPTBOOK_ENGINE_VERSION = '0.113.0-0';
22
22
  /**
23
23
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
24
24
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1177,7 +1177,7 @@ parseInt(process.env.API_REQUEST_TIMEOUT || '90000');
1177
1177
  * @private internal helper function
1178
1178
  */
1179
1179
  function $randomToken(randomness) {
1180
- return randomBytes(randomness).toString('hex');
1180
+ return CryptoJS.lib.WordArray.random(randomness).toString(CryptoJS.enc.Hex);
1181
1181
  }
1182
1182
  // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
1183
1183
  // TODO: Maybe use nanoid instead https://github.com/ai/nanoid