@promptbook/node 0.112.0-54 → 0.112.0-56

package/esm/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/esm/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/esm/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/esm/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/esm/src/commitments/index.test.d.ts

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

package/esm/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/esm/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/esm/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/esm/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/esm/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;
 };

package/esm/src/transpilers/_common/TranspiledTeamExport.d.ts

@@ -0,0 +1,80 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { PseudoAgentKind } from '../../book-2.0/agent-source/pseudoAgentReferences';
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Model-requirement fields embedded for one built-in teammate in transpiled code.
+ */
+export type TranspiledTeamAgentModelRequirements = Pick<AgentModelRequirements, 'systemMessage' | 'promptSuffix' | 'modelName' | 'temperature' | 'topP' | 'topK' | 'knowledgeSources' | 'samples'> & {
+    /**
+     * Tool definitions visible to this built-in teammate.
+     */
+    readonly tools: ReadonlyArray<LlmToolDefinition>;
+};
+/**
+ * One TEAM edge embedded into transpiled code.
+ */
+export type TranspiledTeamTeammate = {
+    /**
+     * Canonical teammate URL.
+     */
+    readonly url: string;
+    /**
+     * Human-readable teammate label.
+     */
+    readonly label: string;
+    /**
+     * Tool name used by the owning agent to consult this teammate.
+     */
+    readonly toolName: string;
+    /**
+     * Optional instructions from the TEAM commitment.
+     */
+    readonly instructions?: string;
+    /**
+     * Pseudo-agent kind for `{User}` and `{Void}` teammates.
+     */
+    readonly pseudoAgentKind?: PseudoAgentKind;
+};
+/**
+ * One agent node embedded into a transpiled TEAM hierarchy.
+ */
+export type TranspiledTeamAgent = {
+    /**
+     * Canonical URL used as the stable team-member identifier.
+     */
+    readonly url: string;
+    /**
+     * Human-readable agent name.
+     */
+    readonly agentName: string;
+    /**
+     * Resolved Book source for this agent.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Compiled model requirements used by the exported harness.
+     */
+    readonly modelRequirements: TranspiledTeamAgentModelRequirements;
+    /**
+     * Teammates directly available to this agent.
+     */
+    readonly teammates: ReadonlyArray<TranspiledTeamTeammate>;
+    /**
+     * Marks the root exported agent in the hierarchy.
+     */
+    readonly isRootAgent?: boolean;
+};
+/**
+ * Full built-in TEAM hierarchy embedded into transpiled code.
+ */
+export type TranspiledTeamExport = {
+    /**
+     * Canonical URL of the root exported agent.
+     */
+    readonly rootAgentUrl: string;
+    /**
+     * Root agent and all reachable teammates.
+     */
+    readonly agents: ReadonlyArray<TranspiledTeamAgent>;
+};

package/esm/src/transpilers/_common/createTranspiledTeamRuntimeSection.d.ts

@@ -0,0 +1,55 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { TranspiledTeamAgentModelRequirements, TranspiledTeamExport, TranspiledTeamTeammate } from './TranspiledTeamExport';
+/**
+ * Creates the full transpiled TEAM export used by generated harnesses.
+ *
+ * @param options - Root source, compiled requirements, and optional server-resolved hierarchy.
+ * @returns Normalized team export, or `null` when no TEAM tools are present.
+ *
+ * @private shared between transpilers
+ */
+export declare function createTranspiledTeamExportForContext(options: {
+    readonly agentName: string;
+    readonly agentSource: string_book;
+    readonly modelRequirements: AgentModelRequirements;
+    readonly transpiledTeam?: TranspiledTeamExport;
+}): TranspiledTeamExport | null;
+/**
+ * Extracts serializable TEAM teammate metadata from model requirements.
+ *
+ * @param modelRequirements - Compiled agent requirements with TEAM metadata.
+ * @returns Teammates safe to embed in transpiled code.
+ *
+ * @private shared between transpilers
+ */
+export declare function extractTranspiledTeamTeammates(modelRequirements: AgentModelRequirements): ReadonlyArray<TranspiledTeamTeammate>;
+/**
+ * Creates the serializable model-requirement subset embedded for each built-in teammate.
+ *
+ * @param modelRequirements - Full compiled model requirements.
+ * @returns Minimal model requirements needed by transpiled TEAM helpers.
+ *
+ * @private shared between transpilers
+ */
+export declare function createTranspiledTeamAgentModelRequirements(modelRequirements: AgentModelRequirements): TranspiledTeamAgentModelRequirements;
+/**
+ * Replaces TEAM tool closures with self-contained transpiled TEAM tool functions.
+ *
+ * @param usedToolFunctions - Tool implementation sources collected from commitment definitions.
+ * @param transpiledTeam - Built-in team hierarchy prepared for the generated harness.
+ * @returns Tool implementations with TEAM tools pointing to the reusable runtime helper.
+ *
+ * @private shared between transpilers
+ */
+export declare function createTranspiledTeamAwareToolFunctions(usedToolFunctions: Record<string_javascript_name, string>, transpiledTeam: TranspiledTeamExport | null): Record<string_javascript_name, string>;
+/**
+ * Creates the reusable JavaScript TEAM runtime block embedded into generated harnesses.
+ *
+ * @param transpiledTeam - Built-in team hierarchy prepared for the generated harness.
+ * @returns JavaScript source, or an empty string when there is no TEAM hierarchy.
+ *
+ * @private shared between transpilers
+ */
+export declare function createTranspiledTeamRuntimeSection(transpiledTeam: TranspiledTeamExport | null): string;

