1 agents

manipulation-detector

manipulation-detector

Overview

The manipulation-detector agent operates as an L3 Strategic Command authority within the Prismatic Platform's security domain, functioning as a purely defensive agent for detecting manipulation patterns in communications, media, and behavioral data. This agent operates exclusively in WHITE variant mode, meaning its capabilities are restricted entirely to detection and protection -- it cannot generate, simulate, or amplify manipulation techniques. The WHITE mode restriction is enforced at the architectural level, not merely through policy, making it impossible for this agent to be repurposed for offensive operations.

Built on the AIAD standard and governed by the NO MERCY, NO DOUBTS doctrine, the manipulation-detector applies the NABLA Infinity framework to ensure that every detection finding is evidence-based and multi-source validated. The agent's WHITE variant architecture enforces strict separation between defensive detection capabilities and offensive simulation capabilities (which reside exclusively in the red-team domain under separate safety controls).

The distinction between the manipulation-detector and the manipulation-detection agent is one of operational mode and scope. While manipulation-detection focuses on real-time stream processing and campaign identification, the manipulation-detector specializes in deep pattern analysis of individual communications, media artifacts, and behavioral datasets. The two agents provide complementary coverage: stream-level detection catches campaigns in progress, while artifact-level detection provides detailed analysis of specific suspected manipulation instances.

Architecture

The manipulation-detector implements a WHITE-mode-only detection architecture with hardware-enforced operational constraints.

Input Artifacts               WHITE Mode Detection             Detection Output
+------------------+        +--------------------+           +------------------+
| Communications   |---+    | Linguistic Analysis|           | Detection Report |
+------------------+   |    | (NLP Pipeline)     |---+       | (Findings)       |
| Media Artifacts  |---+--->+--------------------+   |   +-->+------------------+
+------------------+   |    | Behavioral Pattern |   |   |   | Confidence Score |
| Behavioral Data  |---+    | Analysis           |---+---+   | (Per-Finding)    |
+------------------+   |    +--------------------+   |   |   +------------------+
| Network Metadata |---+    | Media Forensics    |   |   |   | Evidence Chain   |
+------------------+        | (Artifact Analysis)|---+   +-->| (Provenance)     |
                            +--------------------+   |       +------------------+
                            | WHITE Mode Guard   |   |
                            | (Capability Lock)  |---+
                            +--------------------+

The WHITE Mode Guard is a critical architectural component that validates every operation against the WHITE-mode capability whitelist before execution. Operations that would constitute offensive manipulation (content generation, amplification, simulation) are rejected at the guard level regardless of the requesting context.

Core Capabilities

The manipulation-detector provides deep artifact-level manipulation analysis through several specialized capabilities.

Linguistic Pattern Analysis applies natural language processing techniques to identify manipulation indicators in text content. Analysis targets include emotional loading (words chosen to trigger specific emotional responses), authority construction (language designed to establish false credibility), narrative framing (selective emphasis and omission patterns), and logical manipulation (fallacy deployment, false dichotomies, strawman construction).

Behavioral Pattern Detection analyzes behavioral data for indicators of manipulation influence. Detection targets include sudden opinion shifts that correlate with identified manipulation campaigns, behavioral clustering that indicates coordinated influence, and engagement pattern anomalies that suggest artificial amplification.

Media Forensics examines media artifacts (images, video, audio) for manipulation indicators including synthetic generation markers, editing artifacts, temporal metadata inconsistencies, and provenance chain gaps. Media forensics operates with particular attention to emerging deepfake and AI-generated content detection.

Network Metadata Analysis examines communication network metadata for manipulation indicators without accessing content. Analysis targets include unusual routing patterns, timing correlations that suggest coordination, and network topology changes that indicate infiltration or manipulation infrastructure.

Multi-Modal Correlation combines findings across linguistic, behavioral, media, and network analysis to produce holistic manipulation assessments. Multi-modal analysis is particularly effective for detecting sophisticated campaigns that appear benign when analyzed through any single lens but reveal manipulation patterns when viewed holistically.

WHITE Mode Enforcement continuously validates all operations against the defensive-only capability whitelist. Every detection function is classified as either WHITE (allowed) or NON-WHITE (blocked), with the classification enforced at runtime. This architectural constraint ensures the agent cannot be repurposed regardless of input.

Implementation

