akanjs 3.1.0-rc.2 → 3.1.0-rc.21

package/types/vendor/@akanjs/native/plugins/http/src/desktop.d.ts

@@ -1,5 +1,5 @@
 import type { HttpSpec } from "./index.ts";
 /** `send` is replaceable for tests; the default is Bun's fetch. */
-export declare function createDesktopHttp(send?: typeof fetch): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<HttpSpec, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<HttpSpec, {}>;
+export declare function createDesktopHttp(send?: typeof fetch): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<HttpSpec, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<HttpSpec, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/http/src/web.d.ts

@@ -1,2 +1,2 @@
 import type { HttpSpec } from "./index.ts";
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<HttpSpec, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<HttpSpec, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/keep-awake/src/desktop.d.ts

@@ -10,6 +10,6 @@ export type Spawner = (argv: string[]) => Child;
  * `spawn` is replaceable so tests can check the command without keeping the Mac awake, `platform`
  * so they can check the shell ops of Windows and Linux on any OS.
  */
-export declare function createDesktopKeepAwake(spawn?: Spawner, pid?: number, platform?: NodeJS.Platform): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<KeepAwakeApi, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<KeepAwakeApi, {}>;
+export declare function createDesktopKeepAwake(spawn?: Spawner, pid?: number, platform?: NodeJS.Platform): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<KeepAwakeApi, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<KeepAwakeApi, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/keep-awake/src/index.d.ts

@@ -22,7 +22,7 @@ export interface KeepAwakeApi {
         value: boolean;
     }>;
 }
-export declare const keepAwake: import("../../../packages/core/src/plugin.ts").Plugin<KeepAwakeApi, {}>;
+export declare const keepAwake: import("../../../packages/core/src/plugin.ts").Plugin<KeepAwakeApi, Record<never, never>>;
 /**
  * Keeps the screen on until the returned function is called (once per holder). The first holder
  * calls keepAwake, the last release calls allowSleep. Do not mix with direct keepAwake()/allowSleep()

package/types/vendor/@akanjs/native/plugins/keep-awake/src/web.d.ts

@@ -1,2 +1,2 @@
 import type { KeepAwakeApi } from "./index.ts";
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<KeepAwakeApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<KeepAwakeApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/opener/src/desktop.d.ts

@@ -9,6 +9,6 @@ export type Runner = (argv: string[]) => Promise<Command>;
  * `run` is replaceable so tests can check the commands without opening anything, `platform` so
  * they can check the Windows and Linux paths (shell ops) on any OS.
  */
-export declare function createDesktopOpener(run?: Runner, platform?: NodeJS.Platform): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<OpenerApi, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<OpenerApi, {}>;
+export declare function createDesktopOpener(run?: Runner, platform?: NodeJS.Platform): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<OpenerApi, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<OpenerApi, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/opener/src/index.d.ts

@@ -30,4 +30,4 @@ export interface OpenerApi {
      */
     openSettings(): Promise<void>;
 }
-export declare const opener: import("../../../packages/core/src/plugin.ts").Plugin<OpenerApi, {}>;
+export declare const opener: import("../../../packages/core/src/plugin.ts").Plugin<OpenerApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/opener/src/web.d.ts

@@ -1,2 +1,2 @@
 import type { OpenerApi } from "./index.ts";
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<OpenerApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<OpenerApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/preferences/src/desktop.d.ts

@@ -1,3 +1,3 @@
 import type { PreferencesApi } from "./index.ts";
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<PreferencesApi, {}>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<PreferencesApi, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/preferences/src/index.d.ts

@@ -17,7 +17,7 @@ export interface PreferencesApi {
     }>;
     clear(): Promise<void>;
 }
