target-supabase-sdk 0.2.3 → 0.2.4

package/dist/extraction/extraction.api.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import type { SupabaseResponse } from "../core.interface";
+import { type Extraction } from "./extraction.interface";
+export declare const postExtractionSchema: z.ZodObject<{
+    name: z.ZodString;
+    /** Source Target id — for log analysis this is the producing Task id. */
+    sourceId: z.ZodString;
+    loaderKey: z.ZodString;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    objects: z.ZodArray<z.ZodUnknown, "many">;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    extra: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tagList: string[];
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    extra?: string | undefined;
+    meta?: unknown;
+}, {
+    name: string;
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    tagList?: string[] | undefined;
+    extra?: string | undefined;
+    meta?: unknown;
+}>;
+export type PostExtractionPayload = z.infer<typeof postExtractionSchema>;
+export declare const getExtractionSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    loaderKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>;
+export type GetExtractionPayload = z.infer<typeof getExtractionSchema>;
+export declare const scanExtractionListSchema: z.ZodObject<{
+    loaderKey: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    ascending: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>;
+export type ScanExtractionListPayload = z.infer<typeof scanExtractionListSchema>;
+export declare const patchExtractionObjectsSchema: z.ZodObject<{
+    id: z.ZodString;
+    objects: z.ZodArray<z.ZodUnknown, "many">;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}, {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}>;
+export type PatchExtractionObjectsPayload = z.infer<typeof patchExtractionObjectsSchema>;
+/** Create an Extraction row for `(sourceId, loaderKey)`. Idempotent on redundancy key. */
+export declare const postExtraction: (payload: {
+    name: string;
+    tagList: string[];
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    extra?: string | undefined;
+    meta?: unknown;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+/** Fetch one Extraction by row id, or by `(sourceId, loaderKey)`. */
+export declare const getExtraction: (payload: {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+/** Scan Extraction rows (newest first by default). */
+export declare const scanExtractionList: (payload: {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}) => SupabaseResponse<Extraction[]> | Promise<SupabaseResponse<Extraction[]>>;
+/** Replace {@link ExtractionDetails.objects} and bump `meta.revision`. */
+export declare const patchExtractionObjects: (payload: {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+//# sourceMappingURL=extraction.api.d.ts.map

package/dist/extraction/extraction.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.api.d.ts","sourceRoot":"","sources":["../../src/extraction/extraction.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAsB,KAAK,UAAU,EAA0B,MAAM,wBAAwB,CAAC;AAKrG,eAAO,MAAM,oBAAoB;;IAE7B,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;EAO3E,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EAgB3B,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAKvC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AA8BzF,0FAA0F;AAC1F,eAAO,MAAM,cAAc;;;;;;;;0EAmCzB,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;0EA2BxB,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,kBAAkB;;;;;8EAkB7B,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;0EA2CjC,CAAC"}

package/dist/extraction/extraction.interface.d.ts

@@ -0,0 +1,43 @@
+import type { Target } from "../core.interface";
+/**
+ * Interpretation layer for a source Target: pipeline output (systems, models, algorithms)
+ * materialized as structured data. Not a process (see Task) or raw bytes (see Parcel).
+ *
+ * @see `.cursor/skills/extraction/SKILL.md`
+ */
+export interface Extraction extends Target {
+    /** Human-readable label. */
+    name: string;
+    /**
+     * Source Target id — the single input this row interprets (any category).
+     * Immutable after create. Indexed for lookup: all Extractions where `value = sourceId`.
+     * Not a dedup hash or pipeline run id.
+     */
+    value: string;
+    category: CategoryExtraction;
+    details: ExtractionDetails;
+}
+export declare enum CategoryExtraction {
+    EXTRACTION = "extraction"
+}
+export interface ExtractionDetails {
+    manifestVersion: 0;
+    /**
+     * Extractor identifier. Together with {@link Extraction.value} (source id) forms the
+     * logical unique key: one Extraction row per `(sourceTargetId, loaderKey)`.
+     * Determines how to parse and render {@link objects} (Extractor-owned schema).
+     */
+    loaderKey: string;
+    /**
+     * Extractor-owned metadata for this interpretation (e.g. revision, updatedAt, pipeline).
+     * Updated alongside {@link objects}; kept `unknown` at SDK boundary — see Extractor module.
+     */
+    meta: unknown;
+    /**
+     * Latest mutable analysis results for this source + Extractor — not an immutable snapshot.
+     * Shape is defined by the Extractor for {@link loaderKey}; SDK keeps `unknown[]` at core.
+     * Large payloads should reference Parcel (or similar) rather than inline in this array.
+     */
+    objects: Array<unknown>;
+}
+//# sourceMappingURL=extraction.interface.d.ts.map

package/dist/extraction/extraction.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.interface.d.ts","sourceRoot":"","sources":["../../src/extraction/extraction.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM;IACtC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,iBAAiB,CAAC;CAC9B;AAED,oBAAY,kBAAkB;IAC1B,UAAU,eAAe;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,eAAe,EAAE,CAAC,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CAC3B"}

package/dist/list/list.interface.d.ts

@@ -10,8 +10,8 @@ export interface List extends Target {
 }
 export interface ListDetails {
     manifestVersion: number;
-    /** If string, it is the meta brief of the list, TODO */
-    meta: string;
+    /** Optional list metadata (shape depends on `loaderKey`). */
+    meta: unknown;
     /** If string, it is the url of the preview TODO */
     preview: string;
     /** How to render the List */

package/dist/list/list.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB"}
+{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB"}

package/dist/node/node-runtime.base.d.ts

@@ -5,6 +5,15 @@ export interface NodeLoopContext {
     loopTraceId: string;
     nodeId: string;
 }
+/** Shared options for {@link BaseNodeRuntime} and subclasses (e.g. TriggerNode). */
+export interface BaseNodeRuntimeOptions {
+    /**
+     * Called after node logout (or when the node was never registered),
+     * immediately before `process.exit`. Use for best-effort cleanup such as
+     * {@link unregisterServiceAtShutdown}. Errors are logged and ignored.
+     */
+    beforeProcessExit?: () => void | Promise<void>;
+}
 export declare const LOG_TOPIC_NODE = "node";
 /**
  * Shared node process runtime: bootstrap, main-loop frame, heartbeat, commands, shutdown.
@@ -15,6 +24,7 @@ declare abstract class BaseNodeRuntime {
     /** Log `nodeId` label while startup has not yet received an assigned id from Supabase. */
     private static readonly NODE_ID_PENDING_ASSIGNMENT;
     protected readonly runtimeModule: string;
+    private readonly beforeProcessExitHook;
     private _localNodeId;
     private _isNodeIdLocked;
     private isRunning;
@@ -26,7 +36,9 @@ declare abstract class BaseNodeRuntime {
     private startPromise;
     get localNodeId(): string | null;
     protected set localNodeId(value: string);
-    protected constructor(runtimeModule: string);
+    protected constructor(runtimeModule: string, options?: BaseNodeRuntimeOptions);
+    private runBeforeProcessExit;
+    private exitProcess;
     /** Hook: task registration, trigger config load, etc. Throw to abort bootstrap. */
     protected abstract onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     /** Hook: one iteration body after commands + heartbeat gate. */

package/dist/node/node-runtime.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAGH,KAAK,eAAe,EACpB,QAAQ,EAIX,MAAM,eAAe,CAAC;AAMvB,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAC1D,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;IAEvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM;IAQ3C,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,iGAAiG;IACjG,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;YAsER,OAAO;IAoDf,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAoCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DvD,uFAAuF;cACvE,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;OAGG;cACa,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7F;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAGH,KAAK,eAAe,EACpB,QAAQ,EAIX,MAAM,eAAe,CAAC;AAMvB,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAC1D,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;IAEvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsC;IAE5E,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;YAS/D,oBAAoB;YAcpB,WAAW;IAKzB,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,iGAAiG;IACjG,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;YAsER,OAAO;IAoDf,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAoCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DvD,uFAAuF;cACvE,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;OAGG;cACa,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7F;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/node/process/create-managed-child-processes.d.ts

@@ -0,0 +1,12 @@
+import type { ManagedChildProcessesOptions } from "./managed-child-processes";
+import { ManagedChildProcesses } from "./managed-child-processes";
+export type CreateManagedChildProcessesOptions = Pick<ManagedChildProcessesOptions, "projectRoot" | "preloadModules" | "useTsx" | "graceMs"> & {
+    /** Defaults to `createLogger({ module: "launcher" })`. */
+    logger?: ManagedChildProcessesOptions["logger"];
+};
+/**
+ * Standard L3 service child-process registry: node (not tsx), service preload, launcher logger.
+ * Each service keeps a singleton in `src/startup/child-processes.ts`.
+ */
+export declare function createManagedChildProcesses(options: CreateManagedChildProcessesOptions): ManagedChildProcesses;
+//# sourceMappingURL=create-managed-child-processes.d.ts.map

package/dist/node/process/create-managed-child-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/create-managed-child-processes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,MAAM,kCAAkC,GAAG,IAAI,CACjD,4BAA4B,EAC5B,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAC1D,GAAG;IACA,0DAA0D;IAC1D,MAAM,CAAC,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;CACnD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kCAAkC,GAAG,qBAAqB,CAQ9G"}

package/dist/node/process/index.d.ts

@@ -1,4 +1,6 @@
-export type { ManagedChildProcessesOptions, SpawnChildResult, StopAllChildrenOptions, } from "./managed-child-processes";
+export type { CreateManagedChildProcessesOptions } from "./create-managed-child-processes";
+export { createManagedChildProcesses } from "./create-managed-child-processes";
+export type { CriticalExitHandler, ManagedChildProcessesOptions, SpawnChildOptions, SpawnChildResult, StopAllChildrenOptions, } from "./managed-child-processes";
 export { ManagedChildProcesses } from "./managed-child-processes";
 export type { BuildNodeImportArgsInput, SpawnTsxChildOptions } from "./process-spawn";
 export { buildNodeImportArgs, isChildProcessRunning, spawnTsxChild } from "./process-spawn";

package/dist/node/process/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/process/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/process/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node/process/managed-child-processes.d.ts

@@ -5,7 +5,12 @@ export interface ManagedChildProcessesOptions {
     preloadModules?: readonly string[];
     /** SIGTERM -> wait -> SIGKILL delay (default 5000 ms). */
     graceMs?: number;
-    logger?: Pick<LoggerWithScope, "info" | "warn" | "error">;
+    logger?: Pick<LoggerWithScope, "info" | "warn" | "error" | "critical">;
+    useTsx?: boolean;
+}
+export interface SpawnChildOptions {
+    env?: Record<string, string>;
+    useTsx?: boolean;
 }
 export interface SpawnChildResult {
     child: ChildProcess;
@@ -16,6 +21,10 @@ export interface StopAllChildrenOptions {
     /** PIDs to SIGTERM when not tracked by this registry (cross-process cleanup). */
     extraPids?: readonly number[];
 }
+export interface CriticalExitHandler {
+    labels: readonly string[];
+    onCriticalExit: (label: string, code: number | null, signal: NodeJS.Signals | null) => void;
+}
 /**
  * Process-local registry for tsx child processes (supervisor, worker, etc.).
  * Each OS process has its own instance - do not expect cross-process PID tracking.
@@ -24,13 +33,17 @@ export declare class ManagedChildProcesses {
     private readonly projectRoot;
     private readonly preloadModules;
     private readonly graceMs;
+    private readonly defaultUseTsx;
     private readonly logger?;
     private readonly byLabel;
+    private criticalExitHandler;
+    private suppressCriticalExit;
     constructor(options: ManagedChildProcessesOptions);
+    setCriticalExitHandler(handler: CriticalExitHandler): void;
     get(label: string): ChildProcess | null;
     getRunning(label: string): ChildProcess | null;
     runningLabels(): string[];
-    spawn(label: string, entryScript: string): SpawnChildResult;
+    spawn(label: string, entryScript: string, spawnOptions?: SpawnChildOptions): SpawnChildResult;
     stopAll(options?: StopAllChildrenOptions): Promise<void>;
     private stopChild;
 }

package/dist/node/process/managed-child-processes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/managed-child-processes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmD;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,OAAO,EAAE,4BAA4B;IAOjD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK9C,aAAa,IAAI,MAAM,EAAE;IAMzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAkCrD,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,OAAO,CAAC,SAAS;CAWpB"}
+{"version":3,"file":"managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/managed-child-processes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/F;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAgE;IACxF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,OAAO,EAAE,4BAA4B;IAQjD,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK9C,aAAa,IAAI,MAAM,EAAE;IAMzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,iBAAiB,GAAG,gBAAgB;IA2CvF,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D,OAAO,CAAC,SAAS;CAWpB"}

package/dist/node/runtime-state/create-service-runtime-state-store.d.ts

@@ -0,0 +1,23 @@
+import { type JsonStatePatch } from "../fs/json-state-store";
+import type { DefaultExtraRuntimeSlices, ServiceRuntimeExtraSlicePatch, ServiceRuntimeNestedKeys, ServiceRuntimeState } from "./service-runtime-state.types";
+export interface CreateServiceRuntimeStateStoreOptions<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    filePath: string;
+    /** Default values for service-specific top-level nested slices. */
+    extraDefaults?: TExtraSlices;
+}
+export interface FinishRunnerTickOptions<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    nowMs: number;
+    lastFired: Record<string, string>;
+    postedCount?: number;
+    /** Patch extra slices in the same atomic write as the scheduler tick. */
+    extra?: ServiceRuntimeExtraSlicePatch<TExtraSlices>;
+}
+export interface ServiceRuntimeStateStore<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    readRuntimeState(): Promise<ServiceRuntimeState<TExtraSlices>>;
+    writeRuntimeState(patch: JsonStatePatch<ServiceRuntimeState<TExtraSlices>, ServiceRuntimeNestedKeys<TExtraSlices>>): Promise<ServiceRuntimeState<TExtraSlices>>;
+    resetRuntimeStateForStartup(): Promise<ServiceRuntimeState<TExtraSlices>>;
+    finishRunnerTick(options: FinishRunnerTickOptions<TExtraSlices>): Promise<void>;
+}
+/** JSON file-backed service runtime state (L3 blueprint) with typed core slices and extensions. */
+export declare function createServiceRuntimeStateStore<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices>(options: CreateServiceRuntimeStateStoreOptions<TExtraSlices>): ServiceRuntimeStateStore<TExtraSlices>;
+//# sourceMappingURL=create-service-runtime-state-store.d.ts.map

package/dist/node/runtime-state/create-service-runtime-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-service-runtime-state-store.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/create-service-runtime-state-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAqD,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,KAAK,EACR,yBAAyB,EAIzB,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EAEtB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,WAAW,qCAAqC,CAClD,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAEvE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,aAAa,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAC7G,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/D,iBAAiB,CACb,KAAK,EAAE,cAAc,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC,YAAY,CAAC,CAAC,GACjG,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9C,2BAA2B,IAAI,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AA0CD,mGAAmG;AACnG,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB,EAClH,OAAO,EAAE,qCAAqC,CAAC,YAAY,CAAC,GAC7D,wBAAwB,CAAC,YAAY,CAAC,CAyCxC"}

package/dist/node/runtime-state/index.d.ts

@@ -0,0 +1,4 @@
+export type { CreateServiceRuntimeStateStoreOptions, FinishRunnerTickOptions, ServiceRuntimeStateStore, } from "./create-service-runtime-state-store";
+export { createServiceRuntimeStateStore } from "./create-service-runtime-state-store";
+export type { GuardRuntimeSlice, ReadinessRuntimeSlice, ReadinessStatus, SchedulerRuntimeSlice, ServiceRuntimeCoreNestedKey, ServiceRuntimeExtraSlicePatch, ServiceRuntimeNestedKeys, ServiceRuntimeState, WorkerRuntimeSlice, } from "./service-runtime-state.types";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/runtime-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,qCAAqC,EACrC,uBAAuB,EACvB,wBAAwB,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AACtF,YAAY,EACR,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,+BAA+B,CAAC"}

package/dist/node/runtime-state/service-runtime-state.types.d.ts

@@ -0,0 +1,57 @@
+import type { RegistrySlotRuntimeState } from "../../service/registry-lifecycle";
+export type ReadinessStatus = "pending" | "passed" | "failed";
+export interface ReadinessRuntimeSlice {
+    status: ReadinessStatus;
+    checkedAt: string | null;
+    message: string | null;
+    checks: {
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }[];
+}
+export interface GuardRuntimeSlice {
+    nodeId: string | null;
+    lastCheckAt: string | null;
+    lastDecision: string | null;
+    lastSpawnAt: string | null;
+    spawnCount: number;
+}
+export interface SchedulerRuntimeSlice {
+    lastTickAt: string | null;
+    lastPostedCount: number;
+    lastFired: Record<string, string>;
+}
+export interface WorkerRuntimeSlice {
+    pid: number | null;
+    spawnedAt: string | null;
+    ready: boolean;
+    registeredTasks: string[];
+    readyAt: string | null;
+}
+/**
+ * Default when an L3 service has no service-specific runtime state slices.
+ * Use an empty object type (not `Record<string, never>`) so intersecting with core
+ * slices does not add a string index signature that collapses property types to `never`.
+ */
+export type DefaultExtraRuntimeSlices = Record<never, never>;
+/**
+ * Cross-process service runtime state persisted to `state.json`.
+ * L3 blueprint: readiness + guard + scheduler + worker + registry.
+ * Extend via extra top-level slices only.
+ */
+export type ServiceRuntimeState<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> = {
+    updatedAt: string;
+    readiness: ReadinessRuntimeSlice;
+    guard: GuardRuntimeSlice;
+    scheduler: SchedulerRuntimeSlice;
+    worker: WorkerRuntimeSlice;
+    registry: RegistrySlotRuntimeState;
+} & TExtraSlices;
+export type ServiceRuntimeCoreNestedKey = "readiness" | "guard" | "scheduler" | "worker" | "registry";
+export type ServiceRuntimeNestedKeys<TExtraSlices extends Record<string, object>> = ServiceRuntimeCoreNestedKey | (keyof TExtraSlices & string);
+/** Patch shape for extra top-level slices (one level deep). */
+export type ServiceRuntimeExtraSlicePatch<TExtraSlices extends Record<string, object>> = {
+    [K in keyof TExtraSlices]?: TExtraSlices[K] extends object ? Partial<TExtraSlices[K]> : TExtraSlices[K];
+};
+//# sourceMappingURL=service-runtime-state.types.d.ts.map

package/dist/node/runtime-state/service-runtime-state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-runtime-state.types.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/service-runtime-state.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB,IAAI;IACvG,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,wBAAwB,CAAC;CACtC,GAAG,YAAY,CAAC;AAEjB,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtG,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAC1E,2BAA2B,GAC3B,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KACpF,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAC1G,CAAC"}

package/dist/node/service-guard/index.d.ts

@@ -0,0 +1,9 @@
+export { registerServiceGuardRunner } from "./register-service-guard-runner";
+export type { RunReadinessGateInput } from "./run-readiness-gate";
+export { runReadinessGate } from "./run-readiness-gate";
+export { runServiceGuardTick } from "./run-service-guard-tick";
+export type { RegisterServiceGuardRunnerOptions, ServiceGuardNodeOptions, ServiceGuardTickInput, ServiceGuardTickResult, } from "./service-guard.interface";
+export { SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
+export { ServiceGuardNode } from "./service-guard-node";
+export { getWorkerSpawnCooldownLastAt, markWorkerSpawned, resetWorkerSpawnCooldownForTests, } from "./worker-spawn-cooldown";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/service-guard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACR,iCAAiC,EACjC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACH,4BAA4B,EAC5B,iBAAiB,EACjB,gCAAgC,GACnC,MAAM,yBAAyB,CAAC"}

package/dist/node/service-guard/register-service-guard-runner.d.ts

@@ -0,0 +1,9 @@
+import { type RegisterServiceGuardRunnerOptions, SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
+export interface RegisterServiceGuardRunnerOptionsWithClock extends RegisterServiceGuardRunnerOptions {
+    /** Test hook — defaults to Date.now(). */
+    now?: () => number;
+}
+/** Register the standard L3 guard runner (registry slot + TaskNode + Service runtime). */
+export declare function registerServiceGuardRunner(options: RegisterServiceGuardRunnerOptionsWithClock): void;
+export { SERVICE_GUARD_RUNNER_KEY };
+//# sourceMappingURL=register-service-guard-runner.d.ts.map

package/dist/node/service-guard/register-service-guard-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-service-guard-runner.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/register-service-guard-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AA6C7G,MAAM,WAAW,0CAA2C,SAAQ,iCAAiC;IACjG,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0CAA0C,GAAG,IAAI,CAOpG;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/node/service-guard/run-readiness-gate.d.ts

@@ -0,0 +1,11 @@
+import type { LoggerWithScope } from "../../shared/log";
+import type { ReadinessCheck, ReadinessReport } from "../readiness/readiness.types";
+export interface RunReadinessGateInput {
+    checks: ReadinessCheck[];
+    onReport: (report: ReadinessReport) => Promise<void>;
+    logger: LoggerWithScope;
+    logTopic?: string;
+}
+/** Run readiness checks, persist report via callback, fail-fast when not ok. */
+export declare function runReadinessGate(input: RunReadinessGateInput): Promise<ReadinessReport>;
+//# sourceMappingURL=run-readiness-gate.d.ts.map

package/dist/node/service-guard/run-readiness-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-readiness-gate.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/run-readiness-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpF,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqB7F"}

package/dist/node/service-guard/run-service-guard-tick.d.ts

@@ -0,0 +1,7 @@
+import type { ServiceGuardTickInput, ServiceGuardTickResult } from "./service-guard.interface";
+/**
+ * One guard-runner tick: registry slot check, TaskNode liveness, optional worker
+ * respawn, Service runtime heartbeat rollup.
+ */
+export declare function runServiceGuardTick(input: ServiceGuardTickInput): Promise<ServiceGuardTickResult>;
+//# sourceMappingURL=run-service-guard-tick.d.ts.map

package/dist/node/service-guard/run-service-guard-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-service-guard-tick.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/run-service-guard-tick.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAG/F;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgGvG"}

package/dist/node/service-guard/service-guard-node.d.ts

@@ -0,0 +1,18 @@
+import type { LoggerWithScope } from "../../shared/log";
+import { TriggerNode } from "../../trigger/trigger-node";
+import type { ServiceGuardNodeOptions } from "./service-guard.interface";
+/**
+ * L3 guard process TriggerNode: readiness gate, TaskNode worker spawn owner,
+ * and {@link registerServiceGuardRunner} tick (registry slot + liveness + runtime).
+ *
+ * Use {@link ServiceGuardNode.create} so the guard runner is registered before `start()`.
+ */
+declare class ServiceGuardNode extends TriggerNode {
+    private readonly options;
+    private constructor();
+    /** Register the guard runner and return a ready-to-start node. */
+    static create(options: ServiceGuardNodeOptions): ServiceGuardNode;
+    protected onBeforeRegisterNode(nodeLogger: LoggerWithScope): Promise<void>;
+}
+export { ServiceGuardNode };
+//# sourceMappingURL=service-guard-node.d.ts.map

package/dist/node/service-guard/service-guard-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-guard-node.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/service-guard-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;GAKG;AACH,cAAM,gBAAiB,SAAQ,WAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO;IAQP,kEAAkE;IAClE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB;cASjD,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBnF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/node/service-guard/service-guard.interface.d.ts

@@ -0,0 +1,58 @@
+import type { Node } from "../../node/node.interface";
+import type { RegistrySlotRuntimeState } from "../../service/registry-lifecycle";
+import type { LoggerWithScope } from "../../shared/log";
+import type { TriggerNodeOptions } from "../../trigger/trigger.interface";
+import type { ReadinessCheck, ReadinessReport } from "../readiness/readiness.types";
+/** Default TriggerManager runner key for {@link registerServiceGuardRunner}. */
+export declare const SERVICE_GUARD_RUNNER_KEY = "service-guard";
+export interface ServiceGuardTickInput {
+    serviceValue: string;
+    serviceId: string | null;
+    nodeId: string;
+    loopTraceId: string;
+    logger: LoggerWithScope;
+    logTopic?: string;
+    checkedAt: string;
+    nowMs: number;
+    taskNodeStaleMs: number;
+    workerSpawnCooldownMs: number;
+    maxNodes?: number;
+    spawnWorker: (reason: string) => Promise<void>;
+    getLastWorkerSpawnAt?: () => number;
+    markWorkerSpawned?: (at: number) => void;
+}
+export interface ServiceGuardTickResult {
+    continueTick: boolean;
+    decision: string;
+    nodes: Node[];
+    registryPatch?: Pick<RegistrySlotRuntimeState, "slotOwned" | "lastSlotCheckAt" | "lastSlotCheckError">;
+}
+export interface RegisterServiceGuardRunnerOptions {
+    serviceValue: string;
+    getServiceId: () => Promise<string | null>;
+    logTopic?: string;
+    runnerKey?: string;
+    intervalMs: number;
+    initialDelayMs?: number;
+    taskNodeStaleMs: number;
+    workerSpawnCooldownMs: number;
+    maxNodes?: number;
+    spawnWorker: (reason: string) => Promise<void>;
+    onRegistryPatch: (patch: Pick<RegistrySlotRuntimeState, "slotOwned" | "lastSlotCheckAt" | "lastSlotCheckError">) => Promise<void>;
+    onGuardPatch: (patch: {
+        nodeId: string;
+        lastCheckAt: string;
+        lastDecision?: string;
+    }) => Promise<void>;
+    onDecision?: (decision: string) => Promise<void>;
+}
+export interface ServiceGuardNodeOptions extends TriggerNodeOptions {
+    serviceValue: string;
+    logTopic?: string;
+    readinessChecks: ReadinessCheck[];
+    onReadinessReport: (report: ReadinessReport) => Promise<void>;
+    guardRunner: Omit<RegisterServiceGuardRunnerOptions, "serviceValue" | "logTopic" | "runnerKey" | "intervalMs" | "initialDelayMs"> & Pick<RegisterServiceGuardRunnerOptions, "intervalMs" | "initialDelayMs">;
+    spawnWorker: (reason: string) => Promise<void>;
+    onWorkerSpawned?: () => void;
+}
+//# sourceMappingURL=service-guard.interface.d.ts.map

package/dist/node/service-guard/service-guard.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-guard.interface.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/service-guard.interface.ts"],"names":[],"mappings":"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"}

package/dist/node/service-guard/worker-spawn-cooldown.d.ts

@@ -0,0 +1,4 @@
+export declare function getWorkerSpawnCooldownLastAt(): number;
+export declare function markWorkerSpawned(at?: number): void;
+export declare function resetWorkerSpawnCooldownForTests(): void;
+//# sourceMappingURL=worker-spawn-cooldown.d.ts.map

package/dist/node/service-guard/worker-spawn-cooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-spawn-cooldown.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/worker-spawn-cooldown.ts"],"names":[],"mappings":"AAEA,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,SAAa,GAAG,IAAI,CAEvD;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/node/service-host/index.d.ts

@@ -0,0 +1,9 @@
+export type { RegisterServiceGuardRunnerOptions, RunReadinessGateInput, ServiceGuardNodeOptions, ServiceGuardTickInput, ServiceGuardTickResult, } from "../service-guard";
+export { getWorkerSpawnCooldownLastAt, markWorkerSpawned, registerServiceGuardRunner, runReadinessGate, runServiceGuardTick, SERVICE_GUARD_RUNNER_KEY, ServiceGuardNode, } from "../service-guard";
+export type { ApplyRegistrySlotGuardInput, ApplyRegistrySlotGuardResult, } from "./registry-slot-guard-step";
+export { applyRegistrySlotGuardStep } from "./registry-slot-guard-step";
+export type { ServiceHost, ServiceHostClosable, ServiceHostContext, ServiceHostOptions, } from "./service-host";
+export { createServiceHost } from "./service-host";
+export type { SingleProcessServiceContext, SingleProcessServiceOptions } from "./single-process-service";
+export { runSingleProcessService } from "./single-process-service";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/service-host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/service-host/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,4BAA4B,EAC5B,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,2BAA2B,EAC3B,4BAA4B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EACR,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/node/service-host/registry-slot-guard-step.d.ts

@@ -0,0 +1,21 @@
+import { registrySlotRuntimePatchFromGuardResult } from "../../service/registry-lifecycle";
+import type { LoggerWithScope } from "../../shared/log";
+export interface ApplyRegistrySlotGuardInput {
+    serviceValue: string;
+    serviceId: string;
+    checkedAt: string;
+    logger: Pick<LoggerWithScope, "critical" | "warn">;
+    logTopic?: string;
+    traceId?: string;
+}
+export interface ApplyRegistrySlotGuardResult {
+    /** When false, caller should abort the supervisor tick (slot lost shutdown initiated). */
+    continueTick: boolean;
+    registryPatch: ReturnType<typeof registrySlotRuntimePatchFromGuardResult>;
+}
+/**
+ * Run registry slot ownership check and optionally SIGTERM the parent main process.
+ * Used by guard / supervisor TriggerNode runners across L3 services.
+ */
+export declare function applyRegistrySlotGuardStep(input: ApplyRegistrySlotGuardInput): Promise<ApplyRegistrySlotGuardResult>;
+//# sourceMappingURL=registry-slot-guard-step.d.ts.map