@qlingzzy/qling 1.0.0

package/dist/session/daemon-session-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-session-api.d.ts","sourceRoot":"","sources":["../../src/session/daemon-session-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,OAAO,CAAC,EAAE,MAAM;IAQtB,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;QAC1B,MAAM,EAAE,QAAQ,CAAC;KAClB,GACA,OAAO,CAAC,WAAW,CAAC;IAKjB,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,gBAAgB,CAAC;IAQtB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKvD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAK5D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKxD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQvE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAUzD"}

package/dist/session/daemon-session-api.js

@@ -0,0 +1,48 @@
+import axios from "axios";
+export class DaemonSessionApi {
+    client;
+    constructor(baseUrl) {
+        const port = process.env.QLING_DAEMON_PORT || "9998";
+        this.client = axios.create({
+            baseURL: baseUrl ?? `http://127.0.0.1:${port}`,
+            timeout: 3_000,
+        });
+    }
+    async createLoopTask(sessionId, payload) {
+        const response = await this.client.post(`/sessions/${encodeURIComponent(sessionId)}/loop-tasks`, payload);
+        return response.data;
+    }
+    async setGoal(sessionId, condition, stats) {
+        const response = await this.client.post(`/sessions/${encodeURIComponent(sessionId)}/goal`, {
+            condition,
+            stats,
+        });
+        return response.data;
+    }
+    async clearGoal(sessionId) {
+        const response = await this.client.post(`/sessions/${encodeURIComponent(sessionId)}/goal/clear`, {});
+        return response.data;
+    }
+    async getGoal(sessionId) {
+        const response = await this.client.get(`/sessions/${encodeURIComponent(sessionId)}/goal`);
+        return response.data;
+    }
+    async listLoopTasks(sessionId) {
+        const response = await this.client.get(`/sessions/${encodeURIComponent(sessionId)}/loop-tasks`);
+        return response.data ?? [];
+    }
+    async cancelLoopTask(sessionId, taskId) {
+        const response = await this.client.post(`/sessions/${encodeURIComponent(sessionId)}/loop-tasks/${encodeURIComponent(taskId)}/cancel`, {});
+        return response.data;
+    }
+    async clearLoopTasks(sessionId) {
+        const tasks = await this.listLoopTasks(sessionId);
+        const active = tasks.filter((task) => task.status === "active" || task.status === "running");
+        let count = 0;
+        for (const task of active) {
+            await this.cancelLoopTask(sessionId, task.id);
+            count += 1;
+        }
+        return count;
+    }
+}

package/dist/session/durable-session-supervisor.d.ts

@@ -0,0 +1,24 @@
+export interface DurableSessionSupervisorOptions {
+    stateDir: string;
+    tickIntervalMs?: number;
+    log?: (message: string) => void;
+}
+export declare class DurableSessionSupervisor {
+    private readonly stateDir;
+    private readonly tickIntervalMs;
+    private readonly log;
+    private readonly runningSessions;
+    private timer;
+    private ticking;
+    constructor(options: DurableSessionSupervisorOptions);
+    start(): void;
+    stop(): Promise<void>;
+    private tick;
+    private collectSessionIds;
+    private tryRunDurableGoal;
+    private tryRunDurableLoopTasks;
+    private runDurableGoal;
+    private executePromptTurn;
+    private createAgent;
+}
+//# sourceMappingURL=durable-session-supervisor.d.ts.map

package/dist/session/durable-session-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-session-supervisor.d.ts","sourceRoot":"","sources":["../../src/session/durable-session-supervisor.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,+BAA+B;IAMpD,KAAK,IAAI,IAAI;IAQP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,IAAI;YAoBJ,iBAAiB;YAcjB,iBAAiB;YAiBjB,sBAAsB;YA+BtB,cAAc;YAoCd,iBAAiB;YAyBjB,WAAW;CA+B1B"}

package/dist/session/durable-session-supervisor.js

