wehub-resource-sync
4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
44 lines
1.5 KiB
Plaintext
44 lines
1.5 KiB
Plaintext
---
|
|
description: Integration client patterns
|
|
globs:
|
|
- integrations/**
|
|
---
|
|
|
|
# Integration Clients
|
|
|
|
## Directory Structure
|
|
|
|
All vendor integrations live under `integrations/<vendor>/`. There is no
|
|
`services/` directory — it was removed in the V0.2 Phase 1 refactor.
|
|
|
|
```
|
|
integrations/
|
|
├── grafana/
|
|
│ └── tools/ # Vendor tools (moved from tools/ in T-3)
|
|
├── datadog/
|
|
│ ├── tools/
|
|
│ └── correlation/ # Vendor-specific sub-packages where needed
|
|
├── <vendor>/ # One directory per vendor (60+ vendors)
|
|
│ └── tools/ # Vendor tools live here
|
|
├── opensre_mcp.py # MCP server implementation
|
|
└── ...
|
|
```
|
|
## Adding a New Integration
|
|
|
|
1. Create a directory `integrations/<vendor>/`
|
|
2. Add client code (connection, auth, API methods) directly in the vendor dir
|
|
3. Create a tool under `integrations/<vendor>/tools/<tool_name>/` that uses the client
|
|
4. Wire availability into `resolve_integrations` node if the integration requires
|
|
runtime discovery
|
|
5. Add the vendor to `EvidenceSource` literal in `core/domain/types/evidence.py`
|
|
if it is a new source type
|
|
|
|
## Conventions
|
|
|
|
- Clients should be stateless or use context managers for connection lifecycle
|
|
- Return `{"success": bool, "data": ..., "error": ...}` from client methods
|
|
- Keep API-specific logic in the client; the tool handles param extraction and
|
|
result formatting
|
|
- MCP tools are registered via `opensre-mcp` entry point in `pyproject.toml`
|
|
- All directory names use **snake_case** — no PascalCase
|