@proxyhuman/protocol 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -151,7 +151,15 @@ var SessionEventSchema = import_zod.z.discriminatedUnion("type", [
     viewerCount: import_zod.z.number().int(),
     viewer: ViewerInfoSchema.optional()
   }),
-  import_zod.z.object({ ts: import_zod.z.number(), type: import_zod.z.literal("action_recorded"), action: RecordedActionSchema }),
+  import_zod.z.object({
+    ts: import_zod.z.number(),
+    type: import_zod.z.literal("action_recorded"),
+    action: RecordedActionSchema,
+    /** The viewer that performed this action. Optional for backward
+     *  compatibility with events recorded before per-action attribution
+     *  was added. */
+    viewer: ViewerInfoSchema.optional()
+  }),
   import_zod.z.object({ ts: import_zod.z.number(), type: import_zod.z.literal("error"), message: import_zod.z.string(), detail: import_zod.z.string().optional() })
 ]);
 var NewSessionSchema = import_zod.z.object({
@@ -265,7 +273,10 @@ var SessionInfoSchema = import_zod.z.object({
   outcome: SessionOutcomeSchema.nullable(),
   prompt: import_zod.z.string().nullable(),
   publisher: PublisherInfoSchema.nullable(),
-  target: TargetInfoSchema.nullable()
+  target: TargetInfoSchema.nullable(),
+  /** Most recent viewer to join (or leave) — what the dashboard list shows
+   *  as the "picked up by" device. Null until the first viewer connects. */
+  lastViewer: ViewerInfoSchema.nullable().optional()
 });
 var SessionSummarySchema = import_zod.z.object({
   sessionId: import_zod.z.string(),
@@ -277,7 +288,9 @@ var SessionSummarySchema = import_zod.z.object({
   createdAt: import_zod.z.number(),
   endedAt: import_zod.z.number().nullable(),
   /** Last event-log append timestamp. */
-  updatedAt: import_zod.z.number()
+  updatedAt: import_zod.z.number(),
+  /** Most recent viewer to join (or leave). Null until first viewer. */
+  lastViewer: ViewerInfoSchema.nullable().optional()
 });
 var SessionActionsResponseSchema = import_zod.z.object({
   sessionId: import_zod.z.string(),

package/dist/index.d.cts

@@ -587,6 +587,23 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     }>]>;
+    /** The viewer that performed this action. Optional for backward
+     *  compatibility with events recorded before per-action attribution
+     *  was added. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     type: "action_recorded";
     ts: number;
@@ -638,6 +655,11 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     };
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
 }, {
     type: "action_recorded";
     ts: number;
@@ -689,6 +711,11 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     };
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
 }>, z.ZodObject<{
     ts: z.ZodNumber;
     type: z.ZodLiteral<"error">;
@@ -1947,6 +1974,22 @@ declare const SessionInfoSchema: z.ZodObject<{
         browserVersion?: string | null | undefined;
         userAgent?: string | null | undefined;
     }>>;
+    /** Most recent viewer to join (or leave) — what the dashboard list shows
+     *  as the "picked up by" device. Null until the first viewer connects. */
+    lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     viewerCount: number;
     prompt: string | null;
@@ -1986,6 +2029,11 @@ declare const SessionInfoSchema: z.ZodObject<{
     state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
     createdAt: number;
     endedAt: number | null;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }, {
     viewerCount: number;
     prompt: string | null;
@@ -2025,6 +2073,11 @@ declare const SessionInfoSchema: z.ZodObject<{
     state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
     createdAt: number;
     endedAt: number | null;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }>;
 type SessionInfo = z.infer<typeof SessionInfoSchema>;
 declare const SessionSummarySchema: z.ZodObject<{
@@ -2086,6 +2139,21 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: z.ZodNullable<z.ZodNumber>;
     /** Last event-log append timestamp. */
     updatedAt: z.ZodNumber;
+    /** Most recent viewer to join (or leave). Null until first viewer. */
+    lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     viewerCount: number;
     prompt: string | null;
@@ -2112,6 +2180,11 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: number | null;
     actionCount: number;
     updatedAt: number;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }, {
     viewerCount: number;
     prompt: string | null;
@@ -2138,6 +2211,11 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: number | null;
     actionCount: number;
     updatedAt: number;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }>;
 type SessionSummary = z.infer<typeof SessionSummarySchema>;
 /** `GET /sessions/:sid/actions` */
@@ -2504,6 +2582,22 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             browserVersion?: string | null | undefined;
             userAgent?: string | null | undefined;
         }>>;
+        /** Most recent viewer to join (or leave) — what the dashboard list shows
+         *  as the "picked up by" device. Null until the first viewer connects. */
+        lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         viewerCount: number;
         prompt: string | null;
@@ -2543,6 +2637,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }, {
         viewerCount: number;
         prompt: string | null;
@@ -2582,6 +2681,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }>;
     events: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         ts: z.ZodNumber;
@@ -2815,6 +2919,23 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         }>]>;
+        /** The viewer that performed this action. Optional for backward
+         *  compatibility with events recorded before per-action attribution
+         *  was added. */
+        viewer: z.ZodOptional<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         type: "action_recorded";
         ts: number;
@@ -2866,6 +2987,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     }, {
         type: "action_recorded";
         ts: number;
@@ -2917,6 +3043,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     }>, z.ZodObject<{
         ts: z.ZodNumber;
         type: z.ZodLiteral<"error">;
@@ -3165,6 +3296,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     };
     events: ({
         type: "state_changed";
@@ -3240,6 +3376,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     } | {
         message: string;
         type: "error";
@@ -3335,6 +3476,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     };
     events: ({
         type: "state_changed";
@@ -3410,6 +3556,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     } | {
         message: string;
         type: "error";
@@ -3482,6 +3633,21 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: z.ZodNullable<z.ZodNumber>;
         /** Last event-log append timestamp. */
         updatedAt: z.ZodNumber;
+        /** Most recent viewer to join (or leave). Null until first viewer. */
+        lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         viewerCount: number;
         prompt: string | null;
@@ -3508,6 +3674,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }, {
         viewerCount: number;
         prompt: string | null;
@@ -3534,6 +3705,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }>, "many">;
     /** Opaque cursor for the next page, or null when there are no more. */
     nextCursor: z.ZodNullable<z.ZodString>;
@@ -3564,6 +3740,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }[];
     nextCursor: string | null;
 }, {
@@ -3593,6 +3774,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }[];
     nextCursor: string | null;
 }>;

