opensteer 0.8.15 → 0.8.17

package/dist/index.cjs

@@ -2428,6 +2428,20 @@ var opensteerNetworkRedirectHopSchema = objectSchema(
     required: ["method", "url"]
   }
 );
+var opensteerReplayAttemptSchema = objectSchema(
+  {
+    transport: transportKindSchema,
+    status: integerSchema({ minimum: 100, maximum: 599 }),
+    ok: { type: "boolean" },
+    durationMs: integerSchema({ minimum: 0 }),
+    note: stringSchema(),
+    error: stringSchema()
+  },
+  {
+    title: "OpensteerReplayAttempt",
+    required: ["transport", "ok", "durationMs"]
+  }
+);
 var opensteerNetworkDetailOutputSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
@@ -2451,28 +2465,24 @@ var opensteerNetworkDetailOutputSchema = objectSchema(
       }
     ),
     redirectChain: arraySchema(opensteerNetworkRedirectHopSchema),
-    notes: arraySchema(stringSchema())
+    notes: arraySchema(stringSchema()),
+    transportProbe: objectSchema(
+      {
+        recommended: transportKindSchema,
+        attempts: arraySchema(opensteerReplayAttemptSchema)
+      },
+      {
+        title: "OpensteerTransportProbeResult",
+        required: ["attempts"]
+      }
+    )
   },
   {
     title: "OpensteerNetworkDetailOutput",
     required: ["recordId", "summary", "requestHeaders", "responseHeaders"]
   }
 );
-var opensteerReplayAttemptSchema = objectSchema(
-  {
-    transport: transportKindSchema,
-    status: integerSchema({ minimum: 100, maximum: 599 }),
-    ok: { type: "boolean" },
-    durationMs: integerSchema({ minimum: 0 }),
-    note: stringSchema(),
-    error: stringSchema()
-  },
-  {
-    title: "OpensteerReplayAttempt",
-    required: ["transport", "ok", "durationMs"]
-  }
-);
-var opensteerNetworkReplayInputSchema = objectSchema(
+objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
     pageRef: pageRefSchema,
@@ -2486,7 +2496,6 @@ var opensteerNetworkReplayInputSchema = objectSchema(
     required: ["recordId"]
   }
 );
