@proxyhuman/protocol 0.2.1 → 0.2.2

package/dist/index.cjs

@@ -265,7 +265,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 +280,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

@@ -1947,6 +1947,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 +2002,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 +2046,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 +2112,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 +2153,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 +2184,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 +2555,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 +2610,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 +2654,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;
@@ -3165,6 +3242,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";
@@ -3335,6 +3417,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";
@@ -3482,6 +3569,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 +3610,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 +3641,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 +3676,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 +3710,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

@@ -1947,6 +1947,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 +2002,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 +2046,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 +2112,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 +2153,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 +2184,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 +2555,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 +2610,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 +2654,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;
@@ -3165,6 +3242,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";
@@ -3335,6 +3417,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";
@@ -3482,6 +3569,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 +3610,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 +3641,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 +3676,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 +3710,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

@@ -209,7 +209,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 +224,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.2",
   "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",