Skip to content

Commit d2e8aed

Browse files
committed
docs(paracosm): reposition PARACOSM doc as structured world model
Updates the canonical paracosm doc that pull-docs.mjs syncs into agentos-live-docs/docs/features/paracosm.md, so the published docs site reflects the new positioning on the next build. Changes: - Title frontmatter: "Paracosm: Structured World Model for AI Agents" (was "Paracosm - AI Simulation Engine") - Opener rewrite: leads with "structured world model for AI agents" and adds a "Where paracosm sits in the world-model landscape" section citing Xing 2025 (arXiv:2507.05169), the ACM CSUR 2025 world-model survey, and Kirfel et al 2025 CWSM. Names the adjacent categories (Sora/Genie 3/Marble, LeCun AMI Labs, LangGraph/AutoGen/CrewAI/OpenAI Agents SDK, MiroFish/OASIS, Generative Agents/Concordia) as explicit contrast. - Links row includes the new positioning map anchor at github.com/framersai/paracosm/blob/master/docs/positioning/ world-model-mapping.md. - HEXACO bullets reformatted from "Openness - high: X; low: Y" to "Openness. High: X. Low: Y" for consistency with the em-dash-free style used across the new positioning surface. - All em-dashes replaced with colons or periods per the project's prose style rule. Zero em-dashes in the file after this change. Per release.config.js, "docs:" commits do not trigger a semantic-release npm publish, so @framers/agentos's version is unchanged. The docs workflow (docs.yml) will pick up the change and regenerate agentos-live-docs/docs/features/paracosm.md on its next scheduled deploy.
1 parent a597991 commit d2e8aed

1 file changed

Lines changed: 21 additions & 15 deletions

File tree

docs/PARACOSM.md

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
11
---
2-
title: "Paracosm — AI Simulation Engine"
2+
title: "Paracosm: Structured World Model for AI Agents"
33
sidebar_position: 1
44
---
55

6-
Paracosm is an AI agent swarm simulation engine built on AgentOS. Define a scenario as JSON, run it with AI commanders that have different [HEXACO](/features/cognitive-memory) personality profiles, and watch their decisions diverge into measurably different outcomes from the same seed. The reference scenario ships as Mars Genesis: a thirty-colonist Mars colony running from 2035 to 2067 across six turns.
6+
Paracosm is a **structured world model for AI agents**, built on AgentOS. Define a world as JSON, pick leaders with different [HEXACO](/features/cognitive-memory) personality profiles, and watch their decisions diverge into measurably different trajectories from an identical seed. The reference scenario ships as Mars Genesis: a 100-colonist Mars settlement running from 2035 to 2083 across six turns.
77

