@mongodb-js/agent-engine-sdk 0.11.3

package/dist/models.d.ts

@@ -0,0 +1,593 @@
+/** Framework-neutral types and models for the Atlas Agent Engine SDK. */
+import { z } from "zod";
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Runtime schema for the recursive `JsonValue` type. */
+export declare const JsonValueSchema: z.ZodType<JsonValue>;
+export type Role = "user" | "assistant" | "tool" | "system";
+/** Text content block. */
+export declare const TextBlockSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"text">>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type TextBlock = z.infer<typeof TextBlockSchema>;
+/** Image content block. */
+export declare const ImageBlockSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"image">>;
+    url: z.ZodString;
+    mime_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImageBlock = z.infer<typeof ImageBlockSchema>;
+/** Document/file content block. */
+export declare const DocumentBlockSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"document">>;
+    url: z.ZodString;
+    mime_type: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DocumentBlock = z.infer<typeof DocumentBlockSchema>;
+/**
+ * Discriminated on `type` so a document block is never misparsed as an image
+ * (a plain union would match `{ url }` against `ImageBlockSchema` first and
+ * silently drop `filename`). Inputs must carry an explicit `type`.
+ */
+export declare const AnyContentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"text">>;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"image">>;
+    url: z.ZodString;
+    mime_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"document">>;
+    url: z.ZodString;
+    mime_type: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type AnyContentBlock = z.infer<typeof AnyContentBlockSchema>;
+/** Framework-neutral tool definition. */
+export declare const ToolDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    args_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    callable: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+    remote: z.ZodDefault<z.ZodBoolean>;
+    provider_type: z.ZodOptional<z.ZodString>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    network: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+    redact_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>;
+export type ToolDefinitionInput = z.input<typeof ToolDefinitionSchema>;
+/** Constructs a ToolDefinition, applying Python-parity defaults (remote=true, network=[], timeout_seconds=30, redact_fields=[]). */
+export declare function createToolDefinition(input: ToolDefinitionInput): ToolDefinition;
+/** Typed token-usage metadata for LLM calls. */
+export declare class LLMTokenUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly promptTokens?: number;
+    readonly completionTokens?: number;
+    totalTokens?: number;
+    readonly model?: string;
+    constructor(data: {
+        input_tokens?: number;
+        output_tokens?: number;
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+        model?: string;
+    });
+    /** Serializes to snake_case wire format so JSON.stringify round-trips through LLMTokenUsageSchema. */
+    toJSON(): Record<string, unknown>;
+    /** Returns LangChain's expected usage-metadata keys. */
+    toLangchainUsageMetadata(): {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Runtime validation schema for LLMTokenUsage wire data. All fields optional, matching the class constructor. */
+export declare const LLMTokenUsageSchema: z.ZodPreprocess<z.ZodPipe<z.ZodObject<{
+    input_tokens: z.ZodOptional<z.ZodNumber>;
+    output_tokens: z.ZodOptional<z.ZodNumber>;
+    prompt_tokens: z.ZodOptional<z.ZodNumber>;
+    completion_tokens: z.ZodOptional<z.ZodNumber>;
+    total_tokens: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<LLMTokenUsage, {
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+    prompt_tokens?: number | undefined;
+    completion_tokens?: number | undefined;
+    total_tokens?: number | undefined;
+    model?: string | undefined;
+}>>>;
+/** Typed final tool call requested by an LLM. */
+export declare class LLMToolCall {
+    readonly id?: string;
+    readonly name?: string;
+    readonly args?: JsonValue;
+    readonly type?: string;
+    readonly index?: number;
+    constructor(data: {
+        id?: string;
+        name?: string;
+        args?: JsonValue;
+        arguments?: JsonValue;
+        type?: string;
+        index?: number;
+    });
+    /** Returns a LangChain-compatible tool-call dict (excludes index). */
+    toLangchainDict(): Record<string, JsonValue>;
+}
+/** Runtime validation schema for LLMToolCall wire data. */
+export declare const LLMToolCallSchema: z.ZodPipe<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    arguments: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    type: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodTransform<LLMToolCall, {
+    id?: string | undefined;
+    name?: string | undefined;
+    args?: JsonValue | undefined;
+    arguments?: JsonValue | undefined;
+    type?: string | undefined;
+    index?: number | undefined;
+}>>;
+/** Serializable bound-tool schema forwarded with an LLM call. */
+export declare class LLMToolSchema {
+    readonly name?: string;
+    readonly description?: string;
+    readonly parameters?: JsonValue;
+    readonly type?: string;
+    readonly strict?: boolean;
+    readonly function?: JsonValue;
+    constructor(data: {
+        name?: string;
+        description?: string;
+        parameters?: JsonValue;
+        type?: string;
+        strict?: boolean;
+        function?: JsonValue;
+    });
+    /** Returns the schema in the shape LangChain bind_tools expects. */
+    toLangchainDict(): Record<string, JsonValue>;
+}
+/** Runtime validation schema for LLMToolSchema wire data. */
+export declare const LLMToolSchemaValidator: z.ZodPipe<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    type: z.ZodOptional<z.ZodString>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+    function: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>, z.ZodTransform<LLMToolSchema, {
+    name?: string | undefined;
+    description?: string | undefined;
+    parameters?: JsonValue | undefined;
+    type?: string | undefined;
+    strict?: boolean | undefined;
+    function?: JsonValue | undefined;
+}>>;
+/** Explicit provider/model options passed with an LLM invocation. */
+export declare class LLMInvocationOptions {
+    readonly maxTokens?: number;
+    readonly responseFormat?: JsonValue;
+    readonly topP?: number;
+    readonly topK?: number;
+    readonly frequencyPenalty?: number;
+    readonly presencePenalty?: number;
+    readonly seed?: number;
+    readonly timeout?: number;
+    readonly parallelToolCalls?: boolean;
+    readonly reasoningEffort?: string;
+    /** Provider-specific kwargs not in the standard field set (e.g. temperature). Mirrors Python's extra="allow". */
+    readonly extras: Record<string, unknown>;
+    constructor(data: {
+        max_tokens?: number;
+        response_format?: JsonValue;
+        top_p?: number;
+        top_k?: number;
+        frequency_penalty?: number;
+        presence_penalty?: number;
+        seed?: number;
+        timeout?: number;
+        parallel_tool_calls?: boolean;
+        reasoning_effort?: string;
+        [key: string]: unknown;
+    });
+    /** Serializes to snake_case wire format so JSON.stringify round-trips through LLMInvocationOptionsSchema. */
+    toJSON(): Record<string, unknown>;
+    /** Converts to kwargs for underlying model invocation. Mirrors Python's model_dump(exclude_none=True) with extra="allow". */
+    toModelKwargs(): Record<string, unknown>;
+}
+/** Runtime validation schema for LLMInvocationOptions wire data. */
+export declare const LLMInvocationOptionsSchema: z.ZodPreprocess<z.ZodPipe<z.ZodObject<{
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    response_format: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    top_p: z.ZodOptional<z.ZodNumber>;
+    top_k: z.ZodOptional<z.ZodNumber>;
+    frequency_penalty: z.ZodOptional<z.ZodNumber>;
+    presence_penalty: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    parallel_tool_calls: z.ZodOptional<z.ZodBoolean>;
+    reasoning_effort: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, z.ZodTransform<LLMInvocationOptions, {
+    [x: string]: unknown;
+    max_tokens?: number | undefined;
+    response_format?: JsonValue | undefined;
+    top_p?: number | undefined;
+    top_k?: number | undefined;
+    frequency_penalty?: number | undefined;
+    presence_penalty?: number | undefined;
+    seed?: number | undefined;
+    timeout?: number | undefined;
+    parallel_tool_calls?: boolean | undefined;
+    reasoning_effort?: string | undefined;
+}>>>;
+/**
+ * Framework-neutral message.
+ *
+ * Content can be a simple string for text-only messages, or a list of
+ * content blocks for multimodal content (images, documents, etc.).
+ */
+export interface Message {
+    role: Role;
+    content: string | AnyContentBlock[];
+    toolCalls?: LLMToolCall[];
+    toolCallId?: string;
+    isError?: boolean;
+    name?: string;
+    id?: string;
+    additionalKwargs?: Record<string, JsonValue>;
+    responseMetadata?: Record<string, JsonValue>;
+}
+/**
+ * Runtime validation schema for Message wire data. Parses snake_case wire
+ * fields and transforms them to the camelCase Message interface shape,
+ * matching how LLMToolCallSchema/LLMTokenUsageSchema handle the same mapping.
+ */
+export declare const MessageSchema: z.ZodPipe<z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        tool: "tool";
+        system: "system";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"text">>;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"image">>;
+        url: z.ZodString;
+        mime_type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"document">>;
+        url: z.ZodString;
+        mime_type: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>]>;
+    tool_calls: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        arguments: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        type: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodTransform<LLMToolCall, {
+        id?: string | undefined;
+        name?: string | undefined;
+        args?: JsonValue | undefined;
+        arguments?: JsonValue | undefined;
+        type?: string | undefined;
+        index?: number | undefined;
+    }>>>>;
+    tool_call_id: z.ZodOptional<z.ZodString>;
+    is_error: z.ZodOptional<z.ZodBoolean>;
+    name: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    additional_kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    response_metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+}, z.core.$loose>, z.ZodTransform<Message, {
+    [x: string]: unknown;
+    role: "user" | "assistant" | "tool" | "system";
+    content: string | ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        url: string;
+        mime_type?: string | undefined;
+    } | {
+        type: "document";
+        url: string;
+        mime_type?: string | undefined;
+        filename?: string | undefined;
+    })[];
+    tool_calls?: LLMToolCall[] | undefined;
+    tool_call_id?: string | undefined;
+    is_error?: boolean | undefined;
+    name?: string | undefined;
+    id?: string | undefined;
+    additional_kwargs?: Record<string, JsonValue> | undefined;
+    response_metadata?: Record<string, JsonValue> | undefined;
+}>>;
+/**
+ * Serialize a Message to its snake_case wire shape — the camel→snake "dump"
+ * half that mirrors Python's `model_dump(by_alias=True)`. `MessageSchema` is
+ * the inverse snake→camel "parse" half.
+ *
+ * Keeping these two symmetric is what makes the representation safe: messages
+ * are camelCase internally (the `Message` interface) and snake_case on the
+ * wire, and conversion happens exactly once at each boundary. Use this when
+ * dumping an already-internal `Message`; never re-run an internal Message
+ * through `MessageSchema`, whose transform would blank the camelCase fields.
+ */
+export declare function serializeMessage(message: Message): Record<string, unknown>;
+/** Framework-neutral LLM response. */
+export declare class LLMResponse {
+    readonly content: string;
+    readonly toolCalls?: LLMToolCall[];
+    readonly metadata: Record<string, JsonValue>;
+    readonly usage?: LLMTokenUsage;
+    readonly id?: string;
+    readonly name?: string;
+    readonly additionalKwargs?: Record<string, JsonValue>;
+    readonly responseMetadata?: Record<string, JsonValue>;
+    constructor(data: {
+        content: string;
+        toolCalls?: LLMToolCall[];
+        metadata?: Record<string, JsonValue>;
+        usage?: LLMTokenUsage;
+        id?: string;
+        name?: string;
+        additionalKwargs?: Record<string, JsonValue>;
+        responseMetadata?: Record<string, JsonValue>;
+    });
+    /**
+     * Constructs an LLMResponse from a raw provider dict, normalizing usage
+     * from either a top-level 'usage' key or token keys embedded in 'metadata'.
+     */
+    static fromRaw(data: Record<string, unknown>): LLMResponse;
+}
+/** Runtime validation schema for LLMResponse wire data. `content` is the only required field. */
+export declare const LLMResponseSchema: z.ZodObject<{
+    content: z.ZodString;
+    tool_calls: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    additional_kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    response_metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/**
+ * Partial tool call during streaming.
+ *
+ * All fields are optional since chunks may contain partial data
+ * (e.g., just the start of arguments, or just the tool name).
+ */
+export interface ToolCallChunk {
+    id?: string;
+    name?: string;
+    args?: string;
+    type?: string;
+    index?: number;
+}
+/** Runtime validation schema for ToolCallChunk wire data. */
+export declare const ToolCallChunkSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Rich streaming chunk following OpenAI/Anthropic patterns.
+ *
+ * All fields are optional since different chunks contain different data:
+ * - Content chunks: text deltas during generation
+ * - Tool call chunks: partial tool calls being built up
+ * - Usage chunks: token counts at end of stream
+ */
+export interface LLMStreamChunk {
+    content?: string;
+    toolCalls?: ToolCallChunk[];
+    usage?: LLMTokenUsage;
+    id?: string;
+    name?: string;
+    additionalKwargs?: Record<string, JsonValue>;
+    responseMetadata?: Record<string, JsonValue>;
+}
+/** Input for an agent execution. Payload is an opaque JSON value. */
+export interface AgentInput {
+    payload: JsonValue;
+}
+/** Output from an agent execution. Response is an opaque JSON value. */
+export interface AgentOutput {
+    response: JsonValue;
+}
+/** Event streamed back to the caller during execution. */
+export interface StreamEvent {
+    data: JsonValue;
+    event?: string;
+}
+/** Runtime validation schema for AgentInput wire data. */
+export declare const AgentInputSchema: z.ZodObject<{
+    payload: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+}, z.core.$loose>;
+/** Runtime validation schema for AgentOutput wire data. */
+export declare const AgentOutputSchema: z.ZodObject<{
+    response: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+}, z.core.$loose>;
+/** Runtime validation schema for StreamEvent wire data. */
+export declare const StreamEventSchema: z.ZodObject<{
+    data: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+    event: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Request-scoped context passed to every agent execution.
+ *
+ * Carries framework-neutral execution identity and platform plumbing. The
+ * caller's invocation input lives in `AgentInput.payload`, not here.
+ * Suspend/resume state is opaque to the platform: `metadata` is a
+ * framework-owned blob that the platform forwards unchanged on resume.
+ */
+export interface RequestContext {
+    executionId?: string;
+    sessionId?: string;
+    userId?: string;
+    /**
+     * Tenant scope of the executing agent. Framework adapters use it to scope
+     * state stores keyed only by sessionId (e.g. the LangGraph checkpoint
+     * thread_id) so agents in the same project DB cannot collide. Mirrors
+     * Python's `RequestContext.workspace_id`.
+     */
+    workspaceId?: string;
+    requestHeaders?: Record<string, string>;
+    /** Platform suspend/resume plumbing (framework-neutral). */
+    resume?: boolean;
+    resumeData?: JsonValue | null;
+    /**
+     * True when this session's most recent prior execution was cancelled (its
+     * pod torn down mid-run). Framework adapters that persist per-step state
+     * use it to fence off the killed step's partial writes before running this
+     * turn. Mirrors Python's `previous_execution_cancelled`.
+     */
+    previousExecutionCancelled?: boolean;
+    /**
+     * Opaque framework-owned state passed through by the SDK and AER. Only the
+     * selected framework adapter may interpret its keys and values.
+     */
+    metadata?: Record<string, JsonValue> | null;
+    /**
+     * Cancellation signal for execution timeout or forced abort. The runtime
+     * (and any agent implementation that honours it) should unwind pending
+     * awaits and stop emitting events when this signal fires. Python relies on
+     * `asyncio.wait_for` for the same semantics; JS has no implicit
+     * cancellation, so the signal must be plumbed explicitly.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Per-session summary sourced from framework-specific persistence.
+ *
+ * Returned by the AER's session-enrichment endpoint. The platform layer
+ * (OE) merges this with its own tenant fields (user_id, project_id,
+ * workspace_id, visibility) when assembling the public sessions list.
+ *
+ * Mirrors Python's `SessionSummary` in `agent_engine_sdk/models.py`.
+ */
+export declare const SessionSummarySchema: z.ZodObject<{
+    session_id: z.ZodString;
+    last_activity: z.ZodString;
+    created_at: z.ZodString;
+    message_count: z.ZodNumber;
+    first_message_preview: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type SessionSummary = z.infer<typeof SessionSummarySchema>;
+/** Response for the AER's session-summary enrichment endpoint. */
+export declare const SessionsSummaryResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        session_id: z.ZodString;
+        last_activity: z.ZodString;
+        created_at: z.ZodString;
+        message_count: z.ZodNumber;
+        first_message_preview: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionsSummaryResponse = z.infer<typeof SessionsSummaryResponseSchema>;
+/**
+ * A single message in a session's conversation history.
+ *
+ * `role` uses the same vocabulary as `Message` ("user", "assistant",
+ * "tool", "system"). `name` carries the tool name on tool messages.
+ *
+ * Mirrors Python's `SessionMessage` in `agent_engine_sdk/models.py`.
+ */
+export declare const SessionMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    content: z.ZodString;
+    timestamp: z.ZodString;
+    session_id: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    tool_calls: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodPipe<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        arguments: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        type: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodTransform<LLMToolCall, {
+        id?: string | undefined;
+        name?: string | undefined;
+        args?: JsonValue | undefined;
+        arguments?: JsonValue | undefined;
+        type?: string | undefined;
+        index?: number | undefined;
+    }>>>>>;
+    tool_call_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    additional_kwargs: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type SessionMessage = z.infer<typeof SessionMessageSchema>;
+/** Response for the AER's session-messages endpoint. */
+export declare const SessionMessagesResponseSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodString;
+        content: z.ZodString;
+        timestamp: z.ZodString;
+        session_id: z.ZodString;
+        name: z.ZodDefault<z.ZodString>;
+        tool_calls: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodPipe<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+            arguments: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+            type: z.ZodOptional<z.ZodString>;
+            index: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodTransform<LLMToolCall, {
+            id?: string | undefined;
+            name?: string | undefined;
+            args?: JsonValue | undefined;
+            arguments?: JsonValue | undefined;
+            type?: string | undefined;
+            index?: number | undefined;
+        }>>>>>;
+        tool_call_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        additional_kwargs: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionMessagesResponse = z.infer<typeof SessionMessagesResponseSchema>;
+/** Parses an ISO datetime string into a Date. Rejects unparseable input. */
+export declare const DateFromStringSchema: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+/** Reference to a branch and its fork point. */
+export declare const BranchRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    root_event_id: z.ZodString;
+}, z.core.$loose>;
+export type BranchRef = z.infer<typeof BranchRefSchema>;
+/** Platform event — the storage envelope. Payloads are opaque. */
+export declare const EventSchema: z.ZodObject<{
+    event_id: z.ZodString;
+    session_id: z.ZodString;
+    parent_event_id: z.ZodOptional<z.ZodString>;
+    actor_id: z.ZodString;
+    payload: z.ZodPipe<z.ZodUnknown, z.ZodTransform<string | number | boolean | JsonValue[] | {
+        [key: string]: JsonValue;
+    } | null, unknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    branch: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        root_event_id: z.ZodString;
+    }, z.core.$loose>>;
+    timestamp: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$loose>;
+export type Event = z.infer<typeof EventSchema>;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}