@mantyx/sdk 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,264 +1,6 @@
+export { A as A2AToolRef, a as AgentSession, b as AgentSpecBase, c as AssistantDeltaEvent, d as AssistantMessageEvent, C as CancelledEvent, D as DEFAULT_BASE_URL, e as DefineLocalA2AOptions, f as DefineLocalMcpOptions, g as DefineLocalToolOptions, E as ErrorEvent, L as LocalA2ATool, h as LocalHandlers, i as LocalMcpHttpTransport, j as LocalMcpServer, k as LocalMcpStdioTransport, l as LocalTool, m as LocalToolCallEvent, n as LocalToolResultInEvent, o as MantyxA2AOptions, M as MantyxClient, p as MantyxClientOptions, q as MantyxMcpOptions, r as MantyxPluginToolRef, s as MantyxToolRef, t as McpToolRef, u as ModelCatalog, v as ModelInfo, O as OutputSchema, R as ReasoningLevel, w as ResultEvent, x as RunEvent, y as RunEventBase, z as RunResult, B as RunSpec, S as ServerToolResultEvent, F as SessionInfo, G as SessionSpec, H as ThinkingDeltaEvent, T as ToolRef, Z as ZodLikeObject, I as defineLocalA2A, J as defineLocalMcp, K as defineLocalTool, N as isLocalA2ATool, P as isLocalMcpServer, Q as isLocalTool, U as mantyxA2A, V as mantyxMcp, W as mantyxPluginTool, X as mantyxTool, Y as parseRunOutput } from './client-ChxfhYBJ.cjs';
 import { z } from 'zod';
 
