@mono-agent/agent-app 0.4.0 → 0.5.0

package/dist/metrics.js

@@ -0,0 +1,105 @@
+import { resolve } from "node:path";
+import process from "node:process";
+import { summarizeRecordedRunMetrics } from "@mono-agent/observability";
+import { resolveAppArtifactDir } from "./app-config.js";
+export async function runMetrics(args) {
+    const cwd = process.cwd();
+    const input = {
+        env: process.env,
+        cwd,
+        configPath: resolve(cwd, args.configPath ?? "mono-agent.config.json"),
+    };
+    let report;
+    try {
+        const artifactDir = args.artifactDir === undefined
+            ? await resolveAppArtifactDir(input)
+            : resolve(cwd, args.artifactDir);
+        report = await summarizeRecordedRunMetrics({
+            artifactDir,
+            ...(args.since === undefined ? {} : { since: args.since }),
+            ...(args.until === undefined ? {} : { until: args.until }),
+            ...(args.groupBy === undefined ? {} : { groupBy: args.groupBy }),
+            scope: args.includeMemory === true ? "all" : "agent",
+        });
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    process.stdout.write(args.json === true ? `${JSON.stringify(report, null, 2)}\n` : renderMetricsReport(report));
+    return 0;
+}
+export function renderMetricsReport(report) {
+    let out = `Artifact metrics: ${report.artifactDir}\n`;
+    out += `Summary files: ${report.totalSummaryFiles} (${report.parsedSummaryFiles} parsed, ${report.parseFailureCount} parse failed)\n`;
+    if (report.since !== undefined || report.until !== undefined) {
+        out += `Window: ${report.since ?? "-inf"} to ${report.until ?? "+inf"}\n`;
+    }
+    out += renderBucket(report.overall);
+    if (report.groups.length > 0 && report.groupBy !== undefined) {
+        out += `\nGroups by ${report.groupBy}\n`;
+        for (const group of report.groups) {
+            out += `  ${group.key}: ${group.totalRuns} run${group.totalRuns === 1 ? "" : "s"}`;
+            out += `, failed ${group.statusCounts.failed} (${formatPercent(group.statusRates.failed)})`;
+            out += `, p90 ${formatDuration(group.durationMs.p90)}`;
+            out += `, cost ${formatUsd(group.cost.totalUsd)}\n`;
+        }
+    }
+    if (report.parseFailures.length > 0) {
+        out += "\nParse failures\n";
+        for (const issue of report.parseFailures) {
+            const value = issue.value === undefined ? "" : ` (${issue.value})`;
+            out += `  ${issue.fileName}: ${issue.reason}${value}\n`;
+        }
+    }
+    if (report.warnings.length > 0) {
+        out += "\nWarnings\n";
+        for (const warning of report.warnings) {
+            out += `  ${warning}\n`;
+        }
+    }
+    return out;
+}
+function renderBucket(bucket) {
+    let out = `Total runs: ${bucket.totalRuns}\n`;
+    out += "\nStatuses\n";
+    for (const [status, count] of Object.entries(bucket.statusCounts)) {
+        out += `  ${status}: ${count} (${formatPercent(bucket.statusRates[status])})\n`;
+    }
+    out += "\nDuration\n";
+    out += `  samples: ${bucket.durationMs.count}\n`;
+    out += `  p50: ${formatDuration(bucket.durationMs.p50)}\n`;
+    out += `  p90: ${formatDuration(bucket.durationMs.p90)}\n`;
+    out += `  p99: ${formatDuration(bucket.durationMs.p99)}\n`;
+    out += `  max: ${formatDuration(bucket.durationMs.max)}\n`;
+    out += "\nCost\n";
+    out += `  total: ${formatUsd(bucket.cost.totalUsd)}\n`;
+    out += `  average/run: ${formatUsd(bucket.cost.averageUsdPerRun)}\n`;
+    out += `  runs with cost: ${bucket.cost.runsWithCost}\n`;
+    out += "\nFailure kinds\n";
+    if (bucket.failureKindRates.length === 0) {
+        out += "  none\n";
+    }
+    else {
+        for (const failureKind of bucket.failureKindRates) {
+            out += `  ${failureKind.failureKind}: ${failureKind.count} (${formatPercent(failureKind.rate)})\n`;
+        }
+    }
+    return out;
+}
+function formatPercent(rate) {
+    const fixed = (rate * 100).toFixed(1);
+    return `${fixed.replace(/\.0$/u, "")}%`;
+}
+function formatDuration(value) {
+    return value === null ? "n/a" : `${formatNumber(value)} ms`;
+}
+function formatUsd(value) {
+    return `$${formatNumber(value, 6)}`;
+}
+function formatNumber(value, maxFractionDigits = 3) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: maxFractionDigits,
+    }).format(value);
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAaxD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,KAAK,GAA4B;QACrC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG;QACH,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,IAAI,wBAAwB,CAAC;KACtE,CAAC;IAEF,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS;YAChD,CAAC,CAAC,MAAM,qBAAqB,CAAC,KAAK,CAAC;YACpC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,GAAG,MAAM,2BAA2B,CAAC;YACzC,WAAW;YACX,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YAChE,KAAK,EAAE,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;SACrD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChH,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAgC;IAClE,IAAI,GAAG,GAAG,qBAAqB,MAAM,CAAC,WAAW,IAAI,CAAC;IACtD,GAAG,IAAI,kBAAkB,MAAM,CAAC,iBAAiB,KAAK,MAAM,CAAC,kBAAkB,YAAY,MAAM,CAAC,iBAAiB,kBAAkB,CAAC;IACtI,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7D,GAAG,IAAI,WAAW,MAAM,CAAC,KAAK,IAAI,MAAM,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,IAAI,CAAC;IAC5E,CAAC;IACD,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7D,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,IAAI,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,GAAG,IAAI,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACnF,GAAG,IAAI,YAAY,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;YAC5F,GAAG,IAAI,SAAS,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,GAAG,IAAI,UAAU,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,GAAG,IAAI,oBAAoB,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC;YACnE,GAAG,IAAI,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,MAAM,GAAG,KAAK,IAAI,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,GAAG,IAAI,cAAc,CAAC;QACtB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,GAAG,IAAI,KAAK,OAAO,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,MAAgC;IACpD,IAAI,GAAG,GAAG,eAAe,MAAM,CAAC,SAAS,IAAI,CAAC;IAC9C,GAAG,IAAI,cAAc,CAAC;IACtB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAClE,GAAG,IAAI,KAAK,MAAM,KAAK,KAAK,KAAK,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,MAAyC,CAAC,CAAC,KAAK,CAAC;IACrH,CAAC;IACD,GAAG,IAAI,cAAc,CAAC;IACtB,GAAG,IAAI,cAAc,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjD,GAAG,IAAI,UAAU,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3D,GAAG,IAAI,UAAU,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3D,GAAG,IAAI,UAAU,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3D,GAAG,IAAI,UAAU,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3D,GAAG,IAAI,UAAU,CAAC;IAClB,GAAG,IAAI,YAAY,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IACvD,GAAG,IAAI,kBAAkB,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;IACrE,GAAG,IAAI,qBAAqB,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC;IACzD,GAAG,IAAI,mBAAmB,CAAC;IAC3B,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,GAAG,IAAI,UAAU,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAClD,GAAG,IAAI,KAAK,WAAW,CAAC,WAAW,KAAK,WAAW,CAAC,KAAK,KAAK,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QACrG,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,KAAoB;IAC1C,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,iBAAiB,GAAG,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,qBAAqB,EAAE,iBAAiB;KACzC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/notify-destinations.d.ts

