@agentxjs/core 1.9.5-dev → 1.9.7-dev

package/dist/event/types/index.js

@@ -0,0 +1,56 @@
+import {
+  hasIntent,
+  isAgentEvent,
+  isAgentMessageEvent,
+  isAgentStateEvent,
+  isAgentStreamEvent,
+  isAgentTurnEvent,
+  isCommandEvent,
+  isCommandRequest,
+  isCommandResponse,
+  isConnectionEvent,
+  isContainerEvent,
+  isContainerLifecycleEvent,
+  isDriveableEvent,
+  isFromSource,
+  isMCPEvent,
+  isNotification,
+  isRequest,
+  isResult,
+  isSandboxEvent,
+  isSessionActionEvent,
+  isSessionEvent,
+  isSessionLifecycleEvent,
+  isSessionPersistEvent,
+  isStopReason,
+  isWorkdirEvent
+} from "../../chunk-E5FPOAPO.js";
+import "../../chunk-7D4SUZUM.js";
+export {
+  hasIntent,
+  isAgentEvent,
+  isAgentMessageEvent,
+  isAgentStateEvent,
+  isAgentStreamEvent,
+  isAgentTurnEvent,
+  isCommandEvent,
+  isCommandRequest,
+  isCommandResponse,
+  isConnectionEvent,
+  isContainerEvent,
+  isContainerLifecycleEvent,
+  isDriveableEvent,
+  isFromSource,
+  isMCPEvent,
+  isNotification,
+  isRequest,
+  isResult,
+  isSandboxEvent,
+  isSessionActionEvent,
+  isSessionEvent,
+  isSessionLifecycleEvent,
+  isSessionPersistEvent,
+  isStopReason,
+  isWorkdirEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/event/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/event-CDuTzs__.d.ts

@@ -0,0 +1,296 @@
+import { U as UserMessage, A as AssistantMessage, T as ToolCallMessage, a as ToolResultMessage, E as ErrorMessage, b as TokenUsage } from './message-BMrMm1pq.js';
+
+/**
+ * Event Types - Stream, State, Message, and Turn Events
+ *
+ * This file defines all event types for the AgentEngine:
+ * - Base EngineEvent type
+ * - Stream Events: message_start, text_delta, tool_use_*, etc.
+ * - State Events: conversation_*, tool_*, error_*
+ * - Message Events: user_message, assistant_message, etc.
+ * - Turn Events: turn_request, turn_response
+ * - AgentOutput: Union of all output events
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * EngineEvent - Lightweight event base for AgentEngine domain
+ *
+ * EngineEvent is the simplified event structure used inside AgentEngine.
+ * It only contains: type, timestamp, data
+ *
+ * This is a self-contained type without external dependencies.
+ * All specific event types (StreamEvent, StateEvent, etc.) extend this base.
+ */
+interface EngineEvent<T extends string = string, D = unknown> {
+    /**
+     * Event type identifier (e.g., "text_delta", "assistant_message")
+     */
+    readonly type: T;
+    /**
+     * Event timestamp (Unix milliseconds)
+     */
+    readonly timestamp: number;
+    /**
+     * Event payload data
+     */
+    readonly data: D;
+}
+/**
+ * @deprecated Use EngineEvent instead
+ */
+type AgentEvent<T extends string = string, D = unknown> = EngineEvent<T, D>;
+/**
+ * AgentState
+ *
+ * Agent conversation states for fine-grained monitoring.
+ *
+ * State transitions:
+ * ```
+ * idle -> thinking -> responding -> idle
+ *                        |
+ *               planning_tool -> awaiting_tool_result
+ *                        |
+ *                    thinking -> responding -> idle
+ *
+ * Any state can transition to error:
+ * thinking/responding/planning_tool/awaiting_tool_result -> error -> idle
+ * ```
+ */
+type AgentState = "idle" | "thinking" | "responding" | "planning_tool" | "awaiting_tool_result" | "error";
+/**
+ * Error category
+ */
+type AgentErrorCategory = "network" | "validation" | "system" | "business";
+/**
+ * AgentError - Standardized error structure
+ */
+interface AgentError {
+    /**
+     * Error category
+     */
+    category: AgentErrorCategory;
+    /**
+     * Error code (e.g., "NETWORK_TIMEOUT", "INVALID_INPUT")
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Whether the error is recoverable
+     */
+    recoverable: boolean;
+    /**
+     * Original error (if any)
+     */
+    cause?: Error;
+    /**
+     * Additional context
+     */
+    context?: Record<string, unknown>;
+}
+/**
+ * Stop reason for message completion
+ */
+type StopReason = "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
+interface MessageStartData {
+    messageId: string;
+    model: string;
+}
+interface MessageDeltaData {
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface MessageStopData {
+    stopReason?: StopReason;
+}
+interface TextDeltaData {
+    text: string;
+}
+interface ToolUseStartData {
+    toolCallId: string;
+    toolName: string;
+}
+interface InputJsonDeltaData {
+    partialJson: string;
+}
+interface ToolUseStopData {
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}
+interface ToolResultData {
+    toolCallId: string;
+    result: unknown;
+    isError?: boolean;
+}
+interface ErrorReceivedData {
+    message: string;
+    errorCode?: string;
+}
+type MessageStartEvent = EngineEvent<"message_start", MessageStartData>;
+type MessageDeltaEvent = EngineEvent<"message_delta", MessageDeltaData>;
+type MessageStopEvent = EngineEvent<"message_stop", MessageStopData>;
+type TextDeltaEvent = EngineEvent<"text_delta", TextDeltaData>;
+type ToolUseStartEvent = EngineEvent<"tool_use_start", ToolUseStartData>;
+type InputJsonDeltaEvent = EngineEvent<"input_json_delta", InputJsonDeltaData>;
+type ToolUseStopEvent = EngineEvent<"tool_use_stop", ToolUseStopData>;
+type ToolResultEvent = EngineEvent<"tool_result", ToolResultData>;
+type ErrorReceivedEvent = EngineEvent<"error_received", ErrorReceivedData>;
+/**
+ * StreamEvent - All lightweight stream events
+ */
+type StreamEvent = MessageStartEvent | MessageDeltaEvent | MessageStopEvent | TextDeltaEvent | ToolUseStartEvent | InputJsonDeltaEvent | ToolUseStopEvent | ToolResultEvent | ErrorReceivedEvent;
+/**
+ * StreamEventType - String literal union
+ */
+type StreamEventType = StreamEvent["type"];
+interface ConversationQueuedData {
+    messageId: string;
+}
+interface ConversationStartData {
+    messageId: string;
+}
+interface ConversationThinkingData {
+}
+interface ConversationRespondingData {
+}
+interface ConversationEndData {
+    reason: "completed" | "interrupted" | "error";
+}
+interface ConversationInterruptedData {
+    reason: string;
+}
+interface ToolPlannedData {
+    toolId: string;
+    toolName: string;
+}
+interface ToolExecutingData {
+    toolId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}
+interface ToolCompletedData {
+    toolId: string;
+    toolName: string;
+    result: unknown;
+}
+interface ToolFailedData {
+    toolId: string;
+    toolName: string;
+    error: string;
+}
+interface ErrorOccurredData {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    category?: string;
+}
+/**
+ * StateEvent - Base type for state events
+ * @deprecated Use specific event types instead
+ */
+interface StateEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {
+}
+type ConversationQueuedEvent = EngineEvent<"conversation_queued", ConversationQueuedData>;
+type ConversationStartEvent = EngineEvent<"conversation_start", ConversationStartData>;
+type ConversationThinkingEvent = EngineEvent<"conversation_thinking", ConversationThinkingData>;
+type ConversationRespondingEvent = EngineEvent<"conversation_responding", ConversationRespondingData>;
+type ConversationEndEvent = EngineEvent<"conversation_end", ConversationEndData>;
+type ConversationInterruptedEvent = EngineEvent<"conversation_interrupted", ConversationInterruptedData>;
+type ToolPlannedEvent = EngineEvent<"tool_planned", ToolPlannedData>;
+type ToolExecutingEvent = EngineEvent<"tool_executing", ToolExecutingData>;
+type ToolCompletedEvent = EngineEvent<"tool_completed", ToolCompletedData>;
+type ToolFailedEvent = EngineEvent<"tool_failed", ToolFailedData>;
+type ErrorOccurredEvent = EngineEvent<"error_occurred", ErrorOccurredData>;
+/**
+ * Alias for ErrorOccurredEvent (legacy compatibility)
+ */
+type AgentErrorOccurredEvent = ErrorOccurredEvent;
+/**
+ * AgentStateEvent - All lightweight state events
+ */
+type AgentStateEvent = ConversationQueuedEvent | ConversationStartEvent | ConversationThinkingEvent | ConversationRespondingEvent | ConversationEndEvent | ConversationInterruptedEvent | ToolPlannedEvent | ToolExecutingEvent | ToolCompletedEvent | ToolFailedEvent | ErrorOccurredEvent;
+/**
+ * Type guard: is this a state event?
+ */
+declare function isStateEvent(event: EngineEvent): event is AgentStateEvent;
+/**
+ * MessageEvent - Base type for message events
+ * @deprecated Use specific event types instead
+ */
+interface MessageEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {
+}
+type UserMessageEvent = EngineEvent<"user_message", UserMessage>;
+type AssistantMessageEvent = EngineEvent<"assistant_message", AssistantMessage>;
+type ToolCallMessageEvent = EngineEvent<"tool_call_message", ToolCallMessage>;
+type ToolResultMessageEvent = EngineEvent<"tool_result_message", ToolResultMessage>;
+type ErrorMessageEvent = EngineEvent<"error_message", ErrorMessage>;
+/**
+ * AgentMessageEvent - All lightweight message events
+ */
+type AgentMessageEvent = UserMessageEvent | AssistantMessageEvent | ToolCallMessageEvent | ToolResultMessageEvent | ErrorMessageEvent;
+/**
+ * Type guard: is this a message event?
+ */
+declare function isMessageEvent(event: EngineEvent): event is AgentMessageEvent;
+interface TurnRequestData {
+    turnId: string;
+    messageId: string;
+    content: string;
+    timestamp: number;
+}
+interface TurnResponseData {
+    turnId: string;
+    messageId: string;
+    duration: number;
+    usage?: TokenUsage;
+    model?: string;
+    stopReason?: string;
+    timestamp: number;
+}
+/**
+ * TurnEvent - Base type for turn events
+ * @deprecated Use specific event types instead
+ */
+interface TurnEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {
+}
+type TurnRequestEvent = EngineEvent<"turn_request", TurnRequestData>;
+type TurnResponseEvent = EngineEvent<"turn_response", TurnResponseData>;
+/**
+ * AgentTurnEvent - All lightweight turn events
+ */
+type AgentTurnEvent = TurnRequestEvent | TurnResponseEvent;
+/**
+ * Type guard: is this a turn event?
+ */
+declare function isTurnEvent(event: EngineEvent): event is AgentTurnEvent;
+/**
+ * AgentOutput - Union of all possible agent output events
+ *
+ * Includes all event layers:
+ * - Stream: Real-time streaming events from Driver
+ * - State: State machine transitions
+ * - Message: Assembled messages
+ * - Turn: Turn analytics
+ */
+type AgentOutput = StreamEvent | AgentStateEvent | AgentMessageEvent | AgentTurnEvent;
+/**
+ * Unsubscribe function returned by on()
+ */
+type Unsubscribe = () => void;
+/**
+ * Agent output event callback function type
+ */
+type AgentOutputCallback<T extends AgentOutput = AgentOutput> = (event: T) => void;
+/**
+ * @deprecated Use AgentOutputCallback instead
+ */
+type AgentEventHandler<T extends AgentOutput = AgentOutput> = AgentOutputCallback<T>;
+
+export { type AgentStateEvent as $, type AgentOutput as A, type ConversationInterruptedData as B, type ConversationQueuedData as C, type ToolPlannedData as D, type EngineEvent as E, type ToolExecutingData as F, type ToolCompletedData as G, type ToolFailedData as H, type InputJsonDeltaData as I, type ErrorOccurredData as J, type StateEvent as K, type ConversationQueuedEvent as L, type MessageStartData as M, type ConversationStartEvent as N, type ConversationThinkingEvent as O, type ConversationRespondingEvent as P, type ConversationEndEvent as Q, type ConversationInterruptedEvent as R, type StreamEvent as S, type TextDeltaData as T, type Unsubscribe as U, type ToolPlannedEvent as V, type ToolExecutingEvent as W, type ToolCompletedEvent as X, type ToolFailedEvent as Y, type ErrorOccurredEvent as Z, type AgentErrorOccurredEvent as _, type AgentState as a, type MessageEvent as a0, type UserMessageEvent as a1, type AssistantMessageEvent as a2, type ToolCallMessageEvent as a3, type ToolResultMessageEvent as a4, type ErrorMessageEvent as a5, type AgentMessageEvent as a6, type TurnRequestData as a7, type TurnResponseData as a8, type TurnEvent as a9, type TurnRequestEvent as aa, type TurnResponseEvent as ab, type AgentTurnEvent as ac, type AgentEventHandler as ad, isStateEvent as ae, isMessageEvent as af, isTurnEvent as ag, type AgentOutputCallback as b, type AgentEvent as c, type AgentErrorCategory as d, type AgentError as e, type StopReason as f, type MessageDeltaData as g, type MessageStopData as h, type ToolUseStartData as i, type ToolUseStopData as j, type ToolResultData as k, type ErrorReceivedData as l, type MessageStartEvent as m, type MessageDeltaEvent as n, type MessageStopEvent as o, type TextDeltaEvent as p, type ToolUseStartEvent as q, type InputJsonDeltaEvent as r, type ToolUseStopEvent as s, type ToolResultEvent as t, type ErrorReceivedEvent as u, type StreamEventType as v, type ConversationStartData as w, type ConversationThinkingData as x, type ConversationRespondingData as y, type ConversationEndData as z };

package/dist/image/index.d.ts

@@ -0,0 +1,112 @@
+import { ImageRecord, ImageRepository, SessionRepository } from '../persistence/index.js';
+export { ImageMetadata } from '../persistence/index.js';
+import { McpServerConfig } from '../driver/index.js';
+import '../message-BMrMm1pq.js';
+
+/**
+ * Image - Persistent conversation entity
+ */
+interface Image {
+    readonly imageId: string;
+    readonly containerId: string;
+    readonly sessionId: string;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly systemPrompt: string | undefined;
+    readonly mcpServers: Record<string, McpServerConfig> | undefined;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    /**
+     * Update image metadata (name, description)
+     */
+    update(updates: {
+        name?: string;
+        description?: string;
+    }): Promise<Image>;
+    /**
+     * Delete this image and its session
+     */
+    delete(): Promise<void>;
+    /**
+     * Get the underlying record
+     */
+    toRecord(): ImageRecord;
+}
+/**
+ * Context needed by Image operations
+ */
+interface ImageContext {
+    imageRepository: ImageRepository;
+    sessionRepository: SessionRepository;
+}
+/**
+ * Configuration for creating a new Image
+ */
+interface ImageCreateConfig {
+    containerId: string;
+    name?: string;
+    description?: string;
+    systemPrompt?: string;
+    mcpServers?: Record<string, McpServerConfig>;
+}
+
+/**
+ * ImageImpl - Image implementation
+ */
+declare class ImageImpl implements Image {
+    private readonly record;
+    private readonly context;
+    private constructor();
+    get imageId(): string;
+    get containerId(): string;
+    get sessionId(): string;
+    get name(): string;
+    get description(): string | undefined;
+    get systemPrompt(): string | undefined;
+    get mcpServers(): Record<string, McpServerConfig> | undefined;
+    get createdAt(): number;
+    get updatedAt(): number;
+    /**
+     * Create a new image (conversation)
+     */
+    static create(config: ImageCreateConfig, context: ImageContext): Promise<ImageImpl>;
+    /**
+     * Load an existing image from storage
+     */
+    static load(imageId: string, context: ImageContext): Promise<ImageImpl | null>;
+    /**
+     * List all images in a container
+     */
+    static listByContainer(containerId: string, context: ImageContext): Promise<ImageRecord[]>;
+    /**
+     * List all images
+     */
+    static listAll(context: ImageContext): Promise<ImageRecord[]>;
+    /**
+     * Update image metadata
+     */
+    update(updates: {
+        name?: string;
+        description?: string;
+    }): Promise<Image>;
+    /**
+     * Delete this image and its session
+     */
+    delete(): Promise<void>;
+    /**
+     * Get the underlying record
+     */
+    toRecord(): ImageRecord;
+    private static generateImageId;
+    private static generateSessionId;
+}
+/**
+ * Create a new Image
+ */
+declare function createImage(config: ImageCreateConfig, context: ImageContext): Promise<Image>;
+/**
+ * Load an existing Image
+ */
+declare function loadImage(imageId: string, context: ImageContext): Promise<Image | null>;
+
+export { type Image, type ImageContext, type ImageCreateConfig, ImageImpl, ImageRecord, ImageRepository, createImage, loadImage };

package/dist/image/index.js

@@ -0,0 +1,151 @@
+import "../chunk-7D4SUZUM.js";
+
+// src/image/Image.ts
+import { createLogger } from "commonxjs/logger";
+var logger = createLogger("image/Image");
+var ImageImpl = class _ImageImpl {
+  constructor(record, context) {
+    this.record = record;
+    this.context = context;
+  }
+  // ==================== Getters ====================
+  get imageId() {
+    return this.record.imageId;
+  }
+  get containerId() {
+    return this.record.containerId;
+  }
+  get sessionId() {
+    return this.record.sessionId;
+  }
+  get name() {
+    return this.record.name;
+  }
+  get description() {
+    return this.record.description;
+  }
+  get systemPrompt() {
+    return this.record.systemPrompt;
+  }
+  get mcpServers() {
+    return this.record.mcpServers;
+  }
+  get createdAt() {
+    return this.record.createdAt;
+  }
+  get updatedAt() {
+    return this.record.updatedAt;
+  }
+  // ==================== Static Factory Methods ====================
+  /**
+   * Create a new image (conversation)
+   */
+  static async create(config, context) {
+    const now = Date.now();
+    const imageId = _ImageImpl.generateImageId();
+    const sessionId = _ImageImpl.generateSessionId();
+    const record = {
+      imageId,
+      containerId: config.containerId,
+      sessionId,
+      name: config.name ?? "New Conversation",
+      description: config.description,
+      systemPrompt: config.systemPrompt,
+      mcpServers: config.mcpServers,
+      createdAt: now,
+      updatedAt: now
+    };
+    await context.imageRepository.saveImage(record);
+    await context.sessionRepository.saveSession({
+      sessionId,
+      imageId,
+      containerId: config.containerId,
+      createdAt: now,
+      updatedAt: now
+    });
+    logger.info("Image created", {
+      imageId,
+      sessionId,
+      containerId: config.containerId,
+      name: record.name
+    });
+    return new _ImageImpl(record, context);
+  }
+  /**
+   * Load an existing image from storage
+   */
+  static async load(imageId, context) {
+    const record = await context.imageRepository.findImageById(imageId);
+    if (!record) {
+      logger.debug("Image not found", { imageId });
+      return null;
+    }
+    logger.debug("Image loaded", { imageId, name: record.name });
+    return new _ImageImpl(record, context);
+  }
+  /**
+   * List all images in a container
+   */
+  static async listByContainer(containerId, context) {
+    return context.imageRepository.findImagesByContainerId(containerId);
+  }
+  /**
+   * List all images
+   */
+  static async listAll(context) {
+    return context.imageRepository.findAllImages();
+  }
+  // ==================== Instance Methods ====================
+  /**
+   * Update image metadata
+   */
+  async update(updates) {
+    const now = Date.now();
+    const updatedRecord = {
+      ...this.record,
+      name: updates.name ?? this.record.name,
+      description: updates.description ?? this.record.description,
+      updatedAt: now
+    };
+    await this.context.imageRepository.saveImage(updatedRecord);
+    logger.info("Image updated", { imageId: this.imageId, updates });
+    return new _ImageImpl(updatedRecord, this.context);
+  }
+  /**
+   * Delete this image and its session
+   */
+  async delete() {
+    await this.context.sessionRepository.deleteSession(this.sessionId);
+    await this.context.imageRepository.deleteImage(this.imageId);
+    logger.info("Image deleted", { imageId: this.imageId, sessionId: this.sessionId });
+  }
+  /**
+   * Get the underlying record
+   */
+  toRecord() {
+    return { ...this.record };
+  }
+  // ==================== Private Helpers ====================
+  static generateImageId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `img_${timestamp}_${random}`;
+  }
+  static generateSessionId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `sess_${timestamp}_${random}`;
+  }
+};
+async function createImage(config, context) {
+  return ImageImpl.create(config, context);
+}
+async function loadImage(imageId, context) {
+  return ImageImpl.load(imageId, context);
+}
+export {
+  ImageImpl,
+  createImage,
+  loadImage
+};
+//# sourceMappingURL=index.js.map