-/**
- * Public tool helpers for the MANTYX SDK.
- *
- *   defineLocalTool({ name, description, parameters, execute })
- *     → A tool that runs in the developer's process. The MANTYX server pauses
- *       the agent loop, emits a `local_tool_call` event, and waits for the SDK
- *       to POST the result back.
- *
- *   mantyxTool(id)            → Reference an existing workspace `Tool` row by id.
- *   mantyxPluginTool(name)    → Reference a built-in plugin tool by `@plugin/tool` name.
- */
-
-type ZodLikeObject = z.ZodType<Record<string, unknown>> & {
-    _def?: unknown;
-    parse?: (value: unknown) => unknown;
-};
-interface LocalTool<TArgs = Record<string, unknown>> {
-    readonly kind: "local";
-    readonly name: string;
-    readonly description: string;
-    readonly parameters: ZodLikeObject | undefined;
-    readonly execute: (args: TArgs) => Promise<string> | string;
-}
-interface MantyxToolRef {
-    readonly kind: "mantyx";
-    readonly id: string;
-}
-interface MantyxPluginToolRef {
-    readonly kind: "mantyx_plugin";
-    readonly name: string;
-}
-type ToolRef = MantyxToolRef | MantyxPluginToolRef | LocalTool;
-interface DefineLocalToolOptions<T extends ZodLikeObject | undefined> {
-    /** Lowercase alphanumeric + underscore, max 64 chars. */
-    name: string;
-    description?: string;
-    parameters?: T;
-    execute: (args: T extends ZodLikeObject ? z.infer<T> : Record<string, unknown>) => Promise<string> | string;
-}
-declare function defineLocalTool<T extends ZodLikeObject | undefined>(opts: DefineLocalToolOptions<T>): LocalTool;
-declare function mantyxTool(id: string): MantyxToolRef;
-declare function mantyxPluginTool(name: string): MantyxPluginToolRef;
-declare function isLocalTool(t: ToolRef): t is LocalTool;
-
-declare const DEFAULT_BASE_URL = "https://app.mantyx.io";
-interface MantyxClientOptions {
-    apiKey: string;
-    workspaceSlug: string;
-    /** Defaults to `https://app.mantyx.io`. Override for self-hosted instances. */
-    baseUrl?: string;
-    /** Optional `fetch` override (e.g. node-fetch wrapper, or a custom HTTP client). */
-    fetch?: typeof fetch;
-    /** Default per-request timeout in milliseconds. Default: 60s. */
-    timeoutMs?: number;
-}
-interface ModelInfo {
-    id: string;
-    label: string;
-    provider: string;
-    vendorModelId: string;
-    source: "workspace_provider" | "platform_offering";
-    contextWindowTokens: number | null;
-    pricing: {
-        inputPer1MUsd: number | null;
-        outputPer1MUsd: number | null;
-        cacheReadPer1MUsd: number | null;
-    } | null;
-}
-interface ModelCatalog {
-    models: ModelInfo[];
-    defaultModelId: string | null;
-}
-interface AgentSpecBase {
-    name?: string;
-    /**
-     * Reference to a persisted MANTYX agent in this workspace. When set, the
-     * server hydrates `systemPrompt`, `modelId`, and the agent's own tools
-     * (memory, skills, plugin tools, …) from the Agent row at run time, and any
-     * `tools` you supply here are merged on top — typically `local` tools the
-     * SDK wants the agent to be able to call back into.
-     *
-     * Either `agentId` or `systemPrompt` must be set.
-     */
-    agentId?: string;
-    /** Required unless `agentId` is set. */
-    systemPrompt?: string;
-    modelId?: string;
-    tools?: ToolRef[];
-    budgets?: {
-        maxToolTurns?: number;
-    };
-    /**
-     * Flat string→string KV carried alongside the run / session for
-     * observability. Use it to tag runs with your own application identifiers
-     * (customer id, environment, workflow name, …) — the values are visible in
-     * the MANTYX dashboard and can be filtered there.
-     *
-     * Limits enforced server-side: max 16 entries; keys match
-     * `[A-Za-z0-9._-]{1,64}`; values are strings ≤ 256 chars; serialized JSON
-     * ≤ 4 KB. For session-scoped runs, the session's metadata is inherited and
-     * any per-message override is merged on top.
-     */
-    metadata?: Record<string, string>;
-}
-interface RunSpec extends AgentSpecBase {
-    prompt?: string;
-    messages?: Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>;
-    /** Receives streaming assistant text deltas. */
-    onAssistantDelta?: (delta: string) => void;
-    /** Receives raw events (assistant_message, local_tool_call, tool_result, ...) for advanced consumers. */
-    onEvent?: (event: RunEvent) => void;
-    /** Aborts the run on the client and best-effort cancels server-side. */
-    signal?: AbortSignal;
-}
-type SessionSpec = AgentSpecBase;
-interface RunResult {
-    runId: string;
-    text: string;
-    events: RunEvent[];
-}
-interface RunEventBase {
-    seq: number;
-    type: string;
-}
-interface AssistantDeltaEvent extends RunEventBase {
-    type: "assistant_delta";
-    text: string;
-}
-interface ThinkingDeltaEvent extends RunEventBase {
-    type: "thinking_delta";
-    text: string;
-}
-interface AssistantMessageEvent extends RunEventBase {
-    type: "assistant_message";
-    text: string;
-}
-interface ServerToolResultEvent extends RunEventBase {
-    type: "tool_result";
-    name: string;
-    args?: Record<string, unknown>;
-    ok?: boolean;
-    summary?: string;
-    phase?: "start" | "end";
-}
-interface LocalToolCallEvent extends RunEventBase {
-    type: "local_tool_call";
-    toolUseId: string;
-    name: string;
-    args: Record<string, unknown>;
-}
-interface LocalToolResultInEvent extends RunEventBase {
-    type: "local_tool_result_in";
-    toolUseId: string;
-    result?: string;
-    error?: string;
-}
-interface ResultEvent extends RunEventBase {
-    type: "result";
-    subtype: string;
-    text?: string;
-    error?: string;
-}
-interface ErrorEvent extends RunEventBase {
-    type: "error";
-    error: string;
-    code?: string;
-}
-interface CancelledEvent extends RunEventBase {
-    type: "cancelled";
-    reason?: string;
-}
-type RunEvent = AssistantDeltaEvent | ThinkingDeltaEvent | AssistantMessageEvent | ServerToolResultEvent | LocalToolCallEvent | LocalToolResultInEvent | ResultEvent | ErrorEvent | CancelledEvent | (RunEventBase & {
-    type: string;
-    [key: string]: unknown;
-});
-interface SessionInfo {
-    id: string;
-    name: string;
-    status: "active" | "ended";
-    createdAt: string;
-    lastUsedAt: string;
-    endedAt: string | null;
-    agentSpec: AgentSpecBase;
-    messages: Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>;
-    /** Metadata that was attached to the session at create time, returned for observability. */
-    metadata: Record<string, string>;
-}
-declare class MantyxClient {
-    readonly options: Required<Pick<MantyxClientOptions, "apiKey" | "workspaceSlug" | "baseUrl">> & {
-        fetch: typeof fetch;
-        timeoutMs: number;
-    };
-    constructor(opts: MantyxClientOptions);
-    listModels(): Promise<ModelCatalog>;
-    runAgent(spec: RunSpec): Promise<RunResult>;
-    streamAgent(spec: RunSpec): AsyncGenerator<RunEvent, void, void>;
-    createSession(spec: SessionSpec): Promise<AgentSession>;
-    resumeSession(sessionId: string, opts?: {
-        tools?: ToolRef[];
-    }): Promise<AgentSession>;
-    endSession(sessionId: string): Promise<void>;
-    getSessionInfo(sessionId: string): Promise<SessionInfo>;
-    /** Drive an existing run to completion (collect events, dispatch local tools). */
-    driveRun(runId: string, handlers: Map<string, LocalTool>, opts?: {
-        onAssistantDelta?: (delta: string) => void;
-        onEvent?: (event: RunEvent) => void;
-        signal?: AbortSignal;
-    }): Promise<RunResult>;
-    streamRunEvents(runId: string, handlers: Map<string, LocalTool>, signal?: AbortSignal): AsyncGenerator<RunEvent, void, void>;
-    dispatchLocalTool(runId: string, ev: LocalToolCallEvent, handlers: Map<string, LocalTool>): Promise<void>;
-    postToolResult(runId: string, toolUseId: string, payload: {
-        result?: string;
-        error?: string;
-    }): Promise<void>;
-    cancelRun(runId: string): Promise<void>;
-    private absoluteUrl;
-    private authHeaders;
-    request<T>(args: {
-        method: string;
-        path: string;
-        body?: unknown;
-        timeoutMs?: number;
-    }): Promise<T>;
-    private errorFromResponse;
-}
-declare class AgentSession {
-    readonly id: string;
-    readonly client: MantyxClient;
-    private readonly handlers;
-    private readonly toolsForResume;
-    constructor(client: MantyxClient, id: string, handlers: Map<string, LocalTool>, toolsForResume?: ToolRef[]);
-    send(prompt: string, opts?: {
-        onAssistantDelta?: (s: string) => void;
-        signal?: AbortSignal;
-        /**
-         * Per-message metadata override. Server-side this is merged on top of
-         * the session's metadata at run-creation time (run-level keys win).
-         * Useful for tagging individual turns (e.g. `{ "trace_id": "abc" }`).
-         */
-        metadata?: Record<string, string>;
-    }): Promise<RunResult>;
-    stream(prompt: string, opts?: {
-        signal?: AbortSignal;
-        metadata?: Record<string, string>;
-    }): AsyncGenerator<RunEvent, void, void>;
-    history(): Promise<Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>>;
-    info(): Promise<SessionInfo>;
-    end(): Promise<void>;
-}
-
 /**
  * Error types raised by the MANTYX SDK.
  */
