@qaick/executor 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/declared-inputs.d.ts

@@ -0,0 +1,11 @@
+import type { ExecutableInput } from '@qaick/contract';
+/** Shared invocation semantics. Never coerce supplied arguments or rewrite declarations. */
+export declare function resolveDeclaredInputs(declarations?: readonly ExecutableInput[], arguments_?: Record<string, unknown>): {
+    inputs: {
+        [x: string]: unknown;
+    };
+    issues: {
+        code: string;
+        message: string;
+    }[];
+};

package/dist/declared-inputs.js

@@ -0,0 +1,32 @@
+/** Shared invocation semantics. Never coerce supplied arguments or rewrite declarations. */
+export function resolveDeclaredInputs(declarations = [], arguments_ = {}) {
+    const inputs = { ...arguments_ };
+    const issues = [];
+    if (!Array.isArray(declarations))
+        return { inputs, issues: [{ code: 'INVALID_INPUT', message: 'Declared inputs must be an array.' }] };
+    const seen = new Set();
+    for (const declaration of declarations) {
+        if (!declaration || typeof declaration.name !== 'string' || !declaration.name || seen.has(declaration.name) || !['string', 'number', 'boolean', 'json'].includes(declaration.type) || typeof declaration.required !== 'boolean') {
+            issues.push({ code: 'INVALID_INPUT', message: 'Invalid or duplicate declared input.' });
+            continue;
+        }
+        seen.add(declaration.name);
+        const supplied = Object.hasOwn(arguments_, declaration.name);
+        const value = supplied ? arguments_[declaration.name] : declaration.defaultValue;
+        if (value === undefined) {
+            delete inputs[declaration.name];
+            if (declaration.required)
+                issues.push({ code: 'MISSING_INPUT', message: `Required input ${declaration.name} is missing.` });
+            continue;
+        }
+        const validType = declaration.type === 'number' ? typeof value === 'number' && Number.isFinite(value)
+            : declaration.type === 'json' ? typeof value === 'object' && value !== null
+                : typeof value === declaration.type;
+        if (!validType || (declaration.required && value === '')) {
+            issues.push({ code: 'INVALID_INPUT', message: `Input ${declaration.name}: expected ${declaration.type}${declaration.required ? ' (required)' : ''}.` });
+            continue;
+        }
+        inputs[declaration.name] = value;
+    }
+    return { inputs, issues };
+}

package/dist/executor.js

@@ -1,3 +1,4 @@
+import { resolveDeclaredInputs } from './declared-inputs.js';
 const MAX_TIMEOUT_MS = 300_000;
 export function createExecutor(configuration = {}) {
     return new DefaultExecutor(configuration);
@@ -180,7 +181,9 @@ export class DefaultExecutor {
             timeout = setTimeout(() => { run.timedOut = true; run.abort.abort(); }, timeoutMs);
         this.emit(run, 'run_started', 'created', 'Execution accepted.');
         this.emit(run, 'preflight_started', 'preflighting', 'Validating execution package.');
-        const issues = preflight(run.request.executionPackage, run.request.inputs, run.request.runtimeValues ?? {});
+        const arguments_ = resolveDeclaredInputs(run.request.executionPackage.inputDeclarations, run.request.inputs);
+        run.request = { ...run.request, inputs: arguments_.inputs };
+        const issues = [...arguments_.issues, ...preflight(run.request.executionPackage, arguments_.inputs, run.request.runtimeValues ?? {})];
         if (issues.length > 0 || run.request.options?.dryRun) {
             const result = this.baseResult(run, startedAt, issues.length > 0 ? 'failed' : 'completed', undefined, issues);
             if (timeout)
@@ -211,7 +214,11 @@ export class DefaultExecutor {
         for (const flow of pkg.flows ?? []) {
             if (run.cancelled || run.abort.signal.aborted)
                 throw new Error('Execution cancelled.');
-            const child = await this.executeFlow(run, flow.steps, inputs, [flow.id], startedAt, { kind: 'flow', id: flow.id, name: flow.name });
+            const arguments_ = resolveDeclaredInputs(flow.inputDeclarations, inputs);
+            const issues = [...arguments_.issues, ...preflight({ ...pkg, target: { kind: 'flow', id: flow.id, name: flow.name }, requiredInputs: flow.requiredInputs }, arguments_.inputs, run.request.runtimeValues ?? {})];
+            if (issues.length)
+                return this.baseResult(run, startedAt, 'failed', undefined, issues, children);
+            const child = await this.executeFlow(run, flow.steps, arguments_.inputs, [flow.id], startedAt, { kind: 'flow', id: flow.id, name: flow.name });
             children.push(child);
             if (child.state !== 'completed')
                 return this.baseResult(run, startedAt, child.state, child.error, undefined, children);
@@ -434,8 +441,9 @@ function preflight(pkg, inputs, runtimeValues) {
     const issues = [];
     if (!pkg.packageId || !pkg.target?.id)
         issues.push({ code: 'INVALID_PACKAGE', message: 'Execution package identity is incomplete.' });
+    const flowInputNames = new Set(pkg.target.kind === 'project' ? (pkg.flows ?? []).flatMap(flow => Array.isArray(flow.inputDeclarations) ? flow.inputDeclarations.flatMap(input => typeof input?.name === 'string' ? [input.name] : []) : []) : []);
     for (const name of pkg.requiredInputs ?? [])
-        if (inputs[name] === undefined)
+        if (inputs[name] === undefined && !flowInputNames.has(name))
             issues.push({ code: 'MISSING_INPUT', message: `Required input '${name}' is missing.` });
     for (const name of pkg.runtimeRequirements ?? [])
         if (runtimeValues[name] === undefined)

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './types.js';
 export * from './executor.js';
 export * from './in-memory-action-executor.js';
 export * from './migrated-executor.js';
+export { resolveDeclaredInputs } from './declared-inputs.js';

package/dist/index.js

@@ -2,3 +2,4 @@ export * from './types.js';
 export * from './executor.js';
 export * from './in-memory-action-executor.js';
 export * from './migrated-executor.js';
+export { resolveDeclaredInputs } from './declared-inputs.js';

package/dist/migrated-project-engine.js

@@ -90,7 +90,7 @@ export class MigratedProjectRunnerEngine {
             }
             const childRequestId = `${request.requestId}:${flow.id}`;
             run.activeRequestId = childRequestId;
-            const childPackage = { ...request.executionPackage, target: { kind: 'flow', id: flow.id, name: flow.name }, steps: flow.steps, flows: undefined, requiredInputs: flow.requiredInputs };
+            const childPackage = { ...request.executionPackage, target: { kind: 'flow', id: flow.id, name: flow.name }, steps: flow.steps, flows: undefined, requiredInputs: flow.requiredInputs, inputDeclarations: flow.inputDeclarations };
             await this.flowEngine.submit({ requestId: childRequestId, executionPackage: childPackage, inputs, environment: request.environment, runtimeValues: request.runtimeValues, options: request.options, debugSession: request.debugSession });
             for await (const event of this.flowEngine.events(childRequestId))
                 this.emit(run, event.type, event.state, `[${flow.name}] ${event.message}`, event.stepId ? { stepId: event.stepId, stepName: event.stepName } : undefined, event.parallel, event.control);

package/dist/migrated-runner-engine.js

@@ -1,3 +1,4 @@
+import { resolveDeclaredInputs } from './declared-inputs.js';
 import { InMemoryActionAdapter } from './migrated-adapter.js';
 import { hashExecutionPackage } from './migrated-artifact-hash.js';
 import { RUNNER_PACKAGE_SCHEMA_VERSION } from './migrated-types.js';
@@ -119,7 +120,7 @@ export class MigratedRunnerEngine {
         return new Promise(resolve => { const previous = run.resultResolve; run.resultResolve = result => { previous(result); resolve(result); }; });
     }
     async execute(run, resultPromise) {
-        const { request } = run;
+        let { request } = run;
         const startedAt = new Date().toISOString();
         run.controlState = 'running';
         this.emit(run, 'run_started', 'created', 'Run accepted.');
@@ -133,7 +134,10 @@ export class MigratedRunnerEngine {
             await resultPromise;
             return;
         }
-        const validationIssues = this.validateAll(request.executionPackage, request.inputs, request.runtimeValues ?? {});
+        const arguments_ = resolveDeclaredInputs(request.executionPackage.inputDeclarations, request.inputs);
+        run.request = { ...request, inputs: arguments_.inputs };
+        request = run.request;
+        const validationIssues = [...arguments_.issues, ...this.validateAll(request.executionPackage, arguments_.inputs, request.runtimeValues ?? {})];
         const validationWarnings = this.validateBrowserWarnings(request.executionPackage);
         if (request.options?.dryRun) {
             const dryRunResult = { requestId: request.requestId, state: validationIssues.length ? 'failed' : 'completed', target: request.executionPackage.target, environment: request.environment, startedAt, finishedAt: new Date().toISOString(), steps: [], terminalReason: validationIssues.length ? 'failed' : 'completed', issues: validationIssues, warnings: validationWarnings, ...(validationIssues.length ? { error: { code: 'DRY_RUN_ISSUES', message: `${validationIssues.length} issue${validationIssues.length === 1 ? '' : 's'} found during dry run.` } } : {}) };

package/dist/migrated-types.d.ts

@@ -1,7 +1,7 @@
 /** Compatibility import for Runner modules. The canonical contract is the published @qaick/contract package. */
 export * from '@qaick/contract';
 /** The exact published contract package consumed by this Runner release. */
-export declare const RUNNER_CONTRACT_VERSION: "0.2.10";
+export declare const RUNNER_CONTRACT_VERSION: "0.2.12";
 export type ExecutionControlState = 'idle' | 'running' | 'pause-requested' | 'paused' | 'resuming' | 'stopped' | 'failed' | 'completed';
 export interface RunnerDebugSession {
     breakpoints: string[];

package/dist/migrated-types.js

@@ -1,4 +1,4 @@
 /** Compatibility import for Runner modules. The canonical contract is the published @qaick/contract package. */
 export * from '@qaick/contract';
 /** The exact published contract package consumed by this Runner release. */
-export const RUNNER_CONTRACT_VERSION = '0.2.10';
+export const RUNNER_CONTRACT_VERSION = '0.2.12';

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@qaick/executor",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Host-neutral QAick action execution primitives.",
-  "files": ["dist", "README.md"],
-  "engines": { "node": ">=20" },
-  "publishConfig": { "access": "public", "tag": "alpha" },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vladmus/QAICK_Executor.git"
@@ -26,7 +34,7 @@
     "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
   "dependencies": {
-    "@qaick/contract": "0.2.11"
+    "@qaick/contract": "0.2.12"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",