deepdebug-local-agent 1.2.0 → 1.4.0

package/src/la-protocol-v2/contract/defs.schema.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/defs.schema.json",
+  "title": "LA protocol v2 shared definitions",
+  "$defs": {
+    "uuid": {
+      "type": "string",
+      "minLength": 36,
+      "maxLength": 36,
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 36,
+      "maxLength": 36,
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+    },
+    "workspaceId": {
+      "type": "string",
+      "maxLength": 64,
+      "pattern": "^[A-Za-z0-9_.-]{0,64}$"
+    },
+    "shortId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
+    },
+    "sha256": {
+      "type": "string",
+      "minLength": 64,
+      "maxLength": 64,
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "gitSha": {
+      "type": "string",
+      "minLength": 7,
+      "maxLength": 64,
+      "pattern": "^[0-9a-f]{7,64}$"
+    },
+    "semver": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 48,
+      "pattern": "^[0-9]{1,4}\\.[0-9]{1,4}\\.[0-9]{1,4}([-+][0-9A-Za-z.-]{1,32})?$"
+    },
+    "ts": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 30,
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,6})?Z$"
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "count": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "chunk": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "index": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 63
+        },
+        "total": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 64
+        },
+        "last": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "index",
+        "total",
+        "last"
+      ]
+    },
+    "sig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "keyId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
+        },
+        "timestamp": {
+          "type": "string",
+          "minLength": 9,
+          "maxLength": 16,
+          "pattern": "^[0-9]{9,12}$"
+        },
+        "nonce": {
+          "type": "string",
+          "minLength": 16,
+          "maxLength": 64,
+          "pattern": "^[A-Za-z0-9_-]{16,64}$"
+        },
+        "tenantId": {
+          "$ref": "defs.schema.json#/$defs/tenantId"
+        },
+        "workspaceId": {
+          "$ref": "defs.schema.json#/$defs/workspaceId"
+        },
+        "signature": {
+          "type": "string",
+          "minLength": 64,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9+/_-]{64,128}={0,2}$"
+        }
+      },
+      "required": [
+        "keyId",
+        "timestamp",
+        "nonce",
+        "tenantId",
+        "workspaceId",
+        "signature"
+      ]
+    },
+    "errorCode": {
+      "type": "string",
+      "enum": [
+        "bad_frame",
+        "unknown_type",
+        "schema_violation",
+        "frame_too_large",
+        "payload_too_large",
+        "wrong_direction",
+        "handshake_violation",
+        "not_ready",
+        "seq_gap",
+        "seq_replayed",
+        "chunk_out_of_order",
+        "chunk_inconsistent",
+        "tenant_mismatch",
+        "agent_mismatch",
+        "params_mismatch",
+        "signature_mode_insufficient",
+        "clock_skew",
+        "protocol_unsupported",
+        "unauthorized",
+        "agent_offline",
+        "timeout",
+        "rate_limited",
+        "internal"
+      ]
+    },
+    "signatureMode": {
+      "type": "string",
+      "enum": [
+        "off",
+        "warn",
+        "enforce"
+      ]
+    },
+    "operationMode": {
+      "type": "string",
+      "enum": [
+        "observe",
+        "assist",
+        "autonomous",
+        "none"
+      ]
+    },
+    "dataPlaneMode": {
+      "type": "string",
+      "enum": [
+        "vh",
+        "hybrid",
+        "client"
+      ]
+    },
+    "capability": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 48,
+      "pattern": "^[a-z0-9]+([._-][a-z0-9]+)*$"
+    }
+  }
+}

package/src/la-protocol-v2/contract/envelope.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/envelope.schema.json",
+  "title": "LA protocol v2 envelope",
+  "description": "Common frame. All client-visible data lives in payload; top level is closed. Per-type schemas ($ref this one) close payload.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "type",
+    "msgId",
+    "seq",
+    "tenantId",
+    "workspaceId",
+    "ts",
+    "payload"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 2
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "register",
+        "hello",
+        "heartbeat",
+        "ready",
+        "ack",
+        "error",
+        "job.assign",
+        "job.cancel",
+        "job.event",
+        "job.result",
+        "content.request",
+        "content.response",
+        "approval.decision",
+        "config.update",
+        "scan.upload",
+        "scan.uploaded",
+        "webhook.forward",
+        "incident.candidate",
+        "log.stats",
+        "audit.event",
+        "alert"
+      ]
+    },
+    "msgId": {
+      "$ref": "defs.schema.json#/$defs/uuid"
+    },
+    "seq": {
+      "$ref": "defs.schema.json#/$defs/seq"
+    },
+    "ack": {
+      "$ref": "defs.schema.json#/$defs/seq"
+    },
+    "requestId": {
+      "$ref": "defs.schema.json#/$defs/uuid"
+    },
+    "tenantId": {
+      "$ref": "defs.schema.json#/$defs/tenantId"
+    },
+    "agentId": {
+      "$ref": "defs.schema.json#/$defs/uuid"
+    },
+    "workspaceId": {
+      "$ref": "defs.schema.json#/$defs/workspaceId"
+    },
+    "ts": {
+      "$ref": "defs.schema.json#/$defs/ts"
+    },
+    "chunk": {
+      "$ref": "defs.schema.json#/$defs/chunk"
+    },
+    "paramsRaw": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 24576,
+      "x-large-metadata": true
+    },
+    "sig": {
+      "$ref": "defs.schema.json#/$defs/sig"
+    },
+    "payload": {
+      "type": "object",
+      "maxProperties": 32
+    }
+  }
+}

