@mono-agent/agent-app 0.6.2 → 0.8.0

package/dist/web-command.js

@@ -1,9 +1,11 @@
+import { networkInterfaces } from "node:os";
 import { resolve } from "node:path";
 import { pruneTraceSources } from "@mono-agent/observability";
 import { startSessionWebServer } from "@mono-agent/session-web";
-import { generateBearerToken, isLoopbackHost } from "@mono-agent/agent-contracts";
+import { generateBearerToken, hostForUrl, isLoopbackHost, isWildcardHost, normalizeHostForBind, normalizeOptionalString, } from "@mono-agent/agent-contracts";
 import { resolveAppTraceRegistryDir, resolveGlobalTraceRegistryDir } from "./app-config.js";
 export const DEFAULT_WEB_PORT = 4599;
+const WEB_AUTH_TOKEN_ENV = "MONO_AGENT_WEB_AUTH_TOKEN";
 /**
  * `mono-agent web`: discover every running agent on this machine (trace-source
  * registry, the same mechanism as `mono-agent tui`) and serve the read-only
@@ -21,7 +23,15 @@ export async function runWeb(options, deps = {}) {
     const globalRegistryDir = resolveGlobalTraceRegistryDir(options.env);
     const registryDirs = dedupePaths([configuredRegistryDir, globalRegistryDir]);
     await Promise.all(registryDirs.map((registryDir) => pruneTraceSources({ registryDir })));
-    const authToken = requiresServerAuth(options.host) ? generateBearerToken() : undefined;
+    const authRequired = requiresServerAuth(options.host);
+    const interactive = deps.interactive ?? process.stdout.isTTY === true;
+    const configuredAuthToken = normalizeOptionalString(options.env.MONO_AGENT_WEB_AUTH_TOKEN);
+    if (authRequired && configuredAuthToken === undefined && !interactive) {
+        stderr.write(`Non-interactive non-loopback web serving requires ${WEB_AUTH_TOKEN_ENV}; refusing to generate a bearer secret into logs.\n`);
+        return 1;
+    }
+    const authToken = configuredAuthToken ?? (authRequired ? generateBearerToken() : undefined);
+    const generatedAuthToken = authToken !== undefined && configuredAuthToken === undefined;
     const port = options.port ?? DEFAULT_WEB_PORT;
     const startServer = deps.startServer ?? startSessionWebServer;
     let handle;
@@ -41,19 +51,38 @@ export async function runWeb(options, deps = {}) {
         stderr.write(`mono-agent web failed to start: ${error instanceof Error ? error.message : String(error)}\n`);
         return 1;
     }
-    const browserUrl = authToken === undefined ? handle.url : withAuthToken(handle.url, authToken);
-    stdout.write(`mono-agent web  →  ${browserUrl}\n`);
+    const wildcardBind = isWildcardUrl(handle.url)
+        || (handle.boundAddress !== undefined && isWildcardHost(handle.boundAddress));
+    const networkAddresses = wildcardBind
+        ? bestEffortNetworkAddresses(deps.discoverNetworkAddresses)
+        : [];
+    const advertisedUrls = resolveAdvertisedUrls(handle.url, networkAddresses, handle.boundAddress);
+    const primaryUrl = advertisedUrls[0]?.url ?? handle.url;
+    const mayPrintConfiguredToken = configuredAuthToken !== undefined
+        && options.showAuthUrl === true
+        && interactive;
+    const printableToken = generatedAuthToken || mayPrintConfiguredToken ? authToken : undefined;
+    printAdvertisedUrls(stdout, advertisedUrls, printableToken);
+    if (configuredAuthToken !== undefined && printableToken === undefined) {
+        stdout.write(`Authentication: ${WEB_AUTH_TOKEN_ENV} is configured (token redacted).\n`);
+    }
+    if (configuredAuthToken !== undefined && options.showAuthUrl === true && !mayPrintConfiguredToken) {
+        stderr.write("--show-auth-url was ignored because stdout is not an interactive terminal.\n");
+    }
     stdout.write(`Watching ${registryDirs.length} registr${registryDirs.length === 1 ? "y" : "ies"} for agents. Press Ctrl-C to stop.\n`);
-    stdout.write(`${reverseProxyHint(handle.url)}\n`);
-    stdout.write(`${reachabilityHint(handle.url)}\n`);
-    if (options.open ?? true) {
+    stdout.write(`${reverseProxyHint(primaryUrl)}\n`);
+    stdout.write(`${reachabilityHint(handle.url, handle.boundAddress)}\n`);
+    if ((options.open ?? true) && authToken === undefined) {
         try {
-            (deps.openUrl ?? openInBrowser)(browserUrl);
+            (deps.openUrl ?? openInBrowser)(primaryUrl);
         }
         catch {
             // Best-effort: a headless host without a browser is fine — the URL is printed.
         }
     }
+    else if ((options.open ?? true) && authToken !== undefined) {
+        stdout.write("Browser launch skipped in authenticated mode so the bearer token never enters process arguments.\n");
+    }
     deps.onReady?.(handle);
     await (deps.waitForShutdown ?? waitForSignal)();
     await handle.stop();
@@ -61,12 +90,10 @@ export async function runWeb(options, deps = {}) {
     return 0;
 }
 /**
- * A one-line hint about who can reach the server and how to expose it over a
- * tailnet. Loopback (default) → recommend `tailscale serve` (adds HTTPS + a
- * MagicDNS name, keeping the PWA installable). Non-loopback → note it is already
- * reachable over the LAN/tailnet at this port.
+ * A one-line hint about who can reach the server. Direct HTTP never depends on
+ * Tailscale Serve; Serve is only an optional HTTPS/PWA-installability layer.
  */
