agentic-notify 0.2.1 → 0.3.0

package/README.md

@@ -5,7 +5,7 @@
 
 Notifications for humans and agents: in-app inbox, email and webhook delivery, with a CLI, API, MCP server and SDK.
 
-**Status: 0.2.1.** Breaking for 0.1.0 code and databases, see the CHANGELOG upgrade steps. Works today: the notification model, preferences and mute, digest, a store port from agentic-identity with its memory and D1 adapters, signed webhook and email delivery through a dispatcher, an HTTP API in a Worker, an SDK, a CLI, MCP tools, per-recipient export and erase, and a retention sweep. Not done: a real email provider adapter, webhook endpoint management, and a web UI.
+**Status: 0.3.0.** Breaking for 0.1.0 code and databases, see the CHANGELOG upgrade steps. Works today: the notification model, preferences and mute, digest, a store port from agentic-identity with its memory and D1 adapters, signed webhook and email delivery through a dispatcher, an HTTP API in a Worker, an SDK, a CLI, MCP tools, per-recipient export and erase, and a retention sweep. Not done: a real email provider adapter, webhook endpoint management, and a web UI.
 
 ## Live demo
 
@@ -59,10 +59,13 @@ CLI, SDK and MCP talk to that Worker:
 export NOTIFY_URL=https://notify.example.org NOTIFY_TOKEN=...
 npx agentic-notify send --to human:ana --type mention --resource doc:d1 --body "Look at this"
 npx agentic-notify list --unread
-npx agentic-notify mcp      # tools: list_notifications, read_notification, mark_read,
-                            # mark_all_read, get_preferences, set_preferences, send_notification
+npx agentic-notify mcp      # tools: ping, list_notifications, read_notification, mark_read,
+                            # mark_all_read, get_preferences, set_preferences, unread_count, digest,
+                            # export_data, erase_data, send_notification
 ```
 
+The MCP server needs `NOTIFY_URL` and `NOTIFY_TOKEN`. Without them only `ping` works. `erase_data` needs `confirm: true`.
+
 ```ts
 import { createClient } from "agentic-notify/sdk";
 const client = createClient({ baseUrl: process.env.NOTIFY_URL!, token: process.env.NOTIFY_TOKEN! });

