agentic-notify 0.2.0 → 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.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.
+**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-6QCYA3X7.js → chunk-ARL7FN6Y.js}

@@ -1,101 +1,3 @@
-// package.json
-var package_default = {
-  name: "agentic-notify",
-  version: "0.2.0",
-  description: "Notifications for humans and agents: in-app inbox, webhook and email delivery, with SDK, CLI, MCP server and Worker API.",
-  keywords: [
-    "notifications",
-    "inbox",
-    "webhook",
-    "agents",
-    "mcp",
-    "cli",
-    "cloudflare-workers",
-    "typescript"
-  ],
-  license: "MIT",
-  author: "Pooria Arab",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/pooriaarab/agentic-notify.git"
-  },
-  type: "module",
-  private: false,
-  engines: {
-    node: ">=20"
-  },
-  files: [
-    "dist"
-  ],
-  publishConfig: {
-    access: "public"
-  },
-  mcpName: "io.github.pooriaarab/agentic-notify",
-  main: "./dist/index.js",
-  types: "./dist/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js"
-    },
-    "./testing": {
-      types: "./dist/testing.d.ts",
-      import: "./dist/testing.js"
-    },
-    "./sdk": {
-      types: "./dist/sdk.d.ts",
-      import: "./dist/sdk.js"
-    },
-    "./worker": {
-      types: "./dist/worker.d.ts",
-      import: "./dist/worker.js"
-    }
-  },
-  bin: {
-    "agentic-notify": "./dist/cli.js",
-    "agentic-notify-mcp": "./dist/mcp-bin.js"
-  },
-  scripts: {
-    build: "tsup",
-    typecheck: "tsc --noEmit",
-    test: "vitest run",
-    clean: "rm -rf dist",
-    prepack: "npm run build",
-    "ci:local": "npm run build && npm run typecheck && npm run check:worker && npm test",
-    "deploy:demo": "wrangler deploy --config wrangler.demo.jsonc",
-    "check:worker": "esbuild src/worker.ts --bundle --platform=neutral --format=esm --log-level=warning --outfile=node_modules/.cache/worker-check.js"
-  },
-  dependencies: {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "agentic-identity": "^0.4.0",
-    hono: "^4.13.14",
-    zod: "^3.25.0"
-  },
-  devDependencies: {
-    "@types/node": "^22.0.0",
-    esbuild: "^0.28.2",
-    miniflare: "^4.20260730.0",
-    tsup: "^8.0.0",
-    typescript: "^5.6.0",
-    vitest: "^3.0.0",
-    wrangler: "^4.155.0"
-  },
-  peerDependencies: {
-    vitest: ">=3"
-  },
-  peerDependenciesMeta: {
-    vitest: {
-      optional: true
-    }
-  }
-};
-
-// src/version.ts
-if (typeof package_default.version !== "string" || package_default.version.length === 0) {
-  throw new Error("package.json carries no version string");
-}
-var VERSION = package_default.version;
-
 // src/core/types.ts
 import { z } from "zod";
 var CHANNELS = ["inbox", "webhook", "email"];
@@ -386,7 +288,6 @@ function createNotifier(options) {
 }
 
 export {
-  VERSION,
   CHANNELS,
   recipientSchema,
   typeNameSchema,

package/dist/chunk-O574VONP.js

@@ -0,0 +1,101 @@
+// package.json
+var package_default = {
+  name: "agentic-notify",
+  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",
+    "inbox",
+    "webhook",
+    "agents",
+    "mcp",
+    "cli",
+    "cloudflare-workers",
+    "typescript"
+  ],
+  license: "MIT",
+  author: "Pooria Arab",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/pooriaarab/agentic-notify.git"
+  },
+  type: "module",
+  private: false,
+  engines: {
+    node: ">=20"
+  },
+  files: [
+    "dist"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  mcpName: "io.github.pooriaarab/agentic-notify",
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./testing": {
+      types: "./dist/testing.d.ts",
+      import: "./dist/testing.js"
+    },
+    "./sdk": {
+      types: "./dist/sdk.d.ts",
+      import: "./dist/sdk.js"
+    },
+    "./worker": {
+      types: "./dist/worker.d.ts",
+      import: "./dist/worker.js"
+    }
+  },
+  bin: {
+    "agentic-notify": "./dist/cli.js",
+    "agentic-notify-mcp": "./dist/mcp-bin.js"
+  },
+  scripts: {
+    build: "tsup",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    clean: "rm -rf dist",
+    prepack: "npm run build",
+    "ci:local": "npm run build && npm run typecheck && npm run check:worker && npm test",
+    "deploy:demo": "wrangler deploy --config wrangler.demo.jsonc",
+    "check:worker": "esbuild src/worker.ts --bundle --platform=neutral --format=esm --log-level=warning --outfile=node_modules/.cache/worker-check.js"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "agentic-identity": "^0.4.0",
+    hono: "^4.13.14",
+    zod: "^3.25.0"
+  },
+  devDependencies: {
+    "@types/node": "^22.0.0",
+    esbuild: "^0.28.2",
+    miniflare: "^4.20260730.0",
+    tsup: "^8.0.0",
+    typescript: "^5.6.0",
+    vitest: "^3.0.0",
+    wrangler: "^4.155.0"
+  },
+  peerDependencies: {
+    vitest: ">=3"
+  },
+  peerDependenciesMeta: {
+    vitest: {
+      optional: true
+    }
+  }
+};
+
+// src/version.ts
+if (typeof package_default.version !== "string" || package_default.version.length === 0) {
+  throw new Error("package.json carries no version string");
+}
+var VERSION = package_default.version;
+
+export {
+  VERSION
+};

