paracosm 0.0.1 → 0.2.0

package/dist/engine/compiler/index.js

@@ -0,0 +1,270 @@
+/**
+ * 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 { readCache, writeCache } from './cache.js';
+import { generateProgressionHook, parseResponse as parseProgression } from './generate-progression.js';
+import { generateDirectorInstructions } from './generate-director.js';
+import { generateMilestones, parseMilestones } from './generate-milestones.js';
+import { generateFingerprintHook, parseResponse as parseFingerprint } from './generate-fingerprint.js';
+import { generatePoliticsHook, parseResponse as parsePolitics } from './generate-politics.js';
+import { generateReactionContextHook, parseResponse as parseReactions } from './generate-reactions.js';
+import { ingestSeed, ingestFromUrl } from './seed-ingestion.js';
+import { generateDepartmentPromptHook, parseResponse as parsePrompts } from './generate-prompts.js';
+export { ingestSeed, ingestFromUrl } from './seed-ingestion.js';
+/** Build a default generateText function using AgentOS. */
+async function buildDefaultGenerateText(provider, model) {
+    const { generateText } = await import('@framers/agentos');
+    return async (prompt) => {
+        const result = await generateText({ provider, model, prompt });
+        return result.text;
+    };
+}
+/** Hook names in generation order. */
+const HOOK_NAMES = [
+    'progression',
+    'director',
+    'prompts',
+    'milestones',
+    'fingerprint',
+    'politics',
+    'reactions',
+];
+/** Restore a hook from cached source text. Returns the hook assignment or null if parse fails. */
+function restoreHookFromCache(hookName, source) {
+    try {
+        switch (hookName) {
+            case 'progression': {
+                const fn = parseProgression(source);
+                return fn ? { progressionHook: fn } : null;
+            }
+            case 'director': {
+                const cleaned = source.trim();
+                return cleaned.length > 50 ? { directorInstructions: () => cleaned } : null;
+            }
+            case 'prompts': {
+                const fn = parsePrompts(source);
+                return fn ? { departmentPromptHook: fn } : null;
+            }
+            case 'milestones': {
+                const result = parseMilestones(source);
+                if (!result)
+                    return null;
+                const [founding, legacy] = result;
+                return {
+                    getMilestoneEvent: (turn, maxTurns) => {
+                        if (turn === 1)
+                            return founding;
+                        if (turn === maxTurns)
+                            return legacy;
+                        return null;
+                    },
+                };
+            }
+            case 'fingerprint': {
+                const fn = parseFingerprint(source);
+                return fn ? { fingerprintHook: fn } : null;
+            }
+            case 'politics': {
+                const fn = parsePolitics(source);
+                return fn ? { politicsHook: fn } : null;
+            }
+            case 'reactions': {
+                const fn = parseReactions(source);
+                return fn ? { reactionContextHook: fn } : null;
+            }
+            default:
+                return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 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 async function compileScenario(scenarioJson, options = {}) {
+    const { provider = 'anthropic', model = 'claude-sonnet-4-6', cache = true, cacheDir = '.paracosm/cache', onProgress, } = options;
+    const genText = options.generateText ?? await buildDefaultGenerateText(provider, model);
+    const json = scenarioJson;
+    const hooks = {};
+    // Generate each hook, using cache when available
+    for (const hookName of HOOK_NAMES) {
+        // Try to restore from cache first
+        if (cache) {
+            const cached = readCache(json, hookName, model, cacheDir);
+            if (cached !== null) {
+                const restored = restoreHookFromCache(hookName, cached);
+                if (restored) {
+                    onProgress?.(hookName, 'cached');
+                    Object.assign(hooks, restored);
+                    continue;
+                }
+            }
+        }
+        onProgress?.(hookName, 'generating');
+        switch (hookName) {
+            case 'progression': {
+                const result = await generateProgressionHook(json, genText);
+                hooks.progressionHook = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'director': {
+                const result = await generateDirectorInstructions(json, genText);
+                hooks.directorInstructions = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'prompts': {
+                const result = await generateDepartmentPromptHook(json, genText);
+                hooks.departmentPromptHook = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'milestones': {
+                const result = await generateMilestones(json, genText);
+                hooks.getMilestoneEvent = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'fingerprint': {
+                const result = await generateFingerprintHook(json, genText);
+                hooks.fingerprintHook = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'politics': {
+                const result = await generatePoliticsHook(json, genText);
+                hooks.politicsHook = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+            case 'reactions': {
+                const result = await generateReactionContextHook(json, genText);
+                hooks.reactionContextHook = result.hook;
+                if (cache)
+                    writeCache(json, hookName, result.source, model, cacheDir);
+                break;
+            }
+        }
+        onProgress?.(hookName, 'done');
+    }
+    // Seed ingestion: enrich knowledge bundle from document or URL
+    let knowledge = json.knowledge ?? { topics: {}, categoryMapping: {} };
+    if (options.seedUrl) {
+        onProgress?.('seed-ingestion', 'generating');
+        const seedBundle = await ingestFromUrl(options.seedUrl, {
+            generateText: genText,
+            webSearch: options.webSearch ?? true,
+            maxSearches: options.maxSearches ?? 5,
+            onProgress: (step, status) => onProgress?.(`seed-${step}`, status === 'start' ? 'generating' : 'done'),
+        });
+        knowledge = mergeKnowledgeBundles(knowledge, seedBundle);
+        onProgress?.('seed-ingestion', 'done');
+    }
+    else if (options.seedText) {
+        onProgress?.('seed-ingestion', 'generating');
+        const seedBundle = await ingestSeed(options.seedText, {
+            generateText: genText,
+            webSearch: options.webSearch ?? true,
+            maxSearches: options.maxSearches ?? 5,
+            onProgress: (step, status) => onProgress?.(`seed-${step}`, status === 'start' ? 'generating' : 'done'),
+        });
+        knowledge = mergeKnowledgeBundles(knowledge, seedBundle);
+        onProgress?.('seed-ingestion', 'done');
+    }
+    // Build world schema from metrics if not already structured
+    const world = json.world ?? {
+        metrics: {},
+        capacities: {},
+        statuses: {},
+        politics: {},
+        environment: {},
+    };
+    // Build effects array
+    const effects = Array.isArray(json.effects)
+        ? json.effects
+        : json.effects && typeof json.effects === 'object'
+            ? [{ id: 'category_effects', type: 'category_outcome', label: 'Category Outcome Effects', categoryDefaults: json.effects }]
+            : [];
+    // Build UI definition
+    const ui = {
+        ...(json.ui ?? {}),
+        eventRenderers: Object.fromEntries((json.events ?? []).map((e) => [e.id, { icon: e.icon, color: e.color }])),
+    };
+    return {
+        id: json.id ?? 'compiled-scenario',
+        version: json.version ?? '1.0.0',
+        engineArchetype: json.engineArchetype ?? 'closed_turn_based_settlement',
+        labels: json.labels ?? { name: 'Compiled Scenario', shortName: 'compiled', populationNoun: 'members', settlementNoun: 'settlement', currency: 'credits' },
+        theme: json.theme ?? { primaryColor: '#6366f1', accentColor: '#818cf8', cssVariables: {} },
+        setup: json.setup ?? { defaultTurns: 8, defaultSeed: 100, defaultStartYear: 2040, defaultPopulation: 50, configurableSections: ['leaders', 'departments', 'models'] },
+        world,
+        departments: json.departments ?? [],
+        metrics: json.metrics ?? [],
+        events: json.events ?? [],
+        effects,
+        ui,
+        knowledge,
+        policies: json.policies ?? {
+            toolForging: { enabled: true },
+            liveSearch: { enabled: false, mode: 'off' },
+            bulletin: { enabled: true },
+            characterChat: { enabled: true },
+            sandbox: { timeoutMs: 10000, memoryMB: 128 },
+        },
+        presets: json.presets ?? [],
+        hooks,
+    };
+}
+/** Merge two knowledge bundles, combining topics and category mappings. */
+function mergeKnowledgeBundles(base, overlay) {
+    const topics = { ...base.topics };
+    for (const [key, topic] of Object.entries(overlay.topics)) {
+        if (topics[key]) {
+            // Merge citations into existing topic
+            topics[key] = {
+                ...topics[key],
+                canonicalFacts: [...(topics[key].canonicalFacts || []), ...(topic.canonicalFacts || [])],
+                counterpoints: [...(topics[key].counterpoints || []), ...(topic.counterpoints || [])],
+            };
+        }
+        else {
+            topics[key] = topic;
+        }
+    }
+    const categoryMapping = { ...base.categoryMapping };
+    for (const [cat, topicIds] of Object.entries(overlay.categoryMapping)) {
+        categoryMapping[cat] = [...new Set([...(categoryMapping[cat] || []), ...topicIds])];
+    }
+    return { topics, categoryMapping };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/compiler/index.js.map

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

package/dist/engine/compiler/seed-ingestion.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Real-World Seed Ingestion
+ *
+ * Accepts a document (text, markdown, or URL) and uses it to enrich
+ * a scenario's knowledge bundle via:
+ *
+ * 1. LLM extraction: extract entities, facts, and domain knowledge from the seed
+ * 2. Optional web search: use AgentOS WebSearchService (Tavily, Firecrawl, Serper, Brave)
+ *    with Cohere neural reranking to find real citations grounding the seed material
+ * 3. Knowledge bundle assembly: structure extracted + searched knowledge into
+ *    KnowledgeBundle format compatible with the ScenarioPackage
+ *
+ * The web search is emergent: the LLM decides what to search for based on
+ * the seed content, not hardcoded queries.
+ */
+import type { KnowledgeBundle } from '../types.js';
+import type { GenerateTextFn } from './types.js';
+export interface SeedIngestionOptions {
+    /** LLM generateText function */
+    generateText: GenerateTextFn;
+    /** Enable live web search to enrich with real citations. Requires search API keys in env. */
+    webSearch?: boolean;
+    /** Maximum number of web searches to perform. Default: 5. */
+    maxSearches?: number;
+    /** Progress callback */
+    onProgress?: (step: string, status: 'start' | 'done') => void;
+}
+/**
+ * Ingest a seed document and produce a KnowledgeBundle for a scenario.
+ *
+ * @param seedText - The raw text content of the seed document
+ * @param options - Ingestion options (LLM function, web search toggle)
+ * @returns A KnowledgeBundle ready to merge into a ScenarioPackage
+ */
+export declare function ingestSeed(seedText: string, options: SeedIngestionOptions): Promise<KnowledgeBundle>;
+/**
+ * Ingest from a URL by fetching and extracting content.
+ */
+export declare function ingestFromUrl(url: string, options: SeedIngestionOptions): Promise<KnowledgeBundle>;
+//# sourceMappingURL=seed-ingestion.d.ts.map

package/dist/engine/compiler/seed-ingestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-ingestion.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/seed-ingestion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAqC,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CAC/D;AAmLD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA+B1B"}

package/dist/engine/compiler/seed-ingestion.js

@@ -0,0 +1,232 @@
+/**
+ * Real-World Seed Ingestion
+ *
+ * Accepts a document (text, markdown, or URL) and uses it to enrich
+ * a scenario's knowledge bundle via:
+ *
+ * 1. LLM extraction: extract entities, facts, and domain knowledge from the seed
+ * 2. Optional web search: use AgentOS WebSearchService (Tavily, Firecrawl, Serper, Brave)
+ *    with Cohere neural reranking to find real citations grounding the seed material
+ * 3. Knowledge bundle assembly: structure extracted + searched knowledge into
+ *    KnowledgeBundle format compatible with the ScenarioPackage
+ *
+ * The web search is emergent: the LLM decides what to search for based on
+ * the seed content, not hardcoded queries.
+ */
+/**
+ * Extract knowledge structure from seed text via LLM.
+ */
+async function extractFromSeed(seedText, generateText) {
+    const prompt = `You are analyzing a document to extract domain knowledge for a simulation engine.
+
+DOCUMENT:
+${seedText.slice(0, 8000)}
+
+Extract the following as JSON:
+{
+  "topics": ["list of 3-8 domain topics/themes in this document"],
+  "facts": [{"topic": "topic name", "claim": "specific factual claim from the document"}],
+  "searchQueries": ["5 web search queries that would find real scientific/technical citations supporting or expanding on this document's claims"],
+  "crisisCategories": ["3-6 categories of crises or challenges relevant to this domain"]
+}
+
+Focus on extractable, verifiable facts. Search queries should target academic papers, technical reports, and authoritative sources. Return JSON only.`;
+    const text = await generateText(prompt);
+    let cleaned = text.trim().replace(/^```(?:json)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch {
+        return { topics: [], facts: [], searchQueries: [], crisisCategories: [] };
+    }
+}
+/**
+ * Perform web searches using AgentOS WebSearchService.
+ * Returns citations organized by query.
+ */
+async function searchForCitations(queries, maxSearches) {
+    const searchResults = [];
+    try {
+        const { WebSearchService, FirecrawlProvider, TavilyProvider, SerperProvider, BraveProvider } = await import('@framers/agentos/web-search');
+        const service = new WebSearchService();
+        if (process.env.FIRECRAWL_API_KEY)
+            service.registerProvider(new FirecrawlProvider(process.env.FIRECRAWL_API_KEY));
+        if (process.env.TAVILY_API_KEY)
+            service.registerProvider(new TavilyProvider(process.env.TAVILY_API_KEY));
+        if (process.env.SERPER_API_KEY)
+            service.registerProvider(new SerperProvider(process.env.SERPER_API_KEY));
+        if (process.env.BRAVE_API_KEY)
+            service.registerProvider(new BraveProvider(process.env.BRAVE_API_KEY));
+        if (!service.hasProviders()) {
+            console.log('  [seed] No search API keys configured. Skipping web search enrichment.');
+            return [];
+        }
+        const useRerank = !!process.env.COHERE_API_KEY;
+        const queriesToRun = queries.slice(0, maxSearches);
+        for (const query of queriesToRun) {
+            try {
+                const results = await service.search(query, { maxResults: 3, rerank: useRerank });
+                searchResults.push({
+                    query,
+                    results: results.map(r => ({ title: r.title, url: r.url, snippet: r.snippet })),
+                });
+            }
+            catch (err) {
+                console.log(`  [seed] Search failed for "${query}": ${err}`);
+            }
+        }
+    }
+    catch {
+        // AgentOS web-search module not available, try direct Serper fallback
+        const key = process.env.SERPER_API_KEY;
+        if (!key)
+            return [];
+        for (const query of queries.slice(0, maxSearches)) {
+            try {
+                const res = await fetch('https://google.serper.dev/search', {
+                    method: 'POST',
+                    headers: { 'X-API-KEY': key, 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ q: query, num: 3 }),
+                });
+                if (res.ok) {
+                    const data = await res.json();
+                    searchResults.push({
+                        query,
+                        results: (data.organic || []).slice(0, 3).map((r) => ({ title: r.title, url: r.link, snippet: r.snippet })),
+                    });
+                }
+            }
+            catch { }
+        }
+    }
+    return searchResults;
+}
+/**
+ * Assemble extracted facts and search results into a KnowledgeBundle.
+ */
+function assembleKnowledgeBundle(extracted, searchResults) {
+    const topics = {};
+    // Group extracted facts by topic
+    for (const topicName of extracted.topics) {
+        const topicFacts = extracted.facts.filter(f => f.topic === topicName);
+        const citations = topicFacts.map(f => ({
+            claim: f.claim,
+            source: 'Seed document',
+            url: '',
+        }));
+        topics[topicName] = {
+            canonicalFacts: citations,
+            counterpoints: [],
+            departmentNotes: {},
+        };
+    }
+    // Enrich with web search results by matching queries to topics via word overlap
+    for (const sr of searchResults) {
+        const queryWords = new Set(sr.query.toLowerCase().split(/\s+/).filter(w => w.length > 3));
+        let bestTopic = extracted.topics[0] || 'general';
+        let bestOverlap = 0;
+        for (const t of extracted.topics) {
+            const topicWords = t.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+            const overlap = topicWords.filter(w => queryWords.has(w)).length;
+            // Also check if any query word is a substring of the topic or vice versa
+            const substringBonus = topicWords.some(tw => [...queryWords].some(qw => tw.includes(qw) || qw.includes(tw))) ? 1 : 0;
+            const score = overlap + substringBonus;
+            if (score > bestOverlap) {
+                bestOverlap = score;
+                bestTopic = t;
+            }
+        }
+        const matchingTopic = bestTopic;
+        if (!topics[matchingTopic]) {
+            topics[matchingTopic] = { canonicalFacts: [], counterpoints: [], departmentNotes: {} };
+        }
+        for (const result of sr.results) {
+            topics[matchingTopic].canonicalFacts.push({
+                claim: result.snippet,
+                source: result.title,
+                url: result.url,
+            });
+        }
+    }
+    // Build category mapping: associate each crisis category with topics that
+    // share facts or have overlapping terminology
+    const categoryMapping = {};
+    for (const category of extracted.crisisCategories) {
+        // Find topics whose facts mention the crisis category, or whose names overlap
+        const catLower = category.toLowerCase();
+        const relevant = extracted.topics.filter(t => {
+            const tLower = t.toLowerCase();
+            // Direct name overlap
+            if (catLower.includes(tLower) || tLower.includes(catLower))
+                return true;
+            // Topic has facts that mention the category
+            return extracted.facts.some(f => f.topic === t && f.claim.toLowerCase().includes(catLower));
+        });
+        // Fall back to first 2 topics if no specific match
+        categoryMapping[category] = relevant.length > 0 ? relevant : extracted.topics.slice(0, 2);
+    }
+    return { topics, categoryMapping };
+}
+/**
+ * Ingest a seed document and produce a KnowledgeBundle for a scenario.
+ *
+ * @param seedText - The raw text content of the seed document
+ * @param options - Ingestion options (LLM function, web search toggle)
+ * @returns A KnowledgeBundle ready to merge into a ScenarioPackage
+ */
+export async function ingestSeed(seedText, options) {
+    const { generateText, webSearch = true, maxSearches = 5, onProgress } = options;
+    // Step 1: Extract knowledge from seed
+    onProgress?.('extract', 'start');
+    const extracted = await extractFromSeed(seedText, generateText);
+    onProgress?.('extract', 'done');
+    console.log(`  [seed] Extracted ${extracted.topics.length} topics, ${extracted.facts.length} facts, ${extracted.searchQueries.length} search queries`);
+    // Step 2: Optional web search enrichment
+    let searchResults = [];
+    if (webSearch && extracted.searchQueries.length > 0) {
+        onProgress?.('search', 'start');
+        searchResults = await searchForCitations(extracted.searchQueries, maxSearches);
+        onProgress?.('search', 'done');
+        const totalCitations = searchResults.reduce((sum, sr) => sum + sr.results.length, 0);
+        console.log(`  [seed] Web search found ${totalCitations} citations from ${searchResults.length} queries`);
+    }
+    // Step 3: Assemble knowledge bundle
+    onProgress?.('assemble', 'start');
+    const bundle = assembleKnowledgeBundle(extracted, searchResults);
+    onProgress?.('assemble', 'done');
+    return bundle;
+}
+/**
+ * Ingest from a URL by fetching and extracting content.
+ */
+export async function ingestFromUrl(url, options) {
+    let content;
+    // Try Firecrawl first for clean markdown extraction
+    try {
+        const key = process.env.FIRECRAWL_API_KEY;
+        if (key) {
+            const res = await fetch('https://api.firecrawl.dev/v1/scrape', {
+                method: 'POST',
+                headers: { 'Authorization': `Bearer ${key}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ url, formats: ['markdown'] }),
+            });
+            if (res.ok) {
+                const data = await res.json();
+                content = data.data?.markdown || data.data?.content || '';
+                if (content) {
+                    console.log(`  [seed] Fetched ${content.length} chars from ${url} via Firecrawl`);
+                    return ingestSeed(content, options);
+                }
+            }
+        }
+    }
+    catch { }
+    // Fallback to plain fetch
+    const res = await fetch(url);
+    content = await res.text();
+    // Strip HTML tags for plain text extraction
+    content = content.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
+    console.log(`  [seed] Fetched ${content.length} chars from ${url} via plain fetch`);
+    return ingestSeed(content, options);
+}
+//# sourceMappingURL=seed-ingestion.js.map

package/dist/engine/compiler/seed-ingestion.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Shared types for the scenario compiler module.
+ */
+import type { LlmProvider } from '../types.js';
+/** Function signature for LLM text generation calls. */
+export type GenerateTextFn = (prompt: string) => Promise<string>;
+/** Options for compileScenario(). */
+export interface CompileOptions {
+    /** LLM provider to use for hook generation. */
+    provider?: LlmProvider;
+    /** Model name for hook generation. */
+    model?: string;
+    /** Whether to use disk caching. Default: true. */
+    cache?: boolean;
+    /** Base directory for the disk cache. Default: '.paracosm/cache'. */
+    cacheDir?: string;
+    /** Custom generateText function (overrides provider/model). */
+    generateText?: GenerateTextFn;
+    /** Progress callback for each hook being generated. */
+    onProgress?: (hookName: string, status: 'generating' | 'cached' | 'done' | 'fallback') => void;
+    /** Seed text to ingest into the scenario's knowledge bundle via LLM extraction + optional web search. */
+    seedText?: string;
+    /** Seed URL to fetch and ingest. If set, seedText is ignored. */
+    seedUrl?: string;
+    /** Enable live web search during seed ingestion. Requires search API keys. Default: true. */
+    webSearch?: boolean;
+    /** Max web searches during seed ingestion. Default: 5. */
+    maxSearches?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;IAC/F,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/engine/compiler/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the scenario compiler module.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}