@mono-agent/agent-app 0.15.2 → 0.15.3

package/dist/broadcast-recorder.d.ts

@@ -0,0 +1,27 @@
+import type { RunEventSink } from "@mono-agent/agent-contracts";
+import type { RunRecorder } from "@mono-agent/observability";
+/** Stable run context stamped onto every broadcast frame. */
+export interface BroadcastRunContext {
+    readonly runId: string;
+    readonly conversationId: string;
+    /** Producing instance's trace-source id (empty when the host has none). */
+    readonly sourceId: string;
+    readonly sourceLabel?: string;
+    /** Trigger channel, e.g. "cron" | "webhook" | "chat" | "memory". */
+    readonly source?: string;
+    /** Trigger detail (cron job id / webhook endpoint name). */
+    readonly sourceDetail?: string;
+}
+/**
+ * Wrap a {@link RunRecorder} so every run start/event/finish is ALSO published to
+ * a {@link RunEventSink} (the in-process live bus), giving operator surfaces
+ * sub-run visibility the on-disk recorder can't (it flushes only at start/finish).
+ *
+ * Broadcast is best-effort and additive, exactly like the Phoenix exporter path:
+ * the inner recorder is the source of truth for the returned summary, and a
+ * publish failure never changes the run outcome (publish is wrapped and the bus's
+ * own `publish` is contracted never to throw). `seq` is left 0 here — the bus
+ * stamps a process-wide monotonic value on publish.
+ */
+export declare function createBroadcastRunRecorder(inner: RunRecorder, sink: RunEventSink, ctx: BroadcastRunContext): RunRecorder;
+//# sourceMappingURL=broadcast-recorder.d.ts.map

package/dist/broadcast-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-recorder.d.ts","sourceRoot":"","sources":["../src/broadcast-recorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAmD,MAAM,2BAA2B,CAAC;AAE9G,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,mBAAmB,GACvB,WAAW,CAyFb"}

package/dist/broadcast-recorder.js

@@ -0,0 +1,104 @@
+import { LIVE_EVENT_SCHEMA } from "@mono-agent/agent-contracts";
+import { redactJsonValue } from "@mono-agent/observability";
+/**
+ * Wrap a {@link RunRecorder} so every run start/event/finish is ALSO published to
+ * a {@link RunEventSink} (the in-process live bus), giving operator surfaces
+ * sub-run visibility the on-disk recorder can't (it flushes only at start/finish).
+ *
+ * Broadcast is best-effort and additive, exactly like the Phoenix exporter path:
+ * the inner recorder is the source of truth for the returned summary, and a
+ * publish failure never changes the run outcome (publish is wrapped and the bus's
+ * own `publish` is contracted never to throw). `seq` is left 0 here — the bus
+ * stamps a process-wide monotonic value on publish.
+ */
+export function createBroadcastRunRecorder(inner, sink, ctx) {
+    let eventIndex = 0;
+    let terminalStarted = false;
+    let terminalPromise;
+    const publish = (frame) => {
+        try {
+            sink.publish(frame);
+        }
+        catch {
+            // Broadcast is best-effort; a sink failure must never break the run.
+        }
+    };
+    const finished = async (summary) => {
+        const redactedSummary = redactJsonValue(summary);
+        publish({
+            t: "run_finished",
+            schema: LIVE_EVENT_SCHEMA,
+            sourceId: ctx.sourceId,
+            runId: ctx.runId,
+            status: redactedSummary.status,
+            summary: redactedSummary,
+            seq: 0,
+        });
+        return summary;
+    };
+    const recorder = {
+        onEvent(event) {
+            // Terminal is a hard boundary in the live protocol. Events accepted after
+            // commit starts could otherwise appear after `run_finished` or be absent
+            // from the authoritative summary/export.
+            if (terminalStarted)
+                return;
+            inner.onEvent(event);
+            const redactedEvent = redactJsonValue(event);
+            publish({
+                t: "event",
+                schema: LIVE_EVENT_SCHEMA,
+                sourceId: ctx.sourceId,
+                runId: ctx.runId,
+                eventIndex: eventIndex++,
+                event: redactedEvent,
+                seq: 0,
+            });
+        },
+        async prepareFinish(result) {
+            await inner.prepareFinish?.(result);
+        },
+        async commitFinish(result) {
+            if (terminalPromise === undefined) {
+                terminalStarted = true;
+                terminalPromise = (async () => await finished(inner.commitFinish === undefined ? await inner.finish(result) : await inner.commitFinish(result)))();
+            }
+            return await terminalPromise;
+        },
+        async finish(result) {
+            await recorder.prepareFinish?.(result);
+            return await recorder.commitFinish(result);
+        },
+        async fail(error) {
+            if (terminalPromise === undefined) {
+                terminalStarted = true;
+                terminalPromise = (async () => await finished(await inner.fail(error)))();
+            }
+            return await terminalPromise;
+        },
+    };
+    // `start` is optional on RunRecorder — only expose (and emit run_started) when
+    // the inner recorder has one, so callers that probe `recorder.start?.()` behave
+    // identically to the unwrapped recorder.
+    if (inner.start !== undefined) {
+        const innerStart = inner.start.bind(inner);
+        recorder.start = async () => {
+            const summary = await innerStart();
+            publish({
+                t: "run_started",
+                schema: LIVE_EVENT_SCHEMA,
+                sourceId: ctx.sourceId,
+                ...(ctx.sourceLabel === undefined ? {} : { sourceLabel: ctx.sourceLabel }),
+                runId: ctx.runId,
+                conversationId: ctx.conversationId,
+                ...(ctx.source === undefined ? {} : { source: ctx.source }),
+                ...(ctx.sourceDetail === undefined ? {} : { sourceDetail: ctx.sourceDetail }),
+                startedAt: summary.startedAt ?? new Date().toISOString(),
+                seq: 0,
+            });
+            return summary;
+        };
+    }
+    return recorder;
+}
+//# sourceMappingURL=broadcast-recorder.js.map

