@united-workforce/cli 0.2.1-rc.9 → 0.4.0

package/dist/commands/config.js

@@ -2,17 +2,11 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { parse, stringify } from "yaml";
 /**
- * Valid configuration key schema
+ * Valid configuration key schema. Engine config is LLM-free — providers,
+ * models, defaultModel, and modelOverrides are no longer accepted here.
+ * Each adapter owns its own LLM configuration.
  */
 const VALID_CONFIG_KEYS = {
-    providers: {
-        nested: true,
-        knownFields: ["baseUrl", "apiKey"],
-    },
-    models: {
-        nested: true,
-        knownFields: ["provider", "name"],
-    },
     agents: {
         nested: true,
         knownFields: ["command", "args"],
@@ -22,14 +16,7 @@ const VALID_CONFIG_KEYS = {
         // agentOverrides.<workflowName>.<roleName> = agentAlias (string value)
         // No knownFields — workflow/role names are user-defined
     },
-    modelOverrides: {
-        nested: true,
-        minDepth: 2,
-        // modelOverrides.<scenario> = modelAlias (string value)
-        // No knownFields — scenarios are user-defined
-    },
     defaultAgent: { nested: false },
-    defaultModel: { nested: false },
 };
 /**
  * Validate a config key path against the known schema
@@ -149,25 +136,12 @@ export function setNestedValue(obj, path, value) {
     current[lastSegment] = value;
 }
 /**
- * Deep clone and mask all apiKey values in providers section
+ * Deep clone the config. Engine config is LLM-free, so there are no apiKey
+ * fields to mask — this function is preserved as a defensive deep-clone
+ * boundary used by `cmdConfigList`.
  */
 export function maskApiKeys(config) {
-    // Deep clone
-    const cloned = JSON.parse(JSON.stringify(config));
-    // Mask apiKey values in providers
-    if (cloned.providers && typeof cloned.providers === "object") {
-        const providers = cloned.providers;
-        for (const providerName of Object.keys(providers)) {
-            const provider = providers[providerName];
-            if (provider && typeof provider === "object") {
-                const providerObj = provider;
-                if ("apiKey" in providerObj) {
-                    providerObj.apiKey = "***MASKED***";
-                }
-            }
-        }
-    }
-    return cloned;
+    return JSON.parse(JSON.stringify(config));
 }
 /**
  * List all configuration values (masks API keys)

package/dist/commands/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/commands/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAyR3C"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAsS3C"}

package/dist/commands/prompt.js

@@ -226,7 +226,17 @@ uwf thread exec <thread-id>
 uwf thread show <thread-id>
 \`\`\`
 
-If the thread reaches \`$END\` with status \`completed\`, the setup is working.
+If the thread reaches \`$END\` with status \`end\`, the setup is working.
+
+To verify suspend/resume and poke:
+
+\`\`\`bash
+# After a role yields with $status: "$SUSPEND", resume the suspended thread:
+uwf thread resume <thread-id> -p "Additional context for the agent"
+
+# Re-run the head step's agent with a supplementary prompt (replaces head step):
+uwf thread poke <thread-id> -p "Try again with this hint"
+\`\`\`
 
 ## Scenario B: Upgrade from Previous Version
 
@@ -282,7 +292,7 @@ Check the changelog for breaking changes. Known migrations:
     resume: { role: planner, prompt: "Review previous run and continue." }
   \`\`\`
 
-Update all \`.workflow/\` and \`.workflows/\` YAML files in your projects. \`uwf workflow add\` will reject files with the old \`_\` syntax.
+Update all \`.workflows/\` and \`.workflow/\` YAML files in your projects. \`uwf workflow add\` will reject files with the old \`_\` syntax.
 
 - **v0.2.1**: \`$status: { enum: [value] }\` → \`$status: { const: "value" }\`. The validator no longer accepts \`enum\` for \`$status\`. Update all workflow YAML files:
   \`\`\`yaml
@@ -295,6 +305,9 @@ Update all \`.workflow/\` and \`.workflows/\` YAML files in your projects. \`uwf
   # For multi-exit, use oneOf with const (unchanged)
   \`\`\`
 
+- **v0.4.0**: Thread status \`completed\` → \`end\`. Update scripts that filter \`--status completed\` to use \`--status end\`. Legacy on-disk \`status: completed\` is normalized to \`end\` on read.
+- **v0.4.0**: \`$SUSPEND\` is now an engine-level coroutine yield, not a graph target. Workflows that routed to \`role: "$SUSPEND"\` must emit \`$status: "$SUSPEND"\` with a \`reason\` from the role output instead. The thread becomes \`suspended\`; continue with \`uwf thread resume\`.
+
 ### Step 4 — Verify
 
 \`\`\`bash

package/dist/commands/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAEhC,yEAAyE;AACzE,2FAA2F;AAC3F,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzC,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;AAEtC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAwE+B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAyIlB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsE3C,CAAC;AACF,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAEhC,yEAAyE;AACzE,2FAA2F;AAC3F,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzC,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;AAEtC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAwE+B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAmJlB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyE3C,CAAC;AACF,CAAC"}

package/dist/commands/setup.d.ts

@@ -1,18 +1,6 @@
 import { createInterface } from "node:readline/promises";
-import type { Result } from "@united-workforce/util";
-/**
- * Send a minimal chat completion request to verify the model is reachable.
- * Returns ok on 2xx, error with reason string otherwise.
- */
-export declare function validateModel(baseUrl: string, apiKey: string, model: string): Promise<Result<void, string>>;
-/** Look up the base URL for a preset provider name. Returns null if not a preset. */
-export declare function resolvePresetBaseUrl(providerName: string): string | null;
-type SetupArgs = {
-    provider: string;
-    baseUrl: string;
-    apiKey: string;
-    model: string;
-    agent?: string | undefined;
+export type SetupArgs = {
+    agent: string;
     storageRoot: string;
 };
 /**
@@ -32,22 +20,6 @@ export declare function _discoverAgents(): Promise<string[]>;
 export declare function _isTerminator(c: string): boolean;
 /** Returns true for DEL or backspace. */
 export declare function _isBackspace(c: string): boolean;
-type ProviderEntry = {
-    name: string;
-    label: string;
-    baseUrl: string;
-};
-/** Prints the numbered provider list and custom option to stdout. */
-export declare function _printProviderMenu(providers: readonly ProviderEntry[]): void;
-/** Resolves a numeric choice string to a preset provider, or null for custom/invalid. */
-export declare function _resolveProviderChoice(choice: string, providers: readonly ProviderEntry[]): {
-    providerName: string;
-    baseUrl: string;
-} | null;
-/** Resolves numeric index or literal model name to a model string. */
-export declare function _resolveModelChoice(input: string, models: string[]): string;
-/** Prints the multi-column model list to stdout. */
-export declare function _printModelMenu(models: string[], termCols: number): void;
 /** Extract short agent name from binary name: uwf-claude-code → claude-code */
 export declare function _agentNameFromBinary(binary: string): string;
 /** Prints numbered agent list to stdout. */
@@ -57,24 +29,20 @@ export declare function _printAgentMenu(agents: string[]): void;
  * Returns short agent name (e.g. "hermes", "claude-code").
  */
 export declare function _promptAgentSelection(rl: ReturnType<typeof createInterface>): Promise<string>;
-type ValidationResult = {
-    ok: boolean;
-    error: string | null;
-};
-/** Prints the model validation result to stdout. */
-export declare function _printValidationResult(validation: ValidationResult): void;
 /**
  * Check if the configured adapter binary (and its dependencies) are in PATH.
  * Returns warnings array — empty means all good.
  */
 export declare function _checkAdapterAvailability(agentName: string): string[];
 /**
- * Non-interactive setup. All required args provided via CLI flags.
+ * Non-interactive setup. Engine config is LLM-free — only writes
+ * agents + defaultAgent. LLM provider/model configuration lives in
+ * config.yaml under `providers` and `models`.
  */
 export declare function cmdSetup(args: SetupArgs): Promise<Record<string, unknown>>;
 /**
- * Interactive setup — prompts user for provider, API key, model.
+ * Interactive setup — prompts the user only for the default agent. LLM
+ * configuration lives in config.yaml under `providers` and `models`.
  */
 export declare function cmdSetupInteractive(storageRoot: string): Promise<Record<string, unknown>>;
-export {};
 //# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA2BF;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQxE;AA0BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQzD;AAkBD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAcD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAStD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,CAoCjB;AA+BD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBrE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BhF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsB/F"}

package/dist/commands/setup.js

@@ -4,73 +4,6 @@ import { join } from "node:path";
 import { stdin as input, stdout as output } from "node:process";
 import { createInterface } from "node:readline/promises";
 import { parse, stringify } from "yaml";
-/**
- * Send a minimal chat completion request to verify the model is reachable.
- * Returns ok on 2xx, error with reason string otherwise.
- */
-export async function validateModel(baseUrl, apiKey, model) {
-    try {
-        const url = `${baseUrl.replace(/\/+$/, "")}/chat/completions`;
-        const res = await fetch(url, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                model,
-                messages: [{ role: "user", content: "hi" }],
-                max_tokens: 1,
-            }),
-            signal: AbortSignal.timeout(15_000),
-        });
-        if (!res.ok) {
-            return { ok: false, error: `HTTP ${res.status} ${res.statusText}` };
-        }
-        return { ok: true, value: undefined };
-    }
-    catch (err) {
-        if (err instanceof DOMException && err.name === "AbortError") {
-            return { ok: false, error: "Request timed out — model endpoint unreachable" };
-        }
-        return { ok: false, error: `Network error — could not reach endpoint (${String(err)})` };
-    }
-}
-/**
- * Preset provider list — embedded to avoid runtime YAML loading dependency.
- * Keep in sync with providers.yaml in cli.
- */
-const PRESET_PROVIDERS = [
-    // International
-    { name: "openai", label: "OpenAI", baseUrl: "https://api.openai.com/v1" },
-    { name: "xai", label: "xAI", baseUrl: "https://api.x.ai/v1" },
-    { name: "openrouter", label: "OpenRouter", baseUrl: "https://openrouter.ai/api/v1" },
-    { name: "venice", label: "Venice", baseUrl: "https://api.venice.ai/api/v1" },
-    // China
-    {
-        name: "dashscope",
-        label: "DashScope (Alibaba)",
-        baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
-    },
-    { name: "deepseek", label: "DeepSeek", baseUrl: "https://api.deepseek.com/v1" },
-    { name: "siliconflow", label: "SiliconFlow", baseUrl: "https://api.siliconflow.cn/v1" },
-    {
-        name: "volcengine",
-        label: "Volcengine (ByteDance)",
-        baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
-    },
-    { name: "kimi", label: "Kimi (Moonshot)", baseUrl: "https://api.moonshot.cn/v1" },
-    { name: "glm", label: "GLM (Zhipu AI)", baseUrl: "https://open.bigmodel.cn/api/paas/v4" },
-    { name: "stepfun", label: "StepFun", baseUrl: "https://api.stepfun.com/v1" },
-    { name: "minimax", label: "MiniMax", baseUrl: "https://api.minimax.io/v1" },
-    // Local
-    { name: "ollama", label: "Ollama (local)", baseUrl: "http://localhost:11434/v1" },
-];
-/** Look up the base URL for a preset provider name. Returns null if not a preset. */
-export function resolvePresetBaseUrl(providerName) {
-    const preset = PRESET_PROVIDERS.find((p) => p.name === providerName);
-    return preset !== undefined ? preset.baseUrl : null;
-}
 function getConfigPath(root) {
     return join(root, "config.yaml");
 }
