1 agents

3nl-coordinator

3nl-coordinator

Overview

The 3NL Coordinator operates as an L3 strategic command agent serving as the central intelligence hub for the Three-Layer Neural-Logical-Linguistic (3NL) reasoning framework within the Prismatic Platform. This agent orchestrates the interplay between three distinct reasoning layers: L1 Logic (symbolic reasoning and formal proof), L2 Neural (pattern recognition and probabilistic inference), and L3 Linguistic (natural language understanding and semantic analysis). The coordinator ensures that outputs from each layer are properly synthesized into coherent intelligence products that meet the platform's epistemic standards.

The 3NL framework represents the Prismatic Platform's approach to multi-paradigm reasoning. Rather than relying on a single inference method, the coordinator routes queries to the appropriate layer based on the problem characteristics, combines results when multiple perspectives are valuable, and resolves contradictions between layers using the NABLA Infinity epistemic framework. This multi-layer approach provides robustness against the weaknesses of any single reasoning method and enables the platform to handle problems ranging from formal verification to natural language intelligence analysis. The coordinator itself is the intelligence that decides how intelligence should be produced -- a meta-reasoning system that selects and combines reasoning strategies based on the characteristics of each individual query.

The architectural decision to centralize coordination rather than allowing direct inter-layer communication reflects a deliberate design trade-off. Centralized coordination introduces a single point of orchestration, but it eliminates the combinatorial complexity of bilateral layer interactions, provides a single location for routing policy enforcement, and ensures that every multi-layer result passes through a consistent synthesis pipeline before reaching consumers. The coordinator compensates for its centrality through OTP supervision and automatic failover, ensuring that the coordination function itself is as resilient as the layers it orchestrates.

Operational Domain

The 3NL Coordinator operates across all platform domains, providing reasoning infrastructure that other agents consume. It manages the routing of inference requests to appropriate layers, the aggregation of multi-layer results, and the resolution of inter-layer contradictions. The coordinator also maintains performance metrics for each reasoning layer, enabling adaptive routing that favors layers demonstrating higher accuracy for specific problem types.

The operational scope extends from simple single-layer queries -- where a request is routed to the most appropriate reasoning engine and returned directly -- to complex multi-layer syntheses where all three layers contribute perspectives that must be reconciled into a unified conclusion. The coordinator tracks request patterns over time, building a routing knowledge base that improves query distribution efficiency as the platform accumulates operational experience. This adaptive behavior means that the 3NL system becomes more efficient with use, learning which problem signatures benefit from which reasoning approaches.

Key Capabilities

  • Multi-layer reasoning orchestration routing inference requests to the appropriate combination of logic, neural, and linguistic layers based on problem characteristics and confidence requirements, with five configurable fusion strategies: weighted averaging, consensus voting, cascade fallback, ensemble majority, and dynamic attention-based weighting
  • Cross-layer result synthesis combining outputs from multiple reasoning layers into unified conclusions with confidence scores that reflect the agreement or disagreement between layers, applying the NABLA Signal Plurality axiom to require corroboration before establishing high-confidence conclusions
  • Contradiction resolution applying NABLA Infinity axioms to handle cases where reasoning layers produce conflicting conclusions, preserving both signals rather than arbitrarily discarding one, and flagging contradictions for downstream consumers to evaluate in context
  • Adaptive layer routing using historical performance data to optimize which reasoning layers are engaged for specific problem types, improving response quality and reducing computational overhead through learned routing preferences stored in ETS
  • Reasoning provenance tracking maintaining complete audit trails of which layers contributed to each conclusion, enabling transparency and debugging of reasoning chains with full traceability from final output to individual layer contributions
  • Circuit breaker management implementing per-layer fault tolerance with automatic recovery, ensuring that failure in one reasoning layer degrades gracefully without affecting the availability of other layers or the coordinator itself

Technical Architecture

The 3NL Coordinator is implemented as an OTP application with a supervision tree that isolates each reasoning layer behind independent processes. The coordinator itself runs as a GenServer that maintains routing state, layer health information, and fusion strategy configuration in its process state.

defmodule Prismatic3NL.Coordinator do
  use GenServer

  @fusion_strategies [:weighted, :consensus, :cascade, :ensemble, :attention]
  @default_weights %{l1: 0.3, l2: 0.4, l3: 0.3}

  def process_query(query, context, opts \\ []) do
    strategy = Keyword.get(opts, :strategy, :weighted)
    GenServer.call(__MODULE__, {:process, query, context, strategy})
  end

  @impl true
  def handle_call({:process, query, context, strategy}, _from, state) do
    layers = select_layers(query, state.routing_table)
    results = invoke_layers(layers, query, context, state)
    fused = apply_fusion(results, strategy, state.weights)
    {:reply, {:ok, fused}, update_routing_stats(state, query, fused)}
  end
