feat(gui): improve agent creation with AI-assisted function calling

- AI-assisted mode: Uses completions API with function calling to generate
  complete agent config (name, description, tools, model, prompt)
- Manual mode: Removed permission mode selector, focusing on agent
  description and tool selection
- Added optimized system prompt for generating autonomous agents
- Agents no longer include tools requiring user interaction/ask

Author: factorydroid

cortex-gui/src/components/AgentsManager.tsx

@@ -2,6 +2,9 @@ import { createSignal, createEffect, Show, For } from "solid-js";
 import { Icon } from "./ui/Icon";
 import { useSDK } from "@/context/SDKContext";
 
+// Cortex API base URL for completions
+const CORTEX_API_URL = "https://api.cortex.foundation";
+
 export interface AgentDefinition {
   name: string;
   description: string;
@@ -13,6 +16,40 @@ export interface AgentDefinition {
   filePath?: string;
 }
 
+// Function definition for agent generation via OpenAI-style function calling
+const AGENT_GENERATION_FUNCTION = {
+  name: "generate_agent_config",
+  description: "Generate a complete agent configuration based on the user's description",
+  parameters: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "A short, lowercase, hyphenated name for the agent (e.g., 'code-reviewer', 'test-writer')"
+      },
+      description: {
+        type: "string",
+        description: "A brief description of when this agent should be used and what it does"
+      },
+      tools: {
+        type: "array",
+        items: { type: "string" },
+        description: "List of tools the agent should have access to. Available tools: Read, Create, Edit, Glob, Grep, Execute, LS, WebSearch, FetchUrl, TodoWrite"
+      },
+      model: {
+        type: "string",
+        enum: ["inherit", "sonnet", "opus", "haiku"],
+        description: "The model to use for this agent"
+      },
+      prompt: {
+        type: "string",
+        description: "The system prompt that defines this agent's behavior, expertise, and guidelines"
+      }
+    },
+    required: ["name", "description", "tools", "prompt"]
+  }
+};
+
 interface AgentsManagerProps {
   visible: boolean;
   onClose: () => void;
@@ -38,13 +75,6 @@ const MODELS = [
   { id: "haiku", label: "Haiku (fastest)" },
 ];
 
-const PERMISSIONS = [
-  { id: "default", label: "Default - normal prompts" },
-  { id: "acceptEdits", label: "Accept Edits - auto-accept file changes" },
-  { id: "bypassPermissions", label: "Bypass - skip all prompts" },
-  { id: "plan", label: "Plan - read-only mode" },
-];
-
 export function AgentsManager(props: AgentsManagerProps) {
   const { state } = useSDK();
   const [agents, setAgents] = createSignal<AgentDefinition[]>([]);
@@ -114,13 +144,44 @@ export function AgentsManager(props: AgentsManagerProps) {
     setAiError(null);
 
     try {
-      const res = await fetch(`${state.serverUrl}/api/v1/agents/generate-prompt`, {
+      // Use the completions API with function calling to generate agent config
+      const systemPrompt = `You are an AI assistant that helps create custom agent configurations for Cortex, an AI-powered coding assistant.
+
+When the user describes what kind of agent they want, you must generate a complete agent configuration by calling the generate_agent_config function.
+
+Guidelines for generating agents:
+1. Name should be lowercase, hyphenated, and descriptive (e.g., "code-reviewer", "security-auditor")
+2. Description should clearly explain when to use this agent
+3. Select appropriate tools based on what the agent needs to do:
+   - Read: For reading file contents
+   - Create: For creating new files
+   - Edit: For modifying existing files
+   - Glob: For finding files by pattern
+   - Grep: For searching file contents
+   - Execute: For running shell commands
+   - LS: For listing directories
+   - WebSearch: For searching the web
+   - FetchUrl: For fetching URL content
+   - TodoWrite: For managing todo lists
+4. Do NOT include tools that require user interaction/ask (the agent should work autonomously)
+5. The system prompt should be detailed and clearly define the agent's expertise, behavior, and guidelines`;
+
+      const res = await fetch(`${CORTEX_API_URL}/v1/chat/completions`, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers: { 
+          "Content-Type": "application/json",
+        },
         body: JSON.stringify({
-          description: aiPrompt(),
-          tools: formTools(),
-          name: formName() || undefined,
+          model: state.config?.model || "anthropic/claude-sonnet-4",
+          messages: [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: `Create an agent with the following description:\n\n${aiPrompt()}` }
+          ],
+          tools: [{
+            type: "function",
+            function: AGENT_GENERATION_FUNCTION
+          }],
+          tool_choice: { type: "function", function: { name: "generate_agent_config" } }
         }),
       });
 
@@ -131,17 +192,29 @@ export function AgentsManager(props: AgentsManagerProps) {
 
       const data = await res.json();
 
+      // Extract the function call result
+      const choice = data.choices?.[0];
+      const toolCall = choice?.message?.tool_calls?.[0];
+      
+      if (!toolCall || toolCall.function?.name !== "generate_agent_config") {
+        throw new Error("AI did not return a valid agent configuration");
+      }
+      
+      // Parse the function arguments
+      const agentConfig = JSON.parse(toolCall.function.arguments);
+      
       // Fill form with generated data
-      setFormName(data.name);
-      setFormDescription(data.description);
-      setFormPrompt(data.prompt);
-      setFormTools(data.tools || []);
-      setFormModel(data.model || "inherit");
-      setFormPermission(data.permission_mode || "default");
+      setFormName(agentConfig.name || "");
+      setFormDescription(agentConfig.description || "");
+      setFormPrompt(agentConfig.prompt || "");
+      setFormTools(agentConfig.tools || []);
+      setFormModel(agentConfig.model || "inherit");
+      setFormPermission("default"); // Default permission mode for safety
 
-      // Switch to edit mode to review
+      // Switch to create mode to review
       setMode("create");
     } catch (e) {
+      console.error("AI generation error:", e);
       setAiError(e instanceof Error ? e.message : "Failed to generate agent");
     } finally {
       setGenerating(false);
@@ -628,29 +701,6 @@ export function AgentsManager(props: AgentsManagerProps) {
                 </select>
               </div>
 
-              {/* Permission Mode */}
-              <div>
-                <label class="block text-xs mb-1" style={{ color: "var(--text-weak)" }}>
-                  Permission Mode
-                </label>
-                <select
-                  value={formPermission()}
-                  onChange={(e) => setFormPermission(e.currentTarget.value)}
-                  class="w-full px-3 py-2 rounded border text-sm"
-                  style={{ 
-                    background: "var(--background-base)",
-                    "border-color": "var(--border-base)",
-                    color: "var(--text-base)"
-                  }}
-                >
-                  <For each={PERMISSIONS}>
-                    {(perm) => (
-                      <option value={perm.id}>{perm.label}</option>
-                    )}
-                  </For>
-                </select>
-              </div>
-
               {/* Prompt */}
               <div>
                 <label class="block text-xs mb-1" style={{ color: "var(--text-weak)" }}>