@mono-agent/agent-app 0.5.1 → 0.6.0

package/dist/wizard/run.js

@@ -0,0 +1,345 @@
+import { stat } from "node:fs/promises";
+import { basename, join } from "node:path";
+import * as p from "@clack/prompts";
+import { findModule } from "../modules/catalog.js";
+import { ALLOW_ALL_TOOLS, BUILTIN_TOOL_NAMES, isAllowAllTools } from "../modules/known-tools.js";
+import { alwaysOnTools, composeWizardPlan, defaultAnswers, recommendedToolSelection, } from "./answers.js";
+import { findPreset, presetAnswers } from "./presets.js";
+import { channelSelectOptions, guard, memorySelectOptions, modelSelectOptions, presetSelectOptions, toolMultiselectOptions, WizardCancelled, } from "./prompts.js";
+const LOCAL_PROVIDER_MODEL = /^pi:(?:ollama|lmstudio):/u;
+const SANDBOXABLE_TOOLS = new Set(["Bash", "Write", "Edit"]);
+/**
+ * The interactive `init` wizard: a colourful, step-by-step flow that COLLECTS a
+ * {@link WizardAnswers} and hands it back — it never writes anything. The caller
+ * (`runInit`) does the scaffold/validate/print. Ctrl-C at any prompt unwinds
+ * through {@link WizardCancelled} to a single clean `p.cancel`, so a cancelled
+ * wizard leaves the folder untouched.
+ */
+export async function runInitWizard(ctx) {
+    try {
+        const answers = await collectAnswers(ctx);
+        return { status: "answers", answers };
+    }
+    catch (error) {
+        if (error instanceof WizardCancelled) {
+            p.cancel("Cancelled — nothing was written.");
+            return { status: "cancelled" };
+        }
+        throw error;
+    }
+}
+/** Walk the flow (preset or custom), returning the fully collected answers. */
+async function collectAnswers(ctx) {
+    p.intro("mono-agent init — let's build your agent");
+    const choice = guard(await p.select({
+        message: "Start from…",
+        options: presetSelectOptions(),
+        initialValue: "__custom__",
+    }));
+    return choice === "__custom__"
+        ? await collectCustom(ctx)
+        : await collectFromPreset(ctx, choice);
+}
+/**
+ * The full custom flow: model → channels → memory → per-module inputs → tools →
+ * sandbox (only if code tools were chosen) → observability → summary.
+ */
+async function collectCustom(ctx) {
+    const draft = draftFrom(defaultAnswers());
+    // 1. Model.
+    const model = guard(await p.select({
+        message: "Which model?",
+        options: modelSelectOptions(),
+        initialValue: "claude:claude-sonnet-4-6",
+    }));
+    draft.model = model === "__other__"
+        ? guard(await p.text({
+            message: "Model reference",
+            placeholder: "pi:ollama:llama3.1:8b",
+            validate: (v) => (v ?? "").trim().length === 0
+                ? "Enter a provider:model reference (e.g. pi:ollama:llama3.1:8b)"
+                : undefined,
+        }))
+        : model;
+    // Optional fallback chain.
+    if (guard(await p.confirm({ message: "Add fallback models?", initialValue: false }))) {
+        const raw = guard(await p.text({
+            message: "Fallback models (comma-separated)",
+            placeholder: "codex:gpt-5.5, pi:ollama:llama3.1:8b",
+        }));
+        draft.fallbackModels = splitCsv(raw);
+    }
+    // 2. Channels.
+    const channels = guard(await p.multiselect({
+        message: "How will you talk to this agent?",
+        options: channelSelectOptions(),
+        initialValues: ["channel:webhook"],
+        required: false,
+    }));
+    draft.channels = [...channels];
+    // 3. Memory (before per-module inputs so a memory module's inputs are prompted).
+    const memory = guard(await p.select({
+        message: "Should the agent remember across conversations?",
+        options: memorySelectOptions(),
+        initialValue: "",
+    }));
+    draft.memory = memory === "" ? undefined : memory;
+    // 4. Per-module (non-secret) inputs for the chosen channels + memory.
+    await promptModuleInputs(draft);
+    // 5. Tools.
+    await promptTools(draft);
+    // 6. Sandbox — only meaningful once shell/file tools are in play. Allow-all
+    // includes Bash/Write/Edit, so the sandbox question must still appear under it.
+    if (isAllowAllTools(draft.allowedTools) || draft.allowedTools.some((tool) => SANDBOXABLE_TOOLS.has(tool))) {
+        draft.sandbox = guard(await p.confirm({
+            message: "Sandbox shell/file tools? (native srt, localhost-only network, fails closed if srt is missing)",
+            initialValue: true,
+        }));
+    }
+    // 7. Observability.
+    draft.observability = guard(await p.confirm({
+        message: "Export traces to Phoenix (best-effort OTLP, sensitive data excluded)?",
+        initialValue: false,
+    }));
+    // 8. Summary + final confirm.
+    await confirmSummary(draft, ctx);
+    return toWizardAnswers(draft);
+}
+/**
+ * The preset flow: the preset fixes model/channels/memory/sandbox/observability,
+ * so we only prompt its per-module inputs, let the operator adjust tools, and
+ * confirm the summary.
+ */
+async function collectFromPreset(ctx, presetId) {
+    const preset = findPreset(presetId);
+    // presetSelectOptions only offers known ids; guard defensively regardless.
+    if (preset === undefined) {
+        throw new WizardCancelled();
+    }
+    p.log.step(`Preset: ${preset.title}`);
+    const draft = draftFrom(presetAnswers(preset));
+    await promptModuleInputs(draft);
+    await promptTools(draft);
+    await confirmSummary(draft, ctx);
+    return toWizardAnswers(draft);
+}
+/**
+ * Prompt every non-secret input of the selected channel + memory modules and store
+ * the answers into `draft.moduleInputs`. Secret inputs are never prompted — they
+ * only ever surface as `.env.example` placeholders.
+ */
+async function promptModuleInputs(draft) {
+    const moduleIds = [...draft.channels, ...(draft.memory === undefined ? [] : [draft.memory])];
+    for (const id of moduleIds) {
+        const module = findModule(id);
+        if (module === undefined) {
+            continue;
+        }
+        for (const input of module.inputs) {
+            if (input.secret === true) {
+                continue;
+            }
+            const answer = guard(await p.text({
+                message: `${module.title}: ${input.label}`,
+                placeholder: input.description,
+                ...(input.default === undefined ? {} : { defaultValue: input.default }),
+            }));
+            const trimmed = answer.trim();
+            if (trimmed.length > 0) {
+                (draft.moduleInputs[module.id] ??= {})[input.id] = trimmed;
+            }
+        }
+    }
+}
+/** Short reasons annotating each always-on tool in the framing note. */
+const ALWAYS_ON_TOOL_REASONS = {
+    MemoryRecall: "memory recall is on",
+};
+/** The always-on tool names annotated with their reason, e.g. `MemoryRecall (memory recall is on)`. */
+function alwaysOnDisplay(alwaysOn) {
+    return alwaysOn.map((tool) => {
+        const reason = ALWAYS_ON_TOOL_REASONS[tool];
+        return reason === undefined ? tool : `${tool} (${reason})`;
+    });
+}
+/**
+ * The channel-contributed send/ask tools for the enabled channels (PascalCase),
+ * minus the channel-agnostic `AskUser` (surfaced on its own line). Reuses the
+ * multiselect option builder so the framing note can never drift from the picker.
+ */
+function channelSendTools(channels) {
+    return toolMultiselectOptions(channels)
+        .slice(BUILTIN_TOOL_NAMES.length)
+        .map((option) => option.value)
+        .filter((value) => value !== "AskUser");
+}
+/**
+ * The three tool families, explained before the allow-all decision so the operator
+ * knows what "Allow all" turns on and what is unaffected by the choice:
+ *   1. Always on — auto-provisioned, NOT gated by this choice (e.g. MemoryRecall).
+ *   2. Built-ins — file/shell/web tools.
+ *   3. Channel tools — the send/ask tools that came with the channels you enabled,
+ *      plus AskUser (ask the human, any channel).
+ */
+function toolSituationFraming(draft, alwaysOn) {
+    const sends = channelSendTools(draft.channels);
+    const channelLine = sends.length > 0
+        ? `Channel tools (from the channels you enabled): ${sends.join(", ")}, plus AskUser (ask the human, any channel).`
+        : "Channel tools: AskUser (ask the human, any channel).";
+    return [
+        alwaysOn.length > 0
+            ? `Always on (auto-provisioned, not affected by this choice): ${alwaysOnDisplay(alwaysOn).join(", ")}.`
+            : "Always on (auto-provisioned): none for this setup.",
+        "Built-ins: files (Read/Write/Edit/Glob/Grep), shell (Bash), web (WebFetch/WebSearch).",
+        channelLine,
+        '"Allow all" turns on every built-in and channel tool; you can turn specific tools off later via tools.disallowedTools.',
+    ].join("\n");
+}
+/**
+ * The tools step: frame the three tool families, then a single "Allow all tools?"
+ * confirm (default yes → `["*"]`). Choosing "No" drops into the specific-tool
+ * multiselect. Always-on tools (MemoryRecall/ReadSkill/MCP) are auto-provisioned and
+ * are surfaced only for clarity — never gated by this choice.
+ */
+async function promptTools(draft) {
+    const alwaysOn = alwaysOnTools(toWizardAnswers(draft));
+    p.note(toolSituationFraming(draft, alwaysOn), "Tools");
+    const allowAll = guard(await p.confirm({
+        message: "Allow all tools? (recommended — the model can use every built-in and your channels' tools)",
+        initialValue: true,
+    }));
+    if (allowAll) {
+        draft.allowedTools = [ALLOW_ALL_TOOLS];
+        return;
+    }
+    await pickSpecificTools(draft);
+}
+/**
+ * The "choose specific tools" multiselect, pre-checking the recommended selection for
+ * the current capabilities. An empty selection loops back unless the operator confirms
+ * the chat-only warning. The final list is ordered by the option order so
+ * `tools.allowedTools` is deterministic regardless of toggle order.
+ */
+async function pickSpecificTools(draft) {
+    const options = toolMultiselectOptions(draft.channels);
+    const optionOrder = new Map(options.map((option, index) => [option.value, index]));
+    const recommended = recommendedToolSelection(toWizardAnswers(draft));
+    for (;;) {
+        const tools = guard(await p.multiselect({
+            message: "Which tools may the model call?",
+            options,
+            initialValues: [...recommended],
+            required: false,
+        }));
+        if (tools.length === 0) {
+            const proceed = guard(await p.confirm({
+                message: "⚠ Zero tools selected — the agent will be chat-only (cannot read files, run commands, or send proactively). Continue?",
+                initialValue: false,
+            }));
+            if (!proceed) {
+                continue;
+            }
+        }
+        draft.allowedTools = [...tools].sort((a, b) => (optionOrder.get(a) ?? 0) - (optionOrder.get(b) ?? 0));
+        return;
+    }
+}
+/**
+ * Render the compact plan summary and ask for the single write-time confirmation.
+ * Provider modules are implementation detail (auto-added for local models), so
+ * they are excluded from the user-facing capabilities line. A "no" cancels.
+ */
+async function confirmSummary(draft, ctx) {
+    if (LOCAL_PROVIDER_MODEL.test(draft.model)) {
+        p.note("A matching local provider block is added automatically.\nThe first turn may be slow while the model loads.", "Local model");
+    }
+    const answers = toWizardAnswers(draft);
+    const plan = composeWizardPlan(answers, {
+        dirBasename: basename(ctx.cwd),
+        skillsRootExists: await pathExists(join(ctx.cwd, "skills")),
+    });
+    const capabilities = plan.selectedModules
+        .filter((module) => module.kind !== "provider")
+        .map((module) => module.title);
+    const writes = ["mono-agent.config.json", "IDENTITY.md"];
+    if (plan.envExample !== undefined) {
+        writes.push(".env.example");
+    }
+    for (const file of plan.files) {
+        writes.push(file.path);
+    }
+    const secrets = plan.secrets.map((secret) => secret.envVar);
+    const toolsLine = isAllowAllTools(draft.allowedTools)
+        ? "all tools"
+        : draft.allowedTools.length > 0
+            ? draft.allowedTools.join(", ")
+            : "none (chat-only)";
+    const alwaysOn = alwaysOnTools(answers);
+    const lines = [
+        `Model:        ${draft.model}${draft.fallbackModels.length > 0 ? `  (fallbacks: ${draft.fallbackModels.join(", ")})` : ""}`,
+        `Capabilities: ${capabilities.length > 0 ? capabilities.join(", ") : "none"}`,
+        `Tools:        ${toolsLine}`,
+        ...(alwaysOn.length > 0 ? [`Always on:    ${alwaysOnDisplay(alwaysOn).join(", ")}`] : []),
+        `Writes:       ${writes.join(", ")}`,
+        `Secrets:      ${secrets.length > 0 ? `${secrets.join(", ")} → .env.example` : "none"}`,
+    ];
+    p.note(lines.join("\n"), "Review");
+    if (!guard(await p.confirm({ message: "Write these files?", initialValue: true }))) {
+        throw new WizardCancelled();
+    }
+}
+/** Seed a mutable draft from immutable answers (defaults or a preset). */
+function draftFrom(answers) {
+    const moduleInputs = {};
+    for (const [moduleId, values] of Object.entries(answers.moduleInputs)) {
+        const bag = {};
+        for (const [key, value] of Object.entries(values)) {
+            if (value !== undefined) {
+                bag[key] = value;
+            }
+        }
+        moduleInputs[moduleId] = bag;
+    }
+    return {
+        model: answers.model,
+        fallbackModels: [...answers.fallbackModels],
+        channels: [...answers.channels],
+        memory: answers.memory,
+        sandbox: answers.sandbox,
+        observability: answers.observability,
+        allowedTools: [...answers.allowedTools],
+        moduleInputs,
+    };
+}
+/**
+ * Freeze a draft back into {@link WizardAnswers}. `memory` is omitted entirely when
+ * undefined (exactOptionalPropertyTypes: an optional key must be absent, not
+ * `undefined`).
+ */
+function toWizardAnswers(draft) {
+    return {
+        model: draft.model,
+        fallbackModels: [...draft.fallbackModels],
+        channels: [...draft.channels],
+        ...(draft.memory === undefined ? {} : { memory: draft.memory }),
+        sandbox: draft.sandbox,
+        observability: draft.observability,
+        allowedTools: [...draft.allowedTools],
+        moduleInputs: draft.moduleInputs,
+    };
+}
+/** Split a comma-separated string into trimmed, non-empty entries. */
+function splitCsv(value) {
+    return value.split(",").map((entry) => entry.trim()).filter(Boolean);
+}
+/** True when `path` exists (a local mirror of the CLI's private helper). */
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/wizard/run.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mono-agent/agent-app",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel and traceability from one mono-agent.config.json.",
   "type": "module",
   "license": "UNLICENSED",
@@ -25,22 +25,23 @@
     "README.md"
   ],
   "dependencies": {
+    "@clack/prompts": "^1.7.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@mono-agent/agent-contracts": "0.5.1",
-    "@mono-agent/agent-harness": "0.5.1",
-    "@mono-agent/config": "0.5.1",
-    "@mono-agent/cron-adapter": "0.5.1",
-    "@mono-agent/operator-adapter": "0.5.1",
-    "@mono-agent/memory": "0.5.1",
-    "@mono-agent/memory-supermemory": "0.5.1",
-    "@mono-agent/observability": "0.5.1",
-    "@mono-agent/openai-api-adapter": "0.5.1",
-    "@mono-agent/runtime-adapter": "0.5.1",
-    "@mono-agent/session-web": "0.5.1",
-    "@mono-agent/slack-adapter": "0.5.1",
-    "@mono-agent/telegram-adapter": "0.5.1",
-    "@mono-agent/tui": "0.5.1",
-    "@mono-agent/webhook-adapter": "0.5.1",
+    "@mono-agent/agent-contracts": "0.6.0",
+    "@mono-agent/agent-harness": "0.6.0",
+    "@mono-agent/config": "0.6.0",
+    "@mono-agent/cron-adapter": "0.6.0",
+    "@mono-agent/operator-adapter": "0.6.0",
+    "@mono-agent/memory": "0.6.0",
+    "@mono-agent/memory-supermemory": "0.6.0",
+    "@mono-agent/observability": "0.6.0",
+    "@mono-agent/openai-api-adapter": "0.6.0",
+    "@mono-agent/runtime-adapter": "0.6.0",
+    "@mono-agent/session-web": "0.6.0",
+    "@mono-agent/slack-adapter": "0.6.0",
+    "@mono-agent/telegram-adapter": "0.6.0",
+    "@mono-agent/tui": "0.6.0",
+    "@mono-agent/webhook-adapter": "0.6.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/schema/mono-agent.config.schema.json

@@ -482,7 +482,9 @@
           "items": {
             "type": "string"
           },
-          "default": []
+          "default": [
+            "*"
+          ]
         },
         "disallowedTools": {
           "description": "Configures disallowedTools for the tools section.",
@@ -819,7 +821,7 @@
           "additionalProperties": false,
           "properties": {
             "host": {
-              "description": "Loopback host for the app-owned ask_user/tool-progress bridge.",
+              "description": "Loopback host for the app-owned AskUser/tool-progress bridge.",
               "examples": [
                 "127.0.0.1"
               ],
@@ -841,7 +843,7 @@
           "additionalProperties": false,
           "properties": {
             "timeoutMs": {
-              "description": "Maximum wait for one ask_user question.",
+              "description": "Maximum wait for one AskUser question.",
               "examples": [
                 600000
               ],

package/skills/mono-agent-composer/SKILL.md

@@ -59,23 +59,23 @@ Everything below runs in the user's agent folder, not the workspace.
 
 ## Composition Flow
 
-1. **Discover.** Read `references/discovery-questions.md` and resolve: runtime model + backup models, channels, identity/knowledge, skills, tools/MCP, memory strategy, sandbox, observability, and the acceptance smoke test. Then run `mono-agent recipes list` (and `mono-agent recipes show <id>`) for an executable blueprint matching the user's intent; `references/playbooks.md` is the prose companion. If a recipe fits, use it as the starting shape.
-2. **Scaffold.** In the user's folder, prefer the recipe path when one fits:
+1. **Discover.** Read `references/discovery-questions.md` and resolve: runtime model + backup models, channels, identity/knowledge, skills, tools/MCP, memory strategy, sandbox, observability, and the acceptance smoke test. Then run `mono-agent presets list` (and `mono-agent presets show <id>`) for a saved answer-set matching the user's intent; `references/playbooks.md` is the prose companion. If a preset fits, use it as the starting shape. The six presets are `starter`, `telegram-assistant`, `telegram-supermemory`, `slack-bot`, `local-private`, and `code-sandbox`; shapes with no preset (an OpenAI-API gateway, cron digest, A2A provider, Phoenix-observed, or a full multi-channel build) are hand-assembled from the capability modules and playbooks.
+2. **Scaffold.** In the user's folder, prefer the preset path when one fits — scaffold non-interactively with `--yes` (the composer is not the interactive `init` wizard):
 
    ```bash
-   mono-agent init --recipe <id> [--with slack,cron] [--dry-run]   # blueprint + .env.example + checklist
+   mono-agent init --preset <id> --yes [--with slack,cron] [--dry-run]   # preset + .env.example + checklist
    mono-agent init --model <ref> [--fallback-models <csv>] [--memory lite|journal|bujo]   # bare scaffold
    ```
 
-   Either writes a `mono-agent.config.json`, an `IDENTITY.md` that references any knowledge files already present, and `.mono-agent/` working directories (recipes also emit a `.env.example` and any extra files). `--dry-run` previews without writing. It never overwrites existing files.
+   Either writes a `mono-agent.config.json` (with `tools.allowedTools` pre-filled from the selected capabilities' recommended tools), an `IDENTITY.md` that references any knowledge files already present, and `.mono-agent/` working directories (presets also emit a `.env.example` and any extra files). `--dry-run` previews without writing. It never overwrites existing files.
 3. **Configure.** Edit `mono-agent.config.json` to match the discovery answers. Read `references/config-blueprint.md` for the full annotated config shape: every channel section, skills, MCP, memory, sandbox, and fallback models. Run `mono-agent config` to see the resolved configuration field-by-field with each value tagged `env` / `json` / `default` — the fastest way to confirm a value came from where you intended.
 4. **Validate.**
 
    ```bash
-   mono-agent validate [--recipe <id>] [--consumer <path>]
+   mono-agent validate [--preset <id>] [--consumer <path>]
    ```
 
-   Fix every `[error]` section. `[waiting]` channels are fine — they are simply not configured yet. With `--recipe`, the report also flags any capability the recipe promised that is not yet live. Re-run until the report says the config is ready.
+   Fix every `[error]` section. `[waiting]` channels are fine — they are simply not configured yet. Watch the **Tools & MCP** section: allow-all (the default) shows `All tools allowed`, an **explicit empty** `tools.allowedTools: []` reports `waiting` (the no-tools trap), and an unknown tool name in a specific allowlist is flagged with a "did you mean" hint. With `--preset`, the report also flags any capability the preset promised that is not yet live. Re-run until the report says the config is ready.
 5. **Start and smoke.**
 
    ```bash
@@ -93,7 +93,7 @@ Config-first covers one responder served over any combination of the seven chann
 - `references/discovery-questions.md` — the question sequence and which config keys each answer fills.
 - `references/config-blueprint.md` — annotated `mono-agent.config.json` covering every section, plus the folder layout and programmatic escape hatch.
 - `references/feature-coverage.md` — every framework feature mapped to config / CLI / code / dev-tooling coverage; the answer to "can the config do X?".
-- `references/playbooks.md` — end-to-end recipes (persona → config block → `init`/`validate`/`start`/smoke). Check for a matching recipe before hand-assembling a config.
+- `references/playbooks.md` — end-to-end recipes (persona → config block → `init`/`validate`/`start`/smoke). Check for a matching preset or playbook before hand-assembling a config.
 - `references/package-map.md` — which package owns what, for programmatic composition and troubleshooting.
 - `references/validation.md` — validation commands and per-channel smoke tests; read before claiming the agent works.
 

package/skills/mono-agent-composer/references/config-blueprint.md

@@ -103,10 +103,10 @@ my-agent/
     "consolidation": { "enabled": true, "cron": "0 */2 * * *" } // default: every two hours
   },
 
-  // Fail-closed tool policy + MCP servers. Deny wins; overlap is rejected.
+  // Tool policy (allow-all by default) + MCP servers. Deny wins; overlap is rejected.
   "tools": {
-    "allowedTools": ["Read", "Grep"],      // built-ins: Read, Write, Edit, Glob, Grep, Bash, WebFetch, WebSearch
-    "disallowedTools": ["Bash"],
+    "allowedTools": ["*"],                 // omit or ["*"] = all tools; ["Read","Bash"] = just those; [] = none (chat-only)
+    "disallowedTools": ["Bash"],           // deny wins even under allow-all; the escape hatch to subtract one tool
     "mcpConfigPath": "./mcp.json"          // stdio/sse/http servers; inlined for SDK runtimes
   },
 
@@ -278,12 +278,12 @@ my-agent/
 ## Lifecycle
 
 ```bash
-mono-agent recipes list                 # executable blueprints (id, risk, tags)
-mono-agent recipes show <id>            # generated config + .env.example + follow-up checklist
-mono-agent init --recipe <id> [--with slack,cron] [--dry-run]   # scaffold from a blueprint
+mono-agent presets list                 # saved answer-sets (id, risk, description)
+mono-agent presets show <id>            # generated config + .env.example + follow-up checklist
+mono-agent init --preset <id> --yes [--with slack,cron] [--dry-run]   # scaffold from a preset (non-interactive)
 mono-agent init --model claude:claude-sonnet-4-6 --fallback-models pi:ollama:gemma4:31b [--memory lite|journal|bujo]
 mono-agent config       # resolved config field-by-field, each value tagged env/json/default
-mono-agent validate [--recipe <id>] [--consumer <path>]     # per-section report; --recipe also checks the recipe's capabilities
+mono-agent validate [--preset <id>] [--consumer <path>]     # per-section report; --preset also checks the preset's capabilities
 mono-agent start        # traceability + every configured channel
 mono-agent restart      # apply config edits (config is JSON-first; restart to re-apply)
 mono-agent restart --force  # restart AND purge persisted pi sessions (fresh start; durable memory kept)

package/skills/mono-agent-composer/references/discovery-questions.md

@@ -66,15 +66,17 @@ Fills: `context.skillsRoot`, `context.selectedSkills`, optionally `context.skill
 Question:
 
 ```text
-What tools or MCP servers does the agent actually need?
+What tools does the agent need?
 
-1. No tools yet; fail closed (recommended)
-2. A small allowlist of built-in tools
-3. MCP servers from an mcp.json config file
-4. Both
+1. Allow all tools (recommended — the default: every built-in + enabled channels' send tools)
+2. Allow all, but deny a few by name (tools.disallowedTools)
+3. A specific allowlist of built-in / channel tools
+4. Chat-only, no tools (explicit tools.allowedTools: [])
+
+Plus, independently: MCP servers from an mcp.json config file?
 ```
 
-Fills: `tools.allowedTools`, `tools.disallowedTools` (denylist wins), `tools.mcpConfigPath`. Record exact tool names; do not broaden access as a convenience. To expose adapter-derived send tools, include `slack_send_message` / `telegram_send_message`; valid enabled Slack/Telegram adapter config and destination allowlists are still required.
+Fills: `tools.allowedTools`, `tools.disallowedTools` (denylist wins, even under allow-all), `tools.mcpConfigPath`. The default is allow-all (`["*"]`) — write that unless the user asks to narrow. Under allow-all the adapter-derived send tools (`SlackSendMessage` / `TelegramSendMessage` / …) are auto-available once the channel is enabled; only a **specific** allowlist needs their exact names added. Valid enabled Slack/Telegram adapter config and destination allowlists are required either way. On the pi-native runtime `disallowedTools` does not filter external MCP-server tools — to withhold one, don't declare its server.
 
 ## 6. Memory Strategy
 

package/skills/mono-agent-composer/references/feature-coverage.md

@@ -35,16 +35,16 @@ Every framework capability and how a composed agent reaches it. This table is th
 | Config-aware memory preview CLI (stats/today/show/search/top for the configured backend; local search warns and falls back to FTS-only when embeddings are down) | cli | `mono-agent memory stats\|today\|show <date>\|search <query>\|top [--limit <n>] [--json]` |
 | Memory liveness check (root writable; provider-specific Ollama checks only when embeddings/chat use Ollama; BuJo LLM config + consolidation cadence — loud warn, no silent fallback) | cli | `mono-agent validate` |
 | Host summaries appended after runs | config | `memory.writeMode: "append-host-summary"` |
-| Auto-provisioned read-only `memory_recall` tool (hybrid keyword+semantic search) exposed to the agent from the single memory config; no chat LLM | config | `config.memory.recallTool.enabled` (`MONO_AGENT_MEMORY_RECALL_TOOL_ENABLED`, default on for journal/bujo with embeddings) |
+| Auto-provisioned read-only `MemoryRecall` tool (hybrid keyword+semantic search) exposed to the agent from the single memory config; no chat LLM | config | `config.memory.recallTool.enabled` (`MONO_AGENT_MEMORY_RECALL_TOOL_ENABLED`, default on for journal/bujo with embeddings) |
 
 ## Tools, MCP, sandbox
 
 | Capability | Coverage | Where |
 | --- | --- | --- |
-| Fail-closed tool policy (empty allowlist = no tools) | auto | default |
-| Tool allow/deny lists (deny wins) | config | `tools.allowedTools`, `tools.disallowedTools` |
+| Allow-all tool policy (omitted / `["*"]` = all tools; `[]` = none) | config | default `tools.allowedTools`; the harness no-policy safety net is `failClosedToolPolicy()` |
+| Tool allow/deny lists (deny wins, even under allow-all; pi doesn't deny external MCP tools) | config | `tools.allowedTools`, `tools.disallowedTools` |
 | MCP servers (stdio/sse/http) from a JSON file | config | `tools.mcpConfigPath` |
-| Adapter-derived send tools for enabled Slack/Telegram adapters | config | `tools.allowedTools` must include `slack_send_message` / `telegram_send_message`; valid `slack.*` / `telegram.*` config and existing adapter allowlists provide credentials and destination bounds |
+| Adapter-derived send tools for enabled Slack/Telegram adapters | config | auto-available under allow-all once the channel is enabled; a **specific** `tools.allowedTools` must include `SlackSendMessage` / `TelegramSendMessage`; valid `slack.*` / `telegram.*` config and existing adapter allowlists provide credentials and destination bounds |
 | Sandbox on/off + srt engine | config | `sandbox.mode` |
 | Network policy (none/localhost/allowlist/all) | config | `sandbox.network.{mode,allowlist}` |
 | Filesystem scopes (readable/writable roots, deny-write globs) | config | `sandbox.readableRoots`, `sandbox.writableRoots`, `sandbox.denyWrite` |
@@ -78,11 +78,13 @@ Every framework capability and how a composed agent reaches it. This table is th
 | Phoenix trace viewer (OTLP exporter; local JSONL artifacts are the fallback) | config | `observability.exporters` (phoenix entry) |
 | Operator console (live chat with thinking/tool/telemetry insight, run replay, config view) | cli | `mono-agent tui [--agent <label>]`; agents serve the `tui` stream endpoint by default (`tui.enabled`, loopback) |
 | Session Recorder web PWA (read-only run browser) | cli | `mono-agent web [--host] [--port] [--no-open] [--allow-non-loopback] [--include-memory]`; consumes the default-on `live` relay and local artifacts; memory runs are opt-in |
-| Executable config blueprints (generate config + `.env.example` + checklist) | cli | `mono-agent recipes list\|show <id>`, `mono-agent init --recipe <id>` |
+| Setup presets (saved answer-sets: generate config + `.env.example` + checklist) | cli | `mono-agent presets list\|show <id>`, `mono-agent init --preset <id> --yes` (`recipes`/`--recipe` deprecated aliases) |
+| Interactive setup wizard (preset/custom; walks model→channels→memory→tools→sandbox→observability) | cli | `mono-agent init` (no flags, on a TTY; `setup` alias) |
+| Tools reporting + no-tools guardrail (allow-all → `All tools allowed`; explicit empty `allowedTools: []` → `waiting`; unknown-tool "did you mean"; send-tool/channel cross-checks) | cli | part of `mono-agent validate`/`doctor`; the wizard's tools step |
 | Resolved config view (every field tagged env/json/default) | cli | `mono-agent config` |
-| Scaffold / validate / start / install-skill | cli | `mono-agent init\|validate [--consumer <path>]\|config\|recipes\|start\|install-skill` |
-| Recipe capability check (selected recipe live?) | cli | `mono-agent validate --recipe <id>` |
+| Scaffold / validate / start / install-skill | cli | `mono-agent init\|validate [--consumer <path>]\|config\|presets\|start\|install-skill` |
+| Preset capability check (selected preset live?) | cli | `mono-agent validate --preset <id>` |
 | `.env` auto-loading | cli | automatic; `--env-file <path>` |
 | Explicit failure objects (no fake success) | auto | harness |
 | Per-request runtime options, custom memory/history stores | code | `createConfiguredAgentResponder` options |
-| Multi-agent delegation (`ask_collaborator` loopback MCP tool) | code | `@mono-agent/agent-orchestrator` |
+| Multi-agent delegation (`AskCollaborator` loopback MCP tool) | code | `@mono-agent/agent-orchestrator` |

package/skills/mono-agent-composer/references/package-map.md

@@ -51,7 +51,7 @@ Use this path when the agent needs identity, selected skills, history, and optio
 | Memory substrate (schema, migrations, FTS+vector db, RRF) | `@mono-agent/memory/store` | SQLite storage, BM25 FTS, optional vector index, hybrid recall; re-exports `MemoryStore`/`MemoryBlock`/`MemoryWriteResult` from `@mono-agent/agent-contracts` |
 | Memory engine (all tiers: lite/journal/bujo) | `@mono-agent/memory/bujo` | `BujoMemoryStore` — tier-aware: FTS recall (lite), hybrid recall + decay (journal), LLM capture/reconcile + entity graph + scheduled consolidation (bujo) |
 | Embedding providers | `@mono-agent/memory/search` | Ollama/OpenAI embedding providers used by the store subpath for vector recall |
-| Recall tool surface | `@mono-agent/agent-app` (bundled) | Auto-provisions a read-only `memory_recall` tool (hybrid keyword+semantic search) from `config.memory.recallTool.enabled`; spawns the bundled `mono-agent-memory` stdio child using the same memory root + embeddings as the in-app memory |
+| Recall tool surface | `@mono-agent/agent-app` (bundled) | Auto-provisions a read-only `MemoryRecall` tool (hybrid keyword+semantic search) from `config.memory.recallTool.enabled`; spawns the bundled `mono-agent-memory` stdio child using the same memory root + embeddings as the in-app memory |
 
 Mono-agent selected skills are not auto-selected by description. The host chooses `context.selectedSkills`, and the harness loads those exact bodies.
 
@@ -72,21 +72,21 @@ Use `@mono-agent/agent-harness` directly when a host needs custom prompt/runtime
 
 ## Tools And MCP Join
 
-Use `@mono-agent/agent-harness` for fail-closed tool/MCP policy normalization:
+Use `@mono-agent/agent-harness` for tool/MCP policy normalization. The **config** default is allow-all (`["*"]`); `createToolPolicy` itself does no defaulting, and the harness's no-policy safety net is `failClosedToolPolicy()` (an empty, fail-closed policy):
 
 ```ts
 import { createToolPolicy, toolPolicyToRuntimeOptions } from "@mono-agent/agent-harness";
 
 const policy = createToolPolicy({
-  allowedTools: ["Read", "Grep"],
-  disallowedTools: ["WebFetch"],
+  allowedTools: ["*"],              // ["*"] = all; ["Read","Grep"] = specific; [] = none
+  disallowedTools: ["WebFetch"],   // deny wins, even under allow-all
   mcpConfigPath: "./mcp.json",
 });
 
 const runtimeOptions = toolPolicyToRuntimeOptions(policy);
 ```
 
-Do not grant broad tool access as a fallback. If the requested task needs tools, ask for the narrow allowlist or MCP config path.
+Match the user's intent: allow-all is the recommended default. Prefer subtracting with `disallowedTools` over hand-curating an allowlist, and only narrow to a specific list when the user asks for it.
 
 ## Adapter Join