dsh-plugin-local-infer 0.1.0 → 0.1.2

package/packages/providers/lib/llamacpp.d.ts

@@ -9,9 +9,9 @@
  * `LaunchPlan`. Adding a flag here is a data edit, never a core rewire. The
  * engine is not present on the reference host, so the surface is the
  * specified set the plan names, verified when the binary lands.
- * @module @dsh/dsh-plugin-local-infer/providers/llamacpp
+ * @module dsh-plugin-local-infer/providers/llamacpp
  */
-import type { Config, EnumOption, ParameterSpec } from '@dsh/dsh-plugin-local-infer/core';
+import type { Config, EnumOption, ParameterSpec } from 'dsh-plugin-local-infer/core';
 /**
  * The KV cache quantization formats llama.cpp serves. `f16` is the full-
  * precision default; the smaller tiers trade a little quality for a longer

package/packages/providers/lib/llamacpp.js

@@ -9,7 +9,7 @@
  * `LaunchPlan`. Adding a flag here is a data edit, never a core rewire. The
  * engine is not present on the reference host, so the surface is the
  * specified set the plan names, verified when the binary lands.
- * @module @dsh/dsh-plugin-local-infer/providers/llamacpp
+ * @module dsh-plugin-local-infer/providers/llamacpp
  */
 /**
  * The KV cache quantization formats llama.cpp serves. `f16` is the full-

package/packages/providers/lib/model-defaults.d.ts

@@ -1,16 +1,18 @@
 /**
  * The plugin's default model list. One entry per (engine, model) the card's
  * Model dropdown offers: the NInfer nvfp4 27B and 35B-A3B artifacts, the
- * Hyper-Qwen W4A16 27B and AWQ 35B-A3B artifacts, and the llama.cpp GGUF 27B
- * and 35B-A3B artifacts. Strata does not focus on the dense Qwen models, so it
- * carries no entry; the Qwen Flash Next defaults land with the engine.
+ * Hyper-Qwen W4A16 27B and AWQ 35B-A3B artifacts, the llama.cpp GGUF 27B and
+ * 35B-A3B artifacts, and the Infernix 27B NVIDIA NVFP4 and the Qwen3.8-
+ * Flash-Next Dense8 conversion (whose whole-repo download carries the FP8
+ * n-gram volume the `--ngram-volume` flag reads). Strata does not focus on
+ * the dense Qwen models, so it carries no entry.
  *
  * The list is the single source the card's Model dropdown, the model
  * presence check, and the hf CLI download route read. Adding a model is a
  * data edit here, never a route or card rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/model-defaults
+ * @module dsh-plugin-local-infer/providers/model-defaults
  */
