@sidequest-007/dsh-atlas 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 的组织方式，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.0.2] - 2026-09-27
+
+### 修复
+
+- **带空格的会话引用不再被切成半个 token**：草稿 token 的读取边界是"到空白为止"，而会话标签里经常有空格
+  （`@[继续 LoongCrush J 项目的任务](dsh-session:…)`），于是它被切成 `@[继续` 这一片。现在完整的 wire 引用
+  （方括号 + `dsh-session:` 载荷）**优先**被作为一个 token 读入；官方引用语法本来就只有这一种承载空格标签的
+  写法，所以修复后这类引用能正确解码成会话并画出可点链接（而不是落进文件规则）。
+- **诊断线索**：手打**裸标签**式（`@继续 LoongCrush J 项目的任务`，没有方括号与载荷）在语义上不是会话引用，
+  token 只能是 `@继续`；这类不存在的路径在验证阶段会让 Host 报
+  `cannot resolve target "…\继续": ENOENT`。要引用会话请用 `@` 菜单的「过去的聊天」插入，它会写入带载荷的
+  方括号形态。
+
+### 新增
+
+- **会话引用可点击跳转**：草稿里手打的 `@<会话id>`（或 `@[标题](dsh-session:…)`）与已发送气泡里仍带 wire 形态的会话引用，
+  现在都是**可点链接**——点击即切换当前会话（复用侧栏列表项的同一动作，外观/路由/持久化一致），跨工作区有效。
+  判定规则刻意保守：wire 形态按 payload 精确解码（base64url + 规范化回环校验，坏 URI 一律拒绝）；
+  **裸标签只有唯一命中**（等于某个会话 id，或等于**唯一一个**会话标题）才成为会话链接，
+  所以 `@AGENTS.md` 这种同时也是工作区文件的名字**永远不会被劫持**；同名/过期会话保持原样（可读、不可点）。
+  **边界**：**已发送**的气泡只有在 chip 仍带 `dsh-session:` 载荷时才可点 —— Host 在落库前会把提及折成裸标签，
+  那时 id 已不在文本里（已按上游通道提报）。
+- **新增回归守卫**：补上"profile 未挂 right Sidebar"这条已文档化降级路径的测试（此前**零覆盖**），以及
+  会话引用的**组合层接线**守卫；并用"故意破坏实现"实验证明这些守卫真的会失败。
+
+### 文档
+
+- **介绍口径修正**：tagline 与首段补上两点此前只写在代码里的事实 —— ① **会话引用本身就是链接**（草稿里点它即切换会话）；
+  ② 本部署实际是 **6 个资源族**（五个内置类别 + 内置的 `@git` provider）。此前的措辞只说"五个内置类别 + provider"，
+  读者不会知道菜单里真能看到并使用 `@git`。同步改了 `package.json` 的 `description`（npm 卡片用）、配图的
+  `aria-label` 与图内文案，以及"输入快捷键只显示五个类别"这类描述。
+
 ## [1.0.1] - 2026-09-26
 
 ### 变更

package/README.md

