@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/notifications.js

@@ -0,0 +1,266 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { formatAsText, formatSuccess, formatStructuredList, formatValidationError, } from "@withpica/mcp-utils";
+export class NotificationsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_notifications_list",
+                    description: "Check for notifications from PICA — new collaborator invites, " +
+                        "enrichment results, verification requests, credit disputes, " +
+                        "and other flagged items that need attention.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.listNotifications.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_notify_person",
+                    description: "Send a notification to a person in the catalog. If the person has a PICA account, " +
+                        "they get an in-app notification + Telegram message (if connected). " +
+                        "If they're not a PICA user yet, returns a hint to use pica_collaborators_invite instead. " +
+                        "Use for credit verification requests, song updates, or any message to a collaborator.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            person_id: {
+                                type: "string",
+                                description: "The person's ID in your catalog",
+                            },
+                            message: {
+                                type: "string",
+                                description: "What to tell them (e.g. 'please verify your writing credit on Midnight Run')",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Optional work ID for context — links the notification to a specific work",
+                            },
+                        },
+                        required: ["person_id", "message"],
+                    },
+                },
+                executor: this.notifyPerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_notifications_mark_read",
+                    description: "Mark one or more notifications as read.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            notification_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "IDs of notifications to mark as read",
+                            },
+                        },
+                        required: ["notification_ids"],
+                    },
+                },
+                executor: this.markRead.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_notify_user_at",
+                    description: "Schedule a one-shot Telegram reminder for the future (ADR-160). The user can ask for reminders in any natural phrasing — 'remind me tomorrow at 9', 'ping me in 2 hours', 'check on this next monday'. Convert their phrasing to an ISO 8601 UTC timestamp before calling. Ask the user for their timezone once if you don't already know it. The message body IS the receipt — make it self-contained so the user reading it cold knows what to do. Delivery goes via Telegram, so pica_telegram_connect must be paired first. Per-user cap: 100 pending reminders.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            message: {
+                                type: "string",
+                                description: "The reminder body text. Self-contained — include enough context that the user reading it cold knows what to do. 1-4000 characters.",
+                            },
+                            deliver_at: {
+                                type: "string",
+                                description: "ISO 8601 UTC timestamp. Must be in the future and within 1 year. Convert from natural language using the user's timezone — ask first if you don't know it.",
+                            },
+                        },
+                        required: ["message", "deliver_at"],
+                    },
+                },
+                executor: this.notifyUserAt.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_notify_user_list_pending",
+                    description: "List all pending scheduled Telegram reminders for the current user (ADR-160), ordered by deliver_at ascending. Use to show the user what reminders are queued or to find an id for pica_notify_user_cancel.",
+                    inputSchema: { type: "object", properties: {} },
+                },
+                executor: this.listPending.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_notify_user_cancel",
+                    description: "Cancel a pending scheduled reminder by id (ADR-160). Idempotent — if the reminder was already delivered or already cancelled, this surfaces that state gracefully instead of erroring. Use cancel + pica_notify_user_at together to reschedule a reminder.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "The scheduled_notifications row id — get it from pica_notify_user_list_pending or from the response of pica_notify_user_at.",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.cancelPending.bind(this),
+            },
+        ];
+    }
+    async listPending(_args) {
+        try {
+            const result = await this.pica.notifications.listScheduled();
+            const data = result?.data || result || [];
+            const items = Array.isArray(data) ? data : [];
+            return formatStructuredList(items, "scheduled reminder", {
+                count: items.length,
+            });
+        }
+        catch (err) {
+            return formatAsText({
+                error: `Failed to list pending reminders: ${err?.message || String(err)}`,
+            });
+        }
+    }
+    async cancelPending(args) {
+        if (!args.id || typeof args.id !== "string") {
+            return formatValidationError({ id: "id is required" });
+        }
+        try {
+            const result = await this.pica.notifications.cancelScheduled(args.id);
+            const data = result?.data || result;
+            if (data?.status === "sent") {
+                return formatAsText({
+                    cancelled: false,
+                    status: "sent",
+                    message: `Already delivered on ${data.sent_at} — can't cancel.`,
+                    data,
+                });
+            }
+            if (data?.status === "cancelled" && data?.deliver_at) {
+                return formatSuccess(`Cancelled — was scheduled for ${data.deliver_at}.`, { cancelled: true, id: data.id, deliver_at: data.deliver_at });
+            }
+            if (data?.status === "failed") {
+                return formatAsText({
+                    cancelled: false,
+                    status: "failed",
+                    message: `Reminder already marked failed: ${data.error_text || "unknown"}`,
+                    data,
+                });
+            }
+            return formatSuccess("Cancelled.", { cancelled: true, data });
+        }
+        catch (err) {
+            const message = err?.message || String(err);
+            return formatAsText({
+                cancelled: false,
+                error: `Failed to cancel reminder: ${message}`,
+            });
+        }
+    }
+    async notifyUserAt(args) {
+        if (!args.message ||
+            typeof args.message !== "string" ||
+            !args.message.trim()) {
+            return formatValidationError({ message: "message is required" });
+        }
+        if (!args.deliver_at || typeof args.deliver_at !== "string") {
+            return formatValidationError({
+                deliver_at: "deliver_at is required (ISO 8601 UTC)",
+            });
+        }
+        try {
+            const result = await this.pica.notifications.schedule({
+                message: args.message.trim(),
+                deliverAt: args.deliver_at,
+                source: typeof args.source === "string" ? args.source : undefined,
+            });
+            const data = result?.data || result;
+            return formatSuccess(`Reminder scheduled for ${data.deliver_at}. I'll ping you on Telegram when it fires.`, {
+                id: data.id,
+                deliver_at: data.deliver_at,
+                message: data.message,
+                status: data.status,
+                completion_hints: {
+                    list: "pica_notify_user_list_pending",
+                    cancel: "pica_notify_user_cancel",
+                },
+            });
+        }
+        catch (err) {
+            const message = err?.message || String(err);
+            return formatAsText({
+                scheduled: false,
+                error: `Failed to schedule reminder: ${message}`,
+            });
+        }
+    }
+    async listNotifications(_args) {
+        try {
+            const result = await this.pica.notifications.list();
+            const notifications = result?.notifications || result || [];
+            const items = Array.isArray(notifications) ? notifications : [];
+            const unread = items.filter((n) => !n.read_at);
+            return formatStructuredList(items, "notification", {
+                total: items.length,
+                unread: unread.length,
+            });
+        }
+        catch (err) {
+            return formatAsText({
+                error: `Failed to list notifications: ${err?.message || String(err)}`,
+            });
+        }
+    }
+    async notifyPerson(args) {
+        if (!args.person_id?.trim()) {
+            return formatValidationError({ person_id: "person_id is required" });
+        }
+        if (!args.message?.trim()) {
+            return formatValidationError({ message: "message is required" });
+        }
+        try {
+            const result = await this.pica.notifications.sendToPerson({
+                person_id: args.person_id,
+                message: args.message,
+                work_id: args.work_id,
+            });
+            const data = result.data || result;
+            if (!data.delivered) {
+                return formatAsText({
+                    delivered: false,
+                    person_name: data.person_name,
+                    reason: data.reason,
+                    hint: data.hint,
+                });
+            }
+            const channels = [];
+            if (data.channels?.in_app)
+                channels.push("in-app");
+            if (data.channels?.telegram)
+                channels.push("Telegram");
+            if (data.channels?.email)
+                channels.push("email");
+            return formatSuccess(`Notified ${data.person_name} via ${channels.join(" + ")}`, data);
+        }
+        catch (err) {
+            return formatAsText({
+                error: `Failed to notify person: ${err?.message || String(err)}`,
+            });
+        }
+    }
+    async markRead(args) {
+        const ids = args.notification_ids;
+        await this.pica.notifications.markRead(ids);
+        return formatSuccess(`Marked ${ids.length} notification${ids.length !== 1 ? "s" : ""} as read`);
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/tools/notifications.js.map

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

package/dist/tools/people.d.ts

@@ -1,53 +1,45 @@
 /**
  * People Tools - MCP tools for managing people (artists, composers, etc.)
  */
-import { PicaClient } from "../pica-sdk.js";
+import { PicaClient } from "@withpica/mcp-sdk";
 import { ToolDefinition, ToolExecutor } from "./index.js";
 export declare class PeopleTools {
-  private pica;
-  constructor(pica: PicaClient);
-  /**
-   * Get all people tools
-   */
-  getTools(): Array<{
-    definition: ToolDefinition;
-    executor: ToolExecutor;
-  }>;
-  /**
-   * List people
-   */
-  private listPeople;
-  /**
-   * Get person by ID
-   */
-  private getPerson;
-  /**
-   * Create person
-   */
-  private createPerson;
-  /**
-   * Update person
-   */
-  private updatePerson;
-  /**
-   * Delete person
-   */
-  private deletePerson;
-  /**
-   * Search people
-   */
-  private searchPeople;
-  /**
-   * Enrich from ISNI
-   */
-  private enrichFromISNI;
-  /**
-   * Enrich from MusicBrainz
-   */
-  private enrichFromMusicBrainz;
-  /**
-   * Get full person context bundle
-   */
-  private getPersonFull;
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all people tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    /**
+     * Query people — unified list + search
+     */
+    private queryPeople;
+    /**
+     * Inspect person — unified get + get_full with section filtering
+     */
+    private inspectPerson;
+    /**
+     * Create person
+     */
+    private createPerson;
+    /**
+     * Update person
+     */
+    private updatePerson;
+    /**
+     * Delete person
+     */
+    private deletePerson;
+    /**
+     * Enrich from ISNI
+     */
+    private enrichFromISNI;
+    /**
+     * Enrich from MusicBrainz
+     */
+    private enrichFromMusicBrainz;
 }
-//# sourceMappingURL=people.d.ts.map
+//# sourceMappingURL=people.d.ts.map

package/dist/tools/people.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAQtE,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IAkazE;;OAEG;YACW,UAAU;IAqBxB;;OAEG;YACW,SAAS;IAKvB;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAK1B;;OAEG;YACW,YAAY;IAmB1B;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,qBAAqB;IAanC;;OAEG;YACW,aAAa;CAoB5B"}
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAStE,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IAgazE;;OAEG;YACW,WAAW;IAwCzB;;OAEG;YACW,aAAa;IAsE3B;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAK1B;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,qBAAqB;CASpC"}