agent-runtime-core 0.8.0__tar.gz → 0.9.1__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 (85) hide show
  1. agent_runtime_core-0.9.1/LICENSE +83 -0
  2. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/PKG-INFO +2 -1
  3. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/README.md +1 -0
  4. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/__init__.py +65 -3
  5. agent_runtime_core-0.9.1/agent_runtime_core/agentic_loop.py +519 -0
  6. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/config.py +8 -0
  7. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/contexts.py +72 -4
  8. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/interfaces.py +29 -11
  9. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/llm/anthropic.py +161 -7
  10. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/llm/models_config.py +50 -6
  11. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/llm/openai.py +51 -2
  12. agent_runtime_core-0.9.1/agent_runtime_core/multi_agent.py +1971 -0
  13. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/persistence/__init__.py +8 -0
  14. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/persistence/base.py +318 -1
  15. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/persistence/file.py +226 -2
  16. agent_runtime_core-0.9.1/agent_runtime_core/privacy.py +250 -0
  17. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/tool_calling_agent.py +3 -1
  18. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/pyproject.toml +3 -3
  19. agent_runtime_core-0.9.1/tests/test_llm_anthropic.py +145 -0
  20. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_persistence.py +248 -0
  21. agent_runtime_core-0.9.1/tests/test_privacy.py +585 -0
  22. agent_runtime_core-0.8.0/LICENSE +0 -21
  23. agent_runtime_core-0.8.0/agent_runtime_core/agentic_loop.py +0 -254
  24. agent_runtime_core-0.8.0/agent_runtime_core/multi_agent.py +0 -569
  25. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/.gitignore +0 -0
  26. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/config_schema.py +0 -0
  27. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/events/__init__.py +0 -0
  28. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/events/base.py +0 -0
  29. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/events/memory.py +0 -0
  30. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/events/redis.py +0 -0
  31. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/events/sqlite.py +0 -0
  32. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/__init__.py +0 -0
  33. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/base.py +0 -0
  34. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/ocr.py +0 -0
  35. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/processors.py +0 -0
  36. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/tools.py +0 -0
  37. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/files/vision.py +0 -0
  38. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/json_runtime.py +0 -0
  39. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/llm/__init__.py +0 -0
  40. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/llm/litellm_client.py +0 -0
  41. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/memory/__init__.py +0 -0
  42. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/memory/manager.py +0 -0
  43. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/memory/mixin.py +0 -0
  44. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/persistence/manager.py +0 -0
  45. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/queue/__init__.py +0 -0
  46. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/queue/base.py +0 -0
  47. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/queue/memory.py +0 -0
  48. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/queue/redis.py +0 -0
  49. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/queue/sqlite.py +0 -0
  50. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/rag/__init__.py +0 -0
  51. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/rag/chunking.py +0 -0
  52. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/rag/indexer.py +0 -0
  53. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/rag/retriever.py +0 -0
  54. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/registry.py +0 -0
  55. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/runner.py +0 -0
  56. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/state/__init__.py +0 -0
  57. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/state/base.py +0 -0
  58. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/state/memory.py +0 -0
  59. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/state/redis.py +0 -0
  60. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/state/sqlite.py +0 -0
  61. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/steps.py +0 -0
  62. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/testing.py +0 -0
  63. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/tools.py +0 -0
  64. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/tracing/__init__.py +0 -0
  65. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/tracing/langfuse.py +0 -0
  66. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/tracing/noop.py +0 -0
  67. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/vectorstore/__init__.py +0 -0
  68. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/vectorstore/base.py +0 -0
  69. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/vectorstore/embeddings.py +0 -0
  70. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/vectorstore/sqlite_vec.py +0 -0
  71. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/agent_runtime_core/vectorstore/vertex.py +0 -0
  72. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/__init__.py +0 -0
  73. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_contexts.py +0 -0
  74. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_events.py +0 -0
  75. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_imports.py +0 -0
  76. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_memory.py +0 -0
  77. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_multi_agent.py +0 -0
  78. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_queue.py +0 -0
  79. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_rag.py +0 -0
  80. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_state.py +0 -0
  81. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_steps.py +0 -0
  82. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_testing.py +0 -0
  83. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_tools.py +0 -0
  84. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/tests/test_vectorstore.py +0 -0
  85. {agent_runtime_core-0.8.0 → agent_runtime_core-0.9.1}/uv.lock +0 -0
