@promptbook/javascript 0.111.0-7 → 0.112.0-11

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

@@ -1,4 +1,6 @@
 import { TODO_any } from '../../_packages/types.index';
+import type { ToolCallLogEntry, ToolCallState } from '../../types/ToolCall';
+import type { ChatAttachment } from '../../utils/chat/chatAttachments';
 /**
  * Prompt parameter key used to pass hidden runtime context to tool execution.
  *
@@ -11,6 +13,39 @@ export declare const TOOL_RUNTIME_CONTEXT_PARAMETER = "promptbookToolRuntimeCont
  * @private internal runtime wiring for commitment tools
  */
 export declare const TOOL_RUNTIME_CONTEXT_ARGUMENT = "__promptbookToolRuntimeContext";
+/**
+ * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare const TOOL_PROGRESS_TOKEN_PARAMETER = "promptbookToolProgressToken";
+/**
+ * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare const TOOL_PROGRESS_TOKEN_ARGUMENT = "__promptbookToolProgressToken";
+/**
+ * Incremental tool execution update emitted from long-running tools.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export type ToolCallProgressUpdate = {
+    /**
+     * Optional state override associated with this update.
+     */
+    readonly state?: ToolCallState;
+    /**
+     * Optional incremental log entry appended to the tool-call stream.
+     */
+    readonly log?: ToolCallLogEntry;
+};
+/**
+ * Listener notified when one long-running tool emits a progress update.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+type ToolCallProgressListener = (update: ToolCallProgressUpdate) => void;
 /**
  * User geolocation payload shared with tools through hidden runtime context.
  *
@@ -42,6 +77,27 @@ export type ToolRuntimeContext = {
         isPrivateMode?: boolean;
     };
     userLocation?: UserLocationRuntimeContext;
+    projects?: {
+        githubToken?: string;
+        repositories?: string[];
+    };
+    email?: {
+        smtpCredential?: string;
+        fromAddress?: string;
+    };
+    spawn?: {
+        depth?: number;
+        parentRunId?: string;
+        parentAgentId?: string;
+    };
+    chat?: {
+        chatId?: string;
+        userId?: number;
+        agentId?: string;
+        agentName?: string;
+        parameters?: Record<string, string>;
+        attachments?: ReadonlyArray<ChatAttachment>;
+    };
 };
 /**
  * Parses unknown runtime context payload into a normalized object.
@@ -55,12 +111,46 @@ export declare function parseToolRuntimeContext(rawValue: unknown): ToolRuntimeC
  * @private internal runtime wiring for commitment tools
  */
 export declare function readToolRuntimeContextFromToolArgs(args: Record<string, TODO_any>): ToolRuntimeContext | null;
+/**
+ * Reads the hidden tool-progress token from tool arguments.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function readToolProgressTokenFromToolArgs(args: Record<string, TODO_any>): string | null;
 /**
  * Serializes runtime context for prompt parameters.
  *
  * @private internal runtime wiring for commitment tools
  */
 export declare function serializeToolRuntimeContext(context: ToolRuntimeContext): string;
