@mono-agent/agent-app 0.5.0 → 0.6.0

package/dist/wizard/from-flags.js

@@ -0,0 +1,44 @@
+import { defaultAnswers } from "./answers.js";
+import { findPreset } from "./presets.js";
+/** Channels `mono-agent init --with <csv>` can switch on, by their short flag name. */
+export const WITH_CHANNELS = ["telegram", "slack", "webhook", "openaiApi", "cron"];
+/** True when `value` is a `--with` channel flag name. */
+export function isWithChannel(value) {
+    return WITH_CHANNELS.includes(value);
+}
+/** `--with <channel>` flag → the capability-module id that enables it. */
+const WITH_CHANNEL_MODULE_ID = {
+    telegram: "channel:telegram",
+    slack: "channel:slack",
+    webhook: "channel:webhook",
+    openaiApi: "channel:openai-api",
+    cron: "channel:cron",
+};
+/**
+ * Map the non-interactive `init` flags (and an optional preset) onto full wizard
+ * answers, running once through the single {@link defaultAnswers} path so
+ * `allowedTools` is recomputed from the final capability selection. A preset seeds
+ * the base answers (its partial, so it never pins tools); each explicit flag
+ * overrides that; `--with` channels are unioned onto the preset/default channels.
+ * The caller resolves an unknown `presetId` and errors before calling this.
+ */
+export function answersFromCli(args) {
+    const basePartial = args.presetId === undefined
+        ? {}
+        : findPreset(args.presetId)?.answers ?? {};
+    const channels = new Set(basePartial.channels ?? defaultAnswers().channels);
+    for (const channel of args.withChannels ?? []) {
+        if (isWithChannel(channel)) {
+            channels.add(WITH_CHANNEL_MODULE_ID[channel]);
+        }
+    }
+    const memory = args.memory === undefined ? basePartial.memory : `memory:${args.memory}`;
+    return defaultAnswers({
+        ...basePartial,
+        ...(args.model === undefined ? {} : { model: args.model }),
+        ...(args.fallbackModels === undefined ? {} : { fallbackModels: args.fallbackModels }),
+        channels: [...channels],
+        ...(memory === undefined ? {} : { memory }),
+    });
+}
+//# sourceMappingURL=from-flags.js.map

package/dist/wizard/from-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-flags.js","sourceRoot":"","sources":["../../src/wizard/from-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC;AAG5F,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,0EAA0E;AAC1E,MAAM,sBAAsB,GAAgC;IAC1D,QAAQ,EAAE,kBAAkB;IAC5B,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,SAAS,EAAE,oBAAoB;IAC/B,IAAI,EAAE,cAAc;CACrB,CAAC;AAaF;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,MAAM,WAAW,GAA2B,IAAI,CAAC,QAAQ,KAAK,SAAS;QACrE,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;IAE7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,WAAW,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;IAExF,OAAO,cAAc,CAAC;QACpB,GAAG,WAAW;QACd,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACrF,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/wizard/index.d.ts

@@ -0,0 +1,11 @@
+export type { ComposeContext, SecretChecklistItem, WizardAnswers, WizardPlan, } from "./answers.js";
+export { alwaysOnTools, composeWizardPlan, defaultAnswers, recommendedToolSelection } from "./answers.js";
+export type { WizardPreset } from "./presets.js";
+export { findPreset, PRESET_CATALOG, presetAnswers, presetIds, RECIPE_TO_PRESET } from "./presets.js";
+export type { AnswersFromCliArgs, WithChannel } from "./from-flags.js";
+export { answersFromCli, isWithChannel, WITH_CHANNELS } from "./from-flags.js";
+export type { WizardSelectOption } from "./prompts.js";
+export { channelSelectOptions, guard, memorySelectOptions, modelSelectOptions, presetSelectOptions, toolMultiselectOptions, WizardCancelled, } from "./prompts.js";
+export type { WizardOutcome } from "./run.js";
+export { runInitWizard } from "./run.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wizard/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE1G,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEtG,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/wizard/index.js

