@letta-ai/letta-agent-sdk 0.6.1 → 0.6.2

package/dist/remote-client-session-core.d.ts

@@ -17,6 +17,7 @@ export declare abstract class RemoteClientSessionCore implements LettaCodeSessio
     private readonly requestTimeoutMs;
     private initializePromise;
     private removeMessageHandler;
+    private detachTransportDisconnect;
     private readonly turns;
     private toolNames;
     private deviceStatusListeners;
@@ -63,6 +64,25 @@ export declare abstract class RemoteClientSessionCore implements LettaCodeSessio
     changeDeviceState(updates: ChangeDeviceStateOptions): Promise<void>;
     updateToolset(toolsetPreference: string): Promise<void>;
     protected abstract initializeRuntimeController(): Promise<RuntimeSessionInit>;
+    /**
+     * Fail the session when its transport drops unexpectedly.
+     *
+     * Without this an in-flight turn parks forever: nextMessage() only settles
+     * through the coordinator, and the socket's own pending-request rejection
+     * covers request/response commands, not streaming turns.
+     *
+     * The session is not revived — the runtime lived on the dead socket. The
+     * caller observes the error and rebuilds via resumeSession().
+     *
+     * Subclasses call this only once their runtime is live: a drop before that
+     * already surfaces as a rejected connect or runtime-start, and failing the
+     * session there would defeat initialize()'s retry path. Explicit closes do
+     * not notify, so this fires for faults only. Detaching stays here so every
+     * teardown path — clean close and failed initialize alike — covers it.
+     */
+    protected watchTransportDisconnect(client: {
+        onDisconnect(handler: () => void): () => void;
+    }): void;
     protected afterRuntimeInitialized(): Promise<void>;
     protected beforeTurn(): Promise<void>;
     protected onCoreClose(): void;

package/dist/remote-client-session-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-client-session-core.d.ts","sourceRoot":"","sources":["../src/remote-client-session-core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remote-client-session-core.d.ts","sourceRoot":"","sources":["../src/remote-client-session-core.ts"],"names":[],"mappings":"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"}

package/dist/remote-turn-coordinator.d.ts

