@emseepea/feedback 0.5.3 → 0.7.0

package/README.md

@@ -5,8 +5,6 @@ defines the limits of that label.
 
 Add detailed feedback or a durable support conversation to any Em See Pea
 server. The package is optional. Generated applications do not configure it.
-Their semantic tests install it only as a development dependency so successful
-example journeys can prove that the AI did not record negative feedback.
 
 Use a submission when the team only needs one useful observation. Use a
 conversation when the team must reply and the AI must bring that reply back to
@@ -59,6 +57,199 @@ or expected number of steps is not feedback-worthy.
 These are instructions for the AI, not server-enforced guarantees. Qualify the
 behaviour with a native semantic test for every AI client you support.
 
+## Separate Customer and Internal Feedback
+
+A collection is a deployment-configured authorization partition, such as
+`customer` or `internal`. It identifies the feedback destination, not an
+account or person. Declare submission, monitoring, and operator roles
+separately; declaring a collection grants none of those roles automatically.
+
+| Deployment | Submission destination | Monitoring and retrieval |
+| --- | --- | --- |
+| Customer-facing MCP | `customer` only | None |
+| Internal MCP | Explicitly `internal` | Protected access to `internal`, `customer`, or both authorized collections |
+
+The support backend owns the authoritative record, assignment, status,
+replies, notifications, and private notes. Em See Pea reads and writes exact
+records there; it does not create a second support inbox.
+
+Use the same stable account scope for submission and operator adapters and
+the MCP Events `ownerKey`. Resolve it from verified authentication. Do not use
+an access token or assume an OAuth client ID identifies an account. Two
+accounts using the same collection remain separate.
+
+### Configure customer submission only
+
+The imports from `./feedback-integration.js` are application code you provide.
+`feedbackBackend` implements `FeedbackCollectionSubmissionBackend` over your
+durable support storage. It enforces `context.scope` on every write, list,
+lookup, and cursor.
+
+`accountScopeForPrincipal` resolves the authenticated account. `authentication`
+supplies your checked OAuth verifier and metadata.
+
+```ts
+import {
+  defineFeedbackCollections,
+  defineFeedbackCollectionSubmissions,
+} from "@emseepea/feedback";
+import { createEmseepea } from "@emseepea/server";
+import {
+  authentication, feedbackBackend, accountScopeForPrincipal,
+} from "./feedback-integration.js";
+
+const customer = defineFeedbackCollections({
+  collections: ["customer"],
+  submissions: [{
+    collection: "customer", access: "protected",
+    requiredScopes: ["feedback:submit"],
+  }],
+});
+
+const app = createEmseepea({
+  name: "customer-feedback", version: "1.0.0", authentication,
+  tools: defineFeedbackCollectionSubmissions({
+    definition: customer,
+    scope: accountScopeForPrincipal,
+    backend: feedbackBackend,
+  }),
+});
+```
+
+This exposes `submit-customer-feedback` with a fixed destination. The caller
+cannot select a collection. It exposes no operator tools or MCP Events.
+If anonymous submission is intentional, declare `access: "public"` without
+`requiredScopes` and provide a fixed, application-owned storage scope.
+
+### Configure internal submission and protected operators
+
+The application module below also supplies a durable `eventStore`, its
+`eventSystemHealthy` check, and `accountScopeForAuth` using the same account
+projection as `accountScopeForPrincipal`. `canMonitorCollection` checks the
+owner's current permission for the collection and requested lifecycle phase.
+
+Enforce the declared monitor scopes in that callback; the helper does not
+infer grants from the role declaration.
+
+```ts
+import {
+  defineFeedbackCollections,
+  defineFeedbackCollectionSubmissions,
+  defineFeedbackCollectionOperators,
+} from "@emseepea/feedback";
+import {
+  createFeedbackSubmittedEventsOptions,
+  publishFeedbackSubmittedEvent,
+} from "@emseepea/feedback/mcp-events";
+import { createEmseepea } from "@emseepea/server";
+import {
+  authentication, feedbackBackend, accountScopeForPrincipal,
+  accountScopeForAuth, canMonitorCollection, eventStore, eventSystemHealthy,
+} from "./feedback-integration.js";
+
+const internal = defineFeedbackCollections({
+  collections: ["customer", "internal"],
+  submissions: [{
+    collection: "internal", access: "protected",
+    requiredScopes: ["feedback:submit:internal"],
+  }],
+  operators: [
+    { collection: "internal", access: "protected",
+      requiredScopes: ["feedback:operator", "feedback:read:internal"] },
+    { collection: "customer", access: "protected",
+      requiredScopes: ["feedback:operator", "feedback:read:customer"] },
+  ],
+  monitors: [
+    { collection: "internal", access: "protected",
+      requiredScopes: ["feedback:monitor:internal"] },
+    { collection: "customer", access: "protected",
+      requiredScopes: ["feedback:monitor:customer"] },
+  ],
+});
+
+const events = createFeedbackSubmittedEventsOptions({
+  definition: internal,
+  ownerKey: accountScopeForAuth,
+  canMonitorCollection,
+  health: eventSystemHealthy,
+  store: eventStore,
+});
+
+let app: ReturnType<typeof createEmseepea>;
+app = createEmseepea({
+  name: "internal-feedback", version: "1.0.0", authentication, events,
+  tools: [
+    ...defineFeedbackCollectionSubmissions({
+      definition: internal,
+      scope: accountScopeForPrincipal,
+      backend: feedbackBackend,
+      hooks: [(event, context) => publishFeedbackSubmittedEvent(app, event, context)
+        .then(() => undefined)],
+    }),
+    ...defineFeedbackCollectionOperators({
+      definition: internal,
+      scope: accountScopeForPrincipal,
+      backend: feedbackBackend,
+    }),
+  ],
+});
+```
+
+The internal submission tool is `submit-internal-feedback`. Operator roles
+must share a tool-entry scope, here `feedback:operator`. Each call also checks
+every scope for its selected collection before accessing the backend.
+Use protected tool discovery when operator names and schemas must be hidden.
+
+Hooks run after persistence and are best-effort. For reliable notification,
+save the recorded event and its account scope in a transactional outbox and
+call `publishFeedbackSubmittedEvent(app, event, { scope })` from your worker.
+The publisher targets only subscriptions whose `ownerKey` equals that scope.
+Keep the scope in trusted storage, outside the delivered payload.
+
+### Read and monitor exact submissions
+
+`list-feedback-submissions` accepts `{ collection, cursor?, limit? }`.
+The limit defaults to 20 and cannot exceed 50. Pass the returned `nextCursor`
+unchanged for the next page in the same collection and account scope.
+`get-feedback-submission` accepts the exact `{ collection, submissionId }`.
+Unknown, unauthorized, and mismatched records return the same public error.
+
+Results contain `collection`, `submissionId`, `observation`, `detail`, and
+`recordedAt`. Supply `contextSchema` to both tool builders to accept and return
+validated application context. Backend `source` and authorization `scope`
+are excluded; results cannot exceed 256 KiB.
+
+Discover `feedback.submitted` with `events/list`, then subscribe using one of
+these argument sets:
+
+```json
+{ "collections": ["internal"] }
+```
+
+```json
+{ "collections": ["customer"] }
+```
+
+```json
+{ "collections": ["customer", "internal"] }
+```
+
+Use only currently authorized collections. The selection must be non-empty,
+unique, and no larger than 32 configured monitor collections. It is sorted
+before subscription identity is calculated. Discovery, subscription, refresh,
+and delivery each recheck authorization; delivery also rechecks queued work.
+
+The payload is exactly `{ collection, submissionId, sourceEventId }`.
+Retrieve the authoritative record with `get-feedback-submission` before
+acting on it. Use `sourceEventId` to recognize repeated publication. Configure
+callback verification and a durable delivery store as described in the
+[MCP Events guide](https://emseepea.github.io/emseepea/mcp-events/).
+
+`createFeedbackSubmittedEventsOptions` returns `undefined` when no monitor
+role exists. The included `createInMemoryFeedbackCollectionBackend` is
+process-local reference storage; supply a durable collection backend for
+deployment. Existing conversation adapters retain their conversation APIs.
+
 ## Add a Protected Support Conversation
 
 ```ts
@@ -209,11 +400,8 @@ Configure Zendesk's webhook body to match the documented `eventId`, `subdomain`,
 `ticketId`, `scopeTag`, `occurredAt`, and `change` shape exported by the
 TypeScript API.
 
-The included GitHub and Zendesk checks are deterministic HTTP contract tests,
-not evidence from a live customer account. Provider-native assignment,
-categorisation, milestone, status, notification, and email behavior remains the
-provider's responsibility and must be qualified in the account where you deploy
-the adapter.
+Configure assignment, categories, milestones, status, notifications, and email
+in the provider account where you deploy the adapter.
 
 ## Handle Feedback Events
 
@@ -241,6 +429,37 @@ and cannot change the MCP result. Hook code must honor that signal and deadline.
 For reliable delivery, use the PostgreSQL or Firestore outbox, or GitHub and
 Zendesk native automation.
 
+### Notify an AI client about a team reply
+
+A protected conversation can optionally use MCP Events to tell a subscribed AI
+client that a team reply is ready. The event carries only the account or client
+scope and stable thread, message, and source-event IDs. It does not carry the
+reply text. The client should call `get-feedback-thread` and present the reply
+to the person.
+
+1. Configure `createFeedbackReplyEventsOptions` from
+   `@emseepea/feedback/mcp-events` as the server's `events` option. Use the same
+   stable account or client scope for its `ownerKey` as for
+   `defineFeedbackConversation({ scope })`.
+2. Supply `canReadThread(ownerKey, threadId)` to check access to the exact
+   thread. The check runs when subscribing and again before delivery. Supply
+   your durable MCP Events store and health check as described in the
+   [MCP Events guide](https://emseepea.github.io/emseepea/mcp-events/).
+3. After saving a team reply, pass its typed feedback event to
+   `publishFeedbackTeamReplyEvent(app, event)`. For PostgreSQL or Firestore,
+   publish from the transactional outbox: a saved queue that can be retried
+   after failures. For GitHub or Zendesk, use the checked provider webhook.
+   The helper ignores non-team events and publishes only a reference to a team
+   message.
+
+An outbox retry can publish the same reply more than once. Use the stable
+`sourceEventId` in the event payload to recognise duplicates.
+
+The Markdown destination is one-way and has no team reply to announce. An
+event delivery, or a reply being offered to an AI client, does not prove a
+person saw it. Test the complete reply journey in your own client and
+deployment before relying on it.
+
 ## Effect and Retry Limits
 
 Creating a thread, submitting feedback, and appending a message are

package/dist/collections.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export declare const feedbackCollectionSchema: z.ZodString;
+export type FeedbackCollection = z.output<typeof feedbackCollectionSchema>;
+export type FeedbackCollectionRole = "submission" | "operator" | "monitor";
+export type FeedbackSubmissionRoleDeclaration = Readonly<{
+    collection: FeedbackCollection;
+    access: "public";
+    requiredScopes?: never;
+}> | Readonly<{
+    collection: FeedbackCollection;
+    access: "protected";
+    requiredScopes: readonly string[];
+}>;
+export interface FeedbackProtectedRoleDeclaration {
+    readonly collection: FeedbackCollection;
+    readonly access: "protected";
+    readonly requiredScopes: readonly string[];
+}
+export interface FeedbackCollectionsOptions {
+    readonly collections: readonly FeedbackCollection[];
+    readonly submissions?: readonly FeedbackSubmissionRoleDeclaration[];
+    readonly operators?: readonly FeedbackProtectedRoleDeclaration[];
+    readonly monitors?: readonly FeedbackProtectedRoleDeclaration[];
+}
+export interface FeedbackCollectionCatalogueEntry {
+    readonly id: FeedbackCollection;
+    readonly roles: readonly FeedbackCollectionRole[];
+}
+export interface FeedbackSubmissionRoleProjection {
+    readonly collection: FeedbackCollection;
+    readonly toolName: `submit-${string}-feedback`;
+    readonly access: "public" | "protected";
+    readonly requiredScopes: readonly string[];
+}
+export interface FeedbackProtectedRoleProjection {
+    readonly collection: FeedbackCollection;
+    readonly access: "protected";
+    readonly requiredScopes: readonly string[];
+}
+export interface FeedbackCollectionsDefinition {
+    readonly catalogue: readonly FeedbackCollectionCatalogueEntry[];
+    readonly submissions: readonly FeedbackSubmissionRoleProjection[];
+    readonly operators: readonly FeedbackProtectedRoleProjection[];
+    readonly monitors: readonly FeedbackProtectedRoleProjection[];
+}
+export declare function defineFeedbackCollections(options: FeedbackCollectionsOptions): FeedbackCollectionsDefinition;
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB,aAE2B,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,iCAAiC,GACzC,QAAQ,CAAC;IACT,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC,GACA,QAAQ,CAAC;IACT,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC;AAEL,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,iCAAiC,EAAE,CAAC;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CACjE;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,UAAU,MAAM,WAAW,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC/D;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,6BAA6B,CAuC/B"}

package/dist/collections.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+export const feedbackCollectionSchema = z.string()
+    .regex(/^[a-z][a-z0-9._-]{0,63}$/)
+    .describe("Deployment-static feedback collection identifier.");
+export function defineFeedbackCollections(options) {
+    const raw = requireRecord(options, "Feedback collections configuration");
+    rejectUnknownKeys(raw, ["collections", "submissions", "operators", "monitors"], "Feedback collections configuration");
+    if (!Array.isArray(raw.collections) || raw.collections.length === 0) {
+        throw new TypeError("Feedback collections configuration requires at least one collection");
+    }
+    const declared = new Set();
+    for (const value of raw.collections) {
+        const checked = feedbackCollectionSchema.safeParse(value);
+        if (!checked.success)
+            throw new TypeError("Invalid feedback collection identifier");
+        if (declared.has(checked.data)) {
+            throw new TypeError(`Duplicate collection: ${checked.data}`);
+        }
+        declared.add(checked.data);
+    }
+    const submissions = compileSubmissionRoles(raw.submissions, declared);
+    const operators = compileProtectedRoles("operator", raw.operators, declared);
+    const monitors = compileProtectedRoles("monitor", raw.monitors, declared);
+    const submissionCollections = new Set(submissions.map(({ collection }) => collection));
+    const operatorCollections = new Set(operators.map(({ collection }) => collection));
+    const monitorCollections = new Set(monitors.map(({ collection }) => collection));
+    const catalogue = [...declared].sort().map((id) => Object.freeze({
+        id,
+        roles: Object.freeze([
+            ...(submissionCollections.has(id) ? ["submission"] : []),
+            ...(operatorCollections.has(id) ? ["operator"] : []),
+            ...(monitorCollections.has(id) ? ["monitor"] : []),
+        ]),
+    }));
+    return Object.freeze({
+        catalogue: Object.freeze(catalogue),
+        submissions: Object.freeze(submissions),
+        operators: Object.freeze(operators),
+        monitors: Object.freeze(monitors),
+    });
+}
+function compileSubmissionRoles(value, declared) {
+    const entries = optionalArray(value, "Submission roles");
+    const toolNames = new Set();
+    const projections = entries.map((entry) => {
+        const role = requireRecord(entry, "Submission role");
+        if (Object.keys(role).some((key) => !["collection", "access", "requiredScopes"].includes(key))) {
+            throw new TypeError("Submission destination must be fixed by deployment configuration");
+        }
+        const collection = collectionReference(role.collection, declared);
+        const toolName = submissionToolName(collection);
+        if (toolNames.has(toolName))
+            throw new TypeError(`Duplicate submission tool name: ${toolName}`);
+        toolNames.add(toolName);
+        if (role.access !== "public" && role.access !== "protected") {
+            throw new TypeError("Submission access must be public or protected");
+        }
+        const requiredScopes = role.access === "protected"
+            ? protectedScopes("Submission", role.requiredScopes)
+            : publicScopes(role.requiredScopes);
+        return Object.freeze({ collection, toolName, access: role.access, requiredScopes });
+    });
+    return projections.sort(compareCollection);
+}
+function compileProtectedRoles(roleName, value, declared) {
+    const entries = optionalArray(value, `${roleName} roles`);
+    const collections = new Set();
+    const projections = entries.map((entry) => {
+        const role = requireRecord(entry, `${capitalize(roleName)} role`);
+        rejectUnknownKeys(role, ["collection", "access", "requiredScopes"], `${capitalize(roleName)} role`);
+        const collection = collectionReference(role.collection, declared);
+        if (collections.has(collection))
+            throw new TypeError(`Duplicate ${roleName} role for collection: ${collection}`);
+        collections.add(collection);
+        if (role.access !== "protected") {
+            throw new TypeError(`${capitalize(roleName)} roles must use protected access`);
+        }
+        return Object.freeze({
+            collection,
+            access: "protected",
+            requiredScopes: protectedScopes(capitalize(roleName), role.requiredScopes),
+        });
+    });
+    return projections.sort(compareCollection);
+}
+function collectionReference(value, declared) {
+    const checked = feedbackCollectionSchema.safeParse(value);
+    if (!checked.success || !declared.has(checked.data)) {
+        throw new TypeError(`Role references undeclared collection: ${String(value)}`);
+    }
+    return checked.data;
+}
+function submissionToolName(collection) {
+    const slug = collection.replace(/[._]+/g, "-");
+    return `submit-${slug}-feedback`;
+}
+function protectedScopes(roleName, value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new TypeError(`${roleName} role requires at least one scope`);
+    }
+    const scopes = value.map((scope) => {
+        if (typeof scope !== "string" || scope.length > 240 || !/^[\x21\x23-\x5B\x5D-\x7E]+$/.test(scope)) {
+            throw new TypeError(`${roleName} role contains an invalid scope`);
+        }
+        return scope;
+    });
+    if (new Set(scopes).size !== scopes.length) {
+        throw new TypeError(`${roleName} role contains duplicate scopes`);
+    }
+    return Object.freeze(scopes);
+}
+function publicScopes(value) {
+    if (value !== undefined)
+        throw new TypeError("Public submission roles cannot declare scopes");
+    return Object.freeze([]);
+}
+function optionalArray(value, label) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new TypeError(`${label} must be an array`);
+    return value;
+}
+function requireRecord(value, label) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+    return value;
+}
+function rejectUnknownKeys(value, allowed, label) {
+    if (Object.keys(value).some((key) => !allowed.includes(key))) {
+        throw new TypeError(`${label} contains an unsupported field`);
+    }
+}
+function compareCollection(a, b) {
+    return a.collection < b.collection ? -1 : a.collection > b.collection ? 1 : 0;
+}
+function capitalize(value) {
+    return `${value[0]?.toUpperCase()}${value.slice(1)}`;
+}
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { type EmseepeaTool, type Principal } from "@emseepea/server";
 import { z } from "zod";
+import { type FeedbackCollection, type FeedbackCollectionsDefinition } from "./collections.js";
+export * from "./collections.js";
 export declare const feedbackObservationSchema: z.ZodEnum<{
     error: "error";
     friction: "friction";
@@ -72,6 +74,131 @@ export interface FeedbackAdapterContext {
     readonly signal: AbortSignal;
     readonly deadlineMs: number;
 }
+export declare const feedbackSubmissionSourceReferenceSchema: z.ZodObject<{
+    system: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const feedbackSubmissionRecordSchema: z.ZodObject<{
+    collection: z.ZodString;
+    submissionId: z.ZodString;
+    scope: z.ZodString;
+    observation: 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";
+    }>;
+    detail: z.ZodString;
+    context: z.ZodOptional<z.ZodUnknown>;
+    recordedAt: z.ZodISODateTime;
+    source: z.ZodObject<{
+        system: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const feedbackSubmissionReferenceSchema: z.ZodObject<{
+    collection: z.ZodString;
+    submissionId: z.ZodString;
+}, z.core.$strict>;
+export declare const feedbackSubmissionRecordedEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"feedback.submission.recorded">;
+    occurredAt: z.ZodISODateTime;
+    record: z.ZodObject<{
+        collection: z.ZodString;
+        submissionId: z.ZodString;
+    }, z.core.$strict>;
+    source: z.ZodObject<{
+        system: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const getFeedbackSubmissionQuerySchema: z.ZodObject<{
+    collection: z.ZodString;
+    submissionId: z.ZodString;
+}, z.core.$strict>;
+export declare const listFeedbackSubmissionsQuerySchema: z.ZodObject<{
+    collection: z.ZodString;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const feedbackSubmissionPageSchema: z.ZodObject<{
+    submissions: z.ZodArray<z.ZodObject<{
+        collection: z.ZodString;
+        submissionId: z.ZodString;
+        scope: z.ZodString;
+        observation: 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";
+        }>;
+        detail: z.ZodString;
+        context: z.ZodOptional<z.ZodUnknown>;
+        recordedAt: z.ZodISODateTime;
+        source: z.ZodObject<{
+            system: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FeedbackSubmissionSourceReference = z.output<typeof feedbackSubmissionSourceReferenceSchema>;
+export type FeedbackSubmissionRecord = z.output<typeof feedbackSubmissionRecordSchema>;
+export type FeedbackSubmissionReference = z.output<typeof feedbackSubmissionReferenceSchema>;
+export type FeedbackSubmissionRecordedEvent = z.output<typeof feedbackSubmissionRecordedEventSchema>;
+export type GetFeedbackSubmissionQuery = z.output<typeof getFeedbackSubmissionQuerySchema>;
+export type ListFeedbackSubmissionsQuery = z.output<typeof listFeedbackSubmissionsQuerySchema>;
+export type FeedbackSubmissionPage = z.output<typeof feedbackSubmissionPageSchema>;
+export interface FeedbackCollectionBackend {
+    getSubmission(query: GetFeedbackSubmissionQuery, context: FeedbackAdapterContext): FeedbackSubmissionRecord | undefined | Promise<FeedbackSubmissionRecord | undefined>;
+    listSubmissions(query: ListFeedbackSubmissionsQuery, context: FeedbackAdapterContext): FeedbackSubmissionPage | Promise<FeedbackSubmissionPage>;
+}
+export interface FeedbackCollectionSubmissionBackend<Context = undefined> extends FeedbackCollectionBackend {
+    recordSubmission(command: Readonly<{
+        collection: FeedbackCollection;
+        observation: FeedbackObservation;
+        detail: string;
+        context: Context;
+    }>, context: FeedbackAdapterContext): FeedbackSubmissionRecord | Promise<FeedbackSubmissionRecord>;
+}
+export type FeedbackSubmissionRecordedHook = (event: Readonly<FeedbackSubmissionRecordedEvent>, context: FeedbackAdapterContext) => void | Promise<void>;
+export interface InMemoryFeedbackCollectionOptions {
+    readonly sourceSystem?: string;
+    readonly initialRecords?: readonly unknown[];
+    readonly createSubmissionId?: () => string;
+    readonly now?: () => string;
+}
+export declare function createInMemoryFeedbackCollectionBackend<Context = undefined>(options?: InMemoryFeedbackCollectionOptions): FeedbackCollectionSubmissionBackend<Context>;
+export interface FeedbackCollectionSubmissionOptions<ContextSchema extends z.ZodType = z.ZodUndefined> {
+    readonly definition: FeedbackCollectionsDefinition;
+    readonly scope?: string | ((principal: Principal | undefined) => string);
+    readonly contextSchema?: ContextSchema;
+    readonly backend: FeedbackCollectionSubmissionBackend<z.output<ContextSchema>>;
+    readonly hooks?: readonly FeedbackSubmissionRecordedHook[];
+}
+export declare function defineFeedbackCollectionSubmissions<ContextSchema extends z.ZodType = z.ZodUndefined>(options: FeedbackCollectionSubmissionOptions<ContextSchema>): readonly EmseepeaTool[];
+export interface FeedbackCollectionOperatorOptions<ContextSchema extends z.ZodType = z.ZodNever> {
+    readonly definition: FeedbackCollectionsDefinition;
+    readonly scope?: string | ((principal: Principal | undefined) => string);
+    readonly contextSchema?: ContextSchema;
+    readonly backend: FeedbackCollectionBackend;
+}
+export declare function defineFeedbackCollectionOperators<ContextSchema extends z.ZodType = z.ZodNever>(options: FeedbackCollectionOperatorOptions<ContextSchema>): readonly EmseepeaTool[];
 export declare const feedbackEventSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
@@ -316,5 +443,4 @@ export interface FeedbackConversationOptions {
     readonly hooks?: readonly FeedbackEventHook[];
 }
 export declare function defineFeedbackConversation(options: FeedbackConversationOptions): readonly EmseepeaTool[];
-export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EACnC,MAAM,kBAAkB,CAAC;AAE1B,cAAc,kBAAkB,CAAC;AAMjC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAYuB,CAAC;AAe9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAWhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;iBAIrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,uCAAuC;;;kBAGlD,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;iBASzC,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;kBAG5C,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;kBAMhD,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;kBAAoC,CAAC;AAClF,eAAO,MAAM,kCAAkC;;;;kBAI7C,CAAC;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGvC,CAAC;AAEH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CACtD,OAAO,uCAAuC,CAC/C,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACvF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC7F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,qCAAqC,CAC7C,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC3F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC/F,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,aAAa,CACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,sBAAsB,GAC9B,wBAAwB,GAAG,SAAS,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;IACxF,eAAe,CACb,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,mCAAmC,CAAC,OAAO,GAAG,SAAS,CACtE,SAAQ,yBAAyB;IACjC,gBAAgB,CACd,OAAO,EAAE,QAAQ,CAAC;QAChB,UAAU,EAAE,kBAAkB,CAAC;QAC/B,WAAW,EAAE,mBAAmB,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,EACF,OAAO,EAAE,sBAAsB,GAC9B,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,KAAK,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EAChD,OAAO,EAAE,sBAAsB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,wBAAgB,uCAAuC,CAAC,OAAO,GAAG,SAAS,EACzE,OAAO,GAAE,iCAAsC,GAC9C,mCAAmC,CAAC,OAAO,CAAC,CAyE9C;AAED,MAAM,WAAW,mCAAmC,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY;IACnG,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC5D;AAED,wBAAgB,mCAAmC,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAClG,OAAO,EAAE,mCAAmC,CAAC,aAAa,CAAC,GAC1D,SAAS,YAAY,EAAE,CAwEzB;AAED,MAAM,WAAW,iCAAiC,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,QAAQ;IAC7F,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C;AAOD,wBAAgB,iCAAiC,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,QAAQ,EAC5F,OAAO,EAAE,iCAAiC,CAAC,aAAa,CAAC,GACxD,SAAS,YAAY,EAAE,CAqHzB;AAQD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,OAAO,EAAE,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,KAC3D,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,yBAAyB,CAAC,OAAO,GAAG,SAAS;IAC5D,MAAM,CACJ,OAAO,EAAE,QAAQ,CAAC;QAChB,WAAW,EAAE,mBAAmB,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,EACF,OAAO,EAAE,sBAAsB,GAC9B,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjE;AAED,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;kBAA4C,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAwBtE,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE9E,MAAM,WAAW,yBAAyB,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY;IACzF,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED,wBAAgB,wBAAwB,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACvF,OAAO,EAAE,yBAAyB,CAAC,aAAa,CAAC,GAChD,YAAY,CAkEd;AAED,QAAA,MAAM,yBAAyB;;;kBAG7B,CAAC;AACH,QAAA,MAAM,0BAA0B;;;kBAG9B,CAAC;AACH,QAAA,MAAM,sBAAsB;;;kBAG1B,CAAC;AACH,QAAA,MAAM,oBAAoB;;kBAExB,CAAC;AAMH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAG5B,CAAC;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAG7B,CAAC;AACH,QAAA,MAAM,uBAAuB;;;;;;;;;;;kBAE3B,CAAC;AACH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGzB,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAClF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACpF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE5E,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CACV,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,sBAAsB,GAC9B,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACpE,aAAa,CACX,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,sBAAsB,GAC9B,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACtE,WAAW,CACT,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,sBAAsB,GAC9B,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAClE,SAAS,CACP,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,sBAAsB,GAC9B,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,YAAY,EAAE,CAkFxG"}