@voybio/ace-swarm 0.2.3 → 0.2.5

package/dist/tui/local-model-contract.js

@@ -28,24 +28,8 @@ function extractStatusField(statusRaw, label) {
     const match = statusRaw.match(pattern);
     return match?.[1] ? clip(oneLine(match[1])) : undefined;
 }
-function determineRole(task, preferredRole) {
-    const lowered = task.toLowerCase();
-    if (preferredRole && preferredRole !== "orchestrator") {
-        return preferredRole;
-    }
-    if (/\b(doc|docs|readme|changelog|guide)\b/.test(lowered))
-        return "docs";
-    if (/\b(test|qa|verify|regression|assert|review)\b/.test(lowered))
-        return "qa";
-    if (/\b(ui|design|layout|ux|css|frontend)\b/.test(lowered))
-        return "ui";
-    if (/\b(research|investigate|compare|audit|analyze|analysis)\b/.test(lowered))
-        return "research";
-    if (/\b(spec|schema|contract|interface)\b/.test(lowered))
-        return "spec";
-    if (/\b(build|implement|fix|patch|code|refactor|wire|edit)\b/.test(lowered))
-        return "coders";
-    return "orchestrator";
+function determineRole(preferredRole) {
+    return preferredRole?.trim() || "orchestrator";
 }
 export function shouldSynthesizeShortPlan(task) {
     const lowered = task.toLowerCase();
@@ -103,17 +87,15 @@ export function buildAcePreflightPacket(input) {
                 ? "thin"
                 : "healthy";
     const preflightState = blockers.length > 0 ? "blocked" : warnings.length > 0 || blockedByStatus ? "attention_required" : "ready";
-    const recommendedRole = determineRole(input.task, input.preferredRole);
+    const recommendedRole = determineRole(input.preferredRole);
     const synthesize = shouldSynthesizeShortPlan(input.task);
     const recommendedNextAction = preflightState === "blocked"
         ? "validate_framework"
         : synthesize
             ? "run_orchestrator"
-            : quartetHealth !== "healthy"
-                ? "recall_context"
-                : recommendedRole === "orchestrator"
-                    ? "route_task"
-                    : "recall_context";
+            : recommendedRole === "orchestrator"
+                ? "run_orchestrator"
+                : "recall_context";
     return {
         session_id: input.sessionId,
         workspace_root: input.workspaceRoot,
@@ -154,7 +136,7 @@ export function buildStartupNudge(preflight, ledger) {
     const text = action === "validate_framework"
         ? "ACE state is incomplete. Run validate_framework before free-form execution."
         : action === "run_orchestrator"
-            ? "This looks multi-step. Prefer run_orchestrator over a single free-form reply."
+            ? "Start with run_orchestrator so ACE-Orchestrator can route the work."
             : action === "route_task"
                 ? "Role selection is still ambiguous. Route the task before deeper work."
                 : "Load ACE context first with recall_context before deeper work.";

package/dist/tui/provider-discovery.d.ts

@@ -14,6 +14,8 @@
  */
 export declare const DEFAULT_OLLAMA_MODEL = "llama3.1:8b";
 export declare const DEFAULT_LLAMA_CPP_MODEL = "local-model";
+export declare const LOCAL_LLM_PROVIDERS: readonly ["ollama", "llama.cpp"];
+export type LocalLlmProvider = (typeof LOCAL_LLM_PROVIDERS)[number];
 export interface ProviderDiscoveryOptions {
     workspaceRoot: string;
     cliProvider?: string;
@@ -53,6 +55,10 @@ export declare function normalizeProvider(input: string | undefined): string | u
 export declare function normalizeLocalBaseUrl(url: string | undefined): string | undefined;
 export declare function buildOpenAiCompatibleBaseUrl(baseUrl: string): string;
 export declare function inferProviderFromModel(model: string | undefined): string | undefined;
+export declare function isLocalLlmProvider(providerInput: string | undefined): providerInput is LocalLlmProvider;
+export declare function defaultModelForProvider(providerInput: string | undefined): string;
+export declare function providerEnvPrefix(providerInput: string | undefined): string;
+export declare function buildProviderDoctorCommands(providerInput: string | undefined, modelInput: string | undefined, baseUrlInput?: string): string[];
 export declare function parseJsoncLoose(raw: string): unknown;
 export declare function discoverProviderContext(options: ProviderDiscoveryOptions): ProviderDiscoveryResult;
 export declare function scanLocalModelRuntimes(options?: LocalRuntimeScanOptions): Promise<LocalRuntimeScanResult>;

package/dist/tui/provider-discovery.js

@@ -18,7 +18,14 @@ import { join, resolve } from "node:path";
 import { readStoreJsonSync } from "../store/store-snapshot.js";
 export const DEFAULT_OLLAMA_MODEL = "llama3.1:8b";
 export const DEFAULT_LLAMA_CPP_MODEL = "local-model";
-const LOCAL_RUNTIME_PROVIDER_PREFERENCE = ["ollama", "llama.cpp"];
+const DEFAULT_HOSTED_MODELS = {
+    codex: "gpt-5",
+    claude: "claude-3-7-sonnet",
+    gemini: "gemini-2.5-pro",
+    copilot: "copilot/gpt-5-mini",
+};
+export const LOCAL_LLM_PROVIDERS = ["ollama", "llama.cpp"];
+const LOCAL_RUNTIME_PROVIDER_PREFERENCE = LOCAL_LLM_PROVIDERS;
 const PROVIDER_PREFERENCE = [
     ...LOCAL_RUNTIME_PROVIDER_PREFERENCE,
     "codex",
@@ -95,12 +102,69 @@ export function inferProviderFromModel(model) {
     }
     return undefined;
 }
-function defaultModelForProvider(provider) {
-    if (provider === "ollama")
+export function isLocalLlmProvider(providerInput) {
+    const provider = normalizeProvider(providerInput);
+    return provider === "ollama" || provider === "llama.cpp";
+}
+export function defaultModelForProvider(providerInput) {
+    const provider = normalizeProvider(providerInput);
+    if (provider === "ollama" || !provider)
         return DEFAULT_OLLAMA_MODEL;
     if (provider === "llama.cpp")
         return DEFAULT_LLAMA_CPP_MODEL;
-    return `${provider}/default`;
+    return DEFAULT_HOSTED_MODELS[provider] ?? DEFAULT_HOSTED_MODELS.codex;
+}
+export function providerEnvPrefix(providerInput) {
+    const provider = normalizeProvider(providerInput);
+    if (!provider)
+        return "LLM";
+    if (provider === "llama.cpp")
+        return "LLAMA_CPP";
+    return provider.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
+}
+export function buildProviderDoctorCommands(providerInput, modelInput, baseUrlInput) {
+    const provider = normalizeProvider(providerInput) ?? "ollama";
+    const model = modelInput?.trim() || defaultModelForProvider(provider);
+    const baseUrl = normalizeLocalBaseUrl(baseUrlInput);
+    if (provider === "ollama") {
+        return [
+            "ollama serve",
+            `ollama pull ${model}`,
+            ...(baseUrl ? [`curl -s ${baseUrl}/api/tags`] : []),
+            baseUrl
+                ? `ace doctor --llm ${provider} --model ${model} --base-url ${baseUrl}`
+                : `ace doctor --llm ${provider} --model ${model} --scan`,
+        ];
+    }
+    if (provider === "llama.cpp") {
+        return [
+            "# Start llama-server separately, for example:",
+            "# llama-server -m /path/to/model.gguf --port 8080",
+            ...(baseUrl ? [`curl -s ${buildOpenAiCompatibleBaseUrl(baseUrl)}/models`] : []),
+            baseUrl
+                ? `ace doctor --llm ${provider} --model ${model} --base-url ${baseUrl}`
+                : `ace doctor --llm ${provider} --model ${model} --scan`,
+        ];
+    }
+    if (provider === "codex") {
+        return [
+            "export OPENAI_API_KEY=<token>",
+            ...(baseUrl ? [`export OPENAI_BASE_URL=${baseUrl}`] : []),
+            `ace doctor --llm ${provider} --model ${model}${baseUrl ? ` --base-url ${baseUrl}` : ""}`,
+        ];
+    }
+    if (provider === "copilot") {
+        return [
+            "gh auth login  # or export GITHUB_TOKEN=<token>",
+            `ace doctor --llm ${provider} --model ${model}`,
+        ];
+    }
+    const prefix = providerEnvPrefix(provider);
+    return [
+        `export ${prefix}_BASE_URL=${baseUrl ?? "<openai-compatible-base-url>"}`,
+        `export ${prefix}_API_KEY=<token>`,
+        `ace doctor --llm ${provider} --model ${model}${baseUrl ? ` --base-url ${baseUrl}` : ""}`,
+    ];
 }
 function looksLikeModel(value) {
     const v = value.trim().toLowerCase();
@@ -326,6 +390,8 @@ export function discoverProviderContext(options) {
         process.env.LLM_MODEL?.trim() ||
         undefined;
     const envGenericBaseUrl = normalizeLocalBaseUrl(process.env.ACE_TUI_BASE_URL ?? process.env.ACE_LLM_BASE_URL ?? process.env.LLM_BASE_URL);
+    const openAiBaseUrl = normalizeLocalBaseUrl(process.env.OPENAI_BASE_URL);
+    const genericBaseUrl = envGenericBaseUrl ?? openAiBaseUrl;
     const cliProvider = normalizeProvider(options.cliProvider);
     const cliModel = options.cliModel?.trim() || undefined;
     const cliBaseUrl = normalizeLocalBaseUrl(options.cliBaseUrl ?? options.cliOllamaUrl);
@@ -355,9 +421,18 @@ export function discoverProviderContext(options) {
                 inferProviderFromModel(profileModel);
     }
     if (!provider) {
-        provider = "ollama";
-        if (settingHints.length > 0) {
-            notes.push("runtime_default=ollama (VS Code model hints are discovery-only)");
+        const genericOpenAiSignals = Boolean(genericBaseUrl) ||
+            Boolean(process.env.OPENAI_API_KEY?.trim()) ||
+            Boolean(process.env.CODEX_API_KEY?.trim());
+        if (genericOpenAiSignals) {
+            provider = "codex";
+            notes.push("runtime_default=codex (generic OpenAI-compatible env detected)");
+        }
+        else {
+            provider = "ollama";
+            if (settingHints.length > 0) {
+                notes.push("runtime_default=ollama (VS Code model hints are discovery-only)");
+            }
         }
     }
     setProviderBaseUrl(providerBaseUrls, profileProvider, profileBaseUrl);
@@ -366,8 +441,8 @@ export function discoverProviderContext(options) {
     if (!providerBaseUrls.has(provider) && cliBaseUrl) {
         providerBaseUrls.set(provider, cliBaseUrl);
     }
-    if (!providerBaseUrls.has(provider) && envGenericBaseUrl) {
-        providerBaseUrls.set(provider, envGenericBaseUrl);
+    if (!providerBaseUrls.has(provider) && genericBaseUrl) {
+        providerBaseUrls.set(provider, genericBaseUrl);
     }
     if (!providerBaseUrls.has(provider) && profileBaseUrl && profileProvider === provider) {
         providerBaseUrls.set(provider, profileBaseUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voybio/ace-swarm",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "ACE Framework MCP server and CLI — single-file ACEPACK state, local-model serving, agent orchestration, and host compliance enforcement.",
   "type": "module",
   "main": "dist/index.js",