webagents 0.1.13__tar.gz → 0.2.2__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 (307) hide show
  1. {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/docs.yml +1 -1
  2. webagents-0.2.2/CONTRIBUTING.md +57 -0
  3. webagents-0.2.2/LICENSE +20 -0
  4. webagents-0.2.2/PKG-INFO +266 -0
  5. webagents-0.2.2/README.md +201 -0
  6. {webagents-0.1.13 → webagents-0.2.2}/RELEASE.md +4 -4
  7. webagents-0.2.2/docs/agent/endpoints.md +123 -0
  8. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/handoffs.md +8 -8
  9. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/hooks.md +4 -4
  10. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/lifecycle.md +22 -18
  11. webagents-0.2.2/docs/agent/overview.md +213 -0
  12. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/prompts.md +3 -3
  13. webagents-0.2.2/docs/agent/skills.md +126 -0
  14. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/tools.md +6 -6
  15. {webagents-0.1.13 → webagents-0.2.2}/docs/developers/contributing.md +20 -20
  16. {webagents-0.1.13 → webagents-0.2.2}/docs/developers/development.md +5 -5
  17. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/dynamic-agents.md +4 -4
  18. webagents-0.2.2/docs/index.md +130 -0
  19. webagents-0.2.2/docs/license.md +9 -0
  20. webagents-0.2.2/docs/quickstart.md +106 -0
  21. webagents-0.1.13/docs/sdk/v2-server-guide.md → webagents-0.2.2/docs/server-architecture.md +6 -6
  22. {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/server.md +5 -5
  23. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/llm.md +3 -3
  24. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/mcp.md +3 -3
  25. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/memory.md +3 -3
  26. webagents-0.2.2/docs/skills/custom.md +98 -0
  27. webagents-0.2.2/docs/skills/ecosystem/crewai.md +263 -0
  28. webagents-0.2.2/docs/skills/ecosystem/database.md +67 -0
  29. webagents-0.2.2/docs/skills/ecosystem/filesystem.md +36 -0
  30. webagents-0.2.2/docs/skills/ecosystem/google.md +225 -0
  31. webagents-0.2.2/docs/skills/ecosystem/index.md +204 -0
  32. webagents-0.2.2/docs/skills/ecosystem/mongodb.md +68 -0
  33. webagents-0.2.2/docs/skills/ecosystem/n8n.md +62 -0
  34. webagents-0.2.2/docs/skills/ecosystem/x_com.md +65 -0
  35. webagents-0.2.2/docs/skills/ecosystem/zapier.md +62 -0
  36. webagents-0.2.2/docs/skills/overview.md +39 -0
  37. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/auth.md +4 -4
  38. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/discovery.md +3 -3
  39. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/files.md +5 -5
  40. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/kv.md +4 -4
  41. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/nli.md +3 -3
  42. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/notifications.md +4 -4
  43. {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/payments.md +7 -7
  44. {webagents-0.1.13 → webagents-0.2.2}/docs/stylesheets/extra.css +30 -2
  45. webagents-0.2.2/examples/minimal_quickstart.py +18 -0
  46. webagents-0.1.13/examples/v2_server_demo.py → webagents-0.2.2/examples/server_demo.py +6 -6
  47. {webagents-0.1.13 → webagents-0.2.2}/examples/simple_demo.py +6 -6
  48. {webagents-0.1.13 → webagents-0.2.2}/mkdocs.yml +52 -62
  49. {webagents-0.1.13 → webagents-0.2.2}/pyproject.toml +21 -5
  50. webagents-0.2.2/requirements-ecosystem.txt +17 -0
  51. webagents-0.2.2/requirements.txt +41 -0
  52. webagents-0.2.2/tests/__init__.py +1 -0
  53. {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_http.py +4 -4
  54. {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_scopes.py +1 -1
  55. {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_http_capabilities_integration.py +4 -4
  56. {webagents-0.1.13 → webagents-0.2.2}/tests/fixtures/__init__.py +2 -2
  57. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/__init__.py +2 -2
  58. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/integration_config.py +1 -1
  59. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_discovery_skill_integration.py +33 -33
  60. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_dynamic_agents_integration.py +5 -5
  61. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_external_tools_integration.py +4 -4
  62. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_integration_litellm.py +1 -1
  63. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_integration_openai.py +1 -1
  64. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_payment_skill_integration.py +30 -30
  65. {webagents-0.1.13 → webagents-0.2.2}/tests/run_http_tests.py +2 -2
  66. {webagents-0.1.13 → webagents-0.2.2}/tests/server/__init__.py +2 -2
  67. {webagents-0.1.13 → webagents-0.2.2}/tests/server/conftest.py +4 -4
  68. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_dynamic_agents.py +10 -10
  69. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_http_server_integration.py +5 -5
  70. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_models.py +1 -1
  71. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_monitoring.py +1 -1
  72. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_server_core.py +2 -2
  73. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_server_streaming.py +1 -1
  74. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_streaming_compliance.py +1 -1
  75. {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_tool_execution.py +8 -8
  76. {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/conftest.py +3 -3
  77. {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/test_mcp_skill.py +25 -25
  78. {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/test_mcp_skill_backup.py +25 -25
  79. {webagents-0.1.13 → webagents-0.2.2}/tests/test_auth_skill.py +36 -36
  80. {webagents-0.1.13 → webagents-0.2.2}/tests/test_basic_agent.py +1 -1
  81. webagents-0.2.2/tests/test_crewai_skill.py +243 -0
  82. {webagents-0.1.13 → webagents-0.2.2}/tests/test_decorators.py +23 -23
  83. {webagents-0.1.13 → webagents-0.2.2}/tests/test_discovery_skill.py +29 -29
  84. {webagents-0.1.13 → webagents-0.2.2}/tests/test_litellm_skill.py +1 -1
  85. {webagents-0.1.13 → webagents-0.2.2}/tests/test_long_term_memory_skill.py +17 -17
  86. {webagents-0.1.13 → webagents-0.2.2}/tests/test_memory_skills.py +1 -1
  87. webagents-0.2.2/tests/test_mongodb_skill.py +543 -0
  88. webagents-0.2.2/tests/test_n8n_skill.py +394 -0
  89. {webagents-0.1.13 → webagents-0.2.2}/tests/test_nli_skill.py +4 -4
  90. {webagents-0.1.13 → webagents-0.2.2}/tests/test_payment_skill.py +64 -64
  91. {webagents-0.1.13 → webagents-0.2.2}/tests/test_planner_skill.py +1 -1
  92. {webagents-0.1.13 → webagents-0.2.2}/tests/test_prompt_decorator.py +2 -2
  93. webagents-0.2.2/tests/test_supabase_skill.py +462 -0
  94. {webagents-0.1.13 → webagents-0.2.2}/tests/test_vector_memory_skill.py +5 -5
  95. webagents-0.1.13/tests/test_robutler_storage_skill.py → webagents-0.2.2/tests/test_webagents_storage_skill.py +38 -38
  96. webagents-0.2.2/tests/test_x_com.py +332 -0
  97. webagents-0.2.2/tests/test_zapier_skill.py +412 -0
  98. {webagents-0.1.13 → webagents-0.2.2}/webagents/__init__.py +1 -1
  99. webagents-0.2.2/webagents/__main__.py +55 -0
  100. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/__init__.py +1 -1
  101. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/__init__.py +1 -1
  102. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/base_agent.py +15 -15
  103. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/handoffs.py +1 -1
  104. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/__init__.py +11 -11
  105. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/base.py +1 -1
  106. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/litellm/__init__.py +1 -1
  107. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/litellm/skill.py +1 -1
  108. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/README.md +2 -2
  109. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/skill.py +2 -2
  110. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/long_term_memory/memory_skill.py +14 -14
  111. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/short_term_memory/__init__.py +1 -1
  112. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/short_term_memory/skill.py +1 -1
  113. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/vector_memory/skill.py +6 -6
  114. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/planning/__init__.py +1 -1
  115. webagents-0.2.2/webagents/agents/skills/ecosystem/crewai/__init__.py +3 -0
  116. webagents-0.2.2/webagents/agents/skills/ecosystem/crewai/skill.py +158 -0
  117. webagents-0.2.2/webagents/agents/skills/ecosystem/database/__init__.py +3 -0
  118. webagents-0.2.2/webagents/agents/skills/ecosystem/database/skill.py +522 -0
  119. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/calendar/skill.py +1 -1
  120. webagents-0.2.2/webagents/agents/skills/ecosystem/mongodb/__init__.py +3 -0
  121. webagents-0.2.2/webagents/agents/skills/ecosystem/mongodb/skill.py +428 -0
  122. webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/README.md +287 -0
  123. webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/__init__.py +3 -0
  124. webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/skill.py +341 -0
  125. webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/README.md +401 -0
  126. webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/__init__.py +3 -0
  127. webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/skill.py +1048 -0
  128. webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/README.md +363 -0
  129. webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/__init__.py +3 -0
  130. webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/skill.py +337 -0
  131. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/__init__.py +2 -2
  132. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/__init__.py +3 -3
  133. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/skill.py +16 -16
  134. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/crm/__init__.py +2 -2
  135. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/crm/skill.py +5 -5
  136. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/README.md +5 -5
  137. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/__init__.py +2 -2
  138. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/skill.py +21 -21
  139. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/message_history/__init__.py +2 -2
  140. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/message_history/skill.py +5 -5
  141. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/nli/__init__.py +1 -1
  142. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/nli/skill.py +9 -9
  143. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/__init__.py +3 -3
  144. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/exceptions.py +1 -1
  145. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/skill.py +23 -23
  146. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/__init__.py +2 -2
  147. webagents-0.2.2/webagents/agents/skills/robutler/storage/files/__init__.py +9 -0
  148. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/files/skill.py +4 -4
  149. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/json/__init__.py +1 -1
  150. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/json/skill.py +3 -3
  151. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/kv/skill.py +3 -3
  152. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage.py +6 -6
  153. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/tools/decorators.py +12 -12
  154. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/__init__.py +3 -3
  155. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/context/context_vars.py +2 -2
  156. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/app.py +13 -13
  157. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/middleware.py +3 -3
  158. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/models.py +1 -1
  159. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/monitoring.py +2 -2
  160. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/middleware.py +1 -1
  161. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/models.py +2 -2
  162. {webagents-0.1.13 → webagents-0.2.2}/webagents/server/monitoring.py +15 -15
  163. {webagents-0.1.13 → webagents-0.2.2}/webagents/utils/logging.py +20 -20
  164. webagents-0.1.13/.vscode/launch.json +0 -87
  165. webagents-0.1.13/DESIGN_COHERENCY_REVIEW.md +0 -143
  166. webagents-0.1.13/IMPLEMENTATION_STATUS.md +0 -242
  167. webagents-0.1.13/LICENSE +0 -1
  168. webagents-0.1.13/PAYMENT_TOKENS.md +0 -258
  169. webagents-0.1.13/PKG-INFO +0 -32
  170. webagents-0.1.13/README.md +0 -3
  171. webagents-0.1.13/README_HTTP_IMPLEMENTATION.md +0 -246
  172. webagents-0.1.13/README_VECTOR_MEMORY.md +0 -571
  173. webagents-0.1.13/architecture/ROBUTLER_V2_0_IMPLEMENTATION_PLAN.md +0 -775
  174. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch1_Overview.md +0 -313
  175. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch2_Core_Architecture.md +0 -1847
  176. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch3_Skills_System.md +0 -2902
  177. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch4_Server_Tools.md +0 -802
  178. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch5_Integration_Usage.md +0 -1425
  179. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch6_Implementation_Guide.md +0 -1466
  180. webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_INDEX.md +0 -132
  181. webagents-0.1.13/architecture/STEP_1_5_COMPLETION_SUMMARY.md +0 -188
  182. webagents-0.1.13/architecture/STEP_2_2_COMPLETION_SUMMARY.md +0 -257
  183. webagents-0.1.13/demo_base_agent_capabilities.py +0 -241
  184. webagents-0.1.13/demo_handoff_rename.py +0 -90
  185. webagents-0.1.13/demo_http_capabilities.py +0 -268
  186. webagents-0.1.13/docs/CNAME +0 -1
  187. webagents-0.1.13/docs/api/agent.md +0 -420
  188. webagents-0.1.13/docs/api/client_core.md +0 -201
  189. webagents-0.1.13/docs/api/client_data.md +0 -57
  190. webagents-0.1.13/docs/api/client_exceptions.md +0 -166
  191. webagents-0.1.13/docs/api/decorators.md +0 -262
  192. webagents-0.1.13/docs/api/server.md +0 -672
  193. webagents-0.1.13/docs/api/skills/base.md +0 -197
  194. webagents-0.1.13/docs/api/skills/core.md +0 -350
  195. webagents-0.1.13/docs/api/skills/platform.md +0 -430
  196. webagents-0.1.13/docs/api/skills/types.md +0 -304
  197. webagents-0.1.13/docs/blog/posts/announcing-robutler.md +0 -27
  198. webagents-0.1.13/docs/blog/posts/launch.md +0 -10
  199. webagents-0.1.13/docs/blog/posts/nvidia-inception-program.md +0 -28
  200. webagents-0.1.13/docs/contact.md +0 -25
  201. webagents-0.1.13/docs/glossary.md +0 -93
  202. webagents-0.1.13/docs/index.md +0 -62
  203. webagents-0.1.13/docs/open-positions.md +0 -36
  204. webagents-0.1.13/docs/payment-errors.md +0 -244
  205. webagents-0.1.13/docs/press-kit.md +0 -95
  206. webagents-0.1.13/docs/robutler-agents.md +0 -36
  207. webagents-0.1.13/docs/sdk/agent/communication.md +0 -444
  208. webagents-0.1.13/docs/sdk/agent/configuration.md +0 -239
  209. webagents-0.1.13/docs/sdk/agent/endpoints.md +0 -554
  210. webagents-0.1.13/docs/sdk/agent/examples.md +0 -499
  211. webagents-0.1.13/docs/sdk/agent/overview.md +0 -177
  212. webagents-0.1.13/docs/sdk/agent/skills.md +0 -398
  213. webagents-0.1.13/docs/sdk/api-client.md +0 -343
  214. webagents-0.1.13/docs/sdk/architecture.md +0 -305
  215. webagents-0.1.13/docs/sdk/discovery-and-payments.md +0 -164
  216. webagents-0.1.13/docs/sdk/intent-discovery.md +0 -576
  217. webagents-0.1.13/docs/sdk/introduction.md +0 -101
  218. webagents-0.1.13/docs/sdk/monitoring.md +0 -251
  219. webagents-0.1.13/docs/sdk/openai-compatibility.md +0 -552
  220. webagents-0.1.13/docs/sdk/payment-system.md +0 -554
  221. webagents-0.1.13/docs/sdk/quickstart.md +0 -113
  222. webagents-0.1.13/docs/sdk/skills/custom.md +0 -425
  223. webagents-0.1.13/docs/sdk/skills/dependencies.md +0 -358
  224. webagents-0.1.13/docs/sdk/skills/overview.md +0 -302
  225. webagents-0.1.13/docs/skills/ecosystem/crewai.md +0 -38
  226. webagents-0.1.13/docs/skills/ecosystem/database.md +0 -39
  227. webagents-0.1.13/docs/skills/ecosystem/filesystem.md +0 -39
  228. webagents-0.1.13/docs/skills/ecosystem/google.md +0 -39
  229. webagents-0.1.13/docs/skills/ecosystem/google_calendar.md +0 -109
  230. webagents-0.1.13/docs/skills/ecosystem/n8n.md +0 -38
  231. webagents-0.1.13/docs/skills/ecosystem/zapier.md +0 -38
  232. webagents-0.1.13/docs/skills/overview.md +0 -69
  233. webagents-0.1.13/docs/user/agent.md +0 -133
  234. webagents-0.1.13/docs/user/assistant.md +0 -127
  235. webagents-0.1.13/docs/user/index.md +0 -55
  236. webagents-0.1.13/docs/user/robutler-agent.md +0 -43
  237. webagents-0.1.13/examples/dynamic_agents_demo.py +0 -90
  238. webagents-0.1.13/examples/extensive_agent_server.py +0 -336
  239. webagents-0.1.13/examples/serverbase_example.py +0 -395
  240. webagents-0.1.13/tests/README_HTTP_TESTS.md +0 -260
  241. webagents-0.1.13/tests/__init__.py +0 -1
  242. webagents-0.1.13/tests/integration/README.md +0 -223
  243. webagents-0.1.13/tests/integration/env.example +0 -44
  244. webagents-0.1.13/tests/skills/core/README.md +0 -155
  245. webagents-0.1.13/webagents/agents/skills/ecosystem/crewai/__init__.py +0 -1
  246. webagents-0.1.13/webagents/agents/skills/ecosystem/database/__init__.py +0 -1
  247. webagents-0.1.13/webagents/agents/skills/robutler/storage/files/__init__.py +0 -9
  248. webagents-0.1.13/webagents/api/__init__.py +0 -17
  249. webagents-0.1.13/webagents/api/client.py +0 -1207
  250. webagents-0.1.13/webagents/api/types.py +0 -253
  251. webagents-0.1.13/webagents/server/interfaces/__init__.py +0 -0
  252. webagents-0.1.13/webagents/utils/__init__.py +0 -0
  253. {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/ci.yml +0 -0
  254. {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/publish.yml +0 -0
  255. {webagents-0.1.13 → webagents-0.2.2}/.gitignore +0 -0
  256. {webagents-0.1.13 → webagents-0.2.2}/.vscode/settings.json +0 -0
  257. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Circle_Icon_W.png +0 -0
  258. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_Logo_300.png +0 -0
  259. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_Logo_Full.png +0 -0
  260. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_OG_Card_B.png +0 -0
  261. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_OG_Card_Nvidia_Yel.png +0 -0
  262. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/robutler-logo.svg +0 -0
  263. {webagents-0.1.13 → webagents-0.2.2}/docs/assets/robutler_logo.png +0 -0
  264. {webagents-0.1.13 → webagents-0.2.2}/docs/blog/.authors.yml +0 -0
  265. {webagents-0.1.13 → webagents-0.2.2}/docs/blog/index.md +0 -0
  266. {webagents-0.1.13 → webagents-0.2.2}/docs/gen_ref_pages.py +0 -0
  267. {webagents-0.1.13 → webagents-0.2.2}/docs/javascripts/mathjax.js +0 -0
  268. {webagents-0.1.13 → webagents-0.2.2}/docs/requirements.txt +0 -0
  269. {webagents-0.1.13 → webagents-0.2.2}/pytest.ini +0 -0
  270. {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_init.py +0 -0
  271. {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_quick.py +0 -0
  272. {webagents-0.1.13 → webagents-0.2.2}/tests/integration/openai_integration_config.md +0 -0
  273. {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/mcp_test_config.json +0 -0
  274. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/handoffs/__init__.py +0 -0
  275. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/interfaces/__init__.py +0 -0
  276. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/lifecycle/__init__.py +0 -0
  277. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/__init__.py +0 -0
  278. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/guardrails/__init__.py +0 -0
  279. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/__init__.py +0 -0
  280. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/anthropic/__init__.py +0 -0
  281. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/openai/__init__.py +0 -0
  282. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/xai/__init__.py +0 -0
  283. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/__init__.py +0 -0
  284. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/__init__.py +0 -0
  285. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/long_term_memory/__init__.py +0 -0
  286. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/planning/planner.py +0 -0
  287. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/__init__.py +0 -0
  288. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/filesystem/__init__.py +0 -0
  289. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/__init__.py +0 -0
  290. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/calendar/__init__.py +0 -0
  291. {webagents-0.1.13/webagents/agents/skills/ecosystem/n8n → webagents-0.2.2/webagents/agents/skills/ecosystem/openai_agents}/__init__.py +0 -0
  292. {webagents-0.1.13/webagents/agents/skills/ecosystem/openai_agents → webagents-0.2.2/webagents/agents/skills/ecosystem/web}/__init__.py +0 -0
  293. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/README.md +0 -0
  294. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/kv/__init__.py +0 -0
  295. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/kv/skill.py +0 -0
  296. {webagents-0.1.13/webagents/agents/skills/ecosystem/web → webagents-0.2.2/webagents/agents/skills/robutler/messages}/__init__.py +0 -0
  297. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/notifications/__init__.py +0 -0
  298. {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/notifications/skill.py +0 -0
  299. {webagents-0.1.13/webagents/agents/skills/ecosystem/zapier → webagents-0.2.2/webagents/agents/tools}/__init__.py +0 -0
  300. {webagents-0.1.13/webagents/agents/skills/robutler/messages → webagents-0.2.2/webagents/agents/tracing}/__init__.py +0 -0
  301. {webagents-0.1.13/webagents/agents/tools → webagents-0.2.2/webagents/agents/workflows}/__init__.py +0 -0
  302. {webagents-0.1.13/webagents/agents/tracing → webagents-0.2.2/webagents/scripts}/__init__.py +0 -0
  303. {webagents-0.1.13/webagents/agents/workflows → webagents-0.2.2/webagents/server/context}/__init__.py +0 -0
  304. {webagents-0.1.13/webagents/scripts → webagents-0.2.2/webagents/server/core}/__init__.py +0 -0
  305. {webagents-0.1.13/webagents/server/context → webagents-0.2.2/webagents/server/endpoints}/__init__.py +0 -0
  306. {webagents-0.1.13/webagents/server/core → webagents-0.2.2/webagents/server/interfaces}/__init__.py +0 -0
  307. {webagents-0.1.13/webagents/server/endpoints → webagents-0.2.2/webagents/utils}/__init__.py +0 -0
@@ -51,7 +51,7 @@ jobs:
51
51
  run: |
52
52
  mkdocs build --clean
53
53
  env:
54
- SITE_URL: https://docs.robutler.ai/
54
+ SITE_URL: https://robutler.ai/docs/
55
55
 
56
56
  - name: Upload artifact
57
57
  uses: actions/upload-pages-artifact@v3
@@ -0,0 +1,57 @@
1
+ # Contributing to WebAgents
2
+
3
+ Thanks for your interest in contributing! Please take a moment to review this guide.
4
+
5
+ ## Getting Started
6
+
7
+ 1. Fork the repository and create a feature branch:
8
+ - Branch naming: `feat/<short-name>`, `fix/<short-name>`, or `docs/<short-name>`
9
+ 2. Setup Python 3.10+ and install dependencies:
10
+ ```bash
11
+ pip install -e .[dev]
12
+ ```
13
+ 3. Run the test suite:
14
+ ```bash
15
+ pytest -q
16
+ ```
17
+
18
+ ## Development
19
+
20
+ - Use type hints and keep functions small and focused
21
+ - Match existing code style (Black, Ruff, MyPy in `pyproject.toml`)
22
+ ```bash
23
+ black .
24
+ ruff check .
25
+ mypy webagents
26
+ ```
27
+ - Prefer clear naming (no abbreviations) and early returns
28
+
29
+ ## Commit & PR Guidelines
30
+
31
+ - Write clear, atomic commits (present tense): `fix: correct NLI scope check`
32
+ - Open a Pull Request with:
33
+ - A concise description
34
+ - Screenshots or logs when relevant
35
+ - Tests for new behavior
36
+ - Link related issues (e.g., `Fixes #123`)
37
+
38
+ ## Testing
39
+
40
+ - Add unit tests under `tests/`
41
+ - For HTTP endpoints, include positive and negative cases
42
+ - Keep tests deterministic; avoid network calls (mock where needed)
43
+
44
+ ## Documentation
45
+
46
+ - Update `docs/` for user-visible changes
47
+ - Keep admonitions minimal (2–3 per page)
48
+ - Ensure links are relative and valid (`skills/platform/...` etc.)
49
+ - Build docs locally and fix warnings
50
+
51
+ ## Code of Conduct
52
+
53
+ Be respectful and constructive. We value inclusive, collaborative contributions.
54
+
55
+ ## Questions?
56
+
57
+ Open a discussion or issue on GitHub. Thank you for helping improve WebAgents!
@@ -0,0 +1,20 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Robutler
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20
+ SOFTWARE.
@@ -0,0 +1,266 @@
1
+ Metadata-Version: 2.4
2
+ Name: webagents
3
+ Version: 0.2.2
4
+ Summary: Foundation framework for the Web of Agents - build, serve and monetize AI agents
5
+ Author: Awesome Opensource Contributors and Robutler Team
6
+ License: MIT License
7
+
8
+ Copyright (c) 2025 Robutler
9
+
10
+ Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ of this software and associated documentation files (the "Software"), to deal
12
+ in the Software without restriction, including without limitation the rights
13
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ copies of the Software, and to permit persons to whom the Software is
15
+ furnished to do so, subject to the following conditions:
16
+
17
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
18
+
19
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25
+ SOFTWARE.
26
+ License-File: LICENSE
27
+ Requires-Python: >=3.10
28
+ Requires-Dist: colorama>=0.4.6
29
+ Requires-Dist: fastapi>=0.100.0
30
+ Requires-Dist: fastmcp>=2.3.0
31
+ Requires-Dist: httpx>=0.24.0
32
+ Requires-Dist: litellm>=1.0.0
33
+ Requires-Dist: pillow>=10.0.0
34
+ Requires-Dist: pydantic-settings>=2.0.0
35
+ Requires-Dist: pydantic>=2.7.0
36
+ Requires-Dist: python-dotenv>=1.0.0
37
+ Requires-Dist: tiktoken>=0.5.0
38
+ Requires-Dist: uvicorn>=0.23.0
39
+ Provides-Extra: crewai
40
+ Requires-Dist: crewai>=0.1.0; extra == 'crewai'
41
+ Provides-Extra: dev
42
+ Requires-Dist: black>=23.0.0; extra == 'dev'
43
+ Requires-Dist: mypy>=1.0.0; extra == 'dev'
44
+ Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
45
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
46
+ Requires-Dist: ruff>=0.0.270; extra == 'dev'
47
+ Provides-Extra: ecosystem
48
+ Requires-Dist: crewai>=0.1.0; extra == 'ecosystem'
49
+ Requires-Dist: httpx>=0.24.0; extra == 'ecosystem'
50
+ Requires-Dist: psycopg2-binary>=2.9.0; extra == 'ecosystem'
51
+ Requires-Dist: pymongo>=4.0.0; extra == 'ecosystem'
52
+ Requires-Dist: supabase>=2.0.0; extra == 'ecosystem'
53
+ Requires-Dist: tweepy>=4.14.0; extra == 'ecosystem'
54
+ Provides-Extra: examples
55
+ Requires-Dist: openai-agents>=0.0.16; extra == 'examples'
56
+ Provides-Extra: mongodb
57
+ Requires-Dist: pymongo>=4.0.0; extra == 'mongodb'
58
+ Provides-Extra: postgresql
59
+ Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgresql'
60
+ Provides-Extra: supabase
61
+ Requires-Dist: supabase>=2.0.0; extra == 'supabase'
62
+ Provides-Extra: twitter
63
+ Requires-Dist: tweepy>=4.14.0; extra == 'twitter'
64
+ Description-Content-Type: text/markdown
65
+
66
+ # WebAgents - core framework for the Web of Agents
67
+
68
+ **Build, Serve and Monetize AI Agents**
69
+
70
+ WebAgents is a powerful opensource framework for building connected AI agents with a simple yet comprehensive API. Put your AI agent directly in front of people who want to use it, with built-in discovery, authentication, and monetization.
71
+
72
+ [![PyPI version](https://badge.fury.io/py/webagents.svg)](https://badge.fury.io/py/webagents)
73
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
74
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
75
+
76
+ ## 🚀 Key Features
77
+
78
+ - **🧩 Modular Skills System** - Combine tools, prompts, hooks, and HTTP endpoints into reusable packages
79
+ - **🤝 Agent-to-Agent Delegation** - Delegate tasks to other agents via natural language. Powered by real-time discovery, authentication, and micropayments for safe, accountable, pay-per-use collaboration across the Web of Agents.
80
+ - **🔍 Real-Time Discovery** - Agents discover each other through intent matching - no manual integration
81
+ - **💰 Built-in Monetization** - Earn credits from priced tools with automatic billing
82
+ - **🔐 Trust & Security** - Secure authentication and scope-based access control
83
+ - **🌐 Protocol agnostic connectivity** - Deploy agents as standard chat completion endpoints with coming support for OpenAI Responses/Realtime, ACP, A2A and other common AI communication protocols and frameworks.
84
+ - **🔌 Build or Integrate** - Build from scratch with WebAgents, or integrate existing agents from popular SDKs and platforms into the Web of Agents (e.g., Azure AI Foundry, Google Vertex AI, CrewAI, n8n, Zapier).
85
+
86
+ With WebAgents delegation, your agent is as powerful as the whole ecosystem, and capabilities of your agent grow together with the whole ecosystem.
87
+
88
+ ## 📦 Installation
89
+
90
+ ```bash
91
+ # Core framework
92
+ pip install webagents
93
+
94
+ # With ecosystem skills (MongoDB, Supabase, CrewAI, X.com, etc.)
95
+ pip install webagents[ecosystem]
96
+
97
+ # Individual skills
98
+ pip install webagents[mongodb,crewai,twitter]
99
+ ```
100
+
101
+ ## 🏃‍♂️ Quick Start
102
+
103
+ ### Create Your First Agent
104
+
105
+ ```python
106
+ from webagents.agents.core.base_agent import BaseAgent
107
+
108
+ # Create a basic agent
109
+ agent = BaseAgent(
110
+ name="assistant",
111
+ instructions="You are a helpful AI assistant.",
112
+ model="openai/gpt-4o-mini" # Automatically creates LLM skill
113
+ )
114
+
115
+ # Run chat completion
116
+ messages = [{"role": "user", "content": "Hello! What can you help me with?"}]
117
+ response = await agent.run(messages=messages)
118
+ print(response.content)
119
+ ```
120
+
121
+ ### Serve Your Agent
122
+
123
+ Deploy your agent as an OpenAI-compatible API server:
124
+
125
+ ```python
126
+ from webagents.server.core.app import create_server
127
+ import uvicorn
128
+
129
+ # Create server with your agent
130
+ server = create_server(agents=[agent])
131
+
132
+ # Run the server
133
+ uvicorn.run(server.app, host="0.0.0.0", port=8000)
134
+ ```
135
+
136
+ Test your agent API:
137
+ ```bash
138
+ curl -X POST http://localhost:8000/assistant/chat/completions \
139
+ -H "Content-Type: application/json" \
140
+ -d '{"messages": [{"role": "user", "content": "Hello!"}]}'
141
+ ```
142
+
143
+ ## 🧩 Skills Framework
144
+
145
+ Skills combine tools, prompts, hooks, and HTTP endpoints into easy-to-integrate packages:
146
+
147
+ ```python
148
+ from webagents.agents.skills.base import Skill
149
+ from webagents.agents.tools.decorators import tool, prompt, hook, http
150
+ from webagents.agents.skills.robutler.payments.skill import pricing
151
+
152
+ class NotificationsSkill(Skill):
153
+ @prompt(scope=["owner"])
154
+ def get_prompt(self) -> str:
155
+ return "You can send notifications using send_notification()."
156
+
157
+ @tool(scope="owner")
158
+ @pricing(credits_per_call=0.01)
159
+ async def send_notification(self, title: str, body: str) -> str:
160
+ # Your API integration
161
+ return f"✅ Notification sent: {title}"
162
+
163
+ @hook("on_message")
164
+ async def log_messages(self, context):
165
+ # React to incoming messages
166
+ return context
167
+
168
+ @http("POST", "/webhook")
169
+ async def handle_webhook(self, request):
170
+ # Custom HTTP endpoint
171
+ return {"status": "received"}
172
+ ```
173
+
174
+ **Core Skills** - Essential functionality:
175
+ - **LLM Skills**: OpenAI, Anthropic, LiteLLM integration
176
+ - **Memory Skills**: Short-term, long-term, and vector memory
177
+ - **MCP Skill**: Model Context Protocol integration
178
+
179
+ **Platform Skills** - WebAgents ecosystem:
180
+ - **Discovery**: Real-time agent discovery and routing
181
+ - **Authentication**: Secure agent-to-agent communication
182
+ - **Payments**: Monetization and automatic billing
183
+ - **Storage**: Persistent data and messaging
184
+
185
+ **Ecosystem Skills** - External integrations:
186
+ - **Google**: Calendar, Drive, Gmail integration
187
+ - **Database**: SQL and NoSQL database access
188
+ - **Workflow**: CrewAI, N8N, Zapier automation
189
+
190
+ ## 💰 Monetization
191
+
192
+ Add payments to earn credits from your agent:
193
+
194
+ ```python
195
+ from webagents.agents.core.base_agent import BaseAgent
196
+ from webagents.agents.skills.robutler.payments.skill import PaymentSkill, pricing
197
+ from webagents.agents.tools.decorators import tool
198
+
199
+ # Define a priced tool (fixed pricing)
200
+ @tool
201
+ @pricing(credits_per_call=0.01, reason="Image generation")
202
+ def generate_thumbnail(url: str, size: int = 256) -> dict:
203
+ """Create a thumbnail for a public image URL."""
204
+ # ... your processing logic here ...
205
+ return {"url": url, "thumbnail_size": size, "status": "created"}
206
+
207
+
208
+ agent = BaseAgent(
209
+ name="thumbnail-generator",
210
+ model="openai/gpt-4o-mini",
211
+ skills={
212
+ "payments": PaymentSkill(),
213
+ },
214
+ # Auto-register priced tool as capability
215
+ capabilities=[generate_thumbnail],
216
+ )
217
+ ```
218
+
219
+ ## 🔧 Environment Setup
220
+
221
+ Set up your API keys for LLM providers:
222
+
223
+ ```bash
224
+ export OPENAI_API_KEY="your-openai-key"
225
+
226
+ # Robutler API key for payments
227
+ export WEBAGENTS_API_KEY="your-webagents-key"
228
+ ```
229
+
230
+ Get your WEBAGENTS_API_KEY at https://robutler.ai/developer
231
+
232
+
233
+ ## 🌐 Web of Agents
234
+
235
+ WebAgents enables dynamic real-time orchestration where each AI agent acts as a building block for other agents:
236
+
237
+ - **🚀 Real-Time Discovery**: Think DNS for agent intents - agents find each other through natural language
238
+ - **🔐 Trust & Security**: Secure authentication with audit trails for all transactions
239
+ - **💡 Delegation by Design**: Seamless delegation across agents, enabled by real-time discovery, scoped authentication, and micropayments. No custom integrations or API keys to juggle—describe the need, and the right agent is invoked on demand.
240
+
241
+ ## 📚 Documentation
242
+
243
+ - **[Full Documentation](https://robutler.ai/webagents)** - Complete guides and API reference
244
+ - **[Skills Framework](https://robutler.ai/webagents/skills/overview/)** - Deep dive into modular capabilities
245
+ - **[Agent Architecture](https://robutler.ai/webagents/agent/overview/)** - Understand agent communication
246
+ - **[Custom Skills](https://robutler.ai/webagents/skills/custom/)** - Build your own capabilities
247
+
248
+ ## 🤝 Contributing
249
+
250
+ We welcome contributions! Please see our [Contributing Guide](https://robutler.ai/webagents/developers/contributing/) for details.
251
+
252
+ ## 📄 License
253
+
254
+ This project is licensed under the MIT License - see the [LICENSE](https://robutler.ai/webagents/license/) file for details.
255
+
256
+ ## 🆘 Support
257
+
258
+ - **GitHub Issues**: [Report bugs and request features](https://github.com/robutlerai/webagents/issues)
259
+ - **Documentation**: [robutler.ai/webagents](https://robutler.ai/webagents)
260
+ - **Community**: Join our Discord server for discussions and support
261
+
262
+ ---
263
+
264
+ **Focus on what makes your agent unique instead of spending time on plumbing.**
265
+
266
+ Built with ❤️ by the [WebAgents team](https://robutler.ai) and community contributors.
@@ -0,0 +1,201 @@
1
+ # WebAgents - core framework for the Web of Agents
2
+
3
+ **Build, Serve and Monetize AI Agents**
4
+
5
+ WebAgents is a powerful opensource framework for building connected AI agents with a simple yet comprehensive API. Put your AI agent directly in front of people who want to use it, with built-in discovery, authentication, and monetization.
6
+
7
+ [![PyPI version](https://badge.fury.io/py/webagents.svg)](https://badge.fury.io/py/webagents)
8
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
9
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
10
+
11
+ ## 🚀 Key Features
12
+
13
+ - **🧩 Modular Skills System** - Combine tools, prompts, hooks, and HTTP endpoints into reusable packages
14
+ - **🤝 Agent-to-Agent Delegation** - Delegate tasks to other agents via natural language. Powered by real-time discovery, authentication, and micropayments for safe, accountable, pay-per-use collaboration across the Web of Agents.
15
+ - **🔍 Real-Time Discovery** - Agents discover each other through intent matching - no manual integration
16
+ - **💰 Built-in Monetization** - Earn credits from priced tools with automatic billing
17
+ - **🔐 Trust & Security** - Secure authentication and scope-based access control
18
+ - **🌐 Protocol agnostic connectivity** - Deploy agents as standard chat completion endpoints with coming support for OpenAI Responses/Realtime, ACP, A2A and other common AI communication protocols and frameworks.
19
+ - **🔌 Build or Integrate** - Build from scratch with WebAgents, or integrate existing agents from popular SDKs and platforms into the Web of Agents (e.g., Azure AI Foundry, Google Vertex AI, CrewAI, n8n, Zapier).
20
+
21
+ With WebAgents delegation, your agent is as powerful as the whole ecosystem, and capabilities of your agent grow together with the whole ecosystem.
22
+
23
+ ## 📦 Installation
24
+
25
+ ```bash
26
+ # Core framework
27
+ pip install webagents
28
+
29
+ # With ecosystem skills (MongoDB, Supabase, CrewAI, X.com, etc.)
30
+ pip install webagents[ecosystem]
31
+
32
+ # Individual skills
33
+ pip install webagents[mongodb,crewai,twitter]
34
+ ```
35
+
36
+ ## 🏃‍♂️ Quick Start
37
+
38
+ ### Create Your First Agent
39
+
40
+ ```python
41
+ from webagents.agents.core.base_agent import BaseAgent
42
+
43
+ # Create a basic agent
44
+ agent = BaseAgent(
45
+ name="assistant",
46
+ instructions="You are a helpful AI assistant.",
47
+ model="openai/gpt-4o-mini" # Automatically creates LLM skill
48
+ )
49
+
50
+ # Run chat completion
51
+ messages = [{"role": "user", "content": "Hello! What can you help me with?"}]
52
+ response = await agent.run(messages=messages)
53
+ print(response.content)
54
+ ```
55
+
56
+ ### Serve Your Agent
57
+
58
+ Deploy your agent as an OpenAI-compatible API server:
59
+
60
+ ```python
61
+ from webagents.server.core.app import create_server
62
+ import uvicorn
63
+
64
+ # Create server with your agent
65
+ server = create_server(agents=[agent])
66
+
67
+ # Run the server
68
+ uvicorn.run(server.app, host="0.0.0.0", port=8000)
69
+ ```
70
+
71
+ Test your agent API:
72
+ ```bash
73
+ curl -X POST http://localhost:8000/assistant/chat/completions \
74
+ -H "Content-Type: application/json" \
75
+ -d '{"messages": [{"role": "user", "content": "Hello!"}]}'
76
+ ```
77
+
78
+ ## 🧩 Skills Framework
79
+
80
+ Skills combine tools, prompts, hooks, and HTTP endpoints into easy-to-integrate packages:
81
+
82
+ ```python
83
+ from webagents.agents.skills.base import Skill
84
+ from webagents.agents.tools.decorators import tool, prompt, hook, http
85
+ from webagents.agents.skills.robutler.payments.skill import pricing
86
+
87
+ class NotificationsSkill(Skill):
88
+ @prompt(scope=["owner"])
89
+ def get_prompt(self) -> str:
90
+ return "You can send notifications using send_notification()."
91
+
92
+ @tool(scope="owner")
93
+ @pricing(credits_per_call=0.01)
94
+ async def send_notification(self, title: str, body: str) -> str:
95
+ # Your API integration
96
+ return f"✅ Notification sent: {title}"
97
+
98
+ @hook("on_message")
99
+ async def log_messages(self, context):
100
+ # React to incoming messages
101
+ return context
102
+
103
+ @http("POST", "/webhook")
104
+ async def handle_webhook(self, request):
105
+ # Custom HTTP endpoint
106
+ return {"status": "received"}
107
+ ```
108
+
109
+ **Core Skills** - Essential functionality:
110
+ - **LLM Skills**: OpenAI, Anthropic, LiteLLM integration
111
+ - **Memory Skills**: Short-term, long-term, and vector memory
112
+ - **MCP Skill**: Model Context Protocol integration
113
+
114
+ **Platform Skills** - WebAgents ecosystem:
115
+ - **Discovery**: Real-time agent discovery and routing
116
+ - **Authentication**: Secure agent-to-agent communication
117
+ - **Payments**: Monetization and automatic billing
118
+ - **Storage**: Persistent data and messaging
119
+
120
+ **Ecosystem Skills** - External integrations:
121
+ - **Google**: Calendar, Drive, Gmail integration
122
+ - **Database**: SQL and NoSQL database access
123
+ - **Workflow**: CrewAI, N8N, Zapier automation
124
+
125
+ ## 💰 Monetization
126
+
127
+ Add payments to earn credits from your agent:
128
+
129
+ ```python
130
+ from webagents.agents.core.base_agent import BaseAgent
131
+ from webagents.agents.skills.robutler.payments.skill import PaymentSkill, pricing
132
+ from webagents.agents.tools.decorators import tool
133
+
134
+ # Define a priced tool (fixed pricing)
135
+ @tool
136
+ @pricing(credits_per_call=0.01, reason="Image generation")
137
+ def generate_thumbnail(url: str, size: int = 256) -> dict:
138
+ """Create a thumbnail for a public image URL."""
139
+ # ... your processing logic here ...
140
+ return {"url": url, "thumbnail_size": size, "status": "created"}
141
+
142
+
143
+ agent = BaseAgent(
144
+ name="thumbnail-generator",
145
+ model="openai/gpt-4o-mini",
146
+ skills={
147
+ "payments": PaymentSkill(),
148
+ },
149
+ # Auto-register priced tool as capability
150
+ capabilities=[generate_thumbnail],
151
+ )
152
+ ```
153
+
154
+ ## 🔧 Environment Setup
155
+
156
+ Set up your API keys for LLM providers:
157
+
158
+ ```bash
159
+ export OPENAI_API_KEY="your-openai-key"
160
+
161
+ # Robutler API key for payments
162
+ export WEBAGENTS_API_KEY="your-webagents-key"
163
+ ```
164
+
165
+ Get your WEBAGENTS_API_KEY at https://robutler.ai/developer
166
+
167
+
168
+ ## 🌐 Web of Agents
169
+
170
+ WebAgents enables dynamic real-time orchestration where each AI agent acts as a building block for other agents:
171
+
172
+ - **🚀 Real-Time Discovery**: Think DNS for agent intents - agents find each other through natural language
173
+ - **🔐 Trust & Security**: Secure authentication with audit trails for all transactions
174
+ - **💡 Delegation by Design**: Seamless delegation across agents, enabled by real-time discovery, scoped authentication, and micropayments. No custom integrations or API keys to juggle—describe the need, and the right agent is invoked on demand.
175
+
176
+ ## 📚 Documentation
177
+
178
+ - **[Full Documentation](https://robutler.ai/webagents)** - Complete guides and API reference
179
+ - **[Skills Framework](https://robutler.ai/webagents/skills/overview/)** - Deep dive into modular capabilities
180
+ - **[Agent Architecture](https://robutler.ai/webagents/agent/overview/)** - Understand agent communication
181
+ - **[Custom Skills](https://robutler.ai/webagents/skills/custom/)** - Build your own capabilities
182
+
183
+ ## 🤝 Contributing
184
+
185
+ We welcome contributions! Please see our [Contributing Guide](https://robutler.ai/webagents/developers/contributing/) for details.
186
+
187
+ ## 📄 License
188
+
189
+ This project is licensed under the MIT License - see the [LICENSE](https://robutler.ai/webagents/license/) file for details.
190
+
191
+ ## 🆘 Support
192
+
193
+ - **GitHub Issues**: [Report bugs and request features](https://github.com/robutlerai/webagents/issues)
194
+ - **Documentation**: [robutler.ai/webagents](https://robutler.ai/webagents)
195
+ - **Community**: Join our Discord server for discussions and support
196
+
197
+ ---
198
+
199
+ **Focus on what makes your agent unique instead of spending time on plumbing.**
200
+
201
+ Built with ❤️ by the [WebAgents team](https://robutler.ai) and community contributors.
@@ -1,10 +1,10 @@
1
1
  # Release Instructions
2
2
 
3
- This document outlines the process for releasing new versions of the Robutler package to PyPI.
3
+ This document outlines the process for releasing new versions of the WebAgents package to PyPI.
4
4
 
5
5
  ## Prerequisites
6
6
 
7
- 1. **PyPI Account**: Ensure you have a PyPI account with access to the `robutler` package
7
+ 1. **PyPI Account**: Ensure you have a PyPI account with access to the `webagents` package
8
8
  2. **GitHub Repository Secrets**: The following secrets must be configured in the GitHub repository:
9
9
  - `PYPI_API_TOKEN`: Your PyPI API token with upload permissions
10
10
 
@@ -104,7 +104,7 @@ After a successful release:
104
104
 
105
105
  1. **Verify Installation**: Test installing the new version:
106
106
  ```bash
107
- pip install robutler==0.2.0
107
+ pip install webagents==0.2.0
108
108
  ```
109
109
 
110
110
  2. **Update Documentation**: Ensure all documentation reflects the new version
@@ -121,7 +121,7 @@ After a successful release:
121
121
 
122
122
  3. **Build Failures**: Check the GitHub Actions logs for specific error messages
123
123
 
124
- 4. **Permission Errors**: Ensure your PyPI account has maintainer access to the `robutler` package
124
+ 4. **Permission Errors**: Ensure your PyPI account has maintainer access to the `webagents` package
125
125
 
126
126
  ### Getting Help
127
127