@tangle-network/sandbox-ui 0.20.3 → 0.21.1

package/dist/chat.d.ts

@@ -1,6 +1,9 @@
 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 * as React from 'react';
+import { M as ModelInfo } from './model-picker-DUfMTQo5.js';
+import { e as HarnessType } from './harness-picker-C1W3rTeb.js';
 
 type ReasoningLevel = "auto" | "low" | "medium" | "high";
 interface ReasoningLevelOption {
@@ -19,6 +22,113 @@ interface ReasoningLevelPickerProps {
 declare const DEFAULT_REASONING_LEVEL_OPTIONS: ReadonlyArray<ReasoningLevelOption>;
 declare function ReasoningLevelPicker({ value, onChange, disabled, className, triggerClassName, options, }: ReasoningLevelPickerProps): react_jsx_runtime.JSX.Element;
 
+interface AgentSessionHarnessControl {
+    value: HarnessType;
+    onChange: (next: HarnessType) => void;
+    /** Filter the selectable harnesses (e.g. by plan tier). Defaults to all. */
+    available?: ReadonlyArray<HarnessType>;
+    disabled?: boolean;
+    /**
+     * A harness is bound to its chat session once the conversation has
+     * started. While locked the dropdown is inert and the model catalog
+     * is filtered to what this harness can run — fork the session to
+     * switch harness.
+     */
+    locked?: boolean;
+    /** Tooltip shown on the locked trigger. */
+    lockReason?: string;
+}
+interface AgentSessionModelControl {
+    /** Canonical model id (provider-prefixed, e.g. "anthropic/claude-opus-4-8"). */
+    value: string;
+    onChange: (modelId: string) => void;
+    /** Models to choose from. Pass `[]` while loading. */
+    models: ModelInfo[];
+    loading?: boolean;
+    popular?: ReadonlyArray<string>;
+    recents?: ReadonlyArray<string>;
+    disabled?: boolean;
+}
+interface AgentSessionReasoningControl {
+    value: ReasoningLevel;
+    onChange: (value: ReasoningLevel) => void;
+    options?: ReadonlyArray<ReasoningLevelOption>;
+    disabled?: boolean;
+}
+interface AgentSessionControlsProps {
+    /**
+     * Harness (agent backend) selection. Switching harness usually means
+     * re-creating the agent session — the consumer owns that lifecycle.
+     */
+    harness?: AgentSessionHarnessControl;
+    /** Per-turn model override, fed by the router's model catalog. */
+    model?: AgentSessionModelControl;
+    /** Thinking-effort level applied to subsequent turns. */
+    reasoning?: AgentSessionReasoningControl;
+    /** Right-aligned extra content (token meter, cost, status). */
+    trailing?: React.ReactNode;
+    className?: string;
+}
+/**
+ * Compact control strip for an agent chat composer: harness, model, and
+ * thinking-effort pickers in one row. Every section is optional and only
+ * renders when its control object is provided — never show a dead control.
+ *
+ * When BOTH harness and model controls are present the pair is kept
+ * coherent automatically (see harness-model-compat): picking a harness
+ * snaps an incompatible model to that harness's best catalog option;
+ * picking a model the current harness can't run switches to the model's
+ * native harness — unless the harness is `locked`, in which case the
+ * catalog itself is filtered to compatible models.
+ *
+ * Designed to slot into `SandboxWorkbench`'s `session.composerControls`.
+ */
+declare function AgentSessionControls({ harness, model, reasoning, trailing, className, }: 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;
+    /**
+     * 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.
+     */
+    preferred: ReadonlyArray<RegExp>;
+}
+declare const HARNESS_MODEL_POLICIES: 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.
+ */
+declare function isModelCompatibleWithHarness(harness: HarnessType, modelId: string): boolean;
+/**
+ * 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.
+ */
+declare function snapModelToHarness(harness: HarnessType, modelId: string, models: ReadonlyArray<ModelInfo>): string;
+/**
+ * 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.
+ */
+declare function snapHarnessToModel(harness: HarnessType, modelId: string): HarnessType;
+
 type ArtifactKind = string;
 interface ArtifactScope {
     kind: ArtifactKind;
@@ -116,4 +226,4 @@ declare function createFetchTransport(opts: {
     fetchImpl?: typeof fetch;
 }): ArtifactAgentDockTransport;
 
-export { 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 };
+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 };

package/dist/chat.js

@@ -1,27 +1,41 @@
 import {
+  AgentSessionControls,
   AgentTimeline,
   ArtifactAgentDock,
   ChatContainer,
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
+  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
   UserMessage,
-  createFetchTransport
-} from "./chunk-MQ52AYJX.js";
+  createFetchTransport,
+  isModelCompatibleWithHarness,
+  modelProvider,
+  snapHarnessToModel,
+  snapModelToHarness
+} from "./chunk-TAAYDQGM.js";
+import "./chunk-ESRYVGHF.js";
+import "./chunk-4KAPMTPU.js";
 import "./chunk-EI44GEQ5.js";
 export {
+  AgentSessionControls,
   AgentTimeline,
   ArtifactAgentDock,
   ChatContainer,
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
+  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
   UserMessage,
-  createFetchTransport
+  createFetchTransport,
+  isModelCompatibleWithHarness,
+  modelProvider,
+  snapHarnessToModel,
+  snapModelToHarness
 };