@executioncontrolprotocol/types 0.10.0

package/dist/schemas/encode.result.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/EncodeResultDocument",
+  "definitions": {
+    "EncodeResultDocument": {
+      "$ref": "#/definitions/EncodeResult%3Cunknown%3E",
+      "description": "Concrete encode result for schema generation.",
+      "category": "Encoding"
+    },
+    "EncodeResult<unknown>": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.encode.result"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "format": {
+          "type": "string"
+        },
+        "sourceSchema": {
+          "$ref": "#/definitions/EcpSchema"
+        },
+        "sourceVersion": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "mediaType": {
+          "type": "string"
+        },
+        "result": {},
+        "validation": {
+          "$ref": "#/definitions/ValidationResult"
+        },
+        "diagnostics": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ValidationIssue"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "success",
+        "format",
+        "diagnostics"
+      ],
+      "additionalProperties": false,
+      "description": "Encode operation result.",
+      "category": "Encoding"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "EcpSchema": {
+      "type": "string",
+      "enum": [
+        "@executioncontrolprotocol.workflow",
+        "@executioncontrolprotocol.environment",
+        "@executioncontrolprotocol.environment.describe",
+        "@executioncontrolprotocol.environment.search",
+        "@executioncontrolprotocol.run.request",
+        "@executioncontrolprotocol.run.result",
+        "@executioncontrolprotocol.run.event",
+        "@executioncontrolprotocol.validation.result",
+        "@executioncontrolprotocol.patch",
+        "@executioncontrolprotocol.patch.result",
+        "@executioncontrolprotocol.encode.result",
+        "@executioncontrolprotocol.decode.result",
+        "@executioncontrolprotocol.intent",
+        "@executioncontrolprotocol.harness.reply"
+      ],
+      "description": "Serialized object schema discriminator.",
+      "category": "Common"
+    },
+    "ValidationResult": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.validation.result"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "valid": {
+          "type": "boolean"
+        },
+        "errors": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ValidationIssue"
+          }
+        },
+        "warnings": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ValidationIssue"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "valid",
+        "errors",
+        "warnings"
+      ],
+      "additionalProperties": false,
+      "description": "Validation result document.",
+      "category": "Validation"
+    },
+    "ValidationIssue": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "suggestions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "severity": {
+          "$ref": "#/definitions/ValidationSeverity"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "additionalProperties": false,
+      "description": "Single validation issue.",
+      "category": "Validation"
+    },
+    "ValidationSeverity": {
+      "type": "string",
+      "enum": [
+        "error",
+        "warning",
+        "info"
+      ],
+      "description": "Validation issue severity.",
+      "category": "Validation"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/encode.result.json"
+}

package/dist/schemas/environment.describe.json

@@ -0,0 +1,210 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/EnvironmentDescriptor",
+  "definitions": {
+    "EnvironmentDescriptor": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.environment.describe"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "environment": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "runtime": {
+          "$ref": "#/definitions/RuntimeDescription"
+        },
+        "extensions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExtensionDescription"
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CapabilityDescription"
+          }
+        },
+        "policies": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PolicyDescription"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "environment",
+        "runtime",
+        "extensions",
+        "capabilities",
+        "policies"
+      ],
+      "additionalProperties": false,
+      "description": "Environment descriptor for discovery.",
+      "category": "Environment"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "RuntimeDescription": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "features": {
+          "$ref": "#/definitions/RuntimeFeatures"
+        }
+      },
+      "required": [
+        "id",
+        "features"
+      ],
+      "additionalProperties": false,
+      "description": "Runtime section of descriptor.",
+      "category": "Environment"
+    },
+    "RuntimeFeatures": {
+      "type": "object",
+      "properties": {
+        "durableExecution": {
+          "type": "boolean"
+        },
+        "loops": {
+          "type": "boolean"
+        },
+        "parallel": {
+          "type": "boolean"
+        },
+        "branches": {
+          "type": "boolean"
+        },
+        "pauses": {
+          "type": "boolean"
+        },
+        "cancellation": {
+          "type": "boolean"
+        },
+        "longRunningWorkflows": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Runtime feature flags for validation.",
+      "category": "Environment"
+    },
+    "ExtensionDescription": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "order": {
+          "type": "number"
+        },
+        "configSchema": {},
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "supportedRuntimes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Runtimes this extension supports when restricted; omitted when universal."
+        }
+      },
+      "required": [
+        "id",
+        "order",
+        "capabilities"
+      ],
+      "additionalProperties": false,
+      "description": "Extension section of descriptor.",
+      "category": "Environment"
+    },
+    "CapabilityDescription": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "extension": {
+          "type": "string"
+        },
+        "inputSchema": {},
+        "outputSchema": {},
+        "examples": {
+          "type": "array",
+          "items": {}
+        }
+      },
+      "required": [
+        "id",
+        "extension"
+      ],
+      "additionalProperties": false,
+      "description": "Capability metadata in descriptor.",
+      "category": "Environment"
+    },
+    "PolicyDescription": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "summary": {
+          "type": "string"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {}
+        },
+        "configSchema": {}
+      },
+      "required": [
+        "id"
+      ],
+      "additionalProperties": false,
+      "description": "Policy metadata in descriptor.",
+      "category": "Environment"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/environment.describe.json"
+}

package/dist/schemas/environment.manifest.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/EnvironmentManifest",
+  "definitions": {
+    "EnvironmentManifest": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.environment"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "environment": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "runtime": {
+          "$ref": "#/definitions/RuntimeBindingManifest"
+        },
+        "extensions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExtensionBindingManifest"
+          }
+        },
+        "policies": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PolicyBindingManifest"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "environment"
+      ],
+      "additionalProperties": false,
+      "description": "Environment manifest (bindings only).",
+      "category": "Environment"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "RuntimeBindingManifest": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/NamespacedId"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "label": {
+          "type": "string"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "additionalProperties": false,
+      "description": "Runtime binding in environment manifest.",
+      "category": "Environment"
+    },
+    "NamespacedId": {
+      "type": "string",
+      "description": "Namespaced definition id (`@namespace/name`).",
+      "category": "Common"
+    },
+    "ExtensionBindingManifest": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/NamespacedId"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "label": {
+          "type": "string"
+        },
+        "order": {
+          "type": "number"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "order"
+      ],
+      "additionalProperties": false,
+      "description": "Extension binding in environment manifest.",
+      "category": "Environment"
+    },
+    "PolicyBindingManifest": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/NamespacedId"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "label": {
+          "type": "string"
+        },
+        "order": {
+          "type": "number"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "order"
+      ],
+      "additionalProperties": false,
+      "description": "Policy binding in environment manifest.",
+      "category": "Environment"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/environment.manifest.json"
+}

package/dist/schemas/environment.search.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/SearchResult",
+  "definitions": {
+    "SearchResult": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.environment.search"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "results": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SearchResultItem"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "results"
+      ],
+      "additionalProperties": false,
+      "description": "Search response.",
+      "category": "Environment"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "SearchResultItem": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "score": {
+          "type": "number"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "inputSchema": {
+          "description": "Present when requested via  {@link  SearchOptions.include } ."
+        },
+        "outputSchema": {
+          "description": "Present when requested via  {@link  SearchOptions.include } ."
+        }
+      },
+      "required": [
+        "type",
+        "id",
+        "score"
+      ],
+      "additionalProperties": false,
+      "description": "Search result item.",
+      "category": "Environment"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/environment.search.json"
+}

package/dist/schemas/patch.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/EcpPatchDocumentRecord",
+  "definitions": {
+    "EcpPatchDocumentRecord": {
+      "$ref": "#/definitions/EcpPatchDocument",
+      "description": "Concrete patch document for schema generation.",
+      "category": "Patch"
+    },
+    "EcpPatchDocument": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.patch"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "targetSchema": {
+          "$ref": "#/definitions/EcpSchema"
+        },
+        "patches": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EcpPatchEntry"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "targetSchema",
+        "patches"
+      ],
+      "additionalProperties": false,
+      "description": "Canonical patch document.",
+      "category": "Patch"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "EcpSchema": {
+      "type": "string",
+      "enum": [
+        "@executioncontrolprotocol.workflow",
+        "@executioncontrolprotocol.environment",
+        "@executioncontrolprotocol.environment.describe",
+        "@executioncontrolprotocol.environment.search",
+        "@executioncontrolprotocol.run.request",
+        "@executioncontrolprotocol.run.result",
+        "@executioncontrolprotocol.run.event",
+        "@executioncontrolprotocol.validation.result",
+        "@executioncontrolprotocol.patch",
+        "@executioncontrolprotocol.patch.result",
+        "@executioncontrolprotocol.encode.result",
+        "@executioncontrolprotocol.decode.result",
+        "@executioncontrolprotocol.intent",
+        "@executioncontrolprotocol.harness.reply"
+      ],
+      "description": "Serialized object schema discriminator.",
+      "category": "Common"
+    },
+    "EcpPatchEntry": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "ECP path using `steps[<stepId>]` (not labels)."
+        },
+        "mode": {
+          "$ref": "#/definitions/PatchMode",
+          "description": "Defaults to `merge`."
+        },
+        "value": {
+          "description": "Partial or full JSON value."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Optional audit reason."
+        }
+      },
+      "required": [
+        "path",
+        "value"
+      ],
+      "additionalProperties": false,
+      "description": "Single patch entry.",
+      "category": "Patch"
+    },
+    "PatchMode": {
+      "type": "string",
+      "enum": [
+        "merge",
+        "replace"
+      ],
+      "description": "Patch merge mode.",
+      "category": "Patch"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/patch.json"
+}