Skip to content

chore(langsmith): drop the langsmith-clio image - #910

Merged
Bagatur (baskaryan) merged 8 commits into
v16-stablefrom
chore/drop-clio-image
Aug 4, 2026
Merged

Bagatur (baskaryan) merged 8 commits into
v16-stablefrom
chore/drop-clio-image

Conversation

@baskaryan

Copy link
Copy Markdown
Contributor

Stacked on #909 — retarget to v16-stable once that merges.

Insights and Engine run on the combined langsmith-insights-engine image, so langsmith-clio is no longer a supported value for images.engineInsightsAgentImage. v16 is still on rc, so nothing has shipped with clio under the new key name.

The guard

Moves out of the engine.enabled block so it applies to every install, and now matches on the tag as well as the repository. That second arm is load-bearing: push_helm_chart.sh rewrites marketplace values so every image shares one ECR repo and the image name moves into the tag (repository: <registry>/<ns>/langsmith, tag: langsmith-insights-engine-<version>). A repository-only check would reject every marketplace install. The tag arm is anchored to the langsmith-insights-engine- prefix rather than a loose contains so it can't be used to point the repository somewhere arbitrary.

Installs upgrading from v15 that pinned the old images.insightsAgentImage key are unaffected — the existing rename guard catches them first with its own message.

Marketplace scripts (pre-existing bug)

#900 added the combined image to mirror_langsmith_images.sh only. Both marketplace scripts still carried clio and had no entry for langsmith-insights-engine, so on the marketplace path:

  • push_helm_chart.sh left engineInsightsAgentImage pointing at docker.io/langchain/langsmith-insights-engine, un-rewritten — a marketplace install would pull the co-host image from Docker Hub instead of the marketplace ECR.
  • create_marketplace_version.sh never listed the image in CONTAINER_IMAGES, so it wasn't part of the marketplace version at all.

Both now reference the combined image.

Verification

  • 294 chart tests pass across 22 suites (291 + 3 new); helm lint clean.
  • helm template end to end: default renders; clio pinned fails with the new message with Engine disabled; marketplace layout (name in tag) renders.
  • Ran push_helm_chart.sh's actual rewrite against the real values.yaml and confirmed the output renders against the new guard — and that the pre-change map left the image on docker.io.

No values.yaml change, so the generated README is unaffected.

Follow-ups

  • Forward-port the Engine chart work to main — it has none of it (still insightsAgentImage: langsmith-clio, no engine: block, zero engine.enabled guards). 32 chart commits on v16-stable are absent from main, ~20 of them real fixes. As it stands v17 ships without Engine.
  • Once main no longer references clio, drop it from the promotion matrix in langchainplus so it stops being built and published.

🤖 Generated with Claude Code

Bagatur (baskaryan) and others added 2 commits August 4, 2026 15:58
Enabling Engine took two settings that had to agree: engine.enabled, and
an images.engineInsightsAgentImage.repository pointing at the combined
image, since the default served only the insights graph. Them disagreeing
is what surfaced as a chart that demanded an image customers had no way to
pull.

The combined image serves both graphs and is no larger — 392 MB against
clio's 397 MB compressed on amd64, same architectures — so nothing is paid
for defaulting to it. engine.enabled is now sufficient on its own.

The validate.yaml guard stays: an install that pinned langsmith-clio in its
own values keeps that pin across the upgrade, and the guard is what tells
it why Engine will not start.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Insights and Engine run on the combined langsmith-insights-engine image,
so clio is no longer a supported value for
images.engineInsightsAgentImage.

The image guard moves out of the engine.enabled block and applies to
every install. It now also matches on the tag, because the marketplace
packaging rewrites every image to one shared repo and moves the name
into the tag -- a repository-only check would reject those installs.

Also fixes the marketplace scripts, which still carried clio and had no
entry for the combined image: push_helm_chart.sh left
engineInsightsAgentImage pointing at docker.io instead of the
marketplace ECR, and create_marketplace_version.sh never listed it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@baskaryan
Bagatur (baskaryan) requested a review from a team as a code owner August 4, 2026 20:45
Bagatur (baskaryan) and others added 4 commits August 4, 2026 17:14
The combined image exposes `insights` and `engine`; only the retired clio
image had the `agent` graph that lc_config still defaults to. Defaulting
every install to the combined image therefore left installs with
engine.enabled=false pointing smith-backend at a graph that does not
exist, breaking Insights wherever Engine is not turned on.

CLIO_ASSISTANT_ID follows the image, so it moves out of the
engine.enabled block.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Base automatically changed from chore/default-insights-engine-image to v16-stable August 4, 2026 22:05
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@baskaryan
Bagatur (baskaryan) enabled auto-merge (squash) August 4, 2026 22:38
@baskaryan
Bagatur (baskaryan) merged commit 8394c0d into v16-stable Aug 4, 2026
6 checks passed
@baskaryan
Bagatur (baskaryan) deleted the chore/drop-clio-image branch August 4, 2026 22:48
Bagatur (baskaryan) added a commit that referenced this pull request Aug 19, 2026
* feat(engine): bring Engine/Insights chart support to main

The Engine work landed on v16-stable and was never forward-ported, so
main has no Engine support at all and still ships langsmith-clio as the
insights image. v17 would ship without Engine.

Ports the Insights/Engine parts of #889, #893, #896, #897, #898, #900,
#901, #909, #910 and #914: the co-hosted deployment on the combined
image, the engine values block and its validate guards, Engine env for
the co-host and for smith-go, the kill-switch when Engine is off, and
the image rename across the insights templates and packaging scripts.

Reconstructed against main rather than cherry-picked. The branches have
diverged in both directions, so replaying commits would have dragged
v16's older image tags and superseded comments back over main.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* chore(engine): trim the engine values comments

The README's Engine section carries the requirements and the workspace
guidance, so the value comments only need a line each.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants