@promptbook/documents 0.112.0-41 → 0.112.0-43

package/README.md

@@ -427,6 +427,7 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
 -   **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
 -   **Interactive or unattended runs:** default wait mode, or `--no-wait` for batch execution
 -   **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
+-   **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
 -   **Prompt triage:** `--priority` to process only more important tasks first
 -   **Failure logging:** failed runs write a neighboring `.error.log`
 -   **Line-ending normalization:** changed files are normalized back to LF by default
@@ -444,6 +445,8 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
 
 npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
 
+npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
+
 npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
 
 npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
@@ -466,9 +469,11 @@ npx ptbk coder generate-boilerplates
 
 npx ptbk coder generate-boilerplates --template prompts/templates/common.md
 
-npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
+
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
 
-npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
+npx ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
 
 npx ptbk coder find-refactor-candidates
 
@@ -485,7 +490,7 @@ npx ptbk coder verify
 | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
 | `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/`. |
 | `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.                                                                                                                                                                                                                                                                  |
-| `ptbk coder run`                      | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, marks success or failure, then commits and pushes the result.                                                                                                                                                                                                                                                                                                      |
+| `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.                                                                                                                                                             |
 | `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. |
 | `ptbk coder verify`                   | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.                                                                                                                                                                                                                                                                                                                                             |
 
@@ -496,12 +501,14 @@ npx ptbk coder verify
 | `--agent <name>`           | Selects the coding backend.                                                                        |
 | `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
 | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
+| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.    |
 | `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                       |
 | `--no-wait`                | Skips interactive pauses between prompts for unattended execution.                                 |
 | `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                             |
 | `--priority <n>`           | Runs only prompts at or above the given priority.                                                  |
 | `--dry-run`                | Prints which prompts are ready instead of executing them.                                          |
 | `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                     |
+| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                               |
 | `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
 
 #### Typical usage pattern

package/esm/index.es.js

@@ -26,7 +26,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-41';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -745,7 +745,7 @@ export type ChatProps = {
      * - `BUBBLE_MODE`: keeps the default bubble appearance for all messages.
      * - `ARTICLE_MODE`: keeps user bubbles while rendering assistant replies as borderless article blocks.
      *
-     * @default 'BUBBLE_MODE'
+     * @default 'ARTICLE_MODE'
      */
     readonly CHAT_VISUAL_MODE?: ChatVisualMode;
     /**

package/esm/src/cli/cli-commands/coder/getTypescriptModule.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Possible runtime shapes returned when importing the `typescript` package.
+ */
+type ImportedTypescriptModule = typeof import('typescript') | {
+    default: typeof import('typescript');
+};
+/**
+ * Loads the TypeScript runtime used for parsing JSONC-style project files.
+ *
+ * @private internal utility of `coder init`
+ */
+export declare function getTypescriptModule(): Promise<typeof import('typescript')>;
+/**
+ * Normalizes CommonJS-via-`default` and direct namespace imports of TypeScript.
+ *
+ * @private internal utility of `getTypescriptModule`
+ */
+export declare function normalizeImportedTypescriptModule(importedTypescriptModule: ImportedTypescriptModule): typeof import('typescript');
+export {};

package/esm/src/cli/cli-commands/coder/getTypescriptModule.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/cli/cli-commands/coder/mergeStringRecordJsonFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/cli/cli-commands/coder/verify.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -4,23 +4,11 @@ import type { string_book } from '../../../../book-2.0/agent-source/string_book'
 import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
 import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+import { type CreateAgentPersistenceRecordsOptions } from './createAgentPersistenceRecords';
 /**
  * Options for creating a new agent entry.
  */
-type CreateAgentOptions = {
-    /**
-     * Visibility for the new agent.
-     */
-    readonly visibility?: 'PRIVATE' | 'UNLISTED' | 'PUBLIC';
-    /**
-     * Folder identifier to assign the new agent to.
-     */
-    readonly folderId?: number | null;
-    /**
-     * Sort order for the agent within its parent folder.
-     */
-    readonly sortOrder?: number;
-};
+type CreateAgentOptions = CreateAgentPersistenceRecordsOptions;
 /**
  * Optional controls for persisting one source update.
  */

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.d.ts

@@ -0,0 +1,40 @@
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CreateAgentInput } from '../../CreateAgentInput';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Optional persistence overrides for one new agent row.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsOptions = Omit<CreateAgentInput, 'source'>;
+/**
+ * Prepared insert rows and returned profile for one newly persisted agent.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsResult = {
+    /**
+     * Parsed created agent profile including the resolved permanent id.
+     */
+    readonly createdAgent: AgentBasicInformation & Required<Pick<AgentBasicInformation, 'permanentId'>>;
+    /**
+     * Insert row for the `Agent` table.
+     */
+    readonly agentInsertRecord: AgentsDatabaseSchema['public']['Tables']['Agent']['Insert'];
+    /**
+     * Insert row for the `AgentHistory` table.
+     */
+    readonly agentHistoryInsertRecord: AgentsDatabaseSchema['public']['Tables']['AgentHistory']['Insert'];
+};
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function createAgentPersistenceRecords(agentSource: string_book, options?: CreateAgentPersistenceRecordsOptions, createdAt?: string): CreateAgentPersistenceRecordsResult;

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/llm-providers/agent/Agent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -44,6 +44,10 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * Cached parsed agent information
      */
     private _cachedAgentInfo;
+    /**
+     * Optional server-precomputed model requirements reused until the source changes.
+     */
+    private precomputedModelRequirements;
     /**
      * Creates new AgentLlmExecutionTools
      *

package/esm/src/llm-providers/agent/AgentOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { Updatable } from '../../types/Updatable';
@@ -27,6 +28,13 @@ export type AgentOptions = CommonToolsOptions & {
      * The source of the agent
      */
     agentSource: Updatable<string_book>;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This keeps the actual runtime prompt aligned with server-prepared requirements
+     * such as compact-reference-resolved `TEAM` tools.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
     /**
      * Teacher agent for self-learning
      *

package/esm/src/llm-providers/agent/CreateAgentLlmExecutionToolsOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { OpenAiAgentKitExecutionTools } from '../openai/OpenAiAgentKitExecutionTools';
@@ -25,4 +26,12 @@ export type CreateAgentLlmExecutionToolsOptions = CommonToolsOptions & {
      * The agent source string that defines the agent's behavior
      */
     agentSource: string_book;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This is useful for runtimes such as Agents Server that already resolved compact