@@ -289,6 +31,20 @@ declare class MantyxRunError extends MantyxError {
     readonly subtype: string;
     constructor(runId: string, subtype: string, message: string);
 }
+/**
+ * Thrown by {@link parseRunOutput} when the run's terminal text was supposed
+ * to be a JSON document (because `outputSchema` was set on the spec) but
+ * either failed to JSON.parse or failed the user-supplied validator.
+ *
+ * The original `text` is preserved on the `text` field so callers can log
+ * the raw model output for debugging.
+ */
+declare class MantyxParseError extends MantyxError {
+    readonly text: string;
+    constructor(message: string, text: string, opts?: {
+        cause?: unknown;
+    });
+}
 
 /**
  * Lightweight Zod → JSON Schema converter for tool parameter definitions.
@@ -341,6 +97,6 @@ declare function readSseStream(body: ReadableStream<Uint8Array> | null, opts?: S
 /**
  * Release version — synced from repo root VERSION (`npm run sync-version`).
  */
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.4.0";
 
-export { AgentSession, type AgentSpecBase, type AssistantDeltaEvent, type AssistantMessageEvent, type CancelledEvent, DEFAULT_BASE_URL, type DefineLocalToolOptions, type ErrorEvent, type LocalTool, type LocalToolCallEvent, type LocalToolResultInEvent, MantyxAuthError, MantyxClient, type MantyxClientOptions, MantyxError, MantyxNetworkError, type MantyxPluginToolRef, MantyxRunError, MantyxToolError, type MantyxToolRef, type ModelCatalog, type ModelInfo, type ResultEvent, type RunEvent, type RunEventBase, type RunResult, type RunSpec, SDK_VERSION, type ServerToolResultEvent, type SessionInfo, type SessionSpec, type SseEvent, type SseStreamOptions, type ThinkingDeltaEvent, type ToolRef, type ZodLikeObject, defineLocalTool, isLocalTool, mantyxPluginTool, mantyxTool, readSseStream, toToolParametersWire, zodToJsonSchema };
+export { MantyxAuthError, MantyxError, MantyxNetworkError, MantyxParseError, MantyxRunError, MantyxToolError, SDK_VERSION, type SseEvent, type SseStreamOptions, readSseStream, toToolParametersWire, zodToJsonSchema };

