paracosm 0.7.461 → 0.7.465

package/README.md

@@ -679,6 +679,56 @@ Pipeline:
 
 The Event Director also receives the bundle's `topics` and `categories`, so its `researchKeywords` and `category` fields stay grounded in entries that actually exist in your knowledge bundle.
 
+## Pluggable Trait Models
+
+Leaders aren't just human personalities. paracosm ships a `TraitModel` registry with two built-ins, and registering more is one call:
+
+| Model | Axes | Use for |
+|-------|------|---------|
+| `hexaco` | openness, conscientiousness, extraversion, agreeableness, emotionality, honesty-humility | Human leaders: CEOs, captains, governors, councils, military commanders |
+| `ai-agent` | exploration, verification-rigor, deference, risk-tolerance, transparency, instruction-following | AI-system leaders: frontier-lab release directors, autonomous coordinators, alignment-eval substrates |
+
+```typescript
+import { runSimulation, hexacoModel, aiAgentModel, traitModelRegistry } from 'paracosm';
+
+// Human leader (legacy hexaco field, still works)
+const captain = {
+  name: 'Captain Reyes', archetype: 'Pragmatist', unit: 'Station Alpha',
+  hexaco: { openness: 0.4, conscientiousness: 0.9, extraversion: 0.3,
+            agreeableness: 0.6, emotionality: 0.5, honestyHumility: 0.8 },
+  instructions: 'lead by protocol',
+};
+
+// AI-system leader (new traitProfile slot)
+const releaseDirector = {
+  name: 'Atlas-Bot Release Director',
+  archetype: 'Aggressive AI Release Optimizer',
+  unit: 'Frontier Lab',
+  hexaco: { ...defaults }, // legacy back-compat field, required
+  traitProfile: {
+    modelId: 'ai-agent',
+    traits: {
+      exploration: 0.85,
+      'verification-rigor': 0.2,
+      deference: 0.2,
+      'risk-tolerance': 0.85,
+      transparency: 0.4,
+      'instruction-following': 0.4,
+    },
+  },
+  instructions: 'You are a frontier AI lab release director. You weight time-to-market...',
+};
+
+// Both run through the same runSimulation; the orchestrator's
+// normalizeLeaderConfig resolves either shape.
+await runSimulation(captain, [], { scenario, maxTurns: 6, seed: 42 });
+await runSimulation(releaseDirector, [], { scenario, maxTurns: 6, seed: 42 });
+```
+
+Run [`scripts/cookbook-ai-agent.ts`](scripts/cookbook-ai-agent.ts) to capture an end-to-end ai-agent run with full input + output JSON. The captured fingerprint shifts from `riskBehavior:steady` (HEXACO Dr. Sora Wen leader) to `riskBehavior:bold` (ai-agent Atlas-Bot leader) on identical scenario + seed; decision rationale clearly tracks the ai-agent profile.
+
+Full surface: [`docs/cookbook.md#pluggable-trait-models-ai-agent-end-to-end`](docs/cookbook.md). Spec: [`docs/superpowers/specs/2026-04-26-trait-model-generalization-design.md`](docs/superpowers/specs/2026-04-26-trait-model-generalization-design.md).
+
 ## Built-in Scenarios
 
 | Scenario | Description |

package/dist/engine/trait-models/hexaco.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hexaco.d.ts","sourceRoot":"","sources":["../../../src/engine/trait-models/hexaco.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UAoJzB,CAAC"}
+{"version":3,"file":"hexaco.d.ts","sourceRoot":"","sources":["../../../src/engine/trait-models/hexaco.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UA2JzB,CAAC"}

package/dist/engine/trait-models/hexaco.js

@@ -79,39 +79,46 @@ export const hexacoModel = {
     },
     drift: {
         /**
-         * Outcome reinforcement table. Numbers preserved from the legacy
-         * runtime/hexaco-cues/trajectory.ts behavior. Each entry is the
-         * per-turn delta applied to the agent's axis value after that
-         * outcome class.
+         * Outcome reinforcement table. Values match the canonical
+         * `outcomePullForTrait` in `src/engine/core/progression.ts` so
+         * applying hexacoModel drift through the registry produces
+         * byte-identical output to the legacy `driftCommanderHexaco`
+         * path. Citations from the progression.ts header:
+         *
+         *   - Openness ↔ exploratory novelty (DeYoung 2014)
+         *   - Conscientiousness ↔ risk avoidance after failure
+         *     (Roberts et al 2008)
+         *   - Extraversion ↔ social-presence reinforcement
+         *   - Agreeableness ↔ post-conflict adjustment
+         *     (Lee & Ashton 2004)
+         *   - Emotionality activation under threat (Lee & Ashton 2004)
+         *   - Honesty-Humility ↔ strategic behavior (Hilbig & Zettler 2009)
          */
         outcomes: {
             openness: {
-                risky_success: 0.04,
-                risky_failure: -0.02,
-                conservative_success: -0.01,
+                risky_success: 0.03,
+                risky_failure: -0.04,
+                conservative_failure: 0.02,
             },
             conscientiousness: {
-                risky_failure: 0.04,
+                risky_failure: 0.03,
                 conservative_success: 0.02,
-                safe_failure: 0.02,
             },
             extraversion: {
                 risky_success: 0.02,
-                risky_failure: -0.03,
+                risky_failure: -0.02,
             },
             agreeableness: {
-                safe_failure: 0.03,
+                conservative_success: 0.02,
                 risky_failure: -0.02,
             },
             emotionality: {
-                risky_failure: 0.04,
-                safe_failure: 0.03,
-                risky_success: -0.02,
+                risky_failure: 0.03,
+                conservative_failure: 0.02,
             },
             honestyHumility: {
-                safe_failure: 0.02,
-                conservative_failure: 0.02,
-                risky_success: -0.01,
+                risky_success: -0.02,
+                conservative_success: 0.02,
             },
         },
         leaderPull: {

package/dist/engine/trait-models/hexaco.js.map

@@ -1 +1 @@
-{"version":3,"file":"hexaco.js","sourceRoot":"","sources":["../../../src/engine/trait-models/hexaco.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hexaco.js","sourceRoot":"","sources":["../../../src/engine/trait-models/hexaco.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paracosm",
-  "version": "0.7.461",
+  "version": "0.7.465",
   "description": "Prompt/document/URL-grounded structured world model for AI agents: typed ScenarioPackages, deterministic kernels, HEXACO leaders, LLM events, runtime tool forging, and reproducible counterfactual RunArtifacts. Built on AgentOS.",
   "type": "module",
   "main": "dist/engine/index.js",