+     * references (for example in `TEAM`) and need the executed prompt to stay aligned
+     * with the server-prepared tool list.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
 };

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-40`).
+ * It follows semantic versioning (e.g., `0.112.0-42`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/documents",
-    "version": "0.112.0-41",
+    "version": "0.112.0-43",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -98,7 +98,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/documents.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-41"
+        "@promptbook/core": "0.112.0-43"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -24,7 +24,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-41';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -745,7 +745,7 @@ export type ChatProps = {
      * - `BUBBLE_MODE`: keeps the default bubble appearance for all messages.
      * - `ARTICLE_MODE`: keeps user bubbles while rendering assistant replies as borderless article blocks.
      *
-     * @default 'BUBBLE_MODE'
+     * @default 'ARTICLE_MODE'
      */
     readonly CHAT_VISUAL_MODE?: ChatVisualMode;
     /**

package/umd/src/cli/cli-commands/coder/getTypescriptModule.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Possible runtime shapes returned when importing the `typescript` package.
+ */
+type ImportedTypescriptModule = typeof import('typescript') | {
+    default: typeof import('typescript');
+};
+/**
+ * Loads the TypeScript runtime used for parsing JSONC-style project files.
+ *
+ * @private internal utility of `coder init`
+ */
+export declare function getTypescriptModule(): Promise<typeof import('typescript')>;
+/**
+ * Normalizes CommonJS-via-`default` and direct namespace imports of TypeScript.
+ *
+ * @private internal utility of `getTypescriptModule`
+ */
+export declare function normalizeImportedTypescriptModule(importedTypescriptModule: ImportedTypescriptModule): typeof import('typescript');
+export {};

package/umd/src/cli/cli-commands/coder/getTypescriptModule.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/coder/mergeStringRecordJsonFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/coder/verify.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -4,23 +4,11 @@ import type { string_book } from '../../../../book-2.0/agent-source/string_book'
 import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
 import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+import { type CreateAgentPersistenceRecordsOptions } from './createAgentPersistenceRecords';
 /**
  * Options for creating a new agent entry.
  */
-type CreateAgentOptions = {
-    /**
-     * Visibility for the new agent.
-     */
-    readonly visibility?: 'PRIVATE' | 'UNLISTED' | 'PUBLIC';
-    /**
-     * Folder identifier to assign the new agent to.
-     */
-    readonly folderId?: number | null;
-    /**
-     * Sort order for the agent within its parent folder.
-     */
-    readonly sortOrder?: number;
-};
+type CreateAgentOptions = CreateAgentPersistenceRecordsOptions;
 /**
  * Optional controls for persisting one source update.
  */

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.d.ts

@@ -0,0 +1,40 @@
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CreateAgentInput } from '../../CreateAgentInput';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Optional persistence overrides for one new agent row.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsOptions = Omit<CreateAgentInput, 'source'>;
+/**
+ * Prepared insert rows and returned profile for one newly persisted agent.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsResult = {
+    /**
+     * Parsed created agent profile including the resolved permanent id.
+     */
+    readonly createdAgent: AgentBasicInformation & Required<Pick<AgentBasicInformation, 'permanentId'>>;
+    /**
+     * Insert row for the `Agent` table.
+     */
+    readonly agentInsertRecord: AgentsDatabaseSchema['public']['Tables']['Agent']['Insert'];
+    /**
+     * Insert row for the `AgentHistory` table.
+     */
+    readonly agentHistoryInsertRecord: AgentsDatabaseSchema['public']['Tables']['AgentHistory']['Insert'];
+};
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function createAgentPersistenceRecords(agentSource: string_book, options?: CreateAgentPersistenceRecordsOptions, createdAt?: string): CreateAgentPersistenceRecordsResult;

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/llm-providers/agent/Agent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -44,6 +44,10 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * Cached parsed agent information
      */
     private _cachedAgentInfo;
+    /**
+     * Optional server-precomputed model requirements reused until the source changes.
+     */
+    private precomputedModelRequirements;
     /**
      * Creates new AgentLlmExecutionTools
      *

package/umd/src/llm-providers/agent/AgentOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { Updatable } from '../../types/Updatable';
@@ -27,6 +28,13 @@ export type AgentOptions = CommonToolsOptions & {
      * The source of the agent
      */
     agentSource: Updatable<string_book>;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This keeps the actual runtime prompt aligned with server-prepared requirements
+     * such as compact-reference-resolved `TEAM` tools.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
     /**
      * Teacher agent for self-learning
      *

package/umd/src/llm-providers/agent/CreateAgentLlmExecutionToolsOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { OpenAiAgentKitExecutionTools } from '../openai/OpenAiAgentKitExecutionTools';
@@ -25,4 +26,12 @@ export type CreateAgentLlmExecutionToolsOptions = CommonToolsOptions & {
      * The agent source string that defines the agent's behavior
      */
     agentSource: string_book;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This is useful for runtimes such as Agents Server that already resolved compact
+     * references (for example in `TEAM`) and need the executed prompt to stay aligned
+     * with the server-prepared tool list.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
 };

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-40`).
+ * It follows semantic versioning (e.g., `0.112.0-42`).
  *
  * @generated
  */