@agentknight/sdk 0.9.39 → 0.9.41

package/dist/index.js

@@ -4,12 +4,12 @@ import {
   PeerChatRequestSchema,
   PeerChatResultSchema,
   validateDataDirectory
-} from "./chunks/chunk-UE4QYZCG.js";
+} from "./chunks/chunk-QN3OD5UE.js";
 import {
   AgentSelectionSchema,
   assertSelectionSnapshotFits,
   supportsAgentSelection
-} from "./chunks/chunk-KPRPUIXR.js";
+} from "./chunks/chunk-ASHXZ46V.js";
 import {
   ConversationNormalizer,
   LiveTimelineProjection,
@@ -31,25 +31,26 @@ import {
   resolveGitProjectIdentity,
   sessionRestoreFailure,
   validateOperationResponse
-} from "./chunks/chunk-QGPX4UDW.js";
+} from "./chunks/chunk-SHOE7YAU.js";
 import {
   GROUP_CHAT_MAX_TURNS,
   GroupChatError
-} from "./chunks/chunk-VCNYBWYE.js";
+} from "./chunks/chunk-VDC4G7ZG.js";
 import {
   assistantPreview,
   isContentfulAssistant,
   userPreview
-} from "./chunks/chunk-N4MN54CD.js";
+} from "./chunks/chunk-RBULXS7T.js";
 import {
   AgentModelListingError,
   AgentSessionRenameError,
   SessionOperationError,
   SessionOperations,
+  TimelinePageBudgetError,
   UnsupportedAgentOperationError,
   captureResearchAccess,
   captureWorkbenchAccess
-} from "./chunks/chunk-BM6T2DLH.js";
+} from "./chunks/chunk-LQIW4ARE.js";
 import {
   A2aRelayRequestSchema,
   A2aRelayResponseSchema,
@@ -85,6 +86,7 @@ import {
   PC_PEER_CHAT_CAPABILITY,
   PROTOCOL_VERSION,
   PairingCreateResultSchema,
+  PairingStatusResultSchema,
   PeerDeliverySchema,
   PeerMessageSchema,
   PermissionRequestPayloadSchema,
@@ -95,6 +97,7 @@ import {
   SECURE_MESSAGE_MAX_CIPHERTEXT_LENGTH,
   SECURE_SOCKET_IO_NAMESPACE,
   SESSION_ASSISTANT_PREVIEW_CAPABILITY,
+  SESSION_AVATAR_PERSONA_CAPABILITY,
   SESSION_COMMUNICATION_CAPABILITY,
   SESSION_DELETE_CAPABILITY,
   SESSION_DIRECTORY_LIST_OPERATION,
@@ -124,6 +127,7 @@ import {
   SESSION_IMAGE_MAX_PIXELS,
   SESSION_LIST_UPDATES_CAPABILITY,
   SESSION_OPTIONS_PARTIAL_CAPABILITY,
+  SESSION_OPTIONS_PROGRESSIVE_CAPABILITY,
   SESSION_PROJECT_IDENTITY_OPERATION,
   SESSION_PROJECT_IDENTITY_VERSION,
   SESSION_PROMPT_SUBMISSION_TIME_CAPABILITY,
@@ -223,7 +227,7 @@ import {
   sessionCommunicationError,
   sessionCommunicationOperationCapability,
   workbenchCapability
-} from "./chunks/chunk-E3XCZWRK.js";
+} from "./chunks/chunk-QTBB2U7G.js";
 
 // src/initialize.ts
 import { createHash as createHash16 } from "node:crypto";
@@ -301,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-T3FVUJHA.js");
+      const { ManagedCodingAgentAdapter } = await import("./chunks/managed-agent-adapter-LMHQX6IH.js");
       return new ManagedCodingAgentAdapter({
         dataDirectory: config.dataDirectory,
         owner,
@@ -340,7 +344,7 @@ async function createCodingAgentAdapter(config, onDiagnostic, owner) {
       });
     }
     case "copilot": {
-      const { GithubCopilotAdapter } = await import("./chunks/copilot-adapter-N5B7BNWO.js");
+      const { GithubCopilotAdapter } = await import("./chunks/copilot-adapter-FY75OLIU.js");
       if (owner !== void 0) {
         return new GithubCopilotAdapter(void 0, void 0, void 0, {
           dataDirectory: config.dataDirectory,
@@ -360,13 +364,13 @@ async function createCodingAgentAdapter(config, onDiagnostic, owner) {
     }
     case "pi": {
       assertPiRuntimeSupported();
-      const { PiCodingAgentAdapter } = await import("./chunks/pi-adapter-PHEFFJVF.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-BWVM6WIF.js");
+      const { AcpCodingAgentAdapter } = await import("./chunks/acp-adapter-SPIMGGL2.js");
       return new AcpCodingAgentAdapter({
         command: engine.command,
         args: engine.args,
@@ -747,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) {
@@ -827,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";
@@ -2324,11 +2349,21 @@ function researchAwareCodingAgentAdapter(inner, research) {
     },
     readSessionTimelinePage: (id, options) => route(id, () => research.timeline(id, options), () => inner.readSessionTimelinePage(id, options)),
     watchSession: (id, watched) => route(id, () => research.watch(id, watched), () => inner.watchSession(id, watched)),
-    sendPrompt: (id, prompt, mode, attachments, persist, files, operationId) => route(id, () => {
+    sendPrompt: (id, prompt, mode, attachments, persist, files, operationId, avatarPersona) => route(id, () => {
+      if (avatarPersona !== void 0) return deny();
       if (attachments?.length || files?.length) return deny();
       if (operationId === void 0) throw new SessionOperationError("OPERATION_ID_REQUIRED", "A stable operation ID is required");
       return research.sendPrompt(id, prompt, mode, operationId);
-    }, () => inner.sendPrompt(id, prompt, mode, attachments, persist, files, operationId)),
+    }, () => inner.sendPrompt(
+      id,
+      prompt,
+      mode,
+      attachments,
+      persist,
+      files,
+      operationId,
+      ...avatarPersona === void 0 ? [] : [avatarPersona]
+    )),
     abortSession: (id) => route(id, () => research.abort(id), () => inner.abortSession(id)),
     getSessionConfiguration: (id) => route(id, () => research.configuration(id), () => inner.getSessionConfiguration(id)),
     getSessionCapabilities: (id) => id !== void 0 && owned(id) ? { agentModes: ["interactive"], supportsReasoningEffort: false, supportsFileAttachments: false, supportsPlanRead: false, agentName: "Side chat" } : inner.getSessionCapabilities?.(id) ?? inner,
@@ -2403,8 +2438,25 @@ function toErrorDetails(error) {
   };
 }
 
-// src/pc-agent.ts
+// src/service/transport/relay-socket.ts
 import { io } from "socket.io-client";
+function createRelaySocket(uri, options) {
+  const socket = io(uri, { ...options, autoConnect: false });
+  socket.on("connect_error", (error) => {
+    const manager = socket.io;
+    const transports = manager.opts.transports;
+    if (error.message !== "timeout" || manager.engine.readyState !== "opening" || !manager.opts.tryAllTransports || transports === void 0 || transports.length < 2 || !transports.every((transport) => typeof transport === "string")) return;
+    const failedTransport = manager.engine.transport.name;
+    const failedIndex = transports.findIndex((transport) => transport === failedTransport);
+    if (failedIndex < 0) return;
+    manager.opts.transports = [
+      ...transports.slice(failedIndex + 1),
+      ...transports.slice(0, failedIndex + 1)
+    ];
+  });
+  if (options.autoConnect !== false) socket.connect();
+  return socket;
+}
 
 // src/service/requests/session-communication.ts
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -2793,7 +2845,7 @@ var Work = class {
               GIT_DIR: join6(cwd, "no-repository"),
               GIT_CONFIG_NOSYSTEM: "1",
               GIT_ATTR_NOSYSTEM: "1",
-              GIT_CONFIG_GLOBAL: process.platform === "win32" ? "NUL" : "/dev/null"
+              GIT_CONFIG_GLOBAL: join6(cwd, "gitconfig")
             } : {}
           }
         }, (error, output2, stderr) => {
@@ -3122,6 +3174,7 @@ async function patch(context, change, work, scratchDirectory) {
       await writeFile2(file, content, { flag: "wx", mode: 384 });
       if (process.platform !== "win32") await chmod(file, mode === "100755" ? 448 : 384);
     }
+    await writeFile2(join6(scratch, "gitconfig"), "", { flag: "wx", mode: 384 });
     text = decode(await work.git(scratch, [
       "-c",
       "core.quotePath=false",
@@ -3302,10 +3355,10 @@ var TimelineImageCache = class {
   get bytes() {
     return this.#bytes;
   }
-  referenceItem(sessionId, item) {
+  referenceItem = (sessionId, item) => {
     if (!("attachments" in item) || item.attachments === void 0) return item;
     return { ...item, attachments: item.attachments.map((attachment) => this.#reference(sessionId, attachment)) };
-  }
+  };
   read(sessionId, request) {
     const key = JSON.stringify([sessionId, request.sha256]);
     const asset = this.#assets.get(key);
@@ -3632,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(
@@ -4576,14 +4632,14 @@ var SessionOptionsHandler = class {
       ]));
       if (modelResult.status === "fulfilled" && modelResult.value.length > 0) availableModels = modelResult.value;
       if (configurationResult.status === "fulfilled") configuration = configurationResult.value;
-      for (const [stage, result] of [
+      for (const [stage, result2] of [
         ["configuration", configurationResult],
         ["models", modelResult],
         ["workspaces", workspaceResult]
       ]) {
-        if (result.status === "rejected" && isSessionRestoreFailure(result.reason)) {
+        if (result2.status === "rejected" && isSessionRestoreFailure(result2.reason)) {
           failureStage = stage;
-          throw result.reason;
+          throw result2.reason;
         }
       }
       if (configurationResult.status === "rejected") {
@@ -4605,7 +4661,8 @@ var SessionOptionsHandler = class {
         failureStage = "models";
         throw modelFailure ?? new Error("No coding-agent models are available. Select an authenticated coding agent on the PC.");
       }
-      const environment2 = await sessionEnvironment;
+      const progressive = request.sessionId !== void 0 && request.capabilities?.includes(SESSION_OPTIONS_PROGRESSIVE_CAPABILITY) === true;
+      const environment2 = progressive ? void 0 : await sessionEnvironment;
       const worktreeCreationSupported = request.sessionId === void 0 && request.capabilities?.includes(SESSION_WORKTREE_CREATION_CAPABILITY) === true;
       let worktreeChoices;
       if (worktreeCreationSupported && request.workspaceId !== void 0) {
@@ -4617,7 +4674,7 @@ var SessionOptionsHandler = class {
       }
       const capabilities = adapter.getSessionCapabilities?.(request.sessionId) ?? adapter;
       this.#errors.recovered(errorKey);
-      emit("session.options.result", {
+      const result = {
         ok: true,
         requestId: request.requestId,
         machineId,
@@ -4639,7 +4696,21 @@ var SessionOptionsHandler = class {
         ...environment2 === void 0 ? {} : { environment: environment2 },
         agentName: "agentName" in capabilities && typeof capabilities.agentName === "string" ? capabilities.agentName : codingAgentPresentation(adapter.agentId).name,
         ...current?.configOptions === void 0 ? {} : { configOptions: current.configOptions }
+      };
+      if (!scope.isCurrent()) return;
+      emit("session.options.result", {
+        ...result,
+        ...progressive ? { environmentPending: true } : {}
       });
+      if (progressive) {
+        const environment3 = await sessionEnvironment;
+        if (!scope.isCurrent()) return;
+        adapter.getSessionCapabilities?.(request.sessionId);
+        emit("session.options.result", {
+          ...result,
+          ...environment3 === void 0 ? {} : { environment: environment3 }
+        });
+      }
       const plan = await sessionPlan;
       if (plan !== void 0 && scope.isCurrent()) {
         emit("conversation.item.upsert", plan);
@@ -5023,11 +5094,15 @@ var SessionCommandsHandler = class {
 // src/service/requests/session-prompt.ts
 import { createHash as createHash10 } from "node:crypto";
 function promptOperationFingerprint(request) {
-  return createHash10("sha256").update(request.sessionId).update("\0").update(request.mode).update("\0").update(request.prompt).update("\0").update(request.attachments?.map((attachment) => attachment.sha256).join(",") ?? "").update("\0").update(JSON.stringify(request.fileAttachments?.map(({ name, mimeType, sha256 }) => ({
+  const fingerprint = createHash10("sha256").update(request.sessionId).update("\0").update(request.mode).update("\0").update(request.prompt).update("\0").update(request.attachments?.map((attachment) => attachment.sha256).join(",") ?? "").update("\0").update(JSON.stringify(request.fileAttachments?.map(({ name, mimeType, sha256 }) => ({
     name,
     mimeType,
     sha256
-  })) ?? [])).digest("base64url");
+  })) ?? []));
+  if (request.avatarPersona !== void 0) {
+    fingerprint.update("\0").update(JSON.stringify(request.avatarPersona));
+  }
+  return fingerprint.digest("base64url");
 }
 var SessionPromptHandler = class {
   constructor(options) {
@@ -5049,6 +5124,9 @@ var SessionPromptHandler = class {
       if (adapter.isSessionVisible?.(request.sessionId) === false) {
         throw new Error("This session's coding agent is not shared or is unavailable on the PC");
       }
+      if (request.avatarPersona !== void 0 && adapter.agentId !== "copilot" && adapter.agentId !== "managed") {
+        throw new Error("Avatar personas require Copilot; nothing was submitted");
+      }
       const accepted = await diagnostics.run(() => this.#operations.run({
         operationId: request.operationId,
         fingerprint: promptOperationFingerprint(request),
@@ -5067,7 +5145,8 @@ var SessionPromptHandler = class {
           request.attachments,
           this.options.supportsPersistentInteractions(context.clientId),
           request.fileAttachments,
-          request.operationId
+          request.operationId,
+          ...request.avatarPersona === void 0 ? [] : [request.avatarPersona]
         )
       }));
       emit("session.prompt.result", {
@@ -5186,63 +5265,95 @@ var SessionTimelinePageHandler = class {
       if (request.metadataOnly === true && request.assistantPreview !== true && adapter.supportsSessionListUpdates !== true) {
         throw new Error("Passive session metadata is not supported by this runtime");
       }
-      const page = await diagnostics.run(() => measureOperationPhase("read", () => adapter.readSessionTimelinePage(
-        request.sessionId,
-        request.metadataOnly === true ? {
-          pageSize: request.pageSize,
-          metadataOnly: true,
-          ...request.assistantPreview === true ? { assistantPreview: true } : {},
-          ...request.cursor === void 0 ? {} : { cursor: request.cursor }
-        } : request.cursor === void 0 ? { pageSize: request.pageSize } : { cursor: request.cursor, pageSize: request.pageSize }
-      )));
-      if (diagnostics.activeMs >= 1e3) {
-        logger.info({
-          ...diagnosticRequest(request),
-          ...diagnostics.details(),
-          metadataOnly: request.metadataOnly === true
-        }, "session.timeline.page.read-slow");
-      }
-      if (!publications.isCurrent(request.sessionId, publication)) throw new SessionNotSharedError();
-      const latestAssistant = request.assistantPreview === true ? [...page.items].reverse().find(isContentfulAssistant) : void 0;
-      const preview = latestAssistant === void 0 ? void 0 : assistantPreview(
-        latestAssistant,
-        (item) => this.options.referenceItem(request.sessionId, item)
-      );
-      const latestUser = request.assistantPreview === true ? [...page.items].reverse().find((item) => item.kind === "human-message" && item.actor === "human") : void 0;
-      const humanPreview = latestUser === void 0 ? void 0 : userPreview(latestUser);
-      const responsePage = {
-        ...page,
-        ...preview === void 0 ? {} : { assistantPreview: preview },
-        ...humanPreview === void 0 ? {} : { userPreview: humanPreview },
-        ...request.assistantPreview === true ? { previewsComplete: !page.hasMore } : {},
-        items: request.metadataOnly === true && request.assistantPreview === true ? page.items.map((item) => item.kind === "assistant-message" || item.kind === "human-message" ? { ...item, content: "", attachments: [] } : item) : page.items
-      };
-      const result = {
-        ok: true,
-        requestId: request.requestId,
-        machineId,
-        sessionId: request.sessionId,
-        page: request.imageReferences === true && config.timelineIncrementalEnabled !== false && this.options.imageReferencesEnabled() ? { ...responsePage, items: responsePage.items.map((item) => this.options.referenceItem(request.sessionId, item)) } : responsePage
-      };
-      logger.debug({
-        requestId: request.requestId,
-        sessionId: request.sessionId,
-        itemCount: page.items.length
-      }, "session.timeline.page.ready");
-      phase = "encode";
-      const { message, metrics } = await this.options.encoder.seal(result, request, {
-        enabled: config.timelineCompressionEnabled === true,
-        ...scope.clientId === void 0 ? {} : { recipientClientId: scope.clientId },
-        ...config.secureMessagePacketBudget === void 0 ? {} : { packetBudget: config.secureMessagePacketBudget }
-      });
-      if (!scope.isCurrent()) return;
-      if (!publications.isCurrent(request.sessionId, publication)) throw new SessionNotSharedError();
-      phase = "emit";
-      this.options.sendSealed(message);
-      this.options.trafficMetrics.record(message, metrics.plaintextBytes, metrics.sealDurationMs);
-      this.#errors.recovered(errorKey);
-      const timingLevel = metrics.encodeDurationMs + metrics.sealDurationMs >= 1e3 ? "info" : "debug";
-      logger[timingLevel](metrics, "transport.timeline.encoding");
+      const references = request.imageReferences === true && config.timelineIncrementalEnabled !== false && this.options.imageReferencesEnabled();
+      let pageSize = request.pageSize;
+      while (true) {
+        let itemCount;
+        try {
+          phase = "read";
+          const page = await diagnostics.run(() => measureOperationPhase("read", () => adapter.readSessionTimelinePage(
+            request.sessionId,
+            {
+              pageSize,
+              ...request.cursor === void 0 ? {} : { cursor: request.cursor },
+              ...request.metadataOnly === true ? {
+                metadataOnly: true,
+                ...request.assistantPreview === true ? { assistantPreview: true } : {}
+              } : {
+                ...references || request.cursor !== void 0 || pageSize !== request.pageSize ? { readOnly: true } : {},
+                ...references ? {
+                  imageProjection: { sessionId: request.sessionId, referenceItem: this.options.referenceItem }
+                } : {}
+              }
+            }
+          )));
+          itemCount = page.items.length;
+          if (diagnostics.activeMs >= 1e3) {
+            logger.info({
+              ...diagnosticRequest(request),
+              ...diagnostics.details(),
+              metadataOnly: request.metadataOnly === true
+            }, "session.timeline.page.read-slow");
+          }
+          if (!publications.isCurrent(request.sessionId, publication)) throw new SessionNotSharedError();
+          const latestAssistant = request.assistantPreview === true ? [...page.items].reverse().find(isContentfulAssistant) : void 0;
+          const preview = latestAssistant === void 0 ? void 0 : assistantPreview(
+            latestAssistant,
+            (item) => this.options.referenceItem(request.sessionId, item)
+          );
+          const latestUser = request.assistantPreview === true ? [...page.items].reverse().find((item) => item.kind === "human-message" && item.actor === "human") : void 0;
+          const humanPreview = latestUser === void 0 ? void 0 : userPreview(latestUser);
+          const responsePage = {
+            ...page,
+            ...preview === void 0 ? {} : { assistantPreview: preview },
+            ...humanPreview === void 0 ? {} : { userPreview: humanPreview },
+            ...request.assistantPreview === true ? { previewsComplete: !page.hasMore } : {},
+            items: request.metadataOnly === true && request.assistantPreview === true ? page.items.map((item) => {
+              if (item.kind === "assistant-message" || item.kind === "human-message") {
+                return { ...item, content: "", attachments: [] };
+              }
+              return isContentfulAssistant(item) ? { ...item, content: "" } : item;
+            }) : page.items
+          };
+          const result = {
+            ok: true,
+            requestId: request.requestId,
+            machineId,
+            sessionId: request.sessionId,
+            page: references ? { ...responsePage, items: responsePage.items.map((item) => this.options.referenceItem(request.sessionId, item)) } : responsePage
+          };
+          logger.debug({
+            requestId: request.requestId,
+            sessionId: request.sessionId,
+            itemCount: page.items.length
+          }, "session.timeline.page.ready");
+          phase = "encode";
+          const { message, metrics } = await this.options.encoder.seal(result, request, {
+            enabled: config.timelineCompressionEnabled === true,
+            ...scope.clientId === void 0 ? {} : { recipientClientId: scope.clientId },
+            ...config.secureMessagePacketBudget === void 0 ? {} : { packetBudget: config.secureMessagePacketBudget }
+          });
+          if (!scope.isCurrent()) return;
+          if (!publications.isCurrent(request.sessionId, publication)) throw new SessionNotSharedError();
+          phase = "emit";
+          this.options.sendSealed(message);
+          this.options.trafficMetrics.record(message, metrics.plaintextBytes, metrics.sealDurationMs);
+          this.#errors.recovered(errorKey);
+          const timingLevel = metrics.encodeDurationMs + metrics.sealDurationMs >= 1e3 ? "info" : "debug";
+          logger[timingLevel](metrics, "transport.timeline.encoding");
+          return;
+        } catch (error) {
+          if (!scope.isCurrent()) return;
+          if (!publications.isCurrent(request.sessionId, publication)) throw new SessionNotSharedError();
+          if (phase === "emit" || request.metadataOnly === true || request.assistantPreview === true || pageSize <= 25 || !(error instanceof TimelinePageBudgetError || error instanceof SecureMessageBudgetError) || itemCount !== void 0 && itemCount <= 1) throw error;
+          const nextPageSize = Math.max(25, Math.floor(pageSize / 2));
+          logger.info(
+            { ...diagnosticRequest(request), pageSize, nextPageSize, phase },
+            "session.timeline.page.resized"
+          );
+          pageSize = nextPageSize;
+        }
+      }
     } catch (error) {
       if (!scope.isCurrent()) return;
       this.#errors.failure(errorKey, error, {
@@ -5256,7 +5367,7 @@ var SessionTimelinePageHandler = class {
         machineId,
         sessionId: request.sessionId,
         error: sessionRestoreFailure(error) ?? {
-          code: error instanceof SecureMessageBudgetError ? "TRANSPORT_BUDGET_EXCEEDED" : operationErrorCode(adapter.agentId, "TIMELINE_PAGE", error),
+          code: error instanceof SecureMessageBudgetError || error instanceof TimelinePageBudgetError ? "TRANSPORT_BUDGET_EXCEEDED" : operationErrorCode(adapter.agentId, "TIMELINE_PAGE", error),
           message: toErrorDetails(error).message
         }
       });
@@ -7786,7 +7897,7 @@ var INVENTORY_REFRESH_DEBOUNCE_MS = 100;
 var SESSION_LIST_REFRESH_RETRIES = 2;
 var TRAFFIC_METRICS_INTERVAL_MS = 6e4;
 var PcAgent = class {
-  constructor(config, identity2, appVersion, adapter, logger, pairingProvider, contentCipher, research, createSocket = (uri, options) => io(uri, options), onPairing) {
+  constructor(config, identity2, appVersion, adapter, logger, pairingProvider, contentCipher, research, createSocket = createRelaySocket, onPairing) {
     this.config = config;
     this.identity = identity2;
     this.appVersion = appVersion;
@@ -7832,7 +7943,10 @@ var PcAgent = class {
       stopSynchronizing: (clientId, sessionId) => this.#conversationAudience.stopSynchronizing(clientId, sessionId)
     });
     this.#timelineIncremental = new TimelineIncrementalTransport({
-      readHead: (sessionId) => this.adapter.readSessionTimelinePage(sessionId, { pageSize: 100 })
+      readHead: (sessionId) => this.adapter.readSessionTimelinePage(sessionId, {
+        pageSize: 100,
+        imageProjection: { sessionId, referenceItem: this.#timelineIncremental.images.referenceItem }
+      })
     });
     const imageSettings = config.sessionImages === void 0 ? void 0 : SessionImagesConfigSchema.parse(config.sessionImages);
     this.#imageBlob = imageSettings === void 0 ? void 0 : new TimelineImageBlobPublisher(this.#timelineIncremental.images, new SessionImageUploader({
@@ -7902,7 +8016,7 @@ var PcAgent = class {
       trafficMetrics: this.#trafficMetrics,
       sendSealed: (message) => this.#socket.emit("secure.message", message),
       imageReferencesEnabled: () => this.#communicationNegotiated && this.#conversationAudience.confirmed,
-      referenceItem: (sessionId, item) => this.#timelineIncremental.images.referenceItem(sessionId, item)
+      referenceItem: this.#timelineIncremental.images.referenceItem
     });
     this.#secureRequestRouter = createPcSecureRequestRouter({
       configuredMachineId: identity2.machineId,
@@ -8828,6 +8942,7 @@ var PcAgent = class {
   }
   #machineCapabilities() {
     return [
+      ...this.adapter.agentId === "copilot" || this.adapter.agentId === "managed" ? [SESSION_AVATAR_PERSONA_CAPABILITY] : [],
       SESSION_COMMUNICATION_CAPABILITY,
       ...this.#peerChatEnabled && this.adapter.runPeerTurn !== void 0 ? [PC_PEER_CHAT_CAPABILITY] : [],
       ...this.adapter.runPeerTurn !== void 0 ? [PC_A2A_CAPABILITY] : [],
@@ -10564,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);
@@ -10680,6 +10799,7 @@ export {
   SessionImageUploadError,
   SessionImageUploader,
   SessionImagesConfigSchema,
+  TimelinePageBudgetError,
   assertPiRuntimeSupported,
   buildPairingUri,
   codingAgentPresentation,

package/dist/runtime.js

@@ -3,8 +3,8 @@ import {
   PEER_CHAT_TIMEOUT_MS,
   PeerChatRequestSchema,
   PeerChatResultSchema
-} from "./chunks/chunk-UE4QYZCG.js";
-import "./chunks/chunk-E3XCZWRK.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.39",
+  "version": "0.9.41",
   "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/shared": "0.1.0",
-    "@agentknight/protocol": "0.1.0"
+    "@agentknight/protocol": "0.1.0",
+    "@agentknight/shared": "0.1.0"
   },
   "optionalDependencies": {
     "@earendil-works/pi-ai": "0.85.1",