[PR #3887] [MERGED] docs(langsmith/sandbox-sdk): document idle and delete-after-stop retention #3900

Closed
opened 2026-06-05 18:53:31 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3887
Author: @DanielKneipp
Created: 5/6/2026
Status: Merged
Merged: 5/7/2026
Merged by: @langchain-infra

Base: mainHead: daniel/sandbox-delete-after-stop-docs


📝 Commits (1)

  • 61eb675 docs(langsmith/sandbox-sdk): document idle and delete-after-stop retention

📊 Changes

1 file changed (+73 additions, -0 deletions)

View changed files

📝 src/langsmith/sandbox-sdk.mdx (+73 -0)

📄 Description

Overview

Adds a "Sandbox lifetime and retention" section to the LangSmith sandbox
SDK guide that describes the two-stage retention model:

  • idle_ttl_seconds / idleTtlSeconds — inactivity timer that stops
    the sandbox.
  • delete_after_stop_seconds / deleteAfterStopSeconds — timer that
    starts when the sandbox enters the stopped state and triggers
    deletion (sandbox row + filesystem clone).

The section includes a lifecycle diagram, a field reference table, and
Python + TypeScript examples for default, aggressive, and long-running
retention configurations, plus an update-in-place example.

Type of change

Type: Update existing documentation

Related issues/PRs

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Additional notes

The unchecked checklist items are left for the reviewer / a follow-up:

  • docs dev rendering wasn't run locally before opening this PR.
  • The Python / TypeScript code samples mirror exactly the public APIs
    added in the linked sibling SDK PRs (which have passing unit tests),
    but they haven't been executed end-to-end against a live sandbox from
    this PR.

No navigation changes — this is an addition to an existing page
(src/langsmith/sandbox-sdk.mdx).

Made with Cursor


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/3887 **Author:** [@DanielKneipp](https://github.com/DanielKneipp) **Created:** 5/6/2026 **Status:** ✅ Merged **Merged:** 5/7/2026 **Merged by:** [@langchain-infra](https://github.com/langchain-infra) **Base:** `main` ← **Head:** `daniel/sandbox-delete-after-stop-docs` --- ### 📝 Commits (1) - [`61eb675`](https://github.com/langchain-ai/docs/commit/61eb675f09f3a4a66f6dc55d29fdc07d32b4aad5) docs(langsmith/sandbox-sdk): document idle and delete-after-stop retention ### 📊 Changes **1 file changed** (+73 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `src/langsmith/sandbox-sdk.mdx` (+73 -0) </details> ### 📄 Description ## Overview Adds a "Sandbox lifetime and retention" section to the LangSmith sandbox SDK guide that describes the two-stage retention model: - `idle_ttl_seconds` / `idleTtlSeconds` — inactivity timer that stops the sandbox. - `delete_after_stop_seconds` / `deleteAfterStopSeconds` — timer that starts when the sandbox enters the `stopped` state and triggers deletion (sandbox row + filesystem clone). The section includes a lifecycle diagram, a field reference table, and Python + TypeScript examples for default, aggressive, and long-running retention configurations, plus an update-in-place example. ## Type of change **Type:** Update existing documentation ## Related issues/PRs - Feature PR (Python SDK): langchain-ai/langsmith-sdk#2853 - Feature PR (TypeScript SDK): langchain-ai/langsmith-sdk#2854 ## 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 The unchecked checklist items are left for the reviewer / a follow-up: - `docs dev` rendering wasn't run locally before opening this PR. - The Python / TypeScript code samples mirror exactly the public APIs added in the linked sibling SDK PRs (which have passing unit tests), but they haven't been executed end-to-end against a live sandbox from this PR. No navigation changes — this is an addition to an existing page (`src/langsmith/sandbox-sdk.mdx`). Made with [Cursor](https://cursor.com) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 18:53:31 -04:00
yindo closed this issue 2026-06-05 18:53:31 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#3900