deepdebug-local-agent 1.3.0 → 1.4.0

package/test/contract/la-protocol-v2/vectors/ready.vectors.json

@@ -0,0 +1,177 @@
+{
+  "type": "ready",
+  "schema": "ready.schema.json",
+  "vectors": [
+    {
+      "name": "minimal-valid",
+      "expect": {
+        "valid": true
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "ready",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "paramsRaw": "{\"protocol\":2,\"sessionId\":\"e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091\",\"resumed\":false,\"peerLastSeq\":0,\"limits\":{\"maxFrameBytes\":49152,\"chunkRawBytes\":32768,\"maxChunks\":64,\"ackTimeoutMs\":5000,\"maxRetries\":3,\"heartbeatSeconds\":30,\"contentFirstByteMs\":10000,\"contentTotalMs\":30000}}",
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        },
+        "payload": {
+          "protocol": 2,
+          "sessionId": "e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091",
+          "resumed": false,
+          "peerLastSeq": 0,
+          "limits": {
+            "maxFrameBytes": 49152,
+            "chunkRawBytes": 32768,
+            "maxChunks": 64,
+            "ackTimeoutMs": 5000,
+            "maxRetries": 3,
+            "heartbeatSeconds": 30,
+            "contentFirstByteMs": 10000,
+            "contentTotalMs": 30000
+          }
+        }
+      }
+    },
+    {
+      "name": "extra-top-level-field",
+      "why": "envelope is closed (additionalProperties:false)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "ready",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "paramsRaw": "{\"protocol\":2,\"sessionId\":\"e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091\",\"resumed\":false,\"peerLastSeq\":0,\"limits\":{\"maxFrameBytes\":49152,\"chunkRawBytes\":32768,\"maxChunks\":64,\"ackTimeoutMs\":5000,\"maxRetries\":3,\"heartbeatSeconds\":30,\"contentFirstByteMs\":10000,\"contentTotalMs\":30000}}",
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        },
+        "payload": {
+          "protocol": 2,
+          "sessionId": "e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091",
+          "resumed": false,
+          "peerLastSeq": 0,
+          "limits": {
+            "maxFrameBytes": 49152,
+            "chunkRawBytes": 32768,
+            "maxChunks": 64,
+            "ackTimeoutMs": 5000,
+            "maxRetries": 3,
+            "heartbeatSeconds": 30,
+            "contentFirstByteMs": 10000,
+            "contentTotalMs": 30000
+          }
+        },
+        "extra": "x"
+      }
+    },
+    {
+      "name": "extra-payload-field",
+      "why": "payload is closed: no free-form fields",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "ready",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "paramsRaw": "{\"protocol\":2,\"sessionId\":\"e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091\",\"resumed\":false,\"peerLastSeq\":0,\"limits\":{\"maxFrameBytes\":49152,\"chunkRawBytes\":32768,\"maxChunks\":64,\"ackTimeoutMs\":5000,\"maxRetries\":3,\"heartbeatSeconds\":30,\"contentFirstByteMs\":10000,\"contentTotalMs\":30000}}",
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        },
+        "payload": {
+          "protocol": 2,
+          "sessionId": "e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091",
+          "resumed": false,
+          "peerLastSeq": 0,
+          "limits": {
+            "maxFrameBytes": 49152,
+            "chunkRawBytes": 32768,
+            "maxChunks": 64,
+            "ackTimeoutMs": 5000,
+            "maxRetries": 3,
+            "heartbeatSeconds": 30,
+            "contentFirstByteMs": 10000,
+            "contentTotalMs": 30000
+          },
+          "freeText": "client text"
+        }
+      }
+    },
+    {
+      "name": "tenant-id-not-uuid",
+      "why": "tenantId must be a UUID",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "pattern"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "ready",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "tenant-1",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "paramsRaw": "{\"protocol\":2,\"sessionId\":\"e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091\",\"resumed\":false,\"peerLastSeq\":0,\"limits\":{\"maxFrameBytes\":49152,\"chunkRawBytes\":32768,\"maxChunks\":64,\"ackTimeoutMs\":5000,\"maxRetries\":3,\"heartbeatSeconds\":30,\"contentFirstByteMs\":10000,\"contentTotalMs\":30000}}",
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        },
+        "payload": {
+          "protocol": 2,
+          "sessionId": "e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091",
+          "resumed": false,
+          "peerLastSeq": 0,
+          "limits": {
+            "maxFrameBytes": 49152,
+            "chunkRawBytes": 32768,
+            "maxChunks": 64,
+            "ackTimeoutMs": 5000,
+            "maxRetries": 3,
+            "heartbeatSeconds": 30,
+            "contentFirstByteMs": 10000,
+            "contentTotalMs": 30000
+          }
+        }
+      }
+    }
+  ]
+}

package/test/contract/la-protocol-v2/vectors/register.vectors.json

@@ -0,0 +1,399 @@
+{
+  "type": "register",
+  "schema": "register.schema.json",
+  "vectors": [
+    {
+      "name": "minimal-valid",
+      "expect": {
+        "valid": true
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "extra-top-level-field",
+      "why": "envelope is closed (additionalProperties:false)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        },
+        "extra": "x"
+      }
+    },
+    {
+      "name": "extra-payload-field",
+      "why": "payload is closed: no free-form fields",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ],
+          "freeText": "client text"
+        }
+      }
+    },
+    {
+      "name": "tenant-id-not-uuid",
+      "why": "tenantId must be a UUID",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "pattern"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "tenant-1",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "protocol-1",
+      "why": "register v2 must declare protocol 2 (v1 agents send the legacy frame)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "const"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 1,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "raw-workspace-path",
+      "why": "disk paths do not travel in v2 (only pathSha256)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ],
+          "workspacePath": "/home/user/code"
+        }
+      }
+    },
+    {
+      "name": "bad-signature-mode",
+      "why": "signatureMode in off|warn|enforce",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "enum"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "disabled",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "handshake-seq-not-zero",
+      "why": "handshake frames use seq 0",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "const"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 5,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "with-resume",
+      "expect": {
+        "valid": true
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ],
+          "resume": {
+            "sessionId": "e5f6a7b8-c9d0-4e1f-8a2b-4c5d6e7f8091",
+            "lastRecvSeq": 5
+          }
+        }
+      },
+      "why": "reconnect: resume the previous session from the last received seq"
+    },
+    {
+      "name": "missing-agent-id",
+      "why": "LA->CP frames carry agentId",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "required"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "la-frame-with-sig",
+      "why": "LA->CP frames are not signed in v2.0 (F3-X3 reserves it)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "register",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "protocol": 2,
+          "laVersion": "2.4.0",
+          "capabilities": [
+            "content.request",
+            "job.assign",
+            "incident.detect"
+          ],
+          "signatureMode": "enforce",
+          "workspaces": [
+            {
+              "workspaceId": "ws-1",
+              "pathSha256": "abababababababababababababababababababababababababababababababab"
+            }
+          ]
+        },
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        }
+      }
+    }
+  ]
+}