@linkshell/wire 0.2.22 → 0.2.23

package/dist/workflow.d.ts

@@ -1,14 +1,35 @@
 import { z } from "zod";
-export declare const workflowStateSchema: z.ZodEnum<["running", "paused", "completed", "failed", "stopped"]>;
+export declare const workflowStateSchema: z.ZodEnum<{
+    paused: "paused";
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    stopped: "stopped";
+}>;
 export type WorkflowState = z.infer<typeof workflowStateSchema>;
-export declare const workflowAgentStateSchema: z.ZodEnum<["pending", "running", "paused", "completed", "failed", "stopped", "unknown"]>;
+export declare const workflowAgentStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    paused: "paused";
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    stopped: "stopped";
+    pending: "pending";
+}>;
 export type WorkflowAgentState = z.infer<typeof workflowAgentStateSchema>;
 export declare const workflowAgentSchema: z.ZodObject<{
     id: z.ZodString;
-    /** Present only after the host has imported this agent's transcript. */
     toolCallId: z.ZodOptional<z.ZodString>;
     title: z.ZodString;
-    state: z.ZodEnum<["pending", "running", "paused", "completed", "failed", "stopped", "unknown"]>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        paused: "paused";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        stopped: "stopped";
+        pending: "pending";
+    }>;
     phaseId: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     tokens: z.ZodOptional<z.ZodNumber>;
@@ -17,54 +38,25 @@ export declare const workflowAgentSchema: z.ZodObject<{
     startedAt: z.ZodOptional<z.ZodNumber>;
     endedAt: z.ZodOptional<z.ZodNumber>;
     result: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    title: string;
-    state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-    toolCallId?: string | undefined;
-    phaseId?: string | undefined;
-    model?: string | undefined;
-    tokens?: number | undefined;
-    toolCalls?: number | undefined;
-    durationMs?: number | undefined;
-    startedAt?: number | undefined;
-    endedAt?: number | undefined;
-    result?: string | undefined;
-}, {
-    id: string;
-    title: string;
-    state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-    toolCallId?: string | undefined;
-    phaseId?: string | undefined;
-    model?: string | undefined;
-    tokens?: number | undefined;
-    toolCalls?: number | undefined;
-    durationMs?: number | undefined;
-    startedAt?: number | undefined;
-    endedAt?: number | undefined;
-    result?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type WorkflowAgent = z.infer<typeof workflowAgentSchema>;
 export declare const workflowPhaseSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
     order: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    title: string;
-    order: number;
-}, {
-    id: string;
-    title: string;
-    order: number;
-}>;
+}, z.core.$strip>;
 export type WorkflowPhase = z.infer<typeof workflowPhaseSchema>;
 /** A complete run snapshot, independent of the loaded conversation window. */
 export declare const workflowSchema: z.ZodObject<{
     runId: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    state: z.ZodOptional<z.ZodEnum<["running", "paused", "completed", "failed", "stopped"]>>;
-    /** Observed counts: a dynamic script may start more agents later. */
+    state: z.ZodOptional<z.ZodEnum<{
+        paused: "paused";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        stopped: "stopped";
+    }>>;
     started: z.ZodOptional<z.ZodNumber>;
     completed: z.ZodOptional<z.ZodNumber>;
     tokens: z.ZodOptional<z.ZodNumber>;
@@ -75,21 +67,20 @@ export declare const workflowSchema: z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         order: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        title: string;
-        order: number;
-    }, {
-        id: string;
-        title: string;
-        order: number;
-    }>, "many">>;
+    }, z.core.$strip>>>;
     agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        /** Present only after the host has imported this agent's transcript. */
         toolCallId: z.ZodOptional<z.ZodString>;
         title: z.ZodString;
-        state: z.ZodEnum<["pending", "running", "paused", "completed", "failed", "stopped", "unknown"]>;
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            paused: "paused";
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+            stopped: "stopped";
+            pending: "pending";
+        }>;
         phaseId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         tokens: z.ZodOptional<z.ZodNumber>;
@@ -98,90 +89,6 @@ export declare const workflowSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodNumber>;
         endedAt: z.ZodOptional<z.ZodNumber>;
         result: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        title: string;
-        state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-        toolCallId?: string | undefined;
-        phaseId?: string | undefined;
-        model?: string | undefined;
-        tokens?: number | undefined;
-        toolCalls?: number | undefined;
-        durationMs?: number | undefined;
-        startedAt?: number | undefined;
-        endedAt?: number | undefined;
-        result?: string | undefined;
-    }, {
-        id: string;
-        title: string;
-        state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-        toolCallId?: string | undefined;
-        phaseId?: string | undefined;
-        model?: string | undefined;
-        tokens?: number | undefined;
-        toolCalls?: number | undefined;
-        durationMs?: number | undefined;
-        startedAt?: number | undefined;
-        endedAt?: number | undefined;
-        result?: string | undefined;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    name?: string | undefined;
-    completed?: number | undefined;
-    state?: "paused" | "running" | "completed" | "failed" | "stopped" | undefined;
-    tokens?: number | undefined;
-    durationMs?: number | undefined;
-    startedAt?: number | undefined;
-    endedAt?: number | undefined;
-    runId?: string | undefined;
-    started?: number | undefined;
-    phases?: {
-        id: string;
-        title: string;
-        order: number;
-    }[] | undefined;
-    agents?: {
-        id: string;
-        title: string;
-        state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-        toolCallId?: string | undefined;
-        phaseId?: string | undefined;
-        model?: string | undefined;
-        tokens?: number | undefined;
-        toolCalls?: number | undefined;
-        durationMs?: number | undefined;
-        startedAt?: number | undefined;
-        endedAt?: number | undefined;
-        result?: string | undefined;
-    }[] | undefined;
-}, {
-    name?: string | undefined;
-    completed?: number | undefined;
-    state?: "paused" | "running" | "completed" | "failed" | "stopped" | undefined;
-    tokens?: number | undefined;
-    durationMs?: number | undefined;
-    startedAt?: number | undefined;
-    endedAt?: number | undefined;
-    runId?: string | undefined;
-    started?: number | undefined;
-    phases?: {
-        id: string;
-        title: string;
-        order: number;
-    }[] | undefined;
-    agents?: {
-        id: string;
-        title: string;
-        state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
-        toolCallId?: string | undefined;
-        phaseId?: string | undefined;
-        model?: string | undefined;
-        tokens?: number | undefined;
-        toolCalls?: number | undefined;
-        durationMs?: number | undefined;
-        startedAt?: number | undefined;
-        endedAt?: number | undefined;
-        result?: string | undefined;
-    }[] | undefined;
-}>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type Workflow = z.infer<typeof workflowSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkshell/wire",
-  "version": "0.2.22",
+  "version": "0.2.23",
   "description": "Wire protocol for LinkShell v2: session model, JSON-RPC methods, end-to-end encryption and the relay client.",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "@noble/ciphers": "^2.4.0",
     "@noble/curves": "^1.9.7",
     "@noble/hashes": "^1.8.0",
-    "zod": "^3.24.3"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "vitest": "^3.2.1"

package/src/acp.ts

@@ -1,10 +1,10 @@
 import { z } from "zod";
 
-const env = z.record(z.string());
+const env = z.record(z.string(), z.string());
 export const mcpServerSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("stdio"), name: z.string().min(1), command: z.string().min(1), args: z.array(z.string()).default([]), env: env.default({}) }),
-  z.object({ type: z.literal("http"), name: z.string().min(1), url: z.string().url(), headers: env.default({}) }),
-  z.object({ type: z.literal("sse"), name: z.string().min(1), url: z.string().url(), headers: env.default({}) }),
+  z.object({ type: z.literal("http"), name: z.string().min(1), url: z.url(), headers: env.default({}) }),
+  z.object({ type: z.literal("sse"), name: z.string().min(1), url: z.url(), headers: env.default({}) }),
   z.object({ type: z.literal("acp"), name: z.string().min(1), command: z.string().min(1), args: z.array(z.string()).default([]), env: env.default({}) }),
 ]);
 export type AcpMcpServer = z.infer<typeof mcpServerSchema>;