-import type { DefaultModel } from '@dsh/dsh-plugin-local-infer/core';
+import type { DefaultModel } from 'dsh-plugin-local-infer/core';
 /**
  * DEFAULT_MODELS is the default model list, in the order the card lists them.
  * The 27B keys reuse the VramModel registry ids; the 35B-A3B entries use the

package/packages/providers/lib/model-defaults.js

@@ -1,14 +1,16 @@
 /**
  * The plugin's default model list. One entry per (engine, model) the card's
  * Model dropdown offers: the NInfer nvfp4 27B and 35B-A3B artifacts, the
- * Hyper-Qwen W4A16 27B and AWQ 35B-A3B artifacts, and the llama.cpp GGUF 27B
- * and 35B-A3B artifacts. Strata does not focus on the dense Qwen models, so it
- * carries no entry; the Qwen Flash Next defaults land with the engine.
+ * Hyper-Qwen W4A16 27B and AWQ 35B-A3B artifacts, the llama.cpp GGUF 27B and
+ * 35B-A3B artifacts, and the Infernix 27B NVIDIA NVFP4 and the Qwen3.8-
+ * Flash-Next Dense8 conversion (whose whole-repo download carries the FP8
+ * n-gram volume the `--ngram-volume` flag reads). Strata does not focus on
+ * the dense Qwen models, so it carries no entry.
  *
  * The list is the single source the card's Model dropdown, the model
  * presence check, and the hf CLI download route read. Adding a model is a
  * data edit here, never a route or card rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/model-defaults
+ * @module dsh-plugin-local-infer/providers/model-defaults
  */
 /**
  * DEFAULT_MODELS is the default model list, in the order the card lists them.
@@ -64,6 +66,28 @@ export const DEFAULT_MODELS = [
         url: 'https://huggingface.co/bartowski/Qwen_Qwen3.6-35B-A3B-GGUF',
         file: 'Qwen3.6-35B-A3B-Q4_K_M.gguf',
     },
+    {
+        engineId: 'infernix',
+        modelId: 'qwen3-27b',
+        label: 'Infernix Qwen3.8-27B',
+        url: 'https://huggingface.co/Wallawalla47/Qwen3.8-27B-NVIDIA-NVFP4-NInferV3',
+        file: 'qwen3_8_27b_nvfp4-nvidia.ninfer',
+    },
+    {
+        engineId: 'infernix',
+        modelId: 'qwen38-flash-next',
+        label: 'Infernix Qwen3.8-Flash-Next (Dense8)',
+        // No single file: the download pulls the whole repo, which carries the
+        // three model shards, the FP8 n-gram volume, and the conversion metadata.
+        url: 'https://huggingface.co/Wallawalla47/Qwen3.8-Flash-Next-NVIDIA-NVFP4-Dense8-Infernix',
+    },
+    {
+        engineId: 'infernix',
+        modelId: 'qwen36-35b',
+        label: 'Infernix Qwen3.6-35B',
+        url: 'https://huggingface.co/neroued/Qwen3.6-35B-A3B-NInfer',
+        file: 'qwen3_6_35b_a3b.ninfer',
+    },
 ];
 /**
  * defaultModelsForEngine reads the default list for one engine id, in list

package/packages/providers/lib/ninfer.d.ts

@@ -7,9 +7,9 @@
  *
  * The data is the surface; the `NInferAdapter` (Phase 5) composes it into a
  * `LaunchPlan`. Adding a flag here is a data edit, never a core rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/ninfer
+ * @module dsh-plugin-local-infer/providers/ninfer
  */
-import type { ComboOption, EnumOption, ParameterSpec } from '@dsh/dsh-plugin-local-infer/core';
+import type { ComboOption, EnumOption, ParameterSpec } from 'dsh-plugin-local-infer/core';
 /**
  * The KV cache quantization formats NInfer serves, in the order the form
  * dropdown lists them. `note` carries the tradeoff text the dropdown shows
@@ -39,6 +39,13 @@ export declare const CHAT_TEMPLATE_OPTIONS: readonly ComboOption[];
  * click, not just the constraint.
  */
 export declare const SPEC_GATE_MESSAGE = "Pick a speculation backend first (mtp, dflash, or dflash2)";
+/**
+ * The gate message the form shows while the LM-head draft field is greyed out.
+ * The LM-head drafter is an MTP-backend feature, so the field unlocks only
+ * while the MTP speculation backend is selected, for every provider that
+ * spells the flag.
+ */
+export declare const LM_HEAD_DRAFT_GATE_MESSAGE = "LM-head draft is only available with the MTP speculation backend";
 /**
  * The NInfer `ParameterSpec` surface, in form order. The `group` field is the
  * form section; specs without a group render under `General`. `requires`

package/packages/providers/lib/ninfer.js

@@ -7,7 +7,7 @@
  *
  * The data is the surface; the `NInferAdapter` (Phase 5) composes it into a
  * `LaunchPlan`. Adding a flag here is a data edit, never a core rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/ninfer
+ * @module dsh-plugin-local-infer/providers/ninfer
  */
 /**
  * The KV cache quantization formats NInfer serves, in the order the form
@@ -66,6 +66,13 @@ export const CHAT_TEMPLATE_OPTIONS = [
  * click, not just the constraint.
  */
 export const SPEC_GATE_MESSAGE = 'Pick a speculation backend first (mtp, dflash, or dflash2)';
