Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .agents/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,5 @@ state. A local/runtime result is not cloud acceptance or package publication.
- [Shared application authentication tests](notes/proposed/feature/2026-10-26-shared-application-auth-tests.md) · [verification](evidence/verify/2026-10-26-shared-application-auth-tests.md).

- [README audience review](notes/proposed/process/2026-10-28-readme-audience-review.md) · [verification](evidence/verify/2026-10-28-readme-audience-review.md).

- [Preview release notice and community](notes/proposed/process/2026-11-10-preview-release-community.md) · [verification](evidence/verify/2026-11-10-preview-release-community.md).
22 changes: 22 additions & 0 deletions .agents/evidence/verify/2026-11-10-preview-release-community.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Verification: Preview release notice and developer community

- Date: 2026-11-10
- Base revision: `898280c7a02d6637b17128a3a8f43a28c6b1a5f7`
- Scope: bilingual root READMEs and the original community QR image and this repository's engineering record.
- Environment: Linux, Node.js 22.22.2, Python 3.13.13.
- Result: PASS — scoped local validation; remote CI, merge and publication are separate.

## Content and image

The original 470 × 468 PNG was downloaded from the maintainer's attachment without editing. Independent decoding resolves the supplied DingTalk join code. Its origin query parameter is 1, while the supplied clickable URL has origin 11; both retain the exact same join code. Preserve both supplied inputs.

## Validation

- PASS: Scoped documentation/image and record checks; executable SDK files are unchanged.
- PASS: both root README languages checked for expected date/version/preview language, group number and exact original image bytes; all relative Markdown links resolve.
- PASS: `git diff --check`; seven-section note, matching proposed status and local evidence/index links inspected.
- The exact scoped files are this commit's README/image/UI changes and engineering records. Documentation checks do not establish runtime or cloud acceptance.

## Limitations and cleanup

No package release, cloud sandbox or model task is part of this documentation change. No temporary cloud resources created. DingTalk membership was not joined or authenticated. Publication is checked separately after merge.
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Decision: Preview release notice and developer community

Status: proposed

## Problem

Readers need the maintainer's expected project 1.0.0 release date and one discoverable developer community contact.

## Decision

Update bilingual root READMEs and the original community QR image. State that Agent Sandbox is in preview, may introduce breaking changes, and is expected to release stable 1.0.0 on November 15, 2026. Keep the existing repository introduction and quick start. Use the supplied DingTalk group name, number 213605001586, join URL and unchanged QR image. This is a project announcement, not a package version change or a claim that release gates have passed.

## API Design

N/A — this decision does not involve API changes.

## Alternatives considered

A package version bump would incorrectly publish a future plan. An image-only contact would exclude readers who cannot scan it. An externally hosted upload would make the contact depend on the attachment service; keep the supplied image in the repository.

## Dependencies

The date and community details come from the maintainer's November 10 request. Shared UI is owned by https://github.com/Alibaba-Agent-Sandbox/website and synchronized to https://github.com/Alibaba-Agent-Sandbox/registry with its exact source manifest.

## Test Strategy

Check the changed document links, translations, image bytes and decoded destination. Run owner documentation gates; build and inspect both sites at desktop/mobile widths and both themes. Required remote CI/review and actual publication are separate from local validation.

## Acceptance criteria

The expected date, version, preview warning and community contact are visible in both README languages. New links and image paths resolve. No package/runtime version or existing user workflow changes. Site changes are bilingual, responsive and share identical UI sources. Merge only after applicable checks pass.

## Evidence

[Verification](../../../evidence/verify/2026-11-10-preview-release-community.md).
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ Call sandbox application services from JavaScript or TypeScript. `@agent-sandbox

Requires Node.js 20+ and ESM. Create the sandbox and start its service with the [abx CLI](https://github.com/Alibaba-Agent-Sandbox/agent-sandbox) or [Python SDK](https://github.com/Alibaba-Agent-Sandbox/python-sdk); this package connects to that running service.

> **Preview release:** Agent Sandbox is currently in preview and may introduce breaking changes. The stable **1.0.0** release is expected on **November 15, 2026**. Stay tuned!

## Install

Build the package from source:
Expand Down Expand Up @@ -81,6 +83,14 @@ These helpers look up names and values; they do not configure `ServerClient` or

Run `npm ci`, `npm run typecheck` and `npm test`. The tests build the SDK first. See [examples](examples/README.md) for the local agent loop and its Python runtime prerequisite. Report problems in [Issues](https://github.com/Alibaba-Agent-Sandbox/nodejs-sdk/issues).

## Community

Join the **Agent Sandbox 开发者工具交流群** on DingTalk to discuss usage and share feedback. [Join the group](https://qr.dingtalk.com/action/joingroup?code=v1,k1,kIZr4Ai7sYm4U0xoz1p1QSlgoBHeoi/kE5TkIXeFCR4=&_dt_no_comment=1&origin=11) or search for group number **213605001586**.

Scan the QR code with DingTalk:

<a href="https://qr.dingtalk.com/action/joingroup?code=v1,k1,kIZr4Ai7sYm4U0xoz1p1QSlgoBHeoi/kE5TkIXeFCR4=&amp;_dt_no_comment=1&amp;origin=11"><img src="assets/dingtalk-group.png" alt="DingTalk group QR code" width="235" /></a>

## License

[Apache-2.0](LICENSE). See [NOTICE](NOTICE) for attribution.
10 changes: 10 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@

需要 Node.js 20+,仅支持 ESM。先用 [abx CLI](https://github.com/Alibaba-Agent-Sandbox/agent-sandbox) 或 [Python SDK](https://github.com/Alibaba-Agent-Sandbox/python-sdk)创建沙箱并启动服务,再通过本包连接。

> **预览版说明:** Agent Sandbox 目前处于预览阶段,可能会有不兼容变更。预计于 **2026 年 11 月 15 日**发布 **1.0.0 正式版**,敬请期待!

## 安装

从源码构建安装包:
Expand Down Expand Up @@ -81,6 +83,14 @@ readEnv("sandbox_api_key", process.env);

运行 `npm ci`、`npm run typecheck` 和 `npm test`,测试会先构建 SDK。本地 Agent 循环及其 Python 运行时前提见[示例](examples/README.md)。问题请提交到 [Issues](https://github.com/Alibaba-Agent-Sandbox/nodejs-sdk/issues)。

## 交流与反馈

欢迎加入 **Agent Sandbox 开发者工具交流群**,交流使用经验、分享建议与反馈。[点击加入钉钉群](https://qr.dingtalk.com/action/joingroup?code=v1,k1,kIZr4Ai7sYm4U0xoz1p1QSlgoBHeoi/kE5TkIXeFCR4=&_dt_no_comment=1&origin=11),或搜索钉钉群号 **213605001586**。

也可以使用钉钉扫描二维码加入:

<a href="https://qr.dingtalk.com/action/joingroup?code=v1,k1,kIZr4Ai7sYm4U0xoz1p1QSlgoBHeoi/kE5TkIXeFCR4=&amp;_dt_no_comment=1&amp;origin=11"><img src="assets/dingtalk-group.png" alt="钉钉交流群二维码" width="235" /></a>

## 许可证

[Apache-2.0](LICENSE),署名信息见 [NOTICE](NOTICE)。
Binary file added assets/dingtalk-group.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading