@promptbook/node 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 +508 -4664
  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 -5
  16. package/umd/index.umd.js +511 -4667
  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
@@ -152,8 +152,6 @@ Respond to incoming legal inquiries via email and keep the company website updat
152
152
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
153
153
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
154
154
  <br/>
155
- USE EMAIL<br/>
156
- USE BROWSER<br/>
157
155
  <br/>
158
156
  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/>
159
157
 
@@ -242,7 +240,7 @@ GOAL Keep the company website updated with the latest legal policies and complia
242
240
 
243
241
  #### `Use` commitments
244
242
 
245
- 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.
243
+ 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.
246
244
 
247
245
  These are what turn a chatbot into a persistent agent that actually does work.
248
246
 
@@ -259,9 +257,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
259
257
  **RULE** Never provide legal advice about criminal law.<br/>
260
258
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
261
259
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
262
- USE EMAIL<br/>
263
- USE BROWSER<br/>
264
- USE SEARCH ENGINE<br/>
265
260
 
266
261
  </td></tr></table>
267
262
 
@@ -282,9 +277,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
282
277
  **RULE** Never provide legal advice about criminal law.<br/>
283
278
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
284
279
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
285
- USE EMAIL<br/>
286
- USE BROWSER<br/>
287
- USE SEARCH ENGINE<br/>
288
280
  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/>
289
281
 
290
282
  </td></tr></table>
@@ -471,7 +463,7 @@ Or you can install them separately:
471
463
 
472
464
  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:
473
465
 
474
- - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
466
+ - prompt files with explicit statuses like `[ ]`, `[^]`, `[x]`, and `[-]`
475
467
  - automatic selection of the next runnable task, including priority support
476
468
  - optional shared repo context loaded from a file such as `AGENTS.md`
477
469
  - automatic `git add`, commit, and push after each successful prompt
@@ -486,11 +478,11 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
486
478
  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/`.
487
479
  2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
488
480
  3. You replace placeholder `@@@` sections with real coding tasks.
489
- 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
481
+ 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.
490
482
  5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
491
483
  6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
492
484
 
493
- Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
485
+ 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.
494
486
 
495
487
  #### Features
496
488