@@ -23,10 +23,10 @@ export const acpRemoteAgentSchema = z.object({
   label: z.string().min(1).max(80),
   transport: z.enum(["stdio", "http", "websocket"]),
   command: z.string().optional(), args: z.array(z.string()).default([]),
-  url: z.string().url().optional(),
+  url: z.url().optional(),
   /** Header name to environment-variable name. The UI does not store secrets. */
   headerEnv: env.default({}),
-  settings: acpAgentSettingsSchema.default({}),
+  settings: acpAgentSettingsSchema.prefault({}),
 });
 export type AcpRemoteAgent = z.infer<typeof acpRemoteAgentSchema>;
 

package/src/computer-preview.ts

@@ -4,7 +4,7 @@ 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(),
+  capturedAt: z.number().nonnegative(),
   width: z.number().int().positive().max(2048),
   height: z.number().int().positive().max(2048),
   mimeType: z.literal("image/webp"),

package/src/content.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 
-const optionalString = z.string().nullish().transform((value) => value ?? undefined);
-const optionalMeta = z.record(z.unknown()).nullish().transform((value) => value ?? undefined);
+const optionalString = z.string().nullish().transform((value) => value ?? undefined).optional();
+const optionalMeta = z.record(z.string(), z.unknown()).nullish().transform((value) => value ?? undefined).optional();
 const contentMetadata = {
-  annotations: z.object({ audience: z.array(z.enum(["user", "assistant"])).nullish().transform((value) => value ?? undefined), priority: z.number().nullish().transform((value) => value ?? undefined), lastModified: optionalString }).passthrough().nullish().transform((value) => value ?? undefined),
+  annotations: z.looseObject({ audience: z.array(z.enum(["user", "assistant"])).nullish().transform((value) => value ?? undefined).optional(), priority: z.number().nullish().transform((value) => value ?? undefined).optional(), lastModified: optionalString }).nullish().transform((value) => value ?? undefined).optional(),
   _meta: optionalMeta,
 };
 const contentVariants = z.discriminatedUnion("type", [
@@ -28,7 +28,7 @@ const contentVariants = z.discriminatedUnion("type", [
     title: optionalString,
     description: optionalString,
     mimeType: optionalString,
-    size: z.number().nullish().transform((value) => value ?? undefined),
+    size: z.number().nullish().transform((value) => value ?? undefined).optional(),
     ...contentMetadata,
     /** What the link names: a file (default), a skill the user invoked, or another agent. */
     kind: z.enum(["file", "skill", "agent"]).optional(),
@@ -36,7 +36,7 @@ const contentVariants = z.discriminatedUnion("type", [
 ]);
 export type ContentBlock = z.infer<typeof contentVariants>;
 // Hide the nested validator implementation from every exported RPC declaration.
-export const contentBlockSchema: z.ZodType<ContentBlock, z.ZodTypeDef, unknown> = contentVariants;
+export const contentBlockSchema: z.ZodType<ContentBlock, unknown> = contentVariants;
 
 export const toolCallStatusSchema = z.enum(["pending", "in_progress", "completed", "failed"]);
 export type ToolCallStatus = z.infer<typeof toolCallStatusSchema>;

package/src/envelopes.ts

@@ -95,6 +95,7 @@ export function stripHiddenContext(text: string, { keepPeers = false }: { keepPe
     .trim();
 }
 
+// eslint-disable-next-line no-control-regex -- terminal colour codes start with ESC.
 const ANSI = /\u001b\[[\d;?]*[ -/]*[@-~]/g;
 
 function tagText(source: string, tag: string): string | undefined {
@@ -206,6 +207,15 @@ function unescapeHtml(value: string): string {
   });
 }
 
+/** Output as a terminal shows it: no colour codes, a backspace takes back the character before it, other controls are not drawn. */
+function printed(value: string): string {
+  let text = value.replace(ANSI, "");
+  // eslint-disable-next-line no-control-regex -- a backspace is the character being handled.
+  for (let previous = ""; previous !== text; ) { previous = text; text = text.replace(/[^\n\x08]\x08/g, ""); }
+  // eslint-disable-next-line no-control-regex -- what a terminal doesn't draw.
+  return text.replace(/[\x00-\x08\x0b-\x1f\x7f]/g, "");
+}
+
 /**
  * Codex Desktop writes a mention of another of its threads as a Markdown link to
  * codex://threads/<id>, with the space before it as "&#x20;": read as the thread's title.
@@ -249,7 +259,7 @@ export function readUserText(raw: string, { images = 0 }: { images?: number } =
   }
 
   if (/^<bash-(?:input|stdout|stderr)>/.test(text)) {
-    const clean = (value?: string) => (value === undefined ? undefined : unescapeHtml(value).replace(ANSI, "").replace(/\n+$/, "")) || undefined;
+    const clean = (value?: string) => (value === undefined ? undefined : printed(unescapeHtml(value)).replace(/\n+$/, "")) || undefined;
     const command = clean(tagText(text, "bash-input"))?.trim();
     const stdout = clean(tagText(text, "bash-stdout"));
     const stderr = clean(tagText(text, "bash-stderr"));

package/src/live-activity.ts

@@ -42,7 +42,7 @@ export interface LiveActivityPayload extends Partial<LiveActivityContentState> {
 export const liveActivityIdSchema = z.string().min(1).max(128).regex(/^[a-zA-Z0-9-]+$/);
 export const liveActivitySubscriptionSchema = z.object({
   activityId: liveActivityIdSchema,
-  serviceUrl: z.string().url().max(256),
+  serviceUrl: z.url().max(256),
   grant: z.string().regex(/^[a-f0-9]{64}$/),
   expiresAt: z.number().int().positive(),
   computerKey: z.string().min(1).max(512),

package/src/relay.ts

@@ -74,7 +74,7 @@ export const serverFrameSchema = z.discriminatedUnion("t", [
     result: z.unknown().optional(),
     error: z.object({ code: z.string(), message: z.string() }).optional(),
   }),
-  z.object({ t: z.literal("event"), name: z.string(), data: z.unknown() }),
+  z.object({ t: z.literal("event"), name: z.string(), data: z.unknown().optional() }),
   /** An encrypted frame from a peer, with the keys the gateway verified it holds. */
   z.object({ t: z.literal("from"), from: publicIdentitySchema, via: z.enum(["paired", "account"]), d: z.string() }),
   /** A frame couldn't be delivered: the peer is offline or not reachable. */

package/src/rpc-mcp.ts

@@ -68,7 +68,7 @@ export const mcpMethods = {
       sessionId: z.string().min(1),
       server: z.string().min(1),
       tool: z.string().min(1),
-      arguments: z.record(z.unknown()).optional(),
+      arguments: z.record(z.string(), z.unknown()).optional(),
       connector: z.string().optional(),
     }),
     result: z.object({

package/src/rpc.ts

@@ -78,7 +78,7 @@ export const RPC_APP_ERROR = -32000;
  */
 export const HOST_PROTOCOL = 2;
 
-const empty = z.object({}).passthrough();
+const empty = z.looseObject({});
 
 export const directoryEntrySchema = z.object({
   name: z.string(),
@@ -111,7 +111,7 @@ const acpMethods = {
     result: empty,
   },
   "agents.providers": {
-    params: z.object({ agent: z.string().min(1), operation: z.enum(["list", "set", "disable"]), config: z.object({ providerId: z.string(), apiType: z.string().optional(), baseUrl: z.string().url().optional(), headers: z.record(z.string()).optional() }).optional() }),
+    params: z.object({ agent: z.string().min(1), operation: z.enum(["list", "set", "disable"]), config: z.object({ providerId: z.string(), apiType: z.string().optional(), baseUrl: z.url().optional(), headers: z.record(z.string(), z.string()).optional() }).optional() }),
     result: z.object({ providers: z.array(acpProviderSchema) }),
   },
   "agents.custom": {
@@ -434,12 +434,12 @@ const coreMethods = {
       args: z.array(z.string()).default([]),
       /** The terminal's working directory and environment. */
       cwd: z.string().optional(),
-      env: z.record(z.string()).optional(),
+      env: z.record(z.string(), z.string()).optional(),
     }),
     result: z.object({
       command: z.string(),
       args: z.array(z.string()),
-      env: z.record(z.string()).optional(),
+      env: z.record(z.string(), z.string()).optional(),
       /** Set for handoff agents: the session this terminal now drives. */
       sessionId: z.string().optional(),
     }),
@@ -455,7 +455,7 @@ const coreMethods = {
     result: z.object({
       command: z.string(),
       args: z.array(z.string()),
-      env: z.record(z.string()).optional(),
+      env: z.record(z.string(), z.string()).optional(),
     }),
   },
   // ── Gateway: reach this computer from anywhere ──