@agentknight/sdk 0.9.40 → 0.9.42

package/dist/chunks/{acp-adapter-TVAW7EHK.js → acp-adapter-SPIMGGL2.js}

@@ -1,15 +1,15 @@
 import {
   latestPreviewItems
-} from "./chunk-D6HWUCVM.js";
+} from "./chunk-RBULXS7T.js";
 import {
   UnsupportedAgentOperationError
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   ConversationItemSchema,
   PromptImageAttachmentSchema,
   SESSION_TIMELINE_PAGE_SIZE,
   SessionSummarySchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/acp-adapter.ts
 import { spawn } from "node:child_process";

package/dist/chunks/{chunk-6RWWNR37.js → chunk-ASHXZ46V.js}

@@ -1,6 +1,6 @@
 import {
   SECURE_MESSAGE_MAX_CIPHERTEXT_LENGTH
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/agent-selection.ts
 import { z } from "zod";

package/dist/chunks/{chunk-SDAEMVSD.js → chunk-J52FWJU4.js}

@@ -1,6 +1,6 @@
 import {
   SessionOperationError
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 
 // src/adapters/copilot/runtime/session-identity.ts
 function assertMainSessionId(sessionId) {

package/dist/chunks/{chunk-AJ4YL22H.js → chunk-LQIW4ARE.js}

@@ -3,7 +3,7 @@ import {
   SessionCommunicationDataSchema,
   SessionNameSchema,
   WorkbenchOperationStatusSchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/session-operations.ts
 import { createHash, randomUUID } from "node:crypto";

package/dist/chunks/{chunk-CVWUKZX7.js → chunk-QN3OD5UE.js}

@@ -1,6 +1,6 @@
 import {
   IdSchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/data-directory.ts
 import { randomUUID } from "node:crypto";

package/dist/chunks/{chunk-OV77TRIH.js → chunk-QTBB2U7G.js}

@@ -1150,13 +1150,25 @@ var PairingCreateResultSchema = z10.discriminatedUnion("ok", [
   z10.object({
     ok: z10.literal(true),
     code: z10.string().min(32).max(256),
-    expiresAt: z10.number().int().positive()
+    expiresAt: z10.number().int().positive(),
+    // Presence advertises the PC-only status endpoint; older Relays omit it.
+    statusId: z10.string().regex(/^[A-Za-z0-9_-]{43}$/u).optional()
   }),
   z10.object({
     ok: z10.literal(false),
     error: ProtocolFailureSchema
   })
 ]);
+var PairingStatusRequestSchema = z10.object({
+  userId: IdSchema,
+  machineId: IdSchema,
+  statusId: z10.string().regex(/^[A-Za-z0-9_-]{43}$/u)
+});
+var PairingStatusSchema = z10.enum(["pending", "paired", "unavailable"]);
+var PairingStatusResultSchema = z10.discriminatedUnion("ok", [
+  z10.object({ ok: z10.literal(true), state: PairingStatusSchema }),
+  z10.object({ ok: z10.literal(false), error: ProtocolFailureSchema })
+]);
 var PairingExchangeRequestSchema = z10.object({
   code: z10.string().min(32).max(256),
   clientId: IdSchema
@@ -2661,6 +2673,7 @@ export {
   PAIRING_URI_SCHEME,
   PAIRING_URI_HOST,
   PairingCreateResultSchema,
+  PairingStatusResultSchema,
   SECURE_MESSAGE_MAX_CIPHERTEXT_LENGTH,
   SecureMessageSchema,
   MOBILE_CONNECTED_REPLAY_CAPABILITY,

package/dist/chunks/{chunk-D6HWUCVM.js → chunk-RBULXS7T.js}

@@ -1,7 +1,7 @@
 import {
   SessionAssistantPreviewSchema,
   SessionUserPreviewSchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/assistant-preview.ts
 function isContentfulAssistant(item) {

package/dist/chunks/{chunk-ULJMR33R.js → chunk-SHOE7YAU.js}

@@ -1,9 +1,9 @@
 import {
   isContentfulAssistant
-} from "./chunk-D6HWUCVM.js";
+} from "./chunk-RBULXS7T.js";
 import {
   SessionOperationError
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   CONVERSATION_SOURCE_ID_LIMIT,
   SESSION_DIRECTORY_LIST_OPERATION,
@@ -22,7 +22,7 @@ import {
   WorkbenchInsightsSchema,
   WorkbenchQueueMutationResultSchema,
   WorkbenchQueueSnapshotSchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/operation-diagnostics.ts
 import { AsyncLocalStorage } from "node:async_hooks";

package/dist/chunks/{chunk-Q3TQPONK.js → chunk-VDC4G7ZG.js}

@@ -1,14 +1,14 @@
 import {
   AgentSessionRenameError,
   validateSessionName
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   ConversationItemSchema,
   GroupChatInfoSchema,
   GroupChatParticipantSchema,
   SESSION_TIMELINE_PAGE_SIZE,
   SessionSummarySchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/group-chat.ts
 import { createHash, randomUUID } from "node:crypto";

package/dist/chunks/{copilot-adapter-KH6NXHGK.js → copilot-adapter-A6QB4RD4.js}

@@ -18,25 +18,25 @@ import {
   recordTimelineSyncDiagnostic,
   resolveGitProjectIdentity,
   sanitizeGitRemoteUrl
-} from "./chunk-ULJMR33R.js";
+} from "./chunk-SHOE7YAU.js";
 import {
   assertMainSessionId,
   isResearchSessionId
-} from "./chunk-SDAEMVSD.js";
+} from "./chunk-J52FWJU4.js";
 import {
   GroupChatError,
   GroupChatMessageSchema,
   GroupChatRuntime
-} from "./chunk-Q3TQPONK.js";
+} from "./chunk-VDC4G7ZG.js";
 import {
   isContentfulAssistant
-} from "./chunk-D6HWUCVM.js";
+} from "./chunk-RBULXS7T.js";
 import {
   AgentSessionRenameError,
   SessionOperationError,
   TimelinePageBudgetError,
   validateSessionName
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   ConversationItemSchema,
   CopilotModelOptionSchema,
@@ -57,7 +57,7 @@ import {
   WorkbenchScheduleEntrySchema,
   WorkbenchScheduleProposalSchema,
   WorkbenchScheduleSnapshotSchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/copilot-adapter.ts
 import { createHash as createHash4, randomUUID as randomUUID6 } from "node:crypto";
@@ -547,11 +547,14 @@ var SessionConfiguration = class {
   }
   forget(sessionId) {
     this.#sessionReasoningEfforts.delete(sessionId);
+    this.#pendingModels.delete(sessionId);
   }
   clear() {
     this.#sessionReasoningEfforts.clear();
+    this.#pendingModels.clear();
   }
   #sessionReasoningEfforts = /* @__PURE__ */ new Map();
+  #pendingModels = /* @__PURE__ */ new Map();
   async serializeSessionConfiguration(sessionId, operation) {
     const runtime = this.ports.state(sessionId);
     const previous = runtime.configuration.transition;
@@ -578,15 +581,21 @@ var SessionConfiguration = class {
     if (agentMode === "autopilot") {
       await this.ensureAutopilotPermissions(session);
     }
+    const pending = this.#pendingModels.get(sessionId);
+    if (pending !== void 0 && model.modelId === pending.modelId && (pending.reasoningEffort === "default" && model.modelId !== pending.previousModelId || model.reasoningEffort === pending.reasoningEffort || pending.reasoningEffort === "default" && model.reasoningEffort !== pending.previousEffort)) {
+      this.#pendingModels.delete(sessionId);
+    }
+    const selected = this.#pendingModels.get(sessionId);
+    const selectedModelId = selected?.modelId ?? model.modelId;
     const reasoningEffort = model.reasoningEffort === void 0 ? this.#sessionReasoningEfforts.get(sessionId) ?? "default" : CurrentReasoningEffortSchema.parse(model.reasoningEffort);
     const configurableEffort = SessionReasoningEffortSchema.safeParse(reasoningEffort);
     if (configurableEffort.success) {
       this.#sessionReasoningEfforts.set(sessionId, configurableEffort.data);
     }
     return {
-      ...model.modelId === void 0 ? {} : { modelId: model.modelId },
+      ...selectedModelId === void 0 ? {} : { modelId: selectedModelId },
       agentMode,
-      reasoningEffort
+      reasoningEffort: selected?.reasoningEffort ?? reasoningEffort
     };
   }
   async setAgentMode(session, mode) {
@@ -671,32 +680,37 @@ var SessionConfiguration = class {
         this.ports.assertOriginalAction(sessionId);
         if (options.modelId !== void 0 || options.reasoningEffort !== void 0) {
           const currentModel = await session.rpc.model.getCurrent();
-          const modelId = options.modelId ?? currentModel.modelId;
+          const pending = this.#pendingModels.get(sessionId);
+          const modelId = options.modelId ?? pending?.modelId ?? currentModel.modelId;
           if (modelId === void 0) {
             throw new Error(
               "Copilot did not report the current model for reasoning effort configuration"
             );
           }
           const currentReasoningEffort = currentModel.reasoningEffort ?? this.#sessionReasoningEfforts.get(sessionId) ?? "default";
-          const reasoningEffort = options.reasoningEffort ?? (modelId === currentModel.modelId ? currentReasoningEffort : "default");
-          if (modelId !== currentModel.modelId || reasoningEffort !== currentReasoningEffort) {
-            if ((await session.rpc.metadata?.isProcessing?.())?.processing) {
-              throw new Error("Copilot session is busy; wait before changing its model");
-            }
+          const reasoningEffort = options.reasoningEffort ?? (modelId === pending?.modelId ? pending.reasoningEffort : modelId === currentModel.modelId ? currentReasoningEffort : "default");
+          if (!(pending?.modelId === modelId && pending.reasoningEffort === reasoningEffort) && (modelId !== currentModel.modelId || reasoningEffort !== currentReasoningEffort || pending !== void 0)) {
             const result = await session.rpc.model.switchTo({
               modelId,
               ...reasoningEffort === "default" ? {} : { reasoningEffort },
               deferIfModelChangeQueued: true
             });
-            if (result.deferred) {
-              throw new Error("Copilot queued the model change; it has not been applied yet");
-            }
-            if (result.modelId !== modelId) {
+            if (!result.deferred && result.modelId !== modelId) {
               throw new Error(`Copilot did not apply the requested model: ${modelId}`);
             }
-            const parsedEffort = SessionReasoningEffortSchema.safeParse(reasoningEffort);
-            if (parsedEffort.success) {
-              this.#sessionReasoningEfforts.set(sessionId, parsedEffort.data);
+            if (result.deferred) {
+              this.#pendingModels.set(sessionId, {
+                modelId,
+                reasoningEffort,
+                previousModelId: currentModel.modelId,
+                previousEffort: currentReasoningEffort
+              });
+            } else {
+              this.#pendingModels.delete(sessionId);
+              const parsedEffort = SessionReasoningEffortSchema.safeParse(reasoningEffort);
+              if (parsedEffort.success) {
+                this.#sessionReasoningEfforts.set(sessionId, parsedEffort.data);
+              }
             }
           }
         }
@@ -1146,13 +1160,12 @@ var SessionConnections = class {
         await this.ports.dismissInteractions(sessionId);
         this.ports.persistInteractions(sessionId, persistInteractions);
         const wasBusy = runtime.activity.busy;
-        const sdkMode = mode === "immediate" && !wasBusy ? "enqueue" : mode;
         const submittedAt = this.ports.runtime().client.supportsLocalSubmissionTime === true ? (/* @__PURE__ */ new Date()).toISOString() : void 0;
         const activityRevision = runtime.activity.revision;
         onDispatch?.();
         const receipt = measureOperationStage("session-send", () => session.send({
           prompt,
-          mode: sdkMode,
+          mode,
           ...displayPrompt === void 0 ? {} : { displayPrompt },
           ...sdkAttachments.length === 0 ? {} : { attachments: sdkAttachments }
         }));

package/dist/chunks/{managed-agent-adapter-F7U26CH2.js → managed-agent-adapter-LMHQX6IH.js}

@@ -1,13 +1,13 @@
 import {
   AgentSelectionSchema,
   assertSelectionSnapshotFits
-} from "./chunk-6RWWNR37.js";
+} from "./chunk-ASHXZ46V.js";
 import {
   isResearchSessionId
-} from "./chunk-SDAEMVSD.js";
+} from "./chunk-J52FWJU4.js";
 import {
   GroupChatError
-} from "./chunk-Q3TQPONK.js";
+} from "./chunk-VDC4G7ZG.js";
 import {
   AgentModelListingError,
   AgentSessionRenameError,
@@ -15,11 +15,11 @@ import {
   UnsupportedAgentOperationError,
   captureWorkbenchAccess,
   validateSessionName
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   InteractionResponseSchema,
   SessionSummarySchema
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/managed-agent-adapter.ts
 import { createHash, randomUUID } from "node:crypto";

package/dist/chunks/{pi-adapter-G4GQ5ULV.js → pi-adapter-NWQWUNXO.js}

@@ -1,16 +1,16 @@
 import {
   latestPreviewItems
-} from "./chunk-D6HWUCVM.js";
+} from "./chunk-RBULXS7T.js";
 import {
   AgentSessionRenameError,
   UnsupportedAgentOperationError,
   validateSessionName
-} from "./chunk-AJ4YL22H.js";
+} from "./chunk-LQIW4ARE.js";
 import {
   InteractionRequestSchema,
   REASONING_EFFORTS,
   SESSION_TIMELINE_PAGE_SIZE
-} from "./chunk-OV77TRIH.js";
+} from "./chunk-QTBB2U7G.js";
 
 // src/pi-adapter.ts
 import { createHash as createHash2, randomUUID } from "node:crypto";

package/dist/index.d.ts

@@ -18,6 +18,13 @@ declare const ProtocolErrorSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ProtocolError = z.infer<typeof ProtocolErrorSchema>;
 
+declare const PairingStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    paired: "paired";
+    unavailable: "unavailable";
+}>;
+type PairingStatus = z.infer<typeof PairingStatusSchema>;
+
 declare const SecureEventNameSchema: z.ZodEnum<{
     "session.communication": "session.communication";
     "session.list.result": "session.list.result";
@@ -1873,24 +1880,25 @@ declare class ContentCipher {
 interface PairingTicket {
     readonly uri: string;
     readonly expiresAt: number;
+    readonly statusId?: string;
 }
 interface PairingProvider {
     getPairing(options?: {
         readonly force?: boolean;
     }): Promise<PairingTicket>;
+    getPairingStatus?(statusId: string): Promise<PairingStatus>;
 }
 declare class CachedPairingProvider implements PairingProvider {
     #private;
-    constructor(requestPairing: () => Promise<PairingTicket>, minimumValidityMs?: number);
+    private readonly requestStatus?;
+    constructor(requestPairing: () => Promise<PairingTicket>, minimumValidityMs?: number, requestStatus?: ((statusId: string) => Promise<PairingStatus>) | undefined);
     getPairing(options?: {
         readonly force?: boolean;
     }): Promise<PairingTicket>;
+    getPairingStatus(statusId: string): Promise<PairingStatus>;
 }
 declare function buildPairingUri(relayUrl: string, code: string, machineId: string, contentKey: string): string;
-declare function requestPairingUri(config: Pick<PcAgentConfig, "relayUrl" | "relayToken" | "userId">, identity: DeviceIdentity, contentKey: ContentKeyMaterial): Promise<{
-    uri: string;
-    expiresAt: number;
-}>;
+declare function requestPairingUri(config: Pick<PcAgentConfig, "relayUrl" | "relayToken" | "userId">, identity: DeviceIdentity, contentKey: ContentKeyMaterial): Promise<PairingTicket>;
 
 declare const PEER_CHAT_TIMEOUT_MS = 120000;
 declare const PeerChatRequestSchema: z.ZodObject<{
@@ -2006,7 +2014,7 @@ declare const UploaderConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 type SessionImageUploaderConfig = z.input<typeof UploaderConfigSchema>;
 type Stage = "config" | "source" | "reserve" | "put" | "complete";
-type SessionImageUploadErrorCode = "IMAGE_CONFIG_INVALID" | "IMAGE_CONTENT_INVALID" | "IMAGE_CAPACITY_EXCEEDED" | "IMAGE_UPLOADER_CLOSED" | "IMAGE_ABORTED" | "IMAGE_TIMEOUT" | "IMAGE_NETWORK_ERROR" | "IMAGE_HTTP_ERROR" | "IMAGE_RESPONSE_INVALID" | "IMAGE_RESPONSE_TOO_LARGE" | "IMAGE_UPLOAD_TARGET_INVALID" | "IMAGE_UPLOAD_EXPIRED" | "IMAGE_COMMIT_MISMATCH" | "IMAGE_COMPLETION_FAILED" | "IMAGE_ACCESS_REVOKED";
+type SessionImageUploadErrorCode = "IMAGE_CONFIG_INVALID" | "IMAGE_CONTENT_INVALID" | "IMAGE_CAPACITY_EXCEEDED" | "IMAGE_UPLOADER_CLOSED" | "IMAGE_ABORTED" | "IMAGE_TIMEOUT" | "IMAGE_NETWORK_ERROR" | "IMAGE_HTTP_ERROR" | "IMAGE_RESPONSE_INVALID" | "IMAGE_RESPONSE_TOO_LARGE" | "IMAGE_UPLOAD_TARGET_INVALID" | "IMAGE_UPLOAD_EXPIRED" | "IMAGE_COMMIT_MISMATCH" | "IMAGE_COMPLETION_FAILED" | "IMAGE_ACCESS_REVOKED" | "IMAGE_STORAGE_UNAVAILABLE";
 /** Safe to log: never retains a response body, URL, token, or raw transport/schema error. */
 declare class SessionImageUploadError extends Error {
     readonly code: SessionImageUploadErrorCode;

package/dist/index.js

@@ -4,12 +4,12 @@ import {
   PeerChatRequestSchema,
   PeerChatResultSchema,
   validateDataDirectory
-} from "./chunks/chunk-CVWUKZX7.js";
+} from "./chunks/chunk-QN3OD5UE.js";
 import {
   AgentSelectionSchema,
   assertSelectionSnapshotFits,
   supportsAgentSelection
-} from "./chunks/chunk-6RWWNR37.js";
+} from "./chunks/chunk-ASHXZ46V.js";
 import {
   ConversationNormalizer,
   LiveTimelineProjection,
@@ -31,16 +31,16 @@ import {
   resolveGitProjectIdentity,
   sessionRestoreFailure,
   validateOperationResponse
-} from "./chunks/chunk-ULJMR33R.js";
+} from "./chunks/chunk-SHOE7YAU.js";
 import {
   GROUP_CHAT_MAX_TURNS,
   GroupChatError
-} from "./chunks/chunk-Q3TQPONK.js";
+} from "./chunks/chunk-VDC4G7ZG.js";
 import {
   assistantPreview,
   isContentfulAssistant,
   userPreview
-} from "./chunks/chunk-D6HWUCVM.js";
+} from "./chunks/chunk-RBULXS7T.js";
 import {
   AgentModelListingError,
   AgentSessionRenameError,
@@ -50,7 +50,7 @@ import {
   UnsupportedAgentOperationError,
   captureResearchAccess,
   captureWorkbenchAccess
-} from "./chunks/chunk-AJ4YL22H.js";
+} from "./chunks/chunk-LQIW4ARE.js";
 import {
   A2aRelayRequestSchema,
   A2aRelayResponseSchema,
@@ -86,6 +86,7 @@ import {
   PC_PEER_CHAT_CAPABILITY,
   PROTOCOL_VERSION,
   PairingCreateResultSchema,
+  PairingStatusResultSchema,
   PeerDeliverySchema,
   PeerMessageSchema,
   PermissionRequestPayloadSchema,
@@ -226,7 +227,7 @@ import {
   sessionCommunicationError,
   sessionCommunicationOperationCapability,
   workbenchCapability
-} from "./chunks/chunk-OV77TRIH.js";
+} from "./chunks/chunk-QTBB2U7G.js";
 
 // src/initialize.ts
 import { createHash as createHash16 } from "node:crypto";
@@ -304,7 +305,7 @@ async function createCodingAgentAdapter(config, onDiagnostic, owner) {
   switch (engine.kind) {
     case "managed": {
       if (owner === void 0) throw new Error("Managed coding agents require the PC owner identity");
-      const { ManagedCodingAgentAdapter } = await import("./chunks/managed-agent-adapter-F7U26CH2.js");
+      const { ManagedCodingAgentAdapter } = await import("./chunks/managed-agent-adapter-LMHQX6IH.js");
       return new ManagedCodingAgentAdapter({
         dataDirectory: config.dataDirectory,
         owner,
@@ -343,7 +344,7 @@ async function createCodingAgentAdapter(config, onDiagnostic, owner) {
       });
     }
     case "copilot": {
-      const { GithubCopilotAdapter } = await import("./chunks/copilot-adapter-KH6NXHGK.js");
+      const { GithubCopilotAdapter } = await import("./chunks/copilot-adapter-A6QB4RD4.js");
       if (owner !== void 0) {
         return new GithubCopilotAdapter(void 0, void 0, void 0, {
           dataDirectory: config.dataDirectory,
@@ -363,13 +364,13 @@ async function createCodingAgentAdapter(config, onDiagnostic, owner) {
     }
     case "pi": {
       assertPiRuntimeSupported();
-      const { PiCodingAgentAdapter } = await import("./chunks/pi-adapter-G4GQ5ULV.js");
+      const { PiCodingAgentAdapter } = await import("./chunks/pi-adapter-NWQWUNXO.js");
       return new PiCodingAgentAdapter(
         engine.agentDirectory === void 0 ? {} : { agentDirectory: resolve(engine.agentDirectory) }
       );
     }
     case "acp": {
-      const { AcpCodingAgentAdapter } = await import("./chunks/acp-adapter-TVAW7EHK.js");
+      const { AcpCodingAgentAdapter } = await import("./chunks/acp-adapter-SPIMGGL2.js");
       return new AcpCodingAgentAdapter({
         command: engine.command,
         args: engine.args,
@@ -750,43 +751,47 @@ var DeviceIdentitySchema = z3.object({
 
 // src/pairing.ts
 var CachedPairingProvider = class {
+  constructor(requestPairing, minimumValidityMs = 15e3, requestStatus) {
+    this.requestStatus = requestStatus;
+    this.#requestPairing = requestPairing;
+    this.#minimumValidityMs = minimumValidityMs;
+  }
+  requestStatus;
   #requestPairing;
   #minimumValidityMs;
   #current;
   #pending;
-  #requestSequence = 0;
-  #committedSequence = 0;
-  constructor(requestPairing, minimumValidityMs = 15e3) {
-    this.#requestPairing = requestPairing;
-    this.#minimumValidityMs = minimumValidityMs;
-  }
   async getPairing(options = {}) {
     const force = options.force ?? false;
     if (this.#pending !== void 0) {
       return this.#pending;
     }
-    if (!force && this.#current !== void 0 && this.#current.expiresAt > Date.now() + this.#minimumValidityMs) {
-      return this.#current;
-    }
-    const sequence = ++this.#requestSequence;
-    const pending = this.#requestPairing().then((pairing) => {
-      if (pairing.expiresAt <= Date.now()) {
-        throw new Error("Relay returned an expired pairing ticket");
-      }
-      if (sequence >= this.#committedSequence) {
-        this.#committedSequence = sequence;
-        this.#current = pairing;
-      }
-      return pairing;
-    });
+    const pending = this.#getPairing(force);
     this.#pending = pending;
     try {
       return await pending;
     } finally {
-      if (this.#pending === pending) {
-        this.#pending = void 0;
-      }
+      if (this.#pending === pending) this.#pending = void 0;
+    }
+  }
+  async getPairingStatus(statusId) {
+    const state = await this.requestStatus?.(statusId) ?? "unavailable";
+    if (state !== "pending" && this.#current?.statusId === statusId) {
+      this.#current = void 0;
+    }
+    return state;
+  }
+  async #getPairing(force) {
+    const current = this.#current;
+    if (!force && current !== void 0 && current.expiresAt > Date.now() + this.#minimumValidityMs && (current.statusId === void 0 || this.requestStatus === void 0 || await this.getPairingStatus(current.statusId) === "pending")) {
+      return current;
+    }
+    const pairing = await this.#requestPairing();
+    if (pairing.expiresAt <= Date.now()) {
+      throw new Error("Relay returned an expired pairing ticket");
     }
+    this.#current = pairing;
+    return pairing;
   }
 };
 function buildPairingUri(relayUrl, code, machineId, contentKey) {
@@ -830,9 +835,26 @@ async function requestPairingUri(config, identity2, contentKey) {
       identity2.machineId,
       contentKey.encoded
     ),
-    expiresAt: result.expiresAt
+    expiresAt: result.expiresAt,
+    ...result.statusId === void 0 ? {} : { statusId: result.statusId }
   };
 }
+async function requestPairingStatus(config, identity2, statusId) {
+  const response = await fetch(`${config.relayUrl.replace(/\/+$/, "")}/auth/pairing/status`, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${config.relayToken}`,
+      "content-type": "application/json"
+    },
+    body: JSON.stringify({ userId: config.userId, machineId: identity2.machineId, statusId }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  const result = PairingStatusResultSchema.parse(await response.json());
+  if (!response.ok || !result.ok) {
+    throw new Error(result.ok ? `Relay pairing status failed with HTTP ${response.status}` : `${result.error.code}: ${result.error.message}`);
+  }
+  return result.state;
+}
 
 // src/pc-agent.ts
 import { AsyncLocalStorage as AsyncLocalStorage2 } from "node:async_hooks";
@@ -3663,6 +3685,9 @@ var SessionImageUploader = class {
       headers: { ...this.#headers(), "content-type": "application/json" },
       body: JSON.stringify(body)
     }, stage, signal, async (response, requestSignal) => {
+      if (stage === "reserve" && response.status === 404) {
+        throw new SessionImageUploadError("IMAGE_STORAGE_UNAVAILABLE", stage, response.status);
+      }
       if (response.status !== status) throw new SessionImageUploadError("IMAGE_HTTP_ERROR", stage, response.status);
       const contentLength = response.headers.get("content-length");
       assert(
@@ -10654,7 +10679,11 @@ async function initialize(options) {
     );
     const contentKey = await loadOrCreateContentKey(dataDirectory);
     const cipher = await createPersistentContentCipher(dataDirectory, contentKey);
-    const pairingProvider = new CachedPairingProvider(() => requestPairingUri(config, identity2, contentKey));
+    const pairingProvider = new CachedPairingProvider(
+      () => requestPairingUri(config, identity2, contentKey),
+      void 0,
+      (statusId) => requestPairingStatus(config, identity2, statusId)
+    );
     const sourceAdapter = adapter;
     const sourceMetadata = async (sessionId) => {
       const access2 = captureResearchAccess(sourceAdapter, sessionId);

package/dist/runtime.js

@@ -3,8 +3,8 @@ import {
   PEER_CHAT_TIMEOUT_MS,
   PeerChatRequestSchema,
   PeerChatResultSchema
-} from "./chunks/chunk-CVWUKZX7.js";
-import "./chunks/chunk-OV77TRIH.js";
+} from "./chunks/chunk-QN3OD5UE.js";
+import "./chunks/chunk-QTBB2U7G.js";
 export {
   DataDirectoryLease,
   PEER_CHAT_TIMEOUT_MS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentknight/sdk",
-  "version": "0.9.40",
+  "version": "0.9.42",
   "description": "AgentKnight runtime SDK for local and remote coding sessions",
   "license": "Apache-2.0",
   "type": "module",
@@ -49,8 +49,8 @@
     "esbuild": "0.28.2",
     "rollup": "4.63.1",
     "rollup-plugin-dts": "6.3.0",
-    "@agentknight/protocol": "0.1.0",
-    "@agentknight/shared": "0.1.0"
+    "@agentknight/shared": "0.1.0",
+    "@agentknight/protocol": "0.1.0"
   },
   "optionalDependencies": {
     "@earendil-works/pi-ai": "0.85.1",