deepdebug-local-agent 1.3.0 → 1.4.0

package/test/contract/la-protocol-v2/vectors/cross-type.vectors.json

@@ -0,0 +1,260 @@
+{
+  "type": "*",
+  "schema": "envelope.schema.json",
+  "vectors": [
+    {
+      "name": "type-outside-allowlist",
+      "why": "type must be one of the 21 allowlisted types (no arbitrary commands from the CP)",
+      "expect": {
+        "valid": false,
+        "code": "unknown_type",
+        "keyword": "enum"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "shell.exec",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "state": "running",
+          "phase": "edit",
+          "iteration": 2,
+          "filesRead": 14,
+          "filesChanged": 1,
+          "tokensIn": 8200,
+          "tokensOut": 1300,
+          "costUsd": 0.042,
+          "durationMs": 61000,
+          "errorCode": "none"
+        }
+      }
+    },
+    {
+      "name": "legacy-v1-command-as-type",
+      "why": "v1 commands (mcp.execute-command, ...) are not v2 types",
+      "expect": {
+        "valid": false,
+        "code": "unknown_type",
+        "keyword": "enum"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "mcp.execute-command",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "paramsRaw": "{\"jobId\":\"c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f\",\"kind\":\"fix\",\"incidentRef\":{\"id\":\"inc-8c8deab3\",\"fingerprint\":\"5a1f09c2d7e8b3a4\"},\"repoRef\":{\"provider\":\"github\",\"org\":\"acme\",\"repo\":\"billing\",\"branch\":\"main\"},\"policy\":{\"operationMode\":\"assist\",\"automationLevel\":2,\"ceiling\":\"autonomous\"},\"budget\":{\"tokens\":200000,\"seconds\":900},\"llm\":{\"alias\":\"vh-coder\",\"keyRef\":\"key-la-1\"},\"inputs\":[{\"ref\":\"incident:inc-8c8deab3\"},{\"inline\":\"Fix the NPE in PaymentService\",\"transient\":true}]}",
+        "sig": {
+          "keyId": "vh-cp-2026-10",
+          "timestamp": "1793268000",
+          "nonce": "Zm9vYmFyYmF6cXV4MTIzNDU2",
+          "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+          "workspaceId": "ws-1",
+          "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+        },
+        "requestId": "d4e5f6a7-b8c9-4d0e-9f1a-3b4c5d6e7f80",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "kind": "fix",
+          "incidentRef": {
+            "id": "inc-8c8deab3",
+            "fingerprint": "5a1f09c2d7e8b3a4"
+          },
+          "repoRef": {
+            "provider": "github",
+            "org": "acme",
+            "repo": "billing",
+            "branch": "main"
+          },
+          "policy": {
+            "operationMode": "assist",
+            "automationLevel": 2,
+            "ceiling": "autonomous"
+          },
+          "budget": {
+            "tokens": 200000,
+            "seconds": 900
+          },
+          "llm": {
+            "alias": "vh-coder",
+            "keyRef": "key-la-1"
+          },
+          "inputs": [
+            {
+              "ref": "incident:inc-8c8deab3"
+            },
+            {
+              "inline": "Fix the NPE in PaymentService",
+              "transient": true
+            }
+          ]
+        }
+      }
+    },
+    {
+      "name": "schema-version-1",
+      "why": "schemaVersion is the const 2",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "const"
+      },
+      "message": {
+        "schemaVersion": 1,
+        "type": "job.event",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "state": "running",
+          "phase": "edit",
+          "iteration": 2,
+          "filesRead": 14,
+          "filesChanged": 1,
+          "tokensIn": 8200,
+          "tokensOut": 1300,
+          "costUsd": 0.042,
+          "durationMs": 61000,
+          "errorCode": "none"
+        }
+      }
+    },
+    {
+      "name": "missing-tenant-id",
+      "why": "tenantId is required on every frame",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "required"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "job.event",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "state": "running",
+          "phase": "edit",
+          "iteration": 2,
+          "filesRead": 14,
+          "filesChanged": 1,
+          "tokensIn": 8200,
+          "tokensOut": 1300,
+          "costUsd": 0.042,
+          "durationMs": 61000,
+          "errorCode": "none"
+        }
+      }
+    },
+    {
+      "name": "v1-legacy-command-frame",
+      "why": "a v1 command envelope is not a v2 frame",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "required"
+      },
+      "message": {
+        "requestId": "d4e5f6a7-b8c9-4d0e-9f1a-3b4c5d6e7f80",
+        "command": "mcp.execute-command",
+        "params": {
+          "command": "ls"
+        }
+      }
+    },
+    {
+      "name": "legacy-register",
+      "why": "the v1 register frame is not v2 (v1 path, no schemaVersion)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "required"
+      },
+      "message": {
+        "type": "register",
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "port": 5055,
+        "workspacePath": "/home/user/code"
+      }
+    },
+    {
+      "name": "ts-not-rfc3339-utc",
+      "why": "ts is RFC 3339 UTC",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "pattern"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "job.event",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29 10:00:00",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "state": "running",
+          "phase": "edit",
+          "iteration": 2,
+          "filesRead": 14,
+          "filesChanged": 1,
+          "tokensIn": 8200,
+          "tokensOut": 1300,
+          "costUsd": 0.042,
+          "durationMs": 61000,
+          "errorCode": "none"
+        }
+      }
+    },
+    {
+      "name": "negative-seq",
+      "why": "seq >= 0",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "minimum"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "job.event",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": -1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "jobId": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
+          "state": "running",
+          "phase": "edit",
+          "iteration": 2,
+          "filesRead": 14,
+          "filesChanged": 1,
+          "tokensIn": 8200,
+          "tokensOut": 1300,
+          "costUsd": 0.042,
+          "durationMs": 61000,
+          "errorCode": "none"
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,179 @@
+{
+  "type": "error",
+  "schema": "error.schema.json",
+  "vectors": [
+    {
+      "name": "minimal-valid",
+      "expect": {
+        "valid": true
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5"
+        },
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "extra-top-level-field",
+      "why": "envelope is closed (additionalProperties:false)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5"
+        },
+        "extra": "x",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "extra-payload-field",
+      "why": "payload is closed: no free-form fields",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5",
+          "freeText": "client text"
+        },
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "tenant-id-not-uuid",
+      "why": "tenantId must be a UUID",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "pattern"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "tenant-1",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5"
+        },
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "detail-above-200",
+      "why": "error.detail is bounded; never carries content",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "maxLength"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+        },
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "error-code-outside-enum",
+      "why": "error codes are an enum",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "enum"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "file_not_found_in_PaymentService",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5"
+        },
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
+      }
+    },
+    {
+      "name": "missing-agent-id",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "required"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "error",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 0,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "payload": {
+          "code": "seq_gap",
+          "retryable": true,
+          "refSeq": 7,
+          "detail": "expected seq 5"
+        }
+      },
+      "why": "agentId is required on ack/error (the gateway refuses a frame without it: agent_mismatch)"
+    }
+  ]
+}

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

