deepdebug-local-agent 1.2.0 → 1.4.0

package/src/la-protocol-v2/contract/index.json

@@ -0,0 +1,166 @@
+{
+  "protocol": 2,
+  "baseId": "https://schemas.visionhammer.io/la-protocol-v2/",
+  "limits": {
+    "maxFrameBytes": 49152,
+    "chunkRawBytes": 32768,
+    "maxChunks": 64,
+    "maxContentBytes": 2097152,
+    "maxRetries": 3,
+    "ackTimeoutMs": 5000,
+    "handshakeTimeoutMs": 10000,
+    "heartbeatSeconds": 30,
+    "sessionDeadSeconds": 90,
+    "dedupeWindowSeconds": 600,
+    "clockSkewSeconds": 60
+  },
+  "types": {
+    "register": {
+      "schema": "register.schema.json",
+      "direction": "la->cp",
+      "control": true,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "hello": {
+      "schema": "hello.schema.json",
+      "direction": "la->cp",
+      "control": true,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "heartbeat": {
+      "schema": "heartbeat.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "ready": {
+      "schema": "ready.schema.json",
+      "direction": "cp->la",
+      "control": true,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "ack": {
+      "schema": "ack.schema.json",
+      "direction": "both",
+      "control": true,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "error": {
+      "schema": "error.schema.json",
+      "direction": "both",
+      "control": true,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "job.assign": {
+      "schema": "job.assign.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "transit"
+    },
+    "job.cancel": {
+      "schema": "job.cancel.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "job.event": {
+      "schema": "job.event.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "job.result": {
+      "schema": "job.result.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "content.request": {
+      "schema": "content.request.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "content.response": {
+      "schema": "content.response.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "relay"
+    },
+    "approval.decision": {
+      "schema": "approval.decision.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "config.update": {
+      "schema": "config.update.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "scan.upload": {
+      "schema": "scan.upload.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "none"
+    },
+    "scan.uploaded": {
+      "schema": "scan.uploaded.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "webhook.forward": {
+      "schema": "webhook.forward.schema.json",
+      "direction": "cp->la",
+      "control": false,
+      "signed": true,
+      "contentClass": "transit"
+    },
+    "incident.candidate": {
+      "schema": "incident.candidate.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "log.stats": {
+      "schema": "log.stats.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "audit.event": {
+      "schema": "audit.event.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    },
+    "alert": {
+      "schema": "alert.schema.json",
+      "direction": "la->cp",
+      "control": false,
+      "signed": false,
+      "contentClass": "none"
+    }
+  }
+}

package/src/la-protocol-v2/contract/job.assign.schema.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/job.assign.schema.json",
+  "title": "LA protocol v2: job.assign (cp->la)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "job.assign"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "jobId": {
+          "$ref": "defs.schema.json#/$defs/uuid"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "fix",
+            "implement",
+            "quality"
+          ]
+        },
+        "incidentRef": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "$ref": "defs.schema.json#/$defs/shortId"
+            },
+            "fingerprint": {
+              "type": "string",
+              "minLength": 8,
+              "maxLength": 64,
+              "pattern": "^[0-9a-f]{8,64}$"
+            }
+          },
+          "required": [
+            "id"
+          ]
+        },
+        "repoRef": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "github",
+                "gitlab",
+                "bitbucket",
+                "azure",
+                "other"
+              ]
+            },
+            "org": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 100,
+              "pattern": "^[A-Za-z0-9_.-]{1,100}$"
+            },
+            "repo": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 100,
+              "pattern": "^[A-Za-z0-9_.-]{1,100}$"
+            },
+            "branch": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 255,
+              "pattern": "^[A-Za-z0-9_./-]{1,255}$"
+            }
+          },
+          "required": [
+            "provider",
+            "org",
+            "repo",
+            "branch"
+          ]
+        },
+        "policy": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "operationMode": {
+              "$ref": "defs.schema.json#/$defs/operationMode"
+            },
+            "automationLevel": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 5
+            },
+            "ceiling": {
+              "$ref": "defs.schema.json#/$defs/operationMode"
+            }
+          },
+          "required": [
+            "operationMode",
+            "automationLevel",
+            "ceiling"
+          ]
+        },
+        "budget": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "tokens": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10000000
+            },
+            "seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 86400
+            }
+          },
+          "required": [
+            "tokens",
+            "seconds"
+          ]
+        },
+        "llm": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "defs.schema.json#/$defs/shortId"
+            },
+            "keyRef": {
+              "$ref": "defs.schema.json#/$defs/shortId"
+            }
+          },
+          "required": [
+            "alias",
+            "keyRef"
+          ]
+        },
+        "inputs": {
+          "type": "array",
+          "maxItems": 4,
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512,
+                    "pattern": "^[^\\u0000-\\u001f]{1,512}$"
+                  }
+                },
+                "required": [
+                  "ref"
+                ]
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "inline": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 4096,
+                    "x-content-class": "transit"
+                  },
+                  "transient": {
+                    "const": true
+                  }
+                },
+                "required": [
+                  "inline",
+                  "transient"
+                ]
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "jobId",
+        "kind",
+        "repoRef",
+        "policy",
+        "budget",
+        "llm"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": true,
+    "paramsRaw": true
+  },
+  "required": [
+    "payload",
+    "sig",
+    "paramsRaw"
+  ]
+}