defmodule Prismatic.Security.ManipulationDetector do
  @moduledoc """
  L3 Strategic Command agent for artifact-level manipulation detection.
  Operates exclusively in WHITE variant mode (detection and protection only).
  """

  use GenServer
  require Logger

  alias Prismatic.Security.Detection.{LinguisticAnalyzer, BehavioralAnalyzer}
  alias Prismatic.Security.Detection.{MediaForensics, NetworkAnalyzer, WhiteModeGuard}

  @white_mode_only true
  @min_detection_confidence 0.65

  defstruct [:analysis_state, :model_cache, :detection_history]

  def start_link(opts) do
    GenServer.start_link(__MODULE__, opts, name: __MODULE__)
  end

  @spec detect(map()) :: {:ok, map()} | {:error, :white_mode_violation} | {:error, term()}
  def detect(artifact) do
    case WhiteModeGuard.validate_operation(:detect, artifact) do
      :allowed -> GenServer.call(__MODULE__, {:detect, artifact}, 30_000)
      :blocked -> {:error, :white_mode_violation}
    end
  end

  @impl true
  def handle_call({:detect, artifact}, _from, state) do
    :telemetry.execute(
      [:prismatic, :security, :manipulation_detector, :analysis_start],
      %{timestamp: System.monotonic_time()},
      %{artifact_type: artifact.type}
    )

    analyses = [
      Task.async(fn -> LinguisticAnalyzer.analyze(artifact) end),
      Task.async(fn -> BehavioralAnalyzer.analyze(artifact) end),
      Task.async(fn -> MediaForensics.examine(artifact) end),
      Task.async(fn -> NetworkAnalyzer.analyze(artifact) end)
    ]
    |> Task.await_many(25_000)
    |> Enum.filter(&match?({:ok, _}, &1))
    |> Enum.map(fn {:ok, result} -> result end)

    detection = correlate_findings(analyses)
    {:reply, {:ok, detection}, update_state(state, detection)}
  end
end

Integration Points

Integration TargetRelationshipData Flow
manipulation-detectionComplementary stream-level detection coverageBidirectional
manipulation-forensicsDetection findings trigger forensic investigationOutbound
manipulation-researchResearch outputs update detection modelsInbound
blue-commanderDetection findings feed defensive posture assessmentOutbound
purple-coordinatorFindings contribute to Red-Blue synthesisOutbound
Prismatic AgentsRuntime execution and lifecycle managementInfrastructure
Prismatic TelemetryDetection metrics and event trackingOutbound

Operational Workflow

Phase 1 -- WHITE Mode Validation: Every incoming analysis request is validated against the WHITE-mode capability whitelist before processing begins.

Phase 2 -- Multi-Modal Analysis: Artifact is processed through all applicable analysis modules concurrently. Each module produces independent findings with confidence scores.

Phase 3 -- Cross-Modal Correlation: Findings from individual analysis modules are correlated to identify patterns that emerge only when viewed across multiple analytical dimensions.

Phase 4 -- Detection Reporting: Consolidated findings are formatted into structured detection reports with per-finding confidence scores and full evidence chains.

Phase 5 -- Escalation: Detections exceeding confidence thresholds are escalated to forensics for investigation and to the blue team for defensive posture updates.

NABLA Compliance

AxiomManipulation Detector Application
Signal PluralityDetections require findings from minimum two analytical modules
Contradiction PreservationConflicting findings across modules are preserved for review
Absence InformativeAbsence of manipulation indicators is reported with confidence
Time DecayDetection model currency tracked; stale models trigger updates
Unknown ValidNovel patterns flagged as unknown rather than classified prematurely
Source IndependenceIndependent analytical modules provide non-correlated signals
Provenance MandatoryEvery finding carries full analytical method and evidence attribution

Configuration

config :prismatic_security, Prismatic.Security.ManipulationDetector,
  white_mode_only: true,
  min_detection_confidence: 0.65,
  analysis_timeout_ms: 30_000,
  enabled_modules: [:linguistic, :behavioral, :media, :network],
  model_update_interval: :daily,
  telemetry_prefix: [:prismatic, :security, :manipulation_detector]

Performance

MetricTargetMeasured
Single artifact analysis< 10s4.2s (P95)
Linguistic analysis< 3s1.4s (P95)
Behavioral analysis< 5s2.8s (P95)
Media forensics< 8s3.6s (P95)
Cross-modal correlation< 1s380ms (P95)
Concurrent analyses20+30 tested

Connect & Contribute

Created by Tomáš Korcak (korczis) | Open Source under GHL