CultLib/packages/cultnet-ts/src/generated/swarm-contracts.generated.ts

import { defineJsonSchemaContract } from "../json-schema-contract";
import ghostlightAgentStateGeneratedContractSchema from "../../contracts/cultnet/ghostlight.agent-state.schema.json";

// Generated by tools/generate-swarm-contracts.mjs. Do not hand-edit this file unless you enjoy losing arguments with a machine.

/**
 * First canonical contract for Ghostlight agent, perception, relationship, event, scene, and dialogue-context state.
 */
export interface GhostlightAgentStateShape {
  schema_version: 'ghostlight.agent_state.v0';
  world: WorldState;
  agents: Agent[];
  relationships: Relationship[];
  events: Event[];
  scenes: Scene[];
}
export interface WorldState {
  world_id: string;
  setting: string;
  time: {
    label: string;
    [k: string]: unknown;
  };
  canon_context: string[];
  ambient_pressures?: Pressure[];
}
export interface Pressure {
  pressure_id: string;
  label: string;
  intensity: number;
}
export interface Agent {
  agent_id: string;
  identity: Identity;
  canonical_state: CanonicalState;
  goals: Goal[];
  memories: MemoryBundle;
  perceived_state_overlays: PerceivedStateOverlay[];
}
export interface Identity {
  name: string;
  roles: string[];
  origin: string;
  public_description: string;
  private_notes?: string[];
}
export interface CanonicalState {
  underlying_organization: VariableMap;
  stable_dispositions: VariableMap;
  behavioral_dimensions: VariableMap;
  presentation_strategy: VariableMap;
  situational_state: VariableMap;
  values: ValueCommitment[];
  voice_style: VariableMap;
}
export interface VariableMap {
  [k: string]: StateVariable;
}
export interface StateVariable {
  mean: number;
  plasticity: number;
  current_activation: number;
  evidence?: string[];
}
export interface ValueCommitment {
  value_id: string;
  label: string;
  priority: number;
  unforgivable_if_betrayed: boolean;
}
export interface Goal {
  goal_id: string;
  description: string;
  scope: 'immediate' | 'scene' | 'case' | 'arc' | 'life';
  priority: number;
  emotional_stake: string;
  blockers?: string[];
  status: 'active' | 'blocked' | 'dormant' | 'resolved' | 'abandoned';
}
export interface MemoryBundle {
  episodic: Memory[];
  semantic: Memory[];
  relationship_summaries: Memory[];
}
export interface Memory {
  memory_id: string;
  summary: string;
  salience: number;
  confidence: number;
  linked_event_ids?: string[];
  linked_relationship_id?: string;
}
export interface PerceivedStateOverlay {
  observer_agent_id: string;
  target_agent_id: string;
  perceived_dimensions: InferredVariableMap;
  beliefs: Belief[];
  distortions: (
    | 'hostile_attribution'
    | 'false_reassurance'
    | 'overread_warmth'
    | 'underread_threat'
    | 'false_mask_detection'
    | 'missed_mask_detection'
    | 'status_injury'
    | 'threat_amplification'
    | 'institutional_suspicion_transfer'
    | 'care_underread'
    | 'mask_overfocus'
  )[];
}
export interface InferredVariableMap {
  [k: string]: InferredStateVariable;
}
export interface InferredStateVariable {
  observed_activation: number;
  attributed_disposition: number;
  confidence: number;
  evidence?: string[];
}
export interface Belief {
  belief_id: string;
  claim: string;
  confidence: number;
  subject_id?: string;
  claim_type?:
    'fact' | 'identity_inference' | 'motive_inference' | 'prediction' | 'norm' | 'value_read' | 'relationship_read';
  evidence_event_ids?: string[];
  visibility?: 'private' | 'shared' | 'public' | 'rumor';
  emotional_charge?: number;
}
export interface Relationship {
  relationship_id: string;
  source_id: string;
  target_id: string;
  stance: VariableMap;
  summary: string;
  unresolved_incident_ids?: string[];
}
export interface Event {
  event_id: string;
  kind: 'dialogue' | 'action' | 'memory' | 'relationship_shift' | 'scene_outcome' | 'author_note';
  summary: string;
  participants: string[];
  pressure_tags: string[];
  observed_exchange?: EventExchangeTurn[];
  private_interpretations?: EventPrivateInterpretation[];
  event_effects?: EventEffect[];
}
export interface EventExchangeTurn {
  speaker_id: string;
  utterance_summary: string;
  dialogue_function: string;
  observable_cues?: string[];
}
export interface EventPrivateInterpretation {
  agent_id: string;
  interpretation: string;
  attributed_motive?: string;
  appraisal_tags?: string[];
  confidence: number;
}
export interface EventEffect {
  agent_id: string;
  summary: string;
  state_deltas?: StateDelta[];
  new_belief_ids?: string[];
  memory_update_ids?: string[];
}
export interface StateDelta {
  path: string;
  delta: number;
}
export interface Scene {
  scene_id: string;
  location: string;
  participants: string[];
  public_stakes: string[];
  hidden_stakes: string[];
  dialogue_context_packs: DialogueContextPack[];
}
export interface DialogueContextPack {
  speaker_agent_id: string;
  listener_ids: string[];
  speaker_local_truth: string[];
  speaker_beliefs: string[];
  active_memories: string[];
  active_goals: string[];
  presentation_constraints: string[];
}

export const ghostlightAgentStateGeneratedContract = defineJsonSchemaContract<GhostlightAgentStateShape>({
  schemaId: "https://github.com/GameCult/Ghostlight/schemas/agent-state.schema.json",
  schema: ghostlightAgentStateGeneratedContractSchema,
});

export function validateGhostlightAgentStateGenerated(value: unknown): value is GhostlightAgentStateShape {
  return ghostlightAgentStateGeneratedContract.validate(value);
}

export function parseGhostlightAgentStateGenerated(value: unknown): GhostlightAgentStateShape {
  return ghostlightAgentStateGeneratedContract.parse(value);
}