검증 리포트
엔터프라이즈 Eve 에이전트 개발 핸드북 작성 시 확인한 소스, 문서, 구현 근거와 남은 리스크를 기록한다.
2026-10-23 검증 범위
공개 npm eve@0.82.0의 package metadata·배포 문서·타입 선언과 공식 릴리스를 대조했습니다. 승인, limits, instrumentation, retention, eval 항목을 현재 API 기준으로 수정했습니다. MDX와 TypeScript 예제의 구문 검사를 수행하며, 유료 모델 호출·실제 Vercel 배포·장기 세션 재개 성공을 검증한 기록은 아닙니다.
이전 검증 기록
아래 버전·커밋·문서 개수는 당시 분석 기준입니다.
이 문서는 핸드북 작성 기준과 검증 범위를 기록합니다.
분석 기준
| 항목 | 값 |
|---|---|
| 소스 기준 | 비공개 로컬 Eve 소스 체크아웃 |
| package | packages/eve |
| Eve version | 0.11.4 |
| package description | Filesystem-first framework for durable backend AI agents that run anywhere. |
| 작성일 | 2026-06-18 |
| 공식 문서 대조 | 2026-06-18 https://eve.dev/sitemap.xml 기준 /docs/* 67개 Markdown 문서 |
읽은 주요 문서
| 문서 | 반영 장 |
|---|---|
README.md | 전체 개요 |
SKILL.md | 번들 문서 우선 원칙 |
docs/README.md | 문서 읽기 순서, public mental model |
docs/reference/project-layout.md | Ch3 |
docs/agent-config.md | Ch5 |
docs/concepts/execution-model-and-durability.md | Ch1, Ch13 |
docs/concepts/security-model.md | Ch8, Ch15 |
docs/concepts/sessions-runs-and-streaming.md | Ch9 |
docs/concepts/context-control.md | Ch6 |
docs/concepts/default-harness.md | Ch4, Ch7, Ch8 |
docs/tools/overview.mdx | Ch7 |
docs/tools/human-in-the-loop.md | Ch7 |
docs/connections.mdx | Ch7 |
docs/sandbox.mdx | Ch8 |
docs/channels/overview.mdx | Ch9 |
docs/channels/custom.mdx | Ch9 |
docs/subagents.mdx | Ch10 |
docs/guides/remote-agents.md | Ch10 |
docs/guides/dynamic-capabilities.md | Ch6 |
docs/guides/dynamic-workflows.md | Ch10 |
docs/guides/hooks.md | Ch11 |
docs/guides/state.md | Ch11 |
docs/schedules.mdx | Ch11 |
docs/evals/overview.mdx | Ch12 |
docs/evals/assertions.mdx | Ch12 |
docs/guides/auth-and-route-protection.md | Ch9, Ch15 |
docs/guides/deployment.md | Ch13 |
docs/guides/instrumentation.md | Ch13 |
읽은 공식 문서
2026-06-18에 공식 Introduction, 공식 sitemap, 공식 llms.txt를 기준으로 /docs/* 67개 문서의 Markdown 원문을 수집해 대조했습니다. 전체 링크 목록은 공식 문서 대조표에 정리했습니다.
대조 후 보정한 주요 항목:
| 항목 | 반영 |
|---|---|
| Beta/책임 고지 | index와 governance에 Beta 및 Responsible Use 기준 추가 |
agent.ts | root agent.ts 생략 가능, 작성 시 model 필수, scaffold/default model 표현 보정 |
| route auth | framework default와 scaffold placeholderAuth() 차이 명시 |
| channels | Slack/Discord/GitHub/Linear/Teams/Telegram/Twilio, WebSocket, cross-channel hand-off, metadata projection 추가 |
| client/frontend | TypeScript SDK와 useEveAgent, session cursor, clientContext 기준 추가 |
| evals | eve eval CLI 옵션, artifact 위치, 세부 eval 문서 분리 기준 추가 |
읽은 주요 구현 파일
| 구현 파일 | 확인한 내용 |
|---|---|
packages/eve/package.json | package version, exports, public entrypoints |
packages/eve/src/public/index.ts | core public API |
packages/eve/src/public/tools/index.ts | tool helpers/export |
packages/eve/src/public/agents/auth.ts | remote agent outbound auth |
packages/eve/src/discover/project.ts | flat/nested project resolution |
packages/eve/src/discover/discover-agent.ts | authored slot discovery |
packages/eve/src/discover/manifest.ts | source manifest shape |
packages/eve/src/compiler/compile-agent.ts | artifact write and diagnostics handling |
packages/eve/src/compiler/manifest.ts | compiled manifest schema/version |
packages/eve/src/runtime/resolve-agent.ts | compiled node hydration |
packages/eve/src/runtime/resolve-agent-graph.ts | framework/authored registry merge |
packages/eve/src/runtime/agent/bootstrap.ts | RuntimeTurnAgent construction |
packages/eve/src/harness/tool-loop.ts | AI SDK tool loop, telemetry, compaction, HITL |
packages/eve/src/harness/tools.ts | ToolSet assembly, provider tool handling |
packages/eve/src/harness/input-requests.ts | pending input/approval resolution |
packages/eve/src/execution/workflow-entry.ts | durable driver loop, park/resume |
packages/eve/src/execution/turn-workflow.ts | turn workflow dispatch contract |
packages/eve/src/execution/workflow-steps.ts | "use step" harness execution |
packages/eve/src/execution/durable-session-store.ts | session snapshot and migration-aware state |
packages/eve/src/execution/session.ts | session hydration, compaction config |
정합성 확인 항목
| 요구 | 확인 |
|---|---|
| filesystem-first authoring | README, project-layout, discovery 구현 |
| durable session/turn/step | execution-model 문서, workflow-entry/turn-workflow 구현 |
| app runtime vs sandbox 분리 | security-model, sandbox 문서 |
| route auth fail-closed | auth-and-route-protection 문서 |
| tool approval default | tools/HITL 문서 |
| dynamic capability event order | dynamic-capabilities, workflow-steps 구현 |
| subagent isolation | subagents 문서, runtime graph 구현 |
| eval이 실제 HTTP surface를 구동 | evals overview |
| telemetry와 Workflow tags | instrumentation 문서 |
남은 리스크
| 리스크 | 설명 |
|---|---|
| Preview API 변화 | Eve는 beta/preview 성격이며 API/behavior가 바뀔 수 있음 |
| 공식 문서 최신성 | 2026-06-18 공식 문서를 조회했지만 Eve beta 문서는 이후 변경될 수 있음 |
| 실제 Eve build 미실행 | 참조 Eve repo 자체의 test/build는 수행하지 않았고 코드/문서 정적 분석 중심 |
| 핸드북 렌더링 | MDX build/lint로 최종 확인 필요 |
운영 반영 권장
이 핸드북을 실제 팀 표준으로 쓰려면 다음 artifact를 추가로 만들면 좋습니다.
| Artifact | 목적 |
|---|---|
| Eve PR template | tools/connections/channels/sandbox 변경 리뷰 |
| Eval starter kit | smoke, negative, approval, auth baseline |
| CODEOWNERS sample | 파일 슬롯별 owner 지정 |
| Production runbook | session.waiting, 401, sandbox, connection auth 장애 대응 |
| Data flow template | model/provider/tool/telemetry 경로 기록 |