From d539578b6ee7d205c353a742a6fb52d56e676a4c Mon Sep 17 00:00:00 2001 From: AnyEnv Sandbox Date: Sun, 25 Oct 2026 16:19:08 +0000 Subject: [PATCH 1/2] docs: select public a3 runtime and matching schema in the Node example --- .agents/README.md | 6 ++- .../2026-10-25-current-public-server-a3.md | 21 ++++++++++ .../2026-10-25-current-public-server-a3.md | 42 +++++++++++++++++++ .github/workflows/ci.yml | 4 +- CHANGELOG.md | 2 + examples/README.md | 6 +-- 6 files changed, 74 insertions(+), 7 deletions(-) create mode 100644 .agents/evidence/verify/2026-10-25-current-public-server-a3.md create mode 100644 .agents/notes/proposed/process/2026-10-25-current-public-server-a3.md diff --git a/.agents/README.md b/.agents/README.md index 3b801c2..e73960e 100644 --- a/.agents/README.md +++ b/.agents/README.md @@ -1,12 +1,12 @@ # Node SDK engineering records -## Current delivery — 2026-10-24 +## Current delivery — 2026-10-25 - Source package version: **0.1.0**. [Source installation](../README.md#install) builds and packs the SDK. The recorded delivery is source merge, not npm publication. - Scope: application HTTP `ServerClient` and configuration-name exports. No cloud lifecycle, template build, provider engine, PTY or interpreter client is exported. - [Bound HTTP endpoint acceptance](evidence/verify/2026-10-23-bound-http-control-review.md) and [proxy-token acceptance](evidence/verify/2026-10-24-proxy-application-token.md) cover copied headers, preserved gateway URL/query, redirect refusal and no automatic credential retry. - The proxy record includes the actual OpenSandbox python-hello Node calls. The 92-case template matrix used CLI/Python/HTTP and does **not** establish a 92-case Node SDK test. -- The [local runtime example](../examples/README.md) now installs the public Python server 0.4.0a2; its local health/process/file checks do not establish cloud lifecycle support. +- The [local runtime example](../examples/README.md) now installs the public Python server 0.4.0a3; its local health/process/file checks do not establish cloud lifecycle support. [Documentation synchronization decision](notes/implemented/process/2026-10-24-current-docs-and-records.md) · [verification and acceptance reconciliation](evidence/verify/2026-10-24-current-docs-and-records.md). @@ -52,3 +52,5 @@ state. A local/runtime result is not cloud acceptance or package publication. - [Public runtime a2 guidance](notes/proposed/process/2026-10-25-public-runtime-a2.md) · [verification](evidence/verify/2026-10-25-public-runtime-a2.md). - [Example official PyPI index](notes/proposed/process/2026-10-25-example-official-index.md) · [verification](evidence/verify/2026-10-25-example-official-index.md). + +- [Current public server a3](notes/proposed/process/2026-10-25-current-public-server-a3.md) · [verification](evidence/verify/2026-10-25-current-public-server-a3.md). diff --git a/.agents/evidence/verify/2026-10-25-current-public-server-a3.md b/.agents/evidence/verify/2026-10-25-current-public-server-a3.md new file mode 100644 index 0000000..7229e30 --- /dev/null +++ b/.agents/evidence/verify/2026-10-25-current-public-server-a3.md @@ -0,0 +1,21 @@ +# Public server a3 Node guidance verification + +Date: 2026-10-25 +Result: PASS (local verification; remote delivery gate pending) + +Base: main 63d7cd8ece221b9f968eef51eeb932ea334c90d3. Changes only current example, +CI source/runtime version, changelog and records. Node 22.22.2, npm 12.0.2; +Python 3.13.13 with installed public client/server 0.4.0a3 from a fresh official-index +no-cache installation. No PYTHONPATH source injection. + +- `npm ci`, `npm run typecheck`, `npm test`: exit 0; all 24 tests passed. +- `node examples/agent-loop.mjs`: exit 0; actual health true, shell stdout `4\n`, + file `answer=4\n` and owned server SIGTERM exit -15. +- `npm pack --dry-run`: exit 0; built ESM/types present. No package uploaded. +- Public Python config-key JSON equals the complete Node schema: PASS. +- Official npm SDK metadata returned 404; existing source-install guidance remains + accurate. This is not publication of a Node package. +- Scoped record-link existence and `git diff --check`: PASS. + +No cloud resource was created. Exact latest-head Node 20/22 CI, independent review +and actual merge remain delivery checks; the earlier a2 receipts are unchanged. diff --git a/.agents/notes/proposed/process/2026-10-25-current-public-server-a3.md b/.agents/notes/proposed/process/2026-10-25-current-public-server-a3.md new file mode 100644 index 0000000..c58b64b --- /dev/null +++ b/.agents/notes/proposed/process/2026-10-25-current-public-server-a3.md @@ -0,0 +1,42 @@ +# Decision: Select the verified public a3 server for the local example + +Status: proposed + +## Problem + +Python client/server a3 is now public, while the current Node example and CI +select the preceding server and configuration-source release tag. + +## Decision + +Use exact public server 0.4.0a3 from official PyPI in the documented local setup +and CI. Compare configuration exports with matching immutable v0.4.0a3 sources. +Refresh current record navigation; keep earlier evidence as history. + +## API Design + +No Node export, runtime, package-version or publication change. The source package +remains 0.1.0 and is not published to npm by this task. + +## Alternatives considered + +Keeping an older runtime would not test current installation guidance. Adding a +new installer/framework or cloud lifecycle API is unrelated to this update. + +## Dependencies + +https://github.com/Alibaba-Agent-Sandbox/python-sdk/releases/tag/v0.4.0a3 + +## Test Strategy + +Run lockfile installation, typecheck, 24 existing tests, the actual documented +local HTTP/process/file loop and package dry-run with public a3 and no PYTHONPATH. +Compare the full schema, inspect links/diff and wait for Node20/22 CI/review. + +## Acceptance criteria + +Documented current setup, complete schema and actual owned-process cleanup pass. +Required latest-head CI and independent review precede verified normal merge. +No cloud or npm publication claim is made. + +[Verification](../../../evidence/verify/2026-10-25-current-public-server-a3.md). diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 58387c7..891e6ee 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -22,13 +22,13 @@ jobs: - uses: actions/checkout@v4 with: repository: Alibaba-Agent-Sandbox/python-sdk - ref: v0.4.0a2 + ref: v0.4.0a3 path: vendor/python-sdk persist-credentials: false - uses: actions/setup-python@v5 with: python-version: "3.12" - - run: python -m pip install --index-url https://pypi.org/simple "agent-sandbox-server==0.4.0a2" + - run: python -m pip install --index-url https://pypi.org/simple "agent-sandbox-server==0.4.0a3" - run: python -c "import agent_sandbox.server" - name: Compare the complete Python and Node configuration schema run: | diff --git a/CHANGELOG.md b/CHANGELOG.md index 340e696..fd87f4e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,8 @@ ### Documentation +- Select verified public Python server 0.4.0a3 in the local example and CI, with its matching configuration-schema release tag. + - Use the official PyPI index for the local example's exact public server 0.4.0a2 installation, matching CI. - Verify the documented local agent-loop example with public Python runtime 0.4.0a1 and refresh its installation pin. diff --git a/examples/README.md b/examples/README.md index 3aab0c6..2d94f66 100644 --- a/examples/README.md +++ b/examples/README.md @@ -40,7 +40,7 @@ The current example uses an installed Python runtime and preserves caller `PYTHONPATH`; it adds no fixed repository paths. Install the server before running: ```bash -python3 -m pip install --index-url https://pypi.org/simple 'agent-sandbox-server==0.4.0a2' +python3 -m pip install --index-url https://pypi.org/simple 'agent-sandbox-server==0.4.0a3' npm ci npm test node examples/agent-loop.mjs @@ -53,6 +53,6 @@ node examples/agent-loop.mjs ## Fresh published-runtime verification — 2026-10-25 -A fresh Python 3.13 environment (no repository source injection) with public `agent-sandbox-server==0.4.0a2`, followed by the documented `npm ci`, `npm run build` and `node examples/agent-loop.mjs`, passed. The shell returned `4\n`, the downloaded file matched `answer=4\n`, and the owned server process exited after SIGTERM. `npm run typecheck` and all 24 Node tests passed. No cloud resource or model API was used. +A fresh Python 3.13 environment (no repository source injection) with public `agent-sandbox-server==0.4.0a3`, followed by the documented `npm ci`, `npm run build` and `node examples/agent-loop.mjs`, passed. The shell returned `4\n`, the downloaded file matched `answer=4\n`, and the owned server process exited after SIGTERM. `npm run typecheck` and all 24 Node tests passed. No cloud resource or model API was used. -2026-10-25 已从全新环境安装公开 Python 服务端 0.4.0a2,再按上述命令构建和运行示例。命令输出、文件内容和服务进程清理均通过;类型检查及 24 个测试通过。本次是实际本地 HTTP 运行,不代表云端或模型调用测试。 +2026-10-25 已从全新环境安装公开 Python 服务端 0.4.0a3,再按上述命令构建和运行示例。命令输出、文件内容和服务进程清理均通过;类型检查及 24 个测试通过。本次是实际本地 HTTP 运行,不代表云端或模型调用测试。 From 497290ed2c1ae77f41924f4a0c762104c9d36cec Mon Sep 17 00:00:00 2001 From: AnyEnv Sandbox Date: Sun, 25 Oct 2026 16:37:08 +0000 Subject: [PATCH 2/2] docs: record public server a3 CI verification --- .../2026-10-25-current-public-server-a3-ci.json | 17 +++++++++++++++++ .../2026-10-25-current-public-server-a3.md | 9 ++++++--- 2 files changed, 23 insertions(+), 3 deletions(-) create mode 100644 .agents/evidence/verify/2026-10-25-current-public-server-a3-ci.json diff --git a/.agents/evidence/verify/2026-10-25-current-public-server-a3-ci.json b/.agents/evidence/verify/2026-10-25-current-public-server-a3-ci.json new file mode 100644 index 0000000..0da37ed --- /dev/null +++ b/.agents/evidence/verify/2026-10-25-current-public-server-a3-ci.json @@ -0,0 +1,17 @@ +{ + "source_head": "d539578b6ee7d205c353a742a6fb52d56e676a4c", + "checks": [ + { + "name": "test (22)", + "status": "completed", + "conclusion": "success", + "html_url": "https://github.com/Alibaba-Agent-Sandbox/nodejs-sdk/actions/runs/40211103485/job/121222310098" + }, + { + "name": "test (20)", + "status": "completed", + "conclusion": "success", + "html_url": "https://github.com/Alibaba-Agent-Sandbox/nodejs-sdk/actions/runs/40211103485/job/121222309855" + } + ] +} diff --git a/.agents/evidence/verify/2026-10-25-current-public-server-a3.md b/.agents/evidence/verify/2026-10-25-current-public-server-a3.md index 7229e30..ba5f3c7 100644 --- a/.agents/evidence/verify/2026-10-25-current-public-server-a3.md +++ b/.agents/evidence/verify/2026-10-25-current-public-server-a3.md @@ -1,7 +1,7 @@ # Public server a3 Node guidance verification Date: 2026-10-25 -Result: PASS (local verification; remote delivery gate pending) +Result: PASS (local verification and source CI; merge pending) Base: main 63d7cd8ece221b9f968eef51eeb932ea334c90d3. Changes only current example, CI source/runtime version, changelog and records. Node 22.22.2, npm 12.0.2; @@ -17,5 +17,8 @@ no-cache installation. No PYTHONPATH source injection. accurate. This is not publication of a Node package. - Scoped record-link existence and `git diff --check`: PASS. -No cloud resource was created. Exact latest-head Node 20/22 CI, independent review -and actual merge remain delivery checks; the earlier a2 receipts are unchanged. +No cloud resource was created. Exact source head +`d539578b6ee7d205c353a742a6fb52d56e676a4c` completed both Node 20/22 checks +SUCCESS; [CI receipt](2026-10-25-current-public-server-a3-ci.json) preserves their +identities and links. This record-only follow-up requires its own head CI and +independent review before merge. Earlier a2 receipts are unchanged.