@emseepea/feedback 0.5.3 → 0.7.0

package/dist/mcp-events.js

@@ -0,0 +1,161 @@
+import { publishMcpEvent } from "@emseepea/server";
+import { z } from "zod";
+import { feedbackEventSchema, feedbackSubmissionRecordedEventSchema, } from "./index.js";
+export const feedbackReplyEventName = "feedback.reply.ready";
+export const feedbackSubmittedEventName = "feedback.submitted";
+const identifier = z.string().min(1).max(240);
+const threadArguments = z.strictObject({
+    threadId: identifier.describe("Exact feedback thread to watch for a team reply."),
+});
+const replyReference = z.strictObject({
+    scope: identifier,
+    threadId: identifier,
+    messageId: identifier,
+    sourceEventId: identifier,
+});
+export function createFeedbackReplyEventsOptions(options) {
+    if (typeof options?.canReadThread !== "function")
+        throw new TypeError("feedback reply events require canReadThread");
+    return {
+        definitions: [{
+                name: feedbackReplyEventName,
+                description: "A team reply is ready. Read the exact thread with get-feedback-thread and present the reply to the user.",
+                inputSchema: threadArguments,
+                payloadSchema: replyReference,
+                matches: (arguments_, data, ownerKey) => arguments_.threadId === data.threadId && ownerKey === data.scope,
+            }],
+        ownerKey: options.ownerKey,
+        async authorize({ ownerKey, name, arguments: arguments_, phase }) {
+            if (name !== feedbackReplyEventName)
+                return false;
+            if (phase === "list")
+                return true;
+            const parsed = threadArguments.safeParse(arguments_);
+            return parsed.success && await options.canReadThread(ownerKey, parsed.data.threadId);
+        },
+        health: options.health,
+        store: options.store,
+        ...(options.callbackTimeoutMs === undefined ? {} : { callbackTimeoutMs: options.callbackTimeoutMs }),
+    };
+}
+/** Publish a durable team reply reference after the feedback backend commits it. */
+export async function publishFeedbackTeamReplyEvent(app, event) {
+    const checked = feedbackEventSchema.safeParse(event);
+    if (!checked.success)
+        throw new TypeError("Invalid feedback event");
+    if (checked.data.type !== "feedback.message.added" || checked.data.author !== "team")
+        return false;
+    if (!checked.data.messageId)
+        throw new TypeError("Team reply event requires messageId");
+    await publishMcpEvent(app, feedbackReplyEventName, replyReference.parse({
+        scope: checked.data.scope,
+        threadId: checked.data.threadId,
+        messageId: checked.data.messageId,
+        sourceEventId: checked.data.id,
+    }));
+    return true;
+}
+const maximumMonitoredCollections = 32;
+const submittedReference = z.strictObject({
+    collection: identifier.describe("Feedback collection containing the recorded submission."),
+    submissionId: identifier.describe("Stable identifier within the feedback collection."),
+    sourceEventId: identifier.describe("Identifier of the durable feedback submission event."),
+});
+export function createFeedbackSubmittedEventsOptions(options) {
+    const collections = options.definition.monitors.map(({ collection }) => collection);
+    if (collections.length === 0)
+        return undefined;
+    if (collections.length > maximumMonitoredCollections) {
+        throw new TypeError(`Configure no more than ${maximumMonitoredCollections} monitored feedback collections.`);
+    }
+    if (typeof options.canMonitorCollection !== "function") {
+        throw new TypeError("Provide canMonitorCollection to authorize feedback submission monitoring.");
+    }
+    const collectionSchema = z.enum(collections)
+        .describe("Feedback collection containing the recorded submission.");
+    const subscriptionArguments = submittedSubscriptionArgumentsSchema(collectionSchema, collections.length);
+    const payload = submittedReference.extend({ collection: collectionSchema });
+    const authorizedCollections = async (ownerKey, phase) => {
+        const allowed = [];
+        for (const collection of collections) {
+            if (await options.canMonitorCollection({ ownerKey, collection, phase })) {
+                allowed.push(collection);
+            }
+        }
+        return allowed.sort();
+    };
+    return {
+        definitions: [{
+                name: feedbackSubmittedEventName,
+                description: "Feedback was recorded in a subscribed collection. Read the exact record with get-feedback-submission before acting on its contents.",
+                inputSchema: subscriptionArguments,
+                payloadSchema: payload,
+                async listWire(ownerKey, wire) {
+                    const visible = await authorizedCollections(ownerKey, "list");
+                    if (visible.length === 0)
+                        return undefined;
+                    const visibleCollectionSchema = z.enum(visible)
+                        .describe("Feedback collection containing the recorded submission.");
+                    return Object.freeze({
+                        ...wire,
+                        inputSchema: jsonObjectSchema(submittedSubscriptionArgumentsSchema(visibleCollectionSchema, visible.length)),
+                        payloadSchema: jsonObjectSchema(submittedReference.extend({ collection: visibleCollectionSchema })),
+                    });
+                },
+                matches: (arguments_, data) => Array.isArray(arguments_.collections) && arguments_.collections.includes(data.collection),
+            }],
+        ownerKey: options.ownerKey,
+        async authorize({ ownerKey, name, arguments: arguments_, phase }) {
+            if (name !== feedbackSubmittedEventName)
+                return false;
+            if (phase === "list")
+                return (await authorizedCollections(ownerKey, phase)).length > 0;
+            const parsed = subscriptionArguments.safeParse(arguments_);
+            if (!parsed.success)
+                return false;
+            for (const collection of parsed.data.collections) {
+                if (!await options.canMonitorCollection({ ownerKey, collection, phase }))
+                    return false;
+            }
+            return true;
+        },
+        health: options.health,
+        store: options.store,
+        ...(options.callbackTimeoutMs === undefined ? {} : { callbackTimeoutMs: options.callbackTimeoutMs }),
+    };
+}
+function submittedSubscriptionArgumentsSchema(collectionSchema, maximum) {
+    return z.strictObject({
+        collections: z.array(collectionSchema)
+            .describe("One or more authorized feedback collections to monitor.")
+            .min(1)
+            .max(maximum)
+            .superRefine((selected, context) => {
+            if (new Set(selected).size !== selected.length) {
+                context.addIssue({ code: "custom", message: "List each collection once, then try again." });
+            }
+        })
+            .overwrite((selected) => [...selected].sort()),
+    });
+}
+function jsonObjectSchema(schema) {
+    const json = z.toJSONSchema(schema);
+    if (!json || typeof json !== "object" || Array.isArray(json) || json.type !== "object") {
+        throw new TypeError("feedback submitted event schemas must describe objects");
+    }
+    return json;
+}
+/**
+ * Publish a body-free submission reference from a validated durable-record event.
+ * `context.scope` selects the event owner and must equal the stable key returned by `ownerKey`.
+ */
+export async function publishFeedbackSubmittedEvent(app, event, context) {
+    const checked = feedbackSubmissionRecordedEventSchema.parse(event);
+    await publishMcpEvent(app, feedbackSubmittedEventName, submittedReference.parse({
+        collection: checked.record.collection,
+        submissionId: checked.record.submissionId,
+        sourceEventId: checked.id,
+    }), { ownerKey: context.scope });
+    return true;
+}
+//# sourceMappingURL=mcp-events.js.map

package/dist/mcp-events.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/feedback",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "Optional detailed feedback and support conversations for Em See Pea servers",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,10 @@
       "types": "./dist/webhooks.d.ts",
       "import": "./dist/webhooks.js"
     },
+    "./mcp-events": {
+      "types": "./dist/mcp-events.d.ts",
+      "import": "./dist/mcp-events.js"
+    },
     "./testing-server": "./dist/testing-server.js"
   },
   "files": [
@@ -55,18 +59,18 @@
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.type-tests.json",
     "prepack": "npm run build",
     "test": "npm run build && npm run test:built",
-    "test:built": "node --test test/*.test.mjs",
+    "test:built": "node --test test/*.test.mjs src/*.test.js",
     "test:postgres": "cd ../../examples/multi-instance-postgres-server && node test/with-postgres.mjs node --test ../../packages/feedback/test/postgres.integration.mjs",
     "test:llm": "npm run build && npm run test:llm:built",
     "test:llm:built": "emseepea-test eval",
     "lint": "oxlint src test eval"
   },
   "dependencies": {
-    "@emseepea/server": "0.21.0",
+    "@emseepea/server": "0.22.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@emseepea/testing": "0.20.2",
+    "@emseepea/testing": "0.20.4",
     "pg": "8.23.0"
   },
   "engines": {