+/**
+ * The gate message the form shows while the LM-head draft field is greyed out.
+ * The LM-head drafter is an MTP-backend feature, so the field unlocks only
+ * while the MTP speculation backend is selected, for every provider that
+ * spells the flag.
+ */
+export const LM_HEAD_DRAFT_GATE_MESSAGE = 'LM-head draft is only available with the MTP speculation backend';
 /**
  * The NInfer `ParameterSpec` surface, in form order. The `group` field is the
  * form section; specs without a group render under `General`. `requires`
@@ -209,11 +216,11 @@ export const NINFER_PARAMETERS = [
     {
         key: 'lmHeadDraft',
         label: 'LM-head draft',
-        description: 'Drafts from the small proposal head instead of the full output head, cutting the per-draft projection cost.',
+        description: 'Drafts from the small proposal head instead of the full output head, cutting the per-draft projection cost. An MTP-backend feature, so the field unlocks only while MTP is selected.',
         form: { kind: 'boolean' },
         defaultValue: false,
         group: 'Speculation',
-        requires: (config) => config.spec && config.spec !== 'none' ? null : SPEC_GATE_MESSAGE,
+        requires: (config) => config.spec === 'mtp' ? null : LM_HEAD_DRAFT_GATE_MESSAGE,
         toArgv: (value) => (value === true ? ['--lm-head-draft'] : []),
     },
     {

package/packages/providers/lib/platform.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The per-engine platform defaults the card's Engine platform section seeds:
+ * the local build command the deploy step runs in the checkout and the docker
+ * image tag the docker deploy pulls. Both are data, so a new engine's
+ * defaults are a data edit here, never a card rewire.
+ * @module dsh-plugin-local-infer/providers/platform
+ */
+/**
+ * EnginePlatformDefaults is the per-engine platform defaults: the local build
+ * command (the engine's first acquisition build step) and the docker image tag
+ * the docker deploy pulls. An engine that supports neither a mode carries no
+ * entry for it.
+ */
+export interface EnginePlatformDefaults {
+    defaultBuildCommand?: string;
+    defaultDockerTag?: string;
+}
+/**
+ * The per-engine platform defaults, keyed by engine id. The build command is
+ * the engine's first acquisition build step; the docker tag is the upstream
+ * image the adapter pulls. Hyper-Qwen is compose-driven, so its docker tag is
+ * the vLLM OpenAI server image; Infernix ships no docker image, so it carries
+ * a build command only.
+ */
+export declare const ENGINE_PLATFORM_DEFAULTS: Record<string, EnginePlatformDefaults>;
+/**
+ * enginePlatformDefaults reads the registered platform defaults for an engine
+ * id, or an empty object when none is registered.
+ */
+export declare function enginePlatformDefaults(engineId: string): EnginePlatformDefaults;
+//# sourceMappingURL=platform.d.ts.map

package/packages/providers/lib/platform.js

@@ -0,0 +1,58 @@
+/**
+ * The per-engine platform defaults the card's Engine platform section seeds:
+ * the local build command the deploy step runs in the checkout and the docker
+ * image tag the docker deploy pulls. Both are data, so a new engine's
+ * defaults are a data edit here, never a card rewire.
+ * @module dsh-plugin-local-infer/providers/platform
+ */
+import { LLAMACPP_DOCKER_IMAGE, NINFER_DOCKER_IMAGE, STRATA_DOCKER_IMAGE, } from "./adapters.js";
+import { engineBuildSteps } from "./acquire.js";
+// The local build command is the engine's first acquisition build step (the
+// cmake build the deploy step runs in the checkout), read through
+// engineBuildSteps so the card's placeholder and the deploy step share one
+// list. A step list that is empty (the compose engines) contributes no
+// build command.
+const NINFER_BUILD_COMMAND = engineBuildSteps('ninfer')[0];
+const LLAMACPP_BUILD_COMMAND = engineBuildSteps('llamacpp')[0];
+const INFERNIX_BUILD_COMMAND = engineBuildSteps('infernix')[0];
+/**
+ * The per-engine platform defaults, keyed by engine id. The build command is
+ * the engine's first acquisition build step; the docker tag is the upstream
+ * image the adapter pulls. Hyper-Qwen is compose-driven, so its docker tag is
+ * the vLLM OpenAI server image; Infernix ships no docker image, so it carries
+ * a build command only.
+ */
+export const ENGINE_PLATFORM_DEFAULTS = {
+    ninfer: {
+        ...(NINFER_BUILD_COMMAND !== undefined ? { defaultBuildCommand: NINFER_BUILD_COMMAND } : {}),
+        defaultDockerTag: NINFER_DOCKER_IMAGE,
+    },
+    hyperqwen: {
+        // The compose setup selects a profile, not an image tag, so the card's
+        // docker-tag field seeds the compose arguments the up step runs: the
+        // launcher's default `single` profile.
+        defaultDockerTag: '--profile single',
+    },
+    llamacpp: {
+        ...(LLAMACPP_BUILD_COMMAND !== undefined
+            ? { defaultBuildCommand: LLAMACPP_BUILD_COMMAND }
+            : {}),
+        defaultDockerTag: LLAMACPP_DOCKER_IMAGE,
+    },
+    infernix: {
+        ...(INFERNIX_BUILD_COMMAND !== undefined
+            ? { defaultBuildCommand: INFERNIX_BUILD_COMMAND }
+            : {}),
+    },
+    strata: {
+        defaultDockerTag: STRATA_DOCKER_IMAGE,
+    },
+};
+/**
+ * enginePlatformDefaults reads the registered platform defaults for an engine
+ * id, or an empty object when none is registered.
+ */
+export function enginePlatformDefaults(engineId) {
+    return ENGINE_PLATFORM_DEFAULTS[engineId] ?? {};
+}
+//# sourceMappingURL=platform.js.map

