@promptbook/remote-server 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 +9 -4
  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 +4 -3
  23. package/umd/index.umd.js +9 -4
  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
 
@@ -105,13 +105,13 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
105
105
 
106
106
  ## 📖 The Book Whitepaper
107
107
 
108
- 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.
108
+ 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.
109
109
 
110
110
  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.
111
111
 
112
112
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
113
113
 
114
- 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.
114
+ 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.
115
115
 
116
116
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
117
117
 
@@ -212,7 +212,7 @@ Your job is to provide legal advice and support to the company and its employees
212
212
 
213
213
  #### `Use` commitments
214
214
 
215
- 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.
215
+ 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.
216
216
 
217
217
  These are what turn a chatbot into a persistent agent that actually does work.
218
218
 
@@ -261,7 +261,7 @@ Your job is to provide legal advice and support to the company and its employees
261
261
 
262
262
  ### Promptbook Ecosystem
263
263
 
264
- Promptbook is an ecosystem of tools centered around the **Agents Server** a production-ready platform for running persistent AI agents.
264
+ Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
265
265
 
266
266
  #### Agents Server
267
267
 
@@ -283,7 +283,7 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
283
283
 
284
284
  ## 💜 The Promptbook Project
285
285
 
286
- 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:
286
+ 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:
287
287
 
288
288
  <table>
289
289
  <thead>
@@ -296,7 +296,7 @@ Promptbook project is an ecosystem centered around the **Agents Server** — a p
296
296
  <tr>
297
297
  <td><a href="https://gallery.ptbk.io/"><strong>⭐ Agents Server</strong></a></td>
298
298
  <td>
299
- 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>.
299
+ 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>.
300
300
  </td>
301
301
  </tr>
302
302
  <tr>
@@ -386,8 +386,8 @@ For information on reporting security vulnerabilities, see our [Security Policy]
386
386
 
387
387
  The fastest way to get started is with the **Agents Server**:
388
388
 
389
- - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** Self-host the Agents Server with full control over your data
390
- - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** Start creating agents immediately, no setup required
389
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Self-host the Agents Server with full control over your data
390
+ - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** - Start creating agents immediately, no setup required
391
391
 
392
392
  ### NPM Packages _(for developers embedding the Engine)_
393
393
 
@@ -532,7 +532,7 @@ npx ptbk coder verify
532
532
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
533
533
  | `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/`. |
534
534
  | `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. |
535
- | `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. |
535
+ | `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. |
536
536
  | `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. |
537
537
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
538
538
 
@@ -543,7 +543,7 @@ npx ptbk coder verify
543
543
  | `--agent <name>` | Selects the coding backend. |
544
544
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
545
545
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
546
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
546
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
547
547
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
548
548
  | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
549
549
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
@@ -646,8 +646,8 @@ _Note: This section is not a complete dictionary, more list of general AI / LLM
646
646
 
647
647
  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.
648
648
 
649
- - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) start creating agents immediately
650
- - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) full control over your data and infrastructure
649
+ - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) - start creating agents immediately
650
+ - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) - full control over your data and infrastructure
651
651
  - **API** for integrating agents into your own applications
652
652
 
653
653
  ## 🚂 Promptbook Engine
@@ -665,7 +665,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
665
665
  - When you want agents that **collaborate in teams** and consult each other
666
666
  - When you need to **integrate AI agents into your existing applications** via API
667
667
  - When you want to **self-host** your AI agents with full control over data and infrastructure
668
- - When you are writing an app that generates complex things via LLM like **websites, articles, presentations, code, stories, songs**,...
668
+ - When you are writing an app that generates complex things via LLM - like **websites, articles, presentations, code, stories, songs**,...
669
669
  - When you want to **version** your agent definitions and **test multiple versions**
670
670
  - When you want to **log** agent execution and backtrace issues
671
671
 
