/** Default sand-data root. Alias: /home/box/agent-data. */
export declare const DEFAULT_SAND_ROOT = "/home/box/sand-data";
export declare const AGENT_DATA_ALIAS = "/home/box/agent-data";
export declare const SAND_DATA_DIRNAME = "sand-data";
export declare const ENV_SAND_DATA_ROOT = "SAND_DATA_ROOT";
export declare const ENV_SAND_USER_DATA_DIR = "SAND_USER_DATA_DIR";
export declare const ENV_SAND_GATEWAY_TOKEN = "SAND_GATEWAY_TOKEN";
export declare const ENV_SAND_HOST_PORT = "SAND_HOST_PORT";
export declare const ENV_SAND_GATEWAY_BIND_HOST = "SAND_GATEWAY_BIND_HOST";
/** Full gateway origin, e.g. http://127.0.0.1:1340 or http://your-host:1340. */
export declare const ENV_GROKBOT_GATEWAY_URL = "GROKBOT_GATEWAY_URL";
/** Alias for GROKBOT_GATEWAY_URL. */
export declare const ENV_SAND_GATEWAY_URL = "SAND_GATEWAY_URL";
/** Set to `1` to run the opt-in live gateway smoke (sdk/test/live-gateway.test.ts). */
export declare const ENV_GROKBOT_LIVE = "GROKBOT_LIVE";
/**
 * Directory for job JSON files (`<job_id>.json`). Sandbox-friendly default is
 * `$TMPDIR/grokbot-jobs`. Never writes into sand-data agent folders.
 */
export declare const ENV_GROKBOT_JOBS_DIR = "GROKBOT_JOBS_DIR";
export type SandPaths = {
    sandRoot: string;
    agentsDir: string;
    userMemoryDir: string;
    userMemoryShardsDir: string;
    transcriptsDir: string;
    workflowsDir: string;
    searchIndexPath: string;
    activeAgentPath: string;
    gatewayDiscoveryPath: string;
};
/** Job JSON store. Default: `join(tmpdir(), "grokbot-jobs")`. */
export declare function resolveJobsDir(env?: NodeJS.ProcessEnv): string;
export declare function resolveSandRoot(env?: NodeJS.ProcessEnv): string;
export declare function sandPaths(sandRoot?: string): SandPaths;
export declare function gatewayDiscoveryPath(sandRoot?: string): string;
export declare function agentsDir(sandRoot?: string): string;
/** Host `isSafeFolderId` — agent / automation / project folder names. */
export declare function isSafeFolderId(id: string): boolean;
/** Host `SandInvalidAgentIdError`. */
export declare class SandInvalidAgentIdError extends Error {
    constructor(agentId: string);
}
/**
 * Host `assertValidSandAgentId` — `isSafeFolderId` plus no surrounding
 * whitespace (`agentId !== agentId.trim()`).
 */
export declare function isValidSandAgentId(agentId: string): boolean;
/** Host `assertValidSandAgentId`. */
export declare function assertValidSandAgentId(agentId: string): void;
/**
 * Host `resolveSandAgentDir` containment check: `join(parent, id)` must
 * stay a single direct child of `parent`.
 */
export declare function resolveSafeChildDir(parent: string, id: string): string;
export declare function agentDir(agentId: string, sandRoot?: string): string;
export declare function agentProfilePath(agentId: string, sandRoot?: string): string;
export declare function agentSettingsPath(agentId: string, sandRoot?: string): string;
export declare function agentGroupPath(agentId: string, sandRoot?: string): string;
export declare function agentMemoryDir(agentId: string, sandRoot?: string): string;
export declare function agentAutomationsDir(agentId: string, sandRoot?: string): string;
export declare function storeDbPath(agentId: string, sandRoot?: string): string;
export declare function conversationBlobsPath(agentId: string, sandRoot?: string): string;
export declare function userMemoryDir(sandRoot?: string): string;
export declare function userMemoryShardDir(agentId: string, sandRoot?: string): string;
export declare function transcriptPath(agentId: string, sandRoot?: string): string;
export declare function transcriptsDir(sandRoot?: string): string;
export declare function workflowsDir(sandRoot?: string): string;
export declare function workflowSkillPath(slug: string, sandRoot?: string): string;
export declare function searchIndexPath(sandRoot?: string): string;
export declare function activeAgentPath(sandRoot?: string): string;
/** @deprecated unused helper kept for callers that want a home-relative fallback */
export declare function homeSandRoot(home?: string): string;
//# sourceMappingURL=paths.d.ts.map