@mono-agent/agent-app 0.5.0 → 0.6.0

package/dist/modules/known-tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The single source of truth for tool names, shared by the wizard, doctor, and
+ * tests. Names are exact and case-sensitive, verified against the runtime's
+ * `pi-bridge.js` (built-ins) and `adapter-send-tools.ts` (adapter send tools).
+ */
+import { ALLOW_ALL_TOOLS } from "@mono-agent/config";
+/** Re-export the allow-all sentinel so agent-app callers share one canonical value. */
+export { ALLOW_ALL_TOOLS };
+/** Built-in tools gated by `tools.allowedTools` (pi-bridge.js). */
+export declare const BUILTIN_TOOL_NAMES: readonly ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "WebFetch", "WebSearch"];
+/** Adapter send tools — require BOTH an `allowedTools` entry AND an enabled channel. */
+export declare const ADAPTER_SEND_TOOL_NAMES: readonly ["SlackSendMessage", "TelegramSendMessage", "TelegramAskButtons", "TelegramSendFile", "AskUser"];
+/**
+ * Old snake_case tool names accepted as INPUT aliases so existing fleet/user
+ * configs keep working after the PascalCase rename. Each maps to its canonical
+ * new name; `telegram_send_document`/`telegram_send_photo` both collapse to the
+ * single `TelegramSendFile` tool. The allow/deny matcher and doctor normalize
+ * through this map — the new PascalCase names are the only ones ever registered,
+ * emitted, or recommended.
+ */
+export declare const LEGACY_TOOL_ALIASES: Record<string, string>;
+/** The canonical new name for a tool, resolving a legacy snake_case alias if given. */
+export declare function canonicalToolName(name: string): string;
+/** Safe read-only default pre-checked for every new agent. */
+export declare const DEFAULT_SAFE_TOOLS: readonly ["Read", "Glob", "Grep"];
+export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];
+export type AdapterSendToolName = (typeof ADAPTER_SEND_TOOL_NAMES)[number];
+/**
+ * True when `name` is a built-in, an adapter send tool, or a canonical alias-value
+ * name (exact, case-sensitive match). Legacy snake_case alias KEYS are also accepted
+ * so an old config keeps validating cleanly through the rename.
+ */
+export declare function isKnownToolName(name: string): boolean;
+/** True when `list` contains the global allow-all sentinel (`"*"`). */
+export declare function isAllowAllTools(list: readonly string[]): boolean;
+/** True when `name` targets an MCP server tool (`mcp__…`) — cannot be validated offline. */
+export declare function isMcpToolName(name: string): boolean;
+/**
+ * The closest known tool name for a typo, case-insensitive (e.g. `read` → `Read`),
+ * else undefined. Used by doctor for "did you mean" hints. Matches
+ * case-insensitively against the known set (BUILTIN ∪ ADAPTER_SEND ∪ alias values).
+ */
+export declare function suggestToolName(name: string): string | undefined;
+//# sourceMappingURL=known-tools.d.ts.map

package/dist/modules/known-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-tools.d.ts","sourceRoot":"","sources":["../../src/modules/known-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,uFAAuF;AACvF,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,qFASrB,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,2GAM1B,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUtD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,mCAAoC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAa3E;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEhE;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhE"}

package/dist/modules/known-tools.js

