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

package/dist/client-replies.d.ts.map

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

package/dist/client-replies.js

@@ -0,0 +1,145 @@
+/**
+ * What the PM daemon answers over the wire, as schemas.
+ *
+ * The client reads each reply through its schema where it arrives, so every
+ * method returns a parsed domain value, never a cast of the wire object. Dates
+ * cross the wire as ISO strings; the schemas that carry one revive it here, so
+ * the type a caller sees (`Date`) is the value it gets. A reply that does not
+ * match its schema refuses `INTERNAL pm-daemon-reply-invalid` naming the fields.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { DaemonHealthSchema, DaemonReconcileSummarySchema } from "./schemas/daemon.js";
+import { PmTaskAdmissionSchema, ProcessConfigSchema, ProcessExitSchema, ProcessStateSchema } from "./schemas/process.js";
+import { ProviderPayloadSchema, ResourceStateSchema, ResourceStatusEnum } from "./schemas/resource.js";
+/** The parameters of one RPC call: named values the daemon's payload schema for that command reads. */
+export const RpcParamsSchema = z.record(z.string(), z.unknown());
+/** A daemon answer that succeeded: `success: true` and the command's own fields. */
+export const RpcSuccessSchema = z.looseObject({ success: z.literal(true) });
+/** A daemon answer that failed: the `error` text it carries. */
+export const RpcFailureSchema = z.object({ error: z.string().min(1) });
+/** The fields of a schema issue list, as value-free names. */
+function issueFields(error) {
+    return [...new Set(error.issues.map((issue) => issue.path.join('.') || '(reply)'))];
+}
+/** `reply` read as `schema`, or the typed refusal naming `command` and the fields that did not match. */
+export function parseReply(command, schema, reply) {
+    const parsed = schema.safeParse(reply);
+    if (parsed.success)
+        return parsed.data;
+    throw new CapabilityError(`The PM daemon answered '${command}' with a reply this client cannot read.`, 'INTERNAL', {
+        reason: 'pm-daemon-reply-invalid',
+        details: { command, fields: issueFields(parsed.error) },
+        cause: parsed.error
+    });
+}
+/** A date off the wire; one that does not parse is dropped (undefined), never an Invalid Date that fails further away. */
+const WireDateSchema = z
+    .union([z.date(), z.string(), z.number()])
+    .transform((value) => {
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+})
+    .optional();
+/** A resource state off the wire, its dates revived. */
+export const WireResourceStateSchema = ResourceStateSchema.extend({ createdAt: WireDateSchema, updatedAt: WireDateSchema });
+export const ResourceSetupResultSchema = z.object({
+    state: WireResourceStateSchema,
+    metadata: ProviderPayloadSchema.optional(),
+    skipped: z.boolean().optional(),
+    skipReason: z.string().optional()
+});
+export const ResourceStatusResultSchema = z.object({
+    status: ResourceStatusEnum,
+    metadata: ProviderPayloadSchema.optional(),
+    error: z.string().optional(),
+    progress: z.number().optional(),
+    stale: z.boolean().optional(),
+    updatedAt: WireDateSchema
+});
+const PresetErrorsSchema = z.array(z.object({ id: z.string(), error: z.string() }));
+export const PresetStartResultSchema = z.object({
+    success: z.boolean(),
+    resourcesSetup: z.array(z.string()),
+    processesStarted: z.array(z.string()),
+    errors: PresetErrorsSchema
+});
+export const PresetStopResultSchema = z.object({
+    success: z.boolean(),
+    processesStopped: z.array(z.string()),
+    resourcesTornDown: z.array(z.string()),
+    errors: PresetErrorsSchema
+});
+export const DeclaredStartResultSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('process'), state: ProcessStateSchema, alreadyRunning: z.boolean().optional() }),
+    z.object({ kind: z.literal('resource'), result: ResourceSetupResultSchema }),
+    z.object({ kind: z.literal('dependencies'), result: PresetStartResultSchema, target: ProcessStateSchema.optional() })
+]);
+/**
+ * The daemon's `await-exit` answer, as data so each outcome keeps its identity
+ * across the wire: the run's exit, its deadline, no such process, a later run,
+ * or `interrupted` (the daemon is shutting down or published a new host
+ * generation; the caller re-issues).
+ */
+export const AwaitExitReplySchema = z.discriminatedUnion('outcome', [
+    z.object({ outcome: z.literal('exited'), exit: ProcessExitSchema }),
+    z.object({ outcome: z.literal('deadline') }),
+    z.object({ outcome: z.literal('absent') }),
+    z.object({ outcome: z.literal('superseded') }),
+    z.object({ outcome: z.literal('interrupted'), cause: z.enum(['shutdown', 'generation']) })
+]);
+/** A process or fleet proxy the daemon attached for a liveness profile; its shape is the fleet's. */
+const LivenessProxySchema = z.looseObject({});
+export const LivenessProfileStateSchema = z.looseObject({
+    profile: z.string().optional(),
+    env: z.string().optional(),
+    proxy: LivenessProxySchema.nullish(),
+    scope: z.string().optional()
+});
+/** The daemon's `liveness-set` answer: ok unless it says otherwise; a fleet attach names its proxy and a note. */
+export const LivenessSetReplySchema = z.looseObject({
+    ok: z.boolean().optional(),
+    error: z.string().optional(),
+    proxy: LivenessProxySchema.nullish(),
+    note: z.string().optional()
+});
+/** The reply fields of each command the client reads, keyed by what the client names them. */
+export const ProcessStateReplySchema = z.object({ state: ProcessStateSchema });
+export const OptionalProcessStateReplySchema = z.object({ state: ProcessStateSchema.nullish() });
+export const ProcessStatesReplySchema = z.object({ states: z.array(ProcessStateSchema) });
+export const HealthReplySchema = z.object({ health: DaemonHealthSchema });
+export const ReconcileReplySchema = z.object({ summary: DaemonReconcileSummarySchema });
+export const IsRunningReplySchema = z.object({ isRunning: z.boolean() });
+export const LogsReplySchema = z.object({ logs: z.string() });
+export const LogsSinceReplySchema = z.object({
+    stdout: z.string(),
+    stderr: z.string(),
+    offsets: z.object({ stdout: z.number(), stderr: z.number() })
+});
+export const UnregisterReplySchema = z.object({ unregistered: z.boolean() });
+export const SupervisedAdmissionReplySchema = z.object({ admission: PmTaskAdmissionSchema.nullable() });
+export const SupervisedAcknowledgementReplySchema = z.object({ acknowledged: z.boolean() });
+export const ConfigReplySchema = z.object({ config: ProcessConfigSchema.nullish() });
+export const ConfigsReplySchema = z.object({ configs: z.array(ProcessConfigSchema) });
+export const LivenessGetReplySchema = z.object({ active: LivenessProfileStateSchema.nullish(), proxy: LivenessProxySchema.nullish() });
+export const ResourceSetupReplySchema = z.object({ result: ResourceSetupResultSchema });
+export const ResourceStatusReplySchema = z.object({ status: ResourceStatusResultSchema });
+export const ResourceStalenessReplySchema = z.object({
+    stale: z.boolean(),
+    storedHash: z.string().optional(),
+    currentHash: z.string().optional()
+});
+export const ResourceStateReplySchema = z.object({ state: WireResourceStateSchema.nullish() });
+export const ResourceStatesReplySchema = z.object({ states: z.array(WireResourceStateSchema) });
+export const PresetStartReplySchema = z.object({ result: PresetStartResultSchema });
+export const PresetStopReplySchema = z.object({ result: PresetStopResultSchema });
+export const StartAllReplySchema = z.object({
+    result: PresetStartResultSchema,
+    declared: z.object({ processes: z.number(), resources: z.number() })
+});
+export const StartDeclaredReplySchema = z.object({ started: DeclaredStartResultSchema });
+export const WorkersReadyReplySchema = z.object({ ready: z.boolean().optional() });
+export const SocketStatusReplySchema = z.object({
+    status: z.object({ exists: z.boolean(), connectable: z.boolean(), path: z.string().optional() })
+});
+//# sourceMappingURL=client-replies.js.map

