@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/session/store.js

@@ -0,0 +1,382 @@
+/*
+ * 会话存储。
+ * 路径：<dataDir>/sessions/<cwd桶>/<sessionId>/
+ *   session.json       元信息
+ *   .lock              写入锁
+ *   turns/NNNN.jsonl.zstd   每轮一个 zstd 段
+ * last.json 存在 cwd 桶目录下，记录该 cwd 的最近会话。
+ */
+import { createHash } from "node:crypto";
+import { realpathSync } from "node:fs";
+import { readdir, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { ensureDir, readBytesIfExists, readJsonIfExists, removePath, statIfExists, writeBytesAtomic, writeJsonAtomic, } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+import { decodeEvents, encodeEvents } from "./compress.js";
+import { groupTurns } from "./replay.js";
+const SESSION_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+const SEGMENT = /^(\d+)\.jsonl\.zstd$/;
+const LOCK_STALE_MS = 10 * 60 * 1000;
+const APP_NAME = "wellspring";
+const APP_VERSION = "1.0.0";
+export class SessionNotFoundError extends Error {
+    constructor(id) {
+        super(`会话不存在：${id}`);
+        this.name = "SessionNotFoundError";
+    }
+}
+export class SessionAmbiguousError extends Error {
+    constructor(id) {
+        super(`会话 id 在多个 cwd 桶中重复：${id}`);
+        this.name = "SessionAmbiguousError";
+    }
+}
+export class SessionLockedError extends Error {
+    constructor(id) {
+        super(`会话正在被其他进程写入：${id}`);
+        this.name = "SessionLockedError";
+    }
+}
+export function isValidSessionId(id) {
+    return SESSION_ID.test(id);
+}
+export function newSessionId(date = new Date()) {
+    const pad = (value) => String(value).padStart(2, "0");
+    const stamp = `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}` +
+        `-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+    const suffix = Math.floor(Math.random() * 0xffff)
+        .toString(16)
+        .padStart(4, "0");
+    return `${stamp}-${suffix}`;
+}
+function slugOf(name) {
+    const cleaned = name
+        .replace(/[^A-Za-z0-9._-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^[-.]+|[-.]+$/g, "");
+    return (cleaned === "" ? "root" : cleaned).slice(0, 32);
+}
+/** cwd → 桶目录名：<slug>-<sha256 前 8 位> */
+export function sessionBucket(cwd) {
+    let canonical = cwd;
+    try {
+        canonical = realpathSync(cwd);
+    }
+    catch {
+        canonical = resolve(cwd);
+    }
+    const hash = createHash("sha256").update(canonical).digest("hex").slice(0, 8);
+    return `${slugOf(basename(canonical))}-${hash}`;
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+export class SessionStore {
+    root;
+    constructor(root = join(getPaths().dataDir, "sessions")) {
+        this.root = root;
+    }
+    bucketDir(cwd) {
+        return join(this.root, sessionBucket(cwd));
+    }
+    async lastId(cwd) {
+        const last = await readJsonIfExists(join(this.bucketDir(cwd), "last.json"));
+        return typeof last?.id === "string" ? last.id : null;
+    }
+    async create(options) {
+        const id = options.id ?? newSessionId();
+        if (!isValidSessionId(id)) {
+            throw new Error(`会话 id 不合法：${id}`);
+        }
+        const dir = join(this.bucketDir(options.cwd), id);
+        const existing = await this.open(id, options.cwd).catch(() => null);
+        if (existing !== null) {
+            return existing;
+        }
+        const workspace = resolve(options.workspace ?? options.cwd);
+        const type = options.type ?? "session";
+        const metadata = options.metadata ?? {};
+        const meta = {
+            type,
+            version: 1,
+            id,
+            createdAt: Date.now(),
+            cwd: options.cwd,
+            workspace,
+            metadata,
+            app: APP_NAME,
+            appVersion: APP_VERSION,
+            model: options.model,
+        };
+        const header = { type, metadata, workspace };
+        await ensureDir(join(dir, "turns"));
+        await writeBytesAtomic(join(dir, "turns", "0000.jsonl.zstd"), encodeEvents([
+            {
+                type: "session/header",
+                seq: 0,
+                time: meta.createdAt,
+                data: { ...header },
+            },
+        ]));
+        await writeJsonAtomic(join(dir, "session.json"), meta);
+        await this.#writeLast(options.cwd, id);
+        return { meta, header, dir, events: [], turns: [] };
+    }
+    /** 打开当前 cwd 桶优先，其次其他桶；不存在抛 SessionNotFoundError */
+    async open(id, cwd) {
+        const dir = await this.#findDir(id, cwd);
+        const stored = await readJsonIfExists(join(dir, "session.json"));
+        if (stored === null || typeof stored.type !== "string" || stored.version !== 1) {
+            throw new Error(`会话元信息损坏：${id}`);
+        }
+        const header = (await this.#readHeader(dir)) ?? {
+            type: stored.type,
+            metadata: stored.metadata ?? {},
+            workspace: stored.workspace ?? stored.cwd,
+        };
+        const meta = {
+            ...stored,
+            type: header.type,
+            metadata: header.metadata,
+            workspace: header.workspace === "" ? (stored.workspace ?? stored.cwd) : header.workspace,
+        };
+        const events = await this.#readEvents(dir);
+        return { meta, header, dir, events, turns: groupTurns(events) };
+    }
+    /** 取最近一次会话；没有则创建 */
+    async openLastOrCreate(cwd, model) {
+        const last = await this.lastId(cwd);
+        if (last !== null) {
+            try {
+                return await this.open(last, cwd);
+            }
+            catch {
+                return await this.create({ cwd, model });
+            }
+        }
+        return await this.create({ cwd, model });
+    }
+    async appendTurn(session, events) {
+        if (events.length === 0) {
+            return session.turns.length;
+        }
+        const release = await this.#acquireLock(session.dir, session.meta.id);
+        try {
+            const turnsDir = join(session.dir, "turns");
+            await ensureDir(turnsDir);
+            const names = await readdir(turnsDir);
+            let max = 0;
+            for (const name of names) {
+                const match = SEGMENT.exec(name);
+                if (match !== null) {
+                    const index = Number(match[1]);
+                    if (index > max) {
+                        max = index;
+                    }
+                }
+            }
+            const next = max + 1;
+            const file = join(turnsDir, `${String(next).padStart(4, "0")}.jsonl.zstd`);
+            await writeBytesAtomic(file, encodeEvents(events));
+            await this.#writeLast(session.meta.cwd, session.meta.id);
+            session.events = [...session.events, ...events];
+            session.turns = groupTurns(session.events);
+            return next;
+        }
+        finally {
+            await release();
+        }
+    }
+    async list(options) {
+        const buckets = options.all === true ? await this.#bucketDirs() : [this.bucketDir(options.cwd)];
+        const summaries = [];
+        for (const bucket of buckets) {
+            const last = await readJsonIfExists(join(bucket, "last.json"));
+            const lastId = typeof last?.id === "string" ? last.id : null;
+            let names;
+            try {
+                names = await readdir(bucket);
+            }
+            catch {
+                continue;
+            }
+            for (const name of names) {
+                if (!isValidSessionId(name)) {
+                    continue;
+                }
+                const dir = join(bucket, name);
+                const meta = await readJsonIfExists(join(dir, "session.json"));
+                if (meta === null) {
+                    continue;
+                }
+                const segments = await this.#turnFiles(dir);
+                const lastFile = segments.length === 0
+                    ? null
+                    : await statIfExists(join(dir, "turns", segments[segments.length - 1] ?? ""));
+                summaries.push({
+                    id: meta.id,
+                    cwd: meta.cwd,
+                    dir,
+                    turns: segments.length,
+                    updatedAt: lastFile?.mtimeMs ?? meta.createdAt,
+                    last: lastId === meta.id,
+                });
+            }
+        }
+        summaries.sort((left, right) => right.updatedAt - left.updatedAt);
+        return options.limit === undefined ? summaries : summaries.slice(0, options.limit);
+    }
+    async remove(id) {
+        const dir = await this.#findDir(id);
+        const meta = await readJsonIfExists(join(dir, "session.json"));
+        await removePath(dir);
+        if (meta !== null) {
+            const last = await this.lastId(meta.cwd);
+            if (last === id) {
+                await removePath(join(this.bucketDir(meta.cwd), "last.json"));
+            }
+        }
+    }
+    async removeAll(cwd) {
+        const bucket = this.bucketDir(cwd);
+        let names;
+        try {
+            names = await readdir(bucket);
+        }
+        catch {
+            return 0;
+        }
+        let removed = 0;
+        for (const name of names) {
+            if (!isValidSessionId(name)) {
+                continue;
+            }
+            await removePath(join(bucket, name));
+            removed += 1;
+        }
+        await removePath(join(bucket, "last.json"));
+        return removed;
+    }
+    async #findDir(id, cwd) {
+        if (!isValidSessionId(id)) {
+            throw new Error(`会话 id 不合法：${id}`);
+        }
+        const candidates = [];
+        if (cwd !== undefined) {
+            candidates.push(this.bucketDir(cwd));
+        }
+        for (const bucket of await this.#bucketDirs()) {
+            if (!candidates.includes(bucket)) {
+                candidates.push(bucket);
+            }
+        }
+        const matches = [];
+        for (const bucket of candidates) {
+            const dir = join(bucket, id);
+            if ((await statIfExists(dir)) !== null) {
+                matches.push(dir);
+            }
+        }
+        if (matches.length === 0) {
+            throw new SessionNotFoundError(id);
+        }
+        if (matches.length > 1) {
+            throw new SessionAmbiguousError(id);
+        }
+        return matches[0];
+    }
+    async #bucketDirs() {
+        let names;
+        try {
+            names = await readdir(this.root, { withFileTypes: true }).then((entries) => entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+        }
+        catch {
+            return [];
+        }
+        return names.sort().map((name) => join(this.root, name));
+    }
+    async #turnFiles(dir) {
+        try {
+            const names = await readdir(join(dir, "turns"));
+            return names
+                .filter((name) => SEGMENT.test(name) && name !== "0000.jsonl.zstd")
+                .sort((left, right) => Number(SEGMENT.exec(left)?.[1]) - Number(SEGMENT.exec(right)?.[1]));
+        }
+        catch {
+            return [];
+        }
+    }
+    async #readHeader(dir) {
+        const data = await readBytesIfExists(join(dir, "turns", "0000.jsonl.zstd"));
+        if (data === null) {
+            return null;
+        }
+        const event = decodeEvents(data).find((item) => item.type === "session/header");
+        if (event === undefined) {
+            return null;
+        }
+        const type = event.data["type"];
+        const metadata = event.data["metadata"];
+        const workspace = event.data["workspace"];
+        return {
+            type: typeof type === "string" ? type : "session",
+            metadata: typeof metadata === "object" && metadata !== null && !Array.isArray(metadata)
+                ? metadata
+                : {},
+            workspace: typeof workspace === "string" ? workspace : "",
+        };
+    }
+    async #readEvents(dir) {
+        const files = await this.#turnFiles(dir);
+        const events = [];
+        for (const name of files) {
+            const data = await readBytesIfExists(join(dir, "turns", name));
+            if (data === null) {
+                continue;
+            }
+            events.push(...decodeEvents(data));
+        }
+        return events;
+    }
+    async #writeLast(cwd, id) {
+        await writeJsonAtomic(join(this.bucketDir(cwd), "last.json"), {
+            id,
+            updatedAt: Date.now(),
+        });
+    }
+    async #acquireLock(dir, id) {
+        const lock = join(dir, ".lock");
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            try {
+                await writeFile(lock, JSON.stringify({ pid: process.pid, acquiredAt: Date.now() }), { flag: "wx", mode: 0o600 });
+                return async () => {
+                    await removePath(lock);
+                };
+            }
+            catch (error) {
+                if (error.code !== "EEXIST") {
+                    throw error;
+                }
+                const info = await statIfExists(lock);
+                if (info === null) {
+                    continue;
+                }
+                const content = await readJsonIfExists(lock);
+                const pid = typeof content?.pid === "number" ? content.pid : null;
+                const stale = Date.now() - info.mtimeMs > LOCK_STALE_MS || pid === null || !isPidAlive(pid);
+                if (!stale) {
+                    throw new SessionLockedError(id);
+                }
+                await removePath(lock);
+            }
+        }
+        throw new SessionLockedError(id);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,56 @@
+/** 会话模型：参考 DeepSeekHarness session.v4，按轮分段的 JSONL 事件流 */
+export type SessionMode = "chat" | "run";
+export interface SessionHeader {
+    readonly type: string;
+    readonly metadata: Record<string, unknown>;
+    readonly workspace: string;
+}
+export interface SessionMeta {
+    readonly type: string;
+    readonly version: 1;
+    readonly id: string;
+    readonly createdAt: number;
+    readonly cwd: string;
+    readonly workspace: string;
+    readonly metadata: Record<string, unknown>;
+    readonly app: string;
+    readonly appVersion: string;
+    readonly model: string;
+    readonly title?: string;
+}
+export type ContentPart = {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "reasoning";
+    readonly text: string;
+} | {
+    readonly type: "tool-call";
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+};
+export interface SessionMessageRecord {
+    readonly role: "user" | "assistant" | "system" | "tool";
+    readonly content: readonly ContentPart[];
+    readonly source?: Record<string, unknown>;
+    readonly id?: string;
+    readonly toolCallId?: string;
+}
+/** 规范化后的流式片段 */
+export interface StreamChunkRecord {
+    readonly type: "chunk";
+    readonly time: number;
+    readonly chunk: Record<string, unknown>;
+}
+export interface SessionEvent {
+    readonly type: string;
+    readonly seq: number;
+    readonly time: number;
+    readonly data: Record<string, unknown>;
+}
+export interface SessionTurn {
+    readonly turn: number;
+    readonly mode: SessionMode | null;
+    readonly events: SessionEvent[];
+}

package/dist/session/types.js

@@ -0,0 +1,3 @@
+/** 会话模型：参考 DeepSeekHarness session.v4，按轮分段的 JSONL 事件流 */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,yDAAyD"}

package/dist/workspace/index.d.ts

@@ -0,0 +1,7 @@
+export declare class Workspace {
+    readonly root: string;
+    readonly name: string;
+    constructor(root: string);
+    static open(path?: string): Workspace;
+    equals(other: Workspace): boolean;
+}

package/dist/workspace/index.js

@@ -0,0 +1,17 @@
+// 工作区：会话与 Agent 工具的文件边界
+import { basename, resolve } from "node:path";
+export class Workspace {
+    root;
+    name;
+    constructor(root) {
+        this.root = resolve(root);
+        this.name = basename(this.root);
+    }
+    static open(path = process.cwd()) {
+        return new Workspace(path);
+    }
+    equals(other) {
+        return this.root === other.root;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,OAAO,SAAS;IACT,IAAI,CAAQ;IACZ,IAAI,CAAQ;IAErB,YAAY,IAAY;QACpB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,CAAC,KAAgB;QACnB,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAA;IACnC,CAAC;CACJ"}

package/dist/workspace/registry.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedPaths } from "../platform/path.js";
+import type { HostWorkspaceAddResult, HostWorkspaceEntry, HostWorkspaceListResult } from "../api/host/workspace.js";
+export declare const MAX_WORKSPACES = 40;
+export declare const MAX_WORKSPACE_NAME_CHARS = 60;
+export declare const WORKSPACE_ID: RegExp;
+export declare function workspaceRegistryFile(paths?: ResolvedPaths): string;
+export declare function legacyWorkspaceRegistryFile(paths?: ResolvedPaths): string;
+/** 由工作目录派生稳定 id（与旧版 wellspring-web 的算法一致，保证会话目录还能对上） */
+export declare function workspaceIdFor(root: string): string;
+export declare function normalizeWorkspaceName(value: unknown): string | null;
+/** 解析注册表文件；接受 { v, workspaces } 与旧版纯数组，非法条目忽略 */
+export declare function parseWorkspaceEntries(value: unknown): HostWorkspaceEntry[];
+/** 宿主内部：重置内存里的注册表（测试 / 重新配置路径时用） */
+export declare function resetWorkspaceRegistry(paths?: ResolvedPaths): void;
+export declare function listWorkspaces(paths?: ResolvedPaths): Promise<HostWorkspaceListResult>;
+/** root 必须是已存在的目录；重复添加返回已有记录并刷新 lastSeenAt */
+export declare function addWorkspace(options: {
+    readonly root: string;
+    readonly name?: string;
+}, paths?: ResolvedPaths): Promise<HostWorkspaceAddResult>;
+export declare function removeWorkspace(id: string, paths?: ResolvedPaths): Promise<{
+    readonly removed: boolean;
+}>;
+export declare function renameWorkspace(id: string, name: string, paths?: ResolvedPaths): Promise<HostWorkspaceEntry | null>;
+export declare function touchWorkspace(id: string, paths?: ResolvedPaths): Promise<HostWorkspaceEntry | null>;