package/packages/providers/lib/presets.d.ts

@@ -11,9 +11,9 @@
  * bridge pulls and the pure extractor that turns the fetched page into a
  * preset. The service runs the fetch and tags the result with the URL and the
  * fetch date.
- * @module @dsh/dsh-plugin-local-infer/providers/presets
+ * @module dsh-plugin-local-infer/providers/presets
  */
-import type { Config, Preset, PresetSource } from '@dsh/dsh-plugin-local-infer/core';
+import type { Config, Preset, PresetSource } from 'dsh-plugin-local-infer/core';
 /**
  * BUILTIN_PRESETS is the combined preset list the providers register with the
  * seam. Adding a preset is a data edit here, never a resolver change.

package/packages/providers/lib/presets.js

@@ -11,7 +11,7 @@
  * bridge pulls and the pure extractor that turns the fetched page into a
  * preset. The service runs the fetch and tags the result with the URL and the
  * fetch date.
- * @module @dsh/dsh-plugin-local-infer/providers/presets
+ * @module dsh-plugin-local-infer/providers/presets
  */
 /**
  * The hardware class every built-in preset is sourced for: a 24 GiB Ampere

package/packages/providers/lib/strata.d.ts

@@ -4,9 +4,9 @@
  * available. The surface is empty until then, so the form renders no fields
  * and the adapter renders a bare docker plan; adding a spec here is a data
  * edit, never an adapter rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/strata
+ * @module dsh-plugin-local-infer/providers/strata
  */
-import type { ParameterSpec } from '@dsh/dsh-plugin-local-infer/core';
+import type { ParameterSpec } from 'dsh-plugin-local-infer/core';
 /**
  * The Strata `ParameterSpec` surface, empty until the engine's flag set lands.
  * The `StrataAdapter` composes this (currently nothing) into a docker plan.

package/packages/providers/lib/strata.js

@@ -4,7 +4,7 @@
  * available. The surface is empty until then, so the form renders no fields
  * and the adapter renders a bare docker plan; adding a spec here is a data
  * edit, never an adapter rewire.
- * @module @dsh/dsh-plugin-local-infer/providers/strata
+ * @module dsh-plugin-local-infer/providers/strata
  */
 /**
  * The Strata `ParameterSpec` surface, empty until the engine's flag set lands.

package/packages/providers/lib/vram.d.ts

@@ -6,9 +6,9 @@
  * parameter counts. The provenance note on each model names the exact weight
  * artifact the figures apply to, because the runtime also recognizes other
  * weight profiles with different resident sizes.
- * @module @dsh/dsh-plugin-local-infer/providers/vram
+ * @module dsh-plugin-local-infer/providers/vram
  */
