Knolume Runtime.

面向 AI 应用的可组合执行能力

GitHub

公开的 TypeScript 运行时库，提供 Agent 运行、工具、上下文、记忆、检索、安全检查与子 Agent 能力；模型、工具、身份和产品策略由宿主提供。

TypeScript
AI SDK
Tool calling
Guardrails
RAG
Vitest

方向: Agent 系统
实现重点: Agent 循环、工具管线、上下文、记忆、检索、安全检查与协议契约。
可查看的内容: 查看公开源码、确定性示例与 v0.4.0 版本化发布。

要解决的问题

Agent 应用需要的不只是模型循环。工具副作用、审批、上下文限制、取消和记录都需要组合起来，同时避免每个产品被迫继承同一套业务规则或入口。

模块如何协作

可组合的 Agent 运行时

宿主模型与策略

Agent 循环与上下文

工具执行与审批

安全检查 · 追踪 · 恢复

公开运行时库 · 产品决策留在宿主

该库提供运行时模块和协议契约。应用负责模型、提示词、具体工具、授权、存储与传输；图中不是一个独立托管的服务。

关键工程决策

抽取可复用执行核心

Agent 循环依赖工具运行时契约。模型调用与运行事件位于库中，产品工具和权限策略留在宿主应用。

在副作用发生前设闸

输入检查运行时可以先缓冲生成事件；工具执行等待输入副作用闸门放行。被拒绝的运行会丢弃缓冲输出，不会呈现为已完成工作。

发布可集成的边界

版本化包、公开入口与确定性示例让其他应用能够检查并集成该库，同时明确它并不自带 CLI 或产品服务。

可靠性与失败处理

明确取消与恢复

取消信号贯穿执行流程。会话、追踪和安全检查代码会区分中断或拒绝的工作与成功结果。

产品策略不混入运行时库

身份、租户隔离、凭证、审批和具体工具由宿主负责；运行时安全检查不替代这些授权边界。

离线验证有明确范围

仓库提供测试、覆盖率与确定性示例。这些检查不能证明真实模型效果或使用该库的产品已在生产中运行。

证据与范围

源码链接固定到已阅读版本，便于逐项查看实现依据。

Agent 循环

运行事件、模型步骤、取消和工具运行时组合。

src/harness/agent/loop.ts

工具执行边界

参数校验、权限、审批与执行结果。

src/tools/execution-pipeline.ts

安全检查执行器

缓冲检查、副作用闸门与恢复处理。

src/harness/guardrails/runner.ts

确定性示例

无需真实模型的可运行集成示例。

examples/basic-agent.mjs

行为测试

查看测试内容；链接不代表最新 CI 运行已通过。

src/harness/agent/loop.spec.ts

本案例的依据范围

可查看公开源码与 v0.4.0 GitHub Release。它是运行时库，不是托管应用，也不是已归档 coding-agent 应用的即插即用替代品。

查看已归档的前身

继续探索Agent OS