@astrale-os/sdk 0.6.0-beta.18 → 0.6.0-beta.19

package/dist/tooling/cli/legacy/development/credential.js

@@ -1,57 +0,0 @@
-import { closeSync, constants, fstatSync, openSync, readSync } from 'node:fs';
-const MAXIMUM_CREDENTIAL_BYTES = 64 * 1024;
-/** Admit one caller-owned credential without retaining its value outside this command. */
-export function loadPrivateCredentialFile(path, platform = process.platform) {
-    if (platform === 'win32') {
-        throw new Error('--credential-file is unavailable on Windows until private no-reparse file admission is supported.');
-    }
-    let descriptor;
-    try {
-        descriptor = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
-    }
-    catch (cause) {
-        if (errorCode(cause) === 'ENOENT') {
-            throw new Error(`Credential file '${path}' is missing.`, { cause });
-        }
-        if (errorCode(cause) === 'ELOOP') {
-            throw new Error(`Credential file '${path}' must be a regular file and not a symlink.`, {
-                cause,
-            });
-        }
-        throw cause;
-    }
-    try {
-        const info = fstatSync(descriptor);
-        if (!info.isFile())
-            throw new Error(`Credential file '${path}' must be a regular file.`);
-        if ((info.mode & 0o077) !== 0) {
-            throw new Error(`Credential file '${path}' must not be accessible by group or other users.`);
-        }
-        if (info.size === 0 || info.size > MAXIMUM_CREDENTIAL_BYTES) {
-            throw new Error(`Credential file '${path}' must contain one bounded credential.`);
-        }
-        const bytes = Buffer.allocUnsafe(info.size + 1);
-        let offset = 0;
-        while (offset < bytes.length) {
-            const read = readSync(descriptor, bytes, offset, bytes.length - offset, null);
-            if (read === 0)
-                break;
-            offset += read;
-        }
-        if (offset !== info.size)
-            throw new Error(`Credential file '${path}' changed while read.`);
-        const credential = bytes.subarray(0, offset).toString('utf8').trim();
-        if (credential.length === 0 || /[\r\n\0]/u.test(credential)) {
-            throw new Error(`Credential file '${path}' must contain exactly one credential.`);
-        }
-        return credential;
-    }
-    finally {
-        closeSync(descriptor);
-    }
-}
-function errorCode(input) {
-    return input !== null && typeof input === 'object' && 'code' in input
-        ? String(Reflect.get(input, 'code'))
-        : undefined;
-}

package/dist/tooling/cli/legacy/development/deployment.d.ts

@@ -1,10 +0,0 @@
-import type { ReadyDeployResult } from '../../../../deployment/adapter/index.js';
-import type { DevelopmentCandidate } from './candidate.js';
-export interface DevelopmentDeploymentInput {
-    readonly projectDir: string;
-    readonly environment: string;
-    readonly identity?: string;
-    readonly credential?: string;
-}
-/** Commit and verify one complete remote candidate. A development deployment installs nothing. */
-export declare function deployDevelopmentCandidate(candidate: DevelopmentCandidate, input: DevelopmentDeploymentInput, signal: AbortSignal): Promise<ReadyDeployResult>;

package/dist/tooling/cli/legacy/development/deployment.js

@@ -1,20 +0,0 @@
-import { verifyDeployment } from '../../../../deployment/index.js';
-/** Commit and verify one complete remote candidate. A development deployment installs nothing. */
-export async function deployDevelopmentCandidate(candidate, input, signal) {
-    const deployed = await candidate.adapter.deploy(candidate.parameters, {
-        projectDir: input.projectDir,
-        environment: input.environment,
-        ...(input.identity === undefined ? {} : { identity: input.identity }),
-        ...(input.credential === undefined ? {} : { credential: input.credential }),
-        secrets: candidate.secrets,
-        artifact: candidate.artifact,
-        signal,
-    });
-    const verified = verifyDeployment(candidate.artifact, deployed);
-    if (verified.status === 'failed') {
-        throw new Error(`Deployment failed during ${verified.phase}: ${verified.error.message}`, {
-            cause: verified.error,
-        });
-    }
-    return verified;
-}

package/dist/tooling/cli/legacy/development/deprecation.d.ts

@@ -1,11 +0,0 @@
-/**
- * What replaces `astrale-domain dev`, for its author: development is not a command of the
- * deployment model. A developer, or an agent, deploys the Environment and installs the URL that
- * deploy prints on their own instance.
- *
- * `--direct` sends that URL to the instance's Kernel. Without it, the CLI releases published so
- * far route a bare URL through the Admin catalog, which only knows published entries, so a fresh
- * deployment URL fails to install. The CLI keeps accepting `--direct` after it starts sending
- * every URL to the Kernel, and drops the flag only after this command is removed.
- */
-export declare function developmentDeprecation(environment: string): string;

package/dist/tooling/cli/legacy/development/deprecation.js

@@ -1,13 +0,0 @@
-/**
- * What replaces `astrale-domain dev`, for its author: development is not a command of the
- * deployment model. A developer, or an agent, deploys the Environment and installs the URL that
- * deploy prints on their own instance.
- *
- * `--direct` sends that URL to the instance's Kernel. Without it, the CLI releases published so
- * far route a bare URL through the Admin catalog, which only knows published entries, so a fresh
- * deployment URL fails to install. The CLI keeps accepting `--direct` after it starts sending
- * every URL to the Kernel, and drops the flag only after this command is removed.
- */
-export function developmentDeprecation(environment) {
-    return `astrale-domain dev is deprecated and will be removed: run \`astrale-domain deploy ${environment}\`, then \`astrale domain install <url> --direct -i <instance>\` with the URL it prints.`;
-}

package/dist/tooling/cli/legacy/development/develop.d.ts

@@ -1,15 +0,0 @@
-/**
- * Watch one Project Environment and serialize complete remote deployment generations. Each
- * generation replaces the Environment's stable target in place; none installs anything.
- *
- * @deprecated Deploy the Environment with `astrale-domain deploy`, then install the printed URL
- * with `astrale domain install <url> --direct -i <instance>`.
- */
-export declare function develop(input: {
-    readonly configPath: string;
-    readonly projectDir: string;
-    readonly environment: string;
-    readonly identity?: string;
-    readonly credentialFile?: string;
-    readonly secretsFile?: string;
-}): Promise<number>;

package/dist/tooling/cli/legacy/development/develop.js

@@ -1,142 +0,0 @@
-import { rm, rmdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { deprecationWarnings } from '../../deprecations.js';
-import { error, info, warn } from '../../log.js';
-import { DevelopmentCandidateBuilder, discoverRuntimePath, sameDeploymentCandidate, sameEnvironment, } from './candidate.js';
-import { loadPrivateCredentialFile } from './credential.js';
-import { deployDevelopmentCandidate } from './deployment.js';
-import { DevelopmentLifecycle } from './lifecycle.js';
-import { acquireProjectLock } from './project-lock.js';
-import { LatestRebuild } from './rebuild.js';
-import { reportDevelopmentDeployment } from './report.js';
-import { loadPrivateSecretsFile } from './secrets-file.js';
-import { watchSources } from './source-watch.js';
-/**
- * Watch one Project Environment and serialize complete remote deployment generations. Each
- * generation replaces the Environment's stable target in place; none installs anything.
- *
- * @deprecated Deploy the Environment with `astrale-domain deploy`, then install the printed URL
- * with `astrale domain install <url> --direct -i <instance>`.
- */
-export async function develop(input) {
-    const lifecycle = new DevelopmentLifecycle();
-    let lock;
-    let sourceWatch;
-    let rebuild;
-    let current;
-    let failure;
-    const cleanup = [];
-    try {
-        lock = await acquireProjectLock({
-            projectRoot: input.projectDir,
-            environment: input.environment,
-        });
-        const overrideSecrets = input.secretsFile === undefined
-            ? undefined
-            : Object.freeze(loadPrivateSecretsFile(input.secretsFile));
-        const credential = input.credentialFile === undefined
-            ? undefined
-            : loadPrivateCredentialFile(input.credentialFile);
-        const runtimePath = await discoverRuntimePath(input.configPath);
-        const builder = new DevelopmentCandidateBuilder({
-            ...input,
-            runtimePath,
-            overrideSecrets,
-        });
-        current = await builder.prepare(lifecycle.signal);
-        info(`Domain: ${current.artifact.build.schema.compiled.root.origin}`);
-        for (const warning of deprecationWarnings(current.artifact.build))
-            warn(warning);
-        const first = await deployDevelopmentCandidate(current, { ...input, ...(credential === undefined ? {} : { credential }) }, lifecycle.signal);
-        reportDevelopmentDeployment(first, current.adapter, input);
-        let restartReported = false;
-        rebuild = new LatestRebuild({
-            async prepare(_ignored, signal) {
-                info(`Rebuilding: ${input.environment}`);
-                return builder.prepare(signal);
-            },
-            async commit(candidate, signal) {
-                if (!sameEnvironment(current, candidate)) {
-                    restartReported = true;
-                    throw new Error('Project Environment configuration changed; restart pnpm dev to apply it.');
-                }
-                if (sameDeploymentCandidate(current, candidate)) {
-                    current = candidate;
-                    sourceWatch?.update(candidate.sources);
-                    return;
-                }
-                const deployed = await deployDevelopmentCandidate(candidate, { ...input, ...(credential === undefined ? {} : { credential }) }, signal);
-                current = candidate;
-                sourceWatch?.update(candidate.sources);
-                info(`Updated: ${candidate.artifact.build.schema.compiled.root.revision}`);
-                reportDevelopmentDeployment(deployed, candidate.adapter, input);
-            },
-            async failed(cause) {
-                error(cause instanceof Error ? cause.message : String(cause));
-            },
-        });
-        sourceWatch = watchSources({
-            projectDir: input.projectDir,
-            configPath: input.configPath,
-            sources: current.sources,
-            onInvalidate: () => rebuild.invalidate(),
-            onRestartRequired: () => {
-                if (restartReported)
-                    return;
-                restartReported = true;
-                error('Project Environment configuration changed; restart pnpm dev to apply it.');
-            },
-            onError: (cause) => {
-                failure = cause;
-                lifecycle.stop(cause);
-            },
-        });
-        info('Ready: watching for remote deployments');
-        // Edits made while the first build/deployment was in flight predate this watcher.
-        // Catch up once; artifact deduplication prevents an unchanged second deployment.
-        rebuild.invalidate();
-        await lifecycle.stopped;
-    }
-    catch (cause) {
-        failure = cause;
-    }
-    lifecycle.stop(failure);
-    for (const operation of [
-        () => sourceWatch?.stop(),
-        () => rebuild?.stop(failure),
-        () => rm(join(input.projectDir, '.astrale', 'development', input.environment, 'source'), {
-            recursive: true,
-            force: true,
-        }),
-        () => lock?.release(),
-    ]) {
-        try {
-            await operation();
-        }
-        catch (cause) {
-            cleanup.push(cause);
-        }
-    }
-    for (const directory of [
-        join(input.projectDir, '.astrale', 'development', input.environment),
-        join(input.projectDir, '.astrale', 'development'),
-    ]) {
-        try {
-            await rmdir(directory);
-        }
-        catch (cause) {
-            const code = cause.code;
-            if (code !== 'ENOENT' && code !== 'ENOTEMPTY' && code !== 'EEXIST')
-                cleanup.push(cause);
-        }
-    }
-    lifecycle.dispose();
-    if (failure !== undefined) {
-        if (cleanup.length > 0)
-            error(new AggregateError(cleanup, 'Development cleanup failed.').message);
-        throw failure;
-    }
-    if (cleanup.length > 0)
-        throw new AggregateError(cleanup, 'Development cleanup failed.');
-    return 0;
-}

package/dist/tooling/cli/legacy/development/index.d.ts

@@ -1,21 +0,0 @@
-/**
- * `astrale-domain dev` (legacy, deprecated).
- *
- * Development is not a command of the deployment model: a developer, or an agent, iterates with
- * `astrale-domain deploy development`, then `astrale domain install <url> --direct -i <instance>`. This
- * folder keeps the watch loop that updates one deployment per Domain origin and Environment in
- * place and its private file boundaries, exactly as before. Every run warns with that replacement
- * on stderr.
- *
- * Short-term consumers: the `dev` scripts of the Domain packages that still deploy in place,
- * namely the domains repository's ai-gateway, closing, grc, integrations, issues, organization and
- * services packages, the Shell, and ui's Domain, and of the Projects create-astrale-domain
- * scaffolds while its template still declares `dev`. Projects that pin an SDK release older than
- * this folder never reach it.
- *
- * Deletion: once none of those packages runs `astrale-domain dev`, a separate breaking release
- * deletes this folder with the `dev` command and its `--credential-file` and `--secrets-file`
- * flags.
- */
-export { develop } from './develop.js';
-export { developmentDeprecation } from './deprecation.js';

package/dist/tooling/cli/legacy/development/index.js

@@ -1,21 +0,0 @@
-/**
- * `astrale-domain dev` (legacy, deprecated).
- *
- * Development is not a command of the deployment model: a developer, or an agent, iterates with
- * `astrale-domain deploy development`, then `astrale domain install <url> --direct -i <instance>`. This
- * folder keeps the watch loop that updates one deployment per Domain origin and Environment in
- * place and its private file boundaries, exactly as before. Every run warns with that replacement
- * on stderr.
- *
- * Short-term consumers: the `dev` scripts of the Domain packages that still deploy in place,
- * namely the domains repository's ai-gateway, closing, grc, integrations, issues, organization and
- * services packages, the Shell, and ui's Domain, and of the Projects create-astrale-domain
- * scaffolds while its template still declares `dev`. Projects that pin an SDK release older than
- * this folder never reach it.
- *
- * Deletion: once none of those packages runs `astrale-domain dev`, a separate breaking release
- * deletes this folder with the `dev` command and its `--credential-file` and `--secrets-file`
- * flags.
- */
-export { develop } from './develop.js';
-export { developmentDeprecation } from './deprecation.js';

package/dist/tooling/cli/legacy/development/lease.d.ts

@@ -1,18 +0,0 @@
-export declare class DevelopmentLeaseError extends Error {
-    readonly code: 'DEVELOPMENT_LEASE_LOCKED' | 'DEVELOPMENT_LEASE_LOST';
-    readonly name = "DevelopmentLeaseError";
-    constructor(code: 'DEVELOPMENT_LEASE_LOCKED' | 'DEVELOPMENT_LEASE_LOST', message: string, options?: ErrorOptions);
-}
-export interface DevelopmentLease {
-    readonly path: string;
-    readonly recovered: boolean;
-    release(): Promise<void>;
-}
-/** One fail-closed filesystem lease engine for every local development coordinate. */
-export declare function acquireDevelopmentLease(input: {
-    readonly directory: string;
-    readonly coordinate: string;
-    readonly pid?: number;
-    readonly sessionId?: string;
-    readonly processAlive?: (pid: number) => boolean;
-}): Promise<DevelopmentLease>;

package/dist/tooling/cli/legacy/development/lease.js

@@ -1,163 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { mkdir, open, readFile, unlink } from 'node:fs/promises';
-import { join } from 'node:path';
-const LOCK_VERSION = 1;
-export class DevelopmentLeaseError extends Error {
-    code;
-    name = 'DevelopmentLeaseError';
-    constructor(code, message, options) {
-        super(message, options);
-        this.code = code;
-    }
-}
-/** One fail-closed filesystem lease engine for every local development coordinate. */
-export async function acquireDevelopmentLease(input) {
-    const path = join(input.directory, 'session.lock');
-    const recovery = `${path}.reclaim`;
-    const sessionId = input.sessionId ?? randomUUID();
-    const alive = input.processAlive ?? processAlive;
-    const owner = Object.freeze({
-        version: LOCK_VERSION,
-        pid: input.pid ?? process.pid,
-        sessionId,
-        coordinate: input.coordinate,
-        acquiredAt: new Date().toISOString(),
-    });
-    await mkdir(input.directory, { recursive: true, mode: 0o700 });
-    try {
-        await create(path, owner);
-        return handle(path, input.coordinate, owner, false);
-    }
-    catch (cause) {
-        if (errorCode(cause) !== 'EEXIST')
-            throw cause;
-    }
-    let recoveryHandle;
-    try {
-        recoveryHandle = await open(recovery, 'wx', 0o600);
-        await recoveryHandle.writeFile(`${sessionId}\n`, 'utf8');
-        await recoveryHandle.sync();
-    }
-    catch (cause) {
-        if (errorCode(cause) === 'EEXIST')
-            throw locked(input.coordinate);
-        throw cause;
-    }
-    finally {
-        await recoveryHandle?.close();
-    }
-    try {
-        const observed = await readOwner(path, input.coordinate);
-        if (observed === undefined || alive(observed.pid))
-            throw locked(input.coordinate, observed);
-        const current = await readOwner(path, input.coordinate);
-        if (!sameOwner(current, observed) || alive(observed.pid)) {
-            throw locked(input.coordinate, current);
-        }
-        await unlink(path);
-        try {
-            await create(path, owner);
-        }
-        catch (cause) {
-            if (errorCode(cause) === 'EEXIST')
-                throw locked(input.coordinate);
-            throw cause;
-        }
-        return handle(path, input.coordinate, owner, true);
-    }
-    finally {
-        await unlink(recovery).catch((cause) => {
-            if (errorCode(cause) !== 'ENOENT')
-                throw cause;
-        });
-    }
-}
-function handle(path, coordinate, owner, recovered) {
-    let released = false;
-    return Object.freeze({
-        path,
-        recovered,
-        async release() {
-            if (released)
-                return;
-            const current = await readOwner(path, coordinate);
-            if (!sameOwner(current, owner)) {
-                throw new DevelopmentLeaseError('DEVELOPMENT_LEASE_LOST', `Development lease ownership changed for ${coordinate}; refusing to remove it.`);
-            }
-            await unlink(path);
-            released = true;
-        },
-    });
-}
-async function create(path, owner) {
-    const file = await open(path, 'wx', 0o600);
-    try {
-        await file.writeFile(`${JSON.stringify(owner)}\n`, 'utf8');
-        await file.sync();
-    }
-    catch (cause) {
-        await file.close();
-        await unlink(path).catch(() => undefined);
-        throw cause;
-    }
-    await file.close();
-}
-async function readOwner(path, coordinate) {
-    let text;
-    try {
-        text = await readFile(path, 'utf8');
-    }
-    catch (cause) {
-        if (errorCode(cause) === 'ENOENT')
-            return undefined;
-        throw cause;
-    }
-    let value;
-    try {
-        value = JSON.parse(text);
-    }
-    catch (cause) {
-        throw locked(coordinate, undefined, cause);
-    }
-    if (!isOwner(value) || value.coordinate !== coordinate)
-        throw locked(coordinate);
-    return value;
-}
-function isOwner(input) {
-    if (input === null || typeof input !== 'object' || Array.isArray(input))
-        return false;
-    const owner = input;
-    return (Reflect.ownKeys(owner).every((key) => ['version', 'pid', 'sessionId', 'coordinate', 'acquiredAt'].includes(String(key))) &&
-        owner.version === LOCK_VERSION &&
-        Number.isSafeInteger(owner.pid) &&
-        (owner.pid ?? 0) > 0 &&
-        typeof owner.sessionId === 'string' &&
-        owner.sessionId.length > 0 &&
-        typeof owner.coordinate === 'string' &&
-        owner.coordinate.length > 0 &&
-        typeof owner.acquiredAt === 'string');
-}
-function sameOwner(left, right) {
-    return (left?.version === right.version &&
-        left.pid === right.pid &&
-        left.sessionId === right.sessionId &&
-        left.coordinate === right.coordinate);
-}
-function locked(coordinate, owner, cause) {
-    const detail = owner === undefined ? '' : ` by PID ${owner.pid} (session ${owner.sessionId})`;
-    return new DevelopmentLeaseError('DEVELOPMENT_LEASE_LOCKED', `Development coordinate ${coordinate} is already locked${detail}.`, cause === undefined ? undefined : { cause });
-}
-function processAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (cause) {
-        return errorCode(cause) !== 'ESRCH';
-    }
-}
-function errorCode(input) {
-    return input !== null && typeof input === 'object' && 'code' in input
-        ? String(Reflect.get(input, 'code'))
-        : undefined;
-}

package/dist/tooling/cli/legacy/development/lifecycle.d.ts

@@ -1,9 +0,0 @@
-/** Own process signals for exactly one foreground development command. */
-export declare class DevelopmentLifecycle {
-    #private;
-    constructor();
-    get signal(): AbortSignal;
-    get stopped(): Promise<void>;
-    stop(reason?: unknown): void;
-    dispose(): void;
-}

package/dist/tooling/cli/legacy/development/lifecycle.js

@@ -1,43 +0,0 @@
-/** Own process signals for exactly one foreground development command. */
-export class DevelopmentLifecycle {
-    #controller = new AbortController();
-    #stopped;
-    #resolveStopped;
-    #disposed = false;
-    constructor() {
-        let resolveStopped;
-        this.#stopped = new Promise((resolve) => {
-            resolveStopped = resolve;
-        });
-        this.#resolveStopped = resolveStopped;
-        // Keep handlers installed throughout cleanup. This covers direct Bun
-        // invocation and any duplicate signal forwarding by an older launcher:
-        // repeated interrupts remain idempotent stop requests instead of reverting
-        // to the runtime's immediate default termination.
-        process.on('SIGINT', this.#interrupt);
-        process.on('SIGTERM', this.#interrupt);
-        // The terminal's session leader can exit before asynchronous cleanup finishes.
-        // Its hangup must request the same stop, not terminate the remaining View owner.
-        process.on('SIGHUP', this.#interrupt);
-    }
-    get signal() {
-        return this.#controller.signal;
-    }
-    get stopped() {
-        return this.#stopped;
-    }
-    stop(reason = new Error('Development interrupted.')) {
-        if (!this.#controller.signal.aborted)
-            this.#controller.abort(reason);
-        this.#resolveStopped();
-    }
-    dispose() {
-        if (this.#disposed)
-            return;
-        this.#disposed = true;
-        process.off('SIGINT', this.#interrupt);
-        process.off('SIGTERM', this.#interrupt);
-        process.off('SIGHUP', this.#interrupt);
-    }
-    #interrupt = () => this.stop();
-}

package/dist/tooling/cli/legacy/development/project-imports.d.ts

@@ -1,22 +0,0 @@
-interface ProjectImportResolver {
-    resolveSync(specifier: string, importer: string): string;
-}
-interface ProjectImportResolution {
-    readonly path: string;
-    readonly external?: boolean;
-}
-interface ProjectImportBuilder {
-    onResolve(options: {
-        readonly filter: RegExp;
-    }, resolve: (input: {
-        readonly path: string;
-        readonly importer: string;
-    }) => ProjectImportResolution | undefined): void;
-}
-export interface ProjectImportPlugin {
-    readonly name: string;
-    setup(builder: ProjectImportBuilder): void;
-}
-/** Bundle project-local bare imports while leaving actual dependencies external. */
-export declare function projectImportPlugin(projectDir: string, resolver: ProjectImportResolver): ProjectImportPlugin;
-export {};

package/dist/tooling/cli/legacy/development/project-imports.js

@@ -1,39 +0,0 @@
-import { realpathSync } from 'node:fs';
-import { isAbsolute, relative, resolve, sep } from 'node:path';
-/** Bundle project-local bare imports while leaving actual dependencies external. */
-export function projectImportPlugin(projectDir, resolver) {
-    return Object.freeze({
-        name: 'astrale-project-imports',
-        setup(builder) {
-            builder.onResolve({ filter: /^[^./]/u }, (input) => {
-                let path;
-                try {
-                    path = resolver.resolveSync(input.path, input.importer);
-                }
-                catch {
-                    return Object.freeze({ path: input.path, external: true });
-                }
-                return projectLocal(projectDir, path)
-                    ? Object.freeze({ path })
-                    : Object.freeze({ path: input.path, external: true });
-            });
-        },
-    });
-}
-function projectLocal(projectDir, path) {
-    if (!isAbsolute(path))
-        return false;
-    const local = relative(canonical(projectDir), canonical(path));
-    return (local !== '..' &&
-        !local.startsWith(`..${sep}`) &&
-        !isAbsolute(local) &&
-        !local.split(sep).includes('node_modules'));
-}
-function canonical(path) {
-    try {
-        return realpathSync.native(path);
-    }
-    catch {
-        return resolve(path);
-    }
-}

package/dist/tooling/cli/legacy/development/project-lock.d.ts

@@ -1,16 +0,0 @@
-import type { DevelopmentLease } from './lease.js';
-export declare class ProjectLockError extends Error {
-    readonly code: 'INVALID_ENVIRONMENT' | 'PROJECT_ENVIRONMENT_LOCKED';
-    readonly name = "ProjectLockError";
-    constructor(code: 'INVALID_ENVIRONMENT' | 'PROJECT_ENVIRONMENT_LOCKED', message: string, options?: ErrorOptions);
-}
-export interface ProjectLock extends DevelopmentLease {
-}
-/** Exclude concurrent writers of one checkout's generated Environment state. */
-export declare function acquireProjectLock(input: {
-    readonly projectRoot: string;
-    readonly environment: string;
-    readonly pid?: number;
-    readonly sessionId?: string;
-    readonly processAlive?: (pid: number) => boolean;
-}): Promise<ProjectLock>;