dsh-pf-stream 0.0.0-stage → 0.1.2

package/lib/entry/legacyNormalizer.js

@@ -0,0 +1,86 @@
+/**
+ * 历史便捷字段归一化（《五、双层自适应调节与统一参数映射》§1.1）。
+ *
+ * 输入便利层：start_time/end_time/time_range/timestamps/fps/interval/num_frames/
+ * frame_count/crop/bbox/roi/probe_only → 标准 IntentDirective 字段。
+ * 判秒规则：数值 ≤ 时长（秒）×1.5 判秒，超过判毫秒；归一化来源记入 normalizedFrom。
+ */
+/** 数值或字符串时间 → 毫秒（判秒规则见模块注释）。 */
+export function toMs(value, durationMs) {
+    const n = typeof value === 'string' ? Number.parseFloat(value) : value;
+    if (!Number.isFinite(n))
+        throw new Error(`时间值无法解析：${String(value)}`);
+    const secThreshold = (durationMs / 1000) * 1.5;
+    const ms = n <= secThreshold ? n * 1000 : n;
+    return Math.round(ms);
+}
+function normalizeRoi(raw) {
+    const clamp01 = (v) => Math.min(Math.max(v, 0), 1);
+    return {
+        x: clamp01(raw.x),
+        y: clamp01(raw.y),
+        w: Math.min(Math.max(raw.w, 0), 1 - clamp01(raw.x)),
+        h: Math.min(Math.max(raw.h, 0), 1 - clamp01(raw.y)),
+    };
+}
+export function normalizeLegacyArgs(args, durationMs) {
+    const intent = {};
+    const normalizedFrom = [];
+    const has = (k) => Object.prototype.hasOwnProperty.call(args, k) && args[k] !== undefined;
+    if (has('start_time') || has('end_time') || has('time_range')) {
+        const start = has('start_time') ? toMs(args['start_time'], durationMs) : 0;
+        const end = has('end_time')
+            ? toMs(args['end_time'], durationMs)
+            : Math.max(start, durationMs);
+        intent.pts_window = [start, end];
+        normalizedFrom.push('start_time/end_time');
+    }
+    if (has('time_range') && Array.isArray(args['time_range']) && args['time_range'].length === 2) {
+        const [a, b] = args['time_range'];
+        if (a !== undefined && b !== undefined) {
+            intent.pts_window = [toMs(a, durationMs), toMs(b, durationMs)];
+            normalizedFrom.push('time_range');
+        }
+    }
+    if (has('timestamps') && Array.isArray(args['timestamps'])) {
+        intent.timestamps_ms = args['timestamps'].map((t) => toMs(t, durationMs));
+        intent.action = 'timestamps';
+        normalizedFrom.push('timestamps');
+    }
+    if (has('fps')) {
+        const fps = Number(args['fps']);
+        if (Number.isFinite(fps) && fps > 0) {
+            intent.interval_ms = Math.round(1000 / fps);
+            intent.action = 'uniform';
+            normalizedFrom.push('fps');
+        }
+    }
+    if (has('interval')) {
+        const iv = Number(args['interval']);
+        if (Number.isFinite(iv) && iv > 0) {
+            intent.interval_ms = toMs(iv, durationMs);
+            intent.action = 'uniform';
+            normalizedFrom.push('interval');
+        }
+    }
+    if (has('num_frames') || has('frame_count')) {
+        const fc = Number(args['num_frames'] ?? args['frame_count']);
+        if (Number.isFinite(fc) && fc >= 1) {
+            intent.frame_count = Math.min(Math.round(fc), 128);
+            if (intent.action == null)
+                intent.action = 'uniform';
+            normalizedFrom.push('num_frames/frame_count');
+        }
+    }
+    const roiRaw = (args['crop'] ?? args['bbox'] ?? args['roi']);
+    if (roiRaw && typeof roiRaw === 'object') {
+        intent.roi_hint = normalizeRoi(roiRaw);
+        normalizedFrom.push('crop/bbox/roi');
+    }
+    if (args['probe_only'] === true) {
+        intent.action = 'probe';
+        normalizedFrom.push('probe_only');
+    }
+    return { intent, normalizedFrom };
+}
+//# sourceMappingURL=legacyNormalizer.js.map