package/dist/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/image/Image.ts"],"sourcesContent":["/**\n * Image - Persistent conversation entity\n *\n * Image is the primary entity that users interact with (displayed as \"conversation\").\n * Agent is a transient runtime instance created from Image.\n */\n\nimport { createLogger } from \"commonxjs/logger\";\nimport type { Image, ImageRecord, ImageContext, ImageCreateConfig } from \"./types\";\n\nconst logger = createLogger(\"image/Image\");\n\n/**\n * ImageImpl - Image implementation\n */\nexport class ImageImpl implements Image {\n  private constructor(\n    private readonly record: ImageRecord,\n    private readonly context: ImageContext\n  ) {}\n\n  // ==================== Getters ====================\n\n  get imageId(): string {\n    return this.record.imageId;\n  }\n\n  get containerId(): string {\n    return this.record.containerId;\n  }\n\n  get sessionId(): string {\n    return this.record.sessionId;\n  }\n\n  get name(): string {\n    return this.record.name;\n  }\n\n  get description(): string | undefined {\n    return this.record.description;\n  }\n\n  get systemPrompt(): string | undefined {\n    return this.record.systemPrompt;\n  }\n\n  get mcpServers() {\n    return this.record.mcpServers;\n  }\n\n  get createdAt(): number {\n    return this.record.createdAt;\n  }\n\n  get updatedAt(): number {\n    return this.record.updatedAt;\n  }\n\n  // ==================== Static Factory Methods ====================\n\n  /**\n   * Create a new image (conversation)\n   */\n  static async create(config: ImageCreateConfig, context: ImageContext): Promise<ImageImpl> {\n    const now = Date.now();\n    const imageId = ImageImpl.generateImageId();\n    const sessionId = ImageImpl.generateSessionId();\n\n    // Create image record\n    const record: ImageRecord = {\n      imageId,\n      containerId: config.containerId,\n      sessionId,\n      name: config.name ?? \"New Conversation\",\n      description: config.description,\n      systemPrompt: config.systemPrompt,\n      mcpServers: config.mcpServers,\n      createdAt: now,\n      updatedAt: now,\n    };\n\n    // Persist image\n    await context.imageRepository.saveImage(record);\n\n    // Create associated session (for message storage)\n    await context.sessionRepository.saveSession({\n      sessionId,\n      imageId,\n      containerId: config.containerId,\n      createdAt: now,\n      updatedAt: now,\n    });\n\n    logger.info(\"Image created\", {\n      imageId,\n      sessionId,\n      containerId: config.containerId,\n      name: record.name,\n    });\n\n    return new ImageImpl(record, context);\n  }\n\n  /**\n   * Load an existing image from storage\n   */\n  static async load(imageId: string, context: ImageContext): Promise<ImageImpl | null> {\n    const record = await context.imageRepository.findImageById(imageId);\n    if (!record) {\n      logger.debug(\"Image not found\", { imageId });\n      return null;\n    }\n\n    logger.debug(\"Image loaded\", { imageId, name: record.name });\n    return new ImageImpl(record, context);\n  }\n\n  /**\n   * List all images in a container\n   */\n  static async listByContainer(containerId: string, context: ImageContext): Promise<ImageRecord[]> {\n    return context.imageRepository.findImagesByContainerId(containerId);\n  }\n\n  /**\n   * List all images\n   */\n  static async listAll(context: ImageContext): Promise<ImageRecord[]> {\n    return context.imageRepository.findAllImages();\n  }\n\n  // ==================== Instance Methods ====================\n\n  /**\n   * Update image metadata\n   */\n  async update(updates: { name?: string; description?: string }): Promise<Image> {\n    const now = Date.now();\n    const updatedRecord: ImageRecord = {\n      ...this.record,\n      name: updates.name ?? this.record.name,\n      description: updates.description ?? this.record.description,\n      updatedAt: now,\n    };\n\n    await this.context.imageRepository.saveImage(updatedRecord);\n\n    logger.info(\"Image updated\", { imageId: this.imageId, updates });\n    return new ImageImpl(updatedRecord, this.context);\n  }\n\n  /**\n   * Delete this image and its session\n   */\n  async delete(): Promise<void> {\n    // Delete session first (including messages)\n    await this.context.sessionRepository.deleteSession(this.sessionId);\n\n    // Delete image\n    await this.context.imageRepository.deleteImage(this.imageId);\n\n    logger.info(\"Image deleted\", { imageId: this.imageId, sessionId: this.sessionId });\n  }\n\n  /**\n   * Get the underlying record\n   */\n  toRecord(): ImageRecord {\n    return { ...this.record };\n  }\n\n  // ==================== Private Helpers ====================\n\n  private static generateImageId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `img_${timestamp}_${random}`;\n  }\n\n  private static generateSessionId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `sess_${timestamp}_${random}`;\n  }\n}\n\n/**\n * Create a new Image\n */\nexport async function createImage(\n  config: ImageCreateConfig,\n  context: ImageContext\n): Promise<Image> {\n  return ImageImpl.create(config, context);\n}\n\n/**\n * Load an existing Image\n */\nexport async function loadImage(imageId: string, context: ImageContext): Promise<Image | null> {\n  return ImageImpl.load(imageId, context);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from 'commonxjs/logger';
+export { AgentEngineState, AgentProcessorInput, AgentProcessorOutput, AgentStateMachine, MealyMachine, agentProcessor, createAgent, createInitialAgentEngineState, createMealyMachine } from './agent/index.js';
+export { A as AssistantMessage, C as ContentPart, E as ErrorMessage, F as FilePart, I as ImagePart, M as Message, i as MessageRole, j as MessageSubtype, d as TextPart, e as ThinkingPart, b as TokenUsage, T as ToolCallMessage, f as ToolCallPart, a as ToolResultMessage, g as ToolResultOutput, h as ToolResultPart, c as UserContentPart, U as UserMessage } from './message-BMrMm1pq.js';
+export { e as AgentError, d as AgentErrorCategory, _ as AgentErrorOccurredEvent, c as AgentEvent, ad as AgentEventHandler, a6 as AgentMessageEvent, A as AgentOutput, b as AgentOutputCallback, a as AgentState, $ as AgentStateEvent, ac as AgentTurnEvent, a2 as AssistantMessageEvent, z as ConversationEndData, Q as ConversationEndEvent, B as ConversationInterruptedData, R as ConversationInterruptedEvent, C as ConversationQueuedData, L as ConversationQueuedEvent, y as ConversationRespondingData, P as ConversationRespondingEvent, w as ConversationStartData, N as ConversationStartEvent, x as ConversationThinkingData, O as ConversationThinkingEvent, E as EngineEvent, a5 as ErrorMessageEvent, J as ErrorOccurredData, Z as ErrorOccurredEvent, l as ErrorReceivedData, u as ErrorReceivedEvent, I as InputJsonDeltaData, r as InputJsonDeltaEvent, g as MessageDeltaData, n as MessageDeltaEvent, a0 as MessageEvent, M as MessageStartData, m as MessageStartEvent, h as MessageStopData, o as MessageStopEvent, K as StateEvent, f as StopReason, S as StreamEvent, v as StreamEventType, T as TextDeltaData, p as TextDeltaEvent, a3 as ToolCallMessageEvent, G as ToolCompletedData, X as ToolCompletedEvent, F as ToolExecutingData, W as ToolExecutingEvent, H as ToolFailedData, Y as ToolFailedEvent, D as ToolPlannedData, V as ToolPlannedEvent, k as ToolResultData, t as ToolResultEvent, a4 as ToolResultMessageEvent, i as ToolUseStartData, q as ToolUseStartEvent, j as ToolUseStopData, s as ToolUseStopEvent, a9 as TurnEvent, a7 as TurnRequestData, aa as TurnRequestEvent, a8 as TurnResponseData, ab as TurnResponseEvent, U as Unsubscribe, a1 as UserMessageEvent, af as isMessageEvent, ae as isStateEvent, ag as isTurnEvent } from './event-CDuTzs__.js';
+export { AgentEngine, AgentEventBus, AgentInterceptor, AgentInterceptorNext, AgentMiddleware, AgentMiddlewareNext, AgentPresenter, AgentSource, AgentStateMachineInterface, CreateAgentOptions, EventHandlerMap, MessageQueue, ReactHandlerMap, StateChange, StateChangeHandler } from './agent/types/index.js';
+export { MessageAssemblerInput, MessageAssemblerOutput, MessageAssemblerState, PendingContent, PendingTurn, StateEventProcessorContext, StateEventProcessorInput, StateEventProcessorOutput, TurnTrackerInput, TurnTrackerOutput, TurnTrackerState, createInitialMessageAssemblerState, createInitialStateEventProcessorContext, createInitialTurnTrackerState, messageAssemblerProcessor, messageAssemblerProcessorDef, stateEventProcessor, stateEventProcessorDef, turnTrackerProcessor, turnTrackerProcessorDef } from './agent/engine/internal/index.js';
+export { M as MemoryStore, a as Sink, b as SinkDefinition, c as Source, d as SourceDefinition, S as Store, g as chainProcessors, f as combineInitialStates, e as combineProcessors, h as filterProcessor, i as identityProcessor, m as mapOutput, w as withLogging } from './combinators-nEa5dD0T.js';
+export { P as Processor, b as ProcessorDefinition, a as ProcessorResult } from './Processor-DT0N1qI6.js';