paracosm 0.0.1 → 0.2.0

package/dist/engine/compiler/generate-milestones.js.map

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

package/dist/engine/compiler/generate-politics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a politics hook from scenario JSON via LLM.
+ * The politics hook returns delta values for political/social crisis outcomes.
+ */
+import type { GenerateTextFn } from './types.js';
+export declare function parseResponse(text: string): ((category: string, outcome: string) => Record<string, number> | null) | null;
+export declare function generatePoliticsHook(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (category: string, outcome: string) => Record<string, number> | null;
+    source: string;
+}>;
+//# sourceMappingURL=generate-politics.d.ts.map

package/dist/engine/compiler/generate-politics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-politics.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-politics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsCjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAYzH;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCzG"}

package/dist/engine/compiler/generate-politics.js

@@ -0,0 +1,85 @@
+/**
+ * Generate a politics hook from scenario JSON via LLM.
+ * The politics hook returns delta values for political/social crisis outcomes.
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const effects = scenarioJson.effects ?? {};
+    const categories = typeof effects === 'object' && !Array.isArray(effects)
+        ? Object.keys(effects)
+        : [];
+    return `You are generating a politics hook for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'} — ${labels.settlementNoun ?? 'settlement'} simulation
+CRISIS CATEGORIES: ${categories.join(', ')}
+
+Generate a TypeScript arrow function that returns politics deltas for political/social crisis outcomes.
+
+The function receives:
+- category: string (one of the crisis categories above)
+- outcome: string (contains "success" or "failure")
+
+Return:
+- null if the category is not political/social in nature
+- A Record<string, number> of politics field deltas for political/social categories
+
+For success outcomes, the deltas should push toward independence/autonomy.
+For failure outcomes, the deltas should push toward dependency/instability.
+
+Pick 1-3 politics field names appropriate to this scenario's domain.
+
+Rules:
+1. Return null for non-political categories
+2. Return a plain object with numeric deltas for political categories
+3. Do NOT use external imports
+4. Keep delta values small (e.g., 0.01-0.10 for percentages, 1-5 for integers)
+
+Return ONLY the arrow function, no markdown fences, no explanation.`;
+}
+export function parseResponse(text) {
+    let cleaned = text.trim();
+    cleaned = cleaned.replace(/^```(?:typescript|ts)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    if (cleaned.endsWith(';'))
+        cleaned = cleaned.slice(0, -1).trim();
+    try {
+        const fn = new Function('return ' + cleaned)();
+        if (typeof fn === 'function')
+            return fn;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function generatePoliticsHook(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const fn = parseResponse(text);
+        if (!fn) {
+            lastError = 'Could not parse response into a function';
+            continue;
+        }
+        // Smoke test
+        try {
+            const nonPolitical = fn('environmental', 'risky_success');
+            const political = fn('political', 'risky_success');
+            if (political !== null && typeof political !== 'object') {
+                lastError = 'Political result must be null or object';
+                continue;
+            }
+            return { hook: fn, source: text.trim() };
+        }
+        catch (err) {
+            lastError = String(err);
+        }
+    }
+    // Fallback: no-op
+    console.warn('[compiler] Politics hook generation failed. Using no-op.');
+    return {
+        hook: () => null,
+        source: '// No-op: generation failed',
+    };
+}
+//# sourceMappingURL=generate-politics.js.map

package/dist/engine/compiler/generate-politics.js.map

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

package/dist/engine/compiler/generate-progression.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generate a progression hook from scenario JSON via LLM.
+ * The progression hook applies between-turn health/status changes
+ * based on the scenario's environment and domain.
+ */
+import type { ProgressionHookContext } from '../types.js';
+import type { GenerateTextFn } from './types.js';
+/** Parse the LLM response into an executable function. */
+export declare function parseResponse(text: string): ((ctx: ProgressionHookContext) => void) | null;
+/** Generate a progression hook via LLM, with retries on validation failure. */
+export declare function generateProgressionHook(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (ctx: ProgressionHookContext) => void;
+    source: string;
+}>;
+//# sourceMappingURL=generate-progression.d.ts.map

package/dist/engine/compiler/generate-progression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-progression.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-progression.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqCjD,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,IAAI,CAqB1F;AAED,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC1E"}

package/dist/engine/compiler/generate-progression.js

@@ -0,0 +1,104 @@
+/**
+ * Generate a progression hook from scenario JSON via LLM.
+ * The progression hook applies between-turn health/status changes
+ * based on the scenario's environment and domain.
+ */
+/** Build the prompt for generating a progression hook. */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const env = scenarioJson.world?.environment ?? {};
+    const depts = (scenarioJson.departments ?? []).map((d) => d.id).join(', ');
+    return `You are generating a between-turn progression hook for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'} — ${labels.settlementNoun ?? 'settlement'} simulation
+POPULATION NOUN: ${labels.populationNoun ?? 'members'}
+SETTLEMENT: ${labels.settlementNoun ?? 'settlement'}
+ENVIRONMENT VARIABLES: ${JSON.stringify(env, null, 2)}
+DEPARTMENTS: ${depts}
+
+Generate a TypeScript function body for a progression hook. The function receives a context object with these fields:
+- ctx.agents: array of agent objects with { core: { marsborn: boolean, birthYear: number, name: string }, health: { alive: boolean, boneDensityPct: number, cumulativeRadiationMsv: number, psychScore: number } }
+- ctx.yearDelta: number of simulated years since last turn
+- ctx.year: current simulated year
+- ctx.turn: current turn number
+- ctx.startYear: simulation start year
+- ctx.rng: { chance(p: number): boolean, next(): number, pick<T>(arr: T[]): T, int(min: number, max: number): number }
+
+Rules:
+1. Only modify health fields on ALIVE agents (check c.health.alive first, iterate ctx.agents)
+2. Use environment-appropriate health degradation for this scenario's domain
+3. Multiply time-scaled effects by ctx.yearDelta
+4. Use Math.max/Math.min to keep values bounded (boneDensityPct: 0-100, psychScore: 0-1, cumulativeRadiationMsv: >= 0)
+5. Do NOT use external imports, do NOT use require()
+6. The function signature is: (ctx: ProgressionHookContext) => void
+7. Use ctx.rng.chance(p) for probabilistic effects instead of Math.random()
+
+Return ONLY the complete function as a TypeScript arrow function, no explanation, no markdown fences. Example format:
+(ctx) => { for (const c of ctx.agents) { if (!c.health.alive) continue; /* effects */ } }`;
+}
+/** Parse the LLM response into an executable function. */
+export function parseResponse(text) {
+    let cleaned = text.trim();
+    // Strip markdown fences if present
+    cleaned = cleaned.replace(/^```(?:typescript|ts)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    // Strip trailing semicolons
+    if (cleaned.endsWith(';'))
+        cleaned = cleaned.slice(0, -1).trim();
+    try {
+        // Wrap in a function constructor
+        const fn = new Function('return ' + cleaned)();
+        if (typeof fn === 'function')
+            return fn;
+        return null;
+    }
+    catch {
+        // Try wrapping as function body if it's just statements
+        try {
+            const fn = new Function('ctx', cleaned);
+            return (ctx) => fn(ctx);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/** Generate a progression hook via LLM, with retries on validation failure. */
+export async function generateProgressionHook(scenarioJson, generateText, maxRetries = 3) {
+    const prompt = buildPrompt(scenarioJson);
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(prompt + retryHint);
+        const fn = parseResponse(text);
+        if (!fn) {
+            lastError = 'Could not parse response into a function';
+            continue;
+        }
+        // Quick smoke test
+        try {
+            const testColonists = [
+                { core: { marsborn: false, birthYear: 2010, name: 'Test' }, health: { alive: true, boneDensityPct: 95, cumulativeRadiationMsv: 100, psychScore: 0.7 }, career: {}, social: {}, narrative: {}, hexaco: {} },
+                { core: { marsborn: false, birthYear: 2010, name: 'Dead' }, health: { alive: false, boneDensityPct: 80, cumulativeRadiationMsv: 50, psychScore: 0.5 }, career: {}, social: {}, narrative: {}, hexaco: {} },
+            ];
+            fn({
+                agents: testColonists,
+                yearDelta: 4,
+                year: 2045,
+                turn: 3,
+                startYear: 2035,
+                rng: { chance: () => false, next: () => 0.5, pick: (arr) => arr[0], int: (min, max) => min },
+            });
+            return { hook: fn, source: text.trim() };
+        }
+        catch (err) {
+            lastError = String(err);
+        }
+    }
+    // Fallback: no-op hook
+    console.warn(`[compiler] Progression hook generation failed after ${maxRetries} retries. Using no-op.`);
+    return {
+        hook: () => { },
+        source: '// No-op: generation failed',
+    };
+}
+//# sourceMappingURL=generate-progression.js.map

package/dist/engine/compiler/generate-progression.js.map

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

package/dist/engine/compiler/generate-prompts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a department prompt hook from scenario JSON via LLM.
+ * The department prompt hook builds context lines for each department agent.
+ */
+import type { GenerateTextFn } from './types.js';
+export declare function parseResponse(text: string): ((ctx: any) => string[]) | null;
+export declare function generateDepartmentPromptHook(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (ctx: any) => string[];
+    source: string;
+}>;
+//# sourceMappingURL=generate-prompts.d.ts.map

package/dist/engine/compiler/generate-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-prompts.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiCjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,EAAE,CAAC,GAAG,IAAI,CAY3E;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C3D"}

package/dist/engine/compiler/generate-prompts.js

@@ -0,0 +1,90 @@
+/**
+ * Generate a department prompt hook from scenario JSON via LLM.
+ * The department prompt hook builds context lines for each department agent.
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const depts = (scenarioJson.departments ?? []).map((d) => `- ${d.id}: ${d.label} (${d.role}) — ${d.instructions}`).join('\n');
+    return `You are generating a department prompt hook for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'} — ${labels.settlementNoun ?? 'settlement'} simulation
+DEPARTMENTS:
+${depts}
+
+Generate a TypeScript arrow function that returns an array of context lines for a specific department. The function receives a context object:
+- ctx.department: string (department ID, one of the above)
+- ctx.state: { agents: array, colony: Record<string, number>, politics: Record<string, any>, metadata: { currentYear: number } }
+- ctx.scenario: any (scenario data)
+- ctx.researchPacket: { canonicalFacts: array, counterpoints: array, departmentNotes: Record<string, string> }
+
+For each department, compute and return 2-4 lines of scenario-relevant statistics from ctx.state. Each line should be a section header followed by numbers/stats.
+
+Example output: ['HEALTH:', 'Avg radiation: 150 mSv | Avg bone: 85% | Population: 80']
+
+Rules:
+1. Use a switch statement on ctx.department with a case for each department ID
+2. Access ctx.state.agents (filter alive ones), ctx.state.colony (numeric metrics), ctx.state.politics
+3. Compute averages, counts, and status summaries relevant to each department
+4. Return string[] (array of context lines)
+5. Return an empty array for unknown departments
+6. Do NOT use external imports
+
+Return ONLY the arrow function, no markdown fences, no explanation.`;
+}
+export function parseResponse(text) {
+    let cleaned = text.trim();
+    cleaned = cleaned.replace(/^```(?:typescript|ts)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    if (cleaned.endsWith(';'))
+        cleaned = cleaned.slice(0, -1).trim();
+    try {
+        const fn = new Function('return ' + cleaned)();
+        if (typeof fn === 'function')
+            return fn;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function generateDepartmentPromptHook(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const fn = parseResponse(text);
+        if (!fn) {
+            lastError = 'Could not parse response into a function';
+            continue;
+        }
+        // Smoke test
+        try {
+            const deptId = (scenarioJson.departments ?? [])[0]?.id ?? 'engineering';
+            const result = fn({
+                department: deptId,
+                state: {
+                    agents: [{ core: { name: 'Test' }, health: { alive: true, boneDensityPct: 90, cumulativeRadiationMsv: 100, psychScore: 0.7 } }],
+                    colony: { morale: 0.6, population: 80, foodMonthsReserve: 6, powerKw: 300, infrastructureModules: 10, scienceOutput: 5, lifeSupportCapacity: 100 },
+                    politics: { earthDependencyPct: 50, governanceStatus: 'colonial' },
+                    metadata: { currentYear: 2045 },
+                },
+                scenario: scenarioJson,
+                researchPacket: { canonicalFacts: [], counterpoints: [], departmentNotes: {} },
+            });
+            if (!Array.isArray(result)) {
+                lastError = 'Must return an array of strings';
+                continue;
+            }
+            return { hook: fn, source: text.trim() };
+        }
+        catch (err) {
+            lastError = String(err);
+        }
+    }
+    // Fallback: empty lines
+    console.warn('[compiler] Department prompt hook generation failed. Using fallback.');
+    return {
+        hook: (ctx) => [`[${ctx.department}] No scenario-specific context available.`],
+        source: '// Fallback department prompts',
+    };
+}
+//# sourceMappingURL=generate-prompts.js.map

package/dist/engine/compiler/generate-prompts.js.map

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

package/dist/engine/compiler/generate-reactions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a reaction context hook from scenario JSON via LLM.
+ * The reaction context hook returns location/identity/health phrasing
+ * for individual colonist reaction prompts.
+ */
+import type { GenerateTextFn } from './types.js';
+export declare function parseResponse(text: string): ((colonist: any, ctx: any) => string) | null;
+export declare function generateReactionContextHook(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (colonist: any, ctx: any) => string;
+    source: string;
+}>;
+//# sourceMappingURL=generate-reactions.d.ts.map

package/dist/engine/compiler/generate-reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-reactions.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-reactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,CAYxF;AAED,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CxE"}

package/dist/engine/compiler/generate-reactions.js

@@ -0,0 +1,90 @@
+/**
+ * Generate a reaction context hook from scenario JSON via LLM.
+ * The reaction context hook returns location/identity/health phrasing
+ * for individual colonist reaction prompts.
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    return `You are generating a reaction context hook for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'} — ${labels.settlementNoun ?? 'settlement'} simulation
+POPULATION NOUN: ${labels.populationNoun ?? 'members'}
+START YEAR: ${scenarioJson.setup?.defaultStartYear ?? 2035}
+
+Generate a TypeScript arrow function that returns a 1-3 sentence string providing location/identity context for a ${labels.populationNoun ?? 'member'} reaction prompt.
+
+The function receives:
+- colonist: { core: { marsborn: boolean, birthYear: number, name: string }, health: { alive: boolean, boneDensityPct: number, cumulativeRadiationMsv: number, psychScore: number } }
+- ctx: { year: number, turn: number }
+
+Return a string with:
+1. Identity phrasing (born at the ${labels.settlementNoun ?? 'settlement'} vs arrived from elsewhere)
+2. Health context if relevant (low bone density, high radiation, low psych score)
+3. Scenario-appropriate language
+
+Rules:
+1. Return a string, not an object
+2. Keep it to 1-3 short sentences
+3. Reference scenario-specific health concerns
+4. Do NOT use external imports
+
+Return ONLY the arrow function, no markdown fences, no explanation.`;
+}
+export function parseResponse(text) {
+    let cleaned = text.trim();
+    cleaned = cleaned.replace(/^```(?:typescript|ts)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    if (cleaned.endsWith(';'))
+        cleaned = cleaned.slice(0, -1).trim();
+    try {
+        const fn = new Function('return ' + cleaned)();
+        if (typeof fn === 'function')
+            return fn;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function generateReactionContextHook(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const fn = parseResponse(text);
+        if (!fn) {
+            lastError = 'Could not parse response into a function';
+            continue;
+        }
+        // Smoke test
+        try {
+            const result = fn({ core: { marsborn: false, birthYear: 2010, name: 'Test' }, health: { alive: true, boneDensityPct: 80, cumulativeRadiationMsv: 200, psychScore: 0.6 } }, { year: 2045, turn: 3 });
+            if (typeof result !== 'string') {
+                lastError = 'Must return a string';
+                continue;
+            }
+            return { hook: fn, source: text.trim() };
+        }
+        catch (err) {
+            lastError = String(err);
+        }
+    }
+    // Fallback: generic reaction context
+    const labels = scenarioJson.labels ?? {};
+    console.warn('[compiler] Reaction context hook generation failed. Using fallback.');
+    return {
+        hook: (colonist, ctx) => {
+            const lines = [];
+            if (colonist.core?.marsborn) {
+                lines.push(`Born at the ${labels.settlementNoun ?? 'settlement'}.`);
+            }
+            else {
+                lines.push(`Arrived ${ctx.year - (scenarioJson.setup?.defaultStartYear ?? 2035)} years ago.`);
+            }
+            if (colonist.health?.psychScore < 0.4)
+                lines.push('Struggling with low morale.');
+            return lines.join(' ');
+        },
+        source: '// Fallback reaction context',
+    };
+}
+//# sourceMappingURL=generate-reactions.js.map

package/dist/engine/compiler/generate-reactions.js.map

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

package/dist/engine/compiler/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Paracosm Scenario Compiler
+ *
+ * Takes a raw scenario JSON (the data portion of a ScenarioPackage) and generates
+ * all runtime hooks via LLM calls. Returns a complete ScenarioPackage ready to
+ * pass to runSimulation().
+ *
+ * @example
+ * ```typescript
+ * import { compileScenario } from 'paracosm/compiler';
+ * import { runSimulation } from 'paracosm/runtime';
+ *
+ * const scenario = await compileScenario(submarineJson, {
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-6',
+ * });
+ *
+ * const output = await runSimulation(leader, personnel, { scenario, maxTurns: 8 });
+ * ```
+ */
+import type { ScenarioPackage } from '../types.js';
+import type { CompileOptions, GenerateTextFn } from './types.js';
+export type { CompileOptions, GenerateTextFn };
+export { ingestSeed, ingestFromUrl } from './seed-ingestion.js';
+export type { SeedIngestionOptions } from './seed-ingestion.js';
+/**
+ * Compile a scenario JSON into a complete ScenarioPackage with generated hooks.
+ *
+ * @param scenarioJson - The data portion of a scenario (labels, departments, metrics, effects, etc.)
+ * @param options - Compiler options (provider, model, cache settings)
+ * @returns A complete ScenarioPackage ready for runSimulation()
+ */
+export declare function compileScenario(scenarioJson: Record<string, unknown>, options?: CompileOptions): Promise<ScenarioPackage>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/compiler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYjE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAsEhE;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAsJ1B"}