Coverage for agentos/__init__.py: 100%

1"""NexusAgent - Production-grade Agent Framework SDK 

2 

3v1.12.1: Async Parallel Primitives (fan-out/fan-in, parallel_gather, parallel_map, structured concurrency). 

4v1.12.0: Letta-style Virtual Memory Pager (page-out/page-in + swap store + smart recall). 

5v1.11.0: Background Task Manager + Agent Supervision Tree + Full Checkpoint Integration + Auto-Context Paging. 

6v1.10.0: All-in — Deploy (Docker/K8s) + Eval (SWE-bench/GAIA) + Multimodal (Vision/Audio) + Prompt Hub (versioned) + Cost Tracker (pricing). 

7v1.9.9: GuardPipeline (PII/Injection/Toxicity safety with strict/permissive modes). 

8v1.9.5: CodeSandbox (safe code gen + test case validation) + Human-in-the-Loop breakpoints. 

9v1.9.4: TaskDecomposer + ResultFusion + EvalFeedbackLoop (P0 three-bottleneck fix). 

10v1.9.3: CompositeScorer V2 (BLEU smoothing + LLM-as-Judge), 50+ benchmark cases, 80% pass rate. 

11v1.9.2: Swarm MESH 5x parallel acceleration, CompositeScorer (ROUGE-L+BLEU+contains+exact), 14 built-in benchmarks, AutoPilot self-healing. 

12v1.7.1: System layer + Desktop client: visual approval engine (Agent applies → user clicks allow/deny), native desktop shell (pywebview wrapper), tiered file/shell/browser ops。 

13v1.0.0: Production release — ToolUsingAgent CLI, Mock fallback mode, 

14weather demo (`agentos demo`), unified LLM Provider abstraction, 

15streaming/retry/checkpoint/resume, PyPI + TestPyPI dual publish. 

16 

17v1.3.38: +Tool-Using Agent streaming/retry/checkpoint/resume（run_stream/重试逻辑/断点恢复）， 

18+MockLLMProvider 集成测试支持。11+10 条 Agent 测试全过。 

19v1.3.37: +Tool-Using Agent (agentos.agent) — 基于 LLM Function Calling 的自主 Agent 循环： 

20ToolExecutor 工具注册/执行、多步推理闭环、同步/异步运行、成本追踪、端到端天气 Agent 示例。 

21v1.3.36: +LLM Provider Module (agentos.llm) — unified abstraction with OpenAI/DeepSeek/Anthropic 

22providers, Function Calling / Tool Use, streaming, cost estimation. 零 SDK 依赖 AnthropicProvider 

23(pure httpx). 

24v1.3.15: +SubAgent Parent-Child Communication (SharedState, ChildContext/ChildHandle, heartbeat, 

25lifecycle management: pause/resume/cancel/timeout, heartbeat monitoring). 

26v1.3.14: +OpenTelemetry Integration (otel_bridge: OtelConfig/OtelTracer/OtelMeter/OtelMiddleware). 

27v1.3.13: +A2A Protocol v2 (Task Store with InMemory/SQLite backends, Streaming SSE task lifecycle 

28notifications, enhanced A2AClient with retry/auth/connection pooling, A2AServer with FastAPI 

29route builder + streaming + auth + pluggable persistence). 

30v1.3.12: +Prompt Optimizer (DSPy-inspired iterative refinement, bootstrapping, multi-strategy), 

31+Few-Shot Selector (similarity/diversity/label-balanced strategies), 

32+SSE Streaming (ASGI SSE with heartbeats, backpressure, typed events). 

33v1.3.11: +Guardrails (Input/Output safety engine with PII/Injection/Keyword/Toxicity rules, PolicyEnforcer), 

34+HITL (Human-in-the-Loop approval workflows with RiskLevel auto-decision, caching, preset policies). 

35v1.3.10: +Conversation Manager (multi-turn dialog, sliding window, branching, summarization). 

36v1.3.9: +Schema Enforcer (Pydantic output validation/auto-repair). 

37v1.3.8: +Quality (docstrings, bare-except/type-ignore fixes). 

38 

39v1.4.0: +End-to-end examples (multi_agent_research.py, file_ops_agent.py), 

40+Professional README with feature comparison table, 

41+CLI demo upgraded with self-check mode, +Agent marketplace listing. 

42""" 

43 

44__version__ = "1.16.1" 

45 

46# v1.15.0: Tool Output Validation Layer (structured result validation + error classification + auto-repair suggestions). 

47# v1.14.9: Memory Persistence Checkpoint Delivery - all 6 memory subsystems get_state()/restore_state() + ServerDaemon lifecycle integration + DaemonConfig + /api/daemon/memory endpoint. 

