@promptbook/wizard 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 +8 -3
  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 +3 -3
  23. package/umd/index.umd.js +8 -3
  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
 
@@ -74,13 +74,13 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
74
74
 
75
75
  ## 📖 The Book Whitepaper
76
76
 
77
- 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.
77
+ 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.
78
78
 
79
79
  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.
80
80
 
81
81
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
82
82
 
83
- 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.
83
+ 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.
84
84
 
85
85
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
86
86
 
@@ -181,7 +181,7 @@ Your job is to provide legal advice and support to the company and its employees
181
181
 
182
182
  #### `Use` commitments
183
183
 
184
- 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.
184
+ 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.
185
185
 
186
186
  These are what turn a chatbot into a persistent agent that actually does work.
187
187
 
@@ -230,7 +230,7 @@ Your job is to provide legal advice and support to the company and its employees
230
230
 
231
231
  ### Promptbook Ecosystem
232
232
 
233
- Promptbook is an ecosystem of tools centered around the **Agents Server** a production-ready platform for running persistent AI agents.
233
+ Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
234
234
 
235
235
  #### Agents Server
236
236
 
@@ -252,7 +252,7 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
252
252
 
253
253
  ## 💜 The Promptbook Project
254
254
 
255
- 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:
255
+ 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:
256
256
 
257
257
  <table>
258
258
  <thead>
@@ -265,7 +265,7 @@ Promptbook project is an ecosystem centered around the **Agents Server** — a p
265
265
  <tr>
266
266
  <td><a href="https://gallery.ptbk.io/"><strong>⭐ Agents Server</strong></a></td>
267
267
  <td>
268
- 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>.
268
+ 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>.
269
269
  </td>
270
270
  </tr>
271
271
  <tr>
@@ -355,8 +355,8 @@ For information on reporting security vulnerabilities, see our [Security Policy]
355
355
 
356
356
  The fastest way to get started is with the **Agents Server**:
357
357
 
358
- - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** Self-host the Agents Server with full control over your data
359
- - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** Start creating agents immediately, no setup required
358
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Self-host the Agents Server with full control over your data
359
+ - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** - Start creating agents immediately, no setup required
360
360
 
361
361
  ### NPM Packages _(for developers embedding the Engine)_
362
362
 
@@ -501,7 +501,7 @@ npx ptbk coder verify
501
501
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
502
502
  | `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/`. |
503
503
  | `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. |
504
- | `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. |
504
+ | `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. |
505
505
  | `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. |
506
506
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
507
507
 
@@ -512,7 +512,7 @@ npx ptbk coder verify
512
512
  | `--agent <name>` | Selects the coding backend. |
513
513
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
514
514
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
515
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
515
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
516
516
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
517
517
  | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
518
518
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
@@ -615,8 +615,8 @@ _Note: This section is not a complete dictionary, more list of general AI / LLM
615
615
 
616
616
  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.
617
617
 
618
- - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) start creating agents immediately
619
- - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) full control over your data and infrastructure
618
+ - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) - start creating agents immediately
619
+ - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) - full control over your data and infrastructure
620
620
  - **API** for integrating agents into your own applications
621
621
 
622
622
  ## 🚂 Promptbook Engine
@@ -634,7 +634,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
634
634
  - When you want agents that **collaborate in teams** and consult each other
635
635
  - When you need to **integrate AI agents into your existing applications** via API
636
636
  - When you want to **self-host** your AI agents with full control over data and infrastructure
637
- - When you are writing an app that generates complex things via LLM like **websites, articles, presentations, code, stories, songs**,...
637
+ - When you are writing an app that generates complex things via LLM - like **websites, articles, presentations, code, stories, songs**,...
638
638
  - When you want to **version** your agent definitions and **test multiple versions**
639
639
  - When you want to **log** agent execution and backtrace issues
640
640
 
@@ -646,7 +646,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
646
646
  - When [OpenAI Assistant (GPTs)](https://help.openai.com/en/articles/8673914-gpts-vs-assistants) is enough for you
647
647
  - When you need streaming _(this may be implemented in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/102))_
648
648
  - 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))_
649
- - 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))_
649
+ - 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))_
650
650
  - When you need to use recursion _([see the discussion](https://github.com/webgptorg/promptbook/discussions/38))_
651
651
 
652
652
  [See more](https://github.com/webgptorg/promptbook/discussions/112)
package/esm/index.es.js CHANGED
@@ -38,7 +38,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
38
38
  * @generated
39
39
  * @see https://github.com/webgptorg/promptbook
40
40
  */
41
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-46';
41
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-47';
42
42
  /**
43
43
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
44
44
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1064,7 +1064,7 @@ Color.fromHex('#1D4ED8');
1064
1064
  *
1065
1065
  * @public exported from `@promptbook/core`
1066
1066
  */
1067
- const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
1067
+ const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
1068
1068
  /**
1069
1069
  * When the title of task is not provided, the default title is used
1070
1070
  *
@@ -41531,9 +41531,10 @@ function formatMetaLine(label, value) {
41531
41531
  * Build a minimal agent source snapshot for remote agents.
41532
41532
  */
41533
41533
  function buildRemoteAgentSource(profile, meta) {
41534
+ const isMetaImageExplicit = profile.isMetaImageExplicit !== false;
41534
41535
  const metaLines = [
41535
41536
  formatMetaLine('FULLNAME', meta === null || meta === void 0 ? void 0 : meta.fullname),
41536
- formatMetaLine('IMAGE', meta === null || meta === void 0 ? void 0 : meta.image),
41537
+ formatMetaLine('IMAGE', isMetaImageExplicit ? meta === null || meta === void 0 ? void 0 : meta.image : undefined),
41537
41538
  formatMetaLine('DESCRIPTION', meta === null || meta === void 0 ? void 0 : meta.description),
41538
41539
  formatMetaLine('COLOR', meta === null || meta === void 0 ? void 0 : meta.color),
41539
41540
  formatMetaLine('FONT', meta === null || meta === void 0 ? void 0 : meta.font),
@@ -41632,6 +41633,8 @@ class RemoteAgent extends Agent {
41632
41633
  remoteAgent._isVoiceCallingEnabled = profile.isVoiceCallingEnabled === true; // [✨✷] Store voice calling status
41633
41634
  remoteAgent._isVoiceTtsSttEnabled = profile.isVoiceTtsSttEnabled !== false;
41634
41635
  remoteAgent.knowledgeSources = profile.knowledgeSources || [];
41636
+ remoteAgent.isMetaImageExplicit = profile.isMetaImageExplicit !== false;
41637
+ remoteAgent.avatarVisualId = profile.avatarVisualId;
41635
41638
  return remoteAgent;
41636
41639
  }
41637
41640
  /**
@@ -41647,6 +41650,8 @@ class RemoteAgent extends Agent {
41647
41650
  this.toolTitles = {};
41648
41651
  this._isVoiceCallingEnabled = false; // [✨✷] Track voice calling status
41649
41652
  this._isVoiceTtsSttEnabled = true;
41653
+ this.isMetaImageExplicit = true;
41654
+ this.avatarVisualId = undefined;
41650
41655
  this.knowledgeSources = [];
41651
41656
  this.agentUrl = options.agentUrl;
41652
41657
  }