{
  "id": "page:docs-adapters-archive-research-programmatic-adapter-opportunities",
  "_kind": "Page",
  "_file": "wiki/docs/adapters/archive/research/programmatic-adapter-opportunities.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/adapters/archive/research/programmatic-adapter-opportunities.md",
    "sourceKind": "repo-docs",
    "title": "Programmatic Adapter Opportunities Research",
    "displayName": "Programmatic Adapter Opportunities Research",
    "slug": "docs/adapters/archive/research/programmatic-adapter-opportunities",
    "articlePath": "wiki/docs/adapters/archive/research/programmatic-adapter-opportunities.md",
    "article": "\n# Programmatic Adapter Opportunities Research\n\nThis document summarizes research into which existing subprocess-based adapters would benefit from programmatic SDK or remote API variants.\n\n## Current State\n\n### Existing Adapter Types\n- **Subprocess adapters** (11): cursor, copilot, gemini, qwen, hermes, omp, openclaw, claude, codex, pi, opencode\n- **Programmatic adapters** (3): claude-agent-sdk, codex-sdk, pi-sdk  \n- **Remote adapters** (3): opencode-http, codex-websocket, adapters-remote\n\n## Research Results\n\n### High Priority Candidates\n\n#### 1. Google Gemini SDK Adapter\n- **Current**: `gemini` CLI command\n- **Opportunity**: Official Google AI SDKs (Python, Node.js, Go, Java)\n- **Benefits**:\n  - Direct SDK integration eliminates CLI subprocess overhead\n  - Better streaming support with WebSocket via Gemini Live API\n  - Native tool calling without CLI parsing\n  - Production-ready officially supported libraries\n- **Recommendation**: Implement `gemini-sdk-adapter` extending BaseProgrammaticAdapter\n\n#### 2. Qwen/DashScope SDK Adapter  \n- **Current**: `qwen` CLI command\n- **Opportunity**: Official Alibaba DashScope SDKs + OpenAI-compatible API\n- **Benefits**:\n  - Already uses OpenAI-compatible API underneath CLI\n  - Official Python/Node.js SDKs available\n  - Async/streaming support built-in\n  - Significant performance improvement over CLI\n- **Recommendation**: Implement `qwen-sdk-adapter` extending BaseProgrammaticAdapter\n\n#### 3. GitHub Copilot SDK Adapter\n- **Current**: `gh copilot` CLI extension  \n- **Opportunity**: New GitHub Copilot SDK (public preview as of April 2026)\n- **Benefits**:\n  - Same engine as CLI but with programmatic control\n  - Multi-language SDKs (Python, TypeScript, Go, .NET, Java)\n  - OpenTelemetry support for distributed tracing\n  - JSON-RPC communication with Copilot server\n- **Recommendation**: Implement `copilot-sdk-adapter` extending BaseProgrammaticAdapter\n\n### Medium Priority Candidates\n\n#### 4. Cursor API Adapter\n- **Current**: `cursor-agent` CLI command\n- **Opportunity**: Community reverse-engineered APIs (HTTP/2 + streaming)\n- **Status**: No official SDK, but APIs exist\n- **Recommendation**: Monitor for official API release before implementing\n\n#### 5. Hermes RPC Adapter\n- **Current**: `hermes` CLI command  \n- **Opportunity**: Proposed RPC mode + existing REST endpoints\n- **Status**: RPC mode not yet implemented\n- **Recommendation**: Consider when RPC mode becomes available\n\n#### 6. OpenClaw SDK Adapter\n- **Current**: `openclaw` CLI command\n- **Opportunity**: Python SDK (`openclaw-py`) + REST API\n- **Benefits**: Open-source with plugin system\n- **Recommendation**: Medium priority for open-source integration scenarios\n\n### Not Recommended\n\n#### 7. OMP/MCP\n- **Analysis**: MCP is a protocol standard, not an agent platform\n- **Current Support**: Already integrated in existing adapters via MCP plugin support\n- **Recommendation**: No separate adapter needed\n\n## Implementation Recommendations\n\n### Phase 1: High-Impact SDK Adapters\n1. `gemini-sdk-adapter` - Google AI SDK integration\n2. `qwen-sdk-adapter` - DashScope SDK integration  \n3. `copilot-sdk-adapter` - GitHub Copilot SDK integration\n\n### Phase 2: API/Remote Adapters\n4. `cursor-api-adapter` - When official API becomes available\n5. `hermes-rpc-adapter` - When RPC mode is implemented\n\n### Phase 3: Specialty Adapters  \n6. `openclaw-sdk-adapter` - For open-source integration needs\n\n## Technical Approach\n\n### Programmatic Adapters\n- Extend `BaseProgrammaticAdapter`\n- Use official SDKs for direct integration\n- Implement streaming via SDK native capabilities\n- Mock implementations for testing\n\n### Remote Adapters\n- Extend `BaseRemoteAdapter`\n- HTTP/WebSocket connections to APIs\n- Server lifecycle management\n- Real-time bidirectional communication\n\n## Next Steps\n\n1. **Implement high-priority SDK adapters** (gemini-sdk, qwen-sdk, copilot-sdk)\n2. **Update adapter validation** to support non-subprocess adapter types\n3. **Create comprehensive tests** for new adapter variants\n4. **Update documentation** with new adapter capabilities\n5. **Monitor** Cursor and Hermes for official API releases\n\n## Sources\n\n- [Gemini API libraries | Google AI for Developers](https://ai.google.dev/gemini-api/docs/libraries)\n- [Install DashScope and OpenAI SDKs | Alibaba Cloud Model Studio](https://www.alibabacloud.com/help/en/model-studio/install-sdk)  \n- [GitHub Copilot SDK | GitHub](https://github.com/github/copilot-sdk)\n- [Cursor APIs Overview | Cursor Docs](https://cursor.com/docs/api)\n- [Hermes Agent | NousResearch](https://github.com/nousresearch/hermes-agent)\n- [OpenClaw | GitHub](https://github.com/openclaw/openclaw)\n- [Model Context Protocol | GitHub](https://github.com/modelcontextprotocol)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-adapters-archive-research",
      "to": "page:docs-adapters-archive-research-programmatic-adapter-opportunities",
      "kind": "contains_page"
    }
  ]
}