프로젝트 소개

affe-agent는 TypeScript 라이브러리로, Effect 네이티브 에이전트 실행 커널 역할을 하며, Effect AI의 LanguageModel, Prompt, Tool, Toolkit 프리미티브와 애플리케이션 계층 사이에 위치합니다. 이 라이브러리는 에이전트 애플리케이션이 일반적으로 재구현하는 세션, 실행, 턴, 조종, 후속 작업, 중단, 수명주기 이벤트 계층을 제공합니다. 핵심 모델은 세션 → 제출 → 실행 → 턴으로 구성되며, 하나의 추가 전용 표준 기록과 타입화된 수명주기 이벤트를 갖습니다. 커널은 소규모이며 몇 가지 연결 지점(toolkit/tools, contextTransform, loop, permission, toolExecution, elicitation, InputChannel, eventSink/events, AgentSessionHost, LanguageModel, Sandbox)을 통해 확장 가능합니다. 배터리는 이러한 연결 지점에 플러그인되어 핵심을 수정하지 않고도 기능을 추가합니다. 주요 기능은 다음과 같습니다: - 여러 전송: HTTP, RPC, AG-UI, A2A, MCP(v1 및 v2), OpenAI 호환 completions, 커넥터(Slack) - 코딩(샌드박스 위의 파일/셸 도구), 웹(검색, 보호된 fetch, 렌더링된 페이지 캡처), 하위 에이전트, 메모리, 스킬, 압축, 예산(토큰 및 비용 상한), 모델 메타데이터, 관찰 가능성, 편집, 데이터, 훅, 스케줄링, 트리(분기 가능한 세션), 세션(페이지네이션된 디렉토리), 내보내기(스냅샷 및 JSONL), 블롭 저장소, 플러그인, 프리셋을 위한 배터리 - Effect Workflow를 통한 지속 실행, 클러스터 지원 및 Durable Streams - 휴대용 및 로컬(Node) 구현을 포함한 샌드박스 추상화 - 스크립트된 TestLanguageModel, AgentProbe, 웹 더블, 적합성 스위트를 포함한 테스트 유틸리티 - Node, Bun, Deno, 엣지 런타임(Cloudflare Workers) 전반의 런타임 이식성 라이브러리는 버전 0.0.1(사전 릴리스)입니다. 설계는 안정적이지만 기본 Effect v4 기반은 여전히 릴리스 후보 상태이므로, GA까지 Effect에서 API 변경이 예상됩니다. 프로젝트는 affe-agent, effect, @effect/ai-* 프로바이더의 정확한 버전을 함께 고정할 것을 권장합니다. 저장소에는 참조 애플리케이션도 포함됩니다: 전체 화면 로컬 코딩 TUI, 일반 CLI 클라이언트, 세션당 하나의 Durable Object를 사용하는 Cloudflare Worker 배포.