@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.4

package/lib/types/host/services/schedule-mode/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * schedule-mode host 服务域：在**原生**自动化任务之上叠加「运行目标」选择。
+ *
+ * 原生 `@deepseek-ai/dsh-schedule` 把任务绑定到创建它的会话，到期就地投递；
+ * 本服务域不替换原生调度，而是把任务在两种目标间切换：
+ *
+ *   - `original`（默认、零改动）：不建策略，原生投递照旧；
+ *   - `new`：按原规则在一条**新建的运行会话**上挂一把轮转副本，并撤掉原会话上
+ *     的那行；副本每次投递完成后，再开下一条会话并把副本换挂过去。于是原会话
+ *     永远不再收到投递，每次运行都落在一条全新会话里。
+ *
+ * 计时完全由原生负责（副本自身按原规则推进时点），本域只在投递确认后轮转，
+ * 所以 cron / 每日 / 每周的语义与原生逐字一致，也不需要自己实现时区计算。
+ *
+ * 原生 schedule 是可选 bundle：本域用结构化面 + 非严格 `ctx.get` 读取它，
+ * 缺服务时列表返回 `available: false`、工具给出明确错误，绝不让 web-all 加载失败。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export { ScheduleModeStore, defaultScheduleModeStorePath } from './store.ts';
+export { buildSessionCreateRequest, type ScheduleModeSessionCreateRequest, type ScheduleModeSessionInput } from './session-create.ts';
+export { ScheduleModeEngine, ScheduleModeError, type ScheduleModePorts, type ScheduleModeErrorCode } from './engine.ts';
+export { SCHEDULE_MODE_SETTINGS_NAMESPACE, type ScheduleModeConfig } from './config.ts';
+/** 服务域依赖。 */
+export interface ScheduleModeServiceDeps {
+    /** 策略存储路径（默认 $DSH_HOME/dsh-schedule-mode.json）。 */
+    storePath?: string;
+    logger?: {
+        warn(error: unknown): void;
+    };
+}
+/** 服务域注册入口；返回统一 disposer。 */
+export declare function register(ctx: Context, deps?: ScheduleModeServiceDeps): () => void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/host/services/schedule-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/schedule-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAclD,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,EAAE,yBAAyB,EAAE,KAAK,gCAAgC,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AACrI,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACvH,OAAO,EAAE,gCAAgC,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AA2BvF,aAAa;AACb,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CACxC;AAuBD,6BAA6B;AAC7B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,uBAA4B,GAAG,MAAM,IAAI,CA2HrF"}

package/lib/types/host/services/schedule-mode/index.js