@@ -0,0 +1,88 @@
+/**
+ * The single source of truth for tool names, shared by the wizard, doctor, and
+ * tests. Names are exact and case-sensitive, verified against the runtime's
+ * `pi-bridge.js` (built-ins) and `adapter-send-tools.ts` (adapter send tools).
+ */
+import { ALLOW_ALL_TOOLS } from "@mono-agent/config";
+/** Re-export the allow-all sentinel so agent-app callers share one canonical value. */
+export { ALLOW_ALL_TOOLS };
+/** Built-in tools gated by `tools.allowedTools` (pi-bridge.js). */
+export const BUILTIN_TOOL_NAMES = [
+    "Read",
+    "Write",
+    "Edit",
+    "Glob",
+    "Grep",
+    "Bash",
+    "WebFetch",
+    "WebSearch",
+];
+/** Adapter send tools — require BOTH an `allowedTools` entry AND an enabled channel. */
+export const ADAPTER_SEND_TOOL_NAMES = [
+    "SlackSendMessage",
+    "TelegramSendMessage",
+    "TelegramAskButtons",
+    "TelegramSendFile",
+    "AskUser",
+];
+/**
+ * Old snake_case tool names accepted as INPUT aliases so existing fleet/user
+ * configs keep working after the PascalCase rename. Each maps to its canonical
+ * new name; `telegram_send_document`/`telegram_send_photo` both collapse to the
+ * single `TelegramSendFile` tool. The allow/deny matcher and doctor normalize
+ * through this map — the new PascalCase names are the only ones ever registered,
+ * emitted, or recommended.
+ */
+export const LEGACY_TOOL_ALIASES = {
+    slack_send_message: "SlackSendMessage",
+    telegram_send_message: "TelegramSendMessage",
+    telegram_ask: "TelegramAskButtons",
+    telegram_send_document: "TelegramSendFile",
+    telegram_send_photo: "TelegramSendFile",
+    ask_user: "AskUser",
+    memory_recall: "MemoryRecall",
+    read_skill: "ReadSkill",
+    ask_collaborator: "AskCollaborator",
+};
+/** The canonical new name for a tool, resolving a legacy snake_case alias if given. */
+export function canonicalToolName(name) {
+    return LEGACY_TOOL_ALIASES[name] ?? name;
+}
+/** Safe read-only default pre-checked for every new agent. */
+export const DEFAULT_SAFE_TOOLS = ["Read", "Glob", "Grep"];
+/**
+ * All offline-knowable tool names: built-ins, adapter send tools, AND the canonical
+ * PascalCase names that only exist as alias VALUES (`ReadSkill`, `AskCollaborator`,
+ * `MemoryRecall`). Folding in the alias values keeps the new
+ * canonical names at least as "known" as their deprecated snake_case spellings — a
+ * config listing `ReadSkill` must validate as cleanly as one listing `read_skill`.
+ */
+const KNOWN_TOOL_NAMES = [
+    ...new Set([...BUILTIN_TOOL_NAMES, ...ADAPTER_SEND_TOOL_NAMES, ...Object.values(LEGACY_TOOL_ALIASES)]),
+];
+/**
+ * True when `name` is a built-in, an adapter send tool, or a canonical alias-value
+ * name (exact, case-sensitive match). Legacy snake_case alias KEYS are also accepted
+ * so an old config keeps validating cleanly through the rename.
+ */
+export function isKnownToolName(name) {
+    return name === ALLOW_ALL_TOOLS || KNOWN_TOOL_NAMES.includes(name) || name in LEGACY_TOOL_ALIASES;
+}
+/** True when `list` contains the global allow-all sentinel (`"*"`). */
+export function isAllowAllTools(list) {
+    return list.includes(ALLOW_ALL_TOOLS);
+}
+/** True when `name` targets an MCP server tool (`mcp__…`) — cannot be validated offline. */
+export function isMcpToolName(name) {
+    return name.startsWith("mcp__");
+}
+/**
+ * The closest known tool name for a typo, case-insensitive (e.g. `read` → `Read`),
+ * else undefined. Used by doctor for "did you mean" hints. Matches
+ * case-insensitively against the known set (BUILTIN ∪ ADAPTER_SEND ∪ alias values).
+ */
+export function suggestToolName(name) {
+    const lowered = name.toLowerCase();
+    return KNOWN_TOOL_NAMES.find((known) => known.toLowerCase() === lowered);
+}
+//# sourceMappingURL=known-tools.js.map

package/dist/modules/known-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-tools.js","sourceRoot":"","sources":["../../src/modules/known-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,uFAAuF;AACvF,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;CACH,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,SAAS;CACD,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,kBAAkB,EAAE,kBAAkB;IACtC,qBAAqB,EAAE,qBAAqB;IAC5C,YAAY,EAAE,oBAAoB;IAClC,sBAAsB,EAAE,kBAAkB;IAC1C,mBAAmB,EAAE,kBAAkB;IACvC,QAAQ,EAAE,SAAS;IACnB,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,WAAW;IACvB,gBAAgB,EAAE,iBAAiB;CACpC,CAAC;AAEF,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAKpE;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAsB;IAC1C,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAC/G,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,KAAK,eAAe,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,mBAAmB,CAAC;AACpG,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;AAC3E,CAAC"}

