@promptbook/node 0.113.0-8 → 0.114.0-0

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/getRegisteredLlmToolRegisters.d.ts

@@ -0,0 +1,7 @@
+import type { RegisteredLlmToolRegisters } from './RegisteredLlmToolsMessageContext';
+/**
+ * Takes stable snapshots of both LLM provider registers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function getRegisteredLlmToolRegisters(): RegisteredLlmToolRegisters;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/hasRegisteredLlmToolEntry.d.ts

@@ -0,0 +1,7 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+/**
+ * Checks whether the given provider entry already exists in the target register list.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function hasRegisteredLlmToolEntry(registeredLlmToolEntries: ReadonlyArray<Registered>, registeredLlmToolEntry: Registered): boolean;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/listRegisteredLlmToolEntries.d.ts

@@ -0,0 +1,9 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+import type { LlmToolsMetadata } from '../LlmToolsMetadata';
+import type { RegisteredLlmToolEntry } from './RegisteredLlmToolsMessageContext';
+/**
+ * Merges provider entries from the metadata and constructor registers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function listRegisteredLlmToolEntries(registeredMetadata: ReadonlyArray<LlmToolsMetadata>, registeredTools: ReadonlyArray<Registered>): Array<RegisteredLlmToolEntry>;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/listRegisteredLlmToolStatuses.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolRegisters, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Lists provider entries enriched with installation and configuration state.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function listRegisteredLlmToolStatuses({ registeredMetadata, registeredTools }: RegisteredLlmToolRegisters, env: AvailableEnvironmentVariables): Array<RegisteredLlmToolStatus>;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderAvailableRegisteredLlmTools.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders all provider lines in the status summary.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderAvailableRegisteredLlmTools(llmToolStatuses: ReadonlyArray<RegisteredLlmToolStatus>, env: AvailableEnvironmentVariables, isRunningInNode: boolean): string;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderNoRegisteredLlmToolsMessage.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../../../types/string_markdown';
+/**
+ * Renders the fallback message for environments with no registered providers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderNoRegisteredLlmToolsMessage(usedEnvMessage: string): string_markdown;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderRegisteredLlmToolsMessage.d.ts

@@ -0,0 +1,8 @@
+import type { string_markdown } from '../../../../types/string_markdown';
+import type { RegisteredLlmToolsMessageContext } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders the full provider status summary.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderRegisteredLlmToolsMessage({ env, llmToolStatuses, usedEnvMessage, isRunningInNode, }: RegisteredLlmToolsMessageContext): string_markdown;

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderRelevantRegisteredLlmToolsEnvironmentVariables.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders the list of environment variables used by at least one registered provider.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderRelevantRegisteredLlmToolsEnvironmentVariables(env: AvailableEnvironmentVariables, llmToolStatuses: ReadonlyArray<RegisteredLlmToolStatus>): string;

package/esm/src/utils/agent-message-runtime/agentMessageRuntimePaths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Temporary subdirectory used for agent-message runner shell scripts.
+ *
+ * @private internal constant of agent-message runtime paths
+ */
+export declare const AGENT_MESSAGE_SCRIPT_DIRECTORY_NAME = "agent-messages";
+/**
+ * Builds the temporary shell script path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary shell script path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageScriptPathFromFileName(projectPath: string, sourceFileName: string): string;
+/**
+ * Builds the live runtime log path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary live runtime log path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageRuntimeLogPathFromFileName(projectPath: string, sourceFileName: string): string;

package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the latest user-friendly activity snippet from a coding-harness runtime log.
+ *
+ * The Agents Server local agent runner streams the answering harness output (for example
+ * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
+ * message. This helper extracts the most recent natural-language assistant narration so the
+ * durable chat can show what the agent is doing right now instead of a generic thinking
+ * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
+ * other technical details are intentionally ignored, and harnesses that do not stream
+ * structured text simply resolve to `null` so the caller keeps its existing behavior.
+ *
+ * @param logText - Raw runtime log content.
+ * @returns Latest human-readable activity snippet, or `null` when none can be resolved.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function resolveAgentMessageRuntimeActivity(logText: string | null | undefined): string | null;

package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.test.d.ts

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

package/esm/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -39,7 +39,7 @@ export type ResolveAgentAvatarOptions = {
  */
 export type ResolveAgentAvatarImageUrlOptions = ResolveAgentAvatarOptions;
 /**
- * Default built-in avatar visual used when an agent does not define `META IMAGE`.
+ * Default built-in avatar visual used when an agent does not define `META IMAGE`, `META AVATAR`, or `META VISUAL`.
  *
  * @private shared avatar contract
  */
@@ -76,7 +76,7 @@ export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOpti
 export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarOptions): string_url_image | null;
 /**
  * Resolve the best avatar representation for an agent, preferring explicit `META IMAGE`
- * and otherwise returning the default deterministic canvas visual.
+ * and otherwise returning the selected deterministic canvas visual.
  *
  * @private utility of `<Chat/>`
  */

package/esm/src/utils/agents/terminalAgentAvatarVisual.d.ts

