@promptbook/openai 0.112.0-123 → 0.112.0-125

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.
package/README.md CHANGED
@@ -736,7 +736,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
736
736
  #### Features
737
737
 
738
738
  - **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
739
- - **Context injection:** `--context AGENTS.md` or inline extra instructions
739
+ - **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
740
740
  - **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
741
741
  - **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
742
742
  - **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
@@ -756,11 +756,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
756
756
 
757
757
  npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
758
758
 
759
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
759
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md
760
760
 
761
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
761
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
762
762
 
763
- npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
763
+ npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --ignore-git-changes --no-wait
764
764
 
765
765
  npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
766
766
 
@@ -782,11 +782,11 @@ ptbk coder generate-boilerplates
782
782
 
783
783
  ptbk coder generate-boilerplates --template prompts/templates/common.md
784
784
 
785
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
785
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test
786
786
 
787
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
787
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
788
788
 
789
- ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
789
+ ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
790
790
 
791
791
  ptbk coder find-refactor-candidates
792
792
 
@@ -799,13 +799,13 @@ ptbk coder verify
799
799
 
800
800
  #### What each command does
801
801
 
802
- | Command | What it does |
803
- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
802
+ | Command | What it does |
803
+ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
804
804
  | `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 `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
805
- | `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. |
806
- | `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. |
807
- | `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. |
808
- | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
805
+ | `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. |
806
+ | `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. |
807
+ | `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. |
808
+ | `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
809
809
 
810
810
  #### Most useful `ptbk coder run` flags
811
811
 
@@ -828,7 +828,7 @@ ptbk coder verify
828
828
 
829
829
  1. Initialize once with `ptbk coder init`.
830
830
  2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
831
- 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--context AGENTS.md`.
831
+ 3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--agent agents/coding/developer.book --context AGENTS.md`.
832
832
  4. Run one prompt at a time interactively, or use `--no-wait` for unattended batches.
833
833
  5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
834
834
 
package/esm/index.es.js CHANGED
@@ -20,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
20
20
  * @generated
21
21
  * @see https://github.com/webgptorg/promptbook
22
22
  */
23
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-123';
23
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-125';
24
24
  /**
25
25
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
26
26
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -0,0 +1,25 @@
1
+ import type { InitializationStatus } from './boilerplateTemplates';
2
+ /**
3
+ * Relative directory path for agents initialized by `ptbk coder init`.
4
+ *
5
+ * @private internal utility of `coder init` command
6
+ */
7
+ export declare const CODER_AGENTS_DIRECTORY_PATH = "agents";
8
+ /**
9
+ * Relative file path to the default developer agent initialized by `ptbk coder init`.
10
+ *
11
+ * @private internal utility of `coder init` command
12
+ */
13
+ export declare const CODER_DEVELOPER_AGENT_FILE_PATH = "agents/developer.book";
14
+ /**
15
+ * Source file path of the bundled developer agent inside the Promptbook repository.
16
+ *
17
+ * @private internal utility of `coder init` command
18
+ */
19
+ export declare const DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH = "agents/default/developer.book";
20
+ /**
21
+ * Ensures the default developer agent exists in the initialized project.
22
+ *
23
+ * @private function of `initializeCoderProjectConfiguration`
24
+ */
25
+ export declare function ensureCoderDeveloperAgentFile(projectPath: string): Promise<InitializationStatus>;
@@ -9,6 +9,8 @@ export type CoderInitializationSummary = {
9
9
  readonly promptsDoneDirectoryStatus: InitializationStatus;
10
10
  readonly promptsTemplatesDirectoryStatus: InitializationStatus;
11
11
  readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
12
+ readonly agentsDirectoryStatus: InitializationStatus;
13
+ readonly developerAgentFileStatus: InitializationStatus;
12
14
  readonly agentsFileStatus: InitializationStatus;
13
15
  readonly agentCodingFileStatus: InitializationStatus;
14
16
  readonly envFileStatus: InitializationStatus;
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.112.0-122`).
18
+ * It follows semantic versioning (e.g., `0.112.0-123`).
19
19
  *
20
20
  * @generated
21
21
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/openai",
3
- "version": "0.112.0-123",
3
+ "version": "0.112.0-125",
4
4
  "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -106,7 +106,7 @@
106
106
  "types": "./esm/src/_packages/openai.index.d.ts",
107
107
  "typings": "./esm/src/_packages/openai.index.d.ts",
108
108
  "peerDependencies": {
109
- "@promptbook/core": "0.112.0-123"
109
+ "@promptbook/core": "0.112.0-125"
110
110
  },
111
111
  "dependencies": {
112
112
  "@openai/agents": "0.4.15",
package/umd/index.umd.js CHANGED
@@ -25,7 +25,7 @@
25
25
  * @generated
26
26
  * @see https://github.com/webgptorg/promptbook
27
27
  */
28
- const PROMPTBOOK_ENGINE_VERSION = '0.112.0-123';
28
+ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-125';
29
29
  /**
30
30
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
31
31
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -0,0 +1,25 @@
1
+ import type { InitializationStatus } from './boilerplateTemplates';
2
+ /**
3
+ * Relative directory path for agents initialized by `ptbk coder init`.
4
+ *
5
+ * @private internal utility of `coder init` command
6
+ */
7
+ export declare const CODER_AGENTS_DIRECTORY_PATH = "agents";
8
+ /**
9
+ * Relative file path to the default developer agent initialized by `ptbk coder init`.
10
+ *
11
+ * @private internal utility of `coder init` command
12
+ */
13
+ export declare const CODER_DEVELOPER_AGENT_FILE_PATH = "agents/developer.book";
14
+ /**
15
+ * Source file path of the bundled developer agent inside the Promptbook repository.
16
+ *
17
+ * @private internal utility of `coder init` command
18
+ */
19
+ export declare const DEFAULT_CODER_DEVELOPER_AGENT_SOURCE_FILE_PATH = "agents/default/developer.book";
20
+ /**
21
+ * Ensures the default developer agent exists in the initialized project.
22
+ *
23
+ * @private function of `initializeCoderProjectConfiguration`
24
+ */
25
+ export declare function ensureCoderDeveloperAgentFile(projectPath: string): Promise<InitializationStatus>;
@@ -9,6 +9,8 @@ export type CoderInitializationSummary = {
9
9
  readonly promptsDoneDirectoryStatus: InitializationStatus;
10
10
  readonly promptsTemplatesDirectoryStatus: InitializationStatus;
11
11
  readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
12
+ readonly agentsDirectoryStatus: InitializationStatus;
13
+ readonly developerAgentFileStatus: InitializationStatus;
12
14
  readonly agentsFileStatus: InitializationStatus;
13
15
  readonly agentCodingFileStatus: InitializationStatus;
14
16
  readonly envFileStatus: InitializationStatus;
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.112.0-122`).
18
+ * It follows semantic versioning (e.g., `0.112.0-123`).
19
19
  *
20
20
  * @generated
21
21
  */