@executioncontrolprotocol/runtime-temporal 0.10.0

package/README.md

@@ -0,0 +1,40 @@
+# @executioncontrolprotocol/runtime-temporal
+
+> **Pre-release scaffold.** This package exposes a typed Temporal runtime
+> definition and executor contract, but **durable execution is not implemented
+> yet.** Binding this runtime and running a workflow throws a descriptive error.
+> Use [`@executioncontrolprotocol/node`](../node/README.md) for local execution today.
+
+## What is real
+
+- `temporalRuntimeDefinition` — a real `defineRuntime("@executioncontrolprotocol", "temporal")` with a
+  config schema (`taskQueue`, `durablePauses`).
+- `TemporalRuntimeExecutor` — implements the `RuntimeExecutor` contract from
+  `@executioncontrolprotocol/core`.
+- `registerTemporalRuntime(registry?)` — idempotent registration on a registry.
+- `TEMPORAL_RUNTIME_ID` (`@executioncontrolprotocol/temporal`).
+
+## What is not implemented
+
+- Durable orchestration, activities, signals/updates, pause/resume, and
+  policy-constrained retries. `TemporalRuntimeExecutor.execute()` rejects with a
+  clear "not yet implemented" error.
+
+## Usage (when implemented)
+
+```ts
+import { environment, runtime } from "@executioncontrolprotocol/node"
+import { temporalRuntimeDefinition, registerTemporalRuntime } from "@executioncontrolprotocol/runtime-temporal"
+
+await registerTemporalRuntime()
+
+const env = environment("production").withRuntime(
+  runtime("@executioncontrolprotocol/temporal", "Temporal Runtime").with({
+    taskQueue: "ecp-runtime",
+    durablePauses: true,
+  })
+)
+```
+
+See [`ecp-overhaul.md`](../../../ecp-overhaul.md) section 17 for the intended
+Temporal responsibilities.

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import type { RunResult, RuntimeExecutionContext, RuntimeExecutor, WorkflowManifest } from "@executioncontrolprotocol/core";
+/**
+ * Temporal runtime id.
+ *
+ * @category Runtimes
+ */
+export declare const TEMPORAL_RUNTIME_ID: "@executioncontrolprotocol/temporal";
+/**
+ * Temporal runtime id (string binding).
+ *
+ * @deprecated Prefer {@link TEMPORAL_RUNTIME_ID} or
+ * {@link temporalRuntimeDefinition}. Retained for existing string bindings.
+ * @category Runtimes
+ */
+export declare const temporalRuntime: "@executioncontrolprotocol/temporal";
+/**
+ * Temporal runtime executor.
+ *
+ * This is a typed scaffold: the runtime definition, config schema, and executor
+ * contract are real so the runtime can be discovered, bound, and validated, but
+ * durable execution is not implemented. {@link execute} throws a clear error
+ * rather than failing in an opaque way.
+ *
+ * @category Runtimes
+ */
+export declare class TemporalRuntimeExecutor implements RuntimeExecutor {
+    execute(_manifest: WorkflowManifest, _context: RuntimeExecutionContext): Promise<RunResult>;
+}
+/**
+ * Temporal runtime definition.
+ *
+ * Durable orchestration via Temporal is not yet implemented; binding this
+ * runtime and running a workflow throws a descriptive error.
+ *
+ * @category Runtimes
+ */
+export declare const temporalRuntimeDefinition: import("@executioncontrolprotocol/core").RuntimeDefinition;
+/**
+ * Register `@executioncontrolprotocol/temporal` on a registry (idempotent).
+ *
+ * @category Runtimes
+ */
+export declare function registerTemporalRuntime(registry?: import("@executioncontrolprotocol/core").Registry): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EACjB,MAAM,gCAAgC,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAG,oCAA6C,CAAA;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,sCAAsB,CAAA;AAQlD;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CACL,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,SAAS,CAAC;CAGtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,4DAOQ,CAAA;AAE9C;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,oDAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/index.js

@@ -0,0 +1,62 @@
+import { defineRuntime, globalRegistry } from "@executioncontrolprotocol/core";
+import { z } from "zod";
+/**
+ * Temporal runtime id.
+ *
+ * @category Runtimes
+ */
+export const TEMPORAL_RUNTIME_ID = "@executioncontrolprotocol/temporal";
+/**
+ * Temporal runtime id (string binding).
+ *
+ * @deprecated Prefer {@link TEMPORAL_RUNTIME_ID} or
+ * {@link temporalRuntimeDefinition}. Retained for existing string bindings.
+ * @category Runtimes
+ */
+export const temporalRuntime = TEMPORAL_RUNTIME_ID;
+/** Error thrown when the Temporal runtime executes a workflow. */
+const NOT_IMPLEMENTED_MESSAGE = "@executioncontrolprotocol/temporal is a pre-release scaffold and cannot execute workflows yet. " +
+    "Bind a host runtime such as @executioncontrolprotocol/node for local execution. Track Temporal " +
+    "durable execution support before depending on this runtime in production.";
+/**
+ * Temporal runtime executor.
+ *
+ * This is a typed scaffold: the runtime definition, config schema, and executor
+ * contract are real so the runtime can be discovered, bound, and validated, but
+ * durable execution is not implemented. {@link execute} throws a clear error
+ * rather than failing in an opaque way.
+ *
+ * @category Runtimes
+ */
+export class TemporalRuntimeExecutor {
+    execute(_manifest, _context) {
+        return Promise.reject(new Error(NOT_IMPLEMENTED_MESSAGE));
+    }
+}
+/**
+ * Temporal runtime definition.
+ *
+ * Durable orchestration via Temporal is not yet implemented; binding this
+ * runtime and running a workflow throws a descriptive error.
+ *
+ * @category Runtimes
+ */
+export const temporalRuntimeDefinition = defineRuntime("@executioncontrolprotocol", "temporal")
+    .withConfig({
+    /** Temporal task queue name. */
+    taskQueue: z.string().optional(),
+    /** Whether to use durable pauses (signals/updates) when implemented. */
+    durablePauses: z.boolean().optional(),
+})
+    .withExecutor(new TemporalRuntimeExecutor());
+/**
+ * Register `@executioncontrolprotocol/temporal` on a registry (idempotent).
+ *
+ * @category Runtimes
+ */
+export async function registerTemporalRuntime(registry = globalRegistry) {
+    if (!registry.getRuntime(TEMPORAL_RUNTIME_ID)) {
+        await registry.registerRuntime(temporalRuntimeDefinition);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAA6C,CAAA;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAA;AAElD,kEAAkE;AAClE,MAAM,uBAAuB,GAC3B,iGAAiG;IACjG,iGAAiG;IACjG,2EAA2E,CAAA;AAE7E;;;;;;;;;GASG;AACH,MAAM,OAAO,uBAAuB;IAClC,OAAO,CACL,SAA2B,EAC3B,QAAiC;QAEjC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;IAC3D,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC,2BAA2B,EAAE,UAAU,CAAC;KAC5F,UAAU,CAAC;IACV,gCAAgC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,wEAAwE;IACxE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,YAAY,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAA;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAQ,GAAG,cAAc;IAEzB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@executioncontrolprotocol/runtime-temporal",
+  "version": "0.10.0",
+  "description": "Pre-release Temporal runtime scaffold for ECP. Durable execution is not yet implemented; binding and running throws a descriptive error.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "peerDependencies": {
+    "@executioncontrolprotocol/core": "^0.10.0",
+    "@executioncontrolprotocol/types": "^0.10.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@executioncontrolprotocol/core": "0.10.0",
+    "@executioncontrolprotocol/types": "0.10.0",
+    "typescript": "^5.7.0",
+    "zod": "^3.24.0"
+  }
+}