@promptbook/cli 0.112.0-66 → 0.112.0-70

package/esm/scripts/run-agent-messages/main/listLocalAgentRunnerProjects.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One local direct-child repository that looks like a Promptbook agent runner project.
+ */
+export type LocalAgentRunnerProject = {
+    readonly directoryName: string;
+    readonly projectPath: string;
+};
+/**
+ * Lists local agent runner repositories from direct child directories of the given root.
+ */
+export declare function listLocalAgentRunnerProjects(rootPath: string): Promise<ReadonlyArray<LocalAgentRunnerProject>>;

package/esm/scripts/run-agent-messages/main/loadAgentMessageQueueSnapshot.d.ts

@@ -0,0 +1,25 @@
+import type { AgentMessageFile } from '../messages/AgentMessageFile';
+/**
+ * Queue counts and files used to render the agent-run dashboard.
+ */
+export type AgentMessageQueueSnapshot = {
+    readonly queuedMessages: ReadonlyArray<AgentMessageFile>;
+    readonly finishedMessageCount: number;
+};
+/**
+ * Reads current queued and finished message counts for the agent dashboard.
+ */
+export declare function loadAgentMessageQueueSnapshot(projectPath: string): Promise<AgentMessageQueueSnapshot>;
+/**
+ * Converts agent queue counts into the prompt-style snapshot used by the shared rich UI state.
+ */
+export declare function createAgentQueueProgressSnapshot(queueSnapshot: AgentMessageQueueSnapshot): {
+    done: number;
+    forAgent: number;
+    belowMinimumPriority: number;
+    toBeWritten: number;
+};
+/**
+ * Returns the normalized queued-messages path shown in the UI.
+ */
+export declare function getQueuedAgentMessagesDirectoryLabel(): string;

package/esm/scripts/run-agent-messages/main/pullLatestChangesForAgentQueueIfEnabled.d.ts

@@ -0,0 +1,9 @@
+import type { AgentRunOptions } from '../AgentRunOptions';
+/**
+ * Pulls the latest Git changes for the agent queue when `--auto-pull` is enabled.
+ */
+export declare function pullLatestChangesForAgentQueueIfEnabled(options: {
+    readonly projectPath: string;
+    readonly runOptions: AgentRunOptions;
+    readonly logMessage?: string;
+}): Promise<number | undefined>;

package/esm/scripts/run-agent-messages/main/runAgentMessages.d.ts

@@ -2,4 +2,6 @@ import type { AgentRunOptions } from '../AgentRunOptions';
 /**
  * Watches the queued message directory and answers messages one by one.
  */
-export declare function runAgentMessages(options: AgentRunOptions): Promise<void>;
+export declare function runAgentMessages(options: AgentRunOptions, controls?: {
+    readonly shouldContinue?: () => boolean;
+}): Promise<void>;

package/esm/scripts/run-agent-messages/main/runMultipleAgentMessages.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRunOptions } from '../AgentRunOptions';
+/**
+ * Watches all direct child agent repositories from the current directory in one shared session.
+ */
+export declare function runMultipleAgentMessages(options: AgentRunOptions, controls?: {
+    readonly shouldContinue?: () => boolean;
+}): Promise<void>;

package/esm/scripts/run-agent-messages/main/synchronizeGithubAgentRunnerRepositories.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Environment variable carrying the GitHub token used to discover and clone agent repositories.
+ */
+export declare const PROMPTBOOK_AGENT_RUNNER_GITHUB_TOKEN_ENV = "PROMPTBOOK_AGENT_RUNNER_GITHUB_TOKEN";
+/**
+ * Environment variable carrying the GitHub owner whose `agent-*` repositories should be mirrored locally.
+ */
+export declare const PROMPTBOOK_AGENT_RUNNER_GITHUB_OWNER_ENV = "PROMPTBOOK_AGENT_RUNNER_GITHUB_OWNER";
+/**
+ * Result of one GitHub synchronization round.
+ */
+export type GithubAgentRunnerRepositoriesSynchronizationResult = {
+    readonly clonedRepositoryNames: ReadonlyArray<string>;
+    readonly owner?: string;
+    readonly synchronizedAt?: number;
+};
+/**
+ * Loads the optional GitHub repository-mirroring configuration for multi-agent runs.
+ */
+export declare function loadAgentRunnerGithubConfiguration(): {
+    readonly token: string;
+    readonly owner: string;
+} | null;
+/**
+ * Clones missing `agent-*` repositories from the configured GitHub owner into the direct child directories of `rootPath`.
+ */
+export declare function synchronizeGithubAgentRunnerRepositories(rootPath: string): Promise<GithubAgentRunnerRepositoriesSynchronizationResult>;

