@getuserfeedback/protocol 3.1.1 → 3.1.3

package/dist/index.d.ts

@@ -9,8 +9,9 @@ export { ErrorCategory, ErrorCategorySchema, ErrorEventSchema, ProtocolError, }
 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, 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_FLOW_TRANSPORT_SOURCE, type PreviewFlowOpenCommand, type PreviewFlowOpenRequest, type PreviewFlowOpenResult, previewFlowOpenCommandSchema, previewFlowOpenRequestSchema, previewFlowOpenResultSchema, } from "./preview-flow-transport.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";
 export { type RuntimeEndpoints, resolveApiBaseUrl, resolveCoreUrl, resolveRealtimeUrl, resolveTrpcBaseUrl, runtimeEndpointsSchema, } from "./runtime-endpoints.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

@@ -8,8 +8,9 @@ export { ErrorCategory, ErrorCategorySchema, ErrorEventSchema, ProtocolError, }
 export { claimPendingFlowAssignmentsRequestSchema, claimPendingFlowAssignmentsResponseSchema, flowAssignmentRecipientRequestSchema, flowAssignmentRecordSchema, flowAssignmentStatusSchema, flowAssignmentTargetingContextSchema, listPendingFlowAssignmentsResponseSchema, nullableUpdateFlowAssignmentLifecycleResponseSchema, releaseFlowAssignmentClaimRequestSchema, releaseFlowAssignmentClaimResponseSchema, updateFlowAssignmentLifecycleRequestSchema, updateFlowAssignmentLifecycleResponseSchema, } from "./flow-assignments.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_FLOW_TRANSPORT_SOURCE, previewFlowOpenCommandSchema, previewFlowOpenRequestSchema, previewFlowOpenResultSchema, } from "./preview-flow-transport.js";
 export { PREVIEW_PAIRING_TRANSPORT_SOURCE, previewPairingHostAckSchema, previewPairingHostRequestSchema, previewPairingHostResultSchema, } from "./preview-pairing-transport.js";
 export { isPublicGrantScope, publicGrantScopeIdSchema, } from "./public-grant-scope.js";
 export { resolveApiBaseUrl, resolveCoreUrl, resolveRealtimeUrl, resolveTrpcBaseUrl, runtimeEndpointsSchema, } from "./runtime-endpoints.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/dist/preview-flow-transport.d.ts

