@ 认知一/ sdk
公务 认知 SDK用于节点.js和TypeScript.
跟一个说 认知种子 电器(直接,超过mDNS / USB设备/局域网)
或 认知云 控制平面(api.cognitum.one) (中文(简体) ).
安装
npm install @cognitum-one/sdk
# optional: mDNS discovery
npm install multicast-dns
需要节点.js >=18。 。 。 .
快速开始——与种子交谈
import { SeedClient } from "@cognitum-one/sdk/seed";
const client = new SeedClient({
endpoints: "https://cognitum.local:8443",
tls: { insecure: true }, // dev-only; use tls.ca for production
});
const status = await client.status();
console.log(`seed ${status.deviceId}, epoch ${status.epoch}`);
const result = await client.store.query({ vector: [0.1, 0.2, /*...*/ 0.8], k: 3 });
特征
- 12个打出种子终点(状态,对接,目击,保管,存储,OTA,
- 与最接近的首发、会话粘接读取的网格路由 5xx 上失败
client.mesh()可观察性包装器(状态/同位素/群/群)- 待命
CallOptions—— 说peer编号 :prefer编号 :consistency编号 :timeout编号 :retries - 发现提供者 :
ExplicitDiscovery, (中文(简体) ),MdnsDiscovery, (中文(简体) ),TailscaleDiscovery - TLS - 明确的CA,
fp=sha256:<hex>cert pinning, 或只读insecure - 信任分数 三击截断; 修改
SecretString围绕配对符 - ADR-0005 重试 / 速率限制( 500 ms 基数, 30 s 顶数, 60 s s 壁点)
- 具有 HTTP 和 stdio 传输功能的 MCP 客户端
代理层(v0.3)
Meta-LLM、Meta-Proxy、HarnessaS和MetaHarness 的客户端,加一个 共享代理合同层,全部添加到上面的种子/云客户端.
import { MetaLlmClient } from "@cognitum-one/sdk/meta-llm";
import { StaticApiKeyCredentialProvider } from "@cognitum-one/sdk/agentic";
const llm = new MetaLlmClient({
baseUrl: "https://api.cognitum.one",
credentialProvider: new StaticApiKeyCredentialProvider({
product: "meta-llm",
normalizedOrigin: "https://api.cognitum.one",
audience: "https://api.cognitum.one", // must match baseUrl (ADR-0022 §D3)
}), // reads COGNITUM_API_KEY by default
});
// Each yielded value is a MetaLlmStreamEnvelope<OpenAiStreamEvent> -- the
// event itself lives on .event; the envelope only carries metadata
// (sequence, receivedAt, requestId, ...).
for await (const envelope of llm.chat.completionsStream({
model: "cognitum-meta-llm",
messages: [{ role: "user", content: "hello" }],
})) {
if (envelope.event.type === "content_delta") process.stdout.write(envelope.event.delta);
}
| 命名空间 | 成熟度 | 页:1 |
|---|---|---|
@cognitum-one/sdk/agentic | 可用 | 身份证明,打出错误/重写,收据+分行,编辑,W3C痕量上下文. 遥测原始是公用/测试的,但还没有产品客户端将它们接入活出排放路径. |
@cognitum-one/sdk/meta-llm | 可用 | 6 服务协议,OpenAI/Anthropic SSE流线,路由,收据. 平台资源(boutches, pockes, Brain,.)是只使用REST的—— 问题59。 。 。 . |
@cognitum-one/sdk/meta-proxy | 可用 | 本地状态/能力+聊天. 完成转发(流出+非流出),同意加分云路由. |
@cognitum-one/sdk/harnessaas | 可用 | 真实同步 health 编号 : solve 编号 : lineage上游尚未签订临时工作/投票/核准合同. |
@cognitum-one/sdk/metaharness | 合同预览 | 完全打入地表,每一次呼叫失败关闭——还没有公布本地桥协议. |
见 ../../capabilities/sdk-release.v1.json
用于所有3个SDK的全机可读成熟度/地貌矩阵.
文档
- 交叉性:
../../docs/adr/ - 节点特定发展成果评估 :
docs/adr/ - 更改日志 :
CHANGELOG.md
许可证
阿帕奇-2.0 — 见 LICENSE。 。 。 .