@@ -4,17 +4,17 @@
 
 A **Side Quest** project (工作室：支线任务, **Side Quest Labs**) — npm scope `@sidequest-007/*`, repository [`jameswatt139240-crypto/dsh-ATLAS`](https://github.com/jameswatt139240-crypto/dsh-ATLAS); the DSH plugin id keeps the ecosystem's unscoped `dsh-*` form.
 
-<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS: one @ trigger, five built-in categories, plus a category any plugin can register" width="880">
+<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS: one @ trigger, five built-in categories plus the bundled git category, and a category any plugin can register" width="880">
 
-**@ Last, All Sources.** One `@` . Any plugin can register.
+**@ Last, All Sources.** One `@`, every source; one click, the session it names.
 
-Unified `@` mentions for the DeepSeek Harness web GUI: type `@` in the composer to reference **workspace files and folders**, **discoverable skills**, **past chats**, and **installed plugins** — and any other plugin can add its own category to the same menu.
+Unified `@` mentions for the DeepSeek Harness web GUI: type `@` in the composer to reference **workspace files and folders**, **discoverable skills**, **past chats**, **installed plugins**, and **workspace git changes** — and any other plugin can add its own category to the same menu. A **session** reference is a link: click it and the composer switches to that session.
 
-- **One `@`, every source**: five built-in categories plus every registered provider, in one list; typing letters searches all of them at once.
+- **One `@`, every source**: five built-in categories plus the bundled `@git` provider — six resource families in this deployment — and every registered provider, in one list; typing letters searches all of them at once.
 - **A platform, not a picker**: third-party plugins register their own `@` category through the `ctx.atlas` seam. The menu rebuilds from the live registry on every open, so **this package never has to change for a provider** — see [Write your own `@` source](#write-your-own--source).
 - **Provenance, never content**: a committed mention injects a marker (`<workspace-reference>`, `<skill-reference>`, `<atlas-reference>`, …) and nothing else. The plugin reads directory metadata only; the agent reads the file itself, if and when it needs to.
 - **Governed by construction**: `scopes` and `testedOn` are required, a duplicate `id` throws, a version mismatch registers as `verified: false`, and every provider body is budgeted (16 KiB per reference, 48 KiB per step).
-- **`@git` ships as the worked example**: a real provider, built the way a third party would build one, in ~200 lines across its two halves.
+- **`@git` ships as the worked example, and as a real source**: it lists the workspace's changes (path + added/removed lines) like any other category, and it is built exactly the way a third party would build one, in ~200 lines across its two halves.
 
 <p align="center"><img src="assets/diagrams/atlas-seam.svg" alt="The @ data-source seam: browser half lists candidates, host half resolves one reference at send, and the registry gates the declaration" width="880"></p>
 
@@ -40,9 +40,9 @@ dsh plugin --profile web add @sidequest-007/dsh-atlas
 
 Restart `dsh web` after installing or updating so the Host and the browser client load the same version. Then type `@` in the composer.
 
-## The five categories
+## The categories
 
-The menu keeps five category rows in its **bottom band** — the rows nearest the composer — so pressing `@` opens on them rather than on whatever else shares the trigger.
+The menu keeps the category rows — five built in, plus the bundled `@git` — in its **bottom band**, the rows nearest the composer, so pressing `@` opens on them rather than on whatever else shares the trigger.
 
 | Category | Menu prefix | Shortcut | Candidates from | Written into the draft |
 |---|---|---|---|---|
@@ -52,9 +52,9 @@ The menu keeps five category rows in its **bottom band** — the rows nearest th
 | Past chat | `chat:` | `C` | The official session-reference resolver | `@[title](dsh-session:<id>)` |
 | Plugin | `plugin:` | `P` | The official plugin inventory | `@plugin:dsh-atlas` |
 
-**One shortcut letter is a statement of intent, not a query.** Typing it shows the five categories plus a `Tab 补全 → category:` hint as the **last** row, with the highlight already on that hint; <kbd>Tab</kbd> or <kbd>Enter</kbd> then enters the `category:` prefix. **A registered source can claim a shortcut letter too**: the first letter of its id (`@git` → <kbd>G</kbd>), and only while no built-in category or earlier provider answers to that letter (the `@<id>:` prefix always works). Filtering starts on anything more specific — a first letter that is not a shortcut, or a second character (which is what the `fi`/`fo`/`sk`/`ch`/`pl` spellings are). Clicking a category row or the back row enters/returns the same way and **keeps the menu open** — that is this plugin's own override; the normal pick path closes it.
+**One shortcut letter is a statement of intent, not a query.** Typing it shows the category rows — five built-in plus the bundled `@git` — and a `Tab 补全 → category:` hint as the **last** row, with the highlight already on that hint; <kbd>Tab</kbd> or <kbd>Enter</kbd> then enters the `category:` prefix. **A registered source can claim a shortcut letter too**: the first letter of its id (`@git` → <kbd>G</kbd>), and only while no built-in category or earlier provider answers to that letter (the `@<id>:` prefix always works). Filtering starts on anything more specific — a first letter that is not a shortcut, or a second character (which is what the `fi`/`fo`/`sk`/`ch`/`pl` spellings are). Clicking a category row or the back row enters/returns the same way and **keeps the menu open** — that is this plugin's own override; the normal pick path closes it.
 
-**Registered sources are the sixth row and beyond.** `@git` ships built in (the workspace's changed files, with each file's diff as the referenced content), and any plugin can add its own category the same way — see [Write your own `@` source](#write-your-own--source). They appear after the five, in registration order, and disappear when the plugin that registered them is disposed. The plugin's group itself is registered with a **positive order**, so it is the last group in the menu: the bottom band belongs to this plugin, and the stock `dsh-client-ui-reference` source's file list stays above it.
+**Registered sources are the sixth row and beyond.** `@git` ships built in (the workspace's changed files, with each file's diff as the referenced content), and any plugin can add its own category the same way — see [Write your own `@` source](#write-your-own--source). They appear after the built-ins, in registration order, and disappear when the plugin that registered them is disposed. The plugin's group itself is registered with a **positive order**, so it is the last group in the menu: the bottom band belongs to this plugin, and the stock `dsh-client-ui-reference` source's file list stays above it.
 
 ## Interaction
 
@@ -71,6 +71,7 @@ The menu keeps five category rows in its **bottom band** — the rows nearest th
 - **Every draft reference the plugin can open is a link**: the test is the PLUGIN's own — the token decodes into a reference and the Host has confirmed the target exists — not whether the framework happened to decorate it. A hand-typed `@AGENTS.md` behaves exactly like one the editor recognised: the whole token is blue, a click anywhere inside it opens the reference, and the pointer turns into a hand. The colour is painted with the CSS Custom Highlight API (a Lexical text span expects exactly one text child, so wrapping any part of a token would break typing inside it) in the very colour the framework uses for its own references. A token whose target is **gone** is not left as ordinary text either: it is painted the dock's own **Missing** way — dimmed and struck through — because it is a reference that cannot open. **When** that verdict is drawn matters: only a **finished** token is judged (one followed by whitespace, or by another line, i.e. after Enter), because a token still being typed is every prefix of a path at once and `@N` is always "missing" — striking it through mid-word would judge a word the user has not written yet. A token that CAN open turns blue the moment its name is complete, exactly as the framework's own decoration does. A token whose verdict has not arrived, whose provider declared no `open`, or whose name cannot be placed claims nothing and stays ordinary text. On a browser without the highlight API nothing is painted at all — there only the part the framework itself coloured acts as a link, because nothing else is drawn as one.
 - **A reference another source inserted as a chip is clickable too**: the sidebar's file tree writes one into the draft as an atomic chip, which this client build draws in the framework's chip blue and leaves inert. Clicking one opens the file it names, and the chip then carries the plugin's link language. That source labels a chip with the file's **basename** (the full relative path lives only in the draft text), so a bare name is placed in two steps: first the plugin's own index, where a unique basename settles it; then, when the index itself is ambiguous (`index.ts` exists twice in this workspace), the **draft** — one token with that basename decides, two leave the chip inert. Only a name the index does not know at all is handed to the click's own existence check, which marks the chip stale rather than opening something wrong.
 - **References in sent messages are clickable**: a chip in a message bubble opens on click (files in the right Sidebar, the Host opener when there is none; skills through the skill source; provider items through the `open` their own provider declared). Only a chip that really opens is drawn as a link — the framework's own `--dsw-alias-link` blue with a hover underline — and a build that wires the chips itself renders `<button>`, which this plugin leaves alone. The plugin also implements the framework's `openReference` hook, so a client that activates a reference token in the composer asks its owning source to open it. The installed client activates nothing yet, so the plugin supplies that click itself, through the very action the chips run.
+- **A session reference is a link**: identity here is decided by VALUE, because the id is not in the path. The wire form `@[label](dsh-session:…)` on its own names its session (the payload is decoded and must round-trip canonically), a label with spaces is still ONE token, and a hand-typed bare `@<session-id-or-title>` is promoted only on exactly ONE match from the session list — an ambiguous or unknown name stays inert, so `@AGENTS.md` stays the file reference it is. Clicking switches the current session through the same action a sidebar row performs. **Boundary**: a message already SENT can only be opened when its chip still carries the wire payload; once the Host folds it to a bare label the id is gone, which is why this plugin filed that upstream.
 - **Icons**: every row this plugin emits carries **its own** glyph — the same modern line set the reference dock uses, including per-file-type and per-language marks (TypeScript, Rust, PDF, image, archive, …) and a branch glyph for `@git`. The framework's menu row can only draw three glyphs of its own, so the plugin reserves the slot (which is what indents every name by the same amount) and draws the glyph itself, monochrome, in a fixed layer above the list: nothing is inserted into a row the framework owns, and the framework's own glyph is hidden only in the slots this layer actually covers.
 
 ![The @ menu](assets/screenshots/menu-mixed.png)

package/README.zh.md

@@ -4,17 +4,17 @@
 
 本项目属于 **Side Quest（支线任务）** 工作室（**Side Quest Labs**）—— npm 范围 `@sidequest-007/*`，仓库 [`jameswatt139240-crypto/dsh-ATLAS`](https://github.com/jameswatt139240-crypto/dsh-ATLAS)；**DSH 插件 id 沿用生态惯例的无 scope 形式 `dsh-*`**。
 
-<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS：一个 @ 触发位、五个内置类别，以及任何插件都能注册的自己的类别" width="880">
+<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS：一个 @ 触发位、五个内置类别加内置的 git 类别，以及任何插件都能注册的自己的类别" width="880">
 
-**@ Last, All Sources.** 一个 `@` 。任何插件都能注册。
+**@ Last, All Sources.** 一个 `@`，所有来源；一次点击，直达它指名的那个会话。
 
-DeepSeek Harness Web 界面的**统一 `@` 提及**插件：在输入框输入 `@`，即可引用工作区**文件与文件夹**、可发现的 **Skill**、**过去的聊天记录**、**已安装插件** —— 而且任何其它插件都能把自己的类别加进同一个菜单。
+DeepSeek Harness Web 界面的**统一 `@` 提及**插件：在输入框输入 `@`，即可引用工作区**文件与文件夹**、可发现的 **Skill**、**过去的聊天记录**、**已安装插件**，以及**工作区的 git 改动** —— 而且任何其它插件都能把自己的类别加进同一个菜单。**会话**引用本身就是链接：点一下，输入框就切到那个会话。
 
-- **一个 `@`，所有来源**：五个内置类别 + 所有已注册的数据源，同一个列表；输入字母即跨类别一起搜。
+- **一个 `@`，所有来源**：五个内置类别 + 内置的 `@git` provider（本部署里共 **6 个资源族**）+ 所有已注册的数据源，同一个列表；输入字母即跨类别一起搜。
 - **是平台，不是取词器**：第三方插件通过 `ctx.atlas` seam 注册自己的 `@` 类别。菜单每次打开都从**实时注册表**重建，所以**本包永远不需要为某个 provider 改代码** —— 见 [自己接一个 `@` 数据源](#自己接一个--数据源)。
 - **只给来源，不给内容**：提交的引用只注入标记（`<workspace-reference>`、`<skill-reference>`、`<atlas-reference>` …）。插件只读目录项元数据；文件内容由 agent 在需要时自己去读。
 - **治理写在代码里**：`scopes` 与 `testedOn` 必填、`id` 重复直接抛错、版本不匹配注册为 `verified: false`、provider 正文有预算（单条 16 KiB、单步 48 KiB）。
-- **`@git` 就是范例**：一个真实 provider，完全按第三方的方式实现，两个半边加起来约 200 行。
+- **`@git` 既是范例，也是一个真实来源**：它像其它类别一样列出工作区的改动（路径 + 增删行数），并且完全按第三方的方式实现，两个半边加起来约 200 行。
 
 <p align="center"><img src="assets/diagrams/atlas-seam.svg" alt="@ 数据源 seam：浏览器半边在菜单打开时列候选，Host 半边在发送时解析一次，注册表负责门禁" width="880"></p>
 
@@ -40,7 +40,7 @@ dsh plugin --profile web add @sidequest-007/dsh-atlas
 
 安装或更新后**重启 `dsh web`**，确保 Host 与浏览器客户端都加载同一版本。然后在输入框打 `@`。
 
-## 五个类别
+## 类别
 
 输入 `@` 后，菜单顶部是五个常驻类别行；也可以直接输入关键字跨类别混合搜索。
 
@@ -52,13 +52,13 @@ dsh plugin --profile web add @sidequest-007/dsh-atlas
 | 过去的聊天 | `chat:` | `C` | 官方 session-reference 解析器 | `@[标题](dsh-session:<id>)` |
 | 插件 | `plugin:` | `P` | 官方 plugin inventory | `@plugin:dsh-atlas` |
 
-**单个快捷键字母是"意图"而不是"查询"**：输入它只显示五个类别 + 一行「Tab 补全 → `类别:`」提示，且这行提示在**最下面**（高亮也已经落在它上面），按 <kbd>Tab</kbd> 或 <kbd>Enter</kbd> 即进入对应的 `类别:` 前缀。**注册的数据源也能有快捷键字母**：取 provider id 的首字母（`@git` → <kbd>G</kbd>），只有在该字母没被内置类别或更早注册的 provider 占用时才生效（`@<id>:` 前缀永远可用）。**过滤从更具体的东西开始**：不是快捷键的首字母，或第二个字符（`fi`/`fo`/`sk`/`ch`/`pl` 这类前缀本来就是两个字符）。点击类别行或「返回类别」行同样进入/返回，且**菜单保持打开**（这是本插件的两处覆写：正常 pick 路径会关闭菜单）。
+**单个快捷键字母是"意图"而不是"查询"**：输入它只显示类别行——五个内置类别 + 内置的 `@git`——以及一行「Tab 补全 → `类别:`」提示，且这行提示在**最下面**（高亮也已经落在它上面），按 <kbd>Tab</kbd> 或 <kbd>Enter</kbd> 即进入对应的 `类别:` 前缀。**注册的数据源也能有快捷键字母**：取 provider id 的首字母（`@git` → <kbd>G</kbd>），只有在该字母没被内置类别或更早注册的 provider 占用时才生效（`@<id>:` 前缀永远可用）。**过滤从更具体的东西开始**：不是快捷键的首字母，或第二个字符（`fi`/`fo`/`sk`/`ch`/`pl` 这类前缀本来就是两个字符）。点击类别行或「返回类别」行同样进入/返回，且**菜单保持打开**（这是本插件的两处覆写：正常 pick 路径会关闭菜单）。
 
-**第六行起是"已注册数据源"。** `@git` 已内置（工作区的变更文件，引用内容就是该文件的 diff），任何插件都能用同样的方式加自己的类别——见[自己接一个 `@` 数据源](#自己接一个--数据源)。它们排在五个类别之后、按注册顺序出现，注册它们的插件被销毁时一起消失。插件自身的分组以**正的 `order`** 注册，因此它是菜单里的**最后一个分组**：底部那条工作带归本插件，框架自带 `dsh-client-ui-reference` 数据源的文件列表留在它上面。
+**第六行起是"已注册数据源"。** `@git` 已内置（工作区的变更文件，引用内容就是该文件的 diff），任何插件都能用同样的方式加自己的类别——见[自己接一个 `@` 数据源](#自己接一个--数据源)。它们排在内置类别之后、按注册顺序出现，注册它们的插件被销毁时一起消失。插件自身的分组以**正的 `order`** 注册，因此它是菜单里的**最后一个分组**：底部那条工作带归本插件，框架自带 `dsh-client-ui-reference` 数据源的文件列表留在它上面。
 
 ## 交互
 
-- **直接输入字母**：跨类别混合搜索，结果按「最近引用」与「全部匹配」两段展示，每行带类别标签；五个类别行始终在**最下面的工作带**里可点选。
+- **直接输入字母**：跨类别混合搜索，结果按「最近引用」与「全部匹配」两段展示，每行带类别标签；类别行（五个内置 + 内置的 `@git`）始终在**最下面的工作带**里可点选。
 - **文件夹**：`@folder:` 类别列出目录，选中后写入 `@路径/`（末尾的 `/` 才是「目录」的标记，插件依然只读目录项元数据）；在斜杠后继续输入即可在该目录内收窄搜索。过滤时结果分**两档**排序：先按**名称**命中的文件夹（工作区内的在前，工作区外的在后），再是只有**路径**命中的那些，收进它们自己的 `路径匹配` 组。那一组默认展开、装得下就显示，折叠与否是你的手势。
 - **先写的文件夹会成为后面文件列表的作用域**：`@e:/work/docs/ @file:` 会先列出**该文件夹自己的文件**（一层，走的是文件夹 tab 同一套目录列表），组标题写明它来自哪个文件夹、并标明在工作区之外，然后才是工作区里的命中项。作用域是**位置**决定的——当前 token 之前最近的那个文件夹引用——所以**不需要连接词**；草稿里没有文件夹引用时行为与以前完全一致。
 - **分组折叠**：Skill 按管理层级（系统 / 用户 / 项目 / 自定义 / 插件）再按领域分组，插件按 npm scope（`@deepseek-ai/…` 或「其他」）分组，过去的聊天按工作区分组、子会话缩进在父会话下；组标题**点击即可折叠/展开；当高亮行正是该组标题时按 <kbd>Enter</kbd> 同样折叠/展开**。<kbd>Tab</kbd> 补全、<kbd>↑</kbd><kbd>↓</kbd>、<kbd>Esc</kbd> 全部由框架自己的 keymap 提供。除此之外插件只加三个键：高亮组标题上的 <kbd>Enter</kbd> 折叠、类别行/返回行选中后保持菜单打开、以及 <kbd>PageUp</kbd>/<kbd>PageDown</kbd> 按**实测一屏**翻页——翻页移动的是高亮（高亮属于别的数据源时就只滚列表），所以"看得见的那一行"永远是你正在操作的那一行。
@@ -72,6 +72,7 @@ dsh plugin --profile web add @sidequest-007/dsh-atlas
 - **草稿里任何能打开的 `@路径` 都是链接**：判断依据是**插件自己**——token 能解码成引用、并且宿主确认该目标存在——而不是框架有没有把它装饰成引用。所以手打的 `@AGENTS.md` 和框架认出来的 token 一样：**整条**变蓝、点任意位置都打开、鼠标变手型。上色用 CSS Custom Highlight API 逐段绘制（Lexical 的文本 span 只允许一个文本子节点，包裹尾巴会破坏输入），颜色取框架给引用用的同一个变量。**目标已不存在**的 token 也不会被当成普通文本，而是按引用栏那套「已失效」语言画成**暗色 + 删除线**——它是引用，只是打不开。**判定时机**：只有**写完的 token** 才会被判失效（后面跟着空白，或后面还有下一行＝按过回车）；正在输入的 token 不下结论——`@N` 这种中间态必然"不存在"，边打边画删除线等于替用户还没写完的词下判决。**能打开**的 token 则在名字写成的那一刻就变蓝（与框架自己的引用装饰一样即时）。引用栏还没回答、provider 没声明 `open`、或名字放不下的 token 什么都不说、保持普通文本。浏览器不支持 highlight API 时什么都不绘制，此时**只有框架自己上过色的那部分**可点（没画成链接就不表现得像链接）。
 - **草稿里由其它数据源插入的 chip 也能点**：右侧栏的文件树就是往草稿里插一条原子 chip，这个客户端把它画成框架自己的 chip 蓝、并且不接任何点击。点它即打开它命名的文件，随后 chip 会带上插件的链接语言。那个数据源给 chip 的标签是**文件名**（完整相对路径只存在于草稿文本里），所以裸文件名按两步还原：①在插件索引里找同名 basename，唯一命中即用；②索引里就有歧义（例如 `index.ts` 在工作区里有两处）时回退到**草稿**——草稿里只有一个同名 token 就用它，仍有两个则**保持不可点**。索引完全不认识的名字才原样交给点击时的存在性检查（结果是标「已失效」，而不是打开一个错的目标）。
 - **已发送消息里的引用可点**：消息气泡里的引用 chip 点击即打开（文件进右侧栏，无右栏时交宿主打开器；Skill 交给 Skill 源；provider item 交给它自己声明的 `open`）。只有真的能打开的 chip 会被画成链接（用框架自己的 `--dsw-alias-link` 蓝 + 悬停下划线），框架自己接好点击的版本会渲染 `<button>`，本插件自动让位。插件同时实现了框架的 `openReference` 钩子：客户端在草稿里激活一个引用 token 时，由拥有它的 source 打开。安装版客户端还没有接上这一步，因此这个点击同样由插件补上，走的是 chip 用的那同一个动作。
+- **会话引用本身就是链接**：它的身份按**值**判定，因为 id 不在路径里。`@[标签](dsh-session:…)` 这种带载荷的形态自己就能指明会话（载荷按 base64url 解码并要求**规范化回环**通过）；**标签里有空格也算一个 token**；手打的裸 `@<会话id或标题>` 只有**唯一命中**会话列表时才提升为会话链接——歧义或查不到就保持普通文本，所以 `@AGENTS.md` 仍然是它本来那个文件引用。点击即切换当前会话，走的是**侧栏那一行的同一个动作**。**边界**：**已发送**的消息只有在 chip 上还留着载荷时才可点；一旦 Host 把它折成裸标签，id 就不在了——这条我已按上游通道提了报告。
 - **图标**：本插件发出的每一行都带**自己的**图标——与引用栏同一套现代线稿，含按文件类型与语言的标记（TypeScript、Rust、PDF、图片、压缩包…），`@git` 用分支图标。框架的菜单行只会画它自己的三种字形，所以插件**预定那个图标槽**（这决定了所有名字缩进一致），再由自己在列表上方的一层固定层里、用单色线条画出图标：不往框架拥有的行里插任何东西，框架自己的字形也只在被这一层真正覆盖的槽里隐藏。
 
 ![@ 菜单](assets/screenshots/menu-mixed.png)

package/assets/diagrams/atlas-overview.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="880" height="300" viewBox="0 0 880 300" role="img" aria-label="dsh-ATLAS: one @ trigger, five built-in categories with their glyphs, plus any plugin's own category">
+<svg xmlns="http://www.w3.org/2000/svg" width="880" height="300" viewBox="0 0 880 300" role="img" aria-label="dsh-ATLAS: one @ trigger, five built-in categories plus the bundled git category with their glyphs, and any plugin's own category; one click names the session it points at">
   <rect x="0" y="0" width="880" height="300" rx="18" fill="#0f1420"/>
   <rect x="0.5" y="0.5" width="879" height="299" rx="17.5" fill="none" stroke="#26304a"/>
 

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "@sidequest-007/dsh-atlas",
-  "description": "@ Last, All Sources. One @ . Any plugin can register.",
-  "version": "1.0.0",
+  "description": "@ Last, All Sources. One @, every source; one click, the session it names.",
+  "version": "1.0.2",
   "entry": {
     "name": "@sidequest-007/dsh-atlas",
     "inject": []

package/lib/client.js

@@ -15709,10 +15709,54 @@ function menuGlyph(row, size = 16) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Icon, { size, stroke: 1.8, color: "currentColor", "aria-hidden": true });
 }
 
+// src/client/session-link.ts
+var SESSION_URI_SCHEME = "dsh-session:";
+var WIRE_MENTION_RE = /^@\[([^\]\n]*)\]\((dsh-session:[^)\s]+)\)$/u;
+function wireMentionAt(text, offset) {
+  if (text[offset] !== "@") return void 0;
+  const match = /@\[([^\]\n]*)\]\((dsh-session:[^)\s]+)\)(?=\s|$)/uy;
+  match.lastIndex = offset;
+  const found = match.exec(text);
+  return found === null ? void 0 : { end: offset + found[0].length };
+}
+function wireSessionUri(text) {
+  return WIRE_MENTION_RE.exec(text)?.[2] ?? "";
+}
+function decodeSessionUri(uri) {
+  if (!uri.startsWith(SESSION_URI_SCHEME)) return void 0;
+  const payload = uri.slice(SESSION_URI_SCHEME.length);
+  if (!/^[A-Za-z0-9_-]+$/u.test(payload)) return void 0;
+  let decoded;
+  try {
+    const base643 = payload.replace(/-/gu, "+").replace(/_/gu, "/");
+    const binary = atob(base643);
+    decoded = decodeURIComponent([...binary].map((char) => `%${char.charCodeAt(0).toString(16).padStart(2, "0")}`).join(""));
+  } catch {
+    return void 0;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(decoded);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "string" || parsed === "") return void 0;
+  return encodeSessionUri(parsed) === uri ? parsed : void 0;
+}
+function encodeSessionUri(sessionId) {
+  const json2 = JSON.stringify(sessionId);
+  const bytes = new TextEncoder().encode(json2);
+  let binary = "";
+  for (const byte of bytes) binary += String.fromCharCode(byte);
+  return SESSION_URI_SCHEME + btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
+}
+
 // src/client/reference-links.ts
 var INERT_HANDLES = ["plugin:"];
 function decodeReferenceLink(title) {
   if (typeof title !== "string" || !title.startsWith("@")) return void 0;
+  const session = decodeSessionUri(wireSessionUri(title));
+  if (session !== void 0) return { kind: "session", sessionId: session };
   let label;
   if (title.startsWith('@"')) {
     if (title.length < 4 || !title.endsWith('"')) return void 0;
@@ -15745,6 +15789,9 @@ function decodeDraftReference(token) {
   const trimmed = token.endsWith("/") || token.endsWith("\\") ? token.slice(1, -1) : void 0;
   return trimmed === void 0 || trimmed === "" ? void 0 : { kind: "folder", path: trimmed };
 }
+function draftSessionId(token) {
+  return decodeSessionUri(wireSessionUri(token));
+}
 var FILE_ADDRESS_PREFIX = "dsh-resource://file/";
 function encodeSegment(segment) {
   return encodeURIComponent(segment).replace(/%3A/giu, ":");
@@ -19303,6 +19350,13 @@ function localOffset(index, node, offset) {
 }
 function tokenRunAt(text, offset) {
   if (offset < 0 || offset > text.length) return void 0;
+  const trigger = text.lastIndexOf("@", offset);
+  if (trigger >= 0) {
+    const wire = wireMentionAt(text, trigger);
+    if (wire !== void 0 && offset <= wire.end) {
+      return { token: text.slice(trigger, wire.end), start: trigger, end: wire.end };
+    }
+  }
   let start = offset;
   while (start > 0 && !isSpace(text[start - 1])) start -= 1;
   let end = offset;
@@ -19349,13 +19403,18 @@ function draftTokens() {
   }
   return out;
 }
-function draftActivation(token, actionFor, verdict) {
+function draftActivation(token, actionFor, verdict, resolveLabel) {
+  const session = draftSessionId(token) ?? (resolveLabel === void 0 || !token.startsWith("@") ? void 0 : resolveLabel(token.slice(1)));
+  if (session !== void 0) return activate({ kind: "session", sessionId: session }, actionFor);
   const link = draftLink(token);
   if (link === void 0) return void 0;
   const resolved = withHostKind(link, verdict);
   if (resolved === void 0) return void 0;
-  const run = actionFor(resolved);
-  return run === void 0 ? void 0 : { link: resolved, run };
+  return activate(resolved, actionFor);
+}
+function activate(link, actionFor) {
+  const run = actionFor(link);
+  return run === void 0 ? void 0 : { link, run };
 }
 function withHostKind(link, verdict) {
   if (link.kind !== "file" && link.kind !== "folder") return link;
@@ -19422,16 +19481,16 @@ function caretOf(event) {
   if (range == null) return void 0;
   return { node: range.startContainer, offset: range.startOffset };
 }
-function DraftLinks({ actionFor, useReferenceInfo }) {
+function DraftLinks({ actionFor, useReferenceInfo, resolveSession }) {
   const infos = useReferenceInfo((snapshot) => snapshot.value);
   const verdictByPath = (0, import_react6.useMemo)(
     () => new Map(infos.map((info) => [referenceKey(info.relative), { exists: info.exists, kind: info.kind }])),
     [infos]
   );
-  const face = (0, import_react6.useRef)({ actionFor, verdict: (path) => verdictByPath.get(referenceKey(path)) });
+  const face = (0, import_react6.useRef)({ actionFor, verdict: (path) => verdictByPath.get(referenceKey(path)), resolveSession });
   (0, import_react6.useEffect)(() => {
-    face.current = { actionFor, verdict: (path) => verdictByPath.get(referenceKey(path)) };
-  }, [actionFor, verdictByPath]);
+    face.current = { actionFor, verdict: (path) => verdictByPath.get(referenceKey(path)), resolveSession };
+  }, [actionFor, verdictByPath, resolveSession]);
   const repaint = (0, import_react6.useRef)(() => {
   });
   (0, import_react6.useEffect)(() => {
@@ -19440,12 +19499,12 @@ function DraftLinks({ actionFor, useReferenceInfo }) {
         const end = reference.decoratedEnd;
         if (end === void 0 || reference.local >= end) return void 0;
       }
-      return draftActivation(reference.token, face.current.actionFor, face.current.verdict);
+      return draftActivation(reference.token, face.current.actionFor, face.current.verdict, face.current.resolveSession);
     };
     const paint = () => {
       const verdict = (path) => face.current.verdict(path);
       paintDraftLinks((token) => {
-        if (draftActivation(token.token, face.current.actionFor, verdict) !== void 0) return "link";
+        if (draftActivation(token.token, face.current.actionFor, verdict, face.current.resolveSession) !== void 0) return "link";
         if (!token.settled) return void 0;
         return draftMissing(token.token, verdict) ? "missing" : void 0;
       });
@@ -19535,10 +19594,14 @@ var COMPOSER_CHIP_ATTRIBUTE = "data-composer-chip";
 var LINK_ATTRIBUTE = "data-dsh-atlas-link";
 var MISSING_ATTRIBUTE = "data-dsh-atlas-missing";
 var LINKABLE_KIND = "file";
+var SESSION_KIND = "session";
 function chipLink(chip) {
   if (chip.tagName === "BUTTON") return void 0;
-  if (chip.getAttribute(CHIP_ATTRIBUTE) !== LINKABLE_KIND) return void 0;
-  return decodeReferenceLink(chip.getAttribute("title"));
+  const kind = chip.getAttribute(CHIP_ATTRIBUTE);
+  if (kind !== LINKABLE_KIND && kind !== SESSION_KIND) return void 0;
+  const link = decodeReferenceLink(chip.getAttribute("title"));
+  if (link !== void 0 && kind === SESSION_KIND && link.kind !== "session") return void 0;
+  return link;
 }
 function composerChipBody(host) {
   return host.querySelector("[title]") ?? host;
@@ -20101,6 +20164,22 @@ function apply(ctx) {
   const sessions = ctx.get("sessions");
   const t = ctx.locale.bind(NS);
   const entryByRel = /* @__PURE__ */ new Map();
+  const resolveSessionLabel = (label) => {
+    const snapshot = sessions.list.getSnapshot();
+    const ids = snapshot.ids;
+    if (ids.includes(label)) return label;
+    const hits = ids.filter((id) => snapshot.byId[id]?.displayTitle === label);
+    return hits.length === 1 ? String(hits[0]) : void 0;
+  };
+  const openSession = (sessionId) => {
+    try {
+      sessions.open(sessionId);
+      return "opened";
+    } catch (error51) {
+      console.warn(`[dsh-atlas] this session reference could not be opened: ${sessionId}`, error51);
+      return "gone";
+    }
+  };
   const scopeVerdicts = /* @__PURE__ */ new Map();
   const SCOPE_VERDICT_CACHE = 50;
   const search = async (sessionId, signal) => {
@@ -20336,6 +20415,9 @@ function apply(ctx) {
         return "opened";
       };
     }
+    if (link.kind === "session") {
+      return () => openSession(link.sessionId);
+    }
     if (link.kind === "atlas") {
       const open = atlasRegistry.get(link.provider)?.provider.open;
       if (open === void 0) return void 0;
@@ -20442,7 +20524,8 @@ function apply(ctx) {
     order: 5,
     inject: (sessionId) => ({
       actionFor: (link) => actionFor(sessionId, link),
-      hooks: { referenceInfo }
+      hooks: { referenceInfo },
+      resolveSession: resolveSessionLabel
     })
   }, DraftLinks));
   ctx.slots.inject("conversation.input.overlay", () => ctx.slots.register({

package/lib/types/client/DraftLinks.d.ts

@@ -1,6 +1,7 @@
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ReferenceInfoSource } from './FilesDock.tsx';
 import type { ReferenceLink } from './reference-links.ts';
+import type { SessionLabelResolver } from './session-link.ts';
 import type { ReferenceOutcome } from './ReferenceLinks.tsx';
 /** What the session's overlay shares with the draft bridge. */
 export interface DraftLinksInjected {
@@ -10,6 +11,13 @@ export interface DraftLinksInjected {
     readonly hooks: {
         readonly referenceInfo: ReferenceInfoSource;
     };
+    /**
+     * Resolve a BARE `@label` to the one session it names, or undefined. A session
+     * mention carries no id once it is durable, so this is the only way a draft
+     * token can become a session link — and it answers undefined for an ambiguous
+     * or unknown label, so a name that also exists as a file is never hijacked.
+     */
+    readonly resolveSession?: SessionLabelResolver | undefined;
 }
 /** Overlay entry props: the composer runtime face plus the opener and the verdicts. */
 export type DraftLinksProps = PropsRuntime<'conversation.input.overlay'> & InjectFace<DraftLinksInjected>;
@@ -18,4 +26,4 @@ export type DraftLinksProps = PropsRuntime<'conversation.input.overlay'> & Injec
  * @param props - the injected opener and the dock's verdict source.
  * @returns nothing; this entry renders no DOM of its own.
  */
-export declare function DraftLinks({ actionFor, useReferenceInfo }: DraftLinksProps): null;
+export declare function DraftLinks({ actionFor, useReferenceInfo, resolveSession }: DraftLinksProps): null;

package/lib/types/client/ReferenceLinks.d.ts

@@ -39,7 +39,12 @@ export type ReferenceLinksProps = PropsRuntime<'conversation.input.overlay'> & I
  *
  * A `<button>` chip means the framework passed its reference actions and wires
  * the click itself; acting as well would open the resource twice. A chip of any
- * other kind (session, folder, skill-slash, command) is not ours to open.
+ * other kind (folder, skill-slash, command) is not ours to open — EXCEPT a
+ * session chip, which is nobody else's: DSH renders every session mention as a
+ * plain label element, so switching sessions is exactly the click this bridge
+ * has to add. Its title has to carry the wire URI for that (the host folds the
+ * mention to a bare label before the message is durable), which
+ * `decodeReferenceLink` decides by value.
  * @param chip - the chip element.
  * @returns the decoded action, or undefined when the bridge must not act.
  */

package/lib/types/client/draft-links.d.ts

@@ -1,4 +1,5 @@
 import { type ReferenceLink } from './reference-links.ts';
+import { type SessionLabelResolver } from './session-link.ts';
 import type { ReferenceOutcome } from './ReferenceLinks.tsx';
 /** The attribute Lexical puts on the composer's contenteditable root. */
 export declare const EDITOR_SELECTOR = "[data-lexical-editor=\"true\"]";
@@ -59,6 +60,14 @@ export interface TokenRun {
  * The run is bounded by whitespace and by a second `@` (the grammar is `@` plus
  * a run of non-whitespace, non-`@` characters), so a click anywhere inside a
  * token — including its undecorated tail — resolves to the same whole token.
+ *
+ * ONE exception, and it is load-bearing: a complete WIRE session mention
+ * (`@[label with spaces](dsh-session:…)`) is returned whole, because the
+ * whitespace rule would otherwise cut it at its first space and leave a fragment
+ * (`@[继续`) that decodes as a file path — opening a nonexistent file (observed
+ * live as `cannot resolve target "…\继续": ENOENT`). The official mention
+ * vocabulary always spells a session reference this way, so the bracket form is
+ * the only spelling that can carry a label with spaces.
  * @param text - one line's text.
  * @param offset - the character offset the caret sits at.
  * @returns the token and its span, or undefined when no `@` governs that offset.
@@ -129,9 +138,12 @@ export declare function draftTokens(): readonly DraftToken[];
  * @param token - one draft token, `@` included.
  * @param actionFor - the session's action lookup.
  * @param verdict - the dock's last inspection verdict for one referenced path.
+ * @param resolveLabel - the session list lookup a BARE `@label` needs before it
+ *   may become a session link; omitted means bare labels stay prose and fall
+ *   through to the file rules.
  * @returns the action, or undefined when there is nothing to open.
  */
-export declare function draftActivation(token: string, actionFor: (link: ReferenceLink) => DraftAction | undefined, verdict: DraftVerdictLookup): DraftActivation | undefined;
+export declare function draftActivation(token: string, actionFor: (link: ReferenceLink) => DraftAction | undefined, verdict: DraftVerdictLookup, resolveLabel?: SessionLabelResolver): DraftActivation | undefined;
 /** The Host's inspection verdict for one referenced path. */
 export interface DraftVerdict {
     /** Whether the target exists right now. */

package/lib/types/client/reference-links.d.ts

@@ -1,12 +1,3 @@
-/**
- * The two pure pieces of the sent-message click-through: decoding one rendered
- * reference chip back into the action it can offer, and spelling the file
- * address the right Sidebar resolves.
- *
- * Both are pure string work so the browser bridge (`ReferenceLinks.tsx`) stays a
- * thin event adapter, and so the address grammar can be pinned against the
- * Harness's own implementation in the tests instead of being trusted by eye.
- */
 /** One mention of an already sent message that a click can act on. */
 export type ReferenceLink = {
     readonly kind: 'file';
@@ -25,6 +16,14 @@ export type ReferenceLink = {
     readonly kind: 'atlas';
     readonly provider: string;
     readonly item: string;
+}
+/**
+ * A SESSION reference: selecting it switches the current session, which is a
+ * main-area navigation rather than a resource the Sidebar could show.
+ */
+ | {
+    readonly kind: 'session';
+    readonly sessionId: string;
 };
 /**
  * Decode one reference chip's raw label (its `title`) into the action it offers.
@@ -34,10 +33,11 @@ export type ReferenceLink = {
  * `@atlas:provider/item`, `@[label](dsh-session:…)`, or an out-of-workspace
  * absolute path (`@E:\…` / `@E:/…`, whose drive letter is a path, not a handle).
  * Only a workspace file, a quoted path, an absolute path, a skill (whose source
- * the skill source opens) and a provider item (whose meaning belongs to that
- * provider) name something to act on. A trailing separator is a folder mention
- * (its chip kind is `folder`), and a colon in the first segment is our own handle
- * spelling unless it is a drive letter.
+ * the skill source opens), a provider item (whose meaning belongs to that
+ * provider) and a wire session mention (whose payload names its session) name
+ * something to act on. A trailing separator is a folder mention (its chip kind
+ * is `folder`), and a colon in the first segment is our own handle spelling
+ * unless it is a drive letter.
  * @param title - the chip's `title` attribute (the undecorated label).
  * @returns the mention, or undefined when there is nothing to open.
  */
@@ -49,10 +49,25 @@ export declare function decodeReferenceLink(title: string | null | undefined): R
  * decorates by syntax rather than by name: a trailing separator marks a folder
  * mention (`@src/`), whose chip kind is its own and whose click opens the
  * directory through the Host opener.
+ *
+ * A bare `@label` is deliberately left to the caller's
+ * `resolveSessions`: opening one as a session needs the live session list, and
+ * a token that names no session must still fall through to being a file path
+ * (`@docs` is a directory long before it is a session title). The wire session
+ * form needs no list, so it is decoded right here.
  * @param token - the activated token, trigger included (e.g. `@src/a.ts`).
  * @returns the mention, or undefined when nothing can be opened.
  */
 export declare function decodeDraftReference(token: string): ReferenceLink | undefined;
+/**
+ * The session one DRAFT token names, when the token itself says so.
+ *
+ * Only the wire form answers here: a bare label needs {@link SessionLabelResolver}
+ * and the live list, which is the caller's business (see `draftActivation`).
+ * @param token - one draft token, `@` included.
+ * @returns the session id to switch to, or undefined when the token carries none.
+ */
+export declare function draftSessionId(token: string): string | undefined;
 /**
  * The address of a workspace-relative file in one session: the Harness's
  * `dsh-resource://file/session/<sessionId>/<path>` form, spelled here so the

package/lib/types/client/session-link.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Session-reference CLICK-THROUGH: decode the two shapes a session mention
+ * leaves behind, and decide the one session (if any) each names.
+ *
+ * Why this module exists at all: a session mention is folded to a bare label
+ * before the message is durable (`parseSessionReferenceText` replaces
+ * `@[label](dsh-session:…)` with `@label`), and the editor keeps the wire form
+ * as plain TEXT rather than an atomic chip — measured live, so neither the
+ * bubble's chip `title` nor the composer's DOM carries a session id. Two shapes
+ * therefore survive, and each needs its own rule:
+ *
+ * - the WIRE form `@[label](dsh-session:<base64url(JSON string)>)`, which names
+ *   its session exactly, and
+ * - a bare `@label`, which names nothing by itself and is opened ONLY when the
+ *   session list contains exactly ONE matching session (id or title). A guess
+ *   would hijack a real file: `@AGENTS.md` is a file long before it is a
+ *   session, and the plugin must never turn a workspace path into a jump.
+ *
+ * Pure string + list work, so the browser bridge stays a thin event adapter and
+ * the rules are pinned by their own spec.
+ */
+/** One session reference a click can act on. */
+export interface SessionLink {
+    readonly sessionId: string;
+    /** The session a bare label resolves to, for the "no id in the label" shape. */
+    readonly resolvedFrom?: string;
+}
+/** The wire mention, captured as label + payload. Matches the framework's own grammar. */
+export declare const WIRE_MENTION_RE: RegExp;
+/**
+ * The wire mention that STARTS at one character offset of a line, if any.
+ *
+ * The composer's token reader is whitespace-bounded, which is exactly why this
+ * exists: a session label routinely contains spaces (`@[继续 LoongCrush 项目的任务](…)`)
+ * and the whitespace rule would cut the mention at its first space, leaving a
+ * fragment that decodes as a FILE path. `$` is replaced by a lookahead so the
+ * regex can be anchored at a position inside a longer line.
+ * @param text - one line's text.
+ * @param offset - the offset the mention would start at (the `@`).
+ * @returns the mention and its end offset, or undefined when none starts there.
+ */
+export declare function wireMentionAt(text: string, offset: number): {
+    readonly end: number;
+} | undefined;
+/**
+ * The `dsh-session:` URI inside one wire mention, or undefined for any other
+ * spelling. Shared so the sent-message decoder and the draft activation can ask
+ * the same question instead of each keeping its own copy of the grammar.
+ * @param text - a chip `title` or a draft token.
+ * @returns the URI, ready for {@link decodeSessionUri}.
+ */
+export declare function wireSessionUri(text: string): string;
+/**
+ * Decode one `dsh-session:` URI into the session id it names.
+ *
+ * The payload is base64url of `JSON.stringify(id)` (the host's canonical
+ * encoding), so a payload that decodes to anything but one JSON string is not a
+ * session address — and the round trip is verified, exactly as the host's own
+ * decoder does, so a non-canonical spelling can never name a different session.
+ * @param uri - a complete `dsh-session:` URI.
+ * @returns the session id, or undefined when the URI is malformed.
+ */
+export declare function decodeSessionUri(uri: string): string | undefined;
+/** Look one label up against the live session list. */
+export interface SessionLinkDeps {
+    /**
+     * The session one mention label names, or undefined when it names none or
+     * more than one. Implemented over `ctx.sessions.list`, so the plugin never
+     * guesses: ambiguity answers undefined and the reference stays inert.
+     */
+    matchLabel(label: string): string | undefined;
+}
+/**
+ * The lookup a DRAFT asks before it may promote a bare `@label` into a session
+ * link, or undefined for a bridge that may not promote one at all. Injection
+ * passes the plugin's `ctx.sessions.list` reader; everything else (a test, the
+ * sent-message bridge) leaves it out and bare labels stay dead letters.
+ */
+export type SessionLabelResolver = (label: string) => string | undefined;
+/**
+ * Resolve one reference label (a chip `title`, or a draft token without its
+ * `@`… see the callers) into a session to open.
+ *
+ * The wire form is exact and needs no list. A bare label is accepted ONLY in
+ * the draft, where the user's own typing is the intent: in a SENT bubble the
+ * same bare label also decorates plain prose (`@AGENTS.md` is routinely a
+ * file), so promoting it there would overrule a file reference the user made.
+ * @param text - the label with its leading `@`, or the full wire mention.
+ * @param deps - the live session lookup.
+ * @param allowBareLabel - whether a bare `@label` may be promoted (draft only).
+ * @returns the session to open, or undefined when nothing may be opened.
+ */
+export declare function resolveSessionLink(text: string, deps: SessionLinkDeps, allowBareLabel: boolean): SessionLink | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sidequest-007/dsh-atlas",
-  "description": "@ Last, All Sources. One @ . Any plugin can register.",
-  "version": "1.0.1",
+  "description": "@ Last, All Sources. One @, every source; one click, the session it names.",
+  "version": "1.0.2",
   "license": "MIT",
   "author": "Side Quest Labs",
   "publishConfig": {