agent-runtime-core 0.7.1__tar.gz → 0.9.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/PKG-INFO +36 -1
  2. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/README.md +2 -0
  3. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/__init__.py +65 -3
  4. agent_runtime_core-0.9.0/agent_runtime_core/agentic_loop.py +514 -0
  5. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/config.py +4 -0
  6. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/contexts.py +72 -4
  7. agent_runtime_core-0.9.0/agent_runtime_core/files/__init__.py +88 -0
  8. agent_runtime_core-0.9.0/agent_runtime_core/files/base.py +343 -0
  9. agent_runtime_core-0.9.0/agent_runtime_core/files/ocr.py +406 -0
  10. agent_runtime_core-0.9.0/agent_runtime_core/files/processors.py +508 -0
  11. agent_runtime_core-0.9.0/agent_runtime_core/files/tools.py +317 -0
  12. agent_runtime_core-0.9.0/agent_runtime_core/files/vision.py +360 -0
  13. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/llm/anthropic.py +83 -0
  14. agent_runtime_core-0.9.0/agent_runtime_core/multi_agent.py +1961 -0
  15. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/persistence/__init__.py +8 -0
  16. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/persistence/base.py +318 -1
  17. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/persistence/file.py +226 -2
  18. agent_runtime_core-0.9.0/agent_runtime_core/privacy.py +250 -0
  19. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/pyproject.toml +39 -1
  20. agent_runtime_core-0.9.0/tests/test_llm_anthropic.py +145 -0
  21. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_persistence.py +248 -0
  22. agent_runtime_core-0.9.0/tests/test_privacy.py +585 -0
  23. agent_runtime_core-0.7.1/agent_runtime_core/agentic_loop.py +0 -254
  24. agent_runtime_core-0.7.1/agent_runtime_core/multi_agent.py +0 -569
  25. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/.gitignore +0 -0
  26. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/LICENSE +0 -0
  27. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/config_schema.py +0 -0
  28. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/events/__init__.py +0 -0
  29. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/events/base.py +0 -0
  30. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/events/memory.py +0 -0
  31. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/events/redis.py +0 -0
  32. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/events/sqlite.py +0 -0
  33. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/interfaces.py +0 -0
  34. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/json_runtime.py +0 -0
  35. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/llm/__init__.py +0 -0
  36. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/llm/litellm_client.py +0 -0
  37. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/llm/models_config.py +0 -0
  38. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/llm/openai.py +0 -0
  39. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/memory/__init__.py +0 -0
  40. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/memory/manager.py +0 -0
  41. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/memory/mixin.py +0 -0
  42. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/persistence/manager.py +0 -0
  43. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/queue/__init__.py +0 -0
  44. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/queue/base.py +0 -0
  45. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/queue/memory.py +0 -0
  46. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/queue/redis.py +0 -0
  47. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/queue/sqlite.py +0 -0
  48. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/rag/__init__.py +0 -0
  49. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/rag/chunking.py +0 -0
  50. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/rag/indexer.py +0 -0
  51. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/rag/retriever.py +0 -0
  52. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/registry.py +0 -0
  53. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/runner.py +0 -0
  54. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/state/__init__.py +0 -0
  55. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/state/base.py +0 -0
  56. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/state/memory.py +0 -0
  57. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/state/redis.py +0 -0
  58. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/state/sqlite.py +0 -0
  59. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/steps.py +0 -0
  60. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/testing.py +0 -0
  61. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/tool_calling_agent.py +0 -0
  62. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/tools.py +0 -0
  63. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/tracing/__init__.py +0 -0
  64. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/tracing/langfuse.py +0 -0
  65. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/tracing/noop.py +0 -0
  66. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/vectorstore/__init__.py +0 -0
  67. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/vectorstore/base.py +0 -0
  68. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/vectorstore/embeddings.py +0 -0
  69. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/vectorstore/sqlite_vec.py +0 -0
  70. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/agent_runtime_core/vectorstore/vertex.py +0 -0
  71. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/__init__.py +0 -0
  72. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_contexts.py +0 -0
  73. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_events.py +0 -0
  74. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_imports.py +0 -0
  75. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_memory.py +0 -0
  76. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_multi_agent.py +0 -0
  77. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_queue.py +0 -0
  78. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_rag.py +0 -0
  79. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_state.py +0 -0
  80. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_steps.py +0 -0
  81. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_testing.py +0 -0
  82. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_tools.py +0 -0
  83. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/tests/test_vectorstore.py +0 -0
  84. {agent_runtime_core-0.7.1 → agent_runtime_core-0.9.0}/uv.lock +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agent-runtime-core