48# v1.14.8: P0 regression fix (imports, version, dependencies). 

49 

50# Core - DI system 

51# Tool-Using Agent (v1.3.38) 

52from agentos.agent import ( 

53 AgentConfig, 

54 AgentResult, 

55 AgentStep, 

56 MockLLMProvider, 

57 ToolAgent, 

58 ToolExecutor, 

59) 

60 

61# Agent Marketplace (v1.3.0) 

62from agentos.agents.market import ( 

63 AgentCategory, 

64 AgentMarket, 

65 AgentSkill, 

66) 

67 

68# API Middleware (v1.3.0) 

69from agentos.api.middleware import ( 

70 AuthConfig, 

71 CORSConfig, 

72 CORSMiddleware, 

73 RequestContext, 

74 RequestIDMiddleware, 

75) 

76 

77# API Server (v1.3.2) 

78from agentos.api.server import ( 

79 AgentAPI, 

80 RunRequest, 

81 RunResponse, 

82) 

83 

84# API Streaming (v1.3.0) 

85from agentos.api.streaming import ( 

86 StreamEvent, 

87 StreamingAgent, 

88 StreamSession, 

89) 

90 

91# API Versioning (v1.3.0) 

92from agentos.api.versioning import ( 

93 APIVersion, 

94 VersionConfig, 

95 VersionNegotiator, 

96 VersionStrategy, 

97) 

98 

99# Benchmark Runner (v1.3.0) 

100from agentos.benchmarks.runner import ( 

101 BenchmarkConfig, 

102 BenchmarkReport, 

103 BenchmarkRunner, 

104 BenchmarkScenario, 

105) 

106 

107# Cache - LLM Response Cache (v1.2.7) 

108from agentos.cache import ( 

109 BaseEmbedder, 

110 CacheEntry, 

111 CacheKeyStrategy, 

112 CohereEmbedder, 

113 LLMCache, 

114 LocalEmbedder, 

115 OpenAIEmbedder, 

116 ResponseCache, 

117) 

118 

119# CLI Init (v1.4.1) 

120from agentos.cli.init import ( 

121 scaffold, 

122) 

123 

124# CLI Main (v1.0.0) 

125from agentos.cli.main import main as cli_main 

126 

127# CLI Serve (v1.3.0) 

128from agentos.cli.serve import ( 

129 ServeConfig, 

130 start_api_server, 

131) 

132 

133# Communication layer 

134from agentos.comm.layer import ( 

135 Blackboard, 

136 CommunicationLayer, 

137 EventBus, 

138 Mailbox, 

139) 

140 

141# Concurrency (v1.1.3) 

142from agentos.concurrency.batch import ( 

143 AsyncBatchExecutor, 

144 BatchConfig, 

145 BatchResult, 

146 BatchStrategy, 

147 TaskSpec, 

148) 

149from agentos.concurrency.batch import ( 

150 TaskResult as BatchTaskResult, 

151) 

152from agentos.concurrency.batch import ( 

153 TaskStatus as BatchTaskStatus, 

154) 

155 

156# Config System (v1.2.7) 

157from agentos.config import ( 

158 AgentOSConfig, 

159 AgentOSPreset, 

160 ValidationResult, 

161) 

162 

163# Core extensions (v1.2.9) 

164from agentos.core import ( 

165 AgentContext, 

166 AgentState, 

167 AgentStateMachine, 

168 AsyncAgentLoop, 

169 AsyncContextManager, 

170 AsyncInvocationResult, 

171 AsyncLoopConfig, 

172 ContextManager, 

173 CoreMessage, 

174 CoreToolCall, 

175 CoreToolResult, 

176 ResponseCollector, 

177 Session, 

178 SessionStore, 

179 StateTimeoutError, 

180 StateTransition, 

181 StreamChunk, 

182 StreamEmitter, 

183 StreamEvent, 

184 TransitionError, 

185) 

186 

187# Core - CodeAgent 

188from agentos.core.code_agent import ( 

189 CodeAgent, 

190 CodeResult, 

191 CodeStep, 

192) 

193 

194# Cost Tracking (v1.20.0) 

195from agentos.core.cost_tracker import ( 

196 CostTracker, 

197 ModelPricing, 

198 UsageRecord, 

199) 

200from agentos.core.di import ( 

201 Agent, 

202 Depends, 

203 RunContext, 

204 inject_tool, 

205 requires_context, 

206) 

207 

208# Feature Flags (v1.20.0) 

209# Core - Handoff protocol 

210from agentos.core.handoff import ( 

211 Handoff, 

212 HandoffAwareAgent, 

213 HandoffResult, 

214 can_handle, 

215 execute_with_handoff, 

216 transfer_to, 

217) 