package/dist/broadcast-recorder.js.map

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

package/dist/channel-drivers/live.d.ts

@@ -0,0 +1,12 @@
+import type { LiveAdapterConfig, LiveAdapterHandle, LiveAdapterOptions } from "@mono-agent/operator-adapter";
+import type { ChannelDriver } from "../channels.js";
+export interface LiveChannelOverrides {
+    readonly adapterFactory?: (options: LiveAdapterOptions) => Promise<LiveAdapterHandle>;
+}
+/**
+ * The live event relay is enabled by default on loopback so read-only operator
+ * surfaces (the `@mono-agent/session-web` PWA) can observe a running agent
+ * without a per-agent config edit.
+ */
+export declare function createLiveChannelDriver(overrides?: LiveChannelOverrides): ChannelDriver<LiveAdapterConfig>;
+//# sourceMappingURL=live.d.ts.map

package/dist/channel-drivers/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/channel-drivers/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,oBAAyB,GACnC,aAAa,CAAC,iBAAiB,CAAC,CAsClC"}

package/dist/channel-drivers/live.js

@@ -0,0 +1,48 @@
+import { buildChannelConfigView } from "../channel-config-view.js";
+let liveModule;
+const loadLiveModule = async () => (liveModule ??= await import("@mono-agent/operator-adapter"));
+/**
+ * The live event relay is enabled by default on loopback so read-only operator
+ * surfaces (the `@mono-agent/session-web` PWA) can observe a running agent
+ * without a per-agent config edit.
+ */
+export function createLiveChannelDriver(overrides = {}) {
+    return {
+        id: "live",
+        label: "Live",
+        async configView(input) {
+            const adapter = await loadLiveModule();
+            return await buildChannelConfigView(this, adapter.LIVE_CONFIG_FIELDS, input, { jsonKey: "live" });
+        },
+        async loadConfig(input) {
+            const adapter = await loadLiveModule();
+            return await adapter.loadLiveAdapterConfig({ env: input.env, jsonPath: input.configPath });
+        },
+        isConfigError(error) {
+            return liveModule !== undefined && error instanceof liveModule.LiveAdapterError;
+        },
+        disabledReason(config) {
+            return config.enabled ? undefined : "Live event relay is disabled.";
+        },
+        async start(input) {
+            const adapterModule = await loadLiveModule();
+            const adapterFactory = overrides.adapterFactory ?? adapterModule.startLiveAdapter;
+            const bus = input.liveEventBus ?? adapterModule.createLiveEventBus();
+            const adapter = await adapterFactory({
+                bus,
+                host: input.config.host,
+                port: input.config.port,
+                basePath: input.config.basePath,
+                allowNonLoopback: input.config.allowNonLoopback,
+                ...(input.config.apiKey === undefined ? {} : { apiKey: input.config.apiKey }),
+                onServerError: (reason) => input.onFailure(reason),
+                ...(input.logger === undefined ? {} : { logger: input.logger }),
+            });
+            return {
+                summary: { baseUrl: adapter.baseUrl },
+                stop: () => adapter.stop(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=live.js.map

package/dist/channel-drivers/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/channel-drivers/live.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAKnE,IAAI,UAAyC,CAAC;AAC9C,MAAM,cAAc,GAAG,KAAK,IAAgC,EAAE,CAC5D,CAAC,UAAU,KAAK,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC,CAAC;AAMhE;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAAkC,EAAE;IAEpC,OAAO;QACL,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,MAAM;QACb,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;YACvC,OAAO,MAAM,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;YACvC,OAAO,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,aAAa,CAAC,KAAK;YACjB,OAAO,UAAU,KAAK,SAAS,IAAI,KAAK,YAAY,UAAU,CAAC,gBAAgB,CAAC;QAClF,CAAC;QACD,cAAc,CAAC,MAAM;YACnB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,+BAA+B,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,MAAM,aAAa,GAAG,MAAM,cAAc,EAAE,CAAC;YAC7C,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,IAAI,aAAa,CAAC,gBAAgB,CAAC;YAClF,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,IAAI,aAAa,CAAC,kBAAkB,EAAE,CAAC;YACrE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;gBACnC,GAAG;gBACH,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBACvB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBACvB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;gBAC/B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,gBAAgB;gBAC/C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC7E,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;gBAClD,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;aAChE,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;gBACrC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;aAC3B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/notify-runtime.d.ts

@@ -0,0 +1,26 @@
+import { type NotifyToolsServer } from "./notify-tool.js";
+/**
+ * Per-request input the harness hands each runtime-options extension. We only
+ * need the request's metadata to decide whether this is a proactive trigger.
+ */
+interface NotifyRuntimeExtensionInput {
+    readonly request: {
+        readonly metadata?: Record<string, unknown> | undefined;
+    };
+}
+interface NotifyRuntimeExtensionResult {
+    readonly runtimeOptions: {
+        readonly mcpServers?: Record<string, unknown>;
+    };
+    readonly cleanup: () => Promise<void>;
+}
+/**
+ * Runtime extension that exposes the `notify_conversation`/`list_notify_destinations`
+ * tools, but ONLY on proactive trigger turns — cron and webhook — identified by the
+ * request metadata (`metadata.cron`/`metadata.webhook`, robust regardless of how the
+ * turn's conversationId is scoped). Live channel turns (telegram/slack/etc.) never see
+ * these tools: a live turn is already in its conversation and just replies.
+ */
+export declare function createNotifyToolsRuntimeExtension(server: Pick<NotifyToolsServer, "url" | "token">): (input: NotifyRuntimeExtensionInput) => Promise<NotifyRuntimeExtensionResult>;
+export {};
+//# sourceMappingURL=notify-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify-runtime.d.ts","sourceRoot":"","sources":["../src/notify-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExF;;;GAGG;AACH,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;CAC/E;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,OAAO,CAAC,GAC/C,CAAC,KAAK,EAAE,2BAA2B,KAAK,OAAO,CAAC,4BAA4B,CAAC,CAa/E"}

package/dist/notify-runtime.js

@@ -0,0 +1,27 @@
+import { NOTIFY_TOOLS_MCP_SERVER_NAME } from "./notify-tool.js";
+const EMPTY = { runtimeOptions: {}, cleanup: async () => { } };
+/**
+ * Runtime extension that exposes the `notify_conversation`/`list_notify_destinations`
+ * tools, but ONLY on proactive trigger turns — cron and webhook — identified by the
+ * request metadata (`metadata.cron`/`metadata.webhook`, robust regardless of how the
+ * turn's conversationId is scoped). Live channel turns (telegram/slack/etc.) never see
+ * these tools: a live turn is already in its conversation and just replies.
+ */
+export function createNotifyToolsRuntimeExtension(server) {
+    const entry = {
+        [NOTIFY_TOOLS_MCP_SERVER_NAME]: {
+            type: "http",
+            url: server.url,
+            headers: { Authorization: `Bearer ${server.token}` },
+        },
+    };
+    return async (input) => {
+        return isProactiveTrigger(input.request.metadata)
+            ? { runtimeOptions: { mcpServers: entry }, cleanup: async () => { } }
+            : EMPTY;
+    };
+}
+function isProactiveTrigger(metadata) {
+    return metadata !== undefined && (metadata.cron !== undefined || metadata.webhook !== undefined);
+}
+//# sourceMappingURL=notify-runtime.js.map

package/dist/notify-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-runtime.js","sourceRoot":"","sources":["../src/notify-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAA0B,MAAM,kBAAkB,CAAC;AAexF,MAAM,KAAK,GAAiC,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC;AAE5F;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAC/C,MAAgD;IAEhD,MAAM,KAAK,GAAG;QACZ,CAAC,4BAA4B,CAAC,EAAE;YAC9B,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE;SACrD;KACF,CAAC;IACF,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,OAAO,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC/C,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE;YACpE,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA6C;IACvE,OAAO,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;AACnG,CAAC"}

package/dist/notify-tool.d.ts

@@ -0,0 +1,51 @@
+import type { MonoAgentAppLogger } from "./channels.js";
+import type { NotifyDeliveryResult } from "./proactive-notify.js";
+/**
+ * In-process MCP server that exposes the proactive-notification tools to the agent.
+ *
+ * Unlike `memory_recall`/the adapter send tools (stdio children that re-derive
+ * everything from config/disk), notification delivery has to run a real turn on a
+ * destination channel's LIVE session, so the handler must reach the app's running
+ * channel registry — which only exists in this process. We therefore host the
+ * tools over loopback HTTP (the one MCP transport the runtime's client supports
+ * for an in-process server) and close over app-supplied delivery/discovery hooks.
+ *
+ * Two tools, both intended for proactive cron/webhook turns (the runtime extension
+ * only injects this server for those):
+ *  - `list_notify_destinations` — discover the conversations the agent may notify
+ *    (answers "how do I get a conversationId?" when there is no triggering payload).
+ *  - `notify_conversation` — deliver a message as a real turn into one of them.
+ */
+export declare const NOTIFY_TOOLS_MCP_SERVER_NAME = "mono-agent-notify";
+/** A conversation the agent may proactively notify, surfaced to the model for discovery. */
+export interface NotifyToolDestination {
+    /** Destination conversationId to pass to `notify_conversation`, e.g. `telegram:42`. */
+    readonly conversationId: string;
+    /** Owning channel id (telegram/slack). */
+    readonly channelId: string;
+    /** ISO timestamp of the most recent turn on this conversation, if known. */
+    readonly lastSeen?: string;
+    /** True when this is an allowlisted destination the agent has not yet conversed with. */
+    readonly fromAllowlist?: boolean;
+}
+export interface NotifyToolsDeps {
+    /** Deliver `text` as a real turn into `conversationId` (allowlist-enforced by the owning channel). */
+    readonly deliver: (conversationId: string, text: string) => Promise<NotifyDeliveryResult>;
+    /** The conversations the agent may notify right now (seen + single-allowlist destinations). */
+    readonly listDestinations: () => Promise<readonly NotifyToolDestination[]>;
+    readonly logger?: MonoAgentAppLogger | undefined;
+}
+export interface NotifyToolsServer {
+    /** Loopback URL the runtime's MCP client connects to (`http://127.0.0.1:<port>/mcp`). */
+    readonly url: string;
+    /** Bearer token required on every request. */
+    readonly token: string;
+    close(): Promise<void>;
+}
+/**
+ * Start the in-process notify MCP server on an ephemeral loopback port. Stateless:
+ * each request gets a fresh `McpServer`+transport (the tools are pure request/response),
+ * which sidesteps session bookkeeping and concurrent-trigger races.
+ */
+export declare function startNotifyToolsServer(deps: NotifyToolsDeps): Promise<NotifyToolsServer>;
+//# sourceMappingURL=notify-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify-tool.d.ts","sourceRoot":"","sources":["../src/notify-tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE,4FAA4F;AAC5F,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1F,+FAA+F;IAC/F,QAAQ,CAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAAC;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgC9F"}

package/dist/notify-tool.js

@@ -0,0 +1,182 @@
+import { createServer } from "node:http";
+import { randomBytes, timingSafeEqual } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import * as z from "zod/v4";
+/**
+ * In-process MCP server that exposes the proactive-notification tools to the agent.
+ *
+ * Unlike `memory_recall`/the adapter send tools (stdio children that re-derive
+ * everything from config/disk), notification delivery has to run a real turn on a
+ * destination channel's LIVE session, so the handler must reach the app's running
+ * channel registry — which only exists in this process. We therefore host the
+ * tools over loopback HTTP (the one MCP transport the runtime's client supports
+ * for an in-process server) and close over app-supplied delivery/discovery hooks.
+ *
+ * Two tools, both intended for proactive cron/webhook turns (the runtime extension
+ * only injects this server for those):
+ *  - `list_notify_destinations` — discover the conversations the agent may notify
+ *    (answers "how do I get a conversationId?" when there is no triggering payload).
+ *  - `notify_conversation` — deliver a message as a real turn into one of them.
+ */
+export const NOTIFY_TOOLS_MCP_SERVER_NAME = "mono-agent-notify";
+const MCP_PATH = "/mcp";
+/**
+ * Start the in-process notify MCP server on an ephemeral loopback port. Stateless:
+ * each request gets a fresh `McpServer`+transport (the tools are pure request/response),
+ * which sidesteps session bookkeeping and concurrent-trigger races.
+ */
+export async function startNotifyToolsServer(deps) {
+    const token = randomBytes(24).toString("hex");
+    const expectedAuth = `Bearer ${token}`;
+    const httpServer = createServer((req, res) => {
+        void handleHttpRequest(req, res, expectedAuth, deps);
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        httpServer.once("error", onError);
+        httpServer.listen(0, "127.0.0.1", () => {
+            httpServer.removeListener("error", onError);
+            resolve();
+        });
+    });
+    const address = httpServer.address();
+    if (address === null || typeof address === "string") {
+        httpServer.close();
+        throw new Error("notify tools server: failed to bind a loopback port.");
+    }
+    const url = `http://127.0.0.1:${address.port}${MCP_PATH}`;
+    return {
+        url,
+        token,
+        close: () => new Promise((resolve) => {
+            httpServer.close(() => resolve());
+        }),
+    };
+}
+async function handleHttpRequest(req, res, expectedAuth, deps) {
+    if (!isAuthorized(req, expectedAuth)) {
+        res.writeHead(401, { "content-type": "application/json" });
+        res.end(JSON.stringify({ error: "unauthorized" }));
+        return;
+    }
+    if (req.url?.split("?", 1)[0] !== MCP_PATH) {
+        res.writeHead(404, { "content-type": "application/json" });
+        res.end(JSON.stringify({ error: "not found" }));
+        return;
+    }
+    // Stateless: only POST carries JSON-RPC. The single tool round-trips are
+    // request/response, so reject the optional GET/DELETE session streams.
+    if (req.method !== "POST") {
+        res.writeHead(405, { "content-type": "application/json", allow: "POST" });
+        res.end(JSON.stringify({ error: "method not allowed" }));
+        return;
+    }
+    const server = buildMcpServer(deps);
+    // Stateless: omitting sessionIdGenerator runs the transport without session
+    // tracking, so a fresh server+transport per request is the correct pattern and
+    // concurrent triggers never share state.
+    const transport = new StreamableHTTPServerTransport({});
+    // Idempotent: with HTTP keep-alive the response can `finish` without firing
+    // `close`, so bind both and guard against a double-close leaking nothing.
+    let cleaned = false;
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        void transport.close();
+        void server.close();
+    };
+    res.on("close", cleanup);
+    res.on("finish", cleanup);
+    try {
+        // The transport implements the SDK Transport interface at runtime; the cast
+        // bridges an exactOptionalPropertyTypes mismatch in the SDK's own typings.
+        await server.connect(transport);
+        await transport.handleRequest(req, res);
+    }
+    catch (error) {
+        deps.logger?.error?.("notify tools server: request failed.", { reason: reasonOf(error) });
+        if (!res.headersSent) {
+            res.writeHead(500, { "content-type": "application/json" });
+            res.end(JSON.stringify({ error: "internal error" }));
+        }
+    }
+}
+function isAuthorized(req, expectedAuth) {
+    const header = req.headers.authorization;
+    if (typeof header !== "string") {
+        return false;
+    }
+    const a = Buffer.from(header);
+    const b = Buffer.from(expectedAuth);
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+function buildMcpServer(deps) {
+    const server = new McpServer({ name: "agent-notify-tools", version: "0.1.0" });
+    server.registerTool("list_notify_destinations", {
+        title: "List notification destinations",
+        description: "List the conversations you can proactively deliver a message to with notify_conversation. " +
+            "Use this when you have no triggering conversationId in hand (e.g. a scheduled/cron run) to " +
+            "discover where to reach the user. Each entry's `conversationId` is what notify_conversation " +
+            "expects — read its description for how delivery works (the destination turn's reply is what is sent).",
+        inputSchema: {},
+    }, async () => {
+        const destinations = await deps.listDestinations();
+        const lines = destinations.length === 0
+            ? ["(no known destinations yet — the agent has not handled any push-channel conversation and no single allowlisted destination is configured)"]
+            : destinations.map((d) => `- ${d.conversationId}${d.lastSeen === undefined ? "" : ` (last active ${d.lastSeen})`}${d.fromAllowlist === true ? " (allowlisted, not yet used)" : ""}`);
+        return {
+            content: [{ type: "text", text: ["Conversations you can notify:", ...lines].join("\n") }],
+            structuredContent: { destinations },
+        };
+    });
+    server.registerTool("notify_conversation", {
+        title: "Notify a conversation",
+        description: "Proactively deliver a message into a conversation you are not currently handling. The message " +
+            "runs as a real turn on that conversation's own session and THAT TURN'S REPLY is what the user " +
+            "receives (so the user sees it natively and the conversation remembers it). Use this to follow up " +
+            "from a cron job or an inbound webhook callback.\n\n" +
+            "How `text` is delivered (read carefully — this is the #1 mistake):\n" +
+            "- `text` is the stimulus the destination conversation acts on; it is NOT posted verbatim. The " +
+            "destination agent reads `text` and composes the user-facing reply with its own context, and that " +
+            "reply is delivered automatically.\n" +
+            "- To deliver pre-composed or exact content (e.g. a digest), phrase `text` as an explicit reply " +
+            "instruction, e.g.: \"Reply with the text below exactly as written, adding nothing, and do not call " +
+            "any tools — your reply is delivered automatically:\\n\\n<your content>\".\n" +
+            "- The destination must NOT call its own send tools (e.g. slack_send_message) — its reply is already " +
+            "delivered, so sending again posts the message twice.\n\n" +
+            "How to choose `conversationId`:\n" +
+            "- Webhook/async callback: pass the `conversationId` carried in the triggering request payload.\n" +
+            "- Otherwise (e.g. a scheduled run): call list_notify_destinations first and pick from it.\n\n" +
+            "Delivery is bounded by the channel allowlist and may return delivered:false (e.g. unknown/disallowed " +
+            "id, channel offline). The call blocks until the destination turn replies, so keep that turn to a single " +
+            "reply — a turn that re-scans, recalls, or hunts for a send tool is slow and can hit the request timeout. " +
+            "If you receive delivered:false, do not assume it was also delivered some other way.",
+        inputSchema: {
+            conversationId: z
+                .string()
+                .min(1)
+                .describe("Destination conversationId, e.g. telegram:42 or slack:C123 (or slack:C123:1718.99 for a thread)."),
+            text: z
+                .string()
+                .min(1)
+                .describe("What to deliver. The destination conversation runs this as a turn and its reply is delivered; " +
+                "to deliver exact content, phrase this as a reply-verbatim, no-tools instruction (see the tool description)."),
+        },
+    }, async (args) => {
+        const result = await deps.deliver(args.conversationId, args.text);
+        const summary = result.delivered
+            ? `Delivered to ${args.conversationId}.`
+            : `Not delivered to ${args.conversationId}${result.reason === undefined ? "" : `: ${result.reason}`}.`;
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: { delivered: result.delivered, ...(result.reason === undefined ? {} : { reason: result.reason }) },
+        };
+    });
+    return server;
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=notify-tool.js.map

package/dist/notify-tool.js.map

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

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"}

package/dist/recipes/base.js

@@ -0,0 +1,51 @@
+import { monoAgentConfigWithSchema } from "../config-reference.js";
+export const DEFAULT_MODEL = "claude:claude-sonnet-4-6";
+/** The model input every recipe shares; overridable from `--model`. */
+export const MODEL_INPUT = {
+    id: "model",
+    label: "Model",
+    description: "Primary runtime model reference, e.g. claude:claude-sonnet-4-6, codex:gpt-5.5, pi:ollama:gemma4:31b.",
+    default: DEFAULT_MODEL,
+};
+/**
+ * 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 function baseConfig(input) {
+    return monoAgentConfigWithSchema({
+        runtime: {
+            model: input.model ?? DEFAULT_MODEL,
+            workspace: ".",
+        },
+        context: {
+            identityPath: "./IDENTITY.md",
+            selectedSkills: [],
+        },
+        tools: {
+            allowedTools: [],
+            disallowedTools: [],
+        },
+        artifacts: {
+            dir: "./.mono-agent/artifacts",
+            retention: {
+                maxAgeDays: 365,
+                maxCount: 50000,
+                dryRun: false,
+            },
+        },
+        traceability: {
+            registryDir: "./.mono-agent/trace-sources",
+        },
+    });
+}
+/** A `memory` block for the given tier, rooted at the standard memory path. */
+export function memoryBlock(mode) {
+    return {
+        mode,
+        path: "./.mono-agent/memory",
+        writeMode: mode === "bujo" ? "capture" : "append-host-summary",
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/recipes/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/recipes/base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAExD,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,sGAAsG;IACnH,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,yBAAyB,CAAC;QAC/B,OAAO,EAAE;YACP,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,aAAa;YACnC,SAAS,EAAE,GAAG;SACf;QACD,OAAO,EAAE;YACP,YAAY,EAAE,eAAe;YAC7B,cAAc,EAAE,EAAE;SACnB;QACD,KAAK,EAAE;YACL,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,EAAE;SACpB;QACD,SAAS,EAAE;YACT,GAAG,EAAE,yBAAyB;YAC9B,SAAS,EAAE;gBACT,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,KAAK;aACd;SACF;QACD,YAAY,EAAE;YACZ,WAAW,EAAE,6BAA6B;SAC3C;KACqB,CAAC,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CACzB,IAAiC;IAEjC,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB;KAC/D,CAAC;AACJ,CAAC"}

package/dist/recipes/catalog.d.ts

@@ -0,0 +1,4 @@
+import type { AgentRecipe } from "./types.js";
+/** Ordered catalog — starter recipes first, then the two full blueprints. */
+export declare const RECIPE_CATALOG: readonly AgentRecipe[];
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/recipes/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAC;AAqhBjE,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAchD,CAAC"}