feat(web): copy session reference from context menu

[heavygee]

Problem

When running multiple HAPI sessions (orchestrator + feature peers, parallel investigations), operators need to cite one session inside another — paste a pointer into a different session's composer so the agent or human knows where to look.

Today there is no one-click way to grab that citation from the session list context menu (rename / archive / delete / reopen).

Why not "Copy link"?

A menu item labeled Copy link reads like share access (public URL, guest access, tailnet bookmark). That is not the intent.

The actual use case is same-hub cross-session reference: "see the work already happening in session X" when spawning or continuing a peer. The clipboard text should read as a citation, not an invitation.

Proposal

Add Copy reference to the session More actions menu:

• Session list: long-press / right-click on a row
• Session header: overflow (three-dot) menu

Clipboard payload (example):

See session "upstream issue/pr discovery" (/sessions/abc-def) for context

Design choices:

• Title — human/agent-readable label from session metadata
• Relative path — navigable within the same PWA/hub; deliberately not a full https:// URL (avoids share-link semantics)
• "for context" — frames the paste as a citation for another chat

Implementation sketch:

• web/src/lib/sessionReference.ts — buildSessionReferenceText(title, id)
• SessionActionMenu — new item after Rename; uses existing safeCopyToClipboard
• i18n key: session.action.copyReference

Scope

Web-only. No hub/API/SCHEMA_VERSION changes.

Test plan

• Unit tests for reference string builder
• Unit test: menu click copies citation and closes menu
• Manual: right-click session in list → Copy reference → paste into another session composer

[github-actions]

This is consistent with the current web structure and looks like a web-only additive change.

Verified in the codebase: both requested surfaces already route through the same SessionActionMenu, so a single new action there can be wired from the session list row menu and the session header overflow menu. I did not find an existing sessionReference / buildSessionReferenceText helper, so that part would be new.

Relevant code:

• web/src/components/SessionActionMenu.tsx:12 - menu props currently cover rename/export/archive/reopen/delete actions.
• web/src/components/SessionActionMenu.tsx:287 - Rename is currently the first menu item; export/archive/reopen/delete follow in this component.
• web/src/components/SessionList.tsx:735 - session list long-press/right-click path renders SessionActionMenu.
• web/src/components/SessionHeader.tsx:236 - session header overflow path renders the same SessionActionMenu.
• web/src/lib/clipboard.ts:47 - existing safeCopyToClipboard(text) utility writes to clipboard with fallback behavior.
• web/src/components/SessionList.tsx:439 - list title fallback order is name, summary text, path basename, then id prefix.
• web/src/components/SessionHeader.tsx:15 - header has the same title fallback logic for full session objects.
• web/src/router.tsx:1097 - session detail route is /sessions/$sessionId.
• web/src/lib/locales/en.ts:153 - session action i18n keys live here; no session.action.copyReference key is present now.
• web/src/lib/locales/zh-CN.ts:153 - matching Chinese session action keys live here.
• web/src/components/SessionActionMenu.test.tsx:55 - existing menu action test pattern covers “click action and closes menu”.

No hub/API/schema code path found for this request.

---

HAPI Bot