export interface RunCommandResult {
    code: number;
    stdout: string;
    stderr: string;
}
export interface RunCommandOptions {
    cwd?: string;
    timeoutMs?: number;
    env?: NodeJS.ProcessEnv;
}
/**
 * Runs a command with an optional timeout.
 * Returns { code, stdout, stderr }.
 * Rejects if the process cannot be spawned or the timeout fires.
 */
export declare function runCommandWithTimeout(argv: string[], opts?: RunCommandOptions): Promise<RunCommandResult>;
export declare function resolveDefaultAgentWorkspaceDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
export declare const DEFAULT_AGENT_WORKSPACE_DIR: string;
declare const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
declare const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
declare const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
declare const DEFAULT_USER_FILENAME = "USER.md";
declare const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
declare const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
declare const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
declare const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
export type WorkspaceBootstrapFileName = typeof DEFAULT_AGENTS_FILENAME | typeof DEFAULT_TOOLS_FILENAME | typeof DEFAULT_IDENTITY_FILENAME | typeof DEFAULT_USER_FILENAME | typeof DEFAULT_HEARTBEAT_FILENAME | typeof DEFAULT_BOOTSTRAP_FILENAME | typeof DEFAULT_MEMORY_FILENAME | typeof DEFAULT_MEMORY_ALT_FILENAME;
export type WorkspaceBootstrapFile = {
    name: WorkspaceBootstrapFileName;
    path: string;
    content?: string;
    missing: boolean;
};
export declare function ensureAgentWorkspace(params?: {
    dir?: string;
    ensureBootstrapFiles?: boolean;
}): Promise<{
    dir: string;
    agentsPath?: string;
    toolsPath?: string;
    identityPath?: string;
    userPath?: string;
    heartbeatPath?: string;
    bootstrapPath?: string;
}>;
export declare function loadWorkspaceBootstrapFiles(dir: string): Promise<WorkspaceBootstrapFile[]>;
export declare function filterBootstrapFilesForSession(files: WorkspaceBootstrapFile[], sessionKey?: string): WorkspaceBootstrapFile[];
export {};
//# sourceMappingURL=workspace.d.ts.map