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.
- {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/docs.yml +1 -1
- webagents-0.2.2/CONTRIBUTING.md +57 -0
- webagents-0.2.2/LICENSE +20 -0
- webagents-0.2.2/PKG-INFO +266 -0
- webagents-0.2.2/README.md +201 -0
- {webagents-0.1.13 → webagents-0.2.2}/RELEASE.md +4 -4
- webagents-0.2.2/docs/agent/endpoints.md +123 -0
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/handoffs.md +8 -8
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/hooks.md +4 -4
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/lifecycle.md +22 -18
- webagents-0.2.2/docs/agent/overview.md +213 -0
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/prompts.md +3 -3
- webagents-0.2.2/docs/agent/skills.md +126 -0
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/agent/tools.md +6 -6
- {webagents-0.1.13 → webagents-0.2.2}/docs/developers/contributing.md +20 -20
- {webagents-0.1.13 → webagents-0.2.2}/docs/developers/development.md +5 -5
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/dynamic-agents.md +4 -4
- webagents-0.2.2/docs/index.md +130 -0
- webagents-0.2.2/docs/license.md +9 -0
- webagents-0.2.2/docs/quickstart.md +106 -0
- webagents-0.1.13/docs/sdk/v2-server-guide.md → webagents-0.2.2/docs/server-architecture.md +6 -6
- {webagents-0.1.13/docs/sdk → webagents-0.2.2/docs}/server.md +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/llm.md +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/mcp.md +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/core/memory.md +3 -3
- webagents-0.2.2/docs/skills/custom.md +98 -0
- webagents-0.2.2/docs/skills/ecosystem/crewai.md +263 -0
- webagents-0.2.2/docs/skills/ecosystem/database.md +67 -0
- webagents-0.2.2/docs/skills/ecosystem/filesystem.md +36 -0
- webagents-0.2.2/docs/skills/ecosystem/google.md +225 -0
- webagents-0.2.2/docs/skills/ecosystem/index.md +204 -0
- webagents-0.2.2/docs/skills/ecosystem/mongodb.md +68 -0
- webagents-0.2.2/docs/skills/ecosystem/n8n.md +62 -0
- webagents-0.2.2/docs/skills/ecosystem/x_com.md +65 -0
- webagents-0.2.2/docs/skills/ecosystem/zapier.md +62 -0
- webagents-0.2.2/docs/skills/overview.md +39 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/auth.md +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/discovery.md +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/files.md +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/kv.md +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/nli.md +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/notifications.md +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/docs/skills/platform/payments.md +7 -7
- {webagents-0.1.13 → webagents-0.2.2}/docs/stylesheets/extra.css +30 -2
- webagents-0.2.2/examples/minimal_quickstart.py +18 -0
- webagents-0.1.13/examples/v2_server_demo.py → webagents-0.2.2/examples/server_demo.py +6 -6
- {webagents-0.1.13 → webagents-0.2.2}/examples/simple_demo.py +6 -6
- {webagents-0.1.13 → webagents-0.2.2}/mkdocs.yml +52 -62
- {webagents-0.1.13 → webagents-0.2.2}/pyproject.toml +21 -5
- webagents-0.2.2/requirements-ecosystem.txt +17 -0
- webagents-0.2.2/requirements.txt +41 -0
- webagents-0.2.2/tests/__init__.py +1 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_http.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_scopes.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_http_capabilities_integration.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/tests/fixtures/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/integration_config.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_discovery_skill_integration.py +33 -33
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_dynamic_agents_integration.py +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_external_tools_integration.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_integration_litellm.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_integration_openai.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/test_payment_skill_integration.py +30 -30
- {webagents-0.1.13 → webagents-0.2.2}/tests/run_http_tests.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/conftest.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_dynamic_agents.py +10 -10
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_http_server_integration.py +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_models.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_monitoring.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_server_core.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_server_streaming.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_streaming_compliance.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/server/test_tool_execution.py +8 -8
- {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/conftest.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/test_mcp_skill.py +25 -25
- {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/test_mcp_skill_backup.py +25 -25
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_auth_skill.py +36 -36
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_basic_agent.py +1 -1
- webagents-0.2.2/tests/test_crewai_skill.py +243 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_decorators.py +23 -23
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_discovery_skill.py +29 -29
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_litellm_skill.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_long_term_memory_skill.py +17 -17
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_memory_skills.py +1 -1
- webagents-0.2.2/tests/test_mongodb_skill.py +543 -0
- webagents-0.2.2/tests/test_n8n_skill.py +394 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_nli_skill.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_payment_skill.py +64 -64
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_planner_skill.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_prompt_decorator.py +2 -2
- webagents-0.2.2/tests/test_supabase_skill.py +462 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/test_vector_memory_skill.py +5 -5
- webagents-0.1.13/tests/test_robutler_storage_skill.py → webagents-0.2.2/tests/test_webagents_storage_skill.py +38 -38
- webagents-0.2.2/tests/test_x_com.py +332 -0
- webagents-0.2.2/tests/test_zapier_skill.py +412 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/__init__.py +1 -1
- webagents-0.2.2/webagents/__main__.py +55 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/base_agent.py +15 -15
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/core/handoffs.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/__init__.py +11 -11
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/base.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/litellm/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/litellm/skill.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/README.md +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/skill.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/long_term_memory/memory_skill.py +14 -14
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/short_term_memory/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/short_term_memory/skill.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/vector_memory/skill.py +6 -6
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/planning/__init__.py +1 -1
- webagents-0.2.2/webagents/agents/skills/ecosystem/crewai/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/crewai/skill.py +158 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/database/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/database/skill.py +522 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/calendar/skill.py +1 -1
- webagents-0.2.2/webagents/agents/skills/ecosystem/mongodb/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/mongodb/skill.py +428 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/README.md +287 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/n8n/skill.py +341 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/README.md +401 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/x_com/skill.py +1048 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/README.md +363 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/__init__.py +3 -0
- webagents-0.2.2/webagents/agents/skills/ecosystem/zapier/skill.py +337 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/__init__.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/skill.py +16 -16
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/crm/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/crm/skill.py +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/README.md +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/discovery/skill.py +21 -21
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/message_history/__init__.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/message_history/skill.py +5 -5
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/nli/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/nli/skill.py +9 -9
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/__init__.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/exceptions.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/payments/skill.py +23 -23
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/__init__.py +2 -2
- webagents-0.2.2/webagents/agents/skills/robutler/storage/files/__init__.py +9 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/files/skill.py +4 -4
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/json/__init__.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/json/skill.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage/kv/skill.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/storage.py +6 -6
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/tools/decorators.py +12 -12
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/__init__.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/context/context_vars.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/app.py +13 -13
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/middleware.py +3 -3
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/models.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/core/monitoring.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/middleware.py +1 -1
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/models.py +2 -2
- {webagents-0.1.13 → webagents-0.2.2}/webagents/server/monitoring.py +15 -15
- {webagents-0.1.13 → webagents-0.2.2}/webagents/utils/logging.py +20 -20
- webagents-0.1.13/.vscode/launch.json +0 -87
- webagents-0.1.13/DESIGN_COHERENCY_REVIEW.md +0 -143
- webagents-0.1.13/IMPLEMENTATION_STATUS.md +0 -242
- webagents-0.1.13/LICENSE +0 -1
- webagents-0.1.13/PAYMENT_TOKENS.md +0 -258
- webagents-0.1.13/PKG-INFO +0 -32
- webagents-0.1.13/README.md +0 -3
- webagents-0.1.13/README_HTTP_IMPLEMENTATION.md +0 -246
- webagents-0.1.13/README_VECTOR_MEMORY.md +0 -571
- webagents-0.1.13/architecture/ROBUTLER_V2_0_IMPLEMENTATION_PLAN.md +0 -775
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch1_Overview.md +0 -313
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch2_Core_Architecture.md +0 -1847
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch3_Skills_System.md +0 -2902
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch4_Server_Tools.md +0 -802
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch5_Integration_Usage.md +0 -1425
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_Ch6_Implementation_Guide.md +0 -1466
- webagents-0.1.13/architecture/ROBUTLER_V2_DESIGN_INDEX.md +0 -132
- webagents-0.1.13/architecture/STEP_1_5_COMPLETION_SUMMARY.md +0 -188
- webagents-0.1.13/architecture/STEP_2_2_COMPLETION_SUMMARY.md +0 -257
- webagents-0.1.13/demo_base_agent_capabilities.py +0 -241
- webagents-0.1.13/demo_handoff_rename.py +0 -90
- webagents-0.1.13/demo_http_capabilities.py +0 -268
- webagents-0.1.13/docs/CNAME +0 -1
- webagents-0.1.13/docs/api/agent.md +0 -420
- webagents-0.1.13/docs/api/client_core.md +0 -201
- webagents-0.1.13/docs/api/client_data.md +0 -57
- webagents-0.1.13/docs/api/client_exceptions.md +0 -166
- webagents-0.1.13/docs/api/decorators.md +0 -262
- webagents-0.1.13/docs/api/server.md +0 -672
- webagents-0.1.13/docs/api/skills/base.md +0 -197
- webagents-0.1.13/docs/api/skills/core.md +0 -350
- webagents-0.1.13/docs/api/skills/platform.md +0 -430
- webagents-0.1.13/docs/api/skills/types.md +0 -304
- webagents-0.1.13/docs/blog/posts/announcing-robutler.md +0 -27
- webagents-0.1.13/docs/blog/posts/launch.md +0 -10
- webagents-0.1.13/docs/blog/posts/nvidia-inception-program.md +0 -28
- webagents-0.1.13/docs/contact.md +0 -25
- webagents-0.1.13/docs/glossary.md +0 -93
- webagents-0.1.13/docs/index.md +0 -62
- webagents-0.1.13/docs/open-positions.md +0 -36
- webagents-0.1.13/docs/payment-errors.md +0 -244
- webagents-0.1.13/docs/press-kit.md +0 -95
- webagents-0.1.13/docs/robutler-agents.md +0 -36
- webagents-0.1.13/docs/sdk/agent/communication.md +0 -444
- webagents-0.1.13/docs/sdk/agent/configuration.md +0 -239
- webagents-0.1.13/docs/sdk/agent/endpoints.md +0 -554
- webagents-0.1.13/docs/sdk/agent/examples.md +0 -499
- webagents-0.1.13/docs/sdk/agent/overview.md +0 -177
- webagents-0.1.13/docs/sdk/agent/skills.md +0 -398
- webagents-0.1.13/docs/sdk/api-client.md +0 -343
- webagents-0.1.13/docs/sdk/architecture.md +0 -305
- webagents-0.1.13/docs/sdk/discovery-and-payments.md +0 -164
- webagents-0.1.13/docs/sdk/intent-discovery.md +0 -576
- webagents-0.1.13/docs/sdk/introduction.md +0 -101
- webagents-0.1.13/docs/sdk/monitoring.md +0 -251
- webagents-0.1.13/docs/sdk/openai-compatibility.md +0 -552
- webagents-0.1.13/docs/sdk/payment-system.md +0 -554
- webagents-0.1.13/docs/sdk/quickstart.md +0 -113
- webagents-0.1.13/docs/sdk/skills/custom.md +0 -425
- webagents-0.1.13/docs/sdk/skills/dependencies.md +0 -358
- webagents-0.1.13/docs/sdk/skills/overview.md +0 -302
- webagents-0.1.13/docs/skills/ecosystem/crewai.md +0 -38
- webagents-0.1.13/docs/skills/ecosystem/database.md +0 -39
- webagents-0.1.13/docs/skills/ecosystem/filesystem.md +0 -39
- webagents-0.1.13/docs/skills/ecosystem/google.md +0 -39
- webagents-0.1.13/docs/skills/ecosystem/google_calendar.md +0 -109
- webagents-0.1.13/docs/skills/ecosystem/n8n.md +0 -38
- webagents-0.1.13/docs/skills/ecosystem/zapier.md +0 -38
- webagents-0.1.13/docs/skills/overview.md +0 -69
- webagents-0.1.13/docs/user/agent.md +0 -133
- webagents-0.1.13/docs/user/assistant.md +0 -127
- webagents-0.1.13/docs/user/index.md +0 -55
- webagents-0.1.13/docs/user/robutler-agent.md +0 -43
- webagents-0.1.13/examples/dynamic_agents_demo.py +0 -90
- webagents-0.1.13/examples/extensive_agent_server.py +0 -336
- webagents-0.1.13/examples/serverbase_example.py +0 -395
- webagents-0.1.13/tests/README_HTTP_TESTS.md +0 -260
- webagents-0.1.13/tests/__init__.py +0 -1
- webagents-0.1.13/tests/integration/README.md +0 -223
- webagents-0.1.13/tests/integration/env.example +0 -44
- webagents-0.1.13/tests/skills/core/README.md +0 -155
- webagents-0.1.13/webagents/agents/skills/ecosystem/crewai/__init__.py +0 -1
- webagents-0.1.13/webagents/agents/skills/ecosystem/database/__init__.py +0 -1
- webagents-0.1.13/webagents/agents/skills/robutler/storage/files/__init__.py +0 -9
- webagents-0.1.13/webagents/api/__init__.py +0 -17
- webagents-0.1.13/webagents/api/client.py +0 -1207
- webagents-0.1.13/webagents/api/types.py +0 -253
- webagents-0.1.13/webagents/server/interfaces/__init__.py +0 -0
- webagents-0.1.13/webagents/utils/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/ci.yml +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/.github/workflows/publish.yml +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/.gitignore +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/.vscode/settings.json +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Circle_Icon_W.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_Logo_300.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_Logo_Full.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_OG_Card_B.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/Robutler_OG_Card_Nvidia_Yel.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/robutler-logo.svg +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/assets/robutler_logo.png +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/blog/.authors.yml +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/blog/index.md +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/gen_ref_pages.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/javascripts/mathjax.js +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/docs/requirements.txt +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/pytest.ini +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_init.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/agents/core/test_base_agent_quick.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/integration/openai_integration_config.md +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/tests/skills/core/mcp_test_config.json +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/handoffs/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/interfaces/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/lifecycle/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/guardrails/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/anthropic/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/openai/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/llm/xai/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/mcp/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/memory/long_term_memory/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/core/planning/planner.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/filesystem/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/ecosystem/google/calendar/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/skills/ecosystem/n8n → webagents-0.2.2/webagents/agents/skills/ecosystem/openai_agents}/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/skills/ecosystem/openai_agents → webagents-0.2.2/webagents/agents/skills/ecosystem/web}/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/auth/README.md +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/kv/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/kv/skill.py +0 -0
- {webagents-0.1.13/webagents/agents/skills/ecosystem/web → webagents-0.2.2/webagents/agents/skills/robutler/messages}/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/notifications/__init__.py +0 -0
- {webagents-0.1.13 → webagents-0.2.2}/webagents/agents/skills/robutler/notifications/skill.py +0 -0
- {webagents-0.1.13/webagents/agents/skills/ecosystem/zapier → webagents-0.2.2/webagents/agents/tools}/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/skills/robutler/messages → webagents-0.2.2/webagents/agents/tracing}/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/tools → webagents-0.2.2/webagents/agents/workflows}/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/tracing → webagents-0.2.2/webagents/scripts}/__init__.py +0 -0
- {webagents-0.1.13/webagents/agents/workflows → webagents-0.2.2/webagents/server/context}/__init__.py +0 -0
- {webagents-0.1.13/webagents/scripts → webagents-0.2.2/webagents/server/core}/__init__.py +0 -0
- {webagents-0.1.13/webagents/server/context → webagents-0.2.2/webagents/server/endpoints}/__init__.py +0 -0
- {webagents-0.1.13/webagents/server/core → webagents-0.2.2/webagents/server/interfaces}/__init__.py +0 -0
- {webagents-0.1.13/webagents/server/endpoints → webagents-0.2.2/webagents/utils}/__init__.py +0 -0
@@ -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!
|
webagents-0.2.2/LICENSE
ADDED
@@ -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.
|
webagents-0.2.2/PKG-INFO
ADDED
@@ -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
|
+
[](https://badge.fury.io/py/webagents)
|
73
|
+
[](https://www.python.org/downloads/)
|
74
|
+
[](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
|
+
[](https://badge.fury.io/py/webagents)
|
8
|
+
[](https://www.python.org/downloads/)
|
9
|
+
[](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
|
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 `
|
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
|
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 `
|
124
|
+
4. **Permission Errors**: Ensure your PyPI account has maintainer access to the `webagents` package
|
125
125
|
|
126
126
|
### Getting Help
|
127
127
|
|