@promptbook/node 0.114.0-4 → 0.114.0-6

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.114.0-4",
+    "version": "0.114.0-6",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -97,7 +97,7 @@
     "types": "./esm/src/_packages/node.index.d.ts",
     "typings": "./esm/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.114.0-4"
+        "@promptbook/core": "0.114.0-6"
     },
     "dependencies": {
         "@openai/agents": "0.4.15",

package/umd/index.umd.js

@@ -47,7 +47,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-4';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-6';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5148,6 +5148,65 @@
     `);
     }
 
+    // Note: [💞] This file defines the shared TEAM workspace convention rather than one standalone entity.
+    /**
+     * Relative directory for an active TEAM conversation workspace.
+     *
+     * @private internal convention shared by the Agents Server and agent-folder runner
+     */
+    path.join(AGENT_MESSAGES_DIRECTORY_PATH, 'team');
+    /**
+     * Relative directory where completed TEAM conversation transcripts are retained.
+     *
+     * @private internal convention shared by the Agents Server and agent-folder runner
+     */
+    path.join(AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, 'team');
+    /**
+     * Name of the read-only teammate-source directory inside one TEAM workspace.
+     *
+     * @private internal convention shared by the Agents Server and agent-folder runner
+     */
+    const AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME = 'teammates';
+
+    /**
+     * Builds the optional single-run TEAM consultation instructions for a coding harness.
+     */
+    function buildAgentTeamPromptSection(workspace) {
+        if (!workspace || workspace.manifest.teammates.length === 0) {
+            return '';
+        }
+        const teammateSections = workspace.manifest.teammates.map((teammate) => {
+            const sourcePath = toPromptPath(path.join(workspace.relativeWorkspacePath, AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME, teammate.sourceFileName));
+            const transcriptPath = toPromptPath(path.join(workspace.relativeWorkspacePath, `${teammate.permanentId}--01.book`));
+            const instructions = teammate.instructions.trim() || 'No additional TEAM instructions were provided.';
+            return _spaceTrim.spaceTrim(`
+            -   ${teammate.agentName}
+                -   TEAM instructions: ${instructions}
+                -   Read-only source: \`${sourcePath}\`
+                -   First transcript file: \`${transcriptPath}\`
+        `);
+        });
+        return _spaceTrim.spaceTrim((block) => `
+            ## Team consultations
+
+            The following teammates are available for this user turn:
+
+            ${block(teammateSections.join('\n'))}
+
+            -   The underlying coding harness is already executing this turn **exactly once**. Never start, queue, or invoke another coding harness, agent runner, or \`ptbk\` command to consult a teammate.
+            -   The primary agent remains responsible for the final user-facing \`MESSAGE @Agent\` answer.
+            -   Teammate source files are read-only context. When a teammate consultation occurs, record the actual exchange in a new top-level \`.book\` file in \`${toPromptPath(workspace.relativeWorkspacePath)}\`.
+            -   Name each transcript \`<teammate permanent id>--<sequence>.book\`, for example \`${workspace.manifest.teammates[0].permanentId}--01.book\`.
+            -   Every transcript must contain alternating \`MESSAGE @${workspace.manifest.primaryAgent.agentName}\` and \`MESSAGE @<teammate name>\` blocks. Do not create a transcript for a teammate that was not consulted.
+        `);
+    }
+    /**
+     * Converts a filesystem-relative path into the portable path notation used in prompts.
+     */
+    function toPromptPath(path) {
+        return path.replace(/\\/gu, '/');
+    }
+
     /**
      * Builds the prompt sent to the selected coding runner for one queued user-thread book.
      */
@@ -5157,7 +5216,7 @@
 
                 -   Read \`${messageRelativePath}\` and answer the most recent \`MESSAGE @User\`
                 -   Only change the queued message file by appending one new \`MESSAGE @Agent\` block
-                -   Do not modify any other file in the repository, except files inside your own \`${AGENT_PROJECTS_DIRECTORY_PATH}/\` directory
+                ${block(buildAllowedFileChangesPromptLine(options.teamWorkspace))}
 
                 ## Rules for the answering
 
@@ -5195,11 +5254,22 @@
 
                 ${block(buildAgentProjectsPromptSection(options))}
 
+                ${block(buildAgentTeamPromptSection(options.teamWorkspace))}
+
                 ## This is how you should behave
 
                 ${block(agentSystemMessage)}
             `);
     }
