@mono-agent/agent-app 0.4.0 → 0.4.1

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAKD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAuCpC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,sEAAsE;AACtE,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAKD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAqDpC"}

package/dist/init.js

@@ -1,17 +1,26 @@
 import { mkdir, stat, writeFile } from "node:fs/promises";
-import { basename, join, resolve } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import { writeMonoAgentConfigJson } from "@mono-agent/config";
+import { resolveRecipeInputs } from "./recipes/index.js";
+import { monoAgentConfigWithSchema } from "./config-reference.js";
+/** Channels `--with` can switch on, merged onto a recipe's config. */
+export const WITH_CHANNELS = ["telegram", "slack", "webhook", "openaiApi", "cron"];
+export function isWithChannel(value) {
+    return WITH_CHANNELS.includes(value);
+}
 const DEFAULT_MODEL = "claude:claude-sonnet-4-6";
 const KNOWLEDGE_FILE_CANDIDATES = ["AGENTS.md", "CLAUDE.md", "README.md", "SOUL.md"];
 /**
- * Non-destructively scaffolds a config-first mono-agent folder: a minimal
- * `mono-agent.config.json` (webhook enabled as the zero-credential smoke
- * channel), an `IDENTITY.md` seeded from any knowledge files already in the
- * folder, and the `.mono-agent/` working directories. Existing files are
- * never overwritten.
+ * Non-destructively scaffolds a config-first mono-agent folder: a
+ * `mono-agent.config.json` (from the default smoke scaffold or a recipe), an
+ * `IDENTITY.md` seeded from any knowledge files already in the folder, the
+ * `.mono-agent/` working directories, and — for recipes — a `.env.example` and
+ * any recipe files. Existing files are never overwritten. With `dryRun`, nothing
+ * is written and `created` reports what would have been.
  */
 export async function initMonoAgentFolder(options = {}) {
     const dir = resolve(options.dir ?? process.cwd());
+    const dryRun = options.dryRun === true;
     const created = [];
     const skipped = [];
     const knowledgeFiles = [];
@@ -20,33 +29,84 @@ export async function initMonoAgentFolder(options = {}) {
             knowledgeFiles.push(candidate);
         }
     }
