@tangle-network/sandbox-ui 0.21.0 → 0.21.1

package/dist/chat.d.ts

@@ -28,6 +28,15 @@ interface AgentSessionHarnessControl {
     /** 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"). */
@@ -65,10 +74,61 @@ interface AgentSessionControlsProps {
  * 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;
@@ -166,4 +226,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 };
+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

@@ -6,12 +6,17 @@ import {
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
+  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
   UserMessage,
-  createFetchTransport
-} from "./chunk-666PYT5K.js";
+  createFetchTransport,
+  isModelCompatibleWithHarness,
+  modelProvider,
+  snapHarnessToModel,
+  snapModelToHarness
+} from "./chunk-TAAYDQGM.js";
 import "./chunk-ESRYVGHF.js";
 import "./chunk-4KAPMTPU.js";
 import "./chunk-EI44GEQ5.js";
@@ -23,9 +28,14 @@ export {
   ChatInput,
   ChatMessage,
   DEFAULT_REASONING_LEVEL_OPTIONS,
+  HARNESS_MODEL_POLICIES,
   MessageList,
   ReasoningLevelPicker,
   ThinkingIndicator,
   UserMessage,
-  createFetchTransport
+  createFetchTransport,
+  isModelCompatibleWithHarness,
+  modelProvider,
+  snapHarnessToModel,
+  snapModelToHarness
 };