@@ -0,0 +1,104 @@
+import type { CreateCanvasForAsciiArt } from '../../avatars/renderAvatarVisualAsciiArt';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AsciiArtColorDepth } from '../ascii-art/convertImageDataToAsciiArt';
+/**
+ * Output width of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_COLUMNS = 48;
+/**
+ * Output height of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_ROWS = 12;
+/**
+ * Refresh cadence used while a terminal agent avatar visual is animated.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_REFRESH_INTERVAL_MS = 300;
+/**
+ * Centers ANSI-colored terminal avatar lines within one terminal frame.
+ *
+ * @param lines ANSI-colored avatar lines.
+ * @param frameColumns Available frame width in terminal character cells.
+ * @returns Avatar lines with leading terminal spaces added.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function centerTerminalAgentAvatarVisualLines(lines: ReadonlyArray<string>, frameColumns: number): ReadonlyArray<string>;
+/**
+ * Options passed when rendering one animated terminal avatar frame.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisualFrameOptions = {
+    /**
+     * Current animation time forwarded to the shared avatar renderer.
+     */
+    readonly animationTimeMs: number;
+};
+/**
+ * Runtime renderer for an agent avatar visual shown in a terminal.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisual = {
+    /**
+     * Whether the selected built-in visual changes over time.
+     */
+    readonly isAnimated: boolean;
+    /**
+     * Renders one ANSI ASCII-art frame for the current terminal timestamp.
+     */
+    readonly renderFrame: (options: TerminalAgentAvatarVisualFrameOptions) => ReadonlyArray<string>;
+};
+/**
+ * Options for creating a terminal avatar visual renderer from an agent book source.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type CreateTerminalAgentAvatarVisualOptions = {
+    /**
+     * Source of the agent book whose metadata controls avatar identity.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Built-in avatar visual used when the agent does not declare `META AVATAR` or `META VISUAL`.
+     */
+    readonly defaultAvatarVisualId?: AvatarVisualId;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Platform-specific canvas factory used to rasterize the visual.
+     */
+    readonly createCanvas: CreateCanvasForAsciiArt;
+};
+/**
+ * Resolves the built-in avatar visual selected for terminal rendering of one agent source.
+ *
+ * @param agentSource Source of the agent book.
+ * @param defaultAvatarVisualId Built-in fallback used when the source does not declare an avatar visual.
+ * @returns Supported built-in avatar visual id.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function resolveTerminalAgentAvatarVisualId(agentSource: string_book, defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
+/**
+ * Creates an ANSI ASCII-art avatar renderer for terminal UIs.
+ *
+ * The agent's avatar visual is resolved the same way as on the website: `META AVATAR`
+ * / `META VISUAL` wins, then the provided fallback visual, then the shared default visual.
+ * The terminal variant uses a transparent horizontal canvas instead of the website's framed square surface.
+ *
+ * @param options Agent source, canvas factory, and optional terminal color settings.
+ * @returns Runtime terminal avatar visual renderer.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function createTerminalAgentAvatarVisual(options: CreateTerminalAgentAvatarVisualOptions): TerminalAgentAvatarVisual;

package/esm/src/utils/agents/terminalAgentAvatarVisual.test.d.ts

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

package/esm/src/utils/color/Color.d.ts

@@ -1,8 +1,8 @@
 import type { string_color } from '../../types/string_person_fullname';
 import type { string_url_image } from '../../types/string_url_image';
 import type { WithTake } from '../take/interfaces/ITakeChain';
-import { CSS_COLORS } from './css-colors';
 import { ColorValue } from './ColorValue';
+import { CSS_COLORS } from './css-colors';
 /**
  * Color object represents an RGB color with alpha channel
  *

package/esm/src/utils/html/escapeHtml.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Escapes text so it can be safely inserted into HTML markup or an HTML attribute.
+ *
+ * @param value - Plain text value.
+ * @returns HTML-safe text.
+ *
+ * @private internal utility for building standalone HTML documents
+ */
+export declare function escapeHtml(value: string): string;

package/esm/src/utils/markdown/shiftMarkdownHeadingLevels.d.ts

@@ -0,0 +1,15 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Moves every heading of a markdown document deeper into the hierarchy.
+ *
+ * This is needed when an independent markdown document is embedded under an
+ * existing heading, so that the merged document keeps one consistent outline.
+ * Headings inside fenced code blocks are left untouched.
+ *
+ * @param markdown - Markdown document to shift.
+ * @param headingLevelShift - How many levels the headings should move down.
+ * @returns Markdown with shifted headings.
+ *
+ * @private internal utility for composing markdown documents
+ */
+export declare function shiftMarkdownHeadingLevels(markdown: string_markdown, headingLevelShift: number): string_markdown;

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.113.0-5`).
+ * It follows semantic versioning (e.g., `0.113.1-0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.113.0-8",
+    "version": "0.114.0-0",
     "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.113.0-8"
+        "@promptbook/core": "0.114.0-0"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",

package/umd/book/scripts/import-markdown/increaseHeadings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Increase the level of all headings in the markdown content
+ *
+ * @example h1 -> h2, h2 -> h3, ...
+ * @param content The markdown content
+ * @returns The markdown with increased headings
+ */
+export declare function increaseHeadings(content: string): string;