@getuserfeedback/protocol 3.0.7 → 3.0.9

package/dist/attention-policy.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod/mini";
+export declare const attentionPolicySourceSchema: z.ZodMiniEnum<{
+    default: "default";
+    custom: "custom";
+}>;
+export declare const attentionExclusiveSurfaceStrategySchema: z.ZodMiniEnum<{
+    queue: "queue";
+}>;
+export declare const attentionBlockedBroadcastStrategySchema: z.ZodMiniEnum<{
+    queue: "queue";
+}>;
+export declare const attentionPolicyConfigSchema: z.ZodMiniObject<{
+    version: z.ZodMiniString<string>;
+    source: z.ZodMiniEnum<{
+        default: "default";
+        custom: "custom";
+    }>;
+    recentFlowCooldownMs: z.ZodMiniNumber<number>;
+    exclusiveSurfaceStrategy: z.ZodMiniEnum<{
+        queue: "queue";
+    }>;
+    blockedBroadcastStrategy: z.ZodMiniEnum<{
+        queue: "queue";
+    }>;
+}, z.core.$strict>;
+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

@@ -0,0 +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;AAEzE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;kBAMtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,qBAM7C,CAAC"}

package/dist/attention-policy.js

@@ -0,0 +1,18 @@
+import * as z from "zod/mini";
+export const attentionPolicySourceSchema = z.enum(["default", "custom"]);
+export const attentionExclusiveSurfaceStrategySchema = z.enum(["queue"]);
+export const attentionBlockedBroadcastStrategySchema = z.enum(["queue"]);
+export const attentionPolicyConfigSchema = z.strictObject({
+    version: z.string().check(z.trim(), z.minLength(1)),
+    source: attentionPolicySourceSchema,
+    recentFlowCooldownMs: z.number().check(z.positive()),
+    exclusiveSurfaceStrategy: attentionExclusiveSurfaceStrategySchema,
+    blockedBroadcastStrategy: attentionBlockedBroadcastStrategySchema,
+});
+export const DEFAULT_ATTENTION_POLICY_CONFIG = {
+    version: "attention-policy-default-v1",
+    source: "default",
+    recentFlowCooldownMs: 5 * 60 * 1000,
+    exclusiveSurfaceStrategy: "queue",
+    blockedBroadcastStrategy: "queue",
+};

package/dist/flow-display.d.ts

@@ -1,4 +1,5 @@
 import * as z from "zod/mini";