3
- Version: 0.7.1
3
+ Version: 0.9.0
4
4
  Summary: Framework-agnostic Python library for executing AI agents with consistent patterns
5
5
  Project-URL: Homepage, https://github.com/makemore/agent-runtime-core
6
6
  Project-URL: Repository, https://github.com/makemore/agent-runtime-core
@@ -19,10 +19,19 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
19
19
  Requires-Python: >=3.11
20
20
  Provides-Extra: all
21
21
  Requires-Dist: anthropic>=0.18.0; extra == 'all'
22
+ Requires-Dist: azure-ai-formrecognizer>=3.3.0; extra == 'all'
23
+ Requires-Dist: boto3>=1.34.0; extra == 'all'
22
24
  Requires-Dist: google-cloud-aiplatform>=1.38.0; extra == 'all'
25
+ Requires-Dist: google-cloud-vision>=3.0.0; extra == 'all'
26
+ Requires-Dist: google-generativeai>=0.4.0; extra == 'all'
23
27
  Requires-Dist: langfuse>=2.0.0; extra == 'all'
24
28
  Requires-Dist: litellm>=1.0.0; extra == 'all'
25
29
  Requires-Dist: openai>=1.0.0; extra == 'all'
30
+ Requires-Dist: openpyxl>=3.1.0; extra == 'all'
31
+ Requires-Dist: pillow>=10.0.0; extra == 'all'
32
+ Requires-Dist: pypdf>=4.0.0; extra == 'all'
33
+ Requires-Dist: pytesseract>=0.3.10; extra == 'all'
34
+ Requires-Dist: python-docx>=1.0.0; extra == 'all'
26
35
  Requires-Dist: redis>=5.0.0; extra == 'all'
27
36
  Requires-Dist: sqlite-vec>=0.1.0; extra == 'all'
28
37
  Provides-Extra: anthropic
@@ -33,10 +42,30 @@ Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
33
42
  Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
34
43
  Requires-Dist: pytest>=8.0.0; extra == 'dev'
35
44
  Requires-Dist: ruff>=0.1.0; extra == 'dev'
45
+ Provides-Extra: files
46
+ Requires-Dist: openpyxl>=3.1.0; extra == 'files'
47
+ Requires-Dist: pillow>=10.0.0; extra == 'files'
48
+ Requires-Dist: pypdf>=4.0.0; extra == 'files'
49
+ Requires-Dist: python-docx>=1.0.0; extra == 'files'
50
+ Provides-Extra: files-all
51
+ Requires-Dist: azure-ai-formrecognizer>=3.3.0; extra == 'files-all'
52
+ Requires-Dist: boto3>=1.34.0; extra == 'files-all'
53
+ Requires-Dist: google-cloud-vision>=3.0.0; extra == 'files-all'
54
+ Requires-Dist: google-generativeai>=0.4.0; extra == 'files-all'
55
+ Requires-Dist: openpyxl>=3.1.0; extra == 'files-all'
56
+ Requires-Dist: pillow>=10.0.0; extra == 'files-all'
57
+ Requires-Dist: pypdf>=4.0.0; extra == 'files-all'
58
+ Requires-Dist: pytesseract>=0.3.10; extra == 'files-all'
59
+ Requires-Dist: python-docx>=1.0.0; extra == 'files-all'
36
60
  Provides-Extra: langfuse
37
61
  Requires-Dist: langfuse>=2.0.0; extra == 'langfuse'
38
62
  Provides-Extra: litellm
39
63
  Requires-Dist: litellm>=1.0.0; extra == 'litellm'
