@n8n/instance-ai 1.0.0

package/dist/storage/workflow-loop-storage.d.ts

@@ -0,0 +1,217 @@
+import type { Memory } from '@mastra/memory';
+import { z } from 'zod';
+import type { AttemptRecord, WorkflowBuildOutcome, WorkflowLoopState } from '../workflow-loop/workflow-loop-state';
+declare const workItemRecordSchema: z.ZodObject<{
+    state: z.ZodObject<{
+        workItemId: z.ZodString;
+        threadId: z.ZodString;
+        workflowId: z.ZodOptional<z.ZodString>;
+        phase: z.ZodEnum<["building", "verifying", "repairing", "done", "blocked"]>;
+        status: z.ZodEnum<["active", "completed", "blocked"]>;
+        source: z.ZodEnum<["create", "modify"]>;
+        lastTaskId: z.ZodOptional<z.ZodString>;
+        lastExecutionId: z.ZodOptional<z.ZodString>;
+        lastFailureSignature: z.ZodOptional<z.ZodString>;
+        rebuildAttempts: z.ZodNumber;
+        mockedCredentialTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "blocked" | "active" | "completed";
+        workItemId: string;
+        threadId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        source: "create" | "modify";
+        rebuildAttempts: number;
+        workflowId?: string | undefined;
+        lastTaskId?: string | undefined;
+        lastExecutionId?: string | undefined;
+        lastFailureSignature?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+    }, {
+        status: "blocked" | "active" | "completed";
+        workItemId: string;
+        threadId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        source: "create" | "modify";
+        rebuildAttempts: number;
+        workflowId?: string | undefined;
+        lastTaskId?: string | undefined;
+        lastExecutionId?: string | undefined;
+        lastFailureSignature?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+    }>;
+    attempts: z.ZodArray<z.ZodObject<{
+        workItemId: z.ZodString;
+        phase: z.ZodEnum<["building", "verifying", "repairing", "done", "blocked"]>;
+        attempt: z.ZodNumber;
+        action: z.ZodEnum<["build", "verify", "rebuild", "patch"]>;
+        result: z.ZodEnum<["success", "failure", "blocked"]>;
+        workflowId: z.ZodOptional<z.ZodString>;
+        executionId: z.ZodOptional<z.ZodString>;
+        failureSignature: z.ZodOptional<z.ZodString>;
+        diagnosis: z.ZodOptional<z.ZodString>;
+        fixApplied: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        attempt: number;
+        action: "build" | "verify" | "rebuild" | "patch";
+        result: "blocked" | "success" | "failure";
+        workItemId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        createdAt: string;
+        diagnosis?: string | undefined;
+        fixApplied?: string | undefined;
+        workflowId?: string | undefined;
+        executionId?: string | undefined;
+        failureSignature?: string | undefined;
+    }, {
+        attempt: number;
+        action: "build" | "verify" | "rebuild" | "patch";
+        result: "blocked" | "success" | "failure";
+        workItemId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        createdAt: string;
+        diagnosis?: string | undefined;
+        fixApplied?: string | undefined;
+        workflowId?: string | undefined;
+        executionId?: string | undefined;
+        failureSignature?: string | undefined;
+    }>, "many">;
+    lastBuildOutcome: z.ZodOptional<z.ZodObject<{
+        workItemId: z.ZodString;
+        taskId: z.ZodString;
+        workflowId: z.ZodOptional<z.ZodString>;
+        submitted: z.ZodBoolean;
+        triggerType: z.ZodEnum<["manual_or_testable", "trigger_only"]>;
+        needsUserInput: z.ZodBoolean;
+        blockingReason: z.ZodOptional<z.ZodString>;
+        failureSignature: z.ZodOptional<z.ZodString>;
+        mockedNodeNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mockedCredentialTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mockedCredentialsByNode: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        verificationPinData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>>;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workItemId: string;
+        taskId: string;
+        submitted: boolean;
+        triggerType: "manual_or_testable" | "trigger_only";
+        needsUserInput: boolean;
+        summary: string;
+        workflowId?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+        failureSignature?: string | undefined;
+        blockingReason?: string | undefined;
+        mockedNodeNames?: string[] | undefined;
+        mockedCredentialsByNode?: Record<string, string[]> | undefined;
+        verificationPinData?: Record<string, Record<string, unknown>[]> | undefined;
+    }, {
+        workItemId: string;
+        taskId: string;
+        submitted: boolean;
+        triggerType: "manual_or_testable" | "trigger_only";
+        needsUserInput: boolean;
+        summary: string;
+        workflowId?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+        failureSignature?: string | undefined;
+        blockingReason?: string | undefined;
+        mockedNodeNames?: string[] | undefined;
+        mockedCredentialsByNode?: Record<string, string[]> | undefined;
+        verificationPinData?: Record<string, Record<string, unknown>[]> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    state: {
+        status: "blocked" | "active" | "completed";
+        workItemId: string;
+        threadId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        source: "create" | "modify";
+        rebuildAttempts: number;
+        workflowId?: string | undefined;
+        lastTaskId?: string | undefined;
+        lastExecutionId?: string | undefined;
+        lastFailureSignature?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+    };
+    attempts: {
+        attempt: number;
+        action: "build" | "verify" | "rebuild" | "patch";
+        result: "blocked" | "success" | "failure";
+        workItemId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        createdAt: string;
+        diagnosis?: string | undefined;
+        fixApplied?: string | undefined;
+        workflowId?: string | undefined;
+        executionId?: string | undefined;
+        failureSignature?: string | undefined;
+    }[];
+    lastBuildOutcome?: {
+        workItemId: string;
+        taskId: string;
+        submitted: boolean;
+        triggerType: "manual_or_testable" | "trigger_only";
+        needsUserInput: boolean;
+        summary: string;
+        workflowId?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+        failureSignature?: string | undefined;
+        blockingReason?: string | undefined;
+        mockedNodeNames?: string[] | undefined;
+        mockedCredentialsByNode?: Record<string, string[]> | undefined;
+        verificationPinData?: Record<string, Record<string, unknown>[]> | undefined;
+    } | undefined;
+}, {
+    state: {
+        status: "blocked" | "active" | "completed";
+        workItemId: string;
+        threadId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        source: "create" | "modify";
+        rebuildAttempts: number;
+        workflowId?: string | undefined;
+        lastTaskId?: string | undefined;
+        lastExecutionId?: string | undefined;
+        lastFailureSignature?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+    };
+    attempts: {
+        attempt: number;
+        action: "build" | "verify" | "rebuild" | "patch";
+        result: "blocked" | "success" | "failure";
+        workItemId: string;
+        phase: "building" | "verifying" | "repairing" | "done" | "blocked";
+        createdAt: string;
+        diagnosis?: string | undefined;
+        fixApplied?: string | undefined;
+        workflowId?: string | undefined;
+        executionId?: string | undefined;
+        failureSignature?: string | undefined;
+    }[];
+    lastBuildOutcome?: {
+        workItemId: string;
+        taskId: string;
+        submitted: boolean;
+        triggerType: "manual_or_testable" | "trigger_only";
+        needsUserInput: boolean;
+        summary: string;
+        workflowId?: string | undefined;
+        mockedCredentialTypes?: string[] | undefined;
+        failureSignature?: string | undefined;
+        blockingReason?: string | undefined;
+        mockedNodeNames?: string[] | undefined;
+        mockedCredentialsByNode?: Record<string, string[]> | undefined;
+        verificationPinData?: Record<string, Record<string, unknown>[]> | undefined;
+    } | undefined;
+}>;
+export type WorkflowLoopWorkItemRecord = z.infer<typeof workItemRecordSchema>;
+export declare class WorkflowLoopStorage {
+    private readonly memory;
+    constructor(memory: Memory);
+    getWorkItem(threadId: string, workItemId: string): Promise<WorkflowLoopWorkItemRecord | null>;
+    saveWorkItem(threadId: string, state: WorkflowLoopState, attempts: AttemptRecord[], lastBuildOutcome?: WorkflowBuildOutcome): Promise<void>;
+    getActiveWorkItem(threadId: string): Promise<WorkflowLoopWorkItemRecord | null>;
+    private loadAll;
+    private parse;
+}
+export {};

package/dist/storage/workflow-loop-storage.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowLoopStorage = void 0;
+const zod_1 = require("zod");
+const thread_patch_1 = require("./thread-patch");
+const workflow_loop_state_1 = require("../workflow-loop/workflow-loop-state");
+const METADATA_KEY = 'instanceAiWorkflowLoop';
+const workItemRecordSchema = zod_1.z.object({
+    state: workflow_loop_state_1.workflowLoopStateSchema,
+    attempts: zod_1.z.array(workflow_loop_state_1.attemptRecordSchema),
+    lastBuildOutcome: workflow_loop_state_1.workflowBuildOutcomeSchema.optional(),
+});
+const loopStorageSchema = zod_1.z.record(zod_1.z.string(), workItemRecordSchema);
+class WorkflowLoopStorage {
+    memory;
+    constructor(memory) {
+        this.memory = memory;
+    }
+    async getWorkItem(threadId, workItemId) {
+        const all = await this.loadAll(threadId);
+        return all[workItemId] ?? null;
+    }
+    async saveWorkItem(threadId, state, attempts, lastBuildOutcome) {
+        await (0, thread_patch_1.patchThread)(this.memory, {
+            threadId,
+            update: ({ metadata = {} }) => {
+                const all = this.parse(metadata[METADATA_KEY]);
+                all[state.workItemId] = { state, attempts, lastBuildOutcome };
+                return {
+                    metadata: {
+                        ...metadata,
+                        [METADATA_KEY]: all,
+                    },
+                };
+            },
+        });
+    }
+    async getActiveWorkItem(threadId) {
+        const all = await this.loadAll(threadId);
+        for (const record of Object.values(all)) {
+            if (record.state.status === 'active') {
+                return record;
+            }
+        }
+        return null;
+    }
+    async loadAll(threadId) {
+        const thread = await this.memory.getThreadById({ threadId });
+        if (!thread?.metadata?.[METADATA_KEY])
+            return {};
+        return this.parse(thread.metadata[METADATA_KEY]);
+    }
+    parse(raw) {
+        const result = loopStorageSchema.safeParse(raw);
+        return result.success ? result.data : {};
+    }
+}
+exports.WorkflowLoopStorage = WorkflowLoopStorage;
+//# sourceMappingURL=workflow-loop-storage.js.map

package/dist/storage/workflow-loop-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loop-storage.js","sourceRoot":"","sources":["../../src/storage/workflow-loop-storage.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AAExB,iDAA6C;AAM7C,8EAI8C;AAE9C,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,6CAAuB;IAC9B,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAmB,CAAC;IACtC,gBAAgB,EAAE,gDAA0B,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC;AAIrE,MAAa,mBAAmB;IACF;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,KAAK,CAAC,WAAW,CAChB,QAAgB,EAChB,UAAkB;QAElB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,YAAY,CACjB,QAAgB,EAChB,KAAwB,EACxB,QAAyB,EACzB,gBAAuC;QAEvC,MAAM,IAAA,0BAAW,EAAC,IAAI,CAAC,MAAM,EAAE;YAC9B,QAAQ;YACR,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,EAAE,EAAE;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC/C,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;gBAC9D,OAAO;oBACN,QAAQ,EAAE;wBACT,GAAG,QAAQ;wBACX,CAAC,YAAY,CAAC,EAAE,GAAG;qBACnB;iBACD,CAAC;YACH,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC;YACf,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,QAAgB;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,GAAY;QACzB,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;CACD;AApDD,kDAoDC"}

package/dist/stream/consume-with-hitl.d.ts

@@ -0,0 +1,22 @@
+import type { Agent } from '@mastra/core/agent';
+import type { InstanceAiEventBus } from '../event-bus/event-bus.interface';
+import { type LlmStepTraceHooks, type ResumableStreamSource } from '../runtime/resumable-stream-executor';
+export interface ConsumeWithHitlOptions {
+    agent: Agent;
+    stream: ResumableStreamSource & {
+        text: Promise<string>;
+    };
+    runId: string;
+    agentId: string;
+    eventBus: InstanceAiEventBus;
+    threadId: string;
+    abortSignal: AbortSignal;
+    waitForConfirmation?: (requestId: string) => Promise<Record<string, unknown>>;
+    drainCorrections?: () => string[];
+    llmStepTraceHooks?: LlmStepTraceHooks;
+    workingMemoryEnabled?: boolean;
+}
+export interface ConsumeWithHitlResult {
+    text: Promise<string>;
+}
+export declare function consumeStreamWithHitl(options: ConsumeWithHitlOptions): Promise<ConsumeWithHitlResult>;

package/dist/stream/consume-with-hitl.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consumeStreamWithHitl = consumeStreamWithHitl;
+const resumable_stream_executor_1 = require("../runtime/resumable-stream-executor");
+async function consumeStreamWithHitl(options) {
+    if (!options.waitForConfirmation) {
+        throw new Error('Sub-agent tool requires confirmation but no HITL handler is available');
+    }
+    const result = await (0, resumable_stream_executor_1.executeResumableStream)({
+        agent: options.agent,
+        stream: options.stream,
+        context: {
+            threadId: options.threadId,
+            runId: options.runId,
+            agentId: options.agentId,
+            eventBus: options.eventBus,
+            signal: options.abortSignal,
+        },
+        control: {
+            mode: 'auto',
+            waitForConfirmation: options.waitForConfirmation,
+            drainCorrections: options.drainCorrections,
+        },
+        llmStepTraceHooks: options.llmStepTraceHooks,
+        workingMemoryEnabled: options.workingMemoryEnabled,
+    });
+    return { text: result.text ?? options.stream.text };
+}
+//# sourceMappingURL=consume-with-hitl.js.map

package/dist/stream/consume-with-hitl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-with-hitl.js","sourceRoot":"","sources":["../../src/stream/consume-with-hitl.ts"],"names":[],"mappings":";;AAqCA,sDA2BC;AA7DD,oFAI8C;AA8BvC,KAAK,UAAU,qBAAqB,CAC1C,OAA+B;IAE/B,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,kDAAsB,EAAC;QAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE;YACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,WAAW;SAC3B;QACD,OAAO,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC1C;QACD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;KAClD,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC"}

package/dist/stream/map-chunk.d.ts

@@ -0,0 +1,2 @@
+import type { InstanceAiEvent } from '@n8n/api-types';
+export declare function mapMastraChunkToEvent(runId: string, agentId: string, chunk: unknown): InstanceAiEvent | null;

package/dist/stream/map-chunk.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapMastraChunkToEvent = mapMastraChunkToEvent;
+const api_types_1 = require("@n8n/api-types");
+const zod_1 = require("zod");
+const questionItemSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    question: zod_1.z.string(),
+    type: zod_1.z.enum(['single', 'multi', 'text']),
+    options: zod_1.z.array(zod_1.z.string()).optional(),
+});
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function extractErrorInfo(error) {
+    if (typeof error === 'string')
+        return { content: error };
+    if (error instanceof Error) {
+        const info = { content: error.message };
+        if ('statusCode' in error && typeof error.statusCode === 'number') {
+            info.statusCode = error.statusCode;
+        }
+        if ('responseBody' in error && typeof error.responseBody === 'string') {
+            info.technicalDetails = error.responseBody;
+            try {
+                const body = JSON.parse(error.responseBody);
+                if (body?.error?.message) {
+                    info.content = body.error.message;
+                }
+            }
+            catch {
+            }
+        }
+        if ('url' in error && typeof error.url === 'string') {
+            const urlStr = error.url;
+            if (urlStr.includes('anthropic'))
+                info.provider = 'Anthropic';
+            else if (urlStr.includes('openai'))
+                info.provider = 'OpenAI';
+        }
+        return info;
+    }
+    return { content: 'Unknown error' };
+}
+function mapMastraChunkToEvent(runId, agentId, chunk) {
+    if (!isRecord(chunk))
+        return null;
+    const { type } = chunk;
+    const payload = isRecord(chunk.payload) ? chunk.payload : {};
+    const textValue = typeof payload.text === 'string'
+        ? payload.text
+        : typeof payload.textDelta === 'string'
+            ? payload.textDelta
+            : undefined;
+    if (type === 'text-delta' && textValue !== undefined) {
+        return {
+            type: 'text-delta',
+            runId,
+            agentId,
+            payload: { text: textValue },
+        };
+    }
+    if ((type === 'reasoning-delta' || type === 'reasoning') && textValue !== undefined) {
+        return {
+            type: 'reasoning-delta',
+            runId,
+            agentId,
+            payload: { text: textValue },
+        };
+    }
+    if (type === 'tool-call') {
+        return {
+            type: 'tool-call',
+            runId,
+            agentId,
+            payload: {
+                toolCallId: typeof payload.toolCallId === 'string' ? payload.toolCallId : '',
+                toolName: typeof payload.toolName === 'string' ? payload.toolName : '',
+                args: isRecord(payload.args) ? payload.args : {},
+            },
+        };
+    }
+    if (type === 'tool-result' || type === 'tool-error') {
+        const toolCallId = typeof payload.toolCallId === 'string' ? payload.toolCallId : '';
+        if (payload.isError === true) {
+            return {
+                type: 'tool-error',
+                runId,
+                agentId,
+                payload: {
+                    toolCallId,
+                    error: typeof payload.result === 'string' ? payload.result : 'Tool execution failed',
+                },
+            };
+        }
+        return {
+            type: 'tool-result',
+            runId,
+            agentId,
+            payload: {
+                toolCallId,
+                result: payload.result,
+            },
+        };
+    }
+    if (type === 'tool-call-suspended') {
+        const suspendPayload = isRecord(payload.suspendPayload) ? payload.suspendPayload : {};
+        const toolCallId = typeof payload.toolCallId === 'string' ? payload.toolCallId : '';
+        const requestId = typeof suspendPayload.requestId === 'string' && suspendPayload.requestId
+            ? suspendPayload.requestId
+            : toolCallId;
+        if (!requestId || !toolCallId)
+            return null;
+        const rawSeverity = typeof suspendPayload.severity === 'string' ? suspendPayload.severity : '';
+        const validSeverities = ['destructive', 'warning', 'info'];
+        const severity = validSeverities.includes(rawSeverity)
+            ? rawSeverity
+            : 'warning';
+        let credentialRequests;
+        if (Array.isArray(suspendPayload.credentialRequests)) {
+            const parsed = suspendPayload.credentialRequests
+                .map((item) => api_types_1.credentialRequestSchema.safeParse(item))
+                .filter((r) => r.success)
+                .map((r) => r.data);
+            if (parsed.length > 0) {
+                credentialRequests = parsed;
+            }
+        }
+        const projectId = typeof suspendPayload.projectId === 'string' ? suspendPayload.projectId : undefined;
+        const rawInputType = typeof suspendPayload.inputType === 'string' ? suspendPayload.inputType : undefined;
+        const validInputTypes = ['approval', 'text', 'questions', 'plan-review'];
+        const inputType = validInputTypes.includes(rawInputType ?? '')
+            ? rawInputType
+            : undefined;
+        let questions;
+        if (Array.isArray(suspendPayload.questions)) {
+            const parsed = suspendPayload.questions
+                .map((item) => questionItemSchema.safeParse(item))
+                .filter((r) => r.success)
+                .map((r) => r.data);
+            if (parsed.length > 0) {
+                questions = parsed;
+            }
+        }
+        const introMessage = typeof suspendPayload.introMessage === 'string' ? suspendPayload.introMessage : undefined;
+        let tasks;
+        if (isRecord(suspendPayload.tasks)) {
+            const parsed = api_types_1.taskListSchema.safeParse(suspendPayload.tasks);
+            if (parsed.success) {
+                tasks = parsed.data;
+            }
+        }
+        const rawDomainAccess = isRecord(suspendPayload.domainAccess)
+            ? suspendPayload.domainAccess
+            : undefined;
+        const domainAccess = rawDomainAccess &&
+            typeof rawDomainAccess.url === 'string' &&
+            typeof rawDomainAccess.host === 'string'
+            ? { url: rawDomainAccess.url, host: rawDomainAccess.host }
+            : undefined;
+        const rawCredentialFlow = isRecord(suspendPayload.credentialFlow)
+            ? suspendPayload.credentialFlow
+            : undefined;
+        const validStages = new Set(['generic', 'finalize']);
+        const rawStage = rawCredentialFlow && typeof rawCredentialFlow.stage === 'string'
+            ? rawCredentialFlow.stage
+            : undefined;
+        const credentialFlow = rawStage !== undefined && validStages.has(rawStage)
+            ? { stage: rawStage }
+            : undefined;
+        let setupRequests;
+        if (Array.isArray(suspendPayload.setupRequests)) {
+            const parsed = suspendPayload.setupRequests
+                .map((item) => api_types_1.workflowSetupNodeSchema.safeParse(item))
+                .filter((r) => r.success)
+                .map((r) => r.data);
+            if (parsed.length > 0) {
+                setupRequests = parsed;
+            }
+        }
+        const workflowId = typeof suspendPayload.workflowId === 'string' ? suspendPayload.workflowId : undefined;
+        return {
+            type: 'confirmation-request',
+            runId,
+            agentId,
+            payload: {
+                requestId,
+                toolCallId,
+                toolName: typeof payload.toolName === 'string' ? payload.toolName : '',
+                args: isRecord(payload.args) ? payload.args : {},
+                severity,
+                message: typeof suspendPayload.message === 'string'
+                    ? suspendPayload.message
+                    : 'Confirmation required',
+                ...(credentialRequests ? { credentialRequests } : {}),
+                ...(projectId ? { projectId } : {}),
+                ...(inputType ? { inputType } : {}),
+                ...(domainAccess ? { domainAccess } : {}),
+                ...(credentialFlow ? { credentialFlow } : {}),
+                ...(setupRequests ? { setupRequests } : {}),
+                ...(workflowId ? { workflowId } : {}),
+                ...(questions ? { questions } : {}),
+                ...(introMessage ? { introMessage } : {}),
+                ...(tasks ? { tasks } : {}),
+            },
+        };
+    }
+    if (type === 'error') {
+        const errorInfo = extractErrorInfo(payload.error);
+        return {
+            type: 'error',
+            runId,
+            agentId,
+            payload: {
+                content: errorInfo.content,
+                ...(errorInfo.statusCode !== undefined ? { statusCode: errorInfo.statusCode } : {}),
+                ...(errorInfo.provider ? { provider: errorInfo.provider } : {}),
+                ...(errorInfo.technicalDetails ? { technicalDetails: errorInfo.technicalDetails } : {}),
+            },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=map-chunk.js.map

package/dist/stream/map-chunk.js.map

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

package/dist/tools/best-practices/get-best-practices.tool.d.ts

@@ -0,0 +1,12 @@
+export declare function createGetBestPracticesTool(): import("@mastra/core/tools").Tool<{
+    technique: string;
+}, {
+    message: string;
+    technique: string;
+    documentation?: string | undefined;
+    availableTechniques?: {
+        description: string;
+        technique: string;
+        hasDocumentation: boolean;
+    }[] | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "get-best-practices", unknown>;

package/dist/tools/best-practices/get-best-practices.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetBestPracticesTool = createGetBestPracticesTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const index_1 = require("./index");
+const techniques_1 = require("./techniques");
+function createGetBestPracticesTool() {
+    return (0, tools_1.createTool)({
+        id: 'get-best-practices',
+        description: 'Get workflow building best practices and guidance for a specific technique. Pass "list" to see all available techniques and their descriptions.',
+        inputSchema: zod_1.z.object({
+            technique: zod_1.z
+                .string()
+                .describe('The workflow technique to get guidance for (e.g. "chatbot", "scheduling", "triage"). Pass "list" to see all available techniques.'),
+        }),
+        outputSchema: zod_1.z.object({
+            technique: zod_1.z.string(),
+            documentation: zod_1.z.string().optional(),
+            availableTechniques: zod_1.z
+                .array(zod_1.z.object({
+                technique: zod_1.z.string(),
+                description: zod_1.z.string(),
+                hasDocumentation: zod_1.z.boolean(),
+            }))
+                .optional(),
+            message: zod_1.z.string(),
+        }),
+        execute: async ({ technique }) => {
+            if (technique === 'list') {
+                const availableTechniques = Object.entries(techniques_1.TechniqueDescription).map(([tech, description]) => ({
+                    technique: tech,
+                    description,
+                    hasDocumentation: index_1.documentation[tech] !== undefined,
+                }));
+                return {
+                    technique: 'list',
+                    availableTechniques,
+                    message: `Found ${availableTechniques.length} techniques. ${availableTechniques.filter((t) => t.hasDocumentation).length} have detailed documentation.`,
+                };
+            }
+            const getDocFn = index_1.documentation[technique];
+            if (!getDocFn) {
+                const description = techniques_1.TechniqueDescription[technique];
+                if (description) {
+                    return {
+                        technique,
+                        message: `Technique "${technique}" (${description}) exists but does not have detailed documentation yet. Use search-template-structures to find example workflows instead.`,
+                    };
+                }
+                return {
+                    technique,
+                    message: `Unknown technique "${technique}". Use technique "list" to see all available techniques.`,
+                };
+            }
+            return {
+                technique,
+                documentation: getDocFn(),
+                message: `Best practices documentation for "${technique}" retrieved successfully.`,
+            };
+        },
+    });
+}
+//# sourceMappingURL=get-best-practices.tool.js.map