@@ -0,0 +1,83 @@
1
+ Business Source License 1.1
2
+
3
+ License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
4
+ "Business Source License" is a trademark of MariaDB Corporation Ab.
5
+
6
+ Parameters
7
+
8
+ Licensor: Chris Barry
9
+ Licensed Work: agent-runtime-core
10
+ The Licensed Work is (c) 2025 Chris Barry
11
+ Additional Use Grant: You may use the Licensed Work for non-production purposes,
12
+ including development, testing, and evaluation. Production
13
+ use requires a commercial license from the Licensor.
14
+ Change Date: 2029-01-24
15
+ Change License: MIT
16
+
17
+ Terms
18
+
19
+ The Licensor hereby grants you the right to copy, modify, create derivative
20
+ works, redistribute, and make non-production use of the Licensed Work. The
21
+ Licensor may make an Additional Use Grant, above, permitting limited production
22
+ use.
23
+
24
+ Effective on the Change Date, or the fourth anniversary of the first publicly
25
+ available distribution of a specific version of the Licensed Work under this
26
+ License, whichever comes first, the Licensor hereby grants you rights under
27
+ the terms of the Change License, and the rights granted in the paragraph above
28
+ terminate.
29
+
30
+ If your use of the Licensed Work does not comply with the requirements
31
+ currently in effect as described in this License, you must purchase a
32
+ commercial license from the Licensor, its affiliated entities, or authorized
33
+ resellers, or you must refrain from using the Licensed Work.
34
+
35
+ All copies of the original and modified Licensed Work, and derivative works
36
+ of the Licensed Work, are subject to this License. This License applies
37
+ separately for each version of the Licensed Work and the Change Date may vary
38
+ for each version of the Licensed Work released by Licensor.
39
+
40
+ You must conspicuously display this License on each original or modified copy
41
+ of the Licensed Work. If you receive the Licensed Work in original or
42
+ modified form from a third party, the terms and conditions set forth in this
43
+ License apply to your use of that work.
44
+
45
+ Any use of the Licensed Work in violation of this License will automatically
46
+ terminate your rights under this License for the current and all other
47
+ versions of the Licensed Work.
48
+
49
+ This License does not grant you any right in any trademark or logo of
50
+ Licensor or its affiliates (provided that you may use a trademark or logo of
51
+ Licensor as expressly required by this License).
52
+
53
+ TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
54
+ AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
55
+ EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
56
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
57
+ TITLE.
58
+
59
+ MariaDB hereby grants you permission to use this License's text to license
60
+ your works, and to refer to it using the trademark "Business Source License",
61
+ as long as you comply with the Covenants of Licensor below.
62
+
63
+ Covenants of Licensor
64
+
65
+ In consideration of the right to use this License's text and the "Business
66
+ Source License" name and trademark, Licensor covenants to MariaDB, and to all
67
+ other recipients of the licensed work to be provided by Licensor:
68
+
69
+ 1. To specify as the Change License the GPL Version 2.0 or any later version,
70
+ or a license that is compatible with GPL Version 2.0 or a later version,
71
+ where "compatible" means that software provided under the Change License can
72
+ be included in a program with software provided under GPL Version 2.0 or a
73
+ later version. Licensor may specify additional Change Licenses without
74
+ limitation.
75
+
76
+ 2. To either: (a) specify an additional grant of rights to use that does not
77
+ impose any additional restriction on the right granted in this License, as
78
+ the Additional Use Grant; or (b) insert the text "None".
79
+
80
+ 3. To specify a Change Date.
81
+
82
+ 4. Not to modify this License in any other way.
83
+
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agent-runtime-core
3
- Version: 0.8.0
3
+ Version: 0.9.1
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
@@ -92,6 +92,7 @@ A lightweight, framework-agnostic Python library for building AI agent systems.
92
92
 
93
93
  | Version | Date | Changes |
94
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 |
95
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 |
96
97
  | **0.7.1** | 2026-01-24 | RAG module, vector stores (sqlite-vec, Vertex AI), memory system, multi-agent support, agentic loop, JSON runtime |
97
98
  | **0.6.0** | 2025-01-23 | Enhanced registry with factory functions and class registration |
@@ -10,6 +10,7 @@ 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 |
13
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 |
14
15
  | **0.7.1** | 2026-01-24 | RAG module, vector stores (sqlite-vec, Vertex AI), memory system, multi-agent support, agentic loop, JSON runtime |
15
16
  | **0.6.0** | 2025-01-23 | Enhanced registry with factory functions and class registration |
@@ -34,7 +34,7 @@ Example usage:
34
34
  return RunResult(final_output={"message": "Hello!"})
35
35
  """
36
36
 
37
- __version__ = "0.8.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
  ]