@stigmer/react 3.12.5 → 3.12.7

package/settings/index.js

@@ -6,6 +6,7 @@ export { MembersSection } from "./MembersSection.js";
 export { OrgProfileSection } from "./OrgProfileSection.js";
 export { OrgPreferencesSection } from "./OrgPreferencesSection.js";
 export { AccountPreferencesSection } from "./AccountPreferencesSection.js";
+export { MemorySection } from "./MemorySection.js";
 export { EnvironmentsSection } from "./EnvironmentsSection.js";
 export { InvitationsSection } from "./InvitationsSection.js";
 export { IdentityProvidersSection } from "./IdentityProvidersSection.js";

package/settings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/settings/settings-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-nav.d.ts","sourceRoot":"","sources":["../../src/settings/settings-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAoB3C,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAC3B,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C;AAED,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EA4D1D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAwBzC,CAAC"}
+{"version":3,"file":"settings-nav.d.ts","sourceRoot":"","sources":["../../src/settings/settings-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAqB3C,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAC3B,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C;AAED,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EA6D1D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAwBzC,CAAC"}

package/settings/settings-nav.js

@@ -1,4 +1,4 @@
-import { Activity, AppWindow, BarChart3, Box, Building2, CreditCard, KeyRound, Link, MessageSquare, MousePointerClick, Plug, Scale, ShieldCheck, SlidersHorizontal, UserCog, Users, } from "lucide-react";
+import { Activity, AppWindow, BarChart3, Box, Brain, Building2, CreditCard, KeyRound, Link, MessageSquare, MousePointerClick, Plug, Scale, ShieldCheck, SlidersHorizontal, UserCog, Users, } from "lucide-react";
 /** Canonical settings sidebar/grouped navigation model. */
 export const SETTINGS_NAV_GROUPS = [
     {
@@ -56,6 +56,7 @@ export const SETTINGS_NAV_GROUPS = [
                 label: "Preferences",
                 icon: UserCog,
             },
+            { href: "/settings/memory", label: "Memory", icon: Brain },
         ],
     },
 ];

package/settings/settings-nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-nav.js","sourceRoot":"","sources":["../../src/settings/settings-nav.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,GAAG,EACH,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,KAAK,GACN,MAAM,cAAc,CAAC;AAiCtB,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,kEAAkE;QACpE,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;YACxE;gBACE,IAAI,EAAE,2BAA2B;gBACjC,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,iBAAiB;aACxB;YACD,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5D,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;YACnE;gBACE,IAAI,EAAE,8BAA8B;gBACpC,KAAK,EAAE,oBAAoB;gBAC3B,IAAI,EAAE,WAAW;aAClB;SACF;KACF;IACD;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mFAAmF;QACrF,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjE;gBACE,IAAI,EAAE,4BAA4B;gBAClC,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,IAAI;aACX;YACD,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE;YACpE,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;YACtE;gBACE,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE,cAAc;gBACrB,IAAI,EAAE,aAAa;aACpB;SACF;KACF;IACD;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,sCAAsC;QACnD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE;YACjE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SAC7D;KACF;IACD;QACE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,0DAA0D;QACvE,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,+BAA+B;gBACrC,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,OAAO;aACd;SACF;KACF;CACF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAqB;IAC3D,KAAK,EAAE,UAAU;IACjB,WAAW,EACT,kEAAkE;IACpE,KAAK,EAAE;QACL;YACE,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,oBAAoB;YAC3B,IAAI,EAAE,KAAK;YACX,kBAAkB,EAAE,0BAA0B;SAC/C;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,iBAAiB;YACvB,kBAAkB,EAAE,4BAA4B;SACjD;QACD;YACE,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,QAAQ;YACd,kBAAkB,EAAE,4BAA4B;SACjD;KACF;CACF,CAAC"}
+{"version":3,"file":"settings-nav.js","sourceRoot":"","sources":["../../src/settings/settings-nav.ts"],"names":[],"mappings":"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"}

