@godspeedai/cognate-react

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 3532

反应19对无头客户端的绑定:运行,预测,前端能力,续作,文物(spec §25.2). 没有 Astryx.

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 钩子
  4. 限制
  5. 相关软件包
  6. 许可证

@ godspideai/ cognate- react

对Cognate进行19个装订:将运行,活预测,前端能力,续作,以及文物放入您组件的无头客户端上薄钩. 设计-系统免费——带出自己的渲染器.

何时使用此软件包 : 您为 Cognate 运行时间构建一个 React 前端, 并想要处理状态管道( 订阅、 重放、 注册生命周期) 而不采用组件库 。 现成聊天/核准/艺术表面,层 @godspeedai/cognate-ui-astryx 在顶上.

安装

bun add @godspeedai/cognate-react

要求数 阿宝 ++ 1.4.0和++++ 反应 19.3.0 (被宣布为同伴依赖, "react": "19.3.0") (中文(简体) ). 取决于 @godspeedai/cognate-client 每个钩子都读取 CognateClient,这仍然是真相的唯一来源。 包件船 Bun-native TypeScript 源; 如果您在 Bun 外键入, 请添加 @types/bun 财务报告和审定财务报表 @types/node。 。 。 .

快开始

import { createClient } from "@godspeedai/cognate-client";
import { CognateProvider, useAgent, useContinuations } from "@godspeedai/cognate-react";
import { createRuntime } from "@godspeedai/cognate-runtime-bun";

const runtime = await createRuntime({
  store: ":memory:",
  agents: [myAgent],
  policy, // your kernel invocation policy
  actions, // your action authorization
});
const caller = { actor: { id: "alice", kind: "user" }, tenant: "tenant-a" };
const client = createClient({ service: runtime.service, caller });

function App() {
  const { start, runId, state } = useAgent("agent.support");
  const { open, resolve } = useContinuations(runId);

  return (
    <main>
      <button onClick={() => void start({ message: "I was double charged" })}>Ask</button>
      <p>{state?.text}</p>
      {open
        .filter((c) => (c.condition as { kind?: string } | null)?.kind === "human_approval")
        .map((c) => (
          <button key={c.id} onClick={() => void resolve(c.id, "resume", { approved: true })}>
            Approve {c.id}
          </button>
        ))}
    </main>
  );
}

// Wrap once, near the root:
<CognateProvider client={client}><App /></CognateProvider>;

钩子

钩子目的
useCognate()从最近的客户端 CognateProvider
useRun(runId)现场直播 RunState 状态,流式 text,错误,打开的续作,文物,衍生状态
useAgent(agent)start(input),最新数据 runId及其状态
useSharedState(runId)运行的活共享状态加 update(patchOrSnapshot); 写解决一旦持久并被被中止代理通过 RunContext.state
useThreadSharedState(threadId)相同的, 由所有运行在线程中共享
useProjection(name)公开投影的条目
useCapability(capability, handler)在组件挂起时服务前端能力; 未注册在卸载上, 留下任何打开的继续等待
useRemoteCapability(offer, handler, options?)(一) 发布装机寿命的描述式辅助远程能力; options.render 记录每个持久呼叫的用户界面;返回 { status, error }
useRemoteCapabilityHistory(runId)运行中远程能力呼叫(仅同一次)
useContinuations(runId)打开续作+ resolve(id, "resume" | "cancel", input?)
useArtifact(artifactId)获取文物 : { status, name, mediaType, text? } (文本解码为: text/* 媒体类型)
useConnectionStatus()客户端的连接状态

所有订阅钩是 useSyncExternalStore 适配器凌驾于客户端的被动存储器之上,因此它们也在服务器渲染下工作:客户端将缓冲历史重放入第一次订阅.

限制

  • 软件包没有做任何事情,也没有风格;它是钩子和提供者。 Astryx 类型和组件按设计不开放.
  • 远程能力使出处活在挂载提供者的内存中——在整页重新装入之后,耐用电话仍然可以检查,但原始的渲染器组件已经消失.
  • useCapability 财务报告和审定财务报表 useRemoteCapability 后续组件寿命:卸载会撤回能力或提议; 代理等待中位停留,而不是倒下.

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-react 共发布 20 个版本,首次发布于 2026/10/09;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2523 天前

关于 @godspeedai/cognate-react 的常见问题

@godspeedai/cognate-react 是什么?

反应19对无头客户端的绑定:运行,预测,前端能力,续作,文物(spec §25.2). 没有 Astryx.

如何安装 @godspeedai/cognate-react?

在项目目录运行 npm install @godspeedai/cognate-react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(19.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@godspeedai/cognate-react 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/godspeedai__cognate-react 是否存在。

@godspeedai/cognate-react 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@godspeedai/cognate-react 可以商用吗?

@godspeedai/cognate-react 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@godspeedai/cognate-react 的下载量有多少?

根据 npm 官方下载统计,@godspeedai/cognate-react 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,532 次,日均约 118 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@godspeedai/cognate-react 还在维护吗?

最新版本 0.10.0 发布于 2026/11/16(今天);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/10/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。