@agent-native/core 0.7.7 → 0.7.11

package/dist/notifications/actions.js

@@ -0,0 +1,114 @@
+/**
+ * Framework-level agent actions for the notifications primitive.
+ *
+ * Registered as native tools (not template actions) so they're available in
+ * every template. The agent uses `notify` to surface progress, completions,
+ * and alerts to the user through the in-app inbox and any registered channels.
+ */
+import { notify, listNotifications, countUnread } from "./registry.js";
+export function createNotificationToolEntries(getCurrentUser) {
+    return {
+        notify: {
+            tool: {
+                description: "Send a notification to the user. Always persisted to the in-app inbox so the bell + toast surface shows it. Registered channels (webhook, Slack, etc.) also run. Use `info` for FYI, `warning` for things the user should look at, `critical` for things that need immediate attention.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        severity: {
+                            type: "string",
+                            enum: ["info", "warning", "critical"],
+                            description: "Severity level — drives styling and per-severity channel routing.",
+                        },
+                        title: {
+                            type: "string",
+                            description: "Short, human-readable headline (≤100 chars).",
+                        },
+                        body: {
+                            type: "string",
+                            description: "Optional longer description.",
+                        },
+                        metadataJson: {
+                            type: "string",
+                            description: 'Optional JSON metadata (URLs, entity ids, etc.). Example: \'{"threadId":"abc","link":"/inbox/abc"}\'.',
+                        },
+                        channels: {
+                            type: "string",
+                            description: 'Optional comma-separated channel allowlist (e.g. "inbox,webhook"). Omit to run all registered channels.',
+                        },
+                    },
+                    required: ["severity", "title"],
+                },
+            },
+            run: async (args) => {
+                const owner = getCurrentUser();
+                if (!args.severity || !args.title) {
+                    return "Error: --severity and --title are required.";
+                }
+                const severity = args.severity;
+                if (!["info", "warning", "critical"].includes(severity)) {
+                    return `Error: severity must be info, warning, or critical (got "${severity}").`;
+                }
+                let metadata;
+                if (args.metadataJson) {
+                    try {
+                        metadata = JSON.parse(args.metadataJson);
+                    }
+                    catch {
+                        return "Error: metadataJson must be valid JSON.";
+                    }
+                }
+                const channels = args.channels
+                    ? args.channels
+                        .split(",")
+                        .map((s) => s.trim())
+                        .filter(Boolean)
+                    : undefined;
+                const stored = await notify({
+                    severity,
+                    title: args.title,
+                    body: args.body || undefined,
+                    metadata,
+                    channels,
+                }, { owner });
+                return stored
+                    ? `Notification sent (id: ${stored.id})`
+                    : "Notification dispatched to channels (not persisted).";
+            },
+        },
+        "list-notifications": {
+            tool: {
+                description: "List recent notifications for the current user. Useful when the user asks about prior alerts.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        unreadOnly: {
+                            type: "boolean",
+                            description: "When true, only include unread notifications.",
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Max rows to return (default 20, max 200).",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const owner = getCurrentUser();
+                const rows = await listNotifications(owner, {
+                    unreadOnly: args.unreadOnly === true || args.unreadOnly === "true",
+                    limit: Math.min(Number(args.limit ?? 20), 200),
+                });
+                if (rows.length === 0) {
+                    return args.unreadOnly
+                        ? "No unread notifications."
+                        : "No notifications.";
+                }
+                const unreadCount = await countUnread(owner);
+                const lines = rows.map((n) => `[${n.readAt ? " " : "•"}] (${n.severity}) ${n.title}${n.body ? ` — ${n.body}` : ""} · ${n.createdAt}`);
+                return `${unreadCount} unread\n\n${lines.join("\n")}`;
+            },
+            readOnly: true,
+        },
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/notifications/actions.js.map

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

package/dist/notifications/channels.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in notification channels.
+ *
+ * Set environment variables to auto-register the webhook channel at startup.
+ * Extra channels can be registered at any time via
+ * `registerNotificationChannel()` from a server plugin.
+ *
+ * NOTIFICATIONS_WEBHOOK_URL  → POST notifications as JSON to this URL.
+ *                              Supports `${keys.NAME}` substitution — the raw
+ *                              value never enters the agent context.
+ * NOTIFICATIONS_WEBHOOK_AUTH → optional `Authorization` header value (also
+ *                              supports `${keys.NAME}`).
+ */
+export declare function registerBuiltinNotificationChannels(): void;
+//# sourceMappingURL=channels.d.ts.map

package/dist/notifications/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/notifications/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,wBAAgB,mCAAmC,IAAI,IAAI,CAQ1D"}

package/dist/notifications/channels.js

@@ -0,0 +1,97 @@
+/**
+ * Built-in notification channels.
+ *
+ * Set environment variables to auto-register the webhook channel at startup.
+ * Extra channels can be registered at any time via
+ * `registerNotificationChannel()` from a server plugin.
+ *
+ * NOTIFICATIONS_WEBHOOK_URL  → POST notifications as JSON to this URL.
+ *                              Supports `${keys.NAME}` substitution — the raw
+ *                              value never enters the agent context.
+ * NOTIFICATIONS_WEBHOOK_AUTH → optional `Authorization` header value (also
+ *                              supports `${keys.NAME}`).
+ */
+import { registerNotificationChannel } from "./registry.js";
+import { resolveKeyReferences, validateUrlAllowlist, getKeyAllowlist, } from "../secrets/substitution.js";
+let _registered = false;
+export function registerBuiltinNotificationChannels() {
+    if (_registered)
+        return;
+    _registered = true;
+    const url = process.env.NOTIFICATIONS_WEBHOOK_URL;
+    if (url) {
+        registerNotificationChannel(createWebhookChannel(url));
+    }
+}
+function createWebhookChannel(urlTemplate) {
+    const authTemplate = process.env.NOTIFICATIONS_WEBHOOK_AUTH;
+    return {
+        name: "webhook",
+        async deliver(input, meta) {
+            // Resolve `${keys.NAME}` references against the owner's user-scope
+            // secrets. Missing keys throw — the error surfaces in logs and the
+            // channel is marked un-delivered, but other channels still run.
+            const { resolved: url } = await resolveKeyReferences(urlTemplate, "user", meta.owner);
+            const headers = {
+                "Content-Type": "application/json",
+            };
+            if (authTemplate) {
+                const { resolved: auth } = await resolveKeyReferences(authTemplate, "user", meta.owner);
+                headers.Authorization = auth;
+            }
+            // If the user set an allowlist on a referenced key, enforce it here —
+            // origin-level check, same rule the automations fetch-tool applies.
+            const keyNames = Array.from(new Set(Array.from(urlTemplate.matchAll(/\$\{keys\.([A-Za-z0-9_-]+)\}/g), (m) => m[1])));
+            const allowlists = await Promise.all(keyNames.map((name) => getKeyAllowlist(name, "user", meta.owner)));
+            keyNames.forEach((name, i) => {
+                if (!validateUrlAllowlist(url, allowlists[i])) {
+                    throw new Error(`[notifications] webhook URL ${new URL(url).origin} is not in the allowlist for key "${name}"`);
+                }
+            });
+            const res = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    severity: input.severity,
+                    title: input.title,
+                    body: input.body,
+                    metadata: input.metadata,
+                    owner: meta.owner,
+                    emittedAt: new Date().toISOString(),
+                }),
+            });
+            if (!res.ok) {
+                throw new Error(`[notifications] webhook ${new URL(url).origin} returned ${res.status}${(await readErrorSnippet(res)) || ""}`);
+            }
+        },
+    };
+}
+/**
+ * Read up to ~1 KB from the body for error context. Streams chunks so a
+ * misbehaving endpoint returning a large error page doesn't pin that whole
+ * payload in memory per failed webhook.
+ */
+async function readErrorSnippet(res) {
+    const reader = res.body?.getReader();
+    if (!reader)
+        return "";
+    const decoder = new TextDecoder();
+    const MAX = 1024;
+    let buf = "";
+    try {
+        while (buf.length < MAX) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+        }
+        reader.cancel().catch(() => { });
+    }
+    catch {
+        return "";
+    }
+    if (!buf)
+        return "";
+    return `: ${buf.slice(0, 200)}`;
+}
+//# sourceMappingURL=channels.js.map

package/dist/notifications/channels.js.map

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

package/dist/notifications/index.d.ts