-export declare const preferences: import("../../../packages/core/src/plugin.ts").Plugin<PreferencesApi, {}>;
+export declare const preferences: import("../../../packages/core/src/plugin.ts").Plugin<PreferencesApi, Record<never, never>>;
 export type PreferenceSetter = (value: string | null) => Promise<void>;
 /**
  * Reads and writes one key. `ready` is false until the stored value has loaded.

package/types/vendor/@akanjs/native/plugins/preferences/src/web.d.ts

@@ -1,2 +1,2 @@
 import type { PreferencesApi } from "./index.ts";
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<PreferencesApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<PreferencesApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/secure-storage/src/desktop.d.ts

@@ -11,6 +11,6 @@ export declare function quoteForSecurity(text: string): string;
 export declare function encrypt(key: Buffer, name: string, value: string): string;
 /** null when the entry was written with another key, for another name, or is damaged. */
 export declare function decrypt(key: Buffer, name: string, blob: string): string | null;
-export declare function createDesktopSecureStorage(options?: DesktopSecureStorageOptions): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SecureStorageApi, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SecureStorageApi, {}>;
+export declare function createDesktopSecureStorage(options?: DesktopSecureStorageOptions): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SecureStorageApi, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SecureStorageApi, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/secure-storage/src/index.d.ts

@@ -36,4 +36,4 @@ export interface SecureStorageApi {
     /** Removes every key of this app. */
     clear(): Promise<void>;
 }
-export declare const secureStorage: import("../../../packages/core/src/plugin.ts").Plugin<SecureStorageApi, {}>;
+export declare const secureStorage: import("../../../packages/core/src/plugin.ts").Plugin<SecureStorageApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/share/src/index.d.ts

@@ -42,7 +42,7 @@ export interface ShareApi {
         value: boolean;
     }>;
 }
-export declare const share: import("../../../packages/core/src/plugin.ts").Plugin<ShareApi, {}>;
+export declare const share: import("../../../packages/core/src/plugin.ts").Plugin<ShareApi, Record<never, never>>;
 export interface UseShare {
     /** False where no share sheet exists (desktop Firefox, insecure origins): hide the share button. */
     supported: boolean;

package/types/vendor/@akanjs/native/plugins/share/src/web.d.ts

@@ -2,4 +2,4 @@ import type { ShareApi } from "./index.ts";
 export declare function webShareAvailable(): boolean;
 /** A file name for the share target: the URL's last path segment if it has an extension. */
 export declare function fileName(url: string, mime: string, index: number, base?: string): string;
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<ShareApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<ShareApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/single-instance/src/desktop.d.ts

@@ -3,6 +3,6 @@ export declare function createDesktopSingleInstance(options?: {
     path?: (appId: string) => string;
     args?: () => string[];
     cwd?: () => string;
-}): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<{}, SingleInstanceEvents>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<{}, SingleInstanceEvents>;
+}): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<Record<never, never>, SingleInstanceEvents>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<Record<never, never>, SingleInstanceEvents>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/splash-screen/src/index.d.ts

@@ -16,4 +16,4 @@ export interface SplashScreenApi {
         fadeOutDuration?: number;
     }): Promise<void>;
 }
-export declare const splashScreen: import("../../../packages/core/src/plugin.ts").Plugin<SplashScreenApi, {}>;
+export declare const splashScreen: import("../../../packages/core/src/plugin.ts").Plugin<SplashScreenApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/splash-screen/src/web.d.ts

@@ -1,4 +1,4 @@
 import type { SplashScreenApi } from "./index.ts";
 /** Browsers and the desktop WebView have no splash to hide. Arguments are still checked. */
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<SplashScreenApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<SplashScreenApi, Record<never, never>>;
 export declare function checkFade(value: unknown): void;

package/types/vendor/@akanjs/native/plugins/sqlite/src/desktop.d.ts

@@ -1,6 +1,6 @@
 import { type DesktopContext } from "../../../packages/desktop/src/plugin.ts";
 import type { SqliteSpec } from "./index.ts";
 /** `dir` is replaceable so tests can use a temporary folder. */
-export declare function createDesktopSqlite(dir?: (ctx: DesktopContext) => string): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SqliteSpec, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SqliteSpec, {}>;
+export declare function createDesktopSqlite(dir?: (ctx: DesktopContext) => string): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SqliteSpec, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<SqliteSpec, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/toast/src/index.d.ts

@@ -27,4 +27,4 @@ export interface ToastApi {
      */
     show(options: ToastShowOptions): Promise<void>;
 }
