From 66ae4434c5ef8465e198c91757effb562fdba52e Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 13:47:14 -0700
Subject: [PATCH 01/19] added back recipe parameter support

---
 ui/desktop/openapi.json                       |  5 ++
 ui/desktop/src/api/types.gen.ts               |  4 ++
 .../src/components/ParameterInputModal.tsx    | 58 +++++++++++++++----
 ui/desktop/src/components/RecipeEditor.tsx    | 52 ++++++++++++++---
 .../components/parameter/ParameterInput.tsx   | 42 +++++++++++++-
 ui/desktop/src/hooks/useRecipeManager.ts      |  2 +-
 ui/desktop/src/recipe/index.ts                |  3 +-
 ui/desktop/src/utils/providerUtils.ts         | 12 ++--
 8 files changed, 152 insertions(+), 26 deletions(-)

diff --git a/ui/desktop/openapi.json b/ui/desktop/openapi.json
index d891d6536bf0..30ac193e3d0e 100644
--- a/ui/desktop/openapi.json
+++ b/ui/desktop/openapi.json
@@ -1827,6 +1827,11 @@
             "format": "double",
             "description": "Cost per token for output (optional)",
             "nullable": true
+          },
+          "supports_cache_control": {
+            "type": "boolean",
+            "description": "Whether this model supports cache control",
+            "nullable": true
           }
         }
       },
diff --git a/ui/desktop/src/api/types.gen.ts b/ui/desktop/src/api/types.gen.ts
index 071c7bfd557e..45a43b44ba18 100644
--- a/ui/desktop/src/api/types.gen.ts
+++ b/ui/desktop/src/api/types.gen.ts
@@ -273,6 +273,10 @@ export type ModelInfo = {
      * Cost per token for output (optional)
      */
     output_token_cost?: number | null;
+    /**
+     * Whether this model supports cache control
+     */
+    supports_cache_control?: boolean | null;
 };
 
 export type PermissionConfirmationRequest = {
diff --git a/ui/desktop/src/components/ParameterInputModal.tsx b/ui/desktop/src/components/ParameterInputModal.tsx
index 07f578cc2d04..65564068239d 100644
--- a/ui/desktop/src/components/ParameterInputModal.tsx
+++ b/ui/desktop/src/components/ParameterInputModal.tsx
@@ -122,17 +122,53 @@ const ParameterInputModal: React.FC<ParameterInputModalProps> = ({
                   {param.description || param.key}
                   {param.requirement === 'required' && <span className="text-red-500 ml-1">*</span>}
                 </label>
-                <input
-                  type="text"
-                  value={inputValues[param.key] || ''}
-                  onChange={(e) => handleChange(param.key, e.target.value)}
-                  className={`w-full p-3 border rounded-lg bg-bgSubtle text-textStandard focus:outline-none focus:ring-2 ${
-                    validationErrors[param.key]
-                      ? 'border-red-500 focus:ring-red-500'
-                      : 'border-borderSubtle focus:ring-borderProminent'
-                  }`}
-                  placeholder={param.default || `Enter value for ${param.key}...`}
-                />
+
+                {/* Render different input types */}
+                {param.input_type === 'select' && param.options ? (
+                  <select
+                    value={inputValues[param.key] || ''}
+                    onChange={(e) => handleChange(param.key, e.target.value)}
+                    className={`w-full p-3 border rounded-lg bg-bgSubtle text-textStandard focus:outline-none focus:ring-2 ${
+                      validationErrors[param.key]
+                        ? 'border-red-500 focus:ring-red-500'
+                        : 'border-borderSubtle focus:ring-borderProminent'
+                    }`}
+                  >
+                    <option value="">Select an option...</option>
+                    {param.options.map((option) => (
+                      <option key={option} value={option}>
+                        {option}
+                      </option>
+                    ))}
+                  </select>
+                ) : param.input_type === 'boolean' ? (
+                  <select
+                    value={inputValues[param.key] || ''}
+                    onChange={(e) => handleChange(param.key, e.target.value)}
+                    className={`w-full p-3 border rounded-lg bg-bgSubtle text-textStandard focus:outline-none focus:ring-2 ${
+                      validationErrors[param.key]
+                        ? 'border-red-500 focus:ring-red-500'
+                        : 'border-borderSubtle focus:ring-borderProminent'
+                    }`}
+                  >
+                    <option value="">Select...</option>
+                    <option value="true">True</option>
+                    <option value="false">False</option>
+                  </select>
+                ) : (
+                  <input
+                    type={param.input_type === 'number' ? 'number' : 'text'}
+                    value={inputValues[param.key] || ''}
+                    onChange={(e) => handleChange(param.key, e.target.value)}
+                    className={`w-full p-3 border rounded-lg bg-bgSubtle text-textStandard focus:outline-none focus:ring-2 ${
+                      validationErrors[param.key]
+                        ? 'border-red-500 focus:ring-red-500'
+                        : 'border-borderSubtle focus:ring-borderProminent'
+                    }`}
+                    placeholder={param.default || `Enter value for ${param.key}...`}
+                  />
+                )}
+
                 {validationErrors[param.key] && (
                   <p className="text-red-500 text-sm mt-1">{validationErrors[param.key]}</p>
                 )}
diff --git a/ui/desktop/src/components/RecipeEditor.tsx b/ui/desktop/src/components/RecipeEditor.tsx
index c3f1ce6d3dba..79d780260190 100644
--- a/ui/desktop/src/components/RecipeEditor.tsx
+++ b/ui/desktop/src/components/RecipeEditor.tsx
@@ -401,13 +401,51 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
               <div className="text-red-500 text-sm mt-1">{errors.instructions}</div>
             )}
           </div>
-          {parameters.map((parameter: Parameter) => (
-            <ParameterInput
-              key={parameter.key}
-              parameter={parameter}
-              onChange={(name, value) => handleParameterChange(name, value)}
-            />
-          ))}
+          {/* Parameters section */}
+          <div className="pt-3 pb-6 border-b-2 border-borderSubtle">
+            <div className="flex justify-between items-center mb-4">
+              <h3 className="text-lg font-medium text-textProminent">Parameters</h3>
+              <div className="flex gap-2">
+                <button
+                  type="button"
+                  onClick={() => {
+                    const newKey = `param_${Date.now()}`;
+                    const newParam: Parameter = {
+                      key: newKey,
+                      description: `Enter value for ${newKey}`,
+                      input_type: 'string',
+                      requirement: 'required',
+                    };
+                    setParameters((prev) => [...prev, newParam]);
+                  }}
+                  className="px-3 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors text-sm"
+                >
+                  Add Parameter
+                </button>
+                {parameters.length > 0 && (
+                  <button
+                    type="button"
+                    onClick={() => {
+                      if (parameters.length > 0) {
+                        setParameters((prev) => prev.slice(0, -1));
+                      }
+                    }}
+                    className="px-3 py-2 bg-red-500 text-white rounded-lg hover:bg-red-600 transition-colors text-sm"
+                  >
+                    Remove Last
+                  </button>
+                )}
+              </div>
+            </div>
+
+            {parameters.map((parameter: Parameter) => (
+              <ParameterInput
+                key={parameter.key}
+                parameter={parameter}
+                onChange={(name, value) => handleParameterChange(name, value)}
+              />
+            ))}
+          </div>
           <div className="pt-3 pb-6 border-b-2 border-borderSubtle">
             <RecipeExpandableInfo
               infoLabel="Initial Prompt"
diff --git a/ui/desktop/src/components/parameter/ParameterInput.tsx b/ui/desktop/src/components/parameter/ParameterInput.tsx
index 09839cb54c6b..b48b2c36743a 100644
--- a/ui/desktop/src/components/parameter/ParameterInput.tsx
+++ b/ui/desktop/src/components/parameter/ParameterInput.tsx
@@ -30,8 +30,24 @@ const ParameterInput: React.FC<ParameterInputProps> = ({ parameter, onChange })
         <p className="text-sm text-textSubtle mt-1">This is the message the end-user will see.</p>
       </div>
 
-      {/* Controls for requirement and default value */}
-      <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+      {/* Controls for requirement, input type, and default value */}
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+        <div>
+          <label className="block text-md text-textStandard mb-2 font-semibold">Input Type</label>
+          <select
+            className="w-full p-3 border rounded-lg bg-background-default text-textStandard"
+            value={parameter.input_type || 'string'}
+            onChange={(e) =>
+              onChange(key, { input_type: e.target.value as Parameter['input_type'] })
+            }
+          >
+            <option value="string">String</option>
+            <option value="select">Select</option>
+            <option value="number">Number</option>
+            <option value="boolean">Boolean</option>
+          </select>
+        </div>
+
         <div>
           <label className="block text-md text-textStandard mb-2 font-semibold">Requirement</label>
           <select
@@ -62,6 +78,28 @@ const ParameterInput: React.FC<ParameterInputProps> = ({ parameter, onChange })
           </div>
         )}
       </div>
+
+      {/* Options field for select input type */}
+      {parameter.input_type === 'select' && (
+        <div className="mt-4">
+          <label className="block text-md text-textStandard mb-2 font-semibold">
+            Options (one per line)
+          </label>
+          <textarea
+            value={(parameter.options || []).join('\n')}
+            onChange={(e) => {
+              const options = e.target.value.split('\n').filter((opt) => opt.trim() !== '');
+              onChange(key, { options });
+            }}
+            className="w-full p-3 border rounded-lg bg-background-default text-textStandard focus:outline-none focus:ring-2 focus:ring-borderProminent"
+            placeholder="Option 1&#10;Option 2&#10;Option 3"
+            rows={4}
+          />
+          <p className="text-sm text-textSubtle mt-1">
+            Enter each option on a new line. These will be shown as dropdown choices.
+          </p>
+        </div>
+      )}
     </div>
   );
 };
diff --git a/ui/desktop/src/hooks/useRecipeManager.ts b/ui/desktop/src/hooks/useRecipeManager.ts
index fca9210cc37c..71aefacfa662 100644
--- a/ui/desktop/src/hooks/useRecipeManager.ts
+++ b/ui/desktop/src/hooks/useRecipeManager.ts
@@ -126,7 +126,7 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
 
     // Update the system prompt with parameter-substituted instructions
     try {
-      await updateSystemPromptWithParameters(inputValues);
+      await updateSystemPromptWithParameters(inputValues, recipeConfig || undefined);
     } catch (error) {
       console.error('Failed to update system prompt with parameters:', error);
     }
