@promptbook/markdown-utils 0.112.0-46 → 0.112.0-47

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 (42) hide show
  1. package/README.md +16 -16
  2. package/esm/index.es.js +2 -2
  3. package/esm/index.es.js.map +1 -1
  4. package/esm/src/avatars/AvatarOrImage.d.ts +45 -0
  5. package/esm/src/avatars/index.d.ts +1 -0
  6. package/esm/src/avatars/types/AvatarVisualDefinition.d.ts +6 -1
  7. package/esm/src/avatars/visuals/asciiOctopusAvatarVisual.d.ts +7 -0
  8. package/esm/src/avatars/visuals/octopus3AvatarVisual.d.ts +7 -0
  9. package/esm/src/avatars/visuals/octopusAvatarVisualShared.d.ts +125 -0
  10. package/esm/src/book-components/Chat/Chat/ChatMessageItem.d.ts +1 -1
  11. package/esm/src/book-components/Chat/Chat/ChatMessageList.d.ts +1 -1
  12. package/esm/src/book-components/Chat/Chat/ChatProps.d.ts +1 -1
  13. package/esm/src/book-components/Chat/Chat/ChatToolCallModalComponents.d.ts +8 -2
  14. package/esm/src/book-components/Chat/hooks/useChatCompleteNotification.d.ts +2 -0
  15. package/esm/src/book-components/Chat/types/ChatParticipant.d.ts +10 -0
  16. package/esm/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts +1 -1
  17. package/esm/src/config.d.ts +2 -2
  18. package/esm/src/llm-providers/agent/RemoteAgent.d.ts +3 -0
  19. package/esm/src/utils/agents/resolveAgentAvatarImageUrl.d.ts +49 -5
  20. package/esm/src/utils/agents/resolveAgentAvatarImageUrl.test.d.ts +1 -0
  21. package/esm/src/version.d.ts +1 -1
  22. package/package.json +2 -2
  23. package/umd/index.umd.js +2 -2
  24. package/umd/index.umd.js.map +1 -1
  25. package/umd/src/avatars/AvatarOrImage.d.ts +45 -0
  26. package/umd/src/avatars/index.d.ts +1 -0
  27. package/umd/src/avatars/types/AvatarVisualDefinition.d.ts +6 -1
  28. package/umd/src/avatars/visuals/asciiOctopusAvatarVisual.d.ts +7 -0
  29. package/umd/src/avatars/visuals/octopus3AvatarVisual.d.ts +7 -0
  30. package/umd/src/avatars/visuals/octopusAvatarVisualShared.d.ts +125 -0
  31. package/umd/src/book-components/Chat/Chat/ChatMessageItem.d.ts +1 -1
  32. package/umd/src/book-components/Chat/Chat/ChatMessageList.d.ts +1 -1
  33. package/umd/src/book-components/Chat/Chat/ChatProps.d.ts +1 -1
  34. package/umd/src/book-components/Chat/Chat/ChatToolCallModalComponents.d.ts +8 -2
  35. package/umd/src/book-components/Chat/hooks/useChatCompleteNotification.d.ts +2 -0
  36. package/umd/src/book-components/Chat/types/ChatParticipant.d.ts +10 -0
  37. package/umd/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts +1 -1
  38. package/umd/src/config.d.ts +2 -2
  39. package/umd/src/llm-providers/agent/RemoteAgent.d.ts +3 -0
  40. package/umd/src/utils/agents/resolveAgentAvatarImageUrl.d.ts +49 -5
  41. package/umd/src/utils/agents/resolveAgentAvatarImageUrl.test.d.ts +1 -0
  42. package/umd/src/version.d.ts +1 -1
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <!-- ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten -->
2
2
 
3
- # Promptbook: AI Agents
3
+ # 🐙 Promptbook: Invisible AI Agents
4
4
 
5
- Create persistent AI agents that turn your company's scattered knowledge into action powered by the [Agents Server](https://gallery.ptbk.io/)
5
+ Create persistent AI agents that turn your company's scattered knowledge into action - powered by the [Agents Server](https://gallery.ptbk.io/)
6
6
 
7
7
 
8
8
 
@@ -146,13 +146,13 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
146
146
 
147
147
  ## 📖 The Book Whitepaper
148
148
 
149
- 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.
149
+ 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.
150
150
 
151
151
  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.
152
152
 
153
153
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
154
154
 
155
- In Promptbook, you define your agents **using simple Books** a human-readable language that is explicit, easy to understand and write, reliable, and highly portable. You then deploy them to the **Agents Server**, where they run persistently and work toward their goals.
155
+ In Promptbook, you define your agents **using simple Books** - a human-readable language that is explicit, easy to understand and write, reliable, and highly portable. You then deploy them to the **Agents Server**, where they run persistently and work toward their goals.
156
156
 
157
157
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
158
158
 
@@ -253,7 +253,7 @@ Your job is to provide legal advice and support to the company and its employees
253
253
 
254
254
  #### `Use` commitments
255
255
 
256
- 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.
256
+ 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.
257
257
 
258
258
  These are what turn a chatbot into a persistent agent that actually does work.
259
259
 
