@stigmer/react 3.12.5 → 3.12.6

package/src/schedule/ScheduleDetailView.tsx

@@ -37,7 +37,7 @@ import {
   type RunConfig,
 } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/invocation_pb";
 import { Harness } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
-import { ServiceTier } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ServiceTier, ThinkingMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
 import {
   cadenceToCron,
@@ -60,6 +60,11 @@ import {
   toProtoServiceTier,
   type ServiceTierOption,
 } from "../models/service-tier.js";
+import {
+  fromProtoThinkingMode,
+  toProtoThinkingMode,
+  type ThinkingModeOption,
+} from "../models/thinking-mode.js";
 import { deriveScheduleState, formatNextFire } from "./scheduleState.js";
 import {
   ScheduleRunsCompactList,
@@ -599,10 +604,10 @@ export function ScheduleDetailView({
             {editable && target ? (
               <EngineModelInlineEditor
                 invocation={target}
-                onSave={(harness, modelName, serviceTier) =>
+                onSave={(harness, modelName, serviceTier, thinkingMode) =>
                   saveSpecField("engine-model", (s) => {
                     if (s.target.case === "agent") {
-                      applyEngineModel(s.target.value, harness, modelName, serviceTier);
+                      applyEngineModel(s.target.value, harness, modelName, serviceTier, thinkingMode);
                     }
                   })
                 }
@@ -1016,6 +1021,7 @@ function EngineModelInlineEditor({
     harness: Harness,
     modelName: string,
     serviceTier: ServiceTierOption,
+    thinkingMode: ThinkingModeOption,
   ) => Promise<boolean>;
   readonly isSaving: boolean;
   readonly error?: string;
@@ -1024,6 +1030,7 @@ function EngineModelInlineEditor({
   const [modelName, setModelName] = useState("");
   const [harness, setHarness] = useState<HarnessOption>("cursor");
   const [serviceTier, setServiceTier] = useState<ServiceTierOption>("standard");
+  const [thinkingMode, setThinkingMode] = useState<ThinkingModeOption>("disabled");
 
   const startEdit = () => {
     setModelName(invocation.runConfig?.modelName ?? "");
@@ -1035,6 +1042,9 @@ function EngineModelInlineEditor({
     setServiceTier(
       fromProtoServiceTier(invocation.runConfig?.serviceTier) ?? "standard",
     );
+    setThinkingMode(
+      fromProtoThinkingMode(invocation.runConfig?.thinkingMode) ?? "disabled",
+    );
     setIsEditing(true);
   };
 
@@ -1056,6 +1066,8 @@ function EngineModelInlineEditor({
           onHarnessChange={setHarness}
           serviceTier={serviceTier}
           onServiceTierChange={setServiceTier}
+          thinkingMode={thinkingMode}
+          onThinkingModeChange={setThinkingMode}
           placeholderLabel="Platform default"
           disabled={isSaving}
         />
@@ -1065,6 +1077,7 @@ function EngineModelInlineEditor({
             onClick={() => {
               setModelName("");
               setServiceTier("standard");
+              setThinkingMode("disabled");
             }}
             disabled={isSaving}
             className="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"
@@ -1084,6 +1097,7 @@ function EngineModelInlineEditor({
             modelName !== "" ? toProtoHarness(harness) : Harness.UNSPECIFIED,
             modelName,
             serviceTier,
+            thinkingMode,
           );
           if (ok) setIsEditing(false);
         }}
@@ -1169,14 +1183,17 @@ function applyEngineModel(
   harness: Harness,
   modelName: string,
   serviceTier: ServiceTierOption,
+  thinkingMode: ThinkingModeOption,
 ): void {
   invocation.harness = harness;
   invocation.runConfig = normalizeRunConfig(
     modelName,
     invocation.runConfig?.maxCostUsd ?? 0,
     invocation.runConfig?.maxToolRounds ?? 0,
-    // The tier rides the model choice: no model, no tier (#357).
+    // The variant attributes ride the model choice: no model, no tier and
+    // no thinking (#357/#772).
     modelName.trim() !== "" ? serviceTier : "standard",
+    modelName.trim() !== "" ? thinkingMode : "disabled",
   );
 }
 
@@ -1190,6 +1207,7 @@ function applyBudget(
     maxCostUsd ?? 0,
     invocation.runConfig?.maxToolRounds ?? 0,
     fromProtoServiceTier(invocation.runConfig?.serviceTier) ?? "standard",
+    fromProtoThinkingMode(invocation.runConfig?.thinkingMode) ?? "disabled",
   );
 }
 
@@ -1198,12 +1216,14 @@ function normalizeRunConfig(
   maxCostUsd: number,
   maxToolRounds: number,
   serviceTier: ServiceTierOption,
+  thinkingMode: ThinkingModeOption,
 ): RunConfig | undefined {
   const fields: {
     modelName?: string;
     maxCostUsd?: number;
     maxToolRounds?: number;
     serviceTier?: ServiceTier;
+    thinkingMode?: ThinkingMode;
   } = {};
   if (modelName.trim() !== "") fields.modelName = modelName.trim();
   if (maxCostUsd > 0) fields.maxCostUsd = maxCostUsd;
@@ -1211,6 +1231,8 @@ function normalizeRunConfig(
   // 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);
+  // The tier's #772 twin: only an active enabled choice is carried.
+  if (thinkingMode === "enabled") fields.thinkingMode = toProtoThinkingMode(thinkingMode);
 
   return Object.keys(fields).length > 0
     ? create(RunConfigSchema, fields)
@@ -1429,6 +1451,9 @@ function EngineModelSummary({
   if (invocation?.runConfig?.serviceTier === ServiceTier.FAST) {
     parts.push("Fast tier");
   }
+  if (invocation?.runConfig?.thinkingMode === ThinkingMode.ENABLED) {
+    parts.push("Thinking");
+  }
   return <span className="stg:text-sm stg:text-foreground">{parts.join(" · ")}</span>;
 }
 

package/src/schedule/ScheduleForm.tsx

@@ -16,6 +16,7 @@ import { useGitHubConnection } from "../github/useGitHubConnection.js";
 import { ModelSelector } from "../models/ModelSelector.js";
 import { toProtoHarness, type HarnessOption } from "../models/harness.js";
 import { toProtoServiceTier, type ServiceTierOption } from "../models/service-tier.js";
+import { toProtoThinkingMode, type ThinkingModeOption } from "../models/thinking-mode.js";
 import { Switch } from "../switch/Switch.js";
 import { useStigmerPortalContainer } from "../portal-container.js";
 import { useWorkspaceEntries } from "../workspace/useWorkspaceEntries.js";
@@ -116,6 +117,8 @@ export function ScheduleForm({
   // 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");
+  // Thinking mode: the tier's #772 twin, capability-scoped the same way.
+  const [thinkingMode, setThinkingMode] = useState<ThinkingModeOption>("disabled");
 
   const [budgetUsd, setBudgetUsd] = useState("");
 
@@ -152,7 +155,7 @@ export function ScheduleForm({
       if (!canSubmit || !agentRef) return;
 
       clearError();
-      const runConfig = buildRunConfig(modelName, budgetUsd, serviceTier);
+      const runConfig = buildRunConfig(modelName, budgetUsd, serviceTier, thinkingMode);
       try {
         const schedule = await create({
           name: trimmedName,
@@ -195,6 +198,7 @@ export function ScheduleForm({
       modelName,
       modelHarness,
       serviceTier,
+      thinkingMode,
       budgetUsd,
       workspace,
       onComplete,
@@ -362,6 +366,8 @@ export function ScheduleForm({
             onHarnessChange={setModelHarness}
             serviceTier={serviceTier}
             onServiceTierChange={setServiceTier}
+            thinkingMode={thinkingMode}
+            onThinkingModeChange={setThinkingMode}
             placeholderLabel="Platform default"
             disabled={isCreating}
           />
@@ -371,6 +377,7 @@ export function ScheduleForm({
               onClick={() => {
                 setModelName("");
                 setServiceTier("standard");
+                setThinkingMode("disabled");
               }}
               disabled={isCreating}
               className={cn(
@@ -514,6 +521,7 @@ function buildRunConfig(
   modelName: string,
   budgetUsd: string,
   serviceTier: ServiceTierOption,
+  thinkingMode: ThinkingModeOption,
 ): RunConfigInput | undefined {
   const model = modelName.trim();
   const cost = Number.parseFloat(budgetUsd);
@@ -528,6 +536,11 @@ function buildRunConfig(
   if (serviceTier === "fast" && model !== "") {
     config.serviceTier = toProtoServiceTier(serviceTier);
   }
+  // The tier's #772 twin: thinking is a per-model capability, same
+  // only-explicit-enabled + requires-a-model contract.
+  if (thinkingMode === "enabled" && model !== "") {
+    config.thinkingMode = toProtoThinkingMode(thinkingMode);
+  }
 
   return Object.keys(config).length > 0 ? config : undefined;
 }

package/src/session/run-config.ts

@@ -1,4 +1,5 @@
 import type { ServiceTierOption } from "../models/service-tier.js";
+import type { ThinkingModeOption } from "../models/thinking-mode.js";
 
 /**
  * Owner-pinned execution config for a session surface
@@ -39,6 +40,14 @@ export interface SessionRunConfig {
    * pin is a host configuration error and throws at submit.
    */
   readonly serviceTier?: ServiceTierOption;
+  /**
+   * Thinking mode for every execution (stigmer/stigmer#772).
+   * `"enabled"` requires {@link modelName} under the same contract as
+   * {@link serviceTier}: thinking is a per-model capability (the server
+   * refuses it fail-closed for Auto), so a mode pin without a model pin
+   * is a host configuration error and throws at submit.
+   */
+  readonly thinkingMode?: ThinkingModeOption;
 }
 
 /**
@@ -56,4 +65,11 @@ export function assertValidRunConfig(runConfig: SessionRunConfig): void {
         + "dimension. Pin the model the surface should run.",
     );
   }
+  if (runConfig.thinkingMode === "enabled" && !runConfig.modelName) {
+    throw new Error(
+      "SessionRunConfig: thinkingMode \"enabled\" requires modelName — "
+        + "thinking is a per-model capability and Auto (no pinned model) has "
+        + "no variant dimensions. Pin the model the surface should run.",
+    );
+  }
 }

package/src/session/useNewSessionFlow.ts

@@ -307,6 +307,7 @@ export function useNewSessionFlow(
   if (runConfig) assertValidRunConfig(runConfig);
   const pinnedModelName = runConfig?.modelName;
   const pinnedServiceTier = runConfig?.serviceTier;
+  const pinnedThinkingMode = runConfig?.thinkingMode;
   const contextTarget = useExecutionTarget();
   const executionTarget = options.executionTarget ?? contextTarget;
   const adapter = useRunnerAdapter();
@@ -490,6 +491,10 @@ export function useNewSessionFlow(
           serviceTier: pinnedModelName
             ? (pinnedServiceTier === "fast" ? "fast" : undefined)
             : context?.serviceTier,
+          // The tier's #772 twin, same pin-wins + only-explicit-enabled rule.
+          thinkingMode: pinnedModelName
+            ? (pinnedThinkingMode === "enabled" ? "enabled" : undefined)
+            : context?.thinkingMode,
           workspaceFileRefs: context?.workspaceFileRefs,
           autoApproveAll,
         };
@@ -584,6 +589,7 @@ export function useNewSessionFlow(
       effectiveModelId,
       pinnedModelName,
       pinnedServiceTier,
+      pinnedThinkingMode,
       workspace,
       mcpServerUsages,
       skillRefs,

package/src/session/useSessionConversation.ts

@@ -9,15 +9,17 @@ import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_
 import type { McpServerUsage as ProtoMcpServerUsage } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
 import type { WorkspaceEntry as ProtoWorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
 import type { ApiResourceReference as ProtoApiResourceReference } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import type {
-  AttachmentInput,
-  EnvVarInput,
-  McpServerUsageInput,
-  ResourceRef,
-  WorkspaceEntryInput,
+import {
+  toSessionUpdateInput,
+  type AttachmentInput,
+  type EnvVarInput,
+  type McpServerUsageInput,
+  type ResourceRef,
+  type WorkspaceEntryInput,
 } from "@stigmer/sdk";
 import { isTerminalPhase } from "../execution/execution-phases.js";
 import type { ServiceTierOption } from "../models/service-tier.js";
+import type { ThinkingModeOption } from "../models/thinking-mode.js";
 import { useStigmer } from "../hooks.js";
 import { toError } from "../internal/toError.js";
 import { useConversationStoreRef } from "../internal/store/index.js";
@@ -32,11 +34,6 @@ import { useSession } from "./useSession.js";
 import { useSessionExecutions } from "./useSessionExecutions.js";
 import { useUpdateSession } from "./useUpdateSession.js";
 import { useLocalSessionWorker } from "./useLocalSessionWorker.js";
-import {
-  specWorkspaceToInput,
-  specMcpUsagesToInput,
-  specSkillRefsToInput,
-} from "./session-spec-converters.js";
 
 /**
  * Cadence for re-discovering the session's executions while the live stream
@@ -111,6 +108,16 @@ export interface SendFollowUpOptions {
    * @see {@link SharedAgentExecutionFields.serviceTier}
    */
   readonly serviceTier?: ServiceTierOption;
+  /**
+   * Thinking mode for this execution's model calls (stigmer/stigmer#772).
+   *
+   * Only set when the user actively selected `"enabled"`; `undefined`
+   * preserves the unspecified-vs-explicit distinction (unset resolves to
+   * disabled on the platform side — never the provider account default).
+   *
+   * @see {@link SharedAgentExecutionFields.thinkingMode}
+   */
+  readonly thinkingMode?: ThinkingModeOption;
   /**
    * Marks this execution as a Build-from-plan turn.
    *
@@ -674,6 +681,7 @@ export function useSessionConversation(
           attachments: options?.attachments,
           interactionMode: options?.interactionMode,
           serviceTier: options?.serviceTier,
+          thinkingMode: options?.thinkingMode,
           buildFromPlan: options?.buildFromPlan,
           autoApproveAll: options?.autoApproveAll,
           workspaceFileRefs: options?.workspaceFileRefs,
@@ -818,13 +826,13 @@ export function useSessionConversation(
 // ---------------------------------------------------------------------------
 
 /**
- * Converts the existing Session proto into a SessionInput suitable for
- * the update RPC (which uses replace semantics — the full spec is sent).
- *
- * For each session-level collection (workspace, MCP servers, skills):
- * if an override is provided, it replaces the existing value; otherwise
- * the current session value is preserved by converting it back to input
- * format.
+ * Builds the SessionInput for the update RPC (which uses replace
+ * semantics — the full spec is sent) by spreading the SDK's complete
+ * generated mapper and overriding only the session-level collections the
+ * caller provided. An override replaces the existing value; an omitted
+ * field keeps the fetched session's value (an empty-array override
+ * clears the collection — normalized to absent, the mappers' canonical
+ * shape).
  */
 function buildUpdateInput(
   session: Session,
@@ -835,30 +843,14 @@ function buildUpdateInput(
     skillRefs?: ResourceRef[];
   },
 ) {
-  const meta = session.metadata!;
-  const spec = session.spec;
-
-  const workspaceEntries =
-    overrides.workspaceEntries ?? specWorkspaceToInput(spec);
-
-  const mcpServerUsages =
-    overrides.mcpServerUsages ?? specMcpUsagesToInput(spec);
-
-  const skillRefs = overrides.skillRefs ?? specSkillRefsToInput(spec);
+  const mapped = toSessionUpdateInput(session);
+  const workspaceEntries = overrides.workspaceEntries ?? mapped.workspaceEntries;
+  const mcpServerUsages = overrides.mcpServerUsages ?? mapped.mcpServerUsages;
+  const skillRefs = overrides.skillRefs ?? mapped.skillRefs;
 
   return {
-    name: meta.name,
-    org: meta.org,
-    agentInstanceId: overrides.agentInstanceId ?? (spec?.agentInstanceId || undefined),
-    subject: spec?.subject || undefined,
-    harnessStateId: spec?.harnessStateId || undefined,
-    harness: spec?.harness,
-    cursorMode: spec?.cursorMode,
-    executionTarget: spec?.executionTarget,
-    metadata:
-      spec?.metadata && Object.keys(spec.metadata).length > 0
-        ? { ...spec.metadata }
-        : undefined,
+    ...mapped,
+    agentInstanceId: overrides.agentInstanceId ?? mapped.agentInstanceId,
     workspaceEntries: workspaceEntries?.length ? workspaceEntries : undefined,
     mcpServerUsages: mcpServerUsages?.length ? mcpServerUsages : undefined,
     skillRefs: skillRefs?.length ? skillRefs : undefined,

package/src/session/useSessionPageFlow.ts

@@ -18,7 +18,7 @@ import { useSessionConversation, type UseSessionConversationReturn } from "./use
 import { resolveExecutionRuntimeEnv, type RuntimeEnvProvider } from "./runtime-env.js";
 import { useAgentRefFromSession } from "./useAgentRefFromSession.js";
 import { usePersistedModel, type UsePersistedModelReturn } from "./usePersistedModel.js";
-import { specMcpUsagesToInput, specSkillRefsToInput } from "./session-spec-converters.js";
+import { toSessionUpdateInput } from "@stigmer/sdk";
 import type { SessionAudience } from "./audience.js";
 import { assertValidRunConfig, type SessionRunConfig } from "./run-config.js";
 
@@ -267,6 +267,7 @@ export function useSessionPageFlow(
   // callback's identity must not churn on every render (DD-010).
   const pinnedModelName = runConfig?.modelName;
   const pinnedServiceTier = runConfig?.serviceTier;
+  const pinnedThinkingMode = runConfig?.thinkingMode;
 
   const stigmer = useStigmer();
   const conv = useSessionConversation(sessionId, org);
@@ -401,16 +402,14 @@ export function useSessionPageFlow(
       }
     }
 
-    // MCP server usages
-    const mcpInputs = specMcpUsagesToInput(spec);
-    if (mcpInputs?.length) {
-      setMcpServerUsages(mcpInputs);
+    // MCP server usages and skill references, hydrated through the SDK's
+    // complete update-input mapper (the canonical proto → input lens).
+    const mapped = toSessionUpdateInput(conv.session);
+    if (mapped.mcpServerUsages?.length) {
+      setMcpServerUsages(mapped.mcpServerUsages);
     }
-
-    // Skill references
-    const skillInputs = specSkillRefsToInput(spec);
-    if (skillInputs?.length) {
-      setSkillRefs(skillInputs);
+    if (mapped.skillRefs?.length) {
+      setSkillRefs(mapped.skillRefs);
     }
   }, [conv.session, workspace]);
 
@@ -480,6 +479,10 @@ export function useSessionPageFlow(
         serviceTier: pinnedModelName
           ? (pinnedServiceTier === "fast" ? "fast" : undefined)
           : context?.serviceTier,
+        // The tier's #772 twin, same pin-wins + only-explicit-enabled rule.
+        thinkingMode: pinnedModelName
+          ? (pinnedThinkingMode === "enabled" ? "enabled" : undefined)
+          : context?.thinkingMode,
         buildFromPlan: context?.buildFromPlan,
         // Sourced from the session-scoped preference set at the approval gate,
         // not from the composer (the pre-arm toggle was removed).
@@ -490,7 +493,7 @@ export function useSessionPageFlow(
 
       sessionVariables.clear();
     },
-    [conv.sendFollowUp, modelId, pinnedModelName, pinnedServiceTier, workspace, mcpServerUsages, skillRefs, sessionVariables.clear, resolution, agentRef, sessionInstanceId, stigmer, autoApproveAll, getRuntimeEnv],
+    [conv.sendFollowUp, modelId, pinnedModelName, pinnedServiceTier, pinnedThinkingMode, workspace, mcpServerUsages, skillRefs, sessionVariables.clear, resolution, agentRef, sessionInstanceId, stigmer, autoApproveAll, getRuntimeEnv],
   );
 
   // -------------------------------------------------------------------------

package/src/session/useUpdateSession.ts

@@ -25,40 +25,34 @@ export interface UseUpdateSessionReturn {
  * by the backend to identify the resource) and all spec fields.
  *
  * **Full-replace semantics.** The backend replaces the entire spec with
- * what you send — there is no field mask. Round-trip every spec field
- * you do not intend to change, *including `metadata`*: an update built
- * from a reconstructed partial spec silently wipes the fields it omits
- * (workspace entries, MCP servers, and `stigmer.ai/*` metadata keys such
- * as the embedder session context). To change only the subject, prefer
- * the field-level `session.updateSubject()` RPC instead of this hook.
+ * what you send — there is no field mask. Spread the SDK's complete
+ * `toSessionUpdateInput()` mapper and override only the fields you
+ * change: an update built from a reconstructed partial spec silently
+ * wipes the fields it omits (workspace entries, MCP servers, and
+ * `stigmer.ai/*` metadata keys such as the embedder session context).
+ * To change only the subject, prefer the field-level
+ * `session.updateSubject()` RPC instead of this hook.
  *
  * Typically composed into higher-level hooks like
- * {@link useSessionConversation} (whose update path round-trips the
- * fetched spec) rather than used directly. Platform builders who need
- * direct session mutation can use this hook standalone.
+ * {@link useSessionConversation} (whose update path spreads the mapper
+ * over a freshly fetched session) rather than used directly. Platform
+ * builders who need direct session mutation can use this hook
+ * standalone.
  *
  * @example
  * ```tsx
+ * import { toSessionUpdateInput } from "@stigmer/sdk";
+ *
  * function TagSession({ session }: { session: Session }) {
  *   const { update, isUpdating } = useUpdateSession();
  *
  *   async function handleTag() {
- *     const spec = session.spec;
+ *     const mapped = toSessionUpdateInput(session);
  *     await update({
- *       name: session.metadata!.name,
- *       org: session.metadata!.org,
- *       // Full replace: carry over every fetched spec field...
- *       agentInstanceId: spec?.agentInstanceId,
- *       subject: spec?.subject,
- *       harnessStateId: spec?.harnessStateId,
- *       harness: spec?.harness,
- *       cursorMode: spec?.cursorMode,
- *       executionTarget: spec?.executionTarget,
- *       // ...including the spec lists (workspaceEntries, mcpServerUsages,
- *       // skillRefs), converted from the fetched proto exactly as
- *       // useSessionConversation's update path does...
- *       // ...then apply the one change on top of the carried metadata.
- *       metadata: { ...spec?.metadata, "acme/reviewed": "true" },
+ *       ...mapped,
+ *       // Nested values follow the same rule: spread the mapper's
+ *       // complete value, then apply the one change on top.
+ *       metadata: { ...mapped.metadata, "acme/reviewed": "true" },
  *     });
  *   }
  *

package/src/workflow/ApprovalFormBuilder.tsx

@@ -24,15 +24,17 @@ interface FormFieldEntry {
   enumValues: string;
 }
 
-// HUMAN_INPUT_TIMEOUT_ESCALATE is deliberately absent: the proto declares it
-// but no runtime exists, and the server validator refuses it at apply
-// (stigmer/stigmer#779). The old option also wrote an `escalation_task` field
-// that HumanInputTaskConfig never had, so every config it produced failed
-// the server's strict decode.
+// ESCALATE carries the outcome-by-name contract (stigmer/stigmer#781): the
+// timeout resolves to the outcome NAMED "escalate" and follows its routing,
+// so the gate must declare that outcome — no extra config fields (the
+// pre-#779 option wrote an `escalation_task` field the proto never had).
+// The builder hints when the outcome is missing; the server validator is
+// the enforcement.
 const TIMEOUT_POLICY_OPTIONS = [
   { value: "HUMAN_INPUT_TIMEOUT_FAIL", label: "Fail — task errors on timeout" },
   { value: "HUMAN_INPUT_TIMEOUT_APPROVE", label: "Auto-approve — proceed as approved" },
   { value: "HUMAN_INPUT_TIMEOUT_DENY", label: "Auto-deny — proceed as denied" },
+  { value: "HUMAN_INPUT_TIMEOUT_ESCALATE", label: "Escalate — route via the 'escalate' outcome" },
 ] as const;
 
 const TIMEOUT_UNITS = [
@@ -111,6 +113,7 @@ export const ApprovalFormBuilder = memo(function ApprovalFormBuilder({
       <TimeoutSection
         timeout={typeof cfg.timeout === "number" ? cfg.timeout : 0}
         onTimeout={typeof cfg.on_timeout === "string" ? cfg.on_timeout : ""}
+        hasEscalateOutcome={extractOutcomes(cfg).some((o) => o.name === "escalate")}
         onUpdateConfig={onUpdateConfig}
       />
       <StringListSection
@@ -621,10 +624,12 @@ function FormFieldRow({
 function TimeoutSection({
   timeout,
   onTimeout,
+  hasEscalateOutcome,
   onUpdateConfig,
 }: {
   timeout: number;
   onTimeout: string;
+  hasEscalateOutcome: boolean;
   onUpdateConfig: (fieldPath: string, value: unknown) => void;
 }) {
   const bestUnit = useMemo(() => {
@@ -703,6 +708,16 @@ function TimeoutSection({
               <option key={opt.value} value={opt.value}>{opt.label}</option>
             ))}
           </select>
+          {onTimeout === "HUMAN_INPUT_TIMEOUT_ESCALATE" && !hasEscalateOutcome && (
+            <p
+              role="alert"
+              className="stg:text-[10px] stg:text-[var(--stgm-warning,#d97706)]"
+            >
+              Escalate needs an outcome named &quot;escalate&quot; with routing —
+              the timeout resolves to it. Add the outcome above, or the server
+              will reject this workflow.
+            </p>
+          )}
         </div>
       )}
 

package/src/workflow/WorkflowDetailView.tsx

@@ -9,7 +9,7 @@ import { ValidationState } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/
 import type { WorkflowInput } from "@stigmer/sdk";
 import { useWorkflow } from "./useWorkflow.js";
 import { useUpdateWorkflow } from "./useUpdateWorkflow.js";
-import { workflowToInput } from "./internal/workflowToInput.js";
+import { toWorkflowUpdateInput } from "@stigmer/sdk";
 import { useWorkflowExecutionList } from "./useWorkflowExecutionList.js";
 import { useWorkflowDashboardSummary } from "./useWorkflowDashboardSummary.js";
 import { WorkflowOverviewGraph } from "./WorkflowOverviewGraph.js";
@@ -189,7 +189,7 @@ export function WorkflowDetailView({
       value: WorkflowInput[K],
     ): Promise<boolean> => {
       if (!workflow) return false;
-      const input = workflowToInput(workflow);
+      const input = toWorkflowUpdateInput(workflow);
       (input as unknown as Record<string, unknown>)[field] = value;
       try {
         const updated = await update(input);