package/lib/entry/legacyNormalizer.js.map

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

package/lib/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 插件参数化错误。错误码命名空间：PFSTREAM_<模块>_<原因>。
+ */
+export declare class PfStreamError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}

package/lib/errors.js

@@ -0,0 +1,12 @@
+/**
+ * 插件参数化错误。错误码命名空间：PFSTREAM_<模块>_<原因>。
+ */
+export class PfStreamError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'PfStreamError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IADX,YACW,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/lib/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * dsh-pf-stream — DeepSeek Harness 视频感知插件入口。
+ *
+ * 统一 action 路由：动态流式采样（pf_stream）与内建确定性检视
+ * （probe / timestamps / uniform / RoI）共用主工具 dsh-pf-stream。
+ *
+ * 工具表稳定性（Prefix KV-Cache）：tools.register 在 apply 期一次装齐、
+ * dispose 期统一注销，运行中不增删。
+ */
+import Schema from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import type { PfStreamPluginConfig } from './types.js';
+import { type ToolCallArgs, type ToolExec, type ToolResult } from './tool/handler.js';
+export declare const name = "dsh-pf-stream";
+export declare const inject: string[];
+/** 56 MiB = 58,720,256 字节（含 8 MiB Base64 编码膨胀与协议结构预留）。 */
+export declare const DEFAULT_MAX_REQUEST_BYTES: number;
+export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
+    renderVisualId: Schema<boolean, boolean, "defined">;
+    maxPacketsPerCall: Schema<number, number, "defined">;
+    maxTokensBudgetPerCall: Schema<number, number, "defined">;
+    maxRequestBytes: Schema<number, number, "defined">;
+    maxColdRefs: Schema<number, number, "defined">;
+    telemetryEnabled: Schema<boolean, boolean, "defined">;
+    ffmpegPath: Schema<string, string, "plain">;
+    ffprobePath: Schema<string, string, "plain">;
+    tempDir: Schema<string, string, "plain">;
+    contentHashFallback: Schema<boolean, boolean, "defined">;
+    defaultStreamWindowMs: Schema<number, number, "defined">;
+    streamWorkMaxEdge: Schema<number, number, "defined">;
+    epochCompactionWindow: Schema<number, number, "defined">;
+    meteringProfile: Schema<Schemastery.ObjectS<NoInfer<{
+        superpixelPx: Schema<42, 42, "plain">;
+        rounding: Schema<"ceil", "ceil", "plain">;
+        maxTokensPerImage: Schema<number, number, "defined">;
+        maxImagesPerRequest: Schema<number, number, "defined">;
+        imageCountTiersEnabled: Schema<boolean, boolean, "defined">;
+        legacyModes: Schema<string[], string[], "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        superpixelPx: Schema<42, 42, "plain">;
+        rounding: Schema<"ceil", "ceil", "plain">;
+        maxTokensPerImage: Schema<number, number, "defined">;
+        maxImagesPerRequest: Schema<number, number, "defined">;
+        imageCountTiersEnabled: Schema<boolean, boolean, "defined">;
+        legacyModes: Schema<string[], string[], "defined">;
+    }>>, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    renderVisualId: Schema<boolean, boolean, "defined">;
+    maxPacketsPerCall: Schema<number, number, "defined">;
+    maxTokensBudgetPerCall: Schema<number, number, "defined">;
+    maxRequestBytes: Schema<number, number, "defined">;
+    maxColdRefs: Schema<number, number, "defined">;
+    telemetryEnabled: Schema<boolean, boolean, "defined">;
+    ffmpegPath: Schema<string, string, "plain">;
+    ffprobePath: Schema<string, string, "plain">;
+    tempDir: Schema<string, string, "plain">;
+    contentHashFallback: Schema<boolean, boolean, "defined">;
+    defaultStreamWindowMs: Schema<number, number, "defined">;
+    streamWorkMaxEdge: Schema<number, number, "defined">;
+    epochCompactionWindow: Schema<number, number, "defined">;
+    meteringProfile: Schema<Schemastery.ObjectS<NoInfer<{
+        superpixelPx: Schema<42, 42, "plain">;
+        rounding: Schema<"ceil", "ceil", "plain">;
+        maxTokensPerImage: Schema<number, number, "defined">;
+        maxImagesPerRequest: Schema<number, number, "defined">;
+        imageCountTiersEnabled: Schema<boolean, boolean, "defined">;
+        legacyModes: Schema<string[], string[], "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        superpixelPx: Schema<42, 42, "plain">;
+        rounding: Schema<"ceil", "ceil", "plain">;
+        maxTokensPerImage: Schema<number, number, "defined">;
+        maxImagesPerRequest: Schema<number, number, "defined">;
+        imageCountTiersEnabled: Schema<boolean, boolean, "defined">;
+        legacyModes: Schema<string[], string[], "defined">;
+    }>>, "plain">;
+}>>, "plain">;
+/** 流式单次调用阻塞上限：宿主死线减 40s 余量（超时协作式，signal 绝不硬终止）。 */
+export declare const TOOL_TIMEOUT_MS = 900000;
+export declare const SELF_MANAGED_BLOCK_CEILING_MS: number;
+/** 宿主 tools 服务；运行时由 inject=['tools'] 保证存在（类型未随 cordis 包发布）。 */
+export interface ToolsService {
+    register(definition: unknown): () => void;
+}
+/** 结构化宿主上下文：cordis Context 加 tools 服务。 */
+export type HostContext = Context & {
+    tools: ToolsService;
+};
+export declare function buildToolDefinition(_deps: {
+    ctx: HostContext;
+    config: PfStreamPluginConfig;
+}): {
+    name: string;
+    description: string;
+    parameters: Record<string, import("./tool/schema.js").ValueSchema>;
+    output: {
+        schema: {
+            readonly type: "object";
+        };
+        render: (_args: unknown, value: unknown) => {
+            type: "text";
+            text: string;
+        };
+    };
+    timeoutMs: number;
+    isConcurrencySafe: () => boolean;
+    execute(args: ToolCallArgs, exec: ToolExec | undefined): Promise<ToolResult>;
+};
+export declare function apply(ctx: Context, config: PfStreamPluginConfig): void;