@@ -0,0 +1,4 @@
+export type { Notification, NotificationSeverity, NotificationInput, NotificationMeta, NotificationChannel, } from "./types.js";
+export { notify, registerNotificationChannel, unregisterNotificationChannel, listNotificationChannels, listNotifications, countUnread, markNotificationRead, markAllNotificationsRead, deleteNotification, } from "./registry.js";
+export { registerBuiltinNotificationChannels } from "./channels.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,MAAM,EACN,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mCAAmC,EAAE,MAAM,eAAe,CAAC"}

package/dist/notifications/index.js

@@ -0,0 +1,3 @@
+export { notify, registerNotificationChannel, unregisterNotificationChannel, listNotificationChannels, listNotifications, countUnread, markNotificationRead, markAllNotificationsRead, deleteNotification, } from "./registry.js";
+export { registerBuiltinNotificationChannels } from "./channels.js";
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,MAAM,EACN,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mCAAmC,EAAE,MAAM,eAAe,CAAC"}

package/dist/notifications/registry.d.ts

@@ -0,0 +1,9 @@
+import { type NotificationChannel, type NotificationInput, type NotificationMeta, type Notification } from "./types.js";
+export declare function registerNotificationChannel(channel: NotificationChannel): void;
+export declare function unregisterNotificationChannel(name: string): boolean;
+export declare function listNotificationChannels(): string[];
+export declare function notify(input: NotificationInput, meta: NotificationMeta): Promise<Notification | undefined>;
+/** Test helper — drops all registered channels. */
+export declare function __resetNotificationChannels(): void;
+export { listNotifications, markNotificationRead, markAllNotificationsRead, deleteNotification, countUnread, } from "./store.js";
+//# sourceMappingURL=registry.d.ts.map