@@ -0,0 +1,175 @@
+import { nativeTaskView } from "../../../core/schedule-mode/native.js";
+import { familyNamespace, onFamilyConfigChange } from "../family-config.js";
+import { SCHEDULE_MODE_SETTINGS_NAMESPACE } from "./config.js";
+import { ScheduleModeEngine } from "./engine.js";
+import { ScheduleModeStore, defaultScheduleModeStorePath } from "./store.js";
+import { buildSessionCreateRequest } from "./session-create.js";
+import { registerScheduleModeRoutes } from "./routes.js";
+import { registerScheduleModeTools } from "./tools.js";
+import { registerResources } from "../resources.js";
+export { ScheduleModeStore, defaultScheduleModeStorePath } from "./store.js";
+export { buildSessionCreateRequest } from "./session-create.js";
+export { ScheduleModeEngine, ScheduleModeError } from "./engine.js";
+export { SCHEDULE_MODE_SETTINGS_NAMESPACE } from "./config.js";
+/** 非严格读取可选服务（缺失返回 undefined，不抛错）。 */
+function optionalService(ctx, name) {
+    try {
+        return ctx.get(name, false);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 订阅一个可能不存在的插件事件（事件名不在宿主类型面内时也不抛错）。 */
+function onEvent(ctx, event, listener) {
+    return ctx.on(event, listener);
+}
+/** 会话 cwd 对应的已注册工作区：投递完成的运行会话据此挂回工作区。 */
+function workspaceIdFor(ctx, cwd) {
+    const registry = optionalService(ctx, 'workspaceRegistry');
+    const match = registry?.list().find(workspace => typeof workspace.path === 'string' && workspace.path === cwd);
+    return match?.id === undefined ? undefined : String(match.id);
+}
+/** 服务域注册入口；返回统一 disposer。 */
+export function register(ctx, deps = {}) {
+    const logger = deps.logger ?? { warn: (error) => { console.warn('[web-all:schedule-mode]', error); } };
+    const settings = () => familyNamespace(SCHEDULE_MODE_SETTINGS_NAMESPACE) ?? {};
+    const scheduleFace = () => optionalService(ctx, 'schedule');
+    const controllerFace = () => optionalService(ctx, 'sessionController');
+    const ports = {
+        async listTasks() {
+            const schedule = scheduleFace();
+            if (schedule === undefined)
+                throw new Error('the native schedule service is unavailable in this profile');
+            const entries = await schedule.catalog();
+            if (!Array.isArray(entries))
+                throw new Error('native schedule catalog is malformed');
+            const tasks = entries.map(nativeTaskView);
+            if (tasks.some(task => task === undefined))
+                throw new Error('native schedule catalog schema is unsupported; absence is unconfirmed');
+            const rows = tasks;
+            if (new Set(rows.map(task => task.id)).size !== rows.length)
+                throw new Error('native schedule catalog contains duplicate task IDs');
+            return rows;
+        },
+        async createTask(sessionId, request) {
+            const schedule = scheduleFace();
+            if (schedule === undefined)
+                throw new Error('the native schedule service is unavailable in this profile');
+            const record = await schedule.create(sessionId, {
+                prompt: request.prompt,
+                title: request.title,
+                ...request.selector,
+            });
+            const id = typeof record['id'] === 'string' ? record['id'] : undefined;
+            const scheduledAt = typeof record['scheduledAt'] === 'string' ? record['scheduledAt'] : undefined;
+            if (id === undefined || scheduledAt === undefined)
+                throw new Error('schedule.create returned an unexpected record');
+            return { id, scheduledAt };
+        },
+        async deleteTask(sessionId, id) {
+            const schedule = scheduleFace();
+            if (schedule === undefined)
+                throw new Error('the native schedule service is unavailable in this profile');
+            await schedule.delete({ sessionId, id });
+        },
+        async inspectSession(sessionId) {
+            const controller = controllerFace();
+            if (controller === undefined)
+                throw new Error('the session controller is unavailable');
+            const inspection = await controller.inspect(sessionId);
+            const meta = inspection?.meta;
+            return {
+                ...(typeof meta?.cwd === 'string' && meta.cwd !== '' ? { cwd: meta.cwd } : {}),
+                ...(typeof meta?.agentPreset === 'string' && meta.agentPreset !== '' ? { agentPreset: meta.agentPreset } : {}),
+            };
+        },
+        async createSession(input) {
+            const controller = controllerFace();
+            if (controller === undefined)
+                throw new Error('the session controller is unavailable');
+            const value = await controller.create(buildSessionCreateRequest(input));
+            const sessionId = typeof value?.sessionId === 'string' ? value.sessionId : undefined;
+            if (sessionId === undefined)
+                throw new Error('session creation returned no session id');
+            return sessionId;
+        },
+        /**
+         * 运行会话跑出第一轮后挂回它所属的工作区。待运行期间刻意不挂：工作区里的空会话
+         * 会被 DSH 的「新建会话」复用，新对话就会被认领成这条自动化待运行会话。
+         */
+        async attachSession(sessionId, cwd) {
+            if (cwd === undefined)
+                return;
+            const workspaceId = workspaceIdFor(ctx, cwd);
+            if (workspaceId === undefined)
+                return;
+            const workspace = optionalService(ctx, 'workspaceRegistry')?.get?.(workspaceId);
+            if (workspace?.attachSession === undefined)
+                return;
+            await workspace.attachSession(sessionId);
+        },
+        async renameSession(sessionId, title) {
+            if ((settings().nameRunSessions ?? true) === false)
+                return;
+            const controller = controllerFace();
+            if (controller === undefined)
+                throw new Error('the session controller is unavailable');
+            await controller.rename({ sessionId, title });
+        },
+        get runHistoryLimit() {
+            return settings().runHistoryLimit ?? 50;
+        },
+        now: () => Date.now(),
+        log: (message, error) => {
+            if (error === undefined) {
+                logger.warn(message);
+                return;
+            }
+            logger.warn(`${message}: ${error instanceof Error ? error.message : String(error)}`);
+        },
+    };
+    const store = new ScheduleModeStore(deps.storePath ?? defaultScheduleModeStorePath());
+    const engine = new ScheduleModeEngine(store, ports);
+    let disposed = false;
+    let disposeSurfaces;
+    const sync = () => {
+        if (disposed)
+            return;
+        // Stop pending work before removing the old admission surfaces. Enabling
+        // later resumes through its persisted intent, never through a late callback.
+        engine.setEnabled(false);
+        disposeSurfaces?.();
+        disposeSurfaces = undefined;
+        if ((settings().enabled ?? true) === false)
+            return;
+        try {
+            disposeSurfaces = registerResources(own => {
+                own(registerScheduleModeRoutes(ctx, { engine, logger }));
+                own(registerScheduleModeTools(ctx, engine));
+                own(onEvent(ctx, 'schedule/changed', () => {
+                    if (!disposed)
+                        void engine.reconcile().catch(error => logger.warn(error));
+                }));
+                own(onEvent(ctx, 'workspace/session-stop', (...args) => {
+                    const payload = args[0];
+                    if (disposed || typeof payload?.sessionId !== 'string' || payload.sessionId === '')
+                        return;
+                    void engine.stopSession(payload.sessionId).catch(error => logger.warn(error));
+                }));
+            });
+            engine.setEnabled(true);
+            void engine.reconcile().catch(error => logger.warn(error));
+        }
+        catch (error) {
+            engine.setEnabled(false);
+            throw error;
+        }
+    };
+    return registerResources(own => {
+        own(() => { disposed = true; engine.dispose(); });
+        own(() => { disposeSurfaces?.(); });
+        own(onFamilyConfigChange(() => sync()));
+        sync();
+    });
+}

package/lib/types/host/services/schedule-mode/routes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * schedule-mode host 路由族：`/api/schedule-mode/*`（JSON envelope `{ok,value}`）。
+ *
+ *   GET  /tasks    逻辑任务合并视图（原生任务 + 会话模式策略）
+ *   POST /mode     切换 `original` / `new`
+ *   POST /delete   删除逻辑任务（`new` 模式一并撤下轮转副本）
+ *   POST /refresh  与原生目录对齐（幂等收敛）后再返回视图
+ *
+ * 信任围栏为共享的宿主访问围栏（loopback，或部署声明的 trusted authority +
+ * 已登录浏览器会话），与其它家族面板一致。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
+import type { IncomingMessage } from 'node:http';
+import { SCHEDULE_MODE_API_PREFIX } from '../../../core/schedule-mode/view.ts';
+import { type ScheduleModeEngine } from './engine.ts';
+export { SCHEDULE_MODE_API_PREFIX };
+/** 路由依赖。 */
+export interface ScheduleModeRoutesDeps {
+    engine: ScheduleModeEngine;
+    logger: {
+        warn(error: unknown): void;
+    };
+    /** Host access fence; defaults to the strict loopback rule. */
+    isTrusted?(req: IncomingMessage): boolean;
+}
+/** 组装路由（可直接单测，无需 webServer 服务）。 */
+export declare function makeScheduleModeRoutes(deps: ScheduleModeRoutesDeps): WebRoute[];
+/** 服务域注册入口（路由）。 */
+export declare function registerScheduleModeRoutes(ctx: Context, deps: ScheduleModeRoutesDeps): () => void;
+//# sourceMappingURL=routes.d.ts.map

package/lib/types/host/services/schedule-mode/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/schedule-mode/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAKxE,OAAO,EAAE,wBAAwB,EAAE,CAAA;AAEnC,YAAY;AACZ,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACtC,+DAA+D;IAC/D,SAAS,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAA;CAC1C;AAgCD,mCAAmC;AACnC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,QAAQ,EAAE,CA6D/E;AAED,mBAAmB;AACnB,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAIjG"}

package/lib/types/host/services/schedule-mode/routes.js

@@ -0,0 +1,109 @@
+import { SCHEDULE_MODE_API_PREFIX } from "../../../core/schedule-mode/view.js";
+import { ScheduleModeError } from "./engine.js";
+import { accessTrustOf } from "../access-trust/index.js";
+import { isLoopbackRequest } from "../access-trust/trust.js";
+import { registerResources } from "../resources.js";
+export { SCHEDULE_MODE_API_PREFIX };
+function writeJson(res, status, body) {
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'x-content-type-options': 'nosniff' });
+    res.end(JSON.stringify(body));
+}
+function ok(res, value) {
+    writeJson(res, 200, { ok: true, value });
+}
+function fail(res, status, code, message) {
+    writeJson(res, status, { ok: false, error: { code, message } });
+}
+async function readJsonBody(req, maxBytes = 64 * 1024) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        total += buf.length;
+        if (total > maxBytes)
+            return null;
+        chunks.push(buf);
+    }
+    try {
+        const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        return parsed !== null && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 组装路由（可直接单测，无需 webServer 服务）。 */
+export function makeScheduleModeRoutes(deps) {
+    const { engine, logger } = deps;
+    const isTrusted = deps.isTrusted ?? isLoopbackRequest;
+    const handler = async (req, res) => {
+        if (!isTrusted(req)) {
+            fail(res, 403, 'forbidden', 'loopback only');
+            return;
+        }
+        const url = new URL(req.url ?? '/', 'http://dsh.local');
+        const pathname = url.pathname;
+        const sessionFilter = url.searchParams.get('sessionId');
+        /** 读取一律限定在调用方自己的会话上：不带 sessionId 的整机列举就是跨会话读取。 */
+        const scopedSession = () => (sessionFilter === null || sessionFilter === '' ? undefined : sessionFilter);
+        const filtered = async (value) => {
+            const scope = scopedSession();
+            if (scope === undefined)
+                return { available: value.available, tasks: [] };
+            // 过滤值既可以是原会话，也可以是当前运行会话（原生页里轮转副本挂在运行会话上）。
+            return { available: value.available, tasks: value.tasks.filter(task => task.sessionId === scope || task.runSessionId === scope) };
+        };
+        try {
+            if (pathname === `${SCHEDULE_MODE_API_PREFIX}/tasks` && req.method === 'GET') {
+                ok(res, await filtered(await engine.list()));
+                return;
+            }
+            if (pathname === `${SCHEDULE_MODE_API_PREFIX}/refresh` && req.method === 'POST') {
+                await engine.reconcile();
+                ok(res, await filtered(await engine.list()));
+                return;
+            }
+            if (pathname === `${SCHEDULE_MODE_API_PREFIX}/mode` && req.method === 'POST') {
+                const body = await readJsonBody(req);
+                const sessionId = body?.['sessionId'];
+                const id = body?.['id'];
+                const mode = body?.['mode'];
+                if (typeof sessionId !== 'string' || typeof id !== 'string' || (mode !== 'original' && mode !== 'new')) {
+                    fail(res, 400, 'bad-request', 'expected { sessionId, id, mode: "original" | "new" }');
+                    return;
+                }
+                ok(res, { task: await engine.setMode(sessionId, id, mode) });
+                return;
+            }
+            if (pathname === `${SCHEDULE_MODE_API_PREFIX}/delete` && req.method === 'POST') {
+                const body = await readJsonBody(req);
+                const sessionId = body?.['sessionId'];
+                const id = body?.['id'];
+                if (typeof sessionId !== 'string' || typeof id !== 'string') {
+                    fail(res, 400, 'bad-request', 'expected { sessionId, id }');
+                    return;
+                }
+                ok(res, { deleted: await engine.deleteTask(sessionId, id) });
+                return;
+            }
+            fail(res, 404, 'not-found', `unknown route: ${req.method} ${pathname}`);
+        }
+        catch (error) {
+            if (error instanceof ScheduleModeError) {
+                const status = error.code === 'unknown-task' ? 404 : (error.code === 'task-ended' || error.code === 'recovery-required') ? 409 : 400;
+                fail(res, status, error.code, error.message);
+                return;
+            }
+            logger.warn(error);
+            fail(res, 500, 'internal', error instanceof Error ? error.message : String(error));
+        }
+    };
+    return [{ kind: 'prefix', path: SCHEDULE_MODE_API_PREFIX, handler }];
+}
+/** 服务域注册入口（路由）。 */
+export function registerScheduleModeRoutes(ctx, deps) {
+    return registerResources(own => {
+        for (const route of makeScheduleModeRoutes({ ...deps, isTrusted: accessTrustOf(ctx).isTrusted }))
+            own(ctx.webServer.register(route));
+    });
+}

package/lib/types/host/services/schedule-mode/session-create.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 运行会话创建请求的纯构造逻辑。
+ *
+ * 刻意**不带** `workspaceId`：DSH 的「新建会话」会复用当前工作区里尚未产生第一轮
+ * 对话的空会话（`dsh-client-ui-workspace` 的 `reuseOrCreateBlank`：`blank` 一直为真
+ * 直到会话提交首个 `turn/start`），而「每次新会话」必须在投递前先把运行会话建出来。
+ * 两者相遇时，用户刚点开的「新对话」会被认领成自动化的待运行会话——连带继承
+ * `<任务名> · #N` 的名字和挂在上面的待投递提醒。因此运行会话先只按 `cwd` 创建，
+ * 等它真正投递出第一轮后由引擎挂回工作区（见同目录 `index.ts` 的 `attachSession`
+ * 端口）。`agentPreset` 原样透传，缺省时不发送。
+ */
+/** 引擎侧的会话创建输入。 */
+export interface ScheduleModeSessionInput {
+    readonly cwd?: string;
+    readonly agentPreset?: string;
+}
+/** 传给 `sessionController.create` 的请求体。 */
+export interface ScheduleModeSessionCreateRequest {
+    readonly cwd?: string;
+    readonly agentPreset?: string;
+}
+/**
+ * 构造创建请求：只带 `cwd` 与 `agentPreset`，不请求工作区归属，
+ * 让待运行会话留在工作区之外直到它产生第一轮对话。
+ */
+export declare function buildSessionCreateRequest(input: ScheduleModeSessionInput): ScheduleModeSessionCreateRequest;
+//# sourceMappingURL=session-create.d.ts.map

package/lib/types/host/services/schedule-mode/session-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-create.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/schedule-mode/session-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kBAAkB;AAClB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,0CAA0C;AAC1C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,gCAAgC,CAKlC"}

package/lib/types/host/services/schedule-mode/session-create.js

@@ -0,0 +1,21 @@
+/**
+ * 运行会话创建请求的纯构造逻辑。
+ *
+ * 刻意**不带** `workspaceId`：DSH 的「新建会话」会复用当前工作区里尚未产生第一轮
+ * 对话的空会话（`dsh-client-ui-workspace` 的 `reuseOrCreateBlank`：`blank` 一直为真
+ * 直到会话提交首个 `turn/start`），而「每次新会话」必须在投递前先把运行会话建出来。
+ * 两者相遇时，用户刚点开的「新对话」会被认领成自动化的待运行会话——连带继承
+ * `<任务名> · #N` 的名字和挂在上面的待投递提醒。因此运行会话先只按 `cwd` 创建，
+ * 等它真正投递出第一轮后由引擎挂回工作区（见同目录 `index.ts` 的 `attachSession`
+ * 端口）。`agentPreset` 原样透传，缺省时不发送。
+ */
+/**
+ * 构造创建请求：只带 `cwd` 与 `agentPreset`，不请求工作区归属，
+ * 让待运行会话留在工作区之外直到它产生第一轮对话。
+ */
+export function buildSessionCreateRequest(input) {
+    return {
+        ...(input.cwd === undefined ? {} : { cwd: input.cwd }),
+        ...(input.agentPreset === undefined ? {} : { agentPreset: input.agentPreset }),
+    };
+}

package/lib/types/host/services/schedule-mode/store.d.ts

@@ -0,0 +1,36 @@
+import { DEFAULT_RUN_HISTORY_LIMIT, isRecurringRule, type ScheduleModePolicy } from '../../../core/schedule-mode/types.ts';
+/** 存储格式版本。 */
+export declare const SCHEDULE_MODE_FORMAT_VERSION = 1;
+/** 默认存储路径。 */
+export declare function defaultScheduleModeStorePath(): string;
+/** 存储文件形状。 */
+export interface ScheduleModeStoreFile {
+    formatVersion: number;
+    policies: Record<string, ScheduleModePolicy>;
+}
+/** 解码一条策略；结构不符返回 undefined。 */
+export declare function parsePolicy(value: unknown): ScheduleModePolicy | undefined;
+/** Invalid persistence is not absence: leave the original bytes untouched. */
+export declare function parseStoreFile(text: string): ScheduleModeStoreFile;
+/** 策略存储（原子写 + 内存快照）。 */
+export declare class ScheduleModeStore {
+    private readonly file;
+    private cache;
+    constructor(file?: string);
+    get identity(): string;
+    /** One FIFO per on-disk store in this process, not one FIFO per engine. */
+    coordinate<T>(work: () => Promise<T>, rejectBusy?: boolean): Promise<T>;
+    load(): ScheduleModeStoreFile;
+    private persist;
+    list(): ScheduleModePolicy[];
+    get(key: string): ScheduleModePolicy | undefined;
+    /** 按任一原生任务 id（逻辑 id 或当前副本 id）找策略。 */
+    find(logicalId: string, sourceSessionId: string): ScheduleModePolicy | undefined;
+    findArmed(armedTaskId: string): ScheduleModePolicy | undefined;
+    upsert(policy: ScheduleModePolicy): ScheduleModePolicy;
+    remove(key: string): boolean;
+    /** 丢掉内存快照，强制下次从磁盘重读（测试/外改场景）。 */
+    invalidate(): void;
+}
+export { DEFAULT_RUN_HISTORY_LIMIT, isRecurringRule };
+//# sourceMappingURL=store.d.ts.map

package/lib/types/host/services/schedule-mode/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/schedule-mode/store.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,yBAAyB,EACzB,eAAe,EAEf,KAAK,kBAAkB,EAIxB,MAAM,sCAAsC,CAAA;AAE7C,cAAc;AACd,eAAO,MAAM,4BAA4B,IAAI,CAAA;AAE7C,cAAc;AACd,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,cAAc;AACd,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CAC7C;AA0GD,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAgD1E;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAalE;AAKD,wBAAwB;AACxB,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAAmC;gBAEnB,IAAI,GAAE,MAAuC;IAE1E,IAAI,QAAQ,IAAI,MAAM,CAIrB;IAED,2EAA2E;IAC3E,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAarE,IAAI,IAAI,qBAAqB;IAW7B,OAAO,CAAC,OAAO;IAUf,IAAI,IAAI,kBAAkB,EAAE;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIhD,qCAAqC;IACrC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIhF,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI9D,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB;IAatD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY5B,iCAAiC;IACjC,UAAU,IAAI,IAAI;CAGnB;AAED,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,CAAA"}