swarmauri-core 0.10.1.dev3__tar.gz → 0.11.0.dev2__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 (233) hide show
  1. swarmauri_core-0.11.0.dev2/PKG-INFO +201 -0
  2. swarmauri_core-0.11.0.dev2/README.md +172 -0
  3. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/pyproject.toml +26 -9
  4. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/__init__.py +2 -1
  5. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agent_apis/IAgentCommands.py +2 -1
  6. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agent_apis/IAgentRouterCRUD.py +6 -3
  7. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agent_factories/IExportConf.py +8 -4
  8. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgent.py +9 -4
  9. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOAuth20Login.py +5 -2
  10. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOAuth21Login.py +5 -2
  11. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOIDC10Login.py +2 -1
  12. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IOnlinePayments.py +3 -1
  13. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IPaymentMethods.py +8 -2
  14. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IProductsPrices.py +6 -1
  15. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IRefunds.py +5 -1
  16. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/enums.py +15 -6
  17. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/protos.py +19 -7
  18. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/certs/ICertService.py +8 -4
  19. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChain.py +50 -25
  20. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChainDependencyResolver.py +5 -3
  21. swarmauri_core-0.11.0.dev2/swarmauri_core/chains/__init__.py +3 -0
  22. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chunkers/IChunker.py +4 -2
  23. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/cipher_suites/ICipherSuite.py +6 -2
  24. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/cipher_suites/types.py +4 -5
  25. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/conversations/IConversation.py +2 -1
  26. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/crypto/ICrypto.py +22 -11
  27. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/crypto/types.py +6 -2
  28. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/distances/IDistanceSimilarity.py +23 -6
  29. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/document_stores/IDocumentRetrieve.py +4 -2
  30. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/document_stores/IDocumentStore.py +7 -3
  31. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/documents/IExperimentDocument.py +10 -5
  32. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/embeddings/IVectorize.py +2 -1
  33. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/ensembles/IEnsemble.py +3 -1
  34. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluator_pools/IEvaluatorPool.py +22 -10
  35. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluators/IEvaluate.py +15 -7
  36. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/image_gens/IGenImage.py +2 -1
  37. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/inner_products/IInnerProduct.py +7 -5
  38. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/key_providers/IKeyProvider.py +13 -5
  39. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/llms/IPredict.py +2 -1
  40. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/logger_formatters/IFormatter.py +2 -1
  41. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/matrices/IMatrix.py +7 -3
  42. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/measurements/IMeasurementAggregate.py +4 -2
  43. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/measurements/IMeasurementCalculate.py +11 -5
  44. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/metrics/IMetric.py +7 -5
  45. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/middlewares/IMiddleware.py +14 -3
  46. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/mre_crypto/IMreCrypto.py +44 -22
  47. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/norms/INorm.py +43 -17
  48. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/norms/IUseInnerProduct.py +2 -1
  49. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/ocrs/IPredict.py +2 -1
  50. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/parsers/IParser.py +7 -5
  51. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pop/ipop.py +2 -1
  52. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompt_templates/IPromptTemplate.py +18 -9
  53. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompts/IPrompt.py +4 -2
  54. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompts/IPromptMatrix.py +2 -1
  55. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompts/ITemplate.py +16 -8
  56. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pseudometrics/IPseudometric.py +16 -7
  57. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/rate_limits/IRateLimit.py +3 -1
  58. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/schema_converters/ISchemaConvert.py +3 -1
  59. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/seminorms/ISeminorm.py +8 -4
  60. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/signing/ISigning.py +43 -21
  61. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/similarities/ISimilarity.py +8 -4
  62. swarmauri_core-0.11.0.dev2/swarmauri_core/skills/ISkill.py +14 -0
  63. swarmauri_core-0.11.0.dev2/swarmauri_core/skills/__init__.py +3 -0
  64. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/sst/IPredict.py +2 -1
  65. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/storage/IStorageAdapter.py +55 -5
  66. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/swarm_apis/IAgentRegistrationAPI.py +10 -5
  67. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/swarm_apis/ISwarmAPI.py +2 -1
  68. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/task_mgmt_strategies/ITaskMgmtStrategy.py +4 -1
  69. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tensors/ITensor.py +8 -3
  70. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tokens/ITokenService.py +6 -3
  71. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tool_llms/IToolPredict.py +5 -2
  72. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/toolkits/IToolkit.py +10 -5
  73. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tracing/IChainTracer.py +4 -2
  74. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tracing/ITraceContext.py +2 -1
  75. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tracing/ITracer.py +15 -7
  76. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/ITransport.py +3 -1
  77. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/__init__.py +8 -1
  78. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/capabilities.py +8 -1
  79. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_anycast.py +10 -3
  80. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_broadcast.py +3 -1
  81. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_http_client.py +3 -1
  82. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_multicast.py +5 -1
  83. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_multiplex.py +5 -1
  84. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_runnable.py +5 -2
  85. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tts/IPredict.py +2 -1
  86. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/utils/ITransactional.py +4 -2
  87. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/ICloudVectorStore.py +2 -1
  88. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/IPersistentVectorStore.py +4 -2
  89. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/ISimilarity.py +8 -4
  90. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/IVectorNorm.py +6 -3
  91. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/IVectorStore.py +7 -3
  92. swarmauri_core-0.11.0.dev2/swarmauri_core/vector_stores/IVectorStoreComparator.py +26 -0
  93. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/IVectorStoreRetrieve.py +4 -2
  94. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vector_stores/IVectorStoreSaveLoad.py +15 -7
  95. swarmauri_core-0.11.0.dev2/swarmauri_core/vector_stores/__init__.py +7 -0
  96. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vectors/IVector.py +2 -1
  97. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vectors/IVectorMeta.py +8 -4
  98. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vectors/IVectorProduct.py +11 -3
  99. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vectors/IVectorTransform.py +2 -1
  100. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/vlms/IPredictVision.py +2 -1
  101. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/xmp/IEmbedXMP.py +2 -1
  102. swarmauri_core-0.10.1.dev3/PKG-INFO +0 -197
  103. swarmauri_core-0.10.1.dev3/README.md +0 -174
  104. swarmauri_core-0.10.1.dev3/swarmauri_core/chains/__init__.py +0 -1
  105. swarmauri_core-0.10.1.dev3/swarmauri_core/vlms/__init__.py +0 -0
  106. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/LICENSE +0 -0
  107. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agent_apis/__init__.py +0 -0
  108. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agent_factories/__init__.py +0 -0
  109. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentConversation.py +0 -0
  110. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentParser.py +0 -0
  111. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentRetrieve.py +0 -0
  112. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentSystemContext.py +0 -0
  113. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentToolkit.py +0 -0
  114. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/IAgentVectorStore.py +0 -0
  115. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/agents/__init__.py +0 -0
  116. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOAuth20AppClient.py +0 -0
  117. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOAuth21AppClient.py +0 -0
  118. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/IOIDC10AppClient.py +0 -0
  119. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/auth_idp/__init__.py +0 -0
  120. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IBalanceTransfers.py +0 -0
  121. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IBillingProvider.py +0 -0
  122. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/ICustomers.py +0 -0
  123. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IHostedCheckout.py +0 -0
  124. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IInvoicing.py +0 -0
  125. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IMarketplace.py +0 -0
  126. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IPayouts.py +0 -0
  127. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IPromotions.py +0 -0
  128. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IReports.py +0 -0
  129. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IRisk.py +0 -0
  130. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/ISubscriptions.py +0 -0
  131. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/IWebhooks.py +0 -0
  132. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/billing/__init__.py +0 -0
  133. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/certs/__init__.py +0 -0
  134. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/ICallableChain.py +0 -0
  135. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChainContext.py +0 -0
  136. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChainContextLoader.py +0 -0
  137. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChainFactory.py +0 -0
  138. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chains/IChainStep.py +0 -0
  139. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/chunkers/__init__.py +0 -0
  140. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/cipher_suites/__init__.py +0 -0
  141. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/conversations/IMaxSize.py +0 -0
  142. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/conversations/ISystemContext.py +0 -0
  143. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/conversations/__init__.py +0 -0
  144. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/crypto/__init__.py +0 -0
  145. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/dataconnectors/IDataConnector.py +0 -0
  146. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/dataconnectors/__init__.py +0 -0
  147. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/distances/__init__.py +0 -0
  148. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/document_stores/__init__.py +0 -0
  149. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/documents/IDocument.py +0 -0
  150. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/documents/__init__.py +0 -0
  151. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/embeddings/IFeature.py +0 -0
  152. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/embeddings/ISaveModel.py +0 -0
  153. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/embeddings/__init__.py +0 -0
  154. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/ensembles/__init__.py +0 -0
  155. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluator_pools/__init__.py +0 -0
  156. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluator_results/IEvalResult.py +0 -0
  157. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluator_results/__init__.py +0 -0
  158. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/evaluators/__init__.py +0 -0
  159. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/factories/IFactory.py +0 -0
  160. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/factories/__init__.py +0 -0
  161. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/git_filters/IGitFilter.py +0 -0
  162. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/git_filters/__init__.py +0 -0
  163. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/image_gens/__init__.py +0 -0
  164. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/inner_products/__init__.py +0 -0
  165. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/key_providers/__init__.py +0 -0
  166. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/key_providers/types.py +0 -0
  167. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/keys.py +0 -0
  168. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/llms/IFit.py +0 -0
  169. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/llms/__init__.py +0 -0
  170. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/logger_formatters/__init__.py +0 -0
  171. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/logger_handlers/IHandler.py +0 -0
  172. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/logger_handlers/__init__.py +0 -0
  173. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/loggers/ILogger.py +0 -0
  174. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/loggers/__init__.py +0 -0
  175. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/matrices/__init__.py +0 -0
  176. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/measurements/IMeasurement.py +0 -0
  177. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/measurements/IThreshold.py +0 -0
  178. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/measurements/__init__.py +0 -0
  179. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/messages/IMessage.py +0 -0
  180. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/messages/__init__.py +0 -0
  181. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/metrics/__init__.py +0 -0
  182. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/middlewares/__init__.py +0 -0
  183. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/mre_crypto/__init__.py +0 -0
  184. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/mre_crypto/types.py +0 -0
  185. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/norms/__init__.py +0 -0
  186. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/ocrs/__init__.py +0 -0
  187. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/parsers/__init__.py +0 -0
  188. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pipelines/IPipeline.py +0 -0
  189. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pipelines/__init__.py +0 -0
  190. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pop/__init__.py +0 -0
  191. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pop/isigner.py +0 -0
  192. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pop/types.py +0 -0
  193. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/programs/IProgram.py +0 -0
  194. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/programs/__init__.py +0 -0
  195. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompt_templates/__init__.py +0 -0
  196. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/prompts/__init__.py +0 -0
  197. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/pseudometrics/__init__.py +0 -0
  198. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/publishers/IPublish.py +0 -0
  199. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/publishers/__init__.py +0 -0
  200. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/rate_limits/__init__.py +0 -0
  201. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/schema_converters/__init__.py +0 -0
  202. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/seminorms/__init__.py +0 -0
  203. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/service_registries/IServiceRegistry.py +0 -0
  204. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/service_registries/__init__.py +0 -0
  205. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/signing/__init__.py +0 -0
  206. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/signing/intent.py +0 -0
  207. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/signing/types.py +0 -0
  208. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/similarities/__init__.py +0 -0
  209. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/sst/__init__.py +0 -0
  210. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/state/IState.py +0 -0
  211. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/state/__init__.py +0 -0
  212. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/storage/__init__.py +0 -0
  213. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/swarm_apis/__init__.py +0 -0
  214. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/swarms/ISwarm.py +0 -0
  215. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/swarms/__init__.py +0 -0
  216. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/task_mgmt_strategies/__init__.py +0 -0
  217. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tensors/__init__.py +0 -0
  218. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tokens/__init__.py +0 -0
  219. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tool_llms/__init__.py +0 -0
  220. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/toolkits/__init__.py +0 -0
  221. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tools/IParameter.py +0 -0
  222. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tools/ITool.py +0 -0
  223. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tools/__init__.py +0 -0
  224. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tracing/__init__.py +0 -0
  225. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/enums.py +0 -0
  226. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_appserver.py +0 -0
  227. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_peer.py +0 -0
  228. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/transports/i_unicast.py +0 -0
  229. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/tts/__init__.py +0 -0
  230. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/utils/__init__.py +0 -0
  231. {swarmauri_core-0.10.1.dev3/swarmauri_core/vector_stores → swarmauri_core-0.11.0.dev2/swarmauri_core/vectors}/__init__.py +0 -0
  232. {swarmauri_core-0.10.1.dev3/swarmauri_core/vectors → swarmauri_core-0.11.0.dev2/swarmauri_core/vlms}/__init__.py +0 -0
  233. {swarmauri_core-0.10.1.dev3 → swarmauri_core-0.11.0.dev2}/swarmauri_core/xmp/__init__.py +0 -0