@@ -0,0 +1,6 @@
+export { alwaysOnTools, composeWizardPlan, defaultAnswers, recommendedToolSelection } from "./answers.js";
+export { findPreset, PRESET_CATALOG, presetAnswers, presetIds, RECIPE_TO_PRESET } from "./presets.js";
+export { answersFromCli, isWithChannel, WITH_CHANNELS } from "./from-flags.js";
+export { channelSelectOptions, guard, memorySelectOptions, modelSelectOptions, presetSelectOptions, toolMultiselectOptions, WizardCancelled, } from "./prompts.js";
+export { runInitWizard } from "./run.js";
+//# sourceMappingURL=index.js.map

package/dist/wizard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wizard/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG1G,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGtG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/wizard/presets.d.ts

@@ -0,0 +1,40 @@
+import { type WizardAnswers } from "./answers.js";
+/**
+ * A saved answer-set the wizard can start from: the opinionated blueprints that
+ * replace the old recipes. A preset is only a `Partial<WizardAnswers>` — the
+ * composer's {@link defaultAnswers} fills the rest and recomputes `allowedTools`,
+ * so there is still exactly one config-generation path.
+ */
+export interface WizardPreset {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly riskLevel: "low" | "medium" | "high";
+    /**
+     * The `docs/playbooks/<file>` this preset mirrors. Parity-checked by
+     * `src/__tests__/presets-docs-parity.test.ts`, which asserts the file exists.
+     */
+    readonly playbook?: string;
+    readonly answers: Partial<WizardAnswers>;
+    /** The recipe ids this preset supersedes, for the Task 4 cutover audit. */
+    readonly replacesRecipes?: readonly string[];
+}
+/**
+ * The six starter presets, in wizard-presentation order. Each maps to an existing
+ * playbook and records the recipes it replaces so the Task 4 cutover stays honest.
+ */
+export declare const PRESET_CATALOG: readonly WizardPreset[];
+/** Look up a preset by id, or `undefined` when unknown. */
+export declare function findPreset(id: string): WizardPreset | undefined;
+/** Every preset id, in catalog order. */
+export declare function presetIds(): readonly string[];
+/** Resolve a preset to full wizard answers via the single {@link defaultAnswers} path. */
+export declare function presetAnswers(preset: WizardPreset): WizardAnswers;
+/**
+ * Former recipe id → the preset that now supersedes it, built from each preset's
+ * `replacesRecipes`. Powers the deprecated `--recipe <id>` alias on `init`/`validate`:
+ * a mapped id resolves to its preset (with a deprecation notice); an unmapped id is
+ * treated as a retired recipe.
+ */
+export declare const RECIPE_TO_PRESET: ReadonlyMap<string, WizardPreset>;
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/wizard/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EA4DjD,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D;AAED,yCAAyC;AACzC,wBAAgB,SAAS,IAAI,SAAS,MAAM,EAAE,CAE7C;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAEjE;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAI9D,CAAC"}

package/dist/wizard/presets.js