package/dist/cli.js

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

package/dist/index.js

@@ -17,11 +17,13 @@ import {
   CHANNELS,
   DEFAULT_CHANNELS,
   NotFoundError,
-  VERSION,
   createNotifier,
   defaultPreferences,
   recipientKey
-} from "./chunk-6QCYA3X7.js";
+} from "./chunk-ARL7FN6Y.js";
+import {
+  VERSION
+} from "./chunk-O574VONP.js";
 export {
   CHANNELS,
   D1_SCHEMA,

package/dist/mcp-bin.js

@@ -1,18 +1,27 @@
 #!/usr/bin/env node
 import {
-  startMcp
-} from "./chunk-POSHKDNY.js";
-import "./chunk-3N77SYRA.js";
-import {
-  createClient
-} from "./chunk-FJPEUDTG.js";
-import "./chunk-KJKM56FT.js";
-import "./chunk-6QCYA3X7.js";
+  VERSION
+} from "./chunk-O574VONP.js";
 
 // src/mcp-bin.ts
-var { NOTIFY_URL, NOTIFY_TOKEN } = process.env;
-var client = NOTIFY_URL && NOTIFY_TOKEN ? createClient({ baseUrl: NOTIFY_URL, token: NOTIFY_TOKEN }) : void 0;
-startMcp(client).catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
+var HELP = `agentic-notify-mcp ${VERSION}
+Usage: agentic-notify-mcp [--help | --version]
+
+Runs the MCP server on stdio. An MCP client starts it.
+`;
+var flag = process.argv[2];
+if (flag === "--version" || flag === "-V") {
+  process.stdout.write(`${VERSION}
+`);
+} else if (flag === "--help" || flag === "-h") {
+  process.stdout.write(HELP);
+} else {
+  Promise.all([import("./mcp.js"), import("./sdk.js")]).then(([{ startMcp }, { createClient }]) => {
+    const { NOTIFY_URL, NOTIFY_TOKEN } = process.env;
+    const client = NOTIFY_URL && NOTIFY_TOKEN ? createClient({ baseUrl: NOTIFY_URL, token: NOTIFY_TOKEN }) : void 0;
+    return startMcp(client);
+  }).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  });
+}

package/dist/mcp.js

@@ -1,11 +1,107 @@
 import {
-  createMcpServer,
-  startMcp
-} from "./chunk-POSHKDNY.js";
-import "./chunk-3N77SYRA.js";
-import "./chunk-FJPEUDTG.js";
+  PACKAGE_NAME
+} from "./chunk-3N77SYRA.js";
+import {
+  ApiError
+} from "./chunk-FJPEUDTG.js";
 import "./chunk-KJKM56FT.js";
