Interface: ParacosmClient
Defined in: apps/paracosm/src/runtime/client.ts:80
Handle returned by createParacosmClient. The three methods mirror
the corresponding standalone exports — same arg shapes, same return
types — but with the client's defaults layered in.
Properties
compileScenario()
compileScenario: (
scenarioJson,opts?) =>Promise<ScenarioPackage>
Defined in: apps/paracosm/src/runtime/client.ts:98
Compile a scenario with the client's compiler defaults.
Parameters
scenarioJson
Record<string, unknown>
opts?
Returns
Promise<ScenarioPackage>
runBatch()
runBatch: (
config) =>Promise<BatchManifest>
Defined in: apps/paracosm/src/runtime/client.ts:94
Run a batch sweep. Scenarios / leaders / turns / seed are the caller's responsibility; provider + costPreset + models inherit.
Parameters
config
Returns
Promise<BatchManifest>
runSimulation()
runSimulation: (
leader,keyPersonnel,opts?) =>Promise<{aborted:boolean;agentReactions:object[];agentTrajectories: {[k:string]:object; };citationCatalog:CitationCatalogEntry[];commanderDecisions:object[];cost: {cacheStats?:CacheStats;forgeStats?:ForgeStats;llmCalls:number;providerErrors?:ProviderErrorStats;schemaRetries?:Record<string, {attempts:number;calls:number;fallbacks:number; }>;totalCostUSD:number;totalTokens:number; };directorEvents:object[];finalState:SimulationState;fingerprint: {[key:string]:string; };forgeAttempts:CapturedForge&object[];forgedToolbox:ForgedToolboxEntry[];leader: {archetype:string;colony:string;hexaco:HexacoProfile;hexacoBaseline: {agreeableness:number;conscientiousness:number;emotionality:number;extraversion:number;honestyHumility:number;openness:number; };hexacoHistory:HexacoSnapshot[];name:string; };outcomeClassifications:object[];providerError: {actionUrl:string|undefined;kind:ProviderErrorKind;message:string;provider:string|undefined; } |null;simulation:string;toolRegistries:Record<string,string[]>;totalCitations:number;totalToolsForged:number;turnArtifacts:TurnArtifact[]; }>
Defined in: apps/paracosm/src/runtime/client.ts:85
Run one simulation. Leader + key personnel passed per-call; all other options inherit from the client with per-call overrides.
Parameters
leader
keyPersonnel
opts?
Returns
Promise<{ aborted: boolean; agentReactions: object[]; agentTrajectories: {[k: string]: object; }; citationCatalog: CitationCatalogEntry[]; commanderDecisions: object[]; cost: { cacheStats?: CacheStats; forgeStats?: ForgeStats; llmCalls: number; providerErrors?: ProviderErrorStats; schemaRetries?: Record<string, { attempts: number; calls: number; fallbacks: number; }>; totalCostUSD: number; totalTokens: number; }; directorEvents: object[]; finalState: SimulationState; fingerprint: {[key: string]: string; }; forgeAttempts: CapturedForge & object[]; forgedToolbox: ForgedToolboxEntry[]; leader: { archetype: string; colony: string; hexaco: HexacoProfile; hexacoBaseline: { agreeableness: number; conscientiousness: number; emotionality: number; extraversion: number; honestyHumility: number; openness: number; }; hexacoHistory: HexacoSnapshot[]; name: string; }; outcomeClassifications: object[]; providerError: { actionUrl: string | undefined; kind: ProviderErrorKind; message: string; provider: string | undefined; } | null; simulation: string; toolRegistries: Record<string, string[]>; totalCitations: number; totalToolsForged: number; turnArtifacts: TurnArtifact[]; }>