@vibesdotdev/pm 0.0.0-stage → 1.0.0-rc.3

package/dist/schemas/resource.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Resource Management Schemas
+ * Core Zod v4 schemas for declarative resource configuration and state
+ *
+ * Resources represent infrastructure (K8s, Docker, cloud) managed via providers.
+ * Unlike processes (PID-based), resources have setup/teardown lifecycle.
+ */
+import * as z from 'zod/v4';
+/**
+ * Resource status enum
+ * Represents the current state of a managed resource
+ */
+export declare const ResourceStatusEnum: z.ZodEnum<{
+    error: "error";
+    missing: "missing";
+    ready: "ready";
+    creating: "creating";
+    updating: "updating";
+    stopping: "stopping";
+    stopped: "stopped";
+    deleting: "deleting";
+}>;
+/**
+ * A provider's own payload: its resource `config` and the `metadata` it
+ * reports. Each provider owns the shape (it validates its `config` with
+ * `validateConfig`), so the core schema carries it as named keys over values
+ * only that provider interprets.
+ */
+export declare const ProviderPayloadSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type ProviderPayload = z.infer<typeof ProviderPayloadSchema>;
+/**
+ * Resource configuration schema
+ * Base schema for all resource types - provider-specific config in 'config' field
+ */
+export declare const ResourceConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    onCreate: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            source: z.ZodLiteral<"secret">;
+            key: z.ZodString;
+            store: z.ZodOptional<z.ZodString>;
+            operation: z.ZodOptional<z.ZodCustom<object, object>>;
+        }, z.core.$strict>], "source">>>;
+        selfSpawn: z.ZodOptional<z.ZodBoolean>;
+        ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    onUpdate: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            source: z.ZodLiteral<"secret">;
+            key: z.ZodString;
+            store: z.ZodOptional<z.ZodString>;
+            operation: z.ZodOptional<z.ZodCustom<object, object>>;
+        }, z.core.$strict>], "source">>>;
+        selfSpawn: z.ZodOptional<z.ZodBoolean>;
+        ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    onDelete: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            source: z.ZodLiteral<"secret">;
+            key: z.ZodString;
+            store: z.ZodOptional<z.ZodString>;
+            operation: z.ZodOptional<z.ZodCustom<object, object>>;
+        }, z.core.$strict>], "source">>>;
+        selfSpawn: z.ZodOptional<z.ZodBoolean>;
+        ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    waitForReady: z.ZodDefault<z.ZodBoolean>;
+    readyTimeout: z.ZodDefault<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    presets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Resource state schema (runtime)
+ * Tracks the current state of a managed resource
+ */
+export declare const ResourceStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        missing: "missing";
+        ready: "ready";
+        creating: "creating";
+        updating: "updating";
+        stopping: "stopping";
+        stopped: "stopped";
+        deleting: "deleting";
+    }>;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    lastChecked: z.ZodCoercedDate<unknown>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodString>;
+    lastError: z.ZodOptional<z.ZodString>;
+    progress: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Resource state collection schema
+ * Tracks all managed resources in the system
+ */
+export declare const ResourceStateCollectionSchema: z.ZodObject<{
+    states: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            missing: "missing";
+            ready: "ready";
+            creating: "creating";
+            updating: "updating";
+            stopping: "stopping";
+            stopped: "stopped";
+            deleting: "deleting";
+        }>;
+        createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        lastChecked: z.ZodCoercedDate<unknown>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        error: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+        progress: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    lastUpdated: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
+/**
+ * Resource manifest schema (for config files)
+ * Combines resources with processes and presets
+ */
+export declare const ResourceManifestSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        onCreate: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"secret">;
+                key: z.ZodString;
+                store: z.ZodOptional<z.ZodString>;
+                operation: z.ZodOptional<z.ZodCustom<object, object>>;
+            }, z.core.$strict>], "source">>>;
+            selfSpawn: z.ZodOptional<z.ZodBoolean>;
+            ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        onUpdate: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"secret">;
+                key: z.ZodString;
+                store: z.ZodOptional<z.ZodString>;
+                operation: z.ZodOptional<z.ZodCustom<object, object>>;
+            }, z.core.$strict>], "source">>>;
+            selfSpawn: z.ZodOptional<z.ZodBoolean>;
+            ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        onDelete: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                source: z.ZodLiteral<"secret">;
+                key: z.ZodString;
+                store: z.ZodOptional<z.ZodString>;
+                operation: z.ZodOptional<z.ZodCustom<object, object>>;
+            }, z.core.$strict>], "source">>>;
+            selfSpawn: z.ZodOptional<z.ZodBoolean>;
+            ignoreFailure: z.ZodDefault<z.ZodBoolean>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        waitForReady: z.ZodDefault<z.ZodBoolean>;
+        readyTimeout: z.ZodDefault<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        presets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Type exports
+ */
+export type ResourceStatus = z.infer<typeof ResourceStatusEnum>;
+export type ResourceConfig = z.infer<typeof ResourceConfigSchema>;
+export type ResourceState = z.infer<typeof ResourceStateSchema>;
+export type ResourceStateCollection = z.infer<typeof ResourceStateCollectionSchema>;
+export type ResourceManifest = z.infer<typeof ResourceManifestSchema>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/schemas/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/schemas/resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAS7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,wCAAoC,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAoB9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;iBAGxC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/resource.js