-import type { VramModel } from '@dsh/dsh-plugin-local-infer/core';
+import type { VramModel } from 'dsh-plugin-local-infer/core';
 /**
  * The NInfer measured VramModels, one per model artifact. The top-level
  * `seqFixedBytes`/`seqPerToken` are the no-speculation baseline; the

package/packages/providers/lib/vram.js

@@ -6,7 +6,7 @@
  * parameter counts. The provenance note on each model names the exact weight
  * artifact the figures apply to, because the runtime also recognizes other
  * weight profiles with different resident sizes.
- * @module @dsh/dsh-plugin-local-infer/providers/vram
+ * @module dsh-plugin-local-infer/providers/vram
  */
 /**
  * DFlash2's CUDA-graph allowance is a step in context, measured at 8,192 /

package/packages/providers/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@dsh/dsh-plugin-local-infer-providers",
+  "name": "dsh-plugin-local-infer-providers",
   "version": "0.1.0",
   "description": "Concrete providers for the dsh local-inference plugin: the ninfer, hyperqwen, llamacpp, and strata engine adapters, the NInfer VramModel, the built-in presets, the built-in guidelines, and the per-OS SystemDep install command data. Each registers itself with ctx.localInfer.",
   "keywords": [
@@ -31,8 +31,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh/dsh-plugin-local-infer-core": "workspace:^",
-    "@dsh/dsh-plugin-local-infer-service": "workspace:^"
+    "dsh-plugin-local-infer-core": "workspace:^",
+    "dsh-plugin-local-infer-service": "workspace:^"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1"

package/packages/service/lib/index.d.ts

@@ -15,12 +15,12 @@
  * Phase 6 over the dsh settings seam, and `resolveDefaults` and
  * `fetchPreset` by Phase 7 over the core defaults resolver and the
  * mod-search bridge.
- * @module @dsh/dsh-plugin-local-infer/service
+ * @module dsh-plugin-local-infer/service
  */
 import { Context, Service } from '@deepseek-ai/cordis';
