@mono-agent/agent-app 0.5.1 → 0.6.1

package/dist/modules/index.js

@@ -0,0 +1,5 @@
+export { resolveModuleInputs } from "./types.js";
+export { baseConfig, DEFAULT_MODEL, memoryBlock, MODEL_INPUT } from "./base.js";
+export { ADAPTER_SEND_TOOL_NAMES, ALLOW_ALL_TOOLS, BUILTIN_TOOL_NAMES, canonicalToolName, DEFAULT_SAFE_TOOLS, isAllowAllTools, isKnownToolName, isMcpToolName, LEGACY_TOOL_ALIASES, suggestToolName, } from "./known-tools.js";
+export { CAPABILITY_MODULES, findModule, modulesByKind } from "./catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGhF,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

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/provider-setup.d.ts

@@ -0,0 +1,44 @@
+import { spawn } from "node:child_process";
+export type ProviderSetupKind = "auth" | "preflight";
+export type ProviderSetupAction = {
+    readonly id: string;
+    readonly kind: ProviderSetupKind;
+    readonly label: string;
+    readonly modelRefs: readonly string[];
+    readonly command: readonly [string, ...string[]];
+    readonly cwd: string;
+    readonly detail: string;
+} | {
+    readonly id: string;
+    readonly kind: ProviderSetupKind;
+    readonly label: string;
+    readonly modelRefs: readonly string[];
+    readonly url: string;
+    readonly cwd: string;
+    readonly detail: string;
+};
+export interface ProviderSetupPlan {
+    readonly actions: readonly ProviderSetupAction[];
+}
+export type ProviderSetupStatus = "ok" | "failed";
+export interface ProviderSetupResult {
+    readonly action: ProviderSetupAction;
+    readonly status: ProviderSetupStatus;
+    readonly detail: string;
+}
+export interface PlanProviderSetupOptions {
+    readonly modelRefs: readonly string[];
+    readonly cwd: string;
+    readonly piAuthPath?: string;
+}
+export interface ExecuteProviderSetupOptions {
+    readonly spawn?: typeof spawn;
+    readonly fetch?: typeof fetch;
+}
+export declare function piLoginCommand(provider: string): readonly [string, ...string[]];
+export declare function piLoginCommandLine(provider: string): string;
+export declare function piAuthWorkingDirectory(piAuthPath: string | undefined, cwd?: string): string;
+export declare function planProviderSetup(options: PlanProviderSetupOptions): ProviderSetupPlan;
+export declare function providerSetupActionCommandLine(action: ProviderSetupAction): string;
+export declare function executeProviderSetupPlan(plan: ProviderSetupPlan, options?: ExecuteProviderSetupOptions): Promise<ProviderSetupResult[]>;
+//# sourceMappingURL=provider-setup.d.ts.map

package/dist/provider-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-setup.d.ts","sourceRoot":"","sources":["../src/provider-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAgB,GAAG,MAAM,CAElG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA0GtF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAKlF;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAYhC"}

package/dist/provider-setup.js

