@emseepea/feedback 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,328 @@
+import { type EmseepeaTool, type Principal } from "@emseepea/server";
+import { z } from "zod";
+export declare const feedbackObservationSchema: z.ZodEnum<{
+    error: "error";
+    friction: "friction";
+    annoyance: "annoyance";
+    unnecessary_difficulty: "unnecessary_difficulty";
+    confusion: "confusion";
+    repetition: "repetition";
+    unexpected_good_result: "unexpected_good_result";
+    unexpected_bad_result: "unexpected_bad_result";
+    capability_mismatch: "capability_mismatch";
+    suggestion: "suggestion";
+    notable_success: "notable_success";
+}>;
+export declare const feedbackMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    threadId: z.ZodString;
+    sequence: z.ZodNumber;
+    author: z.ZodEnum<{
+        user: "user";
+        system: "system";
+        team: "team";
+    }>;
+    kind: z.ZodEnum<{
+        status: "status";
+        comment: "comment";
+        question: "question";
+    }>;
+    body: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    offeredToClientAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare const feedbackThreadSchema: z.ZodObject<{
+    id: z.ZodString;
+    subject: z.ZodString;
+    status: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const feedbackConversationSchema: z.ZodObject<{
+    id: z.ZodString;
+    subject: z.ZodString;
+    status: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        threadId: z.ZodString;
+        sequence: z.ZodNumber;
+        author: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>;
+        kind: z.ZodEnum<{
+            status: "status";
+            comment: "comment";
+            question: "question";
+        }>;
+        body: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        offeredToClientAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type FeedbackObservation = z.output<typeof feedbackObservationSchema>;
+export type FeedbackMessage = z.output<typeof feedbackMessageSchema>;
+export type FeedbackThread = z.output<typeof feedbackThreadSchema>;
+export type FeedbackConversation = z.output<typeof feedbackConversationSchema>;
+export interface FeedbackAdapterContext {
+    readonly scope: string;
+    readonly signal: AbortSignal;
+    readonly deadlineMs: number;
+}
+export declare const feedbackEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        "feedback.thread.created": "feedback.thread.created";
+        "feedback.message.added": "feedback.message.added";
+        "feedback.status.changed": "feedback.status.changed";
+        "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    scope: z.ZodString;
+    threadId: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        system: "system";
+        team: "team";
+    }>>;
+}, z.core.$strict>;
+export type FeedbackEvent = z.output<typeof feedbackEventSchema>;
+export type FeedbackEventHook = (event: Readonly<FeedbackEvent>, context: Readonly<{
+    signal: AbortSignal;
+    deadlineMs: number;
+}>) => void | Promise<void>;
+export interface FeedbackSubmissionBackend<Context = undefined> {
+    submit(command: Readonly<{
+        observation: FeedbackObservation;
+        detail: string;
+        context: Context;
+    }>, context: FeedbackAdapterContext): FeedbackSubmissionResult | Promise<FeedbackSubmissionResult>;
+}
+declare const backendEventSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        "feedback.thread.created": "feedback.thread.created";
+        "feedback.message.added": "feedback.message.added";
+        "feedback.status.changed": "feedback.status.changed";
+        "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+    }>;
+    id: z.ZodString;
+    threadId: z.ZodString;
+    author: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        system: "system";
+        team: "team";
+    }>>;
+    occurredAt: z.ZodISODateTime;
+    messageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type FeedbackBackendEvent = z.input<typeof backendEventSchema>;
+declare const submissionResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    recordedAt: z.ZodISODateTime;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "feedback.thread.created": "feedback.thread.created";
+            "feedback.message.added": "feedback.message.added";
+            "feedback.status.changed": "feedback.status.changed";
+            "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+        }>;
+        id: z.ZodString;
+        threadId: z.ZodString;
+        author: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>>;
+        occurredAt: z.ZodISODateTime;
+        messageId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type FeedbackSubmissionResult = z.input<typeof submissionResultSchema>;
+export interface FeedbackSubmissionOptions<ContextSchema extends z.ZodType = z.ZodUndefined> {
+    readonly access: "public" | "protected";
+    readonly requiredScopes?: readonly string[];
+    readonly scope?: string | ((principal: Principal | undefined) => string);
+    readonly contextSchema?: ContextSchema;
+    readonly backend: FeedbackSubmissionBackend<z.output<ContextSchema>>;
+    readonly hooks?: readonly FeedbackEventHook[];
+}
+export declare function defineFeedbackSubmission<ContextSchema extends z.ZodType = z.ZodUndefined>(options: FeedbackSubmissionOptions<ContextSchema>): EmseepeaTool;
+declare const createThreadCommandSchema: z.ZodObject<{
+    subject: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+declare const appendMessageCommandSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+declare const listThreadsQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+declare const getThreadQuerySchema: z.ZodObject<{
+    threadId: z.ZodString;
+}, z.core.$strict>;
+declare const createThreadResultSchema: z.ZodObject<{
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        subject: z.ZodString;
+        status: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            threadId: z.ZodString;
+            sequence: z.ZodNumber;
+            author: z.ZodEnum<{
+                user: "user";
+                system: "system";
+                team: "team";
+            }>;
+            kind: z.ZodEnum<{
+                status: "status";
+                comment: "comment";
+                question: "question";
+            }>;
+            body: z.ZodString;
+            createdAt: z.ZodISODateTime;
+            offeredToClientAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "feedback.thread.created": "feedback.thread.created";
+            "feedback.message.added": "feedback.message.added";
+            "feedback.status.changed": "feedback.status.changed";
+            "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+        }>;
+        id: z.ZodString;
+        threadId: z.ZodString;
+        author: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>>;
+        occurredAt: z.ZodISODateTime;
+        messageId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const appendMessageResultSchema: z.ZodObject<{
+    message: z.ZodObject<{
+        id: z.ZodString;
+        threadId: z.ZodString;
+        sequence: z.ZodNumber;
+        author: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>;
+        kind: z.ZodEnum<{
+            status: "status";
+            comment: "comment";
+            question: "question";
+        }>;
+        body: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        offeredToClientAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "feedback.thread.created": "feedback.thread.created";
+            "feedback.message.added": "feedback.message.added";
+            "feedback.status.changed": "feedback.status.changed";
+            "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+        }>;
+        id: z.ZodString;
+        threadId: z.ZodString;
+        author: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>>;
+        occurredAt: z.ZodISODateTime;
+        messageId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const listThreadsResultSchema: z.ZodObject<{
+    page: z.ZodObject<{
+        threads: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            subject: z.ZodString;
+            status: z.ZodString;
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const getThreadResultSchema: z.ZodObject<{
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        subject: z.ZodString;
+        status: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            threadId: z.ZodString;
+            sequence: z.ZodNumber;
+            author: z.ZodEnum<{
+                user: "user";
+                system: "system";
+                team: "team";
+            }>;
+            kind: z.ZodEnum<{
+                status: "status";
+                comment: "comment";
+                question: "question";
+            }>;
+            body: z.ZodString;
+            createdAt: z.ZodISODateTime;
+            offeredToClientAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "feedback.thread.created": "feedback.thread.created";
+            "feedback.message.added": "feedback.message.added";
+            "feedback.status.changed": "feedback.status.changed";
+            "feedback.message.offered-to-client": "feedback.message.offered-to-client";
+        }>;
+        id: z.ZodString;
+        threadId: z.ZodString;
+        author: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            system: "system";
+            team: "team";
+        }>>;
+        occurredAt: z.ZodISODateTime;
+        messageId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type CreateFeedbackThreadCommand = z.output<typeof createThreadCommandSchema>;
+export type AppendFeedbackMessageCommand = z.output<typeof appendMessageCommandSchema>;
+export type ListFeedbackThreadsQuery = z.output<typeof listThreadsQuerySchema>;
+export type GetFeedbackThreadQuery = z.output<typeof getThreadQuerySchema>;
+export type CreateFeedbackThreadResult = z.input<typeof createThreadResultSchema>;
+export type AppendFeedbackMessageResult = z.input<typeof appendMessageResultSchema>;
+export type ListFeedbackThreadsResult = z.input<typeof listThreadsResultSchema>;
+export type GetFeedbackThreadResult = z.input<typeof getThreadResultSchema>;
+export interface FeedbackConversationBackend {
+    createThread(command: CreateFeedbackThreadCommand, context: FeedbackAdapterContext): CreateFeedbackThreadResult | Promise<CreateFeedbackThreadResult>;
+    appendMessage(command: AppendFeedbackMessageCommand, context: FeedbackAdapterContext): AppendFeedbackMessageResult | Promise<AppendFeedbackMessageResult>;
+    listThreads(query: ListFeedbackThreadsQuery, context: FeedbackAdapterContext): ListFeedbackThreadsResult | Promise<ListFeedbackThreadsResult>;
+    getThread(query: GetFeedbackThreadQuery, context: FeedbackAdapterContext): GetFeedbackThreadResult | Promise<GetFeedbackThreadResult>;
+}
+export interface FeedbackConversationOptions {
+    readonly requiredScopes: readonly string[];
+    readonly scope?: (principal: Principal | undefined) => string;
+    readonly backend: FeedbackConversationBackend;
+    readonly hooks?: readonly FeedbackEventHook[];
+}
+export declare function defineFeedbackConversation(options: FeedbackConversationOptions): readonly EmseepeaTool[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,255 @@
+import { defineTool, } from "@emseepea/server";
+import { z } from "zod";
+import { beforeDeadline, deadlineSignal } from "./deadline.js";
+const identifier = z.string().min(1).max(240);
+const timestamp = z.iso.datetime({ offset: true });
+const body = z.string().min(1).max(4_000);
+export const feedbackObservationSchema = z.enum([
+    "error",
+    "friction",
+    "annoyance",
+    "unnecessary_difficulty",
+    "confusion",
+    "repetition",
+    "unexpected_good_result",
+    "unexpected_bad_result",
+    "capability_mismatch",
+    "suggestion",
+    "notable_success",
+]).describe("The single notable observation being recorded.");
+export const feedbackMessageSchema = z.strictObject({
+    id: identifier.describe("Stable message identifier."),
+    threadId: identifier.describe("Stable identifier of the containing feedback thread."),
+    sequence: z.number().int().positive().describe("Stable one-based position in the thread."),
+    author: z.enum(["user", "team", "system"]).describe("Who authored the message."),
+    kind: z.enum(["comment", "question", "status"]).describe("Purpose of the message."),
+    body: body.describe("Message text that is safe to present in the feedback conversation."),
+    createdAt: timestamp.describe("When the message was created."),
+    offeredToClientAt: timestamp.optional().describe("When this team message was first included in a tool result. This does not prove human attention or comprehension."),
+});
+export const feedbackThreadSchema = z.strictObject({
+    id: identifier.describe("Stable feedback thread identifier."),
+    subject: z.string().min(1).max(200).describe("Short description of the feedback topic."),
+    status: z.string().min(1).max(80).describe("Current backend or support-system status."),
+    createdAt: timestamp.describe("When the thread was created."),
+    updatedAt: timestamp.describe("When the thread last changed."),
+});
+export const feedbackConversationSchema = feedbackThreadSchema.extend({
+    messages: z.array(feedbackMessageSchema).max(200).describe("Messages in stable sequence order. Private support notes are excluded."),
+});
+const feedbackEventTypeSchema = z.enum([
+    "feedback.thread.created",
+    "feedback.message.added",
+    "feedback.status.changed",
+    "feedback.message.offered-to-client",
+]);
+export const feedbackEventSchema = z.strictObject({
+    id: identifier,
+    type: feedbackEventTypeSchema,
+    occurredAt: timestamp,
+    scope: identifier,
+    threadId: identifier,
+    messageId: identifier.optional(),
+    author: z.enum(["user", "team", "system"]).optional(),
+});
+const backendEventSchema = feedbackEventSchema.omit({ scope: true });
+const backendEventsSchema = z.array(backendEventSchema).max(100).optional();
+const submissionNextAction = "Start your final response by answering every part of the user's original request from earlier tool results. A response that only discusses feedback is incomplete. Then tell the user, \"I recorded feedback about ...\", with a brief, specific summary of the observation.";
+const submissionResultSchema = z.strictObject({
+    id: identifier.describe("Stable feedback submission identifier."),
+    recordedAt: timestamp.describe("When the feedback was durably recorded."),
+    events: backendEventsSchema,
+});
+export function defineFeedbackSubmission(options) {
+    const inputSchema = z.strictObject({
+        observation: feedbackObservationSchema,
+        detail: body.describe("What happened, what helped or failed, what was harder than it should have been, or what was surprising."),
+        ...(options.contextSchema ? {
+            context: options.contextSchema.optional().describe("Application-declared structured context. Do not include chat history, credentials, raw tool data, or personal information."),
+        } : {}),
+    });
+    const outputSchema = submissionResultSchema.omit({ events: true }).extend({
+        nextAction: z.literal(submissionNextAction).describe("What the AI should do after the feedback was durably recorded."),
+    });
+    const common = {
+        name: "submit-feedback",
+        title: "Record Detailed Feedback",
+        description: "Record one notable observation about an error, friction, annoyance, unnecessary difficulty, confusion, repetition, an unexpected result, a capability mismatch, a suggestion, or a notable success. " +
+            "Call this tool when another tool result or the user's message reveals notable friction or another qualifying observation. Use it without asking a separate permission question. After it succeeds, fully answer the user's original request. Then briefly state the specific observation you recorded. Do not let feedback replace the requested answer. A tool that works as designed, returns structured data, or takes only the expected steps is ordinary operation. Do not record these outcomes as feedback. Do not record expected empty results, session opening or closing, duplicate observations, or anything after the user objects. Never include surrounding conversation, credentials, raw tool data, or personal information.",
+        annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+        inputSchema,
+        outputSchema,
+    };
+    const execute = async (input, toolContext) => {
+        const adapterContext = createAdapterContext(options.scope, toolContext);
+        const result = await submissionResultSchema.parseAsync(await options.backend.submit({
+            observation: input.observation,
+            detail: input.detail,
+            context: ("context" in input ? input.context : undefined),
+        }, adapterContext));
+        await dispatchHooks(options.hooks, result.events ?? [], adapterContext);
+        return {
+            data: {
+                id: result.id,
+                recordedAt: result.recordedAt,
+                nextAction: submissionNextAction,
+            },
+        };
+    };
+    if (options.access === "public") {
+        if (options.requiredScopes !== undefined) {
+            throw new Error("Public feedback submissions cannot declare requiredScopes");
+        }
+        return defineTool({ ...common, access: "public", handler: execute });
+    }
+    if (!options.requiredScopes?.length) {
+        throw new Error("Protected feedback submissions require at least one scope");
+    }
+    return defineTool({
+        ...common,
+        access: "protected",
+        requiredScopes: options.requiredScopes,
+        handler: execute,
+    });
+}
+const createThreadCommandSchema = z.strictObject({
+    subject: z.string().min(1).max(200).describe("Short description of the feedback topic."),
+    message: body.describe("Detailed first message for the support team."),
+});
+const appendMessageCommandSchema = z.strictObject({
+    threadId: identifier.describe("Exact feedback thread identifier returned by this server."),
+    message: body.describe("New user message to append to the existing support conversation."),
+});
+const listThreadsQuerySchema = z.strictObject({
+    cursor: z.string().min(1).max(1_000).optional().describe("Opaque cursor from the previous page."),
+    limit: z.number().int().min(1).max(50).default(20).describe("Maximum threads to return."),
+});
+const getThreadQuerySchema = z.strictObject({
+    threadId: identifier.describe("Exact feedback thread identifier returned by this server."),
+});
+const threadPageSchema = z.strictObject({
+    threads: z.array(feedbackThreadSchema).max(50).describe("Feedback threads visible in this scope."),
+    nextCursor: z.string().min(1).max(1_000).optional().describe("Cursor for the next page, when more threads exist."),
+});
+const createThreadResultSchema = z.strictObject({
+    conversation: feedbackConversationSchema,
+    events: backendEventsSchema,
+});
+const appendMessageResultSchema = z.strictObject({
+    message: feedbackMessageSchema,
+    events: backendEventsSchema,
+});
+const listThreadsResultSchema = z.strictObject({
+    page: threadPageSchema,
+});
+const getThreadResultSchema = z.strictObject({
+    conversation: feedbackConversationSchema,
+    events: backendEventsSchema,
+});
+export function defineFeedbackConversation(options) {
+    const access = { access: "protected", requiredScopes: options.requiredScopes };
+    const contextFor = (context) => createAdapterContext(options.scope ?? ((principal) => principal?.clientId ?? ""), context);
+    const createThread = defineTool({
+        name: "create-feedback-thread",
+        ...access,
+        title: "Start Feedback Conversation",
+        description: "Start a durable support conversation for detailed feedback. Use one thread for one observation and openly tell the user it was created. Do not include unrelated chat history, credentials, or raw tool payloads.",
+        annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+        inputSchema: createThreadCommandSchema,
+        outputSchema: feedbackConversationSchema,
+        async handler(input, toolContext) {
+            const context = contextFor(toolContext);
+            const result = await createThreadResultSchema.parseAsync(await options.backend.createThread(input, context));
+            await dispatchHooks(options.hooks, result.events ?? [], context);
+            return { data: result.conversation };
+        },
+    });
+    const appendMessage = defineTool({
+        name: "reply-to-feedback-thread",
+        ...access,
+        title: "Reply to Feedback Conversation",
+        description: "Append the user's new message to the exact existing feedback thread. Do not repeat an earlier message or invent a thread identifier.",
+        annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+        inputSchema: appendMessageCommandSchema,
+        outputSchema: feedbackMessageSchema,
+        async handler(input, toolContext) {
+            const context = contextFor(toolContext);
+            const result = await appendMessageResultSchema.parseAsync(await options.backend.appendMessage(input, context));
+            await dispatchHooks(options.hooks, result.events ?? [], context);
+            return { data: result.message };
+        },
+    });
+    const listThreads = defineTool({
+        name: "list-feedback-threads",
+        ...access,
+        title: "List Feedback Conversations",
+        description: "List feedback conversations for this authenticated client scope.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: listThreadsQuerySchema,
+        outputSchema: threadPageSchema,
+        async handler(input, toolContext) {
+            const context = contextFor(toolContext);
+            const result = await listThreadsResultSchema.parseAsync(await options.backend.listThreads(input, context));
+            return { data: result.page };
+        },
+    });
+    const getThread = defineTool({
+        name: "get-feedback-thread",
+        ...access,
+        title: "Read Feedback Conversation",
+        description: "Read one feedback conversation and present the meaning of any new team reply to the user. Reading may record that a team reply was offered to this AI client. It does not prove the user saw or understood it.",
+        annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true },
+        inputSchema: getThreadQuerySchema,
+        outputSchema: feedbackConversationSchema,
+        async handler(input, toolContext) {
+            const context = contextFor(toolContext);
+            const result = await getThreadResultSchema.parseAsync(await options.backend.getThread(input, context));
+            await dispatchHooks(options.hooks, result.events ?? [], context);
+            return { data: result.conversation };
+        },
+    });
+    return Object.freeze([createThread, appendMessage, listThreads, getThread]);
+}
+function createAdapterContext(scopeOption, context) {
+    const scope = typeof scopeOption === "function"
+        ? scopeOption(context.principal)
+        : scopeOption ?? context.principal?.clientId ?? "public";
+    const checkedScope = identifier.parse(scope);
+    return Object.freeze({
+        scope: checkedScope,
+        signal: context.signal,
+        deadlineMs: context.deadlineMs,
+    });
+}
+async function dispatchHooks(hooks, events, context) {
+    if (!hooks?.length || events.length === 0)
+        return;
+    const hookDeadlineMs = context.deadlineMs - 25;
+    for (const uncheckedEvent of events) {
+        if (context.signal.aborted || Date.now() >= hookDeadlineMs)
+            return;
+        const event = Object.freeze(feedbackEventSchema.parse({
+            ...uncheckedEvent,
+            scope: context.scope,
+        }));
+        for (const hook of hooks) {
+            if (context.signal.aborted || Date.now() >= hookDeadlineMs)
+                return;
+            try {
+                const hookContext = {
+                    signal: context.signal,
+                    deadlineMs: hookDeadlineMs,
+                };
+                const signal = deadlineSignal(hookContext);
+                await beforeDeadline(Promise.resolve(hook(event, Object.freeze({
+                    signal,
+                    deadlineMs: hookContext.deadlineMs,
+                }))), hookContext);
+            }
+            catch {
+                // Feedback is already durable. Best-effort hooks cannot change the MCP result.
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/postgres.d.ts

@@ -0,0 +1,32 @@
+import type { FeedbackConversationBackend, FeedbackSubmissionBackend } from "./index.js";
+interface QueryResult<Row> {
+    readonly rows: readonly Row[];
+    readonly rowCount: number | null;
+}
+export interface PostgresFeedbackClient {
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: readonly unknown[]): Promise<QueryResult<Row>>;
+    release(): void;
+}
+export interface PostgresFeedbackPool {
+    connect(): Promise<PostgresFeedbackClient>;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: readonly unknown[]): Promise<QueryResult<Row>>;
+}
+export declare const postgresFeedbackSchema = "\nCREATE TABLE IF NOT EXISTS emseepea_feedback_threads (\n  scope text NOT NULL,\n  id text NOT NULL,\n  subject text NOT NULL,\n  status text NOT NULL,\n  created_at timestamptz NOT NULL,\n  updated_at timestamptz NOT NULL,\n  PRIMARY KEY (scope, id)\n);\nCREATE TABLE IF NOT EXISTS emseepea_feedback_messages (\n  scope text NOT NULL,\n  thread_id text NOT NULL,\n  id text NOT NULL,\n  sequence integer NOT NULL CHECK (sequence > 0),\n  author text NOT NULL CHECK (author IN ('user', 'team', 'system')),\n  kind text NOT NULL CHECK (kind IN ('comment', 'question', 'status')),\n  body text NOT NULL,\n  created_at timestamptz NOT NULL,\n  offered_to_client_at timestamptz,\n  PRIMARY KEY (scope, id),\n  UNIQUE (scope, thread_id, sequence),\n  FOREIGN KEY (scope, thread_id) REFERENCES emseepea_feedback_threads(scope, id)\n);\nCREATE INDEX IF NOT EXISTS emseepea_feedback_threads_page\n  ON emseepea_feedback_threads(scope, updated_at DESC, id DESC);\nCREATE TABLE IF NOT EXISTS emseepea_feedback_submissions (\n  scope text NOT NULL,\n  id text NOT NULL,\n  observation text NOT NULL,\n  detail text NOT NULL,\n  context jsonb,\n  recorded_at timestamptz NOT NULL,\n  PRIMARY KEY (scope, id)\n);\nCREATE TABLE IF NOT EXISTS emseepea_feedback_outbox (\n  event_id text PRIMARY KEY,\n  event_type text NOT NULL,\n  occurred_at timestamptz NOT NULL,\n  scope text NOT NULL,\n  thread_id text NOT NULL,\n  message_id text,\n  author text,\n  dispatched_at timestamptz\n);";
+export declare function migratePostgresFeedback(pool: PostgresFeedbackPool): Promise<void>;
+export interface PostgresFeedbackOptions {
+    readonly pool: PostgresFeedbackPool;
+    readonly outbox?: boolean;
+}
+export declare function createPostgresFeedbackSubmissionBackend<Context = undefined>(options: PostgresFeedbackOptions): FeedbackSubmissionBackend<Context>;
+export declare function createPostgresFeedbackBackend(options: PostgresFeedbackOptions): FeedbackConversationBackend;
+export declare function appendPostgresTeamReply(options: PostgresFeedbackOptions, command: Readonly<{
+    scope: string;
+    threadId: string;
+    message: string;
+    status?: string;
+}>, context: Readonly<{
+    signal: AbortSignal;
+    deadlineMs: number;
+}>): Promise<void>;
+export {};
+//# sourceMappingURL=postgres.d.ts.map

package/dist/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAGpB,UAAU,WAAW,CAAC,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC3C,KAAK,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,q8CA4ChC,CAAC;AAEJ,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,uCAAuC,CAAC,OAAO,GAAG,SAAS,EACzE,OAAO,EAAE,uBAAuB,GAC/B,yBAAyB,CAAC,OAAO,CAAC,CAgBpC;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,2BAA2B,CA0I7B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,EACF,OAAO,EAAE,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,OAAO,CAAC,IAAI,CAAC,CA8Cf"}