@@ -178,66 +111,15 @@ async function _tryWhichDiscovery() {
     }
 }
 // ──────────────────────────────────────────────────────────────────────────────
-// Extracted helpers — onData closure (promptSecret)
+// Terminator/backspace helpers (kept for reuse + test coverage)
 // ──────────────────────────────────────────────────────────────────────────────
 /** Returns true for newline, carriage return, or EOF (EOT). */
 export function _isTerminator(c) {
-    return c === "\n" || c === "\r" || c === "";
+    return c === "\n" || c === "\r" || c === "\u0004";
 }
 /** Returns true for DEL or backspace. */
 export function _isBackspace(c) {
-    return c === "" || c === "\b";
-}
-/** Prints the numbered provider list and custom option to stdout. */
-export function _printProviderMenu(providers) {
-    const numWidth = String(providers.length + 1).length;
-    for (let i = 0; i < providers.length; i++) {
-        const p = providers[i];
-        if (!p)
-            continue;
-        const num = String(i + 1).padStart(numWidth);
-        console.log(`  ${num}) ${p.label.padEnd(28)} ${p.baseUrl}`);
-    }
-    const customNum = String(providers.length + 1).padStart(numWidth);
-    console.log(`  ${customNum}) Custom (enter name and URL manually)\n`);
-}
-/** Resolves a numeric choice string to a preset provider, or null for custom/invalid. */
-export function _resolveProviderChoice(choice, providers) {
-    const n = Number.parseInt(choice, 10);
-    if (Number.isNaN(n) || n < 1 || n > providers.length)
-        return null;
-    const p = providers[n - 1];
-    if (!p)
-        return null;
-    return { providerName: p.name, baseUrl: p.baseUrl };
-}
-/** Resolves numeric index or literal model name to a model string. */
-export function _resolveModelChoice(input, models) {
-    const n = Number.parseInt(input, 10);
-    if (!Number.isNaN(n) && n >= 1 && n <= models.length) {
-        return models[n - 1] ?? input;
-    }
-    return input;
-}
-/** Prints the multi-column model list to stdout. */
-export function _printModelMenu(models, termCols) {
-    const nw = String(models.length).length;
-    const maxLen = models.reduce((m, s) => Math.max(m, s.length), 0);
-    const colWidth = nw + 2 + maxLen + 4;
-    const cols = Math.max(1, Math.floor(termCols / colWidth));
-    const rows = Math.ceil(models.length / cols);
-    for (let r = 0; r < rows; r++) {
-        let line = "";
-        for (let c = 0; c < cols; c++) {
-            const idx = c * rows + r;
-            if (idx >= models.length)
-                break;
-            const num = String(idx + 1).padStart(nw);
-            const name = (models[idx] ?? "").padEnd(maxLen);
-            line += `  ${num}) ${name}  `;
-        }
-        console.log(line.trimEnd());
-    }
+    return c === "\u007f" || c === "\b";
 }
 // ──────────────────────────────────────────────────────────────────────────────
 // Agent selection prompt
