orchestrator-file-contents-handler

What problem does it solve?

It prevents nondeterministic or hallucinatory “file created” claims by ensuring that only the explicit file_contents artifact results in real filesystem writes during the orchestrator commit phase.

Core Features & Use Cases

• Single Source of Truth: Treats payload.file_contents as the only deterministic path to actual file export, even if a worker claims success without providing the artifact.
• Single Committer Determinism: Aggregates reduced artifacts and performs controlled writes via NBAccess/NBFileExport under accessible directory guards.
• LLM-commit Skip Mode: Detects whether any LLM payload keys exist (expression, expressions, cells, code, HeldExpr) and can return early in file-contents-only scenarios with Status="Committed" and Details="FileContentsOnly".

Quick Start

Ask the orchestrator to commit artifacts that include payload.file_contents so the handler writes the declared paths via NBFileExport and returns Committed without requiring LLM commit payloads.