@mastra/core 0.13.2 → 0.14.0-alpha.1

package/dist/processors/processors/language-detector.d.ts

@@ -0,0 +1,151 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { MastraLanguageModel } from '../../agent/types.js';
+import type { Processor } from '../index.js';
+/**
+ * Language detection result for a single text
+ */
+export interface LanguageDetection {
+    language: string;
+    confidence: number;
+    iso_code: string;
+}
+/**
+ * Translation result
+ */
+export interface TranslationResult {
+    original_text: string;
+    original_language: string;
+    translated_text: string;
+    target_language: string;
+    confidence: number;
+}
+/**
+ * Language detection and translation result (simplified for minimal tokens)
+ */
+export interface LanguageDetectionResult {
+    iso_code?: string;
+    confidence?: number;
+    translated_text?: string;
+}
+/**
+ * Configuration options for LanguageDetector
+ */
+export interface LanguageDetectorOptions {
+    /** Model configuration for the detection/translation agent */
+    model: MastraLanguageModel;
+    /**
+     * Target language(s) for the project.
+     * If content is detected in a different language, it may be translated.
+     * Can be language name ('English') or ISO code ('en')
+     */
+    targetLanguages: string[];
+    /**
+     * Confidence threshold for language detection (0-1, default: 0.7)
+     * Only process when detection confidence exceeds this threshold
+     */
+    threshold?: number;
+    /**
+     * Strategy when non-target language is detected:
+     * - 'detect': Only detect language, don't translate (default)
+     * - 'translate': Automatically translate to target language
+     * - 'block': Reject content not in target language
+     * - 'warn': Log warning but allow content through
+     */
+    strategy?: 'detect' | 'translate' | 'block' | 'warn';
+    /**
+     * Whether to preserve original content in message metadata (default: true)
+     * Useful for audit trails and debugging
+     */
+    preserveOriginal?: boolean;
+    /**
+     * Custom detection instructions for the agent
+     * If not provided, uses default instructions
+     */
+    instructions?: string;
+    /**
+     * Minimum text length to perform detection (default: 10)
+     * Short text is often unreliable for language detection
+     */
+    minTextLength?: number;
+    /**
+     * Whether to include detailed detection info in logs (default: false)
+     */
+    includeDetectionDetails?: boolean;
+    /**
+     * Translation quality preference:
+     * - 'speed': Prioritize fast translation
+     * - 'quality': Prioritize translation accuracy (default)
+     * - 'balanced': Balance between speed and quality
+     */
+    translationQuality?: 'speed' | 'quality' | 'balanced';
+}
+/**
+ * LanguageDetector identifies the language of input text and optionally
+ * translates it to a target language for consistent processing.
+ *
+ * Supports 100+ languages via internal agent-based detection and translation,
+ * making it ideal for multilingual AI applications and global deployment.
+ */
+export declare class LanguageDetector implements Processor {
+    readonly name = "language-detector";
+    private detectionAgent;
+    private targetLanguages;
+    private threshold;
+    private strategy;
+    private preserveOriginal;
+    private minTextLength;
+    private includeDetectionDetails;
+    private translationQuality;
+    private static readonly DEFAULT_TARGET_LANGUAGES;
+    private static readonly LANGUAGE_MAP;
+    constructor(options: LanguageDetectorOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    /**
+     * Detect language using the internal agent
+     */
+    private detectLanguage;
+    /**
+     * Determine if language detection indicates non-target language
+     */
+    private isNonTargetLanguage;
+    /**
+     * Get detected language name from ISO code
+     */
+    private getLanguageName;
+    /**
+     * Handle detected language based on strategy
+     */
+    private handleDetectedLanguage;
+    /**
+     * Create a translated message with original preserved in metadata
+     */
+    private createTranslatedMessage;
+    /**
+     * Add language detection metadata to message
+     */
+    private addLanguageMetadata;
+    /**
+     * Check if detected language is a target language
+     */
+    private isTargetLanguage;
+    /**
+     * Extract text content from message for analysis
+     */
+    private extractTextContent;
+    /**
+     * Get language code from language name or vice versa
+     */
+    private getLanguageCode;
+    /**
+     * Create default detection and translation instructions
+     */
+    private createDefaultInstructions;
+    /**
+     * Create detection prompt for the agent
+     */
+    private createDetectionPrompt;
+}
+//# sourceMappingURL=language-detector.d.ts.map

package/dist/processors/processors/language-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detector.d.ts","sourceRoot":"","sources":["../../../src/processors/processors/language-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,KAAK,EAAE,mBAAmB,CAAC;IAE3B;;;;OAIG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAErD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;CACvD;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,kBAAkB,CAAmC;IAG7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAqB;IAGrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAsClC;gBAEU,OAAO,EAAE,uBAAuB;IAiBtC,YAAY,CAAC,IAAI,EAAE;QACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;KACnC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiE9B;;OAEG;YACW,cAAc;IAyB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/processors/processors/moderation.d.ts

@@ -0,0 +1,130 @@
+import type { TextStreamPart, ObjectStreamPart } from 'ai';
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { MastraLanguageModel } from '../../agent/types.js';
+import type { Processor } from '../index.js';
+/**
+ * Confidence scores for each moderation category (0-1)
+ */
+export interface ModerationCategoryScores {
+    hate?: number;
+    'hate/threatening'?: number;
+    harassment?: number;
+    'harassment/threatening'?: number;
+    'self-harm'?: number;
+    'self-harm/intent'?: number;
+    'self-harm/instructions'?: number;
+    sexual?: number;
+    'sexual/minors'?: number;
+    violence?: number;
+    'violence/graphic'?: number;
+    [customCategory: string]: number | undefined;
+}
+/**
+ * Result structure for moderation
+ */
+export interface ModerationResult {
+    category_scores?: ModerationCategoryScores;
+    reason?: string;
+}
+/**
+ * Configuration options for ModerationInputProcessor
+ */
+export interface ModerationOptions {
+    /** Model configuration for the moderation agent */
+    model: MastraLanguageModel;
+    /**
+     * Categories to check for moderation.
+     * If not specified, uses default OpenAI categories.
+     */
+    categories?: string[];
+    /**
+     * Confidence threshold for flagging (0-1, default: 0.5)
+     * Content is flagged if any category score exceeds this threshold
+     */
+    threshold?: number;
+    /**
+     * Strategy when content is flagged:
+     * - 'block': Reject the entire input with an error (default)
+     * - 'warn': Log warning but allow content through
+     * - 'filter': Remove flagged messages but continue with remaining
+     */
+    strategy?: 'block' | 'warn' | 'filter';
+    /**
+     * Custom moderation instructions for the agent
+     * If not provided, uses default instructions based on categories
+     */
+    instructions?: string;
+    /**
+     * Whether to include confidence scores in logs (default: false)
+     * Useful for tuning thresholds and debugging
+     */
+    includeScores?: boolean;
+    /**
+     * Number of previous chunks to include for context when moderating stream chunks.
+     * If set to 1, includes the previous part. If set to 2, includes the two previous chunks, etc.
+     * Default: 0 (no context window)
+     */
+    chunkWindow?: number;
+}
+/**
+ * ModerationInputProcessor uses an internal Mastra agent to evaluate content
+ * against configurable moderation categories for content safety.
+ *
+ * Provides flexible moderation with custom categories, thresholds, and strategies
+ * while maintaining compatibility with OpenAI's moderation API structure.
+ */
+export declare class ModerationProcessor implements Processor {
+    readonly name = "moderation";
+    private moderationAgent;
+    private categories;
+    private threshold;
+    private strategy;
+    private includeScores;
+    private chunkWindow;
+    private static readonly DEFAULT_CATEGORIES;
+    constructor(options: ModerationOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    processOutputResult(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    processOutputStream(args: {
+        part: TextStreamPart<any> | ObjectStreamPart<any>;
+        streamParts: (TextStreamPart<any> | ObjectStreamPart<any>)[];
+        state: Record<string, any>;
+        abort: (reason?: string) => never;
+    }): Promise<TextStreamPart<any> | ObjectStreamPart<any> | null | undefined>;
+    /**
+     * Moderate content using the internal agent
+     */
+    private moderateContent;
+    /**
+     * Determine if content is flagged based on category scores above threshold
+     */
+    private isModerationFlagged;
+    /**
+     * Handle flagged content based on strategy
+     */
+    private handleFlaggedContent;
+    /**
+     * Extract text content from message for moderation
+     */
+    private extractTextContent;
+    /**
+     * Create default moderation instructions
+     */
+    private createDefaultInstructions;
+    /**
+     * Create moderation prompt for the agent
+     */
+    private createModerationPrompt;
+    /**
+     * Build context string from chunks based on chunkWindow
+     * streamParts includes the current part
+     */
+    private buildContextFromChunks;
+}
+//# sourceMappingURL=moderation.d.ts.map

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

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

package/dist/processors/processors/pii-detector.d.ts

@@ -0,0 +1,197 @@
+import type { TextStreamPart, ObjectStreamPart } from 'ai';
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { MastraLanguageModel } from '../../agent/types.js';
+import type { Processor } from '../index.js';
+/**
+ * PII categories for detection and redaction
+ */
+export interface PIICategories {
+    email?: boolean;
+    phone?: boolean;
+    'credit-card'?: boolean;
+    ssn?: boolean;
+    'api-key'?: boolean;
+    'ip-address'?: boolean;
+    name?: boolean;
+    address?: boolean;
+    'date-of-birth'?: boolean;
+    url?: boolean;
+    uuid?: boolean;
+    'crypto-wallet'?: boolean;
+    iban?: boolean;
+    [customType: string]: boolean | undefined;
+}
+/**
+ * Confidence scores for each PII category (0-1)
+ */
+export interface PIICategoryScores {
+    email?: number;
+    phone?: number;
+    'credit-card'?: number;
+    ssn?: number;
+    'api-key'?: number;
+    'ip-address'?: number;
+    name?: number;
+    address?: number;
+    'date-of-birth'?: number;
+    url?: number;
+    uuid?: number;
+    'crypto-wallet'?: number;
+    iban?: number;
+    [customType: string]: number | undefined;
+}
+/**
+ * Individual PII detection with location and redaction info
+ */
+export interface PIIDetection {
+    type: string;
+    value: string;
+    confidence: number;
+    start: number;
+    end: number;
+    redacted_value?: string;
+}
+/**
+ * Result structure for PII detection (simplified for minimal tokens)
+ */
+export interface PIIDetectionResult {
+    categories?: PIICategoryScores;
+    detections?: PIIDetection[];
+    redacted_content?: string;
+}
+/**
+ * Configuration options for PIIDetector
+ */
+export interface PIIDetectorOptions {
+    /** Model configuration for the detection agent */
+    model: MastraLanguageModel;
+    /**
+     * PII types to detect.
+     * If not specified, uses default types.
+     */
+    detectionTypes?: string[];
+    /**
+     * Confidence threshold for flagging (0-1, default: 0.6)
+     * PII is flagged if any category score exceeds this threshold
+     */
+    threshold?: number;
+    /**
+     * Strategy when PII is detected:
+     * - 'block': Reject the entire input with an error
+     * - 'warn': Log warning but allow content through
+     * - 'filter': Remove flagged messages but continue with remaining
+     * - 'redact': Replace detected PII with redacted versions (default)
+     */
+    strategy?: 'block' | 'warn' | 'filter' | 'redact';
+    /**
+     * Redaction method for PII:
+     * - 'mask': Replace with asterisks (***@***.com)
+     * - 'hash': Replace with SHA256 hash
+     * - 'remove': Remove entirely
+     * - 'placeholder': Replace with type placeholder ([EMAIL], [PHONE], etc.)
+     */
+    redactionMethod?: 'mask' | 'hash' | 'remove' | 'placeholder';
+    /**
+     * Custom detection instructions for the agent
+     * If not provided, uses default instructions based on detection types
+     */
+    instructions?: string;
+    /**
+     * Whether to include detection details in logs (default: false)
+     * Useful for compliance auditing and debugging
+     */
+    includeDetections?: boolean;
+    /**
+     * Whether to preserve PII format during redaction (default: true)
+     * When true, maintains structure like ***-**-1234 for phone numbers
+     */
+    preserveFormat?: boolean;
+}
+/**
+ * PIIDetector uses an internal Mastra agent to identify and redact
+ * personally identifiable information for privacy compliance.
+ *
+ * Supports multiple redaction strategies and maintains audit trails
+ * for compliance with GDPR, CCPA, HIPAA, and other privacy regulations.
+ */
+export declare class PIIDetector implements Processor {
+    readonly name = "pii-detector";
+    private detectionAgent;
+    private detectionTypes;
+    private threshold;
+    private strategy;
+    private redactionMethod;
+    private includeDetections;
+    private preserveFormat;
+    private static readonly DEFAULT_DETECTION_TYPES;
+    constructor(options: PIIDetectorOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    /**
+     * Detect PII using the internal agent
+     */
+    private detectPII;
+    /**
+     * Determine if PII is flagged based on detections or category scores above threshold
+     */
+    private isPIIFlagged;
+    /**
+     * Handle detected PII based on strategy
+     */
+    private handleDetectedPII;
+    /**
+     * Create a redacted message with PII removed/masked
+     */
+    private createRedactedMessage;
+    /**
+     * Apply redaction method to content
+     */
+    private applyRedactionMethod;
+    /**
+     * Redact individual PII value based on method and type
+     */
+    private redactValue;
+    /**
+     * Mask PII value while optionally preserving format
+     */
+    private maskValue;
+    /**
+     * Hash PII value using SHA256
+     */
+    private hashValue;
+    /**
+     * Extract text content from message for analysis
+     */
+    private extractTextContent;
+    /**
+     * Create default detection instructions
+     */
+    private createDefaultInstructions;
+    /**
+     * Process streaming output chunks for PII detection and redaction
+     */
+    processOutputStream(args: {
+        part: TextStreamPart<any> | ObjectStreamPart<any>;
+        streamParts: (TextStreamPart<any> | ObjectStreamPart<any>)[];
+        state: Record<string, any>;
+        abort: (reason?: string) => never;
+    }): Promise<TextStreamPart<any> | ObjectStreamPart<any> | null>;
+    /**
+     * Process final output result for PII detection and redaction
+     */
+    processOutputResult({ messages, abort, }: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    /**
+     * Get detected PII types from detection result
+     */
+    private getDetectedTypes;
+    /**
+     * Create detection prompt for the agent
+     */
+    private createDetectionPrompt;
+}
+//# sourceMappingURL=pii-detector.d.ts.map

package/dist/processors/processors/pii-detector.d.ts.map

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

package/dist/processors/processors/prompt-injection-detector.d.ts

@@ -0,0 +1,108 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { MastraLanguageModel } from '../../agent/types.js';
+import type { Processor } from '../index.js';
+/**
+ * Confidence scores for each detection category (0-1)
+ */
+export interface PromptInjectionCategoryScores {
+    injection?: number;
+    jailbreak?: number;
+    'tool-exfiltration'?: number;
+    'data-exfiltration'?: number;
+    'system-override'?: number;
+    'role-manipulation'?: number;
+    [customType: string]: number | undefined;
+}
+/**
+ * Result structure for prompt injection detection
+ */
+export interface PromptInjectionResult {
+    categories?: PromptInjectionCategoryScores;
+    reason?: string;
+    rewritten_content?: string;
+}
+/**
+ * Configuration options for PromptInjectionDetector
+ */
+export interface PromptInjectionOptions {
+    /** Model configuration for the detection agent */
+    model: MastraLanguageModel;
+    /**
+     * Detection types to check for.
+     * If not specified, uses default categories.
+     */
+    detectionTypes?: string[];
+    /**
+     * Confidence threshold for flagging (0-1, default: 0.7)
+     * Higher threshold = less sensitive to avoid false positives
+     */
+    threshold?: number;
+    /**
+     * Strategy when injection is detected:
+     * - 'block': Reject the entire input with an error (default)
+     * - 'warn': Log warning but allow content through
+     * - 'filter': Remove flagged messages but continue with remaining
+     * - 'rewrite': Attempt to neutralize the injection while preserving intent
+     */
+    strategy?: 'block' | 'warn' | 'filter' | 'rewrite';
+    /**
+     * Custom detection instructions for the agent
+     * If not provided, uses default instructions based on detection types
+     */
+    instructions?: string;
+    /**
+     * Whether to include confidence scores in logs (default: false)
+     * Useful for tuning thresholds and debugging
+     */
+    includeScores?: boolean;
+}
+/**
+ * PromptInjectionDetector uses an internal Mastra agent to identify and handle
+ * prompt injection attacks, jailbreaks, and tool/data exfiltration attempts.
+ *
+ * Provides multiple response strategies including content rewriting to neutralize
+ * attacks while preserving legitimate user intent.
+ */
+export declare class PromptInjectionDetector implements Processor {
+    readonly name = "prompt-injection-detector";
+    private detectionAgent;
+    private detectionTypes;
+    private threshold;
+    private strategy;
+    private includeScores;
+    private static readonly DEFAULT_DETECTION_TYPES;
+    constructor(options: PromptInjectionOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    /**
+     * Detect prompt injection using the internal agent
+     */
+    private detectPromptInjection;
+    /**
+     * Determine if prompt injection is flagged based on category scores above threshold
+     */
+    private isInjectionFlagged;
+    /**
+     * Handle detected prompt injection based on strategy
+     */
+    private handleDetectedInjection;
+    /**
+     * Create a rewritten message with neutralized content
+     */
+    private createRewrittenMessage;
+    /**
+     * Extract text content from message for analysis
+     */
+    private extractTextContent;
+    /**
+     * Create default detection instructions
+     */
+    private createDefaultInstructions;
+    /**
+     * Create detection prompt for the agent
+     */
+    private createDetectionPrompt;
+}
+//# sourceMappingURL=prompt-injection-detector.d.ts.map

package/dist/processors/processors/prompt-injection-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-injection-detector.d.ts","sourceRoot":"","sources":["../../../src/processors/processors/prompt-injection-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,KAAK,EAAE,mBAAmB,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEnD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,SAAS;IACvD,QAAQ,CAAC,IAAI,+BAA+B;IAE5C,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,aAAa,CAAU;IAG/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAO7C;gBAEU,OAAO,EAAE,sBAAsB;IAarC,YAAY,CAAC,IAAI,EAAE;QACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;KACnC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAkD9B;;OAEG;YACW,qBAAqB;IAiCnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAY9B"}

package/dist/processors/processors/structured-output.d.ts

@@ -0,0 +1,42 @@
+import type z from 'zod';
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { StructuredOutputOptions } from '../../agent/types.js';
+import type { Processor } from '../index.js';
+export type { StructuredOutputOptions } from '../../agent/types.js';
+/**
+ * StructuredOutputProcessor transforms unstructured agent output into structured JSON
+ * using an internal structuring agent and provides real-time streaming support.
+ *
+ * Features:
+ * - Two-stage processing: unstructured → structured using internal agent
+ * - Real-time partial JSON parsing during streaming
+ * - Schema validation with Zod
+ * - Object chunks for partial updates
+ * - Configurable error handling strategies
+ * - Automatic instruction generation based on schema
+ */
+export declare class StructuredOutputProcessor<S extends z.ZodTypeAny> implements Processor {
+    readonly name = "structured-output";
+    schema: S;
+    private structuringAgent;
+    private errorStrategy;
+    private fallbackValue?;
+    constructor(options: StructuredOutputOptions<S>);
+    processOutputResult(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+    }): Promise<MastraMessageV2[]>;
+    /**
+     * Extract text content from a message
+     */
+    private extractTextContent;
+    /**
+     * Generate instructions for the structuring agent based on the schema
+     */
+    private generateInstructions;
+    /**
+     * Handle errors based on the configured strategy
+     */
+    private handleError;
+}
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/processors/processors/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/processors/processors/structured-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,qBAAa,yBAAyB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,CAAE,YAAW,SAAS;IACjF,QAAQ,CAAC,IAAI,uBAAuB;IAE7B,MAAM,EAAE,CAAC,CAAC;IACjB,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,aAAa,CAAC,CAAa;gBAEvB,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAazC,mBAAmB,CAAC,IAAI,EAAE;QAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;KACnC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwF9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,WAAW;CAiBpB"}