@@ -0,0 +1,85 @@
+import { defaultAnswers } from "./answers.js";
+/**
+ * The six starter presets, in wizard-presentation order. Each maps to an existing
+ * playbook and records the recipes it replaces so the Task 4 cutover stays honest.
+ */
+export const PRESET_CATALOG = [
+    {
+        id: "starter",
+        title: "Starter (webhook smoke agent)",
+        description: "Webhook loopback, no credentials, no memory — the lowest-friction smoke agent.",
+        riskLevel: "low",
+        playbook: "webhook-automation-sync-async.md",
+        answers: {},
+        replacesRecipes: ["minimal-webhook"],
+    },
+    {
+        id: "telegram-assistant",
+        title: "Telegram assistant (BuJo memory)",
+        description: "A Telegram bot with daily-log capture + semantic recall.",
+        riskLevel: "medium",
+        playbook: "telegram-personal-assistant-bujo.md",
+        answers: { channels: ["channel:telegram"], memory: "memory:bujo" },
+        replacesRecipes: ["personal-telegram-bujo"],
+    },
+    {
+        id: "telegram-supermemory",
+        title: "Telegram assistant (Supermemory)",
+        description: "A Telegram bot backed by an external Supermemory server.",
+        riskLevel: "medium",
+        playbook: "telegram-supermemory-memory.md",
+        answers: { channels: ["channel:telegram"], memory: "memory:supermemory" },
+        replacesRecipes: ["personal-telegram-supermemory"],
+    },
+    {
+        id: "slack-bot",
+        title: "Slack team bot",
+        description: "A Socket-Mode Slack bot scoped to a channel allowlist, with the send tool.",
+        riskLevel: "medium",
+        playbook: "slack-team-bot-mcp-tools.md",
+        answers: { channels: ["channel:slack"] },
+        replacesRecipes: ["slack-team-bot"],
+    },
+    {
+        id: "local-private",
+        title: "Local private agent (Ollama)",
+        description: "Runs entirely on a local Ollama provider with journal memory — no remote calls. Light 8B default for a fast first turn.",
+        riskLevel: "low",
+        playbook: "local-only-ollama-agent.md",
+        answers: {
+            model: "pi:ollama:llama3.1:8b",
+            channels: ["channel:webhook"],
+            memory: "memory:journal",
+        },
+        replacesRecipes: ["local-ollama-private"],
+    },
+    {
+        id: "code-sandbox",
+        title: "Sandboxed code agent",
+        description: "Native srt sandbox with workspace-only FS and code tools; fails closed without srt.",
+        riskLevel: "medium",
+        playbook: "sandboxed-code-agent.md",
+        answers: { channels: ["channel:webhook"], sandbox: true },
+        replacesRecipes: ["sandboxed-code-agent"],
+    },
+];
+/** Look up a preset by id, or `undefined` when unknown. */
+export function findPreset(id) {
+    return PRESET_CATALOG.find((preset) => preset.id === id);
+}
+/** Every preset id, in catalog order. */
+export function presetIds() {
+    return PRESET_CATALOG.map((preset) => preset.id);
+}
+/** Resolve a preset to full wizard answers via the single {@link defaultAnswers} path. */
+export function presetAnswers(preset) {
+    return defaultAnswers(preset.answers);
+}
+/**
+ * Former recipe id → the preset that now supersedes it, built from each preset's
+ * `replacesRecipes`. Powers the deprecated `--recipe <id>` alias on `init`/`validate`:
+ * a mapped id resolves to its preset (with a deprecation notice); an unmapped id is
+ * treated as a retired recipe.
+ */
+export const RECIPE_TO_PRESET = new Map(PRESET_CATALOG.flatMap((preset) => (preset.replacesRecipes ?? []).map((recipeId) => [recipeId, preset])));
+//# sourceMappingURL=presets.js.map

package/dist/wizard/presets.js.map

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

package/dist/wizard/prompts.d.ts

