@qlingzzy/qling 1.0.0 → 1.1.0

package/dist/commands/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,eAAO,MAAM,YAAY,EAAE,YAwC1B,CAAC"}

package/dist/commands/trace.js

@@ -0,0 +1,45 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const traceCommand = {
+    name: "/trace",
+    aliases: ["/轨迹"],
+    description: "查看脱敏后的本地执行摘要轨迹",
+    usage: "/trace current | last | show <runId> | export <runId>",
+    category: "session",
+    argumentHint: "current | last | show <runId> | export <runId>",
+    examples: ["/trace last", "/trace show run_abc"],
+    execute: async (args, context) => {
+        const agent = context.agentLoop;
+        if (typeof agent.listRunTraceIds !== "function" || typeof agent.readRunTrace !== "function") {
+            context.writeError("轨迹查询不可用：当前 AgentLoop 未启用本地摘要轨迹。");
+            return;
+        }
+        const sub = (args[0] ?? "last").toLowerCase();
+        const ids = await agent.listRunTraceIds();
+        let runId = args[1];
+        if (sub === "current")
+            runId = agent.getActiveRun?.()?.runId;
+        if (sub === "last")
+            runId = ids[0];
+        if (!runId || !["current", "last", "show", "export"].includes(sub)) {
+            context.writeError(ids.length === 0 ? "暂无本地执行轨迹。" : "用法: /trace current | last | show <runId> | export <runId>");
+            return;
+        }
+        const events = await agent.readRunTrace(runId);
+        if (sub === "export") {
+            const root = typeof agent.getRuntimeRootDir === "function" ? agent.getRuntimeRootDir() : path.join(process.cwd(), ".qling");
+            const exportDir = path.join(root, "exports");
+            const exportPath = path.join(exportDir, `trace-${runId}.jsonl`);
+            await mkdir(exportDir, { recursive: true });
+            await writeFile(exportPath, events.map((event) => JSON.stringify(event)).join("\n") + "\n", "utf8");
+            context.writeLine(`脱敏轨迹已导出: ${exportPath}`);
+            context.writeLine("边界: 导出不包含 prompt、模型思考或工具正文。");
+            return;
+        }
+        context.writeLine(`执行轨迹 ${runId} (${events.length} events)`);
+        for (const event of events) {
+            context.writeLine(`${new Date(event.timestamp).toISOString()}  ${event.type}  ${event.status ?? "-"}  ${event.category ?? "-"}  ${event.fingerprint ?? "-"}`);
+        }
+        context.writeLine("边界: 仅显示脱敏摘要，不包含 prompt、模型思考或工具正文。");
+    },
+};

package/dist/commands/verify.js