+/**
+ * Registers one in-memory listener that receives progress updates emitted by a running tool.
+ *
+ * The returned token is passed into script execution as a hidden argument so tool implementations
+ * can stream progress without exposing extra parameters to the model.
+ *
+ * @param listener - Listener notified about tool progress.
+ * @returns Hidden token used to route progress updates.
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function registerToolCallProgressListener(listener: ToolCallProgressListener): string;
+/**
+ * Unregisters one in-memory progress listener.
+ *
+ * @param token - Token previously created by `registerToolCallProgressListener`.
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function unregisterToolCallProgressListener(token: string): void;
+/**
+ * Emits one tool progress update using a hidden token carried in tool arguments.
+ *
+ * @param args - Raw tool arguments including hidden runtime keys.
+ * @param update - Incremental progress update.
+ * @returns `true` when a listener was found and notified.
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function emitToolCallProgressFromToolArgs(args: Record<string, TODO_any>, update: ToolCallProgressUpdate): boolean;
+export {};
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -12,15 +12,19 @@ import { LanguageCommitmentDefinition } from './LANGUAGE/LANGUAGE';
 import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
 import { AgentMessageCommitmentDefinition } from './MESSAGE/AgentMessageCommitmentDefinition';
 import { InitialMessageCommitmentDefinition } from './MESSAGE/InitialMessageCommitmentDefinition';
+import { InternalMessageCommitmentDefinition } from './MESSAGE/InternalMessageCommitmentDefinition';
 import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
 import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitmentDefinition';
 import { MessageSuffixCommitmentDefinition } from './MESSAGE_SUFFIX/MESSAGE_SUFFIX';
 import { MetaCommitmentDefinition } from './META/META';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
+import { MetaDomainCommitmentDefinition } from './META_DOMAIN/META_DOMAIN';
 import { MetaDisclaimerCommitmentDefinition } from './META_DISCLAIMER/META_DISCLAIMER';
 import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
+import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MetaVoiceCommitmentDefinition } from './META_VOICE/META_VOICE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
 import { OpenCommitmentDefinition } from './OPEN/OPEN';
@@ -36,9 +40,16 @@ import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
 import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
+import { UsePopupCommitmentDefinition } from './USE_POPUP/USE_POPUP';
+import { UsePrivacyCommitmentDefinition } from './USE_PRIVACY/USE_PRIVACY';
+import { UseProjectCommitmentDefinition } from './USE_PROJECT/USE_PROJECT';
 import { UseSearchEngineCommitmentDefinition } from './USE_SEARCH_ENGINE/USE_SEARCH_ENGINE';
+import { UseSpawnCommitmentDefinition } from './USE_SPAWN/USE_SPAWN';
+import { UseTimeoutCommitmentDefinition } from './USE_TIMEOUT/USE_TIMEOUT';
 import { UseTimeCommitmentDefinition } from './USE_TIME/USE_TIME';
 import { UseUserLocationCommitmentDefinition } from './USE_USER_LOCATION/USE_USER_LOCATION';
+import { WritingRulesCommitmentDefinition } from './WRITING_RULES/WRITING_RULES';
+import { WritingSampleCommitmentDefinition } from './WRITING_SAMPLE/WRITING_SAMPLE';
 import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
 /**
  * Registry of all available commitment definitions
@@ -47,7 +58,7 @@ 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, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, 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, 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, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/config.d.ts

@@ -62,6 +62,9 @@ export declare const PROMPTBOOK_SYNTAX_COLORS: {
     readonly LINE: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
     readonly SEPARATOR: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
     readonly COMMITMENT: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
+    readonly NOTE_COMMITMENT: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
+    readonly TODO_COMMITMENT_TEXT: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
+    readonly TODO_COMMITMENT_BACKGROUND: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
     readonly PARAMETER: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
     readonly CODE_BLOCK: import("./utils/take/interfaces/ITakeChain").WithTake<Color>;
 };

package/umd/src/errors/0-index.d.ts

@@ -2,6 +2,7 @@ import { CsvFormatError } from '../formats/csv/CsvFormatError';
 import { AbstractFormatError } from './AbstractFormatError';
 import { AuthenticationError } from './AuthenticationError';
 import { CollectionError } from './CollectionError';
+import { ConflictError } from './ConflictError';
 import { DatabaseError } from './DatabaseError';
 import { EnvironmentMismatchError } from './EnvironmentMismatchError';
 import { ExpectError } from './ExpectError';
@@ -44,6 +45,7 @@ export declare const PROMPTBOOK_ERRORS: {
     readonly WrappedError: typeof WrappedError;
     readonly NotAllowed: typeof NotAllowed;
     readonly DatabaseError: typeof DatabaseError;
+    readonly ConflictError: typeof ConflictError;
 };
 /**
  * Index of all javascript errors
@@ -94,6 +96,7 @@ export declare const ALL_ERRORS: {
     readonly WrappedError: typeof WrappedError;
     readonly NotAllowed: typeof NotAllowed;
     readonly DatabaseError: typeof DatabaseError;
+    readonly ConflictError: typeof ConflictError;
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/errors/ConflictError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Signals that the requested operation could not be completed because the target already exists.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class ConflictError extends Error {
+    readonly name = "ConflictError";
+    constructor(message: string);
+}

package/umd/src/execution/LlmExecutionTools.d.ts

@@ -19,6 +19,17 @@ import type { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult, I
  *
  * @see https://github.com/webgptorg/promptbook#llm-execution-tools
  */