+    /**
+     * Explains the exact files that one coding harness may change for a user turn.
+     */
+    function buildAllowedFileChangesPromptLine(teamWorkspace) {
+        if (!teamWorkspace) {
+            return `-   Do not modify any other file in the repository, except files inside your own \`${AGENT_PROJECTS_DIRECTORY_PATH}/\` directory`;
+        }
+        return `-   Do not modify any other file in the repository, except files inside your own \`${AGENT_PROJECTS_DIRECTORY_PATH}/\` directory and new consultation transcripts inside \`${teamWorkspace.relativeWorkspacePath.replace(/\\/gu, '/')}\``;
+    }
 
     /**
      * Temporary subdirectory used for agent-message runner shell scripts.
@@ -13915,6 +13985,13 @@
     }
 
     /* eslint-disable no-magic-numbers */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
+    /**
+     * Default square size used by avatar renderers.
+     *
+     * @private utility of the avatar rendering system
+     */
+    const DEFAULT_AVATAR_SIZE = 192;
     /**
      * Corner radius ratio used for the common rounded card frame.
      *
@@ -14285,6 +14362,15 @@
      * @private helper of `asciiOctopusAvatarVisual`
      */
     const ATMOSPHERE_GLYPHS = ['.', ':', "'", '`'];
+    /**
+     * Coordinate space the octopus layout is generated in when it is painted into a terminal.
+     *
+     * The terminal renderer has its own character grid, so the geometry only needs one stable
+     * square coordinate space which the grid is then sampled from.
+     *
+     * @private helper of `asciiOctopusAvatarVisual`
+     */
+    const TERMINAL_ASCII_OCTOPUS_LAYOUT_SIZE = DEFAULT_AVATAR_SIZE;
     /**
      * AsciiOctopus avatar visual.
      *
@@ -14301,41 +14387,115 @@
             const staticRandom = createRandom('ascii-octopus-static');
             const gridMetrics = createAsciiGridMetrics(size, gridRandom);
             const layout = createAsciiOctopusLayout(size, timeMs, createRandom, staticRandom, interaction);
+            const glyphGrid = createAsciiOctopusGlyphGrid({
+                sampleGrid: gridMetrics,
+                layout,
+                palette,
+                cellRandom: createRandom('ascii-octopus-cells'),
+                timeMs,
+            });
             drawAvatarFrame(context, size, palette);
             drawAsciiBackdrop(context, size, palette, layout, timeMs);
             context.save();
             context.font = `600 ${gridMetrics.fontSize}px monospace`;
             context.textAlign = 'center';
             context.textBaseline = 'middle';
-            // The ASCII renderer samples the morphing octopus field on a low-resolution grid so the shape stays organic
-            // while the glyph layout remains deterministic for the same avatar input.
-            const cellRandom = createRandom('ascii-octopus-cells');
             for (let rowIndex = 0; rowIndex < gridMetrics.rowCount; rowIndex++) {
                 for (let columnIndex = 0; columnIndex < gridMetrics.columnCount; columnIndex++) {
-                    const point = {
-                        x: gridMetrics.offsetX + columnIndex * gridMetrics.cellWidth,
-                        y: gridMetrics.offsetY + rowIndex * gridMetrics.cellHeight,
-                    };
-                    const noise = cellRandom();
-                    const glyphDescriptor = resolveAsciiGlyph({
-                        point,
-                        layout,
-                        palette,
-                        cellWidth: gridMetrics.cellWidth,
-                        cellHeight: gridMetrics.cellHeight,
-                        noise,
-                        timeMs,
-                    });
+                    const glyphDescriptor = glyphGrid[rowIndex][columnIndex];
                     if (!glyphDescriptor) {
                         continue;
                     }
+                    const point = resolveAsciiSampleGridPoint(gridMetrics, columnIndex, rowIndex);
                     context.fillStyle = glyphDescriptor.color;
                     context.fillText(glyphDescriptor.character, point.x, point.y);
                 }
             }
             context.restore();
         },
+        renderTerminalText({ columns, rows, palette, createRandom, timeMs, interaction }) {
+            const staticRandom = createRandom('ascii-octopus-static');
+            const layout = createAsciiOctopusLayout(TERMINAL_ASCII_OCTOPUS_LAYOUT_SIZE, timeMs, createRandom, staticRandom, interaction);
+            return createAsciiOctopusGlyphGrid({
+                sampleGrid: createAsciiTerminalSampleGrid(columns, rows),
+                layout,
+                palette,
+                cellRandom: createRandom('ascii-octopus-cells'),
+                timeMs,
+            });
+        },
     };
+    /**
+     * Resolves the geometry point sampled for one cell of the grid.
+     *
+     * @param sampleGrid Character-cell sampling grid.
+     * @param columnIndex Zero-based cell column.
+     * @param rowIndex Zero-based cell row.
+     * @returns Sampled point in the octopus coordinate space.
+     *
+     * @private helper of `asciiOctopusAvatarVisual`
+     */
+    function resolveAsciiSampleGridPoint(sampleGrid, columnIndex, rowIndex) {
+        return {
+            x: sampleGrid.offsetX + columnIndex * sampleGrid.cellWidth,
+            y: sampleGrid.offsetY + rowIndex * sampleGrid.cellHeight,
+        };
+    }
+    /**
+     * Builds the sampling grid used when the octopus is painted straight into terminal character cells.
+     *
+     * @param columns Available terminal columns.
+     * @param rows Available terminal rows.
+     * @returns Character-cell sampling grid covering the whole octopus coordinate space.
+     *
+     * @private helper of `asciiOctopusAvatarVisual`
+     */
+    function createAsciiTerminalSampleGrid(columns, rows) {
+        const cellWidth = TERMINAL_ASCII_OCTOPUS_LAYOUT_SIZE / columns;
+        const cellHeight = TERMINAL_ASCII_OCTOPUS_LAYOUT_SIZE / rows;
+        return {
+            cellWidth,
+            cellHeight,
+            columnCount: columns,
+            rowCount: rows,
+            offsetX: cellWidth / 2,
+            offsetY: cellHeight / 2,
+        };
+    }
+    /**
+     * Samples the morphing octopus field into one deterministic grid of ASCII glyphs.
+     *
+     * The field is sampled on a low-resolution grid so the shape stays organic while the glyph
+     * layout remains deterministic for the same avatar input. Both the canvas visual and the
+     * terminal visual share this single sampling pass so they always describe the same octopus.
+     *
+     * @param options Sampling grid, prepared octopus layout, palette, per-cell noise, and animation time.
+     * @returns Resolved glyph of every sampled cell, where `null` means an empty cell.
+     *
+     * @private helper of `asciiOctopusAvatarVisual`
+     */
+    function createAsciiOctopusGlyphGrid(options) {
+        const { sampleGrid, layout, palette, cellRandom, timeMs } = options;
+        const glyphGrid = [];
+        for (let rowIndex = 0; rowIndex < sampleGrid.rowCount; rowIndex++) {
+            const glyphRow = [];
+            for (let columnIndex = 0; columnIndex < sampleGrid.columnCount; columnIndex++) {
+                const point = resolveAsciiSampleGridPoint(sampleGrid, columnIndex, rowIndex);
+                const noise = cellRandom();
+                glyphRow.push(resolveAsciiGlyph({
+                    point,
+                    layout,
+                    palette,
+                    cellWidth: sampleGrid.cellWidth,
+                    cellHeight: sampleGrid.cellHeight,
+                    noise,
+                    timeMs,
+                }));
+            }
+            glyphGrid.push(glyphRow);
+        }
+        return glyphGrid;
+    }
     /**
      * Draws the dark terminal-like glow behind the ASCII octopus.
      *
@@ -29398,28 +29558,28 @@
      */
     function buildToolInvocationScript(options) {
         const { functionName, functionArgsExpression } = options;
-        return `
-        const args = ${functionArgsExpression};
-        const runtimeContextRaw =
-            typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
+        return _spaceTrim.spaceTrim((block) => `
+            const args = ${block(functionArgsExpression)};
+            const runtimeContextRaw =
+                typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
+                    ? undefined
+                    : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
 
-        if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
-        }
+            if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+                args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
+            }
 
-        const toolProgressTokenRaw =
-            typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_PROGRESS_TOKEN_PARAMETER};
+            const toolProgressTokenRaw =
+                typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
+                    ? undefined
+                    : ${TOOL_PROGRESS_TOKEN_PARAMETER};
 
-        if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
-        }
+            if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+                args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
+            }
 
-        return await ${functionName}(args);
-    `;
+            return await ${functionName}(args);
+        `);
     }
 
     /**
@@ -36260,8 +36420,8 @@
          */
         $applyToTaskJson(command, $taskJson) {
             if ($taskJson.format !== undefined && command.format !== $taskJson.format) {
-                throw new ParseError(`Format format is already defined to "${$taskJson.format}".
-                Now you try to redefine it by "${command.format}"`);
+                throw new ParseError(_spaceTrim.spaceTrim(`Format format is already defined to "${$taskJson.format}".
+                Now you try to redefine it by "${command.format}"`));
             }
             $taskJson.format = command.format;
         },