-import "./chunk-6QCYA3X7.js";
+import {
+  preferencesSchema,
+  recipientSchema,
+  resourceRefSchema,
+  typeNameSchema
+} from "./chunk-ARL7FN6Y.js";
+import {
+  VERSION
+} from "./chunk-O574VONP.js";
+
+// src/mcp.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+async function wrap(fn) {
+  try {
+    return { content: [{ type: "text", text: JSON.stringify(await fn()) }] };
+  } catch (error) {
+    if (error instanceof ApiError) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: error.code, status: error.status }) }], isError: true };
+    }
+    throw error;
+  }
+}
+function createMcpServer(client) {
+  const server = new McpServer({ name: PACKAGE_NAME, version: VERSION });
+  const need = (fn) => () => wrap(async () => {
+    if (!client) throw new ApiError(0, "not_configured");
+    return fn(client);
+  });
+  const read = { readOnlyHint: true };
+  const write = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+  server.registerTool(
+    "ping",
+    { description: "Check that the server runs. Returns the package version.", inputSchema: {}, annotations: read },
+    async () => ({ content: [{ type: "text", text: JSON.stringify({ ok: true, version: VERSION }) }] })
+  );
+  server.registerTool("list_notifications", {
+    description: "List your notifications, newest first.",
+    inputSchema: { unreadOnly: z.boolean().optional(), limit: z.number().int().min(1).max(200).optional(), cursor: z.string().optional() },
+    annotations: read
+  }, (a) => need((c) => c.list(a))());
+  server.registerTool(
+    "read_notification",
+    { description: "Get one notification by id.", inputSchema: { id: z.string() }, annotations: read },
+    ({ id }) => need((c) => c.get(id))()
+  );
+  server.registerTool(
+    "mark_read",
+    { description: "Mark one notification as read.", inputSchema: { id: z.string() }, annotations: write },
+    ({ id }) => need((c) => c.markRead(id))()
+  );
+  server.registerTool(
+    "mark_all_read",
+    { description: "Mark all your notifications as read.", inputSchema: {}, annotations: write },
+    need((c) => c.markAllRead())
+  );
+  server.registerTool(
+    "get_preferences",
+    { description: "Read your notification preferences.", inputSchema: {}, annotations: read },
+    need((c) => c.getPreferences())
+  );
+  server.registerTool("set_preferences", {
+    description: "Replace your notification preferences: channels per type, mute, muted types.",
+    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) },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
+  }, (a) => need((c) => c.send(a))());
+  return server;
+}
+async function startMcp(client) {
+  await createMcpServer(client).connect(new StdioServerTransport());
+}
 export {
   createMcpServer,
   startMcp

package/dist/worker.js

@@ -1,13 +1,15 @@
 import {
   NOTES,
   NotFoundError,
-  VERSION,
   createNotifier,
   preferencesSchema,
   recipientSchema,
   resourceRefSchema,
   typeNameSchema
-} from "./chunk-6QCYA3X7.js";
+} from "./chunk-ARL7FN6Y.js";
+import {
+  VERSION
+} from "./chunk-O574VONP.js";
 
 // src/api.ts
 import { Hono } from "hono";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-notify",
-  "version": "0.2.0",
+  "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/chunk-POSHKDNY.js

@@ -1,86 +0,0 @@
-import {
-  PACKAGE_NAME
-} from "./chunk-3N77SYRA.js";
-import {
-  ApiError
-} from "./chunk-FJPEUDTG.js";
-import {
-  VERSION,
-  preferencesSchema,
-  recipientSchema,
-  resourceRefSchema,
-  typeNameSchema
-} from "./chunk-6QCYA3X7.js";
-
-// src/mcp.ts
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-async function wrap(fn) {
-  try {
-    return { content: [{ type: "text", text: JSON.stringify(await fn()) }] };
-  } catch (error) {
-    if (error instanceof ApiError) {
-      return { content: [{ type: "text", text: JSON.stringify({ error: error.code, status: error.status }) }], isError: true };
-    }
-    throw error;
-  }
-}
-function createMcpServer(client) {
-  const server = new McpServer({ name: PACKAGE_NAME, version: VERSION });
-  const need = (fn) => () => wrap(async () => {
-    if (!client) throw new ApiError(0, "not_configured");
-    return fn(client);
-  });
-  const read = { readOnlyHint: true };
-  const write = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
-  server.registerTool(
-    "ping",
-    { description: "Check that the server runs. Returns the package version.", inputSchema: {}, annotations: read },
-    async () => ({ content: [{ type: "text", text: JSON.stringify({ ok: true, version: VERSION }) }] })
-  );
-  server.registerTool("list_notifications", {
-    description: "List your notifications, newest first.",
-    inputSchema: { unreadOnly: z.boolean().optional(), limit: z.number().int().min(1).max(200).optional(), cursor: z.string().optional() },
-    annotations: read
-  }, (a) => need((c) => c.list(a))());
-  server.registerTool(
-    "read_notification",
-    { description: "Get one notification by id.", inputSchema: { id: z.string() }, annotations: read },
-    ({ id }) => need((c) => c.get(id))()
-  );
-  server.registerTool(
-    "mark_read",
-    { description: "Mark one notification as read.", inputSchema: { id: z.string() }, annotations: write },
-    ({ id }) => need((c) => c.markRead(id))()
-  );
-  server.registerTool(
-    "mark_all_read",
-    { description: "Mark all your notifications as read.", inputSchema: {}, annotations: write },
-    need((c) => c.markAllRead())
-  );
-  server.registerTool(
-    "get_preferences",
-    { description: "Read your notification preferences.", inputSchema: {}, annotations: read },
-    need((c) => c.getPreferences())
-  );
-  server.registerTool("set_preferences", {
-    description: "Replace your notification preferences: channels per type, mute, muted types.",
-    inputSchema: preferencesSchema.shape,
-    annotations: write
-  }, (a) => need((c) => c.setPreferences(a))());
-  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) },
-    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
-  }, (a) => need((c) => c.send(a))());
-  return server;
-}
-async function startMcp(client) {
-  await createMcpServer(client).connect(new StdioServerTransport());
-}
-
-export {
-  createMcpServer,
-  startMcp
-};