+/**
+ * Options that fine-tune streaming execution.
+ *
+ * @private internal helper for streaming helpers
+ */
+export type CallChatModelStreamOptions = {
+    /**
+     * Optional signal that can cancel the streaming request.
+     */
+    readonly signal?: AbortSignal;
+};
 export type LlmExecutionTools = {
     /**
      * Title of the model provider
@@ -59,7 +70,7 @@ export type LlmExecutionTools = {
      */
     callChatModelStream?(prompt: Prompt, onProgress: (chunk: ChatPromptResult & {
         isFinished?: boolean;
-    }) => void): Promise<ChatPromptResult>;
+    }) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
     /**
      * Calls a voice chat model
      */

package/umd/src/execution/Usage.d.ts

@@ -13,6 +13,10 @@ export type Usage = {
      * Note: If the cost is unknown, the value 0 and isUncertain is true
      */
     readonly price: UncertainNumber;
+    /**
+     * Time how long the agent was running in seconds
+     */
+    readonly duration: UncertainNumber;
     /**
      * Number of whatever used in the input aka. `prompt_tokens`
      */

package/umd/src/execution/utils/usageToHuman.d.ts

@@ -6,6 +6,7 @@ import type { Usage } from '../Usage';
  */
 type PartialUsage = Partial<Usage> & {
     price: UncertainNumber;
+    duration: UncertainNumber;
     input: Pick<Usage['input'], 'wordsCount'>;
     output: Pick<Usage['output'], 'wordsCount' | 'charactersCount'>;
 };

package/umd/src/file-security-checkers/FileSecurityCheckResult.d.ts

@@ -0,0 +1,32 @@
+import type { string_markdown, string_url } from '../types/typeAliases';
+/**
+ * Result of a file security check.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type FileSecurityCheckResult = {
+    /**
+     * Whether the file is considered safe
+     */
+    readonly isSafe: boolean;
+    /**
+     * Status of the check
+     */
+    readonly status: 'SAFE' | 'MALICIOUS' | 'SUSPICIOUS' | 'UNKNOWN' | 'ERROR';
+    /**
+     * Confidence of the result (0-1)
+     */
+    readonly confidence: number;
+    /**
+     * Human-readable message with more details about the result
+     */
+    readonly message: string_markdown;
+    /**
+     * URL to the full report on the provider's website
+     */
+    readonly reportUrl?: string_url;
+    /**
+     * Raw response from the provider (useful for debugging)
+     */
+    readonly rawResponse?: unknown;
+};

package/umd/src/file-security-checkers/FileSecurityChecker.d.ts

@@ -0,0 +1,34 @@
+import type { Promisable } from 'type-fest';
+import type { string_markdown, string_title, string_url } from '../types/typeAliases';
+import type { FileSecurityCheckResult } from './FileSecurityCheckResult';
+/**
+ * Interface defining the requirements for file security checker implementations.
+ * File security checkers are responsible for scanning uploaded files for viruses, malware, and other security threats.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type FileSecurityChecker = {
+    /**
+     * Unique identifier of the security checker (e.g. 'virustotal')
+     */
+    readonly id: string;
+    /**
+     * Human-readable title of the security checker
+     */
+    readonly title: string_title;
+    /**
+     * Human-readable description of the security checker
+     */
+    readonly description?: string_markdown;
+    /**
+     * Checks the security of a file by its URL
+     *
+     * @param fileUrl URL of the file to check
+     * @returns Result of the security check
+     */
+    checkFile(fileUrl: string_url): Promise<FileSecurityCheckResult>;
+    /**
+     * Checks if the provider is properly configured (e.g. API keys are present)
+     */
+    checkConfiguration(): Promisable<void>;
+};

package/umd/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.d.ts