+import { type AttentionPolicyConfig } from "./attention-policy.js";
 export declare const runtimeDisplayEligibilitySchema: z.ZodMiniObject<{
     requiredCapabilities: z.ZodMiniDefault<z.ZodMiniArray<z.ZodMiniString<string>>>;
     requiredPage: z.ZodMiniOptional<z.ZodMiniObject<{
@@ -199,6 +200,20 @@ export declare const flowDisplaySyncRequestSchema: z.ZodMiniObject<{
 }, z.core.$strip>;
 export declare const flowDisplaySyncResponseSchema: z.ZodMiniObject<{
     fetchedAt: z.ZodMiniString<string>;
+    attentionPolicy: z.ZodMiniOptional<z.ZodMiniObject<{
+        version: z.ZodMiniString<string>;
+        source: z.ZodMiniEnum<{
+            default: "default";
+            custom: "custom";
+        }>;
+        recentFlowCooldownMs: z.ZodMiniNumber<number>;
+        exclusiveSurfaceStrategy: z.ZodMiniEnum<{
+            queue: "queue";
+        }>;
+        blockedBroadcastStrategy: z.ZodMiniEnum<{
+            queue: "queue";
+        }>;
+    }, z.core.$strict>>;
     assignments: z.ZodMiniObject<{
         claimed: z.ZodMiniArray<z.ZodMiniObject<{
             flowAssignmentId: z.ZodMiniString<string>;
@@ -272,4 +287,5 @@ export type RuntimeDisplayEligibility = z.output<typeof runtimeDisplayEligibilit
 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;
 //# 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;AAQ9B,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMxC,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"}
+{"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,EAE1B,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOxC,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"}

package/dist/flow-display.js

@@ -1,4 +1,5 @@
 import * as z from "zod/mini";
+import { attentionPolicyConfigSchema, } from "./attention-policy.js";
 import { flowAssignmentIdentitySchema, flowAssignmentRecordSchema, flowAssignmentTargetingContextSchema, } from "./flow-assignments.js";
 export const runtimeDisplayEligibilitySchema = z.object({
     requiredCapabilities: z._default(z.array(z.string().check(z.trim(), z.minLength(1))), []),
@@ -55,6 +56,7 @@ export const flowDisplaySyncRequestSchema = z.object({
 });
 export const flowDisplaySyncResponseSchema = z.object({
     fetchedAt: z.string(),
+    attentionPolicy: z.optional(attentionPolicyConfigSchema),
     assignments: z.object({
         claimed: z.array(flowAssignmentRecordSchema),
     }),

package/dist/host/widget-layout-size-update.d.ts

@@ -2,14 +2,43 @@ export type WidgetLayoutSize = {
     width: number;
     height: number;
 };
-export type WidgetLayoutSizeTransition = {
+export type WidgetLayoutCubicBezier = readonly [
+    x1: number,
+    y1: number,
+    x2: number,
+    y2: number
+];
+export type WidgetLayoutInstantSizeTransition = {
     kind: "instant";
     durationMs: 0;
 };
+export type WidgetLayoutTimedSizeTransition = {
+    kind: "timed";
+    durationMs: number;
+    easing: {
+        kind: "cubic-bezier";
+        points: WidgetLayoutCubicBezier;
+    };
+};
+export type WidgetLayoutSizeTransition = WidgetLayoutInstantSizeTransition;
 export type WidgetLayoutSizeUpdate = {
     size: WidgetLayoutSize;
     transition: WidgetLayoutSizeTransition;
 };
-export declare const INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION: WidgetLayoutSizeTransition;
+export type WidgetLayoutTimedSizeUpdate = {
+    size: WidgetLayoutSize;
+    transition: WidgetLayoutTimedSizeTransition;
+};
+export declare const INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION: WidgetLayoutInstantSizeTransition;
+export declare function isWidgetLayoutCubicBezier(points: unknown): points is WidgetLayoutCubicBezier;
 export declare function toInstantWidgetLayoutSizeUpdate(size: WidgetLayoutSize): WidgetLayoutSizeUpdate;
+export declare function toTimedWidgetLayoutSizeTransition(input: {
+    durationMs: number;
+    easing: WidgetLayoutCubicBezier;
+}): WidgetLayoutTimedSizeTransition;
+export declare function toTimedWidgetLayoutSizeUpdate(input: {
+    size: WidgetLayoutSize;
+    durationMs: number;
+    easing: WidgetLayoutCubicBezier;
+}): WidgetLayoutTimedSizeUpdate;
 //# sourceMappingURL=widget-layout-size-update.d.ts.map

package/dist/host/widget-layout-size-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-layout-size-update.d.ts","sourceRoot":"","sources":["../../src/host/widget-layout-size-update.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,0BAA0B,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,qCAAqC,EAAE,0BAIlD,CAAC;AAEH,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,gBAAgB,GACpB,sBAAsB,CAKxB"}
+{"version":3,"file":"widget-layout-size-update.d.ts","sourceRoot":"","sources":["../../src/host/widget-layout-size-update.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,SAAS;IAC9C,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;CACV,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACP,IAAI,EAAE,cAAc,CAAC;QACrB,MAAM,EAAE,uBAAuB,CAAC;KAChC,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,iCAAiC,CAAC;AAE3E,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,0BAA0B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,+BAA+B,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,qCAAqC,EAAE,iCAIlD,CAAC;AAKH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,OAAO,GACb,MAAM,IAAI,uBAAuB,CAenC;AAED,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,gBAAgB,GACpB,sBAAsB,CAKxB;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,uBAAuB,CAAC;CAChC,GAAG,+BAA+B,CAmBlC;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,uBAAuB,CAAC;CAChC,GAAG,2BAA2B,CAQ9B"}

package/dist/host/widget-layout-size-update.js

@@ -2,9 +2,49 @@ export const INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION = {
     kind: "instant",
     durationMs: 0,
 };
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+export function isWidgetLayoutCubicBezier(points) {
+    if (!Array.isArray(points) || points.length !== 4) {
+        return false;
+    }
+    const [x1, y1, x2, y2] = points;
+    return (isFiniteNumber(x1) &&
+        x1 >= 0 &&
+        x1 <= 1 &&
+        isFiniteNumber(y1) &&
+        isFiniteNumber(x2) &&
+        x2 >= 0 &&
+        x2 <= 1 &&
+        isFiniteNumber(y2));
+}
 export function toInstantWidgetLayoutSizeUpdate(size) {
     return {
         size: { ...size },
         transition: INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION,
     };
 }
+export function toTimedWidgetLayoutSizeTransition(input) {
+    if (!Number.isFinite(input.durationMs) || input.durationMs <= 0) {
+        throw new RangeError("Timed widget layout transitions require durationMs > 0");
+    }
+    if (!isWidgetLayoutCubicBezier(input.easing)) {
+        throw new RangeError("Timed widget layout transitions require cubic-bezier x control points in [0, 1] and finite y control points");
+    }
+    return {
+        kind: "timed",
+        durationMs: input.durationMs,
+        easing: {
+            kind: "cubic-bezier",
+            points: [...input.easing],
+        },
+    };
+}
+export function toTimedWidgetLayoutSizeUpdate(input) {
+    return {
+        size: { ...input.size },
+        transition: toTimedWidgetLayoutSizeTransition({
+            durationMs: input.durationMs,
+            easing: input.easing,
+        }),
+    };
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { type AppEventCapability, type AppEventExternalId, type AppEventFlag, type AppEventJsonValue, type AppEventPayload, type AppEventTrackInput, appEventBaseSchema, appEventCapabilitySchema, appEventContextSchema, appEventCustomerTrackSchema, appEventExternalIdSchema, appEventFlagProviderSchema, appEventFlagSchema, appEventFlowDismissedSchema, appEventIdentitySchema, appEventIdentityTypeSchema, appEventPayloadSchema, appEventSurveyViewedSchema, appEventSystemBaseSchema, appEventSystemTrackSchema, appEventTrackSchema, reservedSystemAppEventNames, } from "./app-event.js";
+export { type AttentionPolicyConfig, attentionBlockedBroadcastStrategySchema, attentionExclusiveSurfaceStrategySchema, attentionPolicyConfigSchema, attentionPolicySourceSchema, DEFAULT_ATTENTION_POLICY_CONFIG, } from "./attention-policy.js";
 export { type ClientMeta, clientMetaSchema, } from "./client-meta.js";
 export { type CommandContext, type CoreCommandEnvelope, coreCommandEnvelopeSchema, } from "./core-command-envelope.js";
 export { type CoreCommandPayload, coreCommandPayloadSchema, } from "./core-commands.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

@@ -1,4 +1,5 @@
 export { appEventBaseSchema, appEventCapabilitySchema, appEventContextSchema, appEventCustomerTrackSchema, appEventExternalIdSchema, appEventFlagProviderSchema, appEventFlagSchema, appEventFlowDismissedSchema, appEventIdentitySchema, appEventIdentityTypeSchema, appEventPayloadSchema, appEventSurveyViewedSchema, appEventSystemBaseSchema, appEventSystemTrackSchema, appEventTrackSchema, reservedSystemAppEventNames, } from "./app-event.js";
+export { attentionBlockedBroadcastStrategySchema, attentionExclusiveSurfaceStrategySchema, attentionPolicyConfigSchema, attentionPolicySourceSchema, DEFAULT_ATTENTION_POLICY_CONFIG, } from "./attention-policy.js";
 export { clientMetaSchema, } from "./client-meta.js";
 export { coreCommandEnvelopeSchema, } from "./core-command-envelope.js";
 export { coreCommandPayloadSchema, } from "./core-commands.js";

package/package.json

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

package/src/attention-policy.ts

@@ -0,0 +1,27 @@
+import * as z from "zod/mini";
+
+export const attentionPolicySourceSchema = z.enum(["default", "custom"]);
+
+export const attentionExclusiveSurfaceStrategySchema = z.enum(["queue"]);
+
+export const attentionBlockedBroadcastStrategySchema = z.enum(["queue"]);
+
+export const attentionPolicyConfigSchema = z.strictObject({
+	version: z.string().check(z.trim(), z.minLength(1)),
+	source: attentionPolicySourceSchema,
+	recentFlowCooldownMs: z.number().check(z.positive()),
+	exclusiveSurfaceStrategy: attentionExclusiveSurfaceStrategySchema,
+	blockedBroadcastStrategy: attentionBlockedBroadcastStrategySchema,
+});
+
+export type AttentionPolicyConfig = z.output<
+	typeof attentionPolicyConfigSchema
+>;
+
+export const DEFAULT_ATTENTION_POLICY_CONFIG: AttentionPolicyConfig = {
+	version: "attention-policy-default-v1",
+	source: "default",
+	recentFlowCooldownMs: 5 * 60 * 1000,
+	exclusiveSurfaceStrategy: "queue",
+	blockedBroadcastStrategy: "queue",
+};

package/src/flow-display.test.ts

@@ -52,6 +52,7 @@ describe("flow display sync contracts", () => {
 
 		expect(result.assignments.claimed[0]?.flowAssignmentId).toBe("fa_1");
 		expect(result.broadcasts.opportunities).toEqual([]);
+		expect(result.attentionPolicy).toBeUndefined();
 	});
 
 	it("accepts runtime broadcast opportunities", () => {

package/src/flow-display.ts

@@ -1,5 +1,9 @@
 import * as z from "zod/mini";
 
+import {
+	type AttentionPolicyConfig,
+	attentionPolicyConfigSchema,
+} from "./attention-policy.js";
 import {
 	flowAssignmentIdentitySchema,
 	flowAssignmentRecordSchema,
@@ -82,6 +86,7 @@ export const flowDisplaySyncRequestSchema = z.object({
 
 export const flowDisplaySyncResponseSchema = z.object({
 	fetchedAt: z.string(),
+	attentionPolicy: z.optional(attentionPolicyConfigSchema),
 	assignments: z.object({
 		claimed: z.array(flowAssignmentRecordSchema),
 	}),
@@ -109,3 +114,4 @@ export type FlowDisplaySyncRequest = z.output<
 export type FlowDisplaySyncResponse = z.output<
 	typeof flowDisplaySyncResponseSchema
 >;
+export type FlowDisplayAttentionPolicyConfig = AttentionPolicyConfig;

package/src/host/widget-layout-size-update.test.ts

@@ -1,7 +1,10 @@
 import { describe, expect, test } from "bun:test";
 import {
 	INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION,
+	isWidgetLayoutCubicBezier,
 	toInstantWidgetLayoutSizeUpdate,
+	toTimedWidgetLayoutSizeTransition,
+	toTimedWidgetLayoutSizeUpdate,
 } from "./widget-layout-size-update.js";
 
 describe("widget layout size update", () => {
@@ -22,4 +25,66 @@ describe("widget layout size update", () => {
 			toInstantWidgetLayoutSizeUpdate({ width: 1, height: 1 }).transition,
 		).toBe(INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION);
 	});
+
+	test("keeps the existing size update contract instant-only", () => {
+		const update = toInstantWidgetLayoutSizeUpdate({ width: 320, height: 240 });
+
+		expect(update.transition.kind).toBe("instant");
+	});
+
+	test("wraps a host size in the timed transition contract", () => {
+		expect(
+			toTimedWidgetLayoutSizeUpdate({
+				size: { width: 320, height: 240 },
+				durationMs: 180,
+				easing: [0.2, 0, 0, 1],
+			}),
+		).toEqual({
+			size: { width: 320, height: 240 },
+			transition: {
+				kind: "timed",
+				durationMs: 180,
+				easing: {
+					kind: "cubic-bezier",
+					points: [0.2, 0, 0, 1],
+				},
+			},
+		});
+	});
+
+	test("accepts cubic-bezier y control point overshoot", () => {
+		expect(isWidgetLayoutCubicBezier([0.34, -0.2, 0.64, 1.35])).toBe(true);
+		expect(
+			toTimedWidgetLayoutSizeTransition({
+				durationMs: 220,
+				easing: [0.34, -0.2, 0.64, 1.35],
+			}).easing.points,
+		).toEqual([0.34, -0.2, 0.64, 1.35]);
+	});
+
+	test("fails closed for non-array cubic-bezier input", () => {
+		expect(isWidgetLayoutCubicBezier(null)).toBe(false);
+		expect(isWidgetLayoutCubicBezier({ 0: 0.2, 1: 0, 2: 0, 3: 1 })).toBe(false);
+		expect(isWidgetLayoutCubicBezier("0.2,0,0,1")).toBe(false);
+	});
+
+	test("rejects cubic-bezier x control points outside normalized time", () => {
+		expect(isWidgetLayoutCubicBezier([-0.01, 0, 0.5, 1])).toBe(false);
+		expect(isWidgetLayoutCubicBezier([0.5, 0, 1.01, 1])).toBe(false);
+		expect(() =>
+			toTimedWidgetLayoutSizeTransition({
+				durationMs: 220,
+				easing: [-0.01, 0, 0.5, 1],
+			}),
+		).toThrow(RangeError);
+	});
+
+	test("rejects invalid timed transition duration", () => {
+		expect(() =>
+			toTimedWidgetLayoutSizeTransition({
+				durationMs: 0,
+				easing: [0.2, 0, 0, 1],
+			}),
+		).toThrow(RangeError);
+	});
 });

package/src/host/widget-layout-size-update.ts

@@ -3,22 +3,67 @@ export type WidgetLayoutSize = {
 	height: number;
 };
 
-export type WidgetLayoutSizeTransition = {
+export type WidgetLayoutCubicBezier = readonly [
+	x1: number,
+	y1: number,
+	x2: number,
+	y2: number,
+];
+
+export type WidgetLayoutInstantSizeTransition = {
 	kind: "instant";
 	durationMs: 0;
 };
 
+export type WidgetLayoutTimedSizeTransition = {
+	kind: "timed";
+	durationMs: number;
+	easing: {
+		kind: "cubic-bezier";
+		points: WidgetLayoutCubicBezier;
+	};
+};
+
+export type WidgetLayoutSizeTransition = WidgetLayoutInstantSizeTransition;
+
 export type WidgetLayoutSizeUpdate = {
 	size: WidgetLayoutSize;
 	transition: WidgetLayoutSizeTransition;
 };
 
-export const INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION: WidgetLayoutSizeTransition =
+export type WidgetLayoutTimedSizeUpdate = {
+	size: WidgetLayoutSize;
+	transition: WidgetLayoutTimedSizeTransition;
+};
+
+export const INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION: WidgetLayoutInstantSizeTransition =
 	{
 		kind: "instant",
 		durationMs: 0,
 	};
 
+const isFiniteNumber = (value: unknown): value is number =>
+	typeof value === "number" && Number.isFinite(value);
+
+export function isWidgetLayoutCubicBezier(
+	points: unknown,
+): points is WidgetLayoutCubicBezier {
+	if (!Array.isArray(points) || points.length !== 4) {
+		return false;
+	}
+	const [x1, y1, x2, y2] = points;
+	return (
+		isFiniteNumber(x1) &&
+		x1 >= 0 &&
+		x1 <= 1 &&
+		isFiniteNumber(y1) &&
+		isFiniteNumber(x2) &&
+		x2 >= 0 &&
+		x2 <= 1 &&
+		isFiniteNumber(y2)
+	);
+}
+
 export function toInstantWidgetLayoutSizeUpdate(
 	size: WidgetLayoutSize,
 ): WidgetLayoutSizeUpdate {
@@ -27,3 +72,41 @@ export function toInstantWidgetLayoutSizeUpdate(
 		transition: INSTANT_WIDGET_LAYOUT_SIZE_TRANSITION,
 	};
 }
+
+export function toTimedWidgetLayoutSizeTransition(input: {
+	durationMs: number;
+	easing: WidgetLayoutCubicBezier;
+}): WidgetLayoutTimedSizeTransition {
+	if (!Number.isFinite(input.durationMs) || input.durationMs <= 0) {
+		throw new RangeError(
+			"Timed widget layout transitions require durationMs > 0",
+		);
+	}
+	if (!isWidgetLayoutCubicBezier(input.easing)) {
+		throw new RangeError(
+			"Timed widget layout transitions require cubic-bezier x control points in [0, 1] and finite y control points",
+		);
+	}
+	return {
+		kind: "timed",
+		durationMs: input.durationMs,
+		easing: {
+			kind: "cubic-bezier",
+			points: [...input.easing],
+		},
+	};
+}
+
+export function toTimedWidgetLayoutSizeUpdate(input: {
+	size: WidgetLayoutSize;
+	durationMs: number;
+	easing: WidgetLayoutCubicBezier;
+}): WidgetLayoutTimedSizeUpdate {
+	return {
+		size: { ...input.size },
+		transition: toTimedWidgetLayoutSizeTransition({
+			durationMs: input.durationMs,
+			easing: input.easing,
+		}),
+	};
+}

package/src/index.ts

@@ -22,6 +22,14 @@ export {
 	appEventTrackSchema,
 	reservedSystemAppEventNames,
 } from "./app-event.js";
+export {
+	type AttentionPolicyConfig,
+	attentionBlockedBroadcastStrategySchema,
+	attentionExclusiveSurfaceStrategySchema,
+	attentionPolicyConfigSchema,
+	attentionPolicySourceSchema,
+	DEFAULT_ATTENTION_POLICY_CONFIG,
+} from "./attention-policy.js";
 export {
 	type ClientMeta,
 	clientMetaSchema,

package/src/protocol-root.test.ts

@@ -11,6 +11,8 @@ import {
 	appEventPayloadSchema,
 	appEventSurveyViewedSchema,
 	appEventTrackSchema,
+	attentionPolicyConfigSchema,
+	DEFAULT_ATTENTION_POLICY_CONFIG,
 	DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS,
 	flowVersionResolutionSchema,
 	getScopeMeta,
@@ -54,6 +56,18 @@ describe("@getuserfeedback/protocol root contract", () => {
 		]);
 	});
 
+	it("exports attention policy config defaults and schema", () => {
+		expect(
+			attentionPolicyConfigSchema.parse(DEFAULT_ATTENTION_POLICY_CONFIG),
+		).toEqual({
+			version: "attention-policy-default-v1",
+			source: "default",
+			recentFlowCooldownMs: 5 * 60 * 1000,
+			exclusiveSurfaceStrategy: "queue",
+			blockedBroadcastStrategy: "queue",
+		});
+	});
+
 	it("parses widget-config flag and capability inputs via canonical app-event schemas", () => {
 		expect(
 			appEventFlagSchema.parse({