@promptbook/templates 0.114.0-3 → 0.114.0-5

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 (154) hide show
  1. package/README.md +4 -12
  2. package/esm/index.es.js +736 -694
  3. package/esm/index.es.js.map +1 -1
  4. package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts +3 -3
  5. package/esm/src/cli/cli-commands/coder/boilerplateCount.d.ts +52 -0
  6. package/esm/src/cli/cli-commands/coder/generate-boilerplates.d.ts +3 -2
  7. package/esm/src/cli/cli-commands/coder/verify.d.ts +1 -1
  8. package/esm/src/commitments/{COMPONENT/COMPONENT.d.ts → META_FULLNAME/META_FULLNAME.d.ts} +8 -5
  9. package/esm/src/commitments/META_ID/META_ID.d.ts +32 -0
  10. package/esm/src/commitments/index.d.ts +4 -12
  11. package/esm/src/llm-providers/agent/Agent.d.ts +1 -1
  12. package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.d.ts +1 -1
  13. package/esm/src/{commitments/USE_BROWSER → scrapers/_common/utils}/fetchUrlContent.d.ts +2 -3
  14. package/esm/src/version.d.ts +1 -1
  15. package/package.json +2 -2
  16. package/umd/index.umd.js +736 -694
  17. package/umd/index.umd.js.map +1 -1
  18. package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts +3 -3
  19. package/umd/src/cli/cli-commands/coder/boilerplateCount.d.ts +52 -0
  20. package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts +3 -2
  21. package/umd/src/cli/cli-commands/coder/verify.d.ts +1 -1
  22. package/umd/src/commitments/{COMPONENT/COMPONENT.d.ts → META_FULLNAME/META_FULLNAME.d.ts} +8 -5
  23. package/umd/src/commitments/META_ID/META_ID.d.ts +32 -0
  24. package/umd/src/commitments/index.d.ts +4 -12
  25. package/umd/src/llm-providers/agent/Agent.d.ts +1 -1
  26. package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.d.ts +1 -1
  27. package/umd/src/{commitments/USE_BROWSER → scrapers/_common/utils}/fetchUrlContent.d.ts +2 -3
  28. package/umd/src/version.d.ts +1 -1
  29. package/esm/src/commitments/MEMORY/MEMORY.d.ts +0 -48
  30. package/esm/src/commitments/MEMORY/MemoryToolNames.d.ts +0 -11
  31. package/esm/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +0 -149
  32. package/esm/src/commitments/MEMORY/createMemorySystemMessage.d.ts +0 -6
  33. package/esm/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +0 -8
  34. package/esm/src/commitments/MEMORY/createMemoryTools.d.ts +0 -14
  35. package/esm/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +0 -6
  36. package/esm/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  37. package/esm/src/commitments/MEMORY/getMemoryToolTitles.d.ts +0 -7
  38. package/esm/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +0 -61
  39. package/esm/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +0 -8
  40. package/esm/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +0 -13
  41. package/esm/src/commitments/META/META.d.ts +0 -65
  42. package/esm/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts +0 -32
  43. package/esm/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +0 -58
  44. package/esm/src/commitments/USE_BROWSER/fetchUrlContentViaBrowser.d.ts +0 -13
  45. package/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +0 -10
  46. package/esm/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.d.ts +0 -47
  47. package/esm/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +0 -38
  48. package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +0 -21
  49. package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts +0 -1
  50. package/esm/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts +0 -11
  51. package/esm/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +0 -13
  52. package/esm/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts +0 -46
  53. package/esm/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.test.d.ts +0 -1
  54. package/esm/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +0 -38
  55. package/esm/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts +0 -1
  56. package/esm/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +0 -9
  57. package/esm/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +0 -12
  58. package/esm/src/commitments/USE_TIME/USE_TIME.d.ts +0 -43
  59. package/esm/src/commitments/USE_TIME/USE_TIME.test.d.ts +0 -1
  60. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +0 -11
  61. package/esm/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +0 -212
  62. package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +0 -38
  63. package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts +0 -1
  64. package/esm/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +0 -6
  65. package/esm/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +0 -8
  66. package/esm/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +0 -7
  67. package/esm/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  68. package/esm/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +0 -78
  69. package/esm/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +0 -8
  70. package/esm/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +0 -13
  71. package/esm/src/commitments/WALLET/WALLET.d.ts +0 -21
  72. package/esm/src/commitments/WALLET/WALLET.test.d.ts +0 -1
  73. package/esm/src/commitments/WALLET/WalletToolNames.d.ts +0 -12
  74. package/esm/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +0 -163
  75. package/esm/src/commitments/WALLET/createWalletSystemMessage.d.ts +0 -6
  76. package/esm/src/commitments/WALLET/createWalletToolFunctions.d.ts +0 -8
  77. package/esm/src/commitments/WALLET/createWalletTools.d.ts +0 -7
  78. package/esm/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +0 -6
  79. package/esm/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +0 -16
  80. package/esm/src/commitments/WALLET/getWalletToolTitles.d.ts +0 -7
  81. package/esm/src/commitments/WALLET/parseWalletToolArgs.d.ts +0 -51
  82. package/esm/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +0 -8
  83. package/esm/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +0 -13
  84. package/esm/src/commitments/_common/createSerpSearchToolFunction.d.ts +0 -12
  85. package/umd/src/book-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts +0 -1
  86. package/umd/src/commitments/MEMORY/MEMORY.d.ts +0 -48
  87. package/umd/src/commitments/MEMORY/MEMORY.test.d.ts +0 -1
  88. package/umd/src/commitments/MEMORY/MemoryToolNames.d.ts +0 -11
  89. package/umd/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts +0 -149
  90. package/umd/src/commitments/MEMORY/createMemorySystemMessage.d.ts +0 -6
  91. package/umd/src/commitments/MEMORY/createMemoryToolFunctions.d.ts +0 -8
  92. package/umd/src/commitments/MEMORY/createMemoryTools.d.ts +0 -14
  93. package/umd/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts +0 -6
  94. package/umd/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  95. package/umd/src/commitments/MEMORY/getMemoryToolTitles.d.ts +0 -7
  96. package/umd/src/commitments/MEMORY/parseMemoryToolArgs.d.ts +0 -61
  97. package/umd/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts +0 -8
  98. package/umd/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts +0 -13
  99. package/umd/src/commitments/META/META.d.ts +0 -65
  100. package/umd/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts +0 -32
  101. package/umd/src/commitments/USE_BROWSER/USE_BROWSER.d.ts +0 -58
  102. package/umd/src/commitments/USE_BROWSER/USE_BROWSER.test.d.ts +0 -1
  103. package/umd/src/commitments/USE_BROWSER/fetchUrlContentViaBrowser.d.ts +0 -13
  104. package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts +0 -10
  105. package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts +0 -1
  106. package/umd/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.d.ts +0 -47
  107. package/umd/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.test.d.ts +0 -1
  108. package/umd/src/commitments/USE_EMAIL/USE_EMAIL.d.ts +0 -38
  109. package/umd/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts +0 -1
  110. package/umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts +0 -21
  111. package/umd/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts +0 -1
  112. package/umd/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts +0 -11
  113. package/umd/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts +0 -13
  114. package/umd/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts +0 -46
  115. package/umd/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.test.d.ts +0 -1
  116. package/umd/src/commitments/USE_SPAWN/USE_SPAWN.d.ts +0 -38
  117. package/umd/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts +0 -1
  118. package/umd/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts +0 -9
  119. package/umd/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts +0 -12
  120. package/umd/src/commitments/USE_TIME/USE_TIME.d.ts +0 -43
  121. package/umd/src/commitments/USE_TIME/USE_TIME.test.d.ts +0 -1
  122. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts +0 -11
  123. package/umd/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts +0 -212
  124. package/umd/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts +0 -38
  125. package/umd/src/commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts +0 -1
  126. package/umd/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts +0 -6
  127. package/umd/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts +0 -8
  128. package/umd/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts +0 -7
  129. package/umd/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts +0 -17
  130. package/umd/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts +0 -78
  131. package/umd/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts +0 -8
  132. package/umd/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts +0 -13
  133. package/umd/src/commitments/WALLET/WALLET.d.ts +0 -21
  134. package/umd/src/commitments/WALLET/WALLET.test.d.ts +0 -1
  135. package/umd/src/commitments/WALLET/WalletToolNames.d.ts +0 -12
  136. package/umd/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts +0 -163
  137. package/umd/src/commitments/WALLET/createWalletSystemMessage.d.ts +0 -6
  138. package/umd/src/commitments/WALLET/createWalletToolFunctions.d.ts +0 -8
  139. package/umd/src/commitments/WALLET/createWalletTools.d.ts +0 -7
  140. package/umd/src/commitments/WALLET/getWalletCommitmentDocumentation.d.ts +0 -6
  141. package/umd/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.d.ts +0 -16
  142. package/umd/src/commitments/WALLET/getWalletToolTitles.d.ts +0 -7
  143. package/umd/src/commitments/WALLET/parseWalletToolArgs.d.ts +0 -51
  144. package/umd/src/commitments/WALLET/resolveWalletRuntimeContext.d.ts +0 -8
  145. package/umd/src/commitments/WALLET/setWalletToolRuntimeAdapter.d.ts +0 -13
  146. package/umd/src/commitments/_common/createSerpSearchToolFunction.d.ts +0 -12
  147. /package/esm/src/book-2.0/agent-source/{createAgentModelRequirements.useCommitmentAggregation.test.d.ts → createAgentModelRequirements.commitmentAggregation.test.d.ts} +0 -0
  148. /package/esm/src/{commitments/MEMORY/MEMORY.test.d.ts → cli/cli-commands/coder/boilerplateCount.test.d.ts} +0 -0
  149. /package/esm/src/{commitments/USE_BROWSER/USE_BROWSER.test.d.ts → cli/cli-commands/coder/generate-boilerplates.test.d.ts} +0 -0
  150. /package/esm/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.d.ts +0 -0
  151. /package/{esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts → umd/src/book-2.0/agent-source/createAgentModelRequirements.commitmentAggregation.test.d.ts} +0 -0
  152. /package/{esm/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.test.d.ts → umd/src/cli/cli-commands/coder/boilerplateCount.test.d.ts} +0 -0
  153. /package/{esm/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts → umd/src/cli/cli-commands/coder/generate-boilerplates.test.d.ts} +0 -0
  154. /package/umd/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.d.ts +0 -0
package/README.md CHANGED
@@ -96,8 +96,6 @@ Respond to incoming legal inquiries via email and keep the company website updat
96
96
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
97
97
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
98
98
  <br/>
99
- USE EMAIL<br/>
100
- USE BROWSER<br/>
101
99
  <br/>
102
100
  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/>
103
101
 
@@ -186,7 +184,7 @@ GOAL Keep the company website updated with the latest legal policies and complia
186
184
 
187
185
  #### `Use` commitments
188
186
 
189
- Use commitments grant the agent real capabilities - tools it can use to interact with the outside world. `USE EMAIL` lets the agent send emails, `USE BROWSER` lets it access and read web content, `USE SEARCH ENGINE` lets it search the web, and many more.
187
+ Use commitments grant the agent real capabilities - tools it can use to interact with the outside world. `USE CALENDAR` lets the agent work with a calendar, `USE PROJECT` gives it access to a code repository, `USE MCP` connects any external Model Context Protocol server, and many more.
190
188
 
191
189
  These are what turn a chatbot into a persistent agent that actually does work.
192
190
 
@@ -203,9 +201,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
203
201
  **RULE** Never provide legal advice about criminal law.<br/>
204
202
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
205
203
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
206
- USE EMAIL<br/>
207
- USE BROWSER<br/>
208
- USE SEARCH ENGINE<br/>
209
204
 
