@tangle-network/sandbox-ui 0.105.3 → 0.107.0

package/dist/chat.d.ts

@@ -57,284 +57,6 @@ declare const DEFAULT_REASONING_LEVEL_OPTIONS: ReadonlyArray<ReasoningLevelOptio
 declare const HARNESS_REASONING_OPTIONS: Partial<Record<HarnessType, ReadonlyArray<ReasoningLevelOption>>>;
 declare function ReasoningLevelPicker({ value, onChange, disabled, className, triggerClassName, options, available, side, avoidCollisions, }: ReasoningLevelPickerProps): React.JSX.Element;
 
-/**
- * Limits applied when staging files onto a composer.
- *
- * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` stages files without a validation or
- * retry step, so it has no equivalent.
- */
-interface ComposerFileValidationConfig {
-    /** Reject any single file larger than this. */
-    maxSizeBytes?: number;
-    /** Reject files once the staged count would exceed this. */
-    maxCount?: number;
-    /** Files already staged, counted against `maxCount` before this batch. */
-    currentCount?: number;
-    /**
-     * Comma-separated accept list, same grammar as the native `<input accept>`
-     * attribute: file extensions (`.png`), exact MIME types (`image/png`), and
-     * MIME wildcards (`image/*`).
-     */
-    accept?: string;
-}
-/** A file that failed validation, paired with a human-readable reason.
- *
- * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` stages files without a validation or
- * retry step, so it has no equivalent. */
-interface ComposerFileRejection {
-    file: File;
-    reason: string;
-}
-/**
- * Checks a single file against a comma-separated `accept` list using the same
- * grammar as the native `<input accept>` attribute. An undefined or empty
- * `accept` accepts everything.
- *
- * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` stages files without a validation or
- * retry step, so it has no equivalent.
- */
-declare function isAcceptedType(file: File, accept?: string): boolean;
-/**
- * Splits a batch of files into what's safe to stage and what's rejected,
- * checking accept type, then size, then the running count against
- * `currentCount` + `maxCount`. Each rejection carries a reason naming the
- * file and the limit it broke. Pure data in, pure data out — no throwing,
- * no console noise, so callers decide how to surface rejections.
- *
- * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` stages files without a validation or
- * retry step, so it has no equivalent.
- */
-declare function validateComposerFiles(files: File[] | FileList, config: ComposerFileValidationConfig): {
-    accepted: File[];
-    rejected: ComposerFileRejection[];
-};
-
-/** A selectable item in the `@`-mention popover. Generic — file semantics live
- * in the consuming app, not here.
- *
- * Part of the {@link AgentComposer} API. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` has no equivalent — see
- * {@link AgentComposer} for which composer fits a surface. */
-interface MentionItem {
-    id: string;
-    label: string;
-    detail?: string;
-    kind?: string;
-}
-/**
- * Opt-in `@`-mention support. Present ⇒ the composer swaps its textarea for a
- * TipTap rich input that renders mentions as atomic pills; absent ⇒ exactly
- * today's plain-textarea behavior. Data-agnostic: the app supplies items.
- *
- * Part of the {@link AgentComposer} API. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` has no equivalent — see
- * {@link AgentComposer} for which composer fits a surface.
- */
-interface AgentComposerMention {
-    /** The character that opens the popover. Default "@". */
-    trigger?: string;
-    /** Async provider called with the query typed after the trigger. */
-    fetchItems: (query: string) => Promise<MentionItem[]>;
-    /** Fired with the mentions currently in the document whenever they change. */
-    onMentionsChange?: (mentions: MentionItem[]) => void;
-    /** Custom row renderer for a popover item. */
-    renderItem?: (item: MentionItem) => React.ReactNode;
-    /** Shown when a fetch resolves to zero items. Default "No matches". */
-    emptyText?: string;
-    /**
-     * Extra classes merged onto the suggestion popover's root element
-     * (`role="listbox"`), applied last so they win over the component's own —
-     * the supported way to retheme the popover instead of targeting it by its
-     * ARIA attributes.
-     */
-    popoverClassName?: string;
-}
-/** A staged attachment shown as a chip above the input.
- *
- * Part of the {@link AgentComposer} API. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` has no equivalent — see
- * {@link AgentComposer} for which composer fits a surface. */
-interface ComposerFile {
-    id: string;
-    name: string;
-    size?: number;
-    kind: "file" | "folder";
-    /** File count for a folder chip. */
-    fileCount?: number;
-    status: "pending" | "uploading" | "ready" | "error";
-    /**
-     * Object URL for an image thumbnail. The app owns creation and revocation
-     * (e.g. `URL.createObjectURL` on stage, `URL.revokeObjectURL` on remove) —
-     * the composer only ever reads it.
-     */
-    previewUrl?: string;
-    /** Shown on the chip when `status === "error"`. */
-    errorMessage?: string;
-}
-/** Context the agent will see alongside the next message.
- *
- * Part of the {@link AgentComposer} API. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` has no equivalent — see
- * {@link AgentComposer} for which composer fits a surface. */
-interface ComposerContextItem {
-    id: string;
-    label: string;
-    icon?: React.ReactNode;
-    /** Omit to render a non-removable chip. */
-    onRemove?: () => void;
-}
-/**
- * Props of {@link AgentComposer}.
- *
- * Part of the {@link AgentComposer} API. `ChatComposer` in
- * `@tangle-network/agent-app/web-react` has no equivalent — see
- * {@link AgentComposer} for which composer fits a surface.
- */
-interface AgentComposerProps {
-    /** Composer text (controlled). */
-    value: string;
-    onChange: (value: string) => void;
-    /** Fired on Enter (without Shift) or the send button. */
-    onSubmit: () => void;
-    placeholder?: string;
-    /** Disables typing and sending — e.g. while restoring. */
-    disabled?: boolean;
-    /**
-     * A turn is in flight. Spins the send button; paired with `onCancel` it
-     * becomes a Stop button instead, so the user can interrupt the stream.
-     */
-    busy?: boolean;
-    /** Stop the in-flight turn. With `busy`, replaces send with a Stop button. */
-    onCancel?: () => void;
-    /**
-     * The composer's control strip (profile · harness · model · effort pickers,
-     * token meters, …), rendered in the bottom row. Required — the legacy
-     * built-in strip was removed with the legacy pickers: pass
-     * `AgentSessionControls` from `@tangle-network/agent-app/web-react` (or your
-     * own composition), or `null` for a bare composer.
-     */
-    controls: React.ReactNode;
-    /** Extra content left of the send button (token meter, cost, status). */
-    trailing?: React.ReactNode;
-    /** Context the agent will see alongside the next message. */
-    contextItems?: ReadonlyArray<ComposerContextItem>;
-    /**
-     * Attachments are opt-in: pass `onAttach` to show the attach button, accept
-     * drag-and-drop onto the composer, and render `attachments` as chips.
-     */
-    onAttach?: (files: FileList) => void;
-    /** Show a folder-attach button; falls back to `onAttach` if unset. */
-    onAttachFolder?: (files: FileList) => void;
-    attachments?: ReadonlyArray<ComposerFile>;
-    onRemoveFile?: (id: string) => void;
-    /** When set, chips with `status === "error"` render a retry button. */
-    onRetryFile?: (id: string) => void;
-    /**
-     * File types the composer takes, in the native `<input accept>` grammar.
-     * Enforced on every ingress path — the picker dialog, drag-and-drop, and
-     * clipboard paste — so a type the picker won't offer can't arrive by another
-     * route. Non-matching files go to `onRejectFiles` and never reach
-     * `onAttach`. Folder attach is exempt (directory selection has no native
-     * accept semantics); size/count limits are the app's job in `onAttach`.
-     */
-    accept?: string;
-    /**
-     * Called with the files `accept` filtered out of a drop/paste/pick, each
-     * with a human-readable reason. Without it rejection is silent — the same
-     * feedback the native picker gives for a type it won't offer.
-     */
-    onRejectFiles?: (rejections: ComposerFileRejection[]) => void;
-    dropTitle?: string;
-    dropDescription?: string;
-    /**
-     * `canSend` ignores `busy` so Enter/onSubmit keep firing while a turn is
-     * streaming. For composers that queue the next turn instead of blocking on
-     * the current one — the Stop-button rendering rule (`busy && onCancel`) is
-     * unaffected, so the button still flips to Stop while this is set. Default
-     * false.
-     */
-    canSubmitWhileBusy?: boolean;
-    /**
-     * Allow submitting with empty text when at least one attachment is staged
-     * (an image-only message). Counts attachments of ANY status — a gate on
-     * `ready` would make Enter silently dead while an upload is in flight,
-     * with no way for the app to explain why. The app's onSubmit owns the send
-     * policy (block, queue, or toast on pending/errored files) and what the
-     * message body becomes. Default false.
-     */
-    canSubmitAttachmentsOnly?: boolean;
-    /**
-     * Opt-in `@`-mentions. When set, the textarea is replaced by a rich input
-     * that renders mentions as atomic pills and serializes them to `@<id>` in
-     * `value`. Omit for exactly today's plain-textarea behavior.
-     */
-    mention?: AgentComposerMention;
-    /** Cmd/Ctrl+L focuses the input and shows a hint. Default false. */
-    focusShortcut?: boolean;
-    /** Minimum textarea rows before it grows. Default 2. */
-    minRows?: number;
-    /** Max pixel height before the textarea scrolls. Default 200. */
-    maxHeight?: number;
-    className?: string;
-    sendLabel?: string;
-    autoFocus?: boolean;
-}
-/**
- * Sibling of `ChatComposer` in `@tangle-network/agent-app/web-react`, not a
- * predecessor of it. The two composers cover different jobs, and neither is a
- * superset of the other, so pick by the features a surface needs.
- *
- * Reach for `AgentComposer` when the surface needs `@`-mentions (`mention`,
- * backed by a lazily loaded rich-text input that renders mention pills),
- * `contextItems`, or the full attachment lifecycle — `attachments` plus
- * `onRejectFiles` and `onRetryFile`. It also owns `autoFocus`,
- * `canSubmitAttachmentsOnly`, `trailing`, `maxHeight`, and `minRows`.
- *
- * Reach for `ChatComposer` when the surface is a plain send box. It owns
- * send-failure recovery (`onSendFailed`, `sendFailureMessage`), one-shot
- * prefill (`seed`), `controlsPlacement`, `floating`, `sendVariant`,
- * parts-aware sends (`onSendParts`), and an uncontrolled mode
- * (`initialValue`) — none of which exist here.
- *
- * Moving between them is a port, not a rename: the control models differ. This
- * component requires `value` and `onChange` and calls `onSubmit` with no
- * arguments, while `ChatComposer` can own its draft and hands the message to a
- * refusable `onSend`.
- *
- * The input itself: one rounded surface holding an auto-growing
- * textarea and a bottom row that runs left → right — attach buttons, the
- * control strip (supplied via the required `controls` prop), trailing slot,
- * and the send button on the far right. The strip is explicit: the canonical
- * pickers are `ModelPicker` / `EffortPicker` / `AgentSessionControls` from
- * `@tangle-network/agent-app/web-react` — this component only owns the slot.
- *
- * Opt-in extras cover what apps otherwise hand-roll:
- * file/folder attachments with drag-and-drop + chips + clipboard paste
- * (`onAttach` also gates pasting files onto the textarea, auto-naming
- * generic clipboard image blobs `pasted-image-<n>.<ext>`), a streaming Stop
- * button (`busy` + `onCancel`), and a Cmd/Ctrl+L focus shortcut.
- */
-declare function AgentComposer({ value, onChange, onSubmit, placeholder, disabled, busy, onCancel, controls, trailing, contextItems, onAttach, onAttachFolder, attachments, onRemoveFile, onRetryFile, accept, onRejectFiles, dropTitle, dropDescription, canSubmitWhileBusy, canSubmitAttachmentsOnly, mention, focusShortcut, minRows, maxHeight, className, sendLabel, autoFocus, }: AgentComposerProps): React.JSX.Element;
-
-/**
- * Visual contract for a rendered mention pill. The TipTap editor extension in
- * `mention-editor.tsx` styles its inline atom node with this, and any other
- * surface that renders a resolved mention (e.g. a sent-message transcript)
- * should use the same constant so the two stay one visual contract instead of
- * silently drifting apart. Kept in its own module (no TipTap import) so
- * importing it never pulls the lazily-loaded editor chunk into a consumer's
- * bundle.
- *
- * Mention-pill contract of {@link AgentComposer}'s mention feature.
- * `ChatComposer` in `@tangle-network/agent-app/web-react` has no mention
- * support, so it has no equivalent.
- */
-declare const MENTION_PILL_CLASS: string;
-
 /**
  * An agent profile: a named bundle of toolset + persona layered over the same
  * model and session. `builtin` profiles are the product's shipped modes (e.g.
@@ -505,4 +227,4 @@ declare function createFetchTransport(opts: {
     fetchImpl?: typeof fetch;
 }): ArtifactAgentDockTransport;
 
-export { AgentComposer, type AgentComposerMention, type AgentComposerProps, type AgentProfileCapability, type AgentProfileDraft, type AgentProfileOption, AgentProfilePicker, type AgentProfilePickerProps, ArtifactAgentDock, type ArtifactAgentDockProps, type ArtifactAgentDockTransport, type ArtifactDockMessage, type ArtifactDockStreamEvent, type ArtifactKind, type ArtifactScope, type ComposerContextItem, type ComposerFile, type ComposerFileRejection, type ComposerFileValidationConfig, DEFAULT_REASONING_LEVEL_OPTIONS, HARNESS_REASONING_OPTIONS, MENTION_PILL_CLASS, type MentionItem, type ReasoningLevel, type ReasoningLevelOption, ReasoningLevelPicker, type ReasoningLevelPickerProps, createFetchTransport, isAcceptedType, validateComposerFiles };
+export { type AgentProfileCapability, type AgentProfileDraft, type AgentProfileOption, AgentProfilePicker, type AgentProfilePickerProps, ArtifactAgentDock, type ArtifactAgentDockProps, type ArtifactAgentDockTransport, type ArtifactDockMessage, type ArtifactDockStreamEvent, type ArtifactKind, type ArtifactScope, DEFAULT_REASONING_LEVEL_OPTIONS, HARNESS_REASONING_OPTIONS, type ReasoningLevel, type ReasoningLevelOption, ReasoningLevelPicker, type ReasoningLevelPickerProps, createFetchTransport };

package/dist/chat.js

@@ -1,5 +1,4 @@
 import {
-  AgentComposer,
   AgentProfilePicker,
   AgentTimeline,
   ArtifactAgentDock,
@@ -12,19 +11,12 @@ import {
   ThinkingIndicator,
   UserMessage,
   createFetchTransport,
-  isAcceptedType,
   modelProvider,
-  snapHarnessToModel,
-  validateComposerFiles
-} from "./chunk-XIXYQNXD.js";
-import "./chunk-TK46XFLM.js";
-import {
-  MENTION_PILL_CLASS
-} from "./chunk-WGOOQAW3.js";
+  snapHarnessToModel
+} from "./chunk-EKYA6AFY.js";
 import "./chunk-EI44GEQ5.js";
 import "./chunk-CZ7CSFO4.js";
 export {
-  AgentComposer,
   AgentProfilePicker,
   AgentTimeline,
   ArtifactAgentDock,
@@ -32,14 +24,11 @@ export {
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
   HARNESS_REASONING_OPTIONS,
-  MENTION_PILL_CLASS,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
   UserMessage,
   createFetchTransport,
-  isAcceptedType,
   modelProvider,
-  snapHarnessToModel,
-  validateComposerFiles
+  snapHarnessToModel
 };