paracosm 0.7.455 → 0.7.458

package/dist/engine/trait-models/drift.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Trait drift dispatcher. Reads a TraitProfile + the profile's
+ * TraitModel and applies the three drift sources defined in the
+ * model's DriftTable:
+ *
+ *   1. Outcome reinforcement: each turn outcome class produces a
+ *      per-axis delta (e.g. risky_failure raises verification-rigor on
+ *      the ai-agent model, raises emotionality on the hexaco model).
+ *   2. Leader pull: agents drift toward their leader's traits at the
+ *      per-axis pull strength.
+ *   3. Role activation: agents promoted to a department whose role
+ *      activates an axis get an extra push on that axis.
+ *
+ * Each call clamps the resulting trait values to [0, 1].
+ *
+ * @module paracosm/engine/trait-models/drift
+ */
+import type { Outcome, TraitModel, TraitProfile } from './index.js';
+export interface DriftOutcomeContext {
+    /** The outcome class the kernel emitted for this turn. */
+    outcome: Outcome;
+}
+export interface DriftLeaderPullContext {
+    /** The leader's profile (the pull target). */
+    leader: TraitProfile;
+}
+export interface DriftRoleActivationContext {
+    /** axis-id -> sign (+1 to push up, -1 to push down). */
+    axisSigns: Record<string, 1 | -1>;
+}
+/**
+ * Apply outcome-reinforcement drift to a profile in place. Returns a
+ * new TraitProfile (same modelId) with the deltas applied + clamped.
+ */
+export declare function applyOutcomeDrift(profile: TraitProfile, model: TraitModel, ctx: DriftOutcomeContext): TraitProfile;
+/**
+ * Apply leader-pull drift: shift the agent's profile toward the
+ * leader's per-axis values by `model.drift.leaderPull[axisId] *
+ * (leader[axis] - agent[axis])`. Returns a new TraitProfile.
+ *
+ * Skipped when the agent's modelId differs from the leader's
+ * (cross-model pull is undefined).
+ */
+export declare function applyLeaderPull(agent: TraitProfile, model: TraitModel, ctx: DriftLeaderPullContext): TraitProfile;
+/**
+ * Apply role-activation drift: when an agent is promoted to a
+ * department whose role activates one or more axes, push those axes
+ * by `model.drift.roleActivation[axisId] * sign`. Sign comes from the
+ * scenario's role-axis mapping (caller supplies via ctx.axisSigns).
+ * Returns a new TraitProfile.
+ */
+export declare function applyRoleActivation(profile: TraitProfile, model: TraitModel, ctx: DriftRoleActivationContext): TraitProfile;
+//# sourceMappingURL=drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../../src/engine/trait-models/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,mBAAmB,GACvB,YAAY,CAed;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,sBAAsB,GAC1B,YAAY,CAsBd;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,0BAA0B,GAC9B,YAAY,CAgBd"}

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

