@mastra/core 1.0.0-beta.10 → 1.0.0-beta.11

package/dist/processors/runner.d.ts

@@ -1,12 +1,13 @@
 import type { MastraDBMessage } from '../agent/message-list/index.js';
 import { MessageList } from '../agent/message-list/index.js';
+import type { TripWireOptions } from '../agent/trip-wire.js';
 import type { IMastraLogger } from '../logger/index.js';
 import { SpanType } from '../observability/index.js';
 import type { Span, TracingContext } from '../observability/index.js';
 import type { RequestContext } from '../request-context/index.js';
 import type { ChunkType, OutputSchema } from '../stream/index.js';
 import type { MastraModelOutput } from '../stream/base/output.js';
-import type { Processor } from './index.js';
+import type { ProcessInputStepResult, Processor, ProcessorMessageResult, ProcessorWorkflow, RunProcessInputStepArgs, RunProcessInputStepResult, ToolCallInfo } from './index.js';
 /**
  * Implementation of processor state management
  */
@@ -22,28 +23,39 @@ export declare class ProcessorState<OUTPUT extends OutputSchema = undefined> {
     });
     addPart(part: ChunkType<OUTPUT>): void;
 }
+/**
+ * Union type for processor or workflow that can be used as a processor
+ */
+type ProcessorOrWorkflow = Processor | ProcessorWorkflow;
 export declare class ProcessorRunner {
-    readonly inputProcessors: Processor[];
-    readonly outputProcessors: Processor[];
+    readonly inputProcessors: ProcessorOrWorkflow[];
+    readonly outputProcessors: ProcessorOrWorkflow[];
     private readonly logger;
     private readonly agentName;
     constructor({ inputProcessors, outputProcessors, logger, agentName, }: {
-        inputProcessors?: Processor[];
-        outputProcessors?: Processor[];
+        inputProcessors?: ProcessorOrWorkflow[];
+        outputProcessors?: ProcessorOrWorkflow[];
         logger: IMastraLogger;
         agentName: string;
     });
-    runOutputProcessors(messageList: MessageList, tracingContext?: TracingContext, requestContext?: RequestContext): Promise<MessageList>;
+    /**
+     * Execute a workflow as a processor and handle the result.
+     * Returns the processed messages and any tripwire information.
+     */
+    private executeWorkflowAsProcessor;
+    runOutputProcessors(messageList: MessageList, tracingContext?: TracingContext, requestContext?: RequestContext, retryCount?: number): Promise<MessageList>;
     /**
      * Process a stream part through all output processors with state management
      */
-    processPart<OUTPUT extends OutputSchema>(part: ChunkType<OUTPUT>, processorStates: Map<string, ProcessorState<OUTPUT>>, tracingContext?: TracingContext, requestContext?: RequestContext, messageList?: MessageList): Promise<{
+    processPart<OUTPUT extends OutputSchema>(part: ChunkType<OUTPUT>, processorStates: Map<string, ProcessorState<OUTPUT>>, tracingContext?: TracingContext, requestContext?: RequestContext, messageList?: MessageList, retryCount?: number): Promise<{
         part: ChunkType<OUTPUT> | null | undefined;
         blocked: boolean;
         reason?: string;
+        tripwireOptions?: TripWireOptions<unknown>;
+        processorId?: string;
     }>;
     runOutputProcessorsForStream<OUTPUT extends OutputSchema = undefined>(streamResult: MastraModelOutput<OUTPUT>, tracingContext?: TracingContext): Promise<ReadableStream<any>>;
-    runInputProcessors(messageList: MessageList, tracingContext?: TracingContext, requestContext?: RequestContext): Promise<MessageList>;
+    runInputProcessors(messageList: MessageList, tracingContext?: TracingContext, requestContext?: RequestContext, retryCount?: number): Promise<MessageList>;
     /**
      * Run processInputStep for all processors that implement it.
      * Called at each step of the agentic loop, before the LLM is invoked.
@@ -62,16 +74,47 @@ export declare class ProcessorRunner {
      *
      * @returns The processed MessageList
      */
-    runProcessInputStep(args: {
+    runProcessInputStep(args: RunProcessInputStepArgs): Promise<RunProcessInputStepResult>;
+    /**
+     * Type guard to check if result is { messages, systemMessages }
+     */
+    private isProcessInputResultWithSystemMessages;
+    /**
+     * Run processOutputStep for all processors that implement it.
+     * Called after each LLM response in the agentic loop, before tool execution.
+     *
+     * Unlike processOutputResult which runs once at the end, this runs at every step.
+     * This is the ideal place to implement guardrails that can trigger retries.
+     *
+     * @param args.messages - The current messages including the LLM response
+     * @param args.messageList - MessageList instance for managing message sources
+     * @param args.stepNumber - The current step number (0-indexed)
+     * @param args.finishReason - The finish reason from the LLM
+     * @param args.toolCalls - Tool calls made in this step (if any)
+     * @param args.text - Generated text from this step
+     * @param args.tracingContext - Optional tracing context for observability
+     * @param args.requestContext - Optional runtime context with execution metadata
+     * @param args.retryCount - Number of times processors have triggered retry
+     *
+     * @returns The processed MessageList
+     */
+    runProcessOutputStep(args: {
         messages: MastraDBMessage[];
         messageList: MessageList;
         stepNumber: number;
+        finishReason?: string;
+        toolCalls?: ToolCallInfo[];
+        text?: string;
         tracingContext?: TracingContext;
         requestContext?: RequestContext;
+        retryCount?: number;
     }): Promise<MessageList>;
-    /**
-     * Type guard to check if result is { messages, systemMessages }
-     */
-    private isProcessInputResultWithSystemMessages;
+    static applyMessagesToMessageList(messages: MastraDBMessage[], messageList: MessageList, idsBeforeProcessing: string[], check: ReturnType<MessageList['makeMessageSourceChecker']>): void;
+    static validateAndFormatProcessInputStepResult(result: ProcessInputStepResult | Awaited<ProcessorMessageResult> | undefined | void, { messageList, processor, stepNumber, }: {
+        messageList: MessageList;
+        processor: Processor;
+        stepNumber: number;
+    }): Promise<RunProcessInputStepResult>;
 }
+export {};
 //# sourceMappingURL=runner.d.ts.map

package/dist/processors/runner.d.ts.map

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