@workerdeck/ui 2.7.2 → 2.9.0

package/src/components/prompt-area/trigger-presets.ts

@@ -18,12 +18,12 @@
 
 import type { TriggerConfig, TriggerPosition } from './types.ts'
 
-// Shared option type — everything in TriggerConfig except the keys each
+// Shared option type - everything in TriggerConfig except the keys each
 // factory sets by default.
 
 type TriggerPresetOptions = Omit<Partial<TriggerConfig>, 'char' | 'position' | 'mode'>
 
-// @mention — dropdown at any position
+// @mention - dropdown at any position
 
 export type MentionTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'@'`. */
@@ -48,14 +48,14 @@ export function mentionTrigger(opts: MentionTriggerOptions = {}): TriggerConfig
   }
 }
 
-// /command — dropdown anywhere (opt into line-start-only with `position`)
+// /command - dropdown anywhere (opt into line-start-only with `position`)
 
 export type CommandTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'/'`. */
   char?: string
   /**
    * Where the command trigger is valid. Defaults to `'any'`, so commands fire
-   * anywhere a `/` follows whitespace — not just at the start of a line.
+   * anywhere a `/` follows whitespace - not just at the start of a line.
    * Set to `'start'` to restrict the dropdown to the very start of the input
    * or immediately after a newline (the classic slash-command behavior).
    */
@@ -83,7 +83,7 @@ export function commandTrigger(opts: CommandTriggerOptions = {}): TriggerConfig
   }
 }
 