diff --git a/ui/desktop/src/recipe/index.ts b/ui/desktop/src/recipe/index.ts
index 5bf85f850465..0b80b454db7a 100644
--- a/ui/desktop/src/recipe/index.ts
+++ b/ui/desktop/src/recipe/index.ts
@@ -5,9 +5,10 @@ import { FullExtensionConfig } from '../extensions';
 export interface Parameter {
   key: string;
   description: string;
-  input_type: string;
+  input_type: 'string' | 'select' | 'number' | 'boolean';
   default?: string;
   requirement: 'required' | 'optional' | 'user_prompt';
+  options?: string[]; // For select input type
 }
 
 export interface Recipe {
diff --git a/ui/desktop/src/utils/providerUtils.ts b/ui/desktop/src/utils/providerUtils.ts
index 4c01006a81cc..ffb78d6b3e2e 100644
--- a/ui/desktop/src/utils/providerUtils.ts
+++ b/ui/desktop/src/utils/providerUtils.ts
@@ -70,11 +70,13 @@ const substituteParameters = (text: string, params: Record<string, string>): str
  * This should be called after recipe parameters are collected
  */
 export const updateSystemPromptWithParameters = async (
-  recipeParameters: Record<string, string>
+  recipeParameters: Record<string, string>,
+  recipeConfig?: { instructions?: string }
 ): Promise<void> => {
   try {
-    const recipeConfig = window.appConfig?.get?.('recipeConfig');
-    const originalInstructions = (recipeConfig as { instructions?: string })?.instructions;
+    // Use provided recipe config or fall back to app config
+    const config = recipeConfig || window.appConfig?.get?.('recipeConfig');
+    const originalInstructions = (config as { instructions?: string })?.instructions;
 
     if (!originalInstructions) {
       return;
@@ -96,7 +98,9 @@ export const updateSystemPromptWithParameters = async (
     });
 
     if (!response.ok) {
-      console.warn(`Failed to update system prompt with parameters: ${response.statusText}`);
+      console.warn(
+        `Failed to update system prompt with parameters: ${response.status} ${response.statusText}`
+      );
     }
   } catch (error) {
     console.error('Error updating system prompt with parameters:', error);

From 8e145d3974fb7de12d8a73718ec937d338749194 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 14:51:01 -0700
Subject: [PATCH 02/19] fix chat submitting text when unrelated button elements
 are clicked

---
 ui/desktop/src/components/BaseChat.tsx        |  30 +-
 ui/desktop/src/components/ChatInput.tsx       | 698 +++++++++---------
 ui/desktop/src/components/RecipeEditor.tsx    |  18 +-
 ui/desktop/src/components/ViewRecipeModal.tsx |  18 +-
 ui/desktop/src/components/ui/button.tsx       |  28 +-
 5 files changed, 396 insertions(+), 396 deletions(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 247d8bee1116..27a2d7e996f6 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -60,6 +60,7 @@ import { type View, ViewOptions } from '../App';
 import { MainPanelLayout } from './Layout/MainPanelLayout';
 import ChatInput from './ChatInput';
 import { ScrollArea, ScrollAreaHandle } from './ui/scroll-area';
+import { Button } from './ui/button';
 import { useChatEngine } from '../hooks/useChatEngine';
 import { useRecipeManager } from '../hooks/useRecipeManager';
 import { useSessionContinuation } from '../hooks/useSessionContinuation';
@@ -421,29 +422,6 @@ function BaseChatContent({
                             {error.message || 'Honk! Goose experienced an error while responding'}
                           </div>
 
-                          {/* Expandable Error Details */}
-                          <details className="w-full max-w-2xl mb-2">
-                            <summary className="text-xs text-textSubtle cursor-pointer hover:text-textStandard transition-colors">
-                              Error details
-                            </summary>
-                            <div className="mt-2 p-3 bg-bgSubtle border border-borderSubtle rounded-lg text-xs font-mono text-textStandard">
-                              <div className="mb-2">
-                                <strong>Error Type:</strong> {error.name || 'Unknown'}
-                              </div>
-                              <div className="mb-2">
-                                <strong>Message:</strong> {error.message || 'No message'}
-                              </div>
-                              {error.stack && (
-                                <div>
-                                  <strong>Stack Trace:</strong>
-                                  <pre className="mt-1 whitespace-pre-wrap text-xs overflow-x-auto">
-                                    {error.stack}
-                                  </pre>
-                                </div>
-                              )}
-                            </div>
-                          </details>
-
                           {/* Regular retry button for non-token-limit errors */}
                           <div
                             className="px-3 py-2 mt-2 text-center whitespace-nowrap cursor-pointer text-textStandard border border-borderSubtle hover:bg-bgSubtle rounded-full inline-block transition-all duration-150"
@@ -530,12 +508,14 @@ function BaseChatContent({
             <h3 className="text-lg font-medium text-textProminent mb-4">Recipe Creation Failed</h3>
             <p className="text-textStandard mb-6">{recipeError}</p>
             <div className="flex justify-end">
-              <button
+              <Button
                 onClick={() => setRecipeError(null)}
+                variant="default"
+                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors"
               >
                 OK
-              </button>
+              </Button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/ChatInput.tsx b/ui/desktop/src/components/ChatInput.tsx
index 7467dfe3c176..597201b53278 100644
--- a/ui/desktop/src/components/ChatInput.tsx
+++ b/ui/desktop/src/components/ChatInput.tsx
@@ -896,373 +896,375 @@ export default function ChatInput({
       onDrop={handleLocalDrop}
       onDragOver={handleLocalDragOver}
     >
-      <form onSubmit={onFormSubmit} className="flex flex-col">
-        {/* Input row with inline action buttons */}
-        <div className="relative flex items-end">
-          <div className="relative flex-1">
-            <textarea
-              data-testid="chat-input"
-              autoFocus
-              id="dynamic-textarea"
-              placeholder={isRecording ? '' : '⌘↑/⌘↓ to navigate messages'}
-              value={displayValue}
-              onChange={handleChange}
-              onCompositionStart={handleCompositionStart}
-              onCompositionEnd={handleCompositionEnd}
-              onKeyDown={handleKeyDown}
-              onPaste={handlePaste}
-              onFocus={() => setIsFocused(true)}
-              onBlur={() => setIsFocused(false)}
-              ref={textAreaRef}
-              rows={1}
-              style={{
-                maxHeight: `${maxHeight}px`,
-                overflowY: 'auto',
-                opacity: isRecording ? 0 : 1,
-              }}
-              className="w-full outline-none border-none focus:ring-0 bg-transparent px-3 pt-3 pb-1.5 pr-20 text-sm resize-none text-textStandard placeholder:text-textPlaceholder"
-            />
-            {isRecording && (
-              <div className="absolute inset-0 flex items-center pl-4 pr-20 pt-3 pb-1.5">
-                <WaveformVisualizer
-                  audioContext={audioContext}
-                  analyser={analyser}
-                  isRecording={isRecording}
-                />
-              </div>
-            )}
-          </div>
-
-          {/* Inline action buttons on the right */}
-          <div className="flex items-center gap-1 px-2 relative">
-            {/* Microphone button - show if dictation is enabled, disable if not configured */}
-            {dictationSettings?.enabled && (
-              <>
-                {!canUseDictation ? (
-                  <Tooltip>
-                    <TooltipTrigger asChild>
-                      <span className="inline-flex">
-                        <Button
-                          type="button"
-                          size="sm"
-                          shape="round"
-                          variant="outline"
-                          onClick={() => {}}
-                          disabled={true}
-                          className="bg-slate-600 text-white cursor-not-allowed opacity-50 border-slate-600 rounded-full px-6 py-2"
-                        >
-                          <Microphone />
-                        </Button>
-                      </span>
-                    </TooltipTrigger>
-                    <TooltipContent>
-                      {dictationSettings.provider === 'openai'
-                        ? 'OpenAI API key is not configured. Set it up in Settings > Models.'
-                        : dictationSettings.provider === 'elevenlabs'
-                          ? 'ElevenLabs API key is not configured. Set it up in Settings > Chat > Voice Dictation.'
-                          : 'Dictation provider is not properly configured.'}
-                    </TooltipContent>
-                  </Tooltip>
-                ) : (
-                  <Button
-                    type="button"
-                    size="sm"
-                    shape="round"
-                    variant="outline"
-                    onClick={() => {
-                      if (isRecording) {
-                        stopRecording();
-                      } else {
-                        startRecording();
-                      }
-                    }}
-                    disabled={isTranscribing}
-                    className={`rounded-full px-6 py-2 ${
-                      isRecording
-                        ? 'bg-red-500 text-white hover:bg-red-600 border-red-500'
-                        : isTranscribing
-                          ? 'bg-slate-600 text-white cursor-not-allowed animate-pulse border-slate-600'
-                          : 'bg-slate-600 text-white hover:bg-slate-700 border-slate-600'
-                    }`}
-                  >
-                    <Microphone />
-                  </Button>
-                )}
-              </>
-            )}
-
-            {/* Send/Stop button */}
-            {isLoading ? (
-              <Button
-                type="button"
-                onClick={onStop}
-                size="sm"
-                shape="round"
-                variant="outline"
-                className="bg-slate-600 text-white hover:bg-slate-700 border-slate-600 rounded-full px-6 py-2"
-              >
-                <Stop />
-              </Button>
-            ) : (
-              <Button
-                type="submit"
-                size="sm"
-                shape="round"
-                variant="outline"
-                disabled={
-                  !hasSubmittableContent ||
-                  isAnyImageLoading ||
-                  isAnyDroppedFileLoading ||
-                  isRecording ||
-                  isTranscribing ||
-                  isLoadingSummary
-                }
-                className={`rounded-full px-10 py-2 flex items-center gap-2 ${
-                  !hasSubmittableContent ||
-                  isAnyImageLoading ||
-                  isAnyDroppedFileLoading ||
-                  isRecording ||
-                  isTranscribing ||
-                  isLoadingSummary
-                    ? 'bg-slate-600 text-white cursor-not-allowed opacity-50 border-slate-600'
-                    : 'bg-slate-600 text-white hover:bg-slate-700 border-slate-600 hover:cursor-pointer'
-                }`}
-                title={
-                  isLoadingSummary
-                    ? 'Summarizing conversation...'
-                    : isAnyImageLoading
-                      ? 'Waiting for images to save...'
-                      : isAnyDroppedFileLoading
-                        ? 'Processing dropped files...'
-                        : isRecording
-                          ? 'Recording...'
-                          : isTranscribing
-                            ? 'Transcribing...'
-                            : 'Send'
-                }
-              >
-                <Send className="w-4 h-4" />
-                <span className="text-sm">Send</span>
-              </Button>
-            )}
-
-            {/* Recording/transcribing status indicator - positioned above the button row */}
-            {(isRecording || isTranscribing) && (
-              <div className="absolute right-0 -top-8 bg-background-default px-2 py-1 rounded text-xs whitespace-nowrap shadow-md border border-borderSubtle">
-                {isTranscribing ? (
-                  <span className="text-blue-500 flex items-center gap-1">
-                    <span className="inline-block w-2 h-2 bg-blue-500 rounded-full animate-pulse" />
-                    Transcribing...
-                  </span>
-                ) : (
-                  <span
-                    className={`flex items-center gap-2 ${estimatedSize > 20 ? 'text-orange-500' : 'text-textSubtle'}`}
-                  >
-                    <span className="inline-block w-2 h-2 bg-red-500 rounded-full animate-pulse" />
-                    {Math.floor(recordingDuration)}s • ~{estimatedSize.toFixed(1)}MB
-                    {estimatedSize > 20 && <span className="text-xs">(near 25MB limit)</span>}
-                  </span>
-                )}
-              </div>
-            )}
-          </div>
+      {/* Input row with inline action buttons wrapped in form */}
+      <form onSubmit={onFormSubmit} className="relative flex items-end">
+        <div className="relative flex-1">
+          <textarea
+            data-testid="chat-input"
+            autoFocus
+            id="dynamic-textarea"
+            placeholder={isRecording ? '' : '⌘↑/⌘↓ to navigate messages'}
+            value={displayValue}
+            onChange={handleChange}
+            onCompositionStart={handleCompositionStart}
+            onCompositionEnd={handleCompositionEnd}
+            onKeyDown={handleKeyDown}
+            onPaste={handlePaste}
+            onFocus={() => setIsFocused(true)}
+            onBlur={() => setIsFocused(false)}
+            ref={textAreaRef}
+            rows={1}
+            style={{
+              maxHeight: `${maxHeight}px`,
+              overflowY: 'auto',
+              opacity: isRecording ? 0 : 1,
+            }}
+            className="w-full outline-none border-none focus:ring-0 bg-transparent px-3 pt-3 pb-1.5 pr-20 text-sm resize-none text-textStandard placeholder:text-textPlaceholder"
+          />
+          {isRecording && (
+            <div className="absolute inset-0 flex items-center pl-4 pr-20 pt-3 pb-1.5">
+              <WaveformVisualizer
+                audioContext={audioContext}
+                analyser={analyser}
+                isRecording={isRecording}
+              />
+            </div>
+          )}
         </div>
 
-        {/* Combined files and images preview */}
-        {(pastedImages.length > 0 || allDroppedFiles.length > 0) && (
-          <div className="flex flex-wrap gap-2 p-2 border-t border-borderSubtle">
-            {/* Render pasted images first */}
-            {pastedImages.map((img) => (
-              <div key={img.id} className="relative group w-20 h-20">
-                {img.dataUrl && (
-                  <img
-                    src={img.dataUrl}
-                    alt={`Pasted image ${img.id}`}
-                    className={`w-full h-full object-cover rounded border ${img.error ? 'border-red-500' : 'border-borderStandard'}`}
-                  />
-                )}
-                {img.isLoading && (
-                  <div className="absolute inset-0 flex items-center justify-center bg-black bg-opacity-50 rounded">
-                    <div className="animate-spin rounded-full h-6 w-6 border-t-2 border-b-2 border-white"></div>
-                  </div>
-                )}
-                {img.error && !img.isLoading && (
-                  <div className="absolute inset-0 flex flex-col items-center justify-center bg-black bg-opacity-75 rounded p-1 text-center">
-                    <p className="text-red-400 text-[10px] leading-tight break-all mb-1">
-                      {img.error.substring(0, 50)}
-                    </p>
-                    {img.dataUrl && (
+        {/* Inline action buttons on the right */}
+        <div className="flex items-center gap-1 px-2 relative">
+          {/* Microphone button - show if dictation is enabled, disable if not configured */}
+          {dictationSettings?.enabled && (
+            <>
+              {!canUseDictation ? (
+                <Tooltip>
+                  <TooltipTrigger asChild>
+                    <span className="inline-flex">
                       <Button
                         type="button"
-                        onClick={() => handleRetryImageSave(img.id)}
-                        title="Retry saving image"
+                        size="sm"
+                        shape="round"
                         variant="outline"
-                        size="xs"
+                        onClick={() => {}}
+                        disabled={true}
+                        className="bg-slate-600 text-white cursor-not-allowed opacity-50 border-slate-600 rounded-full px-6 py-2"
                       >
-                        Retry
+                        <Microphone />
                       </Button>
-                    )}
-                  </div>
-                )}
-                {!img.isLoading && (
-                  <Button
-                    type="button"
-                    shape="round"
-                    onClick={() => handleRemovePastedImage(img.id)}
-                    className="absolute -top-1 -right-1 opacity-0 group-hover:opacity-100 focus:opacity-100 transition-opacity z-10"
-                    aria-label="Remove image"
-                    variant="outline"
-                    size="xs"
-                  >
-                    <Close />
-                  </Button>
-                )}
-              </div>
-            ))}
-
-            {/* Render dropped files after pasted images */}
-            {allDroppedFiles.map((file) => (
-              <div key={file.id} className="relative group">
-                {file.isImage ? (
-                  // Image preview
-                  <div className="w-20 h-20">
-                    {file.dataUrl && (
-                      <img
-                        src={file.dataUrl}
-                        alt={file.name}
-                        className={`w-full h-full object-cover rounded border ${file.error ? 'border-red-500' : 'border-borderStandard'}`}
-                      />
-                    )}
-                    {file.isLoading && (
-                      <div className="absolute inset-0 flex items-center justify-center bg-black bg-opacity-50 rounded">
-                        <div className="animate-spin rounded-full h-6 w-6 border-t-2 border-b-2 border-white"></div>
-                      </div>
-                    )}
-                    {file.error && !file.isLoading && (
-                      <div className="absolute inset-0 flex flex-col items-center justify-center bg-black bg-opacity-75 rounded p-1 text-center">
-                        <p className="text-red-400 text-[10px] leading-tight break-all">
-                          {file.error.substring(0, 30)}
-                        </p>
-                      </div>
-                    )}
-                  </div>
-                ) : (
-                  // File box preview
-                  <div className="flex items-center gap-2 px-3 py-2 bg-bgSubtle border border-borderStandard rounded-lg min-w-[120px] max-w-[200px]">
-                    <div className="flex-shrink-0 w-8 h-8 bg-background-default border border-borderSubtle rounded flex items-center justify-center text-xs font-mono text-textSubtle">
-                      {file.name.split('.').pop()?.toUpperCase() || 'FILE'}
+                    </span>
+                  </TooltipTrigger>
+                  <TooltipContent>
+                    {dictationSettings.provider === 'openai'
+                      ? 'OpenAI API key is not configured. Set it up in Settings > Models.'
+                      : dictationSettings.provider === 'elevenlabs'
+                        ? 'ElevenLabs API key is not configured. Set it up in Settings > Chat > Voice Dictation.'
+                        : 'Dictation provider is not properly configured.'}
+                  </TooltipContent>
+                </Tooltip>
+              ) : (
+                <Button
+                  type="button"
+                  size="sm"
+                  shape="round"
+                  variant="outline"
+                  onClick={() => {
+                    if (isRecording) {
+                      stopRecording();
+                    } else {
+                      startRecording();
+                    }
+                  }}
+                  disabled={isTranscribing}
+                  className={`rounded-full px-6 py-2 ${
+                    isRecording
+                      ? 'bg-red-500 text-white hover:bg-red-600 border-red-500'
+                      : isTranscribing
+                        ? 'bg-slate-600 text-white cursor-not-allowed animate-pulse border-slate-600'
+                        : 'bg-slate-600 text-white hover:bg-slate-700 border-slate-600'
+                  }`}
+                >
+                  <Microphone />
+                </Button>
+              )}
+            </>
+          )}
+
+          {/* Send/Stop button */}
+          {isLoading ? (
+            <Button
+              type="button"
+              onClick={onStop}
+              size="sm"
+              shape="round"
+              variant="outline"
+              className="bg-slate-600 text-white hover:bg-slate-700 border-slate-600 rounded-full px-6 py-2"
+            >
+              <Stop />
+            </Button>
+          ) : (
+            <Button
+              type="submit"
+              size="sm"
+              shape="round"
+              variant="outline"
+              disabled={
+                !hasSubmittableContent ||
+                isAnyImageLoading ||
+                isAnyDroppedFileLoading ||
+                isRecording ||
+                isTranscribing ||
+                isLoadingSummary
+              }
+              className={`rounded-full px-10 py-2 flex items-center gap-2 ${
+                !hasSubmittableContent ||
+                isAnyImageLoading ||
+                isAnyDroppedFileLoading ||
+                isRecording ||
+                isTranscribing ||
+                isLoadingSummary
+                  ? 'bg-slate-600 text-white cursor-not-allowed opacity-50 border-slate-600'
+                  : 'bg-slate-600 text-white hover:bg-slate-700 border-slate-600 hover:cursor-pointer'
+              }`}
+              title={
+                isLoadingSummary
+                  ? 'Summarizing conversation...'
+                  : isAnyImageLoading
+                    ? 'Waiting for images to save...'
+                    : isAnyDroppedFileLoading
+                      ? 'Processing dropped files...'
+                      : isRecording
+                        ? 'Recording...'
+                        : isTranscribing
+                          ? 'Transcribing...'
+                          : 'Send'
+              }
+            >
+              <Send className="w-4 h-4" />
+              <span className="text-sm">Send</span>
+            </Button>
+          )}
+
+          {/* Recording/transcribing status indicator - positioned above the button row */}
+          {(isRecording || isTranscribing) && (
+            <div className="absolute right-0 -top-8 bg-background-default px-2 py-1 rounded text-xs whitespace-nowrap shadow-md border border-borderSubtle">
+              {isTranscribing ? (
+                <span className="text-blue-500 flex items-center gap-1">
+                  <span className="inline-block w-2 h-2 bg-blue-500 rounded-full animate-pulse" />
+                  Transcribing...
+                </span>
+              ) : (
+                <span
+                  className={`flex items-center gap-2 ${estimatedSize > 20 ? 'text-orange-500' : 'text-textSubtle'}`}
+                >
+                  <span className="inline-block w-2 h-2 bg-red-500 rounded-full animate-pulse" />
+                  {Math.floor(recordingDuration)}s • ~{estimatedSize.toFixed(1)}MB
+                  {estimatedSize > 20 && <span className="text-xs">(near 25MB limit)</span>}
+                </span>
+              )}
+            </div>
+          )}
+        </div>
+      </form>
+
+      {/* Combined files and images preview */}
+      {(pastedImages.length > 0 || allDroppedFiles.length > 0) && (
+        <div className="flex flex-wrap gap-2 p-2 border-t border-borderSubtle">
+          {/* Render pasted images first */}
+          {pastedImages.map((img) => (
+            <div key={img.id} className="relative group w-20 h-20">
+              {img.dataUrl && (
+                <img
+                  src={img.dataUrl}
+                  alt={`Pasted image ${img.id}`}
+                  className={`w-full h-full object-cover rounded border ${img.error ? 'border-red-500' : 'border-borderStandard'}`}
+                />
+              )}
+              {img.isLoading && (
+                <div className="absolute inset-0 flex items-center justify-center bg-black bg-opacity-50 rounded">
+                  <div className="animate-spin rounded-full h-6 w-6 border-t-2 border-b-2 border-white"></div>
+                </div>
+              )}
+              {img.error && !img.isLoading && (
+                <div className="absolute inset-0 flex flex-col items-center justify-center bg-black bg-opacity-75 rounded p-1 text-center">
+                  <p className="text-red-400 text-[10px] leading-tight break-all mb-1">
+                    {img.error.substring(0, 50)}
+                  </p>
+                  {img.dataUrl && (
+                    <Button
+                      type="button"
+                      onClick={() => handleRetryImageSave(img.id)}
+                      title="Retry saving image"
+                      variant="outline"
+                      size="xs"
+                    >
+                      Retry
+                    </Button>
+                  )}
+                </div>
+              )}
+              {!img.isLoading && (
+                <Button
+                  type="button"
+                  shape="round"
+                  onClick={() => handleRemovePastedImage(img.id)}
+                  className="absolute -top-1 -right-1 opacity-0 group-hover:opacity-100 focus:opacity-100 transition-opacity z-10"
+                  aria-label="Remove image"
+                  variant="outline"
+                  size="xs"
+                >
+                  <Close />
+                </Button>
+              )}
+            </div>
+          ))}
+
+          {/* Render dropped files after pasted images */}
+          {allDroppedFiles.map((file) => (
+            <div key={file.id} className="relative group">
+              {file.isImage ? (
+                // Image preview
+                <div className="w-20 h-20">
+                  {file.dataUrl && (
+                    <img
+                      src={file.dataUrl}
+                      alt={file.name}
+                      className={`w-full h-full object-cover rounded border ${file.error ? 'border-red-500' : 'border-borderStandard'}`}
+                    />
+                  )}
+                  {file.isLoading && (
+                    <div className="absolute inset-0 flex items-center justify-center bg-black bg-opacity-50 rounded">
+                      <div className="animate-spin rounded-full h-6 w-6 border-t-2 border-b-2 border-white"></div>
                     </div>
-                    <div className="flex-1 min-w-0">
-                      <p className="text-sm text-textStandard truncate" title={file.name}>
-                        {file.name}
+                  )}
+                  {file.error && !file.isLoading && (
+                    <div className="absolute inset-0 flex flex-col items-center justify-center bg-black bg-opacity-75 rounded p-1 text-center">
+                      <p className="text-red-400 text-[10px] leading-tight break-all">
+                        {file.error.substring(0, 30)}
                       </p>
-                      <p className="text-xs text-textSubtle">{file.type || 'Unknown type'}</p>
                     </div>
+                  )}
+                </div>
+              ) : (
+                // File box preview
+                <div className="flex items-center gap-2 px-3 py-2 bg-bgSubtle border border-borderStandard rounded-lg min-w-[120px] max-w-[200px]">
+                  <div className="flex-shrink-0 w-8 h-8 bg-background-default border border-borderSubtle rounded flex items-center justify-center text-xs font-mono text-textSubtle">
+                    {file.name.split('.').pop()?.toUpperCase() || 'FILE'}
                   </div>
-                )}
-                {!file.isLoading && (
-                  <Button
-                    type="button"
-                    shape="round"
-                    onClick={() => handleRemoveDroppedFile(file.id)}
-                    className="absolute -top-1 -right-1 opacity-0 group-hover:opacity-100 focus:opacity-100 transition-opacity z-10"
-                    aria-label="Remove file"
-                    variant="outline"
-                    size="xs"
-                  >
-                    <Close />
-                  </Button>
-                )}
+                  <div className="flex-1 min-w-0">
+                    <p className="text-sm text-textStandard truncate" title={file.name}>
+                      {file.name}
+                    </p>
+                    <p className="text-xs text-textSubtle">{file.type || 'Unknown type'}</p>
+                  </div>
+                </div>
+              )}
+              {!file.isLoading && (
+                <Button
+                  type="button"
+                  shape="round"
+                  onClick={() => handleRemoveDroppedFile(file.id)}
+                  className="absolute -top-1 -right-1 opacity-0 group-hover:opacity-100 focus:opacity-100 transition-opacity z-10"
+                  aria-label="Remove file"
+                  variant="outline"
+                  size="xs"
+                >
+                  <Close />
+                </Button>
+              )}
+            </div>
+          ))}
+        </div>
+      )}
+
+      {/* Secondary actions and controls row below input */}
+      <div className="flex flex-row items-center gap-1 p-2 relative">
+        {/* Directory path */}
+        <DirSwitcher hasMessages={messages.length > 0} className="mr-0" />
+        <div className="w-px h-4 bg-border-default mx-2" />
+
+        {/* Attach button */}
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Button
+              type="button"
+              onClick={handleFileSelect}
+              variant="ghost"
+              size="sm"
+              className="flex items-center justify-center text-text-default/70 hover:text-text-default text-xs cursor-pointer transition-colors"
+            >
+              <Attach className="w-4 h-4" />
+            </Button>
+          </TooltipTrigger>
+          <TooltipContent>Attach file or directory</TooltipContent>
+        </Tooltip>
+        <div className="w-px h-4 bg-border-default mx-2" />
+
+        {/* Model selector, mode selector, alerts, summarize button */}
+        <div className="flex flex-row items-center">
+          {/* Cost Tracker */}
+          {COST_TRACKING_ENABLED && (
+            <>
+              <div className="flex items-center h-full ml-1 mr-1">
+                <CostTracker
+                  inputTokens={inputTokens}
+                  outputTokens={outputTokens}
+                  sessionCosts={sessionCosts}
+                />
               </div>
-            ))}
-          </div>
-        )}
-
-        {/* Secondary actions and controls row below input */}
-        <div className="flex flex-row items-center gap-1 p-2 relative">
-          {/* Directory path */}
-          <DirSwitcher hasMessages={messages.length > 0} className="mr-0" />
-          <div className="w-px h-4 bg-border-default mx-2" />
-
-          {/* Attach button */}
+            </>
+          )}
           <Tooltip>
-            <TooltipTrigger asChild>
-              <button
-                type="button"
-                className="flex items-center justify-center text-text-default/70 hover:text-text-default text-xs cursor-pointer transition-colors"
-                onClick={handleFileSelect}
-              >
-                <Attach className="w-4 h-4" />
-              </button>
-            </TooltipTrigger>
-            <TooltipContent>Attach file or directory</TooltipContent>
+            <div>
+              <ModelsBottomBar
+                dropdownRef={dropdownRef}
+                setView={setView}
+                alerts={alerts}
+                recipeConfig={recipeConfig}
+                hasMessages={messages.length > 0}
+              />
+            </div>
           </Tooltip>
           <div className="w-px h-4 bg-border-default mx-2" />
-
-          {/* Model selector, mode selector, alerts, summarize button */}
-          <div className="flex flex-row items-center">
-            {/* Cost Tracker */}
-            {COST_TRACKING_ENABLED && (
-              <>
-                <div className="flex items-center h-full ml-1 mr-1">
-                  <CostTracker
-                    inputTokens={inputTokens}
-                    outputTokens={outputTokens}
-                    sessionCosts={sessionCosts}
-                  />
-                </div>
-              </>
-            )}
+          <BottomMenuModeSelection />
+          {messages.length > 0 && (
+            <ManualSummarizeButton
+              messages={messages}
+              isLoading={isLoading}
+              setMessages={setMessages}
+            />
+          )}
+          <div className="w-px h-4 bg-border-default mx-2" />
+          <div className="flex items-center h-full">
             <Tooltip>
-              <div>
-                <ModelsBottomBar
-                  dropdownRef={dropdownRef}
-                  setView={setView}
-                  alerts={alerts}
-                  recipeConfig={recipeConfig}
-                  hasMessages={messages.length > 0}
-                />
-              </div>
+              <TooltipTrigger asChild>
+                <Button
+                  onClick={() => setIsGoosehintsModalOpen?.(true)}
+                  variant="ghost"
+                  size="sm"
+                  className="flex items-center justify-center text-text-default/70 hover:text-text-default text-xs cursor-pointer"
+                >
+                  <FolderKey size={16} />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent>Configure goosehints</TooltipContent>
             </Tooltip>
-            <div className="w-px h-4 bg-border-default mx-2" />
-            <BottomMenuModeSelection />
-            {messages.length > 0 && (
-              <ManualSummarizeButton
-                messages={messages}
-                isLoading={isLoading}
-                setMessages={setMessages}
-              />
-            )}
-            <div className="w-px h-4 bg-border-default mx-2" />
-            <div className="flex items-center h-full">
-              <Tooltip>
-                <TooltipTrigger asChild>
-                  <button
-                    className="flex items-center justify-center text-text-default/70 hover:text-text-default text-xs cursor-pointer"
-                    onClick={() => setIsGoosehintsModalOpen?.(true)}
-                  >
-                    <FolderKey size={16} />
-                  </button>
-                </TooltipTrigger>
-                <TooltipContent>Configure goosehints</TooltipContent>
-              </Tooltip>
-            </div>
           </div>
-
-          <MentionPopover
-            ref={mentionPopoverRef}
-            isOpen={mentionPopover.isOpen}
-            onClose={() => setMentionPopover((prev) => ({ ...prev, isOpen: false }))}
-            onSelect={handleMentionFileSelect}
-            position={mentionPopover.position}
-            query={mentionPopover.query}
-            selectedIndex={mentionPopover.selectedIndex}
-            onSelectedIndexChange={(index) =>
-              setMentionPopover((prev) => ({ ...prev, selectedIndex: index }))
-            }
-          />
         </div>
-      </form>
+
+        <MentionPopover
+          ref={mentionPopoverRef}
+          isOpen={mentionPopover.isOpen}
+          onClose={() => setMentionPopover((prev) => ({ ...prev, isOpen: false }))}
+          onSelect={handleMentionFileSelect}
+          position={mentionPopover.position}
+          query={mentionPopover.query}
+          selectedIndex={mentionPopover.selectedIndex}
+          onSelectedIndexChange={(index) =>
+            setMentionPopover((prev) => ({ ...prev, selectedIndex: index }))
+          }
+        />
+      </div>
     </div>
   );
 }
diff --git a/ui/desktop/src/components/RecipeEditor.tsx b/ui/desktop/src/components/RecipeEditor.tsx
index 79d780260190..06946f765fb4 100644
--- a/ui/desktop/src/components/RecipeEditor.tsx
+++ b/ui/desktop/src/components/RecipeEditor.tsx
@@ -503,14 +503,16 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
           {/* Action Buttons */}
           <div className="flex flex-col space-y-3 pt-4">
             <div className="flex gap-3">
-              <button
+              <Button
                 onClick={handleSaveRecipeClick}
                 disabled={!requiredFieldsAreFilled() || saving}
+                variant="outline"
+                size="lg"
                 className="flex-1 inline-flex items-center justify-center gap-2 px-4 py-3 bg-bgStandard text-textStandard border border-borderStandard rounded-lg hover:bg-bgSubtle transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 <Save className="w-4 h-4" />
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </button>
+              </Button>
               <Button
                 onClick={() => setIsScheduleModalOpen(true)}
                 disabled={!requiredFieldsAreFilled()}
@@ -613,23 +615,27 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
             </div>
 
             <div className="flex justify-end space-x-3 mt-6">
-              <button
+              <Button
                 onClick={() => {
                   setShowSaveDialog(false);
                   setSaveRecipeName('');
                 }}
+                variant="ghost"
+                size="default"
                 className="px-4 py-2 text-textSubtle hover:text-textStandard transition-colors"
                 disabled={saving}
               >
                 Cancel
-              </button>
-              <button
+              </Button>
+              <Button
                 onClick={handleSaveRecipe}
                 disabled={!saveRecipeName.trim() || saving}
+                variant="default"
+                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </button>
+              </Button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index bdd5e825df21..b5405c92ecd0 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -466,14 +466,16 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
           </Button>
 
           <div className="flex gap-3">
-            <button
+            <Button
               onClick={handleSaveRecipeClick}
               disabled={!requiredFieldsAreFilled() || saving}
+              variant="outline"
+              size="default"
               className="inline-flex items-center justify-center gap-2 px-4 py-2 bg-bgStandard text-textStandard border border-borderStandard rounded-lg hover:bg-bgSubtle transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
             >
               <Save className="w-4 h-4" />
               {saving ? 'Saving...' : 'Save Recipe'}
-            </button>
+            </Button>
             <Button
               onClick={() => setIsScheduleModalOpen(true)}
               disabled={!requiredFieldsAreFilled()}
@@ -574,23 +576,27 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
             </div>
 
             <div className="flex justify-end space-x-3 mt-6">
-              <button
+              <Button
                 onClick={() => {
                   setShowSaveDialog(false);
                   setSaveRecipeName('');
                 }}
+                variant="ghost"
+                size="default"
                 className="px-4 py-2 text-textSubtle hover:text-textStandard transition-colors"
                 disabled={saving}
               >
                 Cancel
-              </button>
-              <button
+              </Button>
+              <Button
                 onClick={handleSaveRecipe}
                 disabled={!saveRecipeName.trim() || saving}
+                variant="default"
+                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </button>
+              </Button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/ui/button.tsx b/ui/desktop/src/components/ui/button.tsx
index 04cc74cb6298..e1d276014af4 100644
--- a/ui/desktop/src/components/ui/button.tsx
+++ b/ui/desktop/src/components/ui/button.tsx
@@ -84,18 +84,24 @@ const Button = React.forwardRef<
       asChild?: boolean;
       shape?: 'pill' | 'round';
     }
->(({ className, variant, size, asChild = false, shape = 'pill', ...props }, ref) => {
-  const Comp = asChild ? Slot : 'button';
+>(
+  (
+    { className, variant, size, asChild = false, shape = 'pill', type = 'button', ...props },
+    ref
+  ) => {
+    const Comp = asChild ? Slot : 'button';
 
-  return (
-    <Comp
-      data-slot="button"
-      className={cn(buttonVariants({ variant, size, shape, className }))}
-      ref={ref}
-      {...props}
-    />
-  );
-});
+    return (
+      <Comp
+        data-slot="button"
+        className={cn(buttonVariants({ variant, size, shape, className }))}
+        type={type}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
 
 Button.displayName = 'Button';
 

From 97732f3146010aa639ccbbb004cfddcef466bebd Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 16:24:13 -0700
Subject: [PATCH 03/19] fix navigating away from active recipe resets recipe in
 progress

---
 ui/desktop/src/App.tsx                   | 45 ++++++++++++++++++------
 ui/desktop/src/components/BaseChat.tsx   | 18 +++++++---
 ui/desktop/src/components/hub.tsx        |  1 +
 ui/desktop/src/components/pair.tsx       |  1 +
 ui/desktop/src/contexts/ChatContext.tsx  | 19 ++++++++++
 ui/desktop/src/hooks/useRecipeManager.ts | 20 ++++++++---
 6 files changed, 85 insertions(+), 19 deletions(-)

diff --git a/ui/desktop/src/App.tsx b/ui/desktop/src/App.tsx
index ebd32050d0a3..9fe14e54641a 100644
--- a/ui/desktop/src/App.tsx
+++ b/ui/desktop/src/App.tsx
@@ -182,6 +182,12 @@ const PairRouteWrapper = ({
 
   // Check if we have a resumed session or recipe config from navigation state
   useEffect(() => {
+    // Only process if we actually have navigation state
+    if (!location.state) {
+      console.log('No navigation state, preserving existing chat state');
+      return;
+    }
+
     const resumedSession = location.state?.resumedSession as SessionDetails | undefined;
     const recipeConfig = location.state?.recipeConfig as Recipe | undefined;
     const resetChat = location.state?.resetChat as boolean | undefined;
@@ -205,22 +211,32 @@ const PairRouteWrapper = ({
 
       // Clear the navigation state to prevent reloading on navigation
       window.history.replaceState({}, document.title);
-    } else if (recipeConfig) {
-      console.log('Loading recipe config in pair view:', recipeConfig.title);
+    } else if (recipeConfig && resetChat) {
+      console.log('Loading new recipe config in pair view:', recipeConfig.title);
 
-      // Load recipe config and optionally reset chat
-      // Use the ref to get the current chat state without adding it as a dependency
-      const currentChat = chatRef.current;
       const updatedChat: ChatType = {
-        ...currentChat,
-        recipeConfig: recipeConfig,
+        id: chatRef.current.id, // Keep the same ID
         title: recipeConfig.title || 'Recipe Chat',
+        messages: [], // Clear messages to start fresh
+        messageHistoryIndex: 0,
+        recipeConfig: recipeConfig,
+        recipeParameters: null, // Clear parameters for new recipe
       };
 
-      if (resetChat) {
-        updatedChat.messages = [];
-        updatedChat.messageHistoryIndex = 0;
-      }
+      // Update both the local chat state and the app-level pairChat state
+      setChat(updatedChat);
+      setPairChat(updatedChat);
+
+      // Clear the navigation state to prevent reloading on navigation
+      window.history.replaceState({}, document.title);
+    } else if (recipeConfig && !chatRef.current.recipeConfig) {
+      // Only set recipe config if we don't already have one (e.g., from deeplinks)
+
+      const updatedChat: ChatType = {
+        ...chatRef.current,
+        recipeConfig: recipeConfig,
+        title: recipeConfig.title || chatRef.current.title,
+      };
 
       // Update both the local chat state and the app-level pairChat state
       setChat(updatedChat);
@@ -228,7 +244,14 @@ const PairRouteWrapper = ({
 
       // Clear the navigation state to prevent reloading on navigation
       window.history.replaceState({}, document.title);
+    } else if (location.state) {
+      // We have navigation state but it doesn't match our conditions
+      // Clear it to prevent future processing, but don't modify chat state
+      console.log('Clearing unprocessed navigation state');
+      window.history.replaceState({}, document.title);
     }
+    // If we have a recipe config but resetChat is false and we already have a recipe,
+    // do nothing - just continue with the existing chat state
   }, [location.state, setChat, setPairChat]);
 
   return (
diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 27a2d7e996f6..a654bbc860ff 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -79,6 +79,7 @@ export interface ChatType {
   messageHistoryIndex: number;
   messages: Message[];
   recipeConfig?: Recipe | null; // Add recipe configuration to chat state
+  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
 }
 
 interface BaseChatProps {
@@ -201,16 +202,25 @@ function BaseChatContent({
   // Reset recipe usage tracking when recipe changes
   useEffect(() => {
     if (recipeConfig?.title !== currentRecipeTitle) {
+      const previousTitle = currentRecipeTitle;
       setCurrentRecipeTitle(recipeConfig?.title || null);
-      setHasStartedUsingRecipe(false);
 
-      // Clear existing messages when a new recipe is loaded
-      if (recipeConfig?.title && recipeConfig.title !== currentRecipeTitle) {
+      // Only reset usage if we're switching between different recipes
+      // Don't reset if we're going from no recipe to a recipe (initial load)
+      // or if we already have messages (ongoing conversation)
+      if (previousTitle && recipeConfig?.title && previousTitle !== recipeConfig.title) {
+        console.log('Switching from recipe:', previousTitle, 'to:', recipeConfig.title);
+        setHasStartedUsingRecipe(false);
         setMessages([]);
         setAncestorMessages([]);
+      } else if (!previousTitle && recipeConfig?.title && messages.length === 0) {
+        setHasStartedUsingRecipe(false);
+        // Only clear messages if we don't have any yet
+      } else if (recipeConfig?.title && messages.length > 0) {
+        setHasStartedUsingRecipe(true); // Mark as started since we have messages
       }
     }
-  }, [recipeConfig?.title, currentRecipeTitle, setMessages, setAncestorMessages]);
+  }, [recipeConfig?.title, currentRecipeTitle, messages.length, setMessages, setAncestorMessages]);
 
   // Handle recipe auto-execution
   useEffect(() => {
diff --git a/ui/desktop/src/components/hub.tsx b/ui/desktop/src/components/hub.tsx
index 044a1f1aa7bb..653f4d898292 100644
--- a/ui/desktop/src/components/hub.tsx
+++ b/ui/desktop/src/components/hub.tsx
@@ -36,6 +36,7 @@ export interface ChatType {
   messageHistoryIndex: number;
   messages: Message[];
   recipeConfig?: Recipe | null; // Add recipe configuration to chat state
+  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
 }
 
 export default function Hub({
diff --git a/ui/desktop/src/components/pair.tsx b/ui/desktop/src/components/pair.tsx
index b2597672ee27..e3d38af8207c 100644
--- a/ui/desktop/src/components/pair.tsx
+++ b/ui/desktop/src/components/pair.tsx
@@ -43,6 +43,7 @@ export interface ChatType {
   messageHistoryIndex: number;
   messages: Message[];
   recipeConfig?: Recipe | null; // Add recipe configuration to chat state
+  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
 }
 
 export default function Pair({
diff --git a/ui/desktop/src/contexts/ChatContext.tsx b/ui/desktop/src/contexts/ChatContext.tsx
index 257aa79da6aa..1c1e500ae45f 100644
--- a/ui/desktop/src/contexts/ChatContext.tsx
+++ b/ui/desktop/src/contexts/ChatContext.tsx
@@ -11,6 +11,8 @@ interface ChatContextType {
   hasActiveSession: boolean;
   setRecipeConfig: (recipe: Recipe | null) => void;
   clearRecipeConfig: () => void;
+  setRecipeParameters: (parameters: Record<string, string> | null) => void;
+  clearRecipeParameters: () => void;
   // Draft functionality
   draft: string;
   setDraft: (draft: string) => void;
@@ -55,6 +57,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
       messages: [],
       messageHistoryIndex: 0,
       recipeConfig: null, // Clear recipe when resetting chat
+      recipeParameters: null, // Clear parameters when resetting chat
     });
     // Clear draft when resetting chat
     clearDraft();
@@ -74,6 +77,20 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     });
   };
 
+  const setRecipeParameters = (parameters: Record<string, string> | null) => {
+    setChat({
+      ...chat,
+      recipeParameters: parameters,
+    });
+  };
+
+  const clearRecipeParameters = () => {
+    setChat({
+      ...chat,
+      recipeParameters: null,
+    });
+  };
+
   const hasActiveSession = chat.messages.length > 0;
 
   const value: ChatContextType = {
@@ -83,6 +100,8 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     hasActiveSession,
     setRecipeConfig,
     clearRecipeConfig,
+    setRecipeParameters,
+    clearRecipeParameters,
     draft,
     setDraft,
     clearDraft,
diff --git a/ui/desktop/src/hooks/useRecipeManager.ts b/ui/desktop/src/hooks/useRecipeManager.ts
index 71aefacfa662..1d09191233b6 100644
--- a/ui/desktop/src/hooks/useRecipeManager.ts
+++ b/ui/desktop/src/hooks/useRecipeManager.ts
@@ -13,11 +13,10 @@ interface LocationState {
 export const useRecipeManager = (messages: Message[], locationState?: LocationState) => {
   const [isGeneratingRecipe, setIsGeneratingRecipe] = useState(false);
   const [isParameterModalOpen, setIsParameterModalOpen] = useState(false);
-  const [recipeParameters, setRecipeParameters] = useState<Record<string, string> | null>(null);
   const [readyForAutoUserPrompt, setReadyForAutoUserPrompt] = useState(false);
   const [recipeError, setRecipeError] = useState<string | null>(null);
 
-  // Get chat context to access persisted recipe
+  // Get chat context to access persisted recipe and parameters
   const chatContext = useChatContext();
 
   // Use a ref to capture the current messages for the event handler
@@ -53,6 +52,11 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
     return null;
   }, [chatContext, locationState]);
 
+  // Get recipe parameters from chat context
+  const recipeParameters = useMemo(() => {
+    return chatContext?.chat.recipeParameters || null;
+  }, [chatContext?.chat.recipeParameters]);
+
   // Effect to persist recipe config to chat context when it changes
   useEffect(() => {
     if (!chatContext?.setRecipeConfig) return;
@@ -101,6 +105,11 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
 
   // Pre-fill input with recipe prompt instead of auto-sending it
   const initialPrompt = useMemo(() => {
+    // Don't show initial prompt if we already have messages (ongoing conversation)
+    if (messages.length > 0) {
+      return '';
+    }
+
     if (!recipeConfig?.prompt) return '';
 
     const hasRequiredParams = recipeConfig.parameters && recipeConfig.parameters.length > 0;
@@ -117,11 +126,14 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
 
     // Otherwise, we are waiting for parameters, so the input should be empty.
     return '';
-  }, [recipeConfig, recipeParameters]);
+  }, [recipeConfig, recipeParameters, messages.length]);
 
   // Handle parameter submission
   const handleParameterSubmit = async (inputValues: Record<string, string>) => {
-    setRecipeParameters(inputValues);
+    // Store parameters in chat context instead of local state
+    if (chatContext?.setRecipeParameters) {
+      chatContext.setRecipeParameters(inputValues);
+    }
     setIsParameterModalOpen(false);
 
     // Update the system prompt with parameter-substituted instructions

From 135ad72ef26ca2f288fe47d2f882195d6dd7cfac Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 17:46:28 -0700
Subject: [PATCH 04/19] revert button changes

---
 ui/desktop/src/components/BaseChat.tsx        |  7 ++---
 ui/desktop/src/components/RecipeEditor.tsx    | 18 ++++--------
 ui/desktop/src/components/ViewRecipeModal.tsx | 18 ++++--------
 ui/desktop/src/components/ui/button.tsx       | 28 ++++++++-----------
 4 files changed, 25 insertions(+), 46 deletions(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index a654bbc860ff..dc095ae69667 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -60,7 +60,6 @@ import { type View, ViewOptions } from '../App';
 import { MainPanelLayout } from './Layout/MainPanelLayout';
 import ChatInput from './ChatInput';
 import { ScrollArea, ScrollAreaHandle } from './ui/scroll-area';
-import { Button } from './ui/button';
 import { useChatEngine } from '../hooks/useChatEngine';
 import { useRecipeManager } from '../hooks/useRecipeManager';
 import { useSessionContinuation } from '../hooks/useSessionContinuation';
@@ -518,14 +517,12 @@ function BaseChatContent({
             <h3 className="text-lg font-medium text-textProminent mb-4">Recipe Creation Failed</h3>
             <p className="text-textStandard mb-6">{recipeError}</p>
             <div className="flex justify-end">
-              <Button
+              <button
                 onClick={() => setRecipeError(null)}
-                variant="default"
-                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors"
               >
                 OK
-              </Button>
+              </button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/RecipeEditor.tsx b/ui/desktop/src/components/RecipeEditor.tsx
index 06946f765fb4..79d780260190 100644
--- a/ui/desktop/src/components/RecipeEditor.tsx
+++ b/ui/desktop/src/components/RecipeEditor.tsx
@@ -503,16 +503,14 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
           {/* Action Buttons */}
           <div className="flex flex-col space-y-3 pt-4">
             <div className="flex gap-3">
-              <Button
+              <button
                 onClick={handleSaveRecipeClick}
                 disabled={!requiredFieldsAreFilled() || saving}
-                variant="outline"
-                size="lg"
                 className="flex-1 inline-flex items-center justify-center gap-2 px-4 py-3 bg-bgStandard text-textStandard border border-borderStandard rounded-lg hover:bg-bgSubtle transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 <Save className="w-4 h-4" />
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </Button>
+              </button>
               <Button
                 onClick={() => setIsScheduleModalOpen(true)}
                 disabled={!requiredFieldsAreFilled()}
@@ -615,27 +613,23 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
             </div>
 
             <div className="flex justify-end space-x-3 mt-6">
-              <Button
+              <button
                 onClick={() => {
                   setShowSaveDialog(false);
                   setSaveRecipeName('');
                 }}
-                variant="ghost"
-                size="default"
                 className="px-4 py-2 text-textSubtle hover:text-textStandard transition-colors"
                 disabled={saving}
               >
                 Cancel
-              </Button>
-              <Button
+              </button>
+              <button
                 onClick={handleSaveRecipe}
                 disabled={!saveRecipeName.trim() || saving}
-                variant="default"
-                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </Button>
+              </button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index b5405c92ecd0..bdd5e825df21 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -466,16 +466,14 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
           </Button>
 
           <div className="flex gap-3">
-            <Button
+            <button
               onClick={handleSaveRecipeClick}
               disabled={!requiredFieldsAreFilled() || saving}
-              variant="outline"
-              size="default"
               className="inline-flex items-center justify-center gap-2 px-4 py-2 bg-bgStandard text-textStandard border border-borderStandard rounded-lg hover:bg-bgSubtle transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
             >
               <Save className="w-4 h-4" />
               {saving ? 'Saving...' : 'Save Recipe'}
-            </Button>
+            </button>
             <Button
               onClick={() => setIsScheduleModalOpen(true)}
               disabled={!requiredFieldsAreFilled()}
@@ -576,27 +574,23 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
             </div>
 
             <div className="flex justify-end space-x-3 mt-6">
-              <Button
+              <button
                 onClick={() => {
                   setShowSaveDialog(false);
                   setSaveRecipeName('');
                 }}
-                variant="ghost"
-                size="default"
                 className="px-4 py-2 text-textSubtle hover:text-textStandard transition-colors"
                 disabled={saving}
               >
                 Cancel
-              </Button>
-              <Button
+              </button>
+              <button
                 onClick={handleSaveRecipe}
                 disabled={!saveRecipeName.trim() || saving}
-                variant="default"
-                size="default"
                 className="px-4 py-2 bg-textProminent text-bgApp rounded-lg hover:bg-opacity-90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
               >
                 {saving ? 'Saving...' : 'Save Recipe'}
-              </Button>
+              </button>
             </div>
           </div>
         </div>
diff --git a/ui/desktop/src/components/ui/button.tsx b/ui/desktop/src/components/ui/button.tsx
index e1d276014af4..04cc74cb6298 100644
--- a/ui/desktop/src/components/ui/button.tsx
+++ b/ui/desktop/src/components/ui/button.tsx
@@ -84,24 +84,18 @@ const Button = React.forwardRef<
       asChild?: boolean;
       shape?: 'pill' | 'round';
     }
->(
-  (
-    { className, variant, size, asChild = false, shape = 'pill', type = 'button', ...props },
-    ref
-  ) => {
-    const Comp = asChild ? Slot : 'button';
+>(({ className, variant, size, asChild = false, shape = 'pill', ...props }, ref) => {
+  const Comp = asChild ? Slot : 'button';
 
-    return (
-      <Comp
-        data-slot="button"
-        className={cn(buttonVariants({ variant, size, shape, className }))}
-        type={type}
-        ref={ref}
-        {...props}
-      />
-    );
-  }
-);
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, shape, className }))}
+      ref={ref}
+      {...props}
+    />
+  );
+});
 
 Button.displayName = 'Button';
 

From e7f8b58732ea07be8a060e74fb0aff2de0f1602a Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 18:48:31 -0700
Subject: [PATCH 05/19] actually use select, boolean and number fields

---
 .../src/components/ParameterInputModal.tsx    | 29 +++++++++++-
 ui/desktop/src/components/RecipeEditor.tsx    |  7 ++-
 ui/desktop/src/components/ViewRecipeModal.tsx | 46 +++++++++++--------
 .../components/parameter/ParameterInput.tsx   |  9 +++-
 4 files changed, 69 insertions(+), 22 deletions(-)

diff --git a/ui/desktop/src/components/ParameterInputModal.tsx b/ui/desktop/src/components/ParameterInputModal.tsx
index 65564068239d..33cafc278230 100644
--- a/ui/desktop/src/components/ParameterInputModal.tsx
+++ b/ui/desktop/src/components/ParameterInputModal.tsx
@@ -21,8 +21,33 @@ const ParameterInputModal: React.FC<ParameterInputModalProps> = ({
   useEffect(() => {
     const initialValues: Record<string, string> = {};
     parameters.forEach((param) => {
-      if (param.default) {
-        initialValues[param.key] = param.default;
+      // Set default value for optional parameters if they have a default value
+      if (param.requirement === 'optional' && param.default) {
+        // Validate default value based on parameter type
+        let defaultValue = param.default;
+
+        // For boolean parameters, ensure the default is 'true' or 'false'
+        if (param.input_type === 'boolean') {
+          if (param.default.toLowerCase() === 'true' || param.default.toLowerCase() === 'false') {
+            defaultValue = param.default.toLowerCase();
+          }
+        }
+
+        // For select parameters, ensure the default is one of the valid options
+        if (param.input_type === 'select' && param.options) {
+          if (param.options.includes(param.default)) {
+            defaultValue = param.default;
+          }
+        }
+
+        // For number parameters, ensure the default is a valid number
+        if (param.input_type === 'number') {
+          if (!isNaN(Number(param.default))) {
+            defaultValue = param.default;
+          }
+        }
+
+        initialValues[param.key] = defaultValue;
       }
     });
     setInputValues(initialValues);
diff --git a/ui/desktop/src/components/RecipeEditor.tsx b/ui/desktop/src/components/RecipeEditor.tsx
index 79d780260190..346d2dd6c67f 100644
--- a/ui/desktop/src/components/RecipeEditor.tsx
+++ b/ui/desktop/src/components/RecipeEditor.tsx
@@ -139,7 +139,7 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
     const formattedParameters = parameters.map((param) => {
       const formattedParam: Parameter = {
         key: param.key,
-        input_type: 'string',
+        input_type: param.input_type || 'string', // Use actual input_type instead of hardcoded 'string'
         requirement: param.requirement,
         description: param.description,
       };
@@ -150,6 +150,11 @@ export default function RecipeEditor({ config }: RecipeEditorProps) {
         formattedParam.default = param.default;
       }
 
+      // Add options for select input type
+      if (param.input_type === 'select' && param.options) {
+        formattedParam.options = param.options.filter((opt) => opt.trim() !== ''); // Filter empty options when saving
+      }
+
       return formattedParam;
     });
 
diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index bdd5e825df21..bae5ea510c05 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -38,9 +38,7 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
   const [instructions, setInstructions] = useState(config?.instructions || '');
   const [prompt, setPrompt] = useState(config?.prompt || '');
   const [activities, setActivities] = useState<string[]>(config?.activities || []);
-  const [parameters, setParameters] = useState<Parameter[]>(
-    parseParametersFromInstructions(instructions)
-  );
+  const [parameters, setParameters] = useState<Parameter[]>(config?.parameters || []);
 
   const [extensionOptions, setExtensionOptions] = useState<FixedExtensionEntry[]>([]);
   const [extensionsLoaded, setExtensionsLoaded] = useState(false);
@@ -73,7 +71,8 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
       setInstructions(config.instructions || '');
       setPrompt(config.prompt || '');
       setActivities(config.activities || []);
-      setParameters(parseParametersFromInstructions(config.instructions || ''));
+      // Use the actual parameters from the config, not parsed from instructions
+      setParameters(config.parameters || []);
     }
   }, [config]);
 
@@ -102,28 +101,34 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
     }
   }, [isOpen, getExtensions, recipeExtensions, extensionsLoaded]);
 
-  // Use effect to set parameters whenever instructions or prompt changes
+  // Only auto-parse parameters from instructions if no parameters exist yet
+  // This prevents overwriting existing parameter configurations
   useEffect(() => {
-    const instructionsParams = parseParametersFromInstructions(instructions);
-    const promptParams = parseParametersFromInstructions(prompt);
-
-    // Combine parameters, ensuring no duplicates by key
-    const allParams = [...instructionsParams];
-    promptParams.forEach((promptParam) => {
-      if (!allParams.some((param) => param.key === promptParam.key)) {
-        allParams.push(promptParam);
-      }
-    });
+    // Only parse parameters if we don't have any existing parameters
+    if (parameters.length === 0) {
+      const instructionsParams = parseParametersFromInstructions(instructions);
+      const promptParams = parseParametersFromInstructions(prompt);
+
+      // Combine parameters, ensuring no duplicates by key
+      const allParams = [...instructionsParams];
+      promptParams.forEach((promptParam) => {
+        if (!allParams.some((param) => param.key === promptParam.key)) {
+          allParams.push(promptParam);
+        }
+      });
 
-    setParameters(allParams);
-  }, [instructions, prompt]);
+      if (allParams.length > 0) {
+        setParameters(allParams);
+      }
+    }
+  }, [instructions, prompt, parameters.length]);
 
   const getCurrentConfig = (): Recipe => {
     // Transform the internal parameters state into the desired output format.
     const formattedParameters = parameters.map((param) => {
       const formattedParam: Parameter = {
         key: param.key,
-        input_type: 'string',
+        input_type: param.input_type || 'string', // Use actual input_type instead of hardcoded 'string'
         requirement: param.requirement,
         description: param.description,
       };
@@ -133,6 +138,11 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
         formattedParam.default = param.default;
       }
 
+      // Add options for select input type
+      if (param.input_type === 'select' && param.options) {
+        formattedParam.options = param.options.filter((opt) => opt.trim() !== ''); // Filter empty options when saving
+      }
+
       return formattedParam;
     });
 
diff --git a/ui/desktop/src/components/parameter/ParameterInput.tsx b/ui/desktop/src/components/parameter/ParameterInput.tsx
index b48b2c36743a..7ed1decfe6ff 100644
--- a/ui/desktop/src/components/parameter/ParameterInput.tsx
+++ b/ui/desktop/src/components/parameter/ParameterInput.tsx
@@ -88,9 +88,16 @@ const ParameterInput: React.FC<ParameterInputProps> = ({ parameter, onChange })
           <textarea
             value={(parameter.options || []).join('\n')}
             onChange={(e) => {
-              const options = e.target.value.split('\n').filter((opt) => opt.trim() !== '');
+              // Don't filter out empty lines - preserve them so user can type on new lines
+              const options = e.target.value.split('\n');
               onChange(key, { options });
             }}
+            onKeyDown={(e) => {
+              // Allow Enter key to work normally in textarea (prevent form submission or modal close)
+              if (e.key === 'Enter') {
+                e.stopPropagation();
+              }
+            }}
             className="w-full p-3 border rounded-lg bg-background-default text-textStandard focus:outline-none focus:ring-2 focus:ring-borderProminent"
             placeholder="Option 1&#10;Option 2&#10;Option 3"
             rows={4}

From 7bba69d131cde2860cde5d7e7ba093603b1c2647 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 20:24:11 -0700
Subject: [PATCH 06/19] update recipe preview to show all possible recipe
 values

---
 ui/desktop/src/components/RecipesView.tsx | 296 ++++++++++++++++++++++
 ui/desktop/src/recipe/index.ts            |  27 ++
 2 files changed, 323 insertions(+)

diff --git a/ui/desktop/src/components/RecipesView.tsx b/ui/desktop/src/components/RecipesView.tsx
index 9acb5ad92006..55bfb31149b2 100644
--- a/ui/desktop/src/components/RecipesView.tsx
+++ b/ui/desktop/src/components/RecipesView.tsx
@@ -547,6 +547,17 @@ Parameters you can use:
                 <p className="text-text-muted">{selectedRecipe.recipe.description}</p>
               </div>
 
+              {selectedRecipe.recipe.version && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Version</h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    <span className="text-sm text-text-muted font-mono">
+                      {selectedRecipe.recipe.version}
+                    </span>
+                  </div>
+                </div>
+              )}
+
               {selectedRecipe.recipe.instructions && (
                 <div>
                   <h4 className="text-sm font-medium text-text-standard mb-2">Instructions</h4>
@@ -569,6 +580,65 @@ Parameters you can use:
                 </div>
               )}
 
+              {selectedRecipe.recipe.parameters && selectedRecipe.recipe.parameters.length > 0 && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Parameters</h4>
+                  <div className="space-y-3">
+                    {selectedRecipe.recipe.parameters.map((param, index) => (
+                      <div
+                        key={index}
+                        className="bg-background-muted border border-border-subtle p-3 rounded-lg"
+                      >
+                        <div className="flex items-center gap-2 mb-2">
+                          <code className="text-sm font-mono bg-background-default px-2 py-1 rounded text-text-standard">
+                            {param.key}
+                          </code>
+                          <span className="text-xs px-2 py-1 rounded bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200">
+                            {param.input_type}
+                          </span>
+                          <span
+                            className={`text-xs px-2 py-1 rounded ${
+                              param.requirement === 'required'
+                                ? 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200'
+                                : param.requirement === 'user_prompt'
+                                  ? 'bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200'
+                                  : 'bg-gray-100 text-gray-800 dark:bg-gray-900 dark:text-gray-200'
+                            }`}
+                          >
+                            {param.requirement}
+                          </span>
+                        </div>
+                        <p className="text-sm text-text-muted mb-2">{param.description}</p>
+
+                        {param.default && (
+                          <div className="text-xs text-text-muted">
+                            <span className="font-medium">Default:</span> {param.default}
+                          </div>
+                        )}
+
+                        {param.input_type === 'select' &&
+                          param.options &&
+                          param.options.length > 0 && (
+                            <div className="text-xs text-text-muted mt-2">
+                              <span className="font-medium">Options:</span>
+                              <div className="flex flex-wrap gap-1 mt-1">
+                                {param.options.map((option, optIndex) => (
+                                  <span
+                                    key={optIndex}
+                                    className="px-2 py-1 bg-background-default border border-border-subtle rounded text-xs"
+                                  >
+                                    {option}
+                                  </span>
+                                ))}
+                              </div>
+                            </div>
+                          )}
+                      </div>
+                    ))}
+                  </div>
+                </div>
+              )}
+
               {selectedRecipe.recipe.activities && selectedRecipe.recipe.activities.length > 0 && (
                 <div>
                   <h4 className="text-sm font-medium text-text-standard mb-2">Activities</h4>
@@ -584,6 +654,232 @@ Parameters you can use:
                   </div>
                 </div>
               )}
+
+              {selectedRecipe.recipe.extensions && selectedRecipe.recipe.extensions.length > 0 && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Extensions</h4>
+                  <div className="space-y-2">
+                    {selectedRecipe.recipe.extensions.map((extension, index) => {
+                      const extWithDetails = extension as typeof extension & {
+                        version?: string;
+                        type?: string;
+                        bundled?: boolean;
+                        cmd?: string;
+                        args?: string[];
+                        timeout?: number;
+                      };
+
+                      return (
+                        <div
+                          key={index}
+                          className="bg-background-muted border border-border-subtle p-3 rounded-lg"
+                        >
+                          <div className="flex items-center gap-2 mb-1">
+                            <span className="font-medium text-text-standard">{extension.name}</span>
+                            {extWithDetails.version && (
+                              <span className="text-xs px-2 py-1 bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200 rounded">
+                                v{extWithDetails.version}
+                              </span>
+                            )}
+                            {extWithDetails.type && (
+                              <span className="text-xs px-2 py-1 bg-purple-100 text-purple-800 dark:bg-purple-900 dark:text-purple-200 rounded">
+                                {extWithDetails.type}
+                              </span>
+                            )}
+                            {extWithDetails.bundled && (
+                              <span className="text-xs px-2 py-1 bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200 rounded">
+                                bundled
+                              </span>
+                            )}
+                          </div>
+                          {extension.description && (
+                            <p className="text-sm text-text-muted mb-2">{extension.description}</p>
+                          )}
+
+                          {/* Extension command details */}
+                          {extWithDetails.cmd && (
+                            <div className="text-xs text-text-muted mt-2">
+                              <div className="mb-1">
+                                <span className="font-medium">Command:</span>{' '}
+                                <code className="bg-background-default px-1 rounded">
+                                  {extWithDetails.cmd}
+                                </code>
+                              </div>
+                              {extWithDetails.args && extWithDetails.args.length > 0 && (
+                                <div className="mb-1">
+                                  <span className="font-medium">Args:</span>
+                                  <div className="flex flex-wrap gap-1 mt-1">
+                                    {extWithDetails.args.map((arg: string, argIndex: number) => (
+                                      <code
+                                        key={argIndex}
+                                        className="px-1 bg-background-default border border-border-subtle rounded text-xs"
+                                      >
+                                        {arg}
+                                      </code>
+                                    ))}
+                                  </div>
+                                </div>
+                              )}
+                              {extWithDetails.timeout && (
+                                <div>
+                                  <span className="font-medium">Timeout:</span>{' '}
+                                  {extWithDetails.timeout}s
+                                </div>
+                              )}
+                            </div>
+                          )}
+                        </div>
+                      );
+                    })}
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.sub_recipes &&
+                selectedRecipe.recipe.sub_recipes.length > 0 && (
+                  <div>
+                    <h4 className="text-sm font-medium text-text-standard mb-2">Sub Recipes</h4>
+                    <div className="space-y-3">
+                      {selectedRecipe.recipe.sub_recipes.map((subRecipe, index: number) => (
+                        <div
+                          key={index}
+                          className="bg-background-muted border border-border-subtle p-3 rounded-lg"
+                        >
+                          <div className="flex items-center gap-2 mb-2">
+                            <span className="font-medium text-text-standard">{subRecipe.name}</span>
+                            <span className="text-xs px-2 py-1 bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200 rounded">
+                              sub-recipe
+                            </span>
+                          </div>
+
+                          <div className="text-sm text-text-muted mb-2">
+                            <span className="font-medium">Path:</span>{' '}
+                            <code className="bg-background-default px-1 rounded font-mono text-xs">
+                              {subRecipe.path}
+                            </code>
+                          </div>
+
+                          {subRecipe.values && Object.keys(subRecipe.values).length > 0 && (
+                            <div className="text-xs text-text-muted mt-2">
+                              <span className="font-medium">Parameter Values:</span>
+                              <div className="mt-1 space-y-1">
+                                {Object.entries(subRecipe.values).map(([key, value]) => (
+                                  <div key={key} className="flex items-center gap-2">
+                                    <code className="bg-background-default px-1 rounded text-xs">
+                                      {key}
+                                    </code>
+                                    <span>=</span>
+                                    <code className="bg-background-default px-1 rounded text-xs">
+                                      {String(value)}
+                                    </code>
+                                  </div>
+                                ))}
+                              </div>
+                            </div>
+                          )}
+
+                          {subRecipe.description && (
+                            <p className="text-sm text-text-muted mt-2">{subRecipe.description}</p>
+                          )}
+                        </div>
+                      ))}
+                    </div>
+                  </div>
+                )}
+
+              {selectedRecipe.recipe.response && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Response Schema</h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    <pre className="text-sm text-text-muted whitespace-pre-wrap font-mono">
+                      {
+                        (() => {
+                          const response = selectedRecipe.recipe.response;
+                          try {
+                            if (typeof response === 'string') {
+                              return response;
+                            }
+                            return JSON.stringify(response, null, 2);
+                          } catch {
+                            return String(response);
+                          }
+                        })() as string
+                      }
+                    </pre>
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.goosehints && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Goose Hints</h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    <pre className="text-sm text-text-muted whitespace-pre-wrap font-mono">
+                      {selectedRecipe.recipe.goosehints}
+                    </pre>
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.context && selectedRecipe.recipe.context.length > 0 && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Context</h4>
+                  <div className="space-y-2">
+                    {selectedRecipe.recipe.context.map((contextItem, index) => (
+                      <div
+                        key={index}
+                        className="bg-background-muted border border-border-subtle p-2 rounded text-sm text-text-muted font-mono"
+                      >
+                        {contextItem}
+                      </div>
+                    ))}
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.profile && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Profile</h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    <span className="text-sm text-text-muted font-mono">
+                      {selectedRecipe.recipe.profile}
+                    </span>
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.mcps && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">
+                    Max Completion Tokens per Second
+                  </h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    <span className="text-sm text-text-muted font-mono">
+                      {selectedRecipe.recipe.mcps}
+                    </span>
+                  </div>
+                </div>
+              )}
+
+              {selectedRecipe.recipe.author && (
+                <div>
+                  <h4 className="text-sm font-medium text-text-standard mb-2">Author</h4>
+                  <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                    {selectedRecipe.recipe.author.contact && (
+                      <div className="text-sm text-text-muted mb-1">
+                        <span className="font-medium">Contact:</span>{' '}
+                        {selectedRecipe.recipe.author.contact}
+                      </div>
+                    )}
+                    {selectedRecipe.recipe.author.metadata && (
+                      <div className="text-sm text-text-muted">
+                        <span className="font-medium">Metadata:</span>{' '}
+                        {selectedRecipe.recipe.author.metadata}
+                      </div>
+                    )}
+                  </div>
+                </div>
+              )}
             </div>
 
             <div className="flex justify-end gap-3 mt-6 pt-4 border-t border-border-subtle">
diff --git a/ui/desktop/src/recipe/index.ts b/ui/desktop/src/recipe/index.ts
index 0b80b454db7a..d0bed4dea736 100644
--- a/ui/desktop/src/recipe/index.ts
+++ b/ui/desktop/src/recipe/index.ts
@@ -27,6 +27,33 @@ export interface Recipe {
   context?: string[];
   profile?: string;
   mcps?: number;
+  version?: string;
+  // Sub recipes support
+  sub_recipes?: Array<{
+    name: string;
+    path: string;
+    values?: Record<string, unknown>;
+    description?: string;
+  }>;
+  // Response schema - typically a JSON schema structure
+  response?:
+    | {
+        json_schema?: {
+          type?: string;
+          properties?: Record<
+            string,
+            {
+              type?: string;
+              description?: string;
+              items?: {
+                type?: string;
+              };
+            }
+          >;
+          required?: string[];
+        };
+      }
+    | string; // Can also be a string representation
   // Properties added for scheduled execution
   scheduledJobId?: string;
   isScheduledExecution?: boolean;

From 17db8ee96949e0e884b6fadf99620696139339c7 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 20:29:19 -0700
Subject: [PATCH 07/19] added recipe deeplink to preview

---
 ui/desktop/src/components/RecipesView.tsx | 49 +++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/ui/desktop/src/components/RecipesView.tsx b/ui/desktop/src/components/RecipesView.tsx
index 55bfb31149b2..74e36301ea8f 100644
--- a/ui/desktop/src/components/RecipesView.tsx
+++ b/ui/desktop/src/components/RecipesView.tsx
@@ -542,6 +542,55 @@ Parameters you can use:
             </div>
 
             <div className="space-y-6">
+              <div>
+                <h4 className="text-sm font-medium text-text-standard mb-2">Deeplink</h4>
+                <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
+                  <div className="flex items-center gap-2">
+                    <code className="text-xs text-text-muted font-mono flex-1 break-all">
+                      {(() => {
+                        try {
+                          const recipeJson = JSON.stringify(selectedRecipe.recipe);
+                          const base64Config = Buffer.from(recipeJson).toString('base64');
+                          const encodedConfig = encodeURIComponent(base64Config);
+                          return `goose://recipe?config=${encodedConfig}`;
+                        } catch {
+                          return 'Error generating deeplink';
+                        }
+                      })()}
+                    </code>
+                    <Button
+                      onClick={() => {
+                        try {
+                          const recipeJson = JSON.stringify(selectedRecipe.recipe);
+                          const base64Config = Buffer.from(recipeJson).toString('base64');
+                          const encodedConfig = encodeURIComponent(base64Config);
+                          const deeplink = `goose://recipe?config=${encodedConfig}`;
+                          navigator.clipboard.writeText(deeplink);
+                          toastSuccess({
+                            title: 'Copied!',
+                            msg: 'Recipe deeplink copied to clipboard',
+                          });
+                        } catch (error) {
+                          toastError({
+                            title: 'Copy Failed',
+                            msg: 'Failed to copy deeplink to clipboard',
+                            traceback: error instanceof Error ? error.message : String(error),
+                          });
+                        }
+                      }}
+                      variant="outline"
+                      size="sm"
+                      className="h-8 px-2 shrink-0"
+                    >
+                      Copy
+                    </Button>
+                  </div>
+                  <p className="text-xs text-text-muted mt-2">
+                    Share this deeplink to allow others to import this recipe
+                  </p>
+                </div>
+              </div>
+
               <div>
                 <h4 className="text-sm font-medium text-text-standard mb-2">Description</h4>
                 <p className="text-text-muted">{selectedRecipe.recipe.description}</p>

From 4e1988c618010d875b33d280b5607e9525522b91 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Sat, 19 Jul 2025 20:40:57 -0700
Subject: [PATCH 08/19] change display to one line for deeplink

---
 ui/desktop/src/components/RecipesView.tsx | 59 +++++++++++++++--------
 1 file changed, 40 insertions(+), 19 deletions(-)

diff --git a/ui/desktop/src/components/RecipesView.tsx b/ui/desktop/src/components/RecipesView.tsx
index 74e36301ea8f..b4ff53e4abd4 100644
--- a/ui/desktop/src/components/RecipesView.tsx
+++ b/ui/desktop/src/components/RecipesView.tsx
@@ -545,19 +545,10 @@ Parameters you can use:
               <div>
                 <h4 className="text-sm font-medium text-text-standard mb-2">Deeplink</h4>
                 <div className="bg-background-muted border border-border-subtle p-3 rounded-lg">
-                  <div className="flex items-center gap-2">
-                    <code className="text-xs text-text-muted font-mono flex-1 break-all">
-                      {(() => {
-                        try {
-                          const recipeJson = JSON.stringify(selectedRecipe.recipe);
-                          const base64Config = Buffer.from(recipeJson).toString('base64');
-                          const encodedConfig = encodeURIComponent(base64Config);
-                          return `goose://recipe?config=${encodedConfig}`;
-                        } catch {
-                          return 'Error generating deeplink';
-                        }
-                      })()}
-                    </code>
+                  <div className="flex items-center justify-between mb-2">
+                    <div className="text-sm text-text-muted">
+                      Copy this link to share with friends or paste directly in Chrome to open
+                    </div>
                     <Button
                       onClick={() => {
                         try {
@@ -578,16 +569,46 @@ Parameters you can use:
                           });
                         }
                       }}
-                      variant="outline"
+                      variant="ghost"
                       size="sm"
-                      className="h-8 px-2 shrink-0"
+                      className="ml-4 p-2 hover:bg-background-default rounded-lg transition-colors flex items-center"
                     >
-                      Copy
+                      <span className="text-sm text-text-muted">Copy</span>
                     </Button>
                   </div>
-                  <p className="text-xs text-text-muted mt-2">
-                    Share this deeplink to allow others to import this recipe
-                  </p>
+                  <div
+                    onClick={() => {
+                      try {
+                        const recipeJson = JSON.stringify(selectedRecipe.recipe);
+                        const base64Config = Buffer.from(recipeJson).toString('base64');
+                        const encodedConfig = encodeURIComponent(base64Config);
+                        const deeplink = `goose://recipe?config=${encodedConfig}`;
+                        navigator.clipboard.writeText(deeplink);
+                        toastSuccess({
+                          title: 'Copied!',
+                          msg: 'Recipe deeplink copied to clipboard',
+                        });
+                      } catch (error) {
+                        toastError({
+                          title: 'Copy Failed',
+                          msg: 'Failed to copy deeplink to clipboard',
+                          traceback: error instanceof Error ? error.message : String(error),
+                        });
+                      }
+                    }}
+                    className="text-sm truncate font-mono cursor-pointer text-text-standard"
+                  >
+                    {(() => {
+                      try {
+                        const recipeJson = JSON.stringify(selectedRecipe.recipe);
+                        const base64Config = Buffer.from(recipeJson).toString('base64');
+                        const encodedConfig = encodeURIComponent(base64Config);
+                        return `goose://recipe?config=${encodedConfig}`;
+                      } catch {
+                        return 'Error generating deeplink';
+                      }
+                    })()}
+                  </div>
                 </div>
               </div>
 

From 4644484da57ce158ebb1956b4e668903ebc8302d Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:13:54 -0700
Subject: [PATCH 09/19] change deeplink in recipe preview to use new server
 version

---
 ui/desktop/openapi.json                       | 2971 +++++++++++++++++
 ui/desktop/src/api/types.gen.ts               |    1 -
 ui/desktop/src/components/RecipesView.tsx     |   43 +-
 .../src/components/ToolCallWithResponse.tsx   |    8 +-
 4 files changed, 2995 insertions(+), 28 deletions(-)

diff --git a/ui/desktop/openapi.json b/ui/desktop/openapi.json
index e69de29bb2d1..a004198e8509 100644
--- a/ui/desktop/openapi.json
+++ b/ui/desktop/openapi.json
@@ -0,0 +1,2971 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "goose-server",
+    "description": "An AI agent",
+    "contact": {
+      "name": "Block",
+      "email": "ai-oss-tools@block.xyz"
+    },
+    "license": {
+      "name": "Apache-2.0"
+    },
+    "version": "1.1.0"
+  },
+  "paths": {
+    "/agent/tools": {
+      "get": {
+        "tags": [
+          "super::routes::agent"
+        ],
+        "operationId": "get_tools",
+        "parameters": [
+          {
+            "name": "extension_name",
+            "in": "query",
+            "description": "Optional extension name to filter tools",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "nullable": true
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Tools retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ToolInfo"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - invalid secret key"
+          },
+          "424": {
+            "description": "Agent not initialized"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config": {
+      "get": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "read_all_config",
+        "responses": {
+          "200": {
+            "description": "All configuration values retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConfigResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/config/backup": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "backup_config",
+        "responses": {
+          "200": {
+            "description": "Config file backed up",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/extensions": {
+      "get": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "get_extensions",
+        "responses": {
+          "200": {
+            "description": "All extensions retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExtensionResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "add_extension",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ExtensionQuery"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Extension added or updated successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "422": {
+            "description": "Could not serialize config.yaml"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/extensions/{name}": {
+      "delete": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "remove_extension",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Extension removed successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Extension not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/init": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "init_config",
+        "responses": {
+          "200": {
+            "description": "Config initialization check completed",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/permissions": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "upsert_permissions",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertPermissionsQuery"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Permission update completed",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          }
+        }
+      }
+    },
+    "/config/providers": {
+      "get": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "providers",
+        "responses": {
+          "200": {
+            "description": "All configuration values retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ProviderDetails"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/config/read": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "read_config",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ConfigKeyQuery"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Configuration value retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {}
+              }
+            }
+          },
+          "404": {
+            "description": "Configuration key not found"
+          }
+        }
+      }
+    },
+    "/config/recover": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "recover_config",
+        "responses": {
+          "200": {
+            "description": "Config recovery attempted",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/remove": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "remove_config",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ConfigKeyQuery"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Configuration value removed successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Configuration key not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/upsert": {
+      "post": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "upsert_config",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertConfigQuery"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Configuration value upserted successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/config/validate": {
+      "get": {
+        "tags": [
+          "super::routes::config_management"
+        ],
+        "operationId": "validate_config",
+        "responses": {
+          "200": {
+            "description": "Config validation result",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Config file is corrupted"
+          }
+        }
+      }
+    },
+    "/confirm": {
+      "post": {
+        "tags": [
+          "super::routes::reply"
+        ],
+        "operationId": "confirm_permission",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PermissionConfirmationRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Permission action is confirmed",
+            "content": {
+              "application/json": {
+                "schema": {}
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - invalid secret key"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/context/manage": {
+      "post": {
+        "tags": [
+          "Context Management"
+        ],
+        "operationId": "manage_context",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ContextManageRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Context managed successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ContextManageResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - Invalid or missing API key"
+          },
+          "412": {
+            "description": "Precondition failed - Agent not available"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/recipes/create": {
+      "post": {
+        "tags": [
+          "Recipe Management"
+        ],
+        "summary": "Create a Recipe configuration from the current session",
+        "operationId": "create_recipe",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateRecipeRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Recipe created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateRecipeResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "412": {
+            "description": "Precondition failed - Agent not available"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/recipes/decode": {
+      "post": {
+        "tags": [
+          "Recipe Management"
+        ],
+        "operationId": "decode_recipe",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DecodeRecipeRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Recipe decoded successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DecodeRecipeResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          }
+        }
+      }
+    },
+    "/recipes/encode": {
+      "post": {
+        "tags": [
+          "Recipe Management"
+        ],
+        "operationId": "encode_recipe",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/EncodeRecipeRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Recipe encoded successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EncodeRecipeResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          }
+        }
+      }
+    },
+    "/schedule/create": {
+      "post": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "create_schedule",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateScheduleRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Scheduled job created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScheduledJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid cron expression or recipe file"
+          },
+          "409": {
+            "description": "Job ID already exists"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/delete/{id}": {
+      "delete": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "delete_schedule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to delete",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Scheduled job deleted successfully"
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/list": {
+      "get": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "list_schedules",
+        "responses": {
+          "200": {
+            "description": "A list of scheduled jobs",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListSchedulesResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/{id}": {
+      "put": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "update_schedule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to update",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateScheduleRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Scheduled job updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScheduledJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Cannot update a currently running job or invalid request"
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/inspect": {
+      "get": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "inspect_running_job",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to inspect",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Running job information",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InspectJobResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/kill": {
+      "post": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "kill_running_job",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Running job killed successfully"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/pause": {
+      "post": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "pause_schedule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to pause",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Scheduled job paused successfully"
+          },
+          "400": {
+            "description": "Cannot pause a currently running job"
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/run_now": {
+      "post": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "run_now_handler",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to run",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Scheduled job triggered successfully, returns new session ID",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RunNowResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error when trying to run the job"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/sessions": {
+      "get": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "sessions_handler",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "minimum": 0
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list of session display info",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/SessionDisplayInfo"
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/schedule/{id}/unpause": {
+      "post": {
+        "tags": [
+          "schedule"
+        ],
+        "operationId": "unpause_schedule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of the schedule to unpause",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Scheduled job unpaused successfully"
+          },
+          "404": {
+            "description": "Scheduled job not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        }
+      }
+    },
+    "/sessions": {
+      "get": {
+        "tags": [
+          "Session Management"
+        ],
+        "operationId": "list_sessions",
+        "responses": {
+          "200": {
+            "description": "List of available sessions retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SessionListResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - Invalid or missing API key"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/sessions/{session_id}": {
+      "get": {
+        "tags": [
+          "Session Management"
+        ],
+        "operationId": "get_session_history",
+        "parameters": [
+          {
+            "name": "session_id",
+            "in": "path",
+            "description": "Unique identifier for the session",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Session history retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SessionHistoryResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - Invalid or missing API key"
+          },
+          "404": {
+            "description": "Session not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Annotations": {
+        "type": "object",
+        "properties": {
+          "audience": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Role"
+            }
+          },
+          "priority": {
+            "type": "number"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "Author": {
+        "type": "object",
+        "properties": {
+          "contact": {
+            "type": "string",
+            "nullable": true
+          },
+          "metadata": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "AuthorRequest": {
+        "type": "object",
+        "properties": {
+          "contact": {
+            "type": "string",
+            "nullable": true
+          },
+          "metadata": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "ConfigKey": {
+        "type": "object",
+        "required": [
+          "name",
+          "required",
+          "secret"
+        ],
+        "properties": {
+          "default": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string"
+          },
+          "required": {
+            "type": "boolean"
+          },
+          "secret": {
+            "type": "boolean"
+          }
+        }
+      },
+      "ConfigKeyQuery": {
+        "type": "object",
+        "required": [
+          "key",
+          "is_secret"
+        ],
+        "properties": {
+          "is_secret": {
+            "type": "boolean"
+          },
+          "key": {
+            "type": "string"
+          }
+        }
+      },
+      "ConfigResponse": {
+        "type": "object",
+        "required": [
+          "config"
+        ],
+        "properties": {
+          "config": {
+            "type": "object",
+            "additionalProperties": {}
+          }
+        }
+      },
+      "Content": {
+        "oneOf": [
+          {
+            "type": "object",
+            "required": [
+              "text",
+              "type"
+            ],
+            "properties": {
+              "text": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "data",
+              "mimeType",
+              "type"
+            ],
+            "properties": {
+              "data": {
+                "type": "string"
+              },
+              "mimeType": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "resource",
+              "type"
+            ],
+            "properties": {
+              "resource": {
+                "$ref": "#/components/schemas/ResourceContents"
+              },
+              "type": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "data",
+              "mimeType",
+              "type"
+            ],
+            "properties": {
+              "annotations": {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/Annotations"
+                  }
+                ]
+              },
+              "data": {
+                "type": "string"
+              },
+              "mimeType": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              }
+            }
+          }
+        ]
+      },
+      "ContextLengthExceeded": {
+        "type": "object",
+        "required": [
+          "msg"
+        ],
+        "properties": {
+          "msg": {
+            "type": "string"
+          }
+        }
+      },
+      "ContextManageRequest": {
+        "type": "object",
+        "description": "Request payload for context management operations",
+        "required": [
+          "messages",
+          "manageAction"
+        ],
+        "properties": {
+          "manageAction": {
+            "type": "string",
+            "description": "Operation to perform: \"truncation\" or \"summarize\""
+          },
+          "messages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Message"
+            },
+            "description": "Collection of messages to be managed"
+          }
+        }
+      },
+      "ContextManageResponse": {
+        "type": "object",
+        "description": "Response from context management operations",
+        "required": [
+          "messages",
+          "tokenCounts"
+        ],
+        "properties": {
+          "messages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Message"
+            },
+            "description": "Processed messages after the operation"
+          },
+          "tokenCounts": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "description": "Token counts for each processed message"
+          }
+        }
+      },
+      "CreateRecipeRequest": {
+        "type": "object",
+        "required": [
+          "messages",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "activities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "author": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/AuthorRequest"
+              }
+            ],
+            "nullable": true
+          },
+          "description": {
+            "type": "string"
+          },
+          "messages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Message"
+            }
+          },
+          "title": {
+            "type": "string"
+          }
+        }
+      },
+      "CreateRecipeResponse": {
+        "type": "object",
+        "properties": {
+          "error": {
+            "type": "string",
+            "nullable": true
+          },
+          "recipe": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Recipe"
+              }
+            ],
+            "nullable": true
+          }
+        }
+      },
+      "CreateScheduleRequest": {
+        "type": "object",
+        "required": [
+          "id",
+          "recipe_source",
+          "cron"
+        ],
+        "properties": {
+          "cron": {
+            "type": "string"
+          },
+          "execution_mode": {
+            "type": "string",
+            "nullable": true
+          },
+          "id": {
+            "type": "string"
+          },
+          "recipe_source": {
+            "type": "string"
+          }
+        }
+      },
+      "DecodeRecipeRequest": {
+        "type": "object",
+        "required": [
+          "deeplink"
+        ],
+        "properties": {
+          "deeplink": {
+            "type": "string"
+          }
+        }
+      },
+      "DecodeRecipeResponse": {
+        "type": "object",
+        "required": [
+          "recipe"
+        ],
+        "properties": {
+          "recipe": {
+            "$ref": "#/components/schemas/Recipe"
+          }
+        }
+      },
+      "EmbeddedResource": {
+        "type": "object",
+        "required": [
+          "resource"
+        ],
+        "properties": {
+          "annotations": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Annotations"
+              }
+            ]
+          },
+          "resource": {
+            "$ref": "#/components/schemas/ResourceContents"
+          }
+        }
+      },
+      "EncodeRecipeRequest": {
+        "type": "object",
+        "required": [
+          "recipe"
+        ],
+        "properties": {
+          "recipe": {
+            "$ref": "#/components/schemas/Recipe"
+          }
+        }
+      },
+      "EncodeRecipeResponse": {
+        "type": "object",
+        "required": [
+          "deeplink"
+        ],
+        "properties": {
+          "deeplink": {
+            "type": "string"
+          }
+        }
+      },
+      "Envs": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string",
+          "description": "A map of environment variables to set, e.g. API_KEY -> some_secret, HOST -> host"
+        }
+      },
+      "ExtensionConfig": {
+        "oneOf": [
+          {
+            "type": "object",
+            "description": "Server-sent events client with a URI endpoint",
+            "required": [
+              "name",
+              "uri",
+              "type"
+            ],
+            "properties": {
+              "bundled": {
+                "type": "boolean",
+                "description": "Whether this extension is bundled with Goose",
+                "nullable": true
+              },
+              "description": {
+                "type": "string",
+                "nullable": true
+              },
+              "env_keys": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "envs": {
+                "$ref": "#/components/schemas/Envs"
+              },
+              "name": {
+                "type": "string",
+                "description": "The name used to identify this extension"
+              },
+              "timeout": {
+                "type": "integer",
+                "format": "int64",
+                "nullable": true,
+                "minimum": 0
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "sse"
+                ]
+              },
+              "uri": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "description": "Standard I/O client with command and arguments",
+            "required": [
+              "name",
+              "cmd",
+              "args",
+              "type"
+            ],
+            "properties": {
+              "args": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "bundled": {
+                "type": "boolean",
+                "description": "Whether this extension is bundled with Goose",
+                "nullable": true
+              },
+              "cmd": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string",
+                "nullable": true
+              },
+              "env_keys": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "envs": {
+                "$ref": "#/components/schemas/Envs"
+              },
+              "name": {
+                "type": "string",
+                "description": "The name used to identify this extension"
+              },
+              "timeout": {
+                "type": "integer",
+                "format": "int64",
+                "nullable": true,
+                "minimum": 0
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "stdio"
+                ]
+              }
+            }
+          },
+          {
+            "type": "object",
+            "description": "Built-in extension that is part of the goose binary",
+            "required": [
+              "name",
+              "type"
+            ],
+            "properties": {
+              "bundled": {
+                "type": "boolean",
+                "description": "Whether this extension is bundled with Goose",
+                "nullable": true
+              },
+              "description": {
+                "type": "string",
+                "nullable": true
+              },
+              "display_name": {
+                "type": "string",
+                "nullable": true
+              },
+              "name": {
+                "type": "string",
+                "description": "The name used to identify this extension"
+              },
+              "timeout": {
+                "type": "integer",
+                "format": "int64",
+                "nullable": true,
+                "minimum": 0
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "builtin"
+                ]
+              }
+            }
+          },
+          {
+            "type": "object",
+            "description": "Streamable HTTP client with a URI endpoint using MCP Streamable HTTP specification",
+            "required": [
+              "name",
+              "uri",
+              "type"
+            ],
+            "properties": {
+              "bundled": {
+                "type": "boolean",
+                "description": "Whether this extension is bundled with Goose",
+                "nullable": true
+              },
+              "description": {
+                "type": "string",
+                "nullable": true
+              },
+              "env_keys": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "envs": {
+                "$ref": "#/components/schemas/Envs"
+              },
+              "headers": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "name": {
+                "type": "string",
+                "description": "The name used to identify this extension"
+              },
+              "timeout": {
+                "type": "integer",
+                "format": "int64",
+                "nullable": true,
+                "minimum": 0
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "streamable_http"
+                ]
+              },
+              "uri": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "description": "Frontend-provided tools that will be called through the frontend",
+            "required": [
+              "name",
+              "tools",
+              "type"
+            ],
+            "properties": {
+              "bundled": {
+                "type": "boolean",
+                "description": "Whether this extension is bundled with Goose",
+                "nullable": true
+              },
+              "instructions": {
+                "type": "string",
+                "description": "Instructions for how to use these tools",
+                "nullable": true
+              },
+              "name": {
+                "type": "string",
+                "description": "The name used to identify this extension"
+              },
+              "tools": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/Tool"
+                },
+                "description": "The tools provided by the frontend"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "frontend"
+                ]
+              }
+            }
+          }
+        ],
+        "description": "Represents the different types of MCP extensions that can be added to the manager",
+        "discriminator": {
+          "propertyName": "type"
+        }
+      },
+      "ExtensionEntry": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ExtensionConfig"
+          },
+          {
+            "type": "object",
+            "required": [
+              "enabled"
+            ],
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              }
+            }
+          }
+        ]
+      },
+      "ExtensionQuery": {
+        "type": "object",
+        "required": [
+          "name",
+          "config",
+          "enabled"
+        ],
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/ExtensionConfig"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "name": {
+            "type": "string"
+          }
+        }
+      },
+      "ExtensionResponse": {
+        "type": "object",
+        "required": [
+          "extensions"
+        ],
+        "properties": {
+          "extensions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ExtensionEntry"
+            }
+          }
+        }
+      },
+      "FrontendToolRequest": {
+        "type": "object",
+        "required": [
+          "id",
+          "toolCall"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "toolCall": {
+            "type": "object"
+          }
+        }
+      },
+      "ImageContent": {
+        "type": "object",
+        "required": [
+          "data",
+          "mimeType"
+        ],
+        "properties": {
+          "annotations": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Annotations"
+              }
+            ]
+          },
+          "data": {
+            "type": "string"
+          },
+          "mimeType": {
+            "type": "string"
+          }
+        }
+      },
+      "InspectJobResponse": {
+        "type": "object",
+        "properties": {
+          "processStartTime": {
+            "type": "string",
+            "nullable": true
+          },
+          "runningDurationSeconds": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "sessionId": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "KillJobResponse": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      },
+      "ListSchedulesResponse": {
+        "type": "object",
+        "required": [
+          "jobs"
+        ],
+        "properties": {
+          "jobs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduledJob"
+            }
+          }
+        }
+      },
+      "Message": {
+        "type": "object",
+        "description": "A message to or from an LLM",
+        "required": [
+          "role",
+          "created",
+          "content"
+        ],
+        "properties": {
+          "content": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MessageContent"
+            }
+          },
+          "created": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "id": {
+            "type": "string",
+            "nullable": true
+          },
+          "role": {
+            "$ref": "#/components/schemas/Role"
+          }
+        }
+      },
+      "MessageContent": {
+        "oneOf": [
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/TextContent"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "text"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ImageContent"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "image"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ToolRequest"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "toolRequest"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ToolResponse"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "toolResponse"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ToolConfirmationRequest"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "toolConfirmationRequest"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/FrontendToolRequest"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "frontendToolRequest"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ThinkingContent"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "thinking"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RedactedThinkingContent"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "redactedThinking"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ContextLengthExceeded"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "contextLengthExceeded"
+                    ]
+                  }
+                }
+              }
+            ]
+          },
+          {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/SummarizationRequested"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "summarizationRequested"
+                    ]
+                  }
+                }
+              }
+            ]
+          }
+        ],
+        "description": "Content passed inside a message, which can be both simple content and tool content",
+        "discriminator": {
+          "propertyName": "type"
+        }
+      },
+      "ModelInfo": {
+        "type": "object",
+        "description": "Information about a model's capabilities",
+        "required": [
+          "name",
+          "context_limit"
+        ],
+        "properties": {
+          "context_limit": {
+            "type": "integer",
+            "description": "The maximum context length this model supports",
+            "minimum": 0
+          },
+          "currency": {
+            "type": "string",
+            "description": "Currency for the costs (default: \"$\")",
+            "nullable": true
+          },
+          "input_token_cost": {
+            "type": "number",
+            "format": "double",
+            "description": "Cost per token for input (optional)",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "description": "The name of the model"
+          },
+          "output_token_cost": {
+            "type": "number",
+            "format": "double",
+            "description": "Cost per token for output (optional)",
+            "nullable": true
+          },
+          "supports_cache_control": {
+            "type": "boolean",
+            "description": "Whether this model supports cache control",
+            "nullable": true
+          }
+        }
+      },
+      "PermissionConfirmationRequest": {
+        "type": "object",
+        "required": [
+          "id",
+          "action"
+        ],
+        "properties": {
+          "action": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "principal_type": {
+            "$ref": "#/components/schemas/PrincipalType"
+          }
+        }
+      },
+      "PermissionLevel": {
+        "type": "string",
+        "description": "Enum representing the possible permission levels for a tool.",
+        "enum": [
+          "always_allow",
+          "ask_before",
+          "never_allow"
+        ]
+      },
+      "PrincipalType": {
+        "type": "string",
+        "enum": [
+          "Extension",
+          "Tool"
+        ]
+      },
+      "ProviderDetails": {
+        "type": "object",
+        "required": [
+          "name",
+          "metadata",
+          "is_configured"
+        ],
+        "properties": {
+          "is_configured": {
+            "type": "boolean"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/ProviderMetadata"
+          },
+          "name": {
+            "type": "string"
+          }
+        }
+      },
+      "ProviderMetadata": {
+        "type": "object",
+        "description": "Metadata about a provider's configuration requirements and capabilities",
+        "required": [
+          "name",
+          "display_name",
+          "description",
+          "default_model",
+          "known_models",
+          "model_doc_link",
+          "config_keys"
+        ],
+        "properties": {
+          "config_keys": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ConfigKey"
+            },
+            "description": "Required configuration keys"
+          },
+          "default_model": {
+            "type": "string",
+            "description": "The default/recommended model for this provider"
+          },
+          "description": {
+            "type": "string",
+            "description": "Description of the provider's capabilities"
+          },
+          "display_name": {
+            "type": "string",
+            "description": "Display name for the provider in UIs"
+          },
+          "known_models": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ModelInfo"
+            },
+            "description": "A list of currently known models with their capabilities\nTODO: eventually query the apis directly"
+          },
+          "model_doc_link": {
+            "type": "string",
+            "description": "Link to the docs where models can be found"
+          },
+          "name": {
+            "type": "string",
+            "description": "The unique identifier for this provider"
+          }
+        }
+      },
+      "ProvidersResponse": {
+        "type": "object",
+        "required": [
+          "providers"
+        ],
+        "properties": {
+          "providers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ProviderDetails"
+            }
+          }
+        }
+      },
+      "Recipe": {
+        "type": "object",
+        "description": "A Recipe represents a personalized, user-generated agent configuration that defines\nspecific behaviors and capabilities within the Goose system.\n\n# Fields\n\n## Required Fields\n* `version` - Semantic version of the Recipe file format (defaults to \"1.0.0\")\n* `title` - Short, descriptive name of the Recipe\n* `description` - Detailed description explaining the Recipe's purpose and functionality\n* `Instructions` - Instructions that defines the Recipe's behavior\n\n## Optional Fields\n* `prompt` - the initial prompt to the session to start with\n* `extensions` - List of extension configurations required by the Recipe\n* `context` - Supplementary context information for the Recipe\n* `activities` - Activity labels that appear when loading the Recipe\n* `author` - Information about the Recipe's creator and metadata\n* `parameters` - Additional parameters for the Recipe\n* `response` - Response configuration including JSON schema validation\n\n# Example\n\n\nuse goose::recipe::Recipe;\n\n// Using the builder pattern\nlet recipe = Recipe::builder()\n.title(\"Example Agent\")\n.description(\"An example Recipe configuration\")\n.instructions(\"Act as a helpful assistant\")\n.build()\n.expect(\"Missing required fields\");\n\n// Or using struct initialization\nlet recipe = Recipe {\nversion: \"1.0.0\".to_string(),\ntitle: \"Example Agent\".to_string(),\ndescription: \"An example Recipe configuration\".to_string(),\ninstructions: Some(\"Act as a helpful assistant\".to_string()),\nprompt: None,\nextensions: None,\ncontext: None,\nactivities: None,\nauthor: None,\nsettings: None,\nparameters: None,\nresponse: None,\nsub_recipes: None,\n};\n",
+        "required": [
+          "title",
+          "description"
+        ],
+        "properties": {
+          "activities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "author": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Author"
+              }
+            ],
+            "nullable": true
+          },
+          "context": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "description": {
+            "type": "string"
+          },
+          "extensions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ExtensionConfig"
+            },
+            "nullable": true
+          },
+          "instructions": {
+            "type": "string",
+            "nullable": true
+          },
+          "parameters": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RecipeParameter"
+            },
+            "nullable": true
+          },
+          "prompt": {
+            "type": "string",
+            "nullable": true
+          },
+          "response": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Response"
+              }
+            ],
+            "nullable": true
+          },
+          "settings": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Settings"
+              }
+            ],
+            "nullable": true
+          },
+          "sub_recipes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SubRecipe"
+            },
+            "nullable": true
+          },
+          "title": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        }
+      },
+      "RecipeParameter": {
+        "type": "object",
+        "required": [
+          "key",
+          "input_type",
+          "requirement",
+          "description"
+        ],
+        "properties": {
+          "default": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string"
+          },
+          "input_type": {
+            "$ref": "#/components/schemas/RecipeParameterInputType"
+          },
+          "key": {
+            "type": "string"
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "requirement": {
+            "$ref": "#/components/schemas/RecipeParameterRequirement"
+          }
+        }
+      },
+      "RecipeParameterInputType": {
+        "type": "string",
+        "enum": [
+          "string",
+          "number",
+          "boolean",
+          "date",
+          "file",
+          "select"
+        ]
+      },
+      "RecipeParameterRequirement": {
+        "type": "string",
+        "enum": [
+          "required",
+          "optional",
+          "user_prompt"
+        ]
+      },
+      "RedactedThinkingContent": {
+        "type": "object",
+        "required": [
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "string"
+          }
+        }
+      },
+      "ResourceContents": {
+        "oneOf": [
+          {
+            "type": "object",
+            "required": [
+              "uri",
+              "text"
+            ],
+            "properties": {
+              "mime_type": {
+                "type": "string",
+                "nullable": true
+              },
+              "text": {
+                "type": "string"
+              },
+              "uri": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "uri",
+              "blob"
+            ],
+            "properties": {
+              "blob": {
+                "type": "string"
+              },
+              "mime_type": {
+                "type": "string",
+                "nullable": true
+              },
+              "uri": {
+                "type": "string"
+              }
+            }
+          }
+        ]
+      },
+      "Response": {
+        "type": "object",
+        "properties": {
+          "json_schema": {
+            "nullable": true
+          }
+        }
+      },
+      "Role": {
+        "oneOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
+      "RunNowResponse": {
+        "type": "object",
+        "required": [
+          "session_id"
+        ],
+        "properties": {
+          "session_id": {
+            "type": "string"
+          }
+        }
+      },
+      "ScheduledJob": {
+        "type": "object",
+        "required": [
+          "id",
+          "source",
+          "cron"
+        ],
+        "properties": {
+          "cron": {
+            "type": "string"
+          },
+          "current_session_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "currently_running": {
+            "type": "boolean"
+          },
+          "execution_mode": {
+            "type": "string",
+            "nullable": true
+          },
+          "id": {
+            "type": "string"
+          },
+          "last_run": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "paused": {
+            "type": "boolean"
+          },
+          "process_start_time": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "source": {
+            "type": "string"
+          }
+        }
+      },
+      "SessionDisplayInfo": {
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "createdAt",
+          "workingDir",
+          "messageCount"
+        ],
+        "properties": {
+          "accumulatedInputTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "accumulatedOutputTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "accumulatedTotalTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "createdAt": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "inputTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "messageCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "name": {
+            "type": "string"
+          },
+          "outputTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "scheduleId": {
+            "type": "string",
+            "nullable": true
+          },
+          "totalTokens": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "workingDir": {
+            "type": "string"
+          }
+        }
+      },
+      "SessionHistoryResponse": {
+        "type": "object",
+        "required": [
+          "sessionId",
+          "metadata",
+          "messages"
+        ],
+        "properties": {
+          "messages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Message"
+            },
+            "description": "List of messages in the session conversation"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/SessionMetadata"
+          },
+          "sessionId": {
+            "type": "string",
+            "description": "Unique identifier for the session"
+          }
+        }
+      },
+      "SessionInfo": {
+        "type": "object",
+        "required": [
+          "id",
+          "path",
+          "modified",
+          "metadata"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/SessionMetadata"
+          },
+          "modified": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
+        }
+      },
+      "SessionListResponse": {
+        "type": "object",
+        "required": [
+          "sessions"
+        ],
+        "properties": {
+          "sessions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SessionInfo"
+            },
+            "description": "List of available session information objects"
+          }
+        }
+      },
+      "SessionMetadata": {
+        "type": "object",
+        "description": "Metadata for a session, stored as the first line in the session file",
+        "required": [
+          "working_dir",
+          "description",
+          "message_count"
+        ],
+        "properties": {
+          "accumulated_input_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The number of input tokens used in the session. Accumulated across all messages.",
+            "nullable": true
+          },
+          "accumulated_output_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The number of output tokens used in the session. Accumulated across all messages.",
+            "nullable": true
+          },
+          "accumulated_total_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The total number of tokens used in the session. Accumulated across all messages (useful for tracking cost over an entire session).",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "description": "A short description of the session, typically 3 words or less"
+          },
+          "input_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The number of input tokens used in the session. Retrieved from the provider's last usage.",
+            "nullable": true
+          },
+          "message_count": {
+            "type": "integer",
+            "description": "Number of messages in the session",
+            "minimum": 0
+          },
+          "output_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The number of output tokens used in the session. Retrieved from the provider's last usage.",
+            "nullable": true
+          },
+          "project_id": {
+            "type": "string",
+            "description": "ID of the project this session belongs to, if any",
+            "nullable": true
+          },
+          "schedule_id": {
+            "type": "string",
+            "description": "ID of the schedule that triggered this session, if any",
+            "nullable": true
+          },
+          "total_tokens": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The total number of tokens used in the session. Retrieved from the provider's last usage.",
+            "nullable": true
+          },
+          "working_dir": {
+            "type": "string",
+            "description": "Working directory for the session",
+            "example": "/home/user/sessions/session1"
+          }
+        }
+      },
+      "SessionsQuery": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0
+          }
+        }
+      },
+      "Settings": {
+        "type": "object",
+        "properties": {
+          "goose_model": {
+            "type": "string",
+            "nullable": true
+          },
+          "goose_provider": {
+            "type": "string",
+            "nullable": true
+          },
+          "temperature": {
+            "type": "number",
+            "format": "float",
+            "nullable": true
+          }
+        }
+      },
+      "SubRecipe": {
+        "type": "object",
+        "required": [
+          "name",
+          "path"
+        ],
+        "properties": {
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "sequential_when_repeated": {
+            "type": "boolean"
+          },
+          "values": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "SummarizationRequested": {
+        "type": "object",
+        "required": [
+          "msg"
+        ],
+        "properties": {
+          "msg": {
+            "type": "string"
+          }
+        }
+      },
+      "TextContent": {
+        "type": "object",
+        "required": [
+          "text"
+        ],
+        "properties": {
+          "annotations": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Annotations"
+              }
+            ]
+          },
+          "text": {
+            "type": "string"
+          }
+        }
+      },
+      "ThinkingContent": {
+        "type": "object",
+        "required": [
+          "thinking",
+          "signature"
+        ],
+        "properties": {
+          "signature": {
+            "type": "string"
+          },
+          "thinking": {
+            "type": "string"
+          }
+        }
+      },
+      "Tool": {
+        "type": "object",
+        "description": "A tool that can be used by a model.",
+        "required": [
+          "name",
+          "description",
+          "inputSchema"
+        ],
+        "properties": {
+          "annotations": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ToolAnnotations"
+              }
+            ],
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "description": "A description of what the tool does"
+          },
+          "inputSchema": {
+            "description": "A JSON Schema object defining the expected parameters for the tool"
+          },
+          "name": {
+            "type": "string",
+            "description": "The name of the tool"
+          }
+        }
+      },
+      "ToolAnnotations": {
+        "type": "object",
+        "description": "Additional properties describing a tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**.\nThey are not guaranteed to provide a faithful description of\ntool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations\nreceived from untrusted servers.",
+        "properties": {
+          "destructiveHint": {
+            "type": "boolean",
+            "description": "If true, the tool may perform destructive updates to its environment.\nIf false, the tool performs only additive updates.\n\n(This property is meaningful only when `read_only_hint == false`)\n\nDefault: true"
+          },
+          "idempotentHint": {
+            "type": "boolean",
+            "description": "If true, calling the tool repeatedly with the same arguments\nwill have no additional effect on its environment.\n\n(This property is meaningful only when `read_only_hint == false`)\n\nDefault: false"
+          },
+          "openWorldHint": {
+            "type": "boolean",
+            "description": "If true, this tool may interact with an \"open world\" of external\nentities. If false, the tool's domain of interaction is closed.\nFor example, the world of a web search tool is open, whereas that\nof a memory tool is not.\n\nDefault: true"
+          },
+          "readOnlyHint": {
+            "type": "boolean",
+            "description": "If true, the tool does not modify its environment.\n\nDefault: false"
+          },
+          "title": {
+            "type": "string",
+            "description": "A human-readable title for the tool.",
+            "nullable": true
+          }
+        }
+      },
+      "ToolConfirmationRequest": {
+        "type": "object",
+        "required": [
+          "id",
+          "toolName",
+          "arguments"
+        ],
+        "properties": {
+          "arguments": {},
+          "id": {
+            "type": "string"
+          },
+          "prompt": {
+            "type": "string",
+            "nullable": true
+          },
+          "toolName": {
+            "type": "string"
+          }
+        }
+      },
+      "ToolInfo": {
+        "type": "object",
+        "description": "Information about the tool used for building prompts",
+        "required": [
+          "name",
+          "description",
+          "parameters"
+        ],
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "parameters": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "permission": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/PermissionLevel"
+              }
+            ],
+            "nullable": true
+          }
+        }
+      },
+      "ToolPermission": {
+        "type": "object",
+        "required": [
+          "tool_name",
+          "permission"
+        ],
+        "properties": {
+          "permission": {
+            "$ref": "#/components/schemas/PermissionLevel"
+          },
+          "tool_name": {
+            "type": "string"
+          }
+        }
+      },
+      "ToolRequest": {
+        "type": "object",
+        "required": [
+          "id",
+          "toolCall"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "toolCall": {
+            "type": "object"
+          }
+        }
+      },
+      "ToolResponse": {
+        "type": "object",
+        "required": [
+          "id",
+          "toolResult"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "toolResult": {
+            "type": "object"
+          }
+        }
+      },
+      "ToolResultSchema": {
+        "type": "object",
+        "required": [
+          "success",
+          "data"
+        ],
+        "properties": {
+          "data": {
+            "type": "object"
+          },
+          "message": {
+            "type": "string",
+            "example": "Operation completed successfully",
+            "nullable": true
+          },
+          "success": {
+            "type": "boolean",
+            "example": true
+          }
+        },
+        "example": {
+          "data": {},
+          "success": true
+        }
+      },
+      "UpdateScheduleRequest": {
+        "type": "object",
+        "required": [
+          "cron"
+        ],
+        "properties": {
+          "cron": {
+            "type": "string"
+          }
+        }
+      },
+      "UpsertConfigQuery": {
+        "type": "object",
+        "required": [
+          "key",
+          "value",
+          "is_secret"
+        ],
+        "properties": {
+          "is_secret": {
+            "type": "boolean"
+          },
+          "key": {
+            "type": "string"
+          },
+          "value": {}
+        }
+      },
+      "UpsertPermissionsQuery": {
+        "type": "object",
+        "required": [
+          "tool_permissions"
+        ],
+        "properties": {
+          "tool_permissions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ToolPermission"
+            }
+          }
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/ui/desktop/src/api/types.gen.ts b/ui/desktop/src/api/types.gen.ts
index 68e1e0b0ff77..80343c28b1eb 100644
--- a/ui/desktop/src/api/types.gen.ts
+++ b/ui/desktop/src/api/types.gen.ts
@@ -196,7 +196,6 @@ export type ExtensionConfig = {
      * Whether this extension is bundled with Goose
      */
     bundled?: boolean | null;
-    description?: string | null;
     /**
      * Instructions for how to use these tools
      */
diff --git a/ui/desktop/src/components/RecipesView.tsx b/ui/desktop/src/components/RecipesView.tsx
index 65285a6039f3..918bf7171120 100644
--- a/ui/desktop/src/components/RecipesView.tsx
+++ b/ui/desktop/src/components/RecipesView.tsx
@@ -21,7 +21,7 @@ import { Card } from './ui/card';
 import { Button } from './ui/button';
 import { Skeleton } from './ui/skeleton';
 import { MainPanelLayout } from './Layout/MainPanelLayout';
-import { Recipe, decodeRecipe } from '../recipe';
+import { Recipe, decodeRecipe, generateDeepLink } from '../recipe';
 import { toastSuccess, toastError } from '../toasts';
 
 interface RecipesViewProps {
@@ -42,6 +42,7 @@ export default function RecipesView({ _onLoadRecipe }: RecipesViewProps = {}) {
   const [importRecipeName, setImportRecipeName] = useState('');
   const [importGlobal, setImportGlobal] = useState(true);
   const [importing, setImporting] = useState(false);
+  const [previewDeeplink, setPreviewDeeplink] = useState<string>('');
 
   // Create Recipe state
   const [showCreateDialog, setShowCreateDialog] = useState(false);
@@ -142,9 +143,18 @@ export default function RecipesView({ _onLoadRecipe }: RecipesViewProps = {}) {
     }
   };
 
-  const handlePreviewRecipe = (savedRecipe: SavedRecipe) => {
+  const handlePreviewRecipe = async (savedRecipe: SavedRecipe) => {
     setSelectedRecipe(savedRecipe);
     setShowPreview(true);
+
+    // Generate deeplink for preview
+    try {
+      const deeplink = await generateDeepLink(savedRecipe.recipe);
+      setPreviewDeeplink(deeplink);
+    } catch (error) {
+      console.error('Failed to generate deeplink for preview:', error);
+      setPreviewDeeplink('Error generating deeplink');
+    }
   };
 
   // Function to parse deeplink and extract recipe
@@ -555,12 +565,10 @@ Parameters you can use:
                       Copy this link to share with friends or paste directly in Chrome to open
                     </div>
                     <Button
-                      onClick={() => {
+                      onClick={async () => {
                         try {
-                          const recipeJson = JSON.stringify(selectedRecipe.recipe);
-                          const base64Config = window.btoa(recipeJson);
-                          const encodedConfig = encodeURIComponent(base64Config);
-                          const deeplink = `goose://recipe?config=${encodedConfig}`;
+                          const deeplink =
+                            previewDeeplink || (await generateDeepLink(selectedRecipe.recipe));
                           navigator.clipboard.writeText(deeplink);
                           toastSuccess({
                             title: 'Copied!',
@@ -582,12 +590,10 @@ Parameters you can use:
                     </Button>
                   </div>
                   <div
-                    onClick={() => {
+                    onClick={async () => {
                       try {
-                        const recipeJson = JSON.stringify(selectedRecipe.recipe);
-                        const base64Config = window.btoa(recipeJson);
-                        const encodedConfig = encodeURIComponent(base64Config);
-                        const deeplink = `goose://recipe?config=${encodedConfig}`;
+                        const deeplink =
+                          previewDeeplink || (await generateDeepLink(selectedRecipe.recipe));
                         navigator.clipboard.writeText(deeplink);
                         toastSuccess({
                           title: 'Copied!',
@@ -603,16 +609,7 @@ Parameters you can use:
                     }}
                     className="text-sm truncate font-mono cursor-pointer text-text-standard"
                   >
-                    {(() => {
-                      try {
-                        const recipeJson = JSON.stringify(selectedRecipe.recipe);
-                        const base64Config = window.btoa(recipeJson);
-                        const encodedConfig = encodeURIComponent(base64Config);
-                        return `goose://recipe?config=${encodedConfig}`;
-                      } catch {
-                        return 'Error generating deeplink';
-                      }
-                    })()}
+                    {previewDeeplink || 'Generating deeplink...'}
                   </div>
                 </div>
               </div>
@@ -767,7 +764,7 @@ Parameters you can use:
                               </span>
                             )}
                           </div>
-                          {extension.description && (
+                          {'description' in extension && extension.description && (
                             <p className="text-sm text-text-muted mb-2">{extension.description}</p>
                           )}
 
diff --git a/ui/desktop/src/components/ToolCallWithResponse.tsx b/ui/desktop/src/components/ToolCallWithResponse.tsx
index a75a7065201c..edf896a8684f 100644
--- a/ui/desktop/src/components/ToolCallWithResponse.tsx
+++ b/ui/desktop/src/components/ToolCallWithResponse.tsx
@@ -126,10 +126,10 @@ const notificationToProgress = (notification: NotificationEvent): Progress =>
 const getExtensionTooltip = (toolCallName: string): string | null => {
   const lastIndex = toolCallName.lastIndexOf('__');
   if (lastIndex === -1) return null;
-  
+
   const extensionName = toolCallName.substring(0, lastIndex);
   if (!extensionName) return null;
-  
+
   return `${extensionName} extension`;
 };
 
@@ -377,7 +377,7 @@ function ToolCallView({
         // This ensures any MCP tool works without explicit handling
         const toolDisplayName = snakeToTitleCase(toolName);
         const entries = Object.entries(args);
-        
+
         if (entries.length === 0) {
           return `${toolDisplayName}`;
         }
@@ -413,7 +413,7 @@ function ToolCallView({
   };
 
   const toolLabel = (
-    <span className={cn("ml-2", extensionTooltip && "cursor-pointer hover:opacity-80")}>
+    <span className={cn('ml-2', extensionTooltip && 'cursor-pointer hover:opacity-80')}>
       {getToolLabelContent()}
     </span>
   );

From 4863743dec0a77f48c2cdf1b0e7bf70973e77e94 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:20:54 -0700
Subject: [PATCH 10/19] move previousTitle outside of conditional

---
 ui/desktop/src/components/BaseChat.tsx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index dc095ae69667..4df6cbfe73b7 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -200,8 +200,9 @@ function BaseChatContent({
 
   // Reset recipe usage tracking when recipe changes
   useEffect(() => {
+    const previousTitle = currentRecipeTitle;
+
     if (recipeConfig?.title !== currentRecipeTitle) {
-      const previousTitle = currentRecipeTitle;
       setCurrentRecipeTitle(recipeConfig?.title || null);
 
       // Only reset usage if we're switching between different recipes

From 4e8363c34e5cc40293589dcd8f5898a6dc3bb017 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:23:29 -0700
Subject: [PATCH 11/19] refactor hasRecipeChanged logic to be more readable

---
 ui/desktop/src/components/BaseChat.tsx | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 4df6cbfe73b7..31c8c41678b7 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -201,23 +201,25 @@ function BaseChatContent({
   // Reset recipe usage tracking when recipe changes
   useEffect(() => {
     const previousTitle = currentRecipeTitle;
+    const newTitle = recipeConfig?.title || null;
+    const hasRecipeChanged = newTitle !== currentRecipeTitle;
 
-    if (recipeConfig?.title !== currentRecipeTitle) {
-      setCurrentRecipeTitle(recipeConfig?.title || null);
+    if (hasRecipeChanged) {
+      setCurrentRecipeTitle(newTitle);
 
-      // Only reset usage if we're switching between different recipes
-      // Don't reset if we're going from no recipe to a recipe (initial load)
-      // or if we already have messages (ongoing conversation)
-      if (previousTitle && recipeConfig?.title && previousTitle !== recipeConfig.title) {
-        console.log('Switching from recipe:', previousTitle, 'to:', recipeConfig.title);
+      const isSwitchingBetweenRecipes = previousTitle && newTitle && previousTitle !== newTitle;
+      const isInitialRecipeLoad = !previousTitle && newTitle && messages.length === 0;
+      const hasExistingConversation = newTitle && messages.length > 0;
+
+      if (isSwitchingBetweenRecipes) {
+        console.log('Switching from recipe:', previousTitle, 'to:', newTitle);
         setHasStartedUsingRecipe(false);
         setMessages([]);
         setAncestorMessages([]);
-      } else if (!previousTitle && recipeConfig?.title && messages.length === 0) {
+      } else if (isInitialRecipeLoad) {
         setHasStartedUsingRecipe(false);
-        // Only clear messages if we don't have any yet
-      } else if (recipeConfig?.title && messages.length > 0) {
-        setHasStartedUsingRecipe(true); // Mark as started since we have messages
+      } else if (hasExistingConversation) {
+        setHasStartedUsingRecipe(true);
       }
     }
   }, [recipeConfig?.title, currentRecipeTitle, messages.length, setMessages, setAncestorMessages]);

From 353baf31ce6953bd078a55b44cae7bc30d168a44 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:28:51 -0700
Subject: [PATCH 12/19] remove redundant check for previousTitle

---
 ui/desktop/src/components/BaseChat.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 31c8c41678b7..46cf6e21c114 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -207,7 +207,7 @@ function BaseChatContent({
     if (hasRecipeChanged) {
       setCurrentRecipeTitle(newTitle);
 
-      const isSwitchingBetweenRecipes = previousTitle && newTitle && previousTitle !== newTitle;
+      const isSwitchingBetweenRecipes = previousTitle && newTitle;
       const isInitialRecipeLoad = !previousTitle && newTitle && messages.length === 0;
       const hasExistingConversation = newTitle && messages.length > 0;
 

From 66dc3a515c4d0c6e9965a8324928a63c07f6765c Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:38:49 -0700
Subject: [PATCH 13/19] simplify complex validation logic

---
 .../src/components/ParameterInputModal.tsx    | 27 ++-----------------
 1 file changed, 2 insertions(+), 25 deletions(-)

diff --git a/ui/desktop/src/components/ParameterInputModal.tsx b/ui/desktop/src/components/ParameterInputModal.tsx
index 33cafc278230..df219c5828d1 100644
--- a/ui/desktop/src/components/ParameterInputModal.tsx
+++ b/ui/desktop/src/components/ParameterInputModal.tsx
@@ -21,32 +21,9 @@ const ParameterInputModal: React.FC<ParameterInputModalProps> = ({
   useEffect(() => {
     const initialValues: Record<string, string> = {};
     parameters.forEach((param) => {
-      // Set default value for optional parameters if they have a default value
       if (param.requirement === 'optional' && param.default) {
-        // Validate default value based on parameter type
-        let defaultValue = param.default;
-
-        // For boolean parameters, ensure the default is 'true' or 'false'
-        if (param.input_type === 'boolean') {
-          if (param.default.toLowerCase() === 'true' || param.default.toLowerCase() === 'false') {
-            defaultValue = param.default.toLowerCase();
-          }
-        }
-
-        // For select parameters, ensure the default is one of the valid options
-        if (param.input_type === 'select' && param.options) {
-          if (param.options.includes(param.default)) {
-            defaultValue = param.default;
-          }
-        }
-
-        // For number parameters, ensure the default is a valid number
-        if (param.input_type === 'number') {
-          if (!isNaN(Number(param.default))) {
-            defaultValue = param.default;
-          }
-        }
-
+        const defaultValue =
+          param.input_type === 'boolean' ? param.default.toLowerCase() : param.default;
         initialValues[param.key] = defaultValue;
       }
     });

From 67ebebc471f36cd1cc86799111f62b3dbf6679cb Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:40:39 -0700
Subject: [PATCH 14/19] remove comment

---
 ui/desktop/src/components/ViewRecipeModal.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index 44165664ee1a..a8860811de37 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -63,7 +63,6 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
       setInstructions(config.instructions || '');
       setPrompt(config.prompt || '');
       setActivities(config.activities || []);
-      // Use the actual parameters from the config, not parsed from instructions
       setParameters(config.parameters || []);
     }
   }, [config]);

From 91291e29bcf5927b597e2be9422e320dfa96525a Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:44:41 -0700
Subject: [PATCH 15/19] preserve existing params and add new ones

---
 ui/desktop/src/components/ViewRecipeModal.tsx | 39 ++++++++++---------
 1 file changed, 21 insertions(+), 18 deletions(-)

diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index a8860811de37..a1766c01e6b8 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -92,27 +92,30 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
     }
   }, [isOpen, getExtensions, recipeExtensions, extensionsLoaded]);
 
-  // Only auto-parse parameters from instructions if no parameters exist yet
-  // This prevents overwriting existing parameter configurations
+  // Auto-detect new parameters from instructions and prompt
+  // This adds new parameters without overwriting existing ones
   useEffect(() => {
-    // Only parse parameters if we don't have any existing parameters
-    if (parameters.length === 0) {
-      const instructionsParams = parseParametersFromInstructions(instructions);
-      const promptParams = parseParametersFromInstructions(prompt);
-
-      // Combine parameters, ensuring no duplicates by key
-      const allParams = [...instructionsParams];
-      promptParams.forEach((promptParam) => {
-        if (!allParams.some((param) => param.key === promptParam.key)) {
-          allParams.push(promptParam);
-        }
-      });
-
-      if (allParams.length > 0) {
-        setParameters(allParams);
+    const instructionsParams = parseParametersFromInstructions(instructions);
+    const promptParams = parseParametersFromInstructions(prompt);
+
+    // Combine all detected parameters, ensuring no duplicates by key
+    const detectedParams = [...instructionsParams];
+    promptParams.forEach((promptParam) => {
+      if (!detectedParams.some((param) => param.key === promptParam.key)) {
+        detectedParams.push(promptParam);
       }
+    });
+
+    // Only add parameters that don't already exist in our current parameters
+    const newParams = detectedParams.filter(
+      (detectedParam) =>
+        !parameters.some((existingParam) => existingParam.key === detectedParam.key)
+    );
+
+    if (newParams.length > 0) {
+      setParameters((prev) => [...prev, ...newParams]);
     }
-  }, [instructions, prompt, parameters.length]);
+  }, [instructions, prompt, parameters]);
 
   const getCurrentConfig = useCallback((): Recipe => {
     // Transform the internal parameters state into the desired output format.

From 73017aea8f40f842e961089b6a02c44dd5d3b1db Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:51:55 -0700
Subject: [PATCH 16/19] change lookups to be more efficient with maps and set

---
 ui/desktop/src/components/ViewRecipeModal.tsx | 24 ++++++++++++-------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index a1766c01e6b8..d55132e4105b 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -99,17 +99,25 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
     const promptParams = parseParametersFromInstructions(prompt);
 
     // Combine all detected parameters, ensuring no duplicates by key
-    const detectedParams = [...instructionsParams];
-    promptParams.forEach((promptParam) => {
-      if (!detectedParams.some((param) => param.key === promptParam.key)) {
-        detectedParams.push(promptParam);
+    const detectedParamsMap = new Map<string, Parameter>();
+
+    // Add instruction parameters
+    instructionsParams.forEach((param) => {
+      detectedParamsMap.set(param.key, param);
+    });
+
+    // Add prompt parameters (won't overwrite existing keys)
+    promptParams.forEach((param) => {
+      if (!detectedParamsMap.has(param.key)) {
+        detectedParamsMap.set(param.key, param);
       }
     });
 
-    // Only add parameters that don't already exist in our current parameters
-    const newParams = detectedParams.filter(
-      (detectedParam) =>
-        !parameters.some((existingParam) => existingParam.key === detectedParam.key)
+    const existingParamKeys = new Set(parameters.map((param) => param.key));
+
+    // Only add parameters that don't already exist
+    const newParams = Array.from(detectedParamsMap.values()).filter(
+      (detectedParam) => !existingParamKeys.has(detectedParam.key)
     );
 
     if (newParams.length > 0) {

From 1dbb5fd27e75b30e5b78e0abbf0debfeb885d741 Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 12:52:23 -0700
Subject: [PATCH 17/19] remove comment

---
 ui/desktop/src/components/ViewRecipeModal.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ui/desktop/src/components/ViewRecipeModal.tsx b/ui/desktop/src/components/ViewRecipeModal.tsx
index d55132e4105b..d27d57a300f9 100644
--- a/ui/desktop/src/components/ViewRecipeModal.tsx
+++ b/ui/desktop/src/components/ViewRecipeModal.tsx
@@ -130,7 +130,7 @@ export default function ViewRecipeModal({ isOpen, onClose, config }: ViewRecipeM
     const formattedParameters = parameters.map((param) => {
       const formattedParam: Parameter = {
         key: param.key,
-        input_type: param.input_type || 'string', // Use actual input_type instead of hardcoded 'string'
+        input_type: param.input_type || 'string',
         requirement: param.requirement,
         description: param.description,
       };

From 893c2a0096fe05361848a7e8a54fb0484ff62cfc Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Mon, 21 Jul 2025 13:00:57 -0700
Subject: [PATCH 18/19] change initialPrompt to return the actual recipe prompt
 when available

---
 ui/desktop/src/components/BaseChat.tsx   | 2 +-
 ui/desktop/src/hooks/useRecipeManager.ts | 9 ++-------
 2 files changed, 3 insertions(+), 8 deletions(-)

diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 46cf6e21c114..6ab12ac3fc6a 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -485,7 +485,7 @@ function BaseChatContent({
             isLoading={isLoading}
             onStop={onStopGoose}
             commandHistory={commandHistory}
-            initialValue={_input || initialPrompt}
+            initialValue={_input || (messages.length === 0 ? initialPrompt : '')}
             setView={setView}
             numTokens={sessionTokenCount}
             inputTokens={sessionInputTokens || localInputTokens}
diff --git a/ui/desktop/src/hooks/useRecipeManager.ts b/ui/desktop/src/hooks/useRecipeManager.ts
index 82a5cc13e0df..3e7ac5170ef7 100644
--- a/ui/desktop/src/hooks/useRecipeManager.ts
+++ b/ui/desktop/src/hooks/useRecipeManager.ts
@@ -103,13 +103,8 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
     return substitutedPrompt;
   };
 
-  // Pre-fill input with recipe prompt instead of auto-sending it
+  // Get the recipe's initial prompt (always return the actual prompt, don't modify based on conversation state)
   const initialPrompt = useMemo(() => {
-    // Don't show initial prompt if we already have messages (ongoing conversation)
-    if (messages.length > 0) {
-      return '';
-    }
-
     if (!recipeConfig?.prompt) return '';
 
     const hasRequiredParams = recipeConfig.parameters && recipeConfig.parameters.length > 0;
@@ -126,7 +121,7 @@ export const useRecipeManager = (messages: Message[], locationState?: LocationSt
 
     // Otherwise, we are waiting for parameters, so the input should be empty.
     return '';
-  }, [recipeConfig, recipeParameters, messages.length]);
+  }, [recipeConfig, recipeParameters]);
 
   // Handle parameter submission
   const handleParameterSubmit = async (inputValues: Record<string, string>) => {

From 8b4fd1dd5ebd69a07c90399d4671e77c5fdaec6f Mon Sep 17 00:00:00 2001
From: Zane Staggs <zane@squareup.com>
Date: Tue, 22 Jul 2025 09:47:08 -0700
Subject: [PATCH 19/19] refactor to shared ChatType

---
 ui/desktop/src/App.tsx                         |  3 ++-
 ui/desktop/src/components/BaseChat.tsx         | 10 +---------
 ui/desktop/src/components/hub.tsx              | 12 ++----------
 ui/desktop/src/components/pair.tsx             | 12 ++----------
 ui/desktop/src/contexts/ChatContext.tsx        |  2 +-
 ui/desktop/src/hooks/useChat.ts                |  2 +-
 ui/desktop/src/hooks/useChatEngine.ts          |  2 +-
 ui/desktop/src/hooks/useSessionContinuation.ts |  2 +-
 ui/desktop/src/types/chat.ts                   | 11 +++++++++++
 9 files changed, 22 insertions(+), 34 deletions(-)
 create mode 100644 ui/desktop/src/types/chat.ts

diff --git a/ui/desktop/src/App.tsx b/ui/desktop/src/App.tsx
index 5a89f351584c..0784cb457f63 100644
--- a/ui/desktop/src/App.tsx
+++ b/ui/desktop/src/App.tsx
@@ -15,7 +15,8 @@ import AnnouncementModal from './components/AnnouncementModal';
 import { generateSessionId } from './sessions';
 import ProviderGuard from './components/ProviderGuard';
 
-import Hub, { type ChatType } from './components/hub';
+import { ChatType } from './types/chat';
+import Hub from './components/hub';
 import Pair from './components/pair';
 import SettingsView, { SettingsViewOptions } from './components/settings/SettingsView';
 import SessionsView from './components/sessions/SessionsView';
diff --git a/ui/desktop/src/components/BaseChat.tsx b/ui/desktop/src/components/BaseChat.tsx
index 6ab12ac3fc6a..9478a016ccd1 100644
--- a/ui/desktop/src/components/BaseChat.tsx
+++ b/ui/desktop/src/components/BaseChat.tsx
@@ -66,20 +66,12 @@ import { useSessionContinuation } from '../hooks/useSessionContinuation';
 import { useFileDrop } from '../hooks/useFileDrop';
 import { useCostTracking } from '../hooks/useCostTracking';
 import { Message } from '../types/message';
-import { Recipe } from '../recipe';
 
 // Context for sharing current model info
 const CurrentModelContext = createContext<{ model: string; mode: string } | null>(null);
 export const useCurrentModelInfo = () => useContext(CurrentModelContext);
 
-export interface ChatType {
-  id: string;
-  title: string;
-  messageHistoryIndex: number;
-  messages: Message[];
-  recipeConfig?: Recipe | null; // Add recipe configuration to chat state
-  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
-}
+import { ChatType } from '../types/chat';
 
 interface BaseChatProps {
   chat: ChatType;
diff --git a/ui/desktop/src/components/hub.tsx b/ui/desktop/src/components/hub.tsx
index 653f4d898292..2a3c9954ac3a 100644
--- a/ui/desktop/src/components/hub.tsx
+++ b/ui/desktop/src/components/hub.tsx
@@ -22,22 +22,13 @@
 import { useState } from 'react';
 import FlappyGoose from './FlappyGoose';
 import { type View, ViewOptions } from '../App';
-import { Message } from '../types/message';
 import { SessionInsights } from './sessions/SessionsInsights';
 import ChatInput from './ChatInput';
 import { generateSessionId } from '../sessions';
 import { ChatContextManagerProvider } from './context_management/ChatContextManager';
-import { Recipe } from '../recipe';
 import 'react-toastify/dist/ReactToastify.css';
 
-export interface ChatType {
-  id: string;
-  title: string;
-  messageHistoryIndex: number;
-  messages: Message[];
-  recipeConfig?: Recipe | null; // Add recipe configuration to chat state
-  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
-}
+import { ChatType } from '../types/chat';
 
 export default function Hub({
   chat: _chat,
@@ -69,6 +60,7 @@ export default function Hub({
         messages: [], // Always start with empty messages
         messageHistoryIndex: 0,
         recipeConfig: null, // Clear recipe for new chats from Hub
+        recipeParameters: null, // Clear parameters for new chats from Hub
       };
 
       // Update the PAIR chat state immediately to prevent flashing
diff --git a/ui/desktop/src/components/pair.tsx b/ui/desktop/src/components/pair.tsx
index e3d38af8207c..00593ef9386a 100644
--- a/ui/desktop/src/components/pair.tsx
+++ b/ui/desktop/src/components/pair.tsx
@@ -27,24 +27,15 @@
 import { useEffect, useState } from 'react';
 import { useLocation } from 'react-router-dom';
 import { type View, ViewOptions } from '../App';
-import { Message } from '../types/message';
 import BaseChat from './BaseChat';
 import ParameterInputModal from './ParameterInputModal';
 import { useRecipeManager } from '../hooks/useRecipeManager';
 import { useIsMobile } from '../hooks/use-mobile';
 import { useSidebar } from './ui/sidebar';
-import { Recipe } from '../recipe';
 import 'react-toastify/dist/ReactToastify.css';
 import { cn } from '../utils';
 
-export interface ChatType {
-  id: string;
-  title: string;
-  messageHistoryIndex: number;
-  messages: Message[];
-  recipeConfig?: Recipe | null; // Add recipe configuration to chat state
-  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
-}
+import { ChatType } from '../types/chat';
 
 export default function Pair({
   chat,
@@ -84,6 +75,7 @@ export default function Pair({
         messages: [], // Clear messages to start fresh
         messageHistoryIndex: 0,
         recipeConfig: location.state.recipeConfig, // Set the recipe config in chat state
+        recipeParameters: null, // Clear parameters for new recipe
       };
       setChat(newChat);
 
diff --git a/ui/desktop/src/contexts/ChatContext.tsx b/ui/desktop/src/contexts/ChatContext.tsx
index 1c1e500ae45f..7788ed70a7c8 100644
--- a/ui/desktop/src/contexts/ChatContext.tsx
+++ b/ui/desktop/src/contexts/ChatContext.tsx
@@ -1,5 +1,5 @@
 import React, { createContext, useContext, ReactNode } from 'react';
-import { ChatType } from '../components/BaseChat';
+import { ChatType } from '../types/chat';
 import { generateSessionId } from '../sessions';
 import { Recipe } from '../recipe';
 import { useDraftContext } from './DraftContext';
diff --git a/ui/desktop/src/hooks/useChat.ts b/ui/desktop/src/hooks/useChat.ts
index c3213b8f19f6..7db74e5a6e65 100644
--- a/ui/desktop/src/hooks/useChat.ts
+++ b/ui/desktop/src/hooks/useChat.ts
@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { ChatType } from '../components/BaseChat';
+import { ChatType } from '../types/chat';
 import { fetchSessionDetails, generateSessionId } from '../sessions';
 import { View, ViewOptions } from '../App';
 
diff --git a/ui/desktop/src/hooks/useChatEngine.ts b/ui/desktop/src/hooks/useChatEngine.ts
index 4f2613abe78a..d25ba15cf4fa 100644
--- a/ui/desktop/src/hooks/useChatEngine.ts
+++ b/ui/desktop/src/hooks/useChatEngine.ts
@@ -14,7 +14,7 @@ import {
   getTextContent,
   TextContent,
 } from '../types/message';
-import { ChatType } from '../components/hub';
+import { ChatType } from '../types/chat';
 
 // Helper function to determine if a message is a user message
 const isUserMessage = (message: Message): boolean => {
diff --git a/ui/desktop/src/hooks/useSessionContinuation.ts b/ui/desktop/src/hooks/useSessionContinuation.ts
index 57c69a0d2593..a35942e0ff77 100644
--- a/ui/desktop/src/hooks/useSessionContinuation.ts
+++ b/ui/desktop/src/hooks/useSessionContinuation.ts
@@ -1,6 +1,6 @@
 import { useEffect, useRef } from 'react';
 import { generateSessionId } from '../sessions';
-import { ChatType } from '../components/hub';
+import { ChatType } from '../types/chat';
 
 interface UseSessionContinuationProps {
   chat: ChatType;
diff --git a/ui/desktop/src/types/chat.ts b/ui/desktop/src/types/chat.ts
new file mode 100644
index 000000000000..ac0367590b02
--- /dev/null
+++ b/ui/desktop/src/types/chat.ts
@@ -0,0 +1,11 @@
+import { Message } from './message';
+import { Recipe } from '../recipe';
+
+export interface ChatType {
+  id: string;
+  title: string;
+  messageHistoryIndex: number;
+  messages: Message[];
+  recipeConfig?: Recipe | null; // Add recipe configuration to chat state
+  recipeParameters?: Record<string, string> | null; // Add recipe parameters to chat state
+}