Skip to content

Fix JS deep agents profiles page showing Python code blocks - #4541

Merged
Mason Daugherty (mdrxy) merged 4 commits into
mainfrom
docs/fix-js-deepagents-profiles-python-code-blocks
Jun 18, 2026
Merged

Fix JS deep agents profiles page showing Python code blocks#4541
Mason Daugherty (mdrxy) merged 4 commits into
mainfrom
docs/fix-js-deepagents-profiles-python-code-blocks

Conversation

@langsmith-fleet

Copy link
Copy Markdown
Contributor

Fixes DOC-1282

Summary

  • Wraps all Python-specific content on the Deep Agents profiles page (src/oss/deepagents/profiles.mdx) in a :::python conditional block, so it only renders in the Python docs
  • Adds a :::js block at the top with a <Note> explaining that harness profiles are a Python-only feature, and directing JS users to use systemPrompt or middleware in createDeepAgent instead

Root cause: The profiles.mdx page had no :::python / :::js conditional guards. The build pipeline generates both oss/python/deepagents/profiles and oss/javascript/deepagents/profiles from the same source file, so all Python code blocks were being rendered verbatim on the JS page.

Links

Verification

Docs-only conditional guard change — no scripts to run. Confirmed :::js / :::python pattern matches existing usage in customization.mdx (which already correctly hides the profiles section in its JS build).

Reviewers

Requested review from: Mason Daugherty (@mdrxy), Naomi Pentrel (@npentrel)

Wrap all Python-specific content in :::python conditional blocks
and add a :::js note explaining harness profiles are a Python-only
feature of Deep Agents.
@github-actions github-actions Bot added deepagents For docs changes to Deep Agents oss external User is not a member of langchain-ai labels Jun 18, 2026
@mdrxy
Mason Daugherty (mdrxy) marked this pull request as ready for review June 18, 2026 22:24
…ly features

Harness profiles ARE available in the TypeScript SDK via registerHarnessProfile.
Previous commit incorrectly said they were Python-only.

Changes:
- Add :::js sections with TypeScript code examples (registerHarnessProfile,
  HarnessProfileOptions, parseHarnessProfileConfig, serializeProfile)
- Add :::js ResponseField entries with camelCase TS field names
- Wrap Python-specific content (HarnessProfile class, import forms, provider
  profiles, entry-point plugin system) in :::python blocks
- Note in :::js that provider profiles and plugin registration are Python-only
- Update shared prose (Notes, merge semantics table) to reference both
  Python/TS APIs
- Split Note about system_prompt=/systemPrompt into separate :::python/:::js blocks
- Split Note about create_deep_agent/createDeepAgent into separate :::python/:::js blocks
- Split merge semantics table into separate :::python/:::js tables with language-specific field names
- Split Related customization link into separate :::python/:::js entries
@github-actions

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-docsfi-1781822407-9dbd21e

Site preview: https://langchain-5e9cc07a-preview-docsfi-1781822407-9dbd21e.mintlify.app

Important

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

@mdrxy
Mason Daugherty (mdrxy) merged commit 5609c64 into main Jun 18, 2026
21 checks passed
@mdrxy
Mason Daugherty (mdrxy) deleted the docs/fix-js-deepagents-profiles-python-code-blocks branch June 18, 2026 22:41
Sydney Runkle (sydney-runkle) added a commit that referenced this pull request Jul 24, 2026
## Overview

Adds the final `deepagents` v0.7.0 changelog entry, replacing the
pre-release `v0.7.0a6` block. The v0.7.0 release focuses on making the
harness more configurable and leaner by default. Content is sourced from
the
[`0.7.0b1`](https://github.com/langchain-ai/deepagents/releases/tag/deepagents%3D%3D0.7.0b1)
and
[`0.7.0b2`](https://github.com/langchain-ai/deepagents/releases/tag/deepagents%3D%3D0.7.0b2)
release notes and grouped into Features, Optimizations, and Breaking
changes.

Note: the `SystemPromptConfig` item from the old a6 entry was dropped
because that feature was reverted
([deepagents#4969](langchain-ai/deepagents#4969))
before the GA release.

## Type of change

**Type:** Update existing documentation

## Related issues/PRs
- Feature PRs: langchain-ai/deepagents#4251, #4109, #4325, #4859, #4929,
#4541, #5009

## Checklist
- [x] I have read the contributing guidelines, including the language
policy
- [x] I have tested my changes locally (Vale: 0 errors, 0 warnings)
- [x] All code examples have been tested and work correctly
- [x] I have used **root relative** paths for internal links
- [ ] I have updated navigation in `src/docs.json` if needed (not
needed)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents external User is not a member of langchain-ai oss

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants