airbyte-agent-orb 0.1.6__tar.gz

airbyte_agent_orb-0.1.6/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml

airbyte_agent_orb-0.1.6/AUTH.md

@@ -0,0 +1,99 @@
+# Orb authentication and configuration
+
+This page documents the authentication and configuration options for the Orb agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Orb API key |
+
+Example request:
+
+```python
+from airbyte_agent_orb import OrbConnector
+from airbyte_agent_orb.models import OrbAuthConfig
+
+connector = OrbConnector(
+    auth_config=OrbAuthConfig(
+        api_key="<Your Orb API key>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Orb API key |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <SCOPED_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Orb",
+    "name": "My Orb Connector",
+    "credentials": {
+      "api_key": "<Your Orb API key>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_orb import OrbConnector
+
+connector = OrbConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@OrbConnector.tool_utils
+async def orb_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+

airbyte_agent_orb-0.1.6/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Orb changelog
+
+## [0.1.6] - 2026-02-02
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 9d9866b0
+- SDK version: 0.1.0
+
+## [0.1.5] - 2026-01-30
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: b184da3e
+- SDK version: 0.1.0
+
+## [0.1.4] - 2026-01-30
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 5b20f488
+- SDK version: 0.1.0
+
+## [0.1.3] - 2026-01-30
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: a3729d85
+- SDK version: 0.1.0
+
+## [0.1.2] - 2026-01-29
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 43200eed
+- SDK version: 0.1.0
+
+## [0.1.1] - 2026-01-29
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: c718c683
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-29
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 68ca482c
+- SDK version: 0.1.0

airbyte_agent_orb-0.1.6/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-orb
+Version: 0.1.6
+Summary: Airbyte Orb Connector for AI platforms
+Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,api,connector,data-integration,llm,mcp,orb
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Orb agent connector
+
+Orb is a usage-based billing platform that enables businesses to implement flexible pricing models,
+track customer usage, and manage subscriptions. This connector provides access to customers,
+subscriptions, plans, and invoices for billing analytics and customer management.
+
+
+## Example questions
+
+The Orb connector is optimized to handle prompts like these.
+
+- Show me all my customers in Orb
+- List all active subscriptions
+- What plans are available?
+- Show me recent invoices
+- Get details for customer \{customer_id\}
+- What is the status of subscription \{subscription_id\}?
+- List all invoices for a specific customer
+- Show me the pricing details for plan \{plan_id\}
+- List all subscriptions for customer XYZ
+- Show all active subscriptions for a specific customer
+- What subscriptions does customer \{external_customer_id\} have?
+- Confirm the Stripe ID linked to this customer
+- What is the payment provider ID for customer \{customer_id\}?
+- Pull all invoices from the last month
+- Show invoices created after \{date\}
+- List all paid invoices for customer \{customer_id\}
+- What invoices are in draft status?
+- Show all issued invoices for subscription \{subscription_id\}
+
+## Unsupported questions
+
+The Orb connector isn't currently able to handle prompts like these.
+
+- Create a new customer in Orb
+- Update subscription details
+- Delete a customer record
+- Send an invoice to a customer
+- Filter subscriptions by plan name (must filter client-side after listing)
+- Pull customers billed for specific products (must examine invoice line_items client-side)
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-orb
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_orb import OrbConnector
+from airbyte_agent_orb.models import OrbAuthConfig
+
+connector = OrbConnector(
+    auth_config=OrbAuthConfig(
+        api_key="<Your Orb API key>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@OrbConnector.tool_utils
+async def orb_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_orb import OrbConnector
+
+connector = OrbConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@OrbConnector.tool_utils
+async def orb_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customers | [List](./REFERENCE.md#customers-list), [Get](./REFERENCE.md#customers-get) |
+| Subscriptions | [List](./REFERENCE.md#subscriptions-list), [Get](./REFERENCE.md#subscriptions-get) |
+| Plans | [List](./REFERENCE.md#plans-list), [Get](./REFERENCE.md#plans-get) |
+| Invoices | [List](./REFERENCE.md#invoices-list), [Get](./REFERENCE.md#invoices-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Orb API docs
+
+See the official [Orb API reference](https://docs.withorb.com/api-reference).
+
+## Version information
+
+- **Package version:** 0.1.6
+- **Connector version:** 0.1.1
+- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/orb/CHANGELOG.md)

airbyte_agent_orb-0.1.6/README.md

@@ -0,0 +1,120 @@
+# Orb agent connector
+
+Orb is a usage-based billing platform that enables businesses to implement flexible pricing models,
+track customer usage, and manage subscriptions. This connector provides access to customers,
+subscriptions, plans, and invoices for billing analytics and customer management.
+
+
+## Example questions
+
+The Orb connector is optimized to handle prompts like these.
+
+- Show me all my customers in Orb
+- List all active subscriptions
+- What plans are available?
+- Show me recent invoices
+- Get details for customer \{customer_id\}
+- What is the status of subscription \{subscription_id\}?
+- List all invoices for a specific customer
+- Show me the pricing details for plan \{plan_id\}
+- List all subscriptions for customer XYZ
+- Show all active subscriptions for a specific customer
+- What subscriptions does customer \{external_customer_id\} have?
+- Confirm the Stripe ID linked to this customer
+- What is the payment provider ID for customer \{customer_id\}?
+- Pull all invoices from the last month
+- Show invoices created after \{date\}
+- List all paid invoices for customer \{customer_id\}
+- What invoices are in draft status?
+- Show all issued invoices for subscription \{subscription_id\}
+
+## Unsupported questions
+
+The Orb connector isn't currently able to handle prompts like these.
+
+- Create a new customer in Orb
+- Update subscription details
+- Delete a customer record
+- Send an invoice to a customer
+- Filter subscriptions by plan name (must filter client-side after listing)
+- Pull customers billed for specific products (must examine invoice line_items client-side)
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-orb
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_orb import OrbConnector
+from airbyte_agent_orb.models import OrbAuthConfig
+
+connector = OrbConnector(
+    auth_config=OrbAuthConfig(
+        api_key="<Your Orb API key>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@OrbConnector.tool_utils
+async def orb_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_orb import OrbConnector
+
+connector = OrbConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@OrbConnector.tool_utils
+async def orb_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customers | [List](./REFERENCE.md#customers-list), [Get](./REFERENCE.md#customers-get) |
+| Subscriptions | [List](./REFERENCE.md#subscriptions-list), [Get](./REFERENCE.md#subscriptions-get) |
+| Plans | [List](./REFERENCE.md#plans-list), [Get](./REFERENCE.md#plans-get) |
+| Invoices | [List](./REFERENCE.md#invoices-list), [Get](./REFERENCE.md#invoices-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Orb API docs
+
+See the official [Orb API reference](https://docs.withorb.com/api-reference).
+
+## Version information
+
+- **Package version:** 0.1.6
+- **Connector version:** 0.1.1
+- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/orb/CHANGELOG.md)