package/dist/client-replies.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,345 @@
+/**
+ * PM Client
+ * Connects to PM daemon via the runtime-rpc-unix three-verb protocol
+ * (connectUnix + wireConsumer). The legacy HTTP-over-unix `pm-command` wire
+ * is gone; `rpc()` now routes through the RPC root the PM daemon exposes via
+ * `listenUnix`.
+ *
+ * Dates cross the wire as ISO strings, which are JSON-safe. The blanket
+ * dateReviver is still gone, but "parsed by callers that need Date objects"
+ * was not a workable contract: the methods below advertise `Date`-typed
+ * fields, nothing enforced that a caller parse them, and the first one that
+ * did not took a shipping command down (`vibes pm resource list` →
+ * "e.getTime is not a function", mid-table). So each reply is revived where
+ * its own shape is known — see `reviveResourceStatusDates` /
+ * `reviveResourceStateDates` — and the advertised type is the received type.
+ * Methods that return raw JSON keep returning raw JSON.
+ */
+import { type PathRoots, type RuntimePath } from '@vibesdotdev/paths';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { IProcessManager, StartOptions, StopOptions } from './interface.ts';
+import type { PmTaskInput, PmTaskOptions, PmTaskResult, PmSupervisedTaskOptions } from './tasks/schemas.ts';
+import { type PmTaskProcessIdentity, type PmTaskSettlement, type AwaitExitOptions, type ProcessConfig, type ProcessConfigInput, type ProcessExit, type ProcessState, type ProcessLogOptionsInput } from './schemas/process.ts';
+import { type DaemonHandoffReceipt, type DaemonHealth, type DaemonReconcileSummary, type DaemonShutdownReceipt } from './schemas/daemon.ts';
+import type { ResourceConfig, ResourceState } from './schemas/resource.ts';
+import type { ResourceSetupOptions, ResourceSetupResult, ResourceStatusOptions, ResourceStatusResult } from './resources/provider.ts';
+import type { PresetExecutionOptions, PresetStartResult, PresetStopResult } from './managers/preset-executor.ts';
+import type { DeclaredStartResult } from './schemas/daemon-command.ts';
+export type { DeclaredStartResult };
+import { type DaemonLaunchLockState } from './utils/daemon-launch-lock.ts';
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import type { DaemonStartOptions, PMClientRuntime } from './schemas/client.ts';
+export type { DaemonStartOptions, PMClientRuntime } from './schemas/client.ts';
+import { type LivenessProfileState, type LivenessSetReply } from './client-replies.ts';
+export type { RpcParams, RpcReply, RpcSuccess } from './client-replies.ts';
+/**
+ * The confirmed-absence outcome of a daemon call: no daemon is listening at
+ * the socket. That is the transport's typed `UNAVAILABLE socket-unreachable`
+ * (an absent socket or a refused connect), or the raw errno it types
+ * (`ENOENT`, `ECONNREFUSED`) on an error or its cause. A message that merely
+ * mentions a code is not absence: a daemon relaying an `ENOENT` of its own
+ * answered, and that failure propagates.
+ */
+export declare function isDaemonUnavailableError(failure: CaughtFailure): boolean;
+export declare class PMClient extends BaseRuntimeClient<PMClientRuntime> implements IProcessManager {
+    /** Explicit, or computed from the admitted workspace on first use (see resolveSocketPath). */
+    private socketPath;
+    private usesDefaultSocket;
+    private readonly autoStartDaemon;
+    /**
+     * The workspace this client's daemon supervises: the explicit root, else
+     * the admitted workspace (framework-M8) of the runtime it resolves against,
+     * read on first use. Null until then.
+     */
+    private workspaceIdentity;
+    /** The runtime the caller handed in: its admission names the daemon and its roots place every PM path. */
+    /** The roots every PM path joins under: injected, else `getPathRoots(runtime)`. */
+    private readonly roots;
+    /** Injected path mechanics (see constructor options.runtimePath); else resolved from `runtime` on first use. */
+    private readonly runtimePath?;
+    constructor(socketPath: string | undefined, options: {
+        /**
+         * The runtime the caller was handed. Its admitted workspace
+         * (`pm/admitted-workspace`) names the daemon unless `workspaceRoot` is
+         * given, and its roots place the socket, PID file, launch lock and logs.
+         * Required: PM never reads a host-bound default runtime.
+         */
+        runtime: PMClientRuntime;
+        workspaceRoot?: string;
+        autoStartDaemon?: boolean;
+        /**
+         * Path roots already resolved from `runtime` (a `provide(runtime)`
+         * context impl has them in hand). Omitted: `getPathRoots(runtime)`.
+         *
+         * History: an ambient `getPathRoots()` fallback once ran against a
+         * different runtime instance with no kinds (the studio TUI) and threw
+         * `Kind 'paths/roots' is not registered`, which the PM dashboard reported
+         * as "0 running" / "daemon down" while 6+ processes ran.
+         */
+        roots?: PathRoots;
+        /** Path mechanics already resolved from `runtime`. Omitted: `getRuntimePath(runtime)` on first use. */
+        runtimePath?: RuntimePath;
+    }, context?: KindContext<PMClientRuntime>);
+    /**
+     * The workspace this client's daemon supervises: the explicit root, else
+     * the admitted workspace of its runtime's binding. An unadmitted binding
+     * fails with `PERMISSION_DENIED` `workspace-not-admitted`, so nothing is
+     * ever started or addressed for a workspace PM was not admitted to.
+     */
+    private workspace;
+    /** The daemon socket: explicit, or named by the admitted workspace on first use. */
+    private resolveSocketPath;
+    /**
+     * Check if daemon is running and reachable
+     */
+    isDaemonRunning(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Reads the current launch-lock without acquiring, reclaiming, or waiting
+     * on it, through the runtime's filesystem and process service, resolving
+     * the workspace first. Read-only status surfaces use this when no daemon
+     * is reachable.
+     */
+    readDaemonLaunchLockState(): Promise<DaemonLaunchLockState>;
+    /** The roots and path mechanics every PM path of this client joins under. */
+    private pathOptions;
+    /**
+     * Attempt to start the daemon
+     * @returns true if daemon started successfully or was already running
+     * @throws CapabilityError if the daemon fails to start
+     */
+    attemptStartDaemon(options?: DaemonStartOptions): Promise<boolean>;
+    /** Signal only the child this launch owns, and observe its exit before releasing the lease. */
+    private reapFailedDaemonLaunch;
+    private cleanupStaleDaemonArtifacts;
+    /** Remove `path`; an already-absent file (`ENOENT`) is the goal, any other failure propagates. */
+    private removeFileIfPresent;
+    /**
+     * Ensure daemon is running (check, attempt, fail with useful error)
+     */
+    ensureDaemonRunning(options?: DaemonStartOptions): Promise<void>;
+    /**
+     * A read: the same RPC, but it never starts the daemon. Status, logs and
+     * config lookups report that the daemon is not running instead of spawning
+     * one, so running a read command anywhere has no side effects.
+     */
+    private read;
+    /** An RPC whose reply is read through `schema` where it arrives. */
+    private callReply;
+    /** A read whose reply is read through `schema` where it arrives. */
+    private readReply;
+    /**
+     * Make an RPC call to the PM daemon via the runtime-rpc-unix three-verb
+     * protocol. Each call opens a connection, invokes one method on the PM
+     * RPC root (the method name IS the command name), and closes. The legacy
+     * HTTP `fetch('http://pm/rpc', { unix })` + `dateReviver` envelope is gone.
+     */
+    private rpc;
+    start(config: ProcessConfigInput, options?: StartOptions): Promise<ProcessState>;
+    stop(processId: string, options?: StopOptions): Promise<void>;
+    /**
+     * Restart a managed process. `guard.expectedPid` lets a body that asks to
+     * be rolled prove it IS the process the daemon tracks under `processId`;
+     * the daemon refuses when the tracked pid differs. Measured 2026-09-05: an
+     * orphan carrying an inherited VIBES_PM_MANAGED stamp rolled the healthy
+     * shared MCP host every five minutes (552 of 586 restarts).
+     */
+    restart(processId: string, options?: StartOptions, guard?: {
+        expectedPid?: number;
+    }): Promise<ProcessState>;
+    /**
+     * The daemon's health, or `null` when no daemon is listening (its socket
+     * missing or refusing: the confirmed-absence codes). Any other failure,
+     * a timeout from a daemon that accepted the call included, propagates.
+     * The default 1 s suits a liveness probe; work that must wait for a busy
+     * daemon passes a longer `timeoutMs`.
+     */
+    health(timeoutMs?: number): Promise<DaemonHealth | null>;
+    reconcileState(): Promise<DaemonReconcileSummary>;
+    /**
+     * Ask the daemon to perform its own orderly shutdown.
+     *
+     * This is intentionally an RPC instead of a caller-side signal: the daemon
+     * is the only owner that can drain managed children, persist their stopped
+     * state, and remove its socket/PID artifacts coherently.
+     */
+    shutdownDaemon(): Promise<DaemonShutdownReceipt>;
+    /** Release the serving daemon while preserving its tracked managed runs. */
+    handoffDaemon(): Promise<DaemonHandoffReceipt>;
+    getStatus(processId: string): Promise<ProcessState | undefined>;
+    getAllStatus(): Promise<ProcessState[]>;
+    isRunning(processId: string): Promise<boolean>;
+    /**
+     * Await a run's exit through the daemon's `await-exit`: one RPC that ends
+     * on the exit (never a status poll). `run` names the run; absent, the run
+     * current now is read once and pinned, so a re-issue never latches onto a
+     * later run. The deadline is the caller's (default the host timer ceiling
+     * less the RPC margin); the caller's signal closes the connection.
+     *
+     * Re-issue: when the daemon answers `interrupted` (a new host generation,
+     * or shutdown) or the connection drops before a reply, the same
+     * `{ processId, run }` is sent again within the remaining deadline. Each
+     * re-issue follows a daemon event, never a timer: after a shutdown the
+     * client first awaits the old daemon closing its connection, then goes
+     * through the launch-lock-serialized `ensureDaemonRunning` (auto-start
+     * clients). A re-issue no daemon answers refuses `UNAVAILABLE`
+     * `pm-await-exit-interrupted`.
+     */
+    awaitExit(processId: string, options?: AwaitExitOptions): Promise<ProcessExit>;
+    /** The run `processId` is on now, read once; no state refuses `NOT_FOUND` `pm-process-state-not-found`. */
+    private currentRun;
+    getLogs(processId: string, options?: ProcessLogOptionsInput): Promise<string>;
+    /** What `processId`'s logs gained since `offsets`, complete lines only, redacted by the daemon (RC05). */
+    getLogsSince(processId: string, offsets: {
+        stdout: number;
+        stderr: number;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        offsets: {
+            stdout: number;
+            stderr: number;
+        };
+    }>;
+    register(config: ProcessConfigInput): Promise<void>;
+    unregister(processId: string): Promise<boolean>;
+    /** Ordinary tasks on the client the caller already selected. */
+    runTask(task: PmTaskInput, options: PmTaskOptions): Promise<PmTaskResult>;
+    /** Local owner capability: terminal acknowledgement is awaited before ephemeral task release. */
+    runSupervisedTask(task: PmTaskInput, options: PmSupervisedTaskOptions): Promise<PmTaskResult>;
+    admitSupervisedTask(identity: PmTaskProcessIdentity, task: PmTaskInput, options: Pick<PmSupervisedTaskOptions, 'runId' | 'tags' | 'signal'>): Promise<{
+        id: string;
+        status: "pass" | "stopping" | "stopped" | "running" | "crashed" | "starting" | "completed" | "waiting" | "fail";
+        restartCount: number;
+        consecutiveCrashRestarts: number;
+        retryCount: number;
+        pid?: number | undefined;
+        startedAt?: Date | undefined;
+        stoppedAt?: Date | undefined;
+        lastError?: string | undefined;
+        healthStatus?: "unknown" | "healthy" | "unhealthy" | undefined;
+        exitCode?: number | undefined;
+        signal?: string | undefined;
+        socketPath?: string | undefined;
+        lastActivity?: Date | undefined;
+        idleTimeoutMs?: number | undefined;
+        staleSocket?: boolean | undefined;
+        killedByDaemon?: boolean | undefined;
+        ephemeral?: boolean | undefined;
+        firstObservedAt?: Date | undefined;
+        commandSignature?: string | undefined;
+        adopted?: boolean | undefined;
+    }>;
+    supervisedAdmission(identity: PmTaskProcessIdentity): Promise<{
+        scope: {
+            workspacePath: string;
+            toolingId: string;
+        };
+        admissionId: string;
+        processId: string;
+        release: boolean;
+        startedAt?: number | undefined;
+        settlement?: {
+            scope: {
+                workspacePath: string;
+                toolingId: string;
+            };
+            admissionId: string;
+            processId: string;
+            startedAt: number;
+            status: "pass" | "stopped" | "crashed" | "completed" | "fail";
+            succeeded: boolean;
+            exitCode: number | null;
+            signal: string | null;
+            pid: number | null;
+            stoppedAt: number | null;
+        } | undefined;
+    } | null>;
+    acknowledgeSupervised(receipt: PmTaskSettlement): Promise<boolean>;
+    private taskSupervisionScope;
+    getConfig(processId: string): Promise<ProcessConfig | undefined>;
+    getAllConfigs(): Promise<ProcessConfig[]>;
+    touch(processId: string, timestamp?: Date | number): Promise<void>;
+    setLivenessProfile(profile: string, options?: {
+        env?: string;
+        scope?: string;
+    }): Promise<LivenessSetReply>;
+    getActiveLivenessProfile(options?: {
+        env?: string;
+        scope?: string;
+    }): Promise<LivenessProfileState | undefined>;
+    setupResource(config: ResourceConfig, options?: ResourceSetupOptions): Promise<ResourceSetupResult>;
+    /**
+     * Set up a declared resource by id: the daemon resolves its config against
+     * its own graph (pm.md C1). Same budget as {@link setupResource}'s floor.
+     */
+    setupDeclaredResource(resourceId: string, options?: ResourceSetupOptions, readyTimeoutMs?: number): Promise<ResourceSetupResult>;
+    stopResource(resourceId: string): Promise<void>;
+    resumeResource(resourceId: string): Promise<void>;
+    restartResource(resourceId: string): Promise<void>;
+    teardownResource(resourceId: string): Promise<void>;
+    getResourceStatus(resourceId: string, options?: ResourceStatusOptions, config?: ResourceConfig): Promise<ResourceStatusResult>;
+    checkResourceStaleness(config: ResourceConfig): Promise<{
+        stale: boolean;
+        storedHash?: string;
+        currentHash?: string;
+    }>;
+    getResourceState(resourceId: string): Promise<ResourceState | undefined>;
+    getAllResourceStates(): Promise<ResourceState[]>;
+    getAllResourceStateSummaries(): Promise<ResourceState[]>;
+    /**
+     * Start a declared preset by id. The daemon resolves it against its own
+     * graph (pm.md C1): the client sends the id, never a config.
+     *
+     * Preset starts can take a while when maxProcessConcurrency serializes warmup:
+     * each process holds its semaphore slot until it reports healthy (warmupMs
+     * budget is up to ~2.5min per app). A 15-app preset at concurrency 2 can take
+     * 20+ minutes end-to-end; budget 30min so the CLI doesn't abort the RPC.
+     */
+    startPreset(presetId: string, options?: PresetExecutionOptions): Promise<PresetStartResult>;
+    /** Stop a declared preset by id. Stops are teardown-only and fast; 5min covers large presets. */
+    stopPreset(presetId: string): Promise<PresetStopResult>;
+    /** Restart a declared preset by id: stop, then the long start (see startPreset). */
+    restartPreset(presetId: string, options?: PresetExecutionOptions): Promise<PresetStartResult>;
+    /**
+     * Tear down a declared preset by id (destructive: processes and resources).
+     * Resources like kind clusters can take minutes to delete; 10min covers it.
+     */
+    teardownPreset(presetId: string): Promise<PresetStopResult>;
+    /**
+     * Start every declared process and resource, in dependency order. The
+     * daemon reads its own graph; `declared` counts what it found.
+     */
+    startAll(options?: PresetExecutionOptions): Promise<{
+        result: PresetStartResult;
+        declared: {
+            processes: number;
+            resources: number;
+        };
+    }>;
+    /**
+     * Start one declared process or resource by id, with its declared
+     * dependencies and conflicts, resolved by the daemon against its graph.
+     * A target with dependencies runs as a preset, so it gets the preset budget.
+     */
+    startDeclared(id: string, options?: PresetExecutionOptions, target?: {
+        kind?: 'process';
+    }): Promise<DeclaredStartResult>;
+    ensureWorkerRuntime(target?: 'consumer' | 'cloud'): Promise<void>;
+    /**
+     * Whether the worker runtime answers on its socket. No PM daemon listening
+     * (confirmed absence) is `false`; any other failure propagates typed.
+     */
+    checkWorkersReady(timeout?: number, target?: 'consumer' | 'cloud'): Promise<boolean>;
+    cleanupSocket(processId: string): Promise<void>;
+    getSocketStatus(processId: string): Promise<{
+        exists: boolean;
+        connectable: boolean;
+        path?: string;
+    }>;
+    /**
+     * Disconnect from daemon (no-op for HTTP - connections are stateless)
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAIN,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EACX,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACX,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,OAAO,EAUN,KAAK,qBAAqB,EAC1B,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EAKN,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAc/E,OAAO,EA+BN,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAIrB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAyH3E;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAWxE;AAmBD,qBAAa,QAAS,SAAQ,iBAAiB,CAAC,eAAe,CAAE,YAAW,eAAe;IAC1F,8FAA8F;IAC9F,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAA2B;IACpD,0GAA0G;IAC1G,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,gHAAgH;IAChH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAG1C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE;QACR;;;;;WAKG;QACH,OAAO,EAAE,eAAe,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;;;;;;WAQG;QACH,KAAK,CAAC,EAAE,SAAS,CAAC;QAClB,uGAAuG;QACvG,WAAW,CAAC,EAAE,WAAW,CAAC;KAC1B,EACD,OAAO,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC;IAcvC;;;;;OAKG;YACW,SAAS;IAOvB,oFAAoF;YACtE,iBAAiB;IAa/B;;OAEG;IACG,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;;;;OAKG;IACG,yBAAyB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAKjE,6EAA6E;YAC/D,WAAW;IAIzB;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkM5E,+FAA+F;YACjF,sBAAsB;YAkBtB,2BAA2B;IA0BzC,kGAAkG;YACpF,mBAAmB;IAMjC;;OAEG;IACG,mBAAmB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAIZ,oEAAoE;YACtD,SAAS;IASvB,oEAAoE;YACtD,SAAS;IASvB;;;;;OAKG;YACW,GAAG;IAqHX,KAAK,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAKhF,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;;;;;OAMG;IACG,OAAO,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,YAAY,CAAC;IAOxB;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAOtD,cAAc,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAKvD;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAItD,4EAA4E;IACtE,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI9C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAK/D,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAOvC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmExF,2GAA2G;YAC7F,UAAU;IAWlB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnF,0GAA0G;IACpG,YAAY,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAIrF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrD,gEAAgE;IAC1D,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E,iGAAiG;IAC3F,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAO7F,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;IAS3I,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;IAKnD,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;YAK1D,oBAAoB;IAe5B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKhE,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKzC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,OAAO,CAAC,gBAAgB,CAAC;IAItB,wBAAwB,CAAC,OAAO,CAAC,EAAE;QACxC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAcvC,aAAa,CAClB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAY/B;;;OAGG;IACG,qBAAqB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,cAAc,SAAQ,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAMzB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,EAC/B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,oBAAoB,CAAC;IAS1B,sBAAsB,CAC3B,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAInE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKxE,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKhD,4BAA4B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAU9D;;;;;;;;OAQG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUjG,iGAAiG;IAC3F,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAK7D,oFAAoF;IAC9E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUnG;;;OAGG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKjE;;;OAGG;IACG,QAAQ,CACb,OAAO,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAI7F;;;;OAIG;IACG,aAAa,CAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,sBAAsB,EAChC,MAAM,GAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAO,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAgBzB,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE;;;OAGG;IACG,iBAAiB,CAAC,OAAO,GAAE,MAAa,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB1F,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAKF;;OAEG;IACH,UAAU,IAAI,IAAI;CAelB"}