Skip to content

Fix #3: 💰 Bounty: API Documentation + Python SDK (100 tokens)#4

Open
danielalanbates wants to merge 1 commit intodmb4086:masterfrom
danielalanbates:fix/issue-3
Open

Fix #3: 💰 Bounty: API Documentation + Python SDK (100 tokens)#4
danielalanbates wants to merge 1 commit intodmb4086:masterfrom
danielalanbates:fix/issue-3

Conversation

@danielalanbates
Copy link

Fixes #3

Summary

This PR addresses: 💰 Bounty: API Documentation + Python SDK (100 tokens)

Changes

agent-suite-sdk/agent_suite_sdk/__init__.py   |  60 +++
 agent-suite-sdk/agent_suite_sdk/client.py     | 482 ++++++++++++++++++++++
 agent-suite-sdk/agent_suite_sdk/exceptions.py |  88 ++++
 agent-suite-sdk/agent_suite_sdk/models.py     |  92 +++++
 agent-suite-sdk/pyproject.toml                |  52 +++
 agent-suite-sdk/tests/__init__.py             |   0
 agent-suite-sdk/tests/test_client.py          | 551 ++++++++++++++++++++++++++
 docs/openapi.yaml                             | 457 +++++++++++++++++++++
 examples/async_usage.py                       |  58 +++
 examples/basic_usage.py                       |  87 ++++
 examples/webhook_handler.py                   |  70 ++++
 11 files changed, 1997 insertions(+)

Testing

Please review the changes carefully. The fix was verified against the existing test suite.


This PR was created with the assistance of Claude Opus 4.6 by Anthropic | effort: high (extended thinking). Happy to make any adjustments!

By submitting this pull request, I confirm that my contribution is made under the terms of the project's license (contributor license agreement).

- Add OpenAPI 3.1 spec (docs/openapi.yaml) documenting all 6 endpoints
  with schemas, auth, and examples
- Add agent-suite-sdk Python package with:
  - Sync (AgentSuiteClient) and async (AsyncAgentSuiteClient) clients
  - Typed Pydantic models for all requests/responses
  - Custom exception hierarchy (Auth, NotFound, RateLimit, ServerError)
  - Configurable retry with exponential backoff and Retry-After support
  - httpx for HTTP transport (async-ready)
  - pip-installable via pyproject.toml
- Add 38 comprehensive SDK tests (all passing) covering:
  - Every public method (sync and async)
  - Error handling for all HTTP status codes
  - Retry logic with backoff
  - Model validation and exception hierarchy
- Add usage examples:
  - basic_usage.py: sync client walkthrough
  - async_usage.py: async client with concurrent ops
  - webhook_handler.py: webhook proxy pattern

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

💰 Bounty: API Documentation + Python SDK (100 tokens)

1 participant