@@ -30,11 +30,11 @@ export const verifyCommand = {
                 context.writeLine("-----------------------------------------");
                 if (cmd) {
                     context.writeLine(`当前验证命令 : ${cmd}`);
-                    context.writeLine(`自动自愈状态 : 已开启 (写操作后自动触发，上限 3 轮)`);
+                    context.writeLine(`自动恢复状态 : 已开启 (同因最多 2 次，策略预算 4 次)`);
                 }
                 else {
                     context.writeLine("当前验证命令 : (未设置)");
-                    context.writeLine("自动自愈状态 : 已关闭");
+                    context.writeLine("自动恢复状态 : 已关闭");
                 }
                 context.writeLine("-----------------------------------------");
                 context.writeLine("");

package/dist/config-report.d.ts

@@ -8,7 +8,6 @@ export interface LocalConfigReport {
     stateDir: string;
     cacheDir: string;
     maxSteps: number;
-    maxTokenBudget: number;
     permissionMode: string;
     permissionRuleCount: number;
     features: Record<string, boolean>;

package/dist/config-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-report.d.ts","sourceRoot":"","sources":["../src/config-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,SAAS,GAAG,eAAe,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;CACxB;AAaD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkBzE;AAUD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAoC7E;AAQD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwB3E"}
+{"version":3,"file":"config-report.d.ts","sourceRoot":"","sources":["../src/config-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,SAAS,GAAG,eAAe,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;CACxB;AAaD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkBzE;AAUD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAoC7E;AAQD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwB3E"}

package/dist/config-report.js

@@ -42,7 +42,6 @@ export function buildLocalConfigReport(config) {
         stateDir: safeText(config.runtime.file_state_dir),
         cacheDir: safeText(config.runtime.file_cache_dir),
         maxSteps: Number(config.runtime.max_steps ?? 0),
-        maxTokenBudget: Number(config.runtime.max_token_budget ?? 0),
         permissionMode: safeText(config.guard.permissions.default, "allow"),
         permissionRuleCount: config.guard.permissions.rules?.length ?? 0,
         features: {
@@ -85,7 +84,7 @@ export function formatLocalConfigReport(report) {
         `Workspace  : ${report.workspaceDir}`,
         `State dir  : ${report.stateDir}`,
         `Cache dir  : ${report.cacheDir}`,
-        `Runtime    : max_steps=${report.maxSteps} max_tokens=${report.maxTokenBudget.toLocaleString()}`,
+        `Runtime    : max_steps=${report.maxSteps}`,
         `Permissions: ${formatPermissionMode(report.permissionMode)}`,
         `Rules      : ${report.permissionRuleCount}`,
         `Features   : ${formatFeatureFlags(report.features)}`,

package/dist/config.d.ts

@@ -74,7 +74,6 @@ export interface QlingConfig {
         file_state_dir: string;
         max_steps: number;
         parse_retries: number;
-        max_token_budget: number;
         tool_repeat_limit: number;
         timeout_ms: number;
     };

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -21,7 +21,6 @@ export function buildDefaultConfig() {
             file_state_dir: DEFAULT_STATE_DIR,
             max_steps: 50,
             parse_retries: 2,
-            max_token_budget: 120000,
             tool_repeat_limit: 6,
             timeout_ms: 300000,
         },

package/dist/context-report.d.ts

@@ -1,16 +1,19 @@
 import type { SlashCommandContext } from "./commands/runtime.js";
+import { type TokenUsageSource } from "./token-usage.js";
+import { type ContextLayerEstimate } from "./context-tool-hygiene.js";
 export interface ContextReport {
     sessionId: string;
     turnCount: number;
     messageCount: number;
     tokens: number;
-    tokenSource: "provider" | "estimate" | "unknown";
+    promptTokens: number;
+    completionTokens: number;
+    tokenSource: TokenUsageSource;
     tokenSourceDescription: string;
-    maxTokens: number | null;
-    tokenUsagePercent: number | null;
-    contextLevel: "ok" | "watch" | "critical" | "unknown";
     recommendation: string;
     compactions: number;
+    /** 本地字符层估计（非 provider token） */
+    layers: ContextLayerEstimate | null;
     workspaceDir: string;
     stateDir: string;
     cacheDir: string;
@@ -20,15 +23,18 @@ export interface ContextReport {
 }
 export interface ContextReportOptions {
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
-    maxTokens?: number | null;
 }
 export interface LocalContextReportOptions {
     workspaceDir: string;
     stateDir: string;
     cacheDir?: string;
-    maxTokens?: number | null;
 }
-export declare function formatTokenUsage(tokens: number, maxTokens: number | null | undefined): string;
+export declare function formatTokenUsage(options: {
+    tokens: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    source?: TokenUsageSource;
+}): string;
 export declare function buildContextReport(context: SlashCommandContext, options?: ContextReportOptions): Promise<ContextReport>;
 export declare function buildLocalContextReport(options: LocalContextReportOptions): Promise<ContextReport>;
 export declare function formatContextReport(report: ContextReport): string[];

package/dist/context-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-report.d.ts","sourceRoot":"","sources":["../src/context-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAoBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAO7F;AAiCD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA2CxB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BxG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAsCnE"}
+{"version":3,"file":"context-report.d.ts","sourceRoot":"","sources":["../src/context-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,MAAM,CAOT;AAyBD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBxG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA2DnE"}

package/dist/context-report.js

@@ -2,6 +2,8 @@ import { join } from "path";
 import { homedir } from "os";
 import { formatLocalPanel } from "./output-style.js";
 import { SessionRegistry } from "./session/session-registry.js";
+import { formatProviderTokenLine, } from "./token-usage.js";
+import { estimateContextLayers, } from "./context-tool-hygiene.js";
 function resolveStateDir(env, agentLoop) {
     return env?.QLING_FILE_STATE_DIR
         || agentLoop.getRuntimeRootDir?.()
@@ -10,52 +12,31 @@ function resolveStateDir(env, agentLoop) {
 function resolveCacheDir(env, stateDir) {
     return env?.QLING_FILE_CACHE_DIR || join(stateDir, "cache");
 }
-function resolveMaxTokens(options, agentLoop) {
-    if (typeof options.maxTokens === "number" && options.maxTokens > 0) {
-        return options.maxTokens;
-    }
-    const fromAgent = agentLoop.getTokenBudget?.()?.maxTokens ?? agentLoop.tokenBudget?.maxTokens;
-    return typeof fromAgent === "number" && fromAgent > 0 ? fromAgent : null;
-}
-export function formatTokenUsage(tokens, maxTokens) {
-    const used = Number(tokens ?? 0);
-    if (!maxTokens || maxTokens <= 0) {
-        return `${used.toLocaleString()} / unknown`;
-    }
-    const pct = Math.round((used / maxTokens) * 100);
-    return `${used.toLocaleString()} / ${maxTokens.toLocaleString()} (${pct}%)`;
-}
-function classifyContextLevel(percent) {
-    if (percent === null)
-        return "unknown";
-    if (percent >= 90)
-        return "critical";
-    if (percent >= 70)
-        return "watch";
-    return "ok";
-}
-function describeContextRecommendation(level) {
-    switch (level) {
-        case "critical":
-            return "立即保存 checkpoint 并执行 /compact，避免后续回复被截断或上下文丢失。";
-        case "watch":
-            return "建议在继续长任务前保存 checkpoint；如输出变长，提前 /compact。";
-        case "ok":
-            return "当前上下文占用正常，可继续推进。";
-        default:
-            return "未配置可用 token 预算，建议设置 max token budget 以获得准确上下文水位。";
-    }
+export function formatTokenUsage(options) {
+    return formatProviderTokenLine({
+        tokens: options.tokens,
+        promptTokens: options.promptTokens,
+        completionTokens: options.completionTokens,
+        source: options.source,
+    });
 }
 function describeTokenSource(source) {
     switch (source) {
         case "provider":
-            return "provider reported usage; suitable for accurate accounting when the provider returns usage.";
-        case "estimate":
-            return "local estimate; useful for context planning but not exact billing.";
+            return "provider 官方 usage（prompt/completion/total 字段）；适合账单与用量统计。";
         default:
-            return "unknown; provider usage and local estimate are unavailable.";
+            return "unknown：本会话尚未收到 provider usage；不会用本地字符估算伪造 token。";
     }
 }
+function describeRecommendation(options) {
+    if (options.tokenSource === "unknown") {
+        return "当前无官方 usage。请确认模型 API 返回 usage；部分代理层可能剥离该字段。";
+    }
+    if (options.compactions > 0 || options.messageCount >= 40) {
+        return "上下文较长或已压缩过，可按需 /compact 或保存 checkpoint 后继续。";
+    }
+    return "Token 来自 provider 官方 usage，可继续推进。";
+}
 export async function buildContextReport(context, options = {}) {
     const env = options.env ?? process.env;
     const agentLoop = context.agentLoop;
@@ -65,6 +46,8 @@ export async function buildContextReport(context, options = {}) {
             sessionId: agentLoop.getSessionId?.() ?? "",
             turnCount: agentLoop.turnCount ?? 0,
             tokens: agentLoop.sessionTokens ?? 0,
+            promptTokens: 0,
+            completionTokens: 0,
             tokenSource: "unknown",
             compactions: agentLoop.compactionCount ?? 0,
         };
@@ -74,23 +57,27 @@ export async function buildContextReport(context, options = {}) {
     const savedSessions = context.listSavedSessions ? await context.listSavedSessions() : [];
     const stateDir = resolveStateDir(env, agentLoop);
     const cacheDir = resolveCacheDir(env, stateDir);
-    const maxTokens = resolveMaxTokens(options, agentLoop);
     const tokens = Number(stats.tokens ?? 0);
-    const tokenUsagePercent = maxTokens ? Math.round((tokens / maxTokens) * 100) : null;
+    const promptTokens = Number(stats.promptTokens ?? 0);
+    const completionTokens = Number(stats.completionTokens ?? 0);
     const tokenSource = normalizeTokenSource(stats.tokenSource);
-    const contextLevel = classifyContextLevel(tokenUsagePercent);
+    const messageCount = Array.isArray(messages) ? messages.length : Number(stats.messageCount ?? 0);
+    const compactions = Number(stats.compactions ?? stats.compactionCount ?? 0);
+    const layers = Array.isArray(messages) && messages.length > 0
+        ? estimateContextLayers(messages)
+        : null;
     return {
         sessionId: stats.sessionId || agentLoop.getSessionId?.() || "-",
         turnCount: Number(stats.turnCount ?? 0),
-        messageCount: Array.isArray(messages) ? messages.length : Number(stats.messageCount ?? 0),
+        messageCount,
         tokens,
+        promptTokens,
+        completionTokens,
         tokenSource,
         tokenSourceDescription: describeTokenSource(tokenSource),
-        maxTokens,
-        tokenUsagePercent,
-        contextLevel,
-        recommendation: describeContextRecommendation(contextLevel),
-        compactions: Number(stats.compactions ?? stats.compactionCount ?? 0),
+        recommendation: describeRecommendation({ tokenSource, compactions, messageCount }),
+        compactions,
+        layers,
         workspaceDir: context.workspaceDir || agentLoop.getWorkspaceDir?.() || process.cwd(),
         stateDir,
         cacheDir,
@@ -102,24 +89,19 @@ export async function buildContextReport(context, options = {}) {
 export async function buildLocalContextReport(options) {
     const registry = new SessionRegistry({ stateDir: options.stateDir });
     const savedSessions = await registry.list();
-    const maxTokens = typeof options.maxTokens === "number" && options.maxTokens > 0
-        ? options.maxTokens
-        : null;
-    const tokenUsagePercent = maxTokens ? 0 : null;
     const tokenSource = "unknown";
-    const contextLevel = classifyContextLevel(tokenUsagePercent);
     return {
         sessionId: "-",
         turnCount: 0,
         messageCount: 0,
         tokens: 0,
+        promptTokens: 0,
+        completionTokens: 0,
         tokenSource,
         tokenSourceDescription: describeTokenSource(tokenSource),
-        maxTokens,
-        tokenUsagePercent,
-        contextLevel,
-        recommendation: describeContextRecommendation(contextLevel),
+        recommendation: describeRecommendation({ tokenSource, compactions: 0, messageCount: 0 }),
         compactions: 0,
+        layers: null,
         workspaceDir: options.workspaceDir,
         stateDir: options.stateDir,
         cacheDir: options.cacheDir || join(options.stateDir, "cache"),
@@ -143,15 +125,36 @@ export function formatContextReport(report) {
                 ],
             },
             {
-                heading: "Token 与状态",
+                heading: "Token（官方 usage）",
                 rows: [
-                    ["Token", formatTokenUsage(report.tokens, report.maxTokens)],
+                    ["Token", formatTokenUsage({
+                            tokens: report.tokens,
+                            promptTokens: report.promptTokens,
+                            completionTokens: report.completionTokens,
+                            source: report.tokenSource,
+                        })],
+                    ["输入 tokens", report.promptTokens.toLocaleString()],
+                    ["输出 tokens", report.completionTokens.toLocaleString()],
                     ["Token 来源", report.tokenSource],
                     ["Token 说明", report.tokenSourceDescription],
-                    ["上下文状态", report.contextLevel],
                     ["建议", report.recommendation],
                 ],
             },
+            {
+                heading: "Harness 层（本地字符估计）",
+                rows: report.layers
+                    ? [
+                        ["对话 history", `${report.layers.historyChars.toLocaleString()} 字符 (${report.layers.historyPct}%)`],
+                        ["工具输出", `${report.layers.toolOutputChars.toLocaleString()} 字符 (${report.layers.toolOutputPct}%)`],
+                        ["其他", `${report.layers.otherChars.toLocaleString()} 字符 (${report.layers.otherPct}%)`],
+                        ["合计字符", report.layers.totalChars.toLocaleString()],
+                        ["工具消息数", report.layers.toolMessageCount],
+                        ["说明", "非 provider token；用于观察 harness 膨胀。超长工具结果默认折叠（QLING_TOOL_RESULT_MAX_CHARS）。"],
+                    ]
+                    : [
+                        ["状态", "当前无会话消息快照"],
+                    ],
+            },
             {
                 heading: "本地路径",
                 rows: [
@@ -168,5 +171,5 @@ export function formatContextReport(report) {
     });
 }
 function normalizeTokenSource(value) {
-    return value === "provider" || value === "estimate" ? value : "unknown";
+    return value === "provider" ? "provider" : "unknown";
 }

package/dist/context-tool-hygiene.d.ts

@@ -0,0 +1,36 @@
+export interface ToolOutputSummaryOptions {
+    /** 超过此字符数则折叠。0 或负数 = 不截断。 */
+    maxChars?: number;
+    headChars?: number;
+    tailChars?: number;
+}
+export interface ContextLayerEstimate {
+    historyChars: number;
+    toolOutputChars: number;
+    otherChars: number;
+    totalChars: number;
+    historyPct: number;
+    toolOutputPct: number;
+    otherPct: number;
+    messageCount: number;
+    toolMessageCount: number;
+}
+export declare function resolveToolResultMaxChars(env?: NodeJS.ProcessEnv | Record<string, string | undefined>): number;
+/**
+ * 折叠超长纯文本工具输出。短文本原样返回。
+ */
+export declare function summarizeToolOutputForContext(output: string, options?: ToolOutputSummaryOptions): string;
+/**
+ * 将 tool 消息 content（可能是 JSON.stringify(result)）做卫生处理。
+ * 保持 is_error / tool_call_id 等结构字段。
+ */
+export declare function prepareToolResultContent(content: string, options?: ToolOutputSummaryOptions): string;
+/**
+ * 本地字符层估计（非 provider token）。用于 /context harness 可见性。
+ */
+export declare function estimateContextLayers(messages: Array<{
+    role?: string;
+    content?: string;
+    tool_calls?: unknown;
+}>): ContextLayerEstimate;
+//# sourceMappingURL=context-tool-hygiene.d.ts.map

package/dist/context-tool-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tool-hygiene.d.ts","sourceRoot":"","sources":["../src/context-tool-hygiene.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACxE,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAmCR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAiBR;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACzE,oBAAoB,CAiCtB"}

package/dist/context-tool-hygiene.js

@@ -0,0 +1,125 @@
+// ============================================================
+// Phase 3.0 — 工具结果上下文卫生
+// 默认折叠超长 tool output，保留头尾 + 元数据，避免每轮 payload 膨胀。
+// QLING_TOOL_RESULT_MAX_CHARS: 默认 6000；0 = 不截断
+// ============================================================
+const DEFAULT_MAX = 6000;
+const DEFAULT_HEAD = 2400;
+const DEFAULT_TAIL = 1200;
+export function resolveToolResultMaxChars(env = process.env) {
+    const raw = env.QLING_TOOL_RESULT_MAX_CHARS;
+    if (raw === undefined || raw === "")
+        return DEFAULT_MAX;
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return DEFAULT_MAX;
+    if (n <= 0)
+        return 0;
+    return Math.floor(n);
+}
+/**
+ * 折叠超长纯文本工具输出。短文本原样返回。
+ */
+export function summarizeToolOutputForContext(output, options = {}) {
+    const maxChars = options.maxChars ?? DEFAULT_MAX;
+    if (maxChars <= 0)
+        return output;
+    if (output.length <= maxChars)
+        return output;
+    const lines = output.split("\n").length;
+    const requestedHead = Math.max(0, options.headChars ?? DEFAULT_HEAD);
+    const requestedTail = Math.max(0, options.tailChars ?? DEFAULT_TAIL);
+    const markerFor = (omitted) => `\n…[已截断: 共 ${output.length} 字符 / ${lines} 行，省略约 ${Math.max(0, omitted)} 字符；` +
+        `需要全文请用 read/search 定位，或调高 QLING_TOOL_RESULT_MAX_CHARS]…\n`;
+    let marker = markerFor(output.length);
+    if (marker.length >= maxChars) {
+        return `…[已截断 ${output.length} 字符]…`.slice(0, maxChars);
+    }
+    const requestedTotal = requestedHead + requestedTail;
+    const bodyBudget = maxChars - marker.length;
+    let headChars = requestedTotal > 0
+        ? Math.min(requestedHead, Math.ceil((bodyBudget * requestedHead) / requestedTotal))
+        : Math.ceil(bodyBudget / 2);
+    let tailChars = Math.min(requestedTail, bodyBudget - headChars);
+    if (requestedTotal === 0)
+        tailChars = bodyBudget - headChars;
+    marker = markerFor(output.length - headChars - tailChars);
+    const overflow = headChars + marker.length + tailChars - maxChars;
+    if (overflow > 0) {
+        const trimTail = Math.min(tailChars, overflow);
+        tailChars -= trimTail;
+        headChars = Math.max(0, headChars - (overflow - trimTail));
+    }
+    return output.slice(0, headChars) + marker + output.slice(-tailChars || output.length);
+}
+/**
+ * 将 tool 消息 content（可能是 JSON.stringify(result)）做卫生处理。
+ * 保持 is_error / tool_call_id 等结构字段。
+ */
+export function prepareToolResultContent(content, options = {}) {
+    const maxChars = options.maxChars ?? DEFAULT_MAX;
+    if (maxChars <= 0)
+        return content;
+    try {
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && typeof parsed.output === "string") {
+            const next = {
+                ...parsed,
+                output: summarizeToolOutputForContext(parsed.output, options),
+            };
+            return JSON.stringify(next);
+        }
+    }
+    catch {
+        // plain text tool content
+    }
+    return summarizeToolOutputForContext(content, options);
+}
+function messageChars(msg) {
+    let n = typeof msg.content === "string" ? msg.content.length : 0;
+    if (msg.tool_calls) {
+        try {
+            n += JSON.stringify(msg.tool_calls).length;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return n;
+}
+/**
+ * 本地字符层估计（非 provider token）。用于 /context harness 可见性。
+ */
+export function estimateContextLayers(messages) {
+    let historyChars = 0;
+    let toolOutputChars = 0;
+    let otherChars = 0;
+    let toolMessageCount = 0;
+    for (const msg of messages) {
+        const c = messageChars(msg);
+        const role = msg.role ?? "";
+        if (role === "tool") {
+            toolOutputChars += c;
+            toolMessageCount++;
+        }
+        else if (role === "user" || role === "assistant") {
+            historyChars += c;
+        }
+        else {
+            otherChars += c;
+        }
+    }
+    const totalChars = historyChars + toolOutputChars + otherChars || 1;
+    const pct = (n) => Math.round((n / totalChars) * 1000) / 10;
+    return {
+        historyChars,
+        toolOutputChars,
+        otherChars,
+        totalChars: historyChars + toolOutputChars + otherChars,
+        historyPct: pct(historyChars),
+        toolOutputPct: pct(toolOutputChars),
+        otherPct: pct(otherChars),
+        messageCount: messages.length,
+        toolMessageCount,
+    };
+}

package/dist/dashboard/client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/dashboard/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/dashboard/client.ts"],"names":[],"mappings":""}