agent-scenario-loop 0.1.2 → 0.1.3

package/schemas/external-adapter-message.schema.json

@@ -0,0 +1,693 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-scenario-loop.dev/schemas/external-adapter-message.schema.json",
+  "title": "Agent Scenario Loop External Adapter Message",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocolVersion", "seq", "operationId", "kind", "type", "body"],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          }
+        },
+        "required": ["kind"]
+      },
+      "then": {
+        "properties": {
+          "type": {
+            "$ref": "#/$defs/requestType"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "response"
+          }
+        },
+        "required": ["kind"]
+      },
+      "then": {
+        "properties": {
+          "type": {
+            "$ref": "#/$defs/requestType"
+          },
+          "body": {
+            "$ref": "#/$defs/responseBody"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "event"
+          }
+        },
+        "required": ["kind"]
+      },
+      "then": {
+        "properties": {
+          "type": {
+            "$ref": "#/$defs/eventType"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "hello"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "body": {
+            "$ref": "#/$defs/helloRequestBody"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "prepare"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/prepareRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "launch"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/targetRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "executeAction"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/executeActionRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "waitCondition"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/waitConditionRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "captureEvidence"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/captureEvidenceRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "const": "cancel"
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "$ref": "#/$defs/cancelRequestBody"
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "request"
+          },
+          "type": {
+            "enum": ["stop", "finalize"]
+          }
+        },
+        "required": ["kind", "type"]
+      },
+      "then": {
+        "properties": {
+          "runId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "attemptId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "deadline": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "body": {
+            "type": "object",
+            "additionalProperties": false
+          }
+        },
+        "required": ["runId", "attemptId", "deadline"]
+      }
+    }
+  ],
+  "properties": {
+    "protocolVersion": {
+      "type": "string",
+      "pattern": "^1\\.0$"
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "operationId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["request", "response", "event"]
+    },
+    "type": {
+      "type": "string",
+      "minLength": 1
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "attemptId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "deadline": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "body": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "requestType": {
+      "type": "string",
+      "enum": ["hello", "prepare", "launch", "executeAction", "waitCondition", "captureEvidence", "cancel", "stop", "finalize"]
+    },
+    "eventType": {
+      "type": "string",
+      "enum": ["truthEvent", "progress", "evidence"]
+    },
+    "timestamp": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    },
+    "platform": {
+      "type": "string",
+      "enum": ["android", "ios"]
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "version": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path", "contentType"],
+      "properties": {
+        "kind": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "path": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "contentType": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "description": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "artifactList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/artifact"
+      }
+    },
+    "fileReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "contentType"],
+      "properties": {
+        "path": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "contentType": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "description": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1
+    },
+    "selector": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1
+    },
+    "helloRequestBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["host", "platform"],
+      "properties": {
+        "host": {
+          "$ref": "#/$defs/identity"
+        },
+        "platform": {
+          "$ref": "#/$defs/platform"
+        }
+      }
+    },
+    "prepareRequestBody": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["platform", "target"],
+      "properties": {
+        "platform": {
+          "$ref": "#/$defs/platform"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "artifactsRoot": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "targetRequestBody": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["platform", "target"],
+      "properties": {
+        "platform": {
+          "$ref": "#/$defs/platform"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        }
+      }
+    },
+    "executeActionRequestBody": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["driverAction"],
+      "properties": {
+        "driverAction": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "selector": {
+          "$ref": "#/$defs/selector"
+        }
+      }
+    },
+    "waitConditionRequestBody": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["condition", "clockDomain"],
+      "properties": {
+        "condition": {
+          "type": "object",
+          "additionalProperties": true,
+          "minProperties": 1
+        },
+        "clockDomain": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "captureEvidenceRequestBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kinds"],
+      "properties": {
+        "kinds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        }
+      }
+    },
+    "cancelRequestBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetOperationId", "reason"],
+      "properties": {
+        "targetOperationId": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "reason": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "responseBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok"],
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "ok": {
+                "const": true
+              }
+            },
+            "required": ["ok"]
+          },
+          "then": {
+            "required": ["result"],
+            "properties": {
+              "result": {
+                "$ref": "#/$defs/responseResult"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "ok": {
+                "const": false
+              }
+            },
+            "required": ["ok"]
+          },
+          "then": {
+            "required": ["failure"],
+            "properties": {
+              "failure": {
+                "$ref": "#/$defs/failure"
+              }
+            }
+          }
+        }
+      ],
+      "properties": {
+        "ok": {
+          "type": "boolean"
+        },
+        "result": {
+          "$ref": "#/$defs/responseResult"
+        },
+        "failure": {
+          "$ref": "#/$defs/failure"
+        }
+      }
+    },
+    "responseResult": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "adapter": {
+          "$ref": "#/$defs/identity"
+        },
+        "acceptedProtocolVersion": {
+          "type": "string",
+          "pattern": "^1\\.0$"
+        },
+        "platforms": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/platform"
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "driverActions": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "artifactOutputs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "clockDomains": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifactList"
+        },
+        "raw": {
+          "$ref": "#/$defs/fileReference"
+        },
+        "truthEvent": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["name", "observedAt"],
+          "properties": {
+            "name": {
+              "$ref": "#/$defs/nonEmptyString"
+            },
+            "observedAt": {
+              "$ref": "#/$defs/timestamp"
+            }
+          }
+        }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "retryable"],
+      "properties": {
+        "code": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "message": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "category": {
+          "type": "string",
+          "enum": ["adapter", "cancelled", "cleanup", "deadline", "environment", "protocol", "runner", "unsupported"]
+        },
+        "details": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    }
+  }
+}