@mono-agent/agent-app 0.3.0 → 0.4.1

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

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;AAogBjE,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAchD,CAAC"}