@@ -0,0 +1,61 @@
+import * as z from "zod/mini";
+export declare const PREVIEW_FLOW_TRANSPORT_SOURCE = "getuserfeedback.preview";
+export declare const previewFlowOpenCommandSchema: z.ZodMiniObject<{
+    kind: z.ZodMiniLiteral<"open">;
+    flow: z.ZodMiniObject<{
+        definition: z.ZodMiniUnknown;
+        theme: z.ZodMiniOptional<z.ZodMiniObject<{
+            css: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            themeRuntimeArtifactId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            themeVersionId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    metadata: z.ZodMiniOptional<z.ZodMiniObject<{
+        tags: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>>;
+    }, z.core.$strict>>;
+    hideCloseButton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+}, z.core.$strict>;
+export declare const previewFlowOpenRequestSchema: z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.request">;
+    requestId: z.ZodMiniString<string>;
+    command: z.ZodMiniObject<{
+        kind: z.ZodMiniLiteral<"open">;
+        flow: z.ZodMiniObject<{
+            definition: z.ZodMiniUnknown;
+            theme: z.ZodMiniOptional<z.ZodMiniObject<{
+                css: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                themeRuntimeArtifactId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                themeVersionId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        metadata: z.ZodMiniOptional<z.ZodMiniObject<{
+            tags: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>>;
+        }, z.core.$strict>>;
+        hideCloseButton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const previewFlowOpenResultSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.result">;
+    requestId: z.ZodMiniString<string>;
+    ok: z.ZodMiniLiteral<true>;
+    result: z.ZodMiniObject<{
+        flowHandleId: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.result">;
+    requestId: z.ZodMiniString<string>;
+    ok: z.ZodMiniLiteral<false>;
+    error: z.ZodMiniObject<{
+        code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        message: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">;
+export type PreviewFlowOpenCommand = z.output<typeof previewFlowOpenCommandSchema>;
+export type PreviewFlowOpenRequest = z.output<typeof previewFlowOpenRequestSchema>;
+export type PreviewFlowOpenResult = z.output<typeof previewFlowOpenResultSchema>;
+//# sourceMappingURL=preview-flow-transport.d.ts.map

package/dist/preview-flow-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-flow-transport.d.ts","sourceRoot":"","sources":["../src/preview-flow-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAI9B,eAAO,MAAM,6BAA6B,4BAAmC,CAAC;AA8B9E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;kBAMvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;kBAKvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;0BAoBtC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC"}

package/dist/preview-flow-transport.js

@@ -0,0 +1,59 @@
+import * as z from "zod/mini";
+import { PREVIEW_PAIRING_TRANSPORT_SOURCE } from "./preview-pairing-transport.js";
+import { responseMetadataInputSchema } from "./response-metadata.js";
+export const PREVIEW_FLOW_TRANSPORT_SOURCE = PREVIEW_PAIRING_TRANSPORT_SOURCE;
+const requestIdSchema = z.string().check(z.trim(), z.minLength(1));
+const flowHandleIdSchema = z.string().check(z.trim(), z.minLength(1));
+const inlineFlowThemeSchema = z.strictObject({
+    css: z.optional(z.string()),
+    themeRuntimeArtifactId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+    themeVersionId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+});
+const inlineFlowSchema = z.strictObject({
+    definition: z.unknown().check(z.check((ctx) => {
+        if (ctx.value !== undefined) {
+            return;
+        }
+        ctx.issues.push({
+            code: "custom",
+            input: ctx.value,
+            message: "Inline flow definition is required.",
+            continue: false,
+        });
+    })),
+    theme: z.optional(inlineFlowThemeSchema),
+});
+export const previewFlowOpenCommandSchema = z.strictObject({
+    kind: z.literal("open"),
+    flow: inlineFlowSchema,
+    flowHandleId: z.optional(flowHandleIdSchema),
+    metadata: z.optional(responseMetadataInputSchema),
+    hideCloseButton: z.optional(z.boolean()),
+});
+export const previewFlowOpenRequestSchema = z.strictObject({
+    source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+    type: z.literal("preview.flow.open.request"),
+    requestId: requestIdSchema,
+    command: previewFlowOpenCommandSchema,
+});
+export const previewFlowOpenResultSchema = z.discriminatedUnion("ok", [
+    z.strictObject({
+        source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+        type: z.literal("preview.flow.open.result"),
+        requestId: requestIdSchema,
+        ok: z.literal(true),
+        result: z.strictObject({
+            flowHandleId: flowHandleIdSchema,
+        }),
+    }),
+    z.strictObject({
+        source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+        type: z.literal("preview.flow.open.result"),
+        requestId: requestIdSchema,
+        ok: z.literal(false),
+        error: z.strictObject({
+            code: z.optional(z.string().check(z.trim(), z.minLength(1))),
+            message: z.string().check(z.trim(), z.minLength(1)),
+        }),
+    }),
+]);

package/package.json

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

package/src/index.ts

@@ -109,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,
@@ -119,6 +125,15 @@ export {
 	previewConnectionPairRequestSchema,
 	previewConnectionPairResponseSchema,
 } from "./preview-connection.js";
+export {
+	PREVIEW_FLOW_TRANSPORT_SOURCE,
+	type PreviewFlowOpenCommand,
+	type PreviewFlowOpenRequest,
+	type PreviewFlowOpenResult,
+	previewFlowOpenCommandSchema,
+	previewFlowOpenRequestSchema,
+	previewFlowOpenResultSchema,
+} from "./preview-flow-transport.js";
 export {
 	PREVIEW_PAIRING_TRANSPORT_SOURCE,
 	type PreviewPairingHostAck,

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
+>;

package/src/preview-flow-transport.test.ts

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "bun:test";
+import {
+	PREVIEW_FLOW_TRANSPORT_SOURCE,
+	previewFlowOpenRequestSchema,
+	previewFlowOpenResultSchema,
+} from "./preview-flow-transport";
+
+describe("preview flow transport protocol", () => {
+	it("parses inline flow open requests", () => {
+		expect(
+			previewFlowOpenRequestSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.request",
+				requestId: "req_123",
+				command: {
+					kind: "open",
+					flow: {
+						definition: {
+							blocks: [],
+							config: {},
+							presenter: null,
+						},
+					},
+					flowHandleId: "handle_123",
+					hideCloseButton: true,
+				},
+			}),
+		).toMatchObject({
+			requestId: "req_123",
+			command: {
+				kind: "open",
+				flowHandleId: "handle_123",
+				flow: {
+					definition: {
+						blocks: [],
+					},
+				},
+			},
+		});
+	});
+
+	it("rejects undefined inline definitions", () => {
+		expect(() =>
+			previewFlowOpenRequestSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.request",
+				requestId: "req_123",
+				command: {
+					kind: "open",
+					flow: {
+						definition: undefined,
+					},
+				},
+			}),
+		).toThrow();
+	});
+
+	it("parses success and failure results", () => {
+		expect(
+			previewFlowOpenResultSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.result",
+				requestId: "req_123",
+				ok: true,
+				result: {
+					flowHandleId: "handle_123",
+				},
+			}),
+		).toEqual({
+			source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+			type: "preview.flow.open.result",
+			requestId: "req_123",
+			ok: true,
+			result: {
+				flowHandleId: "handle_123",
+			},
+		});
+
+		expect(
+			previewFlowOpenResultSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.result",
+				requestId: "req_123",
+				ok: false,
+				error: {
+					code: "DISPATCH_FAILED",
+					message: "Preview dispatch failed",
+				},
+			}),
+		).toMatchObject({
+			ok: false,
+			error: { code: "DISPATCH_FAILED" },
+		});
+	});
+});

