@tangle-network/agent-app 0.45.33 → 0.45.35

package/dist/agent-session-controls-1q1XR3j8.d.ts

@@ -0,0 +1,257 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { F as FileMention } from './wire-DOZ-O6hD.js';
+import { Harness } from './harness/index.js';
+import { CatalogModel } from './catalog/index.js';
+
+/**
+ * `useFileMentions` — the glue a host passes straight into `AgentComposer`'s
+ * `mention` prop (`@tangle-network/sandbox-ui#184`) to wire up `@`-file
+ * mentions against `createSandboxFileIndexRoute` (`/chat-routes`).
+ *
+ * Fetches the index once per session from `indexUrl`, refreshes it in the
+ * background whenever the popover opens (a `fetchItems` call) if the cached
+ * copy has aged past `refreshAfterMs`, and answers every keystroke from an
+ * in-memory fuzzy filter — no per-keystroke network round trip. The returned
+ * `refresh()` lets a caller force a re-fetch immediately instead of waiting
+ * on `refreshAfterMs` — e.g. right after the agent creates a file mid-session.
+ *
+ * `MentionItem`/the `mention` prop shape mirror the FROZEN contract from
+ * sandbox-ui#184 structurally (no import: `/web-react` stays dependency-free
+ * beyond React, and `@tangle-network/sandbox-ui` is an optional peer).
+ */
+
+/** Mirrors sandbox-ui#184's `MentionItem` — the atomic pill's payload. For a
+ *  file mention, `id` is the workspace-relative path (the pill's stable
+ *  identity and the `@<id>` serialization sandbox-ui uses to round-trip
+ *  `value`), `label` is the display name, and `detail` carries the full path
+ *  for the popover row's secondary line. */
+interface MentionItem {
+    id: string;
+    label: string;
+    detail?: string;
+    kind?: string;
+}
+/** Mirrors sandbox-ui#184's `AgentComposerProps['mention']` shape — plug the
+ *  hook's `mention` return value straight into that prop. */
+interface ComposerMentionProp {
+    trigger?: string;
+    fetchItems(query: string): Promise<MentionItem[]>;
+    onMentionsChange?(mentions: MentionItem[]): void;
+    renderItem?(item: MentionItem): ReactNode;
+    emptyText?: string;
+}
+/**
+ * Ranks `files` against `query` (case-insensitive), capped to `limit`:
+ * name-prefix matches first, then name-substring, then path-substring.
+ * Within a tier, shorter names sort first (the more specific match), then
+ * alphabetically by path for a stable order. An empty query returns the
+ * first `limit` entries unranked — the popover's default list before typing.
+ * Pure and dependency-free (no fuzzy-match library) so it's cheap enough to
+ * re-run on every keystroke against a 10k-entry index.
+ */
+declare function rankFileMentions(files: readonly FileMention[], query: string, limit: number): FileMention[];
+/** Max popover results per query — enough to show a useful spread of matches
+ *  without pushing the fuzzy-filtered list past what a popover can usefully
+ *  render in one screen. */
+declare const DEFAULT_MENTION_LIMIT = 20;
+/** How long a `ready` index is served before a background refetch — long
+ *  enough that a full session's worth of popover opens don't repeatedly hit
+ *  the index endpoint, short enough that a stale listing doesn't linger too
+ *  far past workspace file changes. Callers who need the index current right
+ *  now (e.g. just after the agent creates a file) call `refresh()` instead of
+ *  waiting on this window. */
+declare const INDEX_REFRESH_AFTER_MS: number;
+/** Popover empty-state copy for a `ready` index whose query matched nothing.
+ *  Loading/warming/error states have their own copy — see `emptyTextFor`. */
+declare const DEFAULT_MENTION_EMPTY_TEXT = "No matching files";
+/** Define options for configuring file mention fetching, caching, and display behavior */
+interface UseFileMentionsOptions {
+    /** GET endpoint returning `FileIndexResponse` (a `createSandboxFileIndexRoute`). */
+    indexUrl: string;
+    /** Max popover results per query. Default {@link DEFAULT_MENTION_LIMIT}. */
+    limit?: number;
+    /** How long a `ready` index is served without a background refetch.
+     *  Default {@link INDEX_REFRESH_AFTER_MS}. */
+    refreshAfterMs?: number;
+    /** `fetch` override for tests / non-global-fetch hosts. Default `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Text shown in the popover's empty state once the index is loaded and
+     *  the query matched nothing. Default {@link DEFAULT_MENTION_EMPTY_TEXT}. */
+    emptyText?: string;
+}
+/** Provide properties and methods to manage and refresh file mentions in a composer interface */
+interface UseFileMentionsResult {
+    /** Spread straight into `AgentComposer`'s `mention` prop. */
+    mention: ComposerMentionProp;
+    /** The files currently referenced by mentions in the composer's value —
+     *  the send-body list (map through `fileMentionsToParts`). */
+    mentions: FileMention[];
+    /** Drop all currently-referenced mentions (e.g. after a successful send). */
+    clearMentions: () => void;
+    /** Force a re-fetch of the index right now, ignoring `refreshAfterMs` — for
+     *  example right after the agent creates a file mid-session, so the next
+     *  popover open sees it. Dedupes against an already-in-flight load rather
+     *  than firing a second request. */
+    refresh: () => Promise<void>;
+}
+/** Resolve and manage file mention data with configurable fetching and state handling */
+declare function useFileMentions(options: UseFileMentionsOptions): UseFileMentionsResult;
+
+/**
+ * Keyboard + pointer model for a trigger-and-popover pair, dependency-free.
+ * Outside-mousedown and Escape both close; Escape also returns focus to the
+ * trigger so keyboard users aren't dropped at the top of the document. The
+ * returned `triggerProps` carry the ARIA contract (`aria-haspopup`/
+ * `aria-expanded`); spread them onto the trigger button.
+ */
+declare function usePopover(open: boolean, setOpen: (open: boolean) => void): {
+    containerRef: react.RefObject<HTMLDivElement | null>;
+    triggerRef: react.RefObject<HTMLButtonElement | null>;
+    triggerProps: {
+        ref: react.RefObject<HTMLButtonElement | null>;
+        'aria-haspopup': true;
+        'aria-expanded': boolean;
+    };
+};
+/**
+ * The one overlay elevation for floating surfaces — picker menus, popovers,
+ * drawers, modals. The theme's `shadow-overlay` utility is landing with the
+ * token work; until it does, this is the composer's raised-card literal kept
+ * in a single place so every overlay paints the same shadow and the later
+ * token swap is a one-line edit (`shadow-overlay` here, `shadow-raised` on
+ * the composer card).
+ * TODO(theme): swap to `shadow-overlay` once the preset ships it.
+ */
+declare const OVERLAY_SHADOW = "shadow-[0_1px_2px_hsl(var(--foreground)/0.05),0_12px_28px_hsl(var(--foreground)/0.07)] dark:shadow-[0_1px_2px_hsl(var(--foreground)/0.14),0_12px_28px_hsl(var(--foreground)/0.22)]";
+/**
+ * Guard an async action against double-submit. `run` ignores re-entrant calls
+ * while a promise is in flight and flips `pending` so the caller can disable
+ * the control — the fix for double-charge / double-approve on a slow network.
+ * Settles (success or throw) before clearing, and no-ops state updates after
+ * unmount.
+ */
+declare function usePending(): {
+    pending: boolean;
+    run: (action: () => void | Promise<void>) => void;
+};
+interface ModelPickerProps {
+    value: string;
+    onChange: (id: string) => void;
+    /** Catalogue models — from `GET`ing the app's catalogue route (see
+     *  `runtime/model-catalog`), plus any product-specific entries appended. */
+    models: CatalogModel[];
+    loading?: boolean;
+    /** Render a provider logo/badge; default is a generic sparkle. */
+    renderProviderBadge?: (provider: string) => ReactNode;
+    /** Section label for `featured` models. */
+    recommendedLabel?: string;
+    /** Pin a labeled section to the TOP of the list (above Recommended) for the
+     *  models a product wants surfaced first — e.g. a tuner app's own fine-tuned
+     *  models (`{ label: 'Your Fine-Tuned Models', match: (m) => m.provider === 'tuner' }`).
+     *  Matching models are shown only in this section, not duplicated below. */
+    priorityGroup?: {
+        label: string;
+        match: (model: CatalogModel) => boolean;
+    };
+}
+/**
+ * Searchable model picker pill + popover: a featured/recommended section
+ * first, then per-provider groups in catalogue order (the server already
+ * sorts providers by tier).
+ *
+ * This is the CANONICAL ecosystem model picker (see "UI chrome ownership
+ * (picker canon)" in AGENTS.md). sandbox-ui's `dashboard/ModelPicker` is
+ * legacy — deprecated, frozen, removed at sandbox-ui's next major; new code
+ * belongs here.
+ */
+declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel, priorityGroup }: ModelPickerProps): react.JSX.Element;
+/** One reasoning-budget level: the engine `id` is unchanged (the value the
+ *  product sends to the loop); only the user-facing `label` is renamed to the
+ *  plainer "how hard should it think" vocabulary from docs/product-surfaces.md.
+ *  `low`→Quick, `medium`→Standard, `high`→Extended. The mapping is overridable
+ *  via `EffortPickerProps.levels`, so a product can relabel without losing the
+ *  ids the runtime expects. */
+interface EffortLevel {
+    id: string;
+    label: string;
+}
+declare const DEFAULT_EFFORT_LEVELS: readonly EffortLevel[];
+/** Segments the meter draws — fixed geometry so the ladder stays tabular
+ *  across levels (and across the trigger and its menu rows). */
+declare const EFFORT_METER_SEGMENTS = 4;
+/**
+ * Filled-segment count for a level: 0 for off/none (or an id the levels list
+ * does not carry); otherwise the level's position among the non-off choices
+ * scaled onto the meter, so the ladder reads low < medium < high and the top
+ * level fills the whole scale. The canonical four levels land 0 / 1 / 2 / 4.
+ */
+declare function effortMeterFill(levelId: string, levels?: readonly EffortLevel[]): number;
+/**
+ * The thinking-strength meter: four 12px bars, filled count = level, filled
+ * opacity ramping 25→100% left to right (unfilled at a faint ghost). Purely
+ * decorative — the level name is always rendered as text beside it, so the
+ * meter is `aria-hidden` and adds no second accessible name.
+ */
+declare function EffortMeter({ fill, className }: {
+    fill: number;
+    className?: string;
+}): react.JSX.Element;
+interface EffortPickerProps {
+    value: string;
+    onChange: (id: string) => void;
+    /** Selectable levels (engine id + user-facing label). Defaults to the plain
+     *  "Thinking" vocabulary; override to relabel without changing the ids the
+     *  runtime receives. */
+    levels?: readonly EffortLevel[];
+    /** Prefix shown before the active level on the pill — the "what is this"
+     *  context the bare value lacked. Default "Thinking". Pass '' to hide it. */
+    label?: string;
+}
+/** Thinking-budget selector pill, styled to match {@link ModelPicker}. Show
+ *  it only when the selected model `supportsReasoning`. "Thinking" is the
+ *  plain-English name for what was internally called "effort".
+ *
+ *  The CANONICAL ecosystem effort picker — sandbox-ui's reasoning menu (inside
+ *  its `chat/AgentSessionControls`) is legacy and frozen. */
+declare function EffortPicker({ value, onChange, levels, label }: EffortPickerProps): react.JSX.Element;
+
+interface AgentSessionControlsProps {
+    /** Catalog models — canonical provider-prefixed ids. */
+    models: CatalogModel[];
+    modelsLoading?: boolean;
+    /** Selected canonical model id. */
+    model: string;
+    onModelChange(modelId: string): void;
+    /** Current harness; harness↔model coherence is enforced on every change. */
+    harness: Harness;
+    onHarnessChange(harness: Harness): void;
+    /** Harnesses to offer; defaults to the labeled set. */
+    availableHarnesses?: ReadonlyArray<Harness>;
+    /** Reasoning-effort value + setter. Shown only when the selected model
+     *  `supportsReasoning`, matching `EffortPicker`'s guidance. */
+    effort: string;
+    onEffortChange(effort: string): void;
+    /**
+     * Levels to offer, forwarded verbatim to {@link EffortPicker}. Omit for the
+     * default vocabulary.
+     *
+     * A product whose backend applies only a SUBSET of the levels for the
+     * selected harness/model passes that subset here. Without it the strip
+     * offers every level and the backend silently ignores the ones it does not
+     * apply — a control that reports a choice the system never made.
+     */
+    effortLevels?: readonly EffortLevel[];
+    /**
+     * `inline` (default): model, harness, effort side by side — the prior
+     * behavior. `compact`: model inline, harness + effort behind a gear popover.
+     */
+    layout?: 'inline' | 'compact';
+    /** Hide the harness control entirely (single-harness products). */
+    showHarness?: boolean;
+    renderProviderBadge?: (provider: string) => ReactNode;
+    className?: string;
+}
+declare function AgentSessionControls(props: AgentSessionControlsProps): react.JSX.Element;
+
+export { type AgentSessionControlsProps as A, type ComposerMentionProp as C, DEFAULT_EFFORT_LEVELS as D, EFFORT_METER_SEGMENTS as E, INDEX_REFRESH_AFTER_MS as I, type MentionItem as M, OVERLAY_SHADOW as O, type UseFileMentionsResult as U, AgentSessionControls as a, DEFAULT_MENTION_EMPTY_TEXT as b, DEFAULT_MENTION_LIMIT as c, type EffortLevel as d, EffortMeter as e, EffortPicker as f, type EffortPickerProps as g, ModelPicker as h, type ModelPickerProps as i, type UseFileMentionsOptions as j, effortMeterFill as k, usePending as l, usePopover as m, rankFileMentions as r, useFileMentions as u };

