@promptbook/markdown-utils 0.112.0-54 → 0.112.0-57

package/esm/src/transpilers/agent-os/AgentOsTranspiler.test.d.ts

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

package/esm/src/transpilers/agent-os/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AgentOsTranspilerRegistration: Registration;

package/esm/src/transpilers/anthropic-claude-managed/AnthropicClaudeManagedTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using Anthropic Claude Agent SDK managed sessions.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AnthropicClaudeManagedTranspiler: {
+    readonly name: "anthropic-claude-managed";
+    readonly title: "Anthropic Claude Managed";
+    readonly packageName: "@promptbook/core";
+    readonly className: "AnthropicClaudeManagedTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/anthropic-claude-managed/AnthropicClaudeManagedTranspiler.test.d.ts

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

package/esm/src/transpilers/anthropic-claude-managed/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AnthropicClaudeManagedTranspilerRegistration: Registration;

package/esm/src/transpilers/anthropic-claude-sdk/AnthropicClaudeSdkTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using Anthropic's Claude SDK.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AnthropicClaudeSdkTranspiler: {
+    readonly name: "anthropic-claude-sdk";
+    readonly title: "Anthropic Claude SDK";
+    readonly packageName: "@promptbook/core";
+    readonly className: "AnthropicClaudeSdkTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/anthropic-claude-sdk/AnthropicClaudeSdkTranspiler.test.d.ts

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

package/esm/src/transpilers/anthropic-claude-sdk/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AnthropicClaudeSdkTranspilerRegistration: Registration;

package/esm/src/transpilers/e2b/E2BTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to a JavaScript launcher that runs the exported agent inside an E2B sandbox.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const E2BTranspiler: {
+    readonly name: "e2b";
+    readonly title: "E2B";
+    readonly packageName: "@promptbook/core";
+    readonly className: "E2BTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/e2b/E2BTranspiler.test.d.ts

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

package/esm/src/transpilers/e2b/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _E2BTranspilerRegistration: Registration;

package/esm/src/transpilers/openai-agents/OpenAiAgentsTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using the OpenAI Agents SDK.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const OpenAiAgentsTranspiler: {
+    readonly name: "openai-agents";
+    readonly title: "OpenAI Agents SDK";
+    readonly packageName: "@promptbook/core";
+    readonly className: "OpenAiAgentsTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/openai-agents/OpenAiAgentsTranspiler.test.d.ts

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

package/esm/src/transpilers/openai-agents/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OpenAiAgentsTranspilerRegistration: Registration;

package/esm/src/types/LlmToolDefinition.d.ts

@@ -1,4 +1,18 @@
 import type { string_markdown_text, string_name } from './typeAliases';
+/**
+ * Minimal recursive JSON Schema entry used by tool definitions.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+type LlmToolJsonSchema = {
+    type?: string;
+    description?: string;
+    properties?: Record<string, LlmToolJsonSchema>;
+    required?: string[];
+    items?: LlmToolJsonSchema;
+    enum?: Array<string | number | boolean | null>;
+    additionalProperties?: boolean;
+};
 /**
  * Definition of a tool that can be used by the model
  *
@@ -16,13 +30,9 @@ export type LlmToolDefinition = {
     /**
      * Parameters of the tool in JSON Schema format
      */
-    readonly parameters: {
+    readonly parameters: LlmToolJsonSchema & {
         readonly type: 'object';
-        readonly properties: Record<string, {
-            type: string;
-            description?: string;
-        }>;
-        readonly required?: string[];
-        readonly additionalProperties?: boolean;
+        readonly properties: Record<string, LlmToolJsonSchema>;
     };
 };
+export {};

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

@@ -21,6 +21,10 @@ export type ResolveAgentAvatarOptions = {
          * Optional preferred avatar visual id coming from remote profile payloads.
          */
         readonly avatarVisualId?: AvatarVisualId;
+        /**
+         * Optional server-wide fallback visual id forwarded by federated server payloads.
+         */
+        readonly defaultAgentAvatarVisualId?: AvatarVisualId;
     };
     /**
      * Optional base URL used to resolve relative meta images and placeholders.
@@ -52,6 +56,17 @@ export type ResolvedAgentAvatar = {
     readonly avatarDefinition: AvatarDefinition;
     readonly visualId: AvatarVisualId;
 };
+/**
+ * Resolves the avatar visual preferred by an agent, then falls back to a federated server default
+ * and finally to the caller/server default.
+ *
+ * @param agent Agent metadata and optional remote-profile visual id.
+ * @param defaultAvatarVisualId Optional metadata-resolved server default.
+ * @returns Supported avatar visual id.
+ *
+ * @private shared avatar contract
+ */
+export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOptions['agent'], defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
 /**
  * Resolve the fallback avatar URL for an agent.
  *

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

@@ -1,6 +1,6 @@
 import type { string_markdown } from '../../types/typeAliases';
 /**
- * Change dash-like characters to regular dashes `—` -> `-` and remove soft hyphens
+ * Change dash-like characters to regular dashes `-` -> `-` and remove soft hyphens
  *
  * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/markdown-utils",
-    "version": "0.112.0-54",
+    "version": "0.112.0-57",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-54';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-57';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -7970,7 +7970,7 @@
     // Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
     /**
-     * Change dash-like characters to regular dashes `—` -> `-` and remove soft hyphens
+     * Change dash-like characters to regular dashes `-` -> `-` and remove soft hyphens
      *
      * Note: [🔂] This function is idempotent.
      * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
@@ -7978,7 +7978,7 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function humanizeAiTextEmdashed(aiText) {
-        return aiText.replace(/\u00AD/g, '').replace(/[‐‑‒–—―−⁃﹣－]/g, '-');
+        return aiText.replace(/\u00AD/g, '').replace(/[‐‑‒–-―−⁃﹣－]/g, '-');
     }
     // Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 

package/umd/src/_packages/cli.index.d.ts

@@ -30,7 +30,12 @@ import { _PdfScraperRegistration } from '../scrapers/pdf/register-constructor';
 import { _PdfScraperMetadataRegistration } from '../scrapers/pdf/register-metadata';
 import { _WebsiteScraperRegistration } from '../scrapers/website/register-constructor';
 import { _WebsiteScraperMetadataRegistration } from '../scrapers/website/register-metadata';
+import { _AgentOsTranspilerRegistration } from '../transpilers/agent-os/register';
+import { _AnthropicClaudeManagedTranspilerRegistration } from '../transpilers/anthropic-claude-managed/register';
+import { _AnthropicClaudeSdkTranspilerRegistration } from '../transpilers/anthropic-claude-sdk/register';
+import { _E2BTranspilerRegistration } from '../transpilers/e2b/register';
 import { _FormattedBookInMarkdownTranspilerRegistration } from '../transpilers/formatted-book-in-markdown/register';
+import { _OpenAiAgentsTranspilerRegistration } from '../transpilers/openai-agents/register';
 import { _OpenAiSdkTranspilerRegistration } from '../transpilers/openai-sdk/register';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { _CLI };
@@ -64,5 +69,10 @@ export { _PdfScraperRegistration };
 export { _PdfScraperMetadataRegistration };
 export { _WebsiteScraperRegistration };
 export { _WebsiteScraperMetadataRegistration };
+export { _AgentOsTranspilerRegistration };
+export { _AnthropicClaudeManagedTranspilerRegistration };
+export { _AnthropicClaudeSdkTranspilerRegistration };
+export { _E2BTranspilerRegistration };
 export { _FormattedBookInMarkdownTranspilerRegistration };
+export { _OpenAiAgentsTranspilerRegistration };
 export { _OpenAiSdkTranspilerRegistration };

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

@@ -18,6 +18,7 @@ import { createPipelineCollectionFromPromise } from '../collection/pipeline-coll
 import { createPipelineCollectionFromUrl } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromUrl';
 import { createPipelineSubcollection } from '../collection/pipeline-collection/constructors/createPipelineSubcollection';
 import { pipelineCollectionToJson } from '../collection/pipeline-collection/pipelineCollectionToJson';
+import type { CommitmentDefinition } from '../commitments/_base/CommitmentDefinition';
 import { createEmptyAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
 import { createBasicAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
 import { NotYetImplementedCommitmentDefinition } from '../commitments/_base/NotYetImplementedCommitmentDefinition';
@@ -196,7 +197,12 @@ import { BlackholeStorage } from '../storage/blackhole/BlackholeStorage';
 import { MemoryStorage } from '../storage/memory/MemoryStorage';
 import { PrefixStorage } from '../storage/utils/PrefixStorage';
 import { $bookTranspilersRegister } from '../transpilers/_common/register/$bookTranspilersRegister';
+import { AgentOsTranspiler } from '../transpilers/agent-os/AgentOsTranspiler';
+import { AnthropicClaudeManagedTranspiler } from '../transpilers/anthropic-claude-managed/AnthropicClaudeManagedTranspiler';
+import { AnthropicClaudeSdkTranspiler } from '../transpilers/anthropic-claude-sdk/AnthropicClaudeSdkTranspiler';
+import { E2BTranspiler } from '../transpilers/e2b/E2BTranspiler';
 import { FormattedBookInMarkdownTranspiler } from '../transpilers/formatted-book-in-markdown/FormattedBookInMarkdownTranspiler';
+import { OpenAiAgentsTranspiler } from '../transpilers/openai-agents/OpenAiAgentsTranspiler';
 import { OpenAiSdkTranspiler } from '../transpilers/openai-sdk/OpenAiSdkTranspiler';
 import { MODEL_VARIANTS } from '../types/ModelVariant';
 import { NonTaskSectionTypes } from '../types/SectionType';
@@ -236,6 +242,7 @@ export { createPipelineCollectionFromPromise };
 export { createPipelineCollectionFromUrl };
 export { createPipelineSubcollection };
 export { pipelineCollectionToJson };
+export type { CommitmentDefinition };
 export { createEmptyAgentModelRequirements };
 export { createBasicAgentModelRequirements };
 export { NotYetImplementedCommitmentDefinition };
@@ -414,7 +421,12 @@ export { BlackholeStorage };
 export { MemoryStorage };
 export { PrefixStorage };
 export { $bookTranspilersRegister };
+export { AgentOsTranspiler };
+export { AnthropicClaudeManagedTranspiler };
+export { AnthropicClaudeSdkTranspiler };
+export { E2BTranspiler };
 export { FormattedBookInMarkdownTranspiler };
+export { OpenAiAgentsTranspiler };
 export { OpenAiSdkTranspiler };
 export { MODEL_VARIANTS };
 export { NonTaskSectionTypes };

package/umd/src/_packages/types.index.d.ts

@@ -222,6 +222,10 @@ import type { FileCacheStorageOptions } from '../storage/file-cache-storage/File
 import type { IndexedDbStorageOptions } from '../storage/local-storage/utils/IndexedDbStorageOptions';
 import type { BookTranspiler } from '../transpilers/_common/BookTranspiler';
 import type { BookTranspilerOptions } from '../transpilers/_common/BookTranspilerOptions';
+import type { TranspiledTeamAgentModelRequirements } from '../transpilers/_common/TranspiledTeamExport';
+import type { TranspiledTeamTeammate } from '../transpilers/_common/TranspiledTeamExport';
+import type { TranspiledTeamAgent } from '../transpilers/_common/TranspiledTeamExport';
+import type { TranspiledTeamExport } from '../transpilers/_common/TranspiledTeamExport';
 import type { IntermediateFilesStrategy } from '../types/IntermediateFilesStrategy';
 import type { LlmCall } from '../types/LlmCall';
 import type { LlmToolDefinition } from '../types/LlmToolDefinition';
@@ -651,6 +655,10 @@ export type { FileCacheStorageOptions };
 export type { IndexedDbStorageOptions };
 export type { BookTranspiler };
 export type { BookTranspilerOptions };
+export type { TranspiledTeamAgentModelRequirements };
+export type { TranspiledTeamTeammate };
+export type { TranspiledTeamAgent };
+export type { TranspiledTeamExport };
 export type { IntermediateFilesStrategy };
 export type { LlmCall };
 export type { LlmToolDefinition };

package/umd/src/_packages/wizard.index.d.ts

@@ -29,7 +29,12 @@ import { _PdfScraperRegistration } from '../scrapers/pdf/register-constructor';
 import { _PdfScraperMetadataRegistration } from '../scrapers/pdf/register-metadata';
 import { _WebsiteScraperRegistration } from '../scrapers/website/register-constructor';
 import { _WebsiteScraperMetadataRegistration } from '../scrapers/website/register-metadata';
+import { _AgentOsTranspilerRegistration } from '../transpilers/agent-os/register';
+import { _AnthropicClaudeManagedTranspilerRegistration } from '../transpilers/anthropic-claude-managed/register';
+import { _AnthropicClaudeSdkTranspilerRegistration } from '../transpilers/anthropic-claude-sdk/register';
+import { _E2BTranspilerRegistration } from '../transpilers/e2b/register';
 import { _FormattedBookInMarkdownTranspilerRegistration } from '../transpilers/formatted-book-in-markdown/register';
+import { _OpenAiAgentsTranspilerRegistration } from '../transpilers/openai-agents/register';
 import { _OpenAiSdkTranspilerRegistration } from '../transpilers/openai-sdk/register';
 import { wizard } from '../wizard/wizard';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
@@ -63,6 +68,11 @@ export { _PdfScraperRegistration };
 export { _PdfScraperMetadataRegistration };
 export { _WebsiteScraperRegistration };
 export { _WebsiteScraperMetadataRegistration };
+export { _AgentOsTranspilerRegistration };
+export { _AnthropicClaudeManagedTranspilerRegistration };
+export { _AnthropicClaudeSdkTranspilerRegistration };
+export { _E2BTranspilerRegistration };
 export { _FormattedBookInMarkdownTranspilerRegistration };
+export { _OpenAiAgentsTranspilerRegistration };
 export { _OpenAiSdkTranspilerRegistration };
 export { wizard };

package/umd/src/avatars/index.d.ts

@@ -2,6 +2,6 @@ export { Avatar } from './Avatar';
 export { AvatarOrImage } from './AvatarOrImage';
 export { renderAvatarVisual } from './renderAvatarVisual';
 export { createAvatarDefinitionFromAgentBasicInformation } from './avatarRenderingUtils';
-export { AVATAR_VISUALS, getAvatarVisualById } from './visuals/avatarVisualRegistry';
+export { AVATAR_VISUALS, getAvatarVisualById, resolveAvatarVisualId } from './visuals/avatarVisualRegistry';
 export type { AvatarDefinition } from './types/AvatarDefinition';
 export type { AvatarInteractionState, AvatarPalette, AvatarPointerType, AvatarProps, AvatarVisual, AvatarVisualDefinition, AvatarVisualId, AvatarVisualRenderContext, RenderAvatarVisualOptions, } from './types/AvatarVisualDefinition';

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

@@ -6,7 +6,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' | 'fractal';
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'fractal' | 'orb';
 /**
  * Derived color palette used by avatar visuals.
  *

package/umd/src/avatars/visuals/avatarVisualRegistry.d.ts

@@ -14,3 +14,15 @@ export declare const AVATAR_VISUALS: ReadonlyArray<AvatarVisualDefinition>;
  * @private shared registry for the avatar rendering system
  */
 export declare function getAvatarVisualById(visualId: AvatarVisualId): AvatarVisualDefinition;
+/**
+ * Resolves a user-facing avatar visual value to a supported built-in visual id.
+ *
+ * The lookup is derived from `AVATAR_VISUALS`, so new visuals become selectable by
+ * adding them to the registry rather than updating parser-specific option lists.
+ *
+ * @param value Raw visual id/title, for example `PIXEL_ART`, `pixel art`, or `pixel-art`.
+ * @returns Matching visual id or `null` when the value is empty/unknown.
+ *
+ * @private shared registry for the avatar rendering system
+ */
+export declare function resolveAvatarVisualId(value: string | null | undefined): AvatarVisualId | null;

package/umd/src/avatars/visuals/orbAvatarVisual.d.ts

@@ -0,0 +1,48 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Orb family labels used to keep the silhouette circle-based while still varying the rendering style.
+ *
+ * @private helper of `orbAvatarVisual`
+ */
+type OrbFamily = 'pearl' | 'nebula' | 'ember' | 'glacier';
+/**
+ * Deterministic orb profile used to keep the orb recognizable while still varying its motion and shape.
+ *
+ * @private helper of `orbAvatarVisual`
+ */
+type OrbMorphologyProfile = {
+    family: OrbFamily;
+    baseRadiusRatio: number;
+    horizontalStretch: number;
+    verticalStretch: number;
+    wobbleAmplitude: number;
+    wobbleFrequencyOne: number;
+    wobbleFrequencyTwo: number;
+    wobbleFrequencyThree: number;
+    ringCount: number;
+    sparkleCount: number;
+    haloCount: number;
+    coreShiftX: number;
+    coreShiftY: number;
+    highlightAngle: number;
+    bandRotation: number;
+    pulseSpeed: number;
+    haloBlurRatio: number;
+    sheenStrength: number;
+};
+/**
+ * Built-in Orb avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+export declare const orbAvatarVisual: AvatarVisualDefinition;
+/**
+ * Builds the deterministic orb profile from the seeded avatar random factory.
+ *
+ * @param createRandom Seeded random factory.
+ * @returns Stable orb morphology profile.
+ *
+ * @private helper of `orbAvatarVisual`
+ */
+export declare function createOrbMorphologyProfile(createRandom: (salt: string) => () => number): OrbMorphologyProfile;
+export {};

package/umd/src/avatars/visuals/orbAvatarVisual.test.d.ts

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

package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -1,4 +1,5 @@
 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';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @
@@ -87,6 +88,7 @@ export type AgentBasicInformation = {
         inputPlaceholder?: string;
         messageSuffix?: string;
         image?: string_url_image;
+        avatar?: AvatarVisualId;
         domain?: string;
         font?: string_fonts;
         color?: string_color;

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

@@ -0,0 +1,7 @@
+import { parseAgentSourceWithCommitments } from '../parseAgentSourceWithCommitments';
+/**
+ * Parsed agent source data produced by `parseAgentSourceWithCommitments`.
+ *
+ * @private internal type of `createAgentModelRequirementsWithCommitments`
+ */
+export type ParsedAgentSourceWithCommitments = ReturnType<typeof parseAgentSourceWithCommitments>;

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

@@ -0,0 +1,14 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../CreateAgentModelRequirementsOptions';
+/**
+ * Applies parsed commitments one by one while keeping the per-commitment steps focused and easy to follow.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param commitments - Commitments already filtered for DELETE-like invalidations.
+ * @param options - Optional reference and teammate resolvers.
+ * @returns Requirements after all applicable commitments are processed.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function applyCommitmentsToAgentModelRequirements(requirements: AgentModelRequirements, commitments: ReadonlyArray<ParsedCommitment>, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

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

@@ -0,0 +1,14 @@
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { string_book } from '../string_book';
+import type { ParsedAgentSourceWithCommitments } from './ParsedAgentSourceWithCommitments';
+/**
+ * Adds source-derived sections after commitments have been applied.
+ *
+ * @param requirements - Requirements after commitment application and USE aggregation.
+ * @param parseResult - Parsed source used to recover non-commitment prose and examples.
+ * @param agentSource - Original source used to recover MCP server declarations.
+ * @returns Requirements with source-derived sections appended.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function augmentAgentModelRequirementsFromSource(requirements: AgentModelRequirements, parseResult: ParsedAgentSourceWithCommitments, agentSource: string_book): Promise<AgentModelRequirements>;

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

@@ -0,0 +1,10 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Applies the commitment filtering rules used before commitment definitions are executed.
+ *
+ * @param commitments - Parsed commitments in original source order.
+ * @returns Commitments after DELETE-like invalidation and overwritten-goal filtering.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function filterCommitmentsForAgentModelRequirements(commitments: ReadonlyArray<ParsedCommitment>): ParsedCommitment[];

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

@@ -0,0 +1,12 @@
+import type { InlineKnowledgeSourceUploader } from '../../../utils/knowledge/inlineKnowledgeSource';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+/**
+ * Converts staged inline knowledge files into the final knowledge source URLs stored on requirements.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param uploader - Optional uploader for inline knowledge files.
+ * @returns Requirements with inline knowledge converted into upload URLs or data URLs.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function materializeInlineKnowledgeSources(requirements: AgentModelRequirements, uploader?: InlineKnowledgeSourceUploader): Promise<AgentModelRequirements>;

package/umd/src/book-2.0/agent-source/parseAgentSource/ParseAgentSourceState.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Mutable commitment-processing state used while collecting basic profile information.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParseAgentSourceState = ParsedAgentProfile & {
+    pendingUserMessage: string | null;
+    knownKnowledgeSourceUrls: Set<string>;
+};

package/umd/src/book-2.0/agent-source/parseAgentSource/ParsedAgentProfile.d.ts

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Parsed agent profile fields accumulated from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParsedAgentProfile = Pick<AgentBasicInformation, 'meta' | 'links' | 'capabilities' | 'samples' | 'knowledgeSources'>;

package/umd/src/book-2.0/agent-source/parseAgentSource/applyMetaCommitment.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Applies META-style commitments that mutate parsed profile metadata.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function applyMetaCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): void;

package/umd/src/book-2.0/agent-source/parseAgentSource/consumeConversationSampleCommitment.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Updates sample-conversation state for communication commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function consumeConversationSampleCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): boolean;

package/umd/src/book-2.0/agent-source/parseAgentSource/createCapabilitiesFromCommitment.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentCapability } from '../AgentBasicInformation';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Creates the visible capabilities produced by one parsed commitment.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function createCapabilitiesFromCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): AgentCapability[];

package/umd/src/book-2.0/agent-source/parseAgentSource/ensureMetaFullname.d.ts

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Ensures the parsed profile always exposes a fullname value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function ensureMetaFullname(meta: AgentBasicInformation['meta'], fallbackFullname: string): void;