-import type { Config, DefaultModel, ModelDirectoryEntry, EngineAdapter, EngineDepPlan, EnginePlatformConfig, GpuUsageProbe, Guideline, GuidelineResult, HardwareProfile, HardwareProbes, InstallResult, LaunchPlan, ModelRow, Preset, PresetSource, ProcessLine, ProviderLaunchRecord, ProviderRef, ProviderStatus, ReLinkOutcome, RegisterResult, ReserveResolution, ResolvedDefaults, SystemDep, VramModel } from '@dsh/dsh-plugin-local-infer/core';
-import type { DetectOsReserveOptions, DownloadModelOptions, DownloadResult, EstimateResult, FetchPresetOptions, FetchPresetResult, HfCliOptions, LaunchOptions, LaunchResult, LocalInferService, RegisterModelOptions } from './types.ts';
-export type { DetectOsReserveOptions, DownloadModelOptions, DownloadResult, EstimateResult, FetchPresetOptions, FetchPresetResult, HfCliOptions, LaunchOptions, LaunchResult, LocalInferService, ProviderStatusOptions, RegisterModelOptions, SettingsDescribeResult, SettingsForms, SettingsNamespaceDescriptor, } from './types.ts';
+import type { Config, DefaultModel, ModelDirectoryEntry, EngineAdapter, EngineDepPlan, EnginePlatformConfig, GpuUsageProbe, Guideline, GuidelineResult, HardwareProfile, HardwareProbes, InstallResult, LaunchPlan, ModelRow, Preset, PresetSource, ProcessLine, ProviderLaunchRecord, ProviderRef, ProviderStatus, ReLinkOutcome, RegisterResult, ReserveResolution, ResolvedDefaults, SystemDep, VramModel } from 'dsh-plugin-local-infer/core';
+import type { DetectOsReserveOptions, DownloadModelOptions, DownloadResult, EngineDeathEvent, EstimateResult, FetchPresetOptions, FetchPresetResult, HfCliOptions, LaunchOptions, LaunchResult, LocalInferService, ProviderStatusOptions, RegisterModelOptions } from './types.ts';
+export type { DetectOsReserveOptions, DownloadModelOptions, DownloadResult, EngineDeathEvent, EstimateResult, FetchPresetOptions, FetchPresetResult, HfCliOptions, LaunchOptions, LaunchResult, LocalInferService, ProviderStatusOptions, RegisterModelOptions, SettingsDescribeResult, SettingsForms, SettingsNamespaceDescriptor, } from './types.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         localInfer: LocalInferService;
@@ -50,6 +50,10 @@ export declare class LocalInfer extends Service implements LocalInferService {
     private readonly platformConfigRegistry;
     private readonly launchedEngines;
     private readonly launchedModels;
+    private readonly launchedPorts;
+    private readonly engineWatchers;
+    private readonly handledPids;
+    private deathObserver;
     constructor(ctx: Context);
     registerEngine(adapter: EngineAdapter): () => void;
     registerPreset(preset: Preset): () => void;
@@ -120,22 +124,20 @@ export declare class LocalInfer extends Service implements LocalInferService {
     detectOsReserve(config?: Config, options?: DetectOsReserveOptions): Promise<ReserveResolution>;
     /**
      * providerStatuses resolves the running-state the card paints each saved
-     * provider's status dot from. It collects every registered adapter's launch
-     * signature, probes the running process table against those markers, and
-     * ties a running engine's port to the model the plugin launched it with (the
-     * launched-models map), so a plugin-launched engine reads as that model and
-     * a foreign engine reads as "engine running, model unknown". The GPU-usage
-     * reading feeds the busy-card rule. The answer is the core resolver's: a
-     * busy card or no engine running reads as unsure for every provider, an
-     * engine the detector saw but could not tie to a model reads as unsure for
-     * its configs and stopped for the rest, and a confirmed engine-plus-model
-     * reads as running. The options inject the probe results, so a test prices a
-     * busy card or a foreign engine without a live nvidia-smi or ps.
-     */
-    providerStatuses(providers: readonly ProviderRef[], options?: {
-        processes?: ProcessLine[];
-        gpuUsage?: GpuUsageProbe | null;
-    }): Promise<Record<string, ProviderStatus>>;
+     * provider's status dot from. It prices each provider's own launch signature
+     * through the registered adapter (the build mode's binary, the port the
+     * provider's config binds, the env keys), so an engine the plugin launched
+     * on a non-default port matches its config instead of reading forever as a
+     * process no signature covers, and ties the matched port to the model the
+     * plugin launched it with (the launched-models map). The GPU-usage reading
+     * feeds the busy-card rule. The answer is the core resolver's: a busy card
+     * or no engine running reads as unsure for every provider, an engine the
+     * detector saw but could not tie to a model reads as unsure for its configs
+     * and stopped for the rest, and a confirmed engine-plus-model reads as
+     * running. The options inject the probe results, so a test prices a busy
+     * card or a foreign engine without a live nvidia-smi or ps.
+     */
+    providerStatuses(providers: readonly ProviderRef[], options?: ProviderStatusOptions): Promise<Record<string, ProviderStatus>>;
     /**
      * unsureBannerKillCommands returns the bash kill commands for the engine
      * processes the detector saw holding VRAM, for the "unsure" banner the card
@@ -210,6 +212,47 @@ export declare class LocalInfer extends Service implements LocalInferService {
         processAlive?: (pid: number) => boolean;
         commandLine?: (pid: number) => string | undefined;
     }): Promise<Record<string, ReLinkOutcome>>;
+    /**
+     * setEngineDeathObserver registers the route's hook for engine process
+     * deaths: a crash or pkill seen through a launched handle's exit event, or a
+     * poll-detected death of a process adopted from a stored launch record. The
+     * observer persists the provider entry's cleared state so the card reads the
+     * provider stopped instead of carrying a stale record. Passing undefined
+     * clears it, which the route's effect does on dispose.
+     */
+    setEngineDeathObserver(observer: ((event: EngineDeathEvent) => void) | undefined): void;
+    /**
+     * watchLaunchedHandle ties a launched child's one-shot exit to the live
+     * state: the host's close/error event (a crash, a pkill, or the stop kill)
+     * reports through observeEngineDeath. A handle whose host cannot watch (no
+     * onExit, a stub) is left to the re-link rule to price after a restart.
+     */
+    private watchLaunchedHandle;
+    /**
+     * watchAdoptedEngine re-attaches the exit watch for a process this DSH did
+     * not spawn: a surviving engine adopted from a stored launch record has no
+     * ChildProcess to listen on after a restart, so an unref'd poll on the
+     * liveness probe stands in for the exit event. When the pid dies the watcher
+     * stops itself and reports through observeEngineDeath, so the provider's
+     * state settles without waiting for the next summary re-link to price the
+     * record dead.
+     */
+    private watchAdoptedEngine;
+    /**
+     * stopEngineWatcher cancels one port's adopted-process poll, if it has one.
+     */
+    private stopEngineWatcher;
+    /**
+     * observeEngineDeath settles one engine process's death against the live
+     * state: the port-to-model tie drops when the dead engine still owns the
+     * port, the port leaves the engine's live ledger, the plugin-launched flag
+     * clears with the engine's last live port, the adopted-process watcher for
+     * the port stops, and the registered death observer (the route's persistence
+     * hook) receives the event. The launch record itself is the route's: the
+     * observer clears the provider entry's record so the card reads the provider
+     * stopped, not stale.
+     */
+    private observeEngineDeath;
     /**
      * stop signals the engine a launch started: it resolves the adapter by the
      * plan's engineId and runs the adapter's stop step (kill the tracked process,