process-gpt-agent-sdk 0.3.18__py3-none-any.whl → 0.3.20__py3-none-any.whl

{process_gpt_agent_sdk-0.3.18.dist-info → process_gpt_agent_sdk-0.3.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: process-gpt-agent-sdk
-Version: 0.3.18
+Version: 0.3.20
 Summary: Supabase 기반 이벤트/작업 폴링으로 A2A AgentExecutor를 실행하는 SDK
 License: MIT
 Project-URL: Homepage, https://github.com/your-org/process-gpt-agent-sdk

process_gpt_agent_sdk-0.3.20.dist-info/RECORD

@@ -0,0 +1,8 @@
+processgpt_agent_sdk/__init__.py,sha256=4-Wt-FRImZa1tG4CWx2ZtICcnTkKoAiqAfva9vLitLQ,991
+processgpt_agent_sdk/database.py,sha256=4oQxJ3y28pPdUpvcQ80DEcFmcvKH37RszhSSZKf6tJU,12690
+processgpt_agent_sdk/processgpt_agent_framework.py,sha256=PPAmWX1IV2SXTvLrkFXHgpuNw0xvKJP5vbXzW4GFx0Y,22940
+processgpt_agent_sdk/utils.py,sha256=XNL-PId5xflUiTF3HQ3lOF264e4y85MXZJOfPix32Iw,8429
+process_gpt_agent_sdk-0.3.20.dist-info/METADATA,sha256=hiif_fASGX7GRlU81ei1hL4M5PFbVqXUp5vx04IrGfI,21981
+process_gpt_agent_sdk-0.3.20.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+process_gpt_agent_sdk-0.3.20.dist-info/top_level.txt,sha256=Xe6zrj3_3Vv7d0pl5RRtenVUckwOVBVLQn2P03j5REo,21
+process_gpt_agent_sdk-0.3.20.dist-info/RECORD,,

processgpt_agent_sdk/__init__.py

@@ -1,4 +1,9 @@
-from .processgpt_agent_framework import ProcessGPTAgentServer
+from .processgpt_agent_framework import (
+    ProcessGPTAgentServer,
+    ProcessGPTRequestContext,
+    ProcessGPTEventQueue,
+    ContextPreparationError,
+)
 from .database import (
     initialize_db,
     get_consumer_id,
@@ -7,12 +12,21 @@ from .database import (
     record_events_bulk,
     save_task_result,
     update_task_error,
-    fetch_context_bundle,
+    fetch_form_def,
+    fetch_users_grouped,
+    fetch_email_users_by_proc_inst_id,
+    fetch_tenant_mcp,
+)
+from .utils import (
+    summarize_error_to_user,
+    summarize_feedback,
 )
-from .utils import summarize_error_to_user
 
 __all__ = [
     "ProcessGPTAgentServer",
+    "ProcessGPTRequestContext",
+    "ProcessGPTEventQueue",
+    "ContextPreparationError",
     "initialize_db",
     "get_consumer_id",
     "polling_pending_todos",
@@ -20,6 +34,10 @@ __all__ = [
     "record_events_bulk",
     "save_task_result",
     "update_task_error",
-    "fetch_context_bundle",
+    "fetch_form_def",
+    "fetch_users_grouped",
+    "fetch_email_users_by_proc_inst_id",
+    "fetch_tenant_mcp",
     "summarize_error_to_user",
+    "summarize_feedback",
 ]

processgpt_agent_sdk/database.py

@@ -130,57 +130,27 @@ async def polling_pending_todos(agent_orch: str, consumer: str) -> Optional[Dict
         ).execute()
 
         rows = resp.data or []
-        return rows[0] if rows else None
+        if not rows:
+            return None
+        
+        row = rows[0]
+        # 빈 값들을 NULL로 변환
+        if row.get("feedback") in ([], {}):
+            row["feedback"] = None
+        if row.get("output") in ([], {}):
+            row["output"] = None
+        if row.get("draft") in ([], {}):
+            row["draft"] = None
+            
+        return row
 
     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")
-        form_html = row.get("form_html")
-        
-        # form 정보가 없는 경우 자유형식 폼으로 처리
-        if not form_id or not form_fields:
-            form_id = "freeform"
-            form_fields = [{"key": "freeform", "type": "textarea", "text": "자유형식 입력", "placeholder": "원하는 내용을 자유롭게 입력해주세요."}]
-            form_html = None
-        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
 
@@ -202,12 +172,8 @@ async def record_events_bulk(payloads: List[Dict[str, Any]]) -> None:
         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
 
@@ -225,6 +191,8 @@ async def record_event(payload: Dict[str, Any]) -> None:
         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
@@ -251,6 +219,8 @@ async def save_task_result(todo_id: str, result: Any, final: bool = False) -> No
 
 # ------------------------------ Failure Status ------------------------------
 async def update_task_error(todo_id: str) -> None:
+    """작업 실패 상태 업데이트 함수"""
+
     if not todo_id:
         return
 
@@ -263,3 +233,151 @@ async def update_task_error(todo_id: str) -> None:
         logger.error("❌ update_task_error failed todo_id=%s", todo_id)
     else:
         logger.info("update_task_error ok todo_id=%s", todo_id)
+
+# ============================== Prepare Context ==============================
+
+from typing import Any, Dict, List, Optional, Tuple
+
+async def fetch_form_def(tool_val: str, tenant_id: str) -> Tuple[str, List[Dict[str, Any]], Optional[str]]:
+    """폼 정의 조회 함수"""
+    form_id = (tool_val or "").replace("formHandler:", "", 1)
+
+    def _call():
+        client = get_db_client()
+        resp = (
+            client.table("form_def")
+            .select("fields_json, html")
+            .eq("id", form_id)
+            .eq("tenant_id", tenant_id or "")
+            .execute()
+        )
+        data = (resp.data or [])
+        if not data:
+            return None
+
+        row = data[0]
+        return {
+            "fields": row.get("fields_json"),
+            "html": row.get("html"),
+        }
+
+    try:
+        res = await _async_retry(_call, name="fetch_form_def")
+    except Exception as e:
+        logger.error("fetch_form_def fatal: %s", str(e), exc_info=e)
+        res = None
+
+    if not res or not res.get("fields"):
+        # 기본(자유형식) 폼
+        return (
+            form_id or "freeform",
+            [{"key": "freeform", "type": "textarea", "text": "자유형식 입력", "placeholder": "원하는 내용을 자유롭게 입력해주세요."}],
+            None,
+        )
+    return (form_id or "freeform", res["fields"], res.get("html"))
+
+
+async def fetch_users_grouped(user_ids: List[str]) -> Tuple[List[Dict[str, Any]], List[Dict[str, Any]]]:
+    """해당 todo에서 사용자 목록과 에이전트 목록 조회하는는 함수"""
+    ids = [u for u in (user_ids or []) if u]
+    if not ids:
+        return ([], [])
+
+    def _call():
+        client = get_db_client()
+        resp = (
+            client.table("users")
+            .select("*")
+            .in_("id", ids)
+            .execute()
+        )
+        rows = resp.data or []
+        return rows
+
+    try:
+        rows = await _async_retry(_call, name="fetch_users_grouped", fallback=lambda: [])
+    except Exception as e:
+        logger.error("fetch_users_grouped fatal: %s", str(e), exc_info=e)
+        rows = []
+
+    agents, users = [], []
+    for r in rows:
+        if r.get("is_agent") is True:
+            agents.append(r)
+        else:
+            users.append(r)
+    return (agents, users)
+
+async def fetch_email_users_by_proc_inst_id(proc_inst_id: str) -> str:
+    """proc_inst_id로 이메일 수집(사람만): todolist → users(in) 한 번에"""
+    if not proc_inst_id:
+        return ""
+
+    def _call():
+        client = get_db_client()
+        # 3-1) 해당 인스턴스의 user_id 수집(중복 제거)
+        tl = (
+            client.table("todolist")
+            .select("user_id")
+            .eq("proc_inst_id", proc_inst_id)
+            .execute()
+        )
+        ids_set = set()
+        for row in (tl.data or []):
+            uid_csv = (row.get("user_id") or "").strip()
+            if not uid_csv:
+                continue
+            # user_id는 문자열 CSV라고 전제
+            for uid in uid_csv.split(","):
+                u = uid.strip()
+                if u:
+                    ids_set.add(u)
+        if not ids_set:
+            return []
+
+        # 3-2) 한 번의 IN 조회로 사람만 이메일 추출
+        ur = (
+            client.table("users")
+            .select("id, email, is_agent")
+            .in_("id", list(ids_set))
+            .eq("is_agent", False)
+            .execute()
+        )
+        emails = []
+        for u in (ur.data or []):
+            email = (u.get("email") or "").strip()
+            if email:
+                emails.append(email)
+        # 중복 제거 및 정렬(보기 좋게)
+        return sorted(set(emails))
+
+    try:
+        emails = await _async_retry(_call, name="fetch_email_users_by_proc_inst_id", fallback=lambda: [])
+    except Exception as e:
+        logger.error("fetch_email_users_by_proc_inst_id fatal: %s", str(e), exc_info=e)
+        emails = []
+
+    return ",".join(emails) if emails else ""
+
+async def fetch_tenant_mcp(tenant_id: str) -> Optional[Dict[str, Any]]:
+    """mcp 설정 조회 함수"""
+    if not tenant_id:
+        return None
+
+    def _call():
+        client = get_db_client()
+        return (
+            client.table("tenants")
+            .select("mcp")
+            .eq("id", tenant_id)
+            .single()
+            .execute()
+        )
+
+    try:
+        resp = await _async_retry(_call, name="fetch_tenant_mcp", fallback=lambda: None)
+    except Exception as e:
+        logger.error("fetch_tenant_mcp fatal: %s", str(e), exc_info=e)
+        return None
+
+    return resp.data.get("mcp") if resp and getattr(resp, "data", None) else None

processgpt_agent_sdk/processgpt_agent_framework.py

@@ -17,11 +17,14 @@ from .database import (
     initialize_db,
     polling_pending_todos,
     record_events_bulk,
-    record_event,          # 단건 이벤트 기록
+    record_event,
     save_task_result,
     update_task_error,
     get_consumer_id,
-    fetch_context_bundle,
+    fetch_form_def,
+    fetch_users_grouped,
+    fetch_email_users_by_proc_inst_id,
+    fetch_tenant_mcp,
 )
 from .utils import summarize_error_to_user, summarize_feedback
 
@@ -100,69 +103,105 @@ class ProcessGPTRequestContext(RequestContext):
         self._extra_context: Dict[str, Any] = {}
 
     async def prepare_context(self) -> None:
-        """
-        컨텍스트 준비.
-        - 실패 시: 더 이상 진행하지 않고 ContextPreparationError를 발생시켜
-          상위 경계에서 FAILED 처리(이벤트 기록 포함)를 단일 경로로 수행.
-        """
-        logger.info("\n🔧 컨텍스트 준비 시작...")
-        
-        # 1단계: 기본 정보 추출
+        """익스큐터를 위한 컨텍스트 준비를 합니다."""
+
         effective_proc_inst_id = self.row.get("root_proc_inst_id") or self.row.get("proc_inst_id")
         tool_val = self.row.get("tool") or ""
         tenant_id = self.row.get("tenant_id") or ""
         user_ids = self.row.get("user_id") or ""
-        
-        logger.info("📋 기본 정보 추출 완료 - proc_inst_id: %s, tool: %s, tenant: %s", 
-                   effective_proc_inst_id, tool_val, tenant_id)
 
         try:
-            # 2단계: 컨텍스트 번들 조회
-            logger.info("🔍 컨텍스트 번들 조회 중...")
-            notify_emails, tenant_mcp, form_tuple, agents = await fetch_context_bundle(
-                effective_proc_inst_id, tenant_id, tool_val, user_ids
+            # 데이터베이스 조회
+            user_id_list = [u.strip() for u in (user_ids or '').split(',') if u.strip()]
+            notify_task = fetch_email_users_by_proc_inst_id(effective_proc_inst_id)
+            mcp_task = fetch_tenant_mcp(tenant_id)
+            form_task = fetch_form_def(tool_val, tenant_id)
+            users_task = fetch_users_grouped(user_id_list)
+
+            notify_emails, tenant_mcp, form_tuple, users_group = await asyncio.gather(
+                notify_task, mcp_task, form_task, users_task
             )
             form_id, form_fields, form_html = form_tuple
+            agents, users = users_group
+            
+            logger.info("\n\n🔍 [데이터베이스 조회 결과]")
+            
+            # Users 정보
+            if users:
+                user_info = []
+                for u in users[:5]:
+                    name = u.get("name", u.get("user_name", "Unknown"))
+                    email = u.get("email", "")
+                    user_info.append(f"{name}({email})" if email else name)
+                logger.info("• Users (%d명): %s%s", len(users), ", ".join(user_info), "..." if len(users) > 5 else "")
+            else:
+                logger.info("• Users: 없음")
+            
+            # Agents 정보
+            if agents:
+                agent_info = []
+                for a in agents:
+                    name = a.get("name", a.get("agent_name", "Unknown"))
+                    tools = a.get("tools", "")
+                    tool_str = f"[{tools}]" if tools else ""
+                    agent_info.append(f"{name}{tool_str}")
+                logger.info("• Agents (%d개): %s%s", len(agents), ", ".join(agent_info), "..." if len(agents) > 5 else "")
+            else:
+                logger.info("• Agents: 없음")
+            
+            # Form 정보
+            if form_fields:
+                pretty_json = json.dumps(form_fields, ensure_ascii=False, separators=(',', ':'))
+                logger.info("• Form: %s (%d개 필드) - %s", form_id, len(form_fields), pretty_json)
+            else:
+                logger.info("• Form: %s (필드 없음)", form_id)
             
-            logger.info("📦 컨텍스트 번들 조회 완료 - agents: %d개, notify_emails: %s, form_type: %s", 
-                       len(agents) if isinstance(agents, list) else 0, 
-                       "있음" if notify_emails else "없음",
-                       "자유형식" if form_id == "freeform" else "정의된 폼")
+            # Notify 정보
+            if notify_emails:
+                email_list = notify_emails.split(',') if ',' in notify_emails else [notify_emails]
+                logger.info("• Notify (%d개): %s", len(email_list), 
+                           ", ".join(email_list[:3]) + ("..." if len(email_list) > 3 else ""))
+            else:
+                logger.info("• Notify: 없음")
+            
+            # MCP 정보 - 상세 표시
+            if tenant_mcp:
+                logger.info("• %s 테넌트에 연결된 MCP 설정 정보가 존재합니다.", tenant_id)
+            else:
+                logger.info("• %s 테넌트에 연결된 MCP 설정 정보가 존재하지 않습니다.", tenant_id)
+            
+            # 피드백 처리
+            feedback_data = self.row.get("feedback")
+            content_data = self.row.get("output") or self.row.get("draft")
+            summarized_feedback = ""
+            if feedback_data:
+                logger.info("\n\n📝 [피드백 처리]")
+                logger.info("• %d자 → AI 요약 중...", len(feedback_data))
+                summarized_feedback = await summarize_feedback(feedback_data, content_data)
+                logger.info("• 요약 완료: %d자", len(summarized_feedback))
+            
+            # 컨텍스트 구성
+            self._extra_context = {
+                "id": self.row.get("id"),
+                "proc_inst_id": effective_proc_inst_id,
+                "root_proc_inst_id": self.row.get("root_proc_inst_id"),
+                "activity_name": self.row.get("activity_name"),
+                "agents": agents,
+                "users": users,
+                "tenant_mcp": tenant_mcp,
+                "form_fields": form_fields,
+                "form_html": form_html,
+                "form_id": form_id,
+                "notify_user_emails": notify_emails,
+                "summarized_feedback": summarized_feedback,
+            }
+            
+            logger.info("\n\n🎉 [컨텍스트 준비 완료] 모든 데이터 준비됨")
             
         except Exception as e:
-            logger.error("❌ 컨텍스트 번들 조회 실패: %s", str(e))
-            # 사용자 친화 요약은 상위 경계에서 한 번만 기록하도록 넘김
+            logger.error("❌ [데이터 조회 실패] %s", str(e))
             raise ContextPreparationError(e)
 
-        # 3단계: 피드백 요약 처리
-        logger.info("📝 피드백 요약 처리 중...")
-        feedback_str = self.row.get("feedback", "")
-        contents_str = self.row.get("output", "") or self.row.get("draft", "")
-        summarized_feedback = ""
-
-        if feedback_str.strip():
-            summarized_feedback = await summarize_feedback(feedback_str, contents_str)
-            logger.info("✅ 피드백 요약 완료 - 원본: %d자 → 요약: %d자", len(feedback_str), len(summarized_feedback))
-
-        # 4단계: 컨텍스트 구성
-        logger.info("🏗️ 컨텍스트 구성 중...")
-        self._extra_context = {
-            "id": self.row.get("id"),
-            "proc_inst_id": effective_proc_inst_id,
-            "root_proc_inst_id": self.row.get("root_proc_inst_id"),
-            "activity_name": self.row.get("activity_name"),
-            "agents": agents,
-            "tenant_mcp": tenant_mcp,
-            "form_fields": form_fields,
-            "form_html": form_html,
-            "form_id": form_id,
-            "notify_user_emails": notify_emails,
-            "summarized_feedback": summarized_feedback,
-        }
-        
-        logger.info("✅ 컨텍스트 준비 완료! (agents=%d개)", 
-                   len(agents) if isinstance(agents, list) else 0)
-
     def get_user_input(self) -> str:
         return self._user_input
 
@@ -197,7 +236,7 @@ class ProcessGPTEventQueue(EventQueue):
         try:
             proc_inst_id_val = getattr(event, "contextId", None) or self.proc_inst_id
             todo_id_val = getattr(event, "taskId", None) or str(self.todolist_id)
-            logger.info("\n📨 이벤트 수신: %s (task=%s)", type(event).__name__, self.todolist_id)
+            logger.info("\n\n📨 이벤트 수신: %s (task=%s)", type(event).__name__, self.todolist_id)
 
             # 1) 결과물 저장
             if isinstance(event, TaskArtifactUpdateEvent):
@@ -348,11 +387,14 @@ class ProcessGPTAgentServer:
 
         while self.is_running and not self._shutdown_event.is_set():
             try:
-                logger.info("🔍 Polling for tasks (agent_orch=%s)...", self.agent_orch)
+                logger.info("🔍 [폴링 시작] 작업 대기 중... (agent_orch=%s)", self.agent_orch)
+                
                 row = await polling_pending_todos(self.agent_orch, get_consumer_id())
 
                 if row:
-                    logger.info("✅ 새 작업: %s (proc=%s, activity=%s)", row.get("id"), row.get("proc_inst_id"), row.get("activity_name"))
+                    logger.info("✅ [새 작업 발견] Task ID: %s", row.get("id"))
+                    logger.info("• Activity: %s | Tool: %s | Tenant: %s", 
+                               row.get("activity_name"), row.get("tool"), row.get("tenant_id"))
                     try:
                         self._current_todo_id = str(row.get("id"))
                         await self.process_todolist_item(row)
@@ -392,29 +434,21 @@ class ProcessGPTAgentServer:
           4) 예외 재전달(상위 루프는 죽지 않고 다음 폴링)
         """
         task_id = row.get("id")
-        logger.info("\n🎯 작업 처리 시작 - Task ID: %s", task_id)
-        logger.info("📝 작업 정보 - proc_inst_id: %s, activity: %s, tool: %s", 
-                   row.get("proc_inst_id"), row.get("activity_name"), row.get("tool"))
+        logger.info("\n🎯 [작업 처리 시작] Task ID: %s", task_id)
         
         friendly_text: Optional[str] = None
 
         try:
             # 1) 컨텍스트 준비 (실패 시 ContextPreparationError로 올라옴)
-            logger.info("🔧 컨텍스트 준비 단계 시작...")
             context = ProcessGPTRequestContext(row)
             await context.prepare_context()
-            logger.info("✅ 컨텍스트 준비 완료")
 
             # 2) 실행
-            logger.info("🤖 에이전트 실행 단계 시작...")
+            logger.info("\n\n🤖 [Agent Orchestrator 실행]")
             event_queue = ProcessGPTEventQueue(str(task_id), self.agent_orch, row.get("proc_inst_id"))
             await self.agent_executor.execute(context, event_queue)
-            logger.info("✅ 에이전트 실행 완료")
-
-            # 3) 정상 완료 이벤트
-            logger.info("🏁 작업 완료 처리 중...")
             event_queue.task_done()
-            logger.info("🎉 작업 완료: %s\n", task_id)
+            logger.info("\n\n🎉 [Agent Orchestrator 완료] Task ID: %s", task_id)
 
         except Exception as e:
             logger.error("❌ 작업 처리 중 오류 발생: %s", str(e))

processgpt_agent_sdk/utils.py

@@ -2,15 +2,13 @@ import os
 import logging
 import traceback
 from typing import Any, Dict, Optional, List
+from typing import Iterable, Union
+from openai import AsyncOpenAI
 
-try:
-    # 비동기 클라이언트 사용 → 이벤트 루프 블로킹 방지
-    from openai import AsyncOpenAI
-except Exception:
-    AsyncOpenAI = None  # type: ignore
 
 logger = logging.getLogger(__name__)
 
+
 # ─────────────────────────────
 # Lazy Singleton OpenAI Client
 # ─────────────────────────────
@@ -119,19 +117,18 @@ async def summarize_error_to_user(exc: Exception, meta: Dict[str, Any]) -> str:
         # 폴백 없이 상위 전파
         raise
 
-async def summarize_feedback(feedback_str: str, contents_str: str = "") -> str:
+async def summarize_feedback(feedback_data: List[dict], content_data: dict = {}) -> str:
     """
     피드백과 결과물을 바탕으로 통합된 피드백 요약을 생성.
     - 모델: gpt-4.1-nano (환경변수 FEEDBACK_SUMMARY_MODEL로 재정의 가능)
     - 폴백: 없음 (LLM 실패 시 예외를 상위로 전파)
     """
     logger.info(
-        "🔍 피드백 요약 처리 시작 | 피드백: %d자, 결과물: %d자",
-        len(feedback_str or ""), len(contents_str or "")
-    )
+        "🔍 피드백 요약 처리 시작 | 피드백: %s, 결과물: %s자",
+        feedback_data, content_data)
 
     system_prompt = _get_feedback_system_prompt()
-    user_prompt = _create_feedback_summary_prompt(feedback_str, contents_str)
+    user_prompt = _create_feedback_summary_prompt(feedback_data, content_data)
 
     try:
         text = await _llm_request(system_prompt, user_prompt, "FEEDBACK_SUMMARY_MODEL", "gpt-4.1-nano")
@@ -145,13 +142,13 @@ async def summarize_feedback(feedback_str: str, contents_str: str = "") -> str:
 # ─────────────────────────────
 # 프롬프트 유틸
 # ─────────────────────────────
-def _create_feedback_summary_prompt(feedbacks_str: str, contents_str: str = "") -> str:
+def _create_feedback_summary_prompt(feedback_data: List[dict], content_data: dict = {}) -> str:
     """피드백 정리 프롬프트 - 현재 결과물과 피드백을 함께 분석"""
     blocks: List[str] = ["다음은 사용자의 피드백과 결과물입니다. 이를 분석하여 통합된 피드백을 작성해주세요:"]
-    if feedbacks_str and feedbacks_str.strip():
-        blocks.append(f"=== 피드백 내용 ===\n{feedbacks_str}")
-    if contents_str and contents_str.strip():
-        blocks.append(f"=== 현재 결과물/작업 내용 ===\n{contents_str}")
+    if feedback_data:
+        blocks.append(f"=== 피드백 내용 ===\n{feedback_data}")
+    if content_data:
+        blocks.append(f"=== 현재 결과물/작업 내용 ===\n{content_data}")
 
     blocks.append(
         """**상황 분석 및 처리 방식:**

process_gpt_agent_sdk-0.3.18.dist-info/RECORD

@@ -1,8 +0,0 @@
-processgpt_agent_sdk/__init__.py,sha256=pn11TgNq6H6zptUwBsO_MNXCQmHTtzot_GwJxR9xSuI,581
-processgpt_agent_sdk/database.py,sha256=i2tgGWe_F8razJho40NEKr3gJXut9AA7uLMsgZY5oJc,9568
-processgpt_agent_sdk/processgpt_agent_framework.py,sha256=M1fhbyUyB6LRzcB8LWq8WA83nYIxsO7GhEOpHWvEU18,21521
-processgpt_agent_sdk/utils.py,sha256=E20OqnuN-HX6m7IaQWAPTwJx-7jFL-otflotHXYvvFU,8598
-process_gpt_agent_sdk-0.3.18.dist-info/METADATA,sha256=pWB3dj1Dsm1Gd5YJv6fS6CCvybwA84lrt31sjfWuUag,21981
-process_gpt_agent_sdk-0.3.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-process_gpt_agent_sdk-0.3.18.dist-info/top_level.txt,sha256=Xe6zrj3_3Vv7d0pl5RRtenVUckwOVBVLQn2P03j5REo,21
-process_gpt_agent_sdk-0.3.18.dist-info/RECORD,,