package/dist/index.d.ts

@@ -1,264 +1,6 @@
+export { A as A2AToolRef, a as AgentSession, b as AgentSpecBase, c as AssistantDeltaEvent, d as AssistantMessageEvent, C as CancelledEvent, D as DEFAULT_BASE_URL, e as DefineLocalA2AOptions, f as DefineLocalMcpOptions, g as DefineLocalToolOptions, E as ErrorEvent, L as LocalA2ATool, h as LocalHandlers, i as LocalMcpHttpTransport, j as LocalMcpServer, k as LocalMcpStdioTransport, l as LocalTool, m as LocalToolCallEvent, n as LocalToolResultInEvent, o as MantyxA2AOptions, M as MantyxClient, p as MantyxClientOptions, q as MantyxMcpOptions, r as MantyxPluginToolRef, s as MantyxToolRef, t as McpToolRef, u as ModelCatalog, v as ModelInfo, O as OutputSchema, R as ReasoningLevel, w as ResultEvent, x as RunEvent, y as RunEventBase, z as RunResult, B as RunSpec, S as ServerToolResultEvent, F as SessionInfo, G as SessionSpec, H as ThinkingDeltaEvent, T as ToolRef, Z as ZodLikeObject, I as defineLocalA2A, J as defineLocalMcp, K as defineLocalTool, N as isLocalA2ATool, P as isLocalMcpServer, Q as isLocalTool, U as mantyxA2A, V as mantyxMcp, W as mantyxPluginTool, X as mantyxTool, Y as parseRunOutput } from './client-ChxfhYBJ.js';
 import { z } from 'zod';
 
