@n8n/instance-ai 1.0.0

package/dist/memory/title-utils.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateToTitle = truncateToTitle;
+exports.generateThreadTitle = generateThreadTitle;
+const agent_1 = require("@mastra/core/agent");
+const MAX_TITLE_LENGTH = 60;
+function truncateToTitle(message) {
+    const text = message.trim().replace(/\s+/g, ' ');
+    if (text.length <= MAX_TITLE_LENGTH)
+        return text;
+    const truncated = text.slice(0, MAX_TITLE_LENGTH);
+    const lastSpace = truncated.lastIndexOf(' ');
+    return (lastSpace > 20 ? truncated.slice(0, lastSpace) : truncated) + '\u2026';
+}
+const TITLE_SYSTEM_PROMPT = [
+    'Generate a concise title (max 60 chars) summarizing what the user wants.',
+    'Return ONLY the title text. No quotes, colons, or explanation.',
+    'Focus on the user intent, not what the assistant might reply.',
+    'Examples: "Build Gmail to Slack workflow", "Debug failed execution", "Show project files"',
+].join('\n');
+async function generateThreadTitle(modelId, userMessage) {
+    try {
+        const agent = new agent_1.Agent({
+            id: 'thread-title-generator',
+            name: 'Thread Title Generator',
+            instructions: {
+                role: 'system',
+                content: TITLE_SYSTEM_PROMPT,
+            },
+            model: modelId,
+        });
+        const result = await agent.generate(userMessage, { maxSteps: 1 });
+        const title = result.text.trim().replace(/^["']|["']$/g, '');
+        if (!title)
+            return null;
+        return title.length > MAX_TITLE_LENGTH ? truncateToTitle(title) : title;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=title-utils.js.map

package/dist/memory/title-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-utils.js","sourceRoot":"","sources":["../../src/memory/title-utils.ts"],"names":[],"mappings":";;AAOA,0CAMC;AAaD,kDAsBC;AAhDD,8CAA2C;AAI3C,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAG5B,SAAgB,eAAe,CAAC,OAAe;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;AAChF,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC3B,0EAA0E;IAC1E,gEAAgE;IAChE,+DAA+D;IAC/D,2FAA2F;CAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAMN,KAAK,UAAU,mBAAmB,CACxC,OAAoB,EACpB,WAAmB;IAEnB,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC;YACvB,EAAE,EAAE,wBAAwB;YAC5B,IAAI,EAAE,wBAAwB;YAC9B,YAAY,EAAE;gBACb,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,mBAAmB;aAC5B;YACD,KAAK,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/memory/working-memory-template.d.ts

@@ -0,0 +1 @@
+export declare const WORKING_MEMORY_TEMPLATE = "\n# User Context\n- **Name**:\n- **Role**:\n- **Organization**:\n\n# Workflow Preferences\n- **Preferred trigger types**:\n- **Common integrations used**:\n- **Workflow naming conventions**:\n- **Error handling patterns**:\n\n# Active Project\n<!-- Keep only the ONE project the user is currently working on. Replace when the user switches projects. -->\n- **Project**:\n- **Status**:\n- **Key details**:\n\n# Known Issues\n<!-- Only unresolved issues. Remove when fixed. -->\n";

package/dist/memory/working-memory-template.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKING_MEMORY_TEMPLATE = void 0;
+exports.WORKING_MEMORY_TEMPLATE = `
+# User Context
+- **Name**:
+- **Role**:
+- **Organization**:
+
+# Workflow Preferences
+- **Preferred trigger types**:
+- **Common integrations used**:
+- **Workflow naming conventions**:
+- **Error handling patterns**:
+
+# Active Project
+<!-- Keep only the ONE project the user is currently working on. Replace when the user switches projects. -->
+- **Project**:
+- **Status**:
+- **Key details**:
+
+# Known Issues
+<!-- Only unresolved issues. Remove when fixed. -->
+`;
+//# sourceMappingURL=working-memory-template.js.map

package/dist/memory/working-memory-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-memory-template.js","sourceRoot":"","sources":["../../src/memory/working-memory-template.ts"],"names":[],"mappings":";;;AAAa,QAAA,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBtC,CAAC"}

package/dist/planned-tasks/planned-task-service.d.ts

@@ -0,0 +1,33 @@
+import type { PlannedTaskStorage } from '../storage/planned-task-storage';
+import type { PlannedTask, PlannedTaskGraph, PlannedTaskSchedulerAction, PlannedTaskService } from '../types';
+export declare class PlannedTaskCoordinator implements PlannedTaskService {
+    private readonly storage;
+    constructor(storage: PlannedTaskStorage);
+    createPlan(threadId: string, tasks: PlannedTask[], metadata: {
+        planRunId: string;
+        messageGroupId?: string;
+    }): Promise<PlannedTaskGraph>;
+    getGraph(threadId: string): Promise<PlannedTaskGraph | null>;
+    markRunning(threadId: string, taskId: string, update: {
+        agentId?: string;
+        backgroundTaskId?: string;
+        startedAt?: number;
+    }): Promise<PlannedTaskGraph | null>;
+    markSucceeded(threadId: string, taskId: string, update: {
+        result?: string;
+        outcome?: Record<string, unknown>;
+        finishedAt?: number;
+    }): Promise<PlannedTaskGraph | null>;
+    markFailed(threadId: string, taskId: string, update: {
+        error?: string;
+        finishedAt?: number;
+    }): Promise<PlannedTaskGraph | null>;
+    markCancelled(threadId: string, taskId: string, update?: {
+        error?: string;
+        finishedAt?: number;
+    }): Promise<PlannedTaskGraph | null>;
+    tick(threadId: string, options?: {
+        availableSlots?: number;
+    }): Promise<PlannedTaskSchedulerAction>;
+    clear(threadId: string): Promise<void>;
+}

package/dist/planned-tasks/planned-task-service.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlannedTaskCoordinator = void 0;
+function hasDuplicateIds(tasks) {
+    return new Set(tasks.map((task) => task.id)).size !== tasks.length;
+}
+function validateDependencies(tasks) {
+    if (hasDuplicateIds(tasks)) {
+        throw new Error('Plan contains duplicate task IDs');
+    }
+    const knownIds = new Set(tasks.map((task) => task.id));
+    for (const task of tasks) {
+        for (const depId of task.deps) {
+            if (!knownIds.has(depId)) {
+                throw new Error(`Task "${task.id}" depends on unknown task "${depId}"`);
+            }
+        }
+        if (task.kind === 'delegate' && (!task.tools || task.tools.length === 0)) {
+            throw new Error(`Delegate task "${task.id}" must include at least one tool`);
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const byId = new Map(tasks.map((task) => [task.id, task]));
+    const visit = (taskId) => {
+        if (visited.has(taskId))
+            return;
+        if (visiting.has(taskId)) {
+            throw new Error(`Plan contains a dependency cycle involving "${taskId}"`);
+        }
+        visiting.add(taskId);
+        const task = byId.get(taskId);
+        for (const depId of task?.deps ?? []) {
+            visit(depId);
+        }
+        visiting.delete(taskId);
+        visited.add(taskId);
+    };
+    for (const task of tasks) {
+        visit(task.id);
+    }
+}
+function isSuccess(task) {
+    return task.status === 'succeeded';
+}
+function updateTaskRecord(graph, taskId, updater) {
+    const index = graph.tasks.findIndex((task) => task.id === taskId);
+    if (index < 0)
+        return null;
+    const tasks = [...graph.tasks];
+    tasks[index] = updater(tasks[index]);
+    return { ...graph, tasks };
+}
+class PlannedTaskCoordinator {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async createPlan(threadId, tasks, metadata) {
+        validateDependencies(tasks);
+        const graph = {
+            planRunId: metadata.planRunId,
+            messageGroupId: metadata.messageGroupId,
+            status: 'active',
+            tasks: tasks.map((task) => ({
+                ...task,
+                status: 'planned',
+            })),
+        };
+        await this.storage.save(threadId, graph);
+        return graph;
+    }
+    async getGraph(threadId) {
+        return await this.storage.get(threadId);
+    }
+    async markRunning(threadId, taskId, update) {
+        return await this.storage.update(threadId, (graph) => updateTaskRecord(graph, taskId, (task) => ({
+            ...task,
+            status: 'running',
+            agentId: update.agentId ?? task.agentId,
+            backgroundTaskId: update.backgroundTaskId ?? task.backgroundTaskId,
+            startedAt: update.startedAt ?? task.startedAt ?? Date.now(),
+            error: undefined,
+        })));
+    }
+    async markSucceeded(threadId, taskId, update) {
+        return await this.storage.update(threadId, (graph) => updateTaskRecord(graph, taskId, (task) => ({
+            ...task,
+            status: 'succeeded',
+            result: update.result ?? task.result,
+            outcome: update.outcome ?? task.outcome,
+            finishedAt: update.finishedAt ?? Date.now(),
+            error: undefined,
+        })));
+    }
+    async markFailed(threadId, taskId, update) {
+        return await this.storage.update(threadId, (graph) => updateTaskRecord(graph, taskId, (task) => ({
+            ...task,
+            status: 'failed',
+            error: update.error ?? task.error ?? 'Unknown error',
+            finishedAt: update.finishedAt ?? Date.now(),
+        })));
+    }
+    async markCancelled(threadId, taskId, update) {
+        return await this.storage.update(threadId, (graph) => updateTaskRecord(graph, taskId, (task) => ({
+            ...task,
+            status: 'cancelled',
+            error: update?.error ?? task.error,
+            finishedAt: update?.finishedAt ?? Date.now(),
+        })));
+    }
+    async tick(threadId, options = {}) {
+        let action = { type: 'none', graph: null };
+        await this.storage.update(threadId, (graph) => {
+            if (graph.status !== 'active') {
+                action = { type: 'none', graph };
+                return graph;
+            }
+            const failedTask = graph.tasks.find((task) => task.status === 'failed');
+            if (failedTask) {
+                const nextGraph = { ...graph, status: 'awaiting_replan' };
+                action = { type: 'replan', graph: nextGraph, failedTask };
+                return nextGraph;
+            }
+            if (graph.tasks.length > 0 && graph.tasks.every(isSuccess)) {
+                const nextGraph = { ...graph, status: 'completed' };
+                action = { type: 'synthesize', graph: nextGraph };
+                return nextGraph;
+            }
+            const availableSlots = options.availableSlots ?? graph.tasks.length;
+            if (availableSlots <= 0) {
+                action = { type: 'none', graph };
+                return graph;
+            }
+            const successfulIds = new Set(graph.tasks.filter((task) => task.status === 'succeeded').map((task) => task.id));
+            const readyTasks = graph.tasks.filter((task) => task.status === 'planned' && task.deps.every((depId) => successfulIds.has(depId)));
+            if (readyTasks.length === 0) {
+                action = { type: 'none', graph };
+                return graph;
+            }
+            action = { type: 'dispatch', graph, tasks: readyTasks.slice(0, availableSlots) };
+            return graph;
+        });
+        return action;
+    }
+    async clear(threadId) {
+        await this.storage.clear(threadId);
+    }
+}
+exports.PlannedTaskCoordinator = PlannedTaskCoordinator;
+//# sourceMappingURL=planned-task-service.js.map

package/dist/planned-tasks/planned-task-service.js.map

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

package/dist/runtime/background-task-manager.d.ts

@@ -0,0 +1,53 @@
+import type { BackgroundTaskResult, InstanceAiTraceContext } from '../types';
+export type BackgroundTaskStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export interface ManagedBackgroundTask {
+    taskId: string;
+    threadId: string;
+    runId: string;
+    role: string;
+    agentId: string;
+    status: BackgroundTaskStatus;
+    result?: string;
+    error?: string;
+    startedAt: number;
+    abortController: AbortController;
+    corrections: string[];
+    messageGroupId?: string;
+    outcome?: Record<string, unknown>;
+    plannedTaskId?: string;
+    workItemId?: string;
+    traceContext?: InstanceAiTraceContext;
+}
+export interface SpawnManagedBackgroundTaskOptions {
+    taskId: string;
+    threadId: string;
+    runId: string;
+    role: string;
+    agentId: string;
+    messageGroupId?: string;
+    plannedTaskId?: string;
+    workItemId?: string;
+    traceContext?: InstanceAiTraceContext;
+    run: (signal: AbortSignal, drainCorrections: () => string[]) => Promise<string | BackgroundTaskResult>;
+    onLimitReached?: (errorMessage: string) => void;
+    onCompleted?: (task: ManagedBackgroundTask) => void | Promise<void>;
+    onFailed?: (task: ManagedBackgroundTask) => void | Promise<void>;
+    onSettled?: (task: ManagedBackgroundTask) => void | Promise<void>;
+}
+export interface BackgroundTaskMessageOptions<TTask extends ManagedBackgroundTask = ManagedBackgroundTask> {
+    formatTask?: (task: TTask) => Promise<string> | string;
+}
+export declare class BackgroundTaskManager {
+    private readonly maxConcurrentPerThread;
+    private readonly tasks;
+    constructor(maxConcurrentPerThread?: number);
+    getTaskSnapshots(threadId: string): ManagedBackgroundTask[];
+    getRunningTasks(threadId: string): ManagedBackgroundTask[];
+    queueCorrection(threadId: string, taskId: string, correction: string): 'queued' | 'task-completed' | 'task-not-found';
+    cancelTask(threadId: string, taskId: string): ManagedBackgroundTask | undefined;
+    cancelThread(threadId: string): ManagedBackgroundTask[];
+    cancelAll(): ManagedBackgroundTask[];
+    spawn(options: SpawnManagedBackgroundTaskOptions): boolean;
+    private executeTask;
+}
+export declare function enrichMessageWithRunningTasks<TTask extends ManagedBackgroundTask = ManagedBackgroundTask>(message: string, runningTasks: TTask[], options?: BackgroundTaskMessageOptions<TTask>): Promise<string>;

package/dist/runtime/background-task-manager.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundTaskManager = void 0;
+exports.enrichMessageWithRunningTasks = enrichMessageWithRunningTasks;
+class BackgroundTaskManager {
+    maxConcurrentPerThread;
+    tasks = new Map();
+    constructor(maxConcurrentPerThread = 5) {
+        this.maxConcurrentPerThread = maxConcurrentPerThread;
+    }
+    getTaskSnapshots(threadId) {
+        return [...this.tasks.values()].filter((task) => task.threadId === threadId);
+    }
+    getRunningTasks(threadId) {
+        return [...this.tasks.values()].filter((task) => task.threadId === threadId && task.status === 'running');
+    }
+    queueCorrection(threadId, taskId, correction) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.threadId !== threadId)
+            return 'task-not-found';
+        if (task.status !== 'running')
+            return 'task-completed';
+        task.corrections.push(correction);
+        return 'queued';
+    }
+    cancelTask(threadId, taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.threadId !== threadId || task.status !== 'running')
+            return undefined;
+        task.abortController.abort();
+        task.status = 'cancelled';
+        this.tasks.delete(taskId);
+        return task;
+    }
+    cancelThread(threadId) {
+        const cancelled = [];
+        for (const [taskId, task] of this.tasks) {
+            if (task.threadId !== threadId || task.status !== 'running')
+                continue;
+            task.abortController.abort();
+            task.status = 'cancelled';
+            cancelled.push(task);
+            this.tasks.delete(taskId);
+        }
+        return cancelled;
+    }
+    cancelAll() {
+        const cancelled = [];
+        for (const [taskId, task] of this.tasks) {
+            task.abortController.abort();
+            cancelled.push(task);
+            this.tasks.delete(taskId);
+        }
+        return cancelled;
+    }
+    spawn(options) {
+        const runningCount = this.getRunningTasks(options.threadId).length;
+        if (runningCount >= this.maxConcurrentPerThread) {
+            options.onLimitReached?.(`Cannot start background task: limit of ${this.maxConcurrentPerThread} concurrent tasks reached. Wait for existing tasks to complete.`);
+            return false;
+        }
+        const task = {
+            taskId: options.taskId,
+            threadId: options.threadId,
+            runId: options.runId,
+            role: options.role,
+            agentId: options.agentId,
+            status: 'running',
+            startedAt: Date.now(),
+            abortController: new AbortController(),
+            corrections: [],
+            messageGroupId: options.messageGroupId,
+            plannedTaskId: options.plannedTaskId,
+            workItemId: options.workItemId,
+            traceContext: options.traceContext,
+        };
+        this.tasks.set(options.taskId, task);
+        void this.executeTask(task, options);
+        return true;
+    }
+    async executeTask(task, options) {
+        const drainCorrections = () => {
+            const pending = [...task.corrections];
+            task.corrections.length = 0;
+            return pending;
+        };
+        try {
+            const raw = await options.run(task.abortController.signal, drainCorrections);
+            task.status = 'completed';
+            task.result = typeof raw === 'string' ? raw : raw.text;
+            task.outcome = typeof raw === 'string' ? undefined : raw.outcome;
+            await options.onCompleted?.(task);
+        }
+        catch (error) {
+            if (task.abortController.signal.aborted)
+                return;
+            task.status = 'failed';
+            task.error = error instanceof Error ? error.message : String(error);
+            await options.onFailed?.(task);
+        }
+        finally {
+            try {
+                if (!task.abortController.signal.aborted) {
+                    await options.onSettled?.(task);
+                }
+            }
+            finally {
+                this.tasks.delete(task.taskId);
+            }
+        }
+    }
+}
+exports.BackgroundTaskManager = BackgroundTaskManager;
+async function enrichMessageWithRunningTasks(message, runningTasks, options = {}) {
+    if (runningTasks.length === 0)
+        return message;
+    const parts = [];
+    for (const task of runningTasks) {
+        if (options.formatTask) {
+            parts.push(await options.formatTask(task));
+            continue;
+        }
+        parts.push(`[Running task — ${task.role}, task: ${task.taskId}]`);
+    }
+    return `<running-tasks>\n${parts.join('\n')}\n</running-tasks>\n\n${message}`;
+}
+//# sourceMappingURL=background-task-manager.js.map

package/dist/runtime/background-task-manager.js.map

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

package/dist/runtime/resumable-stream-executor.d.ts

@@ -0,0 +1,75 @@
+import type { InstanceAiEvent } from '@n8n/api-types';
+import type { RunTree } from 'langsmith';
+import type { InstanceAiEventBus } from '../event-bus';
+import type { SuspensionInfo } from '../utils/stream-helpers';
+type ConfirmationRequestEvent = Extract<InstanceAiEvent, {
+    type: 'confirmation-request';
+}>;
+export interface ResumableStreamSource {
+    runId?: string;
+    fullStream: AsyncIterable<unknown>;
+    text?: Promise<string>;
+    steps?: Promise<unknown[]>;
+    response?: Promise<unknown>;
+    finishReason?: Promise<string | undefined>;
+    request?: Promise<unknown>;
+    usage?: Promise<unknown>;
+    totalUsage?: Promise<unknown>;
+}
+export interface ResumableStreamContext {
+    threadId: string;
+    runId: string;
+    agentId: string;
+    eventBus: InstanceAiEventBus;
+    signal: AbortSignal;
+}
+export interface ManualSuspensionControl {
+    mode: 'manual';
+}
+export interface AutoResumeControl {
+    mode: 'auto';
+    waitForConfirmation: (requestId: string) => Promise<Record<string, unknown>>;
+    drainCorrections?: () => string[];
+    onSuspension?: (suspension: SuspensionInfo) => void;
+    buildResumeOptions?: (input: {
+        mastraRunId: string;
+        suspension: SuspensionInfo;
+    }) => Record<string, unknown>;
+}
+export type ResumableStreamControl = ManualSuspensionControl | AutoResumeControl;
+export interface ExecuteResumableStreamOptions {
+    agent: unknown;
+    stream: ResumableStreamSource;
+    context: ResumableStreamContext;
+    control: ResumableStreamControl;
+    initialMastraRunId?: string;
+    llmStepTraceHooks?: LlmStepTraceHooks;
+    workingMemoryEnabled?: boolean;
+}
+export interface ExecuteResumableStreamResult {
+    status: 'completed' | 'cancelled' | 'suspended' | 'errored';
+    mastraRunId: string;
+    text?: Promise<string>;
+    suspension?: SuspensionInfo;
+    confirmationEvent?: ConfirmationRequestEvent;
+}
+export interface LlmStepTraceHooks {
+    executionOptions: {
+        prepareStep?: (options: unknown) => Promise<undefined>;
+        experimental_prepareStep?: (options: unknown) => Promise<undefined>;
+        experimental_onStepStart?: (options: unknown) => Promise<void>;
+        onStepFinish: (stepResult: unknown) => Promise<void>;
+        experimental_telemetry?: {
+            isEnabled: boolean;
+        };
+    };
+    onStreamChunk: (chunk: unknown) => void;
+    startSegment: () => void;
+    finalize: (source: ResumableStreamSource, options?: {
+        status?: 'completed' | 'cancelled' | 'suspended';
+        error?: string;
+    }) => Promise<void>;
+}
+export declare function createLlmStepTraceHooks(explicitParentRun?: RunTree): LlmStepTraceHooks | undefined;
+export declare function executeResumableStream(options: ExecuteResumableStreamOptions): Promise<ExecuteResumableStreamResult>;
+export {};