88 lines
2.4 KiB
Python
88 lines
2.4 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Integration abstraction layer for Agentic OS.
|
|
|
|
Design:
|
|
- Each adapter implements a tiny, uniform interface.
|
|
- The OS only talks to manager.run_pipeline(); it never calls
|
|
adapter-specific endpoints directly.
|
|
- Adapters are optional. If a service is disabled or missing
|
|
credentials, the manager records a skip/error and continues.
|
|
|
|
Adapter contract:
|
|
create_project(name, description, **kwargs) -> dict with at least id/name
|
|
update_project(external_id, updates) -> dict or None
|
|
append_note(target_id, text) -> dict or None
|
|
create_task(project_id, title, **kwargs) -> dict or None
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any, Dict, List, Optional
|
|
|
|
# ---- config loader -----------------------------------------------------------
|
|
|
|
import json
|
|
import os
|
|
from pathlib import Path
|
|
|
|
INTEGRATIONS_DIR = Path(__file__).parent
|
|
CONFIG_FILE = INTEGRATIONS_DIR / "config.json"
|
|
|
|
|
|
def _load_json(path: Path) -> Dict[str, Any]:
|
|
if not path.exists():
|
|
return {}
|
|
try:
|
|
return json.loads(path.read_text(encoding="utf-8"))
|
|
except Exception:
|
|
return {}
|
|
|
|
|
|
def load_integration_config() -> Dict[str, Any]:
|
|
cfg = _load_json(CONFIG_FILE)
|
|
return cfg
|
|
|
|
|
|
# ---- result helpers ----------------------------------------------------------
|
|
|
|
class Result:
|
|
def __init__(self, ok: bool, data: Any = None, error: Optional[str] = None):
|
|
self.ok = ok
|
|
self.data = data
|
|
self.error = error
|
|
|
|
def to_dict(self) -> Dict[str, Any]:
|
|
return {"ok": self.ok, "data": self.data, "error": self.error}
|
|
|
|
|
|
def _fail(error: str) -> Result:
|
|
return Result(False, None, error)
|
|
|
|
|
|
def _ok(data: Any) -> Result:
|
|
return Result(True, data, None)
|
|
|
|
|
|
# ---- adapter types -----------------------------------------------------------
|
|
|
|
class BaseAdapter:
|
|
"""Override only what this integration supports."""
|
|
|
|
name: str = "base"
|
|
|
|
def enabled(self, cfg: Dict[str, Any]) -> bool:
|
|
return bool(cfg.get("enabled", False))
|
|
|
|
def create_project(self, name: str, description: str = "", **kwargs: Any) -> Result:
|
|
return _fail("not implemented")
|
|
|
|
def update_project(self, external_id: str, updates: Dict[str, Any]) -> Result:
|
|
return _fail("not implemented")
|
|
|
|
def append_note(self, target_id: str, text: str) -> Result:
|
|
return _fail("not implemented")
|
|
|
|
def create_task(self, project_id: str, title: str, **kwargs: Any) -> Result:
|
|
return _fail("not implemented")
|