@promptbook/pdf 0.112.0-69 → 0.112.0-71

package/esm/src/avatars/types/AvatarVisualDefinition.d.ts

@@ -7,7 +7,7 @@ import type { AvatarDefinition } from './AvatarDefinition';
  *
  * @private shared contract for the avatar rendering system
  */
-export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'minecraft2' | 'fractal' | 'orb';
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'octopus3d' | 'ascii-octopus' | 'minecraft' | 'minecraft2' | 'fractal' | 'orb';
 /**
  * Derived color palette used by avatar visuals.
  *

package/esm/src/avatars/visuals/avatar3dProjectionShared.d.ts

@@ -0,0 +1,141 @@
+/**
+ * One 3D point used by the shared avatar projection helpers.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export type Point3D = {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+};
+/**
+ * One projected 2D point derived from scene-space 3D coordinates.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export type ProjectedPoint = {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+};
+/**
+ * Default camera distance ratio shared by the proper-3D avatar visuals.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare const DEFAULT_3D_CAMERA_DISTANCE_RATIO = 1.4;
+/**
+ * Clamps one number into the provided range.
+ *
+ * @param value Input value.
+ * @param minimumValue Inclusive lower bound.
+ * @param maximumValue Inclusive upper bound.
+ * @returns Clamped value.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function clampNumber(value: number, minimumValue: number, maximumValue: number): number;
+/**
+ * Rotates one point around the local Y axis.
+ *
+ * @param point Source point.
+ * @param angle Rotation angle in radians.
+ * @returns Rotated point.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function rotatePointAroundY(point: Point3D, angle: number): Point3D;
+/**
+ * Rotates one point around the local X axis.
+ *
+ * @param point Source point.
+ * @param angle Rotation angle in radians.
+ * @returns Rotated point.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function rotatePointAroundX(point: Point3D, angle: number): Point3D;
+/**
+ * Applies the local rotations and translation to one scene point.
+ *
+ * @param localPoint Point in local object space.
+ * @param center Object center in scene space.
+ * @param rotationX Object pitch in radians.
+ * @param rotationY Object yaw in radians.
+ * @returns Transformed scene-space point.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function transformScenePoint(localPoint: Point3D, center: Point3D, rotationX: number, rotationY: number): Point3D;
+/**
+ * Projects one scene point into canvas coordinates.
+ *
+ * @param point Scene-space point.
+ * @param size Canvas size in CSS pixels.
+ * @param sceneCenterX Horizontal scene center.
+ * @param sceneCenterY Vertical scene center.
+ * @param cameraDistanceRatio Optional camera distance ratio.
+ * @returns Projected point.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function projectScenePoint(point: Point3D, size: number, sceneCenterX: number, sceneCenterY: number, cameraDistanceRatio?: number): ProjectedPoint;
+/**
+ * Interpolates between two projected points.
+ *
+ * @param startPoint Start point.
+ * @param endPoint End point.
+ * @param ratio Interpolation ratio in the range `[0, 1]`.
+ * @returns Interpolated projected point.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function interpolateProjectedPoint(startPoint: ProjectedPoint, endPoint: ProjectedPoint, ratio: number): ProjectedPoint;
+/**
+ * Subtracts one 3D point from another.
+ *
+ * @param leftPoint Left point.
+ * @param rightPoint Right point.
+ * @returns Difference vector.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function subtractPoint3D(leftPoint: Point3D, rightPoint: Point3D): Point3D;
+/**
+ * Computes the 3D cross product of two vectors.
+ *
+ * @param leftVector Left vector.
+ * @param rightVector Right vector.
+ * @returns Cross product.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function crossProduct3D(leftVector: Point3D, rightVector: Point3D): Point3D;
+/**
+ * Computes the 3D dot product of two vectors.
+ *
+ * @param leftVector Left vector.
+ * @param rightVector Right vector.
+ * @returns Dot product.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function dotProduct3D(leftVector: Point3D, rightVector: Point3D): number;
+/**
+ * Normalizes one 3D vector while keeping zero vectors stable.
+ *
+ * @param vector Source vector.
+ * @returns Normalized vector.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function normalizeVector3(vector: Point3D): Point3D;
+/**
+ * Measures the perimeter of one projected quad.
+ *
+ * @param corners Quad corners.
+ * @returns Perimeter length.
+ *
+ * @private helper of the 3D avatar visuals
+ */
+export declare function getProjectedQuadPerimeter(corners: readonly [ProjectedPoint, ProjectedPoint, ProjectedPoint, ProjectedPoint]): number;

