@promptbook/ollama 0.112.0-65 → 0.112.0-69

package/README.md

@@ -412,7 +412,7 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
 
 #### How the workflow works
 
-1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.tmp`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
+1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.promptbook`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
 2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
 3. You replace placeholder `@@@` sections with real coding tasks.
 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent.
@@ -483,13 +483,13 @@ npx ptbk coder find-refactor-candidates --level xhigh
 npx ptbk coder verify
 ```
 
-`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds the coder temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
+`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds the shared `/.promptbook` temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
 
 #### What each command does
 
 | Command                               | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
-| `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 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/`. |
 | `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, 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. |

package/esm/index.es.js

@@ -3,9 +3,6 @@ import { randomBytes } from 'crypto';
 import Bottleneck from 'bottleneck';
 import colors from 'colors';
 import OpenAI from 'openai';
-import 'path';
-import 'crypto-js';
-import 'crypto-js/enc-hex';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
 /**
@@ -21,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-65';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-69';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1087,6 +1084,35 @@ function saturate(amount) {
 }
 // TODO: Maybe implement by mix+hsl
 
+/**
+ * Stable root directory used for Promptbook-owned temporary files and caches.
+ *
+ * @private internal utility for Promptbook temporary folders
+ */
+const PROMPTBOOK_TEMPORARY_DIRECTORY = '.promptbook';
+/**
+ * Builds one normalized project-relative path inside Promptbook's dedicated temporary root.
+ *
+ * The returned path intentionally uses `/` separators so the same helper can be reused from
+ * Node.js and edge-safe code without depending on the Node `path` module.
+ *
+ * @private internal utility for Promptbook temporary folders
+ */
+function getPromptbookTemporaryPath(...pathSegments) {
+    const normalizedPathSegments = pathSegments.flatMap(splitPathSegments).filter(Boolean);
+    return [PROMPTBOOK_TEMPORARY_DIRECTORY, ...normalizedPathSegments].join('/');
+}
+/**
+ * Normalizes one raw path segment into slash-delimited pieces without empty items.
+ */
+function splitPathSegments(pathSegment) {
+    return pathSegment
+        .split(/[\\/]+/u)
+        .map((segment) => segment.trim())
+        .filter(Boolean);
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
  * Name for the Promptbook
  *
@@ -1188,6 +1214,31 @@ const SMALL_NUMBER = 0.001;
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
 const CONNECTION_RETRIES_LIMIT = 5;
+// <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
+/**
+ * Where to store the temporary downloads
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+`./${getPromptbookTemporaryPath('download-cache')}`;
+/**
+ * Where to store the cache of executions for promptbook CLI
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+`./${getPromptbookTemporaryPath('execution-cache')}`;
+/**
+ * Where to store the scrape cache
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+`./${getPromptbookTemporaryPath('scrape-cache')}`;
 // <- TODO: [🧜‍♂️]
 /**
  * Default settings for parsing and generating CSV files in Promptbook.
@@ -2942,6 +2993,105 @@ function templateParameters(template, parameters) {
     return replacedTemplates;
 }
 
+/**
+ * Marker property stored inside serialized tool-execution envelopes.
+ *
+ * @private internal tool-execution transport
+ */
+const TOOL_EXECUTION_ENVELOPE_MARKER = '__promptbookToolExecutionEnvelope';
+/**
+ * Parses one serialized tool-execution envelope when present.
+ *
+ * @private internal tool-execution transport
+ */
+function parseToolExecutionEnvelope(rawValue) {
+    if (typeof rawValue !== 'string') {
+        return null;
+    }
+    try {
+        const parsedValue = JSON.parse(rawValue);
+        if (!parsedValue ||
+            typeof parsedValue !== 'object' ||
+            parsedValue[TOOL_EXECUTION_ENVELOPE_MARKER] !== true ||
+            typeof parsedValue.assistantMessage !== 'string') {
+            return null;
+        }
+        return {
+            assistantMessage: parsedValue.assistantMessage,
+            toolResult: parsedValue.toolResult,
+        };
+    }
+    catch (_a) {
+        return null;
+    }
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
+/**
+ * Prompt parameter key used to pass hidden runtime context to tool execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
+/**
+ * Hidden argument key used to pass runtime context into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
+/**
+ * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
+/**
+ * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
+/**
+ * Monotonic counter used for hidden progress-listener tokens.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+let toolCallProgressListenerCounter = 0;
+/**
+ * Active tool-progress listeners keyed by hidden execution token.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const toolCallProgressListeners = new Map();
+/**
+ * Registers one in-memory listener that receives progress updates emitted by a running tool.
+ *
+ * The returned token is passed into script execution as a hidden argument so tool implementations
+ * can stream progress without exposing extra parameters to the model.
+ *
+ * @param listener - Listener notified about tool progress.
+ * @returns Hidden token used to route progress updates.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+function registerToolCallProgressListener(listener) {
+    toolCallProgressListenerCounter += 1;
+    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
+    toolCallProgressListeners.set(token, listener);
+    return token;
+}
+/**
+ * Unregisters one in-memory progress listener.
+ *
+ * @param token - Token previously created by `registerToolCallProgressListener`.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+function unregisterToolCallProgressListener(token) {
+    toolCallProgressListeners.delete(token);
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
  * This error indicates problems parsing the format value
  *
@@ -3280,209 +3430,6 @@ function serializeError(error) {
     };
 }
 
-/**
- * Async version of Array.forEach
- *
- * @param array - Array to iterate over
- * @param options - Options for the function
- * @param callbackfunction - Function to call for each item
- * @deprecated [🪂] Use queues instead
- *
- * @public exported from `@promptbook/utils`
- */
-async function forEachAsync(array, options, callbackfunction) {
-    const { maxParallelCount = Infinity } = options;
-    let index = 0;
-    let runningTasks = [];
-    const tasks = [];
-    for (const item of array) {
-        const currentIndex = index++;
-        const task = callbackfunction(item, currentIndex, array);
-        tasks.push(task);
-        runningTasks.push(task);
-        /* not await */ Promise.resolve(task).then(() => {
-            runningTasks = runningTasks.filter((runningTask) => runningTask !== task);
-        });
-        if (maxParallelCount < runningTasks.length) {
-            await Promise.race(runningTasks);
-        }
-    }
-    await Promise.all(tasks);
-}
-
-/**
- * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
- *
- * Note: [🔂] This function is idempotent.
- *
- * @param text The text string to be converted to SCREAMING_CASE format.
- * @returns The normalized text in SCREAMING_CASE format.
- * @example 'HELLO_WORLD'
- * @example 'I_LOVE_PROMPTBOOK'
- *
- * @public exported from `@promptbook/utils`
- */
-function normalizeTo_SCREAMING_CASE(text) {
-    let charType;
-    let lastCharType = 'OTHER';
-    let normalizedName = '';
-    for (const char of text) {
-        let normalizedChar;
-        if (/^[a-z]$/.test(char)) {
-            charType = 'LOWERCASE';
-            normalizedChar = char.toUpperCase();
-        }
-        else if (/^[A-Z]$/.test(char)) {
-            charType = 'UPPERCASE';
-            normalizedChar = char;
-        }
-        else if (/^[0-9]$/.test(char)) {
-            charType = 'NUMBER';
-            normalizedChar = char;
-        }
-        else {
-            charType = 'OTHER';
-            normalizedChar = '_';
-        }
-        if (charType !== lastCharType &&
-            !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
-            !(lastCharType === 'NUMBER') &&
-            !(charType === 'NUMBER')) {
-            normalizedName += '_';
-        }
-        normalizedName += normalizedChar;
-        lastCharType = charType;
-    }
-    normalizedName = normalizedName.replace(/_+/g, '_');
-    normalizedName = normalizedName.replace(/_?\/_?/g, '/');
-    normalizedName = normalizedName.replace(/^_/, '');
-    normalizedName = normalizedName.replace(/_$/, '');
-    return normalizedName;
-}
-/**
- * TODO: Tests
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
- * TODO: [🌺] Use some intermediate util splitWords
- */
-
-/**
- * Normalizes a text string to snake_case format.
- *
- * Note: [🔂] This function is idempotent.
- *
- * @param text The text string to be converted to snake_case format.
- * @returns The normalized text in snake_case format.
- * @example 'hello_world'
- * @example 'i_love_promptbook'
- *
- * @public exported from `@promptbook/utils`
- */
-function normalizeTo_snake_case(text) {
-    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
-}
-
-/**
- * Marker property stored inside serialized tool-execution envelopes.
- *
- * @private internal tool-execution transport
- */
-const TOOL_EXECUTION_ENVELOPE_MARKER = '__promptbookToolExecutionEnvelope';
-/**
- * Parses one serialized tool-execution envelope when present.
- *
- * @private internal tool-execution transport
- */
-function parseToolExecutionEnvelope(rawValue) {
-    if (typeof rawValue !== 'string') {
-        return null;
-    }
-    try {
-        const parsedValue = JSON.parse(rawValue);
-        if (!parsedValue ||
-            typeof parsedValue !== 'object' ||
-            parsedValue[TOOL_EXECUTION_ENVELOPE_MARKER] !== true ||
-            typeof parsedValue.assistantMessage !== 'string') {
-            return null;
-        }
-        return {
-            assistantMessage: parsedValue.assistantMessage,
-            toolResult: parsedValue.toolResult,
-        };
-    }
-    catch (_a) {
-        return null;
-    }
-}
-// Note: [💞] Ignore a discrepancy between file name and entity name
-
-/**
- * Prompt parameter key used to pass hidden runtime context to tool execution.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
-/**
- * Hidden argument key used to pass runtime context into individual tool calls.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
-/**
- * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
-/**
- * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
-/**
- * Monotonic counter used for hidden progress-listener tokens.
- *
- * @private internal runtime wiring for commitment tools
- */
-let toolCallProgressListenerCounter = 0;
-/**
- * Active tool-progress listeners keyed by hidden execution token.
- *
- * @private internal runtime wiring for commitment tools
- */
-const toolCallProgressListeners = new Map();
-/**
- * Registers one in-memory listener that receives progress updates emitted by a running tool.
- *
- * The returned token is passed into script execution as a hidden argument so tool implementations
- * can stream progress without exposing extra parameters to the model.
- *
- * @param listener - Listener notified about tool progress.
- * @returns Hidden token used to route progress updates.
- *
- * @private internal runtime wiring for commitment tools
- */
-function registerToolCallProgressListener(listener) {
-    toolCallProgressListenerCounter += 1;
-    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
-    toolCallProgressListeners.set(token, listener);
-    return token;
-}
-/**
- * Unregisters one in-memory progress listener.
- *
- * @param token - Token previously created by `registerToolCallProgressListener`.
- *
- * @private internal runtime wiring for commitment tools
- */
-function unregisterToolCallProgressListener(token) {
-    toolCallProgressListeners.delete(token);
-}
-// Note: [💞] Ignore a discrepancy between file name and entity name
-
 /**
  * Function `addUsage` will add multiple usages into one
  *
@@ -3537,6 +3484,36 @@ function addUsage(...usageItems) {
     }, deepClone(ZERO_USAGE));
 }
 
+/**
+ * Async version of Array.forEach
+ *
+ * @param array - Array to iterate over
+ * @param options - Options for the function
+ * @param callbackfunction - Function to call for each item
+ * @deprecated [🪂] Use queues instead
+ *
+ * @public exported from `@promptbook/utils`
+ */
+async function forEachAsync(array, options, callbackfunction) {
+    const { maxParallelCount = Infinity } = options;
+    let index = 0;
+    let runningTasks = [];
+    const tasks = [];
+    for (const item of array) {
+        const currentIndex = index++;
+        const task = callbackfunction(item, currentIndex, array);
+        tasks.push(task);
+        runningTasks.push(task);
+        /* not await */ Promise.resolve(task).then(() => {
+            runningTasks = runningTasks.filter((runningTask) => runningTask !== task);
+        });
+        if (maxParallelCount < runningTasks.length) {
+            await Promise.race(runningTasks);
+        }
+    }
+    await Promise.all(tasks);
+}
+
 /**
  * Builds a tool invocation script that injects hidden runtime context into tool args.
  *
@@ -5138,6 +5115,80 @@ function $getGlobalScope() {
     return Function('return this')();
 }
 
+/**
+ * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param text The text string to be converted to SCREAMING_CASE format.
+ * @returns The normalized text in SCREAMING_CASE format.
+ * @example 'HELLO_WORLD'
+ * @example 'I_LOVE_PROMPTBOOK'
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_SCREAMING_CASE(text) {
+    let charType;
+    let lastCharType = 'OTHER';
+    let normalizedName = '';
+    for (const char of text) {
+        let normalizedChar;
+        if (/^[a-z]$/.test(char)) {
+            charType = 'LOWERCASE';
+            normalizedChar = char.toUpperCase();
+        }
+        else if (/^[A-Z]$/.test(char)) {
+            charType = 'UPPERCASE';
+            normalizedChar = char;
+        }
+        else if (/^[0-9]$/.test(char)) {
+            charType = 'NUMBER';
+            normalizedChar = char;
+        }
+        else {
+            charType = 'OTHER';
+            normalizedChar = '_';
+        }
+        if (charType !== lastCharType &&
+            !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+            !(lastCharType === 'NUMBER') &&
+            !(charType === 'NUMBER')) {
+            normalizedName += '_';
+        }
+        normalizedName += normalizedChar;
+        lastCharType = charType;
+    }
+    normalizedName = normalizedName.replace(/_+/g, '_');
+    normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+    normalizedName = normalizedName.replace(/^_/, '');
+    normalizedName = normalizedName.replace(/_$/, '');
+    return normalizedName;
+}
+/**
+ * TODO: Tests
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+ * TODO: [🌺] Use some intermediate util splitWords
+ */
+
+/**
+ * Normalizes a text string to snake_case format.
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param text The text string to be converted to snake_case format.
+ * @returns The normalized text in snake_case format.
+ * @example 'hello_world'
+ * @example 'i_love_promptbook'
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_snake_case(text) {
+    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+}
+
 /**
  * Global registry for storing and managing registered entities of a given type.
  *