@qlingzzy/qling 1.0.0

package/dist/session-export-index.js

@@ -0,0 +1,96 @@
+import { readdir, stat } from "fs/promises";
+import { join } from "path";
+import { resolveSessionExportsDir } from "./session-export.js";
+const DEFAULT_EXPORT_COUNT = 10;
+const MAX_EXPORT_COUNT = 50;
+export function parseSessionExportCount(value) {
+    if (value === undefined || value === null || value === "")
+        return DEFAULT_EXPORT_COUNT;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return DEFAULT_EXPORT_COUNT;
+    return Math.min(Math.floor(parsed), MAX_EXPORT_COUNT);
+}
+function isNotFoundError(error) {
+    return Boolean(error && typeof error === "object" && error.code === "ENOENT");
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KB", "MB", "GB"];
+    let value = bytes / 1024;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    return `${value.toFixed(value >= 10 ? 0 : 1)} ${units[unitIndex]}`;
+}
+export async function listSessionExportFiles(context, options = {}) {
+    const requestedCount = parseSessionExportCount(options.count);
+    const exportsDir = resolveSessionExportsDir(context, options.env ?? process.env);
+    let names;
+    try {
+        names = await readdir(exportsDir);
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return { exportsDir, entries: [], total: 0, requestedCount, truncated: false };
+        }
+        throw error;
+    }
+    const entries = [];
+    for (const name of names) {
+        if (!name.toLowerCase().endsWith(".md"))
+            continue;
+        const path = join(exportsDir, name);
+        const fileStat = await stat(path);
+        if (!fileStat.isFile())
+            continue;
+        entries.push({
+            name,
+            path,
+            sizeBytes: fileStat.size,
+            modifiedAt: fileStat.mtime.toISOString(),
+            modifiedAtMs: fileStat.mtimeMs,
+        });
+    }
+    entries.sort((left, right) => right.modifiedAtMs - left.modifiedAtMs || left.name.localeCompare(right.name));
+    return {
+        exportsDir,
+        entries: entries.slice(0, requestedCount),
+        total: entries.length,
+        requestedCount,
+        truncated: entries.length > requestedCount,
+    };
+}
+export function formatSessionExportIndex(report) {
+    const lines = [
+        "",
+        "📚 本地导出列表",
+        "-----------------------------------------",
+        `Dir       : ${report.exportsDir}`,
+        `Count     : ${report.entries.length}/${report.total}`,
+    ];
+    if (!report.entries.length) {
+        lines.push("Status    : 还没有导出；使用 /export 生成本地 Markdown。");
+        lines.push("-----------------------------------------");
+        lines.push("");
+        return lines;
+    }
+    if (report.truncated) {
+        lines.push(`Limit     : 显示最近 ${report.requestedCount} 条`);
+    }
+    lines.push("");
+    report.entries.forEach((entry, index) => {
+        lines.push(`${index + 1}.`);
+        lines.push(`   文件名   : ${entry.name}`);
+        lines.push(`   修改时间 : ${entry.modifiedAt}`);
+        lines.push(`   大小     : ${formatBytes(entry.sizeBytes)}`);
+        lines.push(`   绝对路径 : ${entry.path}`);
+    });
+    lines.push("-----------------------------------------");
+    lines.push("说明      : 仅读取本地文件元数据，不读取导出正文、不调用模型、不联网。");
+    lines.push("");
+    return lines;
+}

package/dist/session-export.d.ts

@@ -0,0 +1,28 @@
+import type { SlashCommandContext } from "./commands/runtime.js";
+interface ExportMessage {
+    role?: string;
+    content?: unknown;
+}
+export interface SessionExportSnapshot {
+    sessionId: string;
+    workspaceDir: string;
+    exportedAt: string;
+    turnCount: number;
+    tokens: number;
+    compactions: number;
+    messages: ExportMessage[];
+}
+export interface SessionExportOptions {
+    now?: () => Date;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+}
+export interface SessionExportResult {
+    path: string;
+    messageCount: number;
+}
+export declare function resolveSessionExportsDir(context: SlashCommandContext, env?: SessionExportOptions["env"]): string;
+export declare function formatSessionExportMarkdown(snapshot: SessionExportSnapshot): string;
+export declare function buildSessionExportSnapshot(context: SlashCommandContext, options?: SessionExportOptions): Promise<SessionExportSnapshot>;
+export declare function writeSessionExport(context: SlashCommandContext, options?: SessionExportOptions): Promise<SessionExportResult>;
+export {};
+//# sourceMappingURL=session-export.d.ts.map