package/esm/src/avatars/visuals/octopus3dAvatarVisual.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Proper 3D Octopus visual built from projected organic meshes and tentacles.
+ *
+ * @private built-in avatar visual
+ */
+export declare const octopus3dAvatarVisual: AvatarVisualDefinition;

package/esm/src/cli/cli-commands/agent/agentProjectPaths.d.ts

@@ -11,13 +11,13 @@ export declare const AGENT_BOOK_FILE_PATH = "agent.book";
  */
 export declare const AGENT_MESSAGES_DIRECTORY_PATH = "messages";
 /**
- * Relative path to queued user messages consumed by `ptbk agent tick`.
+ * Relative path to queued user messages consumed by `ptbk agent run-once`.
  *
  * @private internal utility of `ptbk agent`
  */
 export declare const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH: string;
 /**
- * Relative path to answered messages written by `ptbk agent tick`.
+ * Relative path to answered messages written by `ptbk agent run-once`.
  *
  * @private internal utility of `ptbk agent`
  */

package/esm/src/cli/cli-commands/agent/initializeAgentRunnerCommand.d.ts

@@ -0,0 +1,22 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+import { createAgentRunOptionsFromCliOptions } from './agentRunCliOptions';
+/**
+ * Shared command-registration options for `ptbk agent` runner subcommands.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+type InitializeAgentRunnerCommandOptions = {
+    readonly commandName: string;
+    readonly aliases?: ReadonlyArray<string>;
+    readonly summary: string;
+    readonly featureLines: ReadonlyArray<string>;
+    readonly loadExecutor: () => Promise<(runOptions: ReturnType<typeof createAgentRunOptionsFromCliOptions>) => Promise<unknown>>;
+};
+/**
+ * Registers one runner-backed `ptbk agent` subcommand with the shared option and error handling flow.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+export declare function $initializeAgentRunnerCommand(program: Program, options: InitializeAgentRunnerCommandOptions): $side_effect;
+export {};

package/esm/src/cli/cli-commands/agent/runMultiple.d.ts

@@ -0,0 +1,10 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `agent run-multiple` command for Promptbook CLI utilities.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAgentRunMultipleCommand(program: Program): $side_effect;

package/esm/src/cli/cli-commands/agent.d.ts

@@ -5,8 +5,9 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  *
  * The agent command provides utilities for repository-backed message queues:
  * - init: Initialize local agent queue and instruction files
- * - tick: Answer one queued message and exit
- * - run: Watch the queue and answer messages one by one
+ * - run-once (alias: tick): Answer one queued message and exit
+ * - run-agent (alias: run): Watch one queue and answer messages one by one
+ * - run-multiple: Watch direct child agent repositories in one shared session
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
  *

package/esm/src/cli/other/install.test.d.ts

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

package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts

@@ -3,7 +3,7 @@ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutio
 import type { string_javascript_name } from '../../types/string_person_fullname';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 export { setTimeoutToolRuntimeAdapter } from './setTimeoutToolRuntimeAdapter';
-export type { CancelTimeoutToolResult, ListTimeoutsToolResult, SetTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, UpdateTimeoutToolResult } from './TimeoutToolRuntimeAdapter';
+export type { CancelTimeoutToolResult, ListTimeoutsToolResult, SetTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, UpdateTimeoutToolResult, } from './TimeoutToolRuntimeAdapter';
 /**
  * `USE TIMEOUT` commitment definition.
  *

package/esm/src/commitments/WALLET/WALLET.d.ts

@@ -3,7 +3,7 @@ import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutio
 import type { string_javascript_name } from '../../types/string_person_fullname';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 export { setWalletToolRuntimeAdapter } from './setWalletToolRuntimeAdapter';
-export type { WalletRecordType, WalletToolRecord, WalletToolRuntimeAdapter, WalletToolRuntimeContext } from './WalletToolRuntimeAdapter';
+export type { WalletRecordType, WalletToolRecord, WalletToolRuntimeAdapter, WalletToolRuntimeContext, } from './WalletToolRuntimeAdapter';
 /**
  * WALLET commitment definition.
  *

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-68`).
+ * It follows semantic versioning (e.g., `0.112.0-70`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/pdf",
-    "version": "0.112.0-69",
+    "version": "0.112.0-71",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -98,7 +98,7 @@
     "types": "./esm/src/_packages/pdf.index.d.ts",
     "typings": "./esm/src/_packages/pdf.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-69"
+        "@promptbook/core": "0.112.0-71"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-69';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-71';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2080,11 +2080,11 @@
      */
     function pipelineJsonToString(pipelineJson) {
         const { title, pipelineUrl, bookVersion, description, parameters, tasks } = pipelineJson;
-        let pipelineString = `# ${title}`;
-        if (description) {
-            pipelineString += '\n\n';
-            pipelineString += description;
-        }
+        let pipelineString = spacetrim.spaceTrim((block) => `
+            # ${title}
+
+            ${block(description || '')}
+        `);
         const commands = [];
         if (pipelineUrl) {
             commands.push(`PIPELINE URL ${pipelineUrl}`);
@@ -2100,20 +2100,17 @@
         for (const parameter of parameters.filter(({ isOutput }) => isOutput)) {
             commands.push(`OUTPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
         }
-        pipelineString += '\n\n';
-        pipelineString += commands.map((command) => `- ${command}`).join('\n');
+        pipelineString = spacetrim.spaceTrim((block) => `
+            ${block(pipelineString)}
+
+            ${block(commands.map((command) => `- ${command}`).join('\n'))}
+        `);
         for (const task of tasks) {
             const { 
             /* Note: Not using:> name, */
             title, description, 
             /* Note: dependentParameterNames, */
             jokerParameterNames: jokers, taskType, content, postprocessingFunctionNames: postprocessing, expectations, format, resultingParameterName, } = task;
-            pipelineString += '\n\n';
-            pipelineString += `## ${title}`;
-            if (description) {
-                pipelineString += '\n\n';
-                pipelineString += description;
-            }
             const commands = [];
             let contentLanguage = 'text';
             if (taskType === 'PROMPT_TASK') {
@@ -2176,18 +2173,23 @@
                     commands.push(`FORMAT JSON`);
                 }
             } /* not else */
-            pipelineString += '\n\n';
-            pipelineString += commands.map((command) => `- ${command}`).join('\n');
-            pipelineString += '\n\n';
-            pipelineString += '```' + contentLanguage;
-            pipelineString += '\n';
-            pipelineString += spacetrim.spaceTrim(content);
-            //                   <- TODO: [main] !!3 Escape
-            //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
-            pipelineString += '\n';
-            pipelineString += '```';
-            pipelineString += '\n\n';
-            pipelineString += `\`-> {${resultingParameterName}}\``; // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+            pipelineString = spacetrim.spaceTrim((block) => `
+                ${block(pipelineString)}
+
+                ## ${title}
+
+                ${block(description || '')}
+
+                ${block(commands.map((command) => `- ${command}`).join('\n'))}
+
+                \`\`\`${contentLanguage}
+                ${block(spacetrim.spaceTrim(content))}
+                \`\`\`
+
+                \`-> {${resultingParameterName}}\`
+            `); // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+            // <- TODO: [main] !!3 Escape
+            // <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         }
         return validatePipelineString(pipelineString);
     }