-/**
- * Public tool helpers for the MANTYX SDK.
- *
- *   defineLocalTool({ name, description, parameters, execute })
- *     → A tool that runs in the developer's process. The MANTYX server pauses
- *       the agent loop, emits a `local_tool_call` event, and waits for the SDK
- *       to POST the result back.
- *
- *   mantyxTool(id)            → Reference an existing workspace `Tool` row by id.
- *   mantyxPluginTool(name)    → Reference a built-in plugin tool by `@plugin/tool` name.
- */
-
-type ZodLikeObject = z.ZodType<Record<string, unknown>> & {
-    _def?: unknown;
-    parse?: (value: unknown) => unknown;
-};
-interface LocalTool<TArgs = Record<string, unknown>> {
-    readonly kind: "local";
-    readonly name: string;
-    readonly description: string;
-    readonly parameters: ZodLikeObject | undefined;
-    readonly execute: (args: TArgs) => Promise<string> | string;
-}
-interface MantyxToolRef {
-    readonly kind: "mantyx";
-    readonly id: string;
-}
-interface MantyxPluginToolRef {
-    readonly kind: "mantyx_plugin";
-    readonly name: string;
-}
-type ToolRef = MantyxToolRef | MantyxPluginToolRef | LocalTool;
-interface DefineLocalToolOptions<T extends ZodLikeObject | undefined> {
-    /** Lowercase alphanumeric + underscore, max 64 chars. */
-    name: string;
-    description?: string;
-    parameters?: T;
-    execute: (args: T extends ZodLikeObject ? z.infer<T> : Record<string, unknown>) => Promise<string> | string;
-}
-declare function defineLocalTool<T extends ZodLikeObject | undefined>(opts: DefineLocalToolOptions<T>): LocalTool;
-declare function mantyxTool(id: string): MantyxToolRef;
-declare function mantyxPluginTool(name: string): MantyxPluginToolRef;
-declare function isLocalTool(t: ToolRef): t is LocalTool;
-
-declare const DEFAULT_BASE_URL = "https://app.mantyx.io";
-interface MantyxClientOptions {
-    apiKey: string;
-    workspaceSlug: string;
-    /** Defaults to `https://app.mantyx.io`. Override for self-hosted instances. */
-    baseUrl?: string;
-    /** Optional `fetch` override (e.g. node-fetch wrapper, or a custom HTTP client). */
-    fetch?: typeof fetch;
-    /** Default per-request timeout in milliseconds. Default: 60s. */
-    timeoutMs?: number;
-}
-interface ModelInfo {
-    id: string;
-    label: string;
-    provider: string;
-    vendorModelId: string;
-    source: "workspace_provider" | "platform_offering";
-    contextWindowTokens: number | null;
-    pricing: {
-        inputPer1MUsd: number | null;
-        outputPer1MUsd: number | null;
-        cacheReadPer1MUsd: number | null;
-    } | null;
-}
-interface ModelCatalog {
-    models: ModelInfo[];
-    defaultModelId: string | null;
-}
-interface AgentSpecBase {
-    name?: string;
-    /**
-     * Reference to a persisted MANTYX agent in this workspace. When set, the
-     * server hydrates `systemPrompt`, `modelId`, and the agent's own tools
-     * (memory, skills, plugin tools, …) from the Agent row at run time, and any
-     * `tools` you supply here are merged on top — typically `local` tools the
-     * SDK wants the agent to be able to call back into.
-     *
-     * Either `agentId` or `systemPrompt` must be set.
-     */
-    agentId?: string;
-    /** Required unless `agentId` is set. */
-    systemPrompt?: string;
-    modelId?: string;
-    tools?: ToolRef[];
-    budgets?: {
-        maxToolTurns?: number;
-    };
-    /**
-     * Flat string→string KV carried alongside the run / session for
-     * observability. Use it to tag runs with your own application identifiers
-     * (customer id, environment, workflow name, …) — the values are visible in
-     * the MANTYX dashboard and can be filtered there.
-     *
-     * Limits enforced server-side: max 16 entries; keys match
-     * `[A-Za-z0-9._-]{1,64}`; values are strings ≤ 256 chars; serialized JSON
-     * ≤ 4 KB. For session-scoped runs, the session's metadata is inherited and
-     * any per-message override is merged on top.
-     */
-    metadata?: Record<string, string>;
-}
-interface RunSpec extends AgentSpecBase {
-    prompt?: string;
-    messages?: Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>;
-    /** Receives streaming assistant text deltas. */
-    onAssistantDelta?: (delta: string) => void;
-    /** Receives raw events (assistant_message, local_tool_call, tool_result, ...) for advanced consumers. */
-    onEvent?: (event: RunEvent) => void;
-    /** Aborts the run on the client and best-effort cancels server-side. */
-    signal?: AbortSignal;
-}
-type SessionSpec = AgentSpecBase;
-interface RunResult {
-    runId: string;
-    text: string;
-    events: RunEvent[];
-}
-interface RunEventBase {
-    seq: number;
-    type: string;
-}
-interface AssistantDeltaEvent extends RunEventBase {
-    type: "assistant_delta";
-    text: string;
-}
-interface ThinkingDeltaEvent extends RunEventBase {
-    type: "thinking_delta";
-    text: string;
-}
-interface AssistantMessageEvent extends RunEventBase {
-    type: "assistant_message";
-    text: string;
-}
-interface ServerToolResultEvent extends RunEventBase {
-    type: "tool_result";
-    name: string;
-    args?: Record<string, unknown>;
-    ok?: boolean;
-    summary?: string;
-    phase?: "start" | "end";
-}
-interface LocalToolCallEvent extends RunEventBase {
-    type: "local_tool_call";
-    toolUseId: string;
-    name: string;
-    args: Record<string, unknown>;
-}
-interface LocalToolResultInEvent extends RunEventBase {
-    type: "local_tool_result_in";
-    toolUseId: string;
-    result?: string;
-    error?: string;
-}
-interface ResultEvent extends RunEventBase {
-    type: "result";
-    subtype: string;
-    text?: string;
-    error?: string;
-}
-interface ErrorEvent extends RunEventBase {
-    type: "error";
-    error: string;
-    code?: string;
-}
-interface CancelledEvent extends RunEventBase {
-    type: "cancelled";
-    reason?: string;
-}
-type RunEvent = AssistantDeltaEvent | ThinkingDeltaEvent | AssistantMessageEvent | ServerToolResultEvent | LocalToolCallEvent | LocalToolResultInEvent | ResultEvent | ErrorEvent | CancelledEvent | (RunEventBase & {
-    type: string;
-    [key: string]: unknown;
-});
-interface SessionInfo {
-    id: string;
-    name: string;
-    status: "active" | "ended";
-    createdAt: string;
-    lastUsedAt: string;
-    endedAt: string | null;
-    agentSpec: AgentSpecBase;
-    messages: Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>;
-    /** Metadata that was attached to the session at create time, returned for observability. */
-    metadata: Record<string, string>;
-}
-declare class MantyxClient {
-    readonly options: Required<Pick<MantyxClientOptions, "apiKey" | "workspaceSlug" | "baseUrl">> & {
-        fetch: typeof fetch;
-        timeoutMs: number;
-    };
-    constructor(opts: MantyxClientOptions);
-    listModels(): Promise<ModelCatalog>;
-    runAgent(spec: RunSpec): Promise<RunResult>;
-    streamAgent(spec: RunSpec): AsyncGenerator<RunEvent, void, void>;
-    createSession(spec: SessionSpec): Promise<AgentSession>;
-    resumeSession(sessionId: string, opts?: {
-        tools?: ToolRef[];
-    }): Promise<AgentSession>;
-    endSession(sessionId: string): Promise<void>;
-    getSessionInfo(sessionId: string): Promise<SessionInfo>;
-    /** Drive an existing run to completion (collect events, dispatch local tools). */
-    driveRun(runId: string, handlers: Map<string, LocalTool>, opts?: {
-        onAssistantDelta?: (delta: string) => void;
-        onEvent?: (event: RunEvent) => void;
-        signal?: AbortSignal;
-    }): Promise<RunResult>;
-    streamRunEvents(runId: string, handlers: Map<string, LocalTool>, signal?: AbortSignal): AsyncGenerator<RunEvent, void, void>;
-    dispatchLocalTool(runId: string, ev: LocalToolCallEvent, handlers: Map<string, LocalTool>): Promise<void>;
-    postToolResult(runId: string, toolUseId: string, payload: {
-        result?: string;
-        error?: string;
-    }): Promise<void>;
-    cancelRun(runId: string): Promise<void>;
-    private absoluteUrl;
-    private authHeaders;
-    request<T>(args: {
-        method: string;
-        path: string;
-        body?: unknown;
-        timeoutMs?: number;
-    }): Promise<T>;
-    private errorFromResponse;
-}
-declare class AgentSession {
-    readonly id: string;
-    readonly client: MantyxClient;
-    private readonly handlers;
-    private readonly toolsForResume;
-    constructor(client: MantyxClient, id: string, handlers: Map<string, LocalTool>, toolsForResume?: ToolRef[]);
-    send(prompt: string, opts?: {
-        onAssistantDelta?: (s: string) => void;
-        signal?: AbortSignal;
-        /**
-         * Per-message metadata override. Server-side this is merged on top of
-         * the session's metadata at run-creation time (run-level keys win).
-         * Useful for tagging individual turns (e.g. `{ "trace_id": "abc" }`).
-         */
-        metadata?: Record<string, string>;
-    }): Promise<RunResult>;
-    stream(prompt: string, opts?: {
-        signal?: AbortSignal;
-        metadata?: Record<string, string>;
-    }): AsyncGenerator<RunEvent, void, void>;
-    history(): Promise<Array<{
-        role: "user" | "assistant" | "system";
-        content: string;
-    }>>;
-    info(): Promise<SessionInfo>;
-    end(): Promise<void>;
-}
-
 /**
  * Error types raised by the MANTYX SDK.
  */
