…ilters

- Relax `createSandbox(snapshotId, options?)` so `snapshotId` is optional and
  add a new `snapshotName` field on `CreateSandboxOptions`. Exactly one of
  the two must be set (validated via `LangSmithValidationError`). The SDK
  forwards the identifier verbatim on the wire as `snapshot_id` /
  `snapshot_name`. `snapshotId` stays positional — it is intentionally not
  duplicated on the options object.
- Add a new `ListSnapshotsOptions` type (nameContains / limit / offset /
  signal) and extend `listSnapshots` to build a URLSearchParams query string
  only when at least one option is set, preserving the zero-arg URL.
- Re-export `ListSnapshotsOptions` from the sandbox public index.
- Tests: cover the snapshotName create path, the zero-identifier and
  both-identifier rejection cases, the listSnapshots zero-arg URL shape, and
  the filtered URL shape.
- README: add snapshotName and listSnapshots examples in the Snapshots
  section, update the API Reference rows for `createSandbox` and
  `listSnapshots`, add a `snapshotName` row to the `CreateSandboxOptions`
  table, and add a new `ListSnapshotsOptions` table.

Stacked on top of #2758. Sibling to #2769 (Python).

Made-with: Cursor

## Summary

Follow-up to #2758 — extends the snapshot-only sandbox surface so
callers can boot from a snapshot **name** (not just an ID) and so
`listSnapshots` supports server-side filtering and pagination.

Sibling to the Python SDK change: #2769.

> Stacked on #2758. GitHub will auto-retarget the base to `main` once
that PR merges.

### `createSandbox` — accept `snapshotName`

`snapshotId` becomes optional (positional) and a new `snapshotName`
field is added to `CreateSandboxOptions`. Exactly one must be provided.
To avoid confusion, `snapshotId` is intentionally not duplicated on the
options object.

```ts
// By ID (unchanged):
const sandbox = await client.createSandbox(snapshot.id);

// By name — server resolves the snapshot against the caller's tenant:
const sandbox = await client.createSandbox(undefined, {
  snapshotName: "my-snap",
});
```

Validation throws a `LangSmithValidationError` if neither (or both) is
provided.

### `listSnapshots` — add `ListSnapshotsOptions`

```ts
const all = await client.listSnapshots();
const page = await client.listSnapshots({
  nameContains: "python",
  limit: 10,
  offset: 20,
});
```

All three options are optional and independent. Omitting them keeps
today's zero-arg behavior — the request URL has no query string. The new
type is re-exported from the sandbox public index.

### Tests (`src/tests/sandbox.test.ts`)

- createSandbox: new \`snapshot_name\` payload test + zero-identifier
and both-identifier rejection tests.
- listSnapshots: existing zero-arg test extended to assert an empty
query string; new test asserts \`name_contains\`, \`limit\`, \`offset\`
appear on the request URL.

All 80 sandbox tests pass locally.

### README

- Added a \`snapshotName\` example in the Snapshots section alongside
the existing \`snapshotId\` example.
- Added a \`listSnapshots({ nameContains, limit, offset })\` example.
- Updated the API Reference rows for \`createSandbox\` and
\`listSnapshots\`.
- Added a \`snapshotName\` row to the \`CreateSandboxOptions\` table.
- Added a new \`ListSnapshotsOptions\` table.

### Breaking changes

None. \`createSandbox(snapshotId)\` calls keep working unchanged; the
positional arg is now optional, but the payload behavior is identical
when it is provided.

Made with [Cursor](https://cursor.com)

## Overview

Mirrors the SDK-side deprecation of sandbox templates, warm pools, and
volumes for the public docs. Sandboxes now boot directly from snapshots;
there are no templates or pools left in the public API surface.

- Deletes `langsmith/sandbox-templates` and
`langsmith/sandbox-warm-pools` plus their screenshots.
- Adds `langsmith/sandbox-snapshots` covering build-from-Docker,
capture-from-sandbox, CRUD, and stop/start flows with Python +
TypeScript `<CodeGroup>` examples.
- Rewrites `sandboxes.mdx`, `sandbox-sdk.mdx`,
`sandbox-service-urls.mdx`, and `sandbox-auth-proxy.mdx` so every
example uses `snapshot_id` (Python) / positional `snapshotId`
(TypeScript). Removes every `create_template` / `createTemplate` call.
- Updates the Sandboxes nav group in `docs.json`: Overview → Snapshots →
Service URLs → Auth proxy → SDK usage.

## Type of change

**Type:** Remove outdated content

## Related issues/PRs

- Python SDK: langchain-ai/langsmith-sdk#2757
- JS SDK: langchain-ai/langsmith-sdk#2758

## Checklist

- [x] I have read the [contributing guidelines](README.md), including
the [language
policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy)
- [x] I have tested my changes locally using `docs dev`
- [x] All code examples have been tested and work correctly
- [x] I have used **root relative** paths for internal links
- [x] I have updated navigation in `src/docs.json` if needed

## Additional notes

`oss/deepagents/*` docs still reference `template_name` because the
deepagents CLI/package still uses templates. Deepagents owns its own
migration; one dangling link to `/langsmith/sandbox-templates` remains
in `oss/deepagents/frontend/sandbox.mdx` until they update.