deepclause-sdk 0.0.60 → 0.0.62

package/README.md

@@ -1,8 +1,9 @@
-# DeepClause CLI and SDK
+# DeepClause TUI Agent, CLI and SDK
 
-Compile markdown specs into executable logic programs. Guaranteed execution semantics for agentic workflows.
+Compile markdown specs into executable logic programs. Guaranteed execution semantics for agentic workflows. Comes with a minimal coding agent incl. a nostalgic Borland-style TUI.
 
 ![docs/overview.png](docs/overview.png)
+![docs/tui.png](docs/tui.png)
 
 
 ## What This Is
@@ -16,6 +17,283 @@ DeepClause takes a different approach: **compile task descriptions into DML prog
 Markdown description  →  compile  →  Logic program  →  run  →  Output
 ```
 
+## Install and Run
+
+DeepClause requires Node.js 18+.
+
+### Global install
+
+```bash
+npm install -g deepclause-sdk
+
+# Pick one provider and export its API key
+export OPENAI_API_KEY="sk-..."
+# or: export ANTHROPIC_API_KEY="..."
+# or: export GOOGLE_GENERATIVE_AI_API_KEY="..."
+# or: export OPENROUTER_API_KEY="..."
+
+# Initialize the current workspace
+deepclause init --model openai:gpt-4o
+
+# Inspect the configured slots
+deepclause show-model
+
+# Start the fullscreen conductor TUI
+deepclause
+
+# Or run one headless conductor turn
+deepclause -p "Summarize the repository architecture"
+```
+
+### One-off usage with npx
+
+```bash
+npx deepclause-sdk@latest init --model openai:gpt-4o
+npx deepclause-sdk@latest show-model
+npx deepclause-sdk@latest
+```
+
+All commands except `init`, `help`, `--help`, `--version`, and `-V` expect a `.deepclause/` directory in the current workspace.
+
+`deepclause init` creates:
+
+- `.deepclause/config.json`
+- `.deepclause/tools/`
+- `.deepclause/system/`
+- `.deepclause/.gitignore`
+- seeded local skills: `deep-research` and `research-search-reader`
+- editable system overrides:
+    - `conductor.dml`
+    - `skill-creator.dml`
+    - `CONDUCTOR_PROMPT.md`
+    - `DML_COMPILER_PROMPT.md`
+
+## TUI Agent
+
+Running `deepclause` with no subcommand starts the fullscreen TUI.
+
+- Session list on the left
+- Messages in the center
+- Execution log and context summary on the right
+- Slash commands such as `/new`, `/sessions`, `/set-model <model> [--slot <slot>]`, `/compile <spec>`, `/skill-creator <spec>`, `/cancel`, and `/<skill> [args]`
+- Direct shell commands with `!<command>`, streamed live in the execution pane and cancelled with `/cancel`
+
+For non-interactive use, `deepclause -p "..."` runs a single headless conductor turn with a fresh session.
+
+### Basic Structure
+
+The TUI is the interface around a single built-in agent: the conductor.
+
+- The TUI itself is just the UI shell: session browser, messages pane, execution log, and context view.
+- The conductor is the actual agent that receives your prompt each turn and decides what to do.
+- The conductor is implemented as a system DML skill plus a system prompt.
+- The conductor can answer directly, call an existing local skill, invoke the skill creator to make a new skill, use shell tools, or do web research.
+
+Conceptually, a TUI turn works like this:
+
+1. Load the current session from `.deepclause/sessions/<session-id>/`.
+2. Build the conductor prompt from the resolved conductor prompt template, the current skill catalog, assistant memory, task memory, and session transcript.
+3. Run the conductor DML with the `gateway` model slot.
+4. Stream the conductor's own activity and any child-skill events into the execution log on the right.
+5. Persist the final user/assistant messages and updated usage counters back into the session directory.
+
+The conductor is the router and orchestrator for the CLI runtime. Normal compiled skills are the workers it delegates to. When the conductor launches a normal skill, that skill runs with the `run` model slot. When it launches the skill creator, that child run uses the `compile` model slot instead.
+
+### Memory Tools
+
+The memory tools are there so the conductor can keep durable technical notes across turns instead of re-deriving everything from scratch every time.
+
+- `messages.jsonl` is the conversation transcript. This is the raw history of user and assistant messages.
+- `assistant-memory.md` is long-lived assistant context that gets injected into the conductor prompt each turn.
+- `task-memory.md` is technical working memory: commands that worked, failure modes, local architecture notes, repair strategies, and other distilled learnings.
+
+In the conductor DML, the LLM-facing tool is `save_memory`. That tool does not write arbitrary files directly. Instead, it calls the runtime tool `update_memory`, which replaces `task-memory.md` with the complete updated memory contents.
+
+That distinction matters:
+
+- use the transcript for exact conversation history
+- use task memory for compressed technical learnings that should help future turns
+- use assistant memory for stable higher-level context, tone, or persistent instructions
+
+In the current CLI runtime, task memory is the main writable memory channel exposed to the conductor. Assistant memory is loaded and shown in the TUI, but it is not automatically updated by a built-in conductor tool in the same way.
+
+### Session and Memory Files
+
+Each TUI session lives under `.deepclause/sessions/<session-id>/`:
+
+```text
+.deepclause/
+    sessions/
+        <session-id>/
+            session.json
+            messages.jsonl
+            assistant-memory.md
+            task-memory.md
+            usage.json
+            specs/
+```
+
+- `session.json` stores the session title and timestamps.
+- `messages.jsonl` is the append-only user/assistant transcript that gets replayed into future conductor turns.
+- `assistant-memory.md` is loaded into the conductor prompt as stable assistant context.
+- `task-memory.md` is loaded into the conductor prompt as technical working memory.
+- `usage.json` stores token usage summaries by model.
+- `specs/` is used when the conductor invokes the skill creator and saves generated spec drafts for that session.
+
+In the CLI runtime today, task memory is the actively updated memory channel: the conductor can call `save_memory`, which persists through `update_memory` into `task-memory.md`. `assistant-memory.md` is still loaded every turn, but it is primarily something you inspect or edit manually unless you build additional tooling around it.
+
+### Hacking the Conductor and Skill Creator
+
+There are two levels of customization.
+
+#### 1. Workspace-local system overrides
+
+If you want to customize behavior for one workspace without modifying the package, place override files here:
+
+- `.deepclause/system/conductor.dml`
+- `.deepclause/system/skill-creator.dml`
+- `.deepclause/system/CONDUCTOR_PROMPT.md`
+- `.deepclause/system/DML_COMPILER_PROMPT.md`
+
+When present, the CLI runtime prefers those files over the packaged system DML and system prompt markdown.
+
+#### 2. Source-level hacking in this repository
+
+If you are developing DeepClause itself, these are the main files to edit:
+
+- `src/system/assets/skills/conductor.dml` - the conductor's DML logic
+- `src/system/assets/skills/skill-creator.dml` - the skill creator's DML logic
+- `src/system/assets/docs/CONDUCTOR_PROMPT.md` - the conductor system prompt template
+- `src/system/assets/docs/DML_COMPILER_PROMPT.md` - the skill creator/compiler system prompt template
+- `src/system/runtime/conductor.ts` - session loading, memory injection, tool registration, child-skill routing
+- `src/system/runtime/skill-creator.ts` - compile-slot execution, skill-creator tool registration, validation/testing/deploy flow
+
+Notes:
+
+- The conductor uses the `gateway` model slot.
+- Normal compiled skills use the `run` model slot.
+- The skill creator uses the `compile` model slot.
+- The TUI context pane shows the resolved source paths for the conductor DML/prompt and skill creator DML/prompt.
+- Changes to those `.deepclause/system/` files are picked up on the next conductor turn or skill-creator run; a dedicated TUI reload is not required.
+
+After source-level changes, rebuild the package:
+
+```bash
+npm install
+npm run build
+```
+
+If you want to run the CLI from a source checkout while hacking on it:
+
+```bash
+npm install
+npm run build
+npm run cli -- init
+npm run cli --
+```
+
+## Model and Provider Configuration
+
+DeepClause separates model choice into three slots:
+
+- `gateway` - conductor and orchestration turns
+- `run` - compiled skill execution
+- `compile` - skill compilation and `_skill-creator`
+
+The canonical model id format is `provider:model`, but the CLI also accepts `provider/model` and, for common built-ins, bare model names that it can infer.
+
+Example `.deepclause/config.json`:
+
+```json
+{
+    "models": {
+        "gateway": "openai:gpt-4o",
+        "run": "openrouter:google/gemini-2.5-flash",
+        "compile": "anthropic:claude-sonnet-4-20250514"
+    },
+    "temperatures": {
+        "gateway": 0.7,
+        "run": 0.7,
+        "compile": 0.4
+    },
+    "providers": {
+        "openai": {
+            "apiKey": "${OPENAI_API_KEY}"
+        },
+        "anthropic": {
+            "apiKey": "${ANTHROPIC_API_KEY}"
+        },
+        "google": {
+            "apiKey": "${GOOGLE_GENERATIVE_AI_API_KEY}"
+        },
+        "openrouter": {
+            "apiKey": "${OPENROUTER_API_KEY}",
+            "baseUrl": "https://openrouter.ai/api/v1"
+        }
+    },
+    "agentvm": {
+        "network": false
+    },
+    "workspace": "./workspace",
+    "dmlBase": ".deepclause/tools"
+}
+```
+
+Configuration values support `${ENV_VAR}` and `$ENV_VAR` interpolation.
+
+### Setting Models from the CLI
+
+```bash
+# Update all three slots
+deepclause set-model openai:gpt-4o
+
+# Only change the compile slot
+deepclause set-model anthropic:claude-sonnet-4-20250514 --slot compile
+
+# Use OpenRouter for the conductor only
+deepclause set-model openrouter:google/gemini-2.5-flash --slot gateway
+
+# Inspect the resolved slot values
+deepclause show-model
+```
+
+### Provider Notes
+
+| Provider | Canonical example | API key env var | Notes |
+|----------|-------------------|-----------------|-------|
+| OpenAI | `openai:gpt-4o` | `OPENAI_API_KEY` | You can also set `providers.openai.baseUrl` for an OpenAI-compatible endpoint. |
+| Anthropic | `anthropic:claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` | Native Anthropic adapter. |
+| Google | `google:gemini-2.5-flash` | `GOOGLE_GENERATIVE_AI_API_KEY` | Native Google Generative AI adapter. |
+| OpenRouter | `openrouter:anthropic/claude-sonnet-4` | `OPENROUTER_API_KEY` | Use any OpenRouter model path. |
+| Custom | `custom:local:qwen3-32b` | `LLM_PROVIDER_LOCAL_API_KEY` | Uses the OpenAI-compatible transport with a custom base URL. |
+
+### Custom Provider
+
+`custom:` is for OpenAI-compatible endpoints that you want to name explicitly instead of pretending they are one of the built-in providers.
+
+Format:
+
+```text
+custom:<provider-name>:<model-name>
+```
+
+Example:
+
+```bash
+export LLM_PROVIDER_LOCAL_BASE_URL="http://localhost:11434/v1"
+export LLM_PROVIDER_LOCAL_API_KEY="dummy"
+
+deepclause set-model custom:local:qwen3-32b --slot run
+deepclause show-model
+```
+
+Notes:
+
+- `custom:local:qwen3-32b` reads `LLM_PROVIDER_LOCAL_BASE_URL` and `LLM_PROVIDER_LOCAL_API_KEY`.
+- The provider name is uppercased and normalized when constructing env vars, so `custom:my-lab:model-x` becomes `LLM_PROVIDER_MY_LAB_BASE_URL` and `LLM_PROVIDER_MY_LAB_API_KEY`.
+- `custom:` providers are not configured under the `providers` object in `config.json`; they are resolved from env vars.
+- Internally, `custom:` uses the OpenAI-compatible transport, so your endpoint must speak an OpenAI-style chat/completions API.
+
 ## Runtime Model
 
 DeepClause executes DML in a local CLI runtime:
@@ -88,24 +366,9 @@ agent_main(SpecUrl) :-
 
 Unlike traditional SDD where specs guide but don't control, DeepClause specs **become** the executable. The spec *is* the code—just at a higher abstraction level.
 
-## Quick Start
+## Compile and Run a Skill
 
 ```bash
