@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/service/control.js

@@ -0,0 +1,117 @@
+/*
+ * 服务进程控制：pid 文件 + 跨进程停止。
+ * 只有 wellspring start 会写服务记录；wellspring stop 读取后发送 SIGTERM。
+ */
+import { join } from "node:path";
+import { readJsonIfExists, removePath, statIfExists, writeJsonAtomic } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+export class ServiceNotRunningError extends Error {
+    constructor() {
+        super("没有正在运行的 Wellspring 服务");
+        this.name = "ServiceNotRunningError";
+    }
+}
+export class ServiceAlreadyRunningError extends Error {
+    pid;
+    constructor(pid) {
+        super(`Wellspring 服务已在运行（pid ${pid}）`);
+        this.name = "ServiceAlreadyRunningError";
+        this.pid = pid;
+    }
+}
+export class ServiceStopTimeoutError extends Error {
+    pid;
+    constructor(pid) {
+        super(`等待服务退出超时（pid ${pid}）`);
+        this.name = "ServiceStopTimeoutError";
+        this.pid = pid;
+    }
+}
+export function serviceRecordFile(paths = getPaths()) {
+    return join(paths.dataDir, "service.json");
+}
+export async function readServiceRecord(paths = getPaths()) {
+    const value = await readJsonIfExists(serviceRecordFile(paths));
+    if (value === null ||
+        typeof value.pid !== "number" ||
+        !Number.isInteger(value.pid) ||
+        value.pid <= 0) {
+        return null;
+    }
+    return {
+        version: 1,
+        pid: value.pid,
+        startedAt: typeof value.startedAt === "string" ? value.startedAt : "",
+        cwd: typeof value.cwd === "string" ? value.cwd : "",
+    };
+}
+export async function writeServiceRecord(record, paths = getPaths()) {
+    await writeJsonAtomic(serviceRecordFile(paths), { version: 1, ...record });
+}
+/** 只清理属于指定 pid 的记录，避免误删后来的服务 */
+export async function clearServiceRecord(pid, paths = getPaths()) {
+    const current = await readServiceRecord(paths);
+    if (current !== null && current.pid !== pid) {
+        return;
+    }
+    await removePath(serviceRecordFile(paths));
+}
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ESRCH") {
+            return false;
+        }
+        return true;
+    }
+}
+/** 停止当前服务：SIGTERM → 轮询等待退出 → 清理 pid 文件 */
+export async function stopService(paths = getPaths(), options = {}) {
+    const record = await readServiceRecord(paths);
+    if (record === null) {
+        throw new ServiceNotRunningError();
+    }
+    if (!isProcessAlive(record.pid)) {
+        await clearServiceRecord(record.pid, paths);
+        throw new ServiceNotRunningError();
+    }
+    try {
+        process.kill(record.pid, "SIGTERM");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ESRCH") {
+            await clearServiceRecord(record.pid, paths);
+            throw new ServiceNotRunningError();
+        }
+        throw error;
+    }
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const pollMs = options.pollMs ?? 100;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+        if (!isProcessAlive(record.pid)) {
+            await clearServiceRecord(record.pid, paths);
+            return record.pid;
+        }
+    }
+    throw new ServiceStopTimeoutError(record.pid);
+}
+/** start 前检查：已有存活服务则报错，残留记录直接清掉 */
+export async function assertServiceStartable(paths = getPaths()) {
+    const record = await readServiceRecord(paths);
+    if (record === null) {
+        return;
+    }
+    if (isProcessAlive(record.pid)) {
+        throw new ServiceAlreadyRunningError(record.pid);
+    }
+    const shown = await statIfExists(serviceRecordFile(paths));
+    if (shown !== null) {
+        await clearServiceRecord(record.pid, paths);
+    }
+}
+//# sourceMappingURL=control.js.map

package/dist/service/control.js.map

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

package/dist/session/compress.d.ts

@@ -0,0 +1,3 @@
+import type { SessionEvent } from "./types.js";
+export declare function encodeEvents(events: readonly SessionEvent[]): Buffer;
+export declare function decodeEvents(data: Buffer): SessionEvent[];

package/dist/session/compress.js

