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

package/dist/errors.d.ts

@@ -0,0 +1,262 @@
+/**
+ * PM Error Handling
+ * Comprehensive error types and messages with helpful context
+ *
+ * Every PM error is a `CapabilityError`: `code` is the cross-surface failure
+ * code, `reason` is the PM-specific id (`process-not-found`, `port-in-use`, …),
+ * `explanation` is the human text shown under the message, and `fix` is the
+ * recovery steps (also carried as the `recoveryHint`).
+ */
+import { CapabilityError, CaughtFailureSchema, type CaughtFailure } from '@vibesdotdev/kernel';
+/** What a PM error may carry beyond its text: the failure that caused it. */
+export interface PMErrorOptions {
+    cause?: CaughtFailure;
+}
+/**
+ * Whatever a catch binding can hold: the input type of Runtime's own
+ * `CaughtFailureSchema.parse`. The exported constructors that take a `cause`
+ * accept it raw (their callers sit in catch blocks) and parse it inside, so a
+ * hostile value never throws out of the constructor.
+ */
+export type RawCause = Parameters<typeof CaughtFailureSchema.parse>[0];
+export declare class PMError extends CapabilityError {
+    logPath?: string;
+    /** Human text under the message. */
+    readonly explanation?: string;
+    /** Recovery steps, one per line. */
+    readonly fix?: string;
+    constructor(message: string, pmErrorId: string, explanation?: string, fix?: string, options?: PMErrorOptions);
+    /**
+     * Set the log path for this error
+     */
+    withLogPath(logPath: string): this;
+    /**
+     * Format error for display
+     */
+    format(): string;
+}
+/**
+ * Process not found error
+ */
+export declare class ProcessNotFoundError extends PMError {
+    constructor(processId: string);
+}
+/**
+ * Process already running error
+ */
+export declare class ProcessAlreadyRunningError extends PMError {
+    constructor(processId: string, pid: number);
+}
+/**
+ * Process not running error
+ */
+export declare class ProcessNotRunningError extends PMError {
+    constructor(processId: string);
+}
+/**
+ * Process start failed error
+ */
+export declare class ProcessStartFailedError extends PMError {
+    constructor(processId: string, reason?: string);
+}
+/**
+ * Preset not found error
+ */
+export declare class PresetNotFoundError extends PMError {
+    constructor(presetId: string);
+}
+/**
+ * Resource not found error
+ */
+export declare class ResourceNotFoundError extends PMError {
+    constructor(resourceId: string);
+}
+/**
+ * Resource setup failed error
+ */
+export declare class ResourceSetupFailedError extends PMError {
+    constructor(resourceId: string, reason?: string);
+}
+/**
+ * Daemon not running error
+ */
+export declare class DaemonNotRunningError extends PMError {
+    constructor();
+}
+/**
+ * Daemon already running error
+ */
+export declare class DaemonAlreadyRunningError extends PMError {
+    constructor(pid: number);
+}
+/**
+ * Configuration not found error
+ */
+export declare class ConfigurationNotFoundError extends PMError {
+    constructor();
+}
+/**
+ * Configuration invalid error
+ */
+export declare class ConfigurationInvalidError extends PMError {
+    constructor(reason: string);
+}
+/**
+ * Dependency cycle error
+ */
+export declare class DependencyCycleError extends PMError {
+    constructor(cycle: string[]);
+}
+/**
+ * Health check failed error
+ */
+export declare class HealthCheckFailedError extends PMError {
+    constructor(processId: string, reason?: string);
+}
+/**
+ * Timeout error
+ */
+export declare class TimeoutError extends PMError {
+    constructor(operation: string, timeout: number);
+}
+/**
+ * Permission denied error
+ */
+export declare class PermissionDeniedError extends PMError {
+    constructor(operation: string, reason?: string);
+}
+/**
+ * Port already in use error
+ */
+export declare class PortInUseError extends PMError {
+    constructor(port: number, processId?: string);
+}
+/**
+ * Command not found error
+ */
+export declare class CommandNotFoundError extends PMError {
+    constructor(command: string, processId?: string);
+}
+/**
+ * Worker runtime is not available or failed to start
+ */
+export declare class WorkerUnavailableError extends PMError {
+    constructor(message: string, cause?: RawCause, fix?: string);
+}
+/**
+ * Worker job timed out waiting for completion
+ */
+export declare class WorkerTimeoutError extends PMError {
+    readonly jobId: string;
+    readonly timeoutMs: number;
+    constructor(jobId: string, timeoutMs: number);
+}
+/**
+ * Worker job failed during execution
+ */
+export declare class WorkerJobFailedError extends PMError {
+    readonly jobId: string;
+    readonly jobError: string;
+    constructor(jobId: string, jobError: string);
+}
+/**
+ * Worker version mismatch - runtime is stale and needs restart
+ */
+export declare class WorkerVersionMismatchError extends PMError {
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    constructor(expectedVersion: number, actualVersion: number);
+}
+/**
+ * Socket connection failed
+ */
+export declare class SocketConnectionError extends PMError {
+    constructor(socketPath: string, message: string, cause?: RawCause);
+}
+/**
+ * Helper to format error for CLI display
+ * @param error - The caught failure to format
+ * @param logPath - Optional log path to append to the message
+ */
+export declare function formatError(error: CaughtFailure, logPath?: string): string;
+/**
+ * Helper to extract useful error info from a caught failure. The failure is
+ * classified by its errno `code` (`ENOENT`, `EACCES`, `EADDRINUSE`,
+ * `ETIMEDOUT`) or its `CapabilityError` code, never by its message text.
+ */
+export declare function enhanceError(error: CaughtFailure, context?: {
+    processId?: string;
+    presetId?: string;
+    resourceId?: string;
+    operation?: string;
+}): PMError;
+/**
+ * Worker or job reached a terminal state — no further processing possible.
+ */
+export declare class TerminalStateError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    readonly terminalStatus: string;
+    constructor(resourceType: string, resourceId: string, terminalStatus: string);
+}
+/**
+ * Attempted to operate on a resource that is already in a terminal state.
+ */
+export declare class AlreadyTerminalError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    readonly currentStatus: string;
+    constructor(resourceType: string, resourceId: string, currentStatus: string);
+}
+/**
+ * A resource was not found in the store (lane, autoloop record, process, etc.).
+ */
+export declare class NotFoundError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    constructor(resourceType: string, resourceId: string);
+}
+/**
+ * Operation was cancelled by the user or control plane.
+ */
+export declare class CancelledError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    constructor(resourceType: string, resourceId: string, reason?: string);
+}
+/**
+ * Health check failed — worker process, daemon, or managed resource is unhealthy.
+ */
+export declare class HealthCheckFailedSignalError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    constructor(resourceType: string, resourceId: string, reason?: string);
+}
+/**
+ * Progress signal — informational diagnostic entry for worker/tool-call waypoints.
+ * Not a failure; used for structured observability.
+ */
+export declare class ProgressSignalError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    readonly phase: string;
+    constructor(resourceType: string, resourceId: string, phase: string, message: string);
+}
+/**
+ * Retry limit exhausted — transient errors exceeded the configured max attempts.
+ */
+export declare class RetryLimitError extends PMError {
+    readonly resourceType: string;
+    readonly resourceId: string;
+    readonly maxAttempts: number;
+    readonly lastError: string;
+    constructor(resourceType: string, resourceId: string, maxAttempts: number, lastError: string);
+}
+/**
+ * Rate limit hit — AI provider or API returned a rate-limit response.
+ */
+export declare class RateLimitError extends PMError {
+    readonly providerId: string;
+    constructor(providerId: string, limitType?: string, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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