-# Install
-npm install -g deepclause-sdk
-
-# Set API key (or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.)
-export OPENAI_API_KEY="sk-..."
-
-# Initialize in your project
-deepclause init
-
-# Configure all model slots
-deepclause set-model openai:gpt-4o
-
-# Start the interactive conductor TUI
-deepclause
-
 # Create a task description
 cat > .deepclause/tools/explain.md << 'EOF'
 # Code Explainer
@@ -127,20 +390,21 @@ deepclause compile .deepclause/tools/explain.md
 # Run it
 deepclause run .deepclause/tools/explain.dml "function fib(n) { return n < 2 ? n : fib(n-1) + fib(n-2) }"
 
-# Or run the conductor headlessly for a single prompt
-deepclause -p "Summarize the repository architecture"
+# Or trigger skill creation directly from the TUI with:
+#   /compile <spec>
+#   /skill-creator <spec>
+# Or update the configured model selection from the TUI with:
+#   /set-model openai:gpt-4.1 --slot run
+# Or run a direct workspace shell command with:
+#   !npm test
 ```
 
-## CLI Modes
+Compilation now runs two security-oriented checks on the generated DML:
 
-`deepclause` with no subcommand starts the fullscreen conductor TUI.
+- Prolog static analysis for taint flow, dangerous tool usage, and capability extraction
+- An LLM security audit that reviews the generated DML and returns a short Markdown report
 
-- Session list on the left
-- Messages in the center
-- Execution log and context summary on the right
-- Slash commands such as `/new`, `/sessions`, `/cancel`, and `/<skill> [args]`
-
-For non-interactive use, `deepclause -p "..."` runs a single headless conductor turn with a fresh session.
+The LLM audit runs by default for `deepclause compile`, `deepclause compile-all`, and one-shot `deepclause run -p ...`. Use `--no-audit` if you want to skip only the LLM review. Static analysis still runs either way.
 
 ## Use Cases
 
@@ -245,22 +509,22 @@ Analyze a CSV file and describe its contents.
 
 ## Available Tools
 
-Skills can use these built-in tools:
+Common built-in runtime tools:
 
 | Tool | Description |
 |------|-------------|
-| `web_search` | Search the web (requires `BRAVE_API_KEY`) |
+| `web_search` | Search the web using Brave Search (requires `BRAVE_API_KEY`) |
 | `news_search` | Search recent news |
 | `url_fetch` | Fetch a URL or save it into the workspace |
 | `bash` | Run shell commands in the active workspace shell |
 | `vm_exec` | Alias of `bash`; with `--sandbox`, runs in AgentVM |
-| `ask_user` | Prompt the user for input |
 
-Additional tools can come from configured MCP servers.
+Some tools are runtime-role specific rather than globally available to every skill. For example:
 
-Configure runtime behavior in `.deepclause/config.json`.
+- the conductor adds tools such as `run_skill`, `create_skill`, and `update_memory`
+- the skill creator adds tools such as `list_skills`, `write_file`, `validate_dml`, `test_dml`, and `deploy_skill`
 
-MCP support is on the roadmap.
+Additional tools can come from configured MCP servers. Use `deepclause list-tools` to see the built-ins plus anything exposed by your configured MCP servers.
 
 ## CLI Reference
 
@@ -281,73 +545,68 @@ deepclause set-model <model>       # Change all slots or one slot with --slot
 
 ```bash
 deepclause run skill.dml "input" \
