v3.0.0a1: add runtime event system exports, bump version

purpose_agent/__init__.py

@@ -1,28 +1,13 @@
 """
 purpose_agent — A local-first self-improvement kernel for agents.
 
-Turns traces into tested memory, policies, and rubrics so agents improve
-without fine-tuning, cloud infrastructure, or vendor lock-in.
+v3.0 adds: canonical event runtime, AG-UI streaming, durable execution (planned).
 
-Architecture based on 13 published papers.
+Architecture based on 13+ published papers.
 See COMPILED_RESEARCH.md for the full research trace.
-
-Modules:
-  Core:       types, llm_backend, actor, purpose_function, experience_replay, optimizer, orchestrator
-  V2 Kernel:  v2_types, trace, memory, compiler, immune, memory_ci, evalport, benchmark_v2
-  Research:   meta_rewarding, self_taught, prompt_optimizer, llm_compiler, retroformer
-  SLM:        slm_backends (Ollama, llama-cpp, prompt compression)
-  Streaming:  streaming (async generators, event streaming)
-  Tools:      tools (Tool base class, built-in tools, Tool RAG)
-  Observe:    observability (cost tracking, callbacks, metrics)
-  Multi:      multi_agent (shared memory, agent delegation, teams)
-  HITL:       hitl (checkpoint, interrupt, resume, Φ overrides)
-  Eval:       evaluation (benchmark runner, improvement curves)
-  Unified:    unified (Agent, Graph, parallel, Conversation, KnowledgeStore)
-  Easy:       easy (purpose(), Team, quickstart wizard)
 """
 
-__version__ = "2.1.1"
+__version__ = "3.0.0a1"
 
 # ── Core ──────────────────────────────────────────────────────────────────
 from purpose_agent.types import (
@@ -49,6 +34,10 @@ 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) ─────────────────────────────────────────────────────
+from purpose_agent.runtime.events import PAEvent, EventKind, Visibility, create_event
+from purpose_agent.runtime.event_bus import EventBus, parallel_merge
+
 # ── Research Implementations ──────────────────────────────────────────────
 from purpose_agent.meta_rewarding import MetaRewardingLoop
 from purpose_agent.self_taught import SelfTaughtEvaluator
@@ -99,11 +88,10 @@ from purpose_agent.registry import (
 from purpose_agent.unified import (
     Agent, Graph, parallel, Conversation, KnowledgeStore,
     START, END, Message,
-    # Creative names (primary — use these)
     Spark, Flow, swarm, Council, Vault, BEGIN, DONE_SIGNAL,
 )
 
-# ── Easy API (the only thing beginners need) ─────────────────────────────
+# ── Easy API ─────────────────────────────────────────────────────────────
 from purpose_agent.easy import purpose, Team, quickstart, TEAM_TEMPLATES
 
 __all__ = [
@@ -123,6 +111,9 @@ __all__ = [
     "MemoryCI",
     "EvalCase", "EvalPort", "DictEvalPort", "ScoreBundle",
     "BenchmarkRunnerV2", "V2BenchmarkResult",
+    # V3 Runtime (NEW)
+    "PAEvent", "EventKind", "Visibility", "create_event",
+    "EventBus", "parallel_merge",
     # Research
     "MetaRewardingLoop", "SelfTaughtEvaluator",
     "PromptOptimizer", "Signature", "Demonstration",
@@ -144,15 +135,14 @@ __all__ = [
     # HITL
     "HITLOrchestrator", "Checkpoint", "HumanInputHandler",
     "CLIInputHandler", "AutoApproveHandler", "InterruptType",
-    # Evaluation (V1)
+    # Evaluation
     "BenchmarkTask", "BenchmarkRunner", "BenchmarkResult",
     # Plugin Registry
     "PluginRegistry", "backend_registry", "callback_registry", "model_registry",
     "EmbeddingBackend", "default_embedding",
-    # Unified Capabilities (backward-compat names)
+    # Unified Capabilities
     "Agent", "Graph", "parallel", "Conversation", "KnowledgeStore",
     "START", "END", "Message",
-    # Creative names (primary — use these)
     "Spark", "Flow", "swarm", "Council", "Vault", "BEGIN", "DONE_SIGNAL",
     # Easy API
     "purpose", "Team", "quickstart", "TEAM_TEMPLATES",