@scoutqa/mastra-core 0.24.6-fork.1

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

@@ -0,0 +1,153 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { TracingContext } from '../../ai-tracing/index.js';
+import type { MastraModelConfig } from '../../llm/model/shared.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 | null;
+    confidence: number | null;
+    translated_text?: string | null;
+}
+/**
+ * Configuration options for LanguageDetector
+ */
+export interface LanguageDetectorOptions {
+    /** Model configuration for the detection/translation agent */
+    model: MastraModelConfig;
+    /**
+     * 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;
+        tracingContext?: TracingContext;
+    }): 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":"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"}

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

@@ -0,0 +1,138 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { TracingContext } from '../../ai-tracing/index.js';
+import type { MastraModelConfig } from '../../llm/model/shared.types.js';
+import type { ChunkType } from '../../stream/index.js';
+import type { Processor } from '../index.js';
+/**
+ * Individual moderation category score
+ */
+export interface ModerationCategoryScore {
+    category: string;
+    score: number;
+}
+export type ModerationCategoryScores = ModerationCategoryScore[];
+/**
+ * Result structure for moderation
+ */
+export interface ModerationResult {
+    category_scores: ModerationCategoryScores | null;
+    reason: string | null;
+}
+/**
+ * Configuration options for ModerationInputProcessor
+ */
+export interface ModerationOptions {
+    /**
+     * Model configuration for the moderation agent
+     * Supports magic strings like "openai/gpt-4o", config objects, or direct LanguageModel instances
+     */
+    model: MastraModelConfig;
+    /**
+     * 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;
+    /**
+     * Structured output options used for the moderation agent
+     */
+    structuredOutputOptions?: {
+        /**
+         * Whether to use system prompt injection instead of native response format to coerce the LLM to respond with json text if the LLM does not natively support structured outputs.
+         */
+        jsonPromptInjection?: boolean;
+    };
+}
+/**
+ * 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 structuredOutputOptions?;
+    private static readonly DEFAULT_CATEGORIES;
+    constructor(options: ModerationOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): Promise<MastraMessageV2[]>;
+    processOutputResult(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): Promise<MastraMessageV2[]>;
+    processOutputStream(args: {
+        part: ChunkType;
+        streamParts: ChunkType[];
+        state: Record<string, any>;
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): Promise<ChunkType | 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,203 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { TracingContext } from '../../ai-tracing/index.js';
+import type { MastraModelConfig } from '../../llm/model/shared.types.js';
+import type { ChunkType } from '../../stream/index.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;
+}
+/**
+ * Individual PII category score
+ */
+export interface PIICategoryScore {
+    type: string;
+    score: number;
+}
+export type PIICategoryScores = PIICategoryScore[];
+/**
+ * Individual PII detection with location and redaction info
+ */
+export interface PIIDetection {
+    type: string;
+    value: string;
+    confidence: number;
+    start: number;
+    end: number;
+    redacted_value?: string | null;
+}
+/**
+ * Result structure for PII detection (simplified for minimal tokens)
+ */
+export interface PIIDetectionResult {
+    categories: PIICategoryScores | null;
+    detections: PIIDetection[] | null;
+    redacted_content?: string | null;
+}
+/**
+ * Configuration options for PIIDetector
+ */
+export interface PIIDetectorOptions {
+    /**
+     * Model configuration for the detection agent
+     * Supports magic strings like "openai/gpt-4o", config objects, or direct LanguageModel instances
+     */
+    model: MastraModelConfig;
+    /**
+     * 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;
+    /**
+     * Structured output options used for the detection agent
+     */
+    structuredOutputOptions?: {
+        /**
+         * Whether to use system prompt injection instead of native response format to coerce the LLM to respond with json text if the LLM does not natively support structured outputs.
+         */
+        jsonPromptInjection?: 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 structuredOutputOptions?;
+    private static readonly DEFAULT_DETECTION_TYPES;
+    constructor(options: PIIDetectorOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): 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: ChunkType;
+        streamParts: ChunkType[];
+        state: Record<string, any>;
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): Promise<ChunkType | null>;
+    /**
+     * Process final output result for PII detection and redaction
+     */
+    processOutputResult({ messages, abort, tracingContext, }: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): 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":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,EAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,EAAE,iBAAiB,CAAC;IAEzB;;;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,QAAQ,CAAC;IAElD;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IAE7D;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,uBAAuB,CAAC,EAAE;QACxB;;WAEG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,SAAS;IAC3C,QAAQ,CAAC,IAAI,kBAAkB;IAE/B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,uBAAuB,CAAC,CAAgD;IAGhF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAc7C;gBAEU,OAAO,EAAE,kBAAkB;IAiBjC,YAAY,CAAC,IAAI,EAAE;QACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;QAClC,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiD9B;;OAEG;YACW,SAAS;IA8FvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,SAAS;IAqEjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,IAAI,EAAE,SAAS,CAAC;QAChB,WAAW,EAAE,SAAS,EAAE,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;QAClC,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAgE7B;;OAEG;IACG,mBAAmB,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,cAAc,GACf,EAAE;QACD,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;QAClC,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+C9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAI9B"}

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

@@ -0,0 +1,116 @@
+import type { MastraMessageV2 } from '../../agent/message-list/index.js';
+import type { TracingContext } from '../../ai-tracing/index.js';
+import type { MastraModelConfig } from '../../llm/model/shared.types.js';
+import type { Processor } from '../index.js';
+/**
+ * Individual detection category score
+ */
+export interface PromptInjectionCategoryScore {
+    type: string;
+    score: number;
+}
+export type PromptInjectionCategoryScores = PromptInjectionCategoryScore[];
+/**
+ * Result structure for prompt injection detection
+ */
+export interface PromptInjectionResult {
+    categories: PromptInjectionCategoryScores | null;
+    reason: string | null;
+    rewritten_content?: string | null;
+}
+/**
+ * Configuration options for PromptInjectionDetector
+ */
+export interface PromptInjectionOptions {
+    /** Model configuration for the detection agent */
+    model: MastraModelConfig;
+    /**
+     * 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;
+    /**
+     * Structured output options used for the detection agent
+     */
+    structuredOutputOptions?: {
+        /**
+         * Whether to use system prompt injection instead of native response format to coerce the LLM to respond with json text if the LLM does not natively support structured outputs.
+         */
+        jsonPromptInjection?: 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 structuredOutputOptions?;
+    private static readonly DEFAULT_DETECTION_TYPES;
+    constructor(options: PromptInjectionOptions);
+    processInput(args: {
+        messages: MastraMessageV2[];
+        abort: (reason?: string) => never;
+        tracingContext?: TracingContext;
+    }): 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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,EAAE,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,KAAK,EAAE,iBAAiB,CAAC;IAEzB;;;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;IAExB;;OAEG;IACH,uBAAuB,CAAC,EAAE;QACxB;;WAEG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;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;IAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAoD;IAGpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAO7C;gBAEU,OAAO,EAAE,sBAAsB;IAcrC,YAAY,CAAC,IAAI,EAAE;QACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;QAClC,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAkD9B;;OAEG;YACW,qBAAqB;IAsEnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/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"}