-// #hashtag — dropdown at any position, auto-resolve on space
+// #hashtag - dropdown at any position, auto-resolve on space
 
 export type HashtagTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'#'`. */
@@ -132,7 +132,7 @@ export function callbackTrigger(opts: CallbackTriggerOptions): TriggerConfig {
   }
 }
 
-// Launch trigger — fires onActivate and swallows the character
+// Launch trigger - fires onActivate and swallows the character
 
 export type LaunchTriggerOptions = Omit<Partial<TriggerConfig>, 'mode'> & {
   /** The trigger character. Required. */

package/src/components/prompt-area/types.ts

@@ -46,7 +46,7 @@ export type TriggerPosition = 'start' | 'any'
  * - 'dropdown': Shows a popover with suggestions from `onSearch`
  * - 'callback': Inserts the char, then fires `onActivate` with the typed query
  * - 'launch': Fires `onActivate` on keydown and SUPPRESSES the char (it never
- *   enters the editor) — for opening an external surface (dialog, palette) where
+ *   enters the editor) - for opening an external surface (dialog, palette) where
  *   no in-editor text should appear. Honors `position` like the other modes.
  */
 export type TriggerMode = 'dropdown' | 'callback' | 'launch'
@@ -102,7 +102,7 @@ export type TriggerConfig = {
    * For 'dropdown' mode: opt a suggestion out of becoming a chip.
    *
    * Return a string and the trigger's range is replaced with that **plain,
-   * editable text** — the trigger character included — with the caret left at
+   * editable text** - the trigger character included - with the caret left at
    * its end. Return undefined and the suggestion resolves to a chip as usual,
    * so one dropdown can mix both kinds.
    *
@@ -239,7 +239,7 @@ export type PromptAreaProps = {
   /**
    * When markdown is on, the editor rewrites typed list markers (`- ` / `* `)
    * to a `•` bullet glyph in the model. Set to `false` to keep the original
-   * marker in the value/`onChange` text — needed when a host renders the output
+   * marker in the value/`onChange` text - needed when a host renders the output
    * as real markdown, where `•` is not a valid list marker. Default `true`.
    */
   normalizeBullets?: boolean
@@ -271,8 +271,8 @@ export type PromptAreaProps = {
    * the caret kept where the edit happened. Chips count as their
    * `trigger + displayText` length.
    *
-   * The cap applies to typing only. Paste is not capped — divert it via
-   * `onRawPaste` if needed — and the imperative `setText` / `appendText` also
+   * The cap applies to typing only. Paste is not capped - divert it via
+   * `onRawPaste` if needed - and the imperative `setText` / `appendText` also
    * bypass it, so a programmatic write can exceed the cap until the next
    * keystroke truncates.
    */
@@ -316,7 +316,7 @@ export type PromptAreaProps = {
   onBlur?: (e: React.FocusEvent<HTMLDivElement>) => void
   /**
    * Called at the start of a paste, before PromptArea reads the clipboard. Call
-   * `preventDefault()` to take over the paste completely — e.g. to divert large
+   * `preventDefault()` to take over the paste completely - e.g. to divert large
    * text or non-image files to an upload pipeline. The built-in segment/image
    * paste handling is skipped when the event's default is prevented.
    */

package/src/components/prompt-area/use-chip-editing.ts

@@ -80,7 +80,7 @@ export function useChipEditing({
 
   // The chip node currently edited via `reopenOnChipClick`, kept in lockstep with
   // `editingChip`/`activeTrigger`. Answers "is THIS exact element the open one" by
-  // reference identity — trigger+value cannot distinguish two chips sharing a value.
+  // reference identity - trigger+value cannot distinguish two chips sharing a value.
   const openChipNode = useRef<HTMLElement | null>(null)
 
   // Set by `handleMouseDown` when the mousedown landed on `openChipNode.current`;
@@ -88,7 +88,7 @@ export function useChipEditing({
   // "toggle closed". A real mousedown on the editor root rather than a
   // `dismissTrigger` flag: bubbling reaches the root before `document`, where
   // TriggerPopover's outside-click dismiss listens and would clear `openChipNode`
-  // first — and it stays scoped to this node, so an unrelated dismiss cannot poison
+  // first - and it stays scoped to this node, so an unrelated dismiss cannot poison
   // a later click on the same chip.
   const suppressReopenChip = useRef<HTMLElement | null>(null)
 
@@ -106,7 +106,7 @@ export function useChipEditing({
 
       let node: Node | null = target
       while (node && node !== editor) {
-        // Check for URL link click — only navigate on Cmd/Ctrl+Click;
+        // Check for URL link click - only navigate on Cmd/Ctrl+Click;
         // plain click just positions the cursor for editing.
         if (isLinkElement(node)) {
           if (e.metaKey || e.ctrlKey) {
@@ -137,12 +137,12 @@ export function useChipEditing({
           if (chip) {
             // Native chip-click dropdown: reopen this trigger's suggestions
             // anchored to the chip so the selection can replace it in place.
-            // Gated on `!disabled` — a disabled composer must not accept edits
+            // Gated on `!disabled` - a disabled composer must not accept edits
             // through any path, including this one.
             const config = triggers.find((t) => t.char === chip.trigger)
             // A click on THIS exact chip element while its own dropdown was
             // open just closed it (see `suppressReopenChip` and
-            // `handleMouseDown`) — treat that as a toggle-close, not a reopen.
+            // `handleMouseDown`) - treat that as a toggle-close, not a reopen.
             const wasOpenForThisChip = suppressReopenChip.current === node
             suppressReopenChip.current = null
             if (!disabled && !wasOpenForThisChip && config?.reopenOnChipClick && config.mode === 'dropdown' && config.onSearch) {
@@ -212,7 +212,7 @@ export function useChipEditing({
       }
       const editor = editorRef.current
       if (editor && !disabled) {
-        // Re-verify the click-time index still holds the same chip — the
+        // Re-verify the click-time index still holds the same chip - the
         // model may have shifted (external value update, undo/redo) while
         // the dropdown was open. If it moved, recover ONLY when exactly one
         // chip in the document now matches trigger+value: with duplicates,
@@ -258,7 +258,7 @@ export function useChipEditing({
           renderSegmentsToDOM(newSegments)
 
           // Same value + display text + data: treat as a no-op confirmation
-          // rather than a destructive delete+add — onChipDelete is
+          // rather than a destructive delete+add - onChipDelete is
           // documented as firing on backspace/forward-delete, not on
           // re-confirming the already-selected suggestion.
           const unchanged =
@@ -271,7 +271,7 @@ export function useChipEditing({
           }
 
           // +1 when a space was inserted, matching resolveChip's own
-          // "+1 accounts for the trailing space after the chip" placement —
+          // "+1 accounts for the trailing space after the chip" placement -
           // landing exactly at the chip's end would put the caret at the
           // same bare element boundary the inserted space exists to avoid.
           const caretOffset = segmentsToPlainText(newSegments.slice(0, segIdx + 1)).length + (insertedSpace ? 1 : 0)

package/src/components/prompt-area/use-markdown-mode.ts

@@ -37,7 +37,7 @@ import { useCallback, useMemo, useState } from 'react'
  */
 export type PromptAreaMode = 'markdown' | 'plain'
 
-/** Returns the other mode. Pure — handy for building custom toggles. */
+/** Returns the other mode. Pure - handy for building custom toggles. */
 export function oppositeMode(mode: PromptAreaMode): PromptAreaMode {
   return mode === 'markdown' ? 'plain' : 'markdown'
 }
@@ -47,7 +47,7 @@ export type UseMarkdownModeOptions = {
   initialMode?: PromptAreaMode
   /**
    * Controlled mode. When provided, the hook mirrors this value and never owns
-   * its own state — drive changes through `onModeChange`.
+   * its own state - drive changes through `onModeChange`.
    */
   mode?: PromptAreaMode
   /** Called with the next mode whenever `toggle`/`setMode` change it. */
@@ -57,7 +57,7 @@ export type UseMarkdownModeOptions = {
 export type MarkdownModeState = {
   /** The active mode. */
   mode: PromptAreaMode
-  /** `true` in markdown mode — spread onto `<PromptArea markdown={markdown} />`. */
+  /** `true` in markdown mode - spread onto `<PromptArea markdown={markdown} />`. */
   markdown: boolean
   /** `true` in plain-text mode (the inverse of `markdown`). */
   isPlainText: boolean

package/src/components/prompt-area/use-prompt-area-events.ts

@@ -165,9 +165,9 @@ export function usePromptAreaEvents(deps: EventHandlerDeps): PromptAreaEventHand
       }
 
       // When markdown mode is on, prefer the richest clipboard flavor:
-      //   1. text/markdown — some apps (e.g. Slack) hand out markdown directly,
+      //   1. text/markdown - some apps (e.g. Slack) hand out markdown directly,
       //      preserving nested lists that their text/plain flattens.
-      //   2. text/html     — convert web/Notion/Docs/GitHub HTML to markdown.
+      //   2. text/html     - convert web/Notion/Docs/GitHub HTML to markdown.
       // Otherwise (markdown off, or neither present) fall back to plain text.
       let text = ''
       if (markdownEnabled) {
@@ -180,7 +180,7 @@ export function usePromptAreaEvents(deps: EventHandlerDeps): PromptAreaEventHand
         } else {
           const html = e.clipboardData.getData('text/html')
           // A converter failure (e.g. stack overflow on pathologically deep
-          // nesting) must not drop the paste — leave text empty so the
+          // nesting) must not drop the paste - leave text empty so the
           // text/plain fallback below still runs.
           if (html) {
             try {

package/src/components/prompt-area/use-prompt-area-keydown.ts

@@ -373,7 +373,7 @@ export function usePromptAreaKeydown({
       }
 
       // 1.75 Launch triggers: a trigger with mode 'launch' fires onActivate on
-      // keydown and suppresses the char so it never enters the editor — for
+      // keydown and suppresses the char so it never enters the editor - for
       // opening an external surface (dialog, palette). The DOM read is gated on
       // the typed key actually matching a launch char, so it stays off the hot
       // path. insertChip still inserts a chip at the cursor if the consumer
@@ -406,7 +406,7 @@ export function usePromptAreaKeydown({
       // 2. Trigger dropdown navigation. Gated on the dropdown actually being
       // ON SCREEN, which matches TriggerPopover's own render condition
       // (non-empty suggestions, OR loading/error/emptyMessage) rather than
-      // just `suggestions.length > 0` — otherwise a popover left open in a
+      // just `suggestions.length > 0` - otherwise a popover left open in a
       // loading/empty state (e.g. right after a chip-click reopen, before its
       // empty-query search resolves) lets Enter fall through to onSubmit and
       // Escape fall through to onEscape while still visibly on screen.
@@ -499,7 +499,7 @@ export function usePromptAreaKeydown({
       }
 
       // 3. Enter without Shift (skipping IME): under `submitOnEnter` it submits
-      // *unconditionally* — the send key must not turn into "another bullet" because
+      // *unconditionally* - the send key must not turn into "another bullet" because
       // of what the line above starts with; list continuation lives on Shift+Enter
       // (branch 2.8). Without `submitOnEnter`, Enter is the newline key and continues.
       if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) {

package/src/components/prompt-area/use-prompt-area-state.ts

@@ -35,11 +35,11 @@ export type UsePromptAreaStateOptions = {
 }
 
 export type PromptAreaBind = {
-  /** Ref to attach to PromptArea — gives access to imperative methods. */
+  /** Ref to attach to PromptArea - gives access to imperative methods. */
   ref: React.RefObject<PromptAreaHandle | null>
-  /** Current segment array — pass as `value` prop. */
+  /** Current segment array - pass as `value` prop. */
   value: Segment[]
-  /** Setter — pass as `onChange` prop. */
+  /** Setter - pass as `onChange` prop. */
   onChange: (segments: Segment[]) => void
 }
 
@@ -83,7 +83,7 @@ export function usePromptAreaState(options: UsePromptAreaStateOptions = {}): Pro
 
   const chips = useMemo(() => value.filter((seg): seg is ChipSegment => seg.type === 'chip'), [value])
 
-  // Bind object — safe to spread onto <PromptArea>
+  // Bind object - safe to spread onto <PromptArea>
   const bind = useMemo<PromptAreaBind>(() => ({ ref, value, onChange: setValue }), [value])
 
   const clear = useCallback(() => {

package/src/components/prompt-area/use-prompt-area.ts

@@ -88,7 +88,7 @@ type UsePromptAreaReturn = {
 const UNDO_DEBOUNCE_MS = 300
 
 // Shared default so an omitted `triggers` prop keeps a stable identity across
-// renders — a fresh [] would re-create renderSegmentsToDOM (and everything
+// renders - a fresh [] would re-create renderSegmentsToDOM (and everything
 // keyed on it) on every parent render.
 const NO_TRIGGERS: TriggerConfig[] = []
 
@@ -401,7 +401,7 @@ export function usePromptArea({
   // pending passive effects before rendering that keystroke's onChange. The
   // stale flush would compare an older render's `value` against the
   // lastRenderedValue that handleInput just advanced, read its own echo lag as
-  // an external change, and rewrite the editor to pre-keystroke content —
+  // an external change, and rewrite the editor to pre-keystroke content -
   // leaving the caret behind the character once the echo re-rendered it.
   // Inside the commit, `value` can never be older than lastRenderedValue.
   useLayoutEffect(() => {
@@ -423,7 +423,7 @@ export function usePromptArea({
     }
 
     // A rebuild churns the caret and the decorations, so skip it when the
-    // editor already shows exactly this content — e.g. a consumer echoed our
+    // editor already shows exactly this content - e.g. a consumer echoed our
     // onChange back re-chunked, or the DOM is split by decorations. Adopt the
     // value so the equality guard above short-circuits from here on.
     if (segmentsContentEqual(readSegmentsFromDOM(), value)) {
@@ -520,7 +520,7 @@ export function usePromptArea({
     // Native structural edits (e.g. a Backspace that deleted or merged a list
     // row) bypass applyEditResult, so rebuild ordered-list numbering here too.
     // handleInput fires on every keystroke, so gate on a genuine ordered-list
-    // run — this renumbers a real list (1,2,4 → 1,2,3) but leaves incidental
+    // run - this renumbers a real list (1,2,4 → 1,2,3) but leaves incidental
     // numeric prose ("1985. Born / 2020. Died") untouched.
     let nextSegments = segments
     let renumberedCursor: number | null = null
@@ -643,7 +643,7 @@ export function usePromptArea({
 
   const selectSuggestion = selectSuggestionInternal
 
-  // Handle key events — the numbered router and its chip-deletion helpers live in
+  // Handle key events - the numbered router and its chip-deletion helpers live in
   // use-prompt-area-keydown.ts.
 
   const handleKeyDown = usePromptAreaKeydown({

package/src/components/prompt-area/use-trigger-search.ts

@@ -25,7 +25,7 @@ export function useTriggerSearch(): UseTriggerSearchReturn {
   const [suggestionsLoading, setSuggestionsLoading] = useState(false)
   const [suggestionsError, setSuggestionsError] = useState<string | null>(null)
 
-  // Version counter – belt-and-suspenders alongside AbortController
+  // Version counter - belt-and-suspenders alongside AbortController
   const searchVersion = useRef(0)
   const abortController = useRef<AbortController | null>(null)
   const debounceTimer = useRef<ReturnType<typeof setTimeout> | null>(null)

package/src/components/terminal/PermissionPrompt.tsx

@@ -42,8 +42,8 @@ export function TerminalPermissionPrompt({ request, onApprove, onDeny, className
       onCancel={() => setDenying(false)}
       placeholder={
         plan
-          ? 'What should change? (optional) — the agent keeps planning and reads this'
-          : 'Reason (optional) — the agent reads this and can try something else'
+          ? 'What should change? (optional) - the agent keeps planning and reads this'
+          : 'Reason (optional) - the agent reads this and can try something else'
       }
     />
   ) : undefined
@@ -51,7 +51,7 @@ export function TerminalPermissionPrompt({ request, onApprove, onDeny, className
   const options = plan
     ? [
         { key: 'allow', label: 'Approve plan' },
-        { key: 'deny', label: 'Keep planning — tell it what to change', detail: reasonInput },
+        { key: 'deny', label: 'Keep planning - tell it what to change', detail: reasonInput },
         { key: 'stop', label: 'No, and stop the turn', danger: true },
       ]
     : [
@@ -116,7 +116,7 @@ export function TerminalPermissionPrompt({ request, onApprove, onDeny, className
       <Hint>
         {denying
           ? 'Enter to send · Shift+Enter for a new line · Esc to go back'
-          : 'Enter to select · ↑/↓ to navigate · 1–3 to choose · Esc to cancel'}
+          : 'Enter to select · ↑/↓ to navigate · 1-3 to choose · Esc to cancel'}
       </Hint>
     </div>
   )

package/src/components/terminal/affordances.tsx

@@ -44,7 +44,7 @@ export function WithActions({ actions, children, className }: { actions: ReactNo
 
 // Bookmarks are a host concern (which items, where they persist); the transcript only needs
 // membership and a toggle. A missing provider renders no action at all, so embeddings that
-// never wire bookmarks pay nothing — the same contract AffordanceContext has.
+// never wire bookmarks pay nothing - the same contract AffordanceContext has.
 export type BookmarkHandle = {
   has: (itemId: string) => boolean
   toggle: (itemId: string) => void

package/src/components/terminal/file-link.tsx

@@ -0,0 +1,20 @@
+import { createContext, useContext, type ReactNode } from 'react'
+
+export type FileLinkOpener = (path: string, line?: number) => void
+
+export type FileLinkHandle = {
+  cwd?: string
+  open: FileLinkOpener
+}
+
+const FileLinkContext = createContext<FileLinkHandle | undefined>(undefined)
+
+// A missing provider leaves every link an ordinary anchor, so embeddings that have nowhere to
+// open a file pay nothing - the same contract BookmarkContext has.
+export function FileLinkProvider({ value, children }: { value: FileLinkHandle | undefined; children: ReactNode }) {
+  return <FileLinkContext.Provider value={value}>{children}</FileLinkContext.Provider>
+}
+
+export function useFileLinks(): FileLinkHandle | undefined {
+  return useContext(FileLinkContext)
+}

package/src/components/terminal/height.ts

@@ -102,7 +102,7 @@ type Token = { kind: 'word' | 'space'; w: number; exact: boolean }
 const TAB_SIZE = 2
 
 // Break after these unless a digit follows; `?` is here because Chrome breaks long URLs after it (verified against real break rects).
-const BREAK_AFTER = new Set(['-', '–', '—', '?'])
+const BREAK_AFTER = new Set(['-', '-', '-', '?'])
 
 const PLAIN_ASCII = /^[\x20-\x7e]*$/
 
@@ -181,7 +181,7 @@ function tokenize(line: string): Token[] {
     const { w, exact } = clusterCells(segment)
     const cp = segment.codePointAt(0) ?? 0
     if (isWide(cp) || PICTOGRAPHIC.test(segment)) {
-      // Each wide cluster is its own token — a break may fall between any two.
+      // Each wide cluster is its own token - a break may fall between any two.
       flushWord()
       tokens.push({ kind: 'word', w, exact })
       col += w

package/src/components/terminal/items.tsx

@@ -173,8 +173,8 @@ export function ToolRow({ item }: { item: ToolCallItem }) {
                     }}
                   >
                     {truncated
-                      ? `… +${missing.toLocaleString()} chars — fetch the rest`
-                      : `… +${hidden} line${hidden === 1 ? '' : 's'} — show all ${text.length.toLocaleString()} chars`}
+                      ? `… +${missing.toLocaleString()} chars - fetch the rest`
+                      : `… +${hidden} line${hidden === 1 ? '' : 's'} - show all ${text.length.toLocaleString()} chars`}
                   </button>
                 ) : (
                   <>

package/src/components/terminal/markdown.tsx

@@ -1,7 +1,9 @@
 import { memo, type ReactNode } from 'react'
 import { Streamdown, type Components } from 'streamdown'
 import { cn } from '../../lib/utils.ts'
+import { parseFileLink } from '../../lib/file-link.ts'
 import { CopyAction, WithActions } from './affordances.tsx'
+import { useFileLinks } from './file-link.tsx'
 import { Band } from './row.tsx'
 
 function codeText(node: ReactNode): string {
@@ -45,6 +47,34 @@ function heading(tone: 'bright' | 'fg'): Components['h1'] {
   }
 }
 
+// An agent writes a file as a markdown link far more often than it writes a URL, and the link text is
+// its name, not its path: an anchor to a scheme-less href resolves against the host page and leads nowhere.
+function Link({ href, children }: { href?: string; children: ReactNode }) {
+  const links = useFileLinks()
+  const file = links ? parseFileLink(href, links.cwd) : undefined
+  if (file) {
+    return (
+      <button
+        type="button"
+        className="term-link"
+        data-tone="blue"
+        title={file.line === undefined ? file.path : `${file.path}:${file.line}`}
+        onClick={(event) => {
+          event.stopPropagation()
+          links?.open(file.path, file.line)
+        }}
+      >
+        {children}
+      </button>
+    )
+  }
+  return (
+    <a className="term-link" data-tone="blue" href={href} target="_blank" rel="noreferrer">
+      {children}
+    </a>
+  )
+}
+
 const TERMINAL_COMPONENTS: Components = {
   p: ({ children }) => <div className="term-block">{children}</div>,
 
@@ -85,11 +115,7 @@ const TERMINAL_COMPONENTS: Components = {
     </strong>
   ),
   em: ({ children }) => <em className="term-em">{children}</em>,
-  a: ({ children, href }) => (
-    <a className="term-link" data-tone="blue" href={href} target="_blank" rel="noreferrer">
-      {children}
-    </a>
-  ),
+  a: ({ children, href }) => <Link href={href}>{children}</Link>,
 
   table: ({ children }) => (
     <div className="term-block term-table-wrap">

package/src/components/terminal/scrubber.tsx

@@ -351,7 +351,7 @@ export function TerminalScrubber(props: TerminalScrubberProps) {
     setPeek(null)
   }, [props.items])
 
-  // Manual listener because it must `preventDefault` — React's root wheel listeners are passive.
+  // Manual listener because it must `preventDefault` - React's root wheel listeners are passive.
   useEffect(() => {
     if (!interactive) {
       return

package/src/components/terminal/todos.ts

@@ -29,7 +29,7 @@ export function todoPreview(name: string, input: unknown): TodoPreview | undefin
   }
 }
 
-// Height and render both draw this exact string — `toolRowHeight` counts what `TerminalTodos` paints.
+// Height and render both draw this exact string - `toolRowHeight` counts what `TerminalTodos` paints.
 export function todoLine(todo: TodoEntry): string {
   return `${GLYPH[todo.status]} ${todo.text}`
 }

package/src/components/ui/Splitter.tsx

@@ -59,7 +59,7 @@ export function Splitter({
     }
   }
 
-  // Reached after `endDrag` — the second click of a double-click has already started a drag, and dblclick fires after pointerup.
+  // Reached after `endDrag` - the second click of a double-click has already started a drag, and dblclick fires after pointerup.
   const onDoubleClick = () => {
     if (defaultValue !== undefined) {
       onValueChange(clamp(defaultValue))

package/src/index.ts

@@ -61,6 +61,8 @@ export { TerminalDiff, previewPatch } from './components/terminal/diff.tsx'
 export { TerminalMarkdown, type TerminalMarkdownProps } from './components/terminal/markdown.tsx'
 export { Band, Blank, Ink, Row, type RowProps, type Tone } from './components/terminal/row.tsx'
 export { CopyAction, WithActions, useAffordances, type TerminalAffordances } from './components/terminal/affordances.tsx'
+export { FileLinkProvider, useFileLinks, type FileLinkHandle, type FileLinkOpener } from './components/terminal/file-link.tsx'
+export { parseFileLink, type FileLink } from './lib/file-link.ts'
 export { Conversation, ConversationContent, ConversationScrollButton, type ConversationProps } from './components/agent/Conversation.tsx'
 export { Message, MessageContent, type MessageProps } from './components/agent/Message.tsx'
 export {
@@ -86,7 +88,15 @@ export {
   type QuestionPromptProps,
   type QuestionBehaviorMeta,
 } from './components/agent/QuestionPrompt.tsx'
-export { Composer, skillPrompt, type ComposerFileMatch, type ComposerHandle, type ComposerProps } from './components/agent/Composer.tsx'
+export { Composer, type ComposerFileMatch, type ComposerHandle, type ComposerProps } from './components/agent/Composer.tsx'
+export {
+  mergeComposerRows,
+  rankComposerRows,
+  matchClientCommand,
+  skillPrompt,
+  type ClientCommand,
+  type ComposerRow,
+} from './components/agent/composer-commands.ts'
 export { ModelSelect, type ModelSelectProps } from './components/agent/ModelSelect.tsx'
 export {
   PERMISSION_MODES,

package/src/lib/context-note.ts

@@ -9,11 +9,11 @@ export interface ContextNote {
 
 const CODEX_CONTEXT_NOTE: ContextNote = {
   summary:
-    'Codex budgets 272K input by default and reports 95% of it, so a 1M-class model reads ~258k. That is codex’s price tier, not the model’s ceiling — and it is the number auto-compaction fires on, so the meter is honest.',
-  hint: 'Raising it is yours to set: model_context_window in ~/.codex/config.toml — and watch for auto-compaction failing afterwards.',
+    'Codex budgets 272K input by default and reports 95% of it, so a 1M-class model reads ~258k. That is codex’s price tier, not the model’s ceiling - and it is the number auto-compaction fires on, so the meter is honest.',
+  hint: 'Raising it is yours to set: model_context_window in ~/.codex/config.toml - and watch for auto-compaction failing afterwards.',
   detail: [
     'To raise it, set model_context_window in ~/.codex/config.toml, up to 872000 (reported as 828400). Codex clamps to its own max_context_window, itself below OpenAI’s stated 922,000 max input.',
-    'Above 272K input, a request bills at 2x input / 1.5x output for the whole request. WorkerDeck never writes this setting — it is a cost decision on your account.',
+    'Above 272K input, a request bills at 2x input / 1.5x output for the whole request. WorkerDeck never writes this setting - it is a cost decision on your account.',
   ],
   caveat:
     'Raise it and watch for auto-compaction failing: openai/codex #16068 reports it stops firing after the first overflow. Unverified here on 0.149.0.',

package/src/lib/file-link.ts

@@ -0,0 +1,70 @@
+export type FileLink = {
+  path: string
+  line?: number
+}
+
+const SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/
+const TRAILING_LINE = /^(.*?):(\d+)(?::\d+)?$/
+const FRAGMENT_LINE = /^L(\d+)/
+
+// What an agent writes as a markdown link target when it means a file on the host: `./SPEC.md`,
+// `docs/AUTH.md#anchor`, `/Users/me/project/src/main.ts:42`, `file:///tmp/out.txt`. Anything with a
+// real scheme, and anything relative that arrives before the session's cwd is known, stays a web link.
+export function parseFileLink(href: string | undefined, cwd: string | undefined): FileLink | undefined {
+  const raw = href?.trim()
+  if (!raw || raw.startsWith('#') || raw.startsWith('//')) {
+    return undefined
+  }
+
+  let target = raw
+  if (SCHEME.test(target)) {
+    if (!target.startsWith('file:')) {
+      return undefined
+    }
+    try {
+      target = decodeURIComponent(new URL(target).pathname)
+    } catch {
+      return undefined
+    }
+  }
+
+  let line: number | undefined
+  const hash = target.indexOf('#')
+  if (hash !== -1) {
+    line = readLine(FRAGMENT_LINE.exec(target.slice(hash + 1))?.[1])
+    target = target.slice(0, hash)
+  }
+
+  const suffix = TRAILING_LINE.exec(target)
+  if (suffix) {
+    target = suffix[1]!
+    line ??= readLine(suffix[2])
+  }
+
+  if (!target) {
+    return undefined
+  }
+
+  const path = target.startsWith('/') ? normalize(target) : cwd ? normalize(`${cwd}/${target}`) : undefined
+  return path ? { path, ...(line === undefined ? {} : { line }) } : undefined
+}
+
+function readLine(value: string | undefined): number | undefined {
+  const parsed = value === undefined ? Number.NaN : Number(value)
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined
+}
+
+function normalize(path: string): string {
+  const out: string[] = []
+  for (const part of path.split('/')) {
+    if (part === '' || part === '.') {
+      continue
+    }
+    if (part === '..') {
+      out.pop()
+      continue
+    }
+    out.push(part)
+  }
+  return `/${out.join('/')}`
+}

package/src/lib/format.ts

@@ -28,7 +28,7 @@ export function compactionText(item: {
 
 export function formatCost(usd: number | undefined): string {
   if (usd === undefined || Number.isNaN(usd)) {
-    return '—'
+    return '-'
   }
   if (usd === 0) {
     return '$0.00'
@@ -92,7 +92,7 @@ export function formatCountdown(untilEpochMs: number, now = Date.now()): string
 
 export function formatRelativeTime(epochMs: number | undefined, now = Date.now()): string {
   if (!epochMs) {
-    return '—'
+    return '-'
   }
   const diff = Math.max(0, now - epochMs)
   const s = Math.floor(diff / 1000)