-    const identityPath = join(dir, "IDENTITY.md");
-    if (await pathExists(identityPath)) {
-        skipped.push(identityPath);
-    }
-    else {
-        await writeFile(identityPath, identityTemplate(dir, knowledgeFiles), { flag: "wx" });
-        created.push(identityPath);
+    async function planFile(path, write) {
+        if (await pathExists(path)) {
+            skipped.push(path);
+            return;
+        }
+        if (!dryRun) {
+            await write();
+        }
+        created.push(path);
     }
+    const identityPath = join(dir, "IDENTITY.md");
+    await planFile(identityPath, () => writeFile(identityPath, identityTemplate(dir, knowledgeFiles), { flag: "wx" }));
     for (const subdir of [join(dir, ".mono-agent", "artifacts"), join(dir, ".mono-agent", "workspace")]) {
-        if (await pathExists(subdir)) {
-            skipped.push(subdir);
+        await planFile(subdir, () => mkdir(subdir, { recursive: true }));
+    }
+    const skillsRootExists = await pathExists(join(dir, "skills"));
+    const configJson = await resolveConfigJson(dir, options, skillsRootExists);
+    const configPath = join(dir, "mono-agent.config.json");
+    await planFile(configPath, () => writeMonoAgentConfigJson({ path: configPath, patch: configJson }));
+    if (options.recipe !== undefined) {
+        const inputs = resolveRecipeInputs(options.recipe, recipeOverrides(options.recipe, options));
+        const envExample = options.recipe.envExample?.(inputs);
+        if (envExample !== undefined && envExample.trim().length > 0) {
+            const envExamplePath = join(dir, ".env.example");
+            await planFile(envExamplePath, () => writeFile(envExamplePath, envExample, { flag: "wx" }));
         }
-        else {
-            await mkdir(subdir, { recursive: true });
-            created.push(subdir);
+        for (const file of options.recipe.files?.(inputs) ?? []) {
+            const filePath = join(dir, file.path);
+            await planFile(filePath, async () => {
+                await mkdir(dirname(filePath), { recursive: true });
+                await writeFile(filePath, file.contents, { flag: "wx" });
+            });
         }
     }
-    const configPath = join(dir, "mono-agent.config.json");
-    if (await pathExists(configPath)) {
-        skipped.push(configPath);
+    return { dir, configPath, identityPath, created, skipped, knowledgeFiles, dryRun };
+}
+function recipeOverrides(recipe, options) {
+    const overrides = { ...(options.recipeInputs ?? {}) };
+    for (const input of recipe.inputs) {
+        if (input.secret === true) {
+            delete overrides[input.id];
+        }
+    }
+    if (options.model !== undefined) {
+        overrides.model = options.model;
+    }
+    return overrides;
+}
+async function resolveConfigJson(dir, options, skillsRootExists) {
+    if (options.recipe !== undefined) {
+        const inputs = resolveRecipeInputs(options.recipe, recipeOverrides(options.recipe, options));
+        return monoAgentConfigWithSchema(withChannels(withRuntimeOverrides(options.recipe.config(inputs), options), options.withChannels ?? []));
+    }
+    return monoAgentConfigWithSchema(withChannels(configTemplate(dir, options, skillsRootExists), options.withChannels ?? []));
+}
+function withRuntimeOverrides(config, options) {
+    const fallbackModels = (options.fallbackModels ?? []).filter((entry) => entry.trim().length > 0);
+    if (fallbackModels.length === 0) {
+        return config;
+    }
+    return {
+        ...config,
+        runtime: {
+            ...(config.runtime ?? {}),
+            fallbackModels,
+        },
+    };
+}
+/** Switch on additional channels by merging `{ <channel>: { enabled: true } }`. */
+function withChannels(config, channels) {
+    if (channels.length === 0) {
+        return config;
     }
-    else {
-        const skillsRootExists = await pathExists(join(dir, "skills"));
-        await writeMonoAgentConfigJson({ path: configPath, patch: configTemplate(dir, options, skillsRootExists) });
-        created.push(configPath);
+    const extra = {};
+    for (const channel of channels) {
+        extra[channel] = { enabled: true };
     }
-    return { dir, configPath, identityPath, created, skipped, knowledgeFiles };
+    return { ...config, ...extra };
 }
 function configTemplate(dir, options, skillsRootExists) {
     const fallbackModels = (options.fallbackModels ?? []).filter((entry) => entry.trim().length > 0);
@@ -76,6 +136,11 @@ function configTemplate(dir, options, skillsRootExists) {
         },
         artifacts: {
             dir: "./.mono-agent/artifacts",
+            retention: {
+                maxAgeDays: 365,
+                maxCount: 50000,
+                dryRun: false,
+            },
         },
         traceability: {
             registryDir: "./.mono-agent/trace-sources",

package/dist/init.js.map

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

package/dist/install-skill.d.ts

@@ -14,7 +14,7 @@ export interface InstallSkillResult {
 export declare const COMPOSER_SKILL_NAME = "mono-agent-composer";
 /**
  * Copies the bundled mono-agent-composer skill into the harness skill folders
- * (~/.claude/skills and/or ~/.codex/skills) so Claude Code and Codex can use
+ * (~/.claude/skills and/or ~/.agents/skills) so Claude Code and Codex can use
  * it to compose new agents.
  */
 export declare function installComposerSkill(options: InstallSkillOptions): Promise<InstallSkillResult>;

package/dist/install-skill.js

@@ -8,11 +8,11 @@ export const COMPOSER_SKILL_NAME = "mono-agent-composer";
 const BUNDLED_SKILL_DIR = fileURLToPath(new URL(`../skills/${COMPOSER_SKILL_NAME}`, import.meta.url));
 const TARGET_HARNESS_DIRS = {
     claude: ".claude",
-    codex: ".codex",
+    codex: ".agents",
 };
 /**
  * Copies the bundled mono-agent-composer skill into the harness skill folders
- * (~/.claude/skills and/or ~/.codex/skills) so Claude Code and Codex can use
+ * (~/.claude/skills and/or ~/.agents/skills) so Claude Code and Codex can use
  * it to compose new agents.
  */
 export async function installComposerSkill(options) {

package/dist/install-skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-skill.js","sourceRoot":"","sources":["../src/install-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkBzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,mBAAmB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtG,MAAM,mBAAmB,GAAkE;IACzF,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA4B;IACrE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACzD,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE,OAAO,CAAW,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,MAAM,CAAW,CAAC;IACzG,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAErH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,eAAe,WAAW,oDAAoD,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,6BAA6B,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"install-skill.js","sourceRoot":"","sources":["../src/install-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkBzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,mBAAmB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtG,MAAM,mBAAmB,GAAkE;IACzF,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA4B;IACrE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACzD,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE,OAAO,CAAW,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,MAAM,CAAW,CAAC;IACzG,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAErH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,eAAe,WAAW,oDAAoD,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,6BAA6B,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/interaction-bridge.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Interaction bridge: the app-owned loopback HTTP surface that lets tool child
+ * processes (adapter-send-tools, project MCP servers) interact with the human
+ * behind a channel conversation while a tool call is in flight.
+ *
+ * Two capabilities share it:
+ * - Blocking `ask_user`: POST /v1/asks registers a pending ask (question posted
+ *   through the channel's sink); the tool long-polls GET /v1/asks/:id until the
+ *   channel intercepts the user's next message and resolves it.
+ * - Tool progress: POST /v1/progress fans out to the channel sink's postStatus
+ *   (e.g. a Telegram status message edited in place).
+ *
+ * The registry is in-memory by design: on an app restart pending asks vanish and
+ * the user's later reply simply arrives as a normal next turn (multi-turn
+ * degradation), which the ask_user tool description tells the model to expect.
+ */
+export interface ChannelInteractionSink {
+    /** Post a free-text question to the conversation's chat. */
+    postQuestion(conversationId: string, text: string): Promise<void>;
+    /** Post (or edit in place, per `key`) a short tool-progress status line. */
+    postStatus(conversationId: string, text: string, options: {
+        readonly key: string;
+        readonly state: "working" | "done" | "failed";
+    }): Promise<void>;
+}
+export interface InteractionBridgeOptions {
+    readonly host?: string;
+    /** TCP port; 0 picks an ephemeral port. Default {@link DEFAULT_INTERACTION_BRIDGE_PORT}. */
+    readonly port?: number;
+    /** Default + upper bound for a single ask's wait (ms). Default 10 minutes. */
+    readonly askTimeoutMs?: number;
+    readonly logger?: {
+        warn?: (message: string, metadata?: Record<string, unknown>) => void;
+        debug?: (message: string, metadata?: Record<string, unknown>) => void;
+    };
+}
+export interface InteractionBridgeHandle {
+    readonly url: string;
+    readonly token: string;
+    registerSink(channelId: string, sink: ChannelInteractionSink): void;
+    /** Resolve the conversation's pending ask with the user's reply; true when consumed. */
+    tryResolveAsk(conversationId: string, answer: string): boolean;
+    /** Fail every pending ask on the conversation (user cancelled the run). */
+    cancelAsks(conversationId: string): void;
+    /** Environment consumed by tool child processes (ask_user, project MCP servers). */
+    env(): Record<string, string>;
+    stop(): Promise<void>;
+}
+/** Default port 0 = ephemeral: consumers get the URL via env, so a fixed port only invites collisions. */
+export declare const DEFAULT_INTERACTION_BRIDGE_PORT = 0;
+export declare const DEFAULT_ASK_USER_TIMEOUT_MS = 600000;
+/** Resolved `interaction` config block (JSON `interaction` key + env overrides). */
+export interface InteractionSettings {
+    /** True when the operator explicitly configured the block (JSON or env). */
+    readonly configured: boolean;
+    readonly host: string;
+    readonly port: number;
+    readonly askTimeoutMs: number;
+    readonly progressEnabled: boolean;
+}
+/**
+ * Load the app-level `interaction` block from `mono-agent.config.json` with env
+ * overrides (`MONO_AGENT_INTERACTION_BRIDGE_HOST/PORT`,
+ * `MONO_AGENT_ASK_USER_TIMEOUT_MS`, `MONO_AGENT_PROGRESS_ENABLED`). Tolerant of
+ * a missing file/block: returns unconfigured defaults.
+ */
+export declare function loadInteractionSettings(input: {
+    readonly env: Record<string, string | undefined>;
+    readonly configPath: string;
+}): Promise<InteractionSettings>;
+export declare function startInteractionBridge(options?: InteractionBridgeOptions): Promise<InteractionBridgeHandle>;
+//# sourceMappingURL=interaction-bridge.d.ts.map

package/dist/interaction-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-bridge.d.ts","sourceRoot":"","sources":["../src/interaction-bridge.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,4EAA4E;IAC5E,UAAU,CACR,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;KAAE,GAC/E,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACrE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACvE,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACpE,wFAAwF;IACxF,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,2EAA2E;IAC3E,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,oFAAoF;IACpF,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,0GAA0G;AAC1G,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8B/B;AA+CD,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAwPlC"}

package/dist/interaction-bridge.js

@@ -0,0 +1,354 @@
+import { randomBytes } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { createServer } from "node:http";
+/** Default port 0 = ephemeral: consumers get the URL via env, so a fixed port only invites collisions. */
+export const DEFAULT_INTERACTION_BRIDGE_PORT = 0;
+export const DEFAULT_ASK_USER_TIMEOUT_MS = 600_000;
+/**
+ * Load the app-level `interaction` block from `mono-agent.config.json` with env
+ * overrides (`MONO_AGENT_INTERACTION_BRIDGE_HOST/PORT`,
+ * `MONO_AGENT_ASK_USER_TIMEOUT_MS`, `MONO_AGENT_PROGRESS_ENABLED`). Tolerant of
+ * a missing file/block: returns unconfigured defaults.
+ */
+export async function loadInteractionSettings(input) {
+    let block = {};
+    let present = false;
+    try {
+        const parsed = JSON.parse(await readFile(input.configPath, "utf8"));
+        const interaction = parsed?.interaction;
+        if (typeof interaction === "object" && interaction !== null) {
+            block = interaction;
+            present = true;
+        }
+    }
+    catch {
+        // Missing or invalid config file: the core loader reports that; here we just
+        // fall back to defaults.
+    }
+    const bridge = (block.bridge ?? {});
+    const askUser = (block.askUser ?? {});
+    const progress = (block.progress ?? {});
+    const envHost = trimmed(input.env.MONO_AGENT_INTERACTION_BRIDGE_HOST);
+    const envPort = integerOf(input.env.MONO_AGENT_INTERACTION_BRIDGE_PORT);
+    const envTimeout = integerOf(input.env.MONO_AGENT_ASK_USER_TIMEOUT_MS);
+    const envProgress = trimmed(input.env.MONO_AGENT_PROGRESS_ENABLED);
+    const configured = present || envHost !== undefined || envPort !== undefined || envTimeout !== undefined || envProgress !== undefined;
+    return {
+        configured,
+        host: envHost ?? (typeof bridge.host === "string" ? bridge.host : "127.0.0.1"),
+        port: envPort ?? integerValue(bridge.port) ?? DEFAULT_INTERACTION_BRIDGE_PORT,
+        askTimeoutMs: envTimeout ?? integerValue(askUser.timeoutMs) ?? DEFAULT_ASK_USER_TIMEOUT_MS,
+        progressEnabled: envProgress !== undefined ? envProgress !== "false" : progress.enabled !== false,
+    };
+}
+function trimmed(value) {
+    const normalized = value?.trim();
+    return normalized === undefined || normalized.length === 0 ? undefined : normalized;
+}
+function integerOf(value) {
+    const normalized = trimmed(value);
+    if (normalized === undefined || !/^\d+$/u.test(normalized)) {
+        return undefined;
+    }
+    return Number.parseInt(normalized, 10);
+}
+function integerValue(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : undefined;
+}
+/** Per-request long-poll wait cap, keeping every HTTP request comfortably short-lived. */
+const MAX_LONG_POLL_WAIT_MS = 25_000;
+const MAX_BODY_BYTES = 64 * 1024;
+/** Strip the daily-rollover `#bucket` suffix so registry keys match the channel's base id. */
+function normalizeConversationId(conversationId) {
+    return conversationId.split("#", 1)[0] ?? conversationId;
+}
+function channelIdOf(conversationId) {
+    return conversationId.split(":", 1)[0] ?? conversationId;
+}
+export async function startInteractionBridge(options = {}) {
+    const host = options.host ?? "127.0.0.1";
+    const askTimeoutMs = options.askTimeoutMs ?? DEFAULT_ASK_USER_TIMEOUT_MS;
+    const token = randomBytes(24).toString("base64url");
+    const sinks = new Map();
+    // One pending ask per conversation; a second concurrent ask is a 409 by design
+    // (the model must consolidate its questions instead of stacking them).
+    const asksByConversation = new Map();
+    const asksById = new Map();
+    let askCounter = 0;
+    function settleAsk(ask, status, answer) {
+        if (ask.status !== "pending") {
+            return;
+        }
+        ask.status = status;
+        if (answer !== undefined) {
+            ask.answer = answer;
+        }
+        clearTimeout(ask.expiryTimer);
+        asksByConversation.delete(ask.conversationId);
+        const snapshot = snapshotOf(ask);
+        for (const waiter of ask.waiters) {
+            waiter(snapshot);
+        }
+        ask.waiters.clear();
+    }
+    function snapshotOf(ask) {
+        return ask.status === "answered" && ask.answer !== undefined
+            ? { status: ask.status, answer: ask.answer }
+            : { status: ask.status };
+    }
+    function registerAsk(conversationId, question, timeoutMs) {
+        askCounter += 1;
+        const askId = `ask-${String(askCounter)}-${randomBytes(6).toString("base64url")}`;
+        const ask = {
+            askId,
+            conversationId,
+            status: "pending",
+            waiters: new Set(),
+            expiryTimer: setTimeout(() => settleAsk(ask, "expired"), timeoutMs),
+        };
+        ask.expiryTimer.unref?.();
+        asksByConversation.set(conversationId, ask);
+        asksById.set(askId, ask);
+        return ask;
+    }
+    async function handleCreateAsk(request, response) {
+        const body = await readJsonBody(request);
+        const conversationIdRaw = stringField(body, "conversationId");
+        const question = stringField(body, "question");
+        if (conversationIdRaw === undefined || question === undefined) {
+            sendJson(response, 400, { error: "conversationId and question are required." });
+            return;
+        }
+        const conversationId = normalizeConversationId(conversationIdRaw);
+        const sink = sinks.get(channelIdOf(conversationId));
+        if (sink === undefined) {
+            sendJson(response, 501, {
+                error: `no interactive channel is registered for "${channelIdOf(conversationId)}" — ask in your final reply instead.`,
+            });
+            return;
+        }
+        if (asksByConversation.has(conversationId)) {
+            sendJson(response, 409, { error: "a question is already pending on this conversation; wait for its answer." });
+            return;
+        }
+        const requested = numberField(body, "timeoutMs");
+        // The config value is both the default and the ceiling: tools may wait less,
+        // never more, than the operator allowed.
+        const timeoutMs = Math.min(requested ?? askTimeoutMs, askTimeoutMs);
+        const ask = registerAsk(conversationId, question, timeoutMs);
+        try {
+            await sink.postQuestion(conversationId, question);
+        }
+        catch (error) {
+            settleAsk(ask, "cancelled");
+            asksById.delete(ask.askId);
+            options.logger?.warn?.("interaction bridge: posting the ask question failed.", {
+                conversationId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            sendJson(response, 502, { error: "posting the question to the channel failed." });
+            return;
+        }
+        sendJson(response, 201, { askId: ask.askId, timeoutMs });
+    }
+    function handleAwaitAsk(request, response, askId, url) {
+        const ask = asksById.get(askId);
+        if (ask === undefined) {
+            sendJson(response, 404, { error: "unknown askId." });
+            return;
+        }
+        if (ask.status !== "pending") {
+            // Terminal snapshots are single-consumer: the asking tool reads it once.
+            asksById.delete(askId);
+            sendJson(response, 200, snapshotOf(ask));
+            return;
+        }
+        const waitMs = Math.min(Math.max(Number(url.searchParams.get("waitMs")) || 0, 0), MAX_LONG_POLL_WAIT_MS);
+        if (waitMs === 0) {
+            sendJson(response, 200, snapshotOf(ask));
+            return;
+        }
+        let settled = false;
+        const respond = (snapshot) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(pollTimer);
+            ask.waiters.delete(respond);
+            if (snapshot.status !== "pending") {
+                asksById.delete(askId);
+            }
+            sendJson(response, 200, snapshot);
+        };
+        const pollTimer = setTimeout(() => respond({ status: "pending" }), waitMs);
+        pollTimer.unref?.();
+        ask.waiters.add(respond);
+        request.on("close", () => {
+            clearTimeout(pollTimer);
+            ask.waiters.delete(respond);
+        });
+    }
+    async function handleProgress(request, response) {
+        const body = await readJsonBody(request);
+        const conversationIdRaw = stringField(body, "conversationId");
+        const key = stringField(body, "key");
+        const message = stringField(body, "message");
+        if (conversationIdRaw === undefined || key === undefined || message === undefined) {
+            sendJson(response, 400, { error: "conversationId, key, and message are required." });
+            return;
+        }
+        const state = stringField(body, "state");
+        const conversationId = normalizeConversationId(conversationIdRaw);
+        const sink = sinks.get(channelIdOf(conversationId));
+        if (sink === undefined) {
+            sendJson(response, 501, { error: "no interactive channel is registered for this conversation." });
+            return;
+        }
+        // Accepted before delivery: progress is best-effort by contract and a slow
+        // channel edit must not stall the reporting tool.
+        sendJson(response, 202, { ok: true });
+        void sink
+            .postStatus(conversationId, message, {
+            key,
+            state: state === "done" || state === "failed" ? state : "working",
+        })
+            .catch((error) => {
+            options.logger?.debug?.("interaction bridge: progress post failed (best-effort).", {
+                conversationId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        });
+    }
+    const server = createServer((request, response) => {
+        void routeRequest(request, response).catch((error) => {
+            options.logger?.warn?.("interaction bridge: request handling failed.", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (!response.headersSent) {
+                sendJson(response, 500, { error: "internal error." });
+            }
+            else {
+                response.end();
+            }
+        });
+    });
+    async function routeRequest(request, response) {
+        if (request.headers.authorization !== `Bearer ${token}`) {
+            sendJson(response, 401, { error: "missing or invalid bearer token." });
+            return;
+        }
+        const url = new URL(request.url ?? "/", "http://bridge.local");
+        if (request.method === "POST" && url.pathname === "/v1/asks") {
+            await handleCreateAsk(request, response);
+            return;
+        }
+        const askMatch = /^\/v1\/asks\/([^/]+)$/u.exec(url.pathname);
+        if (askMatch !== null && request.method === "GET") {
+            handleAwaitAsk(request, response, askMatch[1], url);
+            return;
+        }
+        if (askMatch !== null && request.method === "DELETE") {
+            const ask = asksById.get(askMatch[1]);
+            if (ask !== undefined) {
+                settleAsk(ask, "cancelled");
+                asksById.delete(ask.askId);
+            }
+            response.statusCode = 204;
+            response.end();
+            return;
+        }
+        if (request.method === "POST" && url.pathname === "/v1/progress") {
+            await handleProgress(request, response);
+            return;
+        }
+        sendJson(response, 404, { error: "unknown route." });
+    }
+    await listenOn(server, host, options.port ?? DEFAULT_INTERACTION_BRIDGE_PORT);
+    const address = server.address();
+    const port = typeof address === "object" && address !== null ? address.port : 0;
+    const url = `http://${host}:${String(port)}`;
+    return {
+        url,
+        token,
+        registerSink(channelId, sink) {
+            sinks.set(channelId, sink);
+        },
+        tryResolveAsk(conversationId, answer) {
+            const ask = asksByConversation.get(normalizeConversationId(conversationId));
+            if (ask === undefined) {
+                return false;
+            }
+            settleAsk(ask, "answered", answer);
+            return true;
+        },
+        cancelAsks(conversationId) {
+            const ask = asksByConversation.get(normalizeConversationId(conversationId));
+            if (ask !== undefined) {
+                settleAsk(ask, "cancelled");
+            }
+        },
+        env() {
+            return {
+                MONO_AGENT_INTERACTION_BRIDGE_URL: url,
+                MONO_AGENT_INTERACTION_BRIDGE_TOKEN: token,
+                MONO_AGENT_ASK_USER_TIMEOUT_MS: String(askTimeoutMs),
+            };
+        },
+        async stop() {
+            for (const ask of asksById.values()) {
+                settleAsk(ask, "cancelled");
+            }
+            asksById.clear();
+            await new Promise((resolve, reject) => {
+                server.close((error) => (error === undefined || error === null ? resolve() : reject(error)));
+            });
+        },
+    };
+}
+async function listenOn(server, host, port) {
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, host, () => {
+            server.removeListener("error", reject);
+            resolve();
+        });
+    });
+}
+async function readJsonBody(request) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of request) {
+        const buffer = chunk;
+        total += buffer.byteLength;
+        if (total > MAX_BODY_BYTES) {
+            throw new Error("request body too large.");
+        }
+        chunks.push(buffer);
+    }
+    if (total === 0) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+        return typeof parsed === "object" && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function stringField(body, key) {
+    const value = body[key];
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+function numberField(body, key) {
+    const value = body[key];
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : undefined;
+}
+function sendJson(response, statusCode, body) {
+    const payload = JSON.stringify(body);
+    response.statusCode = statusCode;
+    response.setHeader("content-type", "application/json");
+    response.end(payload);
+}
+//# sourceMappingURL=interaction-bridge.js.map