fde-agent-kit

FDE agent substrate — fork·publish 대상 라이브러리.

kernel(A2A contract · ports · task helpers) + runtime(registry · HTTP server)만 포함한다.
reference agent·mock MCP·통합 문서는 fde-agent-lab 에서 관리한다.

전체 FDE 문서: fde-agent-lab/docs/domain/README.md
Agent contract: fde-agent-lab/docs/domain/agent/05-agent-contract.md

역할

| 포함 | 미포함 (lab / 고객 fork) | | --- | --- | | AgentRuntime · AgentCard 형상 | concrete agent (search-agent …) | | A2A Task · InvokeRequest contract | laiv-rag · OpenAI adapter | | RetrieverPort · Store · SynthesizerPort | mock MCP · catalog FE | | AgentRegistry · createServer() | factory · agents.config |

substrate vs lab: docs/architecture-substrate.md 개발 추적: docs/development.md (dev는 fde-agent-lab/dev/에서 관리)

구조

src/
  kernel/       contract · ports · deps · config · task · observability · agent
  runtime/      registry · server (A2A HTTP surface)
  index.ts      public exports (fde-agent-kit)
docs/
  architecture-substrate.md
  fork-guide.md
test/

사용 (lab 또는 fork)

npm install fde-agent-kit

kit 소스를 함께 개발할 때 (monorepo):

npm install && npm run build
npm link   # fde-agent-kit 루트에서
# fde-agent-lab에서: npm link fde-agent-kit

import {
  type AgentRuntime,
  type AgentDeps,
  AgentRegistry,
  createServer,
  completedTask,
} from "fde-agent-kit";

npm publish (로컬)

laiv-rag 와 동일 — macOS 키체인에서 NPM_TOKEN 로드:

cp load-npm-token.local.example.sh load-npm-token.local.sh   # 최초 1회, 이메일 수정
source ./load-npm-token.local.sh
npm run publish:agent-kit -- --dry-run --no-tag-check

상세: docs/publishing-agent-kit.md

fork 가이드

1. 이 repo(fde-agent-kit) + fde-agent-lab을 참고해 고객 repo 생성
2. kit는 의존성으로 두고, src/agents/ · adapters/ · agents.config.ts만 커스터마이즈
3. ACTIVE_AGENTS로 deployment profile 정의

상세: docs/fork-guide.md

스크립트

npm run build      # tsc → dist/
npm run typecheck
npm test
npm run publish:agent-kit -- --dry-run --no-tag-check   # publish 검증

npm 배포 절차: docs/publishing-agent-kit.md

관련 repo

| repo | 역할 | | --- | --- | | fde-agent-kit (이 repo) | substrate — contract + runtime | | fde-agent-lab | PoC·reference agents·전체 FDE 문서·mock·catalog |