ptbk 0.112.0-45 → 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 (3) hide show
  1. package/README.md +16 -16
  2. package/bin/promptbook-cli-proxy.js +11 -4
  3. package/package.json +4 -4
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
 
@@ -36,13 +36,13 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
36
36
 
37
37
  ## 📖 The Book Whitepaper
38
38
 
39
- 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.
39
+ 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.
40
40
 
41
41
  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.
42
42
 
43
43
  The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
44
44
 
45
- 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.
45
+ 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.
46
46
 
47
47
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
48
48
 
@@ -143,7 +143,7 @@ Your job is to provide legal advice and support to the company and its employees
143
143
 
144
144
  #### `Use` commitments
145
145
 
146
- 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.
146
+ 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.
147
147
 
148
148
  These are what turn a chatbot into a persistent agent that actually does work.
149
149
 
@@ -192,7 +192,7 @@ Your job is to provide legal advice and support to the company and its employees
192
192
 
193
193
  ### Promptbook Ecosystem
194
194
 
195
- Promptbook is an ecosystem of tools centered around the **Agents Server** — a production-ready platform for running persistent AI agents.
195
+ Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
196
196
 
197
197
  #### Agents Server
198
198
 
@@ -214,7 +214,7 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
214
214
 
215
215
  ## 💜 The Promptbook Project
216
216
 
217
- 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:
217
+ 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:
218
218
 
219
219
  <table>
220
220
  <thead>
@@ -227,7 +227,7 @@ Promptbook project is an ecosystem centered around the **Agents Server** — a p
227
227
  <tr>
228
228
  <td><a href="https://gallery.ptbk.io/"><strong>⭐ Agents Server</strong></a></td>
229
229
  <td>
230
- 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>.
230
+ 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>.
231
231
  </td>
232
232
  </tr>
233
233
  <tr>
@@ -317,8 +317,8 @@ For information on reporting security vulnerabilities, see our [Security Policy]
317
317
 
318
318
  The fastest way to get started is with the **Agents Server**:
319
319
 
320
- - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** — Self-host the Agents Server with full control over your data
321
- - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** — Start creating agents immediately, no setup required
320
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Self-host the Agents Server with full control over your data
321
+ - ☁️ **[Hosted Agents Server](https://gallery.ptbk.io/)** - Start creating agents immediately, no setup required
322
322
 
323
323
  ### NPM Packages _(for developers embedding the Engine)_
324
324
 
@@ -463,7 +463,7 @@ npx ptbk coder verify
463
463
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
464
464
  | `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/`. |
465
465
  | `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. |
466
- | `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. |
466
+ | `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. |
467
467
  | `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. |
468
468
  | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
469
469
 
@@ -474,7 +474,7 @@ npx ptbk coder verify
474
474
  | `--agent <name>` | Selects the coding backend. |
475
475
  | `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
476
476
  | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
477
- | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
477
+ | `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
478
478
  | `--thinking-level <level>` | Sets reasoning effort for supported runners. |
479
479
  | `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
480
480
  | `--ignore-git-changes` | Disables the clean-working-tree guard. |
@@ -577,8 +577,8 @@ _Note: This section is not a complete dictionary, more list of general AI / LLM
577
577
 
578
578
  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.
579
579
 
580
- - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) — start creating agents immediately
581
- - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) — full control over your data and infrastructure
580
+ - **Hosted** at [gallery.ptbk.io](https://gallery.ptbk.io/) - start creating agents immediately
581
+ - **Self-hosted** via [Docker](https://hub.docker.com/r/hejny/promptbook/) - full control over your data and infrastructure
582
582
  - **API** for integrating agents into your own applications
583
583
 
584
584
  ## 🚂 Promptbook Engine
@@ -596,7 +596,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
596
596
  - When you want agents that **collaborate in teams** and consult each other
597
597
  - When you need to **integrate AI agents into your existing applications** via API
598
598
  - When you want to **self-host** your AI agents with full control over data and infrastructure
599
- - When you are writing an app that generates complex things via LLM — like **websites, articles, presentations, code, stories, songs**,...
599
+ - When you are writing an app that generates complex things via LLM - like **websites, articles, presentations, code, stories, songs**,...
600
600
  - When you want to **version** your agent definitions and **test multiple versions**
601
601
  - When you want to **log** agent execution and backtrace issues
602
602
 
@@ -608,7 +608,7 @@ The Engine is the open-source core that powers the Agents Server. If you need to
608
608
  - When [OpenAI Assistant (GPTs)](https://help.openai.com/en/articles/8673914-gpts-vs-assistants) is enough for you
609
609
  - When you need streaming _(this may be implemented in the future, [see discussion](https://github.com/webgptorg/promptbook/discussions/102))_
610
610
  - 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))_
611
- - 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))_
611
+ - 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))_
612
612
  - When you need to use recursion _([see the discussion](https://github.com/webgptorg/promptbook/discussions/38))_
613
613
 
614
614
  [See more](https://github.com/webgptorg/promptbook/discussions/112)
package/bin/promptbook-cli-proxy.js CHANGED
@@ -2,9 +2,16 @@
2
2
  // <- TODO: [🎺] Ensure correct version of Node.js is used
3
3
  // promptbook-cli-proxy.js
4
4
 
5
- console.log('Please install `ptbk` package first');
6
-
7
5
  /**
8
- * If kept:
9
- * TODO: [👩‍👩‍👧‍👦] During the build check that this file exists
6
+ * Note: [🔺] Purpose of this file is to forward `ptbk` package launches to `@promptbook/cli`
10
7
  */
8
+
9
+ const { dirname } = require('path');
10
+
11
+ // Resolve through `promptbook` so the proxy works for both hoisted and nested installs.
12
+ const promptbookPackageRoot = dirname(require.resolve('promptbook/package.json'));
13
+ const promptbookCliEntrypoint = require.resolve('@promptbook/cli/bin/promptbook-cli.js', {
14
+ paths: [promptbookPackageRoot, __dirname],
15
+ });
16
+
17
+ require(promptbookCliEntrypoint);
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "ptbk",
3
- "version": "0.112.0-45",
4
- "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
3
+ "version": "0.112.0-47",
4
+ "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
5
5
  "private": false,
6
6
  "sideEffects": false,
7
7
  "repository": {
@@ -91,10 +91,10 @@
91
91
  "zod": "$zod"
92
92
  },
93
93
  "peerDependencies": {
94
- "@promptbook/core": "0.112.0-45"
94
+ "@promptbook/core": "0.112.0-47"
95
95
  },
96
96
  "dependencies": {
97
- "promptbook": "0.112.0-45"
97
+ "promptbook": "0.112.0-47"
98
98
  },
99
99
  "bin": {
100
100
  "ptbk": "bin/promptbook-cli-proxy.js"