v0.9.0

Sandbox tools for building your own agent, a code interpreter, agent snapshots and forks, and paused sandboxes that wake on use. Install with npm install @neevcloud/sdk@latest.

Breaking

• The audit trail returns OCSF events. AuditTrail.records is now data: AuditEvent[], and AuditRecord and AuditTrail.sandbox_id are removed. Program and connection events have no api, so read e.api?.operation.
• sandbox.replicas is removed; read sandbox.phase instead.

Also in this release: @neevcloud/sdk/agent-tools (SandboxTools, specs(), FatalGuard) with adapters for the Claude Agent SDK, OpenAI Agents and the AI SDK; the code interpreter (sandbox.code.run and contexts); agent createSnapshot, listSnapshots and fork; runtime calls on a paused sandbox are sent and wake it instead of failing with "call resume() first"; program and connection events in the audit trail, with execution_trace to turn them off; sandbox labels; byte-range file reads; TooEarlyError for HTTP 425. An AbortSignal now also cancels a response body that is still streaming, long exec calls no longer fail at the client timeout, and getUrl no longer waits out its timeout when the app itself answers 403 or 404. See the changelog.

What's Changed

• feat(sandboxes): labels on create, list filter by label, and sandbox.labels by @mayur-tolexo in #59
• feat(agent-tools): ship the sandbox tool contract as @neevcloud/sdk/agent-tools by @mayur-tolexo in #60
• fix(agent-tools): same error text as the Python SDK by @mayur-tolexo in #61
• Remove sandbox.replicas; accept filesystem snapshots by @mayur-tolexo in #63
• Audit trail as OCSF events, with filters by @mayur-tolexo in #66
• Code interpreter: run Python with state kept between runs by @mayur-tolexo in #55
• feat(agent-tools): path tools, paged reads, tool specs and framework adapters by @mayur-tolexo in #64
• Move examples off retired templates; add a Docker example by @mayur-tolexo in #68
• Rewrite the README and docs by product by @mayur-tolexo in #69
• Say Docker starts at boot on the Docker template by @mayur-tolexo in #70
• fix(preview): count the app's own 403/404 as routed by @mayur-tolexo in #71
• Program and connection events in the audit trail by @mayur-tolexo in #72
• Programs and connections in the audit trail, and an execution trace setting by @mayur-tolexo in #73
• feat(sandboxes): let a paused sandbox wake on use; add auto-resume example by @rmanjunath18 in #74
• feat(agents): snapshot, list snapshots and fork an agent by @rmanjunath18 in #75
• release: @neevcloud/sdk v0.9.0 by @mayur-tolexo in #62

Full Changelog: v0.8.2...v0.9.0

v0.8.0

First release without a prerelease suffix. Published to the latest dist-tag; the beta tag stays at 0.7.0-beta, so @neevcloud/sdk@beta no longer tracks the newest build.

Breaking

• restore() for the in-place snapshot revert is now rollback(). Creating a new sandbox from a snapshot stays create({ restore }).

Also in this release: in-place update for a running sandbox (resize cpu/memory and/or replace egress in one PATCH), lifecycle windows (keepalive, updateTimeout, create-time lifecycle, BYOI image/command), sandbox.lastCrash / agent.lastCrash, and name / status / sandboxId filters on sandboxes.list().

What's Changed

• docs: document platform default sandbox/agent resources (AIPLATFORM-1762) by @rmanjunath18 in #35
• docs: move resources defaults pointer to the write path (AIPLATFORM-1762) by @rmanjunath18 in #36
• Cross-link the DeepSeek Harness plugin (@neevcloud/dsh-sandbox) by @mayur-tolexo in #37
• feat(sandboxes): filter list() by name, status, and sandboxId by @mayur-tolexo in #38
• chore: refresh aiagent generated bundle from current spec by @rmanjunath18 in #41
• refactor!: rename snapshot restore → rollback (in-place revert) by @rmanjunath18 in #42
• feat(sandboxes): lifecycle windows, keepalive, and create-time options by @rmanjunath18 in #47
• feat(sandboxes,agents): in-place resize + live egress update by @rmanjunath18 in #48
• feat(sandboxes,agents): expose the last crash on the handles by @rmanjunath18 in #49
• docs: show the in-place resize on the sandbox handle by @mayur-tolexo in #50
• release: @neevcloud/sdk v0.8.0 by @mayur-tolexo in #51

Full Changelog: v0.7.0-beta...v0.8.0

v0.7.0-beta

What's Changed

• chore: harden public SDK config and align CI with backend by @mayur-tolexo in #1
• feat: hybrid autogen client (openapi-fetch + raw escape hatch) by @mayur-tolexo in #2
• feat: sandbox files.write (+ sandbox daemon connection foundation) by @mayur-tolexo in #3
• feat: sandbox files.read / readText by @mayur-tolexo in #4
• feat: sandbox files.list by @mayur-tolexo in #5
• feat: buffered sandbox.exec over /v1/exec by @mayur-tolexo in #6
• chore: rename @neevai/sdk to @neev/sdk (NeevAI → Neev) by @mayur-tolexo in #7
• chore: rename NEEVCLOUD_* env vars to NEEV_* by @mayur-tolexo in #8
• feat: sync sandbox lifecycle to current aiagent API + add templates by @mayur-tolexo in #9
• chore: rename npm scope to @neevcloud/sdk by @mayur-tolexo in #10
• feat: sandbox lifecycle + templates, streaming exec, and agent-framework examples by @mayur-tolexo in #11
• feat(sandbox): snapshots, fork, restore + unified exec by @mayur-tolexo in #12
• release: @neevcloud/sdk v0.5.0-beta by @mayur-tolexo in #13
• ci: run all workflows on GitHub-hosted ubuntu-latest by @mayur-tolexo in #16
• docs: add SDK documentation — getting started, API reference & inventory by @mayur-tolexo in #14
• feat(processes): sandbox process supervisor (sandbox.processes) by @mayur-tolexo in #17
• docs: remove dev-environment and NEEV_BASE_URL references by @mayur-tolexo in #21
• docs: drop region plumbing and leftover baseURL snippet from examples by @mayur-tolexo in #22
• fix(release): publish prereleases under the beta dist-tag by @mayur-tolexo in #23
• feat(agents): agent lifecycle client and template catalogue by @mayur-tolexo in #19
• release: @neevcloud/sdk v0.6.0-beta by @mayur-tolexo in #18
• feat(pty): interactive PTY for sandboxes (sandbox.pty) by @mayur-tolexo in #20
• Wait for a snapshot to be Ready (waitForSnapshot + snapshot waitUntilReady) by @mayur-tolexo in #24
• Scrub platform-internal details from the public SDK docs and comments by @mayur-tolexo in #25
• Release v0.6.1-beta and make the newest beta the default install by @mayur-tolexo in #26
• Add stat/exists/mkdir/move/remove and streaming watch to sandbox.files by @mayur-tolexo in #27
• Add preview URLs for sandbox ports (getUrl) by @mayur-tolexo in #28
• Add PTY reattach (handle.id + create({ id })) by @mayur-tolexo in #29
• Stop documenting the region param; rename the runtime module by @mayur-tolexo in #30
• feat: add SSH tunnelling for sandboxes (sandbox.ssh()) by @mayur-tolexo in #31
• Make sandbox name optional on create by @mayur-tolexo in #32
• Add allow-internet / allow-egress egress convenience to sandbox and agent create by @mayur-tolexo in #33
• release: @neevcloud/sdk v0.7.0-beta by @mayur-tolexo in #34

New Contributors

• @mayur-tolexo made their first contribution in #1

Full Changelog: https://github.com/NeevCloudAI/neev-sdk-js/commits/v0.7.0-beta