210
205
  </td></tr></table>
211
206
 
@@ -226,9 +221,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
226
221
  **RULE** Never provide legal advice about criminal law.<br/>
227
222
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
228
223
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
229
- USE EMAIL<br/>
230
- USE BROWSER<br/>
231
- USE SEARCH ENGINE<br/>
232
224
  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/>
233
225
 
234
226
  </td></tr></table>
@@ -415,7 +407,7 @@ Or you can install them separately:
415
407
 
416
408
  Promptbook Coder is **not another standalone coding model**. It is an orchestration layer over coding agents such as **GitHub Copilot**, **OpenAI Codex**, **Claude Code**, **Opencode**, **Cline**, and **Gemini CLI**. The difference is that Promptbook Coder adds a repeatable repository workflow on top of them:
417
409
 
418
- - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
410
+ - prompt files with explicit statuses like `[ ]`, `[^]`, `[x]`, and `[-]`
419
411
  - automatic selection of the next runnable task, including priority support
420
412
  - optional shared repo context loaded from a file such as `AGENTS.md`
421
413
  - automatic `git add`, commit, and push after each successful prompt
@@ -430,11 +422,11 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
430
422
  1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.promptbook`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
431
423
  2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
432
424
  3. You replace placeholder `@@@` sections with real coding tasks.
433
- 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
425
+ 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent and immediately marks it as in progress `[^]`, naming the harness, the model and the step which is running.
434
426
  5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
435
427
  6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
436
428
 
437
- Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
429
+ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority. A prompt left as `[^]` was interrupted in the middle of its implementation — the in-progress status is never reverted, so a killed or crashed coder always leaves that signal behind.
438
430
 
439
431
  #### Features
440
432