@qing3a/flow-rpa-engine 0.1.0

package/dist/learning.d.ts

@@ -0,0 +1,82 @@
+import type { RunRecord, StepRecord } from './record.js';
+/**
+ * L2 学习管线 —— 执行记录 → 结构化信号 → 改进建议 → 人工确认后应用（移植自 Rust `learning.rs`）。
+ *
+ * 数据流：
+ *   1. `learnFromRun`：把一次执行记录（run.json）转成结构化信号，与历史信号一起
+ *      喂给 `SuggestionStore`，产出改进建议（标注来源=local 规则分析）。
+ *   2. `SuggestionStore`：建议持久化（suggestions/ 目录），供 list_suggestions /
+ *      apply_suggestion / dismiss_suggestion。
+ *   3. 成熟度阈值：同一改进被多次成功复用（样本 ≥ MATURITY_MIN_SAMPLES=5）后标记「成熟」，
+ *      此后 apply 可自动执行，不再强制人工确认。
+ *   4. 人工确认后应用：未成熟建议 apply 要求 confirm=true（结构改动必须人工确认）。
+ */
+/** 成熟度门槛（样本数）：同一改进样本 ≥ 门槛后标记「成熟」（与观察样本门槛 <5 同构） */
+export declare const MATURITY_MIN_SAMPLES = 5;
+/** 本地规则分析来源标识（与平台建议区分） */
+export declare const SOURCE_LOCAL = "local";
+/** 平台侧建议来源标识 */
+export declare const SOURCE_PLATFORM = "platform";
+/** 建议类别（结构化字段） */
+export type SuggestionKind = 'extend_verify_timeout' | 'change_selector' | 'add_verify' | 'change_extract_selector' | 'check_input_value' | 'add_pre_wait';
+export declare const SUGGESTION_KINDS: readonly SuggestionKind[];
+/** 一条改进建议（持久化在 suggestions/<flow_id>/ 下，suggestion_id 即文件名） */
+export interface Suggestion {
+    suggestionId: string;
+    flowId: string;
+    kind: SuggestionKind;
+    /** 目标步骤 id（空 = 流程级） */
+    stepId: string;
+    /** 人类可读的建议内容（标注来源与依据） */
+    message: string;
+    /** 来源：local（本地规则分析）/ platform（平台 agent 回复） */
+    source: string;
+    /** pending（待人工确认）/ applied（已应用）/ dismissed（已忽略）/ mature（成熟，可自动执行） */
+    status: 'pending' | 'applied' | 'dismissed' | 'mature';
+    /** 该改进已被成功复用的次数（成熟度样本计数） */
+    reuseCount: number;
+    /** 创建时间（ISO） */
+    createdAt: string;
+    /** 应用结果（status=applied 时） */
+    appliedNote?: string;
+}
+/** 建议存储：suggestions/<flow_id>/<suggestion_id>.json + 内存索引（去重/成熟度） */
+export declare class SuggestionStore {
+    private readonly root;
+    /** 索引：suggestion_id → 文件路径 */
+    private index;
+    /** flow_id → 建议列表（懒加载缓存） */
+    private byFlow;
+    constructor(root: string);
+    private flowDir;
+    private suggestionPath;
+    /** 读取某流程的全部建议（懒加载缓存；suggestions/<flow_id>/ 下 *.json） */
+    list(flowId: string): Suggestion[];
+    /** 列出全部流程的建议（供 list_suggestions 无 flow_id 时用） */
+    listAll(): Suggestion[];
+    private save;
+    /**
+     * 插入/去重：同 flow+kind+step_id 且未终止（pending/mature）的建议不重复创建，
+     * 只累加 reuseCount；否则创建新建议（status=pending）。返回建议 id。
+     */
+    upsert(flowId: string, kind: SuggestionKind, stepId: string, message: string): string;
+    private loadById;
+    /**
+     * 应用建议（人工确认后；成熟建议自动执行）。返回 (成功与否, 说明)。
+     * confirm：未成熟建议必须 confirm=true（人工确认）；成熟建议可 confirm=false 自动执行。
+     */
+    apply(suggestionId: string, confirm: boolean): string;
+    /** 忽略建议（人工处置：不再展示） */
+    dismiss(suggestionId: string): string;
+}
+/**
+ * 从一次执行记录提取结构化信号，调用学习管线生成建议。
+ * 返回本次学习产生的建议 id 列表（去重后实际新增/累积的）。
+ */
+export declare function learnFromRun(rec: RunRecord, store: SuggestionStore): string[];
+/**
+ * 从失败步骤分类出建议类别（v1 规则）。无法分类的失败返回 undefined —— 不产生建议。
+ */
+export declare function classifyFailure(step: StepRecord): SuggestionKind | undefined;
+/** 判断是否「成熟」（同改进被复用 ≥ 门槛后自动执行） */
+export declare function isMature(s: Suggestion): boolean;

