@promptbook/components 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 +5 -13
  2. package/esm/index.es.js +559 -4005
  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 +1 -1
  16. package/umd/index.umd.js +563 -4009
  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
@@ -144,7 +144,7 @@ interface BookEditorProps {
144
144
  onChange?: (value: string) => void;
145
145
 
146
146
  // Explicit list of commitment keywords to highlight (case-insensitive).
147
- // If omitted, a default set (PERSONA, KNOWLEDGE, MEMORY, STYLE, RULE, RULES, WRITING SAMPLE, WRITING RULES, SAMPLE, EXAMPLE, FORMAT, MODEL, ACTION, META IMAGE, META LINK, NOTE, GOAL, MESSAGE, SCENARIO, DELETE, CANCEL, DISCARD, REMOVE, EXPECT, SCENARIOS, BEHAVIOUR, BEHAVIOURS, AVOID, AVOIDANCE, GOALS, CONTEXT) is used.
147
+ // If omitted, a default set (PERSONA, KNOWLEDGE, STYLE, RULE, RULES, WRITING SAMPLE, WRITING RULES, SAMPLE, EXAMPLE, FORMAT, MODEL, ACTION, META IMAGE, META LINK, NOTE, GOAL, MESSAGE, SCENARIO, DELETE, CANCEL, DISCARD, REMOVE, EXPECT, SCENARIOS, BEHAVIOUR, BEHAVIOURS, AVOID, AVOIDANCE, GOALS, CONTEXT) is used.
148
148
  commitmentTypes?: string[];
149
149
  }
150
150
  ```
@@ -237,8 +237,6 @@ Respond to incoming legal inquiries via email and keep the company website updat
237
237
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
238
238
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
239
239
  <br/>
240
- USE EMAIL<br/>
241
- USE BROWSER<br/>
242
240
  <br/>
243
241
  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/>
244
242
 
@@ -327,7 +325,7 @@ GOAL Keep the company website updated with the latest legal policies and complia
327
325
 
328
326
  #### `Use` commitments
329
327
 
330
- 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.
328
+ 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.
331
329
 
332
330
  These are what turn a chatbot into a persistent agent that actually does work.
333
331
 
@@ -344,9 +342,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
344
342
  **RULE** Never provide legal advice about criminal law.<br/>
345
343
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
346
344
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
347
- USE EMAIL<br/>
348
- USE BROWSER<br/>
349
- USE SEARCH ENGINE<br/>
350
345
 
351
346
  </td></tr></table>
352
347
 
@@ -367,9 +362,6 @@ GOAL Keep the company website updated with the latest legal policies and complia
367
362
  **RULE** Never provide legal advice about criminal law.<br/>
368
363
  **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
369
364
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
370
- USE EMAIL<br/>
371
- USE BROWSER<br/>
372
- USE SEARCH ENGINE<br/>
373
365
  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/>
374
366
 
375
367
  </td></tr></table>
@@ -556,7 +548,7 @@ Or you can install them separately:
556
548
 
557
549
  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:
558
550
 
559
- - prompt files with explicit statuses like `[ ]`, `[x]`, and `[-]`
551
+ - prompt files with explicit statuses like `[ ]`, `[^]`, `[x]`, and `[-]`
560
552
  - automatic selection of the next runnable task, including priority support
561
553
  - optional shared repo context loaded from a file such as `AGENTS.md`
562
554
  - automatic `git add`, commit, and push after each successful prompt
@@ -571,11 +563,11 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
571
563
  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/`.
572
564
  2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
573
565
  3. You replace placeholder `@@@` sections with real coding tasks.
574
- 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
566
+ 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.
575
567
  5. Promptbook Coder marks the prompt as done `[x]`, records runner metadata, then stages, commits, and pushes the resulting changes.
576
568
  6. `ptbk coder verify` reviews completed prompts, archives finished files to `prompts/done/`, and appends a repair prompt when more work is needed.
577
569
 
578
- Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treated as not fully written, and prompts with more `!` markers have higher priority.
570
+ 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.
579
571
 
580
572
  #### Features
581
573