Knolo
Knolo는 AI 에이전트들이 서로 지식을 공유하는 데 사용하는 개방형(open) 프레임워크입니다. 이 지식을 휴대 가능한 Knowledge Image로 패키징하고, digest로 고정(pin)하며, 로컬에 마운트하여 어떤 것이 사용되었는지 증명할 수 있게 합니다.
한 에이전트가 지식을 파일로 패키징합니다. 다른 에이전트는 그 파일을 자신의 기기에 마운트합니다. 이때의 '핀(pin)'이 digest입니다. 쿼리가 실행되면 receipt id와 state root를 반환받습니다. 이 영수증 파일은 쿼리를 실행한 기기에 남게 됩니다. 이는 무결성 검사(integrity check)일 뿐, 주장이 증명되었다는 의미는 아닙니다. 다음 에이전트는 마운트된 이미지를 자신의 pin과 비교하여 확인합니다. Knolo는 모델을 호출하거나 에이전트를 실행하지 않습니다. 자세한 가이드는 두 에이전트가 지식을 공유하는 방법을 참고하세요.
지식은 애플리케이션 내부에 갇힌 불투명한(opaque) 컨텍스트가 아니라, 검사하고, 검증하며, 마이그레이션하고, 실행할 수 있는 자산이어야 합니다.
V6 · KAR · V5 Knowledge Images · V4 compatible · Local-first · Deterministic · Verifiable
최신 릴리스 (Current release)
현재 트리는 Knolo 6.2.0입니다. V6에서는 KAR가 추가되었습니다. KAR은 V5 Knowledge Image와 Committed Evidence Graph로부터 최소 증거 세트(minimum evidence set)를 결정론적으로 검색하는 기능을 제공합니다. 6.1.0에서는 verifiable composition이 추가되었고, 6.2.0에서는 Knolo Cortex가 추가되어 검증 가능한 추적(verifiable trace)을 통한 범위 제한 증거 검색 기능을 제공합니다. 호스트는 어떤 모델을 소유하든 상관없습니다. 검증이 곧 답변의 진실성을 의미하지는 않습니다. Lexical retrieval, V5 images, 그리고 V4 packs는 그대로 유지됩니다.
import {
createKarSession,
evaluateKar,
...
루트 @knolo/core 엔트리는 KAR을 로드하지 않습니다. @knolo/core/experimental/kar는 이번 사이클의 호환성 엔트리로 남아 있습니다. SATISFIED는 선언된 증거 요구사항이 충족되었음을 의미합니다. 이는 주장이 증명되었다는 것을 의미하지 않습니다. UNSATISFIED_EVIDENCE_REQUIREMENTS는 해당 요구사항들이 충족되지 않았음을 의미하며, 주장이 거짓임을 의미하지도 않습니다.
게시된 @knolo/core는 6.2.3입니다. 이 트리의 핵심 패키지 파일은 6.2.3입니다. 6.2.1 버전에서는 선택적 textQuery 플랜이 추가되었는데, 이는 유지된 용어가 전체 단어로 일치해야 함을 의미합니다. textQuery가 없는 EQL SEARCH 플랜 역시 객체 ID 순서로 모든 용어가 부분 문자열(substring)이어야 합니다. @knolo/langchain, @knolo/llamaindex, @knolo/semantic-ollama, 그리고 create-knolo-app은 6.2.0으로 유지되며 @knolo/core ^6.0.0에 의존합니다. 이 트리의 @knolo/cli 패키지 파일은 6.2.7이며 @knolo/core ^6.2.3 및 @knolo/exchange ^0.1.0에 의존합니다. CLI의 npm latest 버전은 6.2.7입니다. 해당 릴리스에는 knolo kite가 포함되어 있습니다. 하지만 @knolo/[email protected]에는 포함되어 있지 않습니다. @knolo/exchange의 npm latest는 0.1.0입니다. @knolo/tools는 0.2.1이며 @knolo/core ^6.2.1에 의존합니다. 이 트리의 @knolo/mcp는 0.2.3이며 @knolo/core ^6.2.1 및 @knolo/tools ^0.2.1에 의존합니다. MCP의 npm latest는 0.2.3입니다. @knolo/ai-sdk는 0.1.0이며 @knolo/core ^6.2.0 및 @knolo/tools ^0.2.0을 유지합니다. @knolo/box의 npm latest는 0.1.1입니다. @knolo/code는 0.1.1입니다. @knolo/reflex는 0.2.0으로 유지됩니다. @knolo/evidence-gate는 0.1.0으로 유지됩니다. Rust, Python, 그리고 ICP 캐니스터는 5.5.1로 유지되며 KAR(Knowledge Access Retrieval), 구성(composition), 또는 Cortex를 구현하지 않습니다. 번들된 계약(contracts), 정책(policy), 운영 도메인 패키지(operations Domain Packs)는 '검토 필요(review-required)' 상태입니다. 로컬 태그 v6.0.0은 6.0.0 커밋에 유지됩니다. 로컬 태그 v6.1.0은 6.1.0 커밋에 유지됩니다. 이 버전들은 재게시하지 마십시오. 서버에서 설명(description) 필드는 위 공유 작업을 명시합니다. npm은 나중에 게시될 때까지 이전 설명을 계속 보여줍니다. KAR 가이드, 구성 가이드, Cortex 가이드, 6.2.0 릴리스 노트, examples/kar-v6, examples/kar-coverage, 그리고 examples/composition-v1부터 시작하십시오.�## 기회
차세대 AI 제품은 지식 레이어의 품질과 신뢰성을 바탕으로 경쟁할 것입니다. 모델은 빠르게 변화할 수 있지만, 그 주변을 둘러싼 증거(evidence), 정책(policies), 검색 동작(retrieval behavior), 런타임 상태(runtime state), 운영 이력(operational history)에 지속적인 가치가 축적됩니다.
Knolo는 해당 레이어를 위한 중립적인 기반을 제공합니다:
- 이식 가능한 지식(Portable knowledge) — 독점 데이터베이스 내보내기 방식 대신 자체 포함된 Knowledge Image 형태로 지식 기반을 패키징할 수 있습니다.
- 검증 가능한 상태(Verifiable state) — 모든 V5 이미지는 결정론적 인코딩(deterministic encodings), 도메인 분리 SHA-256 루트, 경계가 지정된 섹션(bounded sections), 커밋 이력(commit history)을 가집니다.
- 추적 가능한 답변(Traceable answers) — 검색 및 에이전트 실행 과정에서 출처(source), 청크(chunk), 주장(claim), 인용(citation), 증거(evidence)의 식별자를 보존합니다.
- 재현 가능한 동작(Reproducible behavior) — 결정론적 쿼리 계획(deterministic query plans), 영수증(receipts), 마이그레이션 기록(migration records), 런타임 진단(runtime diagnostics)을 사용하여 결과를 검사 가능하게 만듭니다.
- 조합 가능한 인프라(Composable infrastructure) — 스토리지, 검증, 검색, 정책, 에이전트 실행을 분리하여 제품이 필요한 것만 채택할 수 있도록 합니다.
이것이 바로 Knolo의 전략적 가설입니다: 신뢰할 수 있는 지식 런타임은 많은 AI 애플리케이션, 에이전트, 엔터프라이즈 워크플로우 아래에 공유 인프라가 될 수 있습니다.
Knolo의 필요성 (Why Knolo)
| 기존 AI 지식 레이어 | Knolo |
|---|
| 요청 시점에 불투명하게 조립되는 컨텍스트(Context assembled opaquely at request time) | 마운트되고 검사 가능한 Knowledge Image |
| ... | |
| Knolo는 또 다른 모델 제공업체나 채팅 애플리케이션이 되려고 하지 않습니다. 그것은 해당 제품들이 구축할 수 있는 지식 및 런타임 기반입니다. | |
현재 존재하는 것들 (What exists today)
이 저장소에는 V5 Knowledge Image 기반 위에 V6 KAR 표면(surface)과 변경되지 않은 V4 참조 경로가 포함되어 있습니다.
Knowledge Images
V5는 다음을 갖춘 최소한의 검증 가능한 컨테이너를 정의합니다:
- 생성 기반 복구 및 활성 커밋 포인터를 갖춘 이중 슈퍼블록(dual superbblocks);
- 불변 객체 및 이벤트 세그먼트(immutable object and event segments);
- 부모, 객체, 이벤트, 뷰, 스키마, 정책, 런타임, 시퀀스 루트를 포함하는 커밋 기록(commit record);
- 섹션별 경계 및 다이제스트(digests);
- 필수 섹션, 오프셋, 중복 영역, 중복 섹션, 정수 오버플로우, 다이제스트 불일치에 대한 실패 폐쇄 검증(fail-closed validation);
- 알 수 없는 선택적 섹션에 대한 순방향 호환 처리(forward-compatible handling).
그 결과는 마운트(mount)하고, 검사(inspect), 검증(verify), 복사(copy), 그리고 런타임 전반에 걸쳐 비교할 수 있는 경계가 지정된 바이트 아티팩트입니다. V5의 stateRoot가 이미지를 식별합니다. KAR의 knowledgeRoot는 다른 다이제스트를 가집니다.
KAR
KAR은 선언된 계획(declared plan) 하에서 명제(proposition)를 평가하는 데 필요한 최소 적용 가능 증거 세트(minimum applicable evidence set)를 요청합니다. 지지(Support), 반대(opposition), 한정(qualification), 시간적 적용성(temporal applicability), 그리고 권위(authority)는 해당 계획에 의해 유형화됩니다. 평가는 재현 가능(replayable)합니다. 이는 순위가 매겨진 구절 검색이 아니며 query()를 대체하지 않습니다.
커밋된 증거 그래프(Committed Evidence Graph)는 편집 가능한 CEG 소스(CEG Source)로부터 컴파일됩니다. compileCegSource()가 해당 바이트를 작성합니다. 저작권 가져오기(Authoring imports)는 @knolo/core/kar/authoring에서 옵니다. 커버리지 보고서(coverage report)는 어떤 제공된 증거 요구 사항이 충족되었는지, 어떤 것이 격차(gaps)인지, 그리고 어떤 계획들이 결정하지 않았는지 알려줍니다. 작동 데모는 examples/kar-v6와 examples/kar-coverage입니다. 공개 벡터는 conformance/kar/v1와 conformance/kar/coverage-v1입니다.
계약(Contracts), 정책(policy), 및 운영(operations) 도메인 팩(Domain Packs)은 CEG 소스를 제안할 수 있습니다. 이들의 성숙도는 domains/v6-catalog.json에서 review-required입니다. 이러한 제안이 검증된 의미론(validated semantics)으로 취급되기 전에는 여전히 인간의 검토가 필요합니다. KAR은 어쨌든 이미 커밋된 그래프를 평가합니다.
논문: KAR-1: Committed Knowledge Images에 대한 경계 제약 최소 증거 검색 (사전 인쇄본).
결정론적 계약(Deterministic contracts)
Rust와 TypeScript는 핵심 바이트 및 루트 계약에 대해 황금 벡터를 공유합니다:
- 결정론적 CBOR 인코딩(deterministic CBOR encoding);
- 도메인 분리된
knolo:<도메인>:v1 SHA-256 다이제스트(SHA-256 digests);
- 객체, 이벤트, 커밋 및 상태 루트(object, event, commit, and state roots);
- 슈퍼블록 선택 및 찢어진 쓰기 복구(superblock selection and torn-write recovery);
- 섹션 디렉토리 및 다이제스트 검증(section directory and digest validation);
- 마이그레이션 영수증(migration receipts).
V4 마이그레이션(V4 migration)
기존 V1~V4 아티팩트는 여전히 읽을 수 있습니다. V4 아티팩트는 먼저 검증된 후, 결정론적으로 V5 제네시스 이미지로 마이그레이션될 수 있습니다. 이 마이그레이션은 소스(sources), 청크(chunks), 클레임(claims), 에이전트(agents) 및 메타데이터를 가져오고; 레거시 블록 식별자를 안정적인 증거 ID로 매핑하며; 소스 다이제스트, 대상 루트 및 ID 매핑을 포함하는 영수증을 방출합니다.
읽기 전용 런타임 기반(Read-only runtime foundation)
현재 V5 커널은 신뢰할 수 있는 지식 제품을 구축하는 데 필요한 기본 요소들을 지원합니다:
- 콘텐츠 주소 지정 객체 및 불변 이벤트(content-addressed objects and immutable events);
- 단일 작성자 동시성 프로파일을 가진 스냅샷 리더(snapshot readers with a single-writer concurrency profile);
- 제한된 EQL 쿼리 계획 및 결정론적 결과 영수증(bounded EQL query planning and deterministic result receipts);
- 쿼리 인덱스 및 히스토리(query indexes and history);
- 정책 평가, 권한 세션, 서명된 봉투, 키 로테이션(policy evaluation, authority sessions, signed envelopes, and key rotation);
- 동기화 요약, 패스트 포워드 교환, 병합 계획 및 리플레이(sync summaries, fast-forward exchange, merge planning, and replay);
- 호스트 제어 실행 경계를 가진 영속적인 에이전트 실행(durable agent runs with host-controlled execution boundaries);
- 런타임 상태 및 진단(runtime health and diagnostics);
- 읽기 전용 Studio 관리 스냅샷 계약, KIP-0026(a read-only Studio management snapshot contract, KIP-0026);
- 네이티브 Rust 검증 및 마이그레이션 기반(native Rust verification and migration foundations).
트랜잭션(Transactions), 권한 변경 워크플로우(authority mutation workflows), 네트워크 오케스트레이션(network orchestration), 모델 추론(model inference), 그리고 Studio UI/서비스는 의도적인 후속 계층으로 남아 있습니다.
간단한 아키텍처(A simple architecture)
소스(Sources), 주장(claims), 에이전트(agents), 메타데이터(metadata)
│
▼
...
경계는 의도적입니다. Knolo가 아티팩트, 식별자(identity), 증거(evidence), 루트(roots), 검증(validation), 결정론적 계획(deterministic planning), 그리고 제한된 런타임 상태(bounded runtime state)를 소유합니다. 호스트 애플리케이션은 네트워킹, 자격 증명(credentials), 모델 추론(model inference), 외부 부작용(external side effects), 그리고 배포 선택권 등을 소유합니다.
제품 표면 (Product surface)
| 레이어 (Layer) | 역할 (Role) | 현재 경로 (Current path) |
|---|
| 지식 아티팩트 (Knowledge artifact) | 포터블(Portable) 소스, 청크, 주장, 에이전트, 메타데이터, 오브젝트, 이벤트 | @knolo/core |
| ... | | |
빠른 시작 (Quickstart)
호환 가능한 애플리케이션 생성
npx create-knolo-app my-knowledge-app
cd my-knowledge-app
pm install
...
이 스타터 작업 공간은 애플리케이션에 V4 호환 검색 경로를 제공하며, V5 아티팩트를 점진적으로 채택할 수 있는 여지를 남겨둡니다.
V5 이미지 검사 및 검증
npm run knolo -- v5 info ./dist/knowledge.v5
npm run knolo -- v5 health ./dist/knowledge.v5
npm run knolo -- v5 studio ./dist/knowledge.v5
허브 팩(Hub pack) 검색 및 설치
CLI를 사용하면 프로덕션 허브(production Hub)에 게시된 팩을 검색하고, 매니페스트(manifest), Blob 바이트, 다이제스트(digest), 크기, 그리고 로컬 V4/V5 지식 이미지 구조를 검증한 후에만 설치할 수 있습니다:
npm install -g @knolo/cli
knolo search "refund policy"
knolo info acme/refund-policy
...
설치는 콘텐츠 주소 지정 방식(content-addressed)이며 knolo.lock.json에 기록됩니다. 로컬 또는 파트너 허브를 테스트할 때는 KNOLO_HUB_URL 또는 --registry를 사용하십시오.
Hub write API는 필수 Authorization: Bearer kno_… 헤더와 함께 대시보드 kno_… 토큰을 받습니다. knolo login은 원본 시크릿(raw secret)을 로컬에 저장하며, GitHub 로그인만 https://hub.knolo.dev/dashboard/tokens에서 토큰을 발급받는 데 필요합니다. knolo publish는 이 토큰을 사용하여 Hub에 공개 Blob PUT grant를 요청하고, 그 grant URL로 바이트를 업로드(절대 kno_… 토큰 사용 금지)한 다음, 공개 pack URL로 완료합니다. CLI에서 PACKS_READ_WRITE_TOKEN을 설정하지 마십시오. 이는 Hub의 저장소 시크릿입니다.
knolo login --token kno_…
knolo publish ./dist/knowledge.knolo --slug refund-policy \
--version 1.2.0 --license Apache-2.0
...
CLI는 sha256/<64-lowercase-hex>.knolo 경로명을 사용합니다. Hub 검증은 아티팩트를 가져와야 하므로 private Blob 호스트를 거부합니다. 이 토큰은 쿼리 문자열, 쿠키 또는 pack 바이트에 절대 전송되지 않습니다. 401 오류는 일반적으로 Bearer 단어가 누락되었거나 토큰이 취소되었음을 의미하며, Hub가 GitHub 브라우저 세션을 요구한다는 뜻이 아닙니다. 저장된 자격 증명을 테스트하려면 다음을 사용하십시오:
curl -sS -H "Authorization: Bearer kno_…" \
-H "Accept: application/json" \
https://hub.knolo.dev/api/v1/account
POST /api/v1/tokens는 CLI 로그인 엔드포인트가 아니며, 대시보드/세션 토큰 발급 전용입니다.
V5 커널 직접 사용