@@ -0,0 +1,92 @@
+/**
+ * Resource Management Schemas
+ * Core Zod v4 schemas for declarative resource configuration and state
+ *
+ * Resources represent infrastructure (K8s, Docker, cloud) managed via providers.
+ * Unlike processes (PID-based), resources have setup/teardown lifecycle.
+ */
+import * as z from 'zod/v4';
+import { LifecycleHookSchema } from "./common.js";
+/**
+ * Resource status enum
+ * Represents the current state of a managed resource
+ */
+export const ResourceStatusEnum = z.enum([
+    'ready', // Resource is created and operational
+    'creating', // Resource is being set up
+    'updating', // Resource is being modified
+    'stopping', // Resource is being stopped (scaled to 0)
+    'stopped', // Resource is stopped (scaled to 0, but not deleted)
+    'deleting', // Resource is being torn down
+    'error', // Resource encountered an error
+    'missing' // Resource does not exist
+]);
+/**
+ * A provider's own payload: its resource `config` and the `metadata` it
+ * reports. Each provider owns the shape (it validates its `config` with
+ * `validateConfig`), so the core schema carries it as named keys over values
+ * only that provider interprets.
+ */
+export const ProviderPayloadSchema = z.record(z.string(), z.unknown());
+/**
+ * Resource configuration schema
+ * Base schema for all resource types - provider-specific config in 'config' field
+ */
+export const ResourceConfigSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    type: z.string().min(1), // Provider type: 'k8s/namespace', 'helm/chart', 'docker/container', etc.
+    // Provider-specific configuration (validated by provider)
+    config: ProviderPayloadSchema,
+    // Dependencies (can reference processes OR other resources)
+    dependencies: z.array(z.string()).optional(),
+    // Lifecycle hooks
+    onCreate: LifecycleHookSchema.optional(), // Run after resource created
+    onUpdate: LifecycleHookSchema.optional(), // Run after resource updated
+    onDelete: LifecycleHookSchema.optional(), // Run before resource deleted
+    // Ready state behavior
+    waitForReady: z.boolean().default(true), // Block until resource is ready
+    readyTimeout: z.number().int().positive().default(60000), // Timeout in ms
+    // Metadata
+    tags: z.array(z.string()).optional(),
+    presets: z.array(z.string()).optional() // Preset IDs this resource belongs to
+});
+/**
+ * Resource state schema (runtime)
+ * Tracks the current state of a managed resource
+ */
+export const ResourceStateSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    status: ResourceStatusEnum,
+    // Timestamps
+    createdAt: z.coerce.date().optional(),
+    updatedAt: z.coerce.date().optional(),
+    lastChecked: z.coerce.date(),
+    // Provider-specific state metadata
+    metadata: ProviderPayloadSchema.optional(),
+    config: ProviderPayloadSchema.optional(),
+    // Error information
+    error: z.string().optional(),
+    lastError: z.string().optional(),
+    // Progress tracking (for long-running operations)
+    progress: z.number().min(0).max(100).optional() // Percentage 0-100
+});
+/**
+ * Resource state collection schema
+ * Tracks all managed resources in the system
+ */
+export const ResourceStateCollectionSchema = z.object({
+    states: z.record(z.string(), ResourceStateSchema),
+    lastUpdated: z.coerce.date()
+});
+/**
+ * Resource manifest schema (for config files)
+ * Combines resources with processes and presets
+ */
+export const ResourceManifestSchema = z.object({
+    version: z.string().default('1.0'),
+    resources: z.array(ResourceConfigSchema).optional()
+    // Note: processes and presets defined in process.ts
+});
+//# sourceMappingURL=resource.js.map

package/dist/schemas/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/schemas/resource.ts"],"names":[],"mappings":"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"}

package/dist/schemas/store.d.ts