-    --model google/gemini-2.5-flash \   # Override the run model for this execution
-  --stream \                           # Stream output
-  --verbose \                          # Show tool calls
-    --workspace ./data \                 # Set working directory
-    --sandbox                            # Use AgentVM instead of the local shell
+    --model google:gemini-2.5-flash \  # Override the run model for this execution
+    --stream \                          # Stream output
+    --verbose \                         # Show tool calls
+    --workspace ./data \                # Set working directory
+    --sandbox                           # Use AgentVM instead of the local shell
 ```
 
-## Configuration
+### Compile Options
 
-`.deepclause/config.json`:
-```json
-{
-    "models": {
-        "gateway": "openai:gpt-4o",
-        "run": "openai:gpt-4o",
-        "compile": "openai:gpt-4o"
-    },
-    "temperatures": {
-        "gateway": 0.7,
-        "run": 0.7,
-        "compile": 0.4
-    },
-  "agentvm": { "network": true }
-}
-```
+`deepclause compile` and `deepclause compile-all` use the `compile` model slot. They accept `--model`, `--provider`, `--temperature`, `--max-attempts`, `--sandbox`, and `--no-audit`.
 
-### System Overrides
+Static analysis always runs. `--no-audit` disables only the LLM security audit.
 
-If you place system DML files in `.deepclause/system`, the CLI runtime will prefer them over the packaged defaults.
+One-shot prompt mode uses the same compile pipeline before execution, so `deepclause run -p "..." --no-audit` disables the LLM audit there as well.
 
-- `.deepclause/system/conductor.dml`
-- `.deepclause/system/skill-creator.dml`
+```bash
+deepclause compile skill.md \
+    --model claude-sonnet-4-20250514 \
+    --provider anthropic \
+    --temperature 0.2 \
+    --max-attempts 4
+
+deepclause compile-all ./specs \
+    --model claude-sonnet-4-20250514 \
+    --provider anthropic \
+    --no-audit
+```
 
-### Model at Compile Time vs Run Time
+## Configuration
 
-DeepClause separates model selection into three slots:
+The main configuration surface is `.deepclause/config.json`.
 
-- `gateway`: conductor and orchestration turns
-- `run`: compiled skill execution
-- `compile`: skill compilation
+The most important fields are covered above in:
 
-At execution time, you can still override the run model for a single command:
+- [Install and Run](#install-and-run)
+- [TUI Conductor](#tui-conductor)
+- [Model and Provider Configuration](#model-and-provider-configuration)
 
-```bash
-# Set all slots
-deepclause set-model openai:gpt-4o
+Other useful config fields:
 
