@wingman-ai/gateway 0.5.3 → 0.6.0

package/dist/cli/commands/init.cjs

@@ -44,37 +44,19 @@ const external_node_url_namespaceObject = require("node:url");
 const prompts_namespaceObject = require("@clack/prompts");
 const external_chalk_namespaceObject = require("chalk");
 var external_chalk_default = /*#__PURE__*/ __webpack_require__.n(external_chalk_namespaceObject);
+const external_js_yaml_namespaceObject = require("js-yaml");
 const modelFactory_cjs_namespaceObject = require("../../agent/config/modelFactory.cjs");
 const external_logger_cjs_namespaceObject = require("../../logger.cjs");
 const credentials_cjs_namespaceObject = require("../../providers/credentials.cjs");
 const registry_cjs_namespaceObject = require("../../providers/registry.cjs");
 const schema_cjs_namespaceObject = require("../config/schema.cjs");
 const outputManager_cjs_namespaceObject = require("../core/outputManager.cjs");
-const DEFAULT_AGENT_ID = "wingman";
-const DEFAULT_AGENT_DESCRIPTION = "General-purpose coding assistant for this workspace.";
-const DEFAULT_AGENT_PROMPT = "You are Wingman, a coding assistant for this repository.\nBe direct and concise. Ask clarifying questions when requirements are unclear.\nPrefer minimal diffs and safe changes. Avoid destructive actions unless asked.\nUse tools to inspect the codebase before editing.";
-const DEFAULT_TOOLS = [
-    "code_search",
-    "git_status",
-    "command_execute",
-    "browser_control",
-    "internet_search",
-    "think"
-];
 const DEFAULT_FS_ROOT = ".";
 const DEFAULT_BROWSER_PROFILE_ID = "default";
 const DEFAULT_BROWSER_PROFILES_DIR = ".wingman/browser-profiles";
 const DEFAULT_BROWSER_EXTENSIONS_DIR = ".wingman/browser-extensions";
 const DEFAULT_BUNDLED_EXTENSION_ID = "wingman";
 const DEFAULT_BROWSER_TRANSPORT = "auto";