@@ -35,6 +35,16 @@ export declare class RemoteTurnCoordinator {
     markAbortRequested(): void;
     handleProtocolMessage(message: ProtocolMessage, runtime: RuntimeScope): void;
     nextMessage(): Promise<SDKMessage | null>;
+    /**
+     * Close after the transport dropped, surfacing the failure to stream
+     * consumers first.
+     *
+     * A plain close() resolves waiting consumers with `null`, which is
+     * indistinguishable from a conversation ending normally. A dead socket
+     * cannot deliver a turn-scoped failure of its own, so the error is
+     * synthesized here before the queue drains.
+     */
+    closeWithError(detail: string): void;
     close(): void;
     private activateTurn;
     private activateNextTurnFromProtocol;

package/dist/remote-turn-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-turn-coordinator.d.ts","sourceRoot":"","sources":["../src/remote-turn-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EAIV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAoBL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAEtC,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAK;gBAErB,MAAM,EAAE,2BAA2B;IAO/C,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,eAAe,IAAI,OAAO;IAI1B,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAuBjD,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAU1C,kBAAkB,IAAI,IAAI;IAI1B,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAsC5E,WAAW,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASzC,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,uBAAuB;IAiD/B,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,oBAAoB;IA0K5B,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,UAAU;CAKnB"}
+{"version":3,"file":"remote-turn-coordinator.d.ts","sourceRoot":"","sources":["../src/remote-turn-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EAIV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAoBL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAEtC,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAK;gBAErB,MAAM,EAAE,2BAA2B;IAO/C,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,eAAe,IAAI,OAAO;IAI1B,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAuBjD,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAU1C,kBAAkB,IAAI,IAAI;IAI1B,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAsC5E,WAAW,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASzC;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBpC,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,uBAAuB;IAiD/B,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,oBAAoB;IA0K5B,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,UAAU;CAKnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-agent-sdk",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "packageManager": "bun@1.3.0",
   "description": "SDK for programmatic control of Letta agents",
   "type": "module",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@letta-ai/letta-client": "^1.12.1",
-    "@letta-ai/letta-code": "0.30.0"
+    "@letta-ai/letta-code": "0.30.5"
   },
   "devDependencies": {
     "@modelcontextprotocol/server-everything": "^2026.7.4",

package/src/agent-creation.ts

@@ -1,66 +1,104 @@
 import {
-  buildCreatedAgentTags,
-  buildCreateAgentRequestForPersonality,
-  buildSystemPrompt,
-  LETTA_CODE_AGENT_TYPE,
-  MODEL_PRESETS,
+  buildCreateAgentRequest,
+  type CreateAgentMemoryBlock,
+  type CreateAgentRequest,
 } from "@letta-ai/letta-code/agent-presets";
 import type { CreateAgentOptions } from "./types.js";
 
-const DEFAULT_MODEL_ID = "auto";
-const DEFAULT_SUMMARIZATION_MODEL = "letta/auto";
-
-function resolveModel(modelIdentifier: string): string {
-  const preset = MODEL_PRESETS.find(
-    (model) =>
-      model.id === modelIdentifier || model.handle === modelIdentifier,
-  );
-  if (preset) return preset.handle;
-
-  // Preserve support for model handles supplied by self-hosted servers even
-  // when they are not present in the bundled catalog.
-  if (modelIdentifier.includes("/")) return modelIdentifier;
+function isPresetSystemPrompt(value: string): boolean {
+  return [
+    "default",
+    "letta-claude",
+    "letta-codex",
+    "letta-gemini",
+    "claude",
+    "codex",
+    "gemini",
+  ].includes(value);
+}
 
-  throw new Error(`Unknown model: ${modelIdentifier}`);
+function assertCreateAgentOptionsSupported(options: CreateAgentOptions): void {
+  if (
+    options.allowedTools !== undefined ||
+    options.disallowedTools !== undefined
+  ) {
+    throw new Error(
+      "App-server createAgent() does not yet support allowedTools/disallowedTools.",
+    );
+  }
+  if (options.canUseTool !== undefined) {
+    throw new Error(
+      "App-server createAgent() does not yet support canUseTool callbacks.",
+    );
+  }
+  if (options.systemInfoReminder !== undefined) {
+    throw new Error(
+      "App-server createAgent() does not yet support systemInfoReminder overrides.",
+    );
+  }
+  if (options.dreaming?.behavior !== undefined) {
+    throw new Error(
+      "App-server createAgent() does not yet support dreaming.behavior overrides.",
+    );
+  }
 }
 
-/**
- * Build the standard harness portion of a create-agent request.
- *
- * Personality presets are explicit opt-ins. Without one, the SDK builds a
- * generic agent and lets the caller's memory blocks define its identity.
- */
-export async function buildInitialAgentBody(
+/** Translate SDK convenience options into the canonical Letta Code request. */
+export async function createAgentBody(
   options: CreateAgentOptions,
-): Promise<Record<string, unknown>> {
-  if (options.personality !== undefined) {
-    return {
-      ...(await buildCreateAgentRequestForPersonality({
-        personalityId: options.personality,
-        ...(options.name !== undefined ? { name: options.name } : {}),
-        ...(options.description !== undefined
-          ? { description: options.description }
-          : {}),
-        ...(options.model !== undefined ? { model: options.model } : {}),
-        ...(options.tags !== undefined ? { extraTags: options.tags } : {}),
-      })),
-    };
+): Promise<CreateAgentRequest> {
+  assertCreateAgentOptionsSupported(options);
+
+  let system: string | undefined;
+  if (options.systemPrompt !== undefined) {
+    if (
+      typeof options.systemPrompt !== "string" ||
+      isPresetSystemPrompt(options.systemPrompt)
+    ) {
+      throw new Error(
+        "createAgent() does not yet support system prompt presets for this backend.",
+      );
+    }
+    system = options.systemPrompt;
+  }
+
+  const memoryBlocks: CreateAgentMemoryBlock[] = [];
+  const blockIds: string[] = [];
+  for (const item of options.memory ?? []) {
+    if (typeof item === "string") {
+      throw new Error(
+        "App-server createAgent() does not yet support memory preset names.",
+      );
+    }
+    if ("blockId" in item) {
+      blockIds.push(item.blockId);
+    } else {
+      memoryBlocks.push({ ...item });
+    }
+  }
+  if (options.persona !== undefined) {
+    memoryBlocks.push({ label: "persona", value: options.persona });
+  }
+  if (options.human !== undefined) {
+    memoryBlocks.push({ label: "human", value: options.human });
   }
+  const hasMemoryConfiguration =
+    options.memory !== undefined ||
+    options.persona !== undefined ||
+    options.human !== undefined;
 
-  return {
-    agent_type: LETTA_CODE_AGENT_TYPE,
-    ...(options.name !== undefined ? { name: options.name } : {}),
-    ...(options.description !== undefined
-      ? { description: options.description }
-      : {}),
-    model: resolveModel(options.model ?? DEFAULT_MODEL_ID),
-    system: buildSystemPrompt("default", "memfs"),
-    tags: buildCreatedAgentTags({
-      enableMemfs: true,
-      tags: options.tags ?? [],
-    }),
-    initial_message_sequence: [],
-    parallel_tool_calls: true,
-    compaction_settings: { model: DEFAULT_SUMMARIZATION_MODEL },
-  };
+  return buildCreateAgentRequest({
+    personalityId: options.personality,
+    name: options.name,
+    description: options.description,
+    model: options.model,
+    system,
+    memoryBlocks: hasMemoryConfiguration ? memoryBlocks : undefined,
+    blockIds,
+    extraTags: options.tags,
+    enableMemfs: options.memfs ?? true,
+    baseTools: options.baseTools,
+    embedding: options.embedding,
+    hidden: options.hidden,
+  });
 }

package/src/app-server-session.ts

@@ -11,12 +11,7 @@ import type {
   RuntimeStartResponseMessage,
   UpdateModelResponseMessage,
 } from "@letta-ai/letta-code/app-server-protocol";
-import {
-  buildSystemPrompt,
-  GIT_MEMORY_ENABLED_TAG,
-  LETTA_CODE_ORIGIN_TAG,
-} from "@letta-ai/letta-code/agent-presets";
-import { buildInitialAgentBody } from "./agent-creation.js";
+import { createAgentBody } from "./agent-creation.js";
 import { normalizeAppServerModels } from "./app-server-models.js";
 import {
   buildCanUseToolContext,
@@ -99,152 +94,10 @@ export type AppServerSessionOptions = Partial<LettaCodeRemoteClientOptions> & {
   connect?: (
     sessionEnv?: Record<string, string>,
   ) => Promise<{ url: string; close(): void }>;
-  /** Whether SDK create-agent payloads should add the origin tag automatically. */
-  includeSdkOriginTag?: boolean;
 };
 
 export type AppServerSessionMode = RuntimeSessionMode;
 
-function isPresetSystemPrompt(value: string): boolean {
-  return [
-    "default",
-    "letta-claude",
-    "letta-codex",
-    "letta-gemini",
-    "claude",
-    "codex",
-    "gemini",
-  ].includes(value);
-}
-
-function assertRemoteCreateAgentOptionsSupported(options: CreateAgentOptions): void {
-  if (options.allowedTools !== undefined || options.disallowedTools !== undefined) {
-    throw new Error("App-server createAgent() does not yet support allowedTools/disallowedTools.");
-  }
-  if (options.canUseTool !== undefined) {
-    throw new Error("App-server createAgent() does not yet support canUseTool callbacks.");
-  }
-  if (options.systemInfoReminder !== undefined) {
-    throw new Error("App-server createAgent() does not yet support systemInfoReminder overrides.");
-  }
-  if (options.dreaming?.behavior !== undefined) {
-    throw new Error("App-server createAgent() does not yet support dreaming.behavior overrides.");
-  }
-}
-
-function normalizeMemoryBlock(block: Record<string, unknown>): Record<string, unknown> {
-  const normalized = { ...block };
-  if (normalized.value === undefined && typeof normalized.content === "string") {
-    normalized.value = normalized.content;
-  }
-  return normalized;
-}
-
-function upsertMemoryBlock(
-  blocks: Array<Record<string, unknown>>,
-  block: Record<string, unknown>,
-): void {
-  const label = block.label;
-  if (typeof label === "string") {
-    const existingIndex = blocks.findIndex((candidate) => candidate.label === label);
-    if (existingIndex >= 0) {
-      blocks[existingIndex] = block;
-      return;
-    }
-  }
-  blocks.push(block);
-}
-
-export async function createAgentBody(
-  options: CreateAgentOptions,
-  settings: { includeSdkOriginTag?: boolean } = {},
-): Promise<Record<string, unknown>> {
-  assertRemoteCreateAgentOptionsSupported(options);
-
-  const includeOriginTag = settings.includeSdkOriginTag ?? true;
-  const body = await buildInitialAgentBody(options);
-
-  if (Array.isArray(body.tags)) {
-    body.tags = body.tags.filter(
-      (tag) =>
-        (includeOriginTag || tag !== LETTA_CODE_ORIGIN_TAG) &&
-        (options.memfs !== false || tag !== GIT_MEMORY_ENABLED_TAG),
-    );
-  }
-
-  if (options.embedding !== undefined) body.embedding = options.embedding;
-  if (options.hidden !== undefined) body.hidden = options.hidden;
-  // When baseTools is omitted, the harness applies its created-agent
-  // defaults (web_search, fetch_webpage). An explicit list is pinned exactly:
-  // `tools` alone does not suppress the Letta agent type's defaults, so both
-  // default tool attachment and its default tool rules are disabled here.
-  if (options.baseTools === undefined) {
-    delete body.tools;
-    delete body.include_base_tools;
-    delete body.include_base_tool_rules;
-  } else {
-    body.tools = options.baseTools;
-    body.include_base_tools = false;
-    body.include_base_tool_rules = false;
-  }
-
-  if (options.systemPrompt === undefined) {
-    if (options.memfs === false) {
-      body.system = buildSystemPrompt("default", "standard");
-    }
-  } else {
-    if (typeof options.systemPrompt === "string") {
-      if (isPresetSystemPrompt(options.systemPrompt)) {
-        throw new Error("createAgent() does not yet support system prompt presets for this backend.");
-      }
-      body.system = options.systemPrompt;
-    } else {
-      throw new Error("createAgent() does not yet support system prompt preset objects for this backend.");
-    }
-  }
-
-  const hasMemoryConfiguration =
-    Array.isArray(body.memory_blocks) ||
-    options.memory !== undefined ||
-    options.persona !== undefined ||
-    options.human !== undefined;
-  const memoryBlocks = Array.isArray(body.memory_blocks)
-    ? body.memory_blocks
-        .filter(
-          (block): block is Record<string, unknown> =>
-            block !== null && typeof block === "object",
-        )
-        .map((block) => ({ ...block }))
-    : [];
-  const blockIds: string[] = [];
-  for (const item of options.memory ?? []) {
-    if (typeof item === "string") {
-      throw new Error("App-server createAgent() does not yet support memory preset names.");
-    }
-    if ("blockId" in item) {
-      blockIds.push(item.blockId);
-    } else {
-      upsertMemoryBlock(
-        memoryBlocks,
-        normalizeMemoryBlock(item as unknown as Record<string, unknown>),
-      );
-    }
-  }
-  if (options.persona !== undefined) {
-    upsertMemoryBlock(memoryBlocks, {
-      label: "persona",
-      value: options.persona,
-    });
-  }
-  if (options.human !== undefined) {
-    upsertMemoryBlock(memoryBlocks, { label: "human", value: options.human });
-  }
-  if (hasMemoryConfiguration) body.memory_blocks = memoryBlocks;
-  if (blockIds.length > 0) body.block_ids = blockIds;
-
-  return body;
-}
-
 export function externalToolGroups(tools: AnyAgentTool[] | undefined): Array<Record<string, unknown>> | undefined {
   if (!tools || tools.length === 0) return undefined;
   return [
@@ -779,6 +632,8 @@ export class AppServerSession extends RemoteClientSessionCore {
         throw new Error(response.error ?? "Failed to start app-server runtime");
       }
 
+      this.watchTransportDisconnect(client);
+
       const tools = agentToolNames(response.agent);
       const skillSources = options.skillSources;
       const clientToolset = "toolset" in options ? options.toolset : undefined;
@@ -883,9 +738,7 @@ export class AppServerSession extends RemoteClientSessionCore {
 
     if (this.mode.kind === "create-agent") {
       command.create_agent = {
-        body: await createAgentBody(this.mode.options, {
-          includeSdkOriginTag: this.remoteOptions.includeSdkOriginTag,
-        }),
+        body: await createAgentBody(this.mode.options),
         // Hidden (worker-style) agents default to unpinned.
         pin_global:
           this.remoteOptions.pinGlobalAgent ??

package/src/cloud-session.ts

@@ -5,10 +5,10 @@ import {
   createAppServerClient,
   type AppServerClient,
 } from "@letta-ai/letta-code/app-server-client";
+import { createAgentBody } from "./agent-creation.js";
 import {
   AppServerRuntimeController,
   agentToolNames,
-  createAgentBody,
   createExternalToolCallHandler,
   externalToolGroups,
   registerAppServerControlRequestHandler,
@@ -398,6 +398,8 @@ export class CloudEnvironmentSession extends RemoteClientSessionCore {
         throw new Error(response.error ?? "Failed to start Cloud status runtime");
       }
 
+      this.watchTransportDisconnect(client);
+
       const tools = agentToolNames(response.agent);
       const skillSources = options.skillSources;
       const clientToolset = "toolset" in options ? options.toolset : undefined;

package/src/remote-client-session-core.ts

@@ -77,6 +77,7 @@ export abstract class RemoteClientSessionCore implements LettaCodeSession {
   private readonly requestTimeoutMs: number | undefined;
   private initializePromise: Promise<SDKInitMessage> | null = null;
   private removeMessageHandler: (() => void) | null = null;
+  private detachTransportDisconnect: (() => void) | null = null;
   private readonly turns: RemoteTurnCoordinator;
   private toolNames: string[] | undefined;
   private deviceStatusListeners = new Set<(status: SessionDeviceStatus) => void>();
@@ -188,6 +189,8 @@ export abstract class RemoteClientSessionCore implements LettaCodeSession {
   private cleanupFailedInitialize(): void {
     this.removeMessageHandler?.();
     this.removeMessageHandler = null;
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = null;
     this.controller?.close();
     this.controller = null;
     // Subclass-owned resources (spawned connections, sandboxes, handlers)
@@ -543,6 +546,8 @@ export abstract class RemoteClientSessionCore implements LettaCodeSession {
     this.closed = true;
     this.removeMessageHandler?.();
     this.removeMessageHandler = null;
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = null;
     this.turns.close();
     for (const cancel of [...this.deviceStatusRefreshCancels]) {
       cancel(new Error(`Session closed while waiting for ${this.label} device status`));
@@ -619,6 +624,35 @@ export abstract class RemoteClientSessionCore implements LettaCodeSession {
 
   protected abstract initializeRuntimeController(): Promise<RuntimeSessionInit>;
 
+  /**
+   * Fail the session when its transport drops unexpectedly.
+   *
+   * Without this an in-flight turn parks forever: nextMessage() only settles
+   * through the coordinator, and the socket's own pending-request rejection
+   * covers request/response commands, not streaming turns.
+   *
+   * The session is not revived — the runtime lived on the dead socket. The
+   * caller observes the error and rebuilds via resumeSession().
+   *
+   * Subclasses call this only once their runtime is live: a drop before that
+   * already surfaces as a rejected connect or runtime-start, and failing the
+   * session there would defeat initialize()'s retry path. Explicit closes do
+   * not notify, so this fires for faults only. Detaching stays here so every
+   * teardown path — clean close and failed initialize alike — covers it.
+   */
+  protected watchTransportDisconnect(client: {
+    onDisconnect(handler: () => void): () => void;
+  }): void {
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = client.onDisconnect(() => {
+      if (this.closed) return;
+      this.turns.closeWithError(
+        `The ${this.label} connection closed unexpectedly; resume the conversation to continue.`,
+      );
+      this.close();
+    });
+  }
+
   protected async afterRuntimeInitialized(): Promise<void> {
     // Optional hook for subclasses to send transport-specific startup frames.
   }

package/src/remote-turn-coordinator.ts

@@ -160,6 +160,33 @@ export class RemoteTurnCoordinator {
     });
   }
 
+  /**
+   * Close after the transport dropped, surfacing the failure to stream
+   * consumers first.
+   *
+   * A plain close() resolves waiting consumers with `null`, which is
+   * indistinguishable from a conversation ending normally. A dead socket
+   * cannot deliver a turn-scoped failure of its own, so the error is
+   * synthesized here before the queue drains.
+   */
+  closeWithError(detail: string): void {
+    if (this.closed) return;
+    const active = this.activeTurn;
+    if (active) {
+      this.failTurn(active, detail);
+    } else {
+      this.enqueue({
+        type: "error",
+        message: detail,
+        errorCode: "error",
+        stopReason: "error",
+        errorDetail: detail,
+        recoverable: false,
+      });
+    }
+    this.close();
+  }
+
   close(): void {
     if (this.closed) return;
     this.closed = true;