@ godspideai/ cognate- 内核- cordis
全面执行《公约》 @godspeedai/cognate-kernel-api
内核合同——范围,组件,能力,纤维,效果,政策——以Cordis为基础
插件系统。 这是唯一一个 cognate 包导入 cordis类型
其公共表面:消费者程序完全违背内核合同.
何时使用此软件包 : 你想要一个独立的能力内核 没有其他的
运行时间。 大多数申请都通过
@godspeedai/cognate-runtime-bun, (中文(简体) ),
它嵌入了这个内核.
安装
bun add @godspeedai/cognate-kernel-cordis
要求数 阿宝 >= 1.4.0 (中文(简体) )cordis 自动安装为依赖.
快开始
import { allowCapabilities, isUnavailable } from "@godspeedai/cognate-kernel-api";
import { createCordisKernel } from "@godspeedai/cognate-kernel-cordis";
const kernel = await createCordisKernel({
tenant: "tenant-a",
principal: { id: "system", kind: "system" },
policy: allowCapabilities("allow-greetings", ["greet"]),
});
// Mount a component; its activation runs, and its capability is published on success.
const handle = await kernel.mount({
id: "greeter",
provides: [{ id: "greet", version: "1.0.0" }],
activate(fiber) {
fiber.effects.register(() => console.log("greeter cleaned up"));
fiber.provide({ id: "greet", version: "1.0.0" }, async (name: string) => ({ hello: name }));
},
});
await handle.waitFor("ACTIVE");
// Resolution matches deterministically and never consults policy;
// the invocation is what the policy authorizes.
const resolved = kernel.resolve({ capability: "greet" });
if (!isUnavailable(resolved)) {
const result = await resolved.invoke("Ada", {
actor: { id: "alice", kind: "user" },
correlationId: "corr-1",
});
console.log(result); // { ok: true, value: { hello: "Ada" } }
}
// Disposes every fiber and effect, children first.
await kernel.shutdown("done");
createCordisKernel 是一个 KernelFactory: 它返回一个 Kernel 谁 mount, (中文(简体) ), resolve, (中文(简体) ),
observe,以及 shutdown 遵循共享合同。 失败的决议并非例外——它
返回时 { unavailable: true, requirement, reason },哪个 isUnavailable 区别于 a
租赁.
引擎能保证什么
- 完全或无动于衷. 失败的激活处理此尝试的反向效果
命令和发布什么。 需求缺失的构成部分
WAITING没有 当兼容的提供者出现时,纤维和会自动激活. - 有秩序地撕裂.
handle.dispose, (中文(简体) ),scope.close,以及kernel.shutdown运行每个处置者 倒序并具有同位素; 失败汇总为单个CleanupError拒绝. 关闭范围首先关闭儿童. - 撤销. 每一次激活和引用都带有
AbortSignal,在调用时中止 取消、期限到期或供应商拆解. - 复以回向为相. 按组件重试的瞬态激活失败
retry政策. 掷出PermanentActivationError跳过重试直到handle.reset()。超过activationTimeoutMs(默认为 30 秒) 瞬间失败而不是被挂起 . - 范围能见度. 提供的能力在范围上是可见的,只有后人才有; 双人瞄准镜从没见过它。 儿童范围可能缩小主要范围,从不通过 继承.
- 审计.
kernel.observe光纤状态过渡、能力公布和 退出,清理失败,以及一切政策决策.
限制
- 流程中和单租户:一个内核服务于一个租户,没有网络表面. 这个 跑步时间层 呼叫者租房和服务在顶上.
- 升入封闭的瞄准镜
ScopeClosedError。 。 。 . - 内核解决和引用能力,但对耐久性、运行、事件或 坚持不懈——这是运行时间的工作.
相关软件包
@godspeedai/cognate-kernel-api—— 说 包括它通过的配套套房.@godspeedai/cognate-runtime-bun—— 说 嵌入这个内核的参考运行时间 .@godspeedai/cognateSDK伞.
许可证
阿帕奇 - 2.0