@@ -0,0 +1,201 @@
1
+ Metadata-Version: 2.4
2
+ Name: swarmauri_core
3
+ Version: 0.11.0.dev2
4
+ Summary: Core interface contracts and shared types for Swarmauri composable intelligence infrastructure components.
5
+ License-Expression: Apache-2.0
6
+ License-File: LICENSE
7
+ Keywords: swarmauri,interfaces,abstract-base-classes,ai-sdk,component-contracts,composable-intelligence,agents,llms,tools,vector-stores,crypto,signing,key-providers,transports,middleware
8
+ Author: Jacob Stewart
9
+ Author-email: jacob@swarmauri.com
10
+ Requires-Python: >=3.10,<3.15
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: Apache Software License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3 :: Only
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Programming Language :: Python :: 3.14
23
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
24
+ Classifier: Topic :: Software Development :: Libraries
25
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
26
+ Classifier: Topic :: Software Development :: Testing
27
+ Description-Content-Type: text/markdown
28
+
29
+ ![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
30
+
31
+ <p align="center">
32
+ <a href="https://pepy.tech/project/swarmauri_core/">
33
+ <img src="https://static.pepy.tech/badge/swarmauri_core/month" alt="PyPI - Downloads"/></a>
34
+ <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/core/">
35
+ <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/core.svg"/></a>
36
+ <a href="https://pypi.org/project/swarmauri_core/">
37
+ <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
38
+ <a href="https://pypi.org/project/swarmauri_core/">
39
+ <img src="https://img.shields.io/pypi/l/swarmauri_core" alt="PyPI - License"/></a>
40
+ <a href="https://pypi.org/project/swarmauri_core/">
41
+ <img src="https://img.shields.io/pypi/v/swarmauri_core?label=swarmauri_core&color=green" alt="PyPI - swarmauri_core"/></a>
42
+ <a href="https://discord.gg/N4UpBuQv8T">
43
+ <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
44
+
45
+ # Swarmauri Core
46
+
47
+ `swarmauri_core` provides the interface contracts for the Swarmauri SDK. It is the package component authors use when they need stable abstract interfaces for agents, tools, LLMs, parsers, vector stores, cryptography, signing, key providers, transports, middleware, billing, storage, XMP, and other composable intelligence infrastructure components.
48
+
49
+ ## Why Swarmauri Core?
50
+
51
+ `swarmauri_core` keeps component contracts separate from implementations. Package authors can depend on stable interfaces without pulling in every base class, provider adapter, model package, or runtime integration.
52
+
53
+ ## FAQ
54
+
55
+ ### Q: What belongs in `swarmauri_core`?
56
+
57
+ A: Interface contracts, protocol shapes, enums, and shared types for Swarmauri component families.
58
+
59
+ ### Q: Should application developers instantiate classes from this package?
60
+
61
+ A: Usually no. Most application code uses concrete implementations from `swarmauri_standard`, community packages, or provider-specific packages. Component authors use `swarmauri_core` to implement the correct contract.
62
+
63
+ ### Q: How does this package relate to `swarmauri_base`?
64
+
65
+ A: `swarmauri_core` defines interfaces. `swarmauri_base` implements reusable base classes and serialization behavior on top of those interfaces.
66
+
67
+ ## What Is Included?
68
+
69
+ The package is intentionally implementation-light. It defines contracts, protocol shapes, enums, and shared types so implementation packages can interoperate without depending on each other directly.
70
+
71
+ Major interface families include:
72
+
73
+ - Agents and agent APIs: `IAgent`, conversation, parser, retrieval, toolkit, and vector-store agent mixins.
74
+ - LLM and multimodal prediction: text LLMs, tool LLMs, OCR, STT, TTS, and VLM interfaces.
75
+ - Documents and parsing: document contracts, parser contracts, chunkers, conversations, prompts, and prompt templates.
76
+ - Retrieval and vectors: vector, matrix, tensor, metric, similarity, vector-store comparator, deprecated distance compatibility contracts, vector store, and document store contracts.
77
+ - Security and trust: crypto, MRE crypto, cipher suites, signing, proof-of-possession, token services, key providers, certificates, and XMP embedding.
78
+ - Runtime infrastructure: middleware, transports, storage adapters, publishers, rate limits, tracing, state, service registries, and pipelines.
79
+ - Business systems: billing provider interfaces for customers, payments, invoices, subscriptions, refunds, payouts, risk, reporting, webhooks, and marketplace flows.
80
+
81
+ ## Features
82
+
83
+ - Stable abstract interfaces for Swarmauri component packages.
84
+ - Shared types for crypto, signing, key management, transports, billing, and proof-of-possession workflows.
85
+ - Zero runtime dependencies.
86
+ - Interface-first design for packages that later inherit reusable behavior from `swarmauri_base`.
87
+ - Python 3.10, 3.11, 3.12, 3.13, and 3.14 support.
88
+
89
+ ## Installation
90
+
91
+ Install with `uv`:
92
+
93
+ ```bash
94
+ uv add swarmauri_core
95
+ ```
96
+
97
+ Install with `pip`:
98
+
99
+ ```bash
100
+ pip install swarmauri_core
101
+ ```
102
+
103
+ ## Usage
104
+
105
+ Use `swarmauri_core` when defining a new implementation package or validating that a class satisfies a public Swarmauri contract.
106
+
107
+ ```python
108
+ import asyncio
109
+ from typing import Any, Optional
110
+
111
+ from swarmauri_core.agents.IAgent import IAgent
112
+ from swarmauri_core.messages.IMessage import IMessage
113
+
114
+
115
+ class MinimalAgent(IAgent):
116
+ def exec(
117
+ self,
118
+ input_data: Optional[Any] = None,
119
+ llm_kwargs: Optional[dict] = None,
120
+ ) -> Any:
121
+ return {"input": input_data, "kwargs": llm_kwargs or {}}
122
+
123
+ async def aexec(
124
+ self,
125
+ input_str: Optional[str | IMessage] = "",
126
+ llm_kwargs: Optional[dict] = None,
127
+ ) -> Any:
128
+ return self.exec(input_str, llm_kwargs)
129
+
130
+ def batch(
131
+ self,
132
+ inputs: list[str | IMessage],
133
+ llm_kwargs: Optional[dict] = None,
134
+ ) -> list[Any]:
135
+ return [self.exec(item, llm_kwargs) for item in inputs]
136
+
137
+ async def abatch(
138
+ self,
139
+ inputs: list[str | IMessage],
140
+ llm_kwargs: Optional[dict] = None,
141
+ ) -> list[Any]:
142
+ return await asyncio.gather(
143
+ *(self.aexec(item, llm_kwargs) for item in inputs)
144
+ )
145
+ ```
146
+
147
+ Implement a parser contract:
148
+
149
+ ```python
150
+ from pathlib import Path
151
+
152
+ from swarmauri_core.documents.IDocument import IDocument
153
+ from swarmauri_core.parsers.IParser import IParser
154
+
155
+
156
+ class PlainTextParser(IParser):
157
+ def parse(self, data: str | bytes | Path) -> list[IDocument]:
158
+ raise NotImplementedError("Return concrete Document instances here.")
159
+ ```
160
+
161
+ Implement a storage or retrieval contract in a concrete package, then expose the class through `swarmauri_base` and the public `swarmauri` namespace when appropriate.
162
+
163
+ ## Component Author Workflow
164
+
165
+ 1. Choose the closest interface from `swarmauri_core`.
166
+ 2. Implement domain behavior in a package-specific class.
167
+ 3. Add reusable serialization and registration behavior with `swarmauri_base` when the implementation should become a Swarmauri component.
168
+ 4. Publish or register the implementation package through the appropriate `swarmauri.<kind>` entry point or namespace mapping.
169
+ 5. Document installation and usage in the implementation package README.
170
+
171
+ ## Related Packages
172
+
173
+ Foundational packages:
174
+
175
+ - [swarmauri](https://pypi.org/project/swarmauri/) provides the namespace importer and plugin discovery layer.
176
+ - [swarmauri_base](https://pypi.org/project/swarmauri_base/) provides reusable base classes built on these interfaces.
177
+ - [swarmauri_standard](https://pypi.org/project/swarmauri_standard/) provides first-party implementations for common component kinds.
178
+
179
+ Packages built around specific core component kinds:
180
+
181
+ - [swarmauri_signing_ed25519](https://pypi.org/project/swarmauri_signing_ed25519/) implements signing interfaces.
182
+ - [swarmauri_crypto_composite](https://pypi.org/project/swarmauri_crypto_composite/) composes crypto providers behind the crypto interface.
183
+ - [swarmauri_keyprovider_inmemory](https://pypi.org/project/swarmauri_keyprovider_inmemory/) implements key provider contracts.
184
+ - [swarmauri_transport_stdio](https://pypi.org/project/swarmauri_transport_stdio/) implements transport contracts.
185
+ - [swarmauri_storage_memory](https://pypi.org/project/swarmauri_storage_memory/) implements storage adapter contracts.
186
+ - [swarmauri_middleware_jsonrpc](https://pypi.org/project/swarmauri_middleware_jsonrpc/) implements middleware contracts.
187
+
188
+ ## When To Use This Package
189
+
190
+ Use `swarmauri_core` when you are designing or implementing a Swarmauri-compatible component and need the interface contract. Use `swarmauri_base` when you also need reusable base-class behavior, serialization helpers, and component registration. Use `swarmauri_standard` when you want ready-to-use implementations.
191
+
192
+ ## License
193
+
194
+ Apache-2.0
195
+
196
+ ## Contributing
197
+
198
+ When adding or changing a core interface, keep the contract narrow, update downstream base classes where needed, add focused tests, and follow the [Swarmauri SDK contribution guide](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md).
199
+
200
+
201
+
@@ -0,0 +1,172 @@
1
+ ![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
2
+
3
+ <p align="center">
4
+ <a href="https://pepy.tech/project/swarmauri_core/">
5
+ <img src="https://static.pepy.tech/badge/swarmauri_core/month" alt="PyPI - Downloads"/></a>
6
+ <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/core/">
7
+ <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/core.svg"/></a>
8
+ <a href="https://pypi.org/project/swarmauri_core/">
9
+ <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
10
+ <a href="https://pypi.org/project/swarmauri_core/">
11
+ <img src="https://img.shields.io/pypi/l/swarmauri_core" alt="PyPI - License"/></a>
12
+ <a href="https://pypi.org/project/swarmauri_core/">
13
+ <img src="https://img.shields.io/pypi/v/swarmauri_core?label=swarmauri_core&color=green" alt="PyPI - swarmauri_core"/></a>
14
+ <a href="https://discord.gg/N4UpBuQv8T">
15
+ <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
16
+
17
+ # Swarmauri Core
18
+
19
+ `swarmauri_core` provides the interface contracts for the Swarmauri SDK. It is the package component authors use when they need stable abstract interfaces for agents, tools, LLMs, parsers, vector stores, cryptography, signing, key providers, transports, middleware, billing, storage, XMP, and other composable intelligence infrastructure components.
20
+
21
+ ## Why Swarmauri Core?
22
+
23
+ `swarmauri_core` keeps component contracts separate from implementations. Package authors can depend on stable interfaces without pulling in every base class, provider adapter, model package, or runtime integration.
24
+
25
+ ## FAQ
26
+
27
+ ### Q: What belongs in `swarmauri_core`?
28
+
29
+ A: Interface contracts, protocol shapes, enums, and shared types for Swarmauri component families.
30
+
31
+ ### Q: Should application developers instantiate classes from this package?
32
+
33
+ A: Usually no. Most application code uses concrete implementations from `swarmauri_standard`, community packages, or provider-specific packages. Component authors use `swarmauri_core` to implement the correct contract.
34
+
35
+ ### Q: How does this package relate to `swarmauri_base`?
36
+
37
+ A: `swarmauri_core` defines interfaces. `swarmauri_base` implements reusable base classes and serialization behavior on top of those interfaces.
38
+
39
+ ## What Is Included?
40
+
41
+ The package is intentionally implementation-light. It defines contracts, protocol shapes, enums, and shared types so implementation packages can interoperate without depending on each other directly.
42
+
43
+ Major interface families include:
44
+
45
+ - Agents and agent APIs: `IAgent`, conversation, parser, retrieval, toolkit, and vector-store agent mixins.
46
+ - LLM and multimodal prediction: text LLMs, tool LLMs, OCR, STT, TTS, and VLM interfaces.
47
+ - Documents and parsing: document contracts, parser contracts, chunkers, conversations, prompts, and prompt templates.
48
+ - Retrieval and vectors: vector, matrix, tensor, metric, similarity, vector-store comparator, deprecated distance compatibility contracts, vector store, and document store contracts.
49
+ - Security and trust: crypto, MRE crypto, cipher suites, signing, proof-of-possession, token services, key providers, certificates, and XMP embedding.
50
+ - Runtime infrastructure: middleware, transports, storage adapters, publishers, rate limits, tracing, state, service registries, and pipelines.
51
+ - Business systems: billing provider interfaces for customers, payments, invoices, subscriptions, refunds, payouts, risk, reporting, webhooks, and marketplace flows.
52
+
53
+ ## Features
54
+
55
+ - Stable abstract interfaces for Swarmauri component packages.
56
+ - Shared types for crypto, signing, key management, transports, billing, and proof-of-possession workflows.
57
+ - Zero runtime dependencies.
58
+ - Interface-first design for packages that later inherit reusable behavior from `swarmauri_base`.
59
+ - Python 3.10, 3.11, 3.12, 3.13, and 3.14 support.
60
+
61
+ ## Installation
62
+
63
+ Install with `uv`:
64
+
65
+ ```bash
66
+ uv add swarmauri_core
67
+ ```
68
+
69
+ Install with `pip`:
70
+
71
+ ```bash
72
+ pip install swarmauri_core
73
+ ```
74
+
75
+ ## Usage
76
+
77
+ Use `swarmauri_core` when defining a new implementation package or validating that a class satisfies a public Swarmauri contract.
78
+
79
+ ```python
80
+ import asyncio
81
+ from typing import Any, Optional
82
+
83
+ from swarmauri_core.agents.IAgent import IAgent
84
+ from swarmauri_core.messages.IMessage import IMessage
85
+
86
+
87
+ class MinimalAgent(IAgent):
88
+ def exec(
89
+ self,
90
+ input_data: Optional[Any] = None,
91
+ llm_kwargs: Optional[dict] = None,
92
+ ) -> Any:
93
+ return {"input": input_data, "kwargs": llm_kwargs or {}}
94
+
95
+ async def aexec(
96
+ self,
97
+ input_str: Optional[str | IMessage] = "",
98
+ llm_kwargs: Optional[dict] = None,
99
+ ) -> Any:
100
+ return self.exec(input_str, llm_kwargs)
101
+
102
+ def batch(
103
+ self,
104
+ inputs: list[str | IMessage],
105
+ llm_kwargs: Optional[dict] = None,
106
+ ) -> list[Any]:
107
+ return [self.exec(item, llm_kwargs) for item in inputs]
108
+
109
+ async def abatch(
110
+ self,
111
+ inputs: list[str | IMessage],
112
+ llm_kwargs: Optional[dict] = None,
113
+ ) -> list[Any]:
114
+ return await asyncio.gather(
115
+ *(self.aexec(item, llm_kwargs) for item in inputs)
116
+ )
117
+ ```
118
+
119
+ Implement a parser contract:
120
+
121
+ ```python
122
+ from pathlib import Path
123
+
124
+ from swarmauri_core.documents.IDocument import IDocument
125
+ from swarmauri_core.parsers.IParser import IParser
126
+
127
+
128
+ class PlainTextParser(IParser):
129
+ def parse(self, data: str | bytes | Path) -> list[IDocument]:
130
+ raise NotImplementedError("Return concrete Document instances here.")
131
+ ```
132
+
133
+ Implement a storage or retrieval contract in a concrete package, then expose the class through `swarmauri_base` and the public `swarmauri` namespace when appropriate.
134
+
135
+ ## Component Author Workflow
136
+
137
+ 1. Choose the closest interface from `swarmauri_core`.
138
+ 2. Implement domain behavior in a package-specific class.
139
+ 3. Add reusable serialization and registration behavior with `swarmauri_base` when the implementation should become a Swarmauri component.
140
+ 4. Publish or register the implementation package through the appropriate `swarmauri.<kind>` entry point or namespace mapping.
141
+ 5. Document installation and usage in the implementation package README.
142
+
143
+ ## Related Packages
144
+
145
+ Foundational packages:
146
+
147
+ - [swarmauri](https://pypi.org/project/swarmauri/) provides the namespace importer and plugin discovery layer.
148
+ - [swarmauri_base](https://pypi.org/project/swarmauri_base/) provides reusable base classes built on these interfaces.
149
+ - [swarmauri_standard](https://pypi.org/project/swarmauri_standard/) provides first-party implementations for common component kinds.
150
+
151
+ Packages built around specific core component kinds:
152
+
153
+ - [swarmauri_signing_ed25519](https://pypi.org/project/swarmauri_signing_ed25519/) implements signing interfaces.
154
+ - [swarmauri_crypto_composite](https://pypi.org/project/swarmauri_crypto_composite/) composes crypto providers behind the crypto interface.
155
+ - [swarmauri_keyprovider_inmemory](https://pypi.org/project/swarmauri_keyprovider_inmemory/) implements key provider contracts.
156
+ - [swarmauri_transport_stdio](https://pypi.org/project/swarmauri_transport_stdio/) implements transport contracts.
157
+ - [swarmauri_storage_memory](https://pypi.org/project/swarmauri_storage_memory/) implements storage adapter contracts.
158
+ - [swarmauri_middleware_jsonrpc](https://pypi.org/project/swarmauri_middleware_jsonrpc/) implements middleware contracts.
159
+
160
+ ## When To Use This Package
161
+
162
+ Use `swarmauri_core` when you are designing or implementing a Swarmauri-compatible component and need the interface contract. Use `swarmauri_base` when you also need reusable base-class behavior, serialization helpers, and component registration. Use `swarmauri_standard` when you want ready-to-use implementations.
163
+
164
+ ## License
165
+
166
+ Apache-2.0
167
+
168
+ ## Contributing
169
+
170
+ When adding or changing a core interface, keep the contract narrow, update downstream base classes where needed, add focused tests, and follow the [Swarmauri SDK contribution guide](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md).
171
+
172
+
@@ -1,13 +1,33 @@
1
1
  [project]
2
2
  name = "swarmauri_core"
3
- version = "0.10.1.dev3"
4
- description = "This repository includes core interfaces for the Swarmauri framework."
3
+ version = "0.11.0.dev2"
4
+ description = "Core interface contracts and shared types for Swarmauri composable intelligence infrastructure components."
5
5
  authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
6
6
  license = "Apache-2.0"
7
7
  readme = { file = "README.md", content-type = "text/markdown" }
8
8
  repository = "http://github.com/swarmauri/swarmauri-sdk"
9
+ keywords = [
10
+ "swarmauri",
11
+ "interfaces",
12
+ "abstract-base-classes",
13
+ "ai-sdk",
14
+ "component-contracts",
15
+ "composable-intelligence",
16
+ "agents",
17
+ "llms",
18
+ "tools",
19
+ "vector-stores",
20
+ "crypto",
21
+ "signing",
22
+ "key-providers",
23
+ "transports",
24
+ "middleware",
25
+ ]
9
26
  classifiers = [
27
+ "Development Status :: 4 - Beta",
28
+ "Intended Audience :: Developers",
10
29
  "License :: OSI Approved :: Apache Software License",
30
+ "Operating System :: OS Independent",
11
31
  "Programming Language :: Python",
12
32
  "Programming Language :: Python :: 3",
13
33
  "Programming Language :: Python :: 3 :: Only",
@@ -16,16 +36,13 @@ classifiers = [
16
36
  "Programming Language :: Python :: 3.12",
17
37
  "Programming Language :: Python :: 3.13",
18
38
  "Programming Language :: Python :: 3.14",
39
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
40
+ "Topic :: Software Development :: Libraries",
41
+ "Topic :: Software Development :: Libraries :: Python Modules",
42
+ "Topic :: Software Development :: Testing",
19
43
  ]
20
44
  requires-python = ">=3.10,<3.15"
21
45
 
22
- dependencies = [
23
- "typing_extensions",
24
- "aiofiles",
25
- ]
26
-
27
-
28
-
29
46
  [dependency-groups]
30
47
  dev = [
31
48
  "flake8>=7.0",
@@ -3,7 +3,8 @@ __long_desc__ = """
3
3
  # Swarmauri Core
4
4
 
5
5
  ## Core
6
- - **Core Interfaces**: Define the fundamental communication and data-sharing protocols between components in a Swarmauri-based system.
6
+ - **Core Interfaces**: Define the fundamental communication and data-sharing
7
+ protocols between components in a Swarmauri-based system.
7
8
 
8
9
 
9
10
  Visit us at: https://swarmauri.com
@@ -4,7 +4,8 @@ from typing import Any, List
4
4
 
5
5
  class IAgentCommands(ABC):
6
6
  """
7
- Interface for the API object that enables a SwarmAgent to host various API routes.
7
+ Interface for the API object that enables a SwarmAgent to host various API
8
+ routes.
8
9
  """
9
10
 
10
11
  @abstractmethod
@@ -17,7 +17,8 @@ class IAgentRouterCRUD(ABC):
17
17
  Parameters:
18
18
  - path (str): The URL path for the route.
19
19
  - method (str): The HTTP method (e.g., 'GET', 'POST').
20
- - handler (Callable[[Any], Any]): The function that handles requests to this route.
20
+ - handler (Callable[[Any], Any]): The function that handles requests to
21
+ this route.
21
22
  """
22
23
  pass
23
24
 
@@ -31,7 +32,8 @@ class IAgentRouterCRUD(ABC):
31
32
  - method (str): The HTTP method.
32
33
 
33
34
  Returns:
34
- - Dict: Information about the route, including path, method, and handler.
35
+ - Dict: Information about the route, including path, method, and
36
+ handler.
35
37
  """
36
38
  pass
37
39
 
@@ -45,7 +47,8 @@ class IAgentRouterCRUD(ABC):
45
47
  Parameters:
46
48
  - path (str): The URL path for the route.
47
49
  - method (str): The HTTP method.
48
- - new_handler (Callable[[Any], Any]): The new function that handles requests to this route.
50
+ - new_handler (Callable[[Any], Any]): The new function that handles
51
+ requests to this route.
49
52
  """
50
53
  pass
51
54
 
@@ -7,7 +7,8 @@ class IExportConf(ABC):
7
7
  Interface for exporting configurations related to agent factories.
8
8
 
9
9
  Implementing classes are expected to provide functionality for representing
10
- the factory's configuration as a dictionary, JSON string, or exporting to a file.
10
+ the factory's configuration as a dictionary, JSON string, or exporting to a
11
+ file.
11
12
  """
12
13
 
13
14
  @abstractmethod
@@ -16,7 +17,8 @@ class IExportConf(ABC):
16
17
  Serializes the agent factory's configuration to a dictionary.
17
18
 
18
19
  Returns:
19
- Dict[str, Any]: A dictionary representation of the factory's configuration.
20
+ Dict[str, Any]: A dictionary representation of the factory's
21
+ configuration.
20
22
  """
21
23
  pass
22
24
 
@@ -33,9 +35,11 @@ class IExportConf(ABC):
33
35
  @abstractmethod
34
36
  def to_file(self, file_path: str) -> None:
35
37
  """
36
- Exports the agent factory's configuration to a file in a suitable format.
38
+ Exports the agent factory's configuration to a file in a suitable
39
+ format.
37
40
 
38
41
  Parameters:
39
- file_path (str): The path to the file where the configuration should be saved.
42
+ file_path (str): The path to the file where the configuration
43
+ should be saved.
40
44
  """
41
45
  pass
@@ -5,9 +5,12 @@ from swarmauri_core.messages.IMessage import IMessage
5
5
 
6
6
  class IAgent(ABC):
7
7
  @abstractmethod
8
- def exec(self, input_data: Optional[Any], llm_kwargs: Optional[Dict]) -> Any:
8
+ def exec(
9
+ self, input_data: Optional[Any], llm_kwargs: Optional[Dict]
10
+ ) -> Any:
9
11
  """
10
- Executive method that triggers the agent's action based on the input data.
12
+ Executive method that triggers the agent's action based on the input
13
+ data.
11
14
  """
12
15
  pass
13
16
 
@@ -18,7 +21,8 @@ class IAgent(ABC):
18
21
  llm_kwargs: Optional[Dict] = None,
19
22
  ) -> Any:
20
23
  """
21
- Async executive method that triggers the agent's action based on the input data.
24
+ Async executive method that triggers the agent's action based on the
25
+ input data.
22
26
  """
23
27
  pass
24
28
 
@@ -41,7 +45,8 @@ class IAgent(ABC):
41
45
  llm_kwargs: Optional[Dict] = None,
42
46
  ) -> List[Any]:
43
47
  """
44
- Default async batch implementation: concurrently calls `aexec` on all inputs.
48
+ Default async batch implementation: concurrently calls `aexec` on all
49
+ inputs.
45
50
  Subclasses can override for more efficient implementations.
46
51
  """
47
52
  pass
@@ -13,6 +13,9 @@ class IOAuth20Login(ABC):
13
13
  ...
14
14
 
15
15
  @abstractmethod
16
- async def exchange_and_identity(self, code: str, state: str) -> Mapping[str, Any]:
17
- """Exchange the authorization code and return normalized identity claims."""
16
+ async def exchange_and_identity(
17
+ self, code: str, state: str
18
+ ) -> Mapping[str, Any]:
19
+ """Exchange the authorization code and return normalized identity
20
+ claims."""
18
21
  ...
@@ -13,6 +13,9 @@ class IOAuth21Login(ABC):
13
13
  ...
14
14
 
15
15
  @abstractmethod
16
- async def exchange_and_identity(self, code: str, state: str) -> Mapping[str, Any]:
17
- """Exchange the authorization code and return normalized identity claims."""
16
+ async def exchange_and_identity(
17
+ self, code: str, state: str
18
+ ) -> Mapping[str, Any]:
19
+ """Exchange the authorization code and return normalized identity
20
+ claims."""
18
21
  ...
@@ -14,5 +14,6 @@ class IOIDC10Login(ABC):
14
14
 
15
15
  @abstractmethod
16
16
  async def exchange(self, code: str, state: str) -> Mapping[str, Any]:
17
- """Exchange the authorization code and return normalized identity claims."""
17
+ """Exchange the authorization code and return normalized identity
18
+ claims."""
18
19
  ...
@@ -12,7 +12,9 @@ class IOnlinePayments(ABC):
12
12
  """Operations for managing payment intents."""
13
13
 
14
14
  @abstractmethod
15
- def create_payment_intent(self, req: PaymentIntentReqProto) -> PaymentRefProto:
15
+ def create_payment_intent(
16
+ self, req: PaymentIntentReqProto
17
+ ) -> PaymentRefProto:
16
18
  """Create a payment intent."""
17
19
 
18
20
  @abstractmethod
@@ -5,7 +5,11 @@ from __future__ import annotations
5
5
  from abc import ABC, abstractmethod
6
6
  from typing import Any, Mapping, Optional, Sequence
7
7
 
8
- from .protos import CustomerRefProto, PaymentMethodRefProto, PaymentMethodSpecProto
8
+ from .protos import (
9
+ CustomerRefProto,
10
+ PaymentMethodRefProto,
11
+ PaymentMethodSpecProto,
12
+ )
9
13
 
10
14
 
11
15
  class IPaymentMethods(ABC):
@@ -18,7 +22,9 @@ class IPaymentMethods(ABC):
18
22
  """Create a payment method."""
19
23
 
20
24
  @abstractmethod
21
- def detach_payment_method(self, payment_method_id: str) -> Mapping[str, Any]:
25
+ def detach_payment_method(
26
+ self, payment_method_id: str
27
+ ) -> Mapping[str, Any]:
22
28
  """Detach a payment method."""
23
29
 
24
30
  @abstractmethod
@@ -4,7 +4,12 @@ from __future__ import annotations
4
4
 
5
5
  from abc import ABC, abstractmethod
6
6
 
7
- from .protos import PriceRefProto, PriceSpecProto, ProductRefProto, ProductSpecProto
7
+ from .protos import (
8
+ PriceRefProto,
9
+ PriceSpecProto,
10
+ ProductRefProto,
11
+ ProductSpecProto,
12
+ )
8
13
 
9
14
 
10
15
  class IProductsPrices(ABC):
@@ -13,7 +13,11 @@ class IRefunds(ABC):
13
13
 
14
14
  @abstractmethod
15
15
  def create_refund(
16
- self, payment: PaymentRefProto, req: RefundReqProto, *, idempotency_key: str
16
+ self,
17
+ payment: PaymentRefProto,
18
+ req: RefundReqProto,
19
+ *,
20
+ idempotency_key: str,
17
21
  ) -> Mapping[str, Any]:
18
22
  """Create a refund."""
19
23