-const DEFAULT_MODELS = {
-    anthropic: "anthropic:claude-sonnet-4-5",
-    openai: "openai:gpt-4o",
-    codex: "codex:codex-mini-latest",
-    openrouter: "openrouter:openai/gpt-4o",
-    copilot: "copilot:gpt-4o",
-    xai: "xai:grok-beta"
-};
 const DEFAULT_INIT_MODE = "onboard";
 const DEFAULT_ONBOARD_COMPONENTS = [
     "config",
@@ -133,8 +115,20 @@ async function executeInitCommand(args, options = {}) {
         renderInitBanner(outputManager, nonInteractive, mode, components);
         const bundledAgentsPath = resolveBundledAgentsPath();
         const bundledAgents = bundledAgentsPath ? listBundledAgents(bundledAgentsPath) : [];
-        const explicitAgent = Boolean(args.agent?.trim()) || Boolean(args.subcommand) && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-");
-        const defaultAgentId = resolveAgentId(args);
+        const requestedAgentId = resolveRequestedAgentId(args);
+        const explicitAgent = Boolean(requestedAgentId);
+        const resolvedAgentId = resolveDefaultAgentId({
+            requestedAgentId,
+            bundledAgents,
+            configPath
+        });
+        if (!resolvedAgentId && (runConfig || runAgents)) throw new Error("No explicit agents are available. Add an agent under .wingman/agents or pass --agent with an existing bundled agent.");
+        const defaultAgentId = resolvedAgentId || "main";
+        if (runConfig || runAgents) assertAgentIsExplicit({
+            agentId: defaultAgentId,
+            bundledAgents,
+            configRoot
+        });
         const agentPlan = runConfig || runAgents ? syncAgentsOnly ? resolveAgentSyncPlan({
             defaultAgentId,
             bundledAgents,
@@ -159,7 +153,6 @@ async function executeInitCommand(args, options = {}) {
         const model = shouldResolveModel ? await resolveModelSelection({
             nonInteractive,
             optionMap,
-            providerName,
             outputManager
         }) : void 0;
         if (runConfig) await runStep(useClack, "Writing workspace config", async ()=>handleConfigSetup({
@@ -178,7 +171,6 @@ async function executeInitCommand(args, options = {}) {
                 agentId: agentPlan.defaultAgentId,
                 model,
                 force,
-                nonInteractive,
                 outputManager,
                 bundledAgentsPath,
                 copyAgents: agentPlan.copyAgents,
@@ -245,10 +237,35 @@ function isHelpCommand(subcommand) {
         "-h"
     ].includes(subcommand);
 }
-function resolveAgentId(args) {
-    if (args.agent?.trim()) return args.agent.trim();
-    if (args.subcommand && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-")) return args.subcommand.trim();
-    return DEFAULT_AGENT_ID;
+function resolveRequestedAgentId(args) {
+    if (args.agent?.trim()) return sanitizeAgentId(args.agent.trim());
+    if (args.subcommand && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-")) return sanitizeAgentId(args.subcommand.trim());
+}
+function resolveDefaultAgentId(input) {
+    const { requestedAgentId, bundledAgents, configPath } = input;
+    if (requestedAgentId) return requestedAgentId;
+    const existingDefaultAgent = readConfiguredDefaultAgent(configPath);
+    if (existingDefaultAgent) return existingDefaultAgent;
+    const preferredBundledAgent = resolvePreferredBundledAgentId(bundledAgents);
+    if (preferredBundledAgent) return preferredBundledAgent;
+}
+function readConfiguredDefaultAgent(configPath) {
+    if (!(0, external_node_fs_namespaceObject.existsSync)(configPath)) return;
+    try {
+        const raw = (0, external_node_fs_namespaceObject.readFileSync)(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if ("string" == typeof parsed.defaultAgent && parsed.defaultAgent.trim()) return sanitizeAgentId(parsed.defaultAgent.trim());
+    } catch  {}
+}
+function resolvePreferredBundledAgentId(bundledAgents) {
+    if (bundledAgents.includes("main")) return "main";
+    return bundledAgents[0];
+}
+function assertAgentIsExplicit(input) {
+    const { agentId, bundledAgents, configRoot } = input;
+    if (bundledAgents.includes(agentId)) return;
+    if (findAgentConfigPath(configRoot, agentId)) return;
+    throw new Error(`Agent "${agentId}" is not defined. Choose one of the bundled agents (${bundledAgents.join(", ")}) or create .wingman/agents/${agentId}/agent.md explicitly.`);
 }
 async function resolveAgentPlan(input) {
     const { explicitAgent, defaultAgentId, bundledAgents, nonInteractive, optionMap, outputManager, ensureDefaultAgentInSelection } = input;
@@ -508,7 +525,7 @@ function bootstrapBrowserDefaults(configRoot, config) {
     };
 }
 async function handleAgentSetup(input) {
-    const { configRoot, agentId, model, force, nonInteractive, outputManager, bundledAgentsPath, copyAgents, ensureDefaultAgent = true } = input;
+    const { configRoot, agentId, model, force, outputManager, bundledAgentsPath, copyAgents, ensureDefaultAgent = true } = input;
     const copiedAgents = bundledAgentsPath ? copyBundledAgents({
         bundledAgentsPath,
         configRoot,
@@ -518,17 +535,8 @@ async function handleAgentSetup(input) {
     }) : new Set();
     if (copiedAgents.size > 0) writeLine(outputManager, `Copied ${copiedAgents.size} bundled agent(s) to ${(0, external_node_path_namespaceObject.join)(configRoot, "agents")}`);
     if (!ensureDefaultAgent) return;
-    const expectedAgentDir = (0, external_node_path_namespaceObject.join)(configRoot, "agents", agentId);
-    const expectedAgentPath = (0, external_node_path_namespaceObject.join)(expectedAgentDir, "agent.json");
-    const expectedAgentExists = (0, external_node_fs_namespaceObject.existsSync)(expectedAgentPath);
-    if (!expectedAgentExists) return void await createFallbackAgent({
-        configRoot,
-        agentId,
-        model,
-        force,
-        nonInteractive,
-        outputManager
-    });
+    const expectedAgentPath = findAgentConfigPath(configRoot, agentId);
+    if (!expectedAgentPath) throw new Error(`Agent "${agentId}" was not found after init. Create .wingman/agents/${agentId}/agent.md explicitly or choose a bundled agent.`);
     if (model) applyModelToAgent(expectedAgentPath, model, outputManager);
 }
 function resolveBundledAgentsPath() {
@@ -585,35 +593,34 @@ function copyDirectory(source, target) {
         else (0, external_node_fs_namespaceObject.copyFileSync)(sourcePath, targetPath);
     }
 }
-async function createFallbackAgent(input) {
-    const { configRoot, agentId, model, force, nonInteractive, outputManager } = input;
+function findAgentConfigPath(configRoot, agentId) {
     const agentDir = (0, external_node_path_namespaceObject.join)(configRoot, "agents", agentId);
-    const agentPath = (0, external_node_path_namespaceObject.join)(agentDir, "agent.json");
-    const agentExists = (0, external_node_fs_namespaceObject.existsSync)(agentPath);
-    if (agentExists && !force) {
-        if (nonInteractive) return void writeLine(outputManager, `Agent "${agentId}" already exists. Use --force to overwrite.`);
-        const shouldOverwrite = await promptConfirm(`Agent "${agentId}" exists. Overwrite? (y/N): `, false);
-        if (!shouldOverwrite) return void writeLine(outputManager, `Keeping existing agent "${agentId}".`);
-    }
-    (0, external_node_fs_namespaceObject.mkdirSync)(agentDir, {
-        recursive: true
-    });
-    const agentConfig = {
-        name: agentId,
-        description: DEFAULT_AGENT_DESCRIPTION,
-        systemPrompt: DEFAULT_AGENT_PROMPT,
-        tools: DEFAULT_TOOLS
-    };
-    if (model) agentConfig.model = model;
-    (0, external_node_fs_namespaceObject.writeFileSync)(agentPath, JSON.stringify(agentConfig, null, 2));
-    writeLine(outputManager, `Created starter agent at ${agentPath}`);
+    const jsonPath = (0, external_node_path_namespaceObject.join)(agentDir, "agent.json");
+    if ((0, external_node_fs_namespaceObject.existsSync)(jsonPath)) return jsonPath;
+    const markdownPath = (0, external_node_path_namespaceObject.join)(agentDir, "agent.md");
+    if ((0, external_node_fs_namespaceObject.existsSync)(markdownPath)) return markdownPath;
+    return null;
 }
 function applyModelToAgent(agentPath, model, outputManager) {
     try {
-        const raw = (0, external_node_fs_namespaceObject.readFileSync)(agentPath, "utf-8");
-        const parsed = JSON.parse(raw);
-        parsed.model = model;
-        (0, external_node_fs_namespaceObject.writeFileSync)(agentPath, JSON.stringify(parsed, null, 2));
+        if (agentPath.endsWith(".json")) {
+            const raw = (0, external_node_fs_namespaceObject.readFileSync)(agentPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            parsed.model = model;
+            (0, external_node_fs_namespaceObject.writeFileSync)(agentPath, JSON.stringify(parsed, null, 2));
+        } else if (agentPath.endsWith(".md")) {
+            const raw = (0, external_node_fs_namespaceObject.readFileSync)(agentPath, "utf-8");
+            const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/;
+            const match = raw.match(frontmatterRegex);
+            if (!match) throw new Error("Invalid agent.md format: missing frontmatter");
+            const [, rawFrontmatter, prompt] = match;
+            const metadata = external_js_yaml_namespaceObject.load(rawFrontmatter) || {};
+            metadata.model = model;
+            const serializedFrontmatter = external_js_yaml_namespaceObject.dump(metadata, {
+                lineWidth: 120
+            });
+            (0, external_node_fs_namespaceObject.writeFileSync)(agentPath, `---\n${serializedFrontmatter}---\n\n${prompt?.trim() || ""}\n`);
+        } else throw new Error("Unsupported agent config format");
         writeLine(outputManager, `Updated ${agentPath} with model ${model}`);
     } catch  {
         writeLine(outputManager, `Unable to update model for ${agentPath}. Update manually.`);
@@ -653,7 +660,7 @@ async function resolveProviderSelection(input) {
     return normalized;
 }
 async function resolveModelSelection(input) {
-    const { nonInteractive, optionMap, providerName, outputManager } = input;
+    const { nonInteractive, optionMap, outputManager } = input;
     const explicitModel = getStringOption(optionMap, [
         "model"
     ]);
@@ -661,22 +668,13 @@ async function resolveModelSelection(input) {
         validateModel(explicitModel);
         return explicitModel;
     }
-    const providers = (0, registry_cjs_namespaceObject.listProviderSpecs)("model");
-    const configuredProvider = providers.find((provider)=>"missing" !== (0, credentials_cjs_namespaceObject.resolveProviderToken)(provider.name).source);
-    const suggestedProvider = providerName || configuredProvider?.name;
-    const suggestedModel = suggestedProvider ? DEFAULT_MODELS[suggestedProvider] : void 0;
-    if (nonInteractive) {
-        if (suggestedModel) return suggestedModel;
-        return;
-    }
+    if (nonInteractive) return;
     const inputValue = await (0, prompts_namespaceObject.text)({
         message: "Model string (provider:model)",
-        placeholder: suggestedModel ? void 0 : "anthropic:claude-sonnet-4-5",
-        defaultValue: suggestedModel
+        placeholder: "anthropic:claude-sonnet-4-5"
     });
     if ((0, prompts_namespaceObject.isCancel)(inputValue)) abortSetup();
     const trimmed = String(inputValue ?? "").trim();
-    if (!trimmed && suggestedModel) return suggestedModel;
     if (!trimmed) return void writeLine(outputManager, "Skipping model selection.");
     validateModel(trimmed);
     return trimmed;
@@ -779,29 +777,13 @@ async function promptForDefaultAgent(agents, currentDefault) {
     const defaultValue = choices.includes(currentDefault) ? currentDefault : choices[0];
     const selection = await (0, prompts_namespaceObject.select)({
         message: "Pick a default agent",
-        options: [
-            ...choices.map((agent)=>({
-                    value: agent,
-                    label: agent
-                })),
-            {
-                value: "__custom__",
-                label: "Custom agent name"
-            }
-        ],
+        options: choices.map((agent)=>({
+                value: agent,
+                label: agent
+            })),
         initialValue: defaultValue
     });
     if ((0, prompts_namespaceObject.isCancel)(selection)) abortSetup();
-    if ("__custom__" === selection) {
-        const input = await (0, prompts_namespaceObject.text)({
-            message: "Default agent name",
-            placeholder: defaultValue
-        });
-        if ((0, prompts_namespaceObject.isCancel)(input)) abortSetup();
-        const trimmed = String(input ?? "").trim();
-        if (!trimmed) return defaultValue;
-        return sanitizeAgentId(trimmed);
-    }
     return sanitizeAgentId(String(selection));
 }
 async function promptForAgentSelection(agents, defaultAgent) {
@@ -868,12 +850,12 @@ Usage:
   wingman init <agent-name>
 
 Options:
-  --agent <name>         Agent name (default: wingman)
+  --agent <name>         Bundled or existing explicit agent name
   --mode <name>          Init mode (onboard|sync). Default: onboard
   --only <targets>       Run only selected setup targets (config,agents,provider)
   --agents <list>        Copy only these bundled agents (comma-separated)
   --model <provider:model>
-                         Set model for the starter agent
+                         Set model for the selected explicit agent
   --provider <name>      Provider to configure (anthropic|openai|codex|openrouter|copilot|xai)
   --token <token>        Save provider token (non-interactive)
   --api-key <key>        Alias for --token

package/dist/cli/commands/init.js

@@ -3,37 +3,19 @@ import { dirname, isAbsolute, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { cancel, confirm as prompts_confirm, intro, isCancel, multiselect, note, outro, select as prompts_select, spinner, text as prompts_text } from "@clack/prompts";
 import chalk from "chalk";
+import { dump, load } from "js-yaml";
 import { ModelFactory } from "../../agent/config/modelFactory.js";
 import { createLogger, getLogFilePath } from "../../logger.js";
 import { getCredentialsPath, resolveProviderToken, saveProviderToken } from "../../providers/credentials.js";
 import { listProviderSpecs, normalizeProviderName } from "../../providers/registry.js";
 import { WingmanConfigSchema } from "../config/schema.js";
 import { OutputManager } from "../core/outputManager.js";
-const DEFAULT_AGENT_ID = "wingman";
-const DEFAULT_AGENT_DESCRIPTION = "General-purpose coding assistant for this workspace.";
-const DEFAULT_AGENT_PROMPT = "You are Wingman, a coding assistant for this repository.\nBe direct and concise. Ask clarifying questions when requirements are unclear.\nPrefer minimal diffs and safe changes. Avoid destructive actions unless asked.\nUse tools to inspect the codebase before editing.";
-const DEFAULT_TOOLS = [
-    "code_search",
-    "git_status",
-    "command_execute",
-    "browser_control",
-    "internet_search",
-    "think"
-];
 const DEFAULT_FS_ROOT = ".";
 const DEFAULT_BROWSER_PROFILE_ID = "default";
 const DEFAULT_BROWSER_PROFILES_DIR = ".wingman/browser-profiles";
 const DEFAULT_BROWSER_EXTENSIONS_DIR = ".wingman/browser-extensions";
 const DEFAULT_BUNDLED_EXTENSION_ID = "wingman";
 const DEFAULT_BROWSER_TRANSPORT = "auto";
-const DEFAULT_MODELS = {
-    anthropic: "anthropic:claude-sonnet-4-5",
-    openai: "openai:gpt-4o",
-    codex: "codex:codex-mini-latest",
-    openrouter: "openrouter:openai/gpt-4o",
-    copilot: "copilot:gpt-4o",
-    xai: "xai:grok-beta"
-};
 const DEFAULT_INIT_MODE = "onboard";
 const DEFAULT_ONBOARD_COMPONENTS = [
     "config",
@@ -92,8 +74,20 @@ async function executeInitCommand(args, options = {}) {
         renderInitBanner(outputManager, nonInteractive, mode, components);
         const bundledAgentsPath = resolveBundledAgentsPath();
         const bundledAgents = bundledAgentsPath ? listBundledAgents(bundledAgentsPath) : [];
-        const explicitAgent = Boolean(args.agent?.trim()) || Boolean(args.subcommand) && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-");
-        const defaultAgentId = resolveAgentId(args);
+        const requestedAgentId = resolveRequestedAgentId(args);
+        const explicitAgent = Boolean(requestedAgentId);
+        const resolvedAgentId = resolveDefaultAgentId({
+            requestedAgentId,
+            bundledAgents,
+            configPath
+        });
+        if (!resolvedAgentId && (runConfig || runAgents)) throw new Error("No explicit agents are available. Add an agent under .wingman/agents or pass --agent with an existing bundled agent.");
+        const defaultAgentId = resolvedAgentId || "main";
+        if (runConfig || runAgents) assertAgentIsExplicit({
+            agentId: defaultAgentId,
+            bundledAgents,
+            configRoot
+        });
         const agentPlan = runConfig || runAgents ? syncAgentsOnly ? resolveAgentSyncPlan({
             defaultAgentId,
             bundledAgents,
@@ -118,7 +112,6 @@ async function executeInitCommand(args, options = {}) {
         const model = shouldResolveModel ? await resolveModelSelection({
             nonInteractive,
             optionMap,
-            providerName,
             outputManager
         }) : void 0;
         if (runConfig) await runStep(useClack, "Writing workspace config", async ()=>handleConfigSetup({
@@ -137,7 +130,6 @@ async function executeInitCommand(args, options = {}) {
                 agentId: agentPlan.defaultAgentId,
                 model,
                 force,
-                nonInteractive,
                 outputManager,
                 bundledAgentsPath,
                 copyAgents: agentPlan.copyAgents,
@@ -204,10 +196,35 @@ function isHelpCommand(subcommand) {
         "-h"
     ].includes(subcommand);
 }
-function resolveAgentId(args) {
-    if (args.agent?.trim()) return args.agent.trim();
-    if (args.subcommand && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-")) return args.subcommand.trim();
-    return DEFAULT_AGENT_ID;
+function resolveRequestedAgentId(args) {
+    if (args.agent?.trim()) return sanitizeAgentId(args.agent.trim());
+    if (args.subcommand && !isHelpCommand(args.subcommand) && !args.subcommand.startsWith("-")) return sanitizeAgentId(args.subcommand.trim());
+}
+function resolveDefaultAgentId(input) {
+    const { requestedAgentId, bundledAgents, configPath } = input;
+    if (requestedAgentId) return requestedAgentId;
+    const existingDefaultAgent = readConfiguredDefaultAgent(configPath);
+    if (existingDefaultAgent) return existingDefaultAgent;
+    const preferredBundledAgent = resolvePreferredBundledAgentId(bundledAgents);
+    if (preferredBundledAgent) return preferredBundledAgent;
+}
+function readConfiguredDefaultAgent(configPath) {
+    if (!existsSync(configPath)) return;
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if ("string" == typeof parsed.defaultAgent && parsed.defaultAgent.trim()) return sanitizeAgentId(parsed.defaultAgent.trim());
+    } catch  {}
+}
+function resolvePreferredBundledAgentId(bundledAgents) {
+    if (bundledAgents.includes("main")) return "main";
+    return bundledAgents[0];
+}
+function assertAgentIsExplicit(input) {
+    const { agentId, bundledAgents, configRoot } = input;
+    if (bundledAgents.includes(agentId)) return;
+    if (findAgentConfigPath(configRoot, agentId)) return;
+    throw new Error(`Agent "${agentId}" is not defined. Choose one of the bundled agents (${bundledAgents.join(", ")}) or create .wingman/agents/${agentId}/agent.md explicitly.`);
 }
 async function resolveAgentPlan(input) {
     const { explicitAgent, defaultAgentId, bundledAgents, nonInteractive, optionMap, outputManager, ensureDefaultAgentInSelection } = input;
@@ -467,7 +484,7 @@ function bootstrapBrowserDefaults(configRoot, config) {
     };
 }
 async function handleAgentSetup(input) {
-    const { configRoot, agentId, model, force, nonInteractive, outputManager, bundledAgentsPath, copyAgents, ensureDefaultAgent = true } = input;
+    const { configRoot, agentId, model, force, outputManager, bundledAgentsPath, copyAgents, ensureDefaultAgent = true } = input;
     const copiedAgents = bundledAgentsPath ? copyBundledAgents({
         bundledAgentsPath,
         configRoot,
@@ -477,17 +494,8 @@ async function handleAgentSetup(input) {
     }) : new Set();
     if (copiedAgents.size > 0) writeLine(outputManager, `Copied ${copiedAgents.size} bundled agent(s) to ${join(configRoot, "agents")}`);
     if (!ensureDefaultAgent) return;
-    const expectedAgentDir = join(configRoot, "agents", agentId);
-    const expectedAgentPath = join(expectedAgentDir, "agent.json");
-    const expectedAgentExists = existsSync(expectedAgentPath);
-    if (!expectedAgentExists) return void await createFallbackAgent({
-        configRoot,
-        agentId,
-        model,
-        force,
-        nonInteractive,
-        outputManager
-    });
+    const expectedAgentPath = findAgentConfigPath(configRoot, agentId);
+    if (!expectedAgentPath) throw new Error(`Agent "${agentId}" was not found after init. Create .wingman/agents/${agentId}/agent.md explicitly or choose a bundled agent.`);
     if (model) applyModelToAgent(expectedAgentPath, model, outputManager);
 }
 function resolveBundledAgentsPath() {
@@ -544,35 +552,34 @@ function copyDirectory(source, target) {
         else copyFileSync(sourcePath, targetPath);
     }
 }
-async function createFallbackAgent(input) {
-    const { configRoot, agentId, model, force, nonInteractive, outputManager } = input;
+function findAgentConfigPath(configRoot, agentId) {
     const agentDir = join(configRoot, "agents", agentId);
-    const agentPath = join(agentDir, "agent.json");
-    const agentExists = existsSync(agentPath);
-    if (agentExists && !force) {
-        if (nonInteractive) return void writeLine(outputManager, `Agent "${agentId}" already exists. Use --force to overwrite.`);
-        const shouldOverwrite = await promptConfirm(`Agent "${agentId}" exists. Overwrite? (y/N): `, false);
-        if (!shouldOverwrite) return void writeLine(outputManager, `Keeping existing agent "${agentId}".`);
-    }
-    mkdirSync(agentDir, {
-        recursive: true
-    });
-    const agentConfig = {
-        name: agentId,
-        description: DEFAULT_AGENT_DESCRIPTION,
-        systemPrompt: DEFAULT_AGENT_PROMPT,
-        tools: DEFAULT_TOOLS
-    };
-    if (model) agentConfig.model = model;
-    writeFileSync(agentPath, JSON.stringify(agentConfig, null, 2));
-    writeLine(outputManager, `Created starter agent at ${agentPath}`);
+    const jsonPath = join(agentDir, "agent.json");
+    if (existsSync(jsonPath)) return jsonPath;
+    const markdownPath = join(agentDir, "agent.md");
+    if (existsSync(markdownPath)) return markdownPath;
+    return null;
 }
 function applyModelToAgent(agentPath, model, outputManager) {
     try {
-        const raw = readFileSync(agentPath, "utf-8");
-        const parsed = JSON.parse(raw);
-        parsed.model = model;
-        writeFileSync(agentPath, JSON.stringify(parsed, null, 2));
+        if (agentPath.endsWith(".json")) {
+            const raw = readFileSync(agentPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            parsed.model = model;
+            writeFileSync(agentPath, JSON.stringify(parsed, null, 2));
+        } else if (agentPath.endsWith(".md")) {
+            const raw = readFileSync(agentPath, "utf-8");
+            const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/;
+            const match = raw.match(frontmatterRegex);
+            if (!match) throw new Error("Invalid agent.md format: missing frontmatter");
+            const [, rawFrontmatter, prompt] = match;
+            const metadata = load(rawFrontmatter) || {};
+            metadata.model = model;
+            const serializedFrontmatter = dump(metadata, {
+                lineWidth: 120
+            });
+            writeFileSync(agentPath, `---\n${serializedFrontmatter}---\n\n${prompt?.trim() || ""}\n`);
+        } else throw new Error("Unsupported agent config format");
         writeLine(outputManager, `Updated ${agentPath} with model ${model}`);
     } catch  {
         writeLine(outputManager, `Unable to update model for ${agentPath}. Update manually.`);
@@ -612,7 +619,7 @@ async function resolveProviderSelection(input) {
     return normalized;
 }
 async function resolveModelSelection(input) {
-    const { nonInteractive, optionMap, providerName, outputManager } = input;
+    const { nonInteractive, optionMap, outputManager } = input;
     const explicitModel = getStringOption(optionMap, [
         "model"
     ]);
@@ -620,22 +627,13 @@ async function resolveModelSelection(input) {
         validateModel(explicitModel);
         return explicitModel;
     }
-    const providers = listProviderSpecs("model");
-    const configuredProvider = providers.find((provider)=>"missing" !== resolveProviderToken(provider.name).source);
-    const suggestedProvider = providerName || configuredProvider?.name;
-    const suggestedModel = suggestedProvider ? DEFAULT_MODELS[suggestedProvider] : void 0;
-    if (nonInteractive) {
-        if (suggestedModel) return suggestedModel;
-        return;
-    }
+    if (nonInteractive) return;
     const inputValue = await prompts_text({
         message: "Model string (provider:model)",
-        placeholder: suggestedModel ? void 0 : "anthropic:claude-sonnet-4-5",
-        defaultValue: suggestedModel
+        placeholder: "anthropic:claude-sonnet-4-5"
     });
     if (isCancel(inputValue)) abortSetup();
     const trimmed = String(inputValue ?? "").trim();
-    if (!trimmed && suggestedModel) return suggestedModel;
     if (!trimmed) return void writeLine(outputManager, "Skipping model selection.");
     validateModel(trimmed);
     return trimmed;
@@ -738,29 +736,13 @@ async function promptForDefaultAgent(agents, currentDefault) {
     const defaultValue = choices.includes(currentDefault) ? currentDefault : choices[0];
     const selection = await prompts_select({
         message: "Pick a default agent",
-        options: [
-            ...choices.map((agent)=>({
-                    value: agent,
-                    label: agent
-                })),
-            {
-                value: "__custom__",
-                label: "Custom agent name"
-            }
-        ],
+        options: choices.map((agent)=>({
+                value: agent,
+                label: agent
+            })),
         initialValue: defaultValue
     });
     if (isCancel(selection)) abortSetup();
-    if ("__custom__" === selection) {
-        const input = await prompts_text({
-            message: "Default agent name",
-            placeholder: defaultValue
-        });
-        if (isCancel(input)) abortSetup();
-        const trimmed = String(input ?? "").trim();
-        if (!trimmed) return defaultValue;
-        return sanitizeAgentId(trimmed);
-    }
     return sanitizeAgentId(String(selection));
 }
 async function promptForAgentSelection(agents, defaultAgent) {
@@ -827,12 +809,12 @@ Usage:
   wingman init <agent-name>
 
 Options:
-  --agent <name>         Agent name (default: wingman)
+  --agent <name>         Bundled or existing explicit agent name
   --mode <name>          Init mode (onboard|sync). Default: onboard
   --only <targets>       Run only selected setup targets (config,agents,provider)
   --agents <list>        Copy only these bundled agents (comma-separated)
   --model <provider:model>
-                         Set model for the starter agent
+                         Set model for the selected explicit agent
   --provider <name>      Provider to configure (anthropic|openai|codex|openrouter|copilot|xai)
   --token <token>        Save provider token (non-interactive)
   --api-key <key>        Alias for --token

package/dist/cli/config/loader.cjs

@@ -91,11 +91,6 @@ class WingmanConfigLoader {
         return {
             logLevel: "info",
             recursionLimit: 5000,
-            summarization: {
-                enabled: true,
-                maxTokensBeforeSummary: 12000,
-                messagesToKeep: 8
-            },
             modelRetry: {
                 enabled: true,
                 maxRetries: 2,

package/dist/cli/config/loader.js

@@ -63,11 +63,6 @@ class WingmanConfigLoader {
         return {
             logLevel: "info",
             recursionLimit: 5000,
-            summarization: {
-                enabled: true,
-                maxTokensBeforeSummary: 12000,
-                messagesToKeep: 8
-            },
             modelRetry: {
                 enabled: true,
                 maxRetries: 2,

package/dist/cli/config/schema.cjs

@@ -141,8 +141,8 @@ const BrowserConfigSchema = external_zod_namespaceObject.object({
 });
 const SummarizationConfigSchema = external_zod_namespaceObject.object({
     enabled: external_zod_namespaceObject.boolean().optional().default(true).describe("Enable conversation history summarization"),
-    maxTokensBeforeSummary: external_zod_namespaceObject.number().min(1000).max(1000000).optional().default(12000).describe("Token threshold before summarizing conversation history"),
-    messagesToKeep: external_zod_namespaceObject.number().min(2).max(100).optional().default(8).describe("How many most recent messages to keep after summarization")
+    maxTokensBeforeSummary: external_zod_namespaceObject.number().min(1000).max(1000000).optional().describe("Token threshold before summarizing conversation history"),
+    messagesToKeep: external_zod_namespaceObject.number().min(2).max(100).optional().describe("How many most recent messages to keep after summarization")
 });
 const RetryOnFailureSchema = external_zod_namespaceObject["enum"]([
     "continue",
@@ -382,11 +382,7 @@ const WingmanConfigSchema = external_zod_namespaceObject.object({
     ]).optional().default("info"),
     defaultAgent: external_zod_namespaceObject.string().optional(),
     recursionLimit: external_zod_namespaceObject.number().min(1).max(1000000).optional().default(5000),
-    summarization: SummarizationConfigSchema.optional().default({
-        enabled: true,
-        maxTokensBeforeSummary: 12000,
-        messagesToKeep: 8
-    }),
+    summarization: SummarizationConfigSchema.optional(),
     modelRetry: ModelRetryConfigSchema.optional().default({
         enabled: true,
         maxRetries: 2,

package/dist/cli/config/schema.d.ts

@@ -64,8 +64,8 @@ export declare const BrowserConfigSchema: z.ZodObject<{
 export type BrowserConfig = z.infer<typeof BrowserConfigSchema>;
 export declare const SummarizationConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    maxTokensBeforeSummary: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    messagesToKeep: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxTokensBeforeSummary: z.ZodOptional<z.ZodNumber>;
+    messagesToKeep: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type SummarizationConfig = z.infer<typeof SummarizationConfigSchema>;
 export declare const ModelRetryConfigSchema: z.ZodObject<{
@@ -218,11 +218,11 @@ export declare const WingmanConfigSchema: z.ZodObject<{
     }>>>;
     defaultAgent: z.ZodOptional<z.ZodString>;
     recursionLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    summarization: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    summarization: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        maxTokensBeforeSummary: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        messagesToKeep: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    }, z.core.$strip>>>;
+        maxTokensBeforeSummary: z.ZodOptional<z.ZodNumber>;
+        messagesToKeep: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
     modelRetry: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;