@stigmer/react 3.6.0 → 3.8.0

package/src/session/useSessionConversation.ts

@@ -17,6 +17,7 @@ import type {
   WorkspaceEntryInput,
 } from "@stigmer/sdk";
 import { isTerminalPhase } from "../execution/execution-phases.js";
+import type { ServiceTierOption } from "../models/service-tier.js";
 import { useStigmer } from "../hooks.js";
 import { toError } from "../internal/toError.js";
 import { useConversationStoreRef } from "../internal/store/index.js";
@@ -96,6 +97,16 @@ export interface SendFollowUpOptions {
    * - `"plan"`: read-only analysis, no file mutations.
    */
   readonly interactionMode?: "agent" | "plan";
+  /**
+   * Service tier for this execution's model calls (stigmer/stigmer#357).
+   *
+   * Only set when the user actively selected `"fast"`; `undefined` preserves
+   * the unspecified-vs-explicit distinction (unset resolves to standard on
+   * the platform side — never the provider account default).
+   *
+   * @see {@link CreateAgentExecutionInput.serviceTier}
+   */
+  readonly serviceTier?: ServiceTierOption;
   /**
    * Marks this execution as a Build-from-plan turn.
    *
@@ -642,6 +653,7 @@ export function useSessionConversation(
           runtimeEnv: options?.runtimeEnv,
           attachments: options?.attachments,
           interactionMode: options?.interactionMode,
+          serviceTier: options?.serviceTier,
           buildFromPlan: options?.buildFromPlan,
           autoApproveAll: options?.autoApproveAll,
           workspaceFileRefs: options?.workspaceFileRefs,

package/src/session/useSessionPageFlow.ts

@@ -438,6 +438,7 @@ export function useSessionPageFlow(
         runtimeEnv,
         attachments: context?.attachments,
         interactionMode: context?.interactionMode,
+        serviceTier: context?.serviceTier,
         buildFromPlan: context?.buildFromPlan,
         // Sourced from the session-scoped preference set at the approval gate,
         // not from the composer (the pre-arm toggle was removed).

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));

package/src/sidebar/WorkspaceSidebar.tsx

@@ -6,6 +6,7 @@ import {
   LayoutDashboard,
   Library,
   MessageSquare,
+  MessagesSquare,
   Workflow,
   type LucideIcon,
 } from "lucide-react";
@@ -29,7 +30,11 @@ import type { RenderSidebarLink } from "./types.js";
 // ---------------------------------------------------------------------------
 
 /** Primary navigation destinations in the workspace sidebar. */
-export type WorkspaceNavId = "new-session" | "dashboard" | "library";
+export type WorkspaceNavId =
+  | "new-session"
+  | "dashboard"
+  | "conversations"
+  | "library";
 
 /**
  * Recent-activity data for the sidebar's Recents section — the return
@@ -66,6 +71,14 @@ export interface WorkspaceSidebarProps {
    * timestamp column, inside the row.
    */
   readonly renderEntryAccessory?: (entry: RecentActivityEntry) => ReactNode;
+  /**
+   * Count for the Conversations row's badge: how many conversations
+   * want a human right now (`useConversationsWantsHumanCount`). Data as
+   * props per the chrome contract — hosts fetch, deterministic hosts
+   * (tours) pass a fixture or omit. Hidden at `0`/omitted; the display
+   * caps at "99+" while the accessible name keeps the real number.
+   */
+  readonly conversationsBadgeCount?: number;
   /** Footer content — typically the host app's `UserMenu` wrapper. */
   readonly footer: ReactNode;
   /** Reflected as `aria-expanded` on the collapse toggle. @default true */
@@ -85,8 +98,8 @@ export interface WorkspaceSidebarProps {
 
 /**
  * The console's workspace-zone sidebar: org switcher, primary navigation
- * (New Session / Dashboard / Library), time-bucketed recent activity,
- * and a user footer.
+ * (New Session / Dashboard / Conversations / Library), time-bucketed
+ * recent activity, and a user footer.
  *
  * This is the same component the Stigmer web console and desktop app
  * render — hosts differ only in what they return from `renderLink`
@@ -117,6 +130,7 @@ export function WorkspaceSidebar({
   activeSessionId = null,
   activeExecutionId = null,
   renderEntryAccessory,
+  conversationsBadgeCount,
   footer,
   isOpen = true,
   onCollapse,
@@ -154,6 +168,22 @@ export function WorkspaceSidebar({
         active={activeNav === "dashboard"}
         renderLink={renderLink}
       />
+      {/* MessagesSquare, deliberately not MessageSquare — the singular
+          mark is the session glyph in Recents, and the two areas must
+          not read as one. */}
+      <PrimaryNavRow
+        id="conversations"
+        href="/conversations"
+        label="Conversations"
+        icon={MessagesSquare}
+        active={activeNav === "conversations"}
+        renderLink={renderLink}
+        accessory={
+          conversationsBadgeCount !== undefined && conversationsBadgeCount > 0 ? (
+            <WantsHumanBadge count={conversationsBadgeCount} />
+          ) : null
+        }
+      />
       <PrimaryNavRow
         id="library"
         href="/library"
@@ -204,6 +234,7 @@ function PrimaryNavRow({
   icon: Icon,
   active,
   renderLink,
+  accessory = null,
 }: {
   readonly id: WorkspaceNavId;
   readonly href: string;
@@ -211,6 +242,8 @@ function PrimaryNavRow({
   readonly icon: LucideIcon;
   readonly active: boolean;
   readonly renderLink: RenderSidebarLink;
+  /** Trailing row content (e.g. the Conversations count pill). */
+  readonly accessory?: ReactNode;
 }) {
   return (
     <div className="flex-none px-3 py-1">
@@ -224,6 +257,7 @@ function PrimaryNavRow({
           <>
             <Icon className="size-4 shrink-0" />
             {label}
+            {accessory}
           </>
         ),
       })}
@@ -231,6 +265,31 @@ function PrimaryNavRow({
   );
 }
 
+/**
+ * The Conversations row's count pill: how many conversations want a
+ * human right now (DD-011 D-f — `needs_attention` OR awaiting-reply
+ * while human-held). The visible number caps at "99+"; the accessible
+ * name states the meaning with the real number, because a bare "104"
+ * read aloud after "Conversations" says nothing.
+ */
+function WantsHumanBadge({ count }: { readonly count: number }) {
+  return (
+    <span className="ml-auto flex shrink-0 items-center">
+      <span
+        aria-hidden="true"
+        className="bg-sidebar-primary text-sidebar-primary-foreground rounded-full px-1.5 py-0.5 text-[10px] leading-none font-semibold tabular-nums"
+      >
+        {count > 99 ? "99+" : count}
+      </span>
+      <span className="sr-only">
+        {count === 1
+          ? "1 conversation needs a human"
+          : `${count} conversations need a human`}
+      </span>
+    </span>
+  );
+}
+
 function ActivityGroupList({
   groups,
   activeSessionId,

package/src/sidebar/__tests__/WorkspaceSidebar.test.tsx

@@ -109,14 +109,69 @@ function baseProps() {
   };
 }
 
+describe("WorkspaceSidebar — Conversations badge (channel-conversations DD-011 D-f)", () => {
+  const conversationsRow = (container: HTMLElement) =>
+    container.querySelector<HTMLAnchorElement>('[data-row-id="conversations"]')!;
+
+  it("shows the wants-human count on the Conversations row with a meaning-stating accessible name", () => {
+    const { container } = renderSidebar(
+      <WorkspaceSidebar {...baseProps()} conversationsBadgeCount={3} />,
+    );
+
+    const row = conversationsRow(container);
+    expect(within(row).getByText("3")).toBeDefined();
+    expect(within(row).getByText("3 conversations need a human")).toBeDefined();
+  });
+
+  it("speaks the singular for one conversation", () => {
+    const { container } = renderSidebar(
+      <WorkspaceSidebar {...baseProps()} conversationsBadgeCount={1} />,
+    );
+
+    expect(
+      within(conversationsRow(container)).getByText("1 conversation needs a human"),
+    ).toBeDefined();
+  });
+
+  it("hides the badge at zero and when the host passes no count", () => {
+    const { container } = renderSidebar(
+      <WorkspaceSidebar {...baseProps()} conversationsBadgeCount={0} />,
+    );
+    expect(
+      within(conversationsRow(container)).queryByText(/need(s)? a human/),
+    ).toBeNull();
+
+    cleanup();
+
+    const { container: without } = renderSidebar(
+      <WorkspaceSidebar {...baseProps()} />,
+    );
+    expect(
+      within(conversationsRow(without)).queryByText(/need(s)? a human/),
+    ).toBeNull();
+  });
+
+  it("caps the visible number at 99+ while the accessible name keeps the real count", () => {
+    const { container } = renderSidebar(
+      <WorkspaceSidebar {...baseProps()} conversationsBadgeCount={104} />,
+    );
+
+    const row = conversationsRow(container);
+    expect(within(row).getByText("99+")).toBeDefined();
+    expect(within(row).queryByText("104")).toBeNull();
+    expect(within(row).getByText("104 conversations need a human")).toBeDefined();
+  });
+});
+
 describe("WorkspaceSidebar — primary navigation", () => {
-  it("renders the three primary rows through renderLink with stable ids and hrefs", () => {
+  it("renders the four primary rows through renderLink with stable ids and hrefs", () => {
     const { container } = renderSidebar(<WorkspaceSidebar {...baseProps()} />);
 
     const row = (id: string) =>
       container.querySelector<HTMLAnchorElement>(`[data-row-id="${id}"]`);
     expect(row("new-session")?.getAttribute("href")).toBe("/");
     expect(row("dashboard")?.getAttribute("href")).toBe("/dashboard");
+    expect(row("conversations")?.getAttribute("href")).toBe("/conversations");
     expect(row("library")?.getAttribute("href")).toBe("/library");
   });
 

package/src/workflow/__tests__/inspector-forms.test.tsx

@@ -34,15 +34,132 @@ describe("AgentCallForm", () => {
     expect(textarea.value).toBe("Hello world");
   });
 
-  it("renders model input from nested config", () => {
+  it("renders model input from the run_config block", () => {
     const node = makeNode(WorkflowTaskKind.agent_call, {
       agent: "x",
       message: "y",
-      config: { model: "claude-sonnet-4", timeout: 120 },
+      run_config: { model_name: "claude-sonnet-4", max_cost_usd: 0.5 },
     });
     render(<AgentCallForm node={node} onFieldChange={vi.fn()} />);
     const input = screen.getByTestId("agent-call-model-input") as HTMLInputElement;
     expect(input.value).toBe("claude-sonnet-4");
+    const budget = screen.getByTestId("agent-call-budget-input") as HTMLInputElement;
+    expect(budget.value).toBe("0.5");
+  });
+
+  it("emits an undefined run_config when the last field is cleared", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      run_config: { max_cost_usd: 0.5 },
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    const budget = screen.getByTestId("agent-call-budget-input") as HTMLInputElement;
+    fireEvent.change(budget, { target: { value: "" } });
+
+    // Empty means omit: a blank field must not persist a zero override.
+    expect(onFieldChange).toHaveBeenCalledWith("run_config", undefined);
+  });
+
+  it("writes budget changes into run_config.max_cost_usd", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      run_config: { model_name: "claude-sonnet-4" },
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    const budget = screen.getByTestId("agent-call-budget-input") as HTMLInputElement;
+    fireEvent.change(budget, { target: { value: "1.25" } });
+
+    expect(onFieldChange).toHaveBeenCalledWith("run_config", {
+      model_name: "claude-sonnet-4",
+      max_cost_usd: 1.25,
+    });
+  });
+
+  it("renders workspace entries and edits the git url in place", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      workspace_entries: [
+        { name: "app", source: { git_repo: { url: "https://github.com/acme/app", branch: "main" } } },
+      ],
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    const url = screen.getByTestId("agent-call-workspace-url-0") as HTMLInputElement;
+    expect(url.value).toBe("https://github.com/acme/app");
+
+    fireEvent.change(url, { target: { value: "https://github.com/acme/other" } });
+    expect(onFieldChange).toHaveBeenCalledWith("workspace_entries", [
+      { name: "app", source: { git_repo: { url: "https://github.com/acme/other", branch: "main" } } },
+    ]);
+  });
+
+  it("adds a workspace entry row", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, { agent: "x", message: "y" });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    fireEvent.click(screen.getByTestId("agent-call-workspace-add"));
+    expect(onFieldChange).toHaveBeenCalledWith("workspace_entries", [
+      { source: { git_repo: { url: "" } } },
+    ]);
+  });
+
+  it("emits undefined when the last workspace entry is removed", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      workspace_entries: [
+        { source: { git_repo: { url: "https://github.com/acme/app" } } },
+      ],
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    fireEvent.click(screen.getByLabelText("Remove workspace entry 1"));
+    expect(onFieldChange).toHaveBeenCalledWith("workspace_entries", undefined);
+  });
+
+  it("edits environment references as org/slug rows with empty-org omitted", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      environment_refs: [{ slug: "shared-secrets" }],
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    const slug = screen.getByTestId("agent-call-envref-slug-0") as HTMLInputElement;
+    expect(slug.value).toBe("shared-secrets");
+
+    fireEvent.change(slug, { target: { value: "other-secrets" } });
+    // Empty org stays omitted — an empty string must not become a stored
+    // org override (relative refs resolve to the workflow's own org).
+    expect(onFieldChange).toHaveBeenCalledWith("environment_refs", [
+      { slug: "other-secrets" },
+    ]);
+  });
+
+  it("adds and removes environment reference rows", () => {
+    const onFieldChange = vi.fn();
+    const node = makeNode(WorkflowTaskKind.agent_call, {
+      agent: "x",
+      message: "y",
+      environment_refs: [{ slug: "a" }, { org: "acme", slug: "b" }],
+    });
+    render(<AgentCallForm node={node} onFieldChange={onFieldChange} />);
+
+    fireEvent.click(screen.getByLabelText("Remove environment reference 1"));
+    expect(onFieldChange).toHaveBeenCalledWith("environment_refs", [
+      { org: "acme", slug: "b" },
+    ]);
   });
 
   it("shows structured output section when output is present", () => {