@b00dea/cockpit 0.0.0-stage → 0.1.1

package/dist/environment/contract.d.ts

@@ -0,0 +1,522 @@
+import { type EntrypointKind } from '../entrypoint-kinds.js';
+export interface Diagnostic<Code extends string = string> {
+    severity: 'error' | 'warning' | 'info';
+    code: Code;
+    message: string;
+    target?: string;
+    fix?: string;
+}
+export type JsonSnapshot = null | boolean | number | string | JsonSnapshotArray | JsonSnapshotObject;
+interface JsonSnapshotArray extends ReadonlyArray<JsonSnapshot> {
+}
+export interface JsonSnapshotObject {
+    readonly [key: string]: JsonSnapshot;
+}
+export declare function snapshotJson(value: unknown): JsonSnapshot | undefined;
+export declare function snapshotGeneratedJson(value: unknown): JsonSnapshot | undefined;
+declare const identityBrand: unique symbol;
+type BrandedIdentity<Name extends string> = string & {
+    readonly [identityBrand]: Name;
+};
+export type CockpitId = BrandedIdentity<'CockpitId'>;
+export type CheckoutId = BrandedIdentity<'CheckoutId'>;
+export type StackId = BrandedIdentity<'StackId'>;
+export type HolderId = BrandedIdentity<'HolderId'>;
+declare const OBSERVATION_LIFECYCLE_STAGES: readonly ['bootstrap', 'steady'];
+declare const SETUP_ACTION_KINDS: readonly ['clone', 'wire-remote', 'report'];
+export declare const INHERITED_TOOL_ENVIRONMENT: readonly ["HOME", "USER", "LOGNAME", "TMPDIR", "LANG", "LC_ALL", "LC_CTYPE", "TZ"];
+export declare const DOCKER_CLIENT_ENVIRONMENT: ReadonlySet<string>;
+export declare const HOST_PROCESS_CONTROL_ENV: RegExp;
+export declare const OBSERVATION_PRODUCER_BYTE_LIMIT = 256;
+export declare const OBSERVATION_REASON_BYTE_LIMIT = 1024;
+export declare const ENVIRONMENT_CODES: Readonly<{
+    readonly CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND';
+    readonly CONFIG_UNREADABLE: 'CONFIG_UNREADABLE';
+    readonly CONFIG_ENCODING_INVALID: 'CONFIG_ENCODING_INVALID';
+    readonly CONFIG_PARSE_INVALID: 'CONFIG_PARSE_INVALID';
+    readonly CONFIG_SCHEMA_INVALID: 'CONFIG_SCHEMA_INVALID';
+    readonly GENERATED_HOST_PATH_UNMOUNTED: 'GENERATED_HOST_PATH_UNMOUNTED';
+    readonly STATE_ROOT_UNAVAILABLE: 'STATE_ROOT_UNAVAILABLE';
+    readonly STATE_FORMAT_UNSUPPORTED: 'STATE_FORMAT_UNSUPPORTED';
+    readonly STATE_RECORD_MALFORMED: 'STATE_RECORD_MALFORMED';
+    readonly STATE_LOCKED: 'STATE_LOCKED';
+    readonly STATE_DURABILITY_INDETERMINATE: 'STATE_DURABILITY_INDETERMINATE';
+    readonly SETUP_CONFIG_REQUIRED: 'SETUP_CONFIG_REQUIRED';
+    readonly SETUP_OPTION_DUPLICATE: 'SETUP_OPTION_DUPLICATE';
+    readonly SETUP_POSITIONAL_UNSUPPORTED: 'SETUP_POSITIONAL_UNSUPPORTED';
+    readonly SETUP_PATH_OUTSIDE_ROOT: 'SETUP_PATH_OUTSIDE_ROOT';
+    readonly SETUP_PATH_SYMLINK: 'SETUP_PATH_SYMLINK';
+    readonly SETUP_PATH_TYPE_INVALID: 'SETUP_PATH_TYPE_INVALID';
+    readonly SETUP_PARENT_MISSING: 'SETUP_PARENT_MISSING';
+    readonly SETUP_REMOTE_MISMATCH: 'SETUP_REMOTE_MISMATCH';
+    readonly SETUP_REMOTE_UNRESOLVABLE: 'SETUP_REMOTE_UNRESOLVABLE';
+    readonly SETUP_MANUAL_MISSING: 'SETUP_MANUAL_MISSING';
+    readonly SETUP_CLONE_FAILED: 'SETUP_CLONE_FAILED';
+    readonly SETUP_NONE_ABSENT: 'SETUP_NONE_ABSENT';
+    readonly SETUP_NONE_DIRECTORY: 'SETUP_NONE_DIRECTORY';
+    readonly SETUP_NONE_REPOSITORY: 'SETUP_NONE_REPOSITORY';
+    readonly SETUP_POSTCHECK_FAILED: 'SETUP_POSTCHECK_FAILED';
+    readonly SETUP_INSTRUCTION_POINTER_OFFERED: 'SETUP_INSTRUCTION_POINTER_OFFERED';
+    readonly SETUP_INSTRUCTION_POINTER_INVALID: 'SETUP_INSTRUCTION_POINTER_INVALID';
+    readonly SETUP_INSTRUCTION_FILES_OFFERED: 'SETUP_INSTRUCTION_FILES_OFFERED';
+    readonly SETUP_INSTRUCTION_FILES_INVALID: 'SETUP_INSTRUCTION_FILES_INVALID';
+    readonly CONFIG_CHANGED_DURING_EXECUTION: 'CONFIG_CHANGED_DURING_EXECUTION';
+    readonly EXECUTION_SPAWN_FAILED: 'EXECUTION_SPAWN_FAILED';
+    readonly EXECUTION_PRECONDITION_CHANGED: 'EXECUTION_PRECONDITION_CHANGED';
+    readonly EXECUTION_STAGING_FAILED: 'EXECUTION_STAGING_FAILED';
+    readonly EXECUTION_STAGING_CLEANUP_FAILED: 'EXECUTION_STAGING_CLEANUP_FAILED';
+    readonly EXECUTION_TIMEOUT: 'EXECUTION_TIMEOUT';
+    readonly EXECUTION_STDOUT_LIMIT: 'EXECUTION_STDOUT_LIMIT';
+    readonly EXECUTION_STDERR_LIMIT: 'EXECUTION_STDERR_LIMIT';
+    readonly EXECUTION_STEP_FAILED: 'EXECUTION_STEP_FAILED';
+    readonly EXECUTION_ABORTED: 'EXECUTION_ABORTED';
+    readonly EXECUTION_TERMINATION_UNCONFIRMED: 'EXECUTION_TERMINATION_UNCONFIRMED';
+    readonly EXECUTION_COMPENSATION_TIMEOUT: 'EXECUTION_COMPENSATION_TIMEOUT';
+    readonly EXECUTION_COMPENSATION_STEP_FAILED: 'EXECUTION_COMPENSATION_STEP_FAILED';
+    readonly LIFECYCLE_EVIDENCE_INVALID: 'LIFECYCLE_EVIDENCE_INVALID';
+    readonly LIFECYCLE_PROGRESS_INVALID: 'LIFECYCLE_PROGRESS_INVALID';
+    readonly STACK_RECORDED_UNDER_EARLIER_NAME: 'STACK_RECORDED_UNDER_EARLIER_NAME';
+    readonly PORT_FAMILY_COLLISION: 'PORT_FAMILY_COLLISION';
+    readonly PORT_LISTENER_EVIDENCE_INVALID: 'PORT_LISTENER_EVIDENCE_INVALID';
+    readonly PORT_FAMILY_OUT_OF_RANGE: 'PORT_FAMILY_OUT_OF_RANGE';
+    readonly PORT_LEASE_EXHAUSTED: 'PORT_LEASE_EXHAUSTED';
+    readonly PORT_LOCAL_VALUE_CORRECTED: 'PORT_LOCAL_VALUE_CORRECTED';
+    readonly PORT_EXTERNAL_REGISTRATION_GAP: 'PORT_EXTERNAL_REGISTRATION_GAP';
+    readonly CLAIM_CO_TENANT: 'CLAIM_CO_TENANT';
+    readonly CLAIM_LIVENESS_UNKNOWN: 'CLAIM_LIVENESS_UNKNOWN';
+    readonly DRAIN_ATTEMPT_REPAIR_REQUIRED: 'DRAIN_ATTEMPT_REPAIR_REQUIRED';
+    readonly INSTALL_POLICY_OBSERVATION_UNAVAILABLE: 'INSTALL_POLICY_OBSERVATION_UNAVAILABLE';
+    readonly INSTALL_POLICY_OBSERVATION_INVALID: 'INSTALL_POLICY_OBSERVATION_INVALID';
+    readonly INSTALL_POLICY_MISSING: 'INSTALL_POLICY_MISSING';
+    readonly INSTALL_POLICY_AMBIGUOUS: 'INSTALL_POLICY_AMBIGUOUS';
+    readonly TEMPLATE_NOT_FOUND: 'TEMPLATE_NOT_FOUND';
+    readonly TEMPLATE_NOT_TRACKED: 'TEMPLATE_NOT_TRACKED';
+    readonly TEMPLATE_IGNORED: 'TEMPLATE_IGNORED';
+    readonly TEMPLATE_PATH_OUTSIDE_ROOT: 'TEMPLATE_PATH_OUTSIDE_ROOT';
+    readonly ENVIRONMENT_FILE_NOT_FOUND: 'ENVIRONMENT_FILE_NOT_FOUND';
+    readonly ENVIRONMENT_FILE_UNREADABLE: 'ENVIRONMENT_FILE_UNREADABLE';
+    readonly ENVIRONMENT_FILE_TOO_LARGE: 'ENVIRONMENT_FILE_TOO_LARGE';
+    readonly ENVIRONMENT_FILE_MALFORMED: 'ENVIRONMENT_FILE_MALFORMED';
+    readonly INSTANCE_NOT_IGNORED: 'INSTANCE_NOT_IGNORED';
+    readonly ENVIRONMENT_SEED_PRECONDITION_CHANGED: 'ENVIRONMENT_SEED_PRECONDITION_CHANGED';
+    readonly ENVIRONMENT_SEED_FAILED: 'ENVIRONMENT_SEED_FAILED';
+    readonly RUNTIME_UNAVAILABLE: 'RUNTIME_UNAVAILABLE';
+    readonly RUNTIME_IMAGE_UNAVAILABLE: 'RUNTIME_IMAGE_UNAVAILABLE';
+    readonly RUNTIME_UNMEASURED: 'RUNTIME_UNMEASURED';
+    readonly RUNTIME_COMPOSE_REMOTE: 'RUNTIME_COMPOSE_REMOTE';
+    readonly RUNTIME_PROBE_TIMEOUT: 'RUNTIME_PROBE_TIMEOUT';
+    readonly LOGS_TRUNCATED: 'LOGS_TRUNCATED';
+    readonly RESET_CONFIRMATION_REQUIRED: 'RESET_CONFIRMATION_REQUIRED';
+    readonly RESET_CONFIRMATION_MISMATCH: 'RESET_CONFIRMATION_MISMATCH';
+    readonly RESET_CO_TENANT: 'RESET_CO_TENANT';
+    readonly EVIDENCE_UNAVAILABLE: 'EVIDENCE_UNAVAILABLE';
+    readonly RECLAIM_LABEL_ESCAPE: 'RECLAIM_LABEL_ESCAPE';
+    readonly RECLAIM_ACCOUNTING_MISMATCH: 'RECLAIM_ACCOUNTING_MISMATCH';
+    readonly DOWN_RESOURCES_KEPT: 'DOWN_RESOURCES_KEPT';
+    readonly STACKS_ORPHANED: 'STACKS_ORPHANED';
+    readonly STACKS_PRUNE_UNCONFIRMED: 'STACKS_PRUNE_UNCONFIRMED';
+    readonly STACKS_PRUNE_INCOMPLETE: 'STACKS_PRUNE_INCOMPLETE';
+    readonly CONFIG_STALE: 'CONFIG_STALE';
+    readonly SIBLING_MISSING: 'SIBLING_MISSING';
+    readonly GUIDE_CAP_EXCEEDED: 'GUIDE_CAP_EXCEEDED';
+    readonly SIBLING_GUIDE_MISSING: 'SIBLING_GUIDE_MISSING';
+    readonly MACHINE_MEMORY_BELOW_FLOOR: 'MACHINE_MEMORY_BELOW_FLOOR';
+    readonly MACHINE_CPU_BELOW_FLOOR: 'MACHINE_CPU_BELOW_FLOOR';
+    readonly MACHINE_DISK_BELOW_FLOOR: 'MACHINE_DISK_BELOW_FLOOR';
+    readonly MACHINE_COLD_START_EXCEEDED: 'MACHINE_COLD_START_EXCEEDED';
+    readonly GIT_STATE_UNHEALTHY: 'GIT_STATE_UNHEALTHY';
+    readonly CHECKOUT_ADJACENCY_UNHEALTHY: 'CHECKOUT_ADJACENCY_UNHEALTHY';
+    readonly GIT_COMPARISON_REMOTE_MISMATCH: 'GIT_COMPARISON_REMOTE_MISMATCH';
+    readonly RUNNING_CHECKOUT_MISMATCH: 'RUNNING_CHECKOUT_MISMATCH';
+    readonly ENVIRONMENT_KEYS_STALE: 'ENVIRONMENT_KEYS_STALE';
+    readonly ENV_SCHEMA_UNHEALTHY: 'ENV_SCHEMA_UNHEALTHY';
+    readonly ENV_SCHEMA_TOOL_MISSING: 'ENV_SCHEMA_TOOL_MISSING';
+    readonly GENERATED_ENVIRONMENT_UNAVAILABLE: 'GENERATED_ENVIRONMENT_UNAVAILABLE';
+    readonly CLAIM_STATE_UNHEALTHY: 'CLAIM_STATE_UNHEALTHY';
+    readonly MOUNT_POSTURE_UNAVAILABLE: 'MOUNT_POSTURE_UNAVAILABLE';
+    readonly COMPOSE_PROFILE_UNDEFINED: 'COMPOSE_PROFILE_UNDEFINED';
+    readonly STATE_UNSEEDED: 'STATE_UNSEEDED';
+    readonly STACK_NOT_RUNNING: 'STACK_NOT_RUNNING';
+    readonly SKILL_BUDGET_UNAVAILABLE: 'SKILL_BUDGET_UNAVAILABLE';
+    readonly HARNESS_SURFACE_UNAVAILABLE: 'HARNESS_SURFACE_UNAVAILABLE';
+    readonly DIRECTORY_GRANTS_UNAVAILABLE: 'DIRECTORY_GRANTS_UNAVAILABLE';
+    readonly TEAM_METADATA_UNAVAILABLE: 'TEAM_METADATA_UNAVAILABLE';
+    readonly COCKPIT_VERSION_MISMATCH: 'COCKPIT_VERSION_MISMATCH';
+    readonly MOUNT_MATERIALIZATION_UNAVAILABLE: 'MOUNT_MATERIALIZATION_UNAVAILABLE';
+    readonly ENVIRONMENT_NOT_DECLARED: 'ENVIRONMENT_NOT_DECLARED';
+    readonly SERVICE_NOT_DECLARED: 'SERVICE_NOT_DECLARED';
+    readonly GUARD_HOSTS_UNDECLARED: 'GUARD_HOSTS_UNDECLARED';
+    readonly TESTING_GATE_UNDECLARED: 'TESTING_GATE_UNDECLARED';
+    readonly MCP_COMMAND_UNRESOLVED: 'MCP_COMMAND_UNRESOLVED';
+    readonly MCP_ENVIRONMENT_UNSET: 'MCP_ENVIRONMENT_UNSET';
+    readonly EVALUATOR_UNAVAILABLE: 'EVALUATOR_UNAVAILABLE';
+    readonly EVALUATOR_RUN_FAILED: 'EVALUATOR_RUN_FAILED';
+    readonly EVALUATOR_FELL_BACK_TO_RUNNING_TOOL: 'EVALUATOR_FELL_BACK_TO_RUNNING_TOOL';
+    readonly EVALUATOR_ANSWER_INVALID: 'EVALUATOR_ANSWER_INVALID';
+    readonly TEST_GATE_UNSATISFIED: 'TEST_GATE_UNSATISFIED';
+    readonly WORK_GRADE_UNSATISFIED: 'WORK_GRADE_UNSATISFIED';
+    readonly WORK_CHECK_FAILED: 'WORK_CHECK_FAILED';
+    readonly BROWSER_ROUTE_FINDINGS: 'BROWSER_ROUTE_FINDINGS';
+    readonly WORK_VERIFY_FAILED: 'WORK_VERIFY_FAILED';
+    readonly WORK_PERSON_REQUIRED: 'WORK_PERSON_REQUIRED';
+    readonly WORK_TEST_WEAKENED: 'WORK_TEST_WEAKENED';
+    readonly AUTONOMY_PERSON_REQUIRED: 'AUTONOMY_PERSON_REQUIRED';
+    readonly AUTONOMY_CI_ONLY: 'AUTONOMY_CI_ONLY';
+    readonly POLICY_WEAKENING_UNCONFIRMED: 'POLICY_WEAKENING_UNCONFIRMED';
+    readonly GUARD_CONFIG_UNSYNCED: 'GUARD_CONFIG_UNSYNCED';
+    readonly GUARD_CONFIG_WIDENED: 'GUARD_CONFIG_WIDENED';
+    readonly WORK_ORDER_CLOSED: 'WORK_ORDER_CLOSED';
+    readonly CODEX_HOOK_UNTRUSTED: 'CODEX_HOOK_UNTRUSTED';
+    readonly SELFTEST_CUSTOM_PROBE_UNSUPPORTED: 'SELFTEST_CUSTOM_PROBE_UNSUPPORTED';
+    readonly DECLARATION_UNCONFIRMED: 'DECLARATION_UNCONFIRMED';
+    readonly CONFIRM_PERSON_REQUIRED: 'CONFIRM_PERSON_REQUIRED';
+    readonly CONFIRM_ANSWER_NOT_LISTED: 'CONFIRM_ANSWER_NOT_LISTED';
+    readonly CONFIRM_OBSERVATION_FAILED: 'CONFIRM_OBSERVATION_FAILED';
+    readonly CONFIRM_RECORD_UNWRITABLE: 'CONFIRM_RECORD_UNWRITABLE';
+    readonly COCKPIT_NOT_INSTALLED: 'COCKPIT_NOT_INSTALLED';
+    readonly COCKPIT_LAUNCHER_UNPROVEN: 'COCKPIT_LAUNCHER_UNPROVEN';
+    readonly SIBLING_REMOTE_UNRECORDED: 'SIBLING_REMOTE_UNRECORDED';
+    readonly SECRET_FILE_TRACKED: 'SECRET_FILE_TRACKED';
+    readonly SIBLING_INSTRUCTIONS_AGENTS_ONLY: 'SIBLING_INSTRUCTIONS_AGENTS_ONLY';
+    readonly SIBLING_INSTRUCTIONS_CLAUDE_ONLY: 'SIBLING_INSTRUCTIONS_CLAUDE_ONLY';
+    readonly SIBLING_INSTRUCTIONS_UNLINKED: 'SIBLING_INSTRUCTIONS_UNLINKED';
+    readonly SIBLING_INSTRUCTIONS_MISSING: 'SIBLING_INSTRUCTIONS_MISSING';
+    readonly SIBLING_INSTRUCTIONS_TOOL_ONLY: 'SIBLING_INSTRUCTIONS_TOOL_ONLY';
+    readonly GUARD_SEARCH_PATH_RELATIVE: 'GUARD_SEARCH_PATH_RELATIVE';
+    readonly SESSION_STACK_RETAINED: 'SESSION_STACK_RETAINED';
+    readonly UPGRADE_PACKAGE_MANAGER_UNKNOWN: 'UPGRADE_PACKAGE_MANAGER_UNKNOWN';
+    readonly UPGRADE_REGISTRY_UNREACHABLE: 'UPGRADE_REGISTRY_UNREACHABLE';
+    readonly UPGRADE_VERSION_INVALID: 'UPGRADE_VERSION_INVALID';
+    readonly UPGRADE_ALREADY_CURRENT: 'UPGRADE_ALREADY_CURRENT';
+    readonly UPGRADE_INSTALL_FAILED: 'UPGRADE_INSTALL_FAILED';
+    readonly UPGRADE_SYNC_FAILED: 'UPGRADE_SYNC_FAILED';
+    readonly DATA_SEED_FAILED: 'DATA_SEED_FAILED';
+    readonly DATA_SEED_UNAVAILABLE: 'DATA_SEED_UNAVAILABLE';
+    readonly DOCS_NOT_DECLARED: 'DOCS_NOT_DECLARED';
+    readonly DOCS_DECLARATION_UNMATCHED: 'DOCS_DECLARATION_UNMATCHED';
+    readonly DOCS_REFERENCE_REMOVED: 'DOCS_REFERENCE_REMOVED';
+    readonly DOCS_TARGET_REMOVED: 'DOCS_TARGET_REMOVED';
+    readonly DECISION_NUMBER_REUSED: 'DECISION_NUMBER_REUSED';
+    readonly DECISION_UNINDEXED: 'DECISION_UNINDEXED';
+    readonly DECISION_INDEX_ENTRY_MISSING: 'DECISION_INDEX_ENTRY_MISSING';
+    readonly DECISION_STATUS_MISSING: 'DECISION_STATUS_MISSING';
+    readonly DECISION_LINK_UNRESOLVED: 'DECISION_LINK_UNRESOLVED';
+    readonly DECISION_SUPERSEDED_STALE: 'DECISION_SUPERSEDED_STALE';
+    readonly SIBLING_CHECKOUT_RECORD_INVALID: 'SIBLING_CHECKOUT_RECORD_INVALID';
+    readonly SIBLING_CHECKOUT_UNKNOWN: 'SIBLING_CHECKOUT_UNKNOWN';
+    readonly SIBLING_CHECKOUT_UNAVAILABLE: 'SIBLING_CHECKOUT_UNAVAILABLE';
+    readonly SIBLING_CHECKOUT_FOREIGN: 'SIBLING_CHECKOUT_FOREIGN';
+    readonly SIBLING_CHECKOUT_OVERRIDDEN: 'SIBLING_CHECKOUT_OVERRIDDEN';
+    readonly SIBLING_ENVIRONMENT_FILE_MISSING: 'SIBLING_ENVIRONMENT_FILE_MISSING';
+    readonly PULL_SKIPPED: 'PULL_SKIPPED';
+    readonly STACK_INPUTS_CHANGED: 'STACK_INPUTS_CHANGED';
+    readonly STACK_INPUTS_UNRECORDED: 'STACK_INPUTS_UNRECORDED';
+}>;
+export declare const EXECUTION_FAILURE_CODES: readonly ["EXECUTION_SPAWN_FAILED", "EXECUTION_PRECONDITION_CHANGED", "EXECUTION_STAGING_FAILED", "EXECUTION_STAGING_CLEANUP_FAILED", "EXECUTION_TIMEOUT", "EXECUTION_STDOUT_LIMIT", "EXECUTION_STDERR_LIMIT", "EXECUTION_STEP_FAILED", "EXECUTION_ABORTED", "EXECUTION_TERMINATION_UNCONFIRMED"];
+export declare const REFUSAL_CODES: readonly ["CONFIG_NOT_FOUND", "CONFIG_UNREADABLE", "CONFIG_ENCODING_INVALID", "CONFIG_PARSE_INVALID", "CONFIG_SCHEMA_INVALID", "STATE_ROOT_UNAVAILABLE", "STATE_FORMAT_UNSUPPORTED", "STATE_RECORD_MALFORMED", "STATE_LOCKED", "STATE_DURABILITY_INDETERMINATE", "SETUP_CONFIG_REQUIRED", "SETUP_OPTION_DUPLICATE", "SETUP_POSITIONAL_UNSUPPORTED", "SETUP_PATH_OUTSIDE_ROOT", "SETUP_PATH_SYMLINK", "SETUP_PATH_TYPE_INVALID", "SETUP_PARENT_MISSING", "SETUP_REMOTE_MISMATCH", "SETUP_REMOTE_UNRESOLVABLE", "SETUP_MANUAL_MISSING", "SETUP_CLONE_FAILED", "SETUP_POSTCHECK_FAILED", "SETUP_INSTRUCTION_POINTER_INVALID", "SETUP_INSTRUCTION_FILES_INVALID", "CONFIG_CHANGED_DURING_EXECUTION", "EXECUTION_SPAWN_FAILED", "EXECUTION_PRECONDITION_CHANGED", "EXECUTION_STAGING_FAILED", "EXECUTION_STAGING_CLEANUP_FAILED", "EXECUTION_TIMEOUT", "EXECUTION_STDOUT_LIMIT", "EXECUTION_STDERR_LIMIT", "EXECUTION_STEP_FAILED", "EXECUTION_ABORTED", "EXECUTION_TERMINATION_UNCONFIRMED", "EXECUTION_COMPENSATION_TIMEOUT", "EXECUTION_COMPENSATION_STEP_FAILED", "LIFECYCLE_EVIDENCE_INVALID", "LIFECYCLE_PROGRESS_INVALID", "STACK_RECORDED_UNDER_EARLIER_NAME", "PORT_FAMILY_COLLISION", "PORT_LISTENER_EVIDENCE_INVALID", "PORT_FAMILY_OUT_OF_RANGE", "PORT_LEASE_EXHAUSTED", "CLAIM_CO_TENANT", "CLAIM_LIVENESS_UNKNOWN", "DRAIN_ATTEMPT_REPAIR_REQUIRED", "INSTALL_POLICY_OBSERVATION_UNAVAILABLE", "INSTALL_POLICY_OBSERVATION_INVALID", "INSTALL_POLICY_MISSING", "INSTALL_POLICY_AMBIGUOUS", "TEMPLATE_NOT_FOUND", "TEMPLATE_NOT_TRACKED", "TEMPLATE_IGNORED", "TEMPLATE_PATH_OUTSIDE_ROOT", "ENVIRONMENT_FILE_NOT_FOUND", "ENVIRONMENT_FILE_UNREADABLE", "ENVIRONMENT_FILE_TOO_LARGE", "ENVIRONMENT_FILE_MALFORMED", "INSTANCE_NOT_IGNORED", "ENVIRONMENT_SEED_PRECONDITION_CHANGED", "ENVIRONMENT_SEED_FAILED", "RUNTIME_UNAVAILABLE", "RUNTIME_IMAGE_UNAVAILABLE", "RUNTIME_UNMEASURED", "RUNTIME_COMPOSE_REMOTE", "RUNTIME_PROBE_TIMEOUT", "RESET_CONFIRMATION_REQUIRED", "RESET_CONFIRMATION_MISMATCH", "RESET_CO_TENANT", "EVIDENCE_UNAVAILABLE", "RECLAIM_LABEL_ESCAPE", "RECLAIM_ACCOUNTING_MISMATCH", "DOWN_RESOURCES_KEPT", "GIT_COMPARISON_REMOTE_MISMATCH"];
+export type ObservationLifecycleStage = typeof OBSERVATION_LIFECYCLE_STAGES[number];
+export type SetupActionKind = typeof SETUP_ACTION_KINDS[number];
+export type EnvironmentCode = typeof ENVIRONMENT_CODES[keyof typeof ENVIRONMENT_CODES];
+export type ExecutionFailureCode = typeof EXECUTION_FAILURE_CODES[number];
+export type RefusalCode = typeof REFUSAL_CODES[number];
+export type EnvironmentDiagnostic = Diagnostic<EnvironmentCode>;
+export declare class RefusalError extends Error {
+}
+export declare function errorCause(error: unknown): string;
+export declare function parseJsonText(text: string, subject: string, expected: string): Readonly<{
+    value: unknown;
+}> | Readonly<{
+    refusal: string;
+}>;
+export declare function tryParseJson(text: string): unknown;
+export declare function hasErrorCode(error: unknown, ...codes: readonly string[]): boolean;
+export declare function isMissing(error: unknown): boolean;
+export declare function isCanonicalTimestamp(value: unknown): value is string;
+type ExpectedObservation = {
+    kind: 'path';
+    target: string;
+    state: 'absent' | 'directory' | 'repository';
+} | {
+    kind: 'remote';
+    target: string;
+    name: string;
+    url: string;
+};
+export interface FilesystemCheck {
+    path: string;
+    expected: 'absent' | 'directory' | 'file';
+    sha256?: string;
+    maxBytes?: number;
+    identity?: FilesystemIdentity;
+}
+export interface FilesystemObjectIdentity {
+    dev: number;
+    ino: number;
+    /** Creation time in nanoseconds as a decimal string; '0' where the filesystem records none. */
+    birthtimeNs: string;
+}
+export interface FilesystemIdentity extends FilesystemObjectIdentity {
+    ancestors: readonly FilesystemAncestorIdentity[];
+}
+export interface FilesystemAncestorIdentity extends FilesystemObjectIdentity {
+    path: string;
+}
+interface FilesystemObjectStatus {
+    readonly dev: bigint;
+    readonly ino: bigint;
+    readonly birthtimeNs: bigint;
+}
+export declare function filesystemObjectIdentity(status: FilesystemObjectStatus): FilesystemObjectIdentity;
+export declare function sameFilesystemObject(status: FilesystemObjectStatus, recorded: FilesystemObjectIdentity): boolean;
+export declare function isFilesystemObjectIdentity(value: Record<string, unknown>): boolean;
+interface ConsumedFileBase {
+    path: string;
+    sha256: string;
+    maxBytes: number;
+    argvIndexes: readonly number[];
+}
+export type ConsumedFile = ConsumedFileBase & ({
+    executable: true;
+    executionMode: 'verified-path';
+} | {
+    executable: false;
+    executionMode?: never;
+});
+export interface SourceProvenance {
+    path: string;
+    byteLength: number;
+    sha256: string;
+}
+export type ConfigSourceSnapshot = ({
+    state: 'available';
+} & SourceProvenance) | {
+    state: 'unavailable';
+    path: string;
+    code: typeof ENVIRONMENT_CODES.CONFIG_NOT_FOUND | typeof ENVIRONMENT_CODES.CONFIG_UNREADABLE;
+};
+export interface SetupExecutionEvidence {
+    mutationMayHaveOccurred: boolean;
+    completedStepIds: readonly string[];
+    failedStep?: {
+        id: string;
+        started: boolean;
+    };
+    compensation: {
+        attemptedStepIds: readonly string[];
+        completedStepIds: readonly string[];
+        failed: readonly {
+            id: string;
+            code: ExecutionFailureCode;
+        }[];
+    };
+}
+export interface SetupRefusalEvidence {
+    execution: SetupExecutionEvidence;
+    source: {
+        before: SourceProvenance;
+        after: ConfigSourceSnapshot;
+        postcheck?: SourceProvenance;
+    };
+}
+export interface ExecutionStep {
+    id: string;
+    argv: readonly [string, ...string[]];
+    argv0: string;
+    cwd: string;
+    env: Readonly<Record<string, string>>;
+    timeoutMs: number;
+    spawnNotAfter?: string;
+    stdoutLimitBytes: number;
+    stderrLimitBytes: number;
+    outputOverflow?: 'retain-tail';
+    failureOutput?: 'stderr-tail';
+    paths: readonly string[];
+    ports: readonly number[];
+    labels: Readonly<Record<string, string>>;
+    expected: readonly ExpectedObservation[];
+    consumedFiles: readonly ConsumedFile[];
+    filesystemChecks: readonly FilesystemCheck[];
+    executionFence?: ExecutionFence;
+    compensation: readonly ExecutionStep[];
+}
+export interface ExecutionFence {
+    readonly attemptId: string;
+    readonly markerPath: string;
+    readonly socketPath: string;
+}
+export interface ExecutionPlan {
+    steps: readonly ExecutionStep[];
+}
+type LifecycleResumeBoundary = Readonly<{
+    completedStepIds: readonly string[];
+    nextStepId: string | null;
+}>;
+type LifecycleStepBase = Readonly<{
+    id: string;
+}>;
+interface LifecycleEntrypoint {
+    readonly name: string;
+    readonly kind: EntrypointKind;
+    readonly port: string;
+    readonly value: string;
+}
+interface LifecycleCompletedService {
+    readonly service: string;
+    readonly containerId: string;
+}
+export interface LifecycleProgress {
+    readonly workBasisSha256: string;
+    readonly operationGeneration: string;
+    readonly completedServices: readonly LifecycleCompletedService[];
+}
+type LifecycleStep = (LifecycleStepBase & Readonly<{
+    kind: 'preflight';
+}>) | (LifecycleStepBase & Readonly<{
+    kind: 'claim';
+    action: 'acquire' | 'release';
+}>) | (LifecycleStepBase & Readonly<{
+    kind: 'prepare';
+    execution: ExecutionStep;
+}>) | (LifecycleStepBase & Readonly<{
+    kind: 'service';
+    service: string;
+}>) | (LifecycleStepBase & Readonly<{
+    kind: 'publish-entrypoints';
+    values: readonly LifecycleEntrypoint[];
+}>);
+type ClaimReleaseStep = LifecycleStepBase & Readonly<{
+    kind: 'claim';
+    action: 'release';
+}>;
+export type LifecyclePlan = Readonly<{
+    verb: 'up' | 'sleep' | 'down' | 'reset';
+    progress: LifecycleProgress;
+    steps: readonly LifecycleStep[];
+    resumeBoundary: LifecycleResumeBoundary;
+    compensation: readonly Readonly<{
+        step: ClaimReleaseStep;
+        ownership: Readonly<{
+            stackId: StackId;
+            holderId: HolderId;
+            recordRevision: number;
+            change: 'acquired';
+        }>;
+    }>[];
+    diagnostics: readonly EnvironmentDiagnostic[];
+}>;
+export declare const MAX_STEP_TIMEOUT_MS = 7200000;
+export declare function snapshotExecutionStep(value: unknown): ExecutionStep | undefined;
+export declare function snapshotExecutionPlan(value: unknown): ExecutionPlan | undefined;
+export declare function snapshotLifecyclePlan(value: unknown): LifecyclePlan | undefined;
+export interface ExecutionReceipt {
+    readonly stepId: string;
+    readonly startedAt: string;
+    readonly finishedAt: string;
+    readonly receiptMatches: (step: ExecutionStep) => boolean;
+}
+export type Observation<T> = {
+    state: 'available';
+    value: T;
+    observedAt: string;
+    producer: string;
+} | {
+    state: 'unavailable';
+    reason: string;
+    producer: string;
+} | {
+    state: 'failed';
+    code: RefusalCode;
+    reason: string;
+    producer: string;
+};
+export type ObservationExpectation = {
+    readonly kind: 'equal';
+    readonly value: JsonSnapshot;
+} | {
+    readonly kind: 'one-of';
+    readonly values: readonly JsonSnapshot[];
+} | {
+    readonly kind: 'minimum';
+    readonly value: number;
+} | {
+    readonly kind: 'maximum';
+    readonly value: number;
+} | {
+    readonly kind: 'present';
+};
+type ObservationApplicability = {
+    readonly state: 'required';
+    readonly posture: string;
+} | {
+    readonly state: 'not-applicable';
+    readonly posture: string;
+    readonly reason: string;
+};
+type ObservationFreshness = {
+    readonly state: 'current';
+} | {
+    readonly state: 'stale' | 'missing';
+    readonly reason: string;
+};
+type EnvironmentObservedValue = {
+    readonly state: 'available';
+    readonly value: JsonSnapshot;
+    readonly observedAt: string;
+} | {
+    readonly state: 'unavailable' | 'failed';
+    readonly reason: string;
+    readonly observedAt: string;
+};
+export interface EnvironmentObservation {
+    readonly code: EnvironmentCode;
+    readonly owner: string;
+    readonly stackId: StackId;
+    readonly source: string;
+    readonly observed: EnvironmentObservedValue;
+    readonly expectation: ObservationExpectation;
+    readonly applicability: ObservationApplicability;
+    readonly freshness: ObservationFreshness;
+    readonly remedy: string;
+}
+export interface ObservationDeclaration {
+    readonly id: string;
+    readonly owner: string;
+    readonly postures: readonly string[];
+    readonly stages: readonly ObservationStageDeclaration[];
+    readonly code: EnvironmentCode;
+    readonly isIssued: (value: unknown) => value is EnvironmentObservation;
+    readonly issuedAt?: (value: unknown) => number | undefined;
+}
+export type ObservationStageDeclaration = {
+    readonly stage: ObservationLifecycleStage;
+    readonly disposition: 'required';
+} | {
+    readonly stage: ObservationLifecycleStage;
+    readonly disposition: 'not-applicable';
+    readonly reason: string;
+};
+export declare function snapshotEnvironmentObservation(value: unknown): EnvironmentObservation | undefined;
+export type EnvironmentCommandOutcome<Result> = {
+    kind: 'complete';
+    status: 0;
+    diagnostics: readonly EnvironmentDiagnostic[];
+    result: Result;
+    plan?: never;
+} | {
+    kind: 'preview';
+    status: 0;
+    diagnostics: readonly EnvironmentDiagnostic[];
+    result: Result;
+    plan: ExecutionPlan;
+} | {
+    kind: 'refusal';
+    status: 2;
+    diagnostics: readonly EnvironmentDiagnostic[];
+    result: null;
+    plan?: never;
+};
+/** A command refusal carrying the diagnostics an owner raised: exit status 2 and no result. */
+export declare function forwardedRefusal(diagnostics: readonly EnvironmentDiagnostic[]): Extract<EnvironmentCommandOutcome<never>, {
+    kind: 'refusal';
+}>;
+export {};