@getuserfeedback/protocol 3.1.0 → 3.1.2

package/dist/attention-policy.d.ts

@@ -37,7 +37,7 @@ export declare const attentionPolicyConfigSchema: z.ZodMiniObject<{
     blockedBroadcastStrategy: z.ZodMiniEnum<{
         queue: "queue";
     }>;
-}, z.core.$strict>;
+}, z.core.$loose>;
 export type AttentionPolicyConfig = z.output<typeof attentionPolicyConfigSchema>;
 export declare const DEFAULT_ATTENTION_POLICY_CONFIG: AttentionPolicyConfig;
 //# sourceMappingURL=attention-policy.d.ts.map

package/dist/attention-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attention-policy.d.ts","sourceRoot":"","sources":["../src/attention-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,eAAO,MAAM,2BAA2B;;;EAAgC,CAAC;AAEzE,eAAO,MAAM,uCAAuC;;EAAoB,CAAC;AAEzE,eAAO,MAAM,uCAAuC;;EAAoB,CAAC;AAUzE,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;kBAE7C,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;kBAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,qBAO7C,CAAC"}
+{"version":3,"file":"attention-policy.d.ts","sourceRoot":"","sources":["../src/attention-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,eAAO,MAAM,2BAA2B;;;EAAgC,CAAC;AAEzE,eAAO,MAAM,uCAAuC;;EAAoB,CAAC;AAEzE,eAAO,MAAM,uCAAuC;;EAAoB,CAAC;AAUzE,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;kBAE7C,CAAC;AAKF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;iBAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,qBAO7C,CAAC"}

package/dist/attention-policy.js

@@ -10,7 +10,10 @@ const legacyAttentionPolicyConfigFields = {
     blockedBroadcastStrategy: attentionBlockedBroadcastStrategySchema,
 };
 export const legacyAttentionPolicyConfigSchema = z.strictObject(legacyAttentionPolicyConfigFields);
-export const attentionPolicyConfigSchema = z.strictObject({
+// V2 is the additive policy envelope for the flow-display wire contract.
+// Keep legacy strict, and add future policy controls here instead of creating
+// another versioned sibling field for every new setting.
+export const attentionPolicyConfigSchema = z.looseObject({
     ...legacyAttentionPolicyConfigFields,
     recentInAppCooldownMs: z._default(z.number().check(z.nonnegative()), 0),
 });

package/dist/flow-display.d.ts

@@ -228,7 +228,7 @@ export declare const flowDisplaySyncResponseSchema: z.ZodMiniObject<{
         blockedBroadcastStrategy: z.ZodMiniEnum<{
             queue: "queue";
         }>;
-    }, z.core.$strict>>;
+    }, z.core.$loose>>;
     assignments: z.ZodMiniObject<{
         claimed: z.ZodMiniArray<z.ZodMiniObject<{
             flowAssignmentId: z.ZodMiniString<string>;
@@ -303,4 +303,5 @@ export type RuntimeDisplayTrigger = z.output<typeof runtimeDisplayTriggerSchema>
 export type FlowDisplaySyncRequest = z.output<typeof flowDisplaySyncRequestSchema>;
 export type FlowDisplaySyncResponse = z.output<typeof flowDisplaySyncResponseSchema>;
 export type FlowDisplayAttentionPolicyConfig = AttentionPolicyConfig;
+export declare const resolveFlowDisplayAttentionPolicyConfig: (displaySync: Pick<FlowDisplaySyncResponse, "attentionPolicy" | "attentionPolicyV2">) => FlowDisplayAttentionPolicyConfig | undefined;
 //# sourceMappingURL=flow-display.d.ts.map

package/dist/flow-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-display.d.ts","sourceRoot":"","sources":["../src/flow-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,EACN,KAAK,qBAAqB,EAG1B,MAAM,uBAAuB,CAAC;AAO/B,eAAO,MAAM,+BAA+B;;;;;iBAU1C,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;2BAOtC,CAAC;AAQH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAY9C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAenD,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQxC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CACnD,OAAO,mCAAmC,CAC1C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAC/C,OAAO,+BAA+B,CACtC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"flow-display.d.ts","sourceRoot":"","sources":["../src/flow-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,EACN,KAAK,qBAAqB,EAG1B,MAAM,uBAAuB,CAAC;AAO/B,eAAO,MAAM,+BAA+B;;;;;iBAU1C,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;2BAOtC,CAAC;AAQH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAY9C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAenD,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQxC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CACnD,OAAO,mCAAmC,CAC1C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAC/C,OAAO,+BAA+B,CACtC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AAErE,eAAO,MAAM,uCAAuC,GACnD,aAAa,IAAI,CAChB,uBAAuB,EACvB,iBAAiB,GAAG,mBAAmB,CACvC,KACC,gCAAgC,GAAG,SAkBrC,CAAC"}

package/dist/flow-display.js

@@ -63,3 +63,20 @@ export const flowDisplaySyncResponseSchema = z.object({
     }),
     broadcasts: runtimeDisplayBroadcastsSchema,
 });
+export const resolveFlowDisplayAttentionPolicyConfig = (displaySync) => {
+    const policy = displaySync.attentionPolicyV2 ?? displaySync.attentionPolicy;
+    if (!policy) {
+        return undefined;
+    }
+    return {
+        version: policy.version,
+        source: policy.source,
+        recentFlowCooldownMs: policy.recentFlowCooldownMs,
+        recentInAppCooldownMs: "recentInAppCooldownMs" in policy &&
+            typeof policy.recentInAppCooldownMs === "number"
+            ? policy.recentInAppCooldownMs
+            : 0,
+        exclusiveSurfaceStrategy: policy.exclusiveSurfaceStrategy,
+        blockedBroadcastStrategy: policy.blockedBroadcastStrategy,
+    };
+};

package/dist/index.d.ts

@@ -7,9 +7,9 @@ export { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS } from "./defaults.js";
 export type { ErrorEvent, ProtocolErrorCode } from "./errors.js";
 export { ErrorCategory, ErrorCategorySchema, ErrorEventSchema, ProtocolError, } from "./errors.js";
 export { type ClaimPendingFlowAssignmentsRequest, type ClaimPendingFlowAssignmentsResponse, claimPendingFlowAssignmentsRequestSchema, claimPendingFlowAssignmentsResponseSchema, type FlowAssignmentExternalIdIdentityTypeValue, type FlowAssignmentIdentityTypeValue, type FlowAssignmentRecipientRequest, type FlowAssignmentRecord, type FlowAssignmentStatus, type FlowAssignmentTargetingContext, flowAssignmentRecipientRequestSchema, flowAssignmentRecordSchema, flowAssignmentStatusSchema, flowAssignmentTargetingContextSchema, type ListPendingFlowAssignmentsResponse, listPendingFlowAssignmentsResponseSchema, nullableUpdateFlowAssignmentLifecycleResponseSchema, type ReleaseFlowAssignmentClaimRequest, type ReleaseFlowAssignmentClaimResponse, releaseFlowAssignmentClaimRequestSchema, releaseFlowAssignmentClaimResponseSchema, type UpdateFlowAssignmentLifecycleRequest, type UpdateFlowAssignmentLifecycleResponse, updateFlowAssignmentLifecycleRequestSchema, updateFlowAssignmentLifecycleResponseSchema, } from "./flow-assignments.js";
-export { type FlowDisplaySyncRequest, type FlowDisplaySyncResponse, flowDisplaySyncRequestSchema, flowDisplaySyncResponseSchema, type RuntimeDisplayAttentionPolicy, type RuntimeDisplayBroadcastOpportunity, type RuntimeDisplayBroadcasts, type RuntimeDisplayEligibility, type RuntimeDisplayTrigger, runtimeDisplayAttentionPolicySchema, runtimeDisplayBroadcastOpportunitySchema, runtimeDisplayBroadcastsSchema, runtimeDisplayEligibilitySchema, runtimeDisplayTriggerSchema, } from "./flow-display.js";
+export { type FlowDisplaySyncRequest, type FlowDisplaySyncResponse, flowDisplaySyncRequestSchema, flowDisplaySyncResponseSchema, type RuntimeDisplayAttentionPolicy, type RuntimeDisplayBroadcastOpportunity, type RuntimeDisplayBroadcasts, type RuntimeDisplayEligibility, type RuntimeDisplayTrigger, resolveFlowDisplayAttentionPolicyConfig, runtimeDisplayAttentionPolicySchema, runtimeDisplayBroadcastOpportunitySchema, runtimeDisplayBroadcastsSchema, runtimeDisplayEligibilitySchema, runtimeDisplayTriggerSchema, } from "./flow-display.js";
 export { buildIdentityTypeGuidanceMessage, getIdentityTypeSuggestion, IDENTITY_TYPE_VALUES, type IdentityTypeValue, isIdentityTypeValue, type StandardIdentityTypeValue, } from "./identity-type.js";
-export { type CaptureInstanceFeedbackRequest, type CaptureInstanceFeedbackResponse, captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, type InstanceFeedbackDataType, type InstanceFeedbackValence, instanceFeedbackDataTypeSchema, instanceFeedbackValenceSchema, } from "./instance-feedback.js";
+export { type CaptureInstanceFeedbackRequest, type CaptureInstanceFeedbackResponse, captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, type InstanceFeedbackDataType, type InstanceFeedbackMineFeedback, type InstanceFeedbackValence, instanceFeedbackDataTypeSchema, instanceFeedbackMineFeedbackSchema, instanceFeedbackValenceSchema, type ListInstanceFeedbackMineRequest, type ListInstanceFeedbackMineResponse, listInstanceFeedbackMineRequestSchema, listInstanceFeedbackMineResponseSchema, } from "./instance-feedback.js";
 export { type PreviewConnectionPairRequest, type PreviewConnectionPairResponse, previewConnectionPairRequestSchema, previewConnectionPairResponseSchema, } from "./preview-connection.js";
 export { PREVIEW_PAIRING_TRANSPORT_SOURCE, type PreviewPairingHostAck, type PreviewPairingHostRequest, type PreviewPairingHostResult, previewPairingHostAckSchema, previewPairingHostRequestSchema, previewPairingHostResultSchema, } from "./preview-pairing-transport.js";
 export { isPublicGrantScope, type PublicGrantScope, publicGrantScopeIdSchema, } from "./public-grant-scope.js";

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":"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"}

package/dist/index.js

@@ -6,9 +6,9 @@ export { coreCommandPayloadSchema, } from "./core-commands.js";
 export { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS } from "./defaults.js";
 export { ErrorCategory, ErrorCategorySchema, ErrorEventSchema, ProtocolError, } from "./errors.js";
 export { claimPendingFlowAssignmentsRequestSchema, claimPendingFlowAssignmentsResponseSchema, flowAssignmentRecipientRequestSchema, flowAssignmentRecordSchema, flowAssignmentStatusSchema, flowAssignmentTargetingContextSchema, listPendingFlowAssignmentsResponseSchema, nullableUpdateFlowAssignmentLifecycleResponseSchema, releaseFlowAssignmentClaimRequestSchema, releaseFlowAssignmentClaimResponseSchema, updateFlowAssignmentLifecycleRequestSchema, updateFlowAssignmentLifecycleResponseSchema, } from "./flow-assignments.js";
-export { flowDisplaySyncRequestSchema, flowDisplaySyncResponseSchema, runtimeDisplayAttentionPolicySchema, runtimeDisplayBroadcastOpportunitySchema, runtimeDisplayBroadcastsSchema, runtimeDisplayEligibilitySchema, runtimeDisplayTriggerSchema, } from "./flow-display.js";
+export { flowDisplaySyncRequestSchema, flowDisplaySyncResponseSchema, resolveFlowDisplayAttentionPolicyConfig, runtimeDisplayAttentionPolicySchema, runtimeDisplayBroadcastOpportunitySchema, runtimeDisplayBroadcastsSchema, runtimeDisplayEligibilitySchema, runtimeDisplayTriggerSchema, } from "./flow-display.js";
 export { buildIdentityTypeGuidanceMessage, getIdentityTypeSuggestion, IDENTITY_TYPE_VALUES, isIdentityTypeValue, } from "./identity-type.js";
-export { captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, instanceFeedbackDataTypeSchema, instanceFeedbackValenceSchema, } from "./instance-feedback.js";
+export { captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, instanceFeedbackDataTypeSchema, instanceFeedbackMineFeedbackSchema, instanceFeedbackValenceSchema, listInstanceFeedbackMineRequestSchema, listInstanceFeedbackMineResponseSchema, } from "./instance-feedback.js";
 export { previewConnectionPairRequestSchema, previewConnectionPairResponseSchema, } from "./preview-connection.js";
 export { PREVIEW_PAIRING_TRANSPORT_SOURCE, previewPairingHostAckSchema, previewPairingHostRequestSchema, previewPairingHostResultSchema, } from "./preview-pairing-transport.js";
 export { isPublicGrantScope, publicGrantScopeIdSchema, } from "./public-grant-scope.js";

package/dist/instance-feedback.d.ts

@@ -33,8 +33,55 @@ export declare const captureInstanceFeedbackResponseSchema: z.ZodMiniObject<{
     evaluationId: z.ZodMiniString<string>;
     status: z.ZodMiniLiteral<"accepted">;
 }, z.core.$strip>;
+export declare const listInstanceFeedbackMineRequestSchema: z.ZodMiniObject<{
+    targets: z.ZodMiniArray<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        targetBindingToken: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const instanceFeedbackMineFeedbackSchema: z.ZodMiniObject<{
+    capturedAt: z.ZodMiniString<string>;
+    dataType: z.ZodMiniEnum<{
+        boolean: "boolean";
+        categorical: "categorical";
+        numeric: "numeric";
+    }>;
+    evaluationId: z.ZodMiniString<string>;
+    label: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    name: z.ZodMiniString<string>;
+    scoreValue: z.ZodMiniNullable<z.ZodMiniNumber<number>>;
+    valence: z.ZodMiniEnum<{
+        positive: "positive";
+        negative: "negative";
+        neutral: "neutral";
+    }>;
+}, z.core.$strip>;
+export declare const listInstanceFeedbackMineResponseSchema: z.ZodMiniObject<{
+    items: z.ZodMiniArray<z.ZodMiniObject<{
+        feedback: z.ZodMiniNullable<z.ZodMiniObject<{
+            capturedAt: z.ZodMiniString<string>;
+            dataType: z.ZodMiniEnum<{
+                boolean: "boolean";
+                categorical: "categorical";
+                numeric: "numeric";
+            }>;
+            evaluationId: z.ZodMiniString<string>;
+            label: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            name: z.ZodMiniString<string>;
+            scoreValue: z.ZodMiniNullable<z.ZodMiniNumber<number>>;
+            valence: z.ZodMiniEnum<{
+                positive: "positive";
+                negative: "negative";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type InstanceFeedbackDataType = z.output<typeof instanceFeedbackDataTypeSchema>;
 export type InstanceFeedbackValence = z.output<typeof instanceFeedbackValenceSchema>;
 export type CaptureInstanceFeedbackRequest = z.output<typeof captureInstanceFeedbackRequestSchema>;
 export type CaptureInstanceFeedbackResponse = z.output<typeof captureInstanceFeedbackResponseSchema>;
+export type ListInstanceFeedbackMineRequest = z.output<typeof listInstanceFeedbackMineRequestSchema>;
+export type InstanceFeedbackMineFeedback = z.output<typeof instanceFeedbackMineFeedbackSchema>;
+export type ListInstanceFeedbackMineResponse = z.output<typeof listInstanceFeedbackMineResponseSchema>;
 //# sourceMappingURL=instance-feedback.d.ts.map

package/dist/instance-feedback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-feedback.d.ts","sourceRoot":"","sources":["../src/instance-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAyB9B,eAAO,MAAM,8BAA8B;;;;EAIzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;EAIxC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;iBA0B/C,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;iBAIhD,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CACrD,OAAO,qCAAqC,CAC5C,CAAC"}
+{"version":3,"file":"instance-feedback.d.ts","sourceRoot":"","sources":["../src/instance-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAsC9B,eAAO,MAAM,8BAA8B;;;;EAIzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;EAIxC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;iBAgB/C,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;iBAIhD,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;;iBAShD,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;iBAQ7C,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;iBAMjD,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CACrD,OAAO,qCAAqC,CAC5C,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CACrD,OAAO,qCAAqC,CAC5C,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAClD,OAAO,kCAAkC,CACzC,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CACtD,OAAO,sCAAsC,CAC7C,CAAC"}

package/dist/instance-feedback.js

@@ -12,9 +12,18 @@ const isCanonicalUtcTimestamp = (value) => {
     const date = new Date(value);
     return !Number.isNaN(date.getTime()) && date.toISOString() === value;
 };
+const canonicalUtcTimestampSchema = z.string().check(z.trim(), z.minLength(1), z.refine(isCanonicalUtcTimestamp, {
+    message: "capturedAt must be a canonical UTC timestamp.",
+}));
 const finiteNumberSchema = z.number().check(z.refine(Number.isFinite, {
     message: "Expected a finite number.",
 }));
+const targetBindingTokenSchema = z
+    .string()
+    .check(z.trim(), z.minLength(1), z.maxLength(maxTargetBindingTokenLength));
+const feedbackNameSchema = z
+    .string()
+    .check(z.trim(), z.minLength(1), z.maxLength(255));
 export const instanceFeedbackDataTypeSchema = z.enum([
     "boolean",
     "categorical",
@@ -26,16 +35,12 @@ export const instanceFeedbackValenceSchema = z.enum([
     "neutral",
 ]);
 export const captureInstanceFeedbackRequestSchema = z.object({
-    targetBindingToken: z
-        .string()
-        .check(z.trim(), z.minLength(1), z.maxLength(maxTargetBindingTokenLength)),
-    capturedAt: z.string().check(z.trim(), z.minLength(1), z.refine(isCanonicalUtcTimestamp, {
-        message: "capturedAt must be a canonical UTC timestamp.",
-    })),
+    targetBindingToken: targetBindingTokenSchema,
+    capturedAt: canonicalUtcTimestampSchema,
     comment: z.optional(z.nullable(z.string().check(z.maxLength(maxCaptureRequestCommentLength)))),
     dataType: instanceFeedbackDataTypeSchema,
     label: z.optional(z.nullable(z.string().check(z.maxLength(255)))),
-    name: z.optional(z.string().check(z.trim(), z.minLength(1), z.maxLength(255))),
+    name: z.optional(feedbackNameSchema),
     reasonCategories: z.optional(z
         .array(z.string().check(z.trim(), z.minLength(1), z.maxLength(128)))
         .check(z.maxLength(maxReasonCategoryCount))),
@@ -47,3 +52,25 @@ export const captureInstanceFeedbackResponseSchema = z.object({
     evaluationId: z.string().check(z.trim(), z.minLength(1)),
     status: z.literal("accepted"),
 });
+export const listInstanceFeedbackMineRequestSchema = z.object({
+    targets: z
+        .array(z.object({
+        name: z.optional(feedbackNameSchema),
+        targetBindingToken: targetBindingTokenSchema,
+    }))
+        .check(z.minLength(1), z.maxLength(50)),
+});
+export const instanceFeedbackMineFeedbackSchema = z.object({
+    capturedAt: canonicalUtcTimestampSchema,
+    dataType: instanceFeedbackDataTypeSchema,
+    evaluationId: z.string().check(z.trim(), z.minLength(1)),
+    label: z.nullable(z.string()),
+    name: feedbackNameSchema,
+    scoreValue: z.nullable(finiteNumberSchema),
+    valence: instanceFeedbackValenceSchema,
+});
+export const listInstanceFeedbackMineResponseSchema = z.object({
+    items: z.array(z.object({
+        feedback: z.nullable(instanceFeedbackMineFeedbackSchema),
+    })),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@getuserfeedback/protocol",
-	"version": "3.1.0",
+	"version": "3.1.2",
 	"description": "getuserfeedback widget protocol — host surface and (later) wire protocol",
 	"keywords": [
 		"getuserfeedback",

package/src/attention-policy.ts

@@ -18,7 +18,10 @@ export const legacyAttentionPolicyConfigSchema = z.strictObject(
 	legacyAttentionPolicyConfigFields,
 );
 
-export const attentionPolicyConfigSchema = z.strictObject({
+// V2 is the additive policy envelope for the flow-display wire contract.
+// Keep legacy strict, and add future policy controls here instead of creating
+// another versioned sibling field for every new setting.
+export const attentionPolicyConfigSchema = z.looseObject({
 	...legacyAttentionPolicyConfigFields,
 	recentInAppCooldownMs: z._default(z.number().check(z.nonnegative()), 0),
 });

package/src/flow-display.test.ts

@@ -2,6 +2,7 @@ import { describe, expect, it } from "bun:test";
 import {
 	flowDisplaySyncRequestSchema,
 	flowDisplaySyncResponseSchema,
+	resolveFlowDisplayAttentionPolicyConfig,
 } from "./flow-display";
 
 describe("flow display sync contracts", () => {
@@ -122,6 +123,112 @@ describe("flow display sync contracts", () => {
 		).toThrow();
 	});
 
+	it("accepts future additive fields on the v2 attention policy envelope", () => {
+		const result = flowDisplaySyncResponseSchema.parse({
+			fetchedAt: "2026-06-18T00:00:00.000Z",
+			attentionPolicyV2: {
+				version: "attention-policy-organization-override-v1",
+				source: "custom",
+				recentFlowCooldownMs: 45_000,
+				recentInAppCooldownMs: 60_000,
+				exclusiveSurfaceStrategy: "queue",
+				blockedBroadcastStrategy: "queue",
+				futureChannelStrategy: "digest",
+			},
+			assignments: {
+				claimed: [],
+			},
+			broadcasts: {
+				version: "empty",
+				opportunities: [],
+			},
+		});
+
+		expect(result.attentionPolicyV2).toEqual({
+			version: "attention-policy-organization-override-v1",
+			source: "custom",
+			recentFlowCooldownMs: 45_000,
+			recentInAppCooldownMs: 60_000,
+			exclusiveSurfaceStrategy: "queue",
+			blockedBroadcastStrategy: "queue",
+			futureChannelStrategy: "digest",
+		});
+		expect(resolveFlowDisplayAttentionPolicyConfig(result)).toEqual({
+			version: "attention-policy-organization-override-v1",
+			source: "custom",
+			recentFlowCooldownMs: 45_000,
+			recentInAppCooldownMs: 60_000,
+			exclusiveSurfaceStrategy: "queue",
+			blockedBroadcastStrategy: "queue",
+		});
+	});
+
+	it("resolves the v2 attention policy before the legacy fallback", () => {
+		const result = flowDisplaySyncResponseSchema.parse({
+			fetchedAt: "2026-06-18T00:00:00.000Z",
+			attentionPolicy: {
+				version: "attention-policy-legacy-v1",
+				source: "custom",
+				recentFlowCooldownMs: 45_000,
+				exclusiveSurfaceStrategy: "queue",
+				blockedBroadcastStrategy: "queue",
+			},
+			attentionPolicyV2: {
+				version: "attention-policy-v2-v1",
+				source: "custom",
+				recentFlowCooldownMs: 90_000,
+				recentInAppCooldownMs: 30_000,
+				exclusiveSurfaceStrategy: "queue",
+				blockedBroadcastStrategy: "queue",
+			},
+			assignments: {
+				claimed: [],
+			},
+			broadcasts: {
+				version: "empty",
+				opportunities: [],
+			},
+		});
+
+		expect(resolveFlowDisplayAttentionPolicyConfig(result)).toEqual({
+			version: "attention-policy-v2-v1",
+			source: "custom",
+			recentFlowCooldownMs: 90_000,
+			recentInAppCooldownMs: 30_000,
+			exclusiveSurfaceStrategy: "queue",
+			blockedBroadcastStrategy: "queue",
+		});
+	});
+
+	it("resolves legacy attention policy with default v2-only fields", () => {
+		const result = flowDisplaySyncResponseSchema.parse({
+			fetchedAt: "2026-06-18T00:00:00.000Z",
+			attentionPolicy: {
+				version: "attention-policy-legacy-v1",
+				source: "custom",
+				recentFlowCooldownMs: 45_000,
+				exclusiveSurfaceStrategy: "queue",
+				blockedBroadcastStrategy: "queue",
+			},
+			assignments: {
+				claimed: [],
+			},
+			broadcasts: {
+				version: "empty",
+				opportunities: [],
+			},
+		});
+
+		expect(resolveFlowDisplayAttentionPolicyConfig(result)).toEqual({
+			version: "attention-policy-legacy-v1",
+			source: "custom",
+			recentFlowCooldownMs: 45_000,
+			recentInAppCooldownMs: 0,
+			exclusiveSurfaceStrategy: "queue",
+			blockedBroadcastStrategy: "queue",
+		});
+	});
+
 	it("accepts runtime broadcast opportunities", () => {
 		const result = flowDisplaySyncResponseSchema.parse({
 			fetchedAt: "2026-06-18T00:00:00.000Z",

package/src/flow-display.ts

@@ -117,3 +117,28 @@ export type FlowDisplaySyncResponse = z.output<
 	typeof flowDisplaySyncResponseSchema
 >;
 export type FlowDisplayAttentionPolicyConfig = AttentionPolicyConfig;
+
+export const resolveFlowDisplayAttentionPolicyConfig = (
+	displaySync: Pick<
+		FlowDisplaySyncResponse,
+		"attentionPolicy" | "attentionPolicyV2"
+	>,
+): FlowDisplayAttentionPolicyConfig | undefined => {
+	const policy = displaySync.attentionPolicyV2 ?? displaySync.attentionPolicy;
+	if (!policy) {
+		return undefined;
+	}
+
+	return {
+		version: policy.version,
+		source: policy.source,
+		recentFlowCooldownMs: policy.recentFlowCooldownMs,
+		recentInAppCooldownMs:
+			"recentInAppCooldownMs" in policy &&
+			typeof policy.recentInAppCooldownMs === "number"
+				? policy.recentInAppCooldownMs
+				: 0,
+		exclusiveSurfaceStrategy: policy.exclusiveSurfaceStrategy,
+		blockedBroadcastStrategy: policy.blockedBroadcastStrategy,
+	};
+};

package/src/index.ts

@@ -88,6 +88,7 @@ export {
 	type RuntimeDisplayBroadcasts,
 	type RuntimeDisplayEligibility,
 	type RuntimeDisplayTrigger,
+	resolveFlowDisplayAttentionPolicyConfig,
 	runtimeDisplayAttentionPolicySchema,
 	runtimeDisplayBroadcastOpportunitySchema,
 	runtimeDisplayBroadcastsSchema,
@@ -108,9 +109,15 @@ export {
 	captureInstanceFeedbackRequestSchema,
 	captureInstanceFeedbackResponseSchema,
 	type InstanceFeedbackDataType,
+	type InstanceFeedbackMineFeedback,
 	type InstanceFeedbackValence,
 	instanceFeedbackDataTypeSchema,
+	instanceFeedbackMineFeedbackSchema,
 	instanceFeedbackValenceSchema,
+	type ListInstanceFeedbackMineRequest,
+	type ListInstanceFeedbackMineResponse,
+	listInstanceFeedbackMineRequestSchema,
+	listInstanceFeedbackMineResponseSchema,
 } from "./instance-feedback.js";
 export {
 	type PreviewConnectionPairRequest,

package/src/instance-feedback.test.ts

@@ -1,6 +1,10 @@
 import { describe, expect, it } from "bun:test";
 
-import { captureInstanceFeedbackRequestSchema } from "./instance-feedback";
+import {
+	captureInstanceFeedbackRequestSchema,
+	listInstanceFeedbackMineRequestSchema,
+	listInstanceFeedbackMineResponseSchema,
+} from "./instance-feedback";
 
 const validCaptureRequest = {
 	capturedAt: "2026-07-01T12:00:00.000Z",
@@ -84,3 +88,63 @@ describe("captureInstanceFeedbackRequestSchema", () => {
 		).toBe(false);
 	});
 });
+
+describe("listInstanceFeedbackMineRequestSchema", () => {
+	it("accepts target binding token batches", () => {
+		expect(
+			listInstanceFeedbackMineRequestSchema.safeParse({
+				targets: [
+					{ targetBindingToken: "binding-token" },
+					{ name: "quality_rating", targetBindingToken: "binding-token-2" },
+				],
+			}).success,
+		).toBe(true);
+	});
+
+	it("requires at least one target", () => {
+		expect(
+			listInstanceFeedbackMineRequestSchema.safeParse({ targets: [] }).success,
+		).toBe(false);
+	});
+
+	it("caps target batches", () => {
+		expect(
+			listInstanceFeedbackMineRequestSchema.safeParse({
+				targets: Array.from({ length: 51 }, (_, index) => ({
+					targetBindingToken: `binding-token-${index}`,
+				})),
+			}).success,
+		).toBe(false);
+	});
+
+	it("caps target binding tokens before verification", () => {
+		expect(
+			listInstanceFeedbackMineRequestSchema.safeParse({
+				targets: [{ targetBindingToken: "x".repeat(4097) }],
+			}).success,
+		).toBe(false);
+	});
+});
+
+describe("listInstanceFeedbackMineResponseSchema", () => {
+	it("accepts nullable feedback entries aligned with requested targets", () => {
+		expect(
+			listInstanceFeedbackMineResponseSchema.safeParse({
+				items: [
+					{
+						feedback: {
+							capturedAt: "2026-07-01T12:00:00.000Z",
+							dataType: "boolean",
+							evaluationId: "eval_1",
+							label: null,
+							name: "user_feedback",
+							scoreValue: 1,
+							valence: "positive",
+						},
+					},
+					{ feedback: null },
+				],
+			}).success,
+		).toBe(true);
+	});
+});

package/src/instance-feedback.ts

@@ -17,11 +17,24 @@ const isCanonicalUtcTimestamp = (value: string) => {
 	const date = new Date(value);
 	return !Number.isNaN(date.getTime()) && date.toISOString() === value;
 };
+const canonicalUtcTimestampSchema = z.string().check(
+	z.trim(),
+	z.minLength(1),
+	z.refine(isCanonicalUtcTimestamp, {
+		message: "capturedAt must be a canonical UTC timestamp.",
+	}),
+);
 const finiteNumberSchema = z.number().check(
 	z.refine(Number.isFinite, {
 		message: "Expected a finite number.",
 	}),
 );
+const targetBindingTokenSchema = z
+	.string()
+	.check(z.trim(), z.minLength(1), z.maxLength(maxTargetBindingTokenLength));
+const feedbackNameSchema = z
+	.string()
+	.check(z.trim(), z.minLength(1), z.maxLength(255));
 
 export const instanceFeedbackDataTypeSchema = z.enum([
 	"boolean",
@@ -36,24 +49,14 @@ export const instanceFeedbackValenceSchema = z.enum([
 ]);
 
 export const captureInstanceFeedbackRequestSchema = z.object({
-	targetBindingToken: z
-		.string()
-		.check(z.trim(), z.minLength(1), z.maxLength(maxTargetBindingTokenLength)),
-	capturedAt: z.string().check(
-		z.trim(),
-		z.minLength(1),
-		z.refine(isCanonicalUtcTimestamp, {
-			message: "capturedAt must be a canonical UTC timestamp.",
-		}),
-	),
+	targetBindingToken: targetBindingTokenSchema,
+	capturedAt: canonicalUtcTimestampSchema,
 	comment: z.optional(
 		z.nullable(z.string().check(z.maxLength(maxCaptureRequestCommentLength))),
 	),
 	dataType: instanceFeedbackDataTypeSchema,
 	label: z.optional(z.nullable(z.string().check(z.maxLength(255)))),
-	name: z.optional(
-		z.string().check(z.trim(), z.minLength(1), z.maxLength(255)),
-	),
+	name: z.optional(feedbackNameSchema),
 	reasonCategories: z.optional(
 		z
 			.array(z.string().check(z.trim(), z.minLength(1), z.maxLength(128)))
@@ -69,6 +72,35 @@ export const captureInstanceFeedbackResponseSchema = z.object({
 	status: z.literal("accepted"),
 });
 
+export const listInstanceFeedbackMineRequestSchema = z.object({
+	targets: z
+		.array(
+			z.object({
+				name: z.optional(feedbackNameSchema),
+				targetBindingToken: targetBindingTokenSchema,
+			}),
+		)
+		.check(z.minLength(1), z.maxLength(50)),
+});
+
+export const instanceFeedbackMineFeedbackSchema = z.object({
+	capturedAt: canonicalUtcTimestampSchema,
+	dataType: instanceFeedbackDataTypeSchema,
+	evaluationId: z.string().check(z.trim(), z.minLength(1)),
+	label: z.nullable(z.string()),
+	name: feedbackNameSchema,
+	scoreValue: z.nullable(finiteNumberSchema),
+	valence: instanceFeedbackValenceSchema,
+});
+
+export const listInstanceFeedbackMineResponseSchema = z.object({
+	items: z.array(
+		z.object({
+			feedback: z.nullable(instanceFeedbackMineFeedbackSchema),
+		}),
+	),
+});
+
 export type InstanceFeedbackDataType = z.output<
 	typeof instanceFeedbackDataTypeSchema
 >;
@@ -81,3 +113,12 @@ export type CaptureInstanceFeedbackRequest = z.output<
 export type CaptureInstanceFeedbackResponse = z.output<
 	typeof captureInstanceFeedbackResponseSchema
 >;
+export type ListInstanceFeedbackMineRequest = z.output<
+	typeof listInstanceFeedbackMineRequestSchema
+>;
+export type InstanceFeedbackMineFeedback = z.output<
+	typeof instanceFeedbackMineFeedbackSchema
+>;
+export type ListInstanceFeedbackMineResponse = z.output<
+	typeof listInstanceFeedbackMineResponseSchema
+>;