@tangle-network/sandbox-ui 0.58.0 → 0.60.0

package/dist/chat.d.ts

@@ -48,6 +48,69 @@ interface ReasoningLevelPickerProps {
 declare const DEFAULT_REASONING_LEVEL_OPTIONS: ReadonlyArray<ReasoningLevelOption>;
 declare function ReasoningLevelPicker({ value, onChange, disabled, className, triggerClassName, options, available, side, avoidCollisions, }: ReasoningLevelPickerProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * 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.
+ * Studio / Assistant); the rest are user-saved custom agents. The concept is
+ * backend-agnostic — it applies to a router-backed agent and a sandbox-backed
+ * one alike, which is why it lives beside the model control rather than under
+ * the harness.
+ */
+interface AgentProfileOption {
+    id: string;
+    name: string;
+    /** Builtin: a one-line description. Custom: derived "N tools" if omitted. */
+    description?: string;
+    /** Capability/tool-group ids this profile enables. */
+    capabilities?: ReadonlyArray<string>;
+    /** Persona / extra system instructions. */
+    instructions?: string;
+    /** A shipped mode vs a user-saved custom agent. */
+    builtin?: boolean;
+}
+/** A selectable tool group offered by the create/edit form. */
+interface AgentProfileCapability {
+    id: string;
+    label: string;
+    description?: string;
+}
+/** The editable shape the create/edit form emits. */
+interface AgentProfileDraft {
+    id?: string;
+    name: string;
+    capabilities: string[];
+    instructions: string;
+}
+interface AgentProfilePickerProps {
+    /** Selected profile id. */
+    value: string;
+    onChange: (id: string) => void;
+    profiles: ReadonlyArray<AgentProfileOption>;
+    /**
+     * Tool catalog for the create/edit form. Provide together with at least one
+     * write callback to enable authoring custom agents; omit for a
+     * selection-only picker (the New / edit / delete affordances stay hidden).
+     */
+    capabilities?: ReadonlyArray<AgentProfileCapability>;
+    onCreate?: (draft: AgentProfileDraft) => void | Promise<void>;
+    onUpdate?: (id: string, draft: AgentProfileDraft) => void | Promise<void>;
+    onDelete?: (id: string) => void | Promise<void>;
+    disabled?: boolean;
+    className?: string;
+    /** Side the menu opens toward. Defaults to up (composer-anchored). */
+    side?: "top" | "bottom";
+}
+/**
+ * Agent / mode switcher styled to match the chat control strip's pills
+ * (harness, model, effort). The pill shows the active profile; the menu lists
+ * builtin modes and saved custom agents. When a capability catalog and a write
+ * callback are supplied it also authors agents inline (name + tool toggles +
+ * persona) — a self-contained click-outside popover rather than a Radix menu,
+ * because the inline form needs its own focus and typing without the menu
+ * stealing keystrokes.
+ */
+declare function AgentProfilePicker({ value, onChange, profiles, capabilities, onCreate, onUpdate, onDelete, disabled, className, side, }: AgentProfilePickerProps): react_jsx_runtime.JSX.Element;
+
 interface AgentSessionHarnessControl {
     value: HarnessType;
     onChange: (next: HarnessType) => void;
@@ -86,12 +149,33 @@ interface AgentSessionReasoningControl {
      */
     available?: ReadonlyArray<ReasoningEffort>;
 }
+/**
+ * Agent-profile (mode / toolset / persona) selection. Backend-agnostic — it
+ * sits beside the model in both router-backed and sandbox-backed modes, so the
+ * same session can switch the agent's identity without touching the harness.
+ */
+interface AgentSessionProfileControl {
+    value: string;
+    onChange: (id: string) => void;
+    profiles: ReadonlyArray<AgentProfileOption>;
+    /** Tool catalog for inline authoring; pair with a write callback to enable it. */
+    capabilities?: ReadonlyArray<AgentProfileCapability>;
+    onCreate?: (draft: AgentProfileDraft) => void | Promise<void>;
+    onUpdate?: (id: string, draft: AgentProfileDraft) => void | Promise<void>;
+    onDelete?: (id: string) => void | Promise<void>;
+    disabled?: boolean;
+}
 interface AgentSessionControlsProps {
     /**
      * Harness (agent backend) selection. Switching harness usually means
      * re-creating the agent session — the consumer owns that lifecycle.
      */
     harness?: AgentSessionHarnessControl;
+    /**
+     * Agent profile (mode / toolset / persona). Universal — present in both
+     * router-backed and sandbox-backed composers, independent of the harness.
+     */
+    profile?: AgentSessionProfileControl;
     /** Per-turn model override, fed by the router's model catalog. */
     model?: AgentSessionModelControl;
     /** Thinking-effort level applied to subsequent turns. */
@@ -139,7 +223,90 @@ interface AgentSessionControlsProps {
  *
  * Designed to slot into `SandboxWorkbench`'s `session.composerControls`.
  */
-declare function AgentSessionControls({ harness, model, reasoning, trailing, className, context, layout, menuPlacement, }: AgentSessionControlsProps): react_jsx_runtime.JSX.Element | null;
+declare function AgentSessionControls({ harness, profile, model, reasoning, trailing, className, context, layout, menuPlacement, }: AgentSessionControlsProps): react_jsx_runtime.JSX.Element | null;
+
+/** A staged attachment shown as a chip above the input. */
+interface ComposerFile {
+    id: string;
+    name: string;
+    size?: number;
+    kind: "file" | "folder";
+    /** File count for a folder chip. */
+    fileCount?: number;
+    status: "pending" | "uploading" | "ready" | "error";
+}
+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;
+    /**
+     * Agent backend. Present → sandbox-backed (the harness pill shows and snaps
+     * with the model); omitted → router-backed (no harness, just model/effort).
+     */
+    harness?: AgentSessionHarnessControl;
+    /** Agent profile (mode / toolset / persona) — universal across both modes. */
+    profile?: AgentSessionProfileControl;
+    model?: AgentSessionModelControl;
+    reasoning?: AgentSessionReasoningControl;
+    /** Forwarded to the control strip (chat hides shell-only harnesses). */
+    context?: "chat" | "all";
+    /**
+     * Override the built-in control strip with custom controls. When set, the
+     * `harness`/`profile`/`model`/`reasoning` props are ignored and this node is
+     * rendered in the control row instead — for apps that compose their own
+     * pickers. Omit to use the canonical strip.
+     */
+    controls?: React.ReactNode;
+    /** Extra content left of the send button (token meter, cost, status). */
+    trailing?: React.ReactNode;
+    /**
+     * 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;
+    accept?: string;
+    dropTitle?: string;
+    dropDescription?: string;
+    /** 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;
+}
+/**
+ * The canonical agent chat input: one rounded surface holding an auto-growing
+ * textarea, the embedded control strip (profile · harness · model · effort) at
+ * the bottom-left, and the send button at the bottom-right. The strip's pickers
+ * snap the harness↔model pair automatically; which controls appear is driven
+ * purely by which control objects are passed, so the same component is the
+ * router-backed composer (no harness) and the sandbox-backed one (with harness).
+ *
+ * Opt-in extras make it the superset of every app's hand-rolled composer:
+ * file/folder attachments with drag-and-drop + chips, a streaming Stop button
+ * (`busy` + `onCancel`), a `controls` override slot for bespoke picker rows, and
+ * a Cmd/Ctrl+L focus shortcut.
+ */
+declare function AgentComposer({ value, onChange, onSubmit, placeholder, disabled, busy, onCancel, harness, profile, model, reasoning, context, controls, trailing, onAttach, onAttachFolder, attachments, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, minRows, maxHeight, className, sendLabel, autoFocus, }: AgentComposerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Whether `harness` can run `modelId`. Router-backed harnesses, and provider-less
@@ -253,4 +420,4 @@ declare function createFetchTransport(opts: {
     fetchImpl?: typeof fetch;
 }): ArtifactAgentDockTransport;
 
-export { AgentSessionControls, type AgentSessionControlsProps, type AgentSessionHarnessControl, type AgentSessionModelControl, type AgentSessionReasoningControl, ArtifactAgentDock, type ArtifactAgentDockProps, type ArtifactAgentDockTransport, type ArtifactDockMessage, type ArtifactDockStreamEvent, type ArtifactKind, type ArtifactScope, DEFAULT_REASONING_LEVEL_OPTIONS, type ReasoningLevel, type ReasoningLevelOption, ReasoningLevelPicker, type ReasoningLevelPickerProps, createFetchTransport, isModelCompatibleWithHarness, snapModelToHarness };
+export { AgentComposer, type AgentComposerProps, type AgentProfileCapability, type AgentProfileDraft, type AgentProfileOption, AgentProfilePicker, type AgentProfilePickerProps, AgentSessionControls, type AgentSessionControlsProps, type AgentSessionHarnessControl, type AgentSessionModelControl, type AgentSessionProfileControl, type AgentSessionReasoningControl, ArtifactAgentDock, type ArtifactAgentDockProps, type ArtifactAgentDockTransport, type ArtifactDockMessage, type ArtifactDockStreamEvent, type ArtifactKind, type ArtifactScope, type ComposerFile, DEFAULT_REASONING_LEVEL_OPTIONS, type ReasoningLevel, type ReasoningLevelOption, ReasoningLevelPicker, type ReasoningLevelPickerProps, createFetchTransport, isModelCompatibleWithHarness, snapModelToHarness };

package/dist/chat.js

@@ -1,4 +1,6 @@
 import {
+  AgentComposer,
+  AgentProfilePicker,
   AgentSessionControls,
   AgentTimeline,
   ArtifactAgentDock,
@@ -15,12 +17,14 @@ import {
   modelProvider,
   snapHarnessToModel,
   snapModelToHarness
-} from "./chunk-WLMLD2CZ.js";
+} from "./chunk-V5JZOO3W.js";
 import "./chunk-HU4B2M4K.js";
 import "./chunk-SF6LPMMN.js";
 import "./chunk-EI44GEQ5.js";
 import "./chunk-U67V476Y.js";
 export {
+  AgentComposer,
+  AgentProfilePicker,
   AgentSessionControls,
   AgentTimeline,
   ArtifactAgentDock,