@promptbook/types 0.112.0-66 → 0.112.0-70

package/README.md

@@ -654,7 +654,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.
@@ -725,13 +725,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/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';

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

@@ -1,6 +1,6 @@
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatMessageContentSegment } from '../utils/splitMessageContentIntoSegments';
-import { type StreamingFeaturePlaceholderKind } from './StreamingFeaturePlaceholder';
+import type { StreamingFeaturePlaceholderKind } from './StreamingFeaturePlaceholder';
 /**
  * Props for rendering the rich message-body content area.
  *

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

@@ -1,9 +1,9 @@
 import type { CSSProperties, ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
-import { Color } from '../../../_packages/color.index';
-import { SpeechRecognition } from '../../../types/SpeechRecognition';
-import type { string_href } from '../../../types/typeAliases';
-import { string_color } from '../../../types/typeAliases';
+import type { SpeechRecognition } from '../../../types/SpeechRecognition';
+import type { string_href } from '../../../types/string_href';
+import type { string_color } from '../../../types/string_person_fullname';
+import { Color } from '../../../utils/color/Color';
 import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';

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

@@ -1,4 +1,4 @@
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatFeedbackMode, ChatProps } from './ChatProps';
 /**

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

@@ -3,9 +3,9 @@ import { Color } from '../../../utils/color/Color';
 import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { TeamToolCallSummary, TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
 import type { AgentProfileData } from '../utils/loadAgentProfile';
-import type { TeamToolResult } from '../utils/toolCallParsing';
+import type { TeamToolResult } from '../utils/toolCallParsing/TeamToolResult';
 import type { ChatUiTranslations } from './ChatProps';
 /**
  * Tool-call snapshot rendered by the modal body.

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

@@ -2,9 +2,9 @@ import { type ReactElement } from 'react';
 import { Color } from '../../../utils/color/Color';
 import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { TeamToolCallSummary, TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
 import type { AgentProfileData } from '../utils/loadAgentProfile';
-import type { TeamToolResult } from '../utils/toolCallParsing';
+import type { TeamToolResult } from '../utils/toolCallParsing/TeamToolResult';
 /**
  * Rendering options for TEAM tool-call modal content.
  *

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

@@ -1,7 +1,7 @@
 import type { ToolCall } from '../../../types/ToolCall';
-import type { AgentChipData } from '../AgentChip';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { ChatMessage } from '../types/ChatMessage';
-import { type TransitiveCitation } from '../utils/collectTeamToolCallSummary';
+import type { TransitiveCitation } from '../utils/collectTeamToolCallSummary';
 import type { ChatProps } from './ChatProps';
 /**
  * Status variants for tool call chips.

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

@@ -1,8 +1,8 @@
 import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
 import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import { Color } from '../../../utils/color/Color';
 /**
  * Options for rendering a tool call detail view.
  *

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

@@ -1,7 +1,7 @@
 import type { ToolCallLogEntry, ToolCallState } from '../../../types/ToolCall';
 import type { TODO_any } from '../../../utils/organization/TODO_any';
 import type { ChatMessage } from '../types/ChatMessage';
-import type { RunBrowserToolArtifact, RunBrowserToolError } from '../utils/toolCallParsing';
+import type { RunBrowserToolArtifact, RunBrowserToolError } from '../utils/toolCallParsing/RunBrowserToolResult';
 /**
  * One browser tool call rendered in the replay modal.
  *

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

@@ -1,7 +1,7 @@
 import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
 import type { SpeechRecognitionErrorCode } from '../../../types/SpeechRecognition';
 import type { ChatProps } from './ChatProps';
-import { type DictationRefinementSettings } from './refineFinalDictationChunk';
+import type { DictationRefinementSettings } from './refineFinalDictationChunk';
 /**
  * Stable dictation error shape consumed by the correction panel UI.
  *

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

@@ -1,5 +1,5 @@
 import { type Dispatch, type SetStateAction } from 'react';
-import { type DictationDictionary, type DictationRefinementSettings } from './refineFinalDictationChunk';
+import type { DictationDictionary, DictationRefinementSettings } from './refineFinalDictationChunk';
 /**
  * Persistent dictation state shared by the dictation hook and its helpers.
  *

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

@@ -1,5 +1,5 @@
 import type { ChatProps } from './ChatProps';
-import { type DictationUiState, type SpeechRecognitionUiDescriptor } from './resolveSpeechRecognitionUiDescriptor';
+import type { DictationUiState, SpeechRecognitionUiDescriptor } from './resolveSpeechRecognitionUiDescriptor';
 /**
  * Props for `useChatInputAreaDictationSupport`.
  *

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

@@ -1,9 +1,9 @@
 import { type MutableRefObject } from 'react';
 import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { ChatMessage } from '../types/ChatMessage';
-import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
-import { type AgentProfileData } from '../utils/loadAgentProfile';
-import { type TeamToolResult } from '../utils/toolCallParsing';
+import type { TeamToolCallSummary, TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { AgentProfileData } from '../utils/loadAgentProfile';
+import type { TeamToolResult } from '../utils/toolCallParsing/TeamToolResult';
 /**
  * Tool-call snapshot rendered by the modal.
  *

package/esm/src/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -1,10 +1,10 @@
 import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { ChatProps } from '../Chat/ChatProps';
 import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Determines how the chat reset action should behave when user clicks "New chat".
  */

package/esm/src/book-components/Chat/LlmChat/useLlmChatMessageHandler.d.ts

@@ -1,6 +1,6 @@
 import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
 import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { LlmChatProps } from './LlmChatProps';
 /**