218 

219# Agent Loop (v1.3.2) 

220from agentos.core.loop import ( 

221 AgentLoop, 

222 AgentResult, 

223 HumanInterruptNeeded, 

224 LoopConfig, 

225 LoopState, 

226 MaxIterationsExceeded, 

227) 

228 

229# Core - Middleware Pipeline (v1.2.7) 

230from agentos.core.middleware import ( 

231 AgentMiddleware, 

232 MiddlewareContext, 

233 MiddlewareDecision, 

234 MiddlewarePhase, 

235 MiddlewarePipeline, 

236) 

237 

238# Cost - Token Counter (v1.2.9) 

239from agentos.cost import ( 

240 CostEstimate, 

241 ModelFamily, 

242 TokenCount, 

243 TokenCounter, 

244) 

245 

246# Cost tracking (v1.1.4) 

247from agentos.cost.tracker import ( 

248 PRICING, 

249 CostTracker, 

250 ModelPricing, 

251 RunCostSession, 

252 UsageRecord, 

253) 

254 

255# Deployment (v1.2.8) 

256from agentos.deployment import ( 

257 ComposeConfig, 

258 ComposeService, 

259 DockerConfig, 

260) 

261 

262# Docs Generator (v1.3.2) 

263from agentos.docs.generator import ( 

264 DocConfig, 

265 generate_api_docs, 

266 generate_quickstart, 

267) 

268 

269# Errors (v1.2.8) 

270from agentos.errors import ( 

271 ErrorCategory, 

272 ErrorContext, 

273 ErrorFormatter, 

274 HumanError, 

275) 

276 

277# Evaluation Framework (v1.3.18) 

278from agentos.evaluation import ( 

279 EvalReport, 

280 Evaluator, 

281 Scorer, 

282) 

283from agentos.evaluation.scorers import ( 

284 CompositeScorer, 

285) 

286 

287# Evolution engine 

288from agentos.evolution.engine import ( 

289 EvolutionEngine, 

290 EvolutionProposal, 

291 EvolutionStatus, 

292) 

293from agentos.experiments import ( 

294 Evaluator as ExperimentEvaluator, 

295) 

296 

297# Experiments (v1.2.8) 

298from agentos.experiments import ( 

299 ExperimentConfig, 

300 ExperimentReport, 

301 ExperimentRunner, 

302 PromptVariant, 

303 TrialResult, 

304) 

305 

306# Feedback (v1.2.8) 

307from agentos.feedback import ( 

308 FeedbackCollector, 

309 FeedbackRecord, 

310 FeedbackType, 

311 PreferenceLearner, 

312) 

313 

314# Health (v1.2.9) 

315from agentos.health import ( 

316 CheckResult, 

317 HealthCheck, 

318 HealthChecker, 

319 HealthStatus, 

320) 

321 

322# Logging (v1.2.9) 

323from agentos.log import ( 

324 JSONFormatter, 

325 TraceContext, 

326) 

327 

328# MCP Package (v1.3.6) 

329from agentos.mcp import ( 

330 MCPClient as MCPFullClient, 

331) 

332from agentos.mcp import ( 

333 MCPError, 

334 MCPPromptDef, 

335 MCPPromptInfo, 

336 MCPResource, 

337 MCPResourceInfo, 

338 # MCP Server (v1.5.2) 

339 MCPServer, 

340 MCPToolDef, 

341 MCPToolInfo, 

342 connect_mcp_servers, 

343 create_default_server, 

344 start_mcp_server, 

345) 

346from agentos.mcp import ( 

347 MCPServerConfig as MCPConfig, 

348) 

349from agentos.mcp.adapter import ( 

350 MCPToolAdapter, 

351 MCPToolRegistry, 

352) 

353 

354# Built-in MCP Servers (v1.7.8) 

355from agentos.mcp.builtin_servers import ( 

356 BuiltinMCPRegistry, 

357 FilesystemServer, 

358 MemoryServer, 

359 WebFetchServer, 

360 create_default_registry, 

361) 

362 

363# Memory - Retriever + Conversation (v1.2.7) 

364# Memory extensions (v1.2.8) 

365# Memory - Compressor (v1.2.9) 

366from agentos.memory import ( 

367 ContextCompressor, 

368 ConversationMemory, 

369 ImportanceScorer, 

370 LongTermMemory, 

371 MemoryChunk, 

372 MemoryStore, 

373 MemorySummarizer, 

374 SemanticMemoryRetriever, 

375 VectorMemory, 

376 WorkingMemory, 

377 WorkingMemoryItem, 

378) 

379 

380# Memory pyramid 