@@ -302,45 +184,28 @@ export async function _promptAgentSelection(rl) {
     console.log(`  → ${name}\n`);
     return name;
 }
-/** Prints the model validation result to stdout. */
-export function _printValidationResult(validation) {
-    if (validation.ok) {
-        console.log("✓ Model verified — connection successful.\n");
-    }
-    else {
-        console.log(`\n⚠ Warning: Could not reach model — ${validation.error}`);
-        console.log("  Config saved, but you may want to try a different model or check your API key.\n");
-    }
-}
 // ──────────────────────────────────────────────────────────────────────────────
 /**
- * Merge setup args into config.yaml structure. Non-destructive — preserves existing entries.
+ * Merge setup args into config.yaml structure. Non-destructive — preserves
+ * existing entries (including agentOverrides). Engine config is LLM-free, so
+ * legacy provider/model fields are dropped on rewrite.
  */
 function mergeConfig(existing, args) {
-    const providers = (typeof existing.providers === "object" && existing.providers !== null
-        ? { ...existing.providers }
-        : {});
-    providers[args.provider] = { baseUrl: args.baseUrl, apiKey: args.apiKey };
-    const models = (typeof existing.models === "object" && existing.models !== null
-        ? { ...existing.models }
-        : {});
-    models.default = { provider: args.provider, name: args.model };
     const agents = (typeof existing.agents === "object" && existing.agents !== null
         ? { ...existing.agents }
         : {});
-    const agentName = _agentNameFromBinary(args.agent ?? "hermes");
-    // Ensure the selected agent has an entry
+    const agentName = _agentNameFromBinary(args.agent);
     if (!agents[agentName]) {
         agents[agentName] = { command: `uwf-${agentName}`, args: [] };
     }
-    return {
-        ...existing,
-        providers,
-        models,
+    const merged = {
         agents,
         defaultAgent: agentName,
-        defaultModel: existing.defaultModel ?? "default",
     };
+    if (existing.agentOverrides !== undefined) {
+        merged.agentOverrides = existing.agentOverrides;
+    }
+    return merged;
 }
 /**
  * Check if the configured adapter binary (and its dependencies) are in PATH.
@@ -368,7 +233,9 @@ export function _checkAdapterAvailability(agentName) {
     return warnings;
 }
 /**
- * Non-interactive setup. All required args provided via CLI flags.
+ * Non-interactive setup. Engine config is LLM-free — only writes
+ * agents + defaultAgent. LLM provider/model configuration lives in
+ * config.yaml under `providers` and `models`.
  */
 export async function cmdSetup(args) {
     const { storageRoot } = args;
@@ -379,178 +246,36 @@ export async function cmdSetup(args) {
     writeFileSync(configPath, stringify(merged, { indent: 2 }), "utf8");
     // Print config path to stderr (stdout is reserved for JSON output)
     console.error(`Config saved to ${configPath} ✓`);
-    // Validate model connectivity
-    const validation = await validateModel(args.baseUrl, args.apiKey, args.model);
     // Check adapter availability
-    const agentName = _agentNameFromBinary(args.agent ?? "hermes");
+    const agentName = _agentNameFromBinary(args.agent);
     const adapterWarnings = _checkAdapterAvailability(agentName);
     for (const w of adapterWarnings) {
         console.error(`⚠ ${w}`);
     }
     return {
         configPath,
-        provider: args.provider,
-        model: args.model,
         defaultAgent: merged.defaultAgent,
-        validation,
         adapterWarnings,
     };
 }
-function _handleSecretTerminator(state) {
-    if (process.stdin.isTTY)
-        process.stdin.setRawMode(state.rawWasSet);
-    process.stdin.pause();
-    process.stdin.removeListener("data", state.onData);
-    process.stdout.write("\n");
-    state.resolve(state.buf.trim());
-}
-function _handleSecretBackspace(state) {
-    if (state.buf.length > 0) {
-        state.buf = state.buf.slice(0, -1);
-        process.stdout.write("\b \b");
-    }
-}
-function _handleSecretChar(c, state) {
-    if (_isTerminator(c)) {
-        _handleSecretTerminator(state);
-        return true;
-    }
-    if (_isBackspace(c)) {
-        _handleSecretBackspace(state);
-        return false;
-    }
-    if (c === "") {
-        if (process.stdin.isTTY)
-            process.stdin.setRawMode(state.rawWasSet);
-        process.exit(130);
-    }
-    state.buf += c;
-    process.stdout.write("*");
-    return false;
-}
-/** Read a line with terminal echo disabled (for secrets). */
-async function promptSecret(label) {
-    process.stdout.write(label);
-    return new Promise((resolve) => {
-        const rawWasSet = process.stdin.isRaw;
-        if (process.stdin.isTTY) {
-            process.stdin.setRawMode(true);
-        }
-        process.stdin.resume();
-        process.stdin.setEncoding("utf8");
-        const state = { buf: "", rawWasSet, resolve, onData: () => { } };
-        state.onData = (chunk) => {
-            for (const c of chunk.toString()) {
-                if (_handleSecretChar(c, state))
-                    return;
-            }
-        };
-        process.stdin.on("data", state.onData);
-    });
-}
-/** Fetch available models from an OpenAI-compatible /models endpoint. */
-async function fetchModels(baseUrl, apiKey) {
-    try {
-        const url = `${baseUrl.replace(/\/+$/, "")}/models`;
-        const res = await fetch(url, {
-            headers: { Authorization: `Bearer ${apiKey}` },
-            signal: AbortSignal.timeout(10_000),
-        });
-        if (!res.ok)
-            return [];
-        const body = (await res.json());
-        if (!Array.isArray(body.data))
-            return [];
-        const NON_CHAT = /speech|embed|image|video|audio|ocr|rerank|tts|asr|paraformer|sambert|cosyvoice|wordart|wanx|wan2|flux|stable-diffusion|gui-/i;
-        return body.data
-            .map((m) => m.id)
-            .filter((id) => !NON_CHAT.test(id))
-            .sort();
-    }
-    catch {
-        return [];
-    }
-}
-async function _promptProviderSelection(rl) {
-    console.log("Select a provider:\n");
-    _printProviderMenu(PRESET_PROVIDERS);
-    const choice = (await rl.question(`Choose [1-${PRESET_PROVIDERS.length + 1}]: `)).trim();
-    const choiceNum = Number.parseInt(choice, 10);
-    if (Number.isNaN(choiceNum) || choiceNum < 1 || choiceNum > PRESET_PROVIDERS.length + 1) {
-        throw new Error(`Invalid choice: ${choice}`);
-    }
-    const preset = _resolveProviderChoice(choice, PRESET_PROVIDERS);
-    if (preset) {
-        const selected = PRESET_PROVIDERS[choiceNum - 1];
-        if (selected) {
-            console.log(`\n  → ${selected.label} (${selected.baseUrl})\n`);
-        }
-        return preset;
-    }
-    const providerName = (await rl.question("Provider name (e.g. my-proxy): ")).trim();
-    if (!providerName)
-        throw new Error("Provider name required");
-    const baseUrl = (await rl.question("OpenAI-compatible API base URL: ")).trim();
-    if (!baseUrl)
-        throw new Error("Base URL required");
-    return { providerName, baseUrl };
-}
-async function _promptModelSelection(rl, baseUrl, apiKey) {
-    console.log("\nFetching available models...");
-    const models = await fetchModels(baseUrl, apiKey);
-    if (models.length === 0) {
-        console.log("Could not fetch models. Enter model name manually.");
-        const model = (await rl.question("Default model (e.g. qwen-plus, gpt-4o): ")).trim();
-        if (!model)
-            throw new Error("Model required");
-        return model;
-    }
-    console.log(`\nAvailable models (${models.length}):\n`);
-    _printModelMenu(models, process.stdout.columns || 100);
-    console.log(`\nChoose a number, or type a model name directly.`);
-    const modelInput = (await rl.question(`Default model [1-${models.length}]: `)).trim();
-    if (!modelInput)
-        throw new Error("Model required");
-    return _resolveModelChoice(modelInput, models);
-}
 /**
- * Interactive setup — prompts user for provider, API key, model.
+ * Interactive setup — prompts the user only for the default agent. LLM
+ * configuration lives in config.yaml under `providers` and `models`.
  */
 export async function cmdSetupInteractive(storageRoot) {
     const rl = createInterface({ input, output });
     try {
-        console.log("Configure LLM provider for uwf workflow agents.\n");
-        const { providerName, baseUrl } = await _promptProviderSelection(rl);
-        // 2. API key
+        console.log("Configure default agent for uwf workflow.\n");
+        const agentName = await _promptAgentSelection(rl);
         rl.close();
-        const apiKey = await promptSecret("API key: ");
-        if (!apiKey)
-            throw new Error("API key required");
-        // 3. Model selection
-        const rl2 = createInterface({ input, output });
-        const model = await _promptModelSelection(rl2, baseUrl, apiKey);
-        rl2.close();
-        console.log(`  → ${providerName}/${model}\n`);
-        // 4. Agent discovery & selection
-        const rl3 = createInterface({ input, output });
-        const agentName = await _promptAgentSelection(rl3);
-        rl3.close();
-        const setupResult = await cmdSetup({
-            provider: providerName,
-            baseUrl,
-            apiKey,
-            model,
-            agent: agentName,
-            storageRoot,
-        });
-        // Show validation result
-        if (setupResult.validation && typeof setupResult.validation === "object") {
-            _printValidationResult(setupResult.validation);
-        }
+        await cmdSetup({ agent: agentName, storageRoot });
         console.log("Setup complete! Get started:\n");
-        console.log("  uwf workflow put <workflow.yaml>   Register a workflow");
-        console.log('  uwf thread start <name> -p "..."   Start a thread');
-        console.log("  uwf thread step <thread-id>        Execute next step");
+        console.log("  uwf workflow list                  List available workflows");
+        console.log("  uwf workflow add <workflow.yaml>    Register a workflow");
+        console.log('  uwf thread start <name> -p "..."    Start a thread');
+        console.log("  uwf thread exec <thread-id>         Execute next step");
+        console.log("");
+        console.log("LLM config: edit ~/.uwf/config.yaml (providers + models sections).");
         console.log("");
         return null;
     }