webagents 0.1.12__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (282) hide show
  1. webagents-0.2.0/.readthedocs.yaml +23 -0
  2. webagents-0.2.0/CONTRIBUTING.md +57 -0
  3. webagents-0.2.0/LICENSE +20 -0
  4. webagents-0.2.0/PKG-INFO +242 -0
  5. webagents-0.2.0/README.md +194 -0
  6. {webagents-0.1.12 → webagents-0.2.0}/RELEASE.md +4 -4
  7. webagents-0.2.0/TODO.md +22 -0
  8. webagents-0.2.0/docs/CNAME +1 -0
  9. webagents-0.2.0/docs/agent/endpoints.md +123 -0
  10. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/agent/handoffs.md +8 -8
  11. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/agent/hooks.md +4 -4
  12. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/agent/lifecycle.md +22 -18
  13. webagents-0.2.0/docs/agent/overview.md +213 -0
  14. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/agent/prompts.md +3 -3
  15. webagents-0.2.0/docs/agent/skills.md +126 -0
  16. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/agent/tools.md +6 -6
  17. {webagents-0.1.12 → webagents-0.2.0}/docs/developers/contributing.md +20 -20
  18. {webagents-0.1.12 → webagents-0.2.0}/docs/developers/development.md +5 -5
  19. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/dynamic-agents.md +4 -4
  20. webagents-0.2.0/docs/index.md +130 -0
  21. webagents-0.2.0/docs/license.md +9 -0
  22. webagents-0.2.0/docs/quickstart.md +102 -0
  23. webagents-0.1.12/docs/sdk/v2-server-guide.md → webagents-0.2.0/docs/server-architecture.md +6 -6
  24. {webagents-0.1.12/docs/sdk → webagents-0.2.0/docs}/server.md +5 -5
  25. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/core/llm.md +3 -3
  26. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/core/mcp.md +3 -3
  27. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/core/memory.md +3 -3
  28. webagents-0.2.0/docs/skills/custom.md +98 -0
  29. webagents-0.2.0/docs/skills/ecosystem/crewai.md +35 -0
  30. webagents-0.2.0/docs/skills/ecosystem/database.md +36 -0
  31. webagents-0.2.0/docs/skills/ecosystem/filesystem.md +36 -0
  32. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/ecosystem/google.md +3 -3
  33. webagents-0.2.0/docs/skills/ecosystem/n8n.md +35 -0
  34. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/ecosystem/zapier.md +3 -3
  35. webagents-0.2.0/docs/skills/overview.md +39 -0
  36. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/auth.md +4 -4
  37. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/discovery.md +3 -3
  38. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/files.md +5 -5
  39. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/kv.md +4 -4
  40. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/nli.md +3 -3
  41. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/notifications.md +4 -4
  42. {webagents-0.1.12 → webagents-0.2.0}/docs/skills/platform/payments.md +7 -7
  43. {webagents-0.1.12 → webagents-0.2.0}/docs/stylesheets/extra.css +4 -2
  44. webagents-0.2.0/examples/minimal_quickstart.py +18 -0
  45. webagents-0.1.12/examples/v2_server_demo.py → webagents-0.2.0/examples/server_demo.py +6 -6
  46. {webagents-0.1.12 → webagents-0.2.0}/examples/simple_demo.py +6 -6
  47. {webagents-0.1.12 → webagents-0.2.0}/mkdocs.yml +29 -57
  48. {webagents-0.1.12 → webagents-0.2.0}/pyproject.toml +4 -7
  49. webagents-0.2.0/tests/__init__.py +1 -0
  50. {webagents-0.1.12 → webagents-0.2.0}/tests/agents/core/test_base_agent_http.py +4 -4
  51. {webagents-0.1.12 → webagents-0.2.0}/tests/agents/core/test_base_agent_scopes.py +1 -1
  52. {webagents-0.1.12 → webagents-0.2.0}/tests/agents/core/test_http_capabilities_integration.py +4 -4
  53. {webagents-0.1.12 → webagents-0.2.0}/tests/fixtures/__init__.py +2 -2
  54. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/__init__.py +2 -2
  55. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/integration_config.py +1 -1
  56. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_discovery_skill_integration.py +33 -33
  57. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_dynamic_agents_integration.py +5 -5
  58. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_external_tools_integration.py +4 -4
  59. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_integration_litellm.py +1 -1
  60. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_integration_openai.py +1 -1
  61. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/test_payment_skill_integration.py +30 -30
  62. {webagents-0.1.12 → webagents-0.2.0}/tests/run_http_tests.py +2 -2
  63. {webagents-0.1.12 → webagents-0.2.0}/tests/server/__init__.py +2 -2
  64. {webagents-0.1.12 → webagents-0.2.0}/tests/server/conftest.py +4 -4
  65. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_dynamic_agents.py +10 -10
  66. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_http_server_integration.py +5 -5
  67. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_models.py +1 -1
  68. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_monitoring.py +1 -1
  69. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_server_core.py +2 -2
  70. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_server_streaming.py +1 -1
  71. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_streaming_compliance.py +1 -1
  72. {webagents-0.1.12 → webagents-0.2.0}/tests/server/test_tool_execution.py +8 -8
  73. {webagents-0.1.12 → webagents-0.2.0}/tests/skills/core/conftest.py +3 -3
  74. {webagents-0.1.12 → webagents-0.2.0}/tests/skills/core/test_mcp_skill.py +25 -25
  75. {webagents-0.1.12 → webagents-0.2.0}/tests/skills/core/test_mcp_skill_backup.py +25 -25
  76. {webagents-0.1.12 → webagents-0.2.0}/tests/test_auth_skill.py +36 -36
  77. {webagents-0.1.12 → webagents-0.2.0}/tests/test_basic_agent.py +1 -1
  78. {webagents-0.1.12 → webagents-0.2.0}/tests/test_decorators.py +23 -23
  79. {webagents-0.1.12 → webagents-0.2.0}/tests/test_discovery_skill.py +29 -29
  80. {webagents-0.1.12 → webagents-0.2.0}/tests/test_litellm_skill.py +1 -1
  81. {webagents-0.1.12 → webagents-0.2.0}/tests/test_long_term_memory_skill.py +17 -17
  82. {webagents-0.1.12 → webagents-0.2.0}/tests/test_memory_skills.py +1 -1
  83. {webagents-0.1.12 → webagents-0.2.0}/tests/test_nli_skill.py +4 -4
  84. {webagents-0.1.12 → webagents-0.2.0}/tests/test_payment_skill.py +64 -64
  85. {webagents-0.1.12 → webagents-0.2.0}/tests/test_planner_skill.py +1 -1
  86. {webagents-0.1.12 → webagents-0.2.0}/tests/test_prompt_decorator.py +2 -2
  87. {webagents-0.1.12 → webagents-0.2.0}/tests/test_vector_memory_skill.py +5 -5
  88. webagents-0.1.12/tests/test_robutler_storage_skill.py → webagents-0.2.0/tests/test_webagents_storage_skill.py +38 -38
  89. {webagents-0.1.12 → webagents-0.2.0}/webagents/__init__.py +1 -1
  90. webagents-0.2.0/webagents/__main__.py +55 -0
  91. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/__init__.py +1 -1
  92. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/core/__init__.py +1 -1
  93. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/core/base_agent.py +15 -15
  94. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/core/handoffs.py +1 -1
  95. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/__init__.py +11 -11
  96. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/base.py +1 -1
  97. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/litellm/__init__.py +1 -1
  98. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/litellm/skill.py +1 -1
  99. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/mcp/README.md +2 -2
  100. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/mcp/skill.py +2 -2
  101. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/long_term_memory/memory_skill.py +14 -14
  102. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/short_term_memory/__init__.py +1 -1
  103. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/short_term_memory/skill.py +1 -1
  104. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/vector_memory/skill.py +6 -6
  105. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/planning/__init__.py +1 -1
  106. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/google/calendar/skill.py +1 -1
  107. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/__init__.py +2 -2
  108. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/auth/__init__.py +3 -3
  109. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/auth/skill.py +16 -16
  110. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/crm/__init__.py +2 -2
  111. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/crm/skill.py +5 -5
  112. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/discovery/README.md +5 -5
  113. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/discovery/__init__.py +2 -2
  114. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/discovery/skill.py +21 -21
  115. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/message_history/__init__.py +2 -2
  116. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/message_history/skill.py +5 -5
  117. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/nli/__init__.py +1 -1
  118. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/nli/skill.py +9 -9
  119. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/payments/__init__.py +3 -3
  120. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/payments/exceptions.py +1 -1
  121. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/payments/skill.py +23 -23
  122. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage/__init__.py +2 -2
  123. webagents-0.2.0/webagents/agents/skills/robutler/storage/files/__init__.py +9 -0
  124. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage/files/skill.py +4 -4
  125. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage/json/__init__.py +1 -1
  126. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage/json/skill.py +3 -3
  127. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage/kv/skill.py +3 -3
  128. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/storage.py +6 -6
  129. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/tools/decorators.py +12 -12
  130. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/__init__.py +3 -3
  131. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/context/context_vars.py +2 -2
  132. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/core/app.py +13 -13
  133. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/core/middleware.py +3 -3
  134. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/core/models.py +1 -1
  135. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/core/monitoring.py +2 -2
  136. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/middleware.py +1 -1
  137. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/models.py +2 -2
  138. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/monitoring.py +15 -15
  139. {webagents-0.1.12 → webagents-0.2.0}/webagents/utils/logging.py +20 -20
  140. webagents-0.1.12/DESIGN_COHERENCY_REVIEW.md +0 -143
  141. webagents-0.1.12/IMPLEMENTATION_STATUS.md +0 -242
  142. webagents-0.1.12/LICENSE +0 -1
  143. webagents-0.1.12/PAYMENT_TOKENS.md +0 -258
  144. webagents-0.1.12/PKG-INFO +0 -99
  145. webagents-0.1.12/README.md +0 -70
  146. webagents-0.1.12/README_HTTP_IMPLEMENTATION.md +0 -246
  147. webagents-0.1.12/README_VECTOR_MEMORY.md +0 -571
  148. webagents-0.1.12/architecture/ROBUTLER_V2_0_IMPLEMENTATION_PLAN.md +0 -775
  149. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch1_Overview.md +0 -313
  150. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch2_Core_Architecture.md +0 -1847
  151. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch3_Skills_System.md +0 -2902
  152. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch4_Server_Tools.md +0 -802
  153. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch5_Integration_Usage.md +0 -1425
  154. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_Ch6_Implementation_Guide.md +0 -1466
  155. webagents-0.1.12/architecture/ROBUTLER_V2_DESIGN_INDEX.md +0 -132
  156. webagents-0.1.12/architecture/STEP_1_5_COMPLETION_SUMMARY.md +0 -188
  157. webagents-0.1.12/architecture/STEP_2_2_COMPLETION_SUMMARY.md +0 -257
  158. webagents-0.1.12/demo_base_agent_capabilities.py +0 -241
  159. webagents-0.1.12/demo_handoff_rename.py +0 -90
  160. webagents-0.1.12/demo_http_capabilities.py +0 -268
  161. webagents-0.1.12/docs/CNAME +0 -1
  162. webagents-0.1.12/docs/api/agent.md +0 -420
  163. webagents-0.1.12/docs/api/client_core.md +0 -201
  164. webagents-0.1.12/docs/api/client_data.md +0 -57
  165. webagents-0.1.12/docs/api/client_exceptions.md +0 -166
  166. webagents-0.1.12/docs/api/decorators.md +0 -262
  167. webagents-0.1.12/docs/api/server.md +0 -672
  168. webagents-0.1.12/docs/api/skills/base.md +0 -197
  169. webagents-0.1.12/docs/api/skills/core.md +0 -350
  170. webagents-0.1.12/docs/api/skills/platform.md +0 -430
  171. webagents-0.1.12/docs/api/skills/types.md +0 -304
  172. webagents-0.1.12/docs/blog/posts/announcing-robutler.md +0 -27
  173. webagents-0.1.12/docs/blog/posts/launch.md +0 -10
  174. webagents-0.1.12/docs/blog/posts/nvidia-inception-program.md +0 -28
  175. webagents-0.1.12/docs/contact.md +0 -25
  176. webagents-0.1.12/docs/glossary.md +0 -93
  177. webagents-0.1.12/docs/index.md +0 -62
  178. webagents-0.1.12/docs/open-positions.md +0 -36
  179. webagents-0.1.12/docs/payment-errors.md +0 -244
  180. webagents-0.1.12/docs/press-kit.md +0 -95
  181. webagents-0.1.12/docs/robutler-agents.md +0 -36
  182. webagents-0.1.12/docs/sdk/agent/communication.md +0 -444
  183. webagents-0.1.12/docs/sdk/agent/configuration.md +0 -239
  184. webagents-0.1.12/docs/sdk/agent/endpoints.md +0 -554
  185. webagents-0.1.12/docs/sdk/agent/examples.md +0 -499
  186. webagents-0.1.12/docs/sdk/agent/overview.md +0 -177
  187. webagents-0.1.12/docs/sdk/agent/skills.md +0 -398
  188. webagents-0.1.12/docs/sdk/api-client.md +0 -343
  189. webagents-0.1.12/docs/sdk/architecture.md +0 -305
  190. webagents-0.1.12/docs/sdk/discovery-and-payments.md +0 -164
  191. webagents-0.1.12/docs/sdk/intent-discovery.md +0 -576
  192. webagents-0.1.12/docs/sdk/introduction.md +0 -101
  193. webagents-0.1.12/docs/sdk/monitoring.md +0 -251
  194. webagents-0.1.12/docs/sdk/openai-compatibility.md +0 -552
  195. webagents-0.1.12/docs/sdk/payment-system.md +0 -554
  196. webagents-0.1.12/docs/sdk/quickstart.md +0 -113
  197. webagents-0.1.12/docs/sdk/skills/custom.md +0 -425
  198. webagents-0.1.12/docs/sdk/skills/dependencies.md +0 -358
  199. webagents-0.1.12/docs/sdk/skills/overview.md +0 -302
  200. webagents-0.1.12/docs/skills/ecosystem/crewai.md +0 -38
  201. webagents-0.1.12/docs/skills/ecosystem/database.md +0 -39
  202. webagents-0.1.12/docs/skills/ecosystem/filesystem.md +0 -39
  203. webagents-0.1.12/docs/skills/ecosystem/google_calendar.md +0 -109
  204. webagents-0.1.12/docs/skills/ecosystem/n8n.md +0 -38
  205. webagents-0.1.12/docs/skills/overview.md +0 -69
  206. webagents-0.1.12/docs/user/agent.md +0 -133
  207. webagents-0.1.12/docs/user/assistant.md +0 -127
  208. webagents-0.1.12/docs/user/index.md +0 -55
  209. webagents-0.1.12/docs/user/robutler-agent.md +0 -43
  210. webagents-0.1.12/examples/dynamic_agents_demo.py +0 -90
  211. webagents-0.1.12/examples/extensive_agent_server.py +0 -336
  212. webagents-0.1.12/examples/serverbase_example.py +0 -395
  213. webagents-0.1.12/tests/README_HTTP_TESTS.md +0 -260
  214. webagents-0.1.12/tests/__init__.py +0 -1
  215. webagents-0.1.12/webagents/agents/skills/robutler/storage/files/__init__.py +0 -9
  216. webagents-0.1.12/webagents/api/__init__.py +0 -17
  217. webagents-0.1.12/webagents/api/client.py +0 -1207
  218. webagents-0.1.12/webagents/api/types.py +0 -253
  219. {webagents-0.1.12 → webagents-0.2.0}/.github/workflows/ci.yml +0 -0
  220. {webagents-0.1.12 → webagents-0.2.0}/.github/workflows/docs.yml +0 -0
  221. {webagents-0.1.12 → webagents-0.2.0}/.github/workflows/publish.yml +0 -0
  222. {webagents-0.1.12 → webagents-0.2.0}/.gitignore +0 -0
  223. {webagents-0.1.12 → webagents-0.2.0}/.vscode/launch.json +0 -0
  224. {webagents-0.1.12 → webagents-0.2.0}/.vscode/settings.json +0 -0
  225. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/Circle_Icon_W.png +0 -0
  226. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/Robutler_Logo_300.png +0 -0
  227. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/Robutler_Logo_Full.png +0 -0
  228. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/Robutler_OG_Card_B.png +0 -0
  229. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/Robutler_OG_Card_Nvidia_Yel.png +0 -0
  230. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/robutler-logo.svg +0 -0
  231. {webagents-0.1.12 → webagents-0.2.0}/docs/assets/robutler_logo.png +0 -0
  232. {webagents-0.1.12 → webagents-0.2.0}/docs/blog/.authors.yml +0 -0
  233. {webagents-0.1.12 → webagents-0.2.0}/docs/blog/index.md +0 -0
  234. {webagents-0.1.12 → webagents-0.2.0}/docs/gen_ref_pages.py +0 -0
  235. {webagents-0.1.12 → webagents-0.2.0}/docs/javascripts/mathjax.js +0 -0
  236. {webagents-0.1.12 → webagents-0.2.0}/docs/requirements.txt +0 -0
  237. {webagents-0.1.12 → webagents-0.2.0}/pytest.ini +0 -0
  238. {webagents-0.1.12 → webagents-0.2.0}/tests/agents/core/test_base_agent_init.py +0 -0
  239. {webagents-0.1.12 → webagents-0.2.0}/tests/agents/core/test_base_agent_quick.py +0 -0
  240. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/README.md +0 -0
  241. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/env.example +0 -0
  242. {webagents-0.1.12 → webagents-0.2.0}/tests/integration/openai_integration_config.md +0 -0
  243. {webagents-0.1.12 → webagents-0.2.0}/tests/skills/core/README.md +0 -0
  244. {webagents-0.1.12 → webagents-0.2.0}/tests/skills/core/mcp_test_config.json +0 -0
  245. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/handoffs/__init__.py +0 -0
  246. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/interfaces/__init__.py +0 -0
  247. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/lifecycle/__init__.py +0 -0
  248. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/__init__.py +0 -0
  249. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/guardrails/__init__.py +0 -0
  250. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/__init__.py +0 -0
  251. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/anthropic/__init__.py +0 -0
  252. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/openai/__init__.py +0 -0
  253. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/llm/xai/__init__.py +0 -0
  254. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/mcp/__init__.py +0 -0
  255. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/__init__.py +0 -0
  256. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/memory/long_term_memory/__init__.py +0 -0
  257. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/core/planning/planner.py +0 -0
  258. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/__init__.py +0 -0
  259. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/crewai/__init__.py +0 -0
  260. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/database/__init__.py +0 -0
  261. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/filesystem/__init__.py +0 -0
  262. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/google/__init__.py +0 -0
  263. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/google/calendar/__init__.py +0 -0
  264. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/n8n/__init__.py +0 -0
  265. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/openai_agents/__init__.py +0 -0
  266. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/web/__init__.py +0 -0
  267. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/ecosystem/zapier/__init__.py +0 -0
  268. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/auth/README.md +0 -0
  269. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/kv/__init__.py +0 -0
  270. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/kv/skill.py +0 -0
  271. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/messages/__init__.py +0 -0
  272. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/notifications/__init__.py +0 -0
  273. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/skills/robutler/notifications/skill.py +0 -0
  274. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/tools/__init__.py +0 -0
  275. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/tracing/__init__.py +0 -0
  276. {webagents-0.1.12 → webagents-0.2.0}/webagents/agents/workflows/__init__.py +0 -0
  277. {webagents-0.1.12 → webagents-0.2.0}/webagents/scripts/__init__.py +0 -0
  278. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/context/__init__.py +0 -0
  279. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/core/__init__.py +0 -0
  280. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/endpoints/__init__.py +0 -0
  281. {webagents-0.1.12 → webagents-0.2.0}/webagents/server/interfaces/__init__.py +0 -0
  282. {webagents-0.1.12 → webagents-0.2.0}/webagents/utils/__init__.py +0 -0