381from agentos.memory.pyramid import ( 

382 MemoryItem, 

383 MemoryLayer, 

384 MemoryPyramid, 

385 MemoryType, 

386) 

387 

388# Anthropic Claude Backend (v1.3.5) 

389from agentos.models.backends.anthropic import ( 

390 ClaudeClient, 

391 ClaudeConfig, 

392) 

393 

394# Gemini Backend (v1.3.1) 

395from agentos.models.backends.gemini import ( 

396 GeminiClient, 

397 GeminiConfig, 

398 GeminiSafetySetting, 

399) 

400 

401# Ollama Backend (v1.3.5) 

402from agentos.models.backends.ollama import ( 

403 OllamaClient, 

404 OllamaConfig, 

405) 

406 

407# OpenAI Backend (v1.3.5) 

408from agentos.models.backends.openai import ( 

409 OpenAIClient, 

410 OpenAIConfig, 

411) 

412 

413# Models - Resilience (v1.1.5) 

414from agentos.models.resilience import ( 

415 CancellationSource, 

416 CancelledError, 

417 CircuitBreaker, 

418 CircuitBreakerConfig, 

419 ResilienceConfig, 

420 ResilientCall, 

421 RetryConfig, 

422 retry_with_backoff, 

423 with_fallback, 

424 with_timeout, 

425) 

426 

427# Models - Router (v1.2.7 minimal) 

428# Model Route Types (v1.3.1) 

429# Model Config (v1.3.2) 

430from agentos.models.router import ( 

431 RECOMMENDED_CONFIG, 

432 AllModelsFailed, 

433 ModelConfig, 

434 ModelResponse, 

435 ModelRouter, 

436 ModelSpec, 

437) 

438 

439# Models - Routing Strategy (v1.2.8) 

440from agentos.models.routing_strategy import ( 

441 Budget, 

442 Complexity, 

443 RoutingStrategy, 

444) 

445 

446# Monitoring (v1.2.8) 

447from agentos.monitoring import ( 

448 Alert, 

449 AlertEvaluator, 

450 AlertRule, 

451 AlertSeverity, 

452 AlertState, 

453 MonitoringConfig, 

454 WebhookConfig, 

455 WebhookDispatcher, 

456) 

457 

458# Multimodal (v1.2.7) 

459from agentos.multimodal import ( 

460 Modality, 

461 MultimodalManager, 

462) 

463 

464# Observability (v1.2.7) 

465from agentos.observability import ( 

466 BudgetAlert, 

467 CostAnalytics, 

468 MetricsCollector, 

469 NoopTracer, 

470 Tracer, 

471) 

472 

473# Orchestration extensions (v1.2.8) 

474from agentos.orchestration import ( 

475 A2ARouter, 

476 AgentGraph, 

477 GraphNodeState, 

478 GraphRecipe, 

479 GraphResult, 

480 RouterAgentCard, 

481 RouterTask, 

482 TaskResult, 

483 TaskStatus, 

484) 

485 

486# Orchestration 

487from agentos.orchestration.graph import ( 

488 GraphEdge, 

489 GraphNode, 

490 GraphOrchestrator, 

491) 

492 

493# Plugin Manager (v1.2.9) 

494from agentos.plugin_manager import ( 

495 PluginInfo, 

496 PluginManager, 

497) 

498 

499# Plugins - Plugin System (v1.2.7) 

500from agentos.plugins import ( 

501 DiscoveredPlugin, 

502 LifecycleManager, 

503 PluginDiscovery, 

504 PluginLoader, 

505 PluginRegistry, 

506 PluginStatus, 

507 RegisteredPlugin, 

508) 

509 

510# Prompts (v1.2.7) 

511from agentos.prompts import ( 

512 PromptRegistry, 

513 PromptTemplate, 

514) 

515 

516# Protocols - Contracts (v1.2.9) 

517from agentos.protocols import ( 

518 AgentCapability, 

519 AgentContract, 

520 CapabilityDomain, 

521 CapabilityMatcher, 

522 ContractRegistry, 

523 MatchScore, 

524 QoSLevel, 

525) 

526 

527# Protocols - A2A 

528from agentos.protocols.a2a import ( 

529 A2AArtifact, 

530 A2AClient, 

531 A2AHandoff, 

532 A2AMessage, 

533 A2AServer, 

534 A2ASession, 

535 A2ATask, 

536 DataPart, 

537 FilePart, 

538 TaskState, 

539 TextPart, 

540 new_handoff, 

541 new_task, 

542) 

543 

544# Protocols - Agent Card 

545from agentos.protocols.agent_card import ( 

546 AgentCard, 

547 AgentCardDiscovery, 

548 AgentCardRegistry, 

549 create_card, 

550 discover_local, 

551) 

