@linkshell/wire 0.2.22 → 0.2.24

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.24",
   "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/index.ts

@@ -1,4 +1,5 @@
 export * from "./model.js";
+export * from "./model-name.js";
 export * from "./goal.js";
 export * from "./updates.js";
 export * from "./workflow.js";

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/model-name.ts

@@ -0,0 +1,7 @@
+/** Format a raw GPT model ID for display without changing the value sent to the agent. */
+export function displayModelName(name: string): string {
+  const match = /^gpt-(\d+(?:\.\d+)*)(?:-([a-z][a-z0-9-]*))?$/i.exec(name.trim());
+  if (!match) return name;
+  const suffix = match[2]?.split("-").map((word) => word[0]!.toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+  return `GPT-${match[1]}${suffix ? ` ${suffix}` : ""}`;
+}

package/src/model.ts

@@ -333,6 +333,8 @@ export type ProjectSummary = z.infer<typeof projectSummarySchema>;
 export const machineInfoSchema = z.object({
   machineId: z.string().min(1),
   hostname: z.string(),
+  /** Host-owned display name; its presence also advertises `machine.rename`. */
+  naming: z.object({ defaultName: z.string(), customName: z.string().optional(), configured: z.boolean() }).optional(),
   platform: z.string(),
   hostVersion: z.string(),
   /** The host's RPC revision (`HOST_PROTOCOL`); absent from hosts older than it. */

package/src/relay-client.ts

@@ -30,7 +30,8 @@ export interface RelayClientOptions {
   url: string;
   identity: Identity;
   role: PeerRole;
-  name: string;
+  name: string | (() => string);
+  namingConfigured?: () => boolean;
   platform?: string;
   /** Account token, fetched fresh for each connection. */
   token?: () => Promise<string | undefined> | string | undefined;
@@ -240,7 +241,8 @@ export class RelayClient {
     this.heardAt = Date.now();
     let fatal: { code: string; message: string } | undefined;
     socket.onmessage = (event) => {
-      if (this.socket === socket) this.heardAt = Date.now();
+      if (this.socket !== socket) return;
+      this.heardAt = Date.now();
       let frame;
       try {
         const parsed = serverFrameSchema.safeParse(JSON.parse(String(event.data)));
@@ -251,7 +253,7 @@ export class RelayClient {
       }
       switch (frame.t) {
         case "challenge":
-          void this.authenticate(frame.nonce);
+          void this.authenticate(frame.nonce, socket);
           return;
         case "ready":
           this.attempt = 0;
@@ -362,19 +364,22 @@ export class RelayClient {
     this.scheduleReconnect({ code: "disconnected", message });
   }
 
-  private async authenticate(nonce: string): Promise<void> {
+  private async authenticate(nonce: string, socket: RelaySocket): Promise<void> {
     let token: string | undefined;
     try {
       token = (await this.options.token?.()) ?? undefined;
     } catch {
       token = undefined;
     }
+    // A token refresh may outlive reauthentication; its nonce belongs to the socket that asked.
+    if (this.socket !== socket) return;
     this.sendFrame({
       t: "auth",
       role: this.options.role,
       identity: publicIdentity(this.options.identity),
       signature: sign(this.options.identity, gatewayChallengeMessage(nonce)),
-      name: this.options.name.slice(0, 120),
+      name: (typeof this.options.name === "function" ? this.options.name() : this.options.name).slice(0, 120),
+      ...(this.options.namingConfigured?.() ? { namingConfigured: true } : {}),
       platform: this.options.platform,
       token,
       ...(this.options.locked?.() ? { locked: true } : {}),

package/src/relay.ts

@@ -24,6 +24,8 @@ export type PeerRole = z.infer<typeof peerRoleSchema>;
 /** A machine as a device sees it in the gateway's list. */
 export const machineEntrySchema = publicIdentitySchema.extend({
   name: z.string(),
+  /** An explicit host-owned name/reset supersedes older device-local aliases. */
+  namingConfigured: z.boolean().optional(),
   platform: z.string().optional(),
   online: z.boolean(),
   /** How this device may reach it: it paired, or both belong to the same account. */
@@ -50,6 +52,7 @@ export const clientFrameSchema = z.discriminatedUnion("t", [
     identity: publicIdentitySchema,
     signature: z.string(),
     name: z.string().max(120),
+    namingConfigured: z.boolean().optional(),
     platform: z.string().max(40).optional(),
     /** Account access token, when signed in. */
     token: z.string().optional(),
@@ -74,7 +77,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. */
@@ -96,6 +99,8 @@ export interface RelayMethods {
     result: { machine: MachineEntry };
   };
   "machines.list": { params: Record<string, never>; result: { machines: MachineEntry[] } };
+  /** Machine: refresh its display metadata without replacing its authenticated connection. */
+  "machines.update": { params: { name: string; namingConfigured?: boolean }; result: Record<string, never> };
   "machines.forget": { params: { machineId: string }; result: Record<string, never> };
   "devices.list": { params: Record<string, never>; result: { devices: DeviceEntry[] } };
   "devices.revoke": { params: { deviceId: string }; result: Record<string, never> };

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

@@ -20,7 +20,7 @@ import {
   questionAnswerSchema,
   pendingPermissionSchema,
 } from "./model.js";
-import { contentBlockSchema, sessionEventSchema, sessionNoticeSchema } from "./updates.js";
+import { contentBlockSchema, sessionConfigOptionSchema, sessionEventSchema, sessionNoticeSchema } from "./updates.js";
 import { sideChatSchema } from "./side.js";
 import { mcpMethods } from "./rpc-mcp.js";
 
@@ -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": {
@@ -135,6 +135,11 @@ const coreMethods = {
     params: empty,
     result: machineInfoSchema,
   },
+  "machine.rename": {
+    /** Empty restores the configured default; names never change peer identities. */
+    params: z.object({ name: z.string().trim().max(40) }),
+    result: machineInfoSchema,
+  },
   "projects.list": {
     params: z.object({ limit: z.number().int().positive().max(200).optional() }),
     result: z.object({ projects: z.array(projectSummarySchema) }),
@@ -167,11 +172,15 @@ const coreMethods = {
       agent: z.string().min(1),
       /** Where the session will work: an agent's project settings can choose another model. */
       cwd: z.string().optional(),
+      /** Preview settings supported by a selected model without changing the agent's default. */
+      model: z.string().optional(),
     }),
     result: z.object({
       /** As a session's model option lists them (`group`: the heading some agents put models under). */
       models: z.array(z.object({ value: z.string(), name: z.string(), description: z.string().optional(), group: z.string().optional() })),
       current: z.string().optional(),
+      /** Settings available before the first prompt; omitted by older hosts or agents without a template. */
+      config: z.array(sessionConfigOptionSchema).optional(),
     }),
   },
   "sessions.create": {
@@ -182,6 +191,8 @@ const coreMethods = {
       clientMessageId: z.string().optional(),
       /** One of `agents.models`' values; absent: the agent's own default. */
       model: z.string().optional(),
+      /** Explicit choices from agents.models.config, applied before the first prompt. */
+      config: z.record(z.string(), z.string()).optional(),
       /**
        * Start in a new git worktree of `cwd`'s repository (its own branch, from
        * the last commit) instead of in `cwd` itself. Refused with `not_a_repo`
@@ -434,12 +445,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 +466,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 ──
@@ -741,6 +752,7 @@ export function isMethodName(name: string): name is MethodName {
 // ── Notifications (host → client) ────────────────────────────────────
 
 export const notifications = {
+  "machine.changed": machineInfoSchema,
   "agent.changed": z.object({ agent: agentInfoSchema }),
   "agent.interaction": z.object({ agent: z.string(), request: z.union([pendingPermissionSchema, z.object({ requestId: z.string(), resolved: z.literal(true) })]) }),
   "session.notice": z.object({ sessionId: z.string(), notice: sessionNoticeSchema }),