64
+ Provides-Extra: ocr
65
+ Requires-Dist: azure-ai-formrecognizer>=3.3.0; extra == 'ocr'
66
+ Requires-Dist: boto3>=1.34.0; extra == 'ocr'
67
+ Requires-Dist: google-cloud-vision>=3.0.0; extra == 'ocr'
68
+ Requires-Dist: pytesseract>=0.3.10; extra == 'ocr'
40
69
  Provides-Extra: openai
41
70
  Requires-Dist: openai>=1.0.0; extra == 'openai'
42
71
  Provides-Extra: redis
@@ -45,6 +74,10 @@ Provides-Extra: sqlite-vec
45
74
  Requires-Dist: sqlite-vec>=0.1.0; extra == 'sqlite-vec'
46
75
  Provides-Extra: vertex
47
76
  Requires-Dist: google-cloud-aiplatform>=1.38.0; extra == 'vertex'
77
+ Provides-Extra: vision
78
+ Requires-Dist: anthropic>=0.18.0; extra == 'vision'
79
+ Requires-Dist: google-generativeai>=0.4.0; extra == 'vision'
80
+ Requires-Dist: openai>=1.0.0; extra == 'vision'
48
81
  Description-Content-Type: text/markdown
49
82
 
50
83
  # agent-runtime-core
@@ -59,6 +92,8 @@ A lightweight, framework-agnostic Python library for building AI agent systems.
59
92
 
60
93
  | Version | Date | Changes |
61
94
  |---------|------|---------|
95
+ | **0.9.0** | 2026-01-28 | **Multi-Agent & Debug** - Shared memory with privacy controls, journey mode, structured handback protocol, stuck/loop detection, fallback routing, cost/context tracking in debug mode |
96
+ | **0.8.0** | 2026-01-28 | **File Ingestion** - Pluggable file processors (PDF, images, DOCX, XLSX, CSV), OCR providers (Tesseract, Google Vision, AWS Textract, Azure), AI vision (OpenAI, Anthropic, Gemini), file read/write tools |
62
97
  | **0.7.1** | 2026-01-24 | RAG module, vector stores (sqlite-vec, Vertex AI), memory system, multi-agent support, agentic loop, JSON runtime |
63
98
  | **0.6.0** | 2025-01-23 | Enhanced registry with factory functions and class registration |
64
99
  | **0.5.2** | 2025-01-14 | Add ToolCallingAgent base class, execute_with_events helper |
@@ -10,6 +10,8 @@ A lightweight, framework-agnostic Python library for building AI agent systems.
10
10
 
11
11
  | Version | Date | Changes |
12
12
  |---------|------|---------|
13
+ | **0.9.0** | 2026-01-28 | **Multi-Agent & Debug** - Shared memory with privacy controls, journey mode, structured handback protocol, stuck/loop detection, fallback routing, cost/context tracking in debug mode |
14
+ | **0.8.0** | 2026-01-28 | **File Ingestion** - Pluggable file processors (PDF, images, DOCX, XLSX, CSV), OCR providers (Tesseract, Google Vision, AWS Textract, Azure), AI vision (OpenAI, Anthropic, Gemini), file read/write tools |
13
15
  | **0.7.1** | 2026-01-24 | RAG module, vector stores (sqlite-vec, Vertex AI), memory system, multi-agent support, agentic loop, JSON runtime |
14
16
  | **0.6.0** | 2025-01-23 | Enhanced registry with factory functions and class registration |
15
17
  | **0.5.2** | 2025-01-14 | Add ToolCallingAgent base class, execute_with_events helper |
@@ -34,7 +34,7 @@ Example usage:
34
34
  return RunResult(final_output={"message": "Hello!"})