@@ -0,0 +1,23 @@
1
+ # Read the Docs configuration file
2
+ # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
3
+
4
+ # Required
5
+ version: 2
6
+
7
+ # Set the OS, Python version, and other tools you might need
8
+ build:
9
+ os: ubuntu-24.04
10
+ tools:
11
+ python: "3.13"
12
+
13
+ # Build documentation with Mkdocs
14
+ mkdocs:
15
+ configuration: mkdocs.yml
16
+
17
+ # Optionally, but recommended,
18
+ # declare the Python requirements required to build your documentation
19
+ # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
20
+ # python:
21
+ # install:
22
+ # - requirements: docs/requirements.txt
23
+
@@ -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,242 @@
1
+ Metadata-Version: 2.4
2
+ Name: webagents
3
+ Version: 0.2.0
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: dev
40
+ Requires-Dist: black>=23.0.0; extra == 'dev'
41
+ Requires-Dist: mypy>=1.0.0; extra == 'dev'
42
+ Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
43
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
44
+ Requires-Dist: ruff>=0.0.270; extra == 'dev'
45
+ Provides-Extra: examples
46
+ Requires-Dist: openai-agents>=0.0.16; extra == 'examples'
47
+ Description-Content-Type: text/markdown
48
+
49
+ # WebAgents - core framework for the Web of Agents
50
+
51
+ **Build, Serve and Monetize AI Agents**
52
+
53
+ 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.
54
+
55
+ [![PyPI version](https://badge.fury.io/py/webagents.svg)](https://badge.fury.io/py/webagents)
56
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
57
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
58
+
59
+ ## 🚀 Key Features
60
+
61
+ - **🧩 Modular Skills System** - Combine tools, prompts, hooks, and HTTP endpoints into reusable packages
62
+ - **🤝 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.
63
+ - **🔍 Real-Time Discovery** - Agents discover each other through intent matching - no manual integration
64
+ - **💰 Built-in Monetization** - Earn credits from priced tools with automatic billing
65
+ - **🔐 Trust & Security** - Secure authentication and scope-based access control
66
+ - **🌐 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.
67
+ - **🔌 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).
68
+
69
+ With WebAgents delegation, your agent is as powerful as the whole ecosystem, and capabilities of your agent grow together with the whole ecosystem.
70
+
71
+ ## 📦 Installation
72
+
73
+ ```bash
74
+ pip install webagents
75
+ ```
76
+
77
+ ## 🏃‍♂️ Quick Start
78
+
79
+ ### Create Your First Agent
80
+
81
+ ```python
82
+ from webagents.agents.core.base_agent import BaseAgent
83
+
84
+ # Create a basic agent
85
+ agent = BaseAgent(
86
+ name="assistant",
87
+ instructions="You are a helpful AI assistant.",
88
+ model="openai/gpt-4o-mini" # Automatically creates LLM skill
89
+ )
90
+
91
+ # Run chat completion
92
+ messages = [{"role": "user", "content": "Hello! What can you help me with?"}]
93
+ response = await agent.run(messages=messages)
94
+ print(response.content)
95
+ ```
96
+
97
+ ### Serve Your Agent
98
+
99
+ Deploy your agent as an OpenAI-compatible API server:
100
+
101
+ ```python
102
+ from webagents.server.core.app import create_server
103
+ import uvicorn
104
+
105
+ # Create server with your agent
106
+ server = create_server(agents=[agent])
107
+
108
+ # Run the server
109
+ uvicorn.run(server.app, host="0.0.0.0", port=8000)
110
+ ```
111
+
112
+ Test your agent API:
113
+ ```bash
114
+ curl -X POST http://localhost:8000/assistant/chat/completions \
115
+ -H "Content-Type: application/json" \
116
+ -d '{"messages": [{"role": "user", "content": "Hello!"}]}'
117
+ ```
118
+
119
+ ## 🧩 Skills Framework
120
+
121
+ Skills combine tools, prompts, hooks, and HTTP endpoints into easy-to-integrate packages:
122
+
123
+ ```python
124
+ from webagents.agents.skills.base import Skill
125
+ from webagents.agents.tools.decorators import tool, prompt, hook, http
126
+ from webagents.agents.skills.robutler.payments.skill import pricing
127
+
128
+ class NotificationsSkill(Skill):
129
+ @prompt(scope=["owner"])
130
+ def get_prompt(self) -> str:
131
+ return "You can send notifications using send_notification()."
132
+
133
+ @tool(scope="owner")
134
+ @pricing(credits_per_call=0.01)
135
+ async def send_notification(self, title: str, body: str) -> str:
136
+ # Your API integration
137
+ return f"✅ Notification sent: {title}"
138
+
139
+ @hook("on_message")
140
+ async def log_messages(self, context):
141
+ # React to incoming messages
142
+ return context
143
+
144
+ @http("POST", "/webhook")
145
+ async def handle_webhook(self, request):
146
+ # Custom HTTP endpoint
147
+ return {"status": "received"}
148
+ ```
149
+
150
+ **Core Skills** - Essential functionality:
151
+ - **LLM Skills**: OpenAI, Anthropic, LiteLLM integration
152
+ - **Memory Skills**: Short-term, long-term, and vector memory
153
+ - **MCP Skill**: Model Context Protocol integration
154
+
155
+ **Platform Skills** - WebAgents ecosystem:
156
+ - **Discovery**: Real-time agent discovery and routing
157
+ - **Authentication**: Secure agent-to-agent communication
158
+ - **Payments**: Monetization and automatic billing
159
+ - **Storage**: Persistent data and messaging
160
+
161
+ **Ecosystem Skills** - External integrations:
162
+ - **Google**: Calendar, Drive, Gmail integration
163
+ - **Database**: SQL and NoSQL database access
164
+ - **Workflow**: CrewAI, N8N, Zapier automation
165
+
166
+ ## 💰 Monetization
167
+
168
+ Add payments to earn credits from your agent:
169
+
170
+ ```python
171
+ from webagents.agents.core.base_agent import BaseAgent
172
+ from webagents.agents.skills.robutler.payments.skill import PaymentSkill, pricing
173
+ from webagents.agents.tools.decorators import tool
174
+
175
+ # Define a priced tool (fixed pricing)
176
+ @tool
177
+ @pricing(credits_per_call=0.01, reason="Image generation")
178
+ def generate_thumbnail(url: str, size: int = 256) -> dict:
179
+ """Create a thumbnail for a public image URL."""
180
+ # ... your processing logic here ...
181
+ return {"url": url, "thumbnail_size": size, "status": "created"}
182
+
183
+
184
+ agent = BaseAgent(
185
+ name="thumbnail-generator",
186
+ model="openai/gpt-4o-mini",
187
+ skills={
188
+ "payments": PaymentSkill(),
189
+ },
190
+ # Auto-register priced tool as capability
191
+ capabilities=[generate_thumbnail],
192
+ )
193
+ ```
194
+
195
+ ## 🔧 Environment Setup
196
+
197
+ Set up your API keys for LLM providers:
198
+
199
+ ```bash
200
+ export OPENAI_API_KEY="your-openai-key"
201
+
202
+ # Robutler API key for payments
203
+ export WEBAGENTS_API_KEY="your-webagents-key"
204
+ ```
205
+
206
+ Get your WEBAGENTS_API_KEY at https://robutler.ai
207
+
208
+
209
+ ## 🌐 Web of Agents
210
+
211
+ WebAgents enables dynamic real-time orchestration where each AI agent acts as a building block for other agents:
212
+
213
+ - **🚀 Real-Time Discovery**: Think DNS for agent intents - agents find each other through natural language
214
+ - **🔐 Trust & Security**: Secure authentication with audit trails for all transactions
215
+ - **💡 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.
216
+
217
+ ## 📚 Documentation
218
+
219
+ - **[Full Documentation](https://webagents.robutler.ai)** - Complete guides and API reference
220
+ - **[Skills Framework](https://webagents.robutler.ai/skills/overview/)** - Deep dive into modular capabilities
221
+ - **[Agent Architecture](https://webagents.robutler.ai/agent/overview/)** - Understand agent communication
222
+ - **[Custom Skills](https://webagents.robutler.ai/skills/custom/)** - Build your own capabilities
223
+
224
+ ## 🤝 Contributing
225
+
226
+ We welcome contributions! Please see our [Contributing Guide](https://webagents.robutler.ai/developers/contributing/) for details.
227
+
228
+ ## 📄 License
229
+
230
+ This project is licensed under the MIT License - see the [LICENSE](https://webagents.robutler.ai/license/) file for details.
231
+
232
+ ## 🆘 Support
233
+
234
+ - **GitHub Issues**: [Report bugs and request features](https://github.com/robutlerai/webagents/issues)
235
+ - **Documentation**: [webagents.robutler.ai](https://webagents.robutler.ai)
236
+ - **Community**: Join our Discord server for discussions and support
237
+
238
+ ---
239
+
240
+ **Focus on what makes your agent unique instead of spending time on plumbing.**
241
+
242
+ Built with ❤️ by the [WebAgents team](https://robutler.ai) and community contributors.
@@ -0,0 +1,194 @@
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
+ pip install webagents
27
+ ```
28
+
29
+ ## 🏃‍♂️ Quick Start
30
+
31
+ ### Create Your First Agent
32
+
33
+ ```python
34
+ from webagents.agents.core.base_agent import BaseAgent
35
+
36
+ # Create a basic agent
37
+ agent = BaseAgent(
38
+ name="assistant",
39
+ instructions="You are a helpful AI assistant.",
40
+ model="openai/gpt-4o-mini" # Automatically creates LLM skill
41
+ )
42
+
43
+ # Run chat completion
44
+ messages = [{"role": "user", "content": "Hello! What can you help me with?"}]
45
+ response = await agent.run(messages=messages)
46
+ print(response.content)
47
+ ```
48
+
49
+ ### Serve Your Agent
50
+
51
+ Deploy your agent as an OpenAI-compatible API server:
52
+
53
+ ```python
54
+ from webagents.server.core.app import create_server
55
+ import uvicorn
56
+
57
+ # Create server with your agent
58
+ server = create_server(agents=[agent])
59
+
60
+ # Run the server
61
+ uvicorn.run(server.app, host="0.0.0.0", port=8000)
62
+ ```
63
+
64
+ Test your agent API:
65
+ ```bash
66
+ curl -X POST http://localhost:8000/assistant/chat/completions \
67
+ -H "Content-Type: application/json" \
68
+ -d '{"messages": [{"role": "user", "content": "Hello!"}]}'
69
+ ```
70
+
71
+ ## 🧩 Skills Framework
72
+
73
+ Skills combine tools, prompts, hooks, and HTTP endpoints into easy-to-integrate packages:
74
+
75
+ ```python
76
+ from webagents.agents.skills.base import Skill
77
+ from webagents.agents.tools.decorators import tool, prompt, hook, http
78
+ from webagents.agents.skills.robutler.payments.skill import pricing
79
+
80
+ class NotificationsSkill(Skill):
81
+ @prompt(scope=["owner"])
82
+ def get_prompt(self) -> str:
83
+ return "You can send notifications using send_notification()."
84
+
85
+ @tool(scope="owner")
86
+ @pricing(credits_per_call=0.01)
87
+ async def send_notification(self, title: str, body: str) -> str:
88
+ # Your API integration
89
+ return f"✅ Notification sent: {title}"
90
+
91
+ @hook("on_message")
92
+ async def log_messages(self, context):
93
+ # React to incoming messages
94
+ return context
95
+
96
+ @http("POST", "/webhook")
97
+ async def handle_webhook(self, request):
98
+ # Custom HTTP endpoint
99
+ return {"status": "received"}
100
+ ```
101
+
102
+ **Core Skills** - Essential functionality:
103
+ - **LLM Skills**: OpenAI, Anthropic, LiteLLM integration
104
+ - **Memory Skills**: Short-term, long-term, and vector memory
105
+ - **MCP Skill**: Model Context Protocol integration
106
+
107
+ **Platform Skills** - WebAgents ecosystem:
108
+ - **Discovery**: Real-time agent discovery and routing
109
+ - **Authentication**: Secure agent-to-agent communication
110
+ - **Payments**: Monetization and automatic billing
111
+ - **Storage**: Persistent data and messaging
112
+
113
+ **Ecosystem Skills** - External integrations:
114
+ - **Google**: Calendar, Drive, Gmail integration
115
+ - **Database**: SQL and NoSQL database access
116
+ - **Workflow**: CrewAI, N8N, Zapier automation
117
+
118
+ ## 💰 Monetization
119
+
120
+ Add payments to earn credits from your agent:
121
+
122
+ ```python
123
+ from webagents.agents.core.base_agent import BaseAgent
124
+ from webagents.agents.skills.robutler.payments.skill import PaymentSkill, pricing
125
+ from webagents.agents.tools.decorators import tool
126
+
127
+ # Define a priced tool (fixed pricing)
128
+ @tool
129
+ @pricing(credits_per_call=0.01, reason="Image generation")
130
+ def generate_thumbnail(url: str, size: int = 256) -> dict:
131
+ """Create a thumbnail for a public image URL."""
132
+ # ... your processing logic here ...
133
+ return {"url": url, "thumbnail_size": size, "status": "created"}
134
+
135
+
136
+ agent = BaseAgent(
137
+ name="thumbnail-generator",
138
+ model="openai/gpt-4o-mini",
139
+ skills={
140
+ "payments": PaymentSkill(),
141
+ },
142
+ # Auto-register priced tool as capability
143
+ capabilities=[generate_thumbnail],
144
+ )
145
+ ```
146
+
147
+ ## 🔧 Environment Setup
148
+
149
+ Set up your API keys for LLM providers:
150
+
151
+ ```bash
152
+ export OPENAI_API_KEY="your-openai-key"
153
+
154
+ # Robutler API key for payments
155
+ export WEBAGENTS_API_KEY="your-webagents-key"
156
+ ```
157
+
158
+ Get your WEBAGENTS_API_KEY at https://robutler.ai
159
+
160
+
161
+ ## 🌐 Web of Agents
162
+
163
+ WebAgents enables dynamic real-time orchestration where each AI agent acts as a building block for other agents:
164
+
165
+ - **🚀 Real-Time Discovery**: Think DNS for agent intents - agents find each other through natural language
166
+ - **🔐 Trust & Security**: Secure authentication with audit trails for all transactions
167
+ - **💡 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.
168
+
169
+ ## 📚 Documentation
170
+
171
+ - **[Full Documentation](https://webagents.robutler.ai)** - Complete guides and API reference
172
+ - **[Skills Framework](https://webagents.robutler.ai/skills/overview/)** - Deep dive into modular capabilities
173
+ - **[Agent Architecture](https://webagents.robutler.ai/agent/overview/)** - Understand agent communication
174
+ - **[Custom Skills](https://webagents.robutler.ai/skills/custom/)** - Build your own capabilities
175
+
176
+ ## 🤝 Contributing
177
+
178
+ We welcome contributions! Please see our [Contributing Guide](https://webagents.robutler.ai/developers/contributing/) for details.
179
+
180
+ ## 📄 License
181
+
182
+ This project is licensed under the MIT License - see the [LICENSE](https://webagents.robutler.ai/license/) file for details.
183
+
184
+ ## 🆘 Support
185
+
186
+ - **GitHub Issues**: [Report bugs and request features](https://github.com/robutlerai/webagents/issues)
187
+ - **Documentation**: [webagents.robutler.ai](https://webagents.robutler.ai)
188
+ - **Community**: Join our Discord server for discussions and support
189
+
190
+ ---
191
+
192
+ **Focus on what makes your agent unique instead of spending time on plumbing.**
193
+
194
+ 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
 
@@ -0,0 +1,22 @@
1
+ # Documentation Improvements
2
+
3
+ ## Consistency & Links
4
+ - Add anchors in `docs/skills/overview.md` for sections referenced from other pages (e.g., `#2-implement-core-functionality`, `#best-practices`, `#4-implement-lifecycle-hooks`, `#5-enable-smart-routing`) or update all incoming links to point to the correct headings.
5
+ - Ensure all platform skill links consistently use `skills/platform/...` relative paths from root-level docs.
6
+
7
+ ## Under Construction Notices
8
+ - Replace illustrative code in ecosystem skill pages with short notices once implementations land (filesystem, database, crewai, n8n), and add minimal working snippets.
9
+ - Consider a single "Roadmap" page linking all under-construction skills for transparency.
10
+
11
+ ## Examples
12
+ - Add curl examples for `@http` endpoints in `docs/sdk/agent/endpoints.md` that include typical headers and error cases.
13
+ - Provide a minimal end-to-end sample in `examples/` that matches Quickstart (agent + one platform skill + serve).
14
+
15
+ ## Navigation
16
+ - Revisit nav grouping names for clarity: "Skills Repository" vs "Architecture". Consider a short landing page that explains both “using skills” and “building skills.”
17
+
18
+ ## Style
19
+ - Keep admonitions to 2–3 per page; convert informational notes to inline sentences where possible.
20
+ - Maintain consistent heading levels and intro summaries at the top of each page.
21
+
22
+
@@ -0,0 +1 @@
1
+ webagents.robutler.ai