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

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the public agent profile text from the last GOAL/GOALS commitment,
+ * falling back to the deprecated PERSONA/PERSONAE commitments when no goal exists.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractAgentProfileText(commitments: ReadonlyArray<ParsedCommitment>): string | null;

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

@@ -0,0 +1,7 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the last INITIAL MESSAGE commitment, which is the public initial-message value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractInitialMessage(commitments: ReadonlyArray<ParsedCommitment>): string | null;

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Collects capability, sample, meta, link, and knowledge-source data from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractParsedAgentProfile(commitments: ReadonlyArray<ParsedCommitment>): ParsedAgentProfile;

package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.use.test.d.ts

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

package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.d.ts

@@ -1,10 +1,10 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 /**
- * Monaco diagnostic shape used by deprecated-commitment warnings.
+ * Monaco diagnostic shape used by deprecated, unfinished, and low-level commitment warnings.
  *
  * @private internal type of `BookEditorMonaco`
  */
-type DeprecatedCommitmentDiagnostic = {
+type CommitmentNoticeDiagnostic = {
     readonly startLineNumber: number;
     readonly startColumn: number;
     readonly endLineNumber: number;
@@ -14,16 +14,17 @@ type DeprecatedCommitmentDiagnostic = {
     readonly severity: 'warning';
 };
 /**
- * Creates Book editor diagnostics for deprecated commitment keywords.
+ * Creates Book editor diagnostics for deprecated, unfinished, and low-level commitment keywords.
  *
- * The deprecation metadata is UI-only. This helper surfaces it in Monaco so
- * legacy commitments remain functional while still guiding authors toward
- * preferred replacements.
+ * The notice metadata is UI-only. This helper surfaces it in Monaco so legacy,
+ * unfinished, and low-level commitments remain functional while still guiding
+ * authors toward preferred replacements or cautioning them about low-level
+ * usage.
  *
  * @param agentSource - Current editor content.
- * @returns Warning markers for deprecated commitment keywords.
+ * @returns Warning markers for deprecated, unfinished, and low-level commitment keywords.
  *
  * @private internal utility of `BookEditorMonaco`
  */
-export declare function createDeprecatedCommitmentDiagnostics(agentSource?: string_book): ReadonlyArray<DeprecatedCommitmentDiagnostic>;
+export declare function createDeprecatedCommitmentDiagnostics(agentSource?: string_book): ReadonlyArray<CommitmentNoticeDiagnostic>;
 export {};

package/umd/src/commitments/ACTION/ACTION.d.ts

@@ -3,8 +3,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * ACTION commitment definition
  *
- * The ACTION commitment defines specific actions or capabilities that the agent can perform.
- * This helps define what the agent is capable of doing and how it should approach tasks.
+ * Deprecated legacy commitment for broad capability notes.
+ * New books should prefer the appropriate `USE*` commitment instead.
  *
  * Example usage in agent source:
  *
@@ -21,6 +21,12 @@ export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition
      * Short one-line description of ACTION.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use a concrete `USE*` commitment instead.";
+    };
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/ACTION/ACTION.test.d.ts

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

package/umd/src/commitments/DELETE/DELETE.d.ts

@@ -3,9 +3,9 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * DELETE commitment definition
  *
- * The DELETE commitment (and its aliases CANCEL, DISCARD, REMOVE) is used to
- * remove or disregard certain information or context. This can be useful for
- * overriding previous commitments or removing unwanted behaviors.
+ * The DELETE commitment (and its aliases CANCEL, DISCARD, REMOVE) is a low-level
+ * unfinished commitment used to remove or disregard certain information or context.
+ * It is intentionally surfaced with caution because it is not ready for broad use yet.
  *
  * Example usage in agent source:
  *
@@ -24,6 +24,10 @@ export declare class DeleteCommitmentDefinition extends BaseCommitmentDefinition
      * Short one-line description of DELETE/CANCEL/DISCARD/REMOVE.
      */
     get description(): string;
+    /**
+     * Marks DELETE as unfinished and not ready to use.
+     */
+    get isUnfinished(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/DELETE/DELETE.test.d.ts

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

package/umd/src/commitments/FORMAT/FORMAT.d.ts

@@ -3,11 +3,10 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * FORMAT commitment definition
  *
- * The FORMAT commitment defines the specific output structure and formatting
- * that the agent should use in its responses. This includes data formats,
- * response templates, and structural requirements.
+ * Deprecated legacy commitment for output formatting and response structure.
+ * New books should prefer `WRITING SAMPLE` and `WRITING RULES`.
  *
- * Example usage in agent source:
+ * Legacy example usage in agent source:
  *
  * ```book
  * FORMAT Always respond in JSON format with 'status' and 'data' fields
@@ -22,6 +21,13 @@ export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition
      * Short one-line description of FORMAT.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `WRITING SAMPLE` and `WRITING RULES` instead.";
+        readonly replacedBy: readonly ["WRITING SAMPLE", "WRITING RULES"];
+    };
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/FORMAT/FORMAT.test.d.ts

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

package/umd/src/commitments/GOAL/GOAL.d.ts

@@ -22,6 +22,10 @@ export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'
      * Short one-line description of GOAL.
      */
     get description(): string;
+    /**
+     * Marks GOAL as one of the priority commitments surfaced first in catalogues.
+     */
+    get isImportant(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -24,6 +24,10 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      * Short one-line description of KNOWLEDGE.
      */
     get description(): string;
+    /**
+     * Marks KNOWLEDGE as one of the priority commitments surfaced first in catalogues.
+     */
+    get isImportant(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/META/META.d.ts

@@ -4,6 +4,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * META commitment definition
  *
  * The META commitment handles all meta-information about the agent such as:
+ * - META AVATAR: Sets the agent's built-in default avatar visual
  * - META IMAGE: Sets the agent's avatar/profile image URL
  * - META LINK: Provides profile/source links for the person the agent models
  * - META DOMAIN: Sets the canonical custom domain/host of the agent
@@ -18,6 +19,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * Example usage in agent source:
  *
  * ```book
+ * META AVATAR pixel-art
  * META IMAGE https://example.com/avatar.jpg
  * META LINK https://twitter.com/username
  * META DOMAIN my-agent.com

package/umd/src/commitments/META_AVATAR/META_AVATAR.d.ts

@@ -0,0 +1,26 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META AVATAR commitment definition
+ *
+ * The `META AVATAR` commitment sets the built-in default avatar visual used when
+ * the agent does not provide an explicit `META IMAGE`.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaAvatarCommitmentDefinition extends BaseCommitmentDefinition<'META AVATAR'> {
+    constructor();
+    /**
+     * Short one-line description of META AVATAR.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META AVATAR commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

package/umd/src/commitments/MODEL/MODEL.d.ts

@@ -31,6 +31,10 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
      * Short one-line description of MODEL.
      */
     get description(): string;
+    /**
+     * Marks MODEL as a low-level commitment surfaced with caution.
+     */
+    get isLowLevel(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/MODEL/MODEL.test.d.ts

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

package/umd/src/commitments/RULE/RULE.d.ts

@@ -21,6 +21,10 @@ export declare class RuleCommitmentDefinition extends BaseCommitmentDefinition<'
      * Short one-line description of RULE/RULES.
      */
     get description(): string;
+    /**
+     * Marks RULE as one of the priority commitments surfaced first in catalogues.
+     */
+    get isImportant(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/TEAM/TEAM.d.ts

@@ -22,6 +22,10 @@ export declare class TeamCommitmentDefinition extends BaseCommitmentDefinition<'
      * Short one-line description of TEAM.
      */
     get description(): string;
+    /**
+     * Marks TEAM as one of the priority commitments surfaced first in catalogues.
+     */
+    get isImportant(): boolean;
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/TEMPLATE/TEMPLATE.d.ts

@@ -3,11 +3,10 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * TEMPLATE commitment definition
  *
- * The TEMPLATE commitment enforces a specific response structure or template
- * that the agent must follow when generating responses. This helps ensure
- * consistent message formatting across all agent interactions.
+ * Deprecated legacy commitment for response templates and output structure.
+ * New books should prefer `WRITING SAMPLE` and `WRITING RULES`.
  *
- * Example usage in agent source:
+ * Legacy example usage in agent source:
  *
  * ```book
  * TEMPLATE Always structure your response with: 1) Summary, 2) Details, 3) Next steps
@@ -25,6 +24,13 @@ export declare class TemplateCommitmentDefinition extends BaseCommitmentDefiniti
      * Short one-line description of TEMPLATE.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `WRITING SAMPLE` and `WRITING RULES` instead.";
+        readonly replacedBy: readonly ["WRITING SAMPLE", "WRITING RULES"];
+    };
     /**
      * Icon for this commitment.
      */

package/umd/src/commitments/_base/BaseCommitmentDefinition.d.ts

@@ -28,6 +28,18 @@ export declare abstract class BaseCommitmentDefinition<TBookCommitment extends s
      * It should be a single emoji.
      */
     abstract get icon(): string;
+    /**
+     * Whether this commitment should be prioritized in menus, documentation, and intellisense.
+     */
+    get isImportant(): boolean;
+    /**
+     * Whether this commitment is unfinished and not ready to use.
+     */
+    get isUnfinished(): boolean;
+    /**
+     * Whether this commitment is low-level and should be surfaced with caution.
+     */
+    get isLowLevel(): boolean;
     /**
      * Human-readable markdown documentation for this commitment, available at runtime.
      * Must be implemented by each concrete commitment.

package/umd/src/commitments/_base/CommitmentDefinition.d.ts

@@ -17,11 +17,13 @@ type CommitmentDeprecation = {
     readonly replacedBy?: ReadonlyArray<string>;
 };
 /**
- * Definition of a commitment that can be applied to agent model requirements
+ * Definition of a commitment that can be applied to agent model requirements.
  *
  * Each commitment is self-contained and manages its own logic for:
  * - Creating regex patterns for parsing
  * - Applying its effects to agent model requirements
+ *
+ * @public exported from `@promptbook/core`
  */
 export type CommitmentDefinition = {
     /**
@@ -38,6 +40,24 @@ export type CommitmentDefinition = {
      * It should be a single emoji.
      */
     readonly icon: string;
+    /**
+     * Whether this commitment should be prioritized in menus, documentation, and intellisense.
+     */
+    readonly isImportant: boolean;
+    /**
+     * Whether this commitment is unfinished and not ready to use.
+     *
+     * Unfinished commitments are surfaced with low-level caution in the UI,
+     * documentation, and editor diagnostics.
+     */
+    readonly isUnfinished: boolean;
+    /**
+     * Whether this commitment is low-level and should be surfaced with caution.
+     *
+     * Low-level commitments are fully implemented, but they are intended for
+     * advanced use and are not used by most users.
+     */
+    readonly isLowLevel: boolean;
     /**
      * Human-readable markdown documentation for this commitment.
      * Should explain what the commitment does and include example usage.

package/umd/src/commitments/_common/getAllCommitmentDefinitions.test.d.ts

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

package/umd/src/commitments/_common/getCommitmentNoticeMetadata.d.ts

@@ -0,0 +1,51 @@
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Type of commitment notice surfaced in docs and editor UI.
+ *
+ * @private internal type of commitment catalog presentation
+ */
+export type CommitmentNoticeMetadata = {
+    /**
+     * Machine-readable notice kind.
+     */
+    readonly kind: 'deprecated' | 'unfinished' | 'lowLevel';
+    /**
+     * Short badge label shown in documentation and menus.
+     */
+    readonly badgeLabel: string;
+    /**
+     * Longer label used in documentation bodies and editor details.
+     */
+    readonly detailLabel: string;
+    /**
+     * Human-readable notice message shown in editor and documentation callouts.
+     */
+    readonly message: string;
+};
+/**
+ * Formats preferred replacement guidance for deprecated commitments.
+ *
+ * @param replacedBy - Preferred replacement commitment keywords.
+ * @returns Optional replacement guidance sentence with leading space.
+ *
+ * @private internal utility of commitment catalog notices
+ */
+export declare function formatCommitmentReplacementText(replacedBy?: ReadonlyArray<string>): string;
+/**
+ * Returns true when one commitment notice should be rendered with low-visibility styling.
+ *
+ * @param notice - Commitment notice metadata or null.
+ * @returns True for unfinished and low-level notices.
+ *
+ * @private internal utility of commitment catalog notices
+ */
+export declare function isLowVisibilityCommitmentNotice(notice: CommitmentNoticeMetadata | null): boolean;
+/**
+ * Resolves the notice metadata for deprecated, unfinished, or low-level commitments.
+ *
+ * @param definition - Commitment definition to inspect.
+ * @returns Notice metadata when the commitment should be surfaced with caution.
+ *
+ * @private internal utility of commitment catalog notices
+ */
+export declare function getCommitmentNoticeMetadata(definition: Pick<CommitmentDefinition, 'deprecation'> & Partial<Pick<CommitmentDefinition, 'isUnfinished' | 'isLowLevel'>>): CommitmentNoticeMetadata | null;

package/umd/src/commitments/_common/getCommitmentNoticeMetadata.test.d.ts

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

package/umd/src/commitments/_common/getGroupedCommitmentDefinitions.openClosed.test.d.ts

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

package/umd/src/commitments/_common/getGroupedCommitmentDefinitions.order.test.d.ts

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

package/umd/src/commitments/_common/getGroupedCommitmentDefinitions.use.test.d.ts

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

package/umd/src/commitments/_common/sortCommitmentDefinitions.d.ts

@@ -0,0 +1,31 @@
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Sorting options for commitment definitions.
+ *
+ * @private internal helper of commitment catalog sorting
+ */
+type CommitmentDefinitionSortOptions = {
+    /**
+     * When enabled, deprecated commitments are moved behind all non-deprecated commitments.
+     */
+    readonly isDeprecatedLast?: boolean;
+    /**
+     * When enabled, unfinished commitments are moved behind all other commitments.
+     */
+    readonly isUnfinishedLast?: boolean;
+    /**
+     * When enabled, low-level commitments are moved behind all other commitments.
+     */
+    readonly isLowLevelLast?: boolean;
+};
+/**
+ * Sorts commitment definitions so the important ones stay at the top.
+ *
+ * @param commitmentDefinitions - Definitions to sort.
+ * @param options - Sorting options.
+ * @returns Sorted commitment definitions.
+ *
+ * @private internal helper of commitment catalog sorting
+ */
+export declare function sortCommitmentDefinitions<TCommitmentDefinition extends CommitmentDefinition>(commitmentDefinitions: ReadonlyArray<TCommitmentDefinition>, options?: CommitmentDefinitionSortOptions): ReadonlyArray<TCommitmentDefinition>;
+export {};

package/umd/src/commitments/_common/teamInternalAgentAccess.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Header used for same-server TEAM calls that may access private teammate agents.
+ *
+ * @private internal Agents Server access wiring
+ */
+export declare const TEAM_INTERNAL_AGENT_ACCESS_HEADER = "x-promptbook-team-agent-access-token";
+/**
+ * Options for creating same-server TEAM access headers.
+ *
+ * @private internal Agents Server access wiring
+ */
+export type TeamInternalAgentAccessHeadersOptions = {
+    /**
+     * URL of the teammate agent that is about to be contacted.
+     */
+    readonly agentUrl: string;
+    /**
+     * Origin of the current Agents Server.
+     */
+    readonly localServerUrl?: string;
+    /**
+     * Resolved internal access token carried by the runtime context.
+     */
+    readonly accessToken?: string | null;
+};
+/**
+ * Resolves the internal token used by same-server TEAM calls.
+ *
+ * @returns Hashed token, or `null` when the server does not have a private secret.
+ *
+ * @private internal Agents Server access wiring
+ */
+export declare function resolveTeamInternalAgentAccessToken(): string | null;
+/**
+ * Creates request headers for same-server TEAM calls.
+ *
+ * @param options - Target agent URL, local server URL, and resolved access token.
+ * @returns Header map when the target is same-origin; otherwise an empty map.
+ *
+ * @private internal Agents Server access wiring
+ */
+export declare function createTeamInternalAgentAccessHeaders(options: TeamInternalAgentAccessHeadersOptions): Record<string, string>;
+/**
+ * Checks whether an incoming header carries the current same-server TEAM access token.
+ *
+ * @param value - Raw request header value.
+ * @returns `true` only when the server has a private token and the value matches it.
+ *
+ * @private internal Agents Server access wiring
+ */
+export declare function isTeamInternalAgentAccessToken(value: string | null | undefined): boolean;

package/umd/src/commitments/_common/toolRuntimeContext.d.ts

@@ -94,6 +94,10 @@ export type ToolRuntimeContext = {
             scopes?: string[];
         }>;
     };
+    agentsServer?: {
+        localServerUrl?: string;
+        teamInternalAccessToken?: string;
+    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

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

@@ -17,6 +17,7 @@ import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
 import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitmentDefinition';
 import { MessageSuffixCommitmentDefinition } from './MESSAGE_SUFFIX/MESSAGE_SUFFIX';
 import { MetaCommitmentDefinition } from './META/META';
+import { MetaAvatarCommitmentDefinition } from './META_AVATAR/META_AVATAR';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
 import { MetaDomainCommitmentDefinition } from './META_DOMAIN/META_DOMAIN';
 import { MetaDisclaimerCommitmentDefinition } from './META_DISCLAIMER/META_DISCLAIMER';
@@ -35,7 +36,6 @@ import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { TeamCommitmentDefinition } from './TEAM/TEAM';
 import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
-import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
 import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
 import { UseDeepSearchCommitmentDefinition } from './USE_DEEPSEARCH/USE_DEEPSEARCH';
@@ -60,4 +60,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/umd/src/commitments/index.test.d.ts

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

package/umd/src/llm-providers/agent/Agent.d.ts

@@ -5,6 +5,7 @@ import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execut
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_agent_hash, string_agent_name, string_agent_url, string_color, string_fonts, string_url_image } from '../../types/typeAliases';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
 import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
 import type { AgentOptions } from './AgentOptions';
 /**
@@ -69,6 +70,7 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
     meta: {
         fullname?: string;
         image?: string_url_image;
+        avatar?: AvatarVisualId;
         link?: string;
         font?: string_fonts;
         color?: string_color;

package/umd/src/llm-providers/agent/RemoteAgent.d.ts

@@ -24,6 +24,7 @@ export declare class RemoteAgent extends Agent {
      * The source of the agent
      */
     private agentUrl;
+    private requestHeaders;
     private _remoteAgentName;
     private _remoteAgentHash;
     toolTitles: Record<string, string>;

package/umd/src/llm-providers/agent/RemoteAgentOptions.d.ts

@@ -8,4 +8,8 @@ export type RemoteAgentOptions = Omit<CommonToolsOptions, 'teacherAgent'> & {
      * Url of the remote agent
      */
     agentUrl: string_agent_url;
+    /**
+     * Additional HTTP headers sent to the remote agent profile, chat, and voice endpoints.
+     */
+    requestHeaders?: Record<string, string>;
 };

package/umd/src/playground/playground.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env ts-node
 export {};
+/** Note: [⚫] Code for archived playground [_playground-boilerplate.ts](src/playground/backup/_playground-boilerplate.ts.txt) should never be published in any package */

package/umd/src/transpilers/_common/BookTranspilerOptions.d.ts

@@ -1,4 +1,8 @@
+import type { AgentReferenceResolver } from '../../book-2.0/agent-source/AgentReferenceResolver';
+import type { TeammateProfileResolver } from '../../book-2.0/agent-source/TeammateProfileResolver';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { InlineKnowledgeSourceUploader } from '../../utils/knowledge/inlineKnowledgeSource';
+import type { TranspiledTeamExport } from './TranspiledTeamExport';
 /**
  * Options for the BookTranspiler.
  */
@@ -15,4 +19,20 @@ export type BookTranspilerOptions = Omit<CommonToolsOptions, 'maxRequestsPerMinu
      * @default true
      */
     readonly shouldIncludeComments?: boolean;
+    /**
+     * Resolver that transforms compact agent references into concrete URLs before transpilation.
+     */
+    readonly agentReferenceResolver?: AgentReferenceResolver;
+    /**
+     * Optional hook used to upload inline knowledge files before finalizing transpiled model requirements.
+     */
+    readonly inlineKnowledgeSourceUploader?: InlineKnowledgeSourceUploader;
+    /**
+     * Optional resolver that provides actual agent names and descriptions for teammate URLs.
+     */
+    readonly teammateProfileResolver?: TeammateProfileResolver;
+    /**
+     * Built-in TEAM hierarchy resolved by Agents Server for self-contained transpiled exports.
+     */
+    readonly transpiledTeam?: TranspiledTeamExport;
 };