@kici-dev/engine 0.1.22 → 0.1.23

package/dist/protocol/messages/platform-orchestrator.d.ts

@@ -1073,7 +1073,10 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         component: z.ZodString;
     }, z.core.$strip>], "type">;
     environmentId: z.ZodString;
-    scopePatterns: z.ZodArray<z.ZodString>;
+    bindings: z.ZodArray<z.ZodObject<{
+        scopePattern: z.ZodString;
+        hostPattern: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"dashboard.environments.secrets.list">;
     requestId: z.ZodString;
@@ -1484,6 +1487,29 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         component: z.ZodString;
     }, z.core.$strip>], "type">;
     workflowName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"dashboard.fleet.workflows-for-host">;
+    requestId: z.ZodString;
+    actor: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"user">;
+        sub: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"api_key">;
+        keyId: z.ZodString;
+        ownerSub: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"service_account">;
+        id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"platform_operator">;
+        sub: z.ZodString;
+        reason: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"system">;
+        component: z.ZodString;
+    }, z.core.$strip>], "type">;
+    agentId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"dashboard.fleet.host.declare">;
     requestId: z.ZodString;
@@ -1507,7 +1533,7 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         component: z.ZodString;
     }, z.core.$strip>], "type">;
     agentId: z.ZodString;
-    labels: z.ZodArray<z.ZodString>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     hostname: z.ZodOptional<z.ZodString>;
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -2019,6 +2045,8 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         "scaler.capacity.read": "scaler.capacity.read";
         "scaler.agents.read": "scaler.agents.read";
         "fleet.read": "fleet.read";
+        "fleet.init_runner.bringup": "fleet.init_runner.bringup";
+        "fleet.pre_boot.send": "fleet.pre_boot.send";
         "backend.list.read": "backend.list.read";
         "backend.get.read": "backend.get.read";
         "backend.sync": "backend.sync";
@@ -2036,6 +2064,7 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         platform_proxy: "platform_proxy";
         admin_http: "admin_http";
         admin_cli: "admin_cli";
+        agent: "agent";
     }>>;
     outcome: z.ZodOptional<z.ZodEnum<{
         error: "error";
@@ -2157,6 +2186,7 @@ export declare const platformToOrchestratorMessageSchema: z.ZodDiscriminatedUnio
         }, z.core.$strip>>;
         allowEmpty: z.ZodBoolean;
     }, z.core.$strip>>;
+    dispatchInputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     secrets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     encryptedSecrets: z.ZodOptional<z.ZodString>;
     encryptedSecretsKey: z.ZodOptional<z.ZodString>;
@@ -2565,8 +2595,8 @@ export declare const orchestratorToPlatformMessageSchema: z.ZodDiscriminatedUnio
     timestampMs: z.ZodNumber;
     sourceService: z.ZodEnum<{
         platform: "platform";
-        orchestrator: "orchestrator";
         agent: "agent";
+        orchestrator: "orchestrator";
     }>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     traceId: z.ZodOptional<z.ZodString>;

package/dist/protocol/messages/run-events.d.ts

@@ -15,8 +15,8 @@ export declare const runEventMessageSchema: z.ZodObject<{
     timestampMs: z.ZodNumber;
     sourceService: z.ZodEnum<{
         platform: "platform";
-        orchestrator: "orchestrator";
         agent: "agent";
+        orchestrator: "orchestrator";
     }>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     traceId: z.ZodOptional<z.ZodString>;

package/dist/trigger/types.d.ts

@@ -15,14 +15,19 @@
  * Schema version 18: adds LockJob.runsOnAll host fan-out predicate + onUnreachable policy.
  * Schema version 19: adds LockJob.maxParallel/failFast fan-out concurrency (rolling waves).
  * Schema version 20: runsOn/runsOnAll/excludeLabels carry LabelMatcher (exact|regex) for glob+regex selectors.
+ * Schema version 23: adds LockDispatchTrigger.inputs (typed dispatch inputs descriptors).
+ * Schema version 24: adds LockJob.runsOnPick (deterministic single-host selection).
+ * Schema version 25: adds LockStep.retry (step retry policy data subset; retryIf is execution-only).
+ * Schema version 26: adds LockJob.includeUninitialized (runsOnAll fans out to declared-but-un-agented hosts, bringing up a temporary init-runner per fresh box).
  */
 import { z } from 'zod';
 import type { ProviderType } from '../provider/types.js';
 import type { ApproverClause } from '../approval/types.js';
+import type { InputsDescriptorMap } from '../inputs/descriptor.js';
 import { LabelMatcher } from '../labels-match.js';
 import { ExecutionJobStatus } from '../protocol/messages/execution-status.js';
 /** Schema version - increment on breaking changes */
-export declare const SCHEMA_VERSION: 22;
+export declare const SCHEMA_VERSION: 26;
 /**
  * Normalized approval config carried in the lock file. Produced by the compiler
  * from an SDK `approval` at any of the three levels; consumed by the
@@ -139,6 +144,8 @@ export interface LockDispatchTrigger {
     readonly _type: 'dispatch';
     readonly types: readonly string[];
     readonly repos?: readonly LockBranchPattern[];
+    /** Typed dispatch-input descriptors (from `dispatch({ inputs })`). */
+    readonly inputs?: InputsDescriptorMap;
 }
 /**
  * Create trigger in lock file.
@@ -335,6 +342,13 @@ export interface LockStep {
     readonly continueOnError?: boolean;
     /** Step-level timeout in milliseconds. */
     readonly timeout?: number;
+    /** Retry policy data (retryIf is execution-only and never serialized). */
+    readonly retry?: {
+        readonly maxAttempts: number;
+        readonly delayMs: number;
+        readonly backoff: 'fixed' | 'exponential';
+        readonly maxDelayMs: number;
+    };
     /** Source location of the step() call in the original TypeScript file (for annotations). */
     readonly sourceLocation?: {
         readonly file: string;
@@ -474,12 +488,30 @@ export declare const OnUnreachableMode: z.ZodEnum<{
     hold: "hold";
 }>;
 export type OnUnreachableMode = z.infer<typeof OnUnreachableMode>;
+/**
+ * Single-agent selection policy when multiple agents match a `runsOn` selector.
+ *
+ * - `deterministic` (default): sort matching candidates by `agentId` and pick the
+ *   lowest, so a run-once-on-one-host job is reproducible across re-runs.
+ * - `any`: pick any available agent (load spread).
+ */
+export declare const RunsOnPick: z.ZodEnum<{
+    any: "any";
+    deterministic: "deterministic";
+}>;
+export type RunsOnPick = z.infer<typeof RunsOnPick>;
 export interface LockJob {
     readonly _type: 'static';
     readonly name: string;
     /** Single-agent targeting matchers. Absent when the job uses `runsOnAll` instead. */
     readonly runsOn?: readonly LabelMatcher[];
     readonly excludeLabels?: readonly LabelMatcher[];
+    /**
+     * Single-agent selection policy when more than one agent matches `runsOn`.
+     * `deterministic` (default) sorts candidates by `agentId` and picks the lowest;
+     * `any` picks any available agent. Absent on a `runsOnAll` fan-out job.
+     */
+    readonly runsOnPick?: RunsOnPick;
     /**
      * Host fan-out predicate (mutually exclusive with `runsOn`). When set, the job
      * fans out to every roster host matching the predicate, one pinned child per host.
@@ -487,6 +519,14 @@ export interface LockJob {
     readonly runsOnAll?: RunsOnAllPredicate;
     /** Failure policy for unreachable durable hosts in a `runsOnAll` fan-out. */
     readonly onUnreachable?: OnUnreachableMode;
+    /**
+     * Widen a `runsOnAll` fan-out to declared-but-un-agented hosts. When true,
+     * every roster host matching the predicate is a fan-out target even with no
+     * live agent: a fresh host gets a temporary init-runner brought up over SSH
+     * and its pinned steps run there; a live host runs on its own agent. Default
+     * absent ⇒ only live hosts (today's behavior governed by `onUnreachable`).
+     */
+    readonly includeUninitialized?: boolean;
     /**
      * Fan-out concurrency width (sliding window; `1` = serial). When set on a
      * fan-out job (matrix or `runsOnAll`), only the first `maxParallel` children

package/dist/trigger/types.js

@@ -19,9 +19,13 @@ import { z } from "zod";
 * Schema version 18: adds LockJob.runsOnAll host fan-out predicate + onUnreachable policy.
 * Schema version 19: adds LockJob.maxParallel/failFast fan-out concurrency (rolling waves).
 * Schema version 20: runsOn/runsOnAll/excludeLabels carry LabelMatcher (exact|regex) for glob+regex selectors.
+* Schema version 23: adds LockDispatchTrigger.inputs (typed dispatch inputs descriptors).
+* Schema version 24: adds LockJob.runsOnPick (deterministic single-host selection).
+* Schema version 25: adds LockStep.retry (step retry policy data subset; retryIf is execution-only).
+* Schema version 26: adds LockJob.includeUninitialized (runsOnAll fans out to declared-but-un-agented hosts, bringing up a temporary init-runner per fresh box).
 */
 /** Schema version - increment on breaking changes */
-const SCHEMA_VERSION = 22;
+const SCHEMA_VERSION = 26;
 /** Type guard for inline expression values */
 function isLockInlineValue(value) {
 	return typeof value === "object" && value !== null && value._type === "inline";
@@ -94,6 +98,14 @@ const OnUnreachableMode = z.enum([
 	"fail",
 	"hold"
 ]);
+/**
+* Single-agent selection policy when multiple agents match a `runsOn` selector.
+*
+* - `deterministic` (default): sort matching candidates by `agentId` and pick the
+*   lowest, so a run-once-on-one-host job is reproducible across re-runs.
+* - `any`: pick any available agent (load spread).
+*/
+const RunsOnPick = z.enum(["deterministic", "any"]);
 /** Type guard for static jobs */
 function isLockStaticJob(job) {
 	return job._type === "static";
@@ -103,6 +115,6 @@ function isLockDynamicJobFn(job) {
 	return job._type === "dynamic";
 }
 //#endregion
-export { NeedsEntrySchema, NeedsGroupEntrySchema, NeedsRunOn, NeedsWhen, OnUnreachableMode, SCHEMA_VERSION, isLockDynamicJobFn, isLockInlineValue, isLockStaticJob, resolveWhenToRunOn };
+export { NeedsEntrySchema, NeedsGroupEntrySchema, NeedsRunOn, NeedsWhen, OnUnreachableMode, RunsOnPick, SCHEMA_VERSION, isLockDynamicJobFn, isLockInlineValue, isLockStaticJob, resolveWhenToRunOn };
 
 //# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kici-dev/engine",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Shared business logic for the KiCI CI/CD stack: protocol, triggers, state machine, and provider interfaces used by the Platform relay, orchestrator, and compiler.",
   "keywords": [
     "ci",
@@ -53,6 +53,14 @@
       "import": "./dist/labels/compile.js",
       "types": "./dist/labels/compile.d.ts"
     },
+    "./environment/host-match": {
+      "import": "./dist/environment/host-match.js",
+      "types": "./dist/environment/host-match.d.ts"
+    },
+    "./environment/scope-template": {
+      "import": "./dist/environment/scope-template.js",
+      "types": "./dist/environment/scope-template.d.ts"
+    },
     "./protocol/dashboard-global-workflows": {
       "import": "./dist/protocol/dashboard-global-workflows.js",
       "types": "./dist/protocol/dashboard-global-workflows.d.ts"

package/sbom.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@kici-dev/engine@0.1.22",
-  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fengine/0.1.22/5dc6919d-c8a2-40b2-aba3-44650ecac92f",
+  "name": "@kici-dev/engine@0.1.23",
+  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fengine/0.1.23/8d393c8b-11ae-4191-987e-130f8fca7033",
   "creationInfo": {
-    "created": "2026-06-24T06:02:58Z",
+    "created": "2026-06-25T11:12:41Z",
     "creators": [
       "Tool: kici-sbom-generator"
     ]
@@ -54,7 +54,7 @@
     {
       "SPDXID": "SPDXRef-RootPackage",
       "name": "@kici-dev/engine",
-      "versionInfo": "0.1.22",
+      "versionInfo": "0.1.23",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -65,7 +65,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.22"
+          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.23"
         }
       ],
       "description": "Shared business logic for the KiCI CI/CD stack: protocol, triggers, state machine, and provider interfaces used by the Platform relay, orchestrator, and compiler.",