@@ -0,0 +1,109 @@
+{
+  "type": "heartbeat",
+  "schema": "heartbeat.schema.json",
+  "vectors": [
+    {
+      "name": "minimal-valid",
+      "expect": {
+        "valid": true
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "heartbeat",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "signatureMode": "enforce",
+          "diskFreeBytes": 52428800000,
+          "queueDepth": 1,
+          "clockEpochMs": 1793268030000,
+          "inflight": 1
+        }
+      }
+    },
+    {
+      "name": "extra-top-level-field",
+      "why": "envelope is closed (additionalProperties:false)",
+      "expect": {
+        "valid": false,
+        "code": "schema_violation",
+        "keyword": "additionalProperties"
+      },
+      "message": {
+        "schemaVersion": 2,
+        "type": "heartbeat",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "signatureMode": "enforce",
+          "diskFreeBytes": 52428800000,
+          "queueDepth": 1,
+          "clockEpochMs": 1793268030000,
+          "inflight": 1
+        },
+        "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": "heartbeat",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "3f2b8c1e-5a4d-4e7b-9c21-0a1b2c3d4e5f",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "signatureMode": "enforce",
+          "diskFreeBytes": 52428800000,
+          "queueDepth": 1,
+          "clockEpochMs": 1793268030000,
+          "inflight": 1,
+          "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": "heartbeat",
+        "msgId": "00000000-0000-4000-8000-000000000001",
+        "seq": 1,
+        "tenantId": "tenant-1",
+        "workspaceId": "ws-1",
+        "ts": "2026-10-29T10:00:00Z",
+        "agentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "payload": {
+          "signatureMode": "enforce",
+          "diskFreeBytes": 52428800000,
+          "queueDepth": 1,
+          "clockEpochMs": 1793268030000,
+          "inflight": 1
+        }
+      }
+    }
+  ]
+}