Skip to content

Pin retriever installation to available SDK packages - #1061

Merged
zlareb1 merged 2 commits into
mainfrom
docs/langchain-install-artifacts
Nov 20, 2026
Merged

zlareb1 merged 2 commits into
mainfrom
docs/langchain-install-artifacts

Conversation

@zlareb1

@zlareb1 zlareb1 commented Nov 20, 2026 •

Copy link
Copy Markdown
Member

Changelog category (leave one):

  • Documentation

Changelog entry

LangChain examples install the published SDKs and their supported framework peer.

Why

The LangChain examples select the published Python and TypeScript SDK artifacts that contain their retriever modules. The TypeScript command also installs LangChain core 1.x explicitly.

Scope and risk

The guide selects clickhouse-loom[langchain]==1.3.0 and @clickhouse/loom@1.3.0. The actual artifacts contain the example adapters and Python session-protection helper. No adapter or dependency declaration changes.

Two test-fixture corrections resolve the primary failures observed while validating this guide. The complete published repair from #1046 starts the single-thread zombie witness through an isolated interpreter and waits for its ready byte before capturing identity. Existing live-process, namespace, birth, zombie and post-reap assertions remain.

The stale-finalizer fixture asserts completion of its owned backend termination before acquiring the successor lock. PostgreSQL's default termination call confirms signal delivery; the positive timeout waits for termination. The fixture uses the existing five-second termination bound and retains every generation, stale-finalizer, ABA and cleanup assertion. Production locking and operation deadlines are unchanged.

Compatibility, rollout and rollback

No wire, schema or operator changes. Reverting restores the prior guide and fixtures. No production process or database behavior changes.

Tests

  • Actual anonymous registry metadata, wheel source and npm integration sourcemaps confirm artifact availability and matching selected adapter source. Digest comparisons pass. This does not qualify the complete current SDK/server tree or application execution.
  • Scoped checks pass: Ruff format and lint for both changed Python fixtures; Markdown formatting and prose for the guide; Python AST parsing; staged and unstaged whitespace checks.
  • Behavioral and database checks were not run locally. The prior unit-5 and PostgreSQL-18 failures remain failed evidence; static checks do not prove their repairs.
  • All applicable hosted checks pass on the final head. One language-extraction CPU-cost check failed on the first attempt and passed on the single diagnostic rerun. Its cause remains unknown; the test, workload and budget are unchanged. The original failure remains recorded.

AI assistance in the code

  • AI-generated: Codex checked artifact/source bindings, reused the published witness repair and wrote the termination barrier and documentation changes.

  • I can explain every line of this diff and how it interacts with the rest of Loom.

Checklist

  • Required hosted checks pass.
  • Fresh independent review covers the final pushed source and body.
  • Generated files, migrations, plugin manifests and frontend code are unaffected.
  • Validation claims distinguish artifact inspection, static checks and behavior.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
@vercel

vercel Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
loom-docs Ready Ready Preview Nov 20, 2026 5:24pm UTC

Request Review

Install the matching stable SDKs and the declared native peer. Validation fixtures establish a post-exec witness and completed backend termination before checking successor ownership.