@@ -0,0 +1,52 @@
+/**
+ * One `@clack/prompts` `select`/`multiselect` option. `value` is the machine key
+ * the wizard maps back onto {@link WizardAnswers}; `label`/`hint` are display-only.
+ */
+export interface WizardSelectOption {
+    readonly value: string;
+    readonly label: string;
+    readonly hint?: string;
+}
+/**
+ * Thrown when a clack prompt returns its cancel symbol (Ctrl-C / Esc). The wizard
+ * catches it once at the top and turns it into a clean `p.cancel` — nothing is
+ * ever written, because {@link runInitWizard} only collects answers.
+ */
+export declare class WizardCancelled extends Error {
+    constructor();
+}
+/**
+ * Unwrap a clack prompt result: return the value, or throw {@link WizardCancelled}
+ * when the user cancelled (clack signals cancel with a sentinel symbol). Every
+ * prompt result must pass through here so a single top-level catch handles cancel.
+ */
+export declare function guard<T>(value: T | symbol): T;
+/**
+ * Channel options for the "how will you talk to this agent?" multiselect: every
+ * channel module in catalog order (webhook first), value = module id.
+ */
+export declare function channelSelectOptions(): WizardSelectOption[];
+/**
+ * Memory options: a leading "None (stateless)" whose empty-string value maps to
+ * `memory: undefined`, then every memory module in catalog order.
+ */
+export declare function memorySelectOptions(): WizardSelectOption[];
+/**
+ * A short curated model menu plus an `__other__` escape hatch that prompts for a
+ * free-form `provider:model` reference.
+ */
+export declare function modelSelectOptions(): WizardSelectOption[];
+/**
+ * The "choose specific" tools multiselect: all eight built-ins first (with per-tool
+ * hints), then the adapter send tools contributed by the selected channels (deduped,
+ * in channel order, each hint naming its channel + action), then the channel-agnostic
+ * `AskUser`. Value = tool name — the exact `tools.allowedTools` entry. The always-on
+ * tools (`MemoryRecall`/`ReadSkill`/MCP) are auto-provisioned and never listed here.
+ */
+export declare function toolMultiselectOptions(selectedChannelIds: readonly string[]): WizardSelectOption[];
+/**
+ * The "start from…" menu: every preset (labelled with its risk + description),
+ * ending with a "Custom" escape hatch that walks the full step-by-step flow.
+ */
+export declare function presetSelectOptions(): WizardSelectOption[];
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/wizard/prompts.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAK7C;AAqCD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,EAAE,CAM3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,EAAE,CAS1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,EAAE,CA0BlG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,EAAE,CAS1D"}

package/dist/wizard/prompts.js