package/dist/modules/types.d.ts

@@ -0,0 +1,73 @@
+import type { MonoAgentConfigJson } from "@mono-agent/config";
+import type { ValidationStatus } from "../doctor.js";
+/** The kind of capability a module contributes, used to group the wizard's steps. */
+export type ModuleKind = "channel" | "memory" | "sandbox" | "observability" | "provider";
+/**
+ * A value a module templates against. Non-secret inputs carry a default and may
+ * be overridden by the wizard/CLI; secret inputs are never written into JSON —
+ * they only emit a `.env.example` placeholder via {@link CapabilityModule.envExampleLines}.
+ * (Same shape as the old `RecipeInput`.)
+ */
+export interface ModuleInput {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    /** Default used when the wizard/CLI does not override the input. */
+    readonly default?: string;
+    /** Secret inputs are externalized to `.env.example`, never inlined in JSON. */
+    readonly secret?: boolean;
+    /** The `MONO_AGENT_*` env var a secret input maps to (for `.env.example`). */
+    readonly envVar?: string;
+}
+/** Resolved input values keyed by {@link ModuleInput.id}. */
+export type ModuleInputValues = Readonly<Record<string, string | undefined>>;
+/** An auxiliary file a module scaffolds beside the config (e.g. a cron job markdown). */
+export interface GeneratedFile {
+    /** Path relative to the agent folder. */
+    readonly path: string;
+    readonly contents: string;
+}
+/**
+ * A capability a module promises once its secrets are filled in. The composer
+ * checks each expectation against the doctor report and reports the module as
+ * incomplete when a required section is not yet at the promised status.
+ */
+export interface ModuleValidateExpectation {
+    /** Doctor section id: `runtime|memory|sandbox|tools|observability|channel:<driver>`. */
+    readonly sectionId: string;
+    /** The status the section must reach for the module to be considered live. */
+    readonly mustBe: ValidationStatus;
+    /** Human note explaining what to do if the expectation is unmet. */
+    readonly note?: string;
+}
+/**
+ * A composable capability: a partial config fragment plus the inputs, secrets,
+ * tools, and validate-expectations it owns. The composer spreads fragments onto
+ * a shared base skeleton — a module never writes secrets into the config and only
+ * emits JSON the existing loader already accepts.
+ */
+export interface CapabilityModule {
+    /** `channel:telegram`, `memory:bujo`, `sandbox`, `observability:phoenix`, ... */
+    readonly id: string;
+    readonly kind: ModuleKind;
+    readonly title: string;
+    /** One-line wizard hint. */
+    readonly summary: string;
+    readonly riskLevel: "low" | "medium" | "high";
+    /** The `docs/playbooks/<file>` this module mirrors, parity-checked to exist. */
+    readonly playbook?: string;
+    readonly inputs: readonly ModuleInput[];
+    /** Partial config this module contributes; composed onto the base skeleton. */
+    readonly configFragment: (values: ModuleInputValues) => Partial<MonoAgentConfigJson> & Record<string, unknown>;
+    /** `.env.example` placeholder lines for this module's secrets (no trailing newline per line). */
+    readonly envExampleLines?: (values: ModuleInputValues) => readonly string[];
+    /** `allowedTools` entries this capability wants (pre-checked in the wizard tools step). */
+    readonly recommendedTools?: readonly string[];
+    /** Extra files to scaffold (cron job markdown, etc.). */
+    readonly files?: (values: ModuleInputValues) => readonly GeneratedFile[];
+    /** Capabilities the composer checks once secrets are supplied. */
+    readonly validateExpectations: readonly ModuleValidateExpectation[];
+}
+/** Resolve declared input defaults, then layer overrides on top. */
+export declare function resolveModuleInputs(module: CapabilityModule, overrides?: ModuleInputValues): ModuleInputValues;
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE7E,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/G,iGAAiG;IACjG,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,MAAM,EAAE,CAAC;IAC5E,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,aAAa,EAAE,CAAC;IACzE,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACrE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,iBAAsB,GAChC,iBAAiB,CAYnB"}

