@executioncontrolprotocol/types 0.10.0

package/dist/lifecycle.d.ts

@@ -0,0 +1,27 @@
+/** Run lifecycle events. @category Lifecycle */
+export type RunLifecycleEvent = "run:before" | "run:started" | "run:completed" | "run:failed" | "run:cancelled" | "run:finally";
+/** Step lifecycle events. @category Lifecycle */
+export type StepLifecycleEvent = "step:before" | "step:started" | "step:completed" | "step:failed" | "step:cancelled" | "step:paused" | "step:finally";
+/** Policy lifecycle events. @category Lifecycle */
+export type PolicyLifecycleEvent = "policy:pre" | "policy:post" | "policy:finally";
+/** Environment lifecycle events. @category Lifecycle */
+export type EnvironmentLifecycleEvent = "environment:created" | "environment:configuring" | "environment:ready" | "environment:beforeRun" | "environment:terminate";
+/** All public lifecycle events. @category Lifecycle */
+export type LifecycleEvent = EnvironmentLifecycleEvent | RunLifecycleEvent | StepLifecycleEvent | PolicyLifecycleEvent;
+/** Policy hook decision. @category Policies */
+export type PolicyDecision = {
+    type: "allow";
+} | {
+    type: "deny";
+    reason: string;
+    code?: string;
+} | {
+    type: "pause";
+    reason: string;
+    approval?: unknown;
+} | {
+    type: "modify";
+    patch: unknown;
+    reason?: string;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,aAAa,GACb,eAAe,GACf,YAAY,GACZ,eAAe,GACf,aAAa,CAAA;AAEjB,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,cAAc,CAAA;AAElB,mDAAmD;AACnD,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,aAAa,GACb,gBAAgB,CAAA;AAEpB,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,GACjC,qBAAqB,GACrB,yBAAyB,GACzB,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,CAAA;AAE3B,uDAAuD;AACvD,MAAM,MAAM,cAAc,GACtB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,CAAA;AAExB,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/lifecycle.js

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

package/dist/lifecycle.js.map

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

package/dist/model.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import type { GenerateCapabilityInput, GenerateCapabilityOutput } from "./capabilities.js";
+/** Interface tag for harness-compatible model providers. @category Harness */
+export declare const ECP_MODEL_GENERATE_INTERFACE: "@executioncontrolprotocol/model.generate";
+/** Reserved capability name for model providers used by harnesses. @category Harness */
+export declare const ECP_MODEL_CAPABILITY_NAME: "generate";
+/** Response format hint for model generation. @category Harness */
+export declare const ECP_MODEL_RESPONSE_FORMATS: {
+    readonly TEXT: "text";
+    readonly JSON: "json";
+    readonly TOON: "toon";
+};
+/** Model response format union. @category Harness */
+export type EcpModelResponseFormat = (typeof ECP_MODEL_RESPONSE_FORMATS)[keyof typeof ECP_MODEL_RESPONSE_FORMATS];
+/** Normalized model generate input. @category Harness */
+export declare const modelGenerateInputSchema: z.ZodObject<{
+    /** User/model prompt body. */
+    prompt: z.ZodString;
+    /** System instruction. */
+    system: z.ZodOptional<z.ZodString>;
+    /** Model override. */
+    model: z.ZodOptional<z.ZodString>;
+    /** Optional provider context blob. */
+    context: z.ZodOptional<z.ZodUnknown>;
+    /** Output format hint for providers without native support. */
+    responseFormat: z.ZodOptional<z.ZodEnum<["text", "json", "toon", "eql"]>>;
+    /** Provider-specific options (e.g. temperature, top_p for Ollama). */
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    options?: Record<string, unknown> | undefined;
+    model?: string | undefined;
+    system?: string | undefined;
+    context?: unknown;
+    responseFormat?: "json" | "toon" | "eql" | "text" | undefined;
+}, {
+    prompt: string;
+    options?: Record<string, unknown> | undefined;
+    model?: string | undefined;
+    system?: string | undefined;
+    context?: unknown;
+    responseFormat?: "json" | "toon" | "eql" | "text" | undefined;
+}>;
+/** Normalized model generate input type. @category Harness */
+export type ModelGenerateInput = GenerateCapabilityInput & z.infer<typeof modelGenerateInputSchema>;
+/** Normalized model generate output. @category Harness */
+export declare const modelGenerateOutputSchema: z.ZodObject<{
+    /** Generated text content. */
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+}, {
+    text: string;
+}>;
+/** Normalized model generate output type. @category Harness */
+export type ModelGenerateOutput = GenerateCapabilityOutput & z.infer<typeof modelGenerateOutputSchema>;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAE1F,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,EAAG,0CAAmD,CAAA;AAE/F,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,EAAG,UAAmB,CAAA;AAE5D,mEAAmE;AACnE,eAAO,MAAM,0BAA0B;;;;CAI7B,CAAA;AAEV,qDAAqD;AACrD,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAA;AAE9E,yDAAyD;AACzD,eAAO,MAAM,wBAAwB;IACnC,8BAA8B;;IAE9B,0BAA0B;;IAE1B,sBAAsB;;IAEtB,sCAAsC;;IAEtC,+DAA+D;;IAE/D,sEAAsE;;;;;;;;;;;;;;;;EAEtE,CAAA;AAEF,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GACtD,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB;IACpC,8BAA8B;;;;;;EAE9B,CAAA;AAEF,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,GACxD,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/model.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+/** Interface tag for harness-compatible model providers. @category Harness */
+export const ECP_MODEL_GENERATE_INTERFACE = "@executioncontrolprotocol/model.generate";
+/** Reserved capability name for model providers used by harnesses. @category Harness */
+export const ECP_MODEL_CAPABILITY_NAME = "generate";
+/** Response format hint for model generation. @category Harness */
+export const ECP_MODEL_RESPONSE_FORMATS = {
+    TEXT: "text",
+    JSON: "json",
+    TOON: "toon",
+};
+/** Normalized model generate input. @category Harness */
+export const modelGenerateInputSchema = z.object({
+    /** User/model prompt body. */
+    prompt: z.string(),
+    /** System instruction. */
+    system: z.string().optional(),
+    /** Model override. */
+    model: z.string().optional(),
+    /** Optional provider context blob. */
+    context: z.unknown().optional(),
+    /** Output format hint for providers without native support. */
+    responseFormat: z.enum(["text", "json", "toon", "eql"]).optional(),
+    /** Provider-specific options (e.g. temperature, top_p for Ollama). */
+    options: z.record(z.string(), z.unknown()).optional(),
+});
+/** Normalized model generate output. @category Harness */
+export const modelGenerateOutputSchema = z.object({
+    /** Generated text content. */
+    text: z.string(),
+});
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,0CAAmD,CAAA;AAE/F,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAmB,CAAA;AAE5D,mEAAmE;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAA;AAMV,yDAAyD;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,8BAA8B;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,0BAA0B;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,sBAAsB;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,+DAA+D;IAC/D,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAA;AAMF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,8BAA8B;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA"}

package/dist/patch-errors.d.ts

@@ -0,0 +1,11 @@
+/** Patch operation error codes. @category Patch */
+export declare const ECP_PATCH_ERROR_CODES: {
+    readonly DUPLICATE_STEP_ID: "DUPLICATE_STEP_ID";
+    readonly PATCH_PATH_NOT_FOUND: "PATCH_PATH_NOT_FOUND";
+    readonly PATCH_PATH_UNSUPPORTED: "PATCH_PATH_UNSUPPORTED";
+    readonly PATCH_APPLY_FAILED: "PATCH_APPLY_FAILED";
+    readonly PATCH_INVALID_DOCUMENT: "PATCH_INVALID_DOCUMENT";
+};
+/** Patch error code union. @category Patch */
+export type EcpPatchErrorCode = (typeof ECP_PATCH_ERROR_CODES)[keyof typeof ECP_PATCH_ERROR_CODES];
+//# sourceMappingURL=patch-errors.d.ts.map

package/dist/patch-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-errors.d.ts","sourceRoot":"","sources":["../src/patch-errors.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAA;AAEV,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/patch-errors.js

@@ -0,0 +1,9 @@
+/** Patch operation error codes. @category Patch */
+export const ECP_PATCH_ERROR_CODES = {
+    DUPLICATE_STEP_ID: "DUPLICATE_STEP_ID",
+    PATCH_PATH_NOT_FOUND: "PATCH_PATH_NOT_FOUND",
+    PATCH_PATH_UNSUPPORTED: "PATCH_PATH_UNSUPPORTED",
+    PATCH_APPLY_FAILED: "PATCH_APPLY_FAILED",
+    PATCH_INVALID_DOCUMENT: "PATCH_INVALID_DOCUMENT",
+};
+//# sourceMappingURL=patch-errors.js.map

package/dist/patch-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-errors.js","sourceRoot":"","sources":["../src/patch-errors.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,sBAAsB,EAAE,wBAAwB;CACxC,CAAA"}

package/dist/patch.d.ts

@@ -0,0 +1,51 @@
+import type { EcpSchema } from "./schema.js";
+import type { EcpVersion } from "./version.js";
+import type { ValidationIssue } from "./validation.js";
+import type { ValidationResult } from "./validation.js";
+/** Patch merge mode. @category Patch */
+export type PatchMode = "merge" | "replace";
+/** Single patch entry. @category Patch */
+export interface EcpPatchEntry {
+    /** ECP path using `steps[<stepId>]` (not labels). */
+    path: string;
+    /** Defaults to `merge`. */
+    mode?: PatchMode;
+    /** Partial or full JSON value. */
+    value: unknown;
+    /** Optional audit reason. */
+    reason?: string;
+}
+/** Canonical patch document. @category Patch */
+export interface EcpPatchDocument {
+    schema: "@executioncontrolprotocol.patch";
+    version: EcpVersion;
+    targetSchema: EcpSchema;
+    patches: EcpPatchEntry[];
+}
+/** Shorthand or canonical patch input. @category Patch */
+export type EcpPatchInput = EcpPatchDocument | EcpPatchEntry[] | Record<string, unknown>;
+/** Applied patch entry record. @category Patch */
+export interface AppliedPatchEntry {
+    path: string;
+    mode: PatchMode;
+    success: boolean;
+    diagnostics?: ValidationIssue[];
+}
+/** Result from `ecp.patch(...).process()`. @category Patch */
+export interface PatchResult<T = unknown> {
+    schema: "@executioncontrolprotocol.patch.result";
+    version: EcpVersion;
+    success: boolean;
+    targetSchema: EcpSchema;
+    targetVersion?: EcpVersion;
+    result?: T;
+    patch?: EcpPatchDocument;
+    applied: AppliedPatchEntry[];
+    validation?: ValidationResult;
+    diagnostics: ValidationIssue[];
+}
+/** Concrete patch result for schema generation. @category Patch */
+export type PatchResultDocument = PatchResult<unknown>;
+/** Concrete patch document for schema generation. @category Patch */
+export type EcpPatchDocumentRecord = EcpPatchDocument;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,wCAAwC;AACxC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3C,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iCAAiC,CAAA;IACzC,OAAO,EAAE,UAAU,CAAA;IACnB,YAAY,EAAE,SAAS,CAAA;IACvB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAExF,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;CAChC;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,wCAAwC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,SAAS,CAAA;IACvB,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;AAED,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAEtD,qEAAqE;AACrE,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAA"}

package/dist/patch.js

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

package/dist/patch.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+import type { NamespacedId } from "./schema.js";
+/** Source of a dynamic registry registration request. @category Policies */
+export type RegistryRegistrationSourceType = "browser-global" | "environment-api" | "direct-registry";
+/** Registry operation evaluated by environment policies before acceptance. @category Policies */
+export interface RegistryRegistrationRequest {
+    /** Kind of definition being registered. */
+    kind: "extension" | "policy" | "runtime";
+    /** Namespaced id of the definition. */
+    id: NamespacedId;
+    /** Definition payload when available. */
+    definition?: unknown;
+    /** Whether the host will auto-bind after registration. */
+    autoBindRequested?: boolean;
+    /** Provenance of the registration call. */
+    source?: {
+        /** How registration was initiated. */
+        type: RegistryRegistrationSourceType;
+        /** Optional page URL for browser-global registration. */
+        url?: string;
+    };
+}
+/** Policy evaluation scope for non-step checks. @category Policies */
+export type PolicyEvaluationScope = "environment" | "run" | "step" | "invoke";
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,4EAA4E;AAC5E,MAAM,MAAM,8BAA8B,GACtC,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,CAAA;AAErB,iGAAiG;AACjG,MAAM,WAAW,2BAA2B;IAC1C,2CAA2C;IAC3C,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IACxC,uCAAuC;IACvC,EAAE,EAAE,YAAY,CAAA;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE;QACP,sCAAsC;QACtC,IAAI,EAAE,8BAA8B,CAAA;QACpC,yDAAyD;QACzD,GAAG,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAED,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA"}

package/dist/registry.js

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

package/dist/registry.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,35 @@
+import type { RunStatus } from "./schema.js";
+import type { EcpVersion } from "./version.js";
+import type { MutationRecord } from "./store.js";
+import type { WorkflowManifest } from "./workflow.js";
+/** Run request document. @category Runtime */
+export interface RunRequest {
+    schema: "@executioncontrolprotocol.run.request";
+    version: EcpVersion;
+    workflow: WorkflowManifest;
+    input?: Record<string, unknown>;
+    actor?: Record<string, unknown>;
+    dryRun?: boolean;
+}
+/** Per-step run history record. @category Runtime */
+export interface StepRunRecord {
+    status: RunStatus;
+    output?: unknown;
+    committedAs?: string | null;
+    attempts?: number;
+    usage?: Record<string, unknown>;
+    mutations?: MutationRecord[];
+}
+/** Run result document. @category Runtime */
+export interface RunResult {
+    schema: "@executioncontrolprotocol.run.result";
+    version: EcpVersion;
+    run: {
+        id: string;
+        status: RunStatus;
+    };
+    state?: Record<string, unknown>;
+    history?: Record<string, StepRunRecord>;
+    usage?: Record<string, unknown>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,uCAAuC,CAAA;IAC/C,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAA;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,sCAAsC,CAAA;IAC9C,OAAO,EAAE,UAAU,CAAA;IACnB,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,SAAS,CAAA;KAClB,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC"}

package/dist/run.js

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

package/dist/run.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,67 @@
+import type { EcpVersion } from "./version.js";
+/** Serialized object schema discriminator. @category Common */
+export type EcpSchema = "@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";
+/** Namespaced definition id (`@namespace/name`). @category Common */
+export type NamespacedId = `@${string}/${string}`;
+/** Capability id (`@namespace/name.capability`). @category Common */
+export type CapabilityId = `${NamespacedId}.${string}`;
+/** Commit mode for step output. @category Workflow */
+export type CommitMode = "create" | "replace" | "merge" | "append" | "version";
+/** Run status. @category Runtime */
+export type RunStatus = "created" | "started" | "completed" | "failed" | "cancelled" | "paused";
+/** Workflow reference to committed state. @category Workflow */
+export interface RefValue {
+    /** State path prefixed with `state.` in manifests. */
+    $ref: string;
+    /** When true, missing state does not fail resolution. */
+    optional?: boolean;
+    /** Fallback when optional ref is missing. */
+    fallback?: unknown;
+}
+/** Mutable state handle in step input. @category Workflow */
+export interface StateValue {
+    /** State path for staged mutations. */
+    $state: string;
+    optional?: boolean;
+    fallback?: unknown;
+}
+/** Environment config secret reference (not portable in workflows). @category Environment */
+export interface EnvValue {
+    $env: string;
+    optional?: boolean;
+    fallback?: unknown;
+}
+/** OS secrets reference (not portable in workflows). @category Environment */
+export interface SecretValue {
+    /** Logical key in the OS secrets store. */
+    $secret: string;
+    /** When true, missing secret does not fail resolution. */
+    optional?: boolean;
+    /** Fallback when optional secret is missing. */
+    fallback?: unknown;
+}
+/** Browser encrypted secrets reference (not portable in workflows). @category Environment */
+export interface BrowserValue {
+    /** Logical key in the browser secrets vault. */
+    $browser: string;
+    /** When true, missing secret does not fail resolution. */
+    optional?: boolean;
+    /** Fallback when optional secret is missing. */
+    fallback?: unknown;
+}
+/** Expression value in workflow conditions. @category Workflow */
+export type ExprValue = {
+    eq: [string, unknown];
+} | {
+    neq: [string, unknown];
+} | Record<string, unknown>;
+/** Input value allowed in step config. @category Workflow */
+export type InputValue = string | number | boolean | null | InputValue[] | {
+    [key: string]: InputValue;
+} | RefValue | StateValue | EnvValue | SecretValue | BrowserValue;
+/** Base fields on serialized ECP objects. @category Common */
+export interface EcpDocumentBase {
+    schema: EcpSchema;
+    version: EcpVersion;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GACjB,oCAAoC,GACpC,uCAAuC,GACvC,gDAAgD,GAChD,8CAA8C,GAC9C,uCAAuC,GACvC,sCAAsC,GACtC,qCAAqC,GACrC,6CAA6C,GAC7C,iCAAiC,GACjC,wCAAwC,GACxC,yCAAyC,GACzC,yCAAyC,GACzC,kCAAkC,GAClC,yCAAyC,CAAA;AAE7C,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA;AAEjD,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,GAAG,YAAY,IAAI,MAAM,EAAE,CAAA;AAEtD,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE9E,oCAAoC;AACpC,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,QAAQ,CAAA;AAEZ,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,kEAAkE;AAClE,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACzB;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3B,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,EAAE,GACZ;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAC7B,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,WAAW,GACX,YAAY,CAAA;AAEhB,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,UAAU,CAAA;CACpB"}

package/dist/schema.js

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

package/dist/schema.js.map

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

package/dist/schemas/decode.result.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/DecodeResultDocument",
+  "definitions": {
+    "DecodeResultDocument": {
+      "$ref": "#/definitions/DecodeResult%3Cunknown%3E",
+      "description": "Concrete decode result for schema generation.",
+      "category": "Encoding"
+    },
+    "DecodeResult<unknown>": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "string",
+          "const": "@executioncontrolprotocol.decode.result"
+        },
+        "version": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "targetSchema": {
+          "$ref": "#/definitions/EcpSchema"
+        },
+        "targetVersion": {
+          "$ref": "#/definitions/EcpVersion"
+        },
+        "result": {},
+        "validation": {
+          "$ref": "#/definitions/ValidationResult"
+        },
+        "diagnostics": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ValidationIssue"
+          }
+        }
+      },
+      "required": [
+        "schema",
+        "version",
+        "success",
+        "diagnostics"
+      ],
+      "additionalProperties": false,
+      "description": "Decode 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/decode.result.json"
+}