package/lib/index.js

@@ -0,0 +1,109 @@
+/**
+ * dsh-pf-stream — DeepSeek Harness 视频感知插件入口。
+ *
+ * 统一 action 路由：动态流式采样（pf_stream）与内建确定性检视
+ * （probe / timestamps / uniform / RoI）共用主工具 dsh-pf-stream。
+ *
+ * 工具表稳定性（Prefix KV-Cache）：tools.register 在 apply 期一次装齐、
+ * dispose 期统一注销，运行中不增删。
+ */
+import Schema from '@deepseek-ai/schemastery';
+import { handleToolCall, } from './tool/handler.js';
+import { TOOL_NAME, TOOL_DESCRIPTION, toolOutputSchema, toolParameters } from './tool/schema.js';
+import { probeVideo } from './stage0/probe.js';
+import { runDeterministicInspection } from './stage3/deterministicRouter.js';
+import { runStreamCall } from './tool/streamCall.js';
+import { resolveBinPaths } from './utils/ffmpegBin.js';
+export const name = 'dsh-pf-stream';
+export const inject = ['tools', 'subprocess'];
+/** 56 MiB = 58,720,256 字节（含 8 MiB Base64 编码膨胀与协议结构预留）。 */
+export const DEFAULT_MAX_REQUEST_BYTES = 56 * 1024 * 1024;
+export const Config = Schema.object({
+    renderVisualId: Schema.boolean().default(true).description('渲染超像素微型反色角标'),
+    maxPacketsPerCall: Schema.number().default(64).description('单次调用画布包数上限'),
+    maxTokensBudgetPerCall: Schema.number().default(65536).description('单次调用视觉 Token 预算上限（intent.max_tokens_budget 受此钳制）'),
+    maxRequestBytes: Schema.number().default(DEFAULT_MAX_REQUEST_BYTES).description('请求字节软水位'),
+    maxColdRefs: Schema.number().default(4).description('冷区引用数量上限'),
+    telemetryEnabled: Schema.boolean().default(true).description('遥测开关'),
+    ffmpegPath: Schema.string().description('ffmpeg 可执行文件路径（缺省自动探测）'),
+    ffprobePath: Schema.string().description('ffprobe 可执行文件路径（缺省自动探测）'),
+    tempDir: Schema.string().description('临时目录（缺省系统临时目录）'),
+    contentHashFallback: Schema.boolean().default(false).description('内容哈希降级轨开关'),
+    defaultStreamWindowMs: Schema.number().default(10000).description('流式窗口缺省长度（毫秒）'),
+    streamWorkMaxEdge: Schema.number().default(2048).description('流式解码工作分辨率长边上限'),
+    epochCompactionWindow: Schema.number().default(6).description('热转冷批量收敛窗口（包数）'),
+    meteringProfile: Schema.object({
+        superpixelPx: Schema.const(42).description('超像素边长（像素）'),
+        rounding: Schema.const('ceil').description('计费序列长度取整方式'),
+        maxTokensPerImage: Schema.number().default(1024).description('单图视觉 Token 上限（v4.1 口径 1024；384 为 legacy 枚举位）'),
+        maxImagesPerRequest: Schema.number().default(600).description('单次请求图像张数上限（代际参数）'),
+        imageCountTiersEnabled: Schema.boolean().default(false).description('≥15 图单边 4096px 规则门控'),
+        legacyModes: Schema.array(String).default([]).description('legacy 计量口径枚举位'),
+    }),
+});
+/** 流式单次调用阻塞上限：宿主死线减 40s 余量（超时协作式，signal 绝不硬终止）。 */
+export const TOOL_TIMEOUT_MS = 900_000;
+export const SELF_MANAGED_BLOCK_CEILING_MS = TOOL_TIMEOUT_MS - 40_000;
+export function buildToolDefinition(_deps) {
+    const { config } = _deps;
+    const bins = resolveBinPaths({ ffmpegPath: config.ffmpegPath, ffprobePath: config.ffprobePath });
+    const probe = (videoPath, signal) => probeVideo(videoPath, { ffprobePath: bins.ffprobe, signal });
+    const inspect = (videoPath, probeResult, intent, signal) => runDeterministicInspection(videoPath, probeResult, intent, {
+        ffmpegPath: bins.ffmpeg,
+        renderVisualId: config.renderVisualId,
+        packetIdStart: 1,
+        globalIdStart: 1,
+        appliedIntentId: 'intent_1',
+        maxRequestBytes: config.maxRequestBytes,
+        maxTokensPerImage: config.meteringProfile.maxTokensPerImage,
+        signal,
+    });
+    const stream = (videoPath, probeResult, intent, sessionId, signal) => runStreamCall(videoPath, probeResult, intent, sessionId ?? 'default', {
+        ffmpegPath: bins.ffmpeg,
+        renderVisualId: config.renderVisualId,
+        defaultStreamWindowMs: config.defaultStreamWindowMs,
+        streamWorkMaxEdge: config.streamWorkMaxEdge,
+        maxPacketsPerCall: config.maxPacketsPerCall,
+        maxTokensBudgetPerCall: config.maxTokensBudgetPerCall,
+        maxRequestBytes: config.maxRequestBytes,
+        maxColdRefs: config.maxColdRefs,
+        epochCompactionWindow: config.epochCompactionWindow,
+        imageCountTiersEnabled: config.meteringProfile.imageCountTiersEnabled,
+        maxTokensPerImage: config.meteringProfile.maxTokensPerImage,
+        signal,
+    });
+    return {
+        name: TOOL_NAME,
+        description: TOOL_DESCRIPTION,
+        parameters: toolParameters,
+        output: {
+            schema: toolOutputSchema,
+            render: (_args, value) => ({
+                type: 'text',
+                text: JSON.stringify(value, null, 2),
+            }),
+        },
+        timeoutMs: TOOL_TIMEOUT_MS,
+        // 同一 (sessionId, videoKey) 的调用经 per-key promise 队列串行化，
+        // 会话级状态使并发不安全。
+        isConcurrencySafe: () => false,
+        async execute(args, exec) {
+            return handleToolCall(args, exec, { probe, inspect, stream });
+        },
+    };
+}
+export function apply(ctx, config) {
+    const host = ctx;
+    const dispose = host.tools.register(buildToolDefinition({ ctx: host, config }));
+    // register 返回的 disposer 为主注销路径；'dispose' 事件为兜底
+    // （经 events 服务注册，事件名不受 keyof Events 约束）。
+    ctx.events.on('dispose', () => {
+        try {
+            dispose();
+        }
+        catch {
+            // 卸载期清理失败不再抛出
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/session/state.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 会话状态（SessionState / StreamCursor / LRU 管理）。
+ *
+ * LRU 上限（2 个视频/会话）：每视频驻留状态约 1MB 量级
+ * （单槽位擂台图 ~450KB + 待发 P 队列），会话内存占用有界。
+ * M2 为进程内内存态；持久层（storageDomain）在 M4 接入（ADR-005）。
+ */
+import type { SessionIntent, SessionState, SessionVideoState, VideoFingerprint } from '../types.js';
+/** 视频指纹：规范化路径 + size + mtime 联合哈希前 16 hex。 */
+export declare function fingerprintOf(videoPath: string): VideoFingerprint;
+export declare function defaultSessionIntent(): SessionIntent;
+export declare function createSessionState(sessionId: string): SessionState;
+/** LRU 上限（会话内视频数）。 */
+export declare const VIDEO_LRU_LIMIT = 2;
+/** 取视频槽位（不存在则创建）；超过上限淘汰最旧未使用槽位。 */
+export declare function getVideoSlot(state: SessionState, fingerprint: VideoFingerprint): SessionVideoState;
+export declare function getSessionState(sessionId: string): SessionState;
+/** 测试辅助：清空进程内会话存储。 */
+export declare function resetMemorySessions(): void;
+/** 测试辅助：将重建的会话状态放回进程内存储（importSessionSnapshot 配套）。 */
+export declare function setMemorySession(state: SessionState): void;
+/** 导出会话快照（JSON 文本；Buffer 字段 base64 编码）。 */
+export declare function exportSessionSnapshot(state: SessionState): string;
+/** 从快照重建会话状态（exportSessionSnapshot 的逆操作）。 */
+export declare function importSessionSnapshot(json: string): SessionState;

package/lib/session/state.js

@@ -0,0 +1,255 @@
+/**
+ * 会话状态（SessionState / StreamCursor / LRU 管理）。
+ *
+ * LRU 上限（2 个视频/会话）：每视频驻留状态约 1MB 量级
+ * （单槽位擂台图 ~450KB + 待发 P 队列），会话内存占用有界。
+ * M2 为进程内内存态；持久层（storageDomain）在 M4 接入（ADR-005）。
+ */
+import { createHash } from 'node:crypto';
+import { statSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** 视频指纹：规范化路径 + size + mtime 联合哈希前 16 hex。 */
+export function fingerprintOf(videoPath) {
+    const normalizedPath = resolve(videoPath).replaceAll('\\', '/').toLowerCase();
+    const st = statSync(normalizedPath);
+    const digest = createHash('sha256')
+        .update(`${normalizedPath}|${st.size}|${Math.round(st.mtimeMs)}`)
+        .digest('hex');
+    return {
+        normalizedPath,
+        sizeBytes: st.size,
+        mtimeMs: Math.round(st.mtimeMs),
+        sha256Short: digest.slice(0, 16),
+    };
+}
+export function defaultSessionIntent() {
+    return { intentId: 'intent_0', mode: 'standard', focus: 'balanced', fullFrame: false };
+}
+export function createSessionState(sessionId) {
+    return {
+        sessionId,
+        intent: defaultSessionIntent(),
+        videos: new Map(),
+        fUnitCache: new Map(),
+        globalUnitSeq: 0,
+        packetSeq: 0,
+        intentSeq: 0,
+        ctrlSeq: new Map(),
+        heartbeatSeq: 0,
+    };
+}
+/** LRU 上限（会话内视频数）。 */
+export const VIDEO_LRU_LIMIT = 2;
+/** 取视频槽位（不存在则创建）；超过上限淘汰最旧未使用槽位。 */
+export function getVideoSlot(state, fingerprint) {
+    const key = fingerprint.sha256Short;
+    const existing = state.videos.get(key);
+    if (existing) {
+        // LRU 触达：移到 Map 尾部（最新）
+        state.videos.delete(key);
+        state.videos.set(key, existing);
+        return existing;
+    }
+    while (state.videos.size >= VIDEO_LRU_LIMIT) {
+        const oldest = state.videos.keys().next().value;
+        if (oldest == null)
+            break;
+        state.videos.delete(oldest);
+    }
+    const slot = {
+        cursor: {
+            fingerprint,
+            lastConsumedPtsMs: 0,
+            lastEmittedPacketPtsMs: null,
+            snapshot: {
+                state: 'STATIC',
+                enteredAtPtsMs: 0,
+                integratorA: 0,
+                gEma: 0,
+                emaWarmupLeft: 0,
+                settleStartPtsMs: null,
+                lastKCandidates: null,
+                lastMotionVec: null,
+                arena: null,
+            },
+            pendingPUnits: [],
+            lastAnchorF: null,
+        },
+        history: { packets: [] },
+        epoch: { pendingNew: 0, coldRefs: [] },
+    };
+    state.videos.set(key, slot);
+    return slot;
+}
+/** M2 进程内会话存储（key = sessionId）；M4 换 storageDomain 持久层。 */
+const memorySessions = new Map();
+export function getSessionState(sessionId) {
+    let state = memorySessions.get(sessionId);
+    if (!state) {
+        state = createSessionState(sessionId);
+        memorySessions.set(sessionId, state);
+    }
+    return state;
+}
+/** 测试辅助：清空进程内会话存储。 */
+export function resetMemorySessions() {
+    memorySessions.clear();
+}
+/** 测试辅助：将重建的会话状态放回进程内存储（importSessionSnapshot 配套）。 */
+export function setMemorySession(state) {
+    memorySessions.set(state.sessionId, state);
+}
+/** 导出会话快照（JSON 文本；Buffer 字段 base64 编码）。 */
+export function exportSessionSnapshot(state) {
+    const videos = [];
+    for (const [key, slot] of state.videos) {
+        const c = slot.cursor;
+        videos.push([
+            key,
+            {
+                fingerprint: c.fingerprint,
+                lastConsumedPtsMs: c.lastConsumedPtsMs,
+                lastEmittedPacketPtsMs: c.lastEmittedPacketPtsMs,
+                snapshot: {
+                    ...c.snapshot,
+                    arena: c.snapshot.arena == null
+                        ? null
+                        : {
+                            ptsMs: c.snapshot.arena.ptsMs,
+                            rho: c.snapshot.arena.rho,
+                            g: c.snapshot.arena.g,
+                            image672: c.snapshot.arena.image672.toString('base64'),
+                            sourceCropBbox: c.snapshot.arena.sourceCropBbox,
+                        },
+                },
+                pendingPUnits: c.pendingPUnits.map((p) => ({
+                    ptsMs: p.ptsMs,
+                    image336: p.image336.toString('base64'),
+                    sourceCropBbox: p.sourceCropBbox,
+                })),
+                lastAnchorF: c.lastAnchorF,
+                history: {
+                    packets: slot.history.packets.map((h) => ({
+                        packet: h.packet,
+                        imageBytes: h.imageBytes.toString('base64'),
+                        anchorBytes: h.anchorBytes ? h.anchorBytes.toString('base64') : null,
+                        anchorFContentHash: h.anchorFContentHash,
+                    })),
+                },
+                epoch: {
+                    pendingNew: slot.epoch.pendingNew,
+                    coldRefs: slot.epoch.coldRefs.map((r) => ({
+                        refPacketId: r.refPacketId,
+                        sourcePacketId: r.sourcePacketId,
+                        anchorFId: r.anchorFId,
+                        anchorFSha256: r.anchorFSha256,
+                        ptsMs: r.ptsMs,
+                        eventType: r.eventType,
+                        sourceCropBbox: r.sourceCropBbox,
+                        bytes: r.bytes.toString('base64'),
+                        contentHash: r.contentHash,
+                    })),
+                },
+            },
+        ]);
+    }
+    const doc = {
+        version: 1,
+        sessionId: state.sessionId,
+        intent: state.intent,
+        globalUnitSeq: state.globalUnitSeq,
+        packetSeq: state.packetSeq,
+        intentSeq: state.intentSeq,
+        heartbeatSeq: state.heartbeatSeq,
+        ctrlSeq: [...state.ctrlSeq.entries()],
+        fUnitCache: [...state.fUnitCache.values()].map((e) => ({
+            anchorFId: e.anchorFId,
+            packetId: e.packetId,
+            ptsMs: e.ptsMs,
+            independentBytes: e.independentBytes.toString('base64'),
+            anchorFSha256: e.anchorFSha256,
+            stripBytes: e.stripBytes?.toString('base64'),
+            stripSha256: e.stripSha256,
+            contentHash: e.contentHash,
+        })),
+        videos,
+    };
+    return JSON.stringify(doc);
+}
+/** 从快照重建会话状态（exportSessionSnapshot 的逆操作）。 */
+export function importSessionSnapshot(json) {
+    const doc = JSON.parse(json);
+    if (doc.version !== 1)
+        throw new Error(`不支持的会话快照版本：${doc.version}`);
+    const state = createSessionState(doc.sessionId);
+    state.intent = doc.intent;
+    state.globalUnitSeq = doc.globalUnitSeq;
+    state.packetSeq = doc.packetSeq;
+    state.intentSeq = doc.intentSeq;
+    state.heartbeatSeq = doc.heartbeatSeq;
+    state.ctrlSeq = new Map(doc.ctrlSeq);
+    state.fUnitCache = new Map(doc.fUnitCache.map((e) => [
+        e.anchorFId,
+        {
+            anchorFId: e.anchorFId,
+            packetId: e.packetId,
+            ptsMs: e.ptsMs,
+            independentBytes: Buffer.from(e.independentBytes, 'base64'),
+            anchorFSha256: e.anchorFSha256,
+            stripBytes: e.stripBytes != null ? Buffer.from(e.stripBytes, 'base64') : undefined,
+            stripSha256: e.stripSha256,
+            contentHash: e.contentHash,
+        },
+    ]));
+    for (const [key, v] of doc.videos) {
+        state.videos.set(key, {
+            cursor: {
+                fingerprint: v.fingerprint,
+                lastConsumedPtsMs: v.lastConsumedPtsMs,
+                lastEmittedPacketPtsMs: v.lastEmittedPacketPtsMs,
+                snapshot: {
+                    ...v.snapshot,
+                    arena: v.snapshot.arena == null
+                        ? null
+                        : {
+                            ptsMs: v.snapshot.arena.ptsMs,
+                            rho: v.snapshot.arena.rho,
+                            g: v.snapshot.arena.g,
+                            image672: Buffer.from(v.snapshot.arena.image672, 'base64'),
+                            sourceCropBbox: v.snapshot.arena.sourceCropBbox,
+                        },
+                },
+                pendingPUnits: v.pendingPUnits.map((p) => ({
+                    ptsMs: p.ptsMs,
+                    image336: Buffer.from(p.image336, 'base64'),
+                    sourceCropBbox: p.sourceCropBbox,
+                })),
+                lastAnchorF: v.lastAnchorF,
+            },
+            history: {
+                packets: v.history.packets.map((h) => ({
+                    packet: h.packet,
+                    imageBytes: Buffer.from(h.imageBytes, 'base64'),
+                    anchorBytes: h.anchorBytes != null ? Buffer.from(h.anchorBytes, 'base64') : null,
+                    anchorFContentHash: h.anchorFContentHash,
+                })),
+            },
+            epoch: {
+                pendingNew: v.epoch.pendingNew,
+                coldRefs: v.epoch.coldRefs.map((r) => ({
+                    refPacketId: r.refPacketId,
+                    sourcePacketId: r.sourcePacketId,
+                    anchorFId: r.anchorFId,
+                    anchorFSha256: r.anchorFSha256,
+                    ptsMs: r.ptsMs,
+                    eventType: r.eventType,
+                    sourceCropBbox: r.sourceCropBbox,
+                    bytes: Buffer.from(r.bytes, 'base64'),
+                    contentHash: r.contentHash,
+                })),
+            },
+        });
+    }
+    return state;
+}
+//# sourceMappingURL=state.js.map

package/lib/session/state.js.map

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