@frockbot/plugin-fly-sprite 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frockbot/plugin-fly-sprite",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "private": false,
   "type": "module",
   "exports": {
@@ -25,16 +25,16 @@
   },
   "dependencies": {
     "@cordisjs/plugin-webui": "0.8.2",
-    "@frockbot/computer-core": "0.2.3",
-    "@frockbot/computer-host-protocol": "0.2.3",
-    "@frockbot/computer-host-runtime": "0.2.3",
-    "@frockbot/kernel-contracts": "0.2.3",
-    "@frockbot/plugin-computer": "0.2.3",
+    "@frockbot/computer-core": "0.2.4",
+    "@frockbot/computer-host-protocol": "0.2.4",
+    "@frockbot/computer-host-runtime": "0.2.4",
+    "@frockbot/kernel-contracts": "0.2.4",
+    "@frockbot/plugin-computer": "0.2.4",
     "cordis": "4.0.0-rc.8"
   },
   "devDependencies": {
-    "@frockbot/plugin-testkit": "0.2.3",
-    "@frockbot/workspace-store": "0.2.3",
+    "@frockbot/plugin-testkit": "0.2.4",
+    "@frockbot/workspace-store": "0.2.4",
     "@types/bun": "1.4.0",
     "@types/node": "26.2.0",
     "typescript": "5.9.3"

package/src/computer.test.ts

@@ -227,6 +227,30 @@ describe("Fly Sprite computer", () => {
     expect(connected?.message).toBeUndefined();
   });
 
+  test("reports provider-neutral connection boundaries around the host calls", async () => {
+    const host = fakeHost();
+    const provider = new FlySpriteComputerProvider(attach(host));
+    const computer = await provider.open(
+      { userId: "owner" },
+      { botId: "general" },
+      { providerId: "fly-sprite", generation: 1 },
+    );
+    const progress: string[] = [];
+
+    await computer.presence?.connect({
+      onProgress: (step) => {
+        progress.push(step.step);
+      },
+    });
+
+    expect(progress).toEqual([
+      "attaching",
+      "starting-desktop",
+      "minting-viewer",
+      "connecting",
+    ]);
+  });
+
   test("an unconfigured Computer refuses rather than pretending", async () => {
     const computer = new FlySpriteComputer({ spriteName: "frockbot-test" });
     expect(computer.configured).toBe(false);

package/src/computer.ts

@@ -2,6 +2,7 @@ import { createHash, randomUUID } from "node:crypto";
 import {
   ComputerError,
   decodeComputerDoctorReportV1,
+  type ComputerConnectionOptionsV1,
   type ComputerControlRequestV1,
   type ComputerDoctorReportV1,
   type ComputerOperationOptions,
@@ -329,7 +330,7 @@ export class FlySpriteAgentComputer {
     return this.computer.ensureAgent(this.layout, signal);
   }
 
-  connect(options?: ComputerOperationOptions): Promise<ComputerConnection> {
+  connect(options?: ComputerConnectionOptionsV1): Promise<ComputerConnection> {
     return this.computer.connectAgent(this.layout, options);
   }
 
@@ -581,7 +582,7 @@ export class FlySpriteComputer {
 
   connectAgent(
     layout: AgentLayout,
-    options?: ComputerOperationOptions,
+    options?: ComputerConnectionOptionsV1,
   ): Promise<ComputerConnection> {
     this.hostFor(layout);
     return this.openAgent(layout, options);
@@ -1208,7 +1209,7 @@ export class FlySpriteComputer {
    */
   private async openAgent(
     layout: AgentLayout,
-    options?: ComputerOperationOptions,
+    options?: ComputerConnectionOptionsV1,
   ): Promise<ComputerConnection> {
     const signal = options?.signal;
     const effectId = options?.effectId;
@@ -1238,6 +1239,39 @@ export class FlySpriteComputer {
     this.expectedSpriteName = opened.spriteName;
     this.generations.set(layout.key, opened.generation);
     if (opened.display) this.displays.set(layout.key, opened.display);
+    const updating =
+      opened.provisioning?.kind === "update" &&
+      opened.provisioning.status === "running";
+    if (updating && opened.provisioning) {
+      await options?.onProgress?.({
+        version: 1,
+        kind: "update",
+        step: opened.provisioning.phase,
+        label: opened.provisioning.label,
+        index: opened.provisioning.index,
+        total: opened.provisioning.total,
+      });
+    } else {
+      // `host.open` owns the wake, tenant attachment and declared desktop
+      // start. Keep the durable wake step active while that long call is in
+      // flight, then record both boundaries before moving to viewer minting.
+      await options?.onProgress?.({
+        version: 1,
+        kind: "connect",
+        step: "attaching",
+        label: "Attaching the Bot",
+        index: 2,
+        total: 5,
+      });
+      await options?.onProgress?.({
+        version: 1,
+        kind: "connect",
+        step: "starting-desktop",
+        label: "Starting the desktop",
+        index: 3,
+        total: 5,
+      });
+    }
     if (this.respectHumanControl) {
       await this.assertAgentControl(
         host,
@@ -1246,6 +1280,16 @@ export class FlySpriteComputer {
         effectId ? `${effectId}:assert-control` : undefined,
       );
     }
+    if (!updating) {
+      await options?.onProgress?.({
+        version: 1,
+        kind: "connect",
+        step: "minting-viewer",
+        label: "Minting the secure viewer",
+        index: 4,
+        total: 5,
+      });
+    }
     const viewer = await host.viewer("open", {
       signal,
       timeoutMs: TIMEOUTS.viewer,
@@ -1258,6 +1302,16 @@ export class FlySpriteComputer {
         true,
       );
     }
+    if (!updating) {
+      await options?.onProgress?.({
+        version: 1,
+        kind: "connect",
+        step: "connecting",
+        label: "Connecting to the desktop",
+        index: 5,
+        total: 5,
+      });
+    }
     return {
       botId: layout.identity.id,
       botKey: layout.key,