@@ -0,0 +1,195 @@
+import * as fs from "fs/promises";
+import { existsSync } from "fs";
+import * as path from "path";
+import { AgentLoop } from "../agent-loop.js";
+import { applyConfigToProcessEnv, loadQlingConfig } from "../config.js";
+import { buildToolRegistry } from "../tools/index.js";
+import { SessionGoalController } from "./goal-controller.js";
+import { SessionGoalManager } from "./session-goal-manager.js";
+import { SessionScheduler } from "./session-scheduler.js";
+export class DurableSessionSupervisor {
+    stateDir;
+    tickIntervalMs;
+    log;
+    runningSessions = new Set();
+    timer = null;
+    ticking = false;
+    constructor(options) {
+        this.stateDir = options.stateDir;
+        this.tickIntervalMs = options.tickIntervalMs ?? 1_000;
+        this.log = options.log ?? (() => { });
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, this.tickIntervalMs);
+        void this.tick();
+    }
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async tick() {
+        if (this.ticking)
+            return;
+        this.ticking = true;
+        try {
+            const sessionIds = await this.collectSessionIds();
+            for (const sessionId of sessionIds) {
+                if (this.runningSessions.has(sessionId)) {
+                    continue;
+                }
+                const handledGoal = await this.tryRunDurableGoal(sessionId);
+                if (handledGoal) {
+                    continue;
+                }
+                await this.tryRunDurableLoopTasks(sessionId);
+            }
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+    async collectSessionIds() {
+        const sessionIds = new Set();
+        for (const dirName of ["session-goals", "session-tasks"]) {
+            const dirPath = path.join(this.stateDir, dirName);
+            if (!existsSync(dirPath))
+                continue;
+            const files = await fs.readdir(dirPath);
+            for (const file of files) {
+                if (!file.endsWith(".json"))
+                    continue;
+                sessionIds.add(path.basename(file, ".json"));
+            }
+        }
+        return Array.from(sessionIds.values()).sort();
+    }
+    async tryRunDurableGoal(sessionId) {
+        const manager = new SessionGoalManager({ stateDir: this.stateDir, sessionId });
+        await manager.init();
+        const goal = await manager.getGoalStatus();
+        if (!goal || goal.status !== "active" || goal.runner !== "daemon" || !goal.pending) {
+            return false;
+        }
+        this.runningSessions.add(sessionId);
+        try {
+            await this.runDurableGoal(sessionId);
+        }
+        finally {
+            this.runningSessions.delete(sessionId);
+        }
+        return true;
+    }
+    async tryRunDurableLoopTasks(sessionId) {
+        const scheduler = new SessionScheduler({
+            stateDir: this.stateDir,
+            sessionId,
+            runner: "daemon",
+            onDue: async (task) => {
+                await this.executePromptTurn(sessionId, task.prompt);
+            },
+        });
+        await scheduler.init();
+        const tasks = await scheduler.listTasks();
+        const now = Date.now();
+        const hasDue = tasks.some((task) => task.runner === "daemon" &&
+            task.status !== "canceled" &&
+            task.status !== "completed" &&
+            (task.pending || task.nextRunAt <= now));
+        if (!hasDue) {
+            return false;
+        }
+        this.runningSessions.add(sessionId);
+        try {
+            await scheduler.runDueTasksOnce();
+        }
+        finally {
+            this.runningSessions.delete(sessionId);
+        }
+        return true;
+    }
+    async runDurableGoal(sessionId) {
+        const manager = new SessionGoalManager({ stateDir: this.stateDir, sessionId });
+        const controller = new SessionGoalController({
+            manager,
+            runner: "daemon",
+        });
+        await controller.init();
+        let goal = await controller.getGoalStatus();
+        if (!goal || goal.status !== "active" || goal.runner !== "daemon") {
+            return;
+        }
+        let prompt = goal.evaluatedTurns > 0 && goal.lastReason
+            ? controller.buildContinuationPrompt(goal.condition, goal.lastReason)
+            : controller.buildInitialPrompt(goal.condition);
+        while (goal && goal.status === "active") {
+            const turn = await this.executePromptTurn(sessionId, prompt);
+            const outcome = await controller.afterTurn({
+                transcript: SessionGoalController.messagesToTranscript(turn.messages),
+                stats: {
+                    turnCount: turn.stats.turnCount,
+                    tokens: turn.stats.tokens,
+                },
+            });
+            if (outcome.status === "continue" && outcome.continuePrompt) {
+                prompt = outcome.continuePrompt;
+                goal = await controller.getGoalStatus();
+                continue;
+            }
+            return;
+        }
+    }
+    async executePromptTurn(sessionId, prompt) {
+        const agent = await this.createAgent();
+        try {
+            const restored = await agent.restoreSession(sessionId);
+            if (!restored) {
+                throw new Error(`session snapshot not found: ${sessionId}`);
+            }
+            agent.addUserMessage(prompt);
+            await agent.run();
+            await agent.checkpointSession();
+            return {
+                messages: agent.getMessagesSnapshot(),
+                stats: agent.getSessionStats(),
+            };
+        }
+        finally {
+            await agent.shutdown();
+        }
+    }
+    async createAgent() {
+        const { config } = await loadQlingConfig({});
+        applyConfigToProcessEnv(config);
+        const staticEnabled = {};
+        for (const [name, cfg] of Object.entries(config.tools)) {
+            staticEnabled[name] = cfg.enabled;
+        }
+        const tools = buildToolRegistry({ staticEnabled });
+        const agent = new AgentLoop({
+            apiKey: config.llm.api_key || process.env.QLING_LLM_API_KEY || "",
+            provider: config.llm.provider,
+            endpoint: config.llm.endpoint,
+            model: config.llm.model,
+            maxIterations: config.runtime.max_steps,
+            tools,
+            runtime: {
+                workspaceDir: config.runtime.workspace_dir || process.cwd(),
+                fileCacheDir: config.runtime.file_cache_dir,
+                fileStateDir: this.stateDir,
+                maxSteps: config.runtime.max_steps,
+                parseRetries: config.runtime.parse_retries,
+                maxTokenBudget: config.runtime.max_token_budget,
+                toolRepeatLimit: config.runtime.tool_repeat_limit,
+                timeoutMs: config.runtime.timeout_ms,
+            },
+        });
+        await agent.waitForInit();
+        return agent;
+    }
+}

package/dist/session/goal-controller.d.ts

@@ -0,0 +1,43 @@
+import { Message } from "../types.js";
+import { GoalEvaluator } from "./goal-evaluator.js";
+import { SessionGoalManager, type SessionGoalRunner, type SessionGoalState } from "./session-goal-manager.js";
+export interface GoalControllerAfterTurnInput {
+    transcript: string;
+    stats: {
+        turnCount: number;
+        tokens: number;
+    };
+}
+export interface GoalControllerAfterTurnResult {
+    status: "idle" | "continue" | "achieved" | "cleared";
+    reason: string | null;
+    continuePrompt: string | null;
+}
+export interface SessionGoalControllerOptions {
+    manager: SessionGoalManager;
+    evaluator?: Pick<GoalEvaluator, "evaluate">;
+    maxAutoTurns?: number;
+    runner?: SessionGoalRunner;
+}
+export declare class SessionGoalController {
+    private readonly manager;
+    private readonly evaluator;
+    private readonly maxAutoTurns;
+    private readonly runner;
+    constructor(options: SessionGoalControllerOptions);
+    init(): Promise<void>;
+    setGoal(condition: string, stats: {
+        turnCount: number;
+        tokens: number;
+    }, options?: {
+        runner?: SessionGoalRunner;
+        pending?: boolean;
+    }): Promise<SessionGoalState>;
+    clearGoal(reason: string): Promise<SessionGoalState>;
+    getGoalStatus(): Promise<SessionGoalState | null>;
+    buildInitialPrompt(condition: string): string;
+    buildContinuationPrompt(condition: string, reason: string): string;
+    afterTurn(input: GoalControllerAfterTurnInput): Promise<GoalControllerAfterTurnResult>;
+    static messagesToTranscript(messages: Message[]): string;
+}
+//# sourceMappingURL=goal-controller.d.ts.map

package/dist/session/goal-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-controller.d.ts","sourceRoot":"","sources":["../../src/session/goal-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE9G,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,OAAO,EAAE,4BAA4B;IAO3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC5C,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9D,OAAO,CAAC,gBAAgB,CAAC;IAOtB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIpD,aAAa,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAIvD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI5D,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA2C5F,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAMzD"}

package/dist/session/goal-controller.js

@@ -0,0 +1,77 @@
+import { GoalEvaluator } from "./goal-evaluator.js";
+export class SessionGoalController {
+    manager;
+    evaluator;
+    maxAutoTurns;
+    runner;
+    constructor(options) {
+        this.manager = options.manager;
+        this.evaluator = options.evaluator ?? new GoalEvaluator();
+        this.maxAutoTurns = options.maxAutoTurns ?? Number(process.env.QLING_GOAL_MAX_AUTO_TURNS ?? "12");
+        this.runner = options.runner ?? "session";
+    }
+    async init() {
+        await this.manager.init();
+    }
+    async setGoal(condition, stats, options = {}) {
+        return this.manager.setGoal(condition, stats, {
+            runner: options.runner ?? this.runner,
+            pending: options.pending ?? false,
+        });
+    }
+    async clearGoal(reason) {
+        return this.manager.clearGoal(reason);
+    }
+    async getGoalStatus() {
+        return this.manager.getGoalStatus();
+    }
+    buildInitialPrompt(condition) {
+        return `当前激活目标条件：${condition}\n请立即开始工作，直到条件满足。每轮都优先做最有效的下一步，并把可验证证据写入对话。`;
+    }
+    buildContinuationPrompt(condition, reason) {
+        return `目标条件：${condition}\n上一轮 goal 评估：${reason}\n请继续推进，优先执行最有效的下一步，并把可验证证据写入对话。`;
+    }
+    async afterTurn(input) {
+        const active = this.manager.getActiveGoal(this.runner);
+        if (!active) {
+            return { status: "idle", reason: null, continuePrompt: null };
+        }
+        const autoTurnsSpent = Math.max(0, input.stats.turnCount - active.baselineTurns);
+        if (autoTurnsSpent > this.maxAutoTurns) {
+            const cleared = await this.manager.clearGoal(`max auto turns reached (${this.maxAutoTurns})`);
+            return {
+                status: "cleared",
+                reason: cleared.lastReason,
+                continuePrompt: null,
+            };
+        }
+        const evaluation = await this.evaluator.evaluate({
+            condition: active.condition,
+            transcript: input.transcript,
+        });
+        const updated = await this.manager.markEvaluation({
+            done: evaluation.done,
+            reason: evaluation.reason,
+            turnCount: input.stats.turnCount,
+            tokens: input.stats.tokens,
+        });
+        if (evaluation.done) {
+            return {
+                status: "achieved",
+                reason: updated.lastReason,
+                continuePrompt: null,
+            };
+        }
+        return {
+            status: "continue",
+            reason: updated.lastReason,
+            continuePrompt: this.buildContinuationPrompt(updated.condition, updated.lastReason ?? "条件未满足"),
+        };
+    }
+    static messagesToTranscript(messages) {
+        return messages
+            .slice(-40)
+            .map((message) => `${message.role}: ${message.content}`)
+            .join("\n\n");
+    }
+}

package/dist/session/goal-evaluator.d.ts

@@ -0,0 +1,29 @@
+type GoalFetch = typeof fetch;
+export interface GoalEvaluationResult {
+    done: boolean;
+    reason: string;
+}
+export interface GoalEvaluatorOptions {
+    provider?: string;
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    timeoutMs?: number;
+    fetchImpl?: GoalFetch;
+}
+export declare class GoalEvaluator {
+    private readonly provider;
+    private readonly endpoint;
+    private readonly apiKey;
+    private readonly model;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options?: GoalEvaluatorOptions);
+    evaluate(input: {
+        condition: string;
+        transcript: string;
+    }): Promise<GoalEvaluationResult>;
+    parse(raw: string): GoalEvaluationResult;
+}
+export {};
+//# sourceMappingURL=goal-evaluator.d.ts.map