package/src/__tests__/public-api.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+
+import type { SessionRunConfig } from "../index.js";
+
+// Root-surface pin (oss#802): the package's exports map exposes only the root
+// barrel, so a type an embedder must name has to be re-exported from
+// src/index.ts. The type-only import above is enforced by the typecheck gate
+// (`tsc --noEmit`), which fails this file if the root export regresses —
+// vitest alone would not catch it (esbuild strips types unchecked).
+describe("public API surface", () => {
+  it("SessionRunConfig is importable from the package root", () => {
+    // Compile-time is the real assertion; construct a value against the type
+    // so the import cannot be flagged unused.
+    const pinned: SessionRunConfig = {
+      modelName: "claude-opus-5",
+      serviceTier: "fast",
+      thinkingMode: "enabled",
+    };
+    expect(pinned.modelName).toBe("claude-opus-5");
+  });
+});

package/src/agent/AgentDetailView.tsx

@@ -13,7 +13,7 @@ import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinst
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import { useAgent } from "./useAgent.js";
 import { useUpdateAgent } from "./useUpdateAgent.js";
-import { agentToInput } from "./internal/agentToInput.js";
+import { toAgentUpdateInput } from "@stigmer/sdk";
 import { toError } from "../internal/toError.js";
 import { ErrorMessage } from "../error/ErrorMessage.js";
 import { VisibilityBadge } from "../library/VisibilitySelector.js";
