import type { Plan, PlanSummary } from "@xgjktech/xg-openclaw-shared";
/** 注入 stateDir（来自 api.runtime.state.resolveStateDir()）。register(api) 时调用一次。 */
export declare function setPlanStateDir(dir: string): void;
/** 测试用：重置模块级缓存与 stateDir */
export declare function resetPlanStoreAccessForTest(): void;
/**
 * 按 planId 反查完整计划。
 * 库不存在 / 打开失败 / 读取异常 → 返回 undefined 并记 warn 日志，绝不抛。
 */
export declare function getPlanById(planId: string): Plan | undefined;
/**
 * 列出全部计划摘要（重启恢复用）。
 * 异常同上 → 返回空数组，绝不抛。
 */
export declare function listPlanSummaries(): PlanSummary[];
/**
 * 按来源会话（channel + to）反查全量 plan（WS 快照用）。
 * shared 侧只读实现已内置"旧库缺 origin 列 → 返回 []"的探测降级；
 * 这里叠加本文件既有的句柄级降级纪律：拿不到句柄 / 查询异常 → 记 warn、返回 []、绝不抛、
 * 失败时清空句柄缓存（与 getPlanById 同款，供后续调用重试恢复）。
 */
export declare function listPlansByOrigin(channel: string, to: string): Plan[];
//# sourceMappingURL=plan-store-access.d.ts.map