process-gpt-agent-sdk 0.3.15__tar.gz → 0.3.17__tar.gz

{process_gpt_agent_sdk-0.3.15 → process_gpt_agent_sdk-0.3.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: process-gpt-agent-sdk
-Version: 0.3.15
+Version: 0.3.17
 Summary: Supabase 기반 이벤트/작업 폴링으로 A2A AgentExecutor를 실행하는 SDK
 License: MIT
 Project-URL: Homepage, https://github.com/your-org/process-gpt-agent-sdk
@@ -13,14 +13,10 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: supabase>=2.0.0
+Requires-Dist: openai>=1.30.0
 Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: click>=8.0.0
-Requires-Dist: asyncio-mqtt>=0.13.0
-Requires-Dist: jsonschema>=4.0.0
-Requires-Dist: structlog>=23.0.0
-Requires-Dist: typing-extensions>=4.0.0
-Requires-Dist: python-dateutil>=2.8.0
 Requires-Dist: a2a-sdk==0.3.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < "3.11"
 
 # ProcessGPT Agent Framework
 ## A2A SDK 연동을 위한 경량 에이전트 서버 프레임워크
@@ -40,7 +36,6 @@ Supabase 기반의 프로세스 작업(Todolist)을 폴링하고, A2A 규격 이
 |------------|------|-----------|----------------|
 | `task_started` | 작업 시작 | 작업 처리 시작시 | 수동 설정 |
 | `task_completed` | 작업 완료 | 작업 정상 완료시 | 수동 설정 |
-| `crew_completed` | 크루 작업 완료 | 서버가 작업 종료시 | **자동 설정** |
 | `tool_usage_started` | 도구 사용 시작 | 외부 도구/API 호출 시작 | 수동 설정 |
 | `tool_usage_finished` | 도구 사용 완료 | 외부 도구/API 호출 완료 | 수동 설정 |
 | `human_asked` | 사용자 입력 요청 | HITL 패턴 사용시 | **자동 설정** |
@@ -662,3 +657,7 @@ python my_server.py
 - **TaskStatusUpdateEvent** → `events` 테이블 (`data` 컬럼)
 - **TaskArtifactUpdateEvent** → `todolist` 테이블 (`output` 컬럼)
 - 래퍼 자동 제거 후 순수 payload만 저장
+
+
+## 버전업
+./release.sh 버전

{process_gpt_agent_sdk-0.3.15 → process_gpt_agent_sdk-0.3.17}/README.md

@@ -16,7 +16,6 @@ Supabase 기반의 프로세스 작업(Todolist)을 폴링하고, A2A 규격 이
 |------------|------|-----------|----------------|
 | `task_started` | 작업 시작 | 작업 처리 시작시 | 수동 설정 |
 | `task_completed` | 작업 완료 | 작업 정상 완료시 | 수동 설정 |
-| `crew_completed` | 크루 작업 완료 | 서버가 작업 종료시 | **자동 설정** |
 | `tool_usage_started` | 도구 사용 시작 | 외부 도구/API 호출 시작 | 수동 설정 |
 | `tool_usage_finished` | 도구 사용 완료 | 외부 도구/API 호출 완료 | 수동 설정 |
 | `human_asked` | 사용자 입력 요청 | HITL 패턴 사용시 | **자동 설정** |
@@ -638,3 +637,7 @@ python my_server.py
 - **TaskStatusUpdateEvent** → `events` 테이블 (`data` 컬럼)
 - **TaskArtifactUpdateEvent** → `todolist` 테이블 (`output` 컬럼)
 - 래퍼 자동 제거 후 순수 payload만 저장
+
+
+## 버전업
+./release.sh 버전

{process_gpt_agent_sdk-0.3.15 → process_gpt_agent_sdk-0.3.17}/process_gpt_agent_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: process-gpt-agent-sdk
-Version: 0.3.15
+Version: 0.3.17
 Summary: Supabase 기반 이벤트/작업 폴링으로 A2A AgentExecutor를 실행하는 SDK
 License: MIT
 Project-URL: Homepage, https://github.com/your-org/process-gpt-agent-sdk
@@ -13,14 +13,10 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: supabase>=2.0.0
+Requires-Dist: openai>=1.30.0
 Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: click>=8.0.0
-Requires-Dist: asyncio-mqtt>=0.13.0
-Requires-Dist: jsonschema>=4.0.0
-Requires-Dist: structlog>=23.0.0
-Requires-Dist: typing-extensions>=4.0.0
-Requires-Dist: python-dateutil>=2.8.0
 Requires-Dist: a2a-sdk==0.3.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < "3.11"
 
 # ProcessGPT Agent Framework
 ## A2A SDK 연동을 위한 경량 에이전트 서버 프레임워크
@@ -40,7 +36,6 @@ Supabase 기반의 프로세스 작업(Todolist)을 폴링하고, A2A 규격 이
 |------------|------|-----------|----------------|
 | `task_started` | 작업 시작 | 작업 처리 시작시 | 수동 설정 |
 | `task_completed` | 작업 완료 | 작업 정상 완료시 | 수동 설정 |
-| `crew_completed` | 크루 작업 완료 | 서버가 작업 종료시 | **자동 설정** |
 | `tool_usage_started` | 도구 사용 시작 | 외부 도구/API 호출 시작 | 수동 설정 |
 | `tool_usage_finished` | 도구 사용 완료 | 외부 도구/API 호출 완료 | 수동 설정 |
 | `human_asked` | 사용자 입력 요청 | HITL 패턴 사용시 | **자동 설정** |
@@ -662,3 +657,7 @@ python my_server.py
 - **TaskStatusUpdateEvent** → `events` 테이블 (`data` 컬럼)
 - **TaskArtifactUpdateEvent** → `todolist` 테이블 (`output` 컬럼)
 - 래퍼 자동 제거 후 순수 payload만 저장
+
+
+## 버전업
+./release.sh 버전

{process_gpt_agent_sdk-0.3.15 → process_gpt_agent_sdk-0.3.17}/process_gpt_agent_sdk.egg-info/SOURCES.txt

@@ -7,4 +7,5 @@ process_gpt_agent_sdk.egg-info/requires.txt
 process_gpt_agent_sdk.egg-info/top_level.txt
 processgpt_agent_sdk/__init__.py
 processgpt_agent_sdk/database.py
-processgpt_agent_sdk/processgpt_agent_framework.py
+processgpt_agent_sdk/processgpt_agent_framework.py
+processgpt_agent_sdk/utils.py

process_gpt_agent_sdk-0.3.17/process_gpt_agent_sdk.egg-info/requires.txt

@@ -0,0 +1,7 @@
+supabase>=2.0.0
+openai>=1.30.0
+python-dotenv>=1.0.0
+a2a-sdk==0.3.0
+
+[:python_version < "3.11"]
+typing-extensions>=4.0.0

{process_gpt_agent_sdk-0.3.15 → process_gpt_agent_sdk-0.3.17}/processgpt_agent_sdk/__init__.py

@@ -1,33 +1,25 @@
-from .processgpt_agent_framework import ProcessGPTAgentServer
-from .database import (
-    initialize_db,
-    get_consumer_id,
-    polling_pending_todos,
-    record_event,
-    save_task_result,
-    update_task_error,
-    fetch_agent_data,
-    fetch_all_agents,
-    fetch_form_types,
-    fetch_tenant_mcp_config,
-    fetch_human_users_by_proc_inst_id,
-)
-
-__all__ = [
-    "ProcessGPTAgentServer",
-    "initialize_db",
-    "get_consumer_id",
-    "polling_pending_todos",
-    "record_event",
-    "save_task_result",
-    "update_task_error",
-    "fetch_agent_data",
-    "fetch_all_agents",
-    "fetch_form_types",
-    "fetch_tenant_mcp_config",
-    "fetch_human_users_by_proc_inst_id",
-]
-
-__version__ = "0.3.12"
-
-
+from .processgpt_agent_framework import ProcessGPTAgentServer
+from .database import (
+    initialize_db,
+    get_consumer_id,
+    polling_pending_todos,
+    record_event,
+    record_events_bulk,
+    save_task_result,
+    update_task_error,
+    fetch_context_bundle,
+)
+from .utils import summarize_error_to_user
+
+__all__ = [
+    "ProcessGPTAgentServer",
+    "initialize_db",
+    "get_consumer_id",
+    "polling_pending_todos",
+    "record_event",
+    "record_events_bulk",
+    "save_task_result",
+    "update_task_error",
+    "fetch_context_bundle",
+    "summarize_error_to_user",
+]

process_gpt_agent_sdk-0.3.17/processgpt_agent_sdk/database.py

@@ -0,0 +1,259 @@
+import os
+import json
+import asyncio
+import socket
+from typing import Any, Dict, List, Optional, Tuple, Callable, TypeVar
+
+from dotenv import load_dotenv
+from supabase import Client, create_client
+import logging
+import random
+
+T = TypeVar("T")
+logger = logging.getLogger(__name__)
+
+# ------------------------------ Retry & JSON utils ------------------------------
+async def _async_retry(
+    fn: Callable[[], Any],
+    *,
+    name: str,
+    retries: int = 3,
+    base_delay: float = 0.8,
+    fallback: Optional[Callable[[], Any]] = None,
+) -> Optional[Any]:
+    """
+    - 각 시도 실패: warning 로깅(시도/지연/에러 포함)
+    - 최종 실패: FATAL 로깅(스택 포함), 예외는 재전파하지 않고 None 반환(기존 정책 유지)
+    - fallback 이 있으면 실행(실패 시에도 로깅 후 None)
+    """
+    last_err: Optional[Exception] = None
+    for attempt in range(1, retries + 1):
+        try:
+            return await asyncio.to_thread(fn)
+        except Exception as e:
+            last_err = e
+            jitter = random.uniform(0, 0.3)
+            delay = base_delay * (2 ** (attempt - 1)) + jitter
+            logger.warning(
+                "retry warn: name=%s attempt=%d/%d delay=%.2fs error=%s",
+                name, attempt, retries, delay, str(e),
+                exc_info=e
+            )
+            await asyncio.sleep(delay)
+
+    # 최종 실패
+    if last_err is not None:
+        logger.error(
+            "FATAL: retry failed: name=%s retries=%s error=%s",
+            name, retries, str(last_err), exc_info=last_err
+        )
+
+    if fallback is not None:
+        try:
+            return fallback()
+        except Exception as fb_err:
+            logger.error("fallback failed: name=%s error=%s", name, str(fb_err), exc_info=fb_err)
+            return None
+    return None
+
+def _to_jsonable(value: Any) -> Any:
+    try:
+        if value is None or isinstance(value, (str, int, float, bool)):
+            return value
+        if isinstance(value, dict):
+            return {str(k): _to_jsonable(v) for k, v in value.items()}
+        if isinstance(value, (list, tuple, set)):
+            return [_to_jsonable(v) for v in list(value)]
+        if hasattr(value, "__dict__"):
+            return _to_jsonable(vars(value))
+        return repr(value)
+    except Exception:
+        return repr(value)
+
+# ------------------------------ DB Client ------------------------------
+_supabase_client: Optional[Client] = None
+
+def initialize_db() -> None:
+    global _supabase_client
+    if _supabase_client is not None:
+        return
+    try:
+        if os.getenv("ENV") != "production":
+            load_dotenv()
+        supabase_url = os.getenv("SUPABASE_URL") or os.getenv("SUPABASE_KEY_URL")
+        supabase_key = os.getenv("SUPABASE_KEY") or os.getenv("SUPABASE_ANON_KEY")
+        if not supabase_url or not supabase_key:
+            raise RuntimeError("SUPABASE_URL 및 SUPABASE_KEY가 필요합니다")
+        _supabase_client = create_client(supabase_url, supabase_key)
+    except Exception as e:
+        logger.error("initialize_db failed: %s", str(e), exc_info=e)
+        raise
+
+def get_db_client() -> Client:
+    if _supabase_client is None:
+        raise RuntimeError("DB 미초기화: initialize_db() 먼저 호출")
+    return _supabase_client
+
+def get_consumer_id() -> str:
+    env_consumer = os.getenv("CONSUMER_ID")
+    if env_consumer:
+        return env_consumer
+    host = socket.gethostname()
+    pid = os.getpid()
+    return f"{host}:{pid}"
+
+# ------------------------------ Polling ------------------------------
+async def polling_pending_todos(agent_orch: str, consumer: str) -> Optional[Dict[str, Any]]:
+    """단일 RPC(fetch_pending_task) 호출: p_env 로 dev/prod 분기"""
+    if agent_orch is None:
+        agent_orch = ""
+    if consumer is None:
+        consumer = ""
+
+    def _call():
+        client = get_db_client()
+        consumer_id = consumer or socket.gethostname()
+
+        # ENV 값을 dev / (그외=prod) 로만 정규화
+        p_env = (os.getenv("ENV") or "").lower()
+        if p_env != "dev":
+            p_env = "prod"
+
+        resp = client.rpc(
+            "fetch_pending_task",
+            {
+                "p_agent_orch": agent_orch,
+                "p_consumer": consumer_id,
+                "p_limit": 1,
+                "p_env": p_env,
+            },
+        ).execute()
+
+        rows = resp.data or []
+        return rows[0] if rows else None
+
+    return await _async_retry(_call, name="polling_pending_todos", fallback=lambda: None)
+
+# ------------------------------ Context Bundle ------------------------------
+async def fetch_context_bundle(
+    proc_inst_id: str,
+    tenant_id: str,
+    tool_val: str,
+    user_ids: str,
+) -> Tuple[str, Optional[Dict[str, Any]], Tuple[Optional[str], List[Dict[str, Any]], Optional[str]], List[Dict[str, Any]]]:
+    def _call():
+        client = get_db_client()
+        resp = client.rpc(
+            "fetch_context_bundle",
+            {
+                "p_proc_inst_id": proc_inst_id or "",
+                "p_tenant_id": tenant_id or "",
+                "p_tool": tool_val or "",
+                "p_user_ids": user_ids or "",
+            },
+        ).execute()
+        rows = resp.data or []
+        row = rows[0] if rows else {}
+        notify = (row.get("notify_emails") or "").strip()
+        mcp = row.get("tenant_mcp") or None
+        form_id = row.get("form_id")
+        form_fields = row.get("form_fields") or [{"key": form_id, "type": "default", "text": ""}]
+        form_html = row.get("form_html")
+        agents = row.get("agents") or []
+        return notify, mcp, (form_id, form_fields, form_html), agents
+
+    try:
+        return await _async_retry(_call, name="fetch_context_bundle", fallback=lambda: ("", None, (None, [], None), []))
+    except Exception as e:
+        logger.error("fetch_context_bundle fatal: %s", str(e), exc_info=e)
+        return ("", None, (None, [], None), [])
+
+# ------------------------------ Events & Results ------------------------------
+async def record_events_bulk(payloads: List[Dict[str, Any]]) -> None:
+    """
+    이벤트 다건 저장:
+    - 성공: 'record_events_bulk ok'
+    - 실패(최종): '❌ record_events_bulk failed' (개수 포함)
+    """
+    if not payloads:
+        return
+
+    safe_list: List[Dict[str, Any]] = []
+    for p in payloads:
+        sp = _to_jsonable(p)
+        if isinstance(sp, dict) and sp.get("status", "") == "":
+            sp["status"] = None
+        safe_list.append(sp)
+
+    def _call():
+        client = get_db_client()
+        return client.rpc("record_events_bulk", {"p_events": safe_list}).execute()
+
+    res = await _async_retry(_call, name="record_events_bulk", fallback=lambda: None)
+    if res is None:
+        logger.error("❌ record_events_bulk failed: events not persisted count=%d", len(safe_list))
+    else:
+        logger.info("record_events_bulk ok: count=%d", len(safe_list))
+
+async def record_event(payload: Dict[str, Any]) -> None:
+    """
+    단건 이벤트 저장.
+    - 성공: 'record_event ok'
+    - 실패(최종): '❌ record_event failed'
+    - 실패해도 워크플로우는 계속(요청사항)
+    """
+    if not payload:
+        return
+
+    def _call():
+        client = get_db_client()
+        safe_payload = _to_jsonable(payload)
+        if isinstance(safe_payload, dict) and safe_payload.get("status", "") == "":
+            safe_payload["status"] = None
+        return client.table("events").insert(safe_payload).execute()
+
+    res = await _async_retry(_call, name="record_event", fallback=lambda: None)
+    if res is None:
+        logger.error("❌ record_event failed =%s", payload.get("event_type"))
+    else:
+        logger.info("record_event ok: event_type=%s", payload.get("event_type"))
+
+async def save_task_result(todo_id: str, result: Any, final: bool = False) -> None:
+    if not todo_id:
+        logger.error("save_task_result invalid todo_id: %s", str(todo_id))
+        return
+
+    def _safe(val: Any) -> Any:
+        try:
+            return _to_jsonable(val)
+        except Exception:
+            try:
+                return {"repr": repr(val)}
+            except Exception:
+                return {"error": "unserializable payload"}
+
+    def _call():
+        client = get_db_client()
+        payload = _safe(result)
+        return client.rpc("save_task_result", {"p_todo_id": todo_id, "p_payload": payload, "p_final": bool(final)}).execute()
+
+    res = await _async_retry(_call, name="save_task_result", fallback=lambda: None)
+    if res is None:
+        logger.error("❌ save_task_result failed todo_id=%s", todo_id)
+    else:
+        logger.info("save_task_result ok todo_id=%s", todo_id)
+
+# ------------------------------ Failure Status ------------------------------
+async def update_task_error(todo_id: str) -> None:
+    if not todo_id:
+        return
+
+    def _call():
+        client = get_db_client()
+        return client.table("todolist").update({"draft_status": "FAILED", "consumer": None}).eq("id", todo_id).execute()
+
+    res = await _async_retry(_call, name="update_task_error", fallback=lambda: None)
+    if res is None:
+        logger.error("❌ update_task_error failed todo_id=%s", todo_id)
+    else:
+        logger.info("update_task_error ok todo_id=%s", todo_id)