@@ -0,0 +1,23 @@
+import type { NotifyDestination } from "@mono-agent/agent-contracts";
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+import type { ChannelId, MonoAgentAppLogger } from "./channels.js";
+export type { NotifyDestination } from "@mono-agent/agent-contracts";
+export interface ResolveNotifyDestinationsInput {
+    readonly input: MonoAgentAppConfigInput;
+    readonly artifactDir: string;
+    /** Whether a given channel is currently running (only running channels can deliver). */
+    readonly isRunning: (id: ChannelId) => boolean;
+    readonly logger?: MonoAgentAppLogger | undefined;
+}
+/**
+ * The conversations a native cron/webhook notification may be delivered to, used by
+ * the app to infer a destination when a job/endpoint sets no explicit
+ * `notifyConversationId`. Combines two id-free sources so the operator never types a conversationId:
+ *  - conversations the agent has actually handled (run-artifact summaries), filtered to
+ *    notify-capable + running channels, newest-first;
+ *  - the adapter allowlist entries (when not allow-all), surfaced as candidates the agent
+ *    can reach even before it has conversed there (covers a fresh single-user agent).
+ * WhatsApp is excluded (no notify hook yet) so the agent never picks an undeliverable id.
+ */
+export declare function resolveNotifyDestinations(opts: ResolveNotifyDestinationsInput): Promise<readonly NotifyDestination[]>;
+//# sourceMappingURL=notify-destinations.d.ts.map

