@mono-agent/agent-app 0.9.1 → 0.11.0

package/dist/recipes/index.js

@@ -0,0 +1,14 @@
+import { RECIPE_CATALOG } from "./catalog.js";
+export { resolveRecipeInputs } from "./types.js";
+export { RECIPE_CATALOG } from "./catalog.js";
+/** id -> recipe, for O(1) lookup by the CLI. */
+export const RECIPES = new Map(RECIPE_CATALOG.map((recipe) => [recipe.id, recipe]));
+/** Look up a recipe by id, or undefined when unknown. */
+export function findRecipe(id) {
+    return RECIPES.get(id);
+}
+/** Every recipe id, in catalog order. */
+export function recipeIds() {
+    return RECIPE_CATALOG.map((recipe) => recipe.id);
+}
+//# sourceMappingURL=index.js.map

package/dist/recipes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,gDAAgD;AAChD,MAAM,CAAC,MAAM,OAAO,GAAqC,IAAI,GAAG,CAC9D,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CACpD,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,SAAS;IACvB,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/recipes/types.d.ts

@@ -0,0 +1,70 @@
+import type { MonoAgentConfigJson } from "@mono-agent/config";
+import type { ValidationStatus } from "../doctor.js";
+/**
+ * A value the recipe templates against. Non-secret inputs carry a default and
+ * may be overridden from the CLI; secret inputs are never written into JSON —
+ * they only emit a `.env.example` placeholder via {@link AgentRecipe.envExample}.
+ */
+export interface RecipeInput {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    /** Default used when the 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 RecipeInput.id}. */
+export type RecipeInputValues = Readonly<Record<string, string | undefined>>;
+/** An auxiliary file a recipe 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 the recipe promises once secrets are filled in. `mono-agent
+ * validate --recipe <id>` checks each expectation against the doctor report and
+ * reports "selected recipe incomplete" when a required section is not yet at the
+ * promised status (e.g. a channel still `waiting` on a token).
+ */
+export interface RecipeValidateExpectation {
+    /** Doctor section id, e.g. `runtime`, `memory`, `channel:telegram`. */
+    readonly sectionId: string;
+    /** The status the section must reach for the recipe to be considered live. */
+    readonly mustBe: ValidationStatus;
+    /** Human note explaining what to do if the expectation is unmet. */
+    readonly note?: string;
+}
+/**
+ * A typed, testable blueprint that compiles to an ordinary
+ * `mono-agent.config.json` plus optional `.env.example` placeholders and
+ * follow-up files. Recipes never change runtime contracts — they only emit JSON
+ * the existing loader already accepts — and never write secrets into the config.
+ */
+export interface AgentRecipe {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+    readonly riskLevel: "low" | "medium" | "high";
+    /**
+     * The `docs/playbooks/<playbook>.md` this recipe mirrors, parity-checked to
+     * exist. The composite "full" blueprints have no single playbook and omit it.
+     */
+    readonly playbook?: string;
+    readonly inputs: readonly RecipeInput[];
+    /** Build the `mono-agent.config.json` contents from resolved inputs. */
+    readonly config: (input: RecipeInputValues) => MonoAgentConfigJson;
+    /** `.env.example` lines for the secrets this recipe needs (never in JSON). */
+    readonly envExample?: (input: RecipeInputValues) => string;
+    /** Extra files to scaffold (cron job markdown, etc.). */
+    readonly files?: (input: RecipeInputValues) => readonly GeneratedFile[];
+    /** Capabilities `validate --recipe` checks once secrets are supplied. */
+    readonly validateExpectations: readonly RecipeValidateExpectation[];
+}
+/** Resolve declared input defaults, then layer CLI overrides on top. */
+export declare function resolveRecipeInputs(recipe: AgentRecipe, overrides?: RecipeInputValues): RecipeInputValues;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recipes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;GAIG;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,6DAA6D;IAC7D,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;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,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,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,mBAAmB,CAAC;IACnE,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,MAAM,CAAC;IAC3D,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,SAAS,aAAa,EAAE,CAAC;IACxE,yEAAyE;IACzE,QAAQ,CAAC,oBAAoB,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACrE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,SAAS,GAAE,iBAAsB,GAChC,iBAAiB,CAYnB"}

package/dist/recipes/types.js

@@ -0,0 +1,15 @@
+/** Resolve declared input defaults, then layer CLI overrides on top. */
+export function resolveRecipeInputs(recipe, overrides = {}) {
+    const values = {};
+    for (const input of recipe.inputs) {
+        values[input.id] = overrides[input.id] ?? input.default;
+    }
+    // Preserve overrides that don't correspond to a declared input (forward-compat).
+    for (const [key, value] of Object.entries(overrides)) {
+        if (!(key in values)) {
+            values[key] = value;
+        }
+    }
+    return values;
+}
+//# sourceMappingURL=types.js.map

package/dist/recipes/types.js.map

@@ -0,0 +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"}

package/dist/setup.d.ts

@@ -0,0 +1,29 @@
+import type { WithChannel } from "./init.js";
+import type { AgentRecipe, RecipeInputValues } from "./recipes/index.js";
+export interface SetupPromptSource {
+    question(prompt: string): Promise<string>;
+}
+export interface SecretChecklistItem {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    readonly envVar?: string;
+}
+export interface CollectSetupOptions {
+    readonly prompt: SetupPromptSource;
+    readonly recipe?: AgentRecipe;
+    readonly model?: string;
+    readonly fallbackModels?: readonly string[];
+    readonly withChannels?: readonly WithChannel[];
+    readonly recipes?: readonly AgentRecipe[];
+}
+export interface CollectedSetupOptions {
+    readonly recipe: AgentRecipe;
+    readonly recipeInputs: RecipeInputValues;
+    readonly fallbackModels: readonly string[];
+    readonly withChannels: readonly WithChannel[];
+    readonly secrets: readonly SecretChecklistItem[];
+}
+export declare function collectSetupOptions(options: CollectSetupOptions): Promise<CollectedSetupOptions>;
+export declare function renderSetupRecipeMenu(recipes?: readonly AgentRecipe[]): string;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAe,MAAM,oBAAoB,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwBtG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,SAAS,WAAW,EAAmB,GAAG,MAAM,CAO9F"}

package/dist/setup.js

@@ -0,0 +1,97 @@
+import { WITH_CHANNELS } from "./init.js";
+import { RECIPE_CATALOG } from "./recipes/index.js";
+export async function collectSetupOptions(options) {
+    const recipes = options.recipes ?? RECIPE_CATALOG;
+    const recipe = options.recipe ?? await promptForRecipe(options.prompt, recipes);
+    const recipeInputs = {};
+    const secrets = [];
+    for (const input of recipe.inputs) {
+        if (input.secret === true) {
+            secrets.push(secretChecklistItem(input));
+            continue;
+        }
+        const defaultValue = input.id === "model" && options.model !== undefined ? options.model : input.default;
+        const answer = await options.prompt.question(inputPrompt(input, defaultValue));
+        const value = answer.trim();
+        if (value.length > 0) {
+            recipeInputs[input.id] = value;
+        }
+        else if (defaultValue !== undefined) {
+            recipeInputs[input.id] = defaultValue;
+        }
+    }
+    const fallbackModels = await promptForFallbackModels(options.prompt, options.fallbackModels ?? []);
+    const withChannels = await promptForWithChannels(options.prompt, options.withChannels ?? []);
+    return { recipe, recipeInputs, fallbackModels, withChannels, secrets };
+}
+export function renderSetupRecipeMenu(recipes = RECIPE_CATALOG) {
+    return recipes
+        .map((recipe, index) => {
+        const tags = recipe.tags.length === 0 ? "" : ` (${recipe.tags.join(", ")})`;
+        return `${index + 1}. ${recipe.id} [risk: ${recipe.riskLevel}] - ${recipe.title}${tags}`;
+    })
+        .join("\n");
+}
+function inputPrompt(input, defaultValue) {
+    const suffix = defaultValue === undefined ? "" : ` [${defaultValue}]`;
+    return `${input.label}${suffix}\n${input.description}\n> `;
+}
+function secretChecklistItem(input) {
+    return {
+        id: input.id,
+        label: input.label,
+        description: input.description,
+        ...(input.envVar === undefined ? {} : { envVar: input.envVar }),
+    };
+}
+async function promptForRecipe(prompt, recipes) {
+    if (recipes.length === 0) {
+        throw new Error("No setup recipes are available.");
+    }
+    for (;;) {
+        const answer = await prompt.question(`Choose a recipe:\n${renderSetupRecipeMenu(recipes)}\nRecipe [1]: `);
+        const selected = parseRecipeChoice(answer, recipes);
+        if (selected !== undefined) {
+            return selected;
+        }
+    }
+}
+function parseRecipeChoice(answer, recipes) {
+    const value = answer.trim();
+    if (value.length === 0) {
+        return recipes[0];
+    }
+    const index = Number(value);
+    if (Number.isInteger(index) && index >= 1 && index <= recipes.length) {
+        return recipes[index - 1];
+    }
+    return recipes.find((recipe) => recipe.id === value);
+}
+async function promptForWithChannels(prompt, defaults) {
+    const defaultText = defaults.length === 0 ? "none" : defaults.join(",");
+    for (;;) {
+        const answer = await prompt.question(`Enable add-on channels (${WITH_CHANNELS.join(", ")}) [${defaultText}]: `);
+        const raw = answer.trim();
+        if (raw.length === 0) {
+            return defaults;
+        }
+        const parsed = raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+        const invalid = parsed.filter((entry) => !WITH_CHANNELS.includes(entry));
+        if (invalid.length === 0) {
+            return parsed;
+        }
+    }
+}
+async function promptForFallbackModels(prompt, defaults) {
+    const defaultText = defaults.length === 0 ? "none" : defaults.join(",");
+    const answer = await prompt.question(`Fallback models, comma-separated [${defaultText}]: `);
+    const raw = answer.trim();
+    if (raw.length === 0) {
+        return defaults;
+    }
+    if (raw.toLowerCase() === "none") {
+        return [];
+    }
+    return raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA+BpD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA4B;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChF,MAAM,YAAY,GAAuC,EAAE,CAAC;IAC5D,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACzG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QACjC,CAAC;aAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IACnG,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC7F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkC,cAAc;IACpF,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5E,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,WAAW,MAAM,CAAC,SAAS,OAAO,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;IAC3F,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAkB,EAAE,YAAgC;IACvE,MAAM,MAAM,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC;IACtE,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,MAAM,KAAK,KAAK,CAAC,WAAW,MAAM,CAAC;AAC7D,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAkB;IAC7C,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAyB,EACzB,OAA+B;IAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,qBAAqB,qBAAqB,CAAC,OAAO,CAAC,gBAAgB,CACpE,CAAC;QACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,OAA+B;IACxE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACrE,OAAO,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,MAAyB,EACzB,QAAgC;IAEhC,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,2BAA2B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,WAAW,KAAK,CAC1E,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/F,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAChG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,MAAuB,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,MAAyB,EACzB,QAA2B;IAE3B,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,qCAAqC,WAAW,KAAK,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mono-agent/agent-app",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel and traceability from one mono-agent.config.json.",
   "type": "module",
   "license": "UNLICENSED",
@@ -32,20 +32,20 @@
     "@clack/prompts": "^1.7.0",
     "@earendil-works/pi-ai": "^0.80.5",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@mono-agent/agent-contracts": "0.9.1",
-    "@mono-agent/agent-harness": "0.9.1",
-    "@mono-agent/config": "0.9.1",
-    "@mono-agent/cron-adapter": "0.9.1",
-    "@mono-agent/operator-adapter": "0.9.1",
-    "@mono-agent/memory": "0.9.1",
-    "@mono-agent/observability": "0.9.1",
-    "@mono-agent/openai-api-adapter": "0.9.1",
-    "@mono-agent/runtime-adapter": "0.9.1",
-    "@mono-agent/session-web": "0.9.1",
-    "@mono-agent/slack-adapter": "0.9.1",
-    "@mono-agent/telegram-adapter": "0.9.1",
-    "@mono-agent/tui": "0.9.1",
-    "@mono-agent/webhook-adapter": "0.9.1",
+    "@mono-agent/agent-contracts": "0.11.0",
+    "@mono-agent/agent-harness": "0.11.0",
+    "@mono-agent/config": "0.11.0",
+    "@mono-agent/cron-adapter": "0.11.0",
+    "@mono-agent/operator-adapter": "0.11.0",
+    "@mono-agent/memory": "0.11.0",
+    "@mono-agent/observability": "0.11.0",
+    "@mono-agent/openai-api-adapter": "0.11.0",
+    "@mono-agent/runtime-adapter": "0.11.0",
+    "@mono-agent/session-web": "0.11.0",
+    "@mono-agent/slack-adapter": "0.11.0",
+    "@mono-agent/telegram-adapter": "0.11.0",
+    "@mono-agent/tui": "0.11.0",
+    "@mono-agent/webhook-adapter": "0.11.0",
     "undici": "8.7.0",
     "zod": "^4.4.3"
   },

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

@@ -27,7 +27,7 @@ Every framework capability and how a composed agent reaches it. This table is th
 | Selected skills from a skills root | config | `context.skillsRoot`, `context.selectedSkills` |
 | Generated project configuration skills with progressive disclosure | config + cli | init selects `mono-agent-configure` + `mono-agent-memory` under `./skills` with `context.skillDisclosure: "index"`; drift: `mono-agent install-skill --project --check\|--update` |
 | Per-skill byte cap | config | `context.skillMaxBytes` |
-| Conversation history (bounded in-memory) | auto | 12 messages by default; twice a positive `runtime.maxTurns`; custom store via code |
+| Conversation history (owner-only durable store) | auto | 64 messages per exact conversation id independent of `runtime.maxTurns`; aggregate defaults 256 MiB / 10,000 conversations / 365 inactive days; staged atomic publication and post-commit pruning; custom store via code |
 | Lite memory (FTS keyword recall + rapid-log capture; no external deps) | config | `memory.mode: "lite"`, `path`, `maxBytes`, `writeMode` |
 | Journal memory (hybrid recall BM25+vector + salience decay; needs configured embeddings) | config | `memory.mode: "journal"`, `path`, `memory.embeddings.{provider,endpoint,model,dim,apiKeyEnv}` (`provider: "ollama" | "lmstudio" | "openai"`; exclusive, no cross-provider fallback) |
 | BuJo memory (journal + LLM capture/reconcile ADD/UPDATE/SUPERSEDE/NOOP + entity graph + auto-scheduled consolidation; needs embeddings + an app-level `memory.llm`) | config | `memory.mode: "bujo"`, `path`; selected Ollama/LM Studio/OpenAI embeddings are independent from explicit `memory.llm` with `provider: "ollama"` (`model`, optional `endpoint`) or `provider: "agent-host"` (`model` is an SDK runtime model ref, optional `executionMode: "sdk"`) — see `docs/memory/index.md` |
@@ -45,6 +45,7 @@ Every framework capability and how a composed agent reaches it. This table is th
 | Allow-all tool policy (omitted / `["*"]` = all tools; `[]` = none) | config | default `tools.allowedTools`; the harness no-policy safety net is `failClosedToolPolicy()` |
 | Tool allow/deny lists (deny wins, even under allow-all; pi doesn't deny external MCP tools) | config | `tools.allowedTools`, `tools.disallowedTools` |
 | MCP servers (stdio/sse/http) from a JSON file | config | `tools.mcpConfigPath` |
+| Durable origin-bound continuations for trusted stdio/loopback-HTTP MCP services | config + auto | `tools.continuationServers` + `continuations.*`; interactive claims pin a bounded immutable origin snapshot before commit, exact rollover buckets are preserved, v3 state is restart-safe, and unavailable/legacy snapshots use a fixed zero-model fallback |
 | Adapter-derived send tools for enabled Slack/Telegram adapters | config | auto-available under allow-all once the channel is enabled; a **specific** `tools.allowedTools` must include `SlackSendMessage` / `TelegramSendMessage`; valid `slack.*` / `telegram.*` config and existing adapter allowlists provide credentials and destination bounds |
 | Sandbox on/off + srt engine (Pi-owned tools; direct Codex has its own sandbox, Claude/direct OpenCode reject native mono policy) | config | `sandbox.mode` |
 | Network policy (none/localhost/allowlist/all) | config | `sandbox.network.{mode,allowlist}` |