package/dist/notifications/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/notifications/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAsCpB,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CAUN;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD;AAgBD,wBAAsB,MAAM,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAoFnC;AASD,mDAAmD;AACnD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/notifications/registry.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { NOTIFICATION_SEVERITIES, } from "./types.js";
+import { insertNotification, updateDeliveredChannels } from "./store.js";
+import { emit as emitBusEvent } from "../event-bus/bus.js";
+import { registerEvent } from "../event-bus/registry.js";
+import { truncate } from "../shared/truncate.js";
+registerEvent({
+    name: "notification.sent",
+    description: "Fires after notify() delivers to at least one channel. Automations can chain off this — e.g. fan critical notifications to Slack.",
+    payloadSchema: z.object({
+        notificationId: z.string().optional(),
+        severity: z.enum(NOTIFICATION_SEVERITIES),
+        title: z.string(),
+        body: z.string().optional(),
+        deliveredChannels: z.array(z.string()),
+    }),
+    example: {
+        notificationId: "ntf_abc",
+        severity: "critical",
+        title: "Payment failed",
+        body: "Card ending 4242 declined",
+        deliveredChannels: ["inbox", "webhook"],
+    },
+});
+const REGISTRY_KEY = Symbol.for("@agent-native/core/notifications.registry");
+function getRegistry() {
+    const g = globalThis;
+    if (!g[REGISTRY_KEY])
+        g[REGISTRY_KEY] = new Map();
+    return g[REGISTRY_KEY];
+}
+export function registerNotificationChannel(channel) {
+    if (!channel?.name) {
+        throw new Error("registerNotificationChannel: channel.name is required");
+    }
+    if (typeof channel.deliver !== "function") {
+        throw new Error("registerNotificationChannel: channel.deliver must be a function");
+    }
+    getRegistry().set(channel.name, channel);
+}
+export function unregisterNotificationChannel(name) {
+    return getRegistry().delete(name);
+}
+export function listNotificationChannels() {
+    return Array.from(getRegistry().keys());
+}
+/**
+ * Deliver a notification.
+ *
+ * The `inbox` channel always persists a row that drives the in-app UI
+ * (bell + toast). Additional channels (webhook, custom) run in parallel,
+ * best-effort. Returns the stored Notification when `inbox` ran, otherwise
+ * `undefined`.
+ *
+ * Also emits `notification.sent` on the event bus so automations can react
+ * to notifications (e.g. "when a critical notification fires, also page me").
+ */
+const MAX_TITLE_LEN = 100;
+const MAX_BODY_LEN = 2000;
+export async function notify(input, meta) {
+    if (!meta?.owner) {
+        throw new Error("notify: meta.owner is required");
+    }
+    input = {
+        ...input,
+        title: truncate(input.title, MAX_TITLE_LEN),
+        body: truncate(input.body, MAX_BODY_LEN),
+    };
+    const channels = selectChannels(input.channels);
+    // The inbox channel is always included unless explicitly excluded.
+    const runInbox = !input.channels || input.channels.includes("inbox");
+    const delivered = [];
+    let stored;
+    if (runInbox) {
+        try {
+            // Stored with just "inbox" first; the real delivered list is written
+            // after fan-out so a failing webhook doesn't claim it was delivered.
+            stored = await insertNotification({
+                owner: meta.owner,
+                severity: input.severity,
+                title: input.title,
+                body: input.body,
+                metadata: input.metadata,
+                deliveredChannels: ["inbox"],
+            });
+            delivered.push("inbox");
+        }
+        catch (err) {
+            console.error("[notifications] inbox persist failed:", err);
+        }
+    }
+    // Await every channel so a 500-ing webhook doesn't end up in `delivered`.
+    const results = await Promise.allSettled(channels.map(async (channel) => {
+        await channel.deliver(input, meta);
+        return channel.name;
+    }));
+    results.forEach((r, i) => {
+        if (r.status === "fulfilled") {
+            delivered.push(r.value);
+        }
+        else {
+            console.error(`[notifications] channel "${channels[i].name}" failed:`, r.reason);
+        }
+    });
+    const hasExtraChannel = delivered.some((c) => c !== "inbox");
+    if (stored && hasExtraChannel) {
+        try {
+            await updateDeliveredChannels(stored.id, delivered);
+            stored = { ...stored, deliveredChannels: delivered };
+        }
+        catch (err) {
+            console.error("[notifications] delivered-channel update failed:", err);
+        }
+    }
+    // Only emit when at least one channel delivered — an emission with an
+    // empty delivery list (and likely a null notificationId) would mislead
+    // any automation chaining off this event.
+    if (delivered.length > 0) {
+        try {
+            emitBusEvent("notification.sent", {
+                notificationId: stored?.id,
+                severity: input.severity,
+                title: input.title,
+                body: input.body,
+                deliveredChannels: delivered,
+            }, { owner: meta.owner });
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return stored;
+}
+function selectChannels(allowlist) {
+    const registry = getRegistry();
+    const all = Array.from(registry.values());
+    if (!allowlist)
+        return all;
+    return all.filter((c) => allowlist.includes(c.name));
+}
+/** Test helper — drops all registered channels. */
+export function __resetNotificationChannels() {
+    getRegistry().clear();
+}
+export { listNotifications, markNotificationRead, markAllNotificationsRead, deleteNotification, countUnread, } from "./store.js";
+//# sourceMappingURL=registry.js.map

package/dist/notifications/registry.js.map

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

package/dist/notifications/routes.d.ts

@@ -0,0 +1,34 @@
+/**
+ * H3 event handlers for the notifications inbox.
+ *
+ * Mounted under `/_agent-native/notifications/*` by `core-routes-plugin`.
+ *
+ *   GET  /_agent-native/notifications?unread=true&limit=50&before=ISO
+ *                                                   — list for the session owner
+ *   GET  /_agent-native/notifications/count         — unread count
+ *   POST /_agent-native/notifications/:id/read      — mark as read
+ *   POST /_agent-native/notifications/read-all      — mark all read
+ *   DELETE /_agent-native/notifications/:id         — delete
+ */
+export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<import("./types.js").Notification[] | {
+    count: number;
+    updated?: undefined;
+    error?: undefined;
+    ok?: undefined;
+} | {
+    updated: number;
+    count?: undefined;
+    error?: undefined;
+    ok?: undefined;
+} | {
+    error: string;
+    count?: undefined;
+    updated?: undefined;
+    ok?: undefined;
+} | {
+    ok: boolean;
+    count?: undefined;
+    updated?: undefined;
+    error?: undefined;
+}>>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/notifications/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/notifications/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,wBAAgB,0BAA0B;;;;;;;;;;;;;;;;;;;;IAsDzC"}

package/dist/notifications/routes.js

@@ -0,0 +1,69 @@
+/**
+ * H3 event handlers for the notifications inbox.
+ *
+ * Mounted under `/_agent-native/notifications/*` by `core-routes-plugin`.
+ *
+ *   GET  /_agent-native/notifications?unread=true&limit=50&before=ISO
+ *                                                   — list for the session owner
+ *   GET  /_agent-native/notifications/count         — unread count
+ *   POST /_agent-native/notifications/:id/read      — mark as read
+ *   POST /_agent-native/notifications/read-all      — mark all read
+ *   DELETE /_agent-native/notifications/:id         — delete
+ */
+import { defineEventHandler, getMethod, getQuery, setResponseStatus, } from "h3";
+import { getSession } from "../server/auth.js";
+import { listNotifications, countUnread, markNotificationRead, markAllNotificationsRead, deleteNotification, } from "./store.js";
+async function resolveOwner(event) {
+    const session = await getSession(event).catch(() => null);
+    return session?.email || "local@localhost";
+}
+export function createNotificationsHandler() {
+    return defineEventHandler(async (event) => {
+        const method = getMethod(event);
+        const pathname = (event.url?.pathname || "")
+            .replace(/^\/+/, "")
+            .replace(/\/+$/, "");
+        const parts = pathname ? pathname.split("/") : [];
+        const owner = await resolveOwner(event);
+        // GET /  — list
+        if (method === "GET" && parts.length === 0) {
+            const q = getQuery(event);
+            return listNotifications(owner, {
+                unreadOnly: q.unread === "true" || q.unread === "1",
+                limit: q.limit ? Math.min(Number(q.limit) || 50, 200) : 50,
+                before: typeof q.before === "string" ? q.before : undefined,
+            });
+        }
+        // GET /count
+        if (method === "GET" && parts.length === 1 && parts[0] === "count") {
+            const count = await countUnread(owner);
+            return { count };
+        }
+        // POST /read-all
+        if (method === "POST" && parts.length === 1 && parts[0] === "read-all") {
+            const updated = await markAllNotificationsRead(owner);
+            return { updated };
+        }
+        // POST /:id/read
+        if (method === "POST" && parts.length === 2 && parts[1] === "read") {
+            const ok = await markNotificationRead(parts[0], owner);
+            if (!ok) {
+                setResponseStatus(event, 404);
+                return { error: "Not found or already read" };
+            }
+            return { ok: true };
+        }
+        // DELETE /:id
+        if (method === "DELETE" && parts.length === 1) {
+            const ok = await deleteNotification(parts[0], owner);
+            if (!ok) {
+                setResponseStatus(event, 404);
+                return { error: "Not found" };
+            }
+            return { ok: true };
+        }
+        setResponseStatus(event, 404);
+        return { error: "Not found" };
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/notifications/routes.js.map

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

package/dist/notifications/store.d.ts

@@ -0,0 +1,25 @@
+import type { Notification, NotificationSeverity } from "./types.js";
+export interface InsertNotificationInput {
+    owner: string;
+    severity: NotificationSeverity;
+    title: string;
+    body?: string;
+    metadata?: Record<string, unknown>;
+    deliveredChannels?: string[];
+}
+export declare function insertNotification(input: InsertNotificationInput): Promise<Notification>;
+export declare function updateDeliveredChannels(id: string, channels: string[]): Promise<void>;
+export interface ListNotificationsOptions {
+    /** When true, only return unread (read_at IS NULL). */
+    unreadOnly?: boolean;
+    /** Max rows to return. Default 50. */
+    limit?: number;
+    /** ISO timestamp cursor — returns rows with created_at < cursor. */
+    before?: string;
+}
+export declare function listNotifications(owner: string, options?: ListNotificationsOptions): Promise<Notification[]>;
+export declare function countUnread(owner: string): Promise<number>;
+export declare function markNotificationRead(id: string, owner: string): Promise<boolean>;
+export declare function markAllNotificationsRead(owner: string): Promise<number>;
+export declare function deleteNotification(id: string, owner: string): Promise<boolean>;
+//# sourceMappingURL=store.d.ts.map

package/dist/notifications/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notifications/store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA+DrE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhE;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAWlB"}