552 

553# MCP Protocol (v1.2.7) 

554from agentos.protocols.mcp import ( 

555 MCPClient, 

556 MCPServerConfig, 

557 MCPToolSchema, 

558) 

559 

560# Protocols - Structured output validation 

561from agentos.protocols.output import ( 

562 OutputValidator, 

563 StructuredOutput, 

564 validate_output, 

565) 

566 

567# Queue - Task Queue & Rate Limiter (v1.2.7) 

568from agentos.queue import ( 

569 RateLimitConfig, 

570 RateLimiter, 

571 RateLimitStrategy, 

572 TaskPriority, 

573 TaskQueue, 

574) 

575from agentos.queue import ( 

576 TaskState as QueueTaskState, 

577) 

578 

579# RAG Pipeline (v1.3.5) 

580from agentos.rag import ( 

581 ChunkConfig, 

582 EmbeddingConfig, 

583 RAGPipeline, 

584 TextChunker, 

585) 

586 

587# Security extensions (v1.9.9) 

588from agentos.security import ( 

589 ContentSafetyFilter, 

590 GuardAction, 

591 GuardChainResult, 

592 GuardPipeline, 

593 GuardResult, 

594 InputGuard, 

595 LLMSafetyAnalyzer, 

596 OutputGuard, 

597 PIIDetector, 

598 RiskLevel, 

599 SafetyReport, 

600 Sandbox, 

601 SandboxManager, 

602 Severity, 

603 create_permissive_guard, 

604 create_strict_guard, 

605) 

606 

607# Security - Auditor (v1.2.7) 

608from agentos.security.auditor import ( 

609 AuditFinding, 

610 AuditReport, 

611 SecurityAuditor, 

612) 

613 

614# Content Safety Guardrails (v1.20.0) 

615from agentos.security.guardrails import ( 

616 GuardAction, 

617 GuardResult, 

618) 

619 

620# Security - Sandbox (v1.2.1) 

621from agentos.security.sandbox_executor import ( 

622 DockerSandbox, 

623 ProcessSandbox, 

624 SandboxExecutor, 

625 SandboxMode, 

626 SandboxResult, 

627) 

628 

629# MCP Server (v1.3.0) 

630from agentos.server.mcp_server import ( 

631 MCPPrompt, 

632 MCPResource, 

633 MCPServer, 

634 MCPServerConfig, 

635 MCPTool, 

636) 

637 

638# Storage (v1.2.9) 

639from agentos.storage import ( 

640 CheckpointStore, 

641 SqliteStore, 

642) 

643 

644# SubAgent Manager (v1.2.9) + Parent-Child Communication (v1.3.15) 

645from agentos.subagent import ( 

646 ChildContext, 

647 ChildHandle, 

648 ChildHeartbeat, 

649 ChildInfo, 

650 ChildStatus, 

651 SharedState, 

652 SubAgentManager, 

653 SubAgentMode, 

654 SubAgentResult, 

655 SubAgentSpec, 

656) 

657 

658# Swarm Patterns (v1.2.8) 

659from agentos.swarm import ( 

660 CollaborationConfig, 

661 CollaborationResult, 

662 SwarmPatterns, 

663 Topology, 

664) 

665 

666# Code Sandbox (v1.9.5) 

667from agentos.swarm.code_sandbox import ( 

668 CodeFeedbackExtractor, 

669 CodeSandbox, 

670) 

671from agentos.swarm.code_sandbox import ( 

672 SandboxResult as CodeSandboxResult, 

673) 

674from agentos.swarm.code_sandbox import ( 

675 TestCase as CodeTestCase, 

676) 

677 

678# Swarm coordinator 

679# Swarm Coordinator extensions (v1.3.2) 

680from agentos.swarm.coordinator import ( 

681 AgentRole, 

682 ExecutionMode, 

683 MessageBus, 

684 SmartSwarmCoordinator, 

685 SwarmCoordinator, 

686 SwarmMessage, 

687 SwarmResult, 

688 SwarmTopology, 

689) 

690 

691# Human-in-the-Loop (v1.9.5) 

692from agentos.swarm.human_loop import ( 

693 Breakpoint, 

694 BreakpointType, 

695 HITLConfig, 

696 HITLManager, 

697 HumanDecision, 

698) 

699 

700# Testing Fixtures (v1.3.0) 

701from agentos.testing.fixtures import ( 

702 MockLLMClient, 

703 MockLLMResponse, 

704 mock_model_response, 

705 mock_openai_client, 

706 sample_config, 

707) 

708 

709# Tools extensions (v1.2.9) 

710from agentos.tools import ( 

711 BaseTool, 

712 BaseToolCall, 

713 BaseToolResult, 

714 FCToolCall, 

715 FCToolRegistry, 

716 FCToolResult, 

717 GeneratedTool, 

718 OpenAPIToolGenerator, 

719 PermissionLevel, 

720 ToolRegistry, 

721 ToolSchema, 

722) 

723 

724# Concrete Tools (v1.3.0) 

725from agentos.tools.code_agent import ( 

726 CodeAgentTool, 

727 ShellTool, 

728) 

729from agentos.tools.file_tools import ( 

730 ListDirectoryTool, 

731 ReadFileTool, 

732 WriteFileTool, 

733) 

734 

735# Fusion toolkit 

736from agentos.tools.fusion import ( 

737 FusionResult, 

738 FusionToolkit, 

739 ToolSpec, 

740) 

741 

742# Tools - Orchestrator (v1.2.7) 

743from agentos.tools.orchestrator import ( 

744 DAGBuilder, 

745 DAGSpec, 

746 ToolOrchestrator, 

747) 

748 

749# Tool risk rating (v1.1.4) 

750from agentos.tools.risk import ( 

751 ToolRiskLevel, 

752 ToolRiskRating, 

753 get_risk_preset, 

754 infer_risk_level, 

755) 

756from agentos.tools.web_tools import ( 

757 WebFetchTool, 

758) 

759 

760# Vector Store (v1.2.7) 

761from agentos.vectorstore import ( 

762 BaseVectorStore, 

763 ChromaVectorStore, 

764 FAISSVectorStore, 

765) 

766 

767# Workflows (v1.2.7) 

768from agentos.workflows import ( 

769 WorkflowEngine, 

770 WorkflowTemplate, 

771) 

772 