35
35
  """
36
36
 
37
- __version__ = "0.7.0"
37
+ __version__ = "0.9.0"
38
38
 
39
39
  # Core interfaces
40
40
  from agent_runtime_core.interfaces import (
@@ -63,6 +63,7 @@ from agent_runtime_core.tool_calling_agent import ToolCallingAgent
63
63
  from agent_runtime_core.agentic_loop import (
64
64
  run_agentic_loop,
65
65
  AgenticLoopResult,
66
+ UsageStats,
66
67
  )
67
68
 
68
69
  # Configuration
@@ -187,17 +188,49 @@ from agent_runtime_core.tools import (
187
188
  schemas_to_openai_format,
188
189
  )
189
190
 
190
- # Multi-agent support (agent-as-tool pattern)
191
+ # Multi-agent support (agent-as-tool pattern, system context)
191
192
  from agent_runtime_core.multi_agent import (
193
+ # System context for shared knowledge
194
+ SystemContext,
195
+ SharedKnowledge,
196
+ SharedMemoryConfig,
197
+ InjectMode,
198
+ # Agent-as-tool pattern
192
199
  AgentTool,
193
200
  AgentInvocationResult,
194
201
  InvocationMode,
195
202
  ContextMode,
196
203
  SubAgentContext,
197
204
  invoke_agent,
205
+ invoke_agent_with_fallback,
198
206
  create_agent_tool_handler,
199
207
  register_agent_tools,
200
208
  build_sub_agent_messages,
209
+ # Structured Handback Protocol
210
+ HandbackStatus,
211
+ HandbackResult,
212
+ Learning,
213
+ # Stuck/Loop Detection
214
+ StuckCondition,
215
+ StuckDetectionResult,
216
+ StuckDetector,
217
+ # Journey Mode
218
+ JourneyState,
219
+ JourneyEndReason,
220
+ JourneyEndResult,
221
+ JourneyManager,
222
+ JOURNEY_STATE_KEY,
223
+ # Fallback Routing
224
+ FallbackConfig,
225
+ )
226
+
227
+ # Privacy and user isolation
228
+ from agent_runtime_core.privacy import (
229
+ PrivacyConfig,
230
+ UserContext,
231
+ MemoryScope,
232
+ DEFAULT_PRIVACY_CONFIG,
233
+ ANONYMOUS_USER,
201
234
  )
202
235
 
203
236
  # Cross-conversation memory
@@ -230,6 +263,7 @@ __all__ = [
230
263
  "ToolCallingAgent",
231
264
  "run_agentic_loop",
232
265
  "AgenticLoopResult",
266
+ "UsageStats",
233
267
  # Configuration
234
268
  "RuntimeConfig",
235
269
  "configure",
@@ -306,14 +340,42 @@ __all__ = [
306
340
  "ToolSchemaBuilder",
307
341
  "ToolParameter",
308
342
  "schemas_to_openai_format",
309
- # Multi-agent support
343
+ # Multi-agent support - System context
344
+ "SystemContext",
345
+ "SharedKnowledge",
346
+ "SharedMemoryConfig",
347
+ "InjectMode",
348
+ # Multi-agent support - Agent-as-tool
310
349
  "AgentTool",
311
350
  "AgentInvocationResult",
312
351
  "InvocationMode",
313
352
  "ContextMode",
314
353
  "SubAgentContext",
315
354
  "invoke_agent",
355
+ "invoke_agent_with_fallback",
316
356
  "create_agent_tool_handler",
317
357
  "register_agent_tools",
318
358
  "build_sub_agent_messages",
359
+ # Multi-agent support - Structured Handback Protocol
360
+ "HandbackStatus",
361
+ "HandbackResult",
362
+ "Learning",
363
+ # Multi-agent support - Stuck/Loop Detection
364
+ "StuckCondition",
365
+ "StuckDetectionResult",
366
+ "StuckDetector",
367
+ # Multi-agent support - Journey Mode
368
+ "JourneyState",
369
+ "JourneyEndReason",
370
+ "JourneyEndResult",
371
+ "JourneyManager",
372
+ "JOURNEY_STATE_KEY",
373
+ # Multi-agent support - Fallback Routing
374
+ "FallbackConfig",
375
+ # Privacy and user isolation
376
+ "PrivacyConfig",
377
+ "UserContext",
378
+ "MemoryScope",
379
+ "DEFAULT_PRIVACY_CONFIG",
380
+ "ANONYMOUS_USER",
319
381
  ]