@tangle-network/sandbox-ui 0.57.0 → 0.59.0

package/dist/chat.d.ts

@@ -2,6 +2,7 @@ import { MessageRole } from '@tangle-network/ui/chat';
 export { AgentTimeline, AgentTimelineArtifactItem, AgentTimelineCustomItem, AgentTimelineItem, AgentTimelineMessageItem, AgentTimelineProps, AgentTimelineStatusItem, AgentTimelineTone, AgentTimelineToolGroupItem, AgentTimelineToolItem, ChatContainer, ChatContainerProps, ChatInput, ChatInputProps, ChatMessage, ChatMessageProps, MessageList, MessageListProps, MessageRole, PendingFile, ThinkingIndicator, ThinkingIndicatorProps, UserMessage, UserMessageProps } from '@tangle-network/ui/chat';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReasoningEffort, HarnessType } from '@tangle-network/agent-interface';
+export { modelProvider, snapHarnessToModel } from '@tangle-network/agent-interface';
 import * as Popover from '@radix-ui/react-dropdown-menu';
 import * as React from 'react';
 import { M as ModelInfo } from './model-picker-COjPVMzg.js';
@@ -47,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;
@@ -85,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. */
@@ -138,51 +223,64 @@ 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;
 
-/**
- * Harness ↔ model compatibility policy.
- *
- * Native CLI harnesses are vendor-locked: claude-code only drives
- * Anthropic models, codex only OpenAI models. Router-backed harnesses
- * (opencode) accept any catalog model. The pickers use this policy to
- * keep the pair coherent: changing one side snaps the other to its
- * nearest compatible choice instead of letting the user assemble a
- * combination that fails at inference time.
- */
-interface HarnessModelPolicy {
-    /** Canonical-id provider prefixes the harness can run; null = any. */
-    providers: ReadonlyArray<string> | null;
+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 a turn is streaming. */
+    disabled?: boolean;
+    /** Spins the send button and blocks submit, without disabling the textarea. */
+    busy?: boolean;
     /**
-     * Patterns ranking snap targets, best first. Within one pattern's
-     * matches the highest version (numeric-aware descending sort) wins,
-     * so "latest standard frontier" stays correct as catalogs rotate.
+     * Agent backend. Present → sandbox-backed (the harness pill shows and snaps
+     * with the model); omitted → router-backed (no harness, just model/effort).
      */
-    preferred: ReadonlyArray<RegExp>;
+    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";
+    /** Extra content left of the send button (token meter, cost, status). */
+    trailing?: React.ReactNode;
+    /** 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;
 }
-declare const HARNESS_MODEL_POLICIES: Partial<Record<HarnessType, HarnessModelPolicy>>;
-/** Provider prefix of a canonical id ("anthropic/claude-…" → "anthropic"). */
-declare function modelProvider(modelId: string): string | null;
 /**
- * Ids without a provider prefix (consumer sentinels like "default",
- * or an empty selection) are treated as compatible everywhere — they
- * mean "the session's own configuration", which every harness honors.
+ * 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).
  */
-declare function isModelCompatibleWithHarness(harness: HarnessType, modelId: string): boolean;
+declare function AgentComposer({ value, onChange, onSubmit, placeholder, disabled, busy, harness, profile, model, reasoning, context, trailing, minRows, maxHeight, className, sendLabel, autoFocus, }: AgentComposerProps): react_jsx_runtime.JSX.Element;
+
 /**
- * Keeps `modelId` when the harness can run it; otherwise returns the
- * harness's best compatible catalog model (preferred patterns in order,
- * highest version within a pattern). When the catalog holds nothing
- * compatible the original id is returned unchanged — the caller sees
- * the incompatibility instead of a silent wrong substitution.
+ * Whether `harness` can run `modelId`. Router-backed harnesses, and provider-less
+ * sentinel ids (like "default" or an empty selection — "the session's own
+ * configuration"), are compatible with everything.
  */
-declare function snapModelToHarness(harness: HarnessType, modelId: string, models: ReadonlyArray<ModelInfo>): string;
+declare function isModelCompatibleWithHarness(harness: HarnessType, modelId: string): boolean;
 /**
- * Keeps the harness when it can run `modelId`; otherwise returns the
- * model's native harness (anthropic → claude-code, openai → codex),
- * falling back to the router-backed opencode for everything else.
+ * Keeps `modelId` when the harness can run it; otherwise returns the harness's
+ * best compatible model from the loaded catalog (preferred patterns in order,
+ * highest version within a pattern). Adapts the picker's `ModelInfo[]` to the
+ * canonical id list `agent-interface` ranks over; when the catalog holds nothing
+ * compatible the original id is returned unchanged.
  */
-declare function snapHarnessToModel(harness: HarnessType, modelId: string): HarnessType;
+declare function snapModelToHarness(harness: HarnessType, modelId: string, models: ReadonlyArray<ModelInfo>): string;
 
 type ArtifactKind = string;
 interface ArtifactScope {
@@ -281,4 +379,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, HARNESS_MODEL_POLICIES, type ReasoningLevel, type ReasoningLevelOption, ReasoningLevelPicker, type ReasoningLevelPickerProps, createFetchTransport, isModelCompatibleWithHarness, modelProvider, snapHarnessToModel, 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, 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,
@@ -6,7 +8,6 @@ import {
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
-  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
@@ -16,12 +17,14 @@ import {
   modelProvider,
   snapHarnessToModel,
   snapModelToHarness
-} from "./chunk-NHHYPID3.js";
+} from "./chunk-4XOZGMJC.js";
 import "./chunk-HU4B2M4K.js";
 import "./chunk-SF6LPMMN.js";
 import "./chunk-EI44GEQ5.js";
 import "./chunk-U67V476Y.js";
 export {
+  AgentComposer,
+  AgentProfilePicker,
   AgentSessionControls,
   AgentTimeline,
   ArtifactAgentDock,
@@ -29,7 +32,6 @@ export {
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
-  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,