package/dist/index.d.ts

@@ -587,6 +587,23 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     }>]>;
+    /** The viewer that performed this action. Optional for backward
+     *  compatibility with events recorded before per-action attribution
+     *  was added. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     type: "action_recorded";
     ts: number;
@@ -638,6 +655,11 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     };
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
 }, {
     type: "action_recorded";
     ts: number;
@@ -689,6 +711,11 @@ declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: "human_done";
         ts: number;
     };
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
 }>, z.ZodObject<{
     ts: z.ZodNumber;
     type: z.ZodLiteral<"error">;
@@ -1947,6 +1974,22 @@ declare const SessionInfoSchema: z.ZodObject<{
         browserVersion?: string | null | undefined;
         userAgent?: string | null | undefined;
     }>>;
+    /** Most recent viewer to join (or leave) — what the dashboard list shows
+     *  as the "picked up by" device. Null until the first viewer connects. */
+    lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     viewerCount: number;
     prompt: string | null;
@@ -1986,6 +2029,11 @@ declare const SessionInfoSchema: z.ZodObject<{
     state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
     createdAt: number;
     endedAt: number | null;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }, {
     viewerCount: number;
     prompt: string | null;
@@ -2025,6 +2073,11 @@ declare const SessionInfoSchema: z.ZodObject<{
     state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
     createdAt: number;
     endedAt: number | null;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }>;
 type SessionInfo = z.infer<typeof SessionInfoSchema>;
 declare const SessionSummarySchema: z.ZodObject<{
@@ -2086,6 +2139,21 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: z.ZodNullable<z.ZodNumber>;
     /** Last event-log append timestamp. */
     updatedAt: z.ZodNumber;
+    /** Most recent viewer to join (or leave). Null until first viewer. */
+    lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     viewerCount: number;
     prompt: string | null;
@@ -2112,6 +2180,11 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: number | null;
     actionCount: number;
     updatedAt: number;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }, {
     viewerCount: number;
     prompt: string | null;
@@ -2138,6 +2211,11 @@ declare const SessionSummarySchema: z.ZodObject<{
     endedAt: number | null;
     actionCount: number;
     updatedAt: number;
+    lastViewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | null | undefined;
 }>;
 type SessionSummary = z.infer<typeof SessionSummarySchema>;
 /** `GET /sessions/:sid/actions` */
@@ -2504,6 +2582,22 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             browserVersion?: string | null | undefined;
             userAgent?: string | null | undefined;
         }>>;
+        /** Most recent viewer to join (or leave) — what the dashboard list shows
+         *  as the "picked up by" device. Null until the first viewer connects. */
+        lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         viewerCount: number;
         prompt: string | null;
@@ -2543,6 +2637,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }, {
         viewerCount: number;
         prompt: string | null;
@@ -2582,6 +2681,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }>;
     events: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         ts: z.ZodNumber;
@@ -2815,6 +2919,23 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         }>]>;
+        /** The viewer that performed this action. Optional for backward
+         *  compatibility with events recorded before per-action attribution
+         *  was added. */
+        viewer: z.ZodOptional<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         type: "action_recorded";
         ts: number;
@@ -2866,6 +2987,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     }, {
         type: "action_recorded";
         ts: number;
@@ -2917,6 +3043,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     }>, z.ZodObject<{
         ts: z.ZodNumber;
         type: z.ZodLiteral<"error">;
@@ -3165,6 +3296,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     };
     events: ({
         type: "state_changed";
@@ -3240,6 +3376,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     } | {
         message: string;
         type: "error";
@@ -3335,6 +3476,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
         state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
         createdAt: number;
         endedAt: number | null;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     };
     events: ({
         type: "state_changed";
@@ -3410,6 +3556,11 @@ declare const SessionDetailResponseSchema: z.ZodObject<{
             type: "human_done";
             ts: number;
         };
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
     } | {
         message: string;
         type: "error";
@@ -3482,6 +3633,21 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: z.ZodNullable<z.ZodNumber>;
         /** Last event-log append timestamp. */
         updatedAt: z.ZodNumber;
+        /** Most recent viewer to join (or leave). Null until first viewer. */
+        lastViewer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         viewerCount: number;
         prompt: string | null;
@@ -3508,6 +3674,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }, {
         viewerCount: number;
         prompt: string | null;
@@ -3534,6 +3705,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }>, "many">;
     /** Opaque cursor for the next page, or null when there are no more. */
     nextCursor: z.ZodNullable<z.ZodString>;
@@ -3564,6 +3740,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }[];
     nextCursor: string | null;
 }, {
@@ -3593,6 +3774,11 @@ declare const UserSessionsResponseSchema: z.ZodObject<{
         endedAt: number | null;
         actionCount: number;
         updatedAt: number;
+        lastViewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | null | undefined;
     }[];
     nextCursor: string | null;
 }>;

package/dist/index.js

@@ -95,7 +95,15 @@ var SessionEventSchema = z.discriminatedUnion("type", [
     viewerCount: z.number().int(),
     viewer: ViewerInfoSchema.optional()
   }),
-  z.object({ ts: z.number(), type: z.literal("action_recorded"), action: RecordedActionSchema }),
+  z.object({
+    ts: z.number(),
+    type: z.literal("action_recorded"),
+    action: RecordedActionSchema,
+    /** The viewer that performed this action. Optional for backward
+     *  compatibility with events recorded before per-action attribution
+     *  was added. */
+    viewer: ViewerInfoSchema.optional()
+  }),
   z.object({ ts: z.number(), type: z.literal("error"), message: z.string(), detail: z.string().optional() })
 ]);
 var NewSessionSchema = z.object({
@@ -209,7 +217,10 @@ var SessionInfoSchema = z.object({
   outcome: SessionOutcomeSchema.nullable(),
   prompt: z.string().nullable(),
   publisher: PublisherInfoSchema.nullable(),
-  target: TargetInfoSchema.nullable()
+  target: TargetInfoSchema.nullable(),
+  /** Most recent viewer to join (or leave) — what the dashboard list shows
+   *  as the "picked up by" device. Null until the first viewer connects. */
+  lastViewer: ViewerInfoSchema.nullable().optional()
 });
 var SessionSummarySchema = z.object({
   sessionId: z.string(),
@@ -221,7 +232,9 @@ var SessionSummarySchema = z.object({
   createdAt: z.number(),
   endedAt: z.number().nullable(),
   /** Last event-log append timestamp. */
-  updatedAt: z.number()
+  updatedAt: z.number(),
+  /** Most recent viewer to join (or leave). Null until first viewer. */
+  lastViewer: ViewerInfoSchema.nullable().optional()
 });
 var SessionActionsResponseSchema = z.object({
   sessionId: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proxyhuman/protocol",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "ProxyHuman wire-format contract: WebSocket message types, REST response shapes, session lifecycle states. Consumed by @proxyhuman/mcp and the api-worker.",
   "type": "module",
   "main": "./dist/index.cjs",