-var opensteerNetworkReplayOutputSchema;
 var opensteerSessionFetchTransportSchema = enumSchema(
   ["auto", "direct", "matched-tls", "page"],
   {
@@ -2828,7 +2837,7 @@ var opensteerRequestResponseResultSchema = objectSchema(
     required: ["url", "status", "statusText", "headers", "redirected"]
   }
 );
-opensteerNetworkReplayOutputSchema = objectSchema(
+objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
     transport: transportKindSchema,
@@ -5808,7 +5817,6 @@ var opensteerExposedSemanticOperationNames = [
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -5845,7 +5853,6 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -6283,9 +6290,12 @@ var opensteerNetworkDetailInputSchema = objectSchema(
     required: ["recordId"]
   }
 );
-var opensteerComputerMouseButtonSchema = enumSchema(["left", "middle", "right"], {
-  title: "OpensteerComputerMouseButton"
-});
+var opensteerComputerMouseButtonSchema = enumSchema(
+  ["left", "middle", "right"],
+  {
+    title: "OpensteerComputerMouseButton"
+  }
+);
 var opensteerComputerKeyModifierSchema = enumSchema(
   ["Shift", "Control", "Alt", "Meta"],
   {
@@ -6362,10 +6372,7 @@ var opensteerDomExtractInputSchema = defineSchema({
       title: "OpensteerDomExtractInput"
     }
   ),
-  anyOf: [
-    defineSchema({ required: ["persist"] }),
-    defineSchema({ required: ["schema"] })
-  ]
+  anyOf: [defineSchema({ required: ["persist"] }), defineSchema({ required: ["schema"] })]
 });
 var jsonValueSchema3 = recordSchema({}, { title: "JsonValueRecord" });
 var opensteerDomExtractOutputSchema = objectSchema(
@@ -6745,13 +6752,6 @@ var opensteerSemanticOperationSpecificationsBase = [
     outputSchema: opensteerNetworkDetailOutputSchema,
     requiredCapabilities: ["inspect.network", "inspect.networkBodies"]
   }),
-  defineSemanticOperationSpec({
-    name: "network.replay",
-    description: "Replay a captured request through the transport ladder and report the transport that worked.",
-    inputSchema: opensteerNetworkReplayInputSchema,
-    outputSchema: opensteerNetworkReplayOutputSchema,
-    requiredCapabilities: ["inspect.network", "inspect.cookies", "pages.manage"]
-  }),
   defineSemanticOperationSpec({
     name: "interaction.capture",
     description: "Capture a guarded interaction window, including event properties, state changes, and downstream network.",
@@ -16481,12 +16481,7 @@ var BRAND_KEYCHAIN_SERVICE = {
 async function resolveKeychainPassword(brandId) {
   const service = BRAND_KEYCHAIN_SERVICE[brandId];
   try {
-    const { stdout } = await execFile2("security", [
-      "find-generic-password",
-      "-s",
-      service,
-      "-w"
-    ]);
+    const { stdout } = await execFile2("security", ["find-generic-password", "-s", service, "-w"]);
     return stdout.trim();
   } catch {
     throw new Error(
@@ -17034,7 +17029,7 @@ function resolveCloudConfig(input = {}) {
 
 // ../runtime-core/package.json
 var package_default = {
-  version: "0.1.6"};
+  version: "0.1.7"};
 
 // ../runtime-core/src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -21782,7 +21777,12 @@ var OpensteerSessionRuntime = class {
             includeBodies: true,
             redactSecretHeaders: false
           });
-          return this.buildNetworkDetail(record, timeout);
+          const detail = await this.buildNetworkDetail(record, timeout);
+          if (input.probe !== true) {
+            return detail;
+          }
+          const transportProbe = await this.probeTransportsForRecord(record, timeout);
+          return transportProbe === void 0 ? detail : { ...detail, transportProbe };
         },
         options
       );
@@ -21817,54 +21817,6 @@ var OpensteerSessionRuntime = class {
       throw error;
     }
   }
-  async replayNetwork(input, options = {}) {
-    const startedAt = Date.now();
-    try {
-      const output = await this.runWithOperationTimeout(
-        "network.replay",
-        async (timeout) => {
-          const source = await this.resolveNetworkRecordByRecordId(input.recordId, timeout, {
-            includeBodies: true,
-            redactSecretHeaders: false
-          });
-          const replayRequest = buildReplayTransportRequest(source, input);
-          return this.executeNetworkReplay(source, replayRequest, timeout, {
-            ...input.pageRef === void 0 ? {} : { pageRef: input.pageRef }
-          });
-        },
-        options
-      );
-      await this.appendTrace({
-        operation: "network.replay",
-        startedAt,
-        completedAt: Date.now(),
-        outcome: "ok",
-        data: {
-          recordId: input.recordId,
-          transport: output.transport,
-          attempts: output.attempts.length
-        },
-        context: buildRuntimeTraceContext({
-          sessionRef: this.sessionRef,
-          pageRef: this.pageRef
-        })
-      });
-      return output;
-    } catch (error) {
-      await this.appendTrace({
-        operation: "network.replay",
-        startedAt,
-        completedAt: Date.now(),
-        outcome: "error",
-        error,
-        context: buildRuntimeTraceContext({
-          sessionRef: this.sessionRef,
-          pageRef: this.pageRef
-        })
-      });
-      throw error;
-    }
-  }
   async captureScripts(input = {}, options = {}) {
     assertValidSemanticOperationInput("scripts.capture", input);
     const pageRef = input.pageRef ?? await this.ensurePageRef();
@@ -22460,7 +22412,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
-          transport: output.transport,
+          ...output.transport === void 0 ? {} : { transport: output.transport },
           attempts: output.attempts.length,
           ...output.response === void 0 ? {} : { status: output.response.status },
           url: input.url
@@ -23265,6 +23217,42 @@ var OpensteerSessionRuntime = class {
       ...notes.length === 0 ? {} : { notes }
     };
   }
+  async probeTransportsForRecord(record, timeout) {
+    if (record.record.status === void 0) {
+      return void 0;
+    }
+    const request = buildReplayTransportRequest(record, { recordId: record.recordId });
+    const fingerprint = buildCapturedRecordSuccessFingerprint(record);
+    const attempts = [];
+    let recommended;
+    for (const transport of REPLAY_TRANSPORT_LADDER) {
+      const attemptStartedAt = Date.now();
+      try {
+        const output = await this.executeReplayTransportAttempt(transport, request, timeout);
+        const ok = matchesSuccessFingerprintFromProtocolResponse(output.response, fingerprint);
+        attempts.push({
+          transport,
+          status: output.response.status,
+          ok,
+          durationMs: Date.now() - attemptStartedAt
+        });
+        if (ok && recommended === void 0) {
+          recommended = transport;
+        }
+      } catch (error) {
+        attempts.push({
+          transport,
+          ok: false,
+          durationMs: Date.now() - attemptStartedAt,
+          error: normalizeRuntimeErrorMessage(error)
+        });
+      }
+    }
+    return {
+      ...recommended === void 0 ? {} : { recommended },
+      attempts
+    };
+  }
   async buildRedirectChain(record, timeout) {
     if (record.record.redirectFromRequestId === void 0 && record.record.redirectToRequestId === void 0) {
       return {};
@@ -23383,57 +23371,6 @@ var OpensteerSessionRuntime = class {
       })
     };
   }
-  async executeNetworkReplay(source, request, timeout, options) {
-    const fingerprint = buildCapturedRecordSuccessFingerprint(source);
-    const attempts = [];
-    let lastOutput;
-    for (const transport of REPLAY_TRANSPORT_LADDER) {
-      const attemptStartedAt = Date.now();
-      try {
-        const output = await this.executeReplayTransportAttempt(
-          transport,
-          request,
-          timeout,
-          options.pageRef
-        );
-        lastOutput = output;
-        const ok = matchesSuccessFingerprintFromProtocolResponse(output.response, fingerprint);
-        attempts.push({
-          transport,
-          status: output.response.status,
-          ok,
-          durationMs: Date.now() - attemptStartedAt
-        });
-        if (ok) {
-          const fallbackNote = attempts.length > 1 ? buildReplayFallbackNote(attempts, transport) : void 0;
-          const previewData2 = toStructuredPreviewData(output.data);
-          return {
-            recordId: source.recordId,
-            transport,
-            attempts,
-            response: output.response,
-            ...previewData2 === void 0 ? {} : { data: previewData2 },
-            ...fallbackNote === void 0 ? {} : { note: fallbackNote }
-          };
-        }
-      } catch (error) {
-        attempts.push({
-          transport,
-          ok: false,
-          durationMs: Date.now() - attemptStartedAt,
-          error: normalizeRuntimeErrorMessage(error)
-        });
-      }
-    }
-    const previewData = toStructuredPreviewData(lastOutput?.data);
-    return {
-      recordId: source.recordId,
-      attempts,
-      ...lastOutput?.response === void 0 ? {} : { response: lastOutput.response },
-      ...previewData === void 0 ? {} : { data: previewData },
-      note: "all replay transports failed to reproduce the captured response"
-    };
-  }
   async executeSessionFetch(request, input, timeout) {
     const attempts = [];
     let lastOutput;
@@ -26036,11 +25973,6 @@ async function dispatchSemanticOperation(runtime, operation, input, options = {}
         input,
         options
       );
-    case "network.replay":
-      return runtime.replayNetwork(
-        input,
-        options
-      );
     case "interaction.capture":
       return runtime.captureInteraction(
         input,
@@ -26736,10 +26668,6 @@ var CloudSessionProxy = class {
     await this.ensureSession();
     return this.requireClient().invoke("network.detail", input);
   }
-  async replayNetwork(input) {
-    await this.ensureSession();
-    return this.requireClient().invoke("network.replay", input);
-  }
   async captureInteraction(input) {
     await this.ensureSession();
     return this.requireClient().invoke("interaction.capture", input);
@@ -27259,11 +27187,7 @@ var Opensteer = class {
     };
     this.network = {
       query: (input = {}) => this.queryNetwork(input),
-      detail: (recordId) => this.runtime.getNetworkDetail({ recordId }),
-      replay: (recordId, overrides = {}) => this.runtime.replayNetwork({
-        recordId,
-        ...overrides
-      })
+      detail: (recordId, options2) => this.runtime.getNetworkDetail({ recordId, ...options2 })
     };
   }
   async open(input = {}) {
@@ -27410,10 +27334,8 @@ var Opensteer = class {
     return this.runtime.getBrowserState(domain === void 0 ? {} : { domain });
   }
   async fetch(url, options = {}) {
-    const result = await this.runtime.fetch({
-      url,
-      ...options
-    });
+    const input = buildFetchInput(url, options);
+    const result = await this.runtime.fetch(input);
     if (result.response === void 0) {
       throw new Error(result.note ?? `session.fetch did not produce a response for ${url}`);
     }
@@ -27503,6 +27425,25 @@ function pickStorageDomainSnapshot(snapshot, domain) {
   }
   return snapshot.domains.find((entry) => entry.domain === domain);
 }
+function buildFetchInput(url, options) {
+  return {
+    url,
+    ...options.method !== void 0 && { method: options.method },
+    ...options.headers !== void 0 && { headers: options.headers },
+    ...options.query !== void 0 && { query: options.query },
+    ...options.transport !== void 0 && { transport: options.transport },
+    ...options.cookies !== void 0 && { cookies: options.cookies },
+    ...options.followRedirects !== void 0 && { followRedirects: options.followRedirects },
+    ...options.body !== void 0 && { body: toRuntimeBody(options.body) }
+  };
+}
+function toRuntimeBody(body) {
+  try {
+    return { json: JSON.parse(body) };
+  } catch {
+    return { text: body };
+  }
+}
 function toResponse(response) {
   return new Response(decodeBody(response), {
     status: response.status,