package/src/la-protocol-v2/contract/error.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/error.schema.json",
+  "title": "LA protocol v2: error (both)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "error"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "$ref": "defs.schema.json#/$defs/errorCode"
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "refSeq": {
+          "$ref": "defs.schema.json#/$defs/seq"
+        },
+        "refMsgId": {
+          "$ref": "defs.schema.json#/$defs/uuid"
+        },
+        "closeCode": {
+          "type": "integer",
+          "minimum": 4000,
+          "maximum": 4499
+        },
+        "detail": {
+          "type": "string",
+          "maxLength": 200,
+          "pattern": "^[^\\u0000-\\u001f]{0,200}$"
+        }
+      },
+      "required": [
+        "code",
+        "retryable"
+      ]
+    },
+    "seq": {
+      "const": 0
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}

package/src/la-protocol-v2/contract/heartbeat.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/heartbeat.schema.json",
+  "title": "LA protocol v2: heartbeat (la->cp)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "heartbeat"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "signatureMode": {
+          "$ref": "defs.schema.json#/$defs/signatureMode"
+        },
+        "graphify": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "absent",
+                "building",
+                "ready",
+                "stale"
+              ]
+            },
+            "nodes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "edges": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "commit": {
+              "$ref": "defs.schema.json#/$defs/gitSha"
+            },
+            "ageSeconds": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "state"
+          ]
+        },
+        "diskFreeBytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "queueDepth": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100000
+        },
+        "clockEpochMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "inflight": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000
+        }
+      },
+      "required": [
+        "signatureMode",
+        "clockEpochMs",
+        "diskFreeBytes",
+        "queueDepth"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}

package/src/la-protocol-v2/contract/hello.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/hello.schema.json",
+  "title": "LA protocol v2: hello (la->cp)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "hello"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "signatureMode": {
+          "$ref": "defs.schema.json#/$defs/signatureMode"
+        },
+        "graphify": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "absent",
+                "building",
+                "ready",
+                "stale"
+              ]
+            },
+            "nodes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "edges": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "commit": {
+              "$ref": "defs.schema.json#/$defs/gitSha"
+            },
+            "ageSeconds": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "state"
+          ]
+        },
+        "diskFreeBytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "queueDepth": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100000
+        },
+        "clockEpochMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "inflight": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000
+        },
+        "laVersion": {
+          "$ref": "defs.schema.json#/$defs/semver"
+        },
+        "capabilities": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "defs.schema.json#/$defs/capability"
+          }
+        }
+      },
+      "required": [
+        "laVersion",
+        "capabilities",
+        "signatureMode",
+        "clockEpochMs",
+        "diskFreeBytes",
+        "queueDepth"
+      ]
+    },
+    "seq": {
+      "const": 0
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}

package/src/la-protocol-v2/contract/incident.candidate.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/incident.candidate.schema.json",
+  "title": "LA protocol v2: incident.candidate (la->cp)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "incident.candidate"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "errorHash": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 64,
+          "pattern": "^[0-9a-f]{8,64}$"
+        },
+        "fingerprint": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 64,
+          "pattern": "^[0-9a-f]{8,64}$"
+        },
+        "severity": {
+          "type": "string",
+          "enum": [
+            "critical",
+            "high",
+            "medium",
+            "low",
+            "info"
+          ]
+        },
+        "service": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9._:/-]{1,128}$"
+        },
+        "environment": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 32,
+          "pattern": "^[a-z0-9][a-z0-9_-]{0,31}$"
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "firstSeen": {
+          "$ref": "defs.schema.json#/$defs/ts"
+        },
+        "lastSeen": {
+          "$ref": "defs.schema.json#/$defs/ts"
+        },
+        "logCategory": {
+          "type": "string",
+          "enum": [
+            "exception",
+            "timeout",
+            "http_5xx",
+            "db",
+            "oom",
+            "security",
+            "other"
+          ]
+        }
+      },
+      "required": [
+        "errorHash",
+        "fingerprint",
+        "severity",
+        "service",
+        "environment",
+        "count",
+        "firstSeen",
+        "lastSeen"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}