@@ -0,0 +1,174 @@
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { modelReferenceKey, parseMonoRuntimeModelReference } from "@mono-agent/runtime-adapter";
+const DEFAULT_PI_AUTH_PATH = join(homedir(), ".pi", "agent", "auth.json");
+export function piLoginCommand(provider) {
+    return ["npx", "@earendil-works/pi-ai", "login", provider];
+}
+export function piLoginCommandLine(provider) {
+    return piLoginCommand(provider).join(" ");
+}
+export function piAuthWorkingDirectory(piAuthPath, cwd = process.cwd()) {
+    return dirname(piAuthPath === undefined ? DEFAULT_PI_AUTH_PATH : resolve(cwd, piAuthPath));
+}
+export function planProviderSetup(options) {
+    const piAuthPath = options.piAuthPath ?? DEFAULT_PI_AUTH_PATH;
+    const actionsById = new Map();
+    for (const raw of options.modelRefs) {
+        let ref;
+        try {
+            ref = parseMonoRuntimeModelReference(raw);
+        }
+        catch {
+            continue;
+        }
+        const refKey = modelReferenceKey(ref);
+        const add = (action) => {
+            const existing = actionsById.get(action.id);
+            if (existing === undefined) {
+                actionsById.set(action.id, action);
+                return;
+            }
+            actionsById.set(action.id, {
+                ...existing,
+                modelRefs: [...new Set([...existing.modelRefs, ...action.modelRefs])],
+            });
+        };
+        if (ref.sdk === "claude") {
+            add({
+                id: "claude-login",
+                kind: "auth",
+                label: "Claude login",
+                modelRefs: [refKey],
+                command: ["claude", "/login"],
+                cwd: options.cwd,
+                detail: "Runs the Claude Code login flow for Claude model references.",
+            });
+            continue;
+        }
+        if (ref.sdk === "codex") {
+            add({
+                id: "codex-login",
+                kind: "auth",
+                label: "Codex login",
+                modelRefs: [refKey],
+                command: ["codex", "login"],
+                cwd: options.cwd,
+                detail: "Runs the Codex login flow for direct Codex model references.",
+            });
+            continue;
+        }
+        if (ref.sdk !== "pi" || typeof ref.provider !== "string") {
+            continue;
+        }
+        if (ref.provider === "ollama") {
+            add({
+                id: "ollama-list",
+                kind: "preflight",
+                label: "Ollama model preflight",
+                modelRefs: [refKey],
+                command: ["ollama", "list"],
+                cwd: options.cwd,
+                detail: "Checks that the local Ollama server and CLI can list installed models.",
+            });
+            continue;
+        }
+        if (ref.provider === "lmstudio") {
+            add({
+                id: "lmstudio-models",
+                kind: "preflight",
+                label: "LM Studio model preflight",
+                modelRefs: [refKey],
+                url: "http://localhost:1234/v1/models",
+                cwd: options.cwd,
+                detail: "Checks that LM Studio's OpenAI-compatible local server exposes models.",
+            });
+            continue;
+        }
+        if (ref.provider === "opencode-go") {
+            add({
+                id: "opencode-models",
+                kind: "preflight",
+                label: "OpenCode model preflight",
+                modelRefs: [refKey],
+                command: ["opencode", "models", "--json"],
+                cwd: options.cwd,
+                detail: "Checks that OpenCode can list configured models.",
+            });
+            continue;
+        }
+        add({
+            id: `pi-login:${ref.provider}`,
+            kind: "auth",
+            label: `Pi login for ${ref.provider}`,
+            modelRefs: [refKey],
+            command: piLoginCommand(ref.provider),
+            cwd: piAuthWorkingDirectory(piAuthPath, options.cwd),
+            detail: `Runs Pi auth for provider \`${ref.provider}\` from the providers.piAuthPath directory.`,
+        });
+    }
+    return { actions: [...actionsById.values()] };
+}
+export function providerSetupActionCommandLine(action) {
+    if ("command" in action) {
+        return action.command.join(" ");
+    }
+    return `GET ${action.url}`;
+}
+export async function executeProviderSetupPlan(plan, options = {}) {
+    const results = [];
+    for (const action of plan.actions) {
+        const result = "command" in action
+            ? await runCommandAction(action, options.spawn ?? spawn)
+            : await runHttpAction(action, options.fetch ?? fetch);
+        results.push(result);
+        if (result.status === "failed") {
+            break;
+        }
+    }
+    return results;
+}
+async function runCommandAction(action, spawnImpl) {
+    const [file, ...args] = action.command;
+    return new Promise((resolve) => {
+        const child = spawnImpl(file, args, {
+            cwd: action.cwd,
+            env: process.env,
+            stdio: "inherit",
+        });
+        child.once("error", (error) => {
+            resolve({ action, status: "failed", detail: error.message });
+        });
+        child.once("close", (code, signal) => {
+            if (code === 0) {
+                resolve({ action, status: "ok", detail: `${providerSetupActionCommandLine(action)} exited 0.` });
+                return;
+            }
+            resolve({
+                action,
+                status: "failed",
+                detail: signal === null
+                    ? `${providerSetupActionCommandLine(action)} exited ${code ?? "unknown"}.`
+                    : `${providerSetupActionCommandLine(action)} terminated by ${signal}.`,
+            });
+        });
+    });
+}
+async function runHttpAction(action, fetchImpl) {
+    try {
+        const response = await fetchImpl(action.url);
+        if (response.ok) {
+            return { action, status: "ok", detail: `GET ${action.url} returned ${response.status}.` };
+        }
+        return { action, status: "failed", detail: `GET ${action.url} returned ${response.status}.` };
+    }
+    catch (error) {
+        return {
+            action,
+            status: "failed",
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=provider-setup.js.map

package/dist/provider-setup.js.map

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

package/dist/wizard/answers.d.ts

@@ -0,0 +1,87 @@
+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[];
+    /** Optional runtime reasoning effort (`runtime.effort`), omitted for default provider behavior. */
+    readonly effort?: 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,mGAAmG;IACnG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACpE;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAiDD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAQlF;AAyBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAMvE;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAIhF;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAYpH;AAkCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,UAAU,CAqEzF"}