package/esm/src/transpilers/_common/createZodSchemaSource.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Formats a JSON-schema fragment into a Zod expression for generated transpiled code.
+ *
+ * The Claude Code and AgentOS transpilers both need the same JSON-schema-to-Zod conversion,
+ * but Claude Code needs raw Zod shapes while AgentOS needs wrapped `z.object(...)` schemas.
+ *
+ * @param schema - JSON-schema fragment used for one tool input definition.
+ * @returns Zod expression source ready to embed in generated JavaScript.
+ *
+ * @private shared between Claude and AgentOS transpilers
+ */
+export declare function createZodSchemaSource(schema: JsonSchemaLike): string;
+/**
+ * Formats a JSON-schema fragment into a raw Zod shape object literal.
+ *
+ * Claude Code SDK custom tools expect a Zod raw shape instead of a wrapped `z.object(...)`
+ * expression, so this helper reuses the same conversion logic but returns only the object literal
+ * body.
+ *
+ * @param schema - JSON-schema fragment used for one tool input definition.
+ * @returns Raw Zod shape source ready to embed in `tool(...)`.
+ *
+ * @private shared between Claude and AgentOS transpilers
+ */
+export declare function createZodShapeSource(schema: JsonSchemaLike): string;
+/**
+ * Minimal JSON-schema shape used by the transpiled Claude and AgentOS harness generators.
+ *
+ * @private shared between Claude and AgentOS transpilers
+ */
+type JsonSchemaLike = {
+    readonly type?: string;
+    readonly description?: string;
+    readonly properties?: Record<string, JsonSchemaLike>;
+    readonly required?: ReadonlyArray<string>;
+    readonly items?: JsonSchemaLike;
+    readonly enum?: ReadonlyArray<string | number | boolean | null>;
+    readonly additionalProperties?: boolean;
+};
+export {};

package/esm/src/transpilers/_common/formatUsedToolFunctions.d.ts

@@ -0,0 +1,18 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+/**
+ * Formats used tool functions into object-literal method syntax for generated SDK harnesses.
+ *
+ * Tool implementations are authored in several shapes across the repository:
+ * - object-literal methods
+ * - function declarations
+ * - arrow functions
+ *
+ * This helper normalizes all supported shapes into valid object members so the
+ * transpiled `tools` block stays syntactically correct.
+ *
+ * @param usedToolFunctions - Tool function sources indexed by tool name.
+ * @returns Object-member definitions ready to embed inside a transpiled `const tools = { ... }` block.
+ *
+ * @private shared between SDK transpilers
+ */
+export declare function formatUsedToolFunctions(usedToolFunctions: Record<string_javascript_name, string>): string;

package/esm/src/transpilers/_common/formatUsedToolFunctions.test.d.ts

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

package/esm/src/transpilers/_common/prepareSdkTranspilerContext.d.ts

@@ -0,0 +1,48 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { BookTranspilerOptions } from './BookTranspilerOptions';
+import type { TranspiledTeamExport } from './TranspiledTeamExport';
+/**
+ * Parsed data shared by SDK-oriented transpilers.
+ *
+ * @private shared between SDK transpilers
+ */
+export type PreparedSdkTranspilerContext = {
+    /**
+     * Parsed agent name used in the generated CLI harness.
+     */
+    readonly agentName: string;
+    /**
+     * Fully compiled model requirements generated from the Book source.
+     */
+    readonly modelRequirements: AgentModelRequirements;
+    /**
+     * Inline knowledge snippets embedded directly into the generated harness.
+     */
+    readonly directKnowledge: Array<string>;
+    /**
+     * Remote or file-based knowledge sources loaded by the generated harness at runtime.
+     */
+    readonly knowledgeSources: Array<string>;
+    /**
+     * Tool implementations extracted from commitment definitions and embedded into the harness.
+     */
+    readonly usedToolFunctions: Record<string, string>;
+    /**
+     * Whether the transpiler should emit the retrieval-augmented scaffold.
+     */
+    readonly isKnowledgeHandledWithRetrieval: boolean;
+    /**
+     * Built-in TEAM hierarchy embedded into the generated harness.
+     */
+    readonly transpiledTeam: TranspiledTeamExport | null;
+};
+/**
+ * Prepares the common parsed context reused by JavaScript SDK transpilers.
+ *
+ * @param book - Agent Book source being transpiled.
+ * @param options - Optional transpiler hooks such as reference resolvers and built-in TEAM data.
+ * @returns Shared transpiler context derived from the Book.
+ * @private shared between SDK transpilers
+ */
+export declare function prepareSdkTranspilerContext(book: string_book, options?: BookTranspilerOptions): Promise<PreparedSdkTranspilerContext>;

package/esm/src/transpilers/_common/resolveClaudeModelName.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves a Claude model name compatible with generated Claude-based harnesses.
+ *
+ * The Promptbook Book can still specify a non-Claude model, but Claude-based transpilers
+ * need a Claude-compatible default so the generated harness remains runnable.
+ *
+ * @param modelName - Model requested by the Book source.
+ * @returns Claude-compatible model name for the generated export.
+ *
+ * @private shared between Claude transpilers
+ */
+export declare function resolveClaudeModelName(modelName?: string): string;

package/esm/src/transpilers/_common/transpiledTeamTranspilers.test.d.ts

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

package/esm/src/transpilers/agent-os/AgentOsTranspiler.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 AgentOS.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AgentOsTranspiler: {
+    readonly name: "agent-os";
+    readonly title: "AgentOS";
+    readonly packageName: "@promptbook/core";
+    readonly className: "AgentOsTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

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;