@promptbook/anthropic-claude 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">
@@ -309,7 +328,7 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
309
328
 
310
329
  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.
311
330
 
312
- 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.
331
+ 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.
313
332
 
314
333
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
315
334
 
@@ -317,17 +336,20 @@ In Promptbook, you define your agents **using simple Books** - a human-readable
317
336
 
318
337
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
319
338
 
320
- **<ins>Paul Smith</ins>**<br/>
339
+ **<ins>Lawyer</ins>**<br/>
321
340
  <br/>
322
- **PERSONA** You are a company lawyer.<br/>
341
+ GOAL You are a company lawyer.<br/>
323
342
  Your job is to provide legal advice and support to the company and its employees.<br/>
324
- **GOAL** Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
343
+ Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
344
+ <br/>
325
345
  **RULE** You are knowledgeable, professional, and detail-oriented.<br/>
326
346
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
327
347
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
328
- **USE EMAIL**<br/>
329
- **USE BROWSER**<br/>
330
- **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/>
348
+ <br/>
349
+ USE EMAIL<br/>
350
+ USE BROWSER<br/>
351
+ <br/>
352
+ 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/>
331
353
 
332
354
  </td></tr></table>
333
355
 
@@ -360,12 +382,12 @@ Goals define what the agent should actively work toward. Unlike a chatbot that o
360
382
 
361
383
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
362
384
 
363
- **<ins>Paul Smith & Associés</ins>**<br/>
385
+ **<ins>Company Lawyer</ins>**<br/>
364
386
  <br/>
365
- **PERSONA** You are a company lawyer.<br/>
387
+ GOAL<br/>
366
388
  Your job is to provide legal advice and support to the company and its employees.<br/>
367
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
368
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
389
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
390
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
369
391
 
370
392
  </td></tr></table>
371
393
 
@@ -383,8 +405,8 @@ Promptbook Engine will automatically enforce this knowledge during interactions.
383
405
  <br/>
384
406
  **PERSONA** You are a company lawyer.<br/>
385
407
  Your job is to provide legal advice and support to the company and its employees.<br/>
386
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
387
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
408
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
409
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
388
410
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
389
411
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
390
412
 
@@ -402,8 +424,8 @@ Depending on rule strictness, Promptbook will either propagate it to the prompt
402
424
  <br/>
403
425
  **PERSONA** You are a company lawyer.<br/>
404
426
  Your job is to provide legal advice and support to the company and its employees.<br/>
405
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
406
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
427
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
428
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
407
429
  **RULE** Always ensure compliance with local laws and regulations.<br/>
408
430
  **RULE** Never provide legal advice outside your area of expertise.<br/>
409
431
  **RULE** Never provide legal advice about criminal law.<br/>
@@ -424,16 +446,16 @@ These are what turn a chatbot into a persistent agent that actually does work.
424
446
  <br/>
425
447
  **PERSONA** You are a company lawyer.<br/>
426
448
  Your job is to provide legal advice and support to the company and its employees.<br/>
427
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
428
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
449
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
450
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
429
451
  **RULE** Always ensure compliance with local laws and regulations.<br/>
430
452
  **RULE** Never provide legal advice outside your area of expertise.<br/>
431
453
  **RULE** Never provide legal advice about criminal law.<br/>
432
454
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
433
455
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
434
- **USE EMAIL**<br/>
435
- **USE BROWSER**<br/>
436
- **USE SEARCH ENGINE**<br/>
456
+ USE EMAIL<br/>
457
+ USE BROWSER<br/>
458
+ USE SEARCH ENGINE<br/>
437
459
 
438
460
  </td></tr></table>
439
461
 
@@ -447,20 +469,22 @@ Team commitment allows you to define the team structure and advisory fellow memb
447
469
  <br/>
448
470
  **PERSONA** You are a company lawyer.<br/>
449
471
  Your job is to provide legal advice and support to the company and its employees.<br/>
450
- **GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
451
- **GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
472
+ GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
473
+ GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
452
474
  **RULE** Always ensure compliance with local laws and regulations.<br/>
453
475
  **RULE** Never provide legal advice outside your area of expertise.<br/>
454
476
  **RULE** Never provide legal advice about criminal law.<br/>
455
477
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
456
478
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
457
- **USE EMAIL**<br/>
458
- **USE BROWSER**<br/>
459
- **USE SEARCH ENGINE**<br/>
460
- **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/>
479
+ USE EMAIL<br/>
480
+ USE BROWSER<br/>
481
+ USE SEARCH ENGINE<br/>
482
+ 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/>
461
483
 
462
484
  </td></tr></table>
463
485
 
486
+
487
+
464
488
  ### Promptbook Ecosystem
465
489
 
466
490
  Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
@@ -483,6 +507,8 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
483
507
 
484
508
 