-function reachabilityHint(url) {
+function reachabilityHint(url, boundAddress) {
     let port = "";
     let host = "";
     try {
@@ -77,10 +104,11 @@ function reachabilityHint(url) {
     catch {
         /* leave blank */
     }
-    if (host.length > 0 && !isLoopbackHost(host)) {
-        return "Bound non-loopback: reachable over your LAN/Tailnet at this port (use the machine's Tailscale IP or MagicDNS name). For HTTPS + a PWA-installable URL, prefer `tailscale serve` instead.";
+    const effectiveHost = boundAddress ?? host;
+    if (effectiveHost.length > 0 && !isLoopbackHost(effectiveHost)) {
+        return "Bound non-loopback: direct HTTP is available over your LAN/Tailnet at the URLs above. Tailscale Serve is optional and only needed for HTTPS + installable/offline PWA behavior.";
     }
-    return `Loopback only. To reach it over Tailscale with HTTPS + your MagicDNS name (keeps the PWA installable): tailscale serve --bg ${port || "<port>"}`;
+    return `Loopback only. Re-run with --host 0.0.0.0 --allow-non-loopback for direct LAN/Tailnet HTTP. Tailscale Serve is optional for HTTPS + installable/offline PWA behavior (port ${port || "<port>"}).`;
 }
 function reverseProxyHint(url) {
     let target = url;
@@ -102,9 +130,138 @@ function requiresServerAuth(host) {
 }
 function withAuthToken(url, token) {
     const parsed = new URL(url);
-    parsed.searchParams.set("token", token);
+    const fragment = new URLSearchParams(parsed.hash.startsWith("#") ? parsed.hash.slice(1) : parsed.hash);
+    fragment.set("token", token);
+    parsed.hash = fragment.toString();
     return parsed.toString();
 }
+function printAdvertisedUrls(stdout, urls, authToken) {
+    const printable = urls.map((entry) => ({
+        ...entry,
+        url: authToken === undefined ? entry.url : withAuthToken(entry.url, authToken),
+    }));
+    const primary = printable[0];
+    if (primary === undefined) {
+        return;
+    }
+    stdout.write(`mono-agent web  →  ${primary.url}\n`);
+    for (const entry of printable.slice(1)) {
+        stdout.write(`${entry.label.padEnd(9)} →  ${entry.url}\n`);
+    }
+}
+function resolveAdvertisedUrls(url, networkAddresses, boundAddress) {
+    const requestedWildcard = isWildcardUrl(url) ? new URL(url).hostname : undefined;
+    const actualWildcard = boundAddress !== undefined && isWildcardHost(boundAddress)
+        ? boundAddress
+        : undefined;
+    if (requestedWildcard === undefined && actualWildcard === undefined) {
+        return [{ label: isLoopbackUrl(url) ? "Loopback" : "Web", url }];
+    }
+    const wildcardHost = requestedWildcard ?? actualWildcard ?? new URL(url).hostname;
+    const loopbackHost = loopbackForWildcardHost(wildcardHost);
+    const urls = [{ label: "Loopback", url: replaceUrlHost(url, loopbackHost) }];
+    for (const entry of networkAddresses) {
+        urls.push({
+            label: entry.kind === "tailscale" ? "Tailscale" : "LAN",
+            url: replaceUrlHost(url, entry.address),
+        });
+    }
+    return urls;
+}
+function loopbackForWildcardHost(host) {
+    const normalized = normalizeHostForBind(host).toLowerCase();
+    if (normalized === "0.0.0.0") {
+        return "127.0.0.1";
+    }
+    try {
+        const canonical = new URL(`http://[${normalized}]/`).hostname.slice(1, -1);
+        if (canonical === "::ffff:0:0") {
+            return "127.0.0.1";
+        }
+    }
+    catch {
+        // isWildcardHost already validated the caller; fall through defensively.
+    }
+    return "::1";
+}
+function replaceUrlHost(url, host) {
+    const parsed = new URL(url);
+    parsed.hostname = hostForUrl(host);
+    return parsed.toString();
+}
+function isWildcardUrl(url) {
+    try {
+        const host = new URL(url).hostname;
+        return isWildcardHost(host);
+    }
+    catch {
+        return false;
+    }
+}
+function isLoopbackUrl(url) {
+    try {
+        return isLoopbackHost(new URL(url).hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function bestEffortNetworkAddresses(injected) {
+    try {
+        return dedupeNetworkAddresses(injected?.() ?? discoverNetworkAddresses());
+    }
+    catch {
+        return [];
+    }
+}
+function discoverNetworkAddresses() {
+    const addresses = [];
+    for (const interfaces of Object.values(networkInterfaces())) {
+        for (const info of interfaces ?? []) {
+            if (info.internal || info.family !== "IPv4") {
+                continue;
+            }
+            const kind = classifyIpv4Address(info.address);
+            if (kind !== undefined) {
+                addresses.push({ address: info.address, kind });
+            }
+        }
+    }
+    return addresses;
+}
+function classifyIpv4Address(address) {
+    const octets = address.split(".").map((part) => Number.parseInt(part, 10));
+    if (octets.length !== 4 || octets.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) {
+        return undefined;
+    }
+    const [first = -1, second = -1] = octets;
+    if (first === 100 && second >= 64 && second <= 127) {
+        return "tailscale";
+    }
+    if (first === 10
+        || (first === 172 && second >= 16 && second <= 31)
+        || (first === 192 && second === 168)) {
+        return "lan";
+    }
+    return undefined;
+}
+function dedupeNetworkAddresses(addresses) {
+    const seen = new Set();
+    return [...addresses]
+        .filter((entry) => {
+        if (seen.has(entry.address)) {
+            return false;
+        }
+        seen.add(entry.address);
+        return true;
+    })
+        .sort((left, right) => {
+        if (left.kind !== right.kind) {
+            return left.kind === "lan" ? -1 : 1;
+        }
+        return left.address.localeCompare(right.address);
+    });
+}
 /** Resolve + dedupe registry dirs, preserving precedence order. */
 function dedupePaths(dirs) {
     const seen = new Set();

package/dist/web-command.js.map

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

package/dist/wizard/answers.d.ts

@@ -1,15 +1,30 @@
-import type { MonoAgentConfigJson } from "@mono-agent/config";
+import { type MonoAgentConfigJson, type RouteSafetyMode } from "@mono-agent/config";
 import { type CapabilityModule, type GeneratedFile, type ModuleInputValues, type ModuleValidateExpectation } from "../modules/index.js";
 /**
  * The complete set of choices the wizard (or a preset) makes. This is the single
  * input to {@link composeWizardPlan}: everything the composer needs to emit a full
  * `mono-agent.config.json`, `.env.example`, and follow-up files is derived from it.
  */
+export interface WizardFallback {
+    readonly model: string;
+    readonly effort?: string;
+}
 export interface WizardAnswers {
+    /** Public display identity. Omitted only by legacy/programmatic callers. */
+    readonly name?: string;
+    /** Concise role statement used to generate the initial Identity. */
+    readonly purpose?: string;
     readonly model: string;
-    readonly fallbackModels: readonly string[];
-    /** Optional runtime reasoning effort (`runtime.effort`), omitted for default provider behavior. */
+    /** Optional primary-route effort; omitted means provider default. */
     readonly effort?: string;
+    /** Canonical ordered fallback routes; omitted effort means provider default. */
+    readonly fallbacks: readonly WizardFallback[];
+    /**
+     * Deprecated compatibility input. {@link defaultAnswers} converts these to
+     * canonical routes, inheriting the legacy global effort when it is present.
+     */
+    readonly fallbackModels?: readonly string[];
+    readonly routeSafety: RouteSafetyMode;
     /** Channel module ids, e.g. `["channel:webhook","channel:telegram"]`. */
     readonly channels: readonly string[];
     /** Memory module id, or `undefined` for no memory section. */
@@ -35,6 +50,7 @@ export interface SecretChecklistItem {
     readonly label: string;
     readonly envVar: string;
     readonly description: string;
+    readonly required: boolean;
 }
 /**
  * The single artifact of config generation: the JSON to write (with `$schema`),
@@ -51,6 +67,13 @@ export interface WizardPlan {
     readonly validateExpectations: readonly ModuleValidateExpectation[];
     readonly warnings: readonly string[];
 }
+/**
+ * Every model/service reference that provider setup must account for. Runtime
+ * refs come first, followed by memory-owned refs in execution order. Local
+ * memory services use synthetic Pi refs so the existing setup planner can run
+ * the matching Ollama/LM Studio preflight without learning a second shape.
+ */
+export declare function referencedSetupModelRefs(plan: WizardPlan): readonly string[];
 /**
  * The recommended `allowedTools` for these answers: the read-only safe defaults
  * plus every selected module's `recommendedTools`, deduped and ordered by the
@@ -61,7 +84,7 @@ export declare function recommendedToolSelection(answers: WizardAnswers): readon
  * The tools this agent auto-provisions regardless of `tools.allowedTools` — the
  * "always on" set the wizard surfaces so the operator understands they are NOT gated
  * by the allow-list choice. Today that is `MemoryRecall` when the memory tier enables
- * recall (journal/bujo/supermemory). `ReadSkill` (skills configured) and MCP-server
+ * recall (lite/journal/bujo/supermemory). `ReadSkill` (skills configured) and MCP-server
  * tools are also always-on when present, but the basic wizard authors neither, so they
  * never appear here.
  */
@@ -74,6 +97,10 @@ export declare function alwaysOnTools(answers: WizardAnswers): readonly string[]
  * verbatim: `["*"]`, a specific list, or `[]` (the chat-only case).
  */
 export declare function defaultAnswers(overrides?: Partial<WizardAnswers>): WizardAnswers;
+/** Canonicalize old answer objects at the single composition boundary. */
+export declare function effectiveFallbacks(answers: WizardAnswers): readonly WizardFallback[];
+/** Folder basenames become readable public identities without affecting paths. */
+export declare function humanizeAgentName(dirBasename: string): string;
 /** Overrides for one module: the shared model plus its non-secret input values. */
 export declare function moduleOverrides(module: CapabilityModule, answers: WizardAnswers): Record<string, string | undefined>;
 /**

package/dist/wizard/answers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../src/wizard/answers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAKL,KAAK,gBAAgB,EAIrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAE/B,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,mGAAmG;IACnG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACpE;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAiDD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAQlF;AAyBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAMvE;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAIhF;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAYpH;AAkCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,UAAU,CAqEzF"}
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../src/wizard/answers.ts"],"names":[],"mappings":"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"}

package/dist/wizard/answers.js

@@ -1,7 +1,60 @@
+import { MAX_AGENT_NAME_LENGTH, } from "@mono-agent/config";
 import { monoAgentConfigWithSchema } from "../config-reference.js";
-import { ADAPTER_SEND_TOOL_NAMES, ALLOW_ALL_TOOLS, baseConfig, BUILTIN_TOOL_NAMES, DEFAULT_MODEL, DEFAULT_SAFE_TOOLS, findModule, resolveModuleInputs, } from "../modules/index.js";
-/** Tools ordered canonically: built-ins first, then adapter send tools. */
-const ORDERED_TOOL_NAMES = [...BUILTIN_TOOL_NAMES, ...ADAPTER_SEND_TOOL_NAMES];
+import { ADAPTER_SEND_TOOL_NAMES, APP_TOOL_NAMES, ALLOW_ALL_TOOLS, baseConfig, BUILTIN_TOOL_NAMES, DEFAULT_MODEL, DEFAULT_SAFE_TOOLS, findModule, resolveModuleInputs, } from "../modules/index.js";
+import { managedProjectSkillFiles } from "../project-skills.js";
+/**
+ * Every model/service reference that provider setup must account for. Runtime
+ * refs come first, followed by memory-owned refs in execution order. Local
+ * memory services use synthetic Pi refs so the existing setup planner can run
+ * the matching Ollama/LM Studio preflight without learning a second shape.
+ */
+export function referencedSetupModelRefs(plan) {
+    const refs = [];
+    const seen = new Set();
+    const add = (value) => {
+        if (typeof value === "string" && value.length > 0 && !seen.has(value)) {
+            seen.add(value);
+            refs.push(value);
+        }
+    };
+    add(plan.configJson.runtime?.model);
+    for (const fallback of plan.configJson.runtime?.fallbacks ?? []) {
+        add(fallback.model);
+    }
+    // A hand-authored legacy plan can still enter this helper; generated plans
+    // always use the canonical structured form.
+    for (const fallback of plan.configJson.runtime?.fallbackModels ?? []) {
+        add(fallback);
+    }
+    const memory = plan.configJson.memory;
+    if (memory?.llm?.provider === "agent-host") {
+        add(memory.llm.model);
+    }
+    else if (memory?.llm?.provider === "ollama" || memory?.llm?.provider === "lmstudio") {
+        add(localServiceModelRef(memory.llm.provider, memory.llm.model));
+    }
+    const embeddings = memory?.embeddings;
+    if (embeddings?.provider === "ollama" || embeddings?.provider === "lmstudio") {
+        add(localServiceModelRef(embeddings.provider, embeddings.model));
+    }
+    return refs;
+}
+/** Convert a local memory service into the model-ref shape understood by setup. */
+function localServiceModelRef(provider, model) {
+    return typeof model === "string" && model.length > 0 ? `pi:${provider}:${model}` : undefined;
+}
+/** True when a referenced backend requires credentials rather than a local service. */
+function modelRefNeedsCredentials(modelRef) {
+    return modelRef.startsWith("codex:")
+        || modelRef.startsWith("claude:")
+        || (modelRef.startsWith("pi:") && !/^pi:(?:ollama|lmstudio):/u.test(modelRef));
+}
+/** Tools ordered canonically: runtime built-ins, app-owned tools, then adapter send tools. */
+const ORDERED_TOOL_NAMES = [
+    ...BUILTIN_TOOL_NAMES,
+    ...APP_TOOL_NAMES,
+    ...ADAPTER_SEND_TOOL_NAMES,
+];
 const ZERO_TOOLS_WARNING = "Zero tools selected — the agent will be chat-only: it cannot read files, run commands, or send proactive messages.";
 /**
  * The module ids selected by these answers, in composer order: auto-derived
@@ -10,7 +63,7 @@ const ZERO_TOOLS_WARNING = "Zero tools selected — the agent will be chat-only:
  */
 function selectedModuleIds(answers) {
     const ids = [];
-    const modelRefs = [answers.model, ...answers.fallbackModels];
+    const modelRefs = [answers.model, ...effectiveFallbacks(answers).map((fallback) => fallback.model)];
     if (modelRefs.some((model) => /^pi:ollama:/u.test(model))) {
         ids.push("provider:ollama");
     }
@@ -61,8 +114,8 @@ const MEMORY_RECALL_TOOL = "MemoryRecall";
 /**
  * True when the selected memory tier auto-provisions the read-only `MemoryRecall`
  * tool (its fragment sets `memory.recallTool.enabled`). Derived from the catalog so
- * it never drifts from the memory modules themselves — journal/bujo/supermemory do,
- * lite does not.
+ * it never drifts from the memory modules themselves — lite/journal/bujo/supermemory
+ * all do (Lite is FTS-only).
  */
 function memoryProvisionsRecall(memoryId) {
     if (memoryId === undefined) {
@@ -79,12 +132,12 @@ function memoryProvisionsRecall(memoryId) {
  * The tools this agent auto-provisions regardless of `tools.allowedTools` — the
  * "always on" set the wizard surfaces so the operator understands they are NOT gated
  * by the allow-list choice. Today that is `MemoryRecall` when the memory tier enables
- * recall (journal/bujo/supermemory). `ReadSkill` (skills configured) and MCP-server
+ * recall (lite/journal/bujo/supermemory). `ReadSkill` (skills configured) and MCP-server
  * tools are also always-on when present, but the basic wizard authors neither, so they
  * never appear here.
  */
 export function alwaysOnTools(answers) {
-    const tools = [];
+    const tools = ["ReadSkill"];
     if (memoryProvisionsRecall(answers.memory)) {
         tools.push(MEMORY_RECALL_TOOL);
     }
@@ -92,7 +145,8 @@ export function alwaysOnTools(answers) {
 }
 const BASE_ANSWERS = {
     model: DEFAULT_MODEL,
-    fallbackModels: [],
+    fallbacks: [],
+    routeSafety: "uniform",
     channels: ["channel:webhook"],
     // `memory` is intentionally omitted (no memory section) — with
     // exactOptionalPropertyTypes an optional key must be absent, not `undefined`.
@@ -109,9 +163,53 @@ const BASE_ANSWERS = {
  * verbatim: `["*"]`, a specific list, or `[]` (the chat-only case).
  */
 export function defaultAnswers(overrides) {
-    const merged = { ...BASE_ANSWERS, ...overrides };
+    const { fallbacks: canonicalFallbacks, fallbackModels: legacyFallbackModels, ...otherOverrides } = overrides ?? {};
+    const merged = { ...BASE_ANSWERS, ...otherOverrides };
+    const fallbacks = canonicalFallbacks !== undefined
+        ? canonicalFallbacks.map((fallback) => ({ ...fallback }))
+        : (legacyFallbackModels ?? []).map((model) => ({
+            model,
+            ...(merged.effort === undefined ? {} : { effort: merged.effort }),
+        }));
     const allowedTools = overrides?.allowedTools ?? [ALLOW_ALL_TOOLS];
-    return { ...merged, allowedTools };
+    return {
+        ...merged,
+        fallbacks,
+        // Keep a legacy input visible only when that compatibility surface was
+        // actually used. New wizard/canonical callers carry structured routes only.
+        ...(legacyFallbackModels === undefined
+            ? {}
+            : { fallbackModels: [...legacyFallbackModels] }),
+        allowedTools,
+    };
+}
+/** Canonicalize old answer objects at the single composition boundary. */
+export function effectiveFallbacks(answers) {
+    const canonical = answers.fallbacks ?? [];
+    if (canonical.length > 0 || (answers.fallbackModels?.length ?? 0) === 0) {
+        return canonical;
+    }
+    return (answers.fallbackModels ?? []).map((model) => ({
+        model,
+        ...(answers.effort === undefined ? {} : { effort: answers.effort }),
+    }));
+}
+/** Folder basenames become readable public identities without affecting paths. */
+export function humanizeAgentName(dirBasename) {
+    const words = dirBasename
+        .trim()
+        .replace(/[-_]+/gu, " ")
+        .replace(/\s+/gu, " ")
+        .split(" ")
+        .filter(Boolean);
+    const name = words
+        .map((word) => {
+        const [first = "", ...rest] = Array.from(word);
+        return `${first.toLocaleUpperCase()}${rest.join("")}`;
+    })
+        .join(" ");
+    const fallback = name.length > 0 ? name : "Mono Agent";
+    return Array.from(fallback).slice(0, MAX_AGENT_NAME_LENGTH).join("").trimEnd();
 }
 /** Overrides for one module: the shared model plus its non-secret input values. */
 export function moduleOverrides(module, answers) {
@@ -167,10 +265,12 @@ function applyFragment(config, fragment) {
  */
 export function composeWizardPlan(answers, ctx) {
     const modules = selectedModules(answers);
+    const agentName = answers.name?.trim() || humanizeAgentName(ctx.dirBasename);
+    const fallbacks = effectiveFallbacks(answers);
     const config = {
-        ...baseConfig(ctx, answers.model, answers.fallbackModels, answers.effort),
+        ...baseConfig(ctx, agentName, answers.model, fallbacks, answers.routeSafety, answers.effort),
     };
-    const files = [];
+    const files = [...managedProjectSkillFiles()];
     const secrets = [];
     const envLines = [];
     const validateExpectations = [{ sectionId: "runtime", mustBe: "ok" }];
@@ -188,12 +288,13 @@ export function composeWizardPlan(answers, ctx) {
             files.push(file);
         }
         for (const input of module.inputs) {
-            if (input.secret === true && input.envVar !== undefined) {
+            if (input.secret === true) {
                 secrets.push({
                     moduleId: module.id,
                     label: input.label,
                     envVar: input.envVar,
                     description: input.description,
+                    required: input.required === true,
                 });
             }
         }
@@ -206,6 +307,7 @@ export function composeWizardPlan(answers, ctx) {
         allowedTools: [...answers.allowedTools],
         disallowedTools: [],
     };
+    applyDefaultA2AAgentName(config, agentName);
     // The local-ollama endpoint mirrors the old recipe: only when the ollama
     // provider is present AND memory embeddings actually target ollama.
     const memory = config.memory;
@@ -218,15 +320,42 @@ export function composeWizardPlan(answers, ctx) {
     const configJson = monoAgentConfigWithSchema(config);
     const envExample = envLines.length > 0 ? `${envLines.join("\n")}\n` : undefined;
     const warnings = answers.allowedTools.length === 0 ? [ZERO_TOOLS_WARNING] : [];
-    return {
+    const planWithoutExpectations = {
         configJson,
         ...(envExample === undefined ? {} : { envExample }),
         files,
         secrets,
         selectedModules: modules,
-        validateExpectations: dedupeExpectations(validateExpectations),
+        validateExpectations: [],
         warnings,
     };
+    if (referencedSetupModelRefs(planWithoutExpectations).some(modelRefNeedsCredentials)) {
+        validateExpectations.push({
+            sectionId: "credentials",
+            mustBe: "ok",
+            note: "Authenticate every configured cloud model before describing the agent as ready.",
+        });
+    }
+    return {
+        ...planWithoutExpectations,
+        validateExpectations: dedupeExpectations(validateExpectations),
+    };
+}
+/** Use the public identity for generated A2A metadata without changing explicit user config. */
+function applyDefaultA2AAgentName(config, agentName) {
+    const channels = config.channels;
+    for (const plugin of channels?.plugins ?? []) {
+        if (typeof plugin !== "object" || plugin === null)
+            continue;
+        const entry = plugin;
+        if (entry.package !== "@mono-agent/a2a-adapter" || typeof entry.config !== "object" || entry.config === null)
+            continue;
+        const pluginConfig = entry.config;
+        const agent = typeof pluginConfig.agent === "object" && pluginConfig.agent !== null
+            ? pluginConfig.agent
+            : {};
+        pluginConfig.agent = { ...agent, name: agentName };
+    }
 }
 /** Dedupe validate expectations by `sectionId`, keeping the first occurrence. */
 function dedupeExpectations(expectations) {