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
6 changes: 4 additions & 2 deletions .agents/README.md
Original file line number Diff line number Diff line change
@@ -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).

Expand Down Expand Up @@ -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).
Original file line number Diff line number Diff line change
@@ -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"
}
]
}
24 changes: 24 additions & 0 deletions .agents/evidence/verify/2026-10-25-current-public-server-a3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Public server a3 Node guidance verification

Date: 2026-10-25
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;
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 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.
Original file line number Diff line number Diff line change
@@ -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).
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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: |
Expand Down
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
6 changes: 3 additions & 3 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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 运行,不代表云端或模型调用测试。
Loading