/**
 * 会话级环境变量存储：按 sessionKey 保存每个会话的 exec 环境变量，
 * 供 before_tool_call 向 exec 子进程注入（多用户并发安全，不碰 process.env）。
 *
 * 语义：同一群内多人先后触发时按「最后触发者」覆盖写入；subagent 通过
 * linkChildSession 沿父子链反查父会话的 env。
 */
export declare const XG_OPENAPI_APP_KEY = "XG_OPENAPI_APP_KEY";
export declare const XG_OPENAPI_BASE_URL = "XG_OPENAPI_BASE_URL";
/** 过滤非法/危险 env 键值对（key 命名、长度、null 字节）。 */
export declare function sanitizeSessionEnv(env: Record<string, string>): Record<string, string>;
export declare function isRecord(value: unknown): value is Record<string, unknown>;
/** 合并写入某个会话的 env（覆盖同 key；空/非法值会被过滤）。 */
export declare function setSessionEnv(sessionKey: string, env: Record<string, string>): void;
/** 设置/删除某个会话的单个 env 键；value 为 undefined 时删除。 */
export declare function setSessionEnvEntry(sessionKey: string, key: string, value: string | undefined): void;
/** 读取某个会话的 env 快照（浅拷贝）。 */
export declare function getSessionEnv(sessionKey: string): Record<string, string> | undefined;
/** 清空某个会话的 env 与父子关联。 */
export declare function clearSessionEnv(sessionKey: string): void;
/** 删除某个会话的单个 env 键。 */
export declare function removeSessionEnvKey(sessionKey: string, key: string): void;
/** 登记 subagent 子会话到父会话的关联，供 exec env 父子链反查。 */
export declare function linkChildSession(childSessionKey: string, parentSessionKey: string): void;
/**
 * 解析某个会话应注入 exec 的 env：先查本会话；查不到则沿 subagent 父子链
 * 反查父会话（限深，防环）。subagent 内 exec 触发 hook 时 sessionKey 是子会话 key。
 */
export declare function resolveEnvForSession(sessionKey: string | undefined): Record<string, string>;
export declare function __resetSessionEnvStoreForTests(): void;
//# sourceMappingURL=session-env-store.d.ts.map