@stigmer/react 3.7.0 → 3.9.0

package/src/models/ModelSelector.tsx

@@ -4,6 +4,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Popover } from "@base-ui/react/popover";
 import { cn } from "@stigmer/theme";
 import { useStigmerPortalContainer } from "../portal-container.js";
+import { Switch } from "../switch/Switch.js";
 import { useModelRegistry } from "./useModelRegistry.js";
 import type { ModelInfo, CostTier, SpeedTier } from "./registry.js";
 import { HARNESS_META, HARNESS_OPTIONS, type HarnessOption } from "./harness.js";
@@ -80,11 +81,17 @@ export interface ModelSelectorProps {
   readonly serviceTier?: ServiceTierOption;
   /**
    * Called when the user toggles the fast tier. Providing this enables the
-   * tier toggle, which renders ONLY when the selected model prices a fast
-   * variant ({@link ModelInfo.serviceTiers}) — no dead controls. Selecting
-   * a model without a fast tier while "fast" is active resets the tier to
-   * "standard" through this callback, so an unsupported combination can
-   * never be submitted.
+   * "Fast tier" switch in the popover's options area (top of the popover,
+   * beside the harness row — the Cursor options-panel convention), which
+   * renders ONLY while the selected model prices a fast variant
+   * ({@link ModelInfo.serviceTiers}) — no dead controls.
+   *
+   * An active fast tier persists across switches between fast-capable
+   * models (the tier is always visible: trigger badge + options switch),
+   * so "fast, but on that other model" is one action, not a re-toggle.
+   * Selecting a model without a fast tier resets to "standard" through
+   * this callback — an unsupported combination can never be submitted
+   * (#357, refused at create time).
    */
   readonly onServiceTierChange?: (tier: ServiceTierOption) => void;
 
@@ -105,6 +112,19 @@ export interface ModelSelectorProps {
  * The trigger button displays the current selection in compact format:
  * `Harness · Model Name ▾` (or just `Model Name ▾` when harness is locked).
  *
+ * **Service tier (#357).** When the consumer opts in via
+ * {@link ModelSelectorProps.onServiceTierChange} and the selected model
+ * prices a fast variant, a "Fast tier" switch renders in the options area
+ * at the TOP of the popover — the first thing visible on open, mirroring
+ * Cursor's own options panel (Jakob's Law: our users already know that
+ * layout). Deliberately not a per-row affordance: row-level chips crowd
+ * the rows and collide with the "Fast/Fastest" speed badge, and an
+ * interactive element inside `role="option"` is an ARIA authoring error
+ * (option children are presentational). An active fast tier persists
+ * across switches between fast-capable models — the visible badge and
+ * switch keep the state honest — and resets only for models with no fast
+ * variant, where it would be refused at create time.
+ *
  * @example
  * ```tsx
  * <ModelSelector
@@ -245,9 +265,11 @@ export function ModelSelector({
   const selectModel = useCallback(
     (model: ModelInfo) => {
       onValueChange(model.modelId);
-      // Fail-safe: the fast tier is per-model; carrying it onto a model
-      // that does not price it would be refused at create time (#357), so
-      // reset here instead of surfacing a dead selection.
+      // An active fast tier survives a switch between fast-capable models —
+      // resetting it forced users to re-toggle on every model change, and
+      // the tier is never silent (trigger badge + options switch both show
+      // it). It resets ONLY when the new model prices no fast variant: a
+      // stale tier there would be refused at create time (#357).
       if (
         serviceTier === "fast"
         && onServiceTierChange
@@ -268,7 +290,7 @@ export function ModelSelector({
   }, []);
 
   const handleKeyDown = useCallback(
-    (e: React.KeyboardEvent) => {
+    (e: React.KeyboardEvent<HTMLInputElement>) => {
       const len = visibleModels.length;
       if (len === 0) return;
 
@@ -304,14 +326,18 @@ export function ModelSelector({
 
   const showShowAllButton = !isSearching && !showAll && featuredModels.length > 0 && featuredModels.length < models.length;
 
-  // The tier toggle exists only where it applies: a consumer opted in AND
-  // the selected model prices a fast variant (recognition over recall —
-  // never a dead control on models with no tier choice).
+  // The options-area switch exists only where it applies: a consumer opted
+  // in AND the selected model prices a fast variant (recognition over
+  // recall — never a dead control on models with no tier choice).
   const showServiceTierToggle =
     onServiceTierChange !== undefined
     && selectedModel !== undefined
     && selectedModel.serviceTiers.includes(FAST_SERVICE_TIER);
-  const fastActive = serviceTier === "fast";
+  // The trigger badge is display-only: fast is in effect iff the tier is
+  // fast AND the selected model actually prices the variant.
+  const fastActive =
+    serviceTier === "fast"
+    && (selectedModel?.serviceTiers.includes(FAST_SERVICE_TIER) ?? false);
 
   const usingPlaceholder = !value && placeholderLabel !== undefined;
   const triggerLabel = usingPlaceholder
@@ -342,13 +368,14 @@ export function ModelSelector({
           <span className="shrink-0 text-border" aria-hidden>·</span>
         )}
         <span className="truncate">{triggerLabel}</span>
-        {showServiceTierToggle && fastActive && (
+        {fastActive && (
           <span
             className={cn(
-              "shrink-0 rounded-sm border border-border px-1 py-px",
-              "text-[0.6rem] font-medium uppercase tracking-wider text-muted-foreground",
+              "inline-flex shrink-0 items-center gap-0.5 rounded-full border border-primary px-1.5 py-px",
+              "text-[0.6rem] font-medium uppercase tracking-wider text-primary",
             )}
           >
+            <BoltIcon />
             Fast
           </span>
         )}
@@ -433,6 +460,29 @@ export function ModelSelector({
               )}
             </div>
 
+            {/* Options area — the Cursor options-panel convention: settings
+                of the CURRENT selection sit at the top of the popover, the
+                first thing visible on open, never buried under the list.
+                Rendered only while the selected model prices a fast
+                variant (#357). */}
+            {showServiceTierToggle && (
+              <div className="flex items-center justify-between border-b border-border px-3 py-2">
+                <div className="flex flex-col">
+                  <span className="text-xs text-foreground">Fast tier</span>
+                  <span className="text-[0.65rem] text-muted-foreground">
+                    Faster responses at higher per-token rates
+                  </span>
+                </div>
+                <Switch
+                  checked={fastActive}
+                  onCheckedChange={(next) =>
+                    onServiceTierChange?.(next ? "fast" : "standard")
+                  }
+                  aria-label="Fast tier"
+                />
+              </div>
+            )}
+
             {/* Search input */}
             <div className="border-b border-border px-3 py-1.5">
               <input
@@ -535,39 +585,6 @@ export function ModelSelector({
                 </button>
               )}
             </div>
-
-            {/* Service tier toggle — only for models that price a fast variant (#357) */}
-            {showServiceTierToggle && (
-              <div className="flex items-center justify-between border-t border-border px-3 py-2">
-                <div className="flex flex-col">
-                  <span className="text-xs text-foreground">Fast tier</span>
-                  <span className="text-[0.65rem] text-muted-foreground">
-                    Faster responses at higher per-token rates
-                  </span>
-                </div>
-                <button
-                  type="button"
-                  role="switch"
-                  aria-checked={fastActive}
-                  aria-label="Fast tier"
-                  className={cn(
-                    "relative h-4.5 w-8 shrink-0 rounded-full transition-colors cursor-pointer",
-                    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
-                    fastActive ? "bg-primary" : "bg-muted",
-                  )}
-                  onClick={() =>
-                    onServiceTierChange?.(fastActive ? "standard" : "fast")
-                  }
-                >
-                  <span
-                    className={cn(
-                      "absolute top-0.5 size-3.5 rounded-full bg-background shadow-sm transition-transform",
-                      fastActive ? "translate-x-4" : "translate-x-0.5",
-                    )}
-                  />
-                </button>
-              </div>
-            )}
           </Popover.Popup>
         </Popover.Positioner>
       </Popover.Portal>
@@ -665,3 +682,18 @@ function CheckIcon({ className }: { className?: string }) {
     </svg>
   );
 }
+
+function BoltIcon() {
+  return (
+    <svg
+      className="shrink-0"
+      width="8"
+      height="10"
+      viewBox="0 0 8 10"
+      fill="currentColor"
+      aria-hidden
+    >
+      <path d="M4.9 0.2L0.6 5.6h2.6L3.1 9.8l4.3-5.4H4.8L4.9 0.2z" />
+    </svg>
+  );
+}

package/src/models/__tests__/ModelSelector-serviceTier.test.tsx

@@ -23,12 +23,16 @@ beforeAll(() => {
 });
 
 /**
- * Service-tier toggle gating (stigmer/stigmer#357).
+ * Fast-tier switch in the popover's options area (stigmer/stigmer#357).
  *
- * The toggle is capability-gated: it renders only when the consumer opted in
- * (onServiceTierChange) AND the selected model prices a fast variant
- * (ModelInfo.serviceTiers). Switching to a model without a fast tier resets
- * an active fast selection — a stale tier would be refused at create time.
+ * The switch sits at the TOP of the popover (the Cursor options-panel
+ * convention) and is capability-gated: it renders only when the consumer
+ * opted in (onServiceTierChange) AND the selected model prices a fast
+ * variant (ModelInfo.serviceTiers) — no dead controls. An active fast
+ * tier persists across switches between fast-capable models (the trigger
+ * badge and the switch keep the state visible), and resets ONLY when the
+ * chosen model prices no fast variant — a stale tier there would be
+ * refused at create time.
  */
 
 const FAST_CAPABLE: ModelInfo = {
@@ -43,6 +47,18 @@ const FAST_CAPABLE: ModelInfo = {
   serviceTiers: ["fast"],
 };
 
+const ALSO_FAST_CAPABLE: ModelInfo = {
+  modelId: "claude-opus-4-8",
+  provider: "anthropic",
+  displayName: "Claude 4.8 Opus",
+  shortDescription: "Frontier Opus via Cursor",
+  speedTier: "slow",
+  costTier: "premium",
+  harness: "cursor",
+  featured: true,
+  serviceTiers: ["fast"],
+};
+
 const NO_FAST_TIER: ModelInfo = {
   modelId: "claude-haiku-4-5",
   provider: "anthropic",
@@ -64,7 +80,7 @@ function renderSelector(
   const result = render(
     <ModelRegistryContext.Provider
       value={{
-        models: [FAST_CAPABLE, NO_FAST_TIER],
+        models: [FAST_CAPABLE, ALSO_FAST_CAPABLE, NO_FAST_TIER],
         isLoading: false,
         error: null,
         refetch: vi.fn(),
@@ -106,8 +122,8 @@ function modelOption(displayName: string): HTMLElement {
 
 afterEach(cleanup);
 
-describe("ModelSelector — service tier toggle", () => {
-  it("renders the toggle for a fast-capable model", async () => {
+describe("ModelSelector — fast tier switch in the options area", () => {
+  it("renders the switch for a fast-capable selected model", async () => {
     renderSelector();
     await openPopover("Composer 2.5");
 
@@ -115,14 +131,28 @@ describe("ModelSelector — service tier toggle", () => {
     expect(toggle.getAttribute("aria-checked")).toBe("false");
   });
 
-  it("does not render the toggle for a model without a fast tier", async () => {
+  it("places the switch in the options area above the model list", async () => {
+    renderSelector();
+    await openPopover("Composer 2.5");
+
+    const toggle = screen.getByRole("switch", { name: "Fast tier" });
+    const search = screen.getByRole("searchbox", { name: "Search models" });
+    // DOCUMENT_POSITION_FOLLOWING: the search input comes after the switch,
+    // i.e. the options area precedes search + list (never a footer).
+    expect(
+      toggle.compareDocumentPosition(search)
+        & Node.DOCUMENT_POSITION_FOLLOWING,
+    ).toBeTruthy();
+  });
+
+  it("does not render the switch for a model without a fast tier", async () => {
     renderSelector({ value: "claude-haiku-4-5" });
     await openPopover("Haiku 4.5");
 
     expect(screen.queryByRole("switch", { name: "Fast tier" })).toBeNull();
   });
 
-  it("does not render the toggle when the consumer did not opt in", async () => {
+  it("does not render the switch when the consumer did not opt in", async () => {
     renderSelector({ onServiceTierChange: undefined });
     await openPopover("Composer 2.5");
 
@@ -138,35 +168,89 @@ describe("ModelSelector — service tier toggle", () => {
     expect(onServiceTierChange).toHaveBeenCalledWith("fast");
   });
 
+  it("toggling off an active fast tier fires 'standard'", async () => {
+    const { onServiceTierChange } = renderSelector({ serviceTier: "fast" });
+    await openPopover("Composer 2.5");
+
+    fireEvent.click(screen.getByRole("switch", { name: "Fast tier" }));
+    expect(onServiceTierChange).toHaveBeenCalledOnce();
+    expect(onServiceTierChange).toHaveBeenCalledWith("standard");
+  });
+
+  it("keeps the popover open across a toggle", async () => {
+    renderSelector();
+    await openPopover("Composer 2.5");
+
+    fireEvent.click(screen.getByRole("switch", { name: "Fast tier" }));
+    expect(screen.getByPlaceholderText("Search models…")).toBeTruthy();
+  });
+});
+
+describe("ModelSelector — trigger badge", () => {
   it("shows the Fast badge on the trigger when the fast tier is active", () => {
     renderSelector({ serviceTier: "fast" });
 
     expect(screen.getByText("Fast")).toBeTruthy();
   });
 
-  it("resets an active fast tier when selecting a model without one", async () => {
+  it("hides the badge when the selected model has no fast tier", () => {
+    renderSelector({ serviceTier: "fast", value: "claude-haiku-4-5" });
+
+    expect(screen.queryByText("Fast")).toBeNull();
+  });
+});
+
+describe("ModelSelector — fast tier persistence across model switches", () => {
+  it("selecting a model while standard emits no tier change", async () => {
+    const { onValueChange, onServiceTierChange } = renderSelector();
+    await openPopover("Composer 2.5");
+
+    fireEvent.click(modelOption("Composer 2.5"));
+
+    expect(onValueChange).toHaveBeenCalledWith("composer-2.5");
+    expect(onServiceTierChange).not.toHaveBeenCalled();
+  });
+
+  it("keeps an active fast tier when selecting another fast-capable model", async () => {
+    // "Fast, but on that other model" is one action — resetting here made
+    // users re-toggle on every model change, and the tier is never silent
+    // (trigger badge + options switch both show it).
     const { onValueChange, onServiceTierChange } = renderSelector({
       serviceTier: "fast",
     });
     await openPopover("Composer 2.5");
 
-    fireEvent.click(modelOption("Haiku 4.5"));
+    fireEvent.click(modelOption("Claude 4.8 Opus"));
+
+    expect(onValueChange).toHaveBeenCalledWith("claude-opus-4-8");
+    expect(onServiceTierChange).not.toHaveBeenCalled();
+  });
+
+  it("toggle-then-pick works in a single popover visit", async () => {
+    // Flip the switch first (popover stays open), then pick a fast-capable
+    // model: the toggle survives the selection.
+    const { onValueChange, onServiceTierChange } = renderSelector();
+    await openPopover("Composer 2.5");
+
+    fireEvent.click(screen.getByRole("switch", { name: "Fast tier" }));
+    fireEvent.click(modelOption("Claude 4.8 Opus"));
 
-    expect(onValueChange).toHaveBeenCalledOnce();
-    expect(onValueChange).toHaveBeenCalledWith("claude-haiku-4-5");
     expect(onServiceTierChange).toHaveBeenCalledOnce();
-    expect(onServiceTierChange).toHaveBeenCalledWith("standard");
+    expect(onServiceTierChange).toHaveBeenCalledWith("fast");
+    expect(onValueChange).toHaveBeenCalledWith("claude-opus-4-8");
   });
 
-  it("keeps an active fast tier when selecting another fast-capable model", async () => {
-    const { onServiceTierChange } = renderSelector({
+  it("resets an active fast tier when selecting a model without one", async () => {
+    const { onValueChange, onServiceTierChange } = renderSelector({
       serviceTier: "fast",
-      value: "claude-haiku-4-5",
     });
-    await openPopover("Haiku 4.5");
+    await openPopover("Composer 2.5");
 
-    fireEvent.click(modelOption("Composer 2.5"));
+    fireEvent.click(modelOption("Haiku 4.5"));
 
-    expect(onServiceTierChange).not.toHaveBeenCalled();
+    expect(onValueChange).toHaveBeenCalledOnce();
+    expect(onValueChange).toHaveBeenCalledWith("claude-haiku-4-5");
+    expect(onServiceTierChange).toHaveBeenCalledOnce();
+    expect(onServiceTierChange).toHaveBeenCalledWith("standard");
   });
 });

package/src/models/registry.ts

@@ -92,8 +92,9 @@ export interface ModelInfo {
   /**
    * Pricing-variant keys the registry prices for this model (e.g.
    * `["fast"]`). A priced variant is a *selectable* service tier
-   * (stigmer/stigmer#357): the tier toggle renders only for models whose
-   * `serviceTiers` includes it. Empty for models with no variants.
+   * (stigmer/stigmer#357): the fast-tier switch in the model popover's
+   * options area renders only while the selected model's `serviceTiers`
+   * includes it. Empty for models with no variants.
    *
    * Distinct from {@link speedTier}, which is a static latency badge,
    * not a selectable option.

package/src/models/service-tier.ts

@@ -11,7 +11,7 @@ import { ServiceTier } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v
  */
 export type ServiceTierOption = "standard" | "fast";
 
-/** The tier key a model must price for the fast toggle to render. */
+/** The tier key a model must price for the fast-tier switch to render. */
 export const FAST_SERVICE_TIER = "fast";
 
 /**

package/src/schedule/ScheduleDetailView.tsx

@@ -1206,7 +1206,7 @@ function normalizeRunConfig(
   if (modelName.trim() !== "") fields.modelName = modelName.trim();
   if (maxCostUsd > 0) fields.maxCostUsd = maxCostUsd;
   if (maxToolRounds > 0) fields.maxToolRounds = maxToolRounds;
-  // Only an active fast choice is carried — an untouched toggle stays
+  // Only an active fast choice is carried — an untouched tier stays
   // absent, preserving the unspecified-vs-explicit ledger distinction (#357).
   if (serviceTier === "fast") fields.serviceTier = toProtoServiceTier(serviceTier);
 

package/src/schedule/ScheduleForm.tsx

@@ -107,11 +107,12 @@ export function ScheduleForm({
   // the popover without picking a model pins nothing.
   const [modelName, setModelName] = useState("");
   const [modelHarness, setModelHarness] = useState<HarnessOption>("cursor");
-  // Service tier rides the model choice (#357): the ModelSelector renders
-  // the fast toggle only for models whose registry entry prices a fast
-  // variant, and resets it when the user switches to one that does not.
-  // No model pinned = no tier pinned (fast requires a model, and the form's
-  // reset button clears both).
+  // Service tier is scoped by the model choice (#357): the ModelSelector
+  // renders the fast-tier switch only while the selected model's registry
+  // entry prices a fast variant. An active fast tier survives switches
+  // between fast-capable models and resets only when a model without one
+  // is picked. No model pinned = no tier pinned (fast requires a model,
+  // and the form's reset button clears both).
   const [serviceTier, setServiceTier] = useState<ServiceTierOption>("standard");
 
   const [budgetUsd, setBudgetUsd] = useState("");
@@ -520,7 +521,7 @@ function buildRunConfig(
   if (Number.isFinite(cost) && cost > 0) config.maxCostUsd = cost;
   // Carried only when the user actively chose fast AND pinned a model
   // (fast is a per-model price; the server refuses it without one). An
-  // untouched toggle stays absent — unspecified-vs-explicit is a
+  // untouched tier stays absent — unspecified-vs-explicit is a
   // load-bearing ledger distinction (#357).
   if (serviceTier === "fast" && model !== "") {
     config.serviceTier = toProtoServiceTier(serviceTier);

package/src/schedule/__tests__/scheduleCreation.test.tsx

@@ -476,8 +476,8 @@ describe("ScheduleForm", () => {
     fireEvent.click(screen.getByRole("button", { name: /Platform default/ }));
     fireEvent.click(await screen.findByRole("option", { name: /Composer 2\.5/ }));
 
-    // The popover closed on selection; reopen it — the toggle renders only
-    // for the now-selected fast-capable model.
+    // The popover closed on selection; reopen it — the options-area switch
+    // renders only for the now-selected fast-capable model.
     fireEvent.click(screen.getByRole("button", { name: /Composer 2\.5/ }));
     fireEvent.click(await screen.findByRole("switch", { name: "Fast tier" }));
 

package/src/sharing/__tests__/useSaveAgentShare.test.tsx

@@ -6,6 +6,7 @@ import type { AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v
 import type { AgentShareInput } from "@stigmer/sdk";
 import { StigmerContext } from "../../context";
 import {
+  draftFromShare,
   sharingAudienceFromProto,
   useSaveAgentShare,
   type AgentShareDraft,
@@ -50,6 +51,7 @@ const FULL_DRAFT: AgentShareDraft = {
     conversationEnded: "This conversation has ended.",
   },
   environmentRefs: [{ org: "acme", slug: "github-org-shared" }],
+  runConfig: { modelName: "gpt-5-mini", maxCostUsd: 0.25 },
 };
 
 describe("useSaveAgentShare", () => {
@@ -88,6 +90,7 @@ describe("useSaveAgentShare", () => {
     expect(input.environmentRefs).toEqual([
       { org: "acme", slug: "github-org-shared" },
     ]);
+    expect(input.runConfig).toEqual({ modelName: "gpt-5-mini", maxCostUsd: 0.25 });
   });
 
   it("keeps the existing share's identity when editing (a renamed share is never forked)", async () => {
@@ -123,7 +126,15 @@ describe("useSaveAgentShare", () => {
 
     await act(() =>
       result.current.save(
-        { ...FULL_DRAFT, enabled: false, audience: "org", environmentRefs: [] },
+        // An org-audience share carries no environmentRefs or runConfig
+        // (both are public-audience-only by the proto CEL rules).
+        {
+          ...FULL_DRAFT,
+          enabled: false,
+          audience: "org",
+          environmentRefs: [],
+          runConfig: undefined,
+        },
         null,
       ),
     );
@@ -138,6 +149,49 @@ describe("useSaveAgentShare", () => {
     expect(input.audience).toBe(AgentShareAudience.org);
   });
 
+  it("a pause/resume toggle built from draftFromShare carries run_config (never wipes an API-set override)", async () => {
+    const apply = vi.fn().mockResolvedValue({});
+    const client = createMockStigmer({ apply });
+    // A share whose run_config was set via CLI/API — the console list's
+    // toggle rebuilds the full spec from draftFromShare, so the override
+    // must ride through even though no console surface edits it.
+    const share = {
+      metadata: { id: "ash_1", org: "acme", slug: "support-agent", name: "Support Agent" },
+      spec: {
+        enabled: true,
+        allowedOrigins: ["https://example.com"],
+        environmentRefs: [],
+        runConfig: { modelName: "gpt-5-mini", maxCostUsd: 0.25, maxToolRounds: 8 },
+      },
+    } as unknown as AgentShare;
+
+    const { result } = renderHook(() => useSaveAgentShare(AGENT), {
+      wrapper: wrapper(client),
+    });
+
+    await act(() =>
+      result.current.save({ ...draftFromShare(share), enabled: false }, share),
+    );
+
+    const input = apply.mock.calls[0][0] as AgentShareInput;
+    expect(input.enabled).toBe(false);
+    expect(input.runConfig).toEqual({
+      modelName: "gpt-5-mini",
+      maxCostUsd: 0.25,
+      maxToolRounds: 8,
+      serviceTier: undefined,
+    });
+  });
+
+  it("draftFromShare leaves run_config undefined when the share carries none", () => {
+    expect(draftFromShare(null).runConfig).toBeUndefined();
+    const bare = {
+      metadata: { id: "ash_2", org: "acme", slug: "bare" },
+      spec: { enabled: true },
+    } as AgentShare;
+    expect(draftFromShare(bare).runConfig).toBeUndefined();
+  });
+
   it("maps the audience union to the proto enum, writing public explicitly", async () => {
     const apply = vi.fn().mockResolvedValue({});
     const client = createMockStigmer({ apply });

package/src/sharing/__tests__/useShareToolReadiness.test.tsx

@@ -34,6 +34,7 @@ function makeDraft(overrides?: {
     allowedOrigins: [],
     messages: { rateLimited: "", unavailable: "", conversationEnded: "" },
     environmentRefs: overrides?.environmentRefs ?? [],
+    runConfig: undefined,
   };
 }
 

package/src/sharing/useSaveAgentShare.ts

@@ -4,7 +4,7 @@ import { useCallback, useState } from "react";
 import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
 import type { AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
 import { AgentShareAudience } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/spec_pb";
-import type { ResourceRef } from "@stigmer/sdk";
+import type { ResourceRef, RunConfigInput } from "@stigmer/sdk";
 import { useStigmer } from "../hooks.js";
 import { toError } from "../internal/toError.js";
 
@@ -57,6 +57,15 @@ export interface AgentShareDraft {
    * sessions carry no share linkage in Phase A — decision 011 addendum).
    */
   readonly environmentRefs: readonly ResourceRef[];
+  /**
+   * The owner's per-share execution override (model / cost cap / tool
+   * rounds / service tier), merged over the platform guest profile at
+   * run time — stigmer/stigmer#360. The console does not edit it (yet):
+   * it rides through every save opaquely so a toggle never wipes an
+   * override set via the CLI or API. Public-audience only (the same
+   * proto CEL rule as environmentRefs, for the same reason).
+   */
+  readonly runConfig: RunConfigInput | undefined;
 }
 
 /**
@@ -103,6 +112,14 @@ export function draftFromShare(share: AgentShare | null): AgentShareDraft {
       org: ref.org,
       slug: ref.slug,
     })),
+    runConfig: spec?.runConfig
+      ? {
+          modelName: spec.runConfig.modelName,
+          maxCostUsd: spec.runConfig.maxCostUsd,
+          maxToolRounds: spec.runConfig.maxToolRounds,
+          serviceTier: spec.runConfig.serviceTier,
+        }
+      : undefined,
   };
 }
 
@@ -229,6 +246,7 @@ export function useSaveAgentShare(
             org: ref.org,
             slug: ref.slug,
           })),
+          runConfig: draft.runConfig,
         });
       } catch (err) {
         setError(toError(err));