-# Or tune a single slot
-deepclause set-model anthropic:claude-sonnet-4-20250514 --slot compile
-
-# Compile with the compile slot
-deepclause compile research.md
-
-# Run with a different one-off model override
-deepclause run research.dml "quantum computing" --model google/gemini-2.5-flash
+```json
+{
+    "agentvm": {
+        "network": false
+    },
+    "workspace": "./workspace",
+    "dmlBase": ".deepclause/tools",
+    "mcp": {
+        "servers": {
+            "filesystem": {
+                "command": "npx",
+                "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+            }
+        }
+    }
+}
 ```
 
-This lets you keep different defaults for orchestration, skill execution, and compilation without constantly editing prompts or code.
-
-### Supported Models
-
-| Provider | Models |
-|----------|--------|
-| OpenAI | `gpt-4o`, `gpt-4o-mini`, `o1`, `o3-mini` |
-| Anthropic | `claude-sonnet-4-20250514`, `claude-3-5-sonnet-20241022` |
-| Google | `gemini-2.5-pro`, `gemini-2.5-flash` |
-| OpenRouter | Any model via `openrouter/provider/model` |
+- `agentvm.network` controls whether shell commands in `--sandbox` mode get outbound network access.
+- `workspace` sets the default working directory used by shell/file tools.
+- `dmlBase` changes where compiled local skills are written.
+- `mcp.servers` registers MCP servers that then appear in `deepclause list-tools`.
 
 ## Understanding DML
 

package/dist/cli/compile.d.ts

@@ -5,7 +5,9 @@
  * with LLM generation and Prolog validation.
  */
 import { type Provider } from './config.js';
+import type { DMLEvent } from '../types.js';
 import { extractDescription as extractDescriptionFromCompiler, extractParameters as extractParametersFromCompiler, extractToolDependencies as extractToolDependenciesFromCompiler } from '../compiler.js';
+import type { AnalysisResult } from '../types.js';
 export interface CompileOptions {
     force?: boolean;
     validateOnly?: boolean;
@@ -17,6 +19,10 @@ export interface CompileOptions {
     verbose?: boolean;
     stream?: boolean;
     audit?: boolean;
+    headless?: boolean;
+    trace?: string;
+    signal?: AbortSignal;
+    onEvent?: (event: DMLEvent) => void;
 }
 export interface CompileResult {
     output: string;
@@ -27,6 +33,10 @@ export interface CompileResult {
     meta?: MetaFile;
     explanation?: string;
     attempts?: number;
+    analysis?: AnalysisResult;
+    runtimeOutput?: string[];
+    trace?: object;
+    events?: DMLEvent[];
 }
 export interface CompileAllResult {
     compiled: number;

package/dist/cli/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/cli/compile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/cli/compile.ts"],"names":[],"mappings":"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"}

package/dist/cli/compile.js

@@ -70,7 +70,8 @@ class StatusIndicator {
 export async function compile(sourcePath, outputDir, options = {}) {
     const maxAttempts = options.maxAttempts ?? 3;
     const verbose = options.verbose ?? false;
-    const shouldStream = options.stream ?? true;
+    const shouldStream = options.stream ?? false;
+    const shouldAudit = options.audit !== false;
     // Resolve paths
     const absoluteSource = path.resolve(sourcePath);
     const absoluteOutputDir = path.resolve(outputDir);
@@ -126,9 +127,28 @@ export async function compile(sourcePath, outputDir, options = {}) {
     });
     applyResolvedModelConfig(compileSelection);
     const runSelection = resolveModelSlot(config, 'run');
-    // Status indicator
-    const status = new StatusIndicator(verbose || shouldStream);
-    status.start(`Compiling...`);
+    const runtimeOutput = [];
+    const events = [];
+    let executionTrace;
+    const captureEvents = (options.headless
+        || shouldStream
+        || verbose
+        || !!options.trace
+        || !!options.onEvent);
+    const status = new StatusIndicator(!captureEvents);
+    if (!captureEvents) {
+        status.start('Compiling...');
+    }
+    const handleEvent = (event) => {
+        events.push(event);
+        if (event.type === 'output' && event.content) {
+            runtimeOutput.push(event.content);
+        }
+        if ((event.type === 'finished' || event.type === 'error') && event.trace) {
+            executionTrace = event.trace;
+        }
+        options.onEvent?.(event);
+    };
     try {
         const result = await compileWithSkillCreator(markdown, {
             sourcePath: absoluteSource,
@@ -143,18 +163,31 @@ export async function compile(sourcePath, outputDir, options = {}) {
             validateOnly: options.validateOnly,
             maxAttempts,
             verbose,
+            stream: shouldStream,
+            trace: !!options.trace,
+            audit: shouldAudit,
             onUserInput: promptUser,
+            signal: options.signal,
+            onEvent: handleEvent,
         });
-        status.stop();
-        if (result.analysis.warnings.length > 0) {
+        if (!captureEvents) {
+            status.stop();
+        }
+        if (options.trace && executionTrace) {
+            const tracePath = path.resolve(options.trace);
+            await fs.writeFile(tracePath, JSON.stringify(executionTrace, null, 2) + '\n');
+        }
+        if (!options.onEvent && !options.headless && result.analysis.warnings.length > 0) {
             console.log('\n⚠️  Static Analysis Warnings:');
             for (const warning of result.analysis.warnings) {
                 const icon = warning.level === 'critical' ? '🔴' : warning.level === 'high' ? '🟠' : warning.level === 'medium' ? '🟡' : '⚪';
                 console.log(`  ${icon} [${warning.level.toUpperCase()}] ${warning.message}`);
             }
         }
-        console.log('\n✅ Compilation successful!\n');
-        console.log(result.explanation);
+        if (!options.onEvent && !options.headless) {
+            console.log('\n✅ Compilation successful!\n');
+            console.log(result.explanation);
+        }
         return {
             output: dmlPath,
             tools: result.tools,
@@ -164,11 +197,27 @@ export async function compile(sourcePath, outputDir, options = {}) {
             meta: result.meta,
             explanation: result.explanation,
             attempts: 1,
+            analysis: result.analysis,
+            runtimeOutput,
+            trace: executionTrace,
+            events,
         };
     }
     catch (error) {
-        status.stop();
-        throw error;
+        if (!captureEvents) {
+            status.stop();
+        }
+        if (options.trace && executionTrace) {
+            const tracePath = path.resolve(options.trace);
+            await fs.writeFile(tracePath, JSON.stringify(executionTrace, null, 2) + '\n');
+        }
+        const compileError = error instanceof Error
+            ? error
+            : new Error(String(error));
+        compileError.runtimeOutput = runtimeOutput;
+        compileError.trace = executionTrace;
+        compileError.events = events;
+        throw compileError;
     }
 }
 /**
@@ -199,7 +248,8 @@ export async function compileAll(sourceDir, outputDir, options = {}) {
             const compileResult = await compile(sourcePath, absoluteOutputDir, {
                 ...options,
                 stream: false, // Don't stream when batch compiling
-                verbose: false
+                verbose: false,
+                headless: true,
             });
             if (compileResult.skipped) {
                 result.skipped++;
@@ -242,6 +292,7 @@ export async function compilePrompt(prompt, options = {}) {
         validateOnly: true,
         maxAttempts: options.maxAttempts,
         verbose: options.verbose,
+        audit: options.audit !== false,
         onUserInput: promptUser,
     });
     return {