package/src/la-protocol-v2/contract/job.cancel.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/job.cancel.schema.json",
+  "title": "LA protocol v2: job.cancel (cp->la)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "job.cancel"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "jobId": {
+          "$ref": "defs.schema.json#/$defs/uuid"
+        },
+        "reason": {
+          "type": "string",
+          "enum": [
+            "user",
+            "timeout",
+            "killswitch",
+            "policy",
+            "superseded"
+          ]
+        }
+      },
+      "required": [
+        "jobId",
+        "reason"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": true,
+    "paramsRaw": true
+  },
+  "required": [
+    "payload",
+    "sig",
+    "paramsRaw"
+  ]
+}

package/src/la-protocol-v2/contract/job.event.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/job.event.schema.json",
+  "title": "LA protocol v2: job.event (la->cp)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "job.event"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "jobId": {
+          "$ref": "defs.schema.json#/$defs/uuid"
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "waiting_approval",
+            "succeeded",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "phase": {
+          "type": "string",
+          "enum": [
+            "init",
+            "context",
+            "plan",
+            "edit",
+            "validate",
+            "pr",
+            "done"
+          ]
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1000
+        },
+        "filesRead": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "filesChanged": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "tokensIn": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "tokensOut": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "costUsd": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100000
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "errorCode": {
+          "type": "string",
+          "enum": [
+            "none",
+            "llm_error",
+            "policy_denied",
+            "build_failed",
+            "tests_failed",
+            "timeout",
+            "cancelled",
+            "budget_exceeded",
+            "infra",
+            "unknown"
+          ]
+        }
+      },
+      "required": [
+        "jobId",
+        "state"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}

package/src/la-protocol-v2/contract/job.result.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.visionhammer.io/la-protocol-v2/job.result.schema.json",
+  "title": "LA protocol v2: job.result (la->cp)",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "envelope.schema.json"
+    }
+  ],
+  "properties": {
+    "type": {
+      "const": "job.result"
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "jobId": {
+          "$ref": "defs.schema.json#/$defs/uuid"
+        },
+        "outcome": {
+          "type": "string",
+          "enum": [
+            "pr_opened",
+            "no_change",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "prUrl": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^https://[^\\s]{1,500}$"
+        },
+        "branch": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255,
+          "pattern": "^[A-Za-z0-9_./-]{1,255}$"
+        },
+        "commitSha": {
+          "$ref": "defs.schema.json#/$defs/gitSha"
+        },
+        "filesChangedCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "diffSha256": {
+          "$ref": "defs.schema.json#/$defs/sha256"
+        },
+        "tests": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "pass": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "fail": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "skip": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "pass",
+            "fail",
+            "skip"
+          ]
+        }
+      },
+      "required": [
+        "jobId",
+        "outcome"
+      ]
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "chunk": false,
+    "sig": false,
+    "paramsRaw": false,
+    "agentId": true
+  },
+  "required": [
+    "payload",
+    "agentId"
+  ]
+}