package/esm/scripts/run-agent-messages/main/tickAgentMessages.d.ts

@@ -1,11 +1,13 @@
+import { type CoderRunUiHandle } from '../../run-codex-prompts/ui/renderCoderRunUi';
 import type { AgentRunOptions } from '../AgentRunOptions';
 import type { AgentMessageFile } from '../messages/AgentMessageFile';
 import { type FinishedAgentMessageFile } from '../messages/moveAgentMessageToFinished';
 /**
- * Result of one `ptbk agent tick` invocation.
+ * Result of one `ptbk agent run-once` invocation.
  */
 export type AgentTickResult = {
     readonly isMessageProcessed: boolean;
+    readonly autoPullTimestamp?: number;
     readonly queuedMessage?: AgentMessageFile;
     readonly finishedMessage?: FinishedAgentMessageFile;
 };
@@ -14,8 +16,9 @@ export type AgentTickResult = {
  */
 export type TickAgentMessagesOptions = {
     readonly isQuietWhenIdle?: boolean;
+    readonly uiHandle?: CoderRunUiHandle;
 };
 /**
- * Answers one queued markdown message and moves it to `messages/finished`.
+ * Answers one queued `.book` message thread and moves it to `messages/finished`.
  */
 export declare function tickAgentMessages(options: AgentRunOptions, tickOptions?: TickAgentMessagesOptions): Promise<AgentTickResult>;

package/esm/scripts/run-agent-messages/main/validateAgentWatchOptions.d.ts

@@ -0,0 +1,5 @@
+import type { AgentRunOptions } from '../AgentRunOptions';
+/**
+ * Validates constraints specific to never-ending agent watch loops.
+ */
+export declare function validateAgentWatchOptions(commandDisplayName: string, options: AgentRunOptions): void;

package/esm/scripts/run-agent-messages/main/withCurrentWorkingDirectory.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Runs one async callback from a temporary current working directory and always restores the previous directory.
+ */
+export declare function withCurrentWorkingDirectory<T>(directoryPath: string, callback: () => Promise<T>): Promise<T>;

package/esm/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts

@@ -1,4 +1,4 @@
 /**
- * Builds the prompt sent to the selected coding runner for one queued user message.
+ * Builds the prompt sent to the selected coding runner for one queued user-thread book.
  */
 export declare function buildAgentMessagePrompt(messageRelativePath: string): string;

package/esm/scripts/run-agent-messages/messages/listQueuedAgentMessages.d.ts

@@ -1,5 +1,5 @@
 import type { AgentMessageFile } from './AgentMessageFile';
 /**
- * Lists queued markdown message files in deterministic filename order.
+ * Lists queued `.book` message files in deterministic filename order.
  */
 export declare function listQueuedAgentMessages(projectPath: string): Promise<ReadonlyArray<AgentMessageFile>>;

package/esm/scripts/run-agent-messages/ui/buildAgentRunInitialsVisual.d.ts

@@ -1,4 +1,4 @@
 /**
- * Builds a compact centered initials banner for `ptbk agent run`.
+ * Builds a compact centered banner that shows the local agent name.
  */
 export declare function buildAgentRunInitialsVisual(agentName: string, totalWidth: number): readonly string[];

package/esm/scripts/run-agent-messages/ui/initializeAgentRunUi.d.ts

@@ -0,0 +1,15 @@
+import type { AgentRunOptions } from '../AgentRunOptions';
+import { type AgentMessageQueueSnapshot } from '../main/loadAgentMessageQueueSnapshot';
+import { type CoderRunUiHandle } from '../../run-codex-prompts/ui/renderCoderRunUi';
+/**
+ * Creates and seeds the persistent rich terminal UI used by `ptbk agent run`.
+ */
+export declare function initializeAgentRunUi(projectPath: string, options: AgentRunOptions, queueSnapshot: AgentMessageQueueSnapshot): Promise<CoderRunUiHandle | undefined>;
+/**
+ * Updates the persistent rich UI to the idle watch state.
+ */
+export declare function updateAgentRunUiForWatching(uiHandle: CoderRunUiHandle, queueSnapshot: AgentMessageQueueSnapshot, statusMessage?: string): void;
+/**
+ * Updates the persistent rich UI while the runner refreshes the queue repository.
+ */
+export declare function updateAgentRunUiForPulling(uiHandle: CoderRunUiHandle, queueSnapshot: AgentMessageQueueSnapshot, statusMessage: string): void;

package/esm/scripts/run-agent-messages/ui/loadAgentRunUiMetadata.d.ts

@@ -10,6 +10,10 @@ export type AgentRunUiMetadata = {
  * Reads the local agent title and latest queued user message for the rich agent dashboard.
  */
 export declare function loadAgentRunUiMetadata(projectPath: string, queuedMessage: AgentMessageFile): Promise<AgentRunUiMetadata>;
+/**
+ * Reads the local `agent.book` title and falls back to a stable generic name when unavailable.
+ */
+export declare function readLocalAgentName(projectPath: string): Promise<string>;
 /**
  * Extracts the latest `MESSAGE @User` block while preserving the original line breaks.
  */

package/esm/scripts/run-codex-prompts/git/agentGitIdentity.d.ts

@@ -25,3 +25,7 @@ export declare function buildAgentGitSigningFlag(identity?: AgentGitIdentity | u
  * Prints a one-time style tip when coding-agent commits fall back to the user's default Git configuration.
  */
 export declare function printAgentGitIdentityTipIfNeeded(): void;
+/**
+ * Defers the coding-agent Git identity tip until process shutdown so long-running UIs stay uninterrupted.
+ */
+export declare function printAgentGitIdentityTipAtProcessExitIfNeeded(): void;

package/esm/src/_packages/core.index.d.ts

@@ -13,6 +13,7 @@ import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
 import { createStandaloneBookLanguageMarkdown } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
+import { Book } from '../book-3.0/Book';
 import { AgentCollectionInSupabase } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 import { createPipelineCollectionFromJson } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromJson';
 import { createPipelineCollectionFromPromise } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromPromise';
@@ -238,6 +239,7 @@ export { validateBook };
 export { DEFAULT_BOOK };
 export { createStandaloneBookLanguageMarkdown };
 export { generatePlaceholderAgentProfileImageUrl };
+export { Book };
 export { AgentCollectionInSupabase };
 export { createPipelineCollectionFromJson };
 export { createPipelineCollectionFromPromise };

package/esm/src/avatars/AvatarOrImage.d.ts

@@ -1,5 +1,6 @@
 import type { CSSProperties } from 'react';
-import type { string_css_class, string_url_image } from '../types/typeAliases';
+import type { string_css_class } from '../types/string_markdown';
+import type { string_url_image } from '../types/string_url_image';
 import type { AvatarDefinition } from './types/AvatarDefinition';
 import type { AvatarSurfaceStyle, AvatarVisualId } from './types/AvatarVisualDefinition';
 /**

package/esm/src/avatars/avatarRenderingUtils.d.ts

@@ -1,5 +1,5 @@
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
-import type { string_color } from '../types/typeAliases';
+import type { string_color } from '../types/string_person_fullname';
 import type { AvatarDefinition } from './types/AvatarDefinition';
 import type { AvatarPalette, AvatarSurfaceStyle } from './types/AvatarVisualDefinition';
 /**

package/esm/src/avatars/renderAvatarVisual.d.ts

@@ -1,6 +1,5 @@
-import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
 import type { AvatarDefinition } from './types/AvatarDefinition';
-import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId } from './types/AvatarVisualDefinition';
+import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId, RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
 /**
  * Stable render data derived once from the avatar definition, surface, and visual id.
  *

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

@@ -1,4 +1,5 @@
-import type { string_agent_hash, string_agent_name, string_color } from '../../types/typeAliases';
+import type { string_agent_hash, string_agent_name } from '../../types/string_agent_name';
+import type { string_color } from '../../types/string_person_fullname';
 /**
  * Normalized identity payload used by all canvas avatar visuals.
  *

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

@@ -1,12 +1,13 @@
 import type { CSSProperties } from 'react';
-import type { string_color, string_css_class } from '../../types/typeAliases';
+import type { string_css_class } from '../../types/string_markdown';
+import type { string_color } from '../../types/string_person_fullname';
 import type { AvatarDefinition } from './AvatarDefinition';
 /**
  * Supported built-in avatar visual identifiers.
  *
  * @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/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -1,5 +1,9 @@
-import type { string_agent_hash, string_agent_name, string_agent_permanent_id, string_agent_url, string_color, string_fonts, string_url_image } from '../../types/typeAliases';
 import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
+import type { string_agent_hash, string_agent_name, string_agent_permanent_id } from '../../types/string_agent_name';
+import type { string_agent_url } from '../../types/string_agent_url';
+import type { string_fonts } from '../../types/string_markdown';
+import type { string_color } from '../../types/string_person_fullname';
+import type { string_url_image } from '../../types/string_url_image';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @

package/esm/src/book-2.0/agent-source/AgentModelRequirements.d.ts

@@ -1,6 +1,7 @@
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
-import type { string_agent_url, string_knowledge_source_link } from '../../types/typeAliases';
-import { chococake } from '../../utils/organization/really_any';
+import type { string_agent_url } from '../../types/string_agent_url';
+import type { string_knowledge_source_link } from '../../types/string_knowledge_source_content';
+import type { chococake } from '../../utils/organization/really_any';
 /**
  * Model requirements for an agent
  *

package/esm/src/book-2.0/agent-source/AgentSourceParseResult.d.ts

@@ -1,5 +1,5 @@
 import type { ParsedCommitment } from '../../commitments/_base/ParsedCommitment';
-import { string_agent_name } from '../../types/typeAliases';
+import type { string_agent_name } from '../../types/string_agent_name';
 /**
  * Result of parsing agent source for commitments
  *

package/esm/src/book-2.0/agent-source/computeAgentHash.d.ts

@@ -1,5 +1,5 @@
-import { string_agent_hash } from '../../types/typeAliases';
-import { string_book } from './string_book';
+import type { string_agent_hash } from '../../types/string_agent_name';
+import type { string_book } from './string_book';
 /**
  * Computes SHA-256 hash of the agent source
  *

package/esm/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -1,6 +1,9 @@
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-import type { string_agent_name, string_model_name, string_system_message, string_url_image } from '../../types/typeAliases';
+import type { string_agent_name } from '../../types/string_agent_name';
+import type { string_model_name } from '../../types/string_model_name';
+import type { string_system_message } from '../../types/string_prompt';
+import type { string_url_image } from '../../types/string_url_image';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.d.ts

@@ -1,4 +1,4 @@
-import type { string_model_name } from '../../types/typeAliases';
+import type { string_model_name } from '../../types/string_model_name';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';

package/esm/src/book-2.0/agent-source/createDefaultAgentName.d.ts

@@ -1,5 +1,5 @@
-import { string_agent_name } from '../../types/typeAliases';
-import { string_book } from './string_book';
+import type { string_agent_name } from '../../types/string_agent_name';
+import type { string_book } from './string_book';
 /**
  * Creates temporary default agent name based on agent source hash
  *

package/esm/src/book-2.0/agent-source/normalizeAgentName.d.ts

@@ -1,4 +1,4 @@
-import { string_agent_name } from '../../types/typeAliases';
+import type { string_agent_name } from '../../types/string_agent_name';
 /**
  * Normalizes agent name from arbitrary string to valid agent name
  *

package/esm/src/book-2.0/agent-source/parseAgentSourcePrelude.d.ts

@@ -1,4 +1,4 @@
-import type { string_agent_name } from '../../types/typeAliases';
+import type { string_agent_name } from '../../types/string_agent_name';
 import type { string_book } from './string_book';
 /**
  * Parsed prelude of one agent source.

package/esm/src/book-2.0/agent-source/parseTeamCommitment.d.ts

@@ -1,4 +1,4 @@
-import type { string_agent_url } from '../../types/typeAliases';
+import type { string_agent_url } from '../../types/string_agent_url';
 /**
  * Parsed TEAM teammate entry.
  *

package/esm/src/book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown.d.ts

@@ -1,4 +1,4 @@
-import { string_markdown } from '../../types/string_markdown';
+import type { string_markdown } from '../../types/string_markdown';
 /**
  * Creates one standalone markdown guide for Book language (Book 2.0 / agent language).
  *

package/esm/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -1,4 +1,6 @@
-import type { string_agent_name, string_agent_permanent_id, string_url, string_url_image } from '../../types/typeAliases';
+import type { string_agent_name, string_agent_permanent_id } from '../../types/string_agent_name';
+import type { string_url } from '../../types/string_url';
+import type { string_url_image } from '../../types/string_url_image';
 /**
  * Generates an image for the agent to use as profile image
  *

package/esm/src/book-3.0/Book.d.ts

@@ -0,0 +1,33 @@
+import type { string_book } from '../book-2.0/agent-source/string_book';
+import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
+/**
+ * Parser for the agent source for Promptbook agents in book language
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class Book {
+    readonly agentName: string;
+    readonly commitments: ReadonlyArray<Commitment>;
+    private readonly messageBlocks;
+    static parse(source: string_book): Book;
+    /**
+     * Creates one Book from already structured message blocks.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    static fromMessages(messages: ReadonlyArray<Pick<ChatMessage, 'content'> & {
+        sender: string;
+    }>, options?: {
+        agentName?: string;
+        commitments?: ReadonlyArray<Commitment>;
+    }): Book;
+    private constructor();
+    stringify(): string_book;
+    getMessages(): ReadonlyArray<ChatMessage>;
+}
+type Commitment = {
+    type: string;
+    subject: string;
+    content: string;
+};
+export {};

package/esm/src/book-components/AvatarProfile/AvatarChip/AvatarChip.d.ts

@@ -1,5 +1,5 @@
 import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
-import type { string_css_class } from '../../../types/typeAliases';
+import type { string_css_class } from '../../../types/string_markdown';
 /**
  * Props of `AvatarChip`
  *

package/esm/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -1,7 +1,7 @@
 import { CSSProperties } from 'react';
 import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_book } from '../../../book-2.0/agent-source/string_book';
-import type { string_css_class } from '../../../types/typeAliases';
+import type { string_css_class } from '../../../types/string_markdown';
 /**
  * Props of `AvatarProfile`
  *

package/esm/src/book-components/BookEditor/BookEditor.d.ts

@@ -1,7 +1,10 @@
 import { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
-import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
+import type { number_percent } from '../../types/number_percent';
+import type { number_positive } from '../../types/number_positive';
+import type { string_knowledge_source_content } from '../../types/string_knowledge_source_content';
+import type { string_css_value } from '../../types/string_markdown';
 import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
 /**
  * Monaco diagnostic shown inside `BookEditor`.

package/esm/src/book-components/BookEditor/BookEditorActionbar.d.ts

@@ -1,4 +1,4 @@
-import { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
+import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
 /**
  * Props for book editor actionbar.
  */

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

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import type { string_url } from '../../../types/typeAliases';
+import type { string_url } from '../../../types/string_url';
 /**
  * Agent profile information for chip display
  */

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

@@ -1,8 +1,8 @@
 /// <reference types="react" />
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import { type ParsedCitation } from '../utils/parseCitationsFromContent';
+import type { ParsedCitation } from '../utils/parseCitationsFromContent';
 import type { ChatProps } from './ChatProps';
 /**
  * Props for the `ChatMessageItem` component

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

@@ -1,6 +1,6 @@
 import type { UIEvent } from 'react';
 import type { Promisable } from 'type-fest';
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { ParsedCitation } from '../utils/parseCitationsFromContent';