package/src/preview-flow-transport.ts

@@ -0,0 +1,80 @@
+import * as z from "zod/mini";
+import { PREVIEW_PAIRING_TRANSPORT_SOURCE } from "./preview-pairing-transport.js";
+import { responseMetadataInputSchema } from "./response-metadata.js";
+
+export const PREVIEW_FLOW_TRANSPORT_SOURCE = PREVIEW_PAIRING_TRANSPORT_SOURCE;
+
+const requestIdSchema = z.string().check(z.trim(), z.minLength(1));
+const flowHandleIdSchema = z.string().check(z.trim(), z.minLength(1));
+
+const inlineFlowThemeSchema = z.strictObject({
+	css: z.optional(z.string()),
+	themeRuntimeArtifactId: z.optional(
+		z.string().check(z.trim(), z.minLength(1)),
+	),
+	themeVersionId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+});
+
+const inlineFlowSchema = z.strictObject({
+	definition: z.unknown().check(
+		z.check((ctx) => {
+			if (ctx.value !== undefined) {
+				return;
+			}
+			ctx.issues.push({
+				code: "custom",
+				input: ctx.value,
+				message: "Inline flow definition is required.",
+				continue: false,
+			});
+		}),
+	),
+	theme: z.optional(inlineFlowThemeSchema),
+});
+
+export const previewFlowOpenCommandSchema = z.strictObject({
+	kind: z.literal("open"),
+	flow: inlineFlowSchema,
+	flowHandleId: z.optional(flowHandleIdSchema),
+	metadata: z.optional(responseMetadataInputSchema),
+	hideCloseButton: z.optional(z.boolean()),
+});
+
+export const previewFlowOpenRequestSchema = z.strictObject({
+	source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+	type: z.literal("preview.flow.open.request"),
+	requestId: requestIdSchema,
+	command: previewFlowOpenCommandSchema,
+});
+
+export const previewFlowOpenResultSchema = z.discriminatedUnion("ok", [
+	z.strictObject({
+		source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+		type: z.literal("preview.flow.open.result"),
+		requestId: requestIdSchema,
+		ok: z.literal(true),
+		result: z.strictObject({
+			flowHandleId: flowHandleIdSchema,
+		}),
+	}),
+	z.strictObject({
+		source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+		type: z.literal("preview.flow.open.result"),
+		requestId: requestIdSchema,
+		ok: z.literal(false),
+		error: z.strictObject({
+			code: z.optional(z.string().check(z.trim(), z.minLength(1))),
+			message: z.string().check(z.trim(), z.minLength(1)),
+		}),
+	}),
+]);
+
+export type PreviewFlowOpenCommand = z.output<
+	typeof previewFlowOpenCommandSchema
+>;
+export type PreviewFlowOpenRequest = z.output<
+	typeof previewFlowOpenRequestSchema
+>;
+export type PreviewFlowOpenResult = z.output<
+	typeof previewFlowOpenResultSchema
+>;