@@ -0,0 +1,36 @@
+import type { string_url } from '../../types/typeAliases';
+import type { FileSecurityChecker } from '../FileSecurityChecker';
+import type { FileSecurityCheckResult } from '../FileSecurityCheckResult';
+/**
+ * File security checker that uses VirusTotal API.
+ *
+ * @see https://developers.virustotal.com/reference/overview
+ * @public exported from `@promptbook/core`
+ */
+export declare class VirusTotalFileSecurityChecker implements FileSecurityChecker {
+    private readonly apiKey;
+    /**
+     * @param apiKey VirusTotal API key
+     */
+    constructor(apiKey: string);
+    /**
+     * @inheritdoc
+     */
+    get id(): string;
+    /**
+     * @inheritdoc
+     */
+    get title(): string;
+    /**
+     * @inheritdoc
+     */
+    get description(): string;
+    /**
+     * @inheritdoc
+     */
+    checkConfiguration(): Promise<void>;
+    /**
+     * @inheritdoc
+     */
+    checkFile(fileUrl: string_url): Promise<FileSecurityCheckResult>;
+}

package/umd/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.test.d.ts

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

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

@@ -1,7 +1,7 @@
 import { BehaviorSubject } from 'rxjs';
 import type { AgentBasicInformation, AgentCapability, BookParameter } from '../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 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';
@@ -92,7 +92,7 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
      *
      * Note: This method also implements the learning mechanism
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?

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

@@ -3,7 +3,7 @@ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentMo
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_markdown, string_markdown_text, string_model_name, string_title } from '../../types/typeAliases';
@@ -83,7 +83,7 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     /**
      * Calls the chat model with agent-specific system prompt and requirements with streaming
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
 /**
  * TODO: [🍚] Implement Destroyable pattern to free resources

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

@@ -1,3 +1,4 @@
+import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_agent_hash, string_agent_name } from '../../types/typeAliases';
@@ -55,7 +56,7 @@ export declare class RemoteAgent extends Agent {
         userMessage?: string;
         agentMessage?: string;
     }>) | undefined;
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?

package/umd/src/llm-providers/agent/self-learning/SelfLearningManager.test.d.ts

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

package/umd/src/llm-providers/anthropic-claude/computeAnthropicClaudeUsage.d.ts

@@ -1,5 +1,6 @@
 import type Anthropic from '@anthropic-ai/sdk';
 import type { PartialDeep } from 'type-fest';
+import type { UncertainNumber } from '../../execution/UncertainNumber';
 import type { Usage } from '../../execution/Usage';
 import type { Prompt } from '../../types/Prompt';
 /**
@@ -8,11 +9,12 @@ import type { Prompt } from '../../types/Prompt';
  * @param promptContent The content of the prompt
  * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
  * @param rawResponse The raw response from Anthropic Claude API
+ * @param duration The duration of the execution
  * @throws {PipelineExecutionError} If the usage is not defined in the response from Anthropic Claude
  * @private internal utility of `AnthropicClaudeExecutionTools`
  */
 export declare function computeAnthropicClaudeUsage(promptContent: Prompt['content'], // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
-resultContent: string, rawResponse: PartialDeep<Pick<Anthropic.Messages.Message, 'model' | 'usage'>>): Usage;
+resultContent: string, rawResponse: PartialDeep<Pick<Anthropic.Messages.Message, 'model' | 'usage'>>, duration?: UncertainNumber): Usage;
 /**
  * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
  */

package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -1,7 +1,7 @@
 import { Agent as AgentFromKit } from '@openai/agents';
 import OpenAI from 'openai';
 import { TODO_any } from '../../_packages/types.index';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ModelRequirements } from '../../types/ModelRequirements';
 import type { Prompt } from '../../types/Prompt';
@@ -62,6 +62,8 @@ type OpenAiAgentKitPreparedAgent = {
  */
 export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler implements LlmExecutionTools {
     private preparedAgentKitAgent;
+    private readonly agentKitToolResultsByCallId;
+    private readonly agentKitToolSnapshotsByCallId;
     private readonly agentKitModelName;
     /**
      * Creates OpenAI AgentKit execution tools.
@@ -76,7 +78,7 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
     /**
      * Calls OpenAI AgentKit with a chat prompt (streaming).
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
     /**
      * Returns a prepared AgentKit agent when the server wants to manage caching externally.
      */
@@ -119,8 +121,14 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
         readonly openAiAgentKitAgent: OpenAiAgentKitAgent;
         readonly prompt: Prompt;
         readonly rawPromptContent?: string;
-        readonly onProgress: (chunk: ChatPromptResult) => void;
+        readonly onProgress: (chunk: ChatPromptResult & {
+            isFinished?: boolean;
+        }) => void;
         readonly responseFormatOutputType?: AgentOutputType;
+        /**
+         * Optional abort signal propagated from chat surfaces so stream generation can be cancelled.
+         */
+        readonly signal?: AbortSignal;
     }): Promise<ChatPromptResult>;
     /**
      * Builds AgentKit input items from the prompt and optional thread.
@@ -130,10 +138,32 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
      * Builds the user message content for AgentKit runs, including file inputs when provided.
      */
     private buildAgentKitUserContent;