package/dist/notify-destinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-destinations.d.ts","sourceRoot":"","sources":["../src/notify-destinations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKnE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAiBrE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAClD;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CA6BvC"}

package/dist/notify-destinations.js

@@ -0,0 +1,79 @@
+import { listSeenNotifyDestinations } from "./seen-conversations.js";
+let slackModule;
+let telegramModule;
+const loadSlackModule = async () => (slackModule ??= await import("@mono-agent/slack-adapter"));
+const loadTelegramModule = async () => (telegramModule ??= await import("@mono-agent/telegram-adapter"));
+/** Channels whose conversations can receive a proactive notification turn. */
+const NOTIFY_CAPABLE = new Set(["telegram", "slack"]);
+/**
+ * The conversations a native cron/webhook notification may be delivered to, used by
+ * the app to infer a destination when a job/endpoint sets no explicit
+ * `notifyConversationId`. Combines two id-free sources so the operator never types a conversationId:
+ *  - conversations the agent has actually handled (run-artifact summaries), filtered to
+ *    notify-capable + running channels, newest-first;
+ *  - the adapter allowlist entries (when not allow-all), surfaced as candidates the agent
+ *    can reach even before it has conversed there (covers a fresh single-user agent).
+ * WhatsApp is excluded (no notify hook yet) so the agent never picks an undeliverable id.
+ */
+export async function resolveNotifyDestinations(opts) {
+    const out = [];
+    const present = new Set();
+    const seen = await listSeenNotifyDestinations(opts.artifactDir);
+    for (const sighting of seen) {
+        if (!NOTIFY_CAPABLE.has(sighting.channelId) || !opts.isRunning(sighting.channelId)) {
+            continue;
+        }
+        out.push({
+            conversationId: sighting.conversationId,
+            channelId: sighting.channelId,
+            ...(sighting.lastSeen === undefined ? {} : { lastSeen: sighting.lastSeen }),
+        });
+        present.add(sighting.conversationId);
+    }
+    if (opts.isRunning("telegram")) {
+        for (const chatId of await telegramAllowlist(opts)) {
+            addAllowlisted(out, present, `telegram:${chatId}`, "telegram");
+        }
+    }
+    if (opts.isRunning("slack")) {
+        for (const channelId of await slackAllowlist(opts)) {
+            addAllowlisted(out, present, `slack:${channelId}`, "slack");
+        }
+    }
+    return out;
+}
+function addAllowlisted(out, present, conversationId, channelId) {
+    if (present.has(conversationId)) {
+        return;
+    }
+    present.add(conversationId);
+    out.push({ conversationId, channelId, fromAllowlist: true });
+}
+/** Allowlisted Telegram chat ids (empty when allow-all, disabled, or unavailable — no enumerable candidate). */
+async function telegramAllowlist(opts) {
+    try {
+        const adapter = await loadTelegramModule();
+        const config = await adapter.loadTelegramAdapterConfig({ env: opts.input.env, jsonPath: opts.input.configPath });
+        return config.enabled && !config.allowAllChats ? config.allowedChatIds : [];
+    }
+    catch (error) {
+        opts.logger?.warn?.("notify destinations: telegram allowlist unavailable.", { reason: reasonOf(error) });
+        return [];
+    }
+}
+/** Allowlisted Slack channel ids (empty when allow-all, disabled, or unavailable). */
+async function slackAllowlist(opts) {
+    try {
+        const adapter = await loadSlackModule();
+        const config = await adapter.loadSlackAdapterConfig({ env: opts.input.env, jsonPath: opts.input.configPath });
+        return config.enabled && !config.allowAllChannels ? config.allowedChannelIds : [];
+    }
+    catch (error) {
+        opts.logger?.warn?.("notify destinations: slack allowlist unavailable.", { reason: reasonOf(error) });
+        return [];
+    }
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=notify-destinations.js.map

package/dist/notify-destinations.js.map

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

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

@@ -0,0 +1,61 @@
+/**
+ * Maps a message the agent POSTED (`channelId` + Slack `ts`) back to the
+ * conversation that produced it, so a later in-thread reply can be resolved to
+ * that conversation and continue its history/session.
+ *
+ * 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
+ * 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
+ * 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
+ * collides with run-artifact tooling.
+ */
+export declare const POSTED_MESSAGE_INDEX_FILENAME = "posted-message-index.jsonl";
+export interface PostedMessageEntry {
+    /** Slack channel/DM id the message was posted to. */
+    readonly channelId: string;
+    /** Slack message timestamp returned by `chat.postMessage`. */
+    readonly ts: string;
+    /** Producing conversationId, de-bucketed to its base form. */
+    readonly conversationId: string;
+    /** ISO timestamp of when the entry was written. */
+    readonly writtenAt: string;
+}
+/** The single index-file path both producer and consumer agree on. */
+export declare function resolvePostedMessageIndexPath(artifactDir: string): string;
+/** Strip a trailing daily-rollover bucket so the stored id is the base producing id. */
+export declare function basePostedConversationId(conversationId: string): string;
+/**
+ * Record that `conversationId` posted a message at `(channelId, ts)`. Best-effort:
+ * a failed index write must never fail the Slack post, so callers should not await
+ * this in a way that surfaces its errors — it swallows them. The stored
+ * conversationId is de-bucketed so the consumer can let the responder re-bucket to
+ * the reply's own day (consistent with daily session rollover).
+ */
+export declare function appendPostedMessage(indexPath: string, entry: {
+    channelId: string;
+    ts: string;
+    conversationId: string;
+}, now?: () => Date): Promise<void>;
+/**
+ * Resolve the producing conversationId for a posted message, newest write wins.
+ * Returns `undefined` when the file is missing or has no matching entry, so the
+ * caller falls back to the default (a fresh `slack:` conversation) — no regression.
+ */
+export declare function lookupProducingConversation(indexPath: string, channelId: string, ts: string): Promise<string | undefined>;
+/**
+ * Bound file growth by rewriting the index with only the newest `maxEntries`
+ * (by write time, de-duped to the newest entry per `channel+ts`). Consumer-only —
+ * a single process compacts, via temp-file + rename so a concurrent append is
+ * never interleaved with a partial rewrite. Best-effort.
+ */
+export declare function compactPostedMessageIndex(indexPath: string, maxEntries?: number): Promise<void>;
+//# sourceMappingURL=posted-message-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posted-message-index.d.ts","sourceRoot":"","sources":["../src/posted-message-index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAO1E,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAChE,GAAG,GAAE,MAAM,IAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAoC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/posted-message-index.js

@@ -0,0 +1,178 @@
+import { appendFile, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/**
+ * Maps a message the agent POSTED (`channelId` + Slack `ts`) back to the
+ * conversation that produced it, so a later in-thread reply can be resolved to
+ * that conversation and continue its history/session.
+ *
+ * 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
+ * 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
+ * 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
+ * collides with run-artifact tooling.
+ */
+export const POSTED_MESSAGE_INDEX_FILENAME = "posted-message-index.jsonl";
+/** Daily-rollover bucket suffix the responder appends (`…#2026-06-22`). */
+const ROLLOVER_BUCKET = /#\d{4}-\d{2}-\d{2}$/u;
+const DEFAULT_COMPACT_MAX_ENTRIES = 5000;
+/** The single index-file path both producer and consumer agree on. */
+export function resolvePostedMessageIndexPath(artifactDir) {
+    return join(artifactDir, POSTED_MESSAGE_INDEX_FILENAME);
+}
+/** Strip a trailing daily-rollover bucket so the stored id is the base producing id. */
+export function basePostedConversationId(conversationId) {
+    return conversationId.replace(ROLLOVER_BUCKET, "");
+}
+/**
+ * Record that `conversationId` posted a message at `(channelId, ts)`. Best-effort:
+ * a failed index write must never fail the Slack post, so callers should not await
+ * this in a way that surfaces its errors — it swallows them. The stored
+ * conversationId is de-bucketed so the consumer can let the responder re-bucket to
+ * the reply's own day (consistent with daily session rollover).
+ */
+export async function appendPostedMessage(indexPath, entry, now = () => new Date()) {
+    const channelId = entry.channelId.trim();
+    const ts = entry.ts.trim();
+    const conversationId = basePostedConversationId(entry.conversationId.trim());
+    if (channelId.length === 0 || ts.length === 0 || conversationId.length === 0) {
+        return;
+    }
+    const record = {
+        channelId,
+        ts,
+        conversationId,
+        writtenAt: now().toISOString(),
+    };
+    const line = `${JSON.stringify(record)}\n`;
+    try {
+        await appendFile(indexPath, line, "utf8");
+    }
+    catch (error) {
+        if (error?.code !== "ENOENT") {
+            return; // best-effort
+        }
+        // Artifact dir not created yet (agent never wrote a summary here). Create it
+        // and retry once; still best-effort.
+        try {
+            await mkdir(dirname(indexPath), { recursive: true });
+            await appendFile(indexPath, line, "utf8");
+        }
+        catch {
+            // Give up silently.
+        }
+    }
+}
+/**
+ * Resolve the producing conversationId for a posted message, newest write wins.
+ * Returns `undefined` when the file is missing or has no matching entry, so the
+ * caller falls back to the default (a fresh `slack:` conversation) — no regression.
+ */
+export async function lookupProducingConversation(indexPath, channelId, ts) {
+    const wantChannel = channelId.trim();
+    const wantTs = ts.trim();
+    if (wantChannel.length === 0 || wantTs.length === 0) {
+        return undefined;
+    }
+    let match;
+    for (const entry of await readEntries(indexPath)) {
+        if (entry.channelId !== wantChannel || entry.ts !== wantTs) {
+            continue;
+        }
+        if (match === undefined || entry.writtenAt >= match.writtenAt) {
+            match = entry;
+        }
+    }
+    return match?.conversationId;
+}
+/**
+ * Bound file growth by rewriting the index with only the newest `maxEntries`
+ * (by write time, de-duped to the newest entry per `channel+ts`). Consumer-only —
+ * a single process compacts, via temp-file + rename so a concurrent append is
+ * never interleaved with a partial rewrite. Best-effort.
+ */
+export async function compactPostedMessageIndex(indexPath, maxEntries = DEFAULT_COMPACT_MAX_ENTRIES) {
+    const entries = await readEntries(indexPath);
+    if (entries.length <= maxEntries) {
+        return;
+    }
+    // Newest entry per (channel, ts), then newest-first, then cap.
+    const latest = new Map();
+    for (const entry of entries) {
+        const key = `${entry.channelId} ${entry.ts}`;
+        const prior = latest.get(key);
+        if (prior === undefined || entry.writtenAt >= prior.writtenAt) {
+            latest.set(key, entry);
+        }
+    }
+    const kept = [...latest.values()]
+        .sort((a, b) => (a.writtenAt < b.writtenAt ? 1 : a.writtenAt > b.writtenAt ? -1 : 0))
+        .slice(0, maxEntries);
+    const body = kept.map((entry) => JSON.stringify(entry)).join("\n");
+    const tmpPath = `${indexPath}.tmp-${String(kept.length)}`;
+    try {
+        await writeFile(tmpPath, kept.length === 0 ? "" : `${body}\n`, "utf8");
+        await rename(tmpPath, indexPath);
+    }
+    catch {
+        // Best-effort; leave the original file in place on failure.
+    }
+}
+async function readEntries(indexPath) {
+    let raw;
+    try {
+        raw = await readFile(indexPath, "utf8");
+    }
+    catch {
+        return []; // missing/unreadable → nothing recorded yet
+    }
+    const out = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        const parsed = parseEntry(trimmed);
+        if (parsed !== undefined) {
+            out.push(parsed);
+        }
+    }
+    return out;
+}
+function parseEntry(line) {
+    let json;
+    try {
+        json = JSON.parse(line);
+    }
+    catch {
+        return undefined; // tolerate a torn/partial line
+    }
+    if (typeof json !== "object" || json === null) {
+        return undefined;
+    }
+    const record = json;
+    const channelId = stringField(record.channelId);
+    const ts = stringField(record.ts);
+    const conversationId = stringField(record.conversationId);
+    if (channelId === undefined || ts === undefined || conversationId === undefined) {
+        return undefined;
+    }
+    return {
+        channelId,
+        ts,
+        conversationId,
+        writtenAt: stringField(record.writtenAt) ?? "",
+    };
+}
+function stringField(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=posted-message-index.js.map

package/dist/posted-message-index.js.map

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

package/dist/proactive-notify.d.ts

@@ -0,0 +1,32 @@
+import type { NotifyDeliveryResult } from "@mono-agent/agent-contracts";
+import type { ChannelId, MonoAgentAppLogger, RunningChannel } from "./channels.js";
+export type { NotifyDeliveryResult } from "@mono-agent/agent-contracts";
+/** The push channel that owns a destination conversationId (requires a `<scheme>:<target>` form), or undefined. */
+export declare function channelIdForConversation(conversationId: string): ChannelId | undefined;
+export interface ProactiveNotifyInput {
+    /** Destination conversationId, e.g. `telegram:42` or `slack:C1:171.5`. */
+    readonly conversationId: string;
+    /** The message to deliver. With `verbatim`, posted as-is; otherwise run as a turn. */
+    readonly text: string;
+    /**
+     * Deliver `text` VERBATIM — post it to the destination unchanged with no model
+     * call, then record it to the conversation's history (native cron/webhook
+     * notification). Without it, `text` is a prompt run as a turn on the
+     * destination's harness (e.g. a Slack interactive trigger).
+     */
+    readonly verbatim?: boolean;
+    /** Currently running channels, keyed by id (the app's live registry). */
+    readonly running: ReadonlyMap<ChannelId, Pick<RunningChannel, "notify">>;
+    readonly logger?: MonoAgentAppLogger;
+}
+/**
+ * Route a proactive notification to the channel that owns its destination
+ * conversation, so the message runs as a real turn on that channel's own harness
+ * (shared session/history) and is delivered through its normal stream. The owning
+ * channel's `notify` hook enforces its adapter allowlist before delivering, so a
+ * non-allowlisted (e.g. payload-supplied) destination is rejected here. Returns a
+ * structured {@link NotifyDeliveryResult}; never throws (the trigger run already
+ * succeeded), so the caller can report the outcome to the model.
+ */
+export declare function routeProactiveNotification(input: ProactiveNotifyInput): Promise<NotifyDeliveryResult>;
+//# sourceMappingURL=proactive-notify.d.ts.map

package/dist/proactive-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-notify.d.ts","sourceRoot":"","sources":["../src/proactive-notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAInF,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAcxE,mHAAmH;AACnH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAMtF;AAED,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+B3G"}

package/dist/proactive-notify.js

@@ -0,0 +1,62 @@
+/**
+ * Push channels a proactive notification can be delivered to. The conversationId
+ * scheme (the part before the first `:`) identifies the owning channel; only
+ * these channels run a destination harness that can both produce and deliver a
+ * turn. cron/webhook/openai-api/a2a are request-driven, not push destinations.
+ */
+const PUSH_CHANNEL_BY_SCHEME = {
+    telegram: "telegram",
+    slack: "slack",
+    whatsapp: "whatsapp",
+};
+/** The push channel that owns a destination conversationId (requires a `<scheme>:<target>` form), or undefined. */
+export function channelIdForConversation(conversationId) {
+    const colon = conversationId.indexOf(":");
+    if (colon <= 0) {
+        return undefined;
+    }
+    return PUSH_CHANNEL_BY_SCHEME[conversationId.slice(0, colon)];
+}
+/**
+ * Route a proactive notification to the channel that owns its destination
+ * conversation, so the message runs as a real turn on that channel's own harness
+ * (shared session/history) and is delivered through its normal stream. The owning
+ * channel's `notify` hook enforces its adapter allowlist before delivering, so a
+ * non-allowlisted (e.g. payload-supplied) destination is rejected here. Returns a
+ * structured {@link NotifyDeliveryResult}; never throws (the trigger run already
+ * succeeded), so the caller can report the outcome to the model.
+ */
+export async function routeProactiveNotification(input) {
+    const channelId = channelIdForConversation(input.conversationId);
+    if (channelId === undefined) {
+        input.logger?.warn?.("Proactive notification skipped: unrecognized destination.", {
+            conversationId: input.conversationId,
+        });
+        return { delivered: false, reason: "unrecognized destination conversationId" };
+    }
+    const channel = input.running.get(channelId);
+    if (channel?.notify === undefined) {
+        input.logger?.warn?.("Proactive notification skipped: destination channel is not running or does not support delivery.", { conversationId: input.conversationId, channelId });
+        return { delivered: false, reason: `${channelId} channel is not running or does not support proactive delivery` };
+    }
+    try {
+        return await channel.notify({
+            conversationId: input.conversationId,
+            text: input.text,
+            ...(input.verbatim === undefined ? {} : { verbatim: input.verbatim }),
+        });
+    }
+    catch (error) {
+        const reason = reasonOf(error);
+        input.logger?.warn?.("Proactive notification failed: destination channel notify threw.", {
+            conversationId: input.conversationId,
+            channelId,
+            reason,
+        });
+        return { delivered: false, reason };
+    }
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=proactive-notify.js.map

package/dist/proactive-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-notify.js","sourceRoot":"","sources":["../src/proactive-notify.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,sBAAsB,GAAuC;IACjE,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,mHAAmH;AACnH,MAAM,UAAU,wBAAwB,CAAC,cAAsB;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,sBAAsB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAmBD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAA2B;IAC1E,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACjE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,2DAA2D,EAAE;YAChF,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,yCAAyC,EAAE,CAAC;IACjF,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAClB,kGAAkG,EAClG,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE,CACpD,CAAC;QACF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,gEAAgE,EAAE,CAAC;IACpH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,kEAAkE,EAAE;YACvF,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,SAAS;YACT,MAAM;SACP,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/recipes/base.d.ts

@@ -0,0 +1,15 @@
+import type { MonoAgentConfigJson } from "@mono-agent/config";
+import type { RecipeInput, RecipeInputValues } from "./types.js";
+export declare const DEFAULT_MODEL = "claude:claude-sonnet-4-6";
+/** The model input every recipe shares; overridable from `--model`. */
+export declare const MODEL_INPUT: RecipeInput;
+/**
+ * The adapter-neutral skeleton every recipe extends: runtime model, identity,
+ * empty tool policy, local artifacts, and the trace registry. Recipes spread
+ * this and add their channel / memory / sandbox / observability blocks. Mirrors
+ * `init.ts`'s scaffold so a recipe-built folder matches a hand-init'd one.
+ */
+export declare function baseConfig(input: RecipeInputValues): MonoAgentConfigJson;
+/** A `memory` block for the given tier, rooted at the standard memory path. */
+export declare function memoryBlock(mode: "lite" | "journal" | "bujo"): NonNullable<MonoAgentConfigJson["memory"]>;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/recipes/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD,uEAAuE;AACvE,eAAO,MAAM,WAAW,EAAE,WAKzB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CA0BxE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAChC,WAAW,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAM5C"}