package/dist/assistant/index.d.ts

@@ -7,7 +7,7 @@ import '../plans/index.js';
 import '../parts-BqIHMdyu.js';
 import '../types-CCeYywdS.js';
 import '../wire-DOZ-O6hD.js';
-import '../agent-session-controls-BwImzYKC.js';
+import '../agent-session-controls-1q1XR3j8.js';
 import '../harness/index.js';
 import '../catalog/index.js';
 import '../agent-activity-C8ZG0F0M.js';

package/dist/assistant/index.js

@@ -1,7 +1,7 @@
 import {
   ChatComposer,
   ChatMessages
-} from "../chunk-XHD4Y54K.js";
+} from "../chunk-AIHKKLKY.js";
 import "../chunk-FBVLEGEG.js";
 import "../chunk-5MZXWPFN.js";
 import "../chunk-GEYACSFW.js";
@@ -9,7 +9,7 @@ import {
   ModelPicker,
   OVERLAY_SHADOW,
   ProviderLogo
-} from "../chunk-SFSR3CAH.js";
+} from "../chunk-MIZMWCKW.js";
 import "../chunk-BATKJP3P.js";
 import {
   AsyncView

package/dist/chat-react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { AgentComposer } from '@tangle-network/sandbox-ui/chat';
-import { A as AgentSessionControlsProps, U as UseFileMentionsResult } from '../agent-session-controls-BwImzYKC.js';
+import { A as AgentSessionControlsProps, U as UseFileMentionsResult } from '../agent-session-controls-1q1XR3j8.js';
 import { b as ChatAttachmentInput, F as FileMention } from '../wire-DOZ-O6hD.js';
 import '../harness/index.js';
 import '@tangle-network/agent-interface';

package/dist/chat-react/index.js

@@ -1,7 +1,7 @@
 import {
   AgentSessionControls,
   useComposerAttachments
-} from "../chunk-SFSR3CAH.js";
+} from "../chunk-MIZMWCKW.js";
 import {
   ATTACHMENT_ACCEPT
 } from "../chunk-CCVG2TL6.js";

package/dist/{chunk-XHD4Y54K.js → chunk-AIHKKLKY.js}

@@ -10,7 +10,7 @@ import {
   OVERLAY_SHADOW,
   POPOVER_OPTION_FOCUS,
   usePending
-} from "./chunk-SFSR3CAH.js";
+} from "./chunk-MIZMWCKW.js";
 import {
   UNTITLED_SESSION_LABEL,
   mergeSessionPages,
@@ -5983,4 +5983,4 @@ export {
   useThinkingSeconds,
   ChatMessages
 };
-//# sourceMappingURL=chunk-XHD4Y54K.js.map
+//# sourceMappingURL=chunk-AIHKKLKY.js.map

package/dist/{chunk-SFSR3CAH.js → chunk-MIZMWCKW.js}

@@ -824,6 +824,7 @@ function AgentSessionControls(props) {
     availableHarnesses,
     effort,
     onEffortChange,
+    effortLevels,
     layout = "inline",
     showHarness = true,
     renderProviderBadge,
@@ -848,7 +849,7 @@ function AgentSessionControls(props) {
     return /* @__PURE__ */ jsxs4("div", { className: `flex items-center gap-1.5 ${className ?? ""}`, children: [
       modelPicker,
       showHarness && /* @__PURE__ */ jsx4(HarnessPicker, { value: harness, onChange: onHarness, available: availableHarnesses }),
-      showEffort && /* @__PURE__ */ jsx4(EffortPicker, { value: effort, onChange: onEffortChange })
+      showEffort && /* @__PURE__ */ jsx4(EffortPicker, { value: effort, onChange: onEffortChange, levels: effortLevels })
     ] });
   }
   const hasAdvanced = showHarness || showEffort;
@@ -875,7 +876,7 @@ function AgentSessionControls(props) {
         ] }),
         showEffort && /* @__PURE__ */ jsxs4("div", { className: "space-y-1.5", children: [
           /* @__PURE__ */ jsx4("p", { className: "text-xs font-medium text-foreground", children: "Thinking" }),
-          /* @__PURE__ */ jsx4(EffortPicker, { value: effort, onChange: onEffortChange, label: "" }),
+          /* @__PURE__ */ jsx4(EffortPicker, { value: effort, onChange: onEffortChange, levels: effortLevels, label: "" }),
           /* @__PURE__ */ jsx4("p", { className: "text-[11px] leading-snug text-muted-foreground", children: "How hard the agent thinks before answering. Higher is slower but more thorough." })
         ] })
       ] })
@@ -900,4 +901,4 @@ export {
   HarnessGlyph,
   AgentSessionControls
 };
-//# sourceMappingURL=chunk-SFSR3CAH.js.map
+//# sourceMappingURL=chunk-MIZMWCKW.js.map