@@ -0,0 +1,42 @@
+/*
+ * 会话段编解码。
+ * 每轮一个 zstd frame：解压后是 JSONL 事件流，一行一个事件。
+ */
+import { zstdCompressSync, zstdDecompressSync } from "node:zlib";
+export function encodeEvents(events) {
+    const text = `${events.map((event) => JSON.stringify(event)).join("\n")}\n`;
+    return zstdCompressSync(Buffer.from(text, "utf8"));
+}
+export function decodeEvents(data) {
+    let text;
+    try {
+        text = zstdDecompressSync(data).toString("utf8");
+    }
+    catch (error) {
+        throw new Error("会话段解压失败", { cause: error });
+    }
+    const events = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed === "") {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (error) {
+            throw new Error("会话段包含无法解析的行", { cause: error });
+        }
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            typeof parsed.type !== "string" ||
+            typeof parsed.seq !== "number" ||
+            typeof parsed.time !== "number") {
+            throw new Error("会话事件缺少 type/seq/time");
+        }
+        events.push(parsed);
+    }
+    return events;
+}
+//# sourceMappingURL=compress.js.map

package/dist/session/compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../src/session/compress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAIhE,MAAM,UAAU,YAAY,CAAC,MAA+B;IACxD,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IAC3E,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACD,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,MAAM,GAAmB,EAAE,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACjB,SAAQ;QACZ,CAAC;QACD,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACpD,CAAC;QACD,IACI,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ;YACvD,OAAQ,MAA4B,CAAC,GAAG,KAAK,QAAQ;YACrD,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ,EACzD,CAAC;YACC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAC3C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAsB,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/session/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./compress.js";
+export * from "./replay.js";
+export * from "./store.js";
+export * from "./types.js";

package/dist/session/index.js

@@ -0,0 +1,8 @@
+/*
+ * 会话层入口。
+ */
+export * from "./compress.js";
+export * from "./replay.js";
+export * from "./store.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/session/registry.d.ts

@@ -0,0 +1,4 @@
+import type { Session } from "./session.js";
+export declare function registerSession(session: Session): void;
+export declare function unregisterSession(id: string): void;
+export declare function getSession(id: string): Session | null;

package/dist/session/registry.js

