Open SDK • Zero Dependencies • MIT License

Proteus SDK V6.5

Universal JavaScript SDK for the PFS Multi-Agent Orchestration System

Orchestrate intelligent agents with the P (Pater/Strategic), F (Filius/Analytical), S (Spiritus/Creative) framework. 97 genes, 11 classifiers, 7 species, 4-layer gene expression cascade.

PFS Agent Architecture

P

Pater — Strategic

High-level strategic decisions, risk assessment, triage, and directive synthesis. Best for urgent scenarios requiring authoritative judgment.

proteus.chat('pater', prompt)
F

Filius — Analytical

Deep analytical processing, pattern recognition, data interpretation. Ideal for domain-specific analysis like cardiology or pneumology.

proteus.chat('filius', prompt)
S

Spiritus — Creative

Creative synthesis, lateral thinking, novel pattern identification. Generates unexpected connections and alternative interpretations.

proteus.chat('spiritus', prompt)

Orchestration

Combine P, F, S agents in PARALLEL or SEQUENTIAL modes with automatic consensus synthesis.

Genomic Mutations

97 genes across 11 classifiers with propose → vote → apply pipeline and 5 validation levels.

Evolution Cycles

6-phase evolution with fitness evaluation, crossover, and lineage tracking.

Memory & Snapshots

Chronicle system with snapshots, rollback, and full lineage tracking across generations.

Quick Start

<!-- Include the SDK -->
<script src="https://sdk.eloaim.app/assets/js/proteus-sdk.js"></script>

<script>
// Initialize with your API key
const proteus = new ProteusSDK({
    baseURL: 'https://acadiam.ca/api',
    apiKey:  'pak_your_key_here'
});

// Chat with a specific agent species
const result = await proteus.chat('filius', 'Analyze this ECG pattern...', {
    systemPrompt: 'You are a cardiology specialist.',
    temperature: 0.3
});

// PFS orchestration (all 3 agents)
const synthesis = await proteus.orchestrate(
    ['pater', 'filius', 'spiritus'],
    'Evaluate patient vitals: HR=52, SpO2=94%, Temp=38.1°C',
    { mode: 'PARALLEL' }
);
</script>
import { ProteusSDK } from './proteus-sdk.js';

const proteus = new ProteusSDK({
    baseURL: 'https://acadiam.ca/api',
    apiKey:  process.env.PROTEUS_API_KEY
});

// Analyze with the Filius agent
const analysis = await proteus.analyze('filius', {
    data: patientVitals,
    context: 'Medical monitoring'
});

// Research with PeFiSE (P+F+S exploration)
const research = await proteus.research('Cardiac arrhythmia patterns', {
    depth: 'thorough'
});

console.log(analysis.content);
// Secure PHP Proxy — keeps API key server-side
// api/proteus-proxy.php
<?php
header('Content-Type: application/json');
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    exit(json_encode(['error' => 'POST only']));
}

$input     = json_decode(file_get_contents('php://input'), true);
$apiKey    = 'pak_your_server_side_key';  // Never expose!
$backend   = 'https://acadiam.ca/api/proteus.php?action=mcp_proxy';

$ch = curl_init($backend);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($input),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 25,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $apiKey
    ]
]);
echo curl_exec($ch);
curl_close($ch);
?>

API Reference

Constructor

new ProteusSDK({ baseURL, apiKey, timeout? })
baseURLstringProteus backend URL (e.g. https://acadiam.ca/api)
apiKeystringPlugin API key (pak_...)
timeoutnumberRequest timeout in ms (default: 30000)

Core Methods

chat(species, prompt, options?)

Send a chat message to a specific agent species.

speciesstring'pater' | 'filius' | 'spiritus' | 'praefectus' | 'propheta' | 'faber' | 'omniscient'
promptstringThe message to send
options.systemPromptstringSystem prompt for context
options.temperaturenumberLLM temperature (0.0–1.0)
options.maxTokensnumberMax response tokens
orchestrate(species[], prompt, options?)

Orchestrate multiple agents for a combined analysis with consensus synthesis.

speciesstring[]Array of species to orchestrate
promptstringThe task description
options.modestring'PARALLEL' | 'SEQUENTIAL'
analyze(species, options)

Perform structured analysis with a specific agent.

speciesstringAgent species
options.dataobjectData payload to analyze
options.contextstringAnalysis context
research(topic, options?)

Multi-agent PeFiSE research on a topic.

topicstringResearch topic
options.depthstring'quick' | 'standard' | 'thorough'

Genome & Evolution

getGenome(species?)

Retrieve the chromosomal genome (97 genes, 11 classifiers).

mutate(mutations, options?)

Propose mutations via the propose → vote → apply pipeline.

evolve(options?)

Trigger a full 6-phase evolution cycle with fitness evaluation.

crossover(speciesA, speciesB)

Perform genetic crossover between two species.

7 Species

P Pater — Strategic director
F Filius — Analytical processor
S Spiritus — Creative synthesizer
PF Praefectus — Strategic + Analytical hybrid
PS Propheta — Strategic + Creative hybrid
FS Faber — Analytical + Creative hybrid
PFS Omniscient — Full triad convergence

Download

proteus-sdk.js

Universal UMD bundle — works in browsers and Node.js 18+. Zero dependencies.

Download SDK ~25 KB • MIT License

proteus-sdk.d.ts

TypeScript type definitions for full IDE autocompletion and type safety.

Download Types TypeScript declarations

CDN

Include directly from the SDK portal — always up to date.

<script src="https://sdk.eloaim.app/assets/js/proteus-sdk.js"></script>

Get a Proteus API Key

Request a plugin API key (pak_...) to authenticate with the Proteus V6.5 backend. Keys are generated instantly.

Comma-separated domains. Leave empty for unrestricted.