package/dist/session/goal-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-evaluator.d.ts","sourceRoot":"","sources":["../../src/session/goal-evaluator.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AAE9B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AA0BD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,GAAE,oBAAyB;IAcxC,QAAQ,CAAC,KAAK,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+CjC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB;CAczC"}

package/dist/session/goal-evaluator.js

@@ -0,0 +1,100 @@
+const GOAL_EVALUATION_PROMPT = `你是轻灵的 Goal Evaluator。
+
+任务：判断给定的目标条件是否已经被对话中的证据满足。
+
+约束：
+1. 只能基于 transcript 中已经出现的内容判断，不能假设工具已经成功运行。
+2. 如果证据不足，必须返回 done=false。
+3. 输出必须是严格 JSON，禁止额外文本。
+
+输出格式：
+{"done":true,"reason":"一句话理由"}
+或
+{"done":false,"reason":"一句话理由"}`;
+function resolveChatEndpoint(endpoint) {
+    return endpoint.endsWith("/chat/completions")
+        ? endpoint
+        : endpoint.replace(/\/$/, "") + "/chat/completions";
+}
+function stripCodeFences(text) {
+    return text.trim().replace(/^```json\s*/i, "").replace(/^```\s*/i, "").replace(/```$/, "").trim();
+}
+export class GoalEvaluator {
+    provider;
+    endpoint;
+    apiKey;
+    model;
+    timeoutMs;
+    fetchImpl;
+    constructor(options = {}) {
+        this.provider = options.provider ?? process.env.QLING_GOAL_EVALUATOR_PROVIDER ?? process.env.QLING_LLM_PROVIDER ?? "deepseek";
+        const endpoint = options.endpoint ??
+            process.env.QLING_GOAL_EVALUATOR_ENDPOINT ??
+            process.env.QLING_LLM_ENDPOINT ??
+            (this.provider === "openai" ? "https://api.openai.com/v1" : "https://api.deepseek.com");
+        this.endpoint = resolveChatEndpoint(endpoint);
+        this.apiKey = options.apiKey ?? process.env.QLING_GOAL_EVALUATOR_API_KEY ?? process.env.QLING_LLM_API_KEY ?? "";
+        this.model = options.model ?? process.env.QLING_GOAL_EVALUATOR_MODEL ?? process.env.QLING_LLM_MODEL ?? "deepseek-chat";
+        this.timeoutMs = options.timeoutMs ?? Number(process.env.QLING_GOAL_EVALUATOR_TIMEOUT_MS ?? "30000");
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    async evaluate(input) {
+        if (!this.apiKey && this.provider !== "local") {
+            return {
+                done: false,
+                reason: "goal evaluator 缺少 API key，无法确认条件达成",
+            };
+        }
+        const prompt = `${GOAL_EVALUATION_PROMPT}
+
+【目标条件】
+${input.condition}
+
+【Transcript】
+${input.transcript.slice(-12_000)}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(this.endpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(this.provider === "local" || !this.apiKey ? {} : { Authorization: `Bearer ${this.apiKey}` }),
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    temperature: 0,
+                    max_tokens: 120,
+                    messages: [
+                        { role: "user", content: prompt },
+                    ],
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`goal evaluator http ${response.status}`);
+            }
+            const data = await response.json();
+            const content = data.choices?.[0]?.message?.content ?? "";
+            return this.parse(content);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    parse(raw) {
+        try {
+            const parsed = JSON.parse(stripCodeFences(raw));
+            if (typeof parsed.done === "boolean" && typeof parsed.reason === "string") {
+                return parsed;
+            }
+        }
+        catch {
+            // fall through
+        }
+        return {
+            done: false,
+            reason: raw.trim() || "goal evaluator 返回了不可解析结果",
+        };
+    }
+}