@@ -0,0 +1,88 @@
+/**
+ * Trait drift dispatcher. Reads a TraitProfile + the profile's
+ * TraitModel and applies the three drift sources defined in the
+ * model's DriftTable:
+ *
+ *   1. Outcome reinforcement: each turn outcome class produces a
+ *      per-axis delta (e.g. risky_failure raises verification-rigor on
+ *      the ai-agent model, raises emotionality on the hexaco model).
+ *   2. Leader pull: agents drift toward their leader's traits at the
+ *      per-axis pull strength.
+ *   3. Role activation: agents promoted to a department whose role
+ *      activates an axis get an extra push on that axis.
+ *
+ * Each call clamps the resulting trait values to [0, 1].
+ *
+ * @module paracosm/engine/trait-models/drift
+ */
+import { clampTrait, withDefaults } from './index.js';
+/**
+ * Apply outcome-reinforcement drift to a profile in place. Returns a
+ * new TraitProfile (same modelId) with the deltas applied + clamped.
+ */
+export function applyOutcomeDrift(profile, model, ctx) {
+    if (profile.modelId !== model.id) {
+        throw new Error(`applyOutcomeDrift: profile.modelId='${profile.modelId}' but model.id='${model.id}'`);
+    }
+    const filled = withDefaults(profile.traits, model);
+    const out = { ...filled };
+    for (const axis of model.axes) {
+        const delta = model.drift.outcomes[axis.id]?.[ctx.outcome] ?? 0;
+        if (delta !== 0) {
+            out[axis.id] = clampTrait(filled[axis.id] + delta);
+        }
+    }
+    return { modelId: profile.modelId, traits: out };
+}
+/**
+ * Apply leader-pull drift: shift the agent's profile toward the
+ * leader's per-axis values by `model.drift.leaderPull[axisId] *
+ * (leader[axis] - agent[axis])`. Returns a new TraitProfile.
+ *
+ * Skipped when the agent's modelId differs from the leader's
+ * (cross-model pull is undefined).
+ */
+export function applyLeaderPull(agent, model, ctx) {
+    if (agent.modelId !== model.id) {
+        throw new Error(`applyLeaderPull: agent.modelId='${agent.modelId}' but model.id='${model.id}'`);
+    }
+    if (ctx.leader.modelId !== model.id) {
+        // Cross-model pull is undefined; emit a noop (no warn; caller
+        // controls whether to allow mixed-model populations).
+        return agent;
+    }
+    const agentFilled = withDefaults(agent.traits, model);
+    const leaderFilled = withDefaults(ctx.leader.traits, model);
+    const out = { ...agentFilled };
+    for (const axis of model.axes) {
+        const pull = model.drift.leaderPull[axis.id] ?? 0;
+        if (pull > 0) {
+            const gap = leaderFilled[axis.id] - agentFilled[axis.id];
+            out[axis.id] = clampTrait(agentFilled[axis.id] + pull * gap);
+        }
+    }
+    return { modelId: agent.modelId, traits: out };
+}
+/**
+ * Apply role-activation drift: when an agent is promoted to a
+ * department whose role activates one or more axes, push those axes
+ * by `model.drift.roleActivation[axisId] * sign`. Sign comes from the
+ * scenario's role-axis mapping (caller supplies via ctx.axisSigns).
+ * Returns a new TraitProfile.
+ */
+export function applyRoleActivation(profile, model, ctx) {
+    if (profile.modelId !== model.id) {
+        throw new Error(`applyRoleActivation: profile.modelId='${profile.modelId}' but model.id='${model.id}'`);
+    }
+    const filled = withDefaults(profile.traits, model);
+    const out = { ...filled };
+    for (const axis of model.axes) {
+        const amplification = model.drift.roleActivation[axis.id] ?? 0;
+        const sign = ctx.axisSigns[axis.id];
+        if (amplification !== 0 && sign !== undefined) {
+            out[axis.id] = clampTrait(filled[axis.id] + amplification * sign);
+        }
+    }
+    return { modelId: profile.modelId, traits: out };
+}
+//# sourceMappingURL=drift.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * HEXACO trait model. The canonical six-axis personality model from
+ * Ashton & Lee (PSPR 2007), the historical default for paracosm
+ * leaders. Cue strings preserved verbatim from the legacy
+ * `runtime/hexaco-cues/translation.ts` so HEXACO scenario behavior
+ * is unchanged when a leader uses this model.
+ *
+ * Citation:
+ *   Ashton, M.C. & Lee, K. (2007). "Empirical, Theoretical, and
+ *   Practical Advantages of the HEXACO Model of Personality
+ *   Structure." Personality and Social Psychology Review, 11(2),
+ *   150-166. doi:10.1177/1088868306294907
+ *
+ * @module paracosm/engine/trait-models/hexaco
+ */
+import type { TraitModel } from './index.js';
+/**
+ * The HEXACO axes in their canonical order. Order is preserved so
+ * cue iteration matches the legacy translator's output.
+ */
+export declare const hexacoModel: TraitModel;
+//# sourceMappingURL=hexaco.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,168 @@
+/**
+ * HEXACO trait model. The canonical six-axis personality model from
+ * Ashton & Lee (PSPR 2007), the historical default for paracosm
+ * leaders. Cue strings preserved verbatim from the legacy
+ * `runtime/hexaco-cues/translation.ts` so HEXACO scenario behavior
+ * is unchanged when a leader uses this model.
+ *
+ * Citation:
+ *   Ashton, M.C. & Lee, K. (2007). "Empirical, Theoretical, and
+ *   Practical Advantages of the HEXACO Model of Personality
+ *   Structure." Personality and Social Psychology Review, 11(2),
+ *   150-166. doi:10.1177/1088868306294907
+ *
+ * @module paracosm/engine/trait-models/hexaco
+ */
+/**
+ * The HEXACO axes in their canonical order. Order is preserved so
+ * cue iteration matches the legacy translator's output.
+ */
+export const hexacoModel = {
+    id: 'hexaco',
+    name: 'HEXACO',
+    description: 'Six-factor human personality model: Honesty-Humility, Emotionality, ' +
+        'Extraversion, Agreeableness, Conscientiousness, Openness. The ' +
+        'historical default for paracosm leaders. Best fit for human-leader ' +
+        'scenarios (CEOs, captains, governors, ship commanders, councils).',
+    citation: 'Ashton & Lee, PSPR 11(2), 2007, doi:10.1177/1088868306294907',
+    axes: [
+        {
+            id: 'emotionality',
+            label: 'Emotionality',
+            description: 'Tendency to experience anxiety, sentimentality, and seek emotional support.',
+            lowPole: 'stays flat under stress',
+            highPole: 'feels events in body before words',
+        },
+        {
+            id: 'openness',
+            label: 'Openness',
+            description: 'Aesthetic sensitivity, intellectual curiosity, willingness to try unconventional approaches.',
+            lowPole: 'sticks to what has worked',
+            highPole: 'looks for what the moment makes possible',
+        },
+        {
+            id: 'honestyHumility',
+            label: 'Honesty-Humility',
+            description: 'Sincerity, fairness, modesty, low entitlement.',
+            lowPole: 'speaks strategically, not confessionally',
+            highPole: 'says what they really think',
+        },
+        {
+            id: 'conscientiousness',
+            label: 'Conscientiousness',
+            description: 'Organization, diligence, perfectionism, prudence.',
+            lowPole: 'moves first and adjusts mid-stride',
+            highPole: 'wants a plan before moving',
+        },
+        {
+            id: 'extraversion',
+            label: 'Extraversion',
+            description: 'Social self-esteem, social boldness, sociability, liveliness.',
+            lowPole: 'processes inward, speaks only after',
+            highPole: 'says it out loud rather than sit with it',
+        },
+        {
+            id: 'agreeableness',
+            label: 'Agreeableness',
+            description: 'Forgiveness, gentleness, flexibility, patience.',
+            lowPole: "doesn't owe anyone smoothness right now",
+            highPole: 'wants to hold the group together',
+        },
+    ],
+    defaults: {
+        emotionality: 0.5,
+        openness: 0.5,
+        honestyHumility: 0.5,
+        conscientiousness: 0.5,
+        extraversion: 0.5,
+        agreeableness: 0.5,
+    },
+    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.
+         */
+        outcomes: {
+            openness: {
+                risky_success: 0.04,
+                risky_failure: -0.02,
+                conservative_success: -0.01,
+            },
+            conscientiousness: {
+                risky_failure: 0.04,
+                conservative_success: 0.02,
+                safe_failure: 0.02,
+            },
+            extraversion: {
+                risky_success: 0.02,
+                risky_failure: -0.03,
+            },
+            agreeableness: {
+                safe_failure: 0.03,
+                risky_failure: -0.02,
+            },
+            emotionality: {
+                risky_failure: 0.04,
+                safe_failure: 0.03,
+                risky_success: -0.02,
+            },
+            honestyHumility: {
+                safe_failure: 0.02,
+                conservative_failure: 0.02,
+                risky_success: -0.01,
+            },
+        },
+        leaderPull: {
+            emotionality: 0.05,
+            openness: 0.06,
+            honestyHumility: 0.04,
+            conscientiousness: 0.06,
+            extraversion: 0.05,
+            agreeableness: 0.05,
+        },
+        roleActivation: {
+            conscientiousness: 0.03,
+            openness: 0.03,
+            honestyHumility: 0.02,
+            agreeableness: 0.02,
+            extraversion: 0.02,
+            emotionality: 0.02,
+        },
+    },
+    /**
+     * Cue strings lifted verbatim from
+     * `src/runtime/hexaco-cues/translation.ts` so HEXACO scenario
+     * behavior is unchanged. Mid-zone is omitted intentionally: the
+     * legacy translator only emits cues for polarized values.
+     */
+    cues: {
+        emotionality: {
+            low: 'you stay flat when others panic',
+            high: 'you feel events in your body before words',
+        },
+        openness: {
+            low: 'you stick to what has worked',
+            high: 'you look for what this moment makes possible',
+        },
+        honestyHumility: {
+            low: 'you speak strategically, not confessionally',
+            high: 'you say what you really think',
+        },
+        conscientiousness: {
+            low: 'you move first and adjust mid-stride',
+            high: 'you want a plan before you move',
+        },
+        extraversion: {
+            low: 'you process inward and speak only after',
+            high: 'you say it out loud rather than sit with it',
+        },
+        agreeableness: {
+            low: "you don't owe anyone smoothness right now",
+            high: 'you want to hold the group together through this',
+        },
+    },
+    recommendedProviders: ['openai', 'anthropic'],
+};
+//# sourceMappingURL=hexaco.js.map

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

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