@@ -302,7 +302,7 @@ Your job is to provide legal advice and support to the company and its employees
302
302
 
303
303
  ### Promptbook Ecosystem
304
304
 
305
- Promptbook is an ecosystem of tools centered around the **Agents Server** a production-ready platform for running persistent AI agents.
305
+ Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
306
306
 
307
307
  #### Agents Server
308
308
 
@@ -324,7 +324,7 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
324
324
 
325
325
  ## 💜 The Promptbook Project
326
326
 
327
- 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:
327
+ 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:
328
328
 
329
329
  <table>
330
330
  <thead>
@@ -337,7 +337,7 @@ Promptbook project is an ecosystem centered around the **Agents Server** — a p
337
337
  <tr>
338
338
  <td><a href="https://gallery.ptbk.io/"><strong>⭐ Agents Server</strong></a></td>
339
339
  <td>
340
- The primary way to use Promptbook. A production-ready platform where your AI agents live create, manage, deploy, and interact with persistent agents that work on goals. Available as a hosted service or <a href="https://hub.docker.com/r/hejny/promptbook/">self-hosted via Docker</a>.
340
+ The primary way to use Promptbook. A production-ready platform where your AI agents live - create, manage, deploy, and interact with persistent agents that work on goals. Available as a hosted service or <a href="https://hub.docker.com/r/hejny/promptbook/">self-hosted via Docker</a>.
341
341
  </td>
342
342
  </tr>
343
343
  <tr>
@@ -427,8 +427,8 @@ For information on reporting security vulnerabilities, see our [Security Policy]
427
427
 
428
428
  The fastest way to get started is with the **Agents Server**:
429
429
 
430
- - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** Self-host the Agents Server with full control over your data
431
- - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** Start creating agents immediately, no setup required
430
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Self-host the Agents Server with full control over your data
431
+ - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** - Start creating agents immediately, no setup required
432
432
 
433
433
  ### NPM Packages _(for developers embedding the Engine)_
434
434
 
@@ -573,7 +573,7 @@ npx ptbk coder verify
573
573
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
574
574
  | `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 `/.tmp`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
575
575
  | `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. |
576
- | `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. |
576
+ | `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. |
577
577
  | `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. |
578
578
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
579
579
 
@@ -584,7 +584,7 @@ npx ptbk coder verify
584
584
  | `--agent <name>` | Selects the coding backend. |
585
585
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
586
586
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
587
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
587
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
588
588
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
589
589
  | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
590
590
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
@@ -687,8 +687,8 @@ _Note: This section is not a complete dictionary, more list of general AI / LLM
687
687
 
688
688
  The **[Agents Server](https://gallery.ptbk.io/)** is the primary way to use Promptbook. It is a production-ready platform where you create, deploy, and manage persistent AI agents that work toward goals. Agents remember context across conversations, collaborate in teams, and follow the rules and knowledge you define in the Book language.
689
689
 
690
- - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) start creating agents immediately
691
- - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) full control over your data and infrastructure
690
+ - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) - start creating agents immediately
691
+ - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) - full control over your data and infrastructure
692
692
  - **API** for integrating agents into your own applications
693
693
 
694
694
  ## 🚂 Promptbook Engine
@@ -706,7 +706,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
706
706
  - When you want agents that **collaborate in teams** and consult each other
707
707
  - When you need to **integrate AI agents into your existing applications** via API
708
708
  - When you want to **self-host** your AI agents with full control over data and infrastructure
709
- - When you are writing an app that generates complex things via LLM like **websites, articles, presentations, code, stories, songs**,...
709
+ - When you are writing an app that generates complex things via LLM - like **websites, articles, presentations, code, stories, songs**,...
710
710
  - When you want to **version** your agent definitions and **test multiple versions**
711
711
  - When you want to **log** agent execution and backtrace issues
712
712
 
@@ -718,7 +718,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
718
718
  - When [OpenAI Assistant (GPTs)](https://help.openai.com/en/articles/8673914-gpts-vs-assistants) is enough for you
719
719
  - When you need streaming _(this may be implemented in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/102))_
720
720
  - When you need to use something other than JavaScript or TypeScript _(other languages are on the way, [see the discussion](https://github.com/webgptorg/promptbook/discussions/101))_
721
- - When your main focus is on something other than text like images, audio, video, spreadsheets _(other media types may be added in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/103))_
721
+ - When your main focus is on something other than text - like images, audio, video, spreadsheets _(other media types may be added in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/103))_
722
722
  - When you need to use recursion _([see the discussion](https://github.com/webgptorg/promptbook/discussions/38))_
723
723
 
724
724
  [See more](https://github.com/webgptorg/promptbook/discussions/112)
package/esm/index.es.js CHANGED
@@ -23,7 +23,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
23
23
  * @generated
24
24
  * @see https://github.com/webgptorg/promptbook
25
25
  */
26
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-46';
26
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-47';
27
27
  /**
28
28
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
29
29
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1181,7 +1181,7 @@ Color.fromHex('#1D4ED8');
1181
1181
  *
1182
1182
  * @public exported from `@promptbook/core`
1183
1183
  */
1184
- const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
1184
+ const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
1185
1185
  /**
1186
1186
  * Maximum file size limit
1187
1187
  *