@promptbook/browser 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
 
@@ -102,13 +102,13 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
102
102
 
103
103
  ## 📖 The Book Whitepaper
104
104
 
105
- 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.
105
+ 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.
106
106
 
107
107
  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.
108
108
 
109
109
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
110
110
 
111
- 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.
111
+ 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.
112
112
 
113
113
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
114
114
 
@@ -209,7 +209,7 @@ Your job is to provide legal advice and support to the company and its employees
209
209
 
210
210
  #### `Use` commitments
211
211
 
212
- 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.
212
+ 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.
213
213
 
214
214
  These are what turn a chatbot into a persistent agent that actually does work.
215
215
 
@@ -258,7 +258,7 @@ Your job is to provide legal advice and support to the company and its employees
258
258
 
259
259
  ### Promptbook Ecosystem
260
260
 
261
- Promptbook is an ecosystem of tools centered around the **Agents Server** a production-ready platform for running persistent AI agents.
261
+ Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
262
262
 
263
263
  #### Agents Server
264
264
 
@@ -280,7 +280,7 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
280
280
 
281
281
  ## 💜 The Promptbook Project
282
282
 
283
- 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:
283
+ 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:
284
284
 
285
285
  <table>
286
286
  <thead>
@@ -293,7 +293,7 @@ Promptbook project is an ecosystem centered around the **Agents Server** — a p
293
293
  <tr>
294
294
  <td><a href="https://gallery.ptbk.io/"><strong>⭐ Agents Server</strong></a></td>
295
295
  <td>
296
- 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>.
296
+ 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>.
297
297
  </td>
298
298
  </tr>
299
299
  <tr>
@@ -383,8 +383,8 @@ For information on reporting security vulnerabilities, see our [Security Policy]
383
383
 
384
384
  The fastest way to get started is with the **Agents Server**:
385
385
 
386
- - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** Self-host the Agents Server with full control over your data
387
- - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** Start creating agents immediately, no setup required
386
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Self-host the Agents Server with full control over your data
387
+ - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** - Start creating agents immediately, no setup required
388
388
 
389
389
  ### NPM Packages _(for developers embedding the Engine)_
390
390
 
@@ -529,7 +529,7 @@ npx ptbk coder verify
529
529
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
530
530
  | `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/`. |
531
531
  | `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. |
532
- | `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. |
532
+ | `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. |
533
533
  | `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. |
534
534
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
535
535
 
@@ -540,7 +540,7 @@ npx ptbk coder verify
540
540
  | `--agent <name>` | Selects the coding backend. |
541
541
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
542
542
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
543
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
543
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
544
544
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
545
545
  | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
546
546
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
@@ -643,8 +643,8 @@ _Note: This section is not a complete dictionary, more list of general AI / LLM
643
643
 
644
644
  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.
645
645
 
646
- - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) start creating agents immediately
647
- - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) full control over your data and infrastructure
646
+ - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) - start creating agents immediately
647
+ - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) - full control over your data and infrastructure
648
648
  - **API** for integrating agents into your own applications
649
649
 
650
650
  ## 🚂 Promptbook Engine
@@ -662,7 +662,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
662
662
  - When you want agents that **collaborate in teams** and consult each other
663
663
  - When you need to **integrate AI agents into your existing applications** via API
664
664
  - When you want to **self-host** your AI agents with full control over data and infrastructure
665
- - When you are writing an app that generates complex things via LLM like **websites, articles, presentations, code, stories, songs**,...
665
+ - When you are writing an app that generates complex things via LLM - like **websites, articles, presentations, code, stories, songs**,...
666
666
  - When you want to **version** your agent definitions and **test multiple versions**
667
667
  - When you want to **log** agent execution and backtrace issues
668
668
 
@@ -674,7 +674,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
674
674
  - When [OpenAI Assistant (GPTs)](https://help.openai.com/en/articles/8673914-gpts-vs-assistants) is enough for you
675
675
  - When you need streaming _(this may be implemented in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/102))_
676
676
  - 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))_
677
- - 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))_
677
+ - 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))_
678
678
  - When you need to use recursion _([see the discussion](https://github.com/webgptorg/promptbook/discussions/38))_
679
679
 
680
680
  [See more](https://github.com/webgptorg/promptbook/discussions/112)
package/esm/index.es.js CHANGED
@@ -29,7 +29,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
29
29
  * @generated
30
30
  * @see https://github.com/webgptorg/promptbook
31
31
  */
32
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-46';
32
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-47';
33
33
  /**
34
34
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
35
35
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1041,7 +1041,7 @@ Color.fromHex('#1D4ED8');
1041
1041
  *
1042
1042
  * @public exported from `@promptbook/core`
1043
1043
  */
1044
- const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
1044
+ const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
1045
1045
  /**
1046
1046
  * Maximum file size limit
1047
1047
  *
@@ -30988,9 +30988,10 @@ function formatMetaLine(label, value) {
30988
30988
  * Build a minimal agent source snapshot for remote agents.
30989
30989
  */
30990
30990
  function buildRemoteAgentSource(profile, meta) {
30991
+ const isMetaImageExplicit = profile.isMetaImageExplicit !== false;
30991
30992
  const metaLines = [
30992
30993
  formatMetaLine('FULLNAME', meta === null || meta === void 0 ? void 0 : meta.fullname),
30993
- formatMetaLine('IMAGE', meta === null || meta === void 0 ? void 0 : meta.image),
30994
+ formatMetaLine('IMAGE', isMetaImageExplicit ? meta === null || meta === void 0 ? void 0 : meta.image : undefined),
30994
30995
  formatMetaLine('DESCRIPTION', meta === null || meta === void 0 ? void 0 : meta.description),
30995
30996
  formatMetaLine('COLOR', meta === null || meta === void 0 ? void 0 : meta.color),
30996
30997
  formatMetaLine('FONT', meta === null || meta === void 0 ? void 0 : meta.font),
@@ -31089,6 +31090,8 @@ class RemoteAgent extends Agent {
31089
31090
  remoteAgent._isVoiceCallingEnabled = profile.isVoiceCallingEnabled === true; // [✨✷] Store voice calling status
31090
31091
  remoteAgent._isVoiceTtsSttEnabled = profile.isVoiceTtsSttEnabled !== false;
31091
31092
  remoteAgent.knowledgeSources = profile.knowledgeSources || [];
31093
+ remoteAgent.isMetaImageExplicit = profile.isMetaImageExplicit !== false;
31094
+ remoteAgent.avatarVisualId = profile.avatarVisualId;
31092
31095
  return remoteAgent;
31093
31096
  }
31094
31097
  /**
@@ -31104,6 +31107,8 @@ class RemoteAgent extends Agent {
31104
31107
  this.toolTitles = {};
31105
31108
  this._isVoiceCallingEnabled = false; // [✨✷] Track voice calling status
31106
31109
  this._isVoiceTtsSttEnabled = true;
31110
+ this.isMetaImageExplicit = true;
31111
+ this.avatarVisualId = undefined;
31107
31112
  this.knowledgeSources = [];
31108
31113
  this.agentUrl = options.agentUrl;
31109
31114
  }