package/dist/session/loop-prompt.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_LOOP_INTERVAL_MS: number;
+export declare const DEFAULT_MAINTENANCE_PROMPT: string;
+export type LoopPromptSource = "inline" | "project" | "user" | "builtin";
+export interface ResolvedLoopPrompt {
+    prompt: string;
+    source: LoopPromptSource;
+    path?: string;
+}
+export declare function resolveLoopPrompt(options: {
+    workspaceDir: string;
+    homeDir?: string;
+    inlinePrompt?: string;
+}): Promise<ResolvedLoopPrompt>;
+//# sourceMappingURL=loop-prompt.d.ts.map

package/dist/session/loop-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-prompt.d.ts","sourceRoot":"","sources":["../../src/session/loop-prompt.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AACvD,eAAO,MAAM,0BAA0B,QAI3B,CAAC;AAEb,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AASD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmC9B"}

package/dist/session/loop-prompt.js

@@ -0,0 +1,49 @@
+import * as fs from "fs/promises";
+import { existsSync } from "fs";
+import * as os from "os";
+import * as path from "path";
+export const DEFAULT_LOOP_INTERVAL_MS = 10 * 60 * 1000;
+export const DEFAULT_MAINTENANCE_PROMPT = [
+    "继续当前对话中已经授权但尚未完成的工作。",
+    "如果当前工作区里有待验证的修改，优先完成验证并报告结果。",
+    "如果没有待办事项，只输出一行：当前没有需要继续的工作。",
+].join("\n");
+async function readPromptFile(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    const raw = await fs.readFile(filePath, "utf-8");
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export async function resolveLoopPrompt(options) {
+    const inlinePrompt = options.inlinePrompt?.trim();
+    if (inlinePrompt) {
+        return {
+            prompt: inlinePrompt,
+            source: "inline",
+        };
+    }
+    const homeDir = options.homeDir ?? os.homedir();
+    const projectPromptPath = path.join(options.workspaceDir, ".claude", "loop.md");
+    const userPromptPath = path.join(homeDir, ".claude", "loop.md");
+    const projectPrompt = await readPromptFile(projectPromptPath);
+    if (projectPrompt) {
+        return {
+            prompt: projectPrompt,
+            source: "project",
+            path: projectPromptPath,
+        };
+    }
+    const userPrompt = await readPromptFile(userPromptPath);
+    if (userPrompt) {
+        return {
+            prompt: userPrompt,
+            source: "user",
+            path: userPromptPath,
+        };
+    }
+    return {
+        prompt: DEFAULT_MAINTENANCE_PROMPT,
+        source: "builtin",
+    };
+}

package/dist/session/session-goal-manager.d.ts

@@ -0,0 +1,51 @@
+export type SessionGoalStatus = "active" | "achieved" | "cleared";
+export type SessionGoalDecision = "done" | "continue" | "cleared" | null;
+export type SessionGoalRunner = "session" | "daemon";
+export interface SessionGoalState {
+    condition: string;
+    status: SessionGoalStatus;
+    runner: SessionGoalRunner;
+    pending: boolean;
+    createdAt: number;
+    updatedAt: number;
+    achievedAt?: number;
+    clearedAt?: number;
+    baselineTurns: number;
+    baselineTokens: number;
+    evaluatedTurns: number;
+    lastReason: string | null;
+    lastDecision: SessionGoalDecision;
+}
+export interface SessionGoalManagerOptions {
+    stateDir: string;
+    sessionId: string;
+    clock?: () => number;
+}
+export declare class SessionGoalManager {
+    private readonly goalsDir;
+    private readonly stateFile;
+    private readonly clock;
+    private goal;
+    constructor(options: SessionGoalManagerOptions);
+    init(): Promise<void>;
+    setGoal(condition: string, baseline: {
+        turnCount: number;
+        tokens: number;
+    }, options?: {
+        runner?: SessionGoalRunner;
+        pending?: boolean;
+    }): Promise<SessionGoalState>;
+    markEvaluation(result: {
+        done: boolean;
+        reason: string;
+        turnCount: number;
+        tokens: number;
+    }): Promise<SessionGoalState>;
+    clearGoal(reason: string): Promise<SessionGoalState>;
+    getGoalStatus(): Promise<SessionGoalState | null>;
+    getActiveGoal(runner?: SessionGoalRunner): SessionGoalState | null;
+    private getGoalOrThrow;
+    private loadGoal;
+    private saveGoal;
+}
+//# sourceMappingURL=session-goal-manager.d.ts.map

package/dist/session/session-goal-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-goal-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-goal-manager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,IAAI,CAAiC;gBAEjC,OAAO,EAAE,yBAAyB;IAMxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC/C,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9D,OAAO,CAAC,gBAAgB,CAAC;IAmBtB,cAAc,CAAC,MAAM,EAAE;QAC3B,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiCpD,aAAa,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKvD,aAAa,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,IAAI;IAUlE,OAAO,CAAC,cAAc;YAOR,QAAQ;YAWR,QAAQ;CAGvB"}