@@ -0,0 +1,12 @@
+// 活跃会话注册表
+const sessions = new Map();
+export function registerSession(session) {
+    sessions.set(session.id, session);
+}
+export function unregisterSession(id) {
+    sessions.delete(id);
+}
+export function getSession(id) {
+    return sessions.get(id) ?? null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/session/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/session/registry.ts"],"names":[],"mappings":"AAAA,UAAU;AAIV,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;AAE3C,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC5C,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACjC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAA;AACnC,CAAC"}

package/dist/session/replay.d.ts

@@ -0,0 +1,10 @@
+import type { ChatCompletionMessageParam } from "openai/resources/chat/completions";
+import type { ContentPart, SessionEvent, SessionMode, SessionTurn } from "./types.js";
+export declare function contentText(parts: readonly ContentPart[] | undefined): string;
+/** 按 turn/start 分组；没有 turn 边界的事件归到当前组 */
+export declare function groupTurns(events: readonly SessionEvent[]): SessionTurn[];
+export declare function lastTurnNumber(events: readonly SessionEvent[]): number;
+export declare function lastSeq(events: readonly SessionEvent[]): number;
+/** 历史事件 → 模型消息；保留 assistant tool_calls 与 tool 结果 */
+export declare function toChatMessages(events: readonly SessionEvent[]): ChatCompletionMessageParam[];
+export declare function turnModeLabel(mode: SessionMode | null): string;

package/dist/session/replay.js

@@ -0,0 +1,109 @@
+/*
+ * 会话回放：把事件流还原成对话轮次与 Chat Completions 消息。
+ */
+export function contentText(parts) {
+    if (parts === undefined) {
+        return "";
+    }
+    let text = "";
+    for (const part of parts) {
+        if (part.type === "text") {
+            text += part.text;
+        }
+    }
+    return text;
+}
+function messageOf(event) {
+    const message = event.data["message"];
+    if (typeof message !== "object" || message === null) {
+        return null;
+    }
+    return message;
+}
+/** 按 turn/start 分组；没有 turn 边界的事件归到当前组 */
+export function groupTurns(events) {
+    const turns = [];
+    let current = null;
+    for (const event of events) {
+        if (event.type === "turn/start") {
+            const turn = typeof event.data["turn"] === "number" ? event.data["turn"] : turns.length + 1;
+            const mode = event.data["mode"] === "run" ? "run" : event.data["mode"] === "chat" ? "chat" : null;
+            current = { turn, mode, events: [] };
+            turns.push(current);
+        }
+        if (current === null) {
+            const turn = typeof event.data["turn"] === "number" ? event.data["turn"] : 1;
+            const mode = event.data["mode"] === "run" ? "run" : event.data["mode"] === "chat" ? "chat" : null;
+            current = { turn, mode, events: [] };
+            turns.push(current);
+        }
+        current.events.push(event);
+    }
+    return turns;
+}
+export function lastTurnNumber(events) {
+    let max = 0;
+    for (const event of events) {
+        const turn = event.data["turn"];
+        if (typeof turn === "number" && turn > max) {
+            max = turn;
+        }
+    }
+    return max;
+}
+export function lastSeq(events) {
+    let max = -1;
+    for (const event of events) {
+        if (event.seq > max) {
+            max = event.seq;
+        }
+    }
+    return max;
+}
+/** 历史事件 → 模型消息；保留 assistant tool_calls 与 tool 结果 */
+export function toChatMessages(events) {
+    const messages = [];
+    for (const event of events) {
+        if (event.type === "tool/result") {
+            const callId = event.data["callId"];
+            const content = event.data["content"];
+            if (typeof callId === "string" && typeof content === "string") {
+                messages.push({ role: "tool", tool_call_id: callId, content });
+            }
+            continue;
+        }
+        const message = messageOf(event);
+        if (message === null) {
+            continue;
+        }
+        const text = contentText(message.content);
+        if (event.type === "user/message" && message.role === "user") {
+            if (text !== "") {
+                messages.push({ role: "user", content: text });
+            }
+            continue;
+        }
+        if (event.type === "assistant/message" && message.role === "assistant") {
+            const toolCalls = message.content.filter((part) => part.type === "tool-call");
+            if (toolCalls.length > 0) {
+                messages.push({
+                    role: "assistant",
+                    content: text === "" ? null : text,
+                    tool_calls: toolCalls.map((call) => ({
+                        id: call.id,
+                        type: "function",
+                        function: { name: call.name, arguments: call.arguments },
+                    })),
+                });
+            }
+            else if (text !== "") {
+                messages.push({ role: "assistant", content: text });
+            }
+        }
+    }
+    return messages;
+}
+export function turnModeLabel(mode) {
+    return mode === "run" ? "run" : "chat";
+}
+//# sourceMappingURL=replay.js.map

package/dist/session/replay.js.map

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

package/dist/session/session.d.ts

@@ -0,0 +1,40 @@
+import type { SessionStore, SessionData } from "./store.js";
+import type { SessionMessageRecord } from "./types.js";
+import { Workspace } from "../workspace/index.js";
+export interface SessionMessageInput {
+    readonly sessionId: string;
+    readonly content: string | readonly string[];
+    readonly type?: string;
+}
+export declare class SessionMessage {
+    readonly sessionId: string;
+    readonly content: string[];
+    readonly type: string;
+    constructor(input: SessionMessageInput);
+}
+export declare class Session {
+    #private;
+    readonly id: string;
+    readonly type: string;
+    readonly metadata: Record<string, unknown>;
+    readonly workspace: Workspace;
+    readonly data: SessionData;
+    constructor(data: SessionData, store?: SessionStore | null);
+    /** Agent 循环开始后，消息进入队列而不是直接落盘 */
+    begin(): void;
+    /** 请求停止本轮：循环在下一步之前收尾，不再调用模型 */
+    requestStop(): void;
+    /** 本轮是否被要求停止 */
+    get stopRequested(): boolean;
+    end(): void;
+    /** 是否有一轮正在跑；插话只在这个窗口内有效 */
+    get active(): boolean;
+    /** 取走运行期排队的消息 */
+    take(): SessionMessage[];
+    get events(): import("./types.js").SessionEvent[];
+    get turns(): import("./types.js").SessionTurn[];
+    /** 发送消息并触发 onMessage */
+    message(content: string | readonly string[], type?: string): Promise<SessionMessage>;
+    toJSON(): Record<string, unknown>;
+}
+export type { SessionStore, SessionData, SessionMessageRecord };

package/dist/session/session.js

@@ -0,0 +1,108 @@
+// 会话门面：插件与宿主使用的 Session / SessionMessage
+import { randomUUID } from "node:crypto";
+import { emitOnMessage } from "../api/host/hooks.js";
+import { lastSeq, lastTurnNumber } from "./replay.js";
+import { Workspace } from "../workspace/index.js";
+export class SessionMessage {
+    sessionId;
+    content;
+    type;
+    constructor(input) {
+        this.sessionId = input.sessionId;
+        this.content = typeof input.content === "string" ? [input.content] : [...input.content];
+        this.type = input.type ?? "message";
+    }
+}
+export class Session {
+    id;
+    type;
+    metadata;
+    workspace;
+    data;
+    #store;
+    #queue = [];
+    #active = false;
+    #stopRequested = false;
+    constructor(data, store = null) {
+        this.data = data;
+        this.#store = store;
+        this.id = data.meta.id;
+        this.type = data.meta.type;
+        this.metadata = data.meta.metadata;
+        this.workspace = new Workspace(data.meta.workspace);
+    }
+    /** Agent 循环开始后，消息进入队列而不是直接落盘 */
+    begin() {
+        this.#active = true;
+        this.#stopRequested = false;
+    }
+    /** 请求停止本轮：循环在下一步之前收尾，不再调用模型 */
+    requestStop() {
+        this.#stopRequested = true;
+    }
+    /** 本轮是否被要求停止 */
+    get stopRequested() {
+        return this.#stopRequested;
+    }
+    end() {
+        this.#active = false;
+    }
+    /** 是否有一轮正在跑；插话只在这个窗口内有效 */
+    get active() {
+        return this.#active;
+    }
+    /** 取走运行期排队的消息 */
+    take() {
+        return this.#queue.splice(0);
+    }
+    get events() {
+        return this.data.events;
+    }
+    get turns() {
+        return this.data.turns;
+    }
+    /** 发送消息并触发 onMessage */
+    async message(content, type = "message") {
+        const message = new SessionMessage({ sessionId: this.id, content, type });
+        await emitOnMessage({
+            sessionId: this.id,
+            mode: "chat",
+            turn: lastTurnNumber(this.data.events) + 1,
+            role: "user",
+            phase: "before",
+            content: message.content.join(""),
+            prompt: [],
+        });
+        if (this.#active || this.#store === null) {
+            this.#queue.push(message);
+            return message;
+        }
+        const turn = lastTurnNumber(this.data.events) + 1;
+        await this.#store.appendTurn(this.data, [
+            {
+                type: "user/message",
+                seq: lastSeq(this.data.events) + 1,
+                time: Date.now(),
+                data: {
+                    turn,
+                    message: {
+                        role: "user",
+                        content: [{ type: "text", text: message.content.join("") }],
+                        source: { kind: "plugin", type: message.type },
+                        id: randomUUID(),
+                    },
+                },
+            },
+        ]);
+        return message;
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            type: this.type,
+            metadata: this.metadata,
+            workspace: this.workspace.root,
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/store.d.ts

@@ -0,0 +1,58 @@
+import type { SessionEvent, SessionHeader, SessionMeta, SessionTurn } from "./types.js";
+export declare class SessionNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare class SessionAmbiguousError extends Error {
+    constructor(id: string);
+}
+export declare class SessionLockedError extends Error {
+    constructor(id: string);
+}
+export interface SessionData {
+    readonly meta: SessionMeta;
+    readonly header: SessionHeader;
+    readonly dir: string;
+    events: SessionEvent[];
+    turns: SessionTurn[];
+}
+export interface SessionSummary {
+    readonly id: string;
+    readonly cwd: string;
+    readonly dir: string;
+    readonly turns: number;
+    readonly updatedAt: number;
+    readonly last: boolean;
+}
+export interface CreateSessionOptions {
+    readonly cwd: string;
+    readonly workspace?: string;
+    readonly model: string;
+    readonly id?: string;
+    readonly type?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface ListSessionsOptions {
+    readonly cwd: string;
+    readonly all?: boolean;
+    readonly limit?: number;
+}
+export declare function isValidSessionId(id: string): boolean;
+export declare function newSessionId(date?: Date): string;
+/** cwd → 桶目录名：<slug>-<sha256 前 8 位> */
+export declare function sessionBucket(cwd: string): string;
+export declare class SessionStore {
+    #private;
+    readonly root: string;
+    constructor(root?: string);
+    bucketDir(cwd: string): string;
+    lastId(cwd: string): Promise<string | null>;
+    create(options: CreateSessionOptions): Promise<SessionData>;
+    /** 打开当前 cwd 桶优先，其次其他桶；不存在抛 SessionNotFoundError */
+    open(id: string, cwd?: string): Promise<SessionData>;
+    /** 取最近一次会话；没有则创建 */
+    openLastOrCreate(cwd: string, model: string): Promise<SessionData>;
+    appendTurn(session: SessionData, events: readonly SessionEvent[]): Promise<number>;
+    list(options: ListSessionsOptions): Promise<SessionSummary[]>;
+    remove(id: string): Promise<void>;
+    removeAll(cwd: string): Promise<number>;
+}