[Mbeaulne]

Intent

Let people reference the project's pipelines, documents and runs from the Tangent chat box with #, so the agent knows exactly which item they mean.

Current behavior

• The Tangent chat box can only autocomplete agents and people, with @.
• To point the agent at a pipeline or run, you have to type its name or paste an id.
• Pipeline and document links in the chat show as plain links. Only run links show as chips.

What changes

• This page hands Tangent's chat the project's pipelines, documents and runs, newest first, so typing # lists them alongside the session's pinned files. Each shows when it was added or ran, which also tells apart two pipelines with the same name.
• Each one is sent as a link to its canvas address, such as pipeline://id/…. The agent's existing tool for opening things in the canvas accepts it as is.
• Pipeline and document links in the chat now show as chips that open in the canvas, as run links already did.
• The embed package points at the tangent-shell branch that adds the # picker.

How to test

1. Open a project in Tangent that has at least one pipeline, one document and one run.
2. In the chat box, type #. A list opens with Pipelines, Documents and Runs (and Files, if the session has pinned files). Each item shows how long ago it was added or ran, newest first.
3. Type part of a pipeline's name, press Enter, and confirm a token like #Churn-model is inserted.
4. Add a run the same way, then send: "Compare #Churn-model with #Churn-model-2".
5. In your sent message, both references show as chips. Click the pipeline chip and it opens in the canvas. Click the run chip and the run opens.
6. Confirm the agent's reply talks about that pipeline and run, and that it can open them if you ask.
7. Type @ and confirm the agents-and-people list still works.

Checks run on this branch: typecheck, lint, Prettier on the changed files, and knip are clean, and the 572 tests in the Tangent and chat folders pass, including new ones for the references and the chips. Not yet tried in the browser.

Related Issue and Pull requests

• Stack: part 7 of 10. Merge in order: Underline the Tangent tab strips and hide resting scrollbars #3010 → Give the Tangent project lists one row design #3011 → Replace the Tangent Sessions panel with a Projects sidebar #3012 → Move Tangent project tools into a card, a settings dialog and the app bar #3013 → Open Tangent agents from the chat's agents pill #3007 → Search projects and sessions from the Tangent sidebar #3016 → Offer the project's pipelines, documents and runs to the chat's # picker #3018 (this PR) → Show a green plug beside project settings while VS Code is connected #3019 → Rework the Tangent project card around reports, runs, pipelines and documents #3021 → Open runs from the chat, and list each chat's runs in a pill #3022.
• Depends on the # picker in Reference pipelines, runs and files from the chat box with # tangent-shell#164.

Type of Change

• New feature

Line Breakdown

8 files changed, 255 insertions(+), 7 deletions(-)

Category	Added	Removed
Production code	95	1
Comments	8	0
Tests	146	0
Config / CI / tooling	1	1
Generated / lockfiles	5	5
Total	255	7

Checklist

• I have tested this does not break current pipelines / runs functionality
• I have tested the changes on staging

Screenshots (if applicable)

None yet.

Additional Comments

• Before merging: package.json points @tangent/embed-react at the tangent-shell branch MB/tangent-chat-references, so the new references prop typechecks. Once the tangent-shell stack merges, switch it back to #main and refresh the lockfile.
• Rollout: deploy Tangent first. Either order is safe: this page alone passes a list Tangent ignores, and Tangent alone offers only the session's files under #.

🤖 Generated with Claude Code

[github-actions]

🎩 Preview

A preview build has been created at: MB/tangent-chat-references/a5e3a53