toki/iop

History

toki 7b16b3243c 수정: CLI timeout/cancel 후 session 오염과 Registry stop error 처리 개선 - CLI persistent 실행 중 ctx.Done() 발생 시 session을 정리하여 늦은 출력이 다음 run에 섞이는 문제 해결 - CLI Execute에서 mutex lock/unlock 구조를 개선하여 race condition 방지 - Registry.Stop이 모든 lifecycle adapter의 Stop을 시도하고, errors.Join 대신 first error 패턴으로 변경하여 한 adapter의 실패가 다른 adapter 정리를 막지 않도록 수정 - timeout 후 session 오염 방지 회귀 테스트 추가 - registry stop failure 후에도 preceding adapter stop이 호출되는 테스트 추가 - CLI partial profile rollback 테스트 강화		2026-05-03 14:45:18 +09:00
..
cmd/node	정리: 앱 경로와 바이너리 접두어를 제거한다	2026-05-02 21:16:34 +09:00
internal	수정: CLI timeout/cancel 후 session 오염과 Registry stop error 처리 개선	2026-05-03 14:45:18 +09:00
README.md	feat: edge/node architecture updates and agent-task integration	2026-05-03 10:51:29 +09:00

README.md

node — Node Agent

디바이스당 1개 실행되는 IOP 노드 에이전트.
실제 AI 모델 추론 어댑터를 관리하고, TCP + Protobuf + mTLS 소켓을 통해 요청을 처리한다.

내부 구조 (Hexagonal Architecture)

cmd/node/            — CLI 진입점 (cobra)
internal/
  bootstrap/         — fx 의존성 주입 모듈
  node/              — 핵심 노드 서비스 (transport.Handler 구현)
  runtime/           — 도메인 타입: ExecutionSpec, RuntimeEvent, 인터페이스
  router/            — RunRequest → ExecutionSpec 라우팅
  transport/         — TCP 서버, 세션 관리, 프레임 코덱
  adapters/
    mock/            — 에코 테스트 어댑터
    ollama/          — Ollama API 어댑터 (TODO)
    vllm/            — vLLM OpenAI-compatible 어댑터 (TODO)
    cli/             — CLI 프로세스 어댑터 (claude/gemini/codex/opencode)
  store/             — SQLite 실행 이력

실행

# 빌드
go build -o bin/node ./apps/node/cmd/node

# 버전 확인
./bin/node version

# 설정 확인
./bin/node config print --config configs/node.yaml

# 서버 실행
./bin/node serve --config configs/node.yaml

원격 edge에 붙는 수동 테스트는 configs/node.yaml의 transport.edge_addr와 transport.token을 먼저 맞춘 뒤 repo root에서 실행한다.

./bin/node.sh

edge에서 실행 요청을 받으면 node 콘솔에는 받은 입력과 node가 돌려보내는 이벤트/응답이 분리되어 표시된다.

[edge-message] hello
[node-event] start run_id=manual-...
[node-event] complete run_id=manual-... detail="mock execution complete"
[node-message] echo: hello

어댑터

어댑터	설명	상태
`mock`	입력 에코, 스트리밍 테스트용	구현 완료
`ollama`	로컬 Ollama 서버 연동	TODO
`vllm`	vLLM OpenAI-compatible API	TODO
`cli`	claude/gemini/codex/opencode CLI 실행	구현 완료

Transport

TCP 4-byte length-prefix framing
JSON-encoded Envelope (TODO: protobuf 교체)
mTLS (configs/node.yaml에서 활성화)
하트비트: 30초 간격