Skip to content

包入口

Duclaw SDK 暴露三个公开 package entrypoints。

duclaw-cli/sdk

用于通用 SDK 集成。

ts
import { createAgent, memoryStorage, tool, type LLMClient, type Storage } from "duclaw-cli/sdk";

它导出友好的 Agent facade、tool builder、model helper、memory storage 和公开类型,不包含 CLI 或 server 启动副作用。

duclaw-cli/sdk/core

用于低层运行时组合。

ts
import { createCoreAgent, createToolRegistry, createRuntimeEventBus } from "duclaw-cli/sdk/core";

这个 subpath 包含 core contracts、registries、runtime event primitives、channel contracts 和 storage factories,适合自己组装运行时的应用。

duclaw-cli/sdk/duclaw

只有在需要 Duclaw 产品组合时使用这个入口。

ts
import { duclawPreset } from "duclaw-cli/sdk/duclaw";

这个 subpath 提供 duclawPreset() adapter,面向明确需要 Duclaw 产品默认能力的调用方。

部分低层 Duclaw 组合 helper 会保留一个兼容窗口,但新的集成应从 duclawPreset() 开始。

边界规则

通用集成应依赖 duclaw-cli/sdk

运行时作者需要低层组合时,可以选择 duclaw-cli/sdk/core

应用或产品层只有在明确需要 Duclaw 默认能力时,才选择 duclaw-cli/sdk/duclaw

随 duclaw-cli package 一起发布。