+    /**
+     * Converts uploaded `File` objects into AgentKit `input_image` entries.
+     */
+    private createAgentKitInputImageItemsFromFiles;
+    /**
+     * Converts image chat attachments into AgentKit `input_image` entries.
+     *
+     * Note: This keeps images in the same completion request as multimodal input.
+     */
+    private createAgentKitInputImageItemsFromAttachments;
+    /**
+     * Builds AgentKit user content that can include text, uploaded files, and image attachments.
+     */
+    private buildAgentKitUserContentWithAttachments;
     /**
      * Normalizes AgentKit tool outputs into a string for Promptbook tool call results.
      */
     private formatAgentKitToolOutput;
+    /**
+     * Resolves the assistant-visible AgentKit tool response while preserving structured tool result data.
+     */
+    private resolveAgentKitToolResponse;
+    /**
+     * Resolves the stored Promptbook tool result for one AgentKit tool call.
+     */
+    private resolveAgentKitToolOutputResult;
     /**
      * Returns AgentKit-specific options.
      */

package/umd/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ModelRequirements } from '../../types/ModelRequirements';
 import type { Prompt } from '../../types/Prompt';
@@ -38,7 +38,7 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiVectorStoreHand
     /**
      * Calls OpenAI API to use a chat model with streaming.
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
     /**
      * Get an existing assistant tool wrapper
      */

package/umd/src/llm-providers/openai/OpenAiCompatibleExecutionTools.d.ts

@@ -1,6 +1,6 @@
 import OpenAI from 'openai';
 import type { AvailableModel } from '../../execution/AvailableModel';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult, ImagePromptResult } from '../../execution/PromptResult';
 import type { Usage } from '../../execution/Usage';
 import type { Prompt } from '../../types/Prompt';
@@ -49,7 +49,7 @@ export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecu
     /**
      * Calls OpenAI compatible API to use a chat model with streaming.
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
     /**
      * Internal method that handles parameter retry for chat model calls
      */

package/umd/src/llm-providers/openai/computeOpenAiUsage.d.ts

@@ -1,5 +1,6 @@
 import type OpenAI from 'openai';
 import type { PartialDeep } from 'type-fest';
+import type { UncertainNumber } from '../../execution/UncertainNumber';
 import type { Usage } from '../../execution/Usage';
 import type { Prompt } from '../../types/Prompt';
 /**
@@ -8,11 +9,12 @@ import type { Prompt } from '../../types/Prompt';
  * @param promptContent The content of the prompt
  * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
  * @param rawResponse The raw response from OpenAI API
+ * @param duration The duration of the execution
  * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
  * @private internal utility of `OpenAiExecutionTools`
  */
 export declare function computeOpenAiUsage(promptContent: Prompt['content'], // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
-resultContent: string, rawResponse: PartialDeep<Pick<OpenAI.Chat.Completions.ChatCompletion | OpenAI.Completions.Completion | OpenAI.Embeddings.CreateEmbeddingResponse, 'model' | 'usage'>>): Usage;
+resultContent: string, rawResponse: PartialDeep<Pick<OpenAI.Chat.Completions.ChatCompletion | OpenAI.Completions.Completion | OpenAI.Embeddings.CreateEmbeddingResponse, 'model' | 'usage'>>, duration?: UncertainNumber): Usage;
 /**
  * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
  */

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env ts-node
 export {};
 /**
+ * TODO: !!!!!!! Extract to `other` and append DigitalOcean instructions
  * Note: [⚫] Code in this file should never be published in any package
  */