@@ -677,7 +677,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
677
677
  - When [OpenAI Assistant (GPTs)](https://help.openai.com/en/articles/8673914-gpts-vs-assistants) is enough for you
678
678
  - When you need streaming _(this may be implemented in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/102))_
679
679
  - 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))_
680
- - 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))_
680
+ - 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))_
681
681
  - When you need to use recursion _([see the discussion](https://github.com/webgptorg/promptbook/discussions/38))_
682
682
 
683
683
  [See more](https://github.com/webgptorg/promptbook/discussions/112)
package/esm/index.es.js CHANGED
@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
40
40
  * @generated
41
41
  * @see https://github.com/webgptorg/promptbook
42
42
  */
43
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-46';
43
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-47';
44
44
  /**
45
45
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
46
46
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1007,7 +1007,7 @@ const ADMIN_GITHUB_NAME = 'hejny';
1007
1007
  *
1008
1008
  * @public exported from `@promptbook/core`
1009
1009
  */
1010
- const CLAIM = `Turn your company's scattered knowledge into AI ready books`;
1010
+ const CLAIM = `Create persistent AI agents that turn your company's scattered knowledge into action`;
1011
1011
  // <- TODO: [🐊] Pick the best claim
1012
1012
  /**
1013
1013
  * Color of the Promptbook
@@ -1060,7 +1060,7 @@ Color.fromHex('#1D4ED8');
1060
1060
  *
1061
1061
  * @public exported from `@promptbook/core`
1062
1062
  */
1063
- const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
1063
+ const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
1064
1064
  /**
1065
1065
  * Maximum file size limit
1066
1066
  *
@@ -33749,9 +33749,10 @@ function formatMetaLine(label, value) {
33749
33749
  * Build a minimal agent source snapshot for remote agents.
33750
33750
  */
33751
33751
  function buildRemoteAgentSource(profile, meta) {
33752
+ const isMetaImageExplicit = profile.isMetaImageExplicit !== false;
33752
33753
  const metaLines = [
33753
33754
  formatMetaLine('FULLNAME', meta === null || meta === void 0 ? void 0 : meta.fullname),
33754
- formatMetaLine('IMAGE', meta === null || meta === void 0 ? void 0 : meta.image),
33755
+ formatMetaLine('IMAGE', isMetaImageExplicit ? meta === null || meta === void 0 ? void 0 : meta.image : undefined),
33755
33756
  formatMetaLine('DESCRIPTION', meta === null || meta === void 0 ? void 0 : meta.description),
33756
33757
  formatMetaLine('COLOR', meta === null || meta === void 0 ? void 0 : meta.color),
33757
33758
  formatMetaLine('FONT', meta === null || meta === void 0 ? void 0 : meta.font),
@@ -33850,6 +33851,8 @@ class RemoteAgent extends Agent {
33850
33851
  remoteAgent._isVoiceCallingEnabled = profile.isVoiceCallingEnabled === true; // [✨✷] Store voice calling status
33851
33852
  remoteAgent._isVoiceTtsSttEnabled = profile.isVoiceTtsSttEnabled !== false;
33852
33853
  remoteAgent.knowledgeSources = profile.knowledgeSources || [];
33854
+ remoteAgent.isMetaImageExplicit = profile.isMetaImageExplicit !== false;
33855
+ remoteAgent.avatarVisualId = profile.avatarVisualId;
33853
33856
  return remoteAgent;
33854
33857
  }
33855
33858
  /**
@@ -33865,6 +33868,8 @@ class RemoteAgent extends Agent {
33865
33868
  this.toolTitles = {};
33866
33869
  this._isVoiceCallingEnabled = false; // [✨✷] Track voice calling status
33867
33870
  this._isVoiceTtsSttEnabled = true;
33871
+ this.isMetaImageExplicit = true;
33872
+ this.avatarVisualId = undefined;
33868
33873
  this.knowledgeSources = [];
33869
33874
  this.agentUrl = options.agentUrl;
33870
33875
  }