paracosm 0.9.1022 → 0.9.1026

package/README.md

@@ -459,7 +459,7 @@ Programmatic surfaces: `paracosm` root (`run`, `runMany`, `WorldModel`, `compile
 
 For non-SSE consumers there's `POST /simulate` (gated on `PARACOSM_ENABLE_SIMULATE_ENDPOINT=true`) and nine read-and-replay routes under `/api/v1/*`. Wire-level details: [`docs/HTTP_API.md`](docs/HTTP_API.md).
 
-Storage: SQLite by default, Postgres / sql.js / IndexedDB via `STORAGE_ADAPTER=` env. Run history (Library) and session blobs (Load menu) share the same schema. Admin write routes (`/admin/sessions/save`, `/admin/data/wipe`) require both `ADMIN_WRITE=true` and an `ADMIN_TOKEN` bearer; off by default.
+Storage: SQLite through `@framers/sql-storage-adapter` (better-sqlite3, or sql.js when the native module cannot load). Run history (Library) lives in `data/runs.db` under `APP_DIR`, the working directory when unset (`PARACOSM_RUN_HISTORY_DB_PATH` moves it), and saved sessions (Load menu) in `data/sessions.db`; `STORAGE_ADAPTER` and `DATABASE_URL` have no effect on either. Admin write routes (`/admin/sessions/save`, `/admin/data/wipe`) require both `ADMIN_WRITE=true` and an `ADMIN_TOKEN` bearer; off by default.
 
 ---
 
@@ -467,28 +467,41 @@ Storage: SQLite by default, Postgres / sql.js / IndexedDB via `STORAGE_ADAPTER=`
 
 ```
 src/
-  engine/         the npm package
-    core/         deterministic kernel: RNG, state, progression, personality drift
-    compiler/     scenario draft + source grounding to ScenarioPackage compiler
-    mars/         Mars Genesis scenario
-    lunar/        Lunar Outpost scenario
-
-  runtime/        orchestration (not exported)
-    orchestrator           turn pipeline: director, kernel, departments, commander
-    director               emergent event generation from simulation state
-    departments            parallel department analysis agents
-    agent-reactions        batched agent reactions, 10 agents per LLM call
-    agent-memory           persistent memory, consolidation, stance drift
-    chat-agents            post-simulation conversational agents
-    schemas/               Zod schemas for every structured LLM call
-    llm-invocations/       generateValidatedObject + sendAndValidate wrappers
-    hexaco-cues/           trajectory and reaction cue translation helpers
-
-  cli/            server + dashboard (not exported)
-    serve.ts      HTTP + SSE server
-    dashboard/    React + Vite live visualization, cellular automata viz
+  index.ts             the package root: run, runMany, WorldModel, compileScenario,
+                       the built-in scenarios, trait models, presets and types
+  api/                 run() and runMany()
+  engine/              scenario contract, compiler and deterministic kernel
+    core/              kernel: seeded RNG, state, snapshots, progression (paracosm/core)
+    compiler/          scenario draft + source grounding to ScenarioPackage (paracosm/compiler)
+    schema/            RunArtifact types and Zod schemas (paracosm/schema)
+    digital-twin/      WorldModel as DigitalTwin (paracosm/digital-twin)
+    scenarios/         loads Mars Genesis and Lunar Outpost from scenarios/*.json
+    data-driven-hooks/ turns a scenario's JSON hooks into runtime hooks
+    physics/           per-agent progression physics a scenario names in its JSON
+    traits/            trait models: HEXACO and the AI-agent model
+    registries/        effects, events and metrics
+    presets/           actor presets
+    provider/          provider key resolution
+
+  runtime/             simulation execution
+    orchestrator/      turn pipeline: event director, departments, commander, reactions
+    agents/            agent reactions, memory and post-run chat
+    world-model/       the WorldModel facade: simulate, replay, fork, intervene, batch
+    swarm/             views over a run's agent swarm (paracosm/swarm)
+    research/          citation and research memory
+    validators/        Zod validators for LLM responses
+    economics/         cost tracking and pricing
+    io/                output writer, artifact assembly, SSE envelopes
+    util/              parsers and shared helpers
+
+  llm/                 validated LLM calls shared by the runtime and the compiler
+  cli/                 the paracosm command
+  server/              the dashboard's HTTP and SSE server
+  dashboard/           the React + Vite dashboard at /sim, and the landing page
 ```
 
+[docs/architecture/INTERNAL_LAYOUT.md](https://github.com/framerslab/paracosm/blob/master/docs/architecture/INTERNAL_LAYOUT.md) describes each folder.
+
 The engine owns the chassis. The scenario owns the domain. The kernel handles state, time, randomness, and invariants. The scenario handles event categories, department instructions, progression hooks, and research citations. The orchestrator connects them.
 
 ---
@@ -518,7 +531,7 @@ Paracosm uses [AgentOS](https://agentos.sh/en) for agent orchestration, LLM disp
 |---|---|---|
 | Where | [paracosm.agentos.sh/sim](https://paracosm.agentos.sh/sim), in the browser, without an account. | Your machine or server: `npm install paracosm` for the SDK and the CLI, `paracosm dashboard` for the same dashboard at `http://localhost:3456`. |
 | Model keys | The host's keys, or your own OpenAI or Anthropic key entered in Settings. | Your own keys, from the environment or a `.env` file. |
-| Limits | Runs on the host's keys are capped in turns, population and departments, and each IP address has a daily run limit. Your own key lifts both. | None in the SDK and `paracosm run`. The dashboard server limits runs on its own keys to `RATE_LIMIT` per IP address per day (1 when unset); `RATE_LIMIT=0` turns the limit off. |
+| Limits | Runs on the host's keys are capped in turns, population and departments, and each IP address has a daily run limit. Your own key lifts both. | No hosted quotas: the SDK and `paracosm run` cap no turns, population, departments or daily runs. The API has its own bounds: `runMany()` and `WorldModel.quickstart()` take 2 to 6 actors and throw outside that range, `run()` runs two and returns the first, and a dashboard run takes 2 to 300 actors (a fork takes 1). The dashboard server limits runs on its own keys to `RATE_LIMIT` per IP address per day (1 when unset); `RATE_LIMIT=0` turns the limit off. |
 | Cost | Free to try. | Free. You pay your model provider for the runs you make. |
 | Support | Community via Discord and GitHub. | Community via Discord and GitHub. |
 

package/assets/landing.css

@@ -780,50 +780,6 @@ a:hover { text-decoration: underline; }
 .feat p { font-size: var(--font-md); color: var(--t2); line-height: 1.7; }
 .feat-ref { font-size: var(--font-2xs); color: var(--t4); margin-top: 10px; font-family: var(--mono); border-top: 1px solid var(--border); padding-top: 8px; }
 
-/* ── Flow Diagram ─────────────────────────────────────────────────────────── */
-
-.flow-wrap { position: relative; margin: 48px 0; padding: 40px 0; }
-
-/* Pin the connector to the vertical center of the icon-ring row.
-   padding-top (40px) + half the ring height (64 / 2 = 32px) = 72px.
-   Was `top: 50%`, which scaled with the tallest node's paragraph and
-   started cutting through the title/description text as soon as the
-   copy got long enough. */
-.flow-line { position: absolute; top: 72px; left: 60px; right: 60px; height: 2px; background: var(--border); z-index: 0; }
-.flow-line-fill { height: 100%; width: 0; background: var(--grad); transition: width 1.5s ease; }
-.flow-line-fill.active { width: 100%; }
-
-.flow { display: flex; justify-content: space-between; position: relative; z-index: 1; }
-
-.flow-node { display: flex; flex-direction: column; align-items: center; text-align: center; width: 22%; position: relative; }
-
-.flow-ring {
-  width: 64px; height: 64px;
-  border-radius: 50%;
-  border: 2px solid var(--border);
-  display: flex; align-items: center; justify-content: center;
-  background: var(--bg);
-  transition: all .5s;
-  margin-bottom: 14px;
-}
-
-.flow-ring svg { width: 28px; height: 28px; opacity: .7; transition: opacity .3s; }
-.flow-ring.active { border-color: var(--amber); }
-.flow-ring.active svg { opacity: 1; }
-
-.flow-num { font-family: var(--mono); font-size: var(--font-2xs); font-weight: 700; color: var(--t4); letter-spacing: 1px; margin-bottom: 4px; }
-.flow-node h3 { font-family: var(--mono); font-size: var(--font-md); font-weight: 700; color: var(--t1); margin-bottom: 4px; }
-.flow-node p { font-size: var(--font-xs); color: var(--t3); line-height: 1.5; max-width: 180px; }
-
-/* ── Divergence Visualization ─────────────────────────────────────────────── */
-
-.diverge { display: flex; gap: 20px; margin-top: 48px; }
-.diverge-side { flex: 1; border-radius: 8px; padding: 24px; border: 1px solid var(--border); background: var(--bg3); transition: all .3s; }
-.diverge-side:hover { border-color: var(--border-hl); }
-.diverge-side h3 { font-family: var(--mono); font-size: var(--font-lg); font-weight: 700; margin-bottom: 8px; }
-.diverge-bar { height: 6px; border-radius: 3px; margin: 6px 0; overflow: hidden; background: var(--border); }
-.diverge-fill { height: 100%; border-radius: 3px; transition: width 1s ease; }
-
 /* ── Scenarios ────────────────────────────────────────────────────────────── */
 
 .scenarios { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; }
@@ -902,14 +858,6 @@ a:hover { text-decoration: underline; }
   width: 100%;
 }
 