package/dist/{chunk-PHY45IVQ.js → chunk-O574VONP.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "agentic-notify",
-  version: "0.2.1",
+  version: "0.3.0",
   description: "Notifications for humans and agents: in-app inbox, webhook and email delivery, with SDK, CLI, MCP server and Worker API.",
   keywords: [
     "notifications",

package/dist/cli.js

@@ -10,7 +10,7 @@ import "./chunk-KJKM56FT.js";
 import "./chunk-ARL7FN6Y.js";
 import {
   VERSION
-} from "./chunk-PHY45IVQ.js";
+} from "./chunk-O574VONP.js";
 
 // src/cli.ts
 import { realpathSync } from "fs";

package/dist/{dispatch-xe2IAqWe.d.ts → dispatch-LBnkLOQg.d.ts}

@@ -1,7 +1,7 @@
-import { R as RecipientExport } from './gdpr-BAg1U1w6.js';
+import { R as RecipientExport } from './gdpr-CUq5MUwo.js';
 import { Store } from 'agentic-identity';
-import { S as SendInput, N as Notification, C as Channel, R as Recipient, D as Digest, P as Preferences } from './types-anA8DMQH.js';
-import { D as DeliveryChannel, L as Logger } from './types-BdX7UTFu.js';
+import { S as SendInput, N as Notification, C as Channel, R as Recipient, D as Digest, P as Preferences } from './types-C842YAMe.js';
+import { D as DeliveryChannel, L as Logger } from './types-DONKNIOo.js';
 
 interface NotifierOptions {
     store: Store;

package/dist/{gdpr-BAg1U1w6.d.ts → gdpr-CUq5MUwo.d.ts}

@@ -1,4 +1,4 @@
-import { R as Recipient, P as Preferences, N as Notification } from './types-anA8DMQH.js';
+import { R as Recipient, P as Preferences, N as Notification } from './types-C842YAMe.js';
 
 interface RecipientExport {
     recipient: Recipient;

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export { D as DispatchResult, a as DispatcherOptions, L as ListOptions, b as ListResult, N as NotFoundError, c as Notifier, d as NotifierOptions, S as SendResult, e as createDispatcher, f as createNotifier } from './dispatch-xe2IAqWe.js';
+export { D as DispatchResult, a as DispatcherOptions, L as ListOptions, b as ListResult, N as NotFoundError, c as Notifier, d as NotifierOptions, S as SendResult, e as createDispatcher, f as createNotifier } from './dispatch-LBnkLOQg.js';
 export { Doc, Page, Query, Scalar, Store, StoreOps, createMemoryStore } from 'agentic-identity';
-import { R as Recipient } from './types-anA8DMQH.js';
-export { A as Actor, b as CHANNELS, C as Channel, c as DEFAULT_CHANNELS, D as Digest, d as DigestGroup, N as Notification, P as Preferences, a as ResourceRef, S as SendInput, e as defaultPreferences, r as recipientKey } from './types-anA8DMQH.js';
-import { D as DeliveryChannel } from './types-BdX7UTFu.js';
-export { a as DeliveryError, L as Logger } from './types-BdX7UTFu.js';
-export { E as EmailChannelOptions, a as EmailMessage, b as EmailPort, c as createEmailChannel } from './testing-46doJP5Y.js';
+import { R as Recipient } from './types-C842YAMe.js';
+export { A as Actor, b as CHANNELS, C as Channel, c as DEFAULT_CHANNELS, D as Digest, d as DigestGroup, N as Notification, P as Preferences, a as ResourceRef, S as SendInput, e as defaultPreferences, r as recipientKey } from './types-C842YAMe.js';
+import { D as DeliveryChannel } from './types-DONKNIOo.js';
+export { a as DeliveryError, L as Logger } from './types-DONKNIOo.js';
+export { E as EmailChannelOptions, a as EmailMessage, b as EmailPort, c as createEmailChannel } from './testing-B5slvYDV.js';
 export { D1Like, D1_SCHEMA, createD1Store } from 'agentic-identity/cloudflare';
-export { R as RecipientExport } from './gdpr-BAg1U1w6.js';
+export { R as RecipientExport } from './gdpr-CUq5MUwo.js';
 import 'zod';
 import 'agentic-identity/testing';
 

package/dist/index.js

@@ -23,7 +23,7 @@ import {
 } from "./chunk-ARL7FN6Y.js";
 import {
   VERSION
-} from "./chunk-PHY45IVQ.js";
+} from "./chunk-O574VONP.js";
 export {
   CHANNELS,
   D1_SCHEMA,

package/dist/mcp-bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   VERSION
-} from "./chunk-PHY45IVQ.js";
+} from "./chunk-O574VONP.js";
 
 // src/mcp-bin.ts
 var HELP = `agentic-notify-mcp ${VERSION}

package/dist/mcp.d.ts

@@ -1,8 +1,8 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Client } from './sdk.js';
-import './types-anA8DMQH.js';
+import './types-C842YAMe.js';
 import 'zod';
-import './gdpr-BAg1U1w6.js';
+import './gdpr-CUq5MUwo.js';
 
 /** Without a client, only `ping` works and the other tools report that setup is missing. */
 declare function createMcpServer(client?: Client): McpServer;

package/dist/mcp.js

@@ -13,7 +13,7 @@ import {
 } from "./chunk-ARL7FN6Y.js";
 import {
   VERSION
-} from "./chunk-PHY45IVQ.js";
+} from "./chunk-O574VONP.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -72,6 +72,26 @@ function createMcpServer(client) {
     inputSchema: preferencesSchema.shape,
     annotations: write
   }, (a) => need((c) => c.setPreferences(a))());
+  server.registerTool(
+    "unread_count",
+    { description: "Count your unread notifications.", inputSchema: {}, annotations: read },
+    need((c) => c.unreadCount())
+  );
+  server.registerTool("digest", {
+    description: "Group your unread notifications by type. Optional since: epoch milliseconds.",
+    inputSchema: { since: z.number().int().min(0).optional() },
+    annotations: read
+  }, ({ since }) => need((c) => c.digest(since))());
+  server.registerTool(
+    "export_data",
+    { description: "Export all data held about you.", inputSchema: {}, annotations: read },
+    need((c) => c.exportData())
+  );
+  server.registerTool("erase_data", {
+    description: "Permanently delete all data held about you. Pass confirm: true. This cannot be undone.",
+    inputSchema: { confirm: z.literal(true) },
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
+  }, () => need((c) => c.erase())());
   server.registerTool("send_notification", {
     description: "Send a notification. You must hold the send right. You are the actor.",
     inputSchema: { recipient: recipientSchema, type: typeNameSchema, resource: resourceRefSchema, body: z.string().max(2e3) },

package/dist/sdk.d.ts

@@ -1,5 +1,5 @@
-import { N as Notification, D as Digest, P as Preferences, R as Recipient, a as ResourceRef } from './types-anA8DMQH.js';
-import { R as RecipientExport } from './gdpr-BAg1U1w6.js';
+import { N as Notification, D as Digest, P as Preferences, R as Recipient, a as ResourceRef } from './types-C842YAMe.js';
+import { R as RecipientExport } from './gdpr-CUq5MUwo.js';
 import 'zod';
 
 declare class ApiError extends Error {
@@ -46,17 +46,17 @@ declare function createClient(options: ClientOptions): {
         type: string;
         id: string;
         recipient: {
-            kind: "human" | "agent";
             id: string;
+            kind: "human" | "agent";
         };
         resource: {
-            kind: string;
             id: string;
+            kind: string;
             url?: string | undefined;
         };
         actor: {
-            kind: "human" | "agent";
             id: string;
+            kind: "human" | "agent";
         };
         body: string;
         createdAt: number;
@@ -66,17 +66,17 @@ declare function createClient(options: ClientOptions): {
         type: string;
         id: string;
         recipient: {
-            kind: "human" | "agent";
             id: string;
+            kind: "human" | "agent";
         };
         resource: {
-            kind: string;
             id: string;
+            kind: string;
             url?: string | undefined;
         };
         actor: {
-            kind: "human" | "agent";
             id: string;
+            kind: "human" | "agent";
         };
         body: string;
         createdAt: number;

package/dist/{testing-46doJP5Y.d.ts → testing-B5slvYDV.d.ts}

@@ -1,6 +1,6 @@
 import 'agentic-identity/testing';
-import { R as Recipient } from './types-anA8DMQH.js';
-import { D as DeliveryChannel } from './types-BdX7UTFu.js';
+import { R as Recipient } from './types-C842YAMe.js';
+import { D as DeliveryChannel } from './types-DONKNIOo.js';
 
 interface EmailMessage {
     to: string;

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
 export { runStoreContract } from 'agentic-identity/testing';
-export { T as TestEmailAdapter } from './testing-46doJP5Y.js';
-import './types-anA8DMQH.js';
+export { T as TestEmailAdapter } from './testing-B5slvYDV.js';
+import './types-C842YAMe.js';
 import 'zod';
-import './types-BdX7UTFu.js';
+import './types-DONKNIOo.js';

package/dist/{types-BdX7UTFu.d.ts → types-DONKNIOo.d.ts}

@@ -1,4 +1,4 @@
-import { N as Notification } from './types-anA8DMQH.js';
+import { N as Notification } from './types-C842YAMe.js';
 
 /** A delivery channel other than the inbox. */
 interface DeliveryChannel {

package/dist/worker.d.ts

@@ -1,10 +1,10 @@
 import { z } from 'zod';
-import { c as Notifier, e as createDispatcher } from './dispatch-xe2IAqWe.js';
-import { R as Recipient } from './types-anA8DMQH.js';
+import { c as Notifier, e as createDispatcher } from './dispatch-LBnkLOQg.js';
+import { R as Recipient } from './types-C842YAMe.js';
 import { D1Like } from 'agentic-identity/cloudflare';
-import './gdpr-BAg1U1w6.js';
+import './gdpr-CUq5MUwo.js';
 import 'agentic-identity';
-import './types-BdX7UTFu.js';
+import './types-DONKNIOo.js';
 
 /** Who is calling. `kind` has no default: a missing kind is an error. */
 declare const principalSchema: z.ZodObject<{

package/dist/worker.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-ARL7FN6Y.js";
 import {
   VERSION
-} from "./chunk-PHY45IVQ.js";
+} from "./chunk-O574VONP.js";
 
 // src/api.ts
 import { Hono } from "hono";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-notify",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Notifications for humans and agents: in-app inbox, webhook and email delivery, with SDK, CLI, MCP server and Worker API.",
   "keywords": [
     "notifications",

package/dist/{types-anA8DMQH.d.ts → types-C842YAMe.d.ts}

@@ -6,11 +6,11 @@ declare const recipientSchema: z.ZodObject<{
     kind: z.ZodEnum<["human", "agent"]>;
     id: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    kind: "human" | "agent";
     id: string;
-}, {
     kind: "human" | "agent";
+}, {
     id: string;
+    kind: "human" | "agent";
 }>;
 type Recipient = z.infer<typeof recipientSchema>;
 declare const resourceRefSchema: z.ZodObject<{
@@ -18,12 +18,12 @@ declare const resourceRefSchema: z.ZodObject<{
     id: z.ZodString;
     url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strict", z.ZodTypeAny, {
-    kind: string;
     id: string;
+    kind: string;
     url?: string | undefined;
 }, {
-    kind: string;
     id: string;
+    kind: string;
     url?: string | undefined;
 }>;
 type ResourceRef = z.infer<typeof resourceRefSchema>;
@@ -31,11 +31,11 @@ declare const actorSchema: z.ZodObject<{
     kind: z.ZodEnum<["human", "agent"]>;
     id: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    kind: "human" | "agent";
     id: string;
-}, {
     kind: "human" | "agent";
+}, {
     id: string;
+    kind: "human" | "agent";
 }>;
 type Actor = z.infer<typeof actorSchema>;
 declare const notificationSchema: z.ZodObject<{
@@ -44,11 +44,11 @@ declare const notificationSchema: z.ZodObject<{
         kind: z.ZodEnum<["human", "agent"]>;
         id: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "human" | "agent";
         id: string;
-    }, {
         kind: "human" | "agent";
+    }, {
         id: string;
+        kind: "human" | "agent";
     }>;
     type: z.ZodString;
     resource: z.ZodObject<{
@@ -56,23 +56,23 @@ declare const notificationSchema: z.ZodObject<{
         id: z.ZodString;
         url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strict", z.ZodTypeAny, {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     }, {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     }>;
     actor: z.ZodObject<{
         kind: z.ZodEnum<["human", "agent"]>;
         id: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "human" | "agent";
         id: string;
-    }, {
         kind: "human" | "agent";
+    }, {
         id: string;
+        kind: "human" | "agent";
     }>;
     body: z.ZodString;
     createdAt: z.ZodNumber;
@@ -81,17 +81,17 @@ declare const notificationSchema: z.ZodObject<{
     type: string;
     id: string;
     recipient: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     resource: {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     };
     actor: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     body: string;
     createdAt: number;
@@ -100,17 +100,17 @@ declare const notificationSchema: z.ZodObject<{
     type: string;
     id: string;
     recipient: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     resource: {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     };
     actor: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     body: string;
     createdAt: number;
@@ -122,11 +122,11 @@ declare const sendInputSchema: z.ZodObject<{
         kind: z.ZodEnum<["human", "agent"]>;
         id: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "human" | "agent";
         id: string;
-    }, {
         kind: "human" | "agent";
+    }, {
         id: string;
+        kind: "human" | "agent";
     }>;
     type: z.ZodString;
     resource: z.ZodObject<{
@@ -134,55 +134,55 @@ declare const sendInputSchema: z.ZodObject<{
         id: z.ZodString;
         url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strict", z.ZodTypeAny, {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     }, {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     }>;
     actor: z.ZodObject<{
         kind: z.ZodEnum<["human", "agent"]>;
         id: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "human" | "agent";
         id: string;
-    }, {
         kind: "human" | "agent";
+    }, {
         id: string;
+        kind: "human" | "agent";
     }>;
     body: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: string;
     recipient: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     resource: {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     };
     actor: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     body: string;
 }, {
     type: string;
     recipient: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     resource: {
-        kind: string;
         id: string;
+        kind: string;
         url?: string | undefined;
     };
     actor: {
-        kind: "human" | "agent";
         id: string;
+        kind: "human" | "agent";
     };
     body: string;
 }>;