@@ -289,6 +31,20 @@ declare class MantyxRunError extends MantyxError {
     readonly subtype: string;
     constructor(runId: string, subtype: string, message: string);
 }
+/**
+ * Thrown by {@link parseRunOutput} when the run's terminal text was supposed
+ * to be a JSON document (because `outputSchema` was set on the spec) but
+ * either failed to JSON.parse or failed the user-supplied validator.
+ *
+ * The original `text` is preserved on the `text` field so callers can log
+ * the raw model output for debugging.
+ */
+declare class MantyxParseError extends MantyxError {
+    readonly text: string;
+    constructor(message: string, text: string, opts?: {
+        cause?: unknown;
+    });
+}
 
 /**
  * Lightweight Zod → JSON Schema converter for tool parameter definitions.
@@ -341,6 +97,6 @@ declare function readSseStream(body: ReadableStream<Uint8Array> | null, opts?: S
 /**
  * Release version — synced from repo root VERSION (`npm run sync-version`).
  */
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.4.0";
 
-export { AgentSession, type AgentSpecBase, type AssistantDeltaEvent, type AssistantMessageEvent, type CancelledEvent, DEFAULT_BASE_URL, type DefineLocalToolOptions, type ErrorEvent, type LocalTool, type LocalToolCallEvent, type LocalToolResultInEvent, MantyxAuthError, MantyxClient, type MantyxClientOptions, MantyxError, MantyxNetworkError, type MantyxPluginToolRef, MantyxRunError, MantyxToolError, type MantyxToolRef, type ModelCatalog, type ModelInfo, type ResultEvent, type RunEvent, type RunEventBase, type RunResult, type RunSpec, SDK_VERSION, type ServerToolResultEvent, type SessionInfo, type SessionSpec, type SseEvent, type SseStreamOptions, type ThinkingDeltaEvent, type ToolRef, type ZodLikeObject, defineLocalTool, isLocalTool, mantyxPluginTool, mantyxTool, readSseStream, toToolParametersWire, zodToJsonSchema };
+export { MantyxAuthError, MantyxError, MantyxNetworkError, MantyxParseError, MantyxRunError, MantyxToolError, SDK_VERSION, type SseEvent, type SseStreamOptions, readSseStream, toToolParametersWire, zodToJsonSchema };