@kici-dev/orchestrator 0.1.14 → 0.1.16

package/dist/scaler/types.d.ts

@@ -50,6 +50,20 @@ export interface EffectiveLimits {
     cpus?: number;
     memBytes?: number;
 }
+/**
+ * Identity of the work a spawn was provisioned for, passed to
+ * `ScalerBackend.spawn()`. Backends surface it on the provisioned resource
+ * (container labels today) so an operator inspecting the backend — e.g.
+ * `podman ps` — can tell which job/run each agent serves, and so tests can
+ * select the exact container a trigger produced instead of guessing among
+ * concurrent kici-managed containers. Absent for unbound spawns (warm pool).
+ */
+export interface SpawnContext {
+    /** Execution job id the spawn is bound to. */
+    boundJobId?: string;
+    /** Execution run id the bound job belongs to. */
+    runId?: string;
+}
 /**
  * Network policy controlling RFC1918 and internet access for agents in this label set.
  */
@@ -165,6 +179,14 @@ export interface ScalerBackend {
     readonly labelSets: LabelSetConfig[];
     /** Per-backend maximum agents */
     readonly maxAgents: number;
+    /**
+     * Whether this backend spawns its agents on the orchestrator's own host.
+     * True for bare-metal and Firecracker (local processes / local VMs) and for
+     * container backends using a local runtime socket; false when the backend
+     * provisions elsewhere (remote container runtime, future cloud backends).
+     * Drives the static spawning-host display on the diagnostics page.
+     */
+    readonly spawnsOnLocalHost: boolean;
     /** Current count of agents managed by this backend (including spawning) */
     getActiveCount(): number;
     /**
@@ -177,10 +199,13 @@ export interface ScalerBackend {
      *   for this spawn. Computed by ScalerManager from the job/label-set/scaler
      *   default chain. When omitted (or both fields zero), the backend falls
      *   back to its label-set / default limits the same way it always has.
+     * @param spawnContext - Identity of the bound job/run this spawn serves
+     *   (omitted for unbound spawns, e.g. warm pool). Backends surface it on
+     *   the provisioned resource for operator inspection.
      * @returns The managed agent tracking object
      * @throws If the label set is not supported by this backend
      */
-    spawn(labelSet: string[], agentId: string, orchestratorUrl: string, onEvent?: ScalerEventCallback, effectiveLimits?: EffectiveLimits): Promise<ManagedAgent>;
+    spawn(labelSet: string[], agentId: string, orchestratorUrl: string, onEvent?: ScalerEventCallback, effectiveLimits?: EffectiveLimits, spawnContext?: SpawnContext): Promise<ManagedAgent>;
     /**
      * Destroy a specific managed agent.
      * Docker: docker rm -f; Bare-metal: SIGTERM -> SIGKILL
@@ -223,6 +248,8 @@ export interface FirecrackerNetworkConfig {
     gateway?: string;
     /** Subnet mask for guest networking @default '255.255.255.0' */
     netmask?: string;
+    /** nft table name for this coordinator's host bridge @default 'kici' */
+    table?: string;
 }
 /**
  * Parsed and validated scaler configuration from YAML.