@@ -0,0 +1,141 @@
+import * as p from "@clack/prompts";
+import { findModule, modulesByKind } from "../modules/catalog.js";
+import { ADAPTER_SEND_TOOL_NAMES, BUILTIN_TOOL_NAMES } from "../modules/known-tools.js";
+import { PRESET_CATALOG } from "./presets.js";
+/**
+ * Thrown when a clack prompt returns its cancel symbol (Ctrl-C / Esc). The wizard
+ * catches it once at the top and turns it into a clean `p.cancel` — nothing is
+ * ever written, because {@link runInitWizard} only collects answers.
+ */
+export class WizardCancelled extends Error {
+    constructor() {
+        super("Wizard cancelled.");
+        this.name = "WizardCancelled";
+    }
+}
+/**
+ * Unwrap a clack prompt result: return the value, or throw {@link WizardCancelled}
+ * when the user cancelled (clack signals cancel with a sentinel symbol). Every
+ * prompt result must pass through here so a single top-level catch handles cancel.
+ */
+export function guard(value) {
+    if (p.isCancel(value)) {
+        throw new WizardCancelled();
+    }
+    return value;
+}
+/** Human hints for the built-in tools, shown beside each tool in the multiselect. */
+const BUILTIN_TOOL_HINTS = {
+    Read: "read files",
+    Write: "create/overwrite files",
+    Edit: "edit files",
+    Glob: "find files by pattern",
+    Grep: "search file contents",
+    Bash: "run shell commands (pair with the sandbox)",
+    WebFetch: "fetch a URL",
+    WebSearch: "search the web",
+};
+const ADAPTER_SEND_TOOL_SET = new Set(ADAPTER_SEND_TOOL_NAMES);
+/**
+ * The action each adapter send tool performs; the owning channel's title is appended
+ * so the hint reads e.g. `proactive send (Telegram)`. Keyed by PascalCase tool name.
+ */
+const ADAPTER_SEND_TOOL_ACTIONS = {
+    SlackSendMessage: "proactive send",
+    TelegramSendMessage: "proactive send",
+    TelegramAskButtons: "ask via tappable buttons, non-blocking",
+    TelegramSendFile: "send a document or photo",
+};
+/**
+ * The channel-agnostic interaction tool. Always offered (even for a restricted agent)
+ * because it asks the human through whichever channel is live and waits for the reply.
+ */
+const ASK_USER_OPTION = {
+    value: "AskUser",
+    label: "AskUser",
+    hint: "ask the human and wait for a typed reply (any channel)",
+};
+/**
+ * Channel options for the "how will you talk to this agent?" multiselect: every
+ * channel module in catalog order (webhook first), value = module id.
+ */
+export function channelSelectOptions() {
+    return modulesByKind("channel").map((module) => ({
+        value: module.id,
+        label: module.title,
+        hint: module.summary,
+    }));
+}
+/**
+ * Memory options: a leading "None (stateless)" whose empty-string value maps to
+ * `memory: undefined`, then every memory module in catalog order.
+ */
+export function memorySelectOptions() {
+    return [
+        { value: "", label: "None (stateless)", hint: "no cross-conversation memory" },
+        ...modulesByKind("memory").map((module) => ({
+            value: module.id,
+            label: module.title,
+            hint: module.summary,
+        })),
+    ];
+}
+/**
+ * A short curated model menu plus an `__other__` escape hatch that prompts for a
+ * free-form `provider:model` reference.
+ */
+export function modelSelectOptions() {
+    return [
+        { value: "claude:claude-sonnet-4-6", label: "Claude Sonnet 4.6", hint: "default" },
+        { value: "codex:gpt-5.5", label: "Codex GPT-5.5" },
+        { value: "pi:ollama:llama3.1:8b", label: "Ollama llama3.1:8b", hint: "fully local" },
+        { value: "__other__", label: "Other…", hint: "type a provider:model reference" },
+    ];
+}
+/**
+ * The "choose specific" tools multiselect: all eight built-ins first (with per-tool
+ * hints), then the adapter send tools contributed by the selected channels (deduped,
+ * in channel order, each hint naming its channel + action), then the channel-agnostic
+ * `AskUser`. Value = tool name — the exact `tools.allowedTools` entry. The always-on
+ * tools (`MemoryRecall`/`ReadSkill`/MCP) are auto-provisioned and never listed here.
+ */
+export function toolMultiselectOptions(selectedChannelIds) {
+    const options = BUILTIN_TOOL_NAMES.map((name) => ({
+        value: name,
+        label: name,
+        ...(BUILTIN_TOOL_HINTS[name] === undefined ? {} : { hint: BUILTIN_TOOL_HINTS[name] }),
+    }));
+    const seen = new Set(BUILTIN_TOOL_NAMES);
+    for (const channelId of selectedChannelIds) {
+        const module = findModule(channelId);
+        if (module === undefined) {
+            continue;
+        }
+        for (const tool of module.recommendedTools ?? []) {
+            // `AskUser` is channel-agnostic and appended once at the end, not per channel.
+            if (!ADAPTER_SEND_TOOL_SET.has(tool) || seen.has(tool) || tool === "AskUser") {
+                continue;
+            }
+            seen.add(tool);
+            const action = ADAPTER_SEND_TOOL_ACTIONS[tool] ?? "channel action";
+            options.push({ value: tool, label: tool, hint: `${action} (${module.title})` });
+        }
+    }
+    options.push(ASK_USER_OPTION);
+    return options;
+}
+/**
+ * The "start from…" menu: every preset (labelled with its risk + description),
+ * ending with a "Custom" escape hatch that walks the full step-by-step flow.
+ */
+export function presetSelectOptions() {
+    return [
+        ...PRESET_CATALOG.map((preset) => ({
+            value: preset.id,
+            label: preset.title,
+            hint: `${preset.riskLevel} · ${preset.description}`,
+        })),
+        { value: "__custom__", label: "Custom — pick capabilities yourself" },
+    ];
+}
+//# sourceMappingURL=prompts.js.map

package/dist/wizard/prompts.js.map

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

package/dist/wizard/run.d.ts

@@ -0,0 +1,19 @@
+import { type WizardAnswers } from "./answers.js";
+/** The outcome of a wizard run: collected answers, or a clean cancellation. */
+export type WizardOutcome = {
+    readonly status: "answers";
+    readonly answers: WizardAnswers;
+} | {
+    readonly status: "cancelled";
+};
+/**
+ * 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 declare function runInitWizard(ctx: {
+    cwd: string;
+}): Promise<WizardOutcome>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/wizard/run.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAYtB,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAqBrC;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAWhF"}