@tangle-network/agent-app 0.44.28 → 0.44.30

package/dist/{attachment-validation-Dvc_Livy.d.ts → attachment-validation-CNkH91Gs.d.ts}

@@ -1,4 +1,4 @@
-import { M as FileMention } from './parts-fyPPdDdK.js';
+import { F as FileMention } from './wire-DSp4LzEE.js';
 
 /**
  * `createSandboxFileIndexRoute` — server side of `@`-file-mentions

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

@@ -0,0 +1,192 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { ModelInfo, HarnessType } from '@tangle-network/sandbox-ui/dashboard';
+export { HarnessType } from '@tangle-network/sandbox-ui/dashboard';
+import { ReasoningLevel, AgentComposer } from '@tangle-network/sandbox-ui/chat';
+export { ReasoningLevel } from '@tangle-network/sandbox-ui/chat';
+import { ReasoningEffort } from '@tangle-network/agent-interface';
+export { ReasoningEffort } from '@tangle-network/agent-interface';
+import { U as UseFileMentionsResult } from '../use-file-mentions-E6a7_cbH.js';
+import { b as ChatAttachmentInput, F as FileMention } from '../wire-DSp4LzEE.js';
+
+/**
+ * The model half of the composer's agent identity. `models` is the catalog the
+ * picker renders; `value` may be a bare or a canonical (provider-prefixed) id —
+ * the adapter maps it to canonical form for the picker and hands the canonical
+ * id back to `onChange`, so a product that stores bare ids only has to accept
+ * canonical ones in its setter.
+ */
+interface ComposerModelSelection {
+    value: string;
+    onChange: (next: string) => void;
+    models: ModelInfo[];
+    loading?: boolean;
+    disabled?: boolean;
+}
+interface ComposerHarnessSelection {
+    value: HarnessType;
+    onChange: (next: HarnessType) => void;
+    /** Restrict the offered backends. Omit to take the context default. */
+    available?: ReadonlyArray<HarnessType>;
+    disabled?: boolean;
+    /**
+     * A thread's sidecar session is pinned to one harness at its first message,
+     * so once the thread has messages the picker locks. With `onNewChat` the
+     * locked chip becomes the informative lock (explains the binding + a button
+     * to start a fresh session on another backend).
+     */
+    locked?: boolean;
+    lockReason?: string;
+    onNewChat?: () => void;
+}
+interface ComposerEffortSelection {
+    value: ReasoningLevel;
+    onChange: (next: ReasoningLevel) => void;
+    /**
+     * Depths this product's backend actually applies. Omit for the default set.
+     * `auto` is NOT a member: the picker adds that sentinel itself, so listing it
+     * here would offer it twice.
+     */
+    available?: ReadonlyArray<ReasoningEffort>;
+    disabled?: boolean;
+}
+interface ComposerAgentControlsProps {
+    model: ComposerModelSelection;
+    /** Omit on a router-backed composer: a direct model call has no CLI backend,
+     *  so the picker would be inert. Model + effort still render. */
+    harness?: ComposerHarnessSelection;
+    effort?: ComposerEffortSelection;
+    className?: string;
+    /**
+     * Which surface the controls live on. `'chat'` (the default) drops the
+     * shell-only `cli-base` backend — it has no conversational agent — and tells
+     * the shared control to use its chat-only default set. `'all'` keeps every
+     * backend for non-chat / scheduled surfaces.
+     */
+    context?: 'chat' | 'all';
+    /**
+     * Trigger layout. `'combined'` (the default) collapses the pickers behind one
+     * labeled trigger reading the current selection (`harness · model · effort`).
+     * `'gear'` uses an anonymous gear icon instead of the label; `'inline'` lays
+     * the pickers out in a row.
+     */
+    layout?: 'inline' | 'gear' | 'combined';
+    /**
+     * Where the pickers open. `'down'` pins them downward for a composer floating
+     * in open space (the centered entry surface) so a tall menu can't flip up over
+     * the heading. Defaults to `'auto'` (collision-aware).
+     */
+    menuPlacement?: 'auto' | 'down';
+    /**
+     * Restrict the model catalog to what the selected harness can run instead of
+     * letting an incompatible model snap the harness. ON by default: a workspace
+     * harness is sandbox-bound, and a silent swap tears down and recreates the
+     * sandbox. Turn OFF only on a model-first surface with no bound sandbox.
+     */
+    filterModelsToHarness?: boolean;
+}
+/**
+ * The composer's agent-identity control: harness (agent backend), model, and
+ * reasoning effort, over sandbox-ui's `AgentSessionControls`.
+ *
+ * This is an ADAPTER, not a second implementation. sandbox-ui owns the control
+ * and the harness↔model coherence policy (the catalog is filtered to the
+ * selected harness, the effort re-clamps to what the harness/model pair
+ * supports, and a harness that ignores a picker is marked with its dead control
+ * disabled). What lives here is the app-shell wiring every product otherwise
+ * re-derives:
+ *
+ *  - MODEL-ID BOUNDARY. Products store bare ids (what a chat send body expects)
+ *    while the picker matches on canonical provider-prefixed ids. The canonical
+ *    form goes in; the canonical id comes back out to `onChange`.
+ *  - HARNESS-SNAP SUPPRESSION. The shared control snaps the model whenever the
+ *    harness changes, calling the model `onChange` synchronously with a default
+ *    compatible model. A product that remembers a per-harness pick must ignore
+ *    that snap, or it both discards the remembered pick and persists it under
+ *    the wrong harness's key. The guard is armed for exactly the synchronous
+ *    window of a harness change and disarmed on the next microtask, so it can
+ *    never stay stuck — a later genuine pick is never swallowed, even when the
+ *    harness change was a no-op.
+ *  - CHAT-CONTEXT TRIM. `cli-base` never reaches a conversational surface.
+ *
+ * Behavioral modes (a plan toggle) are NOT agent identity and do not belong
+ * here — they dock on the other side of the composer via `controls`.
+ */
+declare function ComposerAgentControls({ model, harness, effort, className, context, layout, menuPlacement, filterModelsToHarness, }: ComposerAgentControlsProps): react.JSX.Element;
+
+interface EntryComposerProps {
+    /** The one line above the input. Domain copy — always a product parameter. */
+    heading?: ReactNode;
+    /** Optional supporting line under the heading. */
+    subheading?: ReactNode;
+    placeholder?: string;
+    initialValue?: string;
+    sendLabel?: string;
+    disabled?: boolean;
+    /**
+     * Agent identity (harness/model/effort). Pass it and the control row renders;
+     * omit it and the composer ships without one. Omitting is a real choice for a
+     * surface with nothing to choose — it should never be an oversight, which is
+     * why this is one prop rather than a free-form slot a caller can forget.
+     */
+    agent?: ComposerAgentControlsProps;
+    /**
+     * Behavioral modes docked on the LEFT (a plan-approval toggle). A mode is an
+     * on/off switch, not a value picker, so it sits apart from agent identity.
+     */
+    modes?: ReactNode;
+    /**
+     * Upload endpoint for staged attachments. Omit and the attach affordance is
+     * hidden — a composer with no place to put a file must not offer one.
+     */
+    uploadUrl?: string;
+    accept?: string;
+    onAttachmentError?: (reason: string) => void;
+    onRejectFiles?: Parameters<typeof AgentComposer>[0]['onRejectFiles'];
+    /**
+     * `@`-file mentions. The hook itself is shared (`useFileMentions`), but the
+     * cold-box policy around it — whether pressing `@` is worth starting a
+     * sandbox — is a per-surface product call, so the result is injected rather
+     * than created here.
+     */
+    mentions?: UseFileMentionsResult;
+    mentionPopoverClassName?: string;
+    /** Rendered under the composer: suggestion pills, an onboarding nudge, a
+     *  disclaimer. All domain copy. */
+    footer?: ReactNode;
+    /** Block submit until a persisted selection has resolved against the catalog,
+     *  so the first turn cannot go out under the wrong model. Defaults to true. */
+    ready?: boolean;
+    onSubmit: (prompt: string, attachments: ChatAttachmentInput[], mentions: FileMention[]) => void;
+    className?: string;
+    composerClassName?: string;
+    /** Max width of the centered column. Defaults to the fleet's 820px. */
+    maxWidth?: number;
+}
+/**
+ * `EntryComposer` — the centered "what do you want to work on?" surface a
+ * product shows before a conversation exists (a new thread, an empty session,
+ * a workspace overview).
+ *
+ * It exists because three products each grew their own, and they drifted into
+ * three different capability sets rather than three different looks: one lost
+ * the attach button, one lost the model and effort pickers entirely, one
+ * hand-rolled a `<textarea>` and wired pickers from three separate packages
+ * into one row. The composer, the pickers, the attachment queue and the mention
+ * index were all ALREADY shared — what was not shared was the assembly, so
+ * every product re-derived which controls an entry surface gets, and each
+ * re-derivation dropped a different one.
+ *
+ * Mechanism lives here: layout, the attachment queue, the mention wiring, the
+ * submit gate (nothing sends while an upload is pending or failed, or before
+ * the model selection has resolved). Domain stays a parameter: `heading`,
+ * `placeholder`, `footer` (suggestion pills, disclaimers) and the selections
+ * themselves.
+ *
+ * The docked in-thread composer is NOT this component — it renders
+ * `AgentComposer` directly with the same {@link ComposerAgentControls}, because
+ * a docked composer has a transcript above it and no hero layout.
+ */
+declare function EntryComposer({ heading, subheading, placeholder, initialValue, sendLabel, disabled, agent, modes, uploadUrl, accept, onAttachmentError, onRejectFiles, mentions, mentionPopoverClassName, footer, ready, onSubmit, className, composerClassName, maxWidth, }: EntryComposerProps): react.JSX.Element;
+
+export { ComposerAgentControls, type ComposerAgentControlsProps, type ComposerEffortSelection, type ComposerHarnessSelection, type ComposerModelSelection, EntryComposer, type EntryComposerProps };

package/dist/chat-react/index.js

@@ -0,0 +1,179 @@
+import {
+  useComposerAttachments
+} from "../chunk-4OO7P3ZF.js";
+import {
+  ATTACHMENT_ACCEPT
+} from "../chunk-IYLJS6VW.js";
+import "../chunk-QYAQGCHF.js";
+
+// src/chat-react/composer-agent-controls.tsx
+import { useCallback, useMemo, useRef } from "react";
+import { AgentSessionControls } from "@tangle-network/sandbox-ui/chat";
+import { canonicalModelId } from "@tangle-network/sandbox-ui/dashboard";
+import { jsx } from "react/jsx-runtime";
+function harnessesForContext(available, context) {
+  if (!available) return available;
+  if (context !== "chat") return available;
+  return available.filter((h) => h !== "cli-base");
+}
+function ComposerAgentControls({
+  model,
+  harness,
+  effort,
+  className,
+  context = "chat",
+  layout = "combined",
+  menuPlacement,
+  filterModelsToHarness = true
+}) {
+  const canonicalSelected = useMemo(() => {
+    const selected = model.models.find((m) => m.id === model.value);
+    if (selected) return canonicalModelId(selected);
+    return model.value;
+  }, [model.value, model.models]);
+  const harnessSwitching = useRef(false);
+  const harnessOnChange = harness?.onChange;
+  const onHarnessChange = useCallback(
+    (next) => {
+      harnessSwitching.current = true;
+      harnessOnChange?.(next);
+      queueMicrotask(() => {
+        harnessSwitching.current = false;
+      });
+    },
+    [harnessOnChange]
+  );
+  const modelOnChange = model.onChange;
+  const onModelChange = useCallback(
+    (canonical) => {
+      if (harnessSwitching.current) return;
+      modelOnChange(canonical);
+    },
+    [modelOnChange]
+  );
+  return /* @__PURE__ */ jsx(
+    AgentSessionControls,
+    {
+      className,
+      context,
+      layout,
+      menuPlacement,
+      filterModelsToHarness,
+      model: {
+        value: canonicalSelected,
+        onChange: onModelChange,
+        models: model.models,
+        loading: model.loading,
+        disabled: model.disabled
+      },
+      harness: harness ? {
+        value: harness.value,
+        onChange: onHarnessChange,
+        available: harnessesForContext(harness.available, context),
+        disabled: harness.disabled,
+        locked: harness.locked,
+        lockReason: harness.lockReason,
+        onNewChat: harness.onNewChat
+      } : void 0,
+      reasoning: effort ? {
+        value: effort.value,
+        onChange: effort.onChange,
+        available: effort.available,
+        disabled: effort.disabled
+      } : void 0
+    }
+  );
+}
+
+// src/chat-react/entry-composer.tsx
+import { useState } from "react";
+import { AgentComposer } from "@tangle-network/sandbox-ui/chat";
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+function EntryComposer({
+  heading,
+  subheading,
+  placeholder,
+  initialValue = "",
+  sendLabel,
+  disabled,
+  agent,
+  modes,
+  uploadUrl,
+  accept = ATTACHMENT_ACCEPT,
+  onAttachmentError,
+  onRejectFiles,
+  mentions,
+  mentionPopoverClassName,
+  footer,
+  ready = true,
+  onSubmit,
+  className,
+  composerClassName,
+  maxWidth = 820
+}) {
+  const [value, setValue] = useState(initialValue);
+  const attachments = useComposerAttachments({
+    uploadUrl,
+    enabled: !!uploadUrl,
+    onReject: onAttachmentError,
+    onError: onAttachmentError
+  });
+  function submit(prompt) {
+    if (!ready || disabled) return;
+    const next = prompt.trim();
+    if (attachments.hasPending || attachments.hasError) {
+      if (attachments.blockReason) onAttachmentError?.(attachments.blockReason);
+      return;
+    }
+    if (!next && attachments.references.length === 0) return;
+    onSubmit(next, attachments.references, mentions?.mentions ?? []);
+    setValue("");
+    attachments.clear();
+    mentions?.clearMentions();
+  }
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      className: className ?? "relative flex flex-1 flex-col items-center justify-center overflow-hidden bg-background px-5",
+      children: /* @__PURE__ */ jsxs("div", { className: "w-full", style: { maxWidth }, children: [
+        heading ? /* @__PURE__ */ jsx2("h2", { className: "mb-4 text-center text-[1.75rem] font-medium tracking-tight text-foreground", children: heading }) : null,
+        subheading ? /* @__PURE__ */ jsx2("p", { className: "mx-auto mb-9 max-w-md text-center text-sm leading-relaxed text-muted-foreground", children: subheading }) : heading ? /* @__PURE__ */ jsx2("div", { className: "mb-7" }) : null,
+        /* @__PURE__ */ jsx2(
+          AgentComposer,
+          {
+            className: composerClassName ?? "vt-composer",
+            value,
+            onChange: setValue,
+            onSubmit: () => submit(value),
+            placeholder,
+            sendLabel,
+            disabled,
+            autoFocus: true,
+            canSubmitAttachmentsOnly: true,
+            accept,
+            attachments: attachments.composerFiles,
+            onAttach: uploadUrl ? (files) => void attachments.addFiles(files) : void 0,
+            onRejectFiles,
+            onRemoveFile: attachments.removeAttachment,
+            onRetryFile: attachments.retry,
+            mention: mentions ? {
+              ...mentions.mention,
+              // Sidebar tone + hairline so the popover reads as app chrome
+              // (the same treatment the picker menus get) instead of the
+              // brighter overlay tone the component defaults to.
+              popoverClassName: mentionPopoverClassName ?? "bg-surface-container-low border-[var(--md3-outline-variant)]"
+            } : void 0,
+            controls: modes,
+            trailing: agent ? /* @__PURE__ */ jsx2(ComposerAgentControls, { menuPlacement: "down", ...agent }) : void 0
+          }
+        ),
+        footer ? /* @__PURE__ */ jsx2("div", { className: "mt-7", children: footer }) : null
+      ] })
+    }
+  );
+}
+export {
+  ComposerAgentControls,
+  EntryComposer
+};
+//# sourceMappingURL=index.js.map

package/dist/chat-react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chat-react/composer-agent-controls.tsx","../../src/chat-react/entry-composer.tsx"],"sourcesContent":["import { useCallback, useMemo, useRef } from 'react'\nimport { AgentSessionControls } from '@tangle-network/sandbox-ui/chat'\nimport { canonicalModelId } from '@tangle-network/sandbox-ui/dashboard'\nimport type { ModelInfo } from '@tangle-network/sandbox-ui/dashboard'\nimport type { HarnessType, ReasoningEffort, ReasoningLevel } from './types'\n\n/**\n * The model half of the composer's agent identity. `models` is the catalog the\n * picker renders; `value` may be a bare or a canonical (provider-prefixed) id —\n * the adapter maps it to canonical form for the picker and hands the canonical\n * id back to `onChange`, so a product that stores bare ids only has to accept\n * canonical ones in its setter.\n */\nexport interface ComposerModelSelection {\n  value: string\n  onChange: (next: string) => void\n  models: ModelInfo[]\n  loading?: boolean\n  disabled?: boolean\n}\n\nexport interface ComposerHarnessSelection {\n  value: HarnessType\n  onChange: (next: HarnessType) => void\n  /** Restrict the offered backends. Omit to take the context default. */\n  available?: ReadonlyArray<HarnessType>\n  disabled?: boolean\n  /**\n   * A thread's sidecar session is pinned to one harness at its first message,\n   * so once the thread has messages the picker locks. With `onNewChat` the\n   * locked chip becomes the informative lock (explains the binding + a button\n   * to start a fresh session on another backend).\n   */\n  locked?: boolean\n  lockReason?: string\n  onNewChat?: () => void\n}\n\nexport interface ComposerEffortSelection {\n  value: ReasoningLevel\n  onChange: (next: ReasoningLevel) => void\n  /**\n   * Depths this product's backend actually applies. Omit for the default set.\n   * `auto` is NOT a member: the picker adds that sentinel itself, so listing it\n   * here would offer it twice.\n   */\n  available?: ReadonlyArray<ReasoningEffort>\n  disabled?: boolean\n}\n\nexport interface ComposerAgentControlsProps {\n  model: ComposerModelSelection\n  /** Omit on a router-backed composer: a direct model call has no CLI backend,\n   *  so the picker would be inert. Model + effort still render. */\n  harness?: ComposerHarnessSelection\n  effort?: ComposerEffortSelection\n  className?: string\n  /**\n   * Which surface the controls live on. `'chat'` (the default) drops the\n   * shell-only `cli-base` backend — it has no conversational agent — and tells\n   * the shared control to use its chat-only default set. `'all'` keeps every\n   * backend for non-chat / scheduled surfaces.\n   */\n  context?: 'chat' | 'all'\n  /**\n   * Trigger layout. `'combined'` (the default) collapses the pickers behind one\n   * labeled trigger reading the current selection (`harness · model · effort`).\n   * `'gear'` uses an anonymous gear icon instead of the label; `'inline'` lays\n   * the pickers out in a row.\n   */\n  layout?: 'inline' | 'gear' | 'combined'\n  /**\n   * Where the pickers open. `'down'` pins them downward for a composer floating\n   * in open space (the centered entry surface) so a tall menu can't flip up over\n   * the heading. Defaults to `'auto'` (collision-aware).\n   */\n  menuPlacement?: 'auto' | 'down'\n  /**\n   * Restrict the model catalog to what the selected harness can run instead of\n   * letting an incompatible model snap the harness. ON by default: a workspace\n   * harness is sandbox-bound, and a silent swap tears down and recreates the\n   * sandbox. Turn OFF only on a model-first surface with no bound sandbox.\n   */\n  filterModelsToHarness?: boolean\n}\n\n/**\n * The chat copilot must never offer `cli-base`: it is a shell-only backend with\n * no conversational agent. sandbox-ui's `context='chat'` drops it from the\n * default set, but an explicit `available` list (a plan-filtered one may include\n * `cli-base`) overrides that trim. So strip it here at the data layer whenever\n * the surface is chat — no `cli-base` ever reaches render.\n */\nfunction harnessesForContext(\n  available: ReadonlyArray<HarnessType> | undefined,\n  context: 'chat' | 'all',\n): ReadonlyArray<HarnessType> | undefined {\n  if (!available) return available\n  if (context !== 'chat') return available\n  return available.filter((h) => h !== 'cli-base')\n}\n\n/**\n * The composer's agent-identity control: harness (agent backend), model, and\n * reasoning effort, over sandbox-ui's `AgentSessionControls`.\n *\n * This is an ADAPTER, not a second implementation. sandbox-ui owns the control\n * and the harness↔model coherence policy (the catalog is filtered to the\n * selected harness, the effort re-clamps to what the harness/model pair\n * supports, and a harness that ignores a picker is marked with its dead control\n * disabled). What lives here is the app-shell wiring every product otherwise\n * re-derives:\n *\n *  - MODEL-ID BOUNDARY. Products store bare ids (what a chat send body expects)\n *    while the picker matches on canonical provider-prefixed ids. The canonical\n *    form goes in; the canonical id comes back out to `onChange`.\n *  - HARNESS-SNAP SUPPRESSION. The shared control snaps the model whenever the\n *    harness changes, calling the model `onChange` synchronously with a default\n *    compatible model. A product that remembers a per-harness pick must ignore\n *    that snap, or it both discards the remembered pick and persists it under\n *    the wrong harness's key. The guard is armed for exactly the synchronous\n *    window of a harness change and disarmed on the next microtask, so it can\n *    never stay stuck — a later genuine pick is never swallowed, even when the\n *    harness change was a no-op.\n *  - CHAT-CONTEXT TRIM. `cli-base` never reaches a conversational surface.\n *\n * Behavioral modes (a plan toggle) are NOT agent identity and do not belong\n * here — they dock on the other side of the composer via `controls`.\n */\nexport function ComposerAgentControls({\n  model,\n  harness,\n  effort,\n  className,\n  context = 'chat',\n  layout = 'combined',\n  menuPlacement,\n  filterModelsToHarness = true,\n}: ComposerAgentControlsProps) {\n  const canonicalSelected = useMemo(() => {\n    const selected = model.models.find((m) => m.id === model.value)\n    if (selected) return canonicalModelId(selected)\n    // Already canonical, or the catalog has not loaded — pass through unchanged\n    // so a provider-prefixed id still matches once models arrive.\n    return model.value\n  }, [model.value, model.models])\n\n  const harnessSwitching = useRef(false)\n  const harnessOnChange = harness?.onChange\n  const onHarnessChange = useCallback(\n    (next: HarnessType) => {\n      harnessSwitching.current = true\n      harnessOnChange?.(next)\n      queueMicrotask(() => {\n        harnessSwitching.current = false\n      })\n    },\n    [harnessOnChange],\n  )\n\n  const modelOnChange = model.onChange\n  const onModelChange = useCallback(\n    (canonical: string) => {\n      if (harnessSwitching.current) return\n      modelOnChange(canonical)\n    },\n    [modelOnChange],\n  )\n\n  return (\n    <AgentSessionControls\n      className={className}\n      context={context}\n      layout={layout}\n      menuPlacement={menuPlacement}\n      filterModelsToHarness={filterModelsToHarness}\n      model={{\n        value: canonicalSelected,\n        onChange: onModelChange,\n        models: model.models,\n        loading: model.loading,\n        disabled: model.disabled,\n      }}\n      harness={\n        harness\n          ? {\n              value: harness.value,\n              onChange: onHarnessChange,\n              available: harnessesForContext(harness.available, context),\n              disabled: harness.disabled,\n              locked: harness.locked,\n              lockReason: harness.lockReason,\n              onNewChat: harness.onNewChat,\n            }\n          : undefined\n      }\n      reasoning={\n        effort\n          ? {\n              value: effort.value,\n              onChange: effort.onChange,\n              available: effort.available,\n              disabled: effort.disabled,\n            }\n          : undefined\n      }\n    />\n  )\n}\n","import { useState, type ReactNode } from 'react'\nimport { AgentComposer } from '@tangle-network/sandbox-ui/chat'\nimport { ATTACHMENT_ACCEPT, useComposerAttachments } from '../web-react/use-composer-attachments'\nimport type { UseFileMentionsResult } from '../web-react/use-file-mentions'\nimport type { ChatAttachmentInput, FileMention } from '../chat-routes/wire'\nimport {\n  ComposerAgentControls,\n  type ComposerAgentControlsProps,\n} from './composer-agent-controls'\n\nexport interface EntryComposerProps {\n  /** The one line above the input. Domain copy — always a product parameter. */\n  heading?: ReactNode\n  /** Optional supporting line under the heading. */\n  subheading?: ReactNode\n  placeholder?: string\n  initialValue?: string\n  sendLabel?: string\n  disabled?: boolean\n  /**\n   * Agent identity (harness/model/effort). Pass it and the control row renders;\n   * omit it and the composer ships without one. Omitting is a real choice for a\n   * surface with nothing to choose — it should never be an oversight, which is\n   * why this is one prop rather than a free-form slot a caller can forget.\n   */\n  agent?: ComposerAgentControlsProps\n  /**\n   * Behavioral modes docked on the LEFT (a plan-approval toggle). A mode is an\n   * on/off switch, not a value picker, so it sits apart from agent identity.\n   */\n  modes?: ReactNode\n  /**\n   * Upload endpoint for staged attachments. Omit and the attach affordance is\n   * hidden — a composer with no place to put a file must not offer one.\n   */\n  uploadUrl?: string\n  accept?: string\n  onAttachmentError?: (reason: string) => void\n  onRejectFiles?: Parameters<typeof AgentComposer>[0]['onRejectFiles']\n  /**\n   * `@`-file mentions. The hook itself is shared (`useFileMentions`), but the\n   * cold-box policy around it — whether pressing `@` is worth starting a\n   * sandbox — is a per-surface product call, so the result is injected rather\n   * than created here.\n   */\n  mentions?: UseFileMentionsResult\n  mentionPopoverClassName?: string\n  /** Rendered under the composer: suggestion pills, an onboarding nudge, a\n   *  disclaimer. All domain copy. */\n  footer?: ReactNode\n  /** Block submit until a persisted selection has resolved against the catalog,\n   *  so the first turn cannot go out under the wrong model. Defaults to true. */\n  ready?: boolean\n  onSubmit: (\n    prompt: string,\n    attachments: ChatAttachmentInput[],\n    mentions: FileMention[],\n  ) => void\n  className?: string\n  composerClassName?: string\n  /** Max width of the centered column. Defaults to the fleet's 820px. */\n  maxWidth?: number\n}\n\n/**\n * `EntryComposer` — the centered \"what do you want to work on?\" surface a\n * product shows before a conversation exists (a new thread, an empty session,\n * a workspace overview).\n *\n * It exists because three products each grew their own, and they drifted into\n * three different capability sets rather than three different looks: one lost\n * the attach button, one lost the model and effort pickers entirely, one\n * hand-rolled a `<textarea>` and wired pickers from three separate packages\n * into one row. The composer, the pickers, the attachment queue and the mention\n * index were all ALREADY shared — what was not shared was the assembly, so\n * every product re-derived which controls an entry surface gets, and each\n * re-derivation dropped a different one.\n *\n * Mechanism lives here: layout, the attachment queue, the mention wiring, the\n * submit gate (nothing sends while an upload is pending or failed, or before\n * the model selection has resolved). Domain stays a parameter: `heading`,\n * `placeholder`, `footer` (suggestion pills, disclaimers) and the selections\n * themselves.\n *\n * The docked in-thread composer is NOT this component — it renders\n * `AgentComposer` directly with the same {@link ComposerAgentControls}, because\n * a docked composer has a transcript above it and no hero layout.\n */\nexport function EntryComposer({\n  heading,\n  subheading,\n  placeholder,\n  initialValue = '',\n  sendLabel,\n  disabled,\n  agent,\n  modes,\n  uploadUrl,\n  accept = ATTACHMENT_ACCEPT,\n  onAttachmentError,\n  onRejectFiles,\n  mentions,\n  mentionPopoverClassName,\n  footer,\n  ready = true,\n  onSubmit,\n  className,\n  composerClassName,\n  maxWidth = 820,\n}: EntryComposerProps) {\n  const [value, setValue] = useState(initialValue)\n  const attachments = useComposerAttachments({\n    uploadUrl,\n    enabled: !!uploadUrl,\n    onReject: onAttachmentError,\n    onError: onAttachmentError,\n  })\n\n  function submit(prompt: string) {\n    if (!ready || disabled) return\n    const next = prompt.trim()\n    // A pending or failed upload must not send: the turn would reference an\n    // attachment the store does not have. Surface why rather than no-op'ing.\n    if (attachments.hasPending || attachments.hasError) {\n      if (attachments.blockReason) onAttachmentError?.(attachments.blockReason)\n      return\n    }\n    if (!next && attachments.references.length === 0) return\n    onSubmit(next, attachments.references, mentions?.mentions ?? [])\n    setValue('')\n    attachments.clear()\n    mentions?.clearMentions()\n  }\n\n  return (\n    <div\n      className={\n        className ??\n        'relative flex flex-1 flex-col items-center justify-center overflow-hidden bg-background px-5'\n      }\n    >\n      <div className=\"w-full\" style={{ maxWidth }}>\n        {heading ? (\n          <h2 className=\"mb-4 text-center text-[1.75rem] font-medium tracking-tight text-foreground\">\n            {heading}\n          </h2>\n        ) : null}\n        {subheading ? (\n          <p className=\"mx-auto mb-9 max-w-md text-center text-sm leading-relaxed text-muted-foreground\">\n            {subheading}\n          </p>\n        ) : (\n          heading ? <div className=\"mb-7\" /> : null\n        )}\n        <AgentComposer\n          className={composerClassName ?? 'vt-composer'}\n          value={value}\n          onChange={setValue}\n          onSubmit={() => submit(value)}\n          placeholder={placeholder}\n          sendLabel={sendLabel}\n          disabled={disabled}\n          autoFocus\n          canSubmitAttachmentsOnly\n          accept={accept}\n          attachments={attachments.composerFiles}\n          onAttach={uploadUrl ? (files) => void attachments.addFiles(files) : undefined}\n          onRejectFiles={onRejectFiles}\n          onRemoveFile={attachments.removeAttachment}\n          onRetryFile={attachments.retry}\n          mention={\n            mentions\n              ? {\n                  ...mentions.mention,\n                  // Sidebar tone + hairline so the popover reads as app chrome\n                  // (the same treatment the picker menus get) instead of the\n                  // brighter overlay tone the component defaults to.\n                  popoverClassName:\n                    mentionPopoverClassName ??\n                    'bg-surface-container-low border-[var(--md3-outline-variant)]',\n                }\n              : undefined\n          }\n          controls={modes}\n          trailing={\n            agent ? <ComposerAgentControls menuPlacement=\"down\" {...agent} /> : undefined\n          }\n        />\n        {footer ? <div className=\"mt-7\">{footer}</div> : null}\n      </div>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,aAAa,SAAS,cAAc;AAC7C,SAAS,4BAA4B;AACrC,SAAS,wBAAwB;AAwK7B;AA7EJ,SAAS,oBACP,WACA,SACwC;AACxC,MAAI,CAAC,UAAW,QAAO;AACvB,MAAI,YAAY,OAAQ,QAAO;AAC/B,SAAO,UAAU,OAAO,CAAC,MAAM,MAAM,UAAU;AACjD;AA6BO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,SAAS;AAAA,EACT;AAAA,EACA,wBAAwB;AAC1B,GAA+B;AAC7B,QAAM,oBAAoB,QAAQ,MAAM;AACtC,UAAM,WAAW,MAAM,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,MAAM,KAAK;AAC9D,QAAI,SAAU,QAAO,iBAAiB,QAAQ;AAG9C,WAAO,MAAM;AAAA,EACf,GAAG,CAAC,MAAM,OAAO,MAAM,MAAM,CAAC;AAE9B,QAAM,mBAAmB,OAAO,KAAK;AACrC,QAAM,kBAAkB,SAAS;AACjC,QAAM,kBAAkB;AAAA,IACtB,CAAC,SAAsB;AACrB,uBAAiB,UAAU;AAC3B,wBAAkB,IAAI;AACtB,qBAAe,MAAM;AACnB,yBAAiB,UAAU;AAAA,MAC7B,CAAC;AAAA,IACH;AAAA,IACA,CAAC,eAAe;AAAA,EAClB;AAEA,QAAM,gBAAgB,MAAM;AAC5B,QAAM,gBAAgB;AAAA,IACpB,CAAC,cAAsB;AACrB,UAAI,iBAAiB,QAAS;AAC9B,oBAAc,SAAS;AAAA,IACzB;AAAA,IACA,CAAC,aAAa;AAAA,EAChB;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,QACL,OAAO;AAAA,QACP,UAAU;AAAA,QACV,QAAQ,MAAM;AAAA,QACd,SAAS,MAAM;AAAA,QACf,UAAU,MAAM;AAAA,MAClB;AAAA,MACA,SACE,UACI;AAAA,QACE,OAAO,QAAQ;AAAA,QACf,UAAU;AAAA,QACV,WAAW,oBAAoB,QAAQ,WAAW,OAAO;AAAA,QACzD,UAAU,QAAQ;AAAA,QAClB,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,WAAW,QAAQ;AAAA,MACrB,IACA;AAAA,MAEN,WACE,SACI;AAAA,QACE,OAAO,OAAO;AAAA,QACd,UAAU,OAAO;AAAA,QACjB,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO;AAAA,MACnB,IACA;AAAA;AAAA,EAER;AAEJ;;;AChNA,SAAS,gBAAgC;AACzC,SAAS,qBAAqB;AA4IxB,SAEI,OAAAA,MAFJ;AArDC,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AACb,GAAuB;AACrB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,YAAY;AAC/C,QAAM,cAAc,uBAAuB;AAAA,IACzC;AAAA,IACA,SAAS,CAAC,CAAC;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AAED,WAAS,OAAO,QAAgB;AAC9B,QAAI,CAAC,SAAS,SAAU;AACxB,UAAM,OAAO,OAAO,KAAK;AAGzB,QAAI,YAAY,cAAc,YAAY,UAAU;AAClD,UAAI,YAAY,YAAa,qBAAoB,YAAY,WAAW;AACxE;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,YAAY,WAAW,WAAW,EAAG;AAClD,aAAS,MAAM,YAAY,YAAY,UAAU,YAAY,CAAC,CAAC;AAC/D,aAAS,EAAE;AACX,gBAAY,MAAM;AAClB,cAAU,cAAc;AAAA,EAC1B;AAEA,SACE,gBAAAA;AAAA,IAAC;AAAA;AAAA,MACC,WACE,aACA;AAAA,MAGF,+BAAC,SAAI,WAAU,UAAS,OAAO,EAAE,SAAS,GACvC;AAAA,kBACC,gBAAAA,KAAC,QAAG,WAAU,8EACX,mBACH,IACE;AAAA,QACH,aACC,gBAAAA,KAAC,OAAE,WAAU,mFACV,sBACH,IAEA,UAAU,gBAAAA,KAAC,SAAI,WAAU,QAAO,IAAK;AAAA,QAEvC,gBAAAA;AAAA,UAAC;AAAA;AAAA,YACC,WAAW,qBAAqB;AAAA,YAChC;AAAA,YACA,UAAU;AAAA,YACV,UAAU,MAAM,OAAO,KAAK;AAAA,YAC5B;AAAA,YACA;AAAA,YACA;AAAA,YACA,WAAS;AAAA,YACT,0BAAwB;AAAA,YACxB;AAAA,YACA,aAAa,YAAY;AAAA,YACzB,UAAU,YAAY,CAAC,UAAU,KAAK,YAAY,SAAS,KAAK,IAAI;AAAA,YACpE;AAAA,YACA,cAAc,YAAY;AAAA,YAC1B,aAAa,YAAY;AAAA,YACzB,SACE,WACI;AAAA,cACE,GAAG,SAAS;AAAA;AAAA;AAAA;AAAA,cAIZ,kBACE,2BACA;AAAA,YACJ,IACA;AAAA,YAEN,UAAU;AAAA,YACV,UACE,QAAQ,gBAAAA,KAAC,yBAAsB,eAAc,QAAQ,GAAG,OAAO,IAAK;AAAA;AAAA,QAExE;AAAA,QACC,SAAS,gBAAAA,KAAC,SAAI,WAAU,QAAQ,kBAAO,IAAS;AAAA,SACnD;AAAA;AAAA,EACF;AAEJ;","names":["jsx"]}

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

@@ -1,17 +1,18 @@
-import { C as ChatMessagePart, N as ChatTurnRequestPayload, O as ChatTurnPartInput, P as ChatTurnFilePartInput, b as ChatAttachmentPart, a as ChatAttachmentKind, g as ChatMentionPart } from '../parts-fyPPdDdK.js';
-export { Q as ChatAttachmentInput, f as ChatMentionKind, R as ChatTurnInputError, T as ChatTurnTextPartInput, U as DISPATCH_MAX_MEDIA_PARTS, V as DISPATCH_MAX_PARTS, W as DISPATCH_REQUEST_MAX_BYTES, X as DISPATCH_STRUCTURAL_RESERVE_BYTES, M as FileMention, Y as FileMentionsToPartsOptions, Z as INLINE_PARTS_MAX_BYTES, _ as MENTION_MAX_COUNT, $ as ProducerErrorEvent, a0 as ProducerNoticeEvent, a1 as ProducerPassthroughEvent, a2 as ProducerPassthroughEventType, a3 as ProducerReasoningEvent, a4 as ProducerTextEvent, a5 as ProducerToolCallEvent, a6 as ProducerToolResultEvent, a7 as ProducerUsageEvent, a8 as ProducerWireEvent, a9 as SandboxMentionPathCheck, aa as assertPromptPartsWithinCap, ab as base64WireLen, ac as buildMentionPromptBlock, ad as chatTurnRequestInit, ae as fileMentionsToParts, af as formatBytes, ag as mediaTypeForMentionPath, ah as mentionKindForPath, ai as parseChatTurnParts, aj as parseFileMentions, ak as promptPartsByteSize, al as validateSandboxMentionPath } from '../parts-fyPPdDdK.js';
-export { A as ALLOWED_ATTACHMENT_SNIFFED_MIMES, a as ATTACHMENT_ACCEPT, b as ATTACHMENT_MAX_COUNT, c as AttachmentTypeCheckResult, C as CreateSandboxFileIndexRouteOptions, F as FileIndexAuthorization, d as FileIndexCache, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse, M as MAX_ATTACHMENT_TOTAL_BYTES, h as MAX_BINARY_ATTACHMENT_BYTES, i as MAX_TEXT_ATTACHMENT_BYTES, S as SandboxFileTreeSource, j as SandboxTreeFile, k as SandboxTreeResult, l as SniffResult, m as attachmentSizeErrorMessage, n as attachmentTotalSizeErrorMessage, o as checkAttachmentType, p as createSandboxFileIndexRoute, s as sanitizeAttachmentFileName, q as sniffBinary } from '../attachment-validation-Dvc_Livy.js';
+import { c as ChatTurnRequestPayload, d as ChatTurnPartInput, e as ChatTurnFilePartInput, a as ChatAttachmentKind } from '../wire-DSp4LzEE.js';
+export { b as ChatAttachmentInput, C as ChatMentionKind, f as ChatTurnInputError, g as ChatTurnTextPartInput, D as DISPATCH_MAX_MEDIA_PARTS, h as DISPATCH_MAX_PARTS, i as DISPATCH_REQUEST_MAX_BYTES, j as DISPATCH_STRUCTURAL_RESERVE_BYTES, F as FileMention, k as FileMentionsToPartsOptions, I as INLINE_PARTS_MAX_BYTES, M as MENTION_MAX_COUNT, P as ProducerErrorEvent, l as ProducerNoticeEvent, m as ProducerPassthroughEvent, n as ProducerPassthroughEventType, o as ProducerReasoningEvent, p as ProducerTextEvent, q as ProducerToolCallEvent, r as ProducerToolResultEvent, s as ProducerUsageEvent, t as ProducerWireEvent, S as SandboxMentionPathCheck, u as assertPromptPartsWithinCap, v as base64WireLen, w as buildMentionPromptBlock, x as chatTurnRequestInit, y as fileMentionsToParts, z as formatBytes, A as mediaTypeForMentionPath, B as mentionKindForPath, E as parseChatTurnParts, G as parseFileMentions, H as promptPartsByteSize, J as validateSandboxMentionPath } from '../wire-DSp4LzEE.js';
+export { A as ALLOWED_ATTACHMENT_SNIFFED_MIMES, a as ATTACHMENT_ACCEPT, b as ATTACHMENT_MAX_COUNT, c as AttachmentTypeCheckResult, C as CreateSandboxFileIndexRouteOptions, F as FileIndexAuthorization, d as FileIndexCache, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse, M as MAX_ATTACHMENT_TOTAL_BYTES, h as MAX_BINARY_ATTACHMENT_BYTES, i as MAX_TEXT_ATTACHMENT_BYTES, S as SandboxFileTreeSource, j as SandboxTreeFile, k as SandboxTreeResult, l as SniffResult, m as attachmentSizeErrorMessage, n as attachmentTotalSizeErrorMessage, o as checkAttachmentType, p as createSandboxFileIndexRoute, s as sanitizeAttachmentFileName, q as sniffBinary } from '../attachment-validation-CNkH91Gs.js';
 import { ChatTurnIdentity, ChatTurnProducer } from '@tangle-network/agent-runtime/durable';
+import { C as ChatMessagePart, a as ChatAttachmentPart, e as ChatMentionPart } from '../parts-7fbe2rj8.js';
 import { InteractionAnswerRoute, InteractionAnswerRouteOptions } from '../interactions/index.js';
 import { PersistedChatMessageForTurn } from '../stream/index.js';
 import { T as TurnEventStore } from '../turn-buffer-BcPfhr1_.js';
 import { M as ModelFailoverAttempt } from '../failover-D-3UXXTb.js';
 export { D as DEFAULT_STALE_TURN_LOCK_GRACE_MS, a as DEFAULT_TERMINAL_TURN_LOCK_GRACE_MS, R as ReconcileStaleTurnLockOptions, b as ReconcileStaleTurnLockResult, S as StaleTurnLockSandboxProbeResult, c as StaleTurnLockSessionProbeResult, r as reconcileStaleTurnLock } from '../stale-turn-lock-DucQzvXu.js';
-import { J as JsonRecord } from '../stream-normalizer-DnuqkZvw.js';
+import { J as JsonRecord } from '../stream-normalizer-CnPnMaTp.js';
 import { SandboxExecChannel, PromptInputPart } from '../sandbox/index.js';
 import '@tangle-network/agent-interface';
-import '../contract-CEewO6DI.js';
-import '../types-DB82fktc.js';
+import '../contract-CQNvv5th.js';
+import '../types-CCeYywdS.js';
 import '../plans/index.js';
 import '@tangle-network/sandbox';
 import '../auth-DJs6lfAs.js';

package/dist/chat-routes/index.js

@@ -1,3 +1,6 @@
+import {
+  createSandboxFileIndexRoute
+} from "../chunk-QY4BRKRJ.js";
 import {
   ALLOWED_ATTACHMENT_SNIFFED_MIMES,
   ATTACHMENT_ACCEPT,
@@ -8,10 +11,9 @@ import {
   attachmentSizeErrorMessage,
   attachmentTotalSizeErrorMessage,
   checkAttachmentType,
-  createSandboxFileIndexRoute,
   sanitizeAttachmentFileName,
   sniffBinary
-} from "../chunk-BI6NKSO4.js";
+} from "../chunk-IYLJS6VW.js";
 import {
   coalesceDeltas,
   createBufferedTurnTap,
@@ -31,6 +33,13 @@ import {
 import {
   parseJsonObjectBody
 } from "../chunk-PTUMBMVH.js";
+import {
+  attachmentInputToPart,
+  attachmentKindForMime,
+  mentionInputToPart,
+  toChatMessageParts
+} from "../chunk-4PUMUTLU.js";
+import "../chunk-ZVEEWGDK.js";
 import {
   ChatTurnInputError,
   DISPATCH_MAX_MEDIA_PARTS,
@@ -40,23 +49,18 @@ import {
   INLINE_PARTS_MAX_BYTES,
   MENTION_MAX_COUNT,
   assertPromptPartsWithinCap,
-  attachmentInputToPart,
-  attachmentKindForMime,
   base64WireLen,
   buildMentionPromptBlock,
   chatTurnRequestInit,
   fileMentionsToParts,
   formatBytes,
   mediaTypeForMentionPath,
-  mentionInputToPart,
   mentionKindForPath,
   parseChatTurnParts,
   parseFileMentions,
   promptPartsByteSize,
-  toChatMessageParts,
   validateSandboxMentionPath
-} from "../chunk-C3SRFZGL.js";
-import "../chunk-ZVEEWGDK.js";
+} from "../chunk-QYAQGCHF.js";
 import {
   asRecord,
   asString,
@@ -93,7 +97,7 @@ import {
   flattenHistory,
   readSandboxBinaryBytes,
   statSandboxFileSize
-} from "../chunk-7775L5NN.js";
+} from "../chunk-BAC2B2KI.js";
 import "../chunk-LWSJK546.js";
 import "../chunk-CQZSAR77.js";
 import "../chunk-ICOHEZK6.js";