Skip to content

feat(sdk): prepare @mosoo/sdk public beta - #528

Draft
Yevanchen wants to merge 1 commit into
mainfrom
feat/sdk-public-beta
Draft

feat(sdk): prepare @mosoo/sdk public beta#528
Yevanchen wants to merge 1 commit into
mainfrom
feat/sdk-public-beta

Conversation

@Yevanchen

Copy link
Copy Markdown
Collaborator

背景

Issue #489 的几次 dogfood 都说明:应用接入 Mosoo 时,会重复实现 Thread/Run 协议、终态判断、错误处理、重试安全和 delegation 校验。

这个 Draft 不新建一套框架,而是把仓库现有的 public API client 收敛成第一个可发布的 TypeScript SDK Beta。

@WH-2099 麻烦帮忙 review,重点看:

  • Public Beta 的 SDK API 和范围是否合理
  • package 名称、npm 首发和 GitHub Actions 发布方式
  • Run 终态、finalOutput、delegation 校验和 artifact 契约
  • 是否有不该放进首版的内容

本次改动

  • 将现有 client 发布面整理为 @mosoo/sdk 0.1.0-beta.0
  • 增加可恢复的 Run 等待、规范 finalOutput、结构化错误和 delegation 校验
  • 增加 Run artifact 的持久化与 Public API 契约
  • 增加 Node.js 22/24、Cloudflare Worker、tarball 安装验证
  • 增加手动 npm Beta 发布 workflow、changelog、license 和发布手册
  • 更新 SDK PRD、架构和相关 Public API 文档

影响

应用后端可以直接安装 SDK 调用已发布 Agent,不再手写 Mosoo 协议和安全边界。这个 PR 本身不会发布 npm;workflow 只允许从 main 手动触发,并经过 npm environment。

验证

  • just check:通过,1,207 tests passed
  • SDK lint:通过
  • SDK typecheck:通过
  • SDK tests:26 passed,包含 clean tarball 和真实 Cloudflare Worker fixture
  • commit / pre-push policy:通过

Draft 阶段仍需完成

  • Reviewer 确认 Beta 范围和 npm 发布配置
  • 配置 npm scope / GitHub npm environment
  • 未参与实现的开发者完成 15 分钟文档验收
  • 首次 Beta 发布后完成 npm clean-install smoke

Related to #489 and #505.

@Yevanchen
Yevanchen requested a review from WH-2099 August 11, 2026 12:23
@Yevanchen
Yevanchen force-pushed the feat/sdk-public-beta branch 3 times, most recently from 6afe7d9 to 7153758 Compare August 20, 2026 16:26
@Yevanchen
Yevanchen force-pushed the feat/sdk-public-beta branch from 7153758 to f88034f Compare August 21, 2026 16:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant