eve/dist/src/self-modification/setup.d.ts

Filesystem-first framework for durable backend AI agents that run anywhere.

import { relative } from "node:path";
import { captureVercel, runVercelCaptureStdout } from "#setup/primitives/run-vercel.js";
import type { VercelProjectReference } from "#setup/project-resolution.js";
export interface SelfModificationSetupValues {
    readonly branch: string;
    readonly channelNames: readonly string[];
    readonly connector: string;
    readonly directory: string;
    readonly repository: string;
    readonly vercelBackend: boolean;
}
export interface DetectedGitRepository {
    readonly branch?: string;
    readonly directory?: string;
    readonly owner?: string;
    readonly repo?: string;
    readonly remoteKind: "github" | "missing" | "other";
}
export interface SelfModificationSetupOperations {
    attachConnector(connector: string, project: VercelProjectReference): Promise<void>;
    detectChannelNames(): Promise<readonly string[]>;
    detectGitRepository(): Promise<DetectedGitRepository>;
    findOrCreateConnector(name: string, project: VercelProjectReference): Promise<string>;
    readConfig(): Promise<string | undefined>;
    writeConfig(source: string): Promise<void>;
}
export interface SelfModificationSetupDependencies {
    captureVercel: typeof captureVercel;
    runVercelCaptureStdout: typeof runVercelCaptureStdout;
}
export declare function connectorName(owner: string, repo: string): string;
export declare function renderSelfModificationConfig(values?: SelfModificationSetupValues): string;
/** Distinguishes resumable generated source from authored source without evaluating it. */
export declare function classifySelfModificationConfig(source: string | undefined): "missing" | "local" | "generated" | "authored";
export declare function parseGitHubRemote(remote: string): {
    owner: string;
    repo: string;
} | undefined;
export declare function defaultSelfModificationSetupOperations(appRoot: string, deps?: SelfModificationSetupDependencies, projectRoot?: string): SelfModificationSetupOperations;
export declare function repositoryRelativeDirectory(repositoryRoot: string, appRoot: string, relativePath?: typeof relative): string;
export declare function repositoryPartError(value: string): string | undefined;
export declare function directoryError(value: string): string | undefined;
export declare function gitRefError(value: string): string | undefined;