485
509
 
510
+
511
+
486
512
  ## 💜 The Promptbook Project
487
513
 
488
514
  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:
@@ -520,6 +546,8 @@ Promptbook project is an ecosystem centered around the **Agents Server** - a pla
520
546
  </tbody>
521
547
  </table>
522
548
 
549
+
550
+
523
551
  ### 🌐 Community & Social Media
524
552
 
525
553
  Join our growing community of developers and users:
@@ -576,6 +604,8 @@ Join our growing community of developers and users:
576
604
 
577
605
 
578
606
 
607
+
608
+
579
609
  ## 📚 Documentation
580
610
 
581
611
  See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -667,9 +697,9 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
667
697
  #### Features
668
698
 
669
699
  - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
670
- - **Context injection:** `--context AGENTS.md` or inline extra instructions
700
+ - **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
671
701
  - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
672
- - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
702
+ - **Unattended or interactive runs:** default auto mode, or `--no-auto` to wait for user confirmation before each prompt
673
703
  - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
674
704
  - **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
675
705
  - **Prompt triage:** `--priority` to process only more important tasks first
@@ -687,11 +717,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
687
717
 
688
718
  npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
689
719
 
690
- npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
720
+ 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
691
721
 
692
- 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
722
+ 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
693
723
 
694
- 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
724
+ 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
695
725
 
696
726
  npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
697
727
 
@@ -713,11 +743,11 @@ ptbk coder generate-boilerplates
713
743
 
714
744
  ptbk coder generate-boilerplates --template prompts/templates/common.md
715
745
 
716
- ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
746
+ 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
717
747
 
718
- ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
748
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
719
749
 
720
- 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
750
+ 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
721
751
 
722
752
  ptbk coder find-refactor-candidates
723
753
 
@@ -730,24 +760,24 @@ ptbk coder verify
730
760
 
731
761
  #### What each command does
732
762
 
733
- | Command | What it does |
734
- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
763
+ | Command | What it does |
764
+ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
735
765
  | `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/`. |
736
- | `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. |
737
- | `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. |
738
- | `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. |
739
- | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
766
+ | `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. |
767
+ | `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. |
768
+ | `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. |
769
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
740
770
 
741
771
  #### Most useful `ptbk coder run` flags
742
772
 
743
773
  | Flag | Purpose |
744
774
  | -------------------------- | -------------------------------------------------------------------------------------------------- |
745
- | `--agent <name>` | Selects the coding backend. |
775
+ | `--harness <name>` | Selects the coding harness. |
746
776
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
747
777
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
748
778
  | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
749
779
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
750
- | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
780
+ | `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
751
781
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
752
782
  | `--priority <n>` | Runs only prompts at or above the given priority. |
753
783
  | `--dry-run` | Prints which prompts are ready instead of executing them. |
@@ -759,8 +789,8 @@ ptbk coder verify
759
789
 
760
790
  1. Initialize once with `ptbk coder init`.
761
791
  2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
762
- 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--context AGENTS.md`.
763
- 4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
792
+ 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--agent agents/coding/developer.book --context AGENTS.md`.
793
+ 4. Run unattended batches by default, or pass `--no-auto` to confirm each prompt interactively.
764
794
  5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
765
795
 
766
796
 
@@ -783,6 +813,8 @@ The following glossary is used to clarify certain concepts:
783
813
 
784
814
  _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
785
815
 
816
+
817
+
786
818
  ### 💯 Core concepts
787
819
 
788
820
  - [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)
package/esm/index.es.js CHANGED
@@ -2,7 +2,7 @@ import { spaceTrim as spaceTrim$1 } from 'spacetrim';
2
2
  import Anthropic from '@anthropic-ai/sdk';
3
3
  import Bottleneck from 'bottleneck';
4
4
  import colors from 'colors';
5
- import { randomBytes } from 'crypto';
5
+ import CryptoJS from 'crypto-js';
6
6
  import { io } from 'socket.io-client';
7
7
 
8
8
  // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -19,7 +19,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
19
19
  * @generated
20
20
  * @see https://github.com/webgptorg/promptbook
21
21
  */
22
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-99';
22
+ const PROMPTBOOK_ENGINE_VERSION = '0.113.0-0';
23
23
  /**
24
24
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
25
25
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1825,7 +1825,7 @@ const ANTHROPIC_CLAUDE_MODELS = exportJson({
1825
1825
  * @private internal helper function
1826
1826
  */
1827
1827
  function $randomToken(randomness) {
1828
- return randomBytes(randomness).toString('hex');
1828
+ return CryptoJS.lib.WordArray.random(randomness).toString(CryptoJS.enc.Hex);
1829
1829
  }
1830
1830
  // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
1831
1831
  // TODO: Maybe use nanoid instead https://github.com/ai/nanoid