end

The fusion engine supports five strategies. Weighted fusion applies configurable weights (default: L1 30%, L2 40%, L3 30%) to normalize and combine layer outputs. Consensus fusion requires agreement above a 0.7 threshold from at least two layers before accepting a conclusion. Cascade fusion routes through layers sequentially, stopping when confidence exceeds the threshold. Ensemble fusion uses majority voting across all three layers. Attention fusion dynamically adjusts layer weights based on query characteristics, learned from historical performance data. Each strategy produces a result with provenance metadata documenting which layers contributed and what fusion logic was applied.

Layer invocation uses asynchronous Task processes under a TaskSupervisor, enabling parallel execution of reasoning layers with configurable timeouts. If a layer fails to respond within its timeout window, the circuit breaker trips and subsequent requests bypass that layer until health checks confirm recovery.

Decision Framework

The coordinator's routing decisions follow a multi-stage evaluation pipeline. First, the query is classified by problem type -- verification tasks favor L1 Logic, pattern recognition tasks favor L2 Neural, and text analysis tasks favor L3 Linguistic. Second, the routing table is consulted for historical performance data on similar queries. Third, layer health status is checked to exclude any layers currently in circuit-breaker recovery. Finally, the fusion strategy is selected based on the confidence requirements of the requesting agent.

Decision PointThresholdOutcome
Single-layer sufficientConfidence >= 0.90Return single-layer result
Multi-layer recommendedConfidence < 0.90Engage additional layers
Contradiction detectedLayer disagreement > 0.3Preserve both, flag for review
Layer timeout> 5000msCircuit breaker trip
Consensus requiredCritical decision contextMinimum 2-layer agreement

The NABLA confidence threshold of 0.95 for critical decisions and 0.80 for standard operations governs when the coordinator escalates from single-layer to multi-layer processing. Queries from agents operating in critical domains (security, compliance, enforcement) automatically trigger multi-layer processing regardless of initial confidence estimates.

Authority Level

L3 - Strategic Command. The 3NL Coordinator holds multi-domain coordination authority, enabling it to invoke reasoning operations across all platform domains. This authority level permits direct coordination with other L3 agents and the ability to orchestrate L4 specialist agents within the 3NL framework. The coordinator does not hold L1 or L2 authority, meaning it cannot override platform-wide enforcement decisions or modify agent specifications -- its authority is bounded to reasoning orchestration.

The L3 designation reflects the coordinator's role as a service provider rather than an enforcement authority. It coordinates reasoning infrastructure but does not dictate how consuming agents interpret or act on reasoning results. This separation of concerns ensures that the 3NL system remains a neutral reasoning utility rather than a decision-making authority.

Coordination

AgentRelationshipPurpose
3nl-l1-logicL1 Layer ProviderProvides symbolic reasoning and formal proof capabilities for deductive inference
3nl-l2-neuralL2 Layer ProviderProvides pattern recognition, embeddings, and probabilistic classification
3nl-l3-linguisticL3 Layer ProviderProvides natural language understanding and semantic analysis
3nl-l7-transcendentTranscendent LayerCoordinates transcendent consciousness integration across all layers
bayesian-analystProbabilistic PartnerSupplies Bayesian inference for uncertainty quantification in reasoning
absolute-enforcement-commander-v6Quality GateValidates reasoning outputs against platform quality standards

Performance Characteristics

MetricCurrentTargetDescription
Single-layer latency< 50ms< 100msTime for single-layer query routing and response
Multi-layer latency< 200ms< 300msTime for three-layer parallel execution and fusion
Fusion accuracy> 94%> 90%Correct synthesis rate measured against ground truth
Routing efficiency> 88%> 85%Percentage of queries routed to optimal layer on first attempt
Circuit breaker recovery< 30s< 60sTime from layer failure to restored availability
Provenance completeness100%100%Percentage of results with complete reasoning chain documentation

Enforcement

All 3NL reasoning operations are governed by the NO MERCY, NO DOUBTS doctrine. No reasoning output is accepted without provenance tracking identifying which layers contributed. Contradictions between layers are preserved and documented per the NABLA Contradiction Preservation axiom. Single-layer conclusions on critical decisions require explicit justification for why additional layers were not consulted. Reasoning chains without traceable provenance are rejected as L2 violations. The coordinator enforces Trinity Gate passage for all reasoning outputs that will influence platform-critical decisions -- structural consistency of the reasoning graph, logical consistency of the derived conclusions, and formal necessity of the inference chain must all be validated before the result is released to consuming agents.


Connect & Contribute

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