@qaick/runtime 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,17 @@
+# QAick Runtime
+
+`@qaick/runtime` is the host-neutral composition layer for QAick execution. It configures `@qaick/executor`, registers host-provided Action Executors, and routes execution handles, controls, events, results, retries, and Run From Here operations.
+
+Host transports and framework APIs remain outside this package. The current local development dependency points to the sibling `QAICK_Executor` repository.
+
+```ts
+import { createRuntime } from '@qaick/runtime';
+
+const runtime = createRuntime({ actionExecutors: [actionExecutor] });
+const run = await runtime.execute(request);
+const result = await run.result;
+```
+
+The package requires Node 20 or newer and `@qaick/executor` as a peer dependency.
+
+For local development, run `npm run typecheck`, `npm test`, and `npm run build`. Use `npm pack --dry-run` to inspect the publication contents.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './runtime.js';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './runtime.js';

package/dist/runtime.d.ts

@@ -0,0 +1,17 @@
+import type { ActionExecutor, ControlCommand, ExecutionControlState, Executor, ExecutorConfiguration, ExecutorEvent, ExecutorRequest, ExecutorResult, ExecutorRun } from '@qaick/executor';
+export interface RuntimeConfiguration extends ExecutorConfiguration {
+    executor?: Executor;
+}
+export interface QaickRuntime {
+    execute(request: ExecutorRequest): Promise<ExecutorRun>;
+    cancel(requestId: string): Promise<void>;
+    control(requestId: string, command: ControlCommand): Promise<void>;
+    controlState(requestId: string): ExecutionControlState | undefined;
+    events(requestId: string): AsyncIterable<ExecutorEvent>;
+    result(requestId: string): Promise<ExecutorResult>;
+    retryAction(requestId: string, stepId: string, invocationPath?: string[]): Promise<void>;
+    retryOperation(requestId: string, stepId: string, invocationPath?: string[]): Promise<void>;
+    runFromHere(requestId: string, stepId: string, invocationPath?: string[]): Promise<ExecutorRun | undefined>;
+    registerActionExecutor(executor: ActionExecutor): void;
+}
+export declare function createRuntime(configuration?: RuntimeConfiguration): QaickRuntime;

package/dist/runtime.js

@@ -0,0 +1,20 @@
+import { createMigratedExecutor } from '@qaick/executor';
+export function createRuntime(configuration = {}) {
+    return new ComposedQaickRuntime(configuration.executor ?? createMigratedExecutor(configuration));
+}
+class ComposedQaickRuntime {
+    executor;
+    constructor(executor) {
+        this.executor = executor;
+    }
+    execute(request) { return this.executor.execute(request); }
+    cancel(requestId) { return this.executor.cancel(requestId); }
+    control(requestId, command) { return this.executor.control(requestId, command); }
+    controlState(requestId) { return this.executor.controlState(requestId); }
+    events(requestId) { return this.executor.events(requestId); }
+    result(requestId) { return this.executor.result(requestId); }
+    retryAction(requestId, stepId, invocationPath) { return this.executor.retryAction(requestId, stepId, invocationPath); }
+    retryOperation(requestId, stepId, invocationPath) { return this.executor.retryOperation(requestId, stepId, invocationPath); }
+    runFromHere(requestId, stepId, invocationPath) { return this.executor.runFromHere(requestId, stepId, invocationPath); }
+    registerActionExecutor(executor) { this.executor.registerActionExecutor(executor); }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@qaick/runtime",
+  "version": "0.1.0-alpha.1",
+  "description": "Host-neutral composition layer for QAick execution.",
+  "type": "module",
+  "files": ["dist", "README.md"],
+  "engines": { "node": ">=20" },
+  "publishConfig": { "access": "public", "tag": "alpha" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vladmus/QAICK_Runtime.git"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "peerDependencies": {
+    "@qaick/executor": ">=0.1.0-alpha.1 <0.2.0"
+  },
+  "devDependencies": {
+    "@qaick/executor": "file:../QAICK_Executor",
+    "typescript": "~6.0.2",
+    "vitest": "^5.0.0"
+  }
+}