package/dist/learning.js

@@ -0,0 +1,240 @@
+import { mkdirSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeJsonAtomic } from './atomic.js';
+import { nowIso } from './storage.js';
+/**
+ * L2 学习管线 —— 执行记录 → 结构化信号 → 改进建议 → 人工确认后应用（移植自 Rust `learning.rs`）。
+ *
+ * 数据流：
+ *   1. `learnFromRun`：把一次执行记录（run.json）转成结构化信号，与历史信号一起
+ *      喂给 `SuggestionStore`，产出改进建议（标注来源=local 规则分析）。
+ *   2. `SuggestionStore`：建议持久化（suggestions/ 目录），供 list_suggestions /
+ *      apply_suggestion / dismiss_suggestion。
+ *   3. 成熟度阈值：同一改进被多次成功复用（样本 ≥ MATURITY_MIN_SAMPLES=5）后标记「成熟」，
+ *      此后 apply 可自动执行，不再强制人工确认。
+ *   4. 人工确认后应用：未成熟建议 apply 要求 confirm=true（结构改动必须人工确认）。
+ */
+/** 成熟度门槛（样本数）：同一改进样本 ≥ 门槛后标记「成熟」（与观察样本门槛 <5 同构） */
+export const MATURITY_MIN_SAMPLES = 5;
+/** 本地规则分析来源标识（与平台建议区分） */
+export const SOURCE_LOCAL = 'local';
+/** 平台侧建议来源标识 */
+export const SOURCE_PLATFORM = 'platform';
+export const SUGGESTION_KINDS = [
+    'extend_verify_timeout',
+    'change_selector',
+    'add_verify',
+    'change_extract_selector',
+    'check_input_value',
+    'add_pre_wait',
+];
+/** 建议存储：suggestions/<flow_id>/<suggestion_id>.json + 内存索引（去重/成熟度） */
+export class SuggestionStore {
+    root;
+    /** 索引：suggestion_id → 文件路径 */
+    index = new Map();
+    /** flow_id → 建议列表（懒加载缓存） */
+    byFlow = new Map();
+    constructor(root) {
+        this.root = root;
+        mkdirSync(join(root, 'suggestions'), { recursive: true });
+    }
+    flowDir(flowId) {
+        return join(this.root, 'suggestions', flowId);
+    }
+    suggestionPath(flowId, suggestionId) {
+        return join(this.flowDir(flowId), `${suggestionId}.json`);
+    }
+    /** 读取某流程的全部建议（懒加载缓存；suggestions/<flow_id>/ 下 *.json） */
+    list(flowId) {
+        const cached = this.byFlow.get(flowId);
+        if (cached)
+            return [...cached];
+        const out = [];
+        try {
+            for (const name of readdirSync(this.flowDir(flowId))) {
+                if (!name.endsWith('.json'))
+                    continue;
+                const path = join(this.flowDir(flowId), name);
+                try {
+                    const s = JSON.parse(readFileSync(path, 'utf8'));
+                    if (s && typeof s === 'object' && typeof s.suggestionId === 'string') {
+                        this.index.set(s.suggestionId, path);
+                        out.push(s);
+                    }
+                }
+                catch {
+                    // 跳过损坏建议文件
+                }
+            }
+        }
+        catch {
+            // 目录不存在 → 空列表
+        }
+        out.sort((a, b) => (a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0));
+        this.byFlow.set(flowId, [...out]);
+        return out;
+    }
+    /** 列出全部流程的建议（供 list_suggestions 无 flow_id 时用） */
+    listAll() {
+        const out = [];
+        try {
+            for (const name of readdirSync(join(this.root, 'suggestions'))) {
+                out.push(...this.list(name));
+            }
+        }
+        catch {
+            // 无 suggestions 目录 → 空
+        }
+        return out;
+    }
+    save(s) {
+        mkdirSync(this.flowDir(s.flowId), { recursive: true });
+        const path = this.suggestionPath(s.flowId, s.suggestionId);
+        writeJsonAtomic(path, s);
+        this.index.set(s.suggestionId, path);
+        const entries = this.byFlow.get(s.flowId) ?? [];
+        const idx = entries.findIndex((e) => e.suggestionId === s.suggestionId);
+        if (idx !== -1)
+            entries[idx] = { ...s };
+        else
+            entries.push({ ...s });
+        entries.sort((a, b) => (a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0));
+        this.byFlow.set(s.flowId, [...entries]);
+    }
+    /**
+     * 插入/去重：同 flow+kind+step_id 且未终止（pending/mature）的建议不重复创建，
+     * 只累加 reuseCount；否则创建新建议（status=pending）。返回建议 id。
+     */
+    upsert(flowId, kind, stepId, message) {
+        this.list(flowId);
+        const active = this.byFlow.get(flowId)?.filter((s) => s.status === 'pending' || s.status === 'mature') ?? [];
+        const existing = active.find((s) => s.kind === kind && s.stepId === stepId);
+        if (existing) {
+            existing.reuseCount += 1;
+            if (existing.reuseCount >= MATURITY_MIN_SAMPLES) {
+                existing.status = 'mature';
+            }
+            this.save(existing);
+            return existing.suggestionId;
+        }
+        const id = `sug_${flowId}_${nowIso().replace(/[-:]/g, '')}`;
+        const s = {
+            suggestionId: id,
+            flowId,
+            kind,
+            stepId,
+            message,
+            source: SOURCE_LOCAL,
+            status: 'pending',
+            reuseCount: 1,
+            createdAt: nowIso(),
+            appliedNote: undefined,
+        };
+        this.save(s);
+        return id;
+    }
+    loadById(suggestionId) {
+        const path = this.index.get(suggestionId);
+        if (!path)
+            return undefined;
+        try {
+            return JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 应用建议（人工确认后；成熟建议自动执行）。返回 (成功与否, 说明)。
+     * confirm：未成熟建议必须 confirm=true（人工确认）；成熟建议可 confirm=false 自动执行。
+     */
+    apply(suggestionId, confirm) {
+        const s = this.loadById(suggestionId);
+        if (!s)
+            throw new Error(`建议不存在: ${suggestionId}`);
+        if (s.status === 'applied')
+            throw new Error('建议已应用过');
+        if (s.status === 'dismissed')
+            throw new Error('建议已被忽略');
+        if (s.status === 'pending' && !confirm) {
+            throw new Error('建议待人工确认：需 confirm=true 后应用（结构改动必须人工确认）');
+        }
+        s.status = 'applied';
+        s.appliedNote = `已应用（${confirm ? '人工确认' : '成熟自动执行'}，样本 ${s.reuseCount}/${MATURITY_MIN_SAMPLES}）`;
+        this.save(s);
+        return `建议 ${suggestionId} 已应用（${s.appliedNote}）`;
+    }
+    /** 忽略建议（人工处置：不再展示） */
+    dismiss(suggestionId) {
+        const s = this.loadById(suggestionId);
+        if (!s)
+            throw new Error(`建议不存在: ${suggestionId}`);
+        if (s.status === 'applied')
+            throw new Error('建议已应用，不能忽略');
+        s.status = 'dismissed';
+        this.save(s);
+        return `建议 ${suggestionId} 已忽略`;
+    }
+}
+/**
+ * 从一次执行记录提取结构化信号，调用学习管线生成建议。
+ * 返回本次学习产生的建议 id 列表（去重后实际新增/累积的）。
+ */
+export function learnFromRun(rec, store) {
+    const produced = [];
+    // 失败步骤才有学习价值（v1：只从失败里学）
+    for (const step of rec.steps.filter((s) => s.status === 'failed')) {
+        const kind = classifyFailure(step);
+        if (!kind)
+            continue;
+        const message = suggestionMessage(step.stepId, kind, step.error ?? '');
+        const id = store.upsert(rec.flowId, kind, step.stepId, message);
+        produced.push(id);
+    }
+    return produced;
+}
+/** 建议内容按类别生成（与 Rust learning.rs 文案一致） */
+function suggestionMessage(stepId, kind, error) {
+    switch (kind) {
+        case 'extend_verify_timeout':
+            return `步骤 ${stepId} 的 wait_selector 验证超时（${error}），建议延长 timeoutMs 或确认选择器在页面中稳定存在`;
+        case 'change_selector':
+            return `步骤 ${stepId} 的 wait_selector 验证超时（${error}），建议改用页面改版后更稳定的选择器`;
+        case 'add_verify':
+            return `步骤 ${stepId} 的 extract 返回空内容，建议补充 verify（如 textContains 或 wait_selector），否则执行器无法判定该步成败`;
+        case 'change_extract_selector':
+            return `步骤 ${stepId} 的 extract 返回空内容（${error}），建议改选择器或检查页面结构`;
+        case 'check_input_value':
+            return `步骤 ${stepId} 的 text_contains 验证失败（${error}），建议检查输入值/变量是否缺失（掩码后的输入值）`;
+        case 'add_pre_wait':
+            return `步骤 ${stepId} 的点击未命中（${error}），建议在该步骤前补 wait_selector 预等待目标出现`;
+    }
+}
+/**
+ * 从失败步骤分类出建议类别（v1 规则）。无法分类的失败返回 undefined —— 不产生建议。
+ */
+export function classifyFailure(step) {
+    const kind = step.type;
+    if (!kind)
+        return undefined;
+    const err = step.error ?? '';
+    if (kind === 'click' && (err.includes('未命中') || err.includes('点击'))) {
+        return 'add_pre_wait';
+    }
+    if ((kind === 'navigate' || kind === 'click' || kind === 'input' || kind === 'wait') && (err.includes('等待选择器') || err.includes('超时'))) {
+        return 'extend_verify_timeout';
+    }
+    if (kind === 'extract' && (err.length === 0 || err.includes('空'))) {
+        return 'change_extract_selector';
+    }
+    if (kind === 'input' && (err.includes('页面文本不含') || err.includes('变量缺失'))) {
+        return 'check_input_value';
+    }
+    return undefined;
+}
+/** 判断是否「成熟」（同改进被复用 ≥ 门槛后自动执行） */
+export function isMature(s) {
+    return s.status === 'mature' || s.reuseCount >= MATURITY_MIN_SAMPLES;
+}
+//# sourceMappingURL=learning.js.map

package/dist/learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.js","sourceRoot":"","sources":["../src/learning.ts"],"names":[],"mappings":"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"}

package/dist/mask.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 掩码规则（移植自 Rust `export.rs` 的 `Masker`；掩码前移的落盘时刻入口）。
+ *
+ * 掩码前移（ARCHITECTURE #6 / FLOW-SCHEMA）：敏感字段（密码/cookie/登录态/输入值）
+ * 在落盘时刻就掩码，本地执行记录与日志即脱敏，不只在上传时。
+ * `maskInputValue` 是 executor 落盘 input 步骤 `inputValueMasked` 的入口。
+ *
+ * 注：Rust 版 Masker 位于 export.rs；此处独立成 mask.ts 供 executor（M4）先落地最小面，
+ * M6 的 export.ts（统计通道 / 观察包）复用同一实现并 re-export。
+ */
+/** 统计通道：标识符清洗用类型占位符 */
+export declare const PLACEHOLDER_COMPANY = "<company>";
+export declare const PLACEHOLDER_KEYWORD = "<keyword>";
+export declare const PLACEHOLDER_PERSON = "<person>";
+export declare const PLACEHOLDER_JOB = "<job>";
+/**
+ * 掩码输入值（密码/cookie/登录态/输入值）：长度 ≤4 全掩，否则保留首尾各 1 字符。
+ * 按字符边界切（[...v] 迭代 Unicode 码点，避免中文等多字节切割错乱）。
+ */
+export declare function maskInputValue(v: string): string;
+/** 掩码 URL 中的敏感子串（如带账号的链接）；v1 仅掩码已知敏感片段 */
+export declare function maskUrl(url: string): string;
+/** 掩码文本中的关键词（统计通道标识符清洗的补充：文本内出现已知关键词一律替换） */
+export declare function maskKeywordInText(text: string, keyword: string): string;
+/**
+ * 掩码文本中的多个关键词（落盘时刻 error 掩码用；掩码前移）。
+ * - 长度降序替换，避免短词作为长词子串时先被替换、长词残留
+ * - 只替换关键词原文，不动类别短语（「不含」/「超时」/「未命中」等）——
+ *   失败类别判定不受影响
+ * - 空串/空列表跳过（无关键词上下文时原样返回）
+ */
+export declare function maskKeywords(text: string, keywords: string[]): string;

package/dist/mask.js

@@ -0,0 +1,70 @@
+/**
+ * 掩码规则（移植自 Rust `export.rs` 的 `Masker`；掩码前移的落盘时刻入口）。
+ *
+ * 掩码前移（ARCHITECTURE #6 / FLOW-SCHEMA）：敏感字段（密码/cookie/登录态/输入值）
+ * 在落盘时刻就掩码，本地执行记录与日志即脱敏，不只在上传时。
+ * `maskInputValue` 是 executor 落盘 input 步骤 `inputValueMasked` 的入口。
+ *
+ * 注：Rust 版 Masker 位于 export.rs；此处独立成 mask.ts 供 executor（M4）先落地最小面，
+ * M6 的 export.ts（统计通道 / 观察包）复用同一实现并 re-export。
+ */
+/** 统计通道：标识符清洗用类型占位符 */
+export const PLACEHOLDER_COMPANY = '<company>';
+export const PLACEHOLDER_KEYWORD = '<keyword>';
+export const PLACEHOLDER_PERSON = '<person>';
+export const PLACEHOLDER_JOB = '<job>';
+/**
+ * 掩码输入值（密码/cookie/登录态/输入值）：长度 ≤4 全掩，否则保留首尾各 1 字符。
+ * 按字符边界切（[...v] 迭代 Unicode 码点，避免中文等多字节切割错乱）。
+ */
+export function maskInputValue(v) {
+    const chars = [...v];
+    if (chars.length <= 4)
+        return '****';
+    return `${chars[0]}****${chars[chars.length - 1]}`;
+}
+/** 掩码 URL 中的敏感子串（如带账号的链接）；v1 仅掩码已知敏感片段 */
+export function maskUrl(url) {
+    let out = url;
+    for (const [k, v] of [
+        ['password=', '<pwd>'],
+        ['passwd=', '<pwd>'],
+        ['token=', '<token>'],
+    ]) {
+        const pos = out.indexOf(k);
+        if (pos !== -1) {
+            const rest = out.slice(pos + k.length);
+            const end = /[&#]/.exec(rest);
+            const stop = end ? pos + k.length + end.index : out.length;
+            out = out.slice(0, pos + k.length) + v + out.slice(stop);
+        }
+    }
+    return out;
+}
+/** 掩码文本中的关键词（统计通道标识符清洗的补充：文本内出现已知关键词一律替换） */
+export function maskKeywordInText(text, keyword) {
+    if (keyword.length === 0)
+        return text;
+    return text.split(keyword).join(PLACEHOLDER_KEYWORD);
+}
+/**
+ * 掩码文本中的多个关键词（落盘时刻 error 掩码用；掩码前移）。
+ * - 长度降序替换，避免短词作为长词子串时先被替换、长词残留
+ * - 只替换关键词原文，不动类别短语（「不含」/「超时」/「未命中」等）——
+ *   失败类别判定不受影响
+ * - 空串/空列表跳过（无关键词上下文时原样返回）
+ */
+export function maskKeywords(text, keywords) {
+    if (keywords.length === 0)
+        return text;
+    const ks = keywords.filter((k) => k.length > 0);
+    if (ks.length === 0)
+        return text;
+    ks.sort((a, b) => b.length - a.length);
+    let out = text;
+    for (const k of ks) {
+        out = out.split(k).join(PLACEHOLDER_KEYWORD);
+    }
+    return out;
+}
+//# sourceMappingURL=mask.js.map

package/dist/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../src/mask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uBAAuB;AACvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IACpB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACpC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,CAAA;AACrD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,GAAG,GAAG,GAAG,CAAA;IACb,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QACnB,CAAC,WAAW,EAAE,OAAO,CAAC;QACtB,CAAC,SAAS,EAAE,OAAO,CAAC;QACpB,CAAC,QAAQ,EAAE,SAAS,CAAC;KACb,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC1B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;YACtC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;YAC1D,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAkB;IAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/C,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAChC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,66 @@
+/**
+ * md-forge 平台客户端（移植自 Rust `platform.rs`；MIGRATION-NODE 七 / EXECUTION-SPEC 七）。
+ *
+ * 协议（md-forge M3 端点，契约已确认）：
+ *   GET /api/packages/<name>           → { ok:true, data: {name,type,version,hash,files[]} }
+ *   GET /api/packages/<name>/files/<f> → 包文件（Bearer 令牌）
+ *
+ * 包 hash 口径与 md-forge `hashFiles` 一致：对 files 按键排序后逐文件
+ * `name\0content` 做 SHA-256 hex（跨实现可校验）。
+ *
+ * 流程包（type=flow）：校验通过后自动替换本地 flows/<name>/（写 flow.json + 其余文件 +
+ * 本地 manifest.json）；软件包（type=software）：不自动替换，提示用户（v1 只做流程包自动部署）。
+ * 哈希校验失败 → 不落盘（返回错误）。
+ */
+/** 包 manifest（与 md-forge 通用包模型一致） */
+export interface PkgManifest {
+    name: string;
+    type: string;
+    version: string;
+    hash: string;
+    files: string[];
+    signature?: string;
+}
+/** 平台客户端（无状态；每次 pkg_update 独立请求） */
+export declare class PlatformClient {
+    readonly baseUrl: string;
+    readonly token: string;
+    constructor(baseUrl: string, token: string);
+    /** 拉取包 manifest（GET /api/packages/<name>，Bearer 认证） */
+    fetchManifest(name: string): Promise<PkgManifest>;
+    /** 下载包内单文件（GET /api/packages/<name>/files/<f>，Bearer 认证） */
+    fetchFile(name: string, file: string): Promise<Uint8Array>;
+    /** 下载整个包（按 manifest.files），返回 {文件名: 内容}（按键排序） */
+    downloadPackage(manifest: PkgManifest): Promise<Map<string, Uint8Array>>;
+    /** 计算包 hash（与 md-forge hashFiles 同口径：files 按键排序，name\0content，SHA-256 hex） */
+    static computeHash(files: Map<string, Uint8Array> | Record<string, Uint8Array>): string;
+    /**
+     * M10 D-O1：上传观察包目录到平台（POST {base}/api/observations，multipart）。
+     * bundleDir 为 outbox/<flow_id>_v<version>_<run_id>/；身份前缀 = <flow_id>_v<version>_<run_id>。
+     * 返回 { status: 'accepted' | 'duplicate', dir }；网络/4xx/5xx 抛错（由调用方记台账 Failed）。
+     */
+    uploadObservation(bundleDir: string): Promise<{
+        status: string;
+        dir: string;
+    }>;
+}
+/** 哈希校验：下载的包文件重新计算 hash，与 manifest.hash 比对 */
+export declare function verifyHash(manifest: PkgManifest, files: Map<string, Uint8Array>): void;
+/** 本地 flows/ 目录中某 flow 的当前版本（读 flow.json 的 version 字段；不存在返回 undefined） */
+export declare function localFlowVersion(flowsDir: string, name: string): number | undefined;
+/** 流程包更新结果 */
+export interface PkgUpdateResult {
+    name: string;
+    /** up_to_date / updated / newer / not_a_flow / error */
+    status: string;
+    localVersion?: number;
+    platformVersion?: number;
+    hash: string;
+    dir?: string;
+    message?: string;
+}
+/**
+ * 执行 pkg_update：拉 manifest → 比版本 → 有更新下载 → 哈希校验 → 替换 flows/。
+ * 校验失败抛错（不落盘）。
+ */
+export declare function pkgUpdate(client: PlatformClient, flowsDir: string, name: string): Promise<PkgUpdateResult>;