@linkshell/wire 0.2.1 → 0.2.3

package/README.md

@@ -2,7 +2,7 @@
 
 The LinkShell v2 wire protocol, shared by the host, the relay and the apps:
 
-- the session model and ACP-shaped session updates,
+- the session model and ACP-shaped session updates, including Claude Workflow phases and Agent progress,
 - JSON-RPC methods and notifications between devices and a computer,
 - end-to-end encryption (Ed25519 identities, X25519 channel keys, XChaCha20-Poly1305),
 - the relay frames and a relay client for Node and React Native.

package/dist/computer-preview.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const PREVIEW_MAX_BYTES: number;
+export declare const previewFrameSchema: z.ZodObject<{
+    id: z.ZodString;
+    target: z.ZodString;
+    capturedAt: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    mimeType: z.ZodLiteral<"image/webp">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    target: string;
+    capturedAt: number;
+    width: number;
+    height: number;
+    mimeType: "image/webp";
+}, {
+    id: string;
+    target: string;
+    capturedAt: number;
+    width: number;
+    height: number;
+    mimeType: "image/webp";
+}>;
+export type PreviewFrameInfo = z.infer<typeof previewFrameSchema>;
+export interface PreviewFrame extends PreviewFrameInfo {
+    bytes: Uint8Array;
+}
+/** Length-prefixed metadata and image bytes, inside an authenticated proxy stream. */
+export declare function encodePreviewFrame(frame: PreviewFrame): Uint8Array;
+/** Handles split TCP/data-channel chunks without accepting unbounded allocations. */
+export declare class PreviewFrameDecoder {
+    private held;
+    push(chunk: Uint8Array): PreviewFrame[];
+}

package/dist/computer-preview.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export const PREVIEW_MAX_BYTES = 48 * 1024;
+export const previewFrameSchema = z.object({
+    id: z.string().regex(/^[a-f0-9]{64}$/),
+    target: z.string().max(1024),
+    capturedAt: z.number().finite().nonnegative(),
+    width: z.number().int().positive().max(2048),
+    height: z.number().int().positive().max(2048),
+    mimeType: z.literal("image/webp"),
+});
+/** Length-prefixed metadata and image bytes, inside an authenticated proxy stream. */
+export function encodePreviewFrame(frame) {
+    const { bytes, ...info } = frame;
+    const metadata = new TextEncoder().encode(JSON.stringify(previewFrameSchema.parse(info)));
+    if (bytes.length > PREVIEW_MAX_BYTES)
+        throw new Error("preview image too large");
+    const packet = new Uint8Array(8 + metadata.length + bytes.length);
+    const header = new DataView(packet.buffer);
+    header.setUint32(0, metadata.length);
+    header.setUint32(4, bytes.length);
+    packet.set(metadata, 8);
+    packet.set(bytes, 8 + metadata.length);
+    return packet;
+}
+/** Handles split TCP/data-channel chunks without accepting unbounded allocations. */
+export class PreviewFrameDecoder {
+    held = new Uint8Array(0);
+    push(chunk) {
+        if (this.held.length + chunk.length > PREVIEW_MAX_BYTES + 4104)
+            throw new Error("preview buffer too large");
+        const next = new Uint8Array(this.held.length + chunk.length);
+        next.set(this.held);
+        next.set(chunk, this.held.length);
+        this.held = next;
+        const frames = [];
+        while (this.held.length >= 8) {
+            const header = new DataView(this.held.buffer, this.held.byteOffset);
+            const meta = header.getUint32(0), size = header.getUint32(4);
+            if (meta > 4096 || size > PREVIEW_MAX_BYTES || !meta || !size)
+                throw new Error("invalid preview frame");
+            const total = 8 + meta + size;
+            if (this.held.length < total)
+                break;
+            const info = previewFrameSchema.parse(JSON.parse(new TextDecoder().decode(this.held.subarray(8, 8 + meta))));
+            frames.push({ ...info, bytes: this.held.slice(8 + meta, total) });
+            this.held = this.held.slice(total);
+        }
+        return frames;
+    }
+}
+//# sourceMappingURL=computer-preview.js.map

package/dist/computer-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-preview.js","sourceRoot":"","sources":["../src/computer-preview.ts"],"names":[],"mappings":"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"}

package/dist/goal.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/** Native agent state, not inferred from prose or a completed turn. */
+export declare const sessionGoalSchema: z.ZodObject<{
+    objective: z.ZodString;
+    status: z.ZodEnum<["active", "paused", "blocked", "usageLimited", "budgetLimited", "complete"]>;
+    tokenBudget: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    tokensUsed: z.ZodOptional<z.ZodNumber>;
+    timeUsedSeconds: z.ZodOptional<z.ZodNumber>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+    lastReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+    objective: string;
+    tokenBudget?: number | null | undefined;
+    tokensUsed?: number | undefined;
+    timeUsedSeconds?: number | undefined;
+    iterations?: number | undefined;
+    lastReason?: string | null | undefined;
+}, {
+    status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+    objective: string;
+    tokenBudget?: number | null | undefined;
+    tokensUsed?: number | undefined;
+    timeUsedSeconds?: number | undefined;
+    iterations?: number | undefined;
+    lastReason?: string | null | undefined;
+}>;
+export type SessionGoal = z.infer<typeof sessionGoalSchema>;
+export declare const goalChangeSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<"get">;
+}, "strip", z.ZodTypeAny, {
+    action: "get";
+}, {
+    action: "get";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"set">;
+    objective: z.ZodString;
+    tokenBudget: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    objective: string;
+    action: "set";
+    tokenBudget?: number | undefined;
+}, {
+    objective: string;
+    action: "set";
+    tokenBudget?: number | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"pause">;
+}, "strip", z.ZodTypeAny, {
+    action: "pause";
+}, {
+    action: "pause";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"resume">;
+}, "strip", z.ZodTypeAny, {
+    action: "resume";
+}, {
+    action: "resume";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"clear">;
+}, "strip", z.ZodTypeAny, {
+    action: "clear";
+}, {
+    action: "clear";
+}>]>;
+export type GoalChange = z.infer<typeof goalChangeSchema>;

package/dist/goal.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+/** Native agent state, not inferred from prose or a completed turn. */
+export const sessionGoalSchema = z.object({
+    objective: z.string(),
+    status: z.enum(["active", "paused", "blocked", "usageLimited", "budgetLimited", "complete"]),
+    tokenBudget: z.number().nonnegative().nullable().optional(),
+    tokensUsed: z.number().nonnegative().optional(),
+    timeUsedSeconds: z.number().nonnegative().optional(),
+    iterations: z.number().int().nonnegative().optional(),
+    lastReason: z.string().nullable().optional(),
+});
+export const goalChangeSchema = z.discriminatedUnion("action", [
+    z.object({ action: z.literal("get") }),
+    z.object({ action: z.literal("set"), objective: z.string().trim().min(1).max(4000), tokenBudget: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional() }),
+    z.object({ action: z.literal("pause") }),
+    z.object({ action: z.literal("resume") }),
+    z.object({ action: z.literal("clear") }),
+]);
+//# sourceMappingURL=goal.js.map

package/dist/goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.js","sourceRoot":"","sources":["../src/goal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC7D,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACtC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IACvK,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./model.js";
+export * from "./goal.js";
 export * from "./updates.js";
+export * from "./workflow.js";
 export * from "./rpc.js";
 export * from "./peer.js";
 export * from "./shell.js";
@@ -7,3 +9,4 @@ export * from "./crypto.js";
 export * from "./relay.js";
 export * from "./relay-client.js";
 export * from "./direct.js";
+export * from "./computer-preview.js";

package/dist/index.js

@@ -1,5 +1,7 @@
 export * from "./model.js";
+export * from "./goal.js";
 export * from "./updates.js";
+export * from "./workflow.js";
 export * from "./rpc.js";
 export * from "./peer.js";
 export * from "./shell.js";
@@ -7,4 +9,5 @@ export * from "./crypto.js";
 export * from "./relay.js";
 export * from "./relay-client.js";
 export * from "./direct.js";
+export * from "./computer-preview.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}