@executioncontrolprotocol/types 0.10.0

package/dist/schemas/validation.result.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ValidationResult",
+  "definitions": {
+    "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"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "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/validation.result.json"
+}

package/dist/schemas/workflow.manifest.json

@@ -0,0 +1,451 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/WorkflowManifest",
+  "definitions": {
+    "WorkflowManifest": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.workflow"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "workflow": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkflowNode"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "workflow",
+        "steps"
+      ],
+      "additionalProperties": false,
+      "description": "Portable workflow manifest.",
+      "category": "Workflow"
+    },
+    "EcpVersion": {
+      "type": "string",
+      "description": "ECP semantic version literal.",
+      "category": "Common"
+    },
+    "WorkflowNode": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/StepNode"
+        },
+        {
+          "$ref": "#/definitions/ParallelNode"
+        },
+        {
+          "$ref": "#/definitions/BranchNode"
+        },
+        {
+          "$ref": "#/definitions/LoopNode"
+        }
+      ],
+      "description": "Workflow graph node union.",
+      "category": "Workflow"
+    },
+    "StepNode": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "step"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "uses": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/CapabilityId"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/InputValue"
+          }
+        },
+        "as": {
+          "type": "string",
+          "description": "State key for committed output (fluent `.as()`)."
+        },
+        "mode": {
+          "$ref": "#/definitions/CommitMode",
+          "description": "Commit mode when `as` is set (fluent `.as(key, { mode })`)."
+        },
+        "when": {
+          "$ref": "#/definitions/ExprValue"
+        }
+      },
+      "required": [
+        "id",
+        "uses"
+      ],
+      "additionalProperties": false,
+      "description": "Single capability step.",
+      "category": "Workflow"
+    },
+    "CapabilityId": {
+      "type": "string",
+      "description": "Capability id (`@namespace/name.capability`).",
+      "category": "Common"
+    },
+    "InputValue": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/InputValue"
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/InputValue"
+          }
+        },
+        {
+          "$ref": "#/definitions/RefValue"
+        },
+        {
+          "$ref": "#/definitions/StateValue"
+        },
+        {
+          "$ref": "#/definitions/EnvValue"
+        },
+        {
+          "$ref": "#/definitions/SecretValue"
+        },
+        {
+          "$ref": "#/definitions/BrowserValue"
+        }
+      ],
+      "description": "Input value allowed in step config.",
+      "category": "Workflow"
+    },
+    "RefValue": {
+      "type": "object",
+      "properties": {
+        "$ref": {
+          "type": "string",
+          "description": "State path prefixed with `state.` in manifests."
+        },
+        "optional": {
+          "type": "boolean",
+          "description": "When true, missing state does not fail resolution."
+        },
+        "fallback": {
+          "description": "Fallback when optional ref is missing."
+        }
+      },
+      "required": [
+        "$ref"
+      ],
+      "additionalProperties": false,
+      "description": "Workflow reference to committed state.",
+      "category": "Workflow"
+    },
+    "StateValue": {
+      "type": "object",
+      "properties": {
+        "$state": {
+          "type": "string",
+          "description": "State path for staged mutations."
+        },
+        "optional": {
+          "type": "boolean"
+        },
+        "fallback": {}
+      },
+      "required": [
+        "$state"
+      ],
+      "additionalProperties": false,
+      "description": "Mutable state handle in step input.",
+      "category": "Workflow"
+    },
+    "EnvValue": {
+      "type": "object",
+      "properties": {
+        "$env": {
+          "type": "string"
+        },
+        "optional": {
+          "type": "boolean"
+        },
+        "fallback": {}
+      },
+      "required": [
+        "$env"
+      ],
+      "additionalProperties": false,
+      "description": "Environment config secret reference (not portable in workflows).",
+      "category": "Environment"
+    },
+    "SecretValue": {
+      "type": "object",
+      "properties": {
+        "$secret": {
+          "type": "string",
+          "description": "Logical key in the OS secrets store."
+        },
+        "optional": {
+          "type": "boolean",
+          "description": "When true, missing secret does not fail resolution."
+        },
+        "fallback": {
+          "description": "Fallback when optional secret is missing."
+        }
+      },
+      "required": [
+        "$secret"
+      ],
+      "additionalProperties": false,
+      "description": "OS secrets reference (not portable in workflows).",
+      "category": "Environment"
+    },
+    "BrowserValue": {
+      "type": "object",
+      "properties": {
+        "$browser": {
+          "type": "string",
+          "description": "Logical key in the browser secrets vault."
+        },
+        "optional": {
+          "type": "boolean",
+          "description": "When true, missing secret does not fail resolution."
+        },
+        "fallback": {
+          "description": "Fallback when optional secret is missing."
+        }
+      },
+      "required": [
+        "$browser"
+      ],
+      "additionalProperties": false,
+      "description": "Browser encrypted secrets reference (not portable in workflows).",
+      "category": "Environment"
+    },
+    "CommitMode": {
+      "type": "string",
+      "enum": [
+        "create",
+        "replace",
+        "merge",
+        "append",
+        "version"
+      ],
+      "description": "Commit mode for step output.",
+      "category": "Workflow"
+    },
+    "ExprValue": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "eq": {
+              "type": "array",
+              "minItems": 2,
+              "items": [
+                {
+                  "type": "string"
+                },
+                {}
+              ],
+              "maxItems": 2
+            }
+          },
+          "required": [
+            "eq"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "neq": {
+              "type": "array",
+              "minItems": 2,
+              "items": [
+                {
+                  "type": "string"
+                },
+                {}
+              ],
+              "maxItems": 2
+            }
+          },
+          "required": [
+            "neq"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "additionalProperties": {}
+        }
+      ],
+      "description": "Expression value in workflow conditions.",
+      "category": "Workflow"
+    },
+    "ParallelNode": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "parallel"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "branches": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/WorkflowNode"
+            }
+          }
+        }
+      },
+      "required": [
+        "type",
+        "id",
+        "branches"
+      ],
+      "additionalProperties": false,
+      "description": "Parallel branches.",
+      "category": "Workflow"
+    },
+    "BranchNode": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "branch"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "branches": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "when": {
+                "$ref": "#/definitions/ExprValue"
+              },
+              "steps": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/WorkflowNode"
+                }
+              }
+            },
+            "required": [
+              "when",
+              "steps"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "type",
+        "id",
+        "branches"
+      ],
+      "additionalProperties": false,
+      "description": "Conditional branches.",
+      "category": "Workflow"
+    },
+    "LoopNode": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "loop"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "until": {
+          "$ref": "#/definitions/ExprValue"
+        },
+        "maxRounds": {
+          "type": "number"
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkflowNode"
+          }
+        }
+      },
+      "required": [
+        "type",
+        "id",
+        "steps"
+      ],
+      "additionalProperties": false,
+      "description": "Loop until condition.",
+      "category": "Workflow"
+    }
+  },
+  "$id": "https://ecp.dev/schemas/workflow.manifest.json"
+}

package/dist/store.d.ts

@@ -0,0 +1,30 @@
+/** Staged store mutation during capability execution. @category Runtime */
+export interface PendingMutation {
+    id: string;
+    op: "set" | "replace" | "merge" | "append";
+    path: string;
+    value: unknown;
+    reason?: string;
+    metadata?: Record<string, unknown>;
+    status: "pending";
+}
+/** Committed or denied mutation record. @category Runtime */
+export interface MutationRecord {
+    id: string;
+    op: "set" | "replace" | "merge" | "append";
+    path: string;
+    before: unknown;
+    after: unknown;
+    reason?: string;
+    metadata?: Record<string, unknown>;
+    status: "committed" | "denied" | "discarded" | "failed";
+    stepId: string;
+    capability: string;
+    timestamp: string;
+}
+/** Opaque mutable state handle from `state()`. @category Workflow */
+export interface StoreStateHandle<T = unknown> {
+    readonly path: string;
+    readonly __brand: T;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,SAAS,CAAA;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CACpB"}

package/dist/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,20 @@
+import type { EcpVersion } from "./version.js";
+/** Validation issue severity. @category Validation */
+export type ValidationSeverity = "error" | "warning" | "info";
+/** Single validation issue. @category Validation */
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    path?: string;
+    suggestions?: string[];
+    severity?: ValidationSeverity;
+}
+/** Validation result document. @category Validation */
+export interface ValidationResult {
+    schema: "@executioncontrolprotocol.validation.result";
+    version: EcpVersion;
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7D,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,6CAA6C,CAAA;IACrD,OAAO,EAAE,UAAU,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B"}

package/dist/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+/** Current ECP manifest version string. @category Common */
+export declare const LATEST_ECP_VERSION: "1.0";
+/** ECP semantic version literal. @category Common */
+export type EcpVersion = `${number}.${number}`;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,EAAG,KAAc,CAAA;AAEhD,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** Current ECP manifest version string. @category Common */
+export const LATEST_ECP_VERSION = "1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAc,CAAA"}

package/dist/workflow.d.ts

@@ -0,0 +1,55 @@
+import type { CapabilityId, CommitMode, ExprValue, InputValue } from "./schema.js";
+import type { EcpVersion } from "./version.js";
+/** Portable workflow manifest. @category Workflow */
+export interface WorkflowManifest {
+    schema: "@executioncontrolprotocol.workflow";
+    version: EcpVersion;
+    workflow: {
+        id: string;
+        label?: string;
+    };
+    steps: WorkflowNode[];
+}
+/** Workflow graph node union. @category Workflow */
+export type WorkflowNode = StepNode | ParallelNode | BranchNode | LoopNode;
+/** Single capability step. @category Workflow */
+export interface StepNode {
+    type?: "step";
+    id: string;
+    label?: string;
+    uses: CapabilityId | string;
+    input?: Record<string, InputValue>;
+    /** State key for committed output (fluent `.as()`). */
+    as?: string;
+    /** Commit mode when `as` is set (fluent `.as(key, { mode })`). */
+    mode?: CommitMode;
+    when?: ExprValue;
+}
+/** Parallel branches. @category Workflow */
+export interface ParallelNode {
+    type: "parallel";
+    id: string;
+    label?: string;
+    branches: WorkflowNode[][];
+}
+/** Conditional branches. @category Workflow */
+export interface BranchNode {
+    type: "branch";
+    id: string;
+    label?: string;
+    branches: Array<{
+        label?: string;
+        when: ExprValue;
+        steps: WorkflowNode[];
+    }>;
+}
+/** Loop until condition. @category Workflow */
+export interface LoopNode {
+    type: "loop";
+    id: string;
+    label?: string;
+    until?: ExprValue;
+    maxRounds?: number;
+    steps: WorkflowNode[];
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,oCAAoC,CAAA;IAC5C,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAED,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAA;AAE1E,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,GAAG,MAAM,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,YAAY,EAAE,EAAE,CAAA;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,SAAS,CAAA;QACf,KAAK,EAAE,YAAY,EAAE,CAAA;KACtB,CAAC,CAAA;CACH;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB"}