8000 AgentEgo/TODO.md at main · daeinki/AgentEgo · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
246 lines (218 loc) · 25.6 KB

TODO.md

File metadata and controls

246 lines (218 loc) · 25.6 KB

TODO — 구현 현황 + 미구현 항목

스냅샷 기준일: 2026-05-06 범례: ✅ 구현됨 / ⚠️ 부분·스텁 / ❌ 미구현


남은 할일 — 즉시 코드 작업 가능

블로킹 의사결정 없이 단독 코드 변경으로 끝낼 수 있는 항목들.

보안 · 샌드박스

  • Skill 실행 sandbox 격리 — WorkerSandbox (worker_threads) 도입 (commit 85b3cc3). per-execute fresh spawn + V8 isolate + resourceLimits (256MB old / 32MB young / 64MB code) + env: {} (parent process.env 비공유, shareEnv: true 옵트인) + terminate() on timeout. 추가로 ad-hoc code.exec 툴 (turn 내 일회성 실행, skill.create 와 동일 staticCheckSource 필터). ReasoningContext.liveTools 로 mid-turn 등록된 도구가 같은 턴에서 호출 가능. 옵션 (a) Docker 가 아닌 (변형) — worker_threads + capability guard 결합. Docker 는 DockerSandbox 로 high-risk 도구(bash.run)에 그대로 유지
  • 외부 바이너리 실행 경로 — binary.run 툴 도입. DockerCommandSpec.mounts? + RunOptions.mounts? 추가해 skillInstallRoot 를 컨테이너에 read-only bind-mount (/skills). interpreter 화이트리스트 (python3 / node / bash / sh), 경로 traversal 가드, exec-bit 검사, default 이미지 python:3.12-slim. 시나리오 두 가지 모두 커버: (A) 컨테이너 이미지에 이미 있는 바이너리 (/usr/bin/ffmpeg), (B) skill.create 로 작성한 스크립트/바이너리 (/skills/<id>/runner.py). enableBinaryRun: true opt-in 필요. 실 Docker 통합 테스트 (binary-run-tool.docker.integration.test.ts, AGENT_DOCKER_INTEGRATION=1 게이트) 7 케이스: python 스크립트 실행 / baked-in binary / read-only mount 검증 / 직접 exec / 네트워크 차단 / timeout / traversal 거부
  • DockerSandbox gVisor 런타임 실 검증 — 코드 옵션은 있으나 실 환경에서 runsc 동작·성능 미측정. binary.run 통합 테스트와 같은 패턴 (env 게이트) 으로 재사용 가능
  • 보안 감사 — worker-sandbox.security.test.ts 21 케이스 (commit 85b3cc3): static check 우회 시도 11, Object.prototype 격리 (parent 무손상), env 차단 + shareEnv 옵트인 검증, structuredClone IPC immutability, 무한 루프 timeout, 메모리 폭탄 resourceLimits, 동시 code.exec 충돌 없음. 갭 발견 + 수정: worker default 가 parent env 상속 → env: {} 로 강화. 프롬프트 인젝션 / 토큰 탈취 시나리오는 차후 별도 감사로 분리

스펙·문서

  • 사용자 가이드 — docs/reference/cli.md 갱신: agent device, agent trace 서브 추가, env 변수 표 보완
  • 아키텍처 다이어그램 (실 구현 기준) — docs/architecture.md §2 패키지 지도에 reasoning/scheduler 추가, contracts 표 16개로, §4.5 Reasoning 레이어 신설, channel adapter 트리오 정확히 반영
  • API 레퍼런스 — docs/reference/contracts.md 신규 작성 (16개 인터페이스 + 확장 가이드)

남은 할일 — 결정·합의 필요

코드는 가능하나 방향 합의가 선행돼야 하는 항목들.

  • 배포 매니페스트 — 타깃 결정 필요: Docker compose / Kubernetes / Helm 중 어느 것(들)?
  • 환경 변수 관리 — 타깃 결정 필요: Vault / AWS Secrets Manager / GCP Secret Manager / SOPS / dotenv 만 중 어느 것?
  • 에이전트 위임 프로토콜 — 한 에이전트 → 다른 에이전트 서브태스크. 별도 ADR 필요 (현재 ADR-005 범위 밖)
  • Message bus 경유 worker pool — 현재 직접 호출, ADR-001 분리형 배포 여지만 확보. 실제 분리 시점·트리거 미정
  • PolicyCapabilityGuard per-session 분리 — 현재 __default__ 단일 policy. 멀티테넌트 요구 시점에 결정
  • replan 트리거 #2 (LLM judge) — 비용 사유로 보류. 실데이터 수집 후 재평가

남은 할일 — 외부 환경 검증·테스트 인프라

런타임·실 서비스 접근 또는 장기 테스트 인프라가 필요한 항목들.

  • webapp chat delta 브라우저 실렌더 검증 — 코드 변경(unsafeHTML 패치) 머지됨, 사용자 환경에서 실 브라우저 구동 검증 대기
  • Baileys QR 페어링 실 디바이스 검증 — 코드는 있으나 실 디바이스에서 QR 스캔·세션 유지 미검증
  • 로드 테스트 — 동시 세션 N개, turn throughput 측정 (k6 / artillery 추정)
  • Chaos 테스트 — Redis 장애 / LLM 타임아웃 / DB 잠금 시 회복
  • 실 서비스 e2e — Telegram 봇 토큰 왕복 / Anthropic API 비용 측정 / OTel → Jaeger·Tempo 파이프라인 검증

시스템 블록 다이어그램 (현재 상태)

┌──────────────────────────────────────────────────────────────────────────────┐
│                        직접 운영자 서피스 (Direct Operators)                   │
│  ┌─────────────────────────┐        ┌─────────────────────────────────────┐  │
│  │ TUI  (Ink + React) ✅   │        │ Webapp  (Vite + Lit 3) ✅            │  │
│  │ T1 InputBar ✅          │        │ app-root / <phase-line> /            │  │
│  │ T2 App ✅               │        │ 6 views(chat/overview/channels/      │  │
│  │ T3 RpcClient ✅         │        │   instances/sessions/cron) ✅        │  │
│  │ Bearer master 토큰      │        │ ed25519 IndexedDB + HMAC 세션 ✅     │  │
│  │                         │        │ chat delta 렌더 (unsafeHTML) ✅      │  │
│  │                         │        │   ⚠️ 브라우저 실검증 사용자 환경 대기 │  │
│  │                         │        │ /ui/* SPA 자동 배선 ✅               │  │
│  └──────────────┬──────────┘        └───────────────┬─────────────────────┘  │
│                 │ Authorization: Bearer …           │ Sec-WebSocket-Protocol:│
│                 │                                   │ bearer.<sessionToken>  │
│                 └──────────────┬────────────────────┘                        │
│                                │ JSON-RPC 2.0 over WebSocket /rpc            │
│                                ▼ (chat.*, sessions.*, overview.status,       │
│                                   channels.*, instances.*, cron.*,           │
│                                   gateway.*, chat.phase notification)        │
└────────────────────────────────┼─────────────────────────────────────────────┘
                                 │
┌────────────────────────────────┼─────────────────────────────────────────────┐
│                  Gateway / Control-Plane 레이어                               │
│  ┌─────────────────────────────▼─────────────────────────────────────────┐   │
│  │ [G1] ApiGateway (HTTP + WS)  ✅                                        │   │
│  │  ├─ /healthz · /messages · /ws (webchat) ✅                            │   │
│  │  ├─ /rpc (WS) ── mount hook for gateway-cli ✅                         │   │
│  │  ├─ /device/enroll · /challenge · /assert ✅  (ADR-010)               │   │
│  │  ├─ /ui/* (SPA 정적 서빙) ✅                                           │   │
│  │  ├─ TokenAuth + master/device verifier ✅                              │   │
│  │  └─ RateLimiter ✅                                                     │   │
│  │                                                                        │   │
│  │ [G2] RpcServer (JSON-RPC 2.0) ✅                                       │   │
│  │ [G3] chat.send/history/abort 핸들러 ✅                                 │   │
│  │                                                                        │   │
│  │ DeviceAuthStore ✅  devices.json 0o600  (ADR-010)                     │   │
│  │  └─ `agent device {list,revoke}` CLI ✅                                │   │
│  │                                                                        │   │
│  │ [C1] RuleRouter ✅       [C2] SessionStore (sessions.db) ✅            │   │
│  │ [C2'] ChannelRegistry ✅  PlatformChannelRegistry — 이벤트 집계 +      │   │
│  │                            channels.list/status RPC 백엔드             │   │
│  │ [C2''] CronRegistry ✅   SchedulerService — 3 runner (chat/bash/wf),  │   │
│  │                            tasks.json JSON5, cron.list/runNow RPC     │   │
│  └───────────────────────────┬────────────────────────────────────────────┘   │
└──────────────────────────────┼────────────────────────────────────────────────┘
                               │
┌──────────────────────────────┼────────────────────────────────────────────────┐
│              Platform Handler (packages/cli runtime) ✅                        │
│  [P1] startPlatform() — 모든 컴포넌트 lazy 배선                                 │
│       ├─ SessionStore, Router, EgoLayer, AgentRunner, Memory, Sandbox ✅       │
│       ├─ HybridReasoner 기본 주입 (tools 있으면 plan-execute 자동) ✅          │
│       ├─ DeviceAuthStore 자동 초기화 ✅                                        │
│       └─ webappDir 자동 탐지 ✅ (--webapp-dir → env → packages/webapp/dist)   │
└──────────────────────────────┬────────────────────────────────────────────────┘
                               │
                        ┌──────▼──────┐
                        │  EGO ON?    │───── off ─────────────────┐
                        └──────┬──────┘                           │
                      passive  │ active                           │
                               ▼                                  │
┌────────────────────────────────────────────────────────────────┼────────────┐
│            [E1] EgoLayer  (packages/ego) ✅ (ADR-005/006)      │            │
│  S1 Intake → S2 Normalize (규칙 ~16ms, ~75% passthrough 목표)  │            │
│  shouldFastExit? → passthrough                                 │            │
│  gatherContext (memory + goals + recent turns, 병렬) ✅        │            │
│  buildSystemPrompt (persona snapshot 주입) ✅                  │            │
│  EgoLlmAdapter.think → Claude Haiku JSON ✅                    │            │
│  validateEgoThinking → 스키마 + 의미 일관성 ✅                 │            │
│  materialize → passthrough/enrich/redirect/direct_response ✅  │            │
│  CircuitBreaker ✅  · daily cost cap auto-downgrade ✅         │            │
│  SqliteAuditLog ✅ (20+ 태그)                                  │            │
│  FileGoalStore ✅ (ADR-007) · FilePersonaManager + evolution ✅│            │
│  ❌ 멀티에이전트 위임 프로토콜 (ADR-005 범위 밖)               │            │
└──────────────────────────────┬─────────────────────────────────┼────────────┘
                               │ invoke                          │
                               ▼          ◄────────── bypass ────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│            [W1] AgentRunner.processTurn (packages/agent-worker) ✅           │
│                                                                              │
│  [W2] PromptBuilder (EGO enrichment 주입) ✅                                 │
│  [M*] ModelAdapter: Anthropic SDK 0.88 ✅  ·  OpenAI ✅                      │
│       responseFormat='json_object' 지원 (OpenAI native / Anthropic prefill) │
│                                                                              │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ [R*] Reasoning 레이어 (ADR-009) ✅                                    │   │
│  │                                                                      │   │
│  │  [R1] HybridReasoner ✅                                               │   │
│  │    └─ [R1a] ComplexityRouter ✅ (EGO perception 직접 입력)            │   │
│  │         low → ReAct   medium|high → Plan-Execute                     │   │
│  │         workflow_execution → 강제 plan-execute                       │   │
│  │                                                                      │   │
│  │  [R2] ReactExecutor  ✅ (Thought/Action/Observation, 2 retry)        │   │
│  │                                                                      │   │
│  │  [R3] PlanExecuteExecutor  ✅                                         │   │
│  │    ├─ planner LLM JSON 모드 (provider 별 강제) ✅                     │   │
│  │    ├─ replan 트리거 #1 (stepRetry 소진) ✅                            │   │
│  │    ├─ ❌ replan 트리거 #2 (LLM judge — 비용 사유 보류)                │   │
│  │    ├─ replan 트리거 #3 (egoRelevance>0.8 + goalUpdates) ✅            │   │
│  │    ├─ 병렬 실행 (parallelExecution opt-in, 레벨 기반) ✅              │   │
│  │    ├─ replan 단계 보존: id 매칭 + StepMatcher 의미 fallback ✅        │   │
│  │    └─ 한도 초과 시 ReAct 다운그레이드 ✅                              │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  [K*] LiveToolRegistry + LocalSkillRegistry ✅                               │
│       built-in: fsRead/fsWrite/webFetch/bashTool ✅ (buildDefaultTools)      │
│       signed skill bundle: architecture-lookup / trace-lookup ✅             │
│       ❌ Skill 실행 sandbox 격리 (현재 host process)                         │
│                                                                              │
│  [S*] Sandbox + CapabilityGuard ✅                                           │
│       InProcessSandbox ✅   DockerSandbox ⚠️ (gVisor 미검증)                │
│       PolicyCapabilityGuard ✅  (single-owner — 멀티테넌트 시 분리 필요)     │
└──┬──────────────────┬─────────────────────┬────────────────────────────────┘
   │                  │                     │
┌──▼─────────┐  ┌─────▼─────────┐  ┌────────▼────────────┐
│ [X*] Memory│  │  Observability│  │  Message Bus        │
│ PalaceMem✅│  │  OTel tracer✅ │  │  InProcessBus ✅    │
│ FTS5 ✅    │  │  Metrics   ✅ │  │  RedisStreamsBus ✅ │
│ cosine ✅  │  │  OTLP      ✅ │  │  ⚠️ worker pool 경유 │
│ access log✅│  │  Audit DB  ✅ │  │     분리형 배포 미구현│
│ ⚠️in-mem   │  │  TraceLog  ✅ │  │     (현재는 직접 호출)│
│   (vec-ext │  └───────────────┘  └─────────────────────┘
│   교체 옵션)│
└────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│             채널 어댑터 계층 (Contracts.ChannelAdapter) ✅                    │
│  ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │ WebChat │ │ Telegram │ │ Slack   │ │ Discord      │ │ WhatsApp         │  │
│  │ WS ✅   │ │ 롱폴링 ✅ │ │ Events✅│ │ Gateway WS✅ │ │ baileys ⚠️       │  │
│  │         │ │           │ │ Socket✅│ │ Resume ✅    │ │   QR 실 페어링   │  │
│  │         │ │           │ │ Mode    │ │ Sharding ✅  │ │   미검증         │  │
│  │         │ │           │ │         │ │ (Manager 포함)│ │ Cloud API ✅    │  │
│  └─────────┘ └──────────┘ └─────────┘ └──────────────┘ └─────────────────┘  │
│  ChannelRegistry ✅ — PlatformChannelRegistry 가 어댑터 이벤트/에러 집계      │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                  곁가지 패키지 (보조 · 실행기)                                │
│  [device-node] WS 프로토콜(페어링/하트비트/푸시) ✅                           │
│  [workflow]    선언적 DSL 인터프리터 ✅  (call/return/try/catch/scope 포함)   │
│  [scheduler]   ✅ node-cron + chat/bash/workflow runner, tasks.json          │
└─────────────────────────────────────────────────────────────────────────────┘

패키지 ↔ 블록 매핑 (요약)

블록 패키지 구현
T1-T3 packages/tui ✅
G1 / C1-C2 / DeviceAuth packages/control-plane ✅
G2-G3 + RPC 메서드 packages/gateway-cli ✅
P1 packages/cli/src/runtime/platform.ts ✅
E1 전체 packages/ego ✅
W1-W2 / M* packages/agent-worker/{runner,prompt,model} ✅
R1-R3 packages/agent-worker/src/reasoning ✅ (트리거 #2 보류)
K* packages/skills + packages/agent-worker/src/tools ✅ (Skill sandbox 격리 ❌)
S* packages/agent-worker/src/security + tools/*sandbox.ts ✅ / ⚠️ (gVisor 미검증)
X* Memory packages/memory ✅ (vec-ext 교체 옵션 ⚠️)
X* Observability packages/observability ✅
Message Bus packages/message-bus ✅ (worker-pool 배포 ❌)
Webapp packages/webapp ✅ (브라우저 실검증 ⚠️)
채널 5개 packages/channels/* ✅ (WhatsApp baileys QR 실 페어링 ⚠️)
ChannelRegistry packages/control-plane/src/gateway/platform-channel-registry.ts ✅
Scheduler / CronRegistry packages/scheduler ✅
Workflow packages/workflow ✅
Device-node packages/device-node ✅

최근 완료 (커밋 ledger)

git log 보조용 — 상세 내역은 커밋 메시지 참조.

커밋 항목
54f6fb5 channel-whatsapp: Meta Cloud API 클라이언트 (graph.facebook.com outbound + 자체 webhook 서버, X-Hub-Signature-256 HMAC 검증)
bce6bd4 channel-slack: Socket Mode 트랜스포트 (apps.connections.open + envelope ack + 자동 재접속, transport 디스크리미네이티드 union)
a02be22 channel-discord: Gateway Resume( 33E7 op6) + sharding (READY session_id 캐시, close 코드 분기, DiscordShardManager)
51bf250 workflow: functions / try-catch-finally / scope (call·return·try·scope step kinds, scope frame stack, depth limit)
f8a7b5c agent-worker: planner JSON mode (OpenAI native + Anthropic { prefill, 3 planner sites)
0c99c2d docs: memory access logging + replan semantic matching 완료 표시
672fd31 agent-worker+cli: replan 단계 보존 의미 매칭 (StepMatcher + EmbedderStepMatcher, threshold 0.85)
d2d8d89 memory: PalaceMemorySystem.search() access logging (AGENT_MEMORY_ACCESS_LOG 토글)
765ea5c skills: architecture-lookup 번들 v0.7.0 갱신
d05a7c0 scheduler+cli: CronRegistry — chat/bash/workflow runner, tasks.json JSON5
a93b65a control-plane+cli: PlatformChannelRegistry → channels.list/status RPC 백엔드
c88aba0 agent-worker+core: replan 트리거 #3 (egoRelevance + goalUpdates)
6e728ac cli: agent device {list,revoke}
e656b2f webapp: chat delta 렌더 (.innerHTML → Lit unsafeHTML)
009e54a gateway: webapp /ui/* 자동 배선 (--webapp-dir → env → dist)
0