-export declare const toast: import("../../../packages/core/src/plugin.ts").Plugin<ToastApi, {}>;
+export declare const toast: import("../../../packages/core/src/plugin.ts").Plugin<ToastApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/toast/src/web.d.ts

@@ -1,2 +1,2 @@
 import type { ToastApi } from "./index.ts";
-export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<ToastApi, {}>;
+export declare const web: import("../../../packages/core/src/plugin.ts").WebPlugin<ToastApi, Record<never, never>>;

package/types/vendor/@akanjs/native/plugins/window/src/index.d.ts

@@ -226,9 +226,9 @@ export declare function useWindowState(): WindowState | null;
  * none prevents it, the window closes as usual. Desktop only: elsewhere it never fires
  * (`appWindow.eventImplementation("closeRequested")` tells). Returns an unregister function.
  */
-export declare const onCloseRequested: (handler: VetoHandler<{}>) => () => void;
+export declare const onCloseRequested: (handler: VetoHandler<Record<never, never>>) => () => void;
 /** onCloseRequested while mounted; always calls the latest handler. */
-export declare function useCloseRequested(handler: VetoHandler<{}>): void;
+export declare function useCloseRequested(handler: VetoHandler<Record<never, never>>): void;
 /** Files dragged over this window (desktop). Returns an unsubscribe function; never fires on web or mobile. */
 export declare function onDragDrop(handler: (event: DragDropEvent) => void): () => void;
 export {};

package/types/vendor/@akanjs/native/plugins/window-state/src/desktop.d.ts

@@ -2,6 +2,6 @@ import type { WindowStateApi } from "./index.ts";
 export declare const STATE_FILE = "window-state.json";
 export declare function createDesktopWindowState(options?: {
     delay?: number;
-}): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<WindowStateApi, {}>;
-declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<WindowStateApi, {}>;
+}): import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<WindowStateApi, Record<never, never>>;
+declare const _default: import("../../../packages/desktop/src/plugin.ts").DesktopPlugin<WindowStateApi, Record<never, never>>;
 export default _default;

package/types/vendor/@akanjs/native/plugins/window-state/src/index.d.ts

@@ -30,4 +30,4 @@ export interface WindowStateApi {
     /** Forgets the saved state: the next launch uses the configured size again. */
     clear(): Promise<void>;
 }
-export declare const windowState: import("../../../packages/core/src/plugin.ts").Plugin<WindowStateApi, {}>;
+export declare const windowState: import("../../../packages/core/src/plugin.ts").Plugin<WindowStateApi, Record<never, never>>;