package/dist/{recipes → modules}/types.js

@@ -1,7 +1,7 @@
-/** Resolve declared input defaults, then layer CLI overrides on top. */
-export function resolveRecipeInputs(recipe, overrides = {}) {
+/** Resolve declared input defaults, then layer overrides on top. */
+export function resolveModuleInputs(module, overrides = {}) {
     const values = {};
-    for (const input of recipe.inputs) {
+    for (const input of module.inputs) {
         values[input.id] = overrides[input.id] ?? input.default;
     }
     // Preserve overrides that don't correspond to a declared input (forward-compat).

package/dist/{recipes → modules}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recipes/types.ts"],"names":[],"mappings":"AA0EA,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CACjC,MAAmB,EACnB,YAA+B,EAAE;IAEjC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;IAC1D,CAAC;IACD,iFAAiF;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":"AA8EA,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,YAA+B,EAAE;IAEjC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;IAC1D,CAAC;IACD,iFAAiF;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/posted-message-index.d.ts

@@ -5,14 +5,14 @@
  *
  * Why this exists: a scheduled/proactive post (e.g. a daily digest) runs under a
  * synthetic conversationId (e.g. `scheduled-scan`) and posts via
- * `slack_send_message`, which registers no `slack:` conversation. When the user
+ * `SlackSendMessage`, which registers no `slack:` conversation. When the user
  * replies, the Slack adapter derives `slack:<channel>:<posted-ts>` — an id with no
  * history. This index closes that gap: the producer records `(channel, ts) →
  * producing conversationId`; the consumer (inbound dispatch) looks it up and
  * aliases the reply onto the producing conversation.
  *
  * Storage is an append-only JSONL file inside the run-artifact dir. Append-only
- * keeps cross-process writes safe: the `slack_send_message` child process and the
+ * keeps cross-process writes safe: the `SlackSendMessage` child process and the
  * adapter both only ever append (small `O_APPEND` writes are atomic), and only the
  * single adapter process compacts. A `.jsonl` file is ignored by the
  * `.summary.json` artifact scanners (see `seen-conversations.ts`), so it never

package/dist/posted-message-index.js

@@ -7,14 +7,14 @@ import { dirname, join } from "node:path";
  *
  * Why this exists: a scheduled/proactive post (e.g. a daily digest) runs under a
  * synthetic conversationId (e.g. `scheduled-scan`) and posts via
- * `slack_send_message`, which registers no `slack:` conversation. When the user
+ * `SlackSendMessage`, which registers no `slack:` conversation. When the user
  * replies, the Slack adapter derives `slack:<channel>:<posted-ts>` — an id with no
  * history. This index closes that gap: the producer records `(channel, ts) →
  * producing conversationId`; the consumer (inbound dispatch) looks it up and
  * aliases the reply onto the producing conversation.
  *
  * Storage is an append-only JSONL file inside the run-artifact dir. Append-only
- * keeps cross-process writes safe: the `slack_send_message` child process and the
+ * keeps cross-process writes safe: the `SlackSendMessage` child process and the
  * adapter both only ever append (small `O_APPEND` writes are atomic), and only the
  * single adapter process compacts. A `.jsonl` file is ignored by the
  * `.summary.json` artifact scanners (see `seen-conversations.ts`), so it never

package/dist/wizard/answers.d.ts

@@ -0,0 +1,85 @@
+import type { MonoAgentConfigJson } 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 WizardAnswers {
+    readonly model: string;
+    readonly fallbackModels: readonly string[];
+    /** Channel module ids, e.g. `["channel:webhook","channel:telegram"]`. */
+    readonly channels: readonly string[];
+    /** Memory module id, or `undefined` for no memory section. */
+    readonly memory?: string;
+    readonly sandbox: boolean;
+    readonly observability: boolean;
+    /** Final tool selection written into `tools.allowedTools`. */
+    readonly allowedTools: readonly string[];
+    /** Per module id → non-secret input overrides. Secret inputs are stripped by the composer. */
+    readonly moduleInputs: Readonly<Record<string, ModuleInputValues>>;
+}
+/** Folder-derived context the base skeleton needs (not from wizard inputs). */
+export interface ComposeContext {
+    readonly dirBasename: string;
+    readonly skillsRootExists: boolean;
+}
+/**
+ * One secret the composed agent still needs. The CLI prints the checklist as
+ * `- <label>: <description>` and points the operator at `<envVar>` in `.env`.
+ */
+export interface SecretChecklistItem {
+    readonly moduleId: string;
+    readonly label: string;
+    readonly envVar: string;
+    readonly description: string;
+}
+/**
+ * The single artifact of config generation: the JSON to write (with `$schema`),
+ * the optional `.env.example`, follow-up files, the secret checklist, the selected
+ * modules, the validate expectations, and any authoring warnings.
+ */
+export interface WizardPlan {
+    readonly configJson: MonoAgentConfigJson;
+    /** Joined module `envExampleLines` plus a trailing newline; `undefined` when none. */
+    readonly envExample?: string;
+    readonly files: readonly GeneratedFile[];
+    readonly secrets: readonly SecretChecklistItem[];
+    readonly selectedModules: readonly CapabilityModule[];
+    readonly validateExpectations: readonly ModuleValidateExpectation[];
+    readonly warnings: readonly string[];
+}
+/**
+ * The recommended `allowedTools` for these answers: the read-only safe defaults
+ * plus every selected module's `recommendedTools`, deduped and ordered by the
+ * canonical BUILTIN∪ADAPTER position. Deterministic — no Set-iteration reliance.
+ */
+export declare function recommendedToolSelection(answers: WizardAnswers): readonly string[];
+/**
+ * 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
+ * tools are also always-on when present, but the basic wizard authors neither, so they
+ * never appear here.
+ */
+export declare function alwaysOnTools(answers: WizardAnswers): readonly string[];
+/**
+ * The wizard's starting answers with `overrides` shallow-merged on top. Unless an
+ * explicit `allowedTools` override is supplied, `allowedTools` defaults to allow-all
+ * (`["*"]`) — the single choke point that flips the silent scaffold, every preset, and
+ * every non-interactive `--flag` path to allow-all. An explicit override is preserved
+ * verbatim: `["*"]`, a specific list, or `[]` (the chat-only case).
+ */
+export declare function defaultAnswers(overrides?: Partial<WizardAnswers>): WizardAnswers;
+/** 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>;
+/**
+ * The single config-generation path: turn wizard answers into a complete
+ * `WizardPlan`. Fragments are composed onto the adapter-neutral base skeleton;
+ * secret inputs are stripped before any fragment runs, so a secret value can never
+ * reach the JSON. The composed default config is byte-equal to today's `init.ts`
+ * scaffold except `tools.allowedTools` (filled from the wizard's tools selection).
+ */
+export declare function composeWizardPlan(answers: WizardAnswers, ctx: ComposeContext): WizardPlan;
+//# sourceMappingURL=answers.d.ts.map

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

@@ -0,0 +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,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;AAgDD;;;;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;AAsBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,UAAU,CAqEzF"}

package/dist/wizard/answers.js

@@ -0,0 +1,231 @@
+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];
+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
+ * providers first (from a `pi:ollama:*`/`pi:lmstudio:*` model), then channels (in
+ * answer order), then the memory tier, then sandbox, then observability.
+ */
+function selectedModuleIds(answers) {
+    const ids = [];
+    if (/^pi:ollama:/u.test(answers.model)) {
+        ids.push("provider:ollama");
+    }
+    if (/^pi:lmstudio:/u.test(answers.model)) {
+        ids.push("provider:lmstudio");
+    }
+    for (const channel of answers.channels) {
+        ids.push(channel);
+    }
+    if (answers.memory !== undefined) {
+        ids.push(answers.memory);
+    }
+    if (answers.sandbox) {
+        ids.push("sandbox");
+    }
+    if (answers.observability) {
+        ids.push("observability:phoenix");
+    }
+    return ids;
+}
+/** Resolve the selected module ids to modules, skipping unknown ids defensively. */
+function selectedModules(answers) {
+    const modules = [];
+    for (const id of selectedModuleIds(answers)) {
+        const module = findModule(id);
+        if (module !== undefined) {
+            modules.push(module);
+        }
+    }
+    return modules;
+}
+/**
+ * The recommended `allowedTools` for these answers: the read-only safe defaults
+ * plus every selected module's `recommendedTools`, deduped and ordered by the
+ * canonical BUILTIN∪ADAPTER position. Deterministic — no Set-iteration reliance.
+ */
+export function recommendedToolSelection(answers) {
+    const union = new Set(DEFAULT_SAFE_TOOLS);
+    for (const module of selectedModules(answers)) {
+        for (const tool of module.recommendedTools ?? []) {
+            union.add(tool);
+        }
+    }
+    return ORDERED_TOOL_NAMES.filter((name) => union.has(name));
+}
+/** The read-only recall tool auto-provisioned from `memory.recallTool.enabled`. */
+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.
+ */
+function memoryProvisionsRecall(memoryId) {
+    if (memoryId === undefined) {
+        return false;
+    }
+    const module = findModule(memoryId);
+    if (module?.kind !== "memory") {
+        return false;
+    }
+    const fragment = module.configFragment({ model: DEFAULT_MODEL });
+    return fragment.memory?.recallTool?.enabled === true;
+}
+/**
+ * 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
+ * tools are also always-on when present, but the basic wizard authors neither, so they
+ * never appear here.
+ */
+export function alwaysOnTools(answers) {
+    const tools = [];
+    if (memoryProvisionsRecall(answers.memory)) {
+        tools.push(MEMORY_RECALL_TOOL);
+    }
+    return tools;
+}
+const BASE_ANSWERS = {
+    model: DEFAULT_MODEL,
+    fallbackModels: [],
+    channels: ["channel:webhook"],
+    // `memory` is intentionally omitted (no memory section) — with
+    // exactOptionalPropertyTypes an optional key must be absent, not `undefined`.
+    sandbox: false,
+    observability: false,
+    allowedTools: [ALLOW_ALL_TOOLS],
+    moduleInputs: {},
+};
+/**
+ * The wizard's starting answers with `overrides` shallow-merged on top. Unless an
+ * explicit `allowedTools` override is supplied, `allowedTools` defaults to allow-all
+ * (`["*"]`) — the single choke point that flips the silent scaffold, every preset, and
+ * every non-interactive `--flag` path to allow-all. An explicit override is preserved
+ * verbatim: `["*"]`, a specific list, or `[]` (the chat-only case).
+ */
+export function defaultAnswers(overrides) {
+    const merged = { ...BASE_ANSWERS, ...overrides };
+    const allowedTools = overrides?.allowedTools ?? [ALLOW_ALL_TOOLS];
+    return { ...merged, allowedTools };
+}
+/** Overrides for one module: the shared model plus its non-secret input values. */
+export function moduleOverrides(module, answers) {
+    const overrides = {
+        model: answers.model,
+        ...(answers.moduleInputs[module.id] ?? {}),
+    };
+    // Defense in depth: a secret-declared value must never reach a fragment or the JSON.
+    for (const input of module.inputs) {
+        if (input.secret === true) {
+            delete overrides[input.id];
+        }
+    }
+    return overrides;
+}
+/** Merge a module fragment onto the working config, concatenating `channels.plugins`. */
+function applyFragment(config, fragment) {
+    for (const [key, value] of Object.entries(fragment)) {
+        if (key === "channels") {
+            const existing = config.channels ?? {};
+            const incoming = value ?? {};
+            const existingPlugins = Array.isArray(existing.plugins) ? existing.plugins : [];
+            const incomingPlugins = Array.isArray(incoming.plugins) ? incoming.plugins : [];
+            const plugins = [...existingPlugins, ...incomingPlugins];
+            config.channels = {
+                ...existing,
+                ...incoming,
+                ...(plugins.length > 0 ? { plugins } : {}),
+            };
+            continue;
+        }
+        config[key] = value;
+    }
+}
+/**
+ * The single config-generation path: turn wizard answers into a complete
+ * `WizardPlan`. Fragments are composed onto the adapter-neutral base skeleton;
+ * secret inputs are stripped before any fragment runs, so a secret value can never
+ * reach the JSON. The composed default config is byte-equal to today's `init.ts`
+ * scaffold except `tools.allowedTools` (filled from the wizard's tools selection).
+ */
+export function composeWizardPlan(answers, ctx) {
+    const modules = selectedModules(answers);
+    const config = {
+        ...baseConfig(ctx, answers.model, answers.fallbackModels),
+    };
+    const files = [];
+    const secrets = [];
+    const envLines = [];
+    const validateExpectations = [{ sectionId: "runtime", mustBe: "ok" }];
+    let providerOllamaSelected = false;
+    for (const module of modules) {
+        if (module.id === "provider:ollama") {
+            providerOllamaSelected = true;
+        }
+        const values = resolveModuleInputs(module, moduleOverrides(module, answers));
+        applyFragment(config, module.configFragment(values));
+        for (const line of module.envExampleLines?.(values) ?? []) {
+            envLines.push(line);
+        }
+        for (const file of module.files?.(values) ?? []) {
+            files.push(file);
+        }
+        for (const input of module.inputs) {
+            if (input.secret === true && input.envVar !== undefined) {
+                secrets.push({
+                    moduleId: module.id,
+                    label: input.label,
+                    envVar: input.envVar,
+                    description: input.description,
+                });
+            }
+        }
+        for (const expectation of module.validateExpectations) {
+            validateExpectations.push(expectation);
+        }
+    }
+    config.tools = {
+        ...(config.tools ?? {}),
+        allowedTools: [...answers.allowedTools],
+        disallowedTools: [],
+    };
+    // 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;
+    if (providerOllamaSelected && memory?.embeddings !== undefined && memory.embeddings.provider === "ollama") {
+        config.memory = {
+            ...memory,
+            embeddings: { ...memory.embeddings, endpoint: "http://localhost:11434" },
+        };
+    }
+    const configJson = monoAgentConfigWithSchema(config);
+    const envExample = envLines.length > 0 ? `${envLines.join("\n")}\n` : undefined;
+    const warnings = answers.allowedTools.length === 0 ? [ZERO_TOOLS_WARNING] : [];
+    return {
+        configJson,
+        ...(envExample === undefined ? {} : { envExample }),
+        files,
+        secrets,
+        selectedModules: modules,
+        validateExpectations: dedupeExpectations(validateExpectations),
+        warnings,
+    };
+}
+/** Dedupe validate expectations by `sectionId`, keeping the first occurrence. */
+function dedupeExpectations(expectations) {
+    const seen = new Set();
+    const out = [];
+    for (const expectation of expectations) {
+        if (seen.has(expectation.sectionId)) {
+            continue;
+        }
+        seen.add(expectation.sectionId);
+        out.push(expectation);
+    }
+    return out;
+}
+//# sourceMappingURL=answers.js.map

package/dist/wizard/answers.js.map

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

package/dist/wizard/from-flags.d.ts

@@ -0,0 +1,26 @@
+import { type WizardAnswers } from "./answers.js";
+/** Channels `mono-agent init --with <csv>` can switch on, by their short flag name. */
+export declare const WITH_CHANNELS: readonly ["telegram", "slack", "webhook", "openaiApi", "cron"];
+export type WithChannel = (typeof WITH_CHANNELS)[number];
+/** True when `value` is a `--with` channel flag name. */
+export declare function isWithChannel(value: string): value is WithChannel;
+/** The non-interactive `init`/preset flags, before they are mapped onto answers. */
+export interface AnswersFromCliArgs {
+    readonly model?: string;
+    readonly fallbackModels?: readonly string[];
+    readonly memory?: "lite" | "journal" | "bujo";
+    /** Validated `--with` channel flag names (see {@link WithChannel}). */
+    readonly withChannels?: readonly string[];
+    /** Preset id whose answers seed the base selection (already validated by the caller). */
+    readonly presetId?: string;
+}
+/**
+ * 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 declare function answersFromCli(args: AnswersFromCliArgs): WizardAnswers;
+//# sourceMappingURL=from-flags.d.ts.map

package/dist/wizard/from-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-flags.d.ts","sourceRoot":"","sources":["../../src/wizard/from-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlE,uFAAuF;AACvF,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAWD,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAqBtE"}