package/dist/engine/trait-models/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Trait Model Registry. Pluggable interface for leader / agent
+ * personality (or, for non-human leaders, decision-tendency) models.
+ *
+ * Today paracosm ships two built-in models:
+ *   - 'hexaco'    six-axis Ashton-Lee personality (the historical default)
+ *   - 'ai-agent'  six-axis AI-system tendency model
+ *
+ * Adding a third model post-hoc is a single `traitModelRegistry.register(...)`
+ * call. See `docs/superpowers/specs/2026-04-26-trait-model-generalization-design.md`.
+ *
+ * @module paracosm/engine/trait-models
+ */
+import type { LlmProvider } from '../types.js';
+/**
+ * Outcome classes the kernel emits for each turn. Trait models map
+ * each outcome to a per-axis delta in their drift table.
+ */
+export type Outcome = 'risky_success' | 'risky_failure' | 'conservative_success' | 'conservative_failure' | 'safe_success' | 'safe_failure';
+/**
+ * One axis of a trait model. Axes are fixed at registration; the
+ * registry is registration-time-only.
+ */
+export interface TraitAxis {
+    /** kebab-case stable id used in serialization. */
+    id: string;
+    /** Human-readable label for UI. */
+    label: string;
+    /** One-sentence description of what the axis measures. */
+    description: string;
+    /** Optional short label for the low pole (UI tooltip). */
+    lowPole?: string;
+    /** Optional short label for the high pole (UI tooltip). */
+    highPole?: string;
+}
+/**
+ * Per-zone prose cue for prompt injection. Zone selection: `low` when
+ * value <= 0.35, `high` when value >= 0.65, `mid` otherwise.
+ */
+export interface CueZone {
+    low?: string;
+    mid?: string;
+    high?: string;
+}
+/**
+ * Drift parameters for a trait model. The kernel applies these to
+ * agents and to the leader after each turn outcome.
+ */
+export interface DriftTable {
+    /**
+     * axis-id -> outcome -> delta. Typical range -0.05 to +0.05.
+     * Missing entries treated as zero.
+     */
+    outcomes: Record<string, Partial<Record<Outcome, number>>>;
+    /**
+     * axis-id -> per-turn pull strength (0..1) toward the leader's value.
+     * Agents drift toward leader's traits; leader does not pull-self.
+     */
+    leaderPull: Record<string, number>;
+    /**
+     * axis-id -> per-turn amplification when the agent is promoted to a
+     * department whose role activates that axis. Sign-aware: positive
+     * pushes the trait up, negative pushes it down.
+     */
+    roleActivation: Record<string, number>;
+}
+/**
+ * Complete definition of a trait model. Registered once at engine
+ * load; consumed by the cue translator, the drift dispatcher, the
+ * dashboard sliders, and the prompt builder.
+ */
+export interface TraitModel {
+    /** kebab-case stable id used in artifacts and configs. */
+    id: string;
+    /** Human-readable name for UI. */
+    name: string;
+    /** One-paragraph description of the model. */
+    description: string;
+    /** Ordered list of axes; UI renders sliders in this order. */
+    axes: readonly TraitAxis[];
+    /** axis-id -> default float in [0, 1] when an axis is omitted. */
+    defaults: Record<string, number>;
+    /** Drift table consumed by the kernel between turns. */
+    drift: DriftTable;
+    /** axis-id -> per-zone prose cue for prompt injection. */
+    cues: Record<string, CueZone>;
+    /**
+     * Optional citation / provenance string for UI tooltips, e.g.
+     * "Ashton & Lee, PSPR 2007" for HEXACO.
+     */
+    citation?: string;
+    /**
+     * Recommended LLM providers / models for runs against this trait
+     * model. Informational only; the orchestrator does not enforce.
+     */
+    recommendedProviders?: readonly LlmProvider[];
+}
+/**
+ * A leader's (or agent's) profile under a specific trait model. Stored
+ * on LeaderConfig.traitProfile and Agent.traitProfile.
+ */
+export interface TraitProfile {
+    /** id of the registered TraitModel. */
+    modelId: string;
+    /** axis-id -> float in [0, 1]. */
+    traits: Record<string, number>;
+}
+/**
+ * Thrown when a TraitProfile references an unregistered modelId.
+ */
+export declare class UnknownTraitModelError extends Error {
+    readonly modelId: string;
+    readonly registered: readonly string[];
+    constructor(modelId: string, registered: readonly string[]);
+}
+/**
+ * In-memory map of TraitModel by id. The runtime singleton lives at
+ * `traitModelRegistry`; tests and isolated callers can construct
+ * their own via `new TraitModelRegistry()`.
+ */
+export declare class TraitModelRegistry {
+    private readonly models;
+    /**
+     * Register a model. Throws if a model with the same id is already
+     * registered (registration-time-only; no live re-binding).
+     */
+    register(model: TraitModel): void;
+    /** Return the model or `undefined` if not registered. */
+    get(modelId: string): TraitModel | undefined;
+    /** Return the model or throw `UnknownTraitModelError`. */
+    require(modelId: string): TraitModel;
+    /** All registered models in registration order. */
+    list(): TraitModel[];
+    /**
+     * Validate model shape: axes match defaults + drift + cues, ids are
+     * kebab-case, defaults are in [0, 1].
+     */
+    private assertValid;
+}
+/**
+ * Process-wide singleton registry. The hexaco + ai-agent built-ins
+ * register on import via `engine/trait-models/builtins.ts` (which is
+ * imported by `engine/index.ts`). External consumers should `import
+ * { traitModelRegistry } from 'paracosm/engine/trait-models'`.
+ */
+export declare const traitModelRegistry: TraitModelRegistry;
+/**
+ * Clamp a numeric trait value to [0, 1]. Used by the drift dispatcher
+ * after applying outcome / leader-pull / role-activation deltas.
+ */
+export declare function clampTrait(value: number): number;
+/**
+ * Compute the zone for a trait value: 'low' when <= 0.35, 'high' when
+ * >= 0.65, 'mid' otherwise. Used by the cue translator.
+ */
+export declare function traitZone(value: number): 'low' | 'mid' | 'high';
+/**
+ * Fill a partial trait map with model defaults so every axis has a
+ * value. Idempotent: existing keys are preserved.
+ */
+export declare function withDefaults(partial: Record<string, number>, model: TraitModel): Record<string, number>;
+//# sourceMappingURL=index.d.ts.map

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

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