-/* ── Pricing ──────────────────────────────────────────────────────────────── */
-
-.pricing-banner { background: var(--bg3); border: 1px solid var(--border); border-radius: 12px; padding: 40px; text-align: center; max-width: 700px; margin: 0 auto; backdrop-filter: blur(12px); }
-.pricing-banner h3 { font-family: var(--mono); font-size: var(--font-2xl); font-weight: 700; color: var(--t1); margin-bottom: 8px; }
-.pricing-banner p { font-size: var(--font-lg); color: var(--t2); line-height: 1.8; margin-bottom: 8px; }
-.pricing-tiers { display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; margin: 20px 0; }
-.pricing-tier { font-family: var(--mono); font-size: var(--font-sm); font-weight: 700; padding: 6px 16px; border-radius: 6px; background: var(--bg4); color: var(--t2); border: 1px solid var(--border); }
-
 /* ── Code Blocks ──────────────────────────────────────────────────────────── */
 
 .code-sec { margin-top: 56px; width: 100%; max-width: 720px; }
@@ -1263,19 +1211,8 @@ html:not(.js) .rv {
    * step instead of staggering across a 20px window (.arch used to
    * collapse at 880, .scenarios at 900 — visible double reflow). */
   .arch { grid-template-columns: 1fr; }
-  .flow { flex-direction: column; align-items: stretch; gap: 28px; }
-  .flow-line { display: none; }
-  /* Desktop keeps each node at width:22% so four fit across the row. On
-     mobile the flex direction flips to column, but without widening the
-     node the 22% cap turns every stacked block into a narrow centered
-     strip with huge empty gutters. Let each node take the full column
-     width and the description paragraph read at a natural line length. */
-  .flow-node { width: 100%; max-width: 520px; margin: 0 auto; }
-  .flow-node p { max-width: none; font-size: var(--font-md); line-height: 1.6; }
-  .diverge { flex-direction: column; }
   .contact-grid { grid-template-columns: 1fr; }
   .hero-chips { gap: 6px; }
-  .pricing-tiers { flex-direction: column; align-items: center; }
 }
 
 
@@ -1317,9 +1254,6 @@ html:not(.js) .rv {
 }
 
 .light .arch-row { background: rgba(248, 242, 228, .7); border-color: var(--border); box-shadow: 0 2px 8px rgba(60, 40, 10, .06); }
-.light .flow-ring { background: var(--bg); border-color: var(--border); }
-.light .diverge-side { background: var(--bg3); border-color: var(--border); }
-.light .pricing-banner { background: var(--bg3); border-color: var(--border); }
 .light .contact-card { background: var(--bg3); border-color: var(--border); }
 .light .faq-item { border-bottom-color: var(--border); }
 
@@ -1355,7 +1289,6 @@ html:not(.js) .rv {
 .light footer { background: var(--bg2); border-top-color: var(--border); }
 .light .banner::before { opacity: .15; }
 .light .pc-badge { background: var(--bg4); color: var(--amber); border-color: var(--border); }
-.light .pricing-tier { background: var(--bg); color: var(--t2); border-color: var(--border); }
 .light .theme-toggle { color: var(--t3); border-color: var(--border); }
 .light .theme-toggle:hover { color: var(--t1); border-color: var(--border-hl); }