Reuses the complete published witness repair from 9ffae96 (#1046).

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
@zlareb1
zlareb1 merged commit 3f28ce2 into main Nov 20, 2026
91 of 92 checks passed
zlareb1 added a commit that referenced this pull request Nov 20, 2026
* Close preparation spends the shared session-end deadline

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Drive placement deadline tests with a private clock

Use one idle-driven clock for the mock exchange timers and owned close. Keep the six cases and their bounds, with a private-loop task census at teardown.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
(cherry picked from commit e1f47e6)

* Drive directory cleanup checks with one private clock

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Docs: serve documentation from the docs subpath (#1042)

* Serve documentation from the docs subpath

The documentation build keeps its links, assets, and discovery files below the configured path.

Signed-off-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>

* Trigger documentation preview

Signed-off-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>

* Redirect documentation preview root

Preview deployments open the documentation path when their root URL is requested.

Signed-off-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>

* Placement deadline tests use one simulated clock

Work deadlines, cleanup, and the elapsed-time assertion use one private clock.
The selector advances it when the loop waits, so scheduler pauses cannot expire
a simulated reply or consume its cleanup allowance. Keep all six cases and
their duration bounds, and fail teardown if the private loop retains a task.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

---------

Signed-off-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>
Co-authored-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* DSPy retrievers over Loom knowledge and memory search (#1049)

* memory.ask matches bridge slugs literally (#1037)

* memory.ask matches bridge slugs literally

Escape LIKE metacharacters so slug underscores cannot select another subject.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Expect literal bridge slugs in the governed-conflict test

The namespace regression must assert the escaped pattern used by the subject filter.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

---------

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Record worker context after linear-cost assertions fail (#1058)

Selected durations alone omit worker allocation and collection state. Attach numeric context after the original assertion fails so the cost calls and decision remain unchanged.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Document memory selection for coding agents and software factories (#1021)

* Document memory selection for coding agents and software factories

Give the existing use-case pages distinct search titles and concrete recall, isolation and evidence-handoff checks without claiming comparative results.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Format coding-agent and factory memory selection tables

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

---------

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Document memory write and worker progress regression tests (#1043)

* Document memory write and worker progress regression tests

Exercise derived effects, stored cursors and complete SQL rows so regression checks observe the boundaries they claim to protect.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Test warm worker passes beside cursor restarts

A restart can recover a missed boundary event through cold reconciliation, so the guide must retain warm continuation regressions.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Concurrency tests cover changed content at an equal version

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Document committed-write cleanup and private cache regression tests

Cancellation during fence release must not skip effects owed by an acknowledged
write. Caches of private strings need retention and erasure coverage as well as
result checks.

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

---------

Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>

* Framework examples select matching SDK artifacts (#1064)

* Framework examples select matching SDK artifacts

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Framework examples install matching published SDKs

Select available stable artifacts and their native peers, keeping DSPy on its matching checkout. Give the invalid-identity fixture its own product clock so semantic closure assertions do not spend real phase time. Preserve all real deadline and cancellation cases.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

---------

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Pin retriever installation to available SDK packages (#1061)

* Pin retriever installation to available SDK packages

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* LangChain examples select published SDK artifacts

Install the matching stable SDKs and the declared native peer. Validation fixtures establish a post-exec witness and completed backend termination before checking successor ownership.

Reuses the complete published witness repair from 9ffae96 (#1046).

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

---------

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Cell checks share topology and catalog helpers (#906)

Related: #776

### Changelog category

- Improvement

### Changelog entry

Cell checks share topology, catalog and synchronization helpers across command and server code.

### Why

Complete cell reads depend on topology validation, the caller's effective privileges, replica identity and synchronization. These implementations live in CLI modules, which server code cannot import. Shared owners let both layers use the same checks without copying them.

### Scope and risk

The complete topology module moves to `server/core/cell_ch.py`. Catalog, grant, default-role, row-policy and replica checks move to `server/insights/store/cell_catalog.py`; synchronization and budget helpers move to `server/core/cell_sync.py`. Callers and test patch points use those owners, and the old topology module is deleted.

SQL, query settings and tags, defaults, refusal conditions, exception identity, row interpretation and ordinary update behavior remain unchanged. A missed caller import or patch point is the main risk. Bounded participant and observation joins remain unimplemented; this extraction adds no later-cell activation or readiness result.

The configuration and placement foundation is merged. Its raw connection ownership, retirement admission, typed configuration refusal, deadlines and cleanup remain intact when the shared imports compose with it.

### Compatibility, rollout and rollback

- Wire and defaults: unchanged; no operations, arguments, settings, tables or stored encodings are added.
- Operator steps: none.
- Rollback: reverting restores the former internal owners and callers; there is no stored data transition.
- The English architecture page names the shared topology owner. Existing translated code references await the normal translation workflow; translated files are unchanged.

### Tests

- Static bindings retain all 37 moved definitions, all 574 audited test assertions and the single unique moved topology assertion. The merged foundation's 577 assertions in the audited test modules remain in source order, with only the sixteen existing shared-owner reference substitutions. Production assertion relocations retain their conditions and multiplicity. The older reported total counted the moved topology assertion in both source images; no assertion was removed.
- The local attempt to run sixteen directly related pure selectors is refused before a test child starts because admission detects an unknown test process. No current test pass is claimed. Source and Git state match before and after the refusal. The same selectors historically pass as 34 parameterized cases on the earlier source, covering complete replica union, topology and synchronization refusal, privileges, caller identity, row policies, extra replicas, streaming failures and budget behavior. Those passes retain their original source attribution.
- Current scoped Ruff checks and formatting checks pass for all 25 changed Python files, and the concern diff passes whitespace checks. The earlier focused attempt lacking its complete source snapshot remains invalid; its passing output is not used as evidence. Historical focused passes retain their original source attribution.
- The actual merged-parent adoption resolves one import conflict while retaining both shared refusal owners and the existing retirement implementation. Static comparison with the later target finds no concern-path overlap or new production coupling; unrelated target advancement alone does not require a source refresh.
- Final-head hosted CI reports 54 successful checks and two expected documentation publication skips. Both Postgres versions complete the native, standby, authenticated-isolation and ordered-reconciliation phases. Mixed-version checks pass. Cell acceptance passes the unchanged latency and throughput requirements, with provenance and cleanup receipts. Fresh independent entire pushed-source review reports no findings or nits. These results apply to this extraction; bounded census joins remain separate work.

### AI assistance in the code

- AI-generated: Codex wrote this change. Independent final-source review and required hosted gates remain mandatory.

- [x] I can explain every line of this diff and how it interacts with the rest of Loom.

### Checklist

- [x] Scoped static checks pass; the refused local test attempt is recorded as unrun.
- [x] Required final-head GitHub CI and fresh whole-source review pass.
- [x] Documentation names the shared owner; generated translations are unchanged.
- [x] No migration or stored data change is introduced.
- [x] Commits are signed off.

* Live MCP results protect the SDK before automatic capture (#1067)

Compose rendering and transport observation so the privacy marker reaches protection before the next automatic write.

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

* Drive directory cleanup checks with one private clock (#1054)

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>

---------

Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
Signed-off-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Signed-off-by: Lareb Zafar <lareb.zafar@clickhouse.com>
Co-authored-by: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Co-authored-by: Rahul <132360698+rahulsjha@users.noreply.github.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.

1 participant