linkshell-cli 0.1.16 → 0.2.1

package/dist/shared-protocol/src/index.d.ts

@@ -17,9 +17,9 @@ export declare const envelopeSchema: z.ZodObject<{
     ack: z.ZodOptional<z.ZodNumber>;
     payload: z.ZodUnknown;
 }, "strip", z.ZodTypeAny, {
+    sessionId: string;
     id: string;
     type: string;
-    sessionId: string;
     timestamp: string;
     deviceId?: string | undefined;
     traceId?: string | undefined;
@@ -27,9 +27,9 @@ export declare const envelopeSchema: z.ZodObject<{
     ack?: number | undefined;
     payload?: unknown;
 }, {
+    sessionId: string;
     id: string;
     type: string;
-    sessionId: string;
     timestamp: string;
     deviceId?: string | undefined;
     traceId?: string | undefined;
@@ -84,14 +84,14 @@ export declare const sessionConnectPayloadSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     role: "host" | "client";
     clientName: string;
-    provider?: "custom" | "claude" | "codex" | undefined;
+    provider?: "claude" | "codex" | "custom" | undefined;
     protocolVersion?: number | undefined;
     hostname?: string | undefined;
     platform?: string | undefined;
 }, {
     role: "host" | "client";
     clientName: string;
-    provider?: "custom" | "claude" | "codex" | undefined;
+    provider?: "claude" | "codex" | "custom" | undefined;
     protocolVersion?: number | undefined;
     hostname?: string | undefined;
     platform?: string | undefined;
@@ -193,15 +193,91 @@ export declare const sessionHostDisconnectedPayloadSchema: z.ZodObject<{
     reason?: string | undefined;
 }>;
 export declare const sessionHostReconnectedPayloadSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const screenStartPayloadSchema: z.ZodObject<{
+    fps: z.ZodDefault<z.ZodNumber>;
+    quality: z.ZodDefault<z.ZodNumber>;
+    scale: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fps: number;
+    quality: number;
+    scale: number;
+}, {
+    fps?: number | undefined;
+    quality?: number | undefined;
+    scale?: number | undefined;
+}>;
+export declare const screenStopPayloadSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const screenFramePayloadSchema: z.ZodObject<{
+    data: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    frameId: z.ZodNumber;
+    chunkIndex: z.ZodDefault<z.ZodNumber>;
+    chunkTotal: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    width: number;
+    height: number;
+    frameId: number;
+    chunkIndex: number;
+    chunkTotal: number;
+}, {
+    data: string;
+    width: number;
+    height: number;
+    frameId: number;
+    chunkIndex?: number | undefined;
+    chunkTotal?: number | undefined;
+}>;
+export declare const screenStatusPayloadSchema: z.ZodObject<{
+    active: z.ZodBoolean;
+    mode: z.ZodDefault<z.ZodEnum<["webrtc", "fallback", "off"]>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    active: boolean;
+    mode: "webrtc" | "fallback" | "off";
+    error?: string | undefined;
+}, {
+    active: boolean;
+    error?: string | undefined;
+    mode?: "webrtc" | "fallback" | "off" | undefined;
+}>;
+export declare const screenOfferPayloadSchema: z.ZodObject<{
+    sdp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sdp: string;
+}, {
+    sdp: string;
+}>;
+export declare const screenAnswerPayloadSchema: z.ZodObject<{
+    sdp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sdp: string;
+}, {
+    sdp: string;
+}>;
+export declare const screenIcePayloadSchema: z.ZodObject<{
+    candidate: z.ZodString;
+    sdpMid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sdpMLineIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    candidate: string;
+    sdpMid?: string | null | undefined;
+    sdpMLineIndex?: number | null | undefined;
+}, {
+    candidate: string;
+    sdpMid?: string | null | undefined;
+    sdpMLineIndex?: number | null | undefined;
+}>;
 export declare const errorPayloadSchema: z.ZodObject<{
     code: z.ZodString;
     message: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    code: string;
     message: string;
-}, {
     code: string;
+}, {
     message: string;
+    code: string;
 }>;
 export declare const protocolMessageSchemas: {
     readonly "session.connect": z.ZodObject<{
@@ -214,14 +290,14 @@ export declare const protocolMessageSchemas: {
     }, "strip", z.ZodTypeAny, {
         role: "host" | "client";
         clientName: string;
-        provider?: "custom" | "claude" | "codex" | undefined;
+        provider?: "claude" | "codex" | "custom" | undefined;
         protocolVersion?: number | undefined;
         hostname?: string | undefined;
         platform?: string | undefined;
     }, {
         role: "host" | "client";
         clientName: string;
-        provider?: "custom" | "claude" | "codex" | undefined;
+        provider?: "claude" | "codex" | "custom" | undefined;
         protocolVersion?: number | undefined;
         hostname?: string | undefined;
         platform?: string | undefined;
@@ -251,11 +327,11 @@ export declare const protocolMessageSchemas: {
         code: z.ZodString;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        code: string;
         message: string;
-    }, {
         code: string;
+    }, {
         message: string;
+        code: string;
     }>;
     readonly "terminal.output": z.ZodObject<{
         stream: z.ZodEnum<["stdout", "stderr"]>;
@@ -369,6 +445,82 @@ export declare const protocolMessageSchemas: {
         reason?: string | undefined;
     }>;
     readonly "session.host_reconnected": z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly "screen.start": z.ZodObject<{
+        fps: z.ZodDefault<z.ZodNumber>;
+        quality: z.ZodDefault<z.ZodNumber>;
+        scale: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        fps: number;
+        quality: number;
+        scale: number;
+    }, {
+        fps?: number | undefined;
+        quality?: number | undefined;
+        scale?: number | undefined;
+    }>;
+    readonly "screen.stop": z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly "screen.frame": z.ZodObject<{
+        data: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        frameId: z.ZodNumber;
+        chunkIndex: z.ZodDefault<z.ZodNumber>;
+        chunkTotal: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        data: string;
+        width: number;
+        height: number;
+        frameId: number;
+        chunkIndex: number;
+        chunkTotal: number;
+    }, {
+        data: string;
+        width: number;
+        height: number;
+        frameId: number;
+        chunkIndex?: number | undefined;
+        chunkTotal?: number | undefined;
+    }>;
+    readonly "screen.status": z.ZodObject<{
+        active: z.ZodBoolean;
+        mode: z.ZodDefault<z.ZodEnum<["webrtc", "fallback", "off"]>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        active: boolean;
+        mode: "webrtc" | "fallback" | "off";
+        error?: string | undefined;
+    }, {
+        active: boolean;
+        error?: string | undefined;
+        mode?: "webrtc" | "fallback" | "off" | undefined;
+    }>;
+    readonly "screen.offer": z.ZodObject<{
+        sdp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sdp: string;
+    }, {
+        sdp: string;
+    }>;
+    readonly "screen.answer": z.ZodObject<{
+        sdp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sdp: string;
+    }, {
+        sdp: string;
+    }>;
+    readonly "screen.ice": z.ZodObject<{
+        candidate: z.ZodString;
+        sdpMid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sdpMLineIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        candidate: string;
+        sdpMid?: string | null | undefined;
+        sdpMLineIndex?: number | null | undefined;
+    }, {
+        candidate: string;
+        sdpMid?: string | null | undefined;
+        sdpMLineIndex?: number | null | undefined;
+    }>;
 };
 export type ProtocolMessageType = keyof typeof protocolMessageSchemas;
 export declare function createEnvelope<T>(input: {

package/dist/shared-protocol/src/index.js

@@ -97,6 +97,37 @@ export const sessionHostDisconnectedPayloadSchema = z.object({
     reason: z.string().optional(),
 });
 export const sessionHostReconnectedPayloadSchema = z.object({});
+// ── Screen sharing payloads ─────────────────────────────────────────
+export const screenStartPayloadSchema = z.object({
+    fps: z.number().int().min(1).max(30).default(5),
+    quality: z.number().int().min(10).max(100).default(60),
+    scale: z.number().min(0.1).max(1).default(0.5),
+});
+export const screenStopPayloadSchema = z.object({});
+export const screenFramePayloadSchema = z.object({
+    data: z.string(), // base64 JPEG
+    width: z.number().int(),
+    height: z.number().int(),
+    frameId: z.number().int(),
+    chunkIndex: z.number().int().default(0),
+    chunkTotal: z.number().int().default(1),
+});
+export const screenStatusPayloadSchema = z.object({
+    active: z.boolean(),
+    mode: z.enum(["webrtc", "fallback", "off"]).default("off"),
+    error: z.string().optional(),
+});
+export const screenOfferPayloadSchema = z.object({
+    sdp: z.string(),
+});
+export const screenAnswerPayloadSchema = z.object({
+    sdp: z.string(),
+});
+export const screenIcePayloadSchema = z.object({
+    candidate: z.string(),
+    sdpMid: z.string().nullable().optional(),
+    sdpMLineIndex: z.number().nullable().optional(),
+});
 export const errorPayloadSchema = z.object({
     code: z.string().min(1),
     message: z.string().min(1),
@@ -121,6 +152,13 @@ export const protocolMessageSchemas = {
     "control.release": controlReleasePayloadSchema,
     "session.host_disconnected": sessionHostDisconnectedPayloadSchema,
     "session.host_reconnected": sessionHostReconnectedPayloadSchema,
+    "screen.start": screenStartPayloadSchema,
+    "screen.stop": screenStopPayloadSchema,
+    "screen.frame": screenFramePayloadSchema,
+    "screen.status": screenStatusPayloadSchema,
+    "screen.offer": screenOfferPayloadSchema,
+    "screen.answer": screenAnswerPayloadSchema,
+    "screen.ice": screenIcePayloadSchema,
 };
 // ── UUID helper (works in Node, Web, and Expo) ─────────────────────
 function generateId() {

package/dist/shared-protocol/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../shared-protocol/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uEAAuE;AAEvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAG3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,iBAAiB;IACjB,YAAY;IACZ,QAAQ;IACR,cAAc;IACd,MAAM;IACN,YAAY;CACb,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;CACf,CAAC,CAAC;AAGH,uEAAuE;AAEvE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAIH,uEAAuE;AAEvE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,gBAAgB;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEH,uEAAuE;AAEvE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB,EAAE,2BAA2B;IAC9C,aAAa,EAAE,uBAAuB;IACtC,gBAAgB,EAAE,0BAA0B;IAC5C,mBAAmB,EAAE,6BAA6B;IAClD,eAAe,EAAE,kBAAkB;IACnC,iBAAiB,EAAE,2BAA2B;IAC9C,gBAAgB,EAAE,0BAA0B;IAC5C,iBAAiB,EAAE,2BAA2B;IAC9C,eAAe,EAAE,yBAAyB;IAC1C,iBAAiB,EAAE,2BAA2B;IAC9C,eAAe,EAAE,yBAAyB;IAC1C,iBAAiB,EAAE,2BAA2B;IAC9C,eAAe,EAAE,yBAAyB;IAC1C,eAAe,EAAE,yBAAyB;IAC1C,gBAAgB,EAAE,0BAA0B;IAC5C,iBAAiB,EAAE,2BAA2B;IAC9C,2BAA2B,EAAE,oCAAoC;IACjE,0BAA0B,EAAE,mCAAmC;CACvD,CAAC;AAIX,sEAAsE;AAEtE,SAAS,UAAU;IACjB,IAAI,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,0EAA0E;IAC1E,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,cAAc,CAAI,KASjC;IACC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAiB;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAW,EACX,OAAgB;IAEhB,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../shared-protocol/src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkshell-cli",
-  "version": "0.1.16",
+  "version": "0.2.1",
   "description": "Remote terminal bridge for Claude Code / Codex — control from your phone",
   "type": "module",
   "main": "dist/index.js",
@@ -36,14 +36,17 @@
     "dev": "tsx src/index.ts"
   },
   "dependencies": {
-    "@linkshell/protocol": "^0.1.0",
-    "@linkshell/gateway": "^0.1.7",
+    "@linkshell/protocol": "^0.2.0",
+    "@linkshell/gateway": "^0.2.0",
     "commander": "^13.1.0",
     "node-pty": "^1.0.0",
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.18.1",
     "zod": "^3.24.3"
   },
+  "optionalDependencies": {
+    "werift": "^0.22.9"
+  },
   "devDependencies": {
     "@types/ws": "^8.5.14",
     "tsx": "^4.19.3"

package/src/index.ts

@@ -15,7 +15,7 @@ program
   .description(
     "Bridge a local Claude/Codex terminal session to a remote gateway",
   )
-  .version("0.1.9");
+  .version("0.2.0");
 
 // ── start ───────────────────────────────────────────────────────────
 
@@ -56,6 +56,7 @@ program
     String(config.cols ?? 120),
   )
   .option("--rows <rows>", "Initial terminal rows", String(config.rows ?? 36))
+  .option("--screen", "Enable screen sharing capability")
   .option("--daemon", "Run in background (detached)")
   .option("--verbose", "Enable verbose logging")
   .option("--_foreground-bridge", undefined) // internal
@@ -85,6 +86,7 @@ program
       childArgs.push("--cols", String(options.cols));
       childArgs.push("--rows", String(options.rows));
       if (options.verbose) childArgs.push("--verbose");
+      if (options.screen) childArgs.push("--screen");
       if (options.sessionId) childArgs.push("--session-id", options.sessionId);
       // Pass through extra args
       const extra = command.args.filter((v: string) => v !== "--");
@@ -161,6 +163,7 @@ program
       clientName: options.clientName,
       hostname: options.hostname,
       verbose: Boolean(options.verbose),
+      screen: Boolean(options.screen),
       providerConfig,
     });
 

package/src/runtime/bridge-session.ts

@@ -11,6 +11,8 @@ import {
 import type { Envelope } from "@linkshell/protocol";
 import type { ProviderConfig } from "../providers.js";
 import { ScrollbackBuffer } from "./scrollback.js";
+import { ScreenFallback } from "./screen-fallback.js";
+import { ScreenShare } from "./screen-share.js";
 import { getLanIp } from "../utils/lan-ip.js";
 
 export interface BridgeSessionOptions {
@@ -23,6 +25,7 @@ export interface BridgeSessionOptions {
   clientName: string;
   hostname?: string;
   verbose?: boolean;
+  screen?: boolean;
   providerConfig: ProviderConfig;
 }
 
@@ -101,6 +104,8 @@ export class BridgeSession {
   private sessionId = "";
   private exited = false;
   private stopped = false;
+  private screenCapture: ScreenFallback | undefined;
+  private screenShare: ScreenShare | undefined;
 
   constructor(options: BridgeSessionOptions) {
     this.options = options;
@@ -267,6 +272,25 @@ export class BridgeSession {
       }
       case "session.heartbeat":
         break;
+      case "screen.start": {
+        const p = parseTypedPayload("screen.start", envelope.payload);
+        this.startScreenCapture(p.fps, p.quality, p.scale);
+        break;
+      }
+      case "screen.stop": {
+        this.stopScreenCapture();
+        break;
+      }
+      case "screen.answer": {
+        const p = parseTypedPayload("screen.answer", envelope.payload);
+        this.screenShare?.handleAnswer(p.sdp);
+        break;
+      }
+      case "screen.ice": {
+        const p = parseTypedPayload("screen.ice", envelope.payload);
+        this.screenShare?.handleIceCandidate(p.candidate, p.sdpMid, p.sdpMLineIndex);
+        break;
+      }
       default:
         break;
     }
@@ -373,6 +397,68 @@ export class BridgeSession {
     }
   }
 
+  private startScreenCapture(fps: number, quality: number, scale: number): void {
+    if (!this.options.screen) {
+      this.log("screen sharing not enabled (use --screen)");
+      this.send(
+        createEnvelope({
+          type: "screen.status",
+          sessionId: this.sessionId,
+          payload: { active: false, mode: "off" as const, error: "Screen sharing not enabled on host. Start CLI with --screen flag." },
+        }),
+      );
+      return;
+    }
+    this.stopScreenCapture();
+    this.log(`starting screen capture (fps=${fps}, quality=${quality}, scale=${scale})`);
+
+    // Try WebRTC first, fall back to screenshot stream
+    if (ScreenShare.isAvailable()) {
+      this.log("WebRTC available, starting screen share");
+      this.screenShare = new ScreenShare({
+        sessionId: this.sessionId,
+        fps,
+        quality,
+        scale,
+        onSignal: (envelope) => this.send(envelope),
+        onStatus: (envelope) => this.send(envelope),
+      });
+      this.screenShare.start().catch((err) => {
+        this.log(`WebRTC failed, falling back to screenshot stream: ${err}`);
+        this.screenShare = undefined;
+        this.startFallbackCapture(fps, quality, scale);
+      });
+    } else {
+      this.log("WebRTC not available (missing werift or ffmpeg), using screenshot fallback");
+      this.startFallbackCapture(fps, quality, scale);
+    }
+  }
+
+  private startFallbackCapture(fps: number, quality: number, scale: number): void {
+    this.screenCapture = new ScreenFallback({
+      fps,
+      quality,
+      scale,
+      sessionId: this.sessionId,
+      onFrame: (envelope) => this.send(envelope),
+      onStatus: (envelope) => this.send(envelope),
+    });
+    this.screenCapture.start();
+  }
+
+  private stopScreenCapture(): void {
+    if (this.screenShare) {
+      this.log("stopping WebRTC screen share");
+      this.screenShare.stop();
+      this.screenShare = undefined;
+    }
+    if (this.screenCapture) {
+      this.log("stopping screenshot capture");
+      this.screenCapture.stop();
+      this.screenCapture = undefined;
+    }
+  }
+
   private scheduleReconnect(): void {
     if (this.reconnecting || this.reconnectAttempts >= RECONNECT_MAX_ATTEMPTS) {
       process.stderr.write(
@@ -408,6 +494,7 @@ export class BridgeSession {
     this.stopped = true;
     this.exited = true;
     this.stopHeartbeat();
+    this.stopScreenCapture();
     if (this.reconnectTimer) {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = undefined;