Skip to content

Remove declarative RAG language remnants - #203

Merged
senamakel merged 1 commit into
mainfrom
remove-rag-language
Sep 23, 2026
Merged

senamakel merged 1 commit into
mainfrom
remove-rag-language

Conversation

@senamakel

@senamakel senamakel commented Sep 23, 2026 •

Copy link
Copy Markdown
Member

Summary

  • remove orphaned declarative .rag language tests, diagnostics, and documentation
  • remove stale registry and capability references to the retired language crate
  • preserve retrieval and embedding APIs

Validation

  • cargo fmt --check
  • cargo test --workspace

Summary by CodeRabbit

  • Documentation
    • Updated registry and capability documentation to reflect current component types and host configuration.
    • Removed the expressive-language reference guides and related coverage and comparison material.
  • Tests
    • Removed tests for expressive-language graph compilation and runtime behavior.

Co-authored-by: Medulla <medulla@tinyhumans.ai>
@tinysweeper

tinysweeper Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

Tiny Sweeper review

This pull request removes orphaned declarative RAG language remnants across documentation, test files, error types, and capability descriptions. However, the removal is incomplete: it deletes the `TinyAgentsError::Diagnostics` variant and `RenderedDiagnostic` struct from `tinyagents-harness` without updating the `tinyagents-language` crate, causing a build failure. It also deletes the test file `language/test.rs` while leaving the corresponding production code (`build_graph`) present and untested, and removes documentation pages without updating their parent indices, creating broken links. Several documentation references to `.rag` language features should be preserved for accuracy.

State: Changes requested
Priority: critical
Reviewed head: 312655d31196
Updated: 1790177451 (Unix time)

Review snapshot

Change surface Files Review signal Count
Production 7 Active findings 5
Tests 1 Noted findings 0
Documentation 12 Resolved findings 0
Configuration 0 Pending checks/questions 0

Completeness: Complete
Test assessment: No supported feature-to-test mapping was available; this does not mean tests are absent or passed.

What changed

Removes declarative RAG language remnants: deletes test file, error variants, expressive-language documentation pages, and updates doc references to remove `.rag` mentions.

Features

  • Removed — Test file for build_graph: Leaves `build_graph` production code untested; existing tests for blueprint lowering and validation are deleted. (crates/tinyagents-graph/src/language/test.rs)
  • Removed — TinyAgentsError::Diagnostics and RenderedDiagnostic: Breaking change: `tinyagents-language` crate depends on these types; removing them causes compilation failure. (crates/tinyagents-harness/src/error.rs, crates/tinyagents-harness/src/error.rs#pub enum TinyAgentsError {)
  • Removed — Expressive language reference documentation: Removes `reference-graph.md` and `reference-nodes.md` without updating parent index, creating broken links. (docs/modules/expressive-language/reference-graph.md, docs/modules/expressive-language/reference-nodes.md)
  • Modified — Capability bundle documentation: Removes `.rag` references from `capability/mod.rs` and `capability/types.rs` doc comments; clarifies that capability bundles are referenced from AgentDefinition and host sessions only. (crates/tinyagents-harness/src/capability/mod.rs, crates/tinyagents-harness/src/capability/types.rs)
  • Modified — Registry and component documentation: Removes `.rag` blueprint references from registry docs and lib.rs; updates component description to no longer mention `.rag` references. (crates/tinyagents-registry/src/capability/mod.rs, crates/tinyagents-registry/src/component/mod.rs, crates/tinyagents-registry/src/lib.rs)
  • Modified — Various documentation files: Removes `.rag` language mentions from runtime-comparison docs, feature-gaps, langgraph, plan, pydantic-ai, and e2e test matrix. (docs/runtime-comparison/README.md, docs/runtime-comparison/feature-gaps.md, docs/runtime-comparison/langgraph.md, docs/runtime-comparison/plan.md, docs/runtime-comparison/pydantic-ai.md, docs/feature-e2e-test-matrix.md)
  • Modified — AGENTS.md and build.log: Removes `expressive-language/` from docs directory listing; deletes a stale build.log file. (AGENTS.md, build.log)

Tests

No supported feature-to-test mapping was produced. Test execution is not inferred.

Findings

  • medium · critique · Preserve the `.rag` capability in the OpenHuman list — The preceding text lists TinyAgents/OpenHuman-owned features and currently ends with `no-progress detection, goals and task board,`; the deleted text was ``.rag` blueprints with di (docs/runtime\-comparison/feature\-gaps\.md:111)
  • medium · critique · Preserve graph and language alias compatibility — The previous wording correctly documented that alias resolution preserves old graph specifications and expressive-language files. The new wording implies aliases are only needed fo (docs/modules/registry/design\.md:186)
  • medium · critique · Do not remove unresolved language audit caveats — The diff removes the documented caveat that `build_graph` ignores most of a `.rag` blueprint and that the language crate pulls the HTTP stack, but it contains no implementation or (docs/runtime\-comparison/README\.md:85)
  • critical · description · Remove the test module declaration or restore the test file — The test file `crates/tinyagents-graph/src/language/test.rs` is deleted, but the parent module `crates/tinyagents-graph/src/language.rs` almost certainly still contains `mod test;` (\(pull request description\))
  • medium · description · Update or remove links in the expressive-language index — This file and `reference-nodes.md` are deleted, but `docs/modules/expressive-language/reference.md` (which is not modified) likely links to both as part of its reference index. The (\(pull request description\))

Before merge

  • Address Remove the test module declaration or restore the test file (\(pull request description\)).

How this fits together

flowchart LR
  n0["ModelRequestDefaults<br/>changed"]:::changed
  n1["..._from_spec_round_trips_declarative_fields"]:::impacted
  n2["Capability"]:::impacted
  n3["...lls_toolset_middleware_and_model_defaults"]:::impacted
  n1 -->|uses| n0
  n1 -->|uses| n2
  n2 -->|uses| n0
  n3 -->|uses| n0
  n3 -->|uses| n2
  classDef changed fill:#0d4429,stroke:#238636,color:#e6edf3
  classDef impacted fill:#161b22,stroke:#6e7681,color:#c9d1d9
  classDef flagged fill:#5a1e02,stroke:#d93f0b,color:#ffffff
  classDef blocking fill:#67060c,stroke:#f85149,color:#ffffff
Loading
Agent review details

critique

  • Conclusion: Success
  • Scope reviewed: all assigned evidence
  • Lane summary: Reviewed 13 files; 5 findings. _The code index is behind this pull request (indexed at `752e2645dac4`), so retrieved context may be out of date._ _3 memory call(s) failed (model: cortex: v1/answer answered 502 Bad Gateway), so this review saw part of what the engine holds._
  • Evidence: docs/runtime\-comparison/feature\-gaps\.md — Preserve the `.rag` capability in the OpenHuman list
  • Evidence: docs/modules/registry/design\.md — Preserve graph and language alias compatibility
  • Evidence: docs/runtime\-comparison/README\.md — Do not remove unresolved language audit caveats

security

  • Conclusion: Success
  • Scope reviewed: all assigned evidence
  • Lane summary: Reviewed 6 files; 0 findings. 7 files were not security-reviewed: docs/modules/registry/design.md (prose or tabular data), docs/modules/registry/implementation-status.md (prose or tabular data), docs/runtime-comparison/README.md (prose or tabular data), docs/runtime-comparison/feature-gaps.md (prose or tabular data), docs/runtime-comparison/langgraph.md (prose or tabular data), and 2 more. _The code index is behind this pull request (indexed at `752e2645dac4`), so retrieved context may be out of date._ _3 memory call(s) failed (model: cortex: v1/answer answered 502 Bad Gateway), so this review saw part of what the engine holds._

tests

  • Conclusion: Success
  • Scope reviewed: all assigned evidence
  • Lane summary: This pull request removes the `.rag` expressive language from documentation and type definitions, but leaves the `tinyagents-language` crate unchanged, so the removal of `TinyAgentsError::Diagnostics` and `RenderedDiagnostic` from `tinyagents-harness` breaks compilation of `tinyagents-language`. The PR also deletes the test file for `build_graph` while leaving the production code in place, leaving it untested. Merge is blocked until the dependent crate is either removed or updated. (1 finding discarded for not matching a changed line) _The code index is behind this pull request (indexed at `752e2645dac4`), so retrieved context may be out of date._ _3 memory call(s) failed (model: cortex: v1/answer answered 502 Bad Gateway), so this review saw part of what the engine holds._

commits

  • Conclusion: Neutral
  • Scope reviewed: all assigned evidence
  • Lane summary: Nothing sensitive found in what this pull request commits.

description

  • Conclusion: Failure
  • Scope reviewed: all assigned evidence
  • Lane summary: This pull request removes orphaned declarative RAG language tests, diagnostics, and documentation, but leaves the backing module declaration intact, causing a build failure. Additionally, it removes referenced documentation pages without updating their parent index, creating broken links. These issues must be fixed before merging. _The code index is behind this pull request (indexed at `752e2645dac4`), so retrieved context may be out of date._ _3 memory call(s) failed (model: cortex: v1/answer answered 502 Bad Gateway), so this review saw part of what the engine holds._
  • Evidence: \(pull request description\) — Remove the test module declaration or restore the test file
  • Evidence: \(pull request description\) — Update or remove links in the expressive-language index

e2e

  • Conclusion: Neutral
  • Scope reviewed: all assigned evidence
  • Lane summary: No end-to-end harness in this repository: no e2e test files and no e2e workflow.
Evidence and run details
  • Models: flash, ladder/vectors, gpt-5.6-luna, deepseek-v4-flash
  • Spend: $0.072889
  • Tokens: 437634 input · 24474 output · 10215 cached · 1074 embedding
Head State Pass summary
312655d31196 changes requested 5 active finding(s), 0 resolved finding(s) (at 1790177451)

tinysweeper 0.1.0

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-23T15:30:17.208872Z 312655d PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Sep 23, 2026

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: ce789493-d17c-4bea-913e-f74f865d4eb9

📥 Commits

Reviewing files that changed from the base of the PR and between 8219f12 and 312655d.

⛔ Files ignored due to path filters (1)
  • build.log is excluded by !**/*.log
📒 Files selected for processing (19)
  • AGENTS.md
  • crates/tinyagents-graph/src/language/test.rs
  • crates/tinyagents-harness/src/capability/mod.rs
  • crates/tinyagents-harness/src/capability/types.rs
  • crates/tinyagents-harness/src/error.rs
  • crates/tinyagents-registry/src/capability/mod.rs
  • crates/tinyagents-registry/src/component/mod.rs
  • crates/tinyagents-registry/src/lib.rs
  • docs/feature-e2e-test-matrix.md
  • docs/modules/expressive-language/reference-graph.md
  • docs/modules/expressive-language/reference-nodes.md
  • docs/modules/registry/design.md
  • docs/modules/registry/implementation-status.md
  • docs/runtime-comparison/README.md
  • docs/runtime-comparison/code-review-workspace.md
  • docs/runtime-comparison/feature-gaps.md
  • docs/runtime-comparison/langgraph.md
  • docs/runtime-comparison/plan.md
  • docs/runtime-comparison/pydantic-ai.md
 __________________________________________________________________________________
< Controlling complexity is the essence of computer programming. - Brian Kernighan >
 ----------------------------------------------------------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR

Comment @coderabbitai help to get the list of available commands.

@senamakel
senamakel merged commit f4735ff into main Sep 23, 2026
9 of 10 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 312655d311

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -1,222 +0,0 @@
# Workspace / registry / language / definition / tracing / integration-tests review

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Retarget references before deleting the workspace review

Deleting this file leaves a broken Markdown link in docs/runtime-comparison/plan.md:11 and unresolved references in feature-gaps.md:74 and crates/tinyagents-registry/src/capability/mod.rs:110,738; readers can no longer resolve the W-* findings that the execution plan and implementation comments rely on. Preserve the still-relevant workspace/registry material or update all of these references to a surviving document.

AGENTS.md reference: AGENTS.md:L78-L80

Useful? React with 👍 / 👎.

@tinysweeper tinysweeper Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requesting changes: 1 lane(s) blocking, worst finding is critical.

Fix or reply to the findings below and push. The next review clears this automatically once they are gone — you should not need to dismiss anything by hand.

             $0.0729 · 437,634 in / 24,474 out · 10,215 cached (2%) · flash, ladder/vectors, gpt-5.6-luna, deepseek-v4-flash · 1,074 embedded
critique:    $0.0521 · 244,280 in / 10,537 out · 6,631 cached (3%)  · gpt-5.6-luna, deepseek-v4-flash
security:    $0.0185 · 88,127 in  / 963 out    · 0 cached (0%)      · gpt-5.6-luna
tests:       $0.0009 · 41,464 in  / 3,075 out  · 1,024 cached (2%)  · deepseek-v4-flash
description: $0.0008 · 31,900 in  / 6,235 out  · 1,024 cached (3%)  · deepseek-v4-flash

`CapabilitySet` model resolution with fallback chains, per-tool timeouts with
grace, run limits and budgets, no-progress detection, goals and task board,
`.rag` blueprints with diagnostics, and a 637-test integration suite with
and a 637-test integration suite with

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

priority medium critique confident

Preserve the .rag capability in the OpenHuman list

The preceding text lists TinyAgents/OpenHuman-owned features and currently ends with no-progress detection, goals and task board,; the deleted text was ``.rag blueprints with diagnostics, and a 637-test integration suite with. Removing the `.rag` phrase makes the document no longer claim the documented expressive-language capability, while the repository README and expressive-language documentation identify `.rag` blueprints and diagnostics as shipped TinyAgents features. Restore that phrase or update the whole sentence to accurately describe the intended ownership.

[RULE] documentation-accuracy ·

Comment on lines +186 to +187
`registry.alias_resolved` so existing host configurations can survive
component renames.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

priority medium critique confident

Preserve graph and language alias compatibility

The previous wording correctly documented that alias resolution preserves old graph specifications and expressive-language files. The new wording implies aliases are only needed for host configurations, even though named capability references in those graph and language surfaces also depend on surviving component renames. Restore the broader compatibility statement so implementers do not miss those consumers.

Suggested change
`registry.alias_resolved` so existing host configurations can survive
component renames.
`registry.alias_resolved` so old graph specs or expressive-language files can
survive component renames.

[RULE] documentation-accuracy ·

integration tests with `-D warnings` or without `--all-features`;
`build_graph` ignores ~70 % of a `.rag` blueprint; the language crate pulls
the HTTP stack for one error type.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

priority medium critique likely

Do not remove unresolved language audit caveats

The diff removes the documented caveat that build_graph ignores most of a .rag blueprint and that the language crate pulls the HTTP stack, but it contains no implementation or documentation changes resolving either issue. If these remain true, the executive summary now presents an incomplete assessment; retain the caveats or update them with the specific fixes that made them obsolete.

[RULE] inaccurate-documentation ·

@tinysweeper tinysweeper Bot added the priority: p0 Drop what you are doing. Data loss, a live break, or an exploitable hole. label Sep 23, 2026
@senamakel
senamakel deleted the remove-rag-language branch September 30, 2026 06:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: p0 Drop what you are doing. Data loss, a live break, or an exploitable hole.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant