gradual-adoption: export state_delta, falsification_critic, sandbox_hooks from __init__

purpose_agent/__init__.py

@@ -1,10 +1,9 @@
 """
 purpose_agent — A local-first self-improvement kernel for agents.
 
-v3.0 adds: canonical event runtime, AG-UI streaming, durable execution (planned).
-
-Architecture based on 13+ published papers.
-See COMPILED_RESEARCH.md for the full research trace.
+v3.0 features: event runtime, durable execution, memory homeostasis,
+protocol interop, intelligent routing, skill evolution, agentic optimization,
+AND first-principles engineering (O(1) critic, falsification scoring, PEP 578 sandbox).
 """
 
 __version__ = "3.0.0a1"
@@ -24,6 +23,11 @@ from purpose_agent.experience_replay import ExperienceReplay
 from purpose_agent.optimizer import HeuristicOptimizer
 from purpose_agent.orchestrator import Orchestrator, Environment, SimpleEnvironment, TaskResult
 
+# ── First-Principles (NEW) ───────────────────────────────────────────────
+from purpose_agent.state_delta import compute_state_delta, StateDelta, format_critic_input
+from purpose_agent.falsification_critic import FalsificationCritic, FalsificationResult
+from purpose_agent.sandbox_hooks import install_sandbox, SandboxPolicy, SandboxViolation, is_sandbox_installed
+
 # ── V2 Kernel ─────────────────────────────────────────────────────────────
 from purpose_agent.v2_types import RunMode, MemoryScope, PurposeScoreV2
 from purpose_agent.trace import Trace, TraceEvent
@@ -34,7 +38,7 @@ from purpose_agent.memory_ci import MemoryCI
 from purpose_agent.evalport import EvalCase, EvalPort, DictEvalPort, ScoreBundle
 from purpose_agent.benchmark_v2 import BenchmarkRunnerV2, V2BenchmarkResult
 
-# ── V3 Runtime (NEW) ─────────────────────────────────────────────────────
+# ── V3 Runtime ────────────────────────────────────────────────────────────
 from purpose_agent.runtime.events import PAEvent, EventKind, Visibility, create_event
 from purpose_agent.runtime.event_bus import EventBus, parallel_merge
 
@@ -75,7 +79,7 @@ from purpose_agent.hitl import (
     CLIInputHandler, AutoApproveHandler, InterruptType,
 )
 
-# ── Evaluation (V1 compat) ──────────────────────────────────────────────
+# ── Evaluation ───────────────────────────────────────────────────────────
 from purpose_agent.evaluation import BenchmarkTask, BenchmarkRunner, BenchmarkResult
 
 # ── Plugin Registry ──────────────────────────────────────────────────────
@@ -102,23 +106,25 @@ __all__ = [
     "OpenAICompatibleBackend", "ChatMessage", "resolve_backend",
     "Actor", "PurposeFunction", "ExperienceReplay", "HeuristicOptimizer",
     "Orchestrator", "Environment", "SimpleEnvironment", "TaskResult",
+    # First-Principles
+    "compute_state_delta", "StateDelta", "format_critic_input",
+    "FalsificationCritic", "FalsificationResult",
+    "install_sandbox", "SandboxPolicy", "SandboxViolation", "is_sandbox_installed",
     # V2 Kernel
     "RunMode", "MemoryScope", "PurposeScoreV2",
     "Trace", "TraceEvent",
     "MemoryStore", "MemoryCard", "MemoryKind", "MemoryStatus",
     "PromptCompiler", "CompiledPrompt",
-    "scan_memory", "ScanResult",
-    "MemoryCI",
+    "scan_memory", "ScanResult", "MemoryCI",
     "EvalCase", "EvalPort", "DictEvalPort", "ScoreBundle",
     "BenchmarkRunnerV2", "V2BenchmarkResult",
-    # V3 Runtime (NEW)
+    # V3 Runtime
     "PAEvent", "EventKind", "Visibility", "create_event",
     "EventBus", "parallel_merge",
     # Research
     "MetaRewardingLoop", "SelfTaughtEvaluator",
     "PromptOptimizer", "Signature", "Demonstration",
-    "LLMCompiler", "ExecutionPlan", "TaskNode",
-    "Retroformer",
+    "LLMCompiler", "ExecutionPlan", "TaskNode", "Retroformer",
     # SLM
     "OllamaBackend", "LlamaCppBackend", "SLMPromptCompressor",
     "create_slm_backend", "SLM_REGISTRY",