8-
**[Live demo](https://paracosm.agentos.sh/sim)** · **[GitHub](https://github.com/framersai/paracosm)** · **[npm](https://www.npmjs.com/package/paracosm)** · **[API reference](/paracosm)** · **[Case study blog post](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation)**
8+
## Where paracosm sits in the world-model landscape
9+
10+
Paracosm is a structured world model in the sense of [Xing 2025](https://arxiv.org/abs/2507.05169) and the [ACM CSUR 2025 world-model survey](https://dl.acm.org/doi/full/10.1145/3746449), and a counterfactual world simulation model in the sense of [Kirfel et al, Stanford 2025](https://cicl.stanford.edu/papers/kirfel2025when.pdf). It is **not** a generative visual or spatial world model (Sora, Genie 3, World Labs Marble), **not** a JEPA-style predictive-representation model (LeCun's AMI Labs), **not** a multi-agent task orchestration framework (LangGraph, AutoGen, CrewAI, OpenAI Agents SDK), **not** a bottom-up swarm intelligence simulator (MiroFish, OASIS), and **not** a generative-agents library (Stanford Generative Agents, Google DeepMind Concordia). It is a JSON-defined state space + deterministic seeded kernel + LLM-driven events and specialist analyses + HEXACO-personality leaders + universal Zod-validated run artifact spanning turn-loop civilization simulations, batch-trajectory digital twins, and batch-point forecasts.
11+
12+
Full taxonomy mapping lives at [docs/positioning/world-model-mapping.md](https://github.com/framersai/paracosm/blob/master/docs/positioning/world-model-mapping.md).
13+
14+
**[Live demo](https://paracosm.agentos.sh/sim)** · **[GitHub](https://github.com/framersai/paracosm)** · **[npm](https://www.npmjs.com/package/paracosm)** · **[API reference](/paracosm)** · **[Positioning map](https://github.com/framersai/paracosm/blob/master/docs/positioning/world-model-mapping.md)** · **[Case study blog post](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation)**
915

1016
## Quick Start
1117

@@ -121,12 +127,12 @@ Two runs on the same seed produce identical deterministic stages. The LLM stages
121127

122128
Paracosm uses the [HEXACO model](/features/cognitive-memory) (Ashton & Lee, 2007) across all six axes, with both poles producing concrete behavioral cues in the commander's decision-style block and the department analysis prompts:
123129

124-
- **Openness** — high: favor novel, untested approaches; low: trust proven protocols.
125-
- **Conscientiousness** — high: demand evidence and contingency plans; low: move fast, accept ambiguity.
126-
- **Extraversion** — high: lead from the front with public comms; low: work through technical channels.
127-
- **Agreeableness** — high: seek consensus with departments and Earth; low: override consensus when you see a better path.
128-
- **Emotionality** — high: weigh human cost heavily; low: accept casualties for strategic gain.
129-
- **Honesty-Humility** — high: report failures transparently; low: leverage information asymmetries.
130+
- **Openness.** High: favor novel, untested approaches. Low: trust proven protocols.
131+
- **Conscientiousness.** High: demand evidence and contingency plans. Low: move fast, accept ambiguity.
132+
- **Extraversion.** High: lead from the front with public comms. Low: work through technical channels.
133+
- **Agreeableness.** High: seek consensus with departments and Earth. Low: override consensus when you see a better path.
134+
- **Emotionality.** High: weigh human cost heavily. Low: accept casualties for strategic gain.
135+
- **Honesty-Humility.** High: report failures transparently. Low: leverage information asymmetries.
130136

131137
Trait thresholds are 0.7 (high) and 0.3 (low); cues only fire when a trait is meaningfully expressed. Visible in action at [departments.ts:90](https://github.com/framersai/paracosm/blob/master/src/runtime/departments.ts#L90) and [commander-setup.ts:30](https://github.com/framersai/paracosm/blob/master/src/runtime/commander-setup.ts#L30).
132138

@@ -231,9 +237,9 @@ Narrow via `e.type` for per-event intellisense on `e.data`. Validate the envelop
231237

232238
## Related
233239

234-
- [Emergent Capabilities](/features/emergent-capabilities) the forge + judge machinery underlying `forge_tool`
235-
- [HEXACO Personality](/features/cognitive-memory) trait model, mutation system, persona overlays
236-
- [Cognitive Memory Guide](/features/cognitive-memory-guide) the memory pipeline colonists use as chat agents
237-
- [Inside Mars Genesis (blog)](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation) full case study
238-
- [Emergent Tools and HEXACO Leaders (blog)](https://agentos.sh/blog/emergent-tools-hexaco-leaders) two-leader-one-seed comparison
239-
- [Build an AI Civilization in 5 Minutes (blog)](https://agentos.sh/blog/build-ai-civilization-simulation-paracosm) tutorial
240+
- [Emergent Capabilities](/features/emergent-capabilities): the forge + judge machinery underlying `forge_tool`
241+
- [HEXACO Personality](/features/cognitive-memory): trait model, mutation system, persona overlays
242+
- [Cognitive Memory Guide](/features/cognitive-memory-guide): the memory pipeline colonists use as chat agents
243+
- [Inside Mars Genesis (blog)](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation): full case study
244+
- [Emergent Tools and HEXACO Leaders (blog)](https://agentos.sh/blog/emergent-tools-hexaco-leaders): two-leader-one-seed comparison
245+
- [Build an AI Civilization in 5 Minutes (blog)](https://agentos.sh/blog/build-ai-civilization-simulation-paracosm): tutorial

0 commit comments

Comments
 (0)