package/types/vendor/use-agentic/Compaction.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage, TurnLimits } from "./types.d.ts";
+import type { ChatMessage, ToolCallResult, TurnLimits } from "./types.d.ts";
 export interface CompactOptions {
     /**
      * Estimated transcript tokens above which a turn summarizes its own history first — a ceiling on what each turn
@@ -50,6 +50,8 @@ export declare class Compaction {
      * more than the slack the estimate leaves.
      */
     static tokensOf(messages: readonly ChatMessage[]): number;
+    /** One tool result as it rides the wire, by the same rule. */
+    static resultTokensOf(result: ToolCallResult): number;
     /**
      * What the next request is estimated to cost, prompt and all: the provider's own count for the last turn that
      * reported one, plus four characters a token for what the transcript gained since. The provider's number is the

package/types/vendor/use-agentic/Reference.d.ts

@@ -31,10 +31,18 @@ export declare class Reference {
      *
      * The text is the source of truth for which references a message carries — deleting the token is how somebody
      * takes one back — so the token has to say everything the pointer does. The value is looked up beside it by key.
+     * A label's `\`, `[` and `]` are backslash-escaped, as in a markdown link: titles like "[Ops] Minutes" are common.
      */
     static token(reference: MessageReference): string;
-    /** Greedy on the label alone: a label may hold anything but `]`, and every other part is a name or an id. */
+    /**
+     * Greedy on the label alone: a label may hold an escaped `\\`, `\[` or `\]`, a backslash escaping nothing (a token
+     * written before labels were escaped), and anything else but `]` or an `@[`, where a token starts over. No two
+     * alternatives match at the same place, so a long run cannot backtrack. Every other part is a name, an id or a
+     * dotted path, none of which holds a bracket.
+     */
     static readonly pattern: RegExp;
+    /** The pointer one match of `pattern` names, its label unescaped. */
+    static pointerOf([, label, refName, refId, path]: RegExpMatchArray): MessageReference;
     /**
      * The pointers a draft names, in the order it names them. Pointers only — the value lives in `staged` and is
      * joined on by key, so reading the text can never resurrect a value somebody deleted the token for.

package/types/vendor/use-agentic/ToolOutput.d.ts

@@ -10,12 +10,17 @@ import type { ToolCallResult } from "./types.d.ts";
  *
  * Clipped rather than dropped, and the note says what happened: a model handed a value it cannot see the end of
  * asks a narrower question, where one handed nothing answers from the field names.
+ *
+ * A file the call attached is bounded apart: a picture is billed by its pixels, not by the length of its base64, so
+ * counting it as characters would clip every one. It meets the per-file ceiling a user's attachment meets instead.
  */
 export declare class ToolOutput {
     #private;
     /** Characters, ~5k tokens: comfortably above `ScreenReader.limit` and far below any provider's window. */
     static readonly limit = 20000;
-    /** Four characters per token, over the JSON the result rides as — the same estimate `Compaction` places. */
+    /** Bytes of one attached file, as `maxAttachmentBytes` bounds a user's: a provider refuses a turn past it. */
+    static readonly attachmentBytes: number;
+    /** The estimate `Compaction` places: four characters per token over the JSON, and a flat rate per picture. */
     static tokensOf(result: ToolCallResult): number;
     static clipped(result: ToolCallResult): ToolCallResult;
     /**

package/types/vendor/use-agentic/ToolReturn.d.ts

@@ -0,0 +1,18 @@
+import type { MessageAttachment } from "./types.d.ts";
+/**
+ * What a tool's `run` returns when its answer includes files beside the value: `ToolReturn.attach(result, files)`.
+ * `ToolRunner` lifts the files into `ToolCallResult.attachments`, which a backend hands the model as content.
+ */
+export declare class ToolReturn {
+    #private;
+    /** Interned, not an `instanceof`: one page can hold several bundled copies of this package. */
+    static readonly brand: unique symbol;
+    readonly result: unknown;
+    readonly attachments: MessageAttachment[];
+    constructor(result: unknown, attachments: MessageAttachment[]);
+    static attach(result: unknown, attachments: MessageAttachment[]): ToolReturn;
+    static split(value: unknown): {
+        result: unknown;
+        attachments: MessageAttachment[];
+    };
+}

package/types/vendor/use-agentic/Transcript.d.ts

@@ -10,9 +10,16 @@ import type { ChatMessage } from "./types.d.ts";
  * transcript is assembled rather than where each hole is made.
  */
 export declare class Transcript {
+    #private;
     static readonly unanswered = "The turn was stopped before this call ran.";
     /** What one turn posts: no host-only message, no unanswered call, no result answering a call nobody sees. */
     static wire(messages: readonly ChatMessage[]): ChatMessage[];
+    /**
+     * A file a tool returned before the user's latest message, as a note in its place. A picture costs a turn over a
+     * thousand tokens and would ride every turn after the one that asked for it; a later question about it calls the
+     * tool again, which is why the note says to — and to do it while the picture is on screen, where a tool can reach it.
+     */
+    static seen(messages: readonly ChatMessage[]): ChatMessage[];
     /** A message without the provider's count for its turn — what the wire carries and what a compaction keeps. */
     static unmeasured(message: ChatMessage): ChatMessage;
     static sanitize(messages: readonly ChatMessage[]): ChatMessage[];

package/types/vendor/use-agentic/index.d.ts

@@ -13,6 +13,7 @@ export * from "./Reference.d.ts";
 export * from "./sharedContext.d.ts";
 export * from "./surfaceContext.d.ts";
 export * from "./ToolOutput.d.ts";
+export * from "./ToolReturn.d.ts";
 export * from "./ToolRunner.d.ts";
 export * from "./Transcript.d.ts";
 export * from "./types.d.ts";

package/types/vendor/use-agentic/types.d.ts

@@ -144,6 +144,12 @@ export interface ToolCallResult {
     /** What the call changed on the surface — the whole report for a tool that returns nothing. */
     changes?: ResourceDiff[];
     error?: string;
+    /**
+     * Files the call handed the model — a picture it looked at — in the shape a user's attachment takes. A `result`
+     * cannot carry one: it reaches the model as JSON text, so a URL is read as letters and base64 as a wall of them.
+     * Outside the `ToolOutput` ceiling, and only the latest turn's ride the wire as bytes (`Transcript.wire`).
+     */
+    attachments?: MessageAttachment[];
 }
 /**
  * Why an assistant turn ended. `length` is the provider's own ceiling rather than the model's choice, so the turn

package/types/webkit/useDebounce.d.ts

@@ -1 +1 @@
-export declare const useDebounce: <Args extends unknown[], Return>(callback: (...args: Args) => Return, states?: unknown[], wait?: number) => (...args: Args) => void;
+export declare const useDebounce: <Args extends unknown[], Return>(callback: (...args: Args) => Return, _states?: unknown[], wait?: number) => (...args: Args) => void;

package/ui/Agent/Chat.tsx

@@ -533,6 +533,7 @@ export const DefaultChat = ({
         draft={draft}
         handleRef={handleRef}
         inputRef={inputRef}
+        isMenuOpen={!!list.at()}
         mentions={mentions ?? !!reference?.length}
         {...(speech.canListen ? { mic: { listening: speech.listening, onToggle: speech.toggle } } : {})}
         onDraft={write}

package/ui/Agent/Composer.tsx

@@ -39,6 +39,8 @@ export interface ComposerProps {
   inputRef?: RefObject<HTMLTextAreaElement | null>;
   /** Draws each `@` pointer as its name; set only when the chat has `reference` sources. */
   mentions?: boolean;
+  /** A `/` or `@` menu is up and `onKeyDown` picks from it: an override that takes Enter for a newline passes it on. */
+  isMenuOpen?: boolean;
   /** Filled by whichever input is drawn. An override that draws its own textarea leaves it null and `inputRef` answers. */
   handleRef?: RefObject<ComposerHandle | null>;
 }

package/ui/Agent/Menu.tsx

@@ -3,6 +3,8 @@ import { cn } from "akanjs/client";
 import { createOverridable } from "../UiOverride";
 
 export interface MenuRow {
+  /** Unique among the rows; `name` repeats when two records share a title. */
+  id: string;
   name: string;
   description?: string;
   /** The argument names a row takes. */
@@ -36,8 +38,10 @@ export const DefaultAgentMenu = ({ className, rows, selected, prefix = "/", onPi
             "flex items-baseline gap-2 px-4 py-1.5 text-left hover:bg-muted",
             idx === selected && "bg-muted",
           )}
-          key={row.name}
+          key={row.id}
           onClick={() => onPick(row)}
+          
+          onMouseDown={(event) => event.preventDefault()}
           role="option"
           type="button"
         >

package/ui/Agent/agentSessionOf.ts

@@ -14,6 +14,7 @@ import {
   type AgentSessionOptions,
   type ChatMessage,
   type CompactOptions,
+  type MessageAttachment,
   type SessionHistory,
   type SurfaceView,
   Transcript,
@@ -100,18 +101,24 @@ export const sessionView = (surface: AgenticSurface, path: string[], builtins?:
 const restoredValue =
   "the conversation was restored from storage, which keeps what the user pointed at but not the value it held";
 
+const pointerOf = ({ name, mimeType, url, ref }: MessageAttachment): MessageAttachment => ({
+  name,
+  mimeType,
+  ...(url ? { url } : {}),
+  ...(ref ? { ref } : {}),
+});
+
 const withoutContent = (message: ChatMessage): ChatMessage => {
-  if (!message.attachments?.length && !message.references?.length) return message;
+  const toolFiles = message.toolResults?.some((result) => result.attachments?.length);
+  if (!message.attachments?.length && !message.references?.length && !toolFiles) return message;
   return {
     ...message,
-    ...(message.attachments?.length
+    ...(message.attachments?.length ? { attachments: message.attachments.map(pointerOf) } : {}),
+    ...(toolFiles
       ? {
-          attachments: message.attachments.map(({ name, mimeType, url, ref }) => ({
-            name,
-            mimeType,
-            ...(url ? { url } : {}),
-            ...(ref ? { ref } : {}),
-          })),
+          toolResults: message.toolResults?.map((result) =>
+            result.attachments?.length ? { ...result, attachments: result.attachments.map(pointerOf) } : result,
+          ),
         }
       : {}),
     ...(message.references?.length

package/ui/Agent/mentionDraft.ts

@@ -32,10 +32,9 @@ export class MentionDraft {
     
     const pattern = new RegExp(Reference.pattern.source, "g");
     for (let match = pattern.exec(text); match; match = pattern.exec(text)) {
-      const [token, label, refName, refId, path] = match;
       if (match.index > at) nodes.push(...MentionDraft.#plain(text.slice(at, match.index)));
-      nodes.push($createMentionNode({ refName, refId, label, ...(path ? { path } : {}) }));
-      at = match.index + token.length;
+      nodes.push($createMentionNode(Reference.pointerOf(match)));
+      at = match.index + match[0].length;
     }
     if (at < text.length) nodes.push(...MentionDraft.#plain(text.slice(at)));
     return nodes;

package/ui/Agent/useReferenceMenu.ts

@@ -68,6 +68,7 @@ export const useReferenceMenu = ({ draft, sources, session, l, onWrite }: Refere
         setRows(
           found.flatMap((candidates, at) =>
             candidates.map((candidate) => ({
+              id: `${current[at].refName}/${candidate.refId}`,
               name: candidate.label,
               description: candidate.description ?? current[at].label,
               pick: () => write(candidate, current[at]),

package/ui/Agent/useSlashMenu.ts

@@ -19,6 +19,7 @@ export const useSlashMenu = ({ draft, l, onCommand }: SlashMenuSetup) => {
     ? ChatCommands.list(l)
         .filter((command) => `/${command.name}`.startsWith(query))
         .map((command) => ({
+          id: command.name,
           name: command.name,
           description: command.description,
           pick: () => onCommand(command),

package/ui/Clipboard.tsx

@@ -26,6 +26,7 @@ export const Clipboard = ({ text, className }: ClipboardProps): ReactElement =>
   };
   return (
     <button
+      type="button"
       onClick={async () => {
         await handleCopy();
       }}

package/ui/CsrImage.tsx

@@ -13,6 +13,8 @@ type CsrImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> &
   quality?: number;
   unoptimized?: boolean;
   fill?: boolean;
+  placeholder?: string;
+  blurDataURL?: string;
 };
 
 const EMPTY_IMAGE = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7";
@@ -24,7 +26,7 @@ export const CsrImage = ({ src, alt, file, className, abstractData, ...props }:
   const defaultAbstractData =
     "data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAFklEQVR42mN8//HLfwYiAOOoQvoqBABbWyZJf74GZgAAAABJRU5ErkJggg==";
   const blurDataURL = abstractData ?? file?.abstractData ?? defaultAbstractData;
-  const { priority, preload, quality, unoptimized, fill, ...csrProps } = props;
+  const { priority, preload, quality, unoptimized, fill, placeholder, blurDataURL: _blurDataURL, ...csrProps } = props;
   return (
     <img
       src={url ?? EMPTY_IMAGE}

package/ui/Data/CardList.tsx

@@ -14,7 +14,7 @@ import DataPagination from "./Pagination";
 
 const gridClassName = "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4";
 
-type DataItemProps<T extends string, M extends { id: string }, L extends { id: string }> = {
+type DataItemProps<T extends string, _M extends { id: string }, L extends { id: string }> = {
   [key in T]: L;
 } & { slice: SliceMeta };
 

package/ui/Data/Dashboard.tsx

@@ -7,7 +7,7 @@ import { useState } from "react";
 
 import { dictLabel, formatStat } from "./dataText";
 
-export interface DashboardProps<T extends string, State> {
+export interface DashboardProps<_T extends string, _State> {
   className?: string;
   summary: Record<string, unknown>;
   /** The listing these tiles belong to. Kept so a caller names its target; the labels are app-level keys. */

package/ui/Data/Insight.tsx

@@ -4,7 +4,7 @@ import type { SliceMeta } from "akanjs/fetch";
 
 import { dictLabel, formatStat } from "./dataText";
 
-interface InsightProps<T extends string, Insight> {
+interface InsightProps<_T extends string, Insight> {
   className?: string;
   insight: Insight;
   slice: SliceMeta;

package/ui/Data/Item.tsx

@@ -68,7 +68,7 @@ export const convToAntdColumn = (column: DataColumn<any>) => {
   else return { key: column, dataIndex: column, title: capitalize(column), render: renderCell };
 };
 
-interface ItemProps<T extends string, Full extends { id: string }, Light extends { id: string }> {
+interface ItemProps<_T extends string, _Full extends { id: string }, Light extends { id: string }> {
   className?: string;
   model: Light;
   slice: SliceMeta;
@@ -166,7 +166,7 @@ export default function Item<T extends string, Full extends { id: string }, Ligh
   );
 }
 
-interface ActionProps<T extends string, M extends { id: string }, L extends { id: string }> {
+interface ActionProps<_T extends string, _M extends { id: string }, L extends { id: string }> {
   action: DataAction;
   model: L;
   slice: SliceMeta;
@@ -194,6 +194,7 @@ export const Action = <T extends string, M extends { id: string }, L extends { i
   };
   return action === "edit" ? (
     <button
+      type="button"
       className={buttonRecipe({ variant: outline ? "outline" : "ghost", size: "icon" }, [
         "m-1 size-8 text-center",
         outline && "border-dashed",
@@ -204,6 +205,7 @@ export const Action = <T extends string, M extends { id: string }, L extends { i
     </button>
   ) : action === "view" ? (
     <button
+      type="button"
       className={buttonRecipe({ variant: outline ? "outline" : "ghost", size: "icon" }, [
         "m-1 size-8 text-center",
         outline && "border-dashed",
@@ -219,6 +221,7 @@ export const Action = <T extends string, M extends { id: string }, L extends { i
       onConfirm={() => void storeDo[namesOfSlice.removeModel](model.id)}
     >
       <button
+        type="button"
         className={buttonRecipe({ variant: outline ? "outline" : "ghost", size: "icon" }, [
           "m-1 size-8 text-center",
           outline && "border-dashed",

package/ui/Data/ListContainer.tsx

@@ -44,8 +44,8 @@ const pageLimits = [10, 20, 50, 100];
 const menuItemClassName = "flex w-full flex-nowrap justify-start gap-2";
 
 export interface ListContainerProps<
-  T extends string,
-  State,
+  _T extends string,
+  _State,
   Input,
   Full extends { id: string },
   Light extends { id: string },

package/ui/Data/Pagination.tsx

@@ -8,7 +8,7 @@ import { usePageTool } from "akanjs/webkit";
 import { Pagination as Pagn } from "../Pagination";
 import { sliceNamesOf } from "../sliceNamesOf";
 
-interface PaginationProps<T extends string> {
+interface PaginationProps<_T extends string> {
   className?: string;
   slice: SliceMeta;
 }

package/ui/Data/TableList.tsx

@@ -16,7 +16,7 @@ import { Action, convToAntdColumn } from "./Item";
 import DataPagination from "./Pagination";
 
 interface TableListProps<
-  T extends string,
+  _T extends string,
   Input,
   Full extends { id: string },
   Light extends { id: string },

package/ui/DraggableList.tsx

@@ -183,6 +183,7 @@ const Item = ({
       {children}
       {removable && (
         <button
+          type="button"
           className={recipe({ variant: "outline", size: "xs" }, [
             "size-6 border-destructive p-0 text-destructive hover:bg-destructive hover:text-destructive-foreground",
             removeClassName,