@@ -253,7 +253,7 @@ export function AgentDetailView({
     ): Promise<boolean> => {
       if (!agent) return false;
       setSaveError(null);
-      const input = agentToInput(agent);
+      const input = toAgentUpdateInput(agent);
       (input as unknown as Record<string, unknown>)[field] = value;
       try {
         const updated = await update(input);

package/src/agent/index.ts

@@ -54,8 +54,6 @@ export type { UseCreateAgentReturn } from "./useCreateAgent.js";
 export { useUpdateAgent } from "./useUpdateAgent.js";
 export type { UseUpdateAgentReturn } from "./useUpdateAgent.js";
 
-export { agentToInput } from "./internal/agentToInput.js";
-
 export { AgentCreationWizard } from "./AgentCreationWizard.js";
 export type {
   AgentCreationWizardProps,

package/src/agent/useUpdateAgent.ts

@@ -23,9 +23,9 @@ export interface UseUpdateAgentReturn {
  *
  * Wraps `stigmer.agent.update(input)` with loading and error state.
  * The caller must provide a **complete** `AgentInput` — the backend
- * performs full spec replacement. Use `agentToInput()` to reconstruct
- * the input from a fetched agent, modify the desired field, and pass
- * the result here.
+ * performs full spec replacement. Use `toAgentUpdateInput()` (from
+ * `@stigmer/sdk`) to reconstruct the input from a fetched agent, modify
+ * the desired field, and pass the result here.
  */
 export function useUpdateAgent(): UseUpdateAgentReturn {
   const stigmer = useStigmer();

package/src/agent-instance/AgentInstanceDetailPanel.tsx

@@ -8,7 +8,7 @@ import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinst
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import type { ResourceRef } from "@stigmer/sdk";
-import { getUserMessage } from "@stigmer/sdk";
+import { getUserMessage, toAgentInstanceUpdateInput } from "@stigmer/sdk";
 import { useUpdateAgentInstance } from "./useUpdateAgentInstance.js";
 import { useDeleteAgentInstance } from "./useDeleteAgentInstance.js";
 import { VisibilityBadge } from "../library/VisibilitySelector.js";
@@ -75,20 +75,18 @@ export function AgentInstanceDetailPanel({
 
   const handleSaveEnvs = useCallback(async () => {
     try {
+      // Full-spec-replace safety: spread the complete mapped input so
+      // any spec field this form does not edit survives the save.
       await update({
-        name: meta?.name ?? "",
-        org: meta?.org ?? org,
-        agentId: spec?.agentId ?? "",
-        description: spec?.description,
+        ...toAgentInstanceUpdateInput(instance),
         environmentRefs: editEnvRefs,
-        visibility: meta?.visibility,
       });
       setIsEditingEnvs(false);
       onUpdated?.();
     } catch {
       // error displayed by hook
     }
-  }, [update, meta, spec, org, editEnvRefs, onUpdated]);
+  }, [update, instance, editEnvRefs, onUpdated]);
 
   const handleDelete = useCallback(async () => {
     setDeleteError(null);

package/src/agent-instance/__tests__/AgentInstanceDetailPanel.test.tsx

@@ -0,0 +1,75 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { create } from "@bufbuild/protobuf";
+import {
+  AgentInstanceSchema,
+  type AgentInstance,
+} from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import type { AgentInstanceInput } from "@stigmer/sdk";
+import { StigmerContext } from "../../context";
+import { AgentInstanceDetailPanel } from "../AgentInstanceDetailPanel";
+
+/**
+ * Regression suite for the full-spec-replace wipe bug: the environment
+ * editor must spread `toAgentInstanceUpdateInput` and override only the
+ * environment refs, so agent_id/description (and any future spec field)
+ * survive an environments-only save.
+ */
+
+const INSTANCE: AgentInstance = create(AgentInstanceSchema, {
+  metadata: {
+    id: "inst-1",
+    name: "Prod Support Bot",
+    slug: "prod-support-bot",
+    org: "acme",
+  },
+  spec: {
+    agentId: "agent-1",
+    description: "Production instance.",
+    environmentRefs: [
+      { org: "acme", slug: "prod", kind: ApiResourceKind.environment },
+    ],
+  },
+});
+
+function renderPanel(update: ReturnType<typeof vi.fn>) {
+  const client = {
+    agentInstance: { update },
+    iamPolicy: {
+      checkMyPermission: vi.fn(async () => ({ isAuthorized: true })),
+    },
+    environment: {
+      list: vi.fn(async () => ({ items: [], totalCount: 0 })),
+    },
+  } as never;
+  return render(
+    <StigmerContext.Provider value={client}>
+      <AgentInstanceDetailPanel instance={INSTANCE} org="acme" onClose={() => {}} />
+    </StigmerContext.Provider>,
+  );
+}
+
+afterEach(cleanup);
+
+describe("AgentInstanceDetailPanel save payload", () => {
+  it("round-trips agent_id and description on an environments-only save", async () => {
+    const update = vi.fn(async (_input: AgentInstanceInput) => INSTANCE);
+    renderPanel(update);
+
+    fireEvent.click(await screen.findByRole("button", { name: "Edit" }));
+    fireEvent.click(screen.getByRole("button", { name: "Save" }));
+
+    await waitFor(() => expect(update).toHaveBeenCalledTimes(1));
+    const input = update.mock.calls[0]![0];
+
+    // The wipe-bug guard: fields the environment editor does not render.
+    expect(input.agentId).toBe("agent-1");
+    expect(input.description).toBe("Production instance.");
+    // The form-owned field.
+    expect(input.environmentRefs).toEqual([{ org: "acme", slug: "prod" }]);
+    // Addressing fields.
+    expect(input.org).toBe("acme");
+    expect(input.slug).toBe("prod-support-bot");
+  });
+});

package/src/agent-instance/useUpdateAgentInstance.ts

@@ -32,7 +32,7 @@ export interface UseUpdateAgentInstanceReturn {
  *
  * const handleSave = async () => {
  *   await update({
- *     ...agentInstanceToInput(instance),
+ *     ...toAgentInstanceUpdateInput(instance),
  *     environmentRefs: newRefs,
  *   });
  *   refetch();

package/src/channel/AgentChannelsPanel.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { useCallback, useState } from "react";
-import { FileCode2, KeyRound, LayoutTemplate, MessageSquare, MoreHorizontal, Share2, Trash2 } from "lucide-react";
+import { FileCode2, KeyRound, LayoutTemplate, MessageSquare, MoreHorizontal, Share2, SlidersHorizontal, Trash2 } from "lucide-react";
 import { cn } from "@stigmer/theme";
 import { getUserMessage } from "@stigmer/sdk";
 import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
@@ -25,6 +25,7 @@ import { CloudFeatureNotice } from "../internal/CloudFeatureNotice.js";
 import { TruncatedText } from "../internal/truncated-text.js";
 import { ChannelConversationsDialog } from "./ChannelConversationsDialog.js";
 import { ChannelCredentialsDialog } from "./ChannelCredentialsDialog.js";
+import { ChannelRunConfigDialog } from "./ChannelRunConfigDialog.js";
 import { ChannelTemplatesDialog } from "./ChannelTemplatesDialog.js";
 import { ConnectSlackDialog } from "./ConnectSlackDialog.js";
 import { ConnectWhatsAppDialog } from "./ConnectWhatsAppDialog.js";
@@ -160,6 +161,7 @@ export function AgentChannelsPanel({
 
   // The channel being edited as YAML (the kind-agnostic manifest flow).
   const [editingYaml, setEditingYaml] = useState<AgentChannel | null>(null);
+  const [editingRunConfig, setEditingRunConfig] = useState<AgentChannel | null>(null);
 
   const handleConnect = useCallback(
     (channel: AgentChannel | null, provider: ChannelProviderDescriptor) => {
@@ -305,6 +307,7 @@ export function AgentChannelsPanel({
                   onViewConversations={() => setViewingConversations(channel)}
                   onViewTemplates={() => setViewingTemplates(channel)}
                   onEditYaml={() => setEditingYaml(channel)}
+                  onEditRunConfig={() => setEditingRunConfig(channel)}
                   refetch={refetch}
                 />
               );
@@ -390,6 +393,17 @@ export function AgentChannelsPanel({
         />
       )}
 
+      {editingRunConfig && (
+        <ChannelRunConfigDialog
+          open
+          onOpenChange={(open) => {
+            if (!open) setEditingRunConfig(null);
+          }}
+          channel={editingRunConfig}
+          onSaved={refetch}
+        />
+      )}
+
       <ConfirmDialog
         state={confirmState}
         onConfirm={handleConfirm}
@@ -415,6 +429,7 @@ interface ChannelCardProps {
   readonly onViewConversations: () => void;
   readonly onViewTemplates: () => void;
   readonly onEditYaml: () => void;
+  readonly onEditRunConfig: () => void;
   readonly refetch: () => void;
 }
 
@@ -429,6 +444,7 @@ function ChannelCard({
   onViewConversations,
   onViewTemplates,
   onEditYaml,
+  onEditRunConfig,
   refetch,
 }: ChannelCardProps) {
   const meta = channel.metadata;
@@ -584,6 +600,15 @@ function ChannelCard({
                   Templates
                 </ActionMenu.Item>
               )}
+              {canEdit && (
+                <ActionMenu.Item
+                  icon={<SlidersHorizontal />}
+                  onSelect={onEditRunConfig}
+                  data-cursor-target="channel-run-config"
+                >
+                  Run settings
+                </ActionMenu.Item>
+              )}
               {canEdit && (
                 <ActionMenu.Item
                   icon={<KeyRound />}

package/src/channel/ChannelRunConfigDialog.tsx

@@ -0,0 +1,351 @@
+"use client";
+
+import { useCallback, useId, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage, type RunConfigInput } from "@stigmer/sdk";
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+import { Button } from "../button/Button.js";
+import { DialogShell } from "../internal/DialogShell.js";
+import { ModelSelector } from "../models/ModelSelector.js";
+import type { HarnessOption } from "../models/harness.js";
+import {
+  fromProtoServiceTier,
+  toProtoServiceTier,
+  type ServiceTierOption,
+} from "../models/service-tier.js";
+import {
+  fromProtoThinkingMode,
+  toProtoThinkingMode,
+  type ThinkingModeOption,
+} from "../models/thinking-mode.js";
+import { agentChannelToInput, useSaveAgentChannel } from "./useSaveAgentChannel.js";
+
+/** Props for {@link ChannelRunConfigDialog}. */
+export interface ChannelRunConfigDialogProps {
+  /** Whether the dialog is open. */
+  readonly open: boolean;
+  /** Called when the dialog requests an open-state change. */
+  readonly onOpenChange: (open: boolean) => void;
+  /** The channel whose run settings are edited. */
+  readonly channel: AgentChannel;
+  /** Called after a successful save (hosts typically pass `refetch`). */
+  readonly onSaved?: () => void;
+  /**
+   * When `false`, renders as an in-flow open dialog instead of a
+   * top-layer modal — for embedding in constrained surfaces
+   * (documentation demos, visual tests). Interactive hosts keep the
+   * default.
+   * @default true
+   */
+  readonly modal?: boolean;
+}
+
+/**
+ * Edits an installed channel's run settings (`AgentChannelSpec.run_config`)
+ * — the console's first run_config editor (stigmer/stigmer#792), replacing
+ * the Edit-YAML detour for the model pin the write-time validation guards
+ * (stigmer/stigmer#774).
+ *
+ * Speaks the schedule form's vocabulary (DD-018 D-5): the model pin uses
+ * the composer's own {@link ModelSelector} (with the fast-tier and
+ * thinking switches, #357/#772) and the budget is the one run bound a
+ * user owns; `max_tool_rounds` is an operator knob, API-reachable only —
+ * preserved verbatim on save, never rendered.
+ *
+ * The harness dropdown is a browsing scope for the picker, initialized to
+ * cursor (the platform's channel-serving default): channels carry no
+ * per-channel harness — the serving harness is a platform property — and
+ * the write-time model-pin validation judges the pin against any harness
+ * section, so pinning under either scope is legitimate.
+ *
+ * Saves are full-input applies via {@link agentChannelToInput}, so the
+ * agent reference, provider marker, credential bindings, and install
+ * status all survive; clearing the model with no budget set is an
+ * explicit reset to the platform defaults (`run_config` absent). Untouched
+ * variant switches stay off the wire — unspecified-vs-explicit is a
+ * load-bearing ledger distinction (#357).
+ *
+ * Built on the native `<dialog>` element, matching the SDK's modal
+ * convention. Most hosts mount it via {@link AgentChannelsPanel}'s
+ * channel card action.
+ */
+export function ChannelRunConfigDialog({
+  open,
+  onOpenChange,
+  channel,
+  onSaved,
+  modal = true,
+}: ChannelRunConfigDialogProps) {
+  // Instance-scoped title id (oss#593): hosts legitimately mount this
+  // dialog more than once per page; duplicate DOM ids would break the
+  // aria-labelledby association for every copy after the first.
+  const titleId = useId();
+
+  const handleClose = useCallback(() => {
+    onOpenChange(false);
+  }, [onOpenChange]);
+
+  return (
+    <DialogShell
+      open={open}
+      onOpenChange={onOpenChange}
+      modal={modal}
+      width="md"
+      aria-labelledby={titleId}
+    >
+      {/* Body mounts only while open so its draft resets per session —
+          reopening never resumes stale, unsaved edits. */}
+      {open && (
+        <ChannelRunConfigDialogBody
+          channel={channel}
+          onSaved={onSaved}
+          onClose={handleClose}
+          titleId={titleId}
+        />
+      )}
+    </DialogShell>
+  );
+}
+
+function ChannelRunConfigDialogBody({
+  channel,
+  onSaved,
+  onClose,
+  titleId,
+}: {
+  readonly channel: AgentChannel;
+  readonly onSaved?: () => void;
+  readonly onClose: () => void;
+  /** Heading id minted by the outer dialog for its aria-labelledby. */
+  readonly titleId: string;
+}) {
+  const channelName =
+    channel.metadata?.name || channel.metadata?.slug || "this channel";
+  const stored = channel.spec?.runConfig;
+
+  const { save, isPending, error, clearError } = useSaveAgentChannel();
+
+  const [modelName, setModelName] = useState(stored?.modelName ?? "");
+  const [harness, setHarness] = useState<HarnessOption>("cursor");
+  const [serviceTier, setServiceTier] = useState<ServiceTierOption>(
+    fromProtoServiceTier(stored?.serviceTier) ?? "standard",
+  );
+  const [thinkingMode, setThinkingMode] = useState<ThinkingModeOption>(
+    fromProtoThinkingMode(stored?.thinkingMode) ?? "disabled",
+  );
+  const [budgetUsd, setBudgetUsd] = useState(
+    stored && stored.maxCostUsd > 0 ? String(stored.maxCostUsd) : "",
+  );
+
+  const handleSave = useCallback(async () => {
+    try {
+      // Full-input apply: only run_config changes. An all-empty draft
+      // clears the block entirely — the proto's "empty = inherit" contract
+      // (DD-018 D-2) — while `max_tool_rounds`, which this editor never
+      // renders, survives verbatim (operator knob, DD-018 D-5).
+      await save({
+        ...agentChannelToInput(channel),
+        runConfig: buildRunConfig(
+          modelName,
+          budgetUsd,
+          serviceTier,
+          thinkingMode,
+          stored?.maxToolRounds ?? 0,
+        ),
+      });
+      onSaved?.();
+      onClose();
+    } catch {
+      // Surfaced through the hook's error state below.
+    }
+  }, [budgetUsd, channel, modelName, onClose, onSaved, save, serviceTier, stored, thinkingMode]);
+
+  return (
+    <div className="stg:flex stg:flex-col">
+      <div className="stg:flex stg:items-start stg:justify-between stg:gap-3 stg:border-b stg:border-border stg:px-5 stg:py-4">
+        <div className="stg:min-w-0">
+          <h2
+            id={titleId}
+            className="stg:text-sm stg:font-semibold stg:text-foreground"
+          >
+            Run settings
+          </h2>
+          <p className="stg:mt-0.5 stg:truncate stg:text-xs stg:text-muted-foreground">
+            {channelName}
+          </p>
+        </div>
+        <button
+          type="button"
+          onClick={onClose}
+          aria-label="Close dialog"
+          className={cn(
+            "stg:rounded stg:p-1 stg:text-muted-foreground",
+            "stg:hover:bg-accent-hover stg:hover:text-foreground",
+            "stg:focus:outline-none stg:focus:ring-1 stg:focus:ring-ring",
+          )}
+        >
+          <CloseIcon />
+        </button>
+      </div>
+
+      <div className="stg:space-y-4 stg:px-5 stg:py-4">
+        {/* Engine & model — the composer's own picker (DD-018 D-5), the
+            same shape as the schedule form's. Nothing is pinned until a
+            model is picked. */}
+        <div className="stg:space-y-1">
+          <span className={labelClasses}>
+            Model{" "}
+            <span className="stg:font-normal stg:text-muted-foreground">(optional)</span>
+          </span>
+          <div className="stg:flex stg:items-center stg:gap-2">
+            <ModelSelector
+              value={modelName}
+              onValueChange={setModelName}
+              initialHarness={harness}
+              onHarnessChange={setHarness}
+              serviceTier={serviceTier}
+              onServiceTierChange={setServiceTier}
+              thinkingMode={thinkingMode}
+              onThinkingModeChange={setThinkingMode}
+              placeholderLabel="Platform default"
+              disabled={isPending}
+            />
+            {modelName !== "" && (
+              <button
+                type="button"
+                onClick={() => {
+                  setModelName("");
+                  setServiceTier("standard");
+                  setThinkingMode("disabled");
+                }}
+                disabled={isPending}
+                className={cn(
+                  "stg:rounded-md stg:px-2 stg:py-1 stg:text-[0.65rem] stg:text-muted-foreground",
+                  "stg:hover:text-foreground stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring",
+                  "stg:disabled:pointer-events-none stg:disabled:opacity-50",
+                )}
+              >
+                Reset to platform default
+              </button>
+            )}
+          </div>
+          <p className={hintClasses}>
+            Every conversation turn on this channel runs the pinned model.
+            Unpinned, the platform&rsquo;s default engine and model apply.
+          </p>
+        </div>
+
+        {/* Budget — the one run bound that matters for an unattended
+            surface (DD-018 D-5). Clamped by the platform profile;
+            tool-round bounds stay API-only. */}
+        <div className="stg:space-y-1">
+          <label htmlFor={`${titleId}-budget`} className={labelClasses}>
+            Budget per run (USD){" "}
+            <span className="stg:font-normal stg:text-muted-foreground">(optional)</span>
+          </label>
+          <input
+            id={`${titleId}-budget`}
+            type="number"
+            min="0"
+            step="0.5"
+            inputMode="decimal"
+            value={budgetUsd}
+            onChange={(e) => setBudgetUsd(e.target.value)}
+            placeholder="Platform default"
+            disabled={isPending}
+            className={cn(inputClasses, "stg:max-w-40")}
+          />
+          <p className={hintClasses}>
+            Caps each turn&rsquo;s estimated spend. The platform profile
+            bounds this value; the lower cap wins.
+          </p>
+        </div>
+
+        {error && (
+          <div
+            role="alert"
+            className="stg:rounded-md stg:border stg:border-destructive/30 stg:bg-destructive-subtle stg:px-3 stg:py-2 stg:text-xs stg:text-destructive"
+          >
+            {getUserMessage(error)}
+          </div>
+        )}
+      </div>
+
+      <div className="stg:flex stg:justify-end stg:gap-2 stg:border-t stg:border-border stg:px-5 stg:py-3">
+        <Button
+          variant="ghost"
+          size="sm"
+          onClick={() => {
+            clearError();
+            onClose();
+          }}
+          disabled={isPending}
+        >
+          Cancel
+        </Button>
+        <Button
+          variant="primary"
+          size="sm"
+          onClick={() => void handleSave()}
+          disabled={isPending}
+        >
+          Save
+        </Button>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * Assemble the run_config the save writes. The schedule form's
+ * `buildRunConfig` contract (#357/#772) plus the edit-surface rule from
+ * the schedule detail view's `normalizeRunConfig`: fields this editor
+ * does not own (`max_tool_rounds`) are preserved verbatim, and an
+ * all-empty result clears the block ("empty = inherit").
+ */
+function buildRunConfig(
+  modelName: string,
+  budgetUsd: string,
+  serviceTier: ServiceTierOption,
+  thinkingMode: ThinkingModeOption,
+  storedMaxToolRounds: number,
+): RunConfigInput | undefined {
+  const model = modelName.trim();
+  const cost = Number.parseFloat(budgetUsd);
+
+  const config: RunConfigInput = {};
+  if (model !== "") config.modelName = model;
+  if (Number.isFinite(cost) && cost > 0) config.maxCostUsd = cost;
+  if (storedMaxToolRounds > 0) config.maxToolRounds = storedMaxToolRounds;
+  // Carried only when the user actively chose the variant AND pinned a
+  // model (both are per-model; the server refuses them without one). An
+  // untouched switch stays absent — unspecified-vs-explicit is a
+  // load-bearing ledger distinction (#357/#772).
+  if (serviceTier === "fast" && model !== "") {
+    config.serviceTier = toProtoServiceTier(serviceTier);
+  }
+  if (thinkingMode === "enabled" && model !== "") {
+    config.thinkingMode = toProtoThinkingMode(thinkingMode);
+  }
+
+  return Object.keys(config).length > 0 ? config : undefined;
+}
+
+const labelClasses = "stg:block stg:text-xs stg:font-medium stg:text-foreground";
+
+const hintClasses = "stg:text-[0.65rem] stg:text-muted-foreground";
+
+const inputClasses = cn(
+  "stg:w-full stg:rounded-md stg:border stg:border-input stg:bg-background stg:px-2.5 stg:py-1.5 stg:text-xs stg:text-foreground",
+  "stg:placeholder:text-muted-foreground",
+  "stg:focus-visible:outline-none stg:focus-visible:ring-1 stg:focus-visible:ring-ring",
+  "stg:disabled:pointer-events-none stg:disabled:opacity-50",
+);
+
+function CloseIcon() {
+  return (
+    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" aria-hidden="true">
+      <path d="m3 3 8 8M11 3l-8 8" />
+    </svg>
+  );
+}