package/dist/session-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-export.d.ts","sourceRoot":"","sources":["../src/session-export.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AA6BD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,GAAE,oBAAoB,CAAC,KAAK,CAAe,GAC7C,MAAM,CAER;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAkCnF;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAwBhC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAa9B"}

package/dist/session-export.js

@@ -0,0 +1,99 @@
+import { mkdir, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join, resolve } from "path";
+function stringifyContent(content) {
+    if (typeof content === "string")
+        return content;
+    try {
+        return JSON.stringify(content, null, 2);
+    }
+    catch {
+        return String(content);
+    }
+}
+function sanitizeFilePart(value) {
+    return (value || "session")
+        .replace(/[^a-zA-Z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80) || "session";
+}
+function timestampForFile(date) {
+    return date.toISOString().replace(/[:.]/g, "-");
+}
+function resolveStateDir(context, env) {
+    const agentLoop = context.agentLoop;
+    return env?.QLING_FILE_STATE_DIR
+        || agentLoop.getRuntimeRootDir?.()
+        || join(homedir(), ".qling");
+}
+export function resolveSessionExportsDir(context, env = process.env) {
+    return resolve(resolveStateDir(context, env), "exports");
+}
+export function formatSessionExportMarkdown(snapshot) {
+    const lines = [
+        "# qling Session Export",
+        "",
+        `- session: ${snapshot.sessionId || "-"}`,
+        `- workspace: ${snapshot.workspaceDir || "-"}`,
+        `- exportedAt: ${snapshot.exportedAt}`,
+        `- turns: ${Number(snapshot.turnCount ?? 0)}`,
+        `- tokens: ${Number(snapshot.tokens ?? 0).toLocaleString()}`,
+        `- compactions: ${Number(snapshot.compactions ?? 0)}`,
+        "",
+        "> This file was exported locally by qling. No model call or network request is required for export.",
+        "",
+        "# Messages",
+        "",
+    ];
+    if (!snapshot.messages.length) {
+        lines.push("_No messages in current session._");
+        lines.push("");
+        return lines.join("\n");
+    }
+    snapshot.messages.forEach((message, index) => {
+        const role = String(message.role || "unknown");
+        lines.push(`## ${role} ${index + 1}`);
+        lines.push("");
+        lines.push("```text");
+        lines.push(stringifyContent(message.content ?? ""));
+        lines.push("```");
+        lines.push("");
+    });
+    return lines.join("\n");
+}
+export async function buildSessionExportSnapshot(context, options = {}) {
+    const agentLoop = context.agentLoop;
+    const stats = typeof agentLoop.getSessionStats === "function"
+        ? await agentLoop.getSessionStats()
+        : {
+            sessionId: agentLoop.getSessionId?.() ?? "session",
+            turnCount: 0,
+            tokens: 0,
+            compactions: 0,
+        };
+    const messages = typeof agentLoop.getMessagesSnapshot === "function"
+        ? await agentLoop.getMessagesSnapshot()
+        : [];
+    const now = options.now?.() ?? new Date();
+    return {
+        sessionId: stats.sessionId || agentLoop.getSessionId?.() || "session",
+        workspaceDir: context.workspaceDir || agentLoop.getWorkspaceDir?.() || process.cwd(),
+        exportedAt: now.toISOString(),
+        turnCount: Number(stats.turnCount ?? 0),
+        tokens: Number(stats.tokens ?? 0),
+        compactions: Number(stats.compactions ?? stats.compactionCount ?? 0),
+        messages: Array.isArray(messages) ? messages : [],
+    };
+}
+export async function writeSessionExport(context, options = {}) {
+    const snapshot = await buildSessionExportSnapshot(context, options);
+    const exportsDir = resolveSessionExportsDir(context, options.env ?? process.env);
+    await mkdir(exportsDir, { recursive: true });
+    const fileName = `${sanitizeFilePart(snapshot.sessionId)}-${timestampForFile(new Date(snapshot.exportedAt))}.md`;
+    const targetPath = join(exportsDir, fileName);
+    await writeFile(targetPath, formatSessionExportMarkdown(snapshot), { encoding: "utf8", flag: "wx" });
+    return {
+        path: targetPath,
+        messageCount: snapshot.messages.length,
+    };
+}

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

@@ -0,0 +1,37 @@
+import { type SessionGoalRunner, type SessionGoalState } from "./session/session-goal-manager.js";
+export interface LocalSessionGoal {
+    sessionId: string;
+    filePath: string;
+    goal: SessionGoalState;
+}
+export interface SessionGoalReport {
+    stateDir: string;
+    goalsDir: string;
+    sessionRef: string | null;
+    totalGoals: number;
+    goals: LocalSessionGoal[];
+    warnings: string[];
+}
+export interface SessionGoalMutation {
+    sessionId: string;
+    sessionName: string;
+    workspaceDir: string | null;
+    goal: SessionGoalState;
+}
+export interface SetLocalSessionGoalOptions {
+    sessionRef?: string;
+    runner?: SessionGoalRunner;
+    clock?: () => number;
+}
+export interface ClearLocalSessionGoalOptions {
+    sessionRef?: string;
+    clock?: () => number;
+}
+export declare function listLocalSessionGoals(stateDir: string, options?: {
+    sessionRef?: string;
+}): Promise<SessionGoalReport>;
+export declare function setLocalSessionGoal(stateDir: string, condition: string, options?: SetLocalSessionGoalOptions): Promise<SessionGoalMutation>;
+export declare function clearLocalSessionGoal(stateDir: string, options?: ClearLocalSessionGoalOptions): Promise<SessionGoalMutation>;
+export declare function formatSessionGoalReport(report: SessionGoalReport): string[];
+export declare function formatSessionGoalMutation(action: "set" | "clear", result: SessionGoalMutation): string[];
+//# sourceMappingURL=session-goal-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-goal-report.d.ts","sourceRoot":"","sources":["../src/session-goal-report.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGtH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAUD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,iBAAiB,CAAC,CA8C5B;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAgC9B;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAgC3E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,KAAK,GAAG,OAAO,EACvB,MAAM,EAAE,mBAAmB,GAC1B,MAAM,EAAE,CAsBV"}

package/dist/session-goal-report.js

@@ -0,0 +1,219 @@
+import * as fs from "fs/promises";
+import { existsSync } from "fs";
+import * as path from "path";
+import { SessionGoalManager } from "./session/session-goal-manager.js";
+import { SessionRegistry } from "./session/session-registry.js";
+export async function listLocalSessionGoals(stateDir, options = {}) {
+    const goalsDir = path.join(stateDir, "session-goals");
+    const warnings = [];
+    const sessionRef = normalizeOptionalRef(options.sessionRef);
+    if (sessionRef) {
+        const sessionId = await resolveStatusSessionId(stateDir, sessionRef);
+        const goal = await readGoalFile(goalsDir, sessionId, warnings);
+        return {
+            stateDir,
+            goalsDir,
+            sessionRef,
+            totalGoals: goal ? 1 : 0,
+            goals: goal ? [goal] : [],
+            warnings,
+        };
+    }
+    if (!existsSync(goalsDir)) {
+        return {
+            stateDir,
+            goalsDir,
+            sessionRef: null,
+            totalGoals: 0,
+            goals: [],
+            warnings,
+        };
+    }
+    const files = (await fs.readdir(goalsDir)).filter((file) => file.endsWith(".json")).sort();
+    const goals = [];
+    for (const file of files) {
+        const sessionId = path.basename(file, ".json");
+        const goal = await readGoalFile(goalsDir, sessionId, warnings);
+        if (goal)
+            goals.push(goal);
+    }
+    goals.sort(compareGoals);
+    return {
+        stateDir,
+        goalsDir,
+        sessionRef: null,
+        totalGoals: goals.length,
+        goals,
+        warnings,
+    };
+}
+export async function setLocalSessionGoal(stateDir, condition, options = {}) {
+    const normalizedCondition = condition.trim();
+    if (!normalizedCondition) {
+        throw new Error("goal condition is required");
+    }
+    const target = await resolveSessionTarget(stateDir, options.sessionRef);
+    const runner = options.runner ?? "daemon";
+    const manager = new SessionGoalManager({
+        stateDir,
+        sessionId: target.sessionId,
+        clock: options.clock,
+    });
+    await manager.init();
+    const goal = await manager.setGoal(normalizedCondition, {
+        turnCount: target.turnCount,
+        tokens: target.tokens,
+    }, {
+        runner,
+        pending: runner === "daemon",
+    });
+    return {
+        sessionId: target.sessionId,
+        sessionName: target.name,
+        workspaceDir: target.workspaceDir,
+        goal,
+    };
+}
+export async function clearLocalSessionGoal(stateDir, options = {}) {
+    const target = await resolveSessionTarget(stateDir, options.sessionRef);
+    const manager = new SessionGoalManager({
+        stateDir,
+        sessionId: target.sessionId,
+        clock: options.clock,
+    });
+    await manager.init();
+    const goal = await manager.clearGoal("cli_clear");
+    return {
+        sessionId: target.sessionId,
+        sessionName: target.name,
+        workspaceDir: target.workspaceDir,
+        goal,
+    };
+}
+export function formatSessionGoalReport(report) {
+    const lines = [
+        "◎ 本地目标列表",
+        "-----------------------------------------",
+        `State dir : ${report.stateDir}`,
+        `Goals    : ${report.goalsDir}`,
+        `Count    : ${report.goals.length}/${report.totalGoals}`,
+    ];
+    if (report.sessionRef) {
+        lines.push(`Target   : ${report.sessionRef}`);
+    }
+    if (report.goals.length === 0) {
+        lines.push("(无本地目标。可使用 `qling goal set \"完成条件\"` 创建 daemon goal。)");
+    }
+    else {
+        lines.push("");
+        for (const item of report.goals) {
+            lines.push(`- [${item.goal.status.toUpperCase()}] ${item.sessionId}`);
+            lines.push(`  Runner  : ${item.goal.runner ?? "session"} | pending=${item.goal.pending ? "yes" : "no"}`);
+            lines.push(`  条件    : ${item.goal.condition || "(空)"}`);
+            lines.push(`  创建    : ${formatTimestamp(item.goal.createdAt)} | 更新: ${formatTimestamp(item.goal.updatedAt)}`);
+            lines.push(`  评估    : ${item.goal.evaluatedTurns ?? 0} | 最近原因: ${item.goal.lastReason ?? "-"}`);
+        }
+    }
+    for (const warning of report.warnings) {
+        lines.push(`⚠️ ${warning}`);
+    }
+    lines.push("-----------------------------------------");
+    lines.push("说明: 只读取本地 goal 状态与会话摘要，不输出会话正文、不联网、不调用模型。");
+    return lines;
+}
+export function formatSessionGoalMutation(action, result) {
+    const title = action === "set" ? "◎ 已设置本地目标" : "◎ 已清除本地目标";
+    const lines = [
+        title,
+        "-----------------------------------------",
+        `Session : ${result.sessionId}`,
+        `Name    : ${result.sessionName}`,
+        `状态    : ${result.goal.status}`,
+        `Runner  : ${result.goal.runner ?? "session"} | pending=${result.goal.pending ? "yes" : "no"}`,
+        `条件    : ${result.goal.condition || "(空)"}`,
+        `更新    : ${formatTimestamp(result.goal.updatedAt)}`,
+    ];
+    if (result.workspaceDir) {
+        lines.push(`Workspace: ${result.workspaceDir}`);
+    }
+    lines.push("-----------------------------------------");
+    lines.push(action === "set"
+        ? "说明: 已写入本地 session-goals；默认 daemon runner，需 qlingd 运行后继续推进。"
+        : "说明: 仅更新本地 session-goals 状态，不删除历史记录。");
+    return lines;
+}
+async function resolveStatusSessionId(stateDir, sessionRef) {
+    if (sessionRef === "latest") {
+        return (await resolveSessionTarget(stateDir, sessionRef)).sessionId;
+    }
+    const registry = new SessionRegistry({ stateDir });
+    const sessions = await registry.list();
+    const normalized = normalizeRef(sessionRef);
+    const matched = sessions.find((session) => normalizeRef(session.name) === normalized || session.sessionId === sessionRef);
+    return matched?.sessionId ?? normalized;
+}
+async function resolveSessionTarget(stateDir, sessionRef) {
+    const registry = new SessionRegistry({ stateDir });
+    const sessions = await registry.list();
+    if (sessions.length === 0) {
+        throw new Error("no saved sessions found; start or resume a chat session first");
+    }
+    const normalized = normalizeOptionalRef(sessionRef);
+    const summary = !normalized || normalized === "latest"
+        ? sessions[0]
+        : findSession(sessions, normalized);
+    if (!summary) {
+        throw new Error(`session not found: ${sessionRef}`);
+    }
+    return {
+        sessionId: summary.sessionId,
+        name: summary.name,
+        workspaceDir: summary.workspaceDir,
+        turnCount: summary.turnCount,
+        tokens: summary.sessionTokens,
+    };
+}
+function findSession(sessions, sessionRef) {
+    const normalized = normalizeRef(sessionRef);
+    return (sessions.find((session) => normalizeRef(session.name) === normalized || session.sessionId === sessionRef) ?? null);
+}
+async function readGoalFile(goalsDir, sessionId, warnings) {
+    const filePath = path.join(goalsDir, `${normalizeRef(sessionId)}.json`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const parsed = JSON.parse(await fs.readFile(filePath, "utf8"));
+        return {
+            sessionId: normalizeRef(sessionId),
+            filePath,
+            goal: {
+                ...parsed,
+                runner: parsed.runner ?? "session",
+                pending: parsed.pending ?? false,
+            },
+        };
+    }
+    catch (err) {
+        warnings.push(`${path.basename(filePath)}: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+function normalizeOptionalRef(value) {
+    if (!value || !value.trim())
+        return null;
+    return normalizeRef(value.trim());
+}
+function normalizeRef(value) {
+    return path.basename(value).replace(/\.json$/i, "");
+}
+function compareGoals(left, right) {
+    const updated = (right.goal.updatedAt ?? 0) - (left.goal.updatedAt ?? 0);
+    if (updated !== 0)
+        return updated;
+    return left.sessionId.localeCompare(right.sessionId);
+}
+function formatTimestamp(ts) {
+    if (!ts)
+        return "-";
+    return new Date(ts).toLocaleString();
+}

package/dist/session-list-report.d.ts

@@ -0,0 +1,16 @@
+import { type SavedSessionSummary } from "./session/session-registry.js";
+export interface SessionListReport {
+    stateDir: string;
+    sessionsDir: string;
+    sessions: SavedSessionSummary[];
+    total: number;
+    requestedCount: number;
+    truncated: boolean;
+}
+export interface SessionListOptions {
+    count?: string | number;
+}
+export declare function parseSessionListCount(value?: string | number): number;
+export declare function listLocalSessions(stateDir: string, options?: SessionListOptions): Promise<SessionListReport>;
+export declare function formatSessionListReport(report: SessionListReport): string[];
+//# sourceMappingURL=session-list-report.d.ts.map

package/dist/session-list-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list-report.d.ts","sourceRoot":"","sources":["../src/session-list-report.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAK1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKrE;AAOD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAa5B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAoC3E"}

package/dist/session-list-report.js

@@ -0,0 +1,60 @@
+import { join } from "path";
+import { SessionRegistry } from "./session/session-registry.js";
+const DEFAULT_SESSION_COUNT = 20;
+const MAX_SESSION_COUNT = 100;
+export function parseSessionListCount(value) {
+    if (value === undefined || value === null || value === "")
+        return DEFAULT_SESSION_COUNT;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return DEFAULT_SESSION_COUNT;
+    return Math.min(Math.floor(parsed), MAX_SESSION_COUNT);
+}
+function formatTime(value) {
+    const ts = Date.parse(value);
+    return Number.isNaN(ts) ? value : new Date(ts).toLocaleString();
+}
+export async function listLocalSessions(stateDir, options = {}) {
+    const requestedCount = parseSessionListCount(options.count);
+    const registry = new SessionRegistry({ stateDir });
+    const allSessions = await registry.list();
+    return {
+        stateDir,
+        sessionsDir: join(stateDir, "sessions"),
+        sessions: allSessions.slice(0, requestedCount),
+        total: allSessions.length,
+        requestedCount,
+        truncated: allSessions.length > requestedCount,
+    };
+}
+export function formatSessionListReport(report) {
+    const lines = [
+        "",
+        "🗂️ 本地会话列表",
+        "-----------------------------------------",
+        `State dir : ${report.stateDir}`,
+        `Sessions  : ${report.sessionsDir}`,
+        `Count     : ${report.sessions.length}/${report.total}`,
+    ];
+    if (!report.sessions.length) {
+        lines.push("(无)");
+        lines.push("-----------------------------------------");
+        lines.push("说明      : 仅读取本地会话快照摘要，不调用模型、不联网。");
+        lines.push("");
+        return lines;
+    }
+    if (report.truncated) {
+        lines.push(`Limit     : 显示最近 ${report.requestedCount} 条`);
+    }
+    lines.push("");
+    report.sessions.forEach((session, index) => {
+        lines.push(`${index + 1}. ${session.name} | ${session.sessionId}`);
+        lines.push(`   更新     : ${formatTime(session.updatedAt)} | turns=${session.turnCount} | messages=${session.messageCount} | tokens=${session.sessionTokens.toLocaleString()}`);
+        lines.push(`   压缩     : ${session.compactionCount}`);
+        lines.push(`   Workspace: ${session.workspaceDir ?? "-"}`);
+    });
+    lines.push("-----------------------------------------");
+    lines.push("说明      : 输出只包含本地摘要字段，不输出消息正文；不调用模型、不联网。");
+    lines.push("");
+    return lines;
+}

package/dist/session-task-report.d.ts

@@ -0,0 +1,23 @@
+import type { SessionTask } from "./session/session-scheduler.js";
+export interface LocalSessionTask extends SessionTask {
+    sessionId: string;
+    filePath: string;
+}
+export interface SessionTaskReport {
+    tasksDir: string;
+    totalFiles: number;
+    totalTasks: number;
+    shownTasks: number;
+    tasks: LocalSessionTask[];
+    warnings: string[];
+}
+export declare function parseSessionTaskCount(value?: string): number;
+export declare function listLocalSessionTasks(stateDir: string, options?: {
+    count?: number;
+}): Promise<SessionTaskReport>;
+export declare function cancelLocalSessionTask(stateDir: string, taskId: string, options?: {
+    clock?: () => number;
+}): Promise<LocalSessionTask>;
+export declare function formatSessionTaskReport(report: SessionTaskReport): string[];
+export declare function formatCanceledSessionTask(task: LocalSessionTask): string[];
+//# sourceMappingURL=session-task-report.d.ts.map

package/dist/session-task-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-task-report.d.ts","sourceRoot":"","sources":["../src/session-task-report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAKlE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA8D5B;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAkC3E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAY1E"}