[PR #3748] [MERGED] docs(langsmith): document sandbox auth proxy callbacks #3772

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

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3748
Author: @langchain-infra
Created: 4/26/2026
Status: Merged
Merged: 4/27/2026
Merged by: @langchain-infra

Base: mainHead: feat/sandbox-auth-proxy-callbacks-doc


📝 Commits (2)

  • 2ade7ce docs(langsmith): document sandbox auth proxy callbacks
  • 011e078 Apply suggestions from code review

📊 Changes

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

View changed files

📝 src/langsmith/sandbox-auth-proxy.mdx (+130 -0)

📄 Description

Overview

Adds a new section to the Sandbox auth proxy doc covering callbacks — the dynamic credential lookup feature that landed in langchainplus#23296.

Static rules pull workspace secrets at sandbox creation time. Callbacks let an integrator host their own endpoint that the proxy POSTs to per-host on cache miss; the response body's headers are injected into the sandbox's outbound request. Useful for short-lived OAuth tokens, per-user-scoped credentials, or anything you don't want to bake into a static rule.

Type of change

Type: Update existing documentation

Related issues/PRs

What the new section covers

  • Configuration fields (match_hosts, url, request_headers, ttl_seconds)
  • Precedence: static rules win over callbacks; first-match-wins within each
  • Proxy → callback HTTP contract: POST {host, port} → response {headers}
  • Fail-closed semantics on non-2xx / transport / parse errors (502 to the sandbox)
  • curl + Python + TypeScript SDK examples

Checklist

  • Tested locally with docs dev (rendered Markdown only — no new components)
  • Code examples mirror the smith-go validator + smith-launcher contract
  • Internal links use root-relative paths (no internal links added in this section)
  • No src/docs.json change needed (existing page, no new route)

🤖 Generated with Claude Code


🔄 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/3748 **Author:** [@langchain-infra](https://github.com/langchain-infra) **Created:** 4/26/2026 **Status:** ✅ Merged **Merged:** 4/27/2026 **Merged by:** [@langchain-infra](https://github.com/langchain-infra) **Base:** `main` ← **Head:** `feat/sandbox-auth-proxy-callbacks-doc` --- ### 📝 Commits (2) - [`2ade7ce`](https://github.com/langchain-ai/docs/commit/2ade7ce53146527663f0ee7f557168971c956f1e) docs(langsmith): document sandbox auth proxy callbacks - [`011e078`](https://github.com/langchain-ai/docs/commit/011e078f2e8b649bd0aa037d07ff2913ad1e7ad9) Apply suggestions from code review ### 📊 Changes **1 file changed** (+130 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `src/langsmith/sandbox-auth-proxy.mdx` (+130 -0) </details> ### 📄 Description ## Overview Adds a new section to the Sandbox auth proxy doc covering callbacks — the dynamic credential lookup feature that landed in [langchainplus#23296](https://github.com/langchain-ai/langchainplus/pull/23296). Static rules pull workspace secrets at sandbox creation time. Callbacks let an integrator host their own endpoint that the proxy POSTs to per-host on cache miss; the response body's `headers` are injected into the sandbox's outbound request. Useful for short-lived OAuth tokens, per-user-scoped credentials, or anything you don't want to bake into a static rule. ## Type of change **Type:** Update existing documentation ## Related issues/PRs - Feature PR: langchain-ai/langchainplus#23296 ## What the new section covers - Configuration fields (`match_hosts`, `url`, `request_headers`, `ttl_seconds`) - Precedence: static rules win over callbacks; first-match-wins within each - Proxy → callback HTTP contract: POST `{host, port}` → response `{headers}` - Fail-closed semantics on non-2xx / transport / parse errors (502 to the sandbox) - curl + Python + TypeScript SDK examples ## Checklist - [x] Tested locally with `docs dev` (rendered Markdown only — no new components) - [x] Code examples mirror the smith-go validator + smith-launcher contract - [x] Internal links use root-relative paths (no internal links added in this section) - [x] No `src/docs.json` change needed (existing page, no new route) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <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:05 -04:00
yindo closed this issue 2026-06-05 18:53:05 -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#3772