@@ -0,0 +1,97 @@
+import type { PathRoots } from '@vibesdotdev/paths';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { ProcessState } from './process.ts';
+export interface StorageContext {
+    get?(key: string): Promise<JsonValue | undefined>;
+    set?(key: string, value: JsonValue): Promise<void>;
+    delete?(key: string): Promise<void>;
+}
+export type ProcessStoreScope = 'global' | 'project' | 'local';
+/**
+ * Where a process store lives, per scope. Every location comes from the
+ * caller's runtime: the store never re-derives a home or a workspace.
+ */
+export type ProcessStoreOptions = {
+    /** StorageContext from ctx.storage (preferred) */
+    storage?: StorageContext;
+    scope?: 'global';
+    /**
+     * Path roots from the caller's runtime (`getPathRoots(runtime)`). The
+     * state lives under `roots.activeHome/pm/workspaces/<toolingId>`.
+     */
+    roots: PathRoots;
+    /**
+     * The caller's admitted workspace tooling id (e.g. `ProcessManager`'s
+     * `workspaceIdentity.toolingId`). Required: two daemons admitted to
+     * different workspaces must never share a partition, which an
+     * ambiently re-derived id once caused (clobbered process rows,
+     * including a worker's persisted `socketPath`).
+     */
+    workspaceToolingId: string;
+} | {
+    storage?: StorageContext;
+    scope: 'project' | 'local';
+    /** The workspace root the project/local state lives in. */
+    workspaceRoot: string;
+};
+export interface ProcessStateRow {
+    id: string;
+    pid: number | null;
+    status: string;
+    started_at: string | null;
+    stopped_at: string | null;
+    restart_count: number;
+    last_error: string | null;
+    health_status: string | null;
+    exit_code: number | null;
+    socket_path: string | null;
+    last_activity: string | null;
+    idle_timeout_ms: number | null;
+    retry_count: number;
+    stale_socket: number;
+    killed_by_daemon: number;
+    ephemeral: number;
+    first_observed_at: string | null;
+    command_signature: string | null;
+    adopted: number;
+    updated_at: string;
+    consecutive_crash_restarts?: number | null;
+    signal?: string | null;
+}
+export interface ResourceStateRow {
+    id: string;
+    type: string;
+    status: string;
+    created_at: string | null;
+    updated_at: string | null;
+    last_checked: string;
+    metadata: string | null;
+    config: string | null;
+    error: string | null;
+    last_error: string | null;
+    progress: number | null;
+}
+/**
+ * A state write that ends a run: the tracked pid is released, or a live row
+ * records its exit code (task rows keep their pid). Every writer that retires
+ * a process — lifecycle's exit handler and `stop`, the daemon health monitor's
+ * kill, the liveness checker — passes through `update`, which makes this the
+ * one seam where "the previous run is over" is observable without teaching
+ * each writer. Consumed by services/process-log-archive.ts.
+ */
+export interface ProcessRunEnd {
+    existing: ProcessState;
+    updates: Partial<ProcessState>;
+}
+export type ProcessRunEndListener = (event: ProcessRunEnd) => void | Promise<void>;
+/** Observes every committed process state write (`set` and `update`), after it lands. */
+export type ProcessStateListener = (state: ProcessState) => void;
+/** An `upsert` write: any state fields, with the `status` a newly created row needs. */
+export type ProcessStateUpsert = Partial<ProcessState> & Pick<ProcessState, 'status'>;
+/**
+ * Who ended a run. `health-kill` is the daemon health monitor's force kill,
+ * `restart-rpc` / `stop-rpc` are operator commands through the manager, and
+ * `exit` is the process leaving on its own (crash or clean exit).
+ */
+export type RunEndInitiator = 'health-kill' | 'restart-rpc' | 'stop-rpc' | 'exit';
+//# sourceMappingURL=store.d.ts.map

package/dist/schemas/store.d.ts.map

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

package/dist/schemas/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/schemas/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/schemas/store.ts"],"names":[],"mappings":""}

package/dist/schemas/task-supervision.d.ts

@@ -0,0 +1,16 @@
+/** Private PM config data. Public ProcessConfigSchema deliberately cannot author these obligations. */
+import * as z from 'zod/v4';
+export declare const TaskObligationSchema: z.ZodObject<{
+    admissionId: z.ZodString;
+    release: z.ZodBoolean;
+    launchDigest: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const TaskObligationsSchema: z.ZodArray<z.ZodObject<{
+    admissionId: z.ZodString;
+    release: z.ZodBoolean;
+    launchDigest: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>;
+export type TaskObligation = z.infer<typeof TaskObligationSchema>;
+//# sourceMappingURL=task-supervision.d.ts.map

package/dist/schemas/task-supervision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-supervision.d.ts","sourceRoot":"","sources":["../../src/schemas/task-supervision.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,oBAAoB;;;;;kBAKtB,CAAC;AACZ,eAAO,MAAM,qBAAqB;;;;;mBAGjC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schemas/task-supervision.js

@@ -0,0 +1,10 @@
+/** Private PM config data. Public ProcessConfigSchema deliberately cannot author these obligations. */
+import * as z from 'zod/v4';
+export const TaskObligationSchema = z.object({
+    admissionId: z.string().uuid(),
+    release: z.boolean(),
+    launchDigest: z.string().regex(/^[a-f0-9]{64}$/),
+    startedAt: z.number().int().nonnegative().optional()
+}).strict();
+export const TaskObligationsSchema = z.array(TaskObligationSchema).refine(entries => new Set(entries.map(entry => entry.admissionId)).size === entries.length, { message: 'A PM admission can hold a process only once.' });
+//# sourceMappingURL=task-supervision.js.map

package/dist/schemas/task-supervision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-supervision.js","sourceRoot":"","sources":["../../src/schemas/task-supervision.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CACxE,OAAO,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EACnF,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAC3D,CAAC"}