773__all__ = [ 

774 # Version 

775 "__version__", 

776 # Core DI 

777 "Agent", 

778 "RunContext", 

779 "Depends", 

780 "inject_tool", 

781 "requires_context", 

782 # Handoff 

783 "Handoff", 

784 "HandoffResult", 

785 "transfer_to", 

786 "can_handle", 

787 "execute_with_handoff", 

788 "HandoffAwareAgent", 

789 # CodeAgent 

790 "CodeAgent", 

791 "CodeResult", 

792 "CodeStep", 

793 # Tool-Using Agent (v1.3.38) 

794 "ToolAgent", 

795 "ToolExecutor", 

796 "AgentConfig", 

797 "AgentStep", 

798 "AgentResult", 

799 "MockLLMProvider", 

800 # Structured output 

801 "StructuredOutput", 

802 "validate_output", 

803 "OutputValidator", 

804 # Agent Card 

805 "AgentCard", 

806 "AgentCardRegistry", 

807 "AgentCardDiscovery", 

808 "discover_local", 

809 "create_card", 

810 # A2A 

811 "A2ATask", 

812 "A2AMessage", 

813 "A2AArtifact", 

814 "A2AHandoff", 

815 "A2ASession", 

816 "A2AClient", 

817 "A2AServer", 

818 "TextPart", 

819 "FilePart", 

820 "DataPart", 

821 "TaskState", 

822 "new_task", 

823 "new_handoff", 

824 # Memory 

825 "MemoryPyramid", 

826 "MemoryLayer", 

827 "MemoryType", 

828 "MemoryItem", 

829 # Evolution 

830 "EvolutionEngine", 

831 "EvolutionProposal", 

832 "EvolutionStatus", 

833 # Fusion 

834 "FusionToolkit", 

835 "FusionResult", 

836 "ToolSpec", 

837 # Risk 

838 "ToolRiskLevel", 

839 "ToolRiskRating", 

840 "get_risk_preset", 

841 "infer_risk_level", 

842 # Swarm 

843 "SwarmCoordinator", 

844 "SmartSwarmCoordinator", 

845 "SwarmTopology", 

846 "SwarmMessage", 

847 "ExecutionMode", 

848 "SwarmResult", 

849 # Communication 

850 "CommunicationLayer", 

851 "Blackboard", 

852 "EventBus", 

853 "Mailbox", 

854 # Orchestration 

855 "GraphOrchestrator", 

856 "GraphNode", 

857 "GraphEdge", 

858 # Concurrency 

859 "AsyncBatchExecutor", 

860 "BatchTaskStatus", 

861 "TaskSpec", 

862 "BatchTaskResult", 

863 "BatchConfig", 

864 "BatchResult", 

865 "BatchStrategy", 

866 # Cost 

867 "RunCostSession", 

868 "CostTracker", 

869 "ModelPricing", 

870 "UsageRecord", 

871 "PRICING", 

872 # Resilience 

873 "CancellationSource", 

874 "CancelledError", 

875 "RetryConfig", 

876 "CircuitBreaker", 

877 "CircuitBreakerConfig", 

878 "ResilienceConfig", 

879 "ResilientCall", 

880 "retry_with_backoff", 

881 "with_timeout", 

882 "with_fallback", 

883 # Router 

884 "ModelRouter", 

885 # Sandbox 

886 "SandboxExecutor", 

887 "SandboxMode", 

888 "SandboxResult", 

889 "ProcessSandbox", 

890 "DockerSandbox", 

891 # Middleware (v1.2.7) 

892 "MiddlewarePhase", 

893 "MiddlewareContext", 

894 "MiddlewareDecision", 

895 "AgentMiddleware", 

896 "MiddlewarePipeline", 

897 # Queue (v1.2.7) 

898 "TaskQueue", 

899 "QueueTaskState", 

900 "TaskPriority", 

901 "RateLimiter", 

902 "RateLimitStrategy", 

903 "RateLimitConfig", 

904 # Cache (v1.2.7) 

905 "LLMCache", 

906 "CacheEntry", 

907 "BaseEmbedder", 

908 "OpenAIEmbedder", 

909 "LocalEmbedder", 

910 "CohereEmbedder", 

911 "ResponseCache", 

912 "CacheKeyStrategy", 

913 # Plugins (v1.2.7) 

914 "PluginRegistry", 

915 "RegisteredPlugin", 

916 "PluginStatus", 

917 "PluginDiscovery", 

918 "DiscoveredPlugin", 

919 "PluginLoader", 

920 "LifecycleManager", 

921 # Observability (v1.2.7) 

922 "MetricsCollector", 

923 "Tracer", 

924 "NoopTracer", 

925 "CostAnalytics", 

926 "BudgetAlert", 

927 # Workflows (v1.2.7) 

928 "WorkflowEngine", 

929 "WorkflowTemplate", 

930 # MCP Protocol (v1.2.7) 

931 "MCPClient", 

932 "MCPServerConfig", 

933 "MCPToolSchema", 

934 # Config (v1.2.7) 

935 "AgentOSConfig", 

936 "AgentOSPreset", 

937 "ValidationResult", 

938 # Evaluation (v1.2.7) 

939 "Evaluator", 

940 "CompositeScorer", 

941 "BenchmarkCase", 

942 "EvalResult", 

943 # Audit (v1.2.7) 

944 "SecurityAuditor", 

945 "AuditFinding", 

946 "AuditReport", 

947 # Orchestrator (v1.2.7) 

948 "ToolOrchestrator", 

949 "DAGBuilder", 

950 "DAGSpec", 

951 # Memory (v1.2.7) 

952 "SemanticMemoryRetriever", 

953 "ConversationMemory", 

954 # Prompts (v1.2.7) 

955 "PromptTemplate", 

956 "PromptRegistry", 

957 # Multimodal (v1.2.7) 

958 "MultimodalManager", 

959 "Modality", 

960 # Vector Store (v1.2.7) 

961 "BaseVectorStore", 

962 "FAISSVectorStore", 

963 "ChromaVectorStore", 

964 # Errors (v1.2.8) 

965 "ErrorCategory", 

966 "ErrorContext", 

967 "ErrorFormatter", 

968 "HumanError", 

969 # Deployment (v1.2.8) 

970 "DockerConfig", 

971 "ComposeService", 

972 "ComposeConfig", 

973 # Monitoring (v1.2.8) 

974 "Alert", 

975 "AlertEvaluator", 

976 "AlertRule", 

977 "AlertSeverity", 

978 "AlertState", 

979 "MonitoringConfig", 

980 "WebhookConfig", 

981 "WebhookDispatcher", 

982 # Experiments (v1.2.8) 

983 "ExperimentRunner", 

984 "ExperimentConfig", 

985 "ExperimentReport", 

986 "PromptVariant", 

987 "TrialResult", 

988 "ExperimentEvaluator", 

989 # Feedback (v1.2.8) 

990 "FeedbackCollector", 

991 "FeedbackRecord", 

992 "FeedbackType", 

993 "PreferenceLearner", 

994 # Memory extensions (v1.2.8) 

995 "MemorySummarizer", 

996 "ImportanceScorer", 

997 "MemoryChunk", 

998 "LongTermMemory", 

999 "MemoryStore", 

1000 "WorkingMemory", 

1001 "WorkingMemoryItem", 

1002 "VectorMemory", 

1003 # Orchestration extensions (v1.2.8) 

1004 "A2ARouter", 

1005 "RouterAgentCard", 

1006 "RouterTask", 

1007 "TaskResult", 

1008 "TaskStatus", 

1009 "AgentGraph", 

1010 "GraphRecipe", 

1011 "GraphNodeState", 

1012 "GraphResult", 

1013 # Models - Routing (v1.2.8) 

1014 "RoutingStrategy", 

1015 "Complexity", 

1016 "Budget", 

1017 # Swarm Patterns (v1.2.8) 

1018 "SwarmPatterns", 

1019 "Topology", 

1020 "CollaborationConfig", 

1021 "CollaborationResult", 

1022 # Code Sandbox (v1.9.5) 

1023 "CodeSandbox", 

1024 "CodeSandboxResult", 

1025 "CodeTestCase", 

1026 "CodeFeedbackExtractor", 

1027 # Human-in-the-Loop (v1.9.5) 

1028 "HITLManager", 

1029 "HITLConfig", 

1030 "Breakpoint", 

1031 "BreakpointType", 

1032 "HumanDecision", 

1033 # Core extensions (v1.2.9) 

1034 "AgentContext", 

1035 "ContextManager", 

1036 "CoreMessage", 

1037 "CoreToolCall", 

1038 "CoreToolResult", 

1039 "AgentStateMachine", 

1040 "AgentState", 

1041 "StateTransition", 

1042 "TransitionError", 

1043 "StateTimeoutError", 

1044 "StreamChunk", 

1045 "StreamEmitter", 

1046 "StreamEvent", 

1047 "ResponseCollector", 

1048 "Session", 

1049 "SessionStore", 

1050 "AsyncAgentLoop", 

1051 "AsyncLoopConfig", 

1052 "AsyncInvocationResult", 

1053 "AsyncContextManager", 

1054 # Logging (v1.2.9) 

1055 "JSONFormatter", 

1056 "TraceContext", 

1057 # Health (v1.2.9) 

1058 "HealthChecker", 

1059 "HealthStatus", 

1060 "HealthCheck", 

1061 "CheckResult", 

1062 # Security extensions (v1.9.9) 

1063 "GuardPipeline", 

1064 "InputGuard", 

1065 "OutputGuard", 

1066 "PIIDetector", 

1067 "ContentSafetyFilter", 

1068 "GuardChainResult", 

1069 "GuardResult", 

1070 "GuardAction", 

1071 "Severity", 

1072 "create_strict_guard", 

1073 "create_permissive_guard", 

1074 "SandboxManager", 

1075 "Sandbox", 

1076 "SafetyReport", 

1077 "RiskLevel", 

1078 "LLMSafetyAnalyzer", 

1079 # Storage (v1.2.9) 

1080 "CheckpointStore", 

1081 "SqliteStore", 

1082 # Plugin Manager (v1.2.9) 

1083 "PluginManager", 

1084 "PluginInfo", 

1085 # Cost - Token Counter (v1.2.9) 

1086 "TokenCounter", 

1087 "TokenCount", 

1088 "CostEstimate", 

1089 "ModelFamily", 

1090 # Protocols - Contracts (v1.2.9) 

1091 "AgentContract", 

1092 "AgentCapability", 

1093 "CapabilityDomain", 

1094 "QoSLevel", 

1095 "CapabilityMatcher", 

1096 "ContractRegistry", 

1097 "MatchScore", 

1098 # Memory - Compressor (v1.2.9) 

1099 "ContextCompressor", 

1100 # Tools extensions (v1.2.9) 

1101 "BaseTool", 

1102 "PermissionLevel", 

1103 "BaseToolCall", 

1104 "BaseToolResult", 

1105 "ToolRegistry", 

1106 "ToolSchema", 

1107 "FCToolCall", 

1108 "FCToolResult", 

1109 "FCToolRegistry", 

1110 "OpenAPIToolGenerator", 

1111 "GeneratedTool", 

1112 # SubAgent Manager (v1.2.9) + Parent-Child (v1.3.15) 

1113 "SubAgentManager", 

1114 "SubAgentMode", 

1115 "SubAgentSpec", 

1116 "SubAgentResult", 

1117 "ChildStatus", 

1118 "ChildHeartbeat", 

1119 "ChildInfo", 

1120 "SharedState", 

1121 "ChildContext", 

1122 "ChildHandle", 

1123 # Agent Marketplace (v1.3.0) 

1124 "AgentMarket", 

1125 "AgentSkill", 

1126 "AgentCategory", 

1127 # API Middleware (v1.3.0) 

1128 "CORSConfig", 

1129 "CORSMiddleware", 

1130 "AuthConfig", 

1131 "RequestContext", 

1132 "RequestIDMiddleware", 

1133 # API Streaming (v1.3.0) 

1134 "StreamEvent", 

1135 "StreamSession",