@opensteer/protocol 0.7.1 → 0.7.3

package/dist/index.cjs

@@ -814,14 +814,10 @@ var networkRecordSchema = objectSchema(
     ]
   }
 );
-var networkQuerySourceSchema = enumSchema(["live", "saved"], {
-  title: "NetworkQuerySource"
-});
 var networkQueryRecordSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
-    source: networkQuerySourceSchema,
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tags: arraySchema(stringSchema({ minLength: 1 }), {
       uniqueItems: true
     }),
@@ -830,7 +826,7 @@ var networkQueryRecordSchema = objectSchema(
   },
   {
     title: "NetworkQueryRecord",
-    required: ["recordId", "source", "record"]
+    required: ["recordId", "record"]
   }
 );
 var orderedHeadersSchema = arraySchema(headerEntrySchema, {
@@ -1303,8 +1299,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     objectSchema(
       {
         kind: enumSchema(["goto"]),
-        url: stringSchema({ minLength: 1 }),
-        networkTag: stringSchema({ minLength: 1 })
+        url: stringSchema({ minLength: 1 })
       },
       {
         title: "OpensteerAuthRecipeGotoStep",
@@ -1313,8 +1308,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     ),
     objectSchema(
       {
-        kind: enumSchema(["reload"]),
-        networkTag: stringSchema({ minLength: 1 })
+        kind: enumSchema(["reload"])
       },
       {
         title: "OpensteerAuthRecipeReloadStep",
@@ -1530,13 +1524,10 @@ var opensteerRecipeRecordSchema = objectSchema(
 var opensteerAuthRecipeRecordSchema = opensteerRecipeRecordSchema;
 var opensteerNetworkQueryInputSchema = objectSchema(
   {
-    source: enumSchema(["live", "saved"], {
-      title: "OpensteerNetworkQuerySource"
-    }),
     pageRef: pageRefSchema,
     recordId: stringSchema({ minLength: 1 }),
     requestId: stringSchema({ minLength: 1 }),
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 }),
     url: stringSchema({ minLength: 1 }),
     hostname: stringSchema({ minLength: 1 }),
@@ -1560,12 +1551,12 @@ var opensteerNetworkQueryOutputSchema = objectSchema(
     required: ["records"]
   }
 );
-var opensteerNetworkSaveInputSchema = objectSchema(
+var opensteerNetworkTagInputSchema = objectSchema(
   {
     pageRef: pageRefSchema,
     recordId: stringSchema({ minLength: 1 }),
     requestId: stringSchema({ minLength: 1 }),
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 }),
     url: stringSchema({ minLength: 1 }),
     hostname: stringSchema({ minLength: 1 }),
@@ -1575,21 +1566,22 @@ var opensteerNetworkSaveInputSchema = objectSchema(
     resourceType: networkResourceTypeSchema
   },
   {
-    title: "OpensteerNetworkSaveInput",
+    title: "OpensteerNetworkTagInput",
     required: ["tag"]
   }
 );
-var opensteerNetworkSaveOutputSchema = objectSchema(
+var opensteerNetworkTagOutputSchema = objectSchema(
   {
-    savedCount: integerSchema({ minimum: 0 })
+    taggedCount: integerSchema({ minimum: 0 })
   },
   {
-    title: "OpensteerNetworkSaveOutput",
-    required: ["savedCount"]
+    title: "OpensteerNetworkTagOutput",
+    required: ["taggedCount"]
   }
 );
 var opensteerNetworkClearInputSchema = objectSchema(
   {
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 })
   },
   {
@@ -2458,6 +2450,7 @@ var cloudActionMethods = [
 var cloudErrorCodes = [
   "CLOUD_AUTH_FAILED",
   "CLOUD_SESSION_NOT_FOUND",
+  "CLOUD_ARTIFACT_NOT_FOUND",
   "CLOUD_SESSION_CLOSED",
   "CLOUD_UNSUPPORTED_METHOD",
   "CLOUD_INVALID_REQUEST",
@@ -3164,6 +3157,164 @@ function traceBundleSchema(dataSchema = {}) {
   );
 }
 
+// src/observability.ts
+var observabilityProfiles = ["off", "baseline", "diagnostic"];
+var observationEventPhases = [
+  "started",
+  "updated",
+  "completed",
+  "failed",
+  "occurred"
+];
+var observationEventKinds = [
+  "session",
+  "operation",
+  "page",
+  "console",
+  "error",
+  "network",
+  "artifact",
+  "annotation",
+  "runtime",
+  "observability"
+];
+var observationArtifactKinds = [
+  "screenshot",
+  "dom-snapshot",
+  "html-snapshot",
+  "trace-bundle",
+  "frame-buffer",
+  "request-body",
+  "response-body",
+  "log",
+  "other"
+];
+var observabilityProfileSchema = enumSchema(observabilityProfiles, {
+  title: "ObservabilityProfile"
+});
+var observabilityTraceContextSchema = objectSchema(
+  {
+    traceparent: stringSchema(),
+    baggage: stringSchema()
+  },
+  {
+    title: "ObservabilityTraceContext"
+  }
+);
+var observabilityRedactionConfigSchema = objectSchema(
+  {
+    sensitiveKeys: arraySchema(stringSchema()),
+    sensitiveValues: arraySchema(stringSchema())
+  },
+  {
+    title: "ObservabilityRedactionConfig"
+  }
+);
+var observabilityConfigSchema = objectSchema(
+  {
+    profile: observabilityProfileSchema,
+    labels: recordSchema(stringSchema()),
+    traceContext: observabilityTraceContextSchema,
+    redaction: observabilityRedactionConfigSchema
+  },
+  {
+    title: "ObservabilityConfig",
+    required: ["profile"]
+  }
+);
+var observationContextSchema = objectSchema(
+  {
+    sessionRef: sessionRefSchema,
+    pageRef: pageRefSchema,
+    frameRef: frameRefSchema,
+    documentRef: documentRefSchema,
+    documentEpoch: documentEpochSchema
+  },
+  {
+    title: "ObservationContext"
+  }
+);
+var observationEventErrorSchema = objectSchema(
+  {
+    code: stringSchema(),
+    message: stringSchema(),
+    retriable: {
+      type: "boolean"
+    },
+    details: {}
+  },
+  {
+    title: "ObservationEventError",
+    required: ["message"]
+  }
+);
+var observationEventSchema = objectSchema(
+  {
+    eventId: stringSchema(),
+    sessionId: stringSchema(),
+    sequence: integerSchema({ minimum: 1 }),
+    kind: enumSchema(observationEventKinds),
+    phase: enumSchema(observationEventPhases),
+    createdAt: integerSchema({ minimum: 0 }),
+    correlationId: stringSchema(),
+    spanId: stringSchema(),
+    parentSpanId: stringSchema(),
+    context: observationContextSchema,
+    data: {},
+    error: observationEventErrorSchema,
+    artifactIds: arraySchema(stringSchema())
+  },
+  {
+    title: "ObservationEvent",
+    required: ["eventId", "sessionId", "sequence", "kind", "phase", "createdAt", "correlationId"]
+  }
+);
+var observationArtifactSchema = objectSchema(
+  {
+    artifactId: stringSchema(),
+    sessionId: stringSchema(),
+    kind: enumSchema(observationArtifactKinds),
+    createdAt: integerSchema({ minimum: 0 }),
+    context: observationContextSchema,
+    mediaType: stringSchema(),
+    byteLength: integerSchema({ minimum: 0 }),
+    sha256: stringSchema(),
+    opensteerArtifactId: stringSchema(),
+    storageKey: stringSchema(),
+    metadata: {}
+  },
+  {
+    title: "ObservationArtifact",
+    required: ["artifactId", "sessionId", "kind", "createdAt"]
+  }
+);
+var observationSessionSchema = objectSchema(
+  {
+    sessionId: stringSchema(),
+    profile: observabilityProfileSchema,
+    labels: recordSchema(stringSchema()),
+    traceContext: observabilityTraceContextSchema,
+    openedAt: integerSchema({ minimum: 0 }),
+    updatedAt: integerSchema({ minimum: 0 }),
+    closedAt: integerSchema({ minimum: 0 }),
+    currentSequence: integerSchema({ minimum: 0 }),
+    eventCount: integerSchema({ minimum: 0 }),
+    artifactCount: integerSchema({ minimum: 0 })
+  },
+  {
+    title: "ObservationSession",
+    required: [
+      "sessionId",
+      "profile",
+      "openedAt",
+      "updatedAt",
+      "currentSequence",
+      "eventCount",
+      "artifactCount"
+    ]
+  }
+);
+
 // src/envelopes.ts
 function createRequestEnvelope(operation, input, options) {
   return {
@@ -3276,7 +3427,7 @@ function responseEnvelopeSchema(dataSchema, operation) {
 }
 
 // src/session-info.ts
-var opensteerSessionGrantKinds = ["automation", "view", "cdp"];
+var opensteerSessionGrantKinds = ["semantic", "automation", "view", "cdp"];
 
 // src/automation.ts
 var opensteerAutomationOperationNames = [
@@ -6239,7 +6390,7 @@ var opensteerSemanticOperationNames = [
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -6300,7 +6451,7 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -6620,7 +6771,7 @@ var opensteerPageCloseOutputSchema = objectSchema(
 var opensteerPageGotoInputSchema = objectSchema(
   {
     url: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerPageGotoInput",
@@ -6767,11 +6918,25 @@ var opensteerInspectStorageInputSchema = objectSchema(
     title: "OpensteerInspectStorageInput"
   }
 );
+var opensteerComputerMouseButtonSchema = enumSchema(["left", "middle", "right"], {
+  title: "OpensteerComputerMouseButton"
+});
+var opensteerComputerKeyModifierSchema = enumSchema(
+  ["Shift", "Control", "Alt", "Meta"],
+  {
+    title: "OpensteerComputerKeyModifier"
+  }
+);
 var opensteerDomClickInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
+    button: opensteerComputerMouseButtonSchema,
+    clickCount: integerSchema({ minimum: 1 }),
+    modifiers: arraySchema(opensteerComputerKeyModifierSchema, {
+      uniqueItems: true
+    }),
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomClickInput",
@@ -6782,7 +6947,7 @@ var opensteerDomHoverInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomHoverInput",
@@ -6795,7 +6960,7 @@ var opensteerDomInputInputSchema = objectSchema(
     text: stringSchema(),
     pressEnter: { type: "boolean" },
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomInputInput",
@@ -6808,7 +6973,7 @@ var opensteerDomScrollInputSchema = objectSchema(
     direction: enumSchema(["up", "down", "left", "right"]),
     amount: integerSchema({ minimum: 1 }),
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomScrollInput",
@@ -6869,18 +7034,6 @@ var opensteerSessionCloseOutputSchema = objectSchema(
     required: ["closed"]
   }
 );
-var opensteerComputerMouseButtonSchema = enumSchema(
-  ["left", "middle", "right"],
-  {
-    title: "OpensteerComputerMouseButton"
-  }
-);
-var opensteerComputerKeyModifierSchema = enumSchema(
-  ["Shift", "Control", "Alt", "Meta"],
-  {
-    title: "OpensteerComputerKeyModifier"
-  }
-);
 var opensteerComputerAnnotationSchema = enumSchema(opensteerComputerAnnotationNames, {
   title: "OpensteerComputerAnnotation"
 });
@@ -7009,7 +7162,7 @@ var opensteerComputerExecuteInputSchema = objectSchema(
   {
     action: opensteerComputerActionSchema,
     screenshot: opensteerComputerScreenshotOptionsSchema,
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerComputerExecuteInput",
@@ -7213,18 +7366,17 @@ var opensteerSemanticOperationSpecificationsBase = [
   }),
   defineSemanticOperationSpec({
     name: "network.query",
-    description: "Query live or saved network records for reverse engineering workflows.",
+    description: "Query persisted network records for reverse engineering workflows.",
     inputSchema: opensteerNetworkQueryInputSchema,
     outputSchema: opensteerNetworkQueryOutputSchema,
-    requiredCapabilities: [],
-    resolveRequiredCapabilities: (input) => input.source === "saved" ? [] : input.includeBodies === true ? ["inspect.network", "inspect.networkBodies"] : ["inspect.network"]
+    requiredCapabilities: []
   }),
   defineSemanticOperationSpec({
-    name: "network.save",
-    description: "Persist filtered live network records into the saved network registry under a tag.",
-    inputSchema: opensteerNetworkSaveInputSchema,
-    outputSchema: opensteerNetworkSaveOutputSchema,
-    requiredCapabilities: ["inspect.network"]
+    name: "network.tag",
+    description: "Apply a tag to persisted network records matching the provided filters.",
+    inputSchema: opensteerNetworkTagInputSchema,
+    outputSchema: opensteerNetworkTagOutputSchema,
+    requiredCapabilities: []
   }),
   defineSemanticOperationSpec({
     name: "network.clear",
@@ -7826,7 +7978,6 @@ exports.networkDiffFieldSchema = networkDiffFieldSchema;
 exports.networkInitiatorSchema = networkInitiatorSchema;
 exports.networkInitiatorTypeSchema = networkInitiatorTypeSchema;
 exports.networkQueryRecordSchema = networkQueryRecordSchema;
-exports.networkQuerySourceSchema = networkQuerySourceSchema;
 exports.networkRecordKindSchema = networkRecordKindSchema;
 exports.networkRecordSchema = networkRecordSchema;
 exports.networkRequestIdSchema = networkRequestIdSchema;
@@ -7838,6 +7989,19 @@ exports.nodeLocatorSchema = nodeLocatorSchema;
 exports.nodeRefSchema = nodeRefSchema;
 exports.numberSchema = numberSchema;
 exports.objectSchema = objectSchema;
+exports.observabilityConfigSchema = observabilityConfigSchema;
+exports.observabilityProfileSchema = observabilityProfileSchema;
+exports.observabilityProfiles = observabilityProfiles;
+exports.observabilityRedactionConfigSchema = observabilityRedactionConfigSchema;
+exports.observabilityTraceContextSchema = observabilityTraceContextSchema;
+exports.observationArtifactKinds = observationArtifactKinds;
+exports.observationArtifactSchema = observationArtifactSchema;
+exports.observationContextSchema = observationContextSchema;
+exports.observationEventErrorSchema = observationEventErrorSchema;
+exports.observationEventKinds = observationEventKinds;
+exports.observationEventPhases = observationEventPhases;
+exports.observationEventSchema = observationEventSchema;
+exports.observationSessionSchema = observationSessionSchema;
 exports.oneOfSchema = oneOfSchema;
 exports.opensteerArtifactReadInputSchema = opensteerArtifactReadInputSchema;
 exports.opensteerArtifactReadOutputSchema = opensteerArtifactReadOutputSchema;
@@ -7897,8 +8061,8 @@ exports.opensteerNetworkMinimizeOutputSchema = opensteerNetworkMinimizeOutputSch
 exports.opensteerNetworkMinimizeSuccessPolicySchema = opensteerNetworkMinimizeSuccessPolicySchema;
 exports.opensteerNetworkQueryInputSchema = opensteerNetworkQueryInputSchema;
 exports.opensteerNetworkQueryOutputSchema = opensteerNetworkQueryOutputSchema;
-exports.opensteerNetworkSaveInputSchema = opensteerNetworkSaveInputSchema;
-exports.opensteerNetworkSaveOutputSchema = opensteerNetworkSaveOutputSchema;
+exports.opensteerNetworkTagInputSchema = opensteerNetworkTagInputSchema;
+exports.opensteerNetworkTagOutputSchema = opensteerNetworkTagOutputSchema;
 exports.opensteerObservationClusterRelationshipKindSchema = opensteerObservationClusterRelationshipKindSchema;
 exports.opensteerObservationClusterSchema = opensteerObservationClusterSchema;
 exports.opensteerOperationNames = opensteerOperationNames;