qlogicagent 2.18.2 → 2.18.3

package/dist/types/skills/memory/task-distillation.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Task distillation (R3, 记忆体系 v2) — 任务后蒸馏的纯逻辑层。
+ * spec: xiaozhiclaw-runtime/docs/memory-layering-and-distillation-spec.md
+ *
+ * 蒸馏对象 = "费了劲才做成的任务的做法"(程序性配方),绝不是每轮都跑:
+ *   候选采集(回合完成,轻量) → 空闲窗聚类(签名 embedding,宁严勿松) →
+ *   簇 ≥ 重复阈值才产 1 条 procedure 记忆 → 高复用晋升技能(见 coordinator)。
+ * 成功闸不用 LLM 自评:正常终态 + 同 session 近窗内未被"重做"(在线否决)。
+ * 与 feedback-distillation(反馈域)无关 —— 这里蒸馏的是任务执行模式。
+ */
+/** 同模式判定的余弦下限。错聚有害(把不同任务蒸成一份配方),漏聚无害(下次再攒)。 */
+export declare const TASK_DISTILL_CLUSTER_SIM = 0.86;
+/** 在线否决窗口:同 session 内距离 ≤N 回合出现高相似任务 = 前一次疑似被重做(纠正信号)。 */
+export declare const TASK_DISTILL_REDO_WINDOW_TURNS = 3;
+/** 候选滚动上限(jsonl 只保留最近 N 条,防无界增长)。 */
+export declare const TASK_DISTILL_MAX_CANDIDATES = 200;
+/** 晋升推荐阈值:procedure 被召回复用 ≥N 次且未被负反馈沉底。 */
+export declare const TASK_DISTILL_PROMOTE_ACCESS = 3;
+export declare const PROCEDURE_TAG = "distilled@v1";
+export declare const PROCEDURE_CATEGORY = "procedure";
+export interface TaskCandidate {
+    id: string;
+    sessionId: string;
+    /** session 内回合序号(在线否决的距离度量) */
+    turnIndex: number;
+    /** 任务首句(user prompt 头部,签名文本) */
+    promptHead: string;
+    toolCallCount: number;
+    distinctToolCount: number;
+    /** 工具调用序列(name 有序去连续重复),配方步骤的原料 */
+    toolSequence: string[];
+    durationMs: number;
+    at: number;
+    /** 签名 embedding(bge-m3);无 embedding 的候选不参与聚类(宁严勿松) */
+    embedding?: number[];
+    status: "pending" | "rejected" | "distilled";
+}
+export interface CandidateStoreFile {
+    candidates: TaskCandidate[];
+}
+export declare function candidateStorePath(profileMemoryDir: string): string;
+export declare function readCandidateStore(path: string): CandidateStoreFile;
+export declare function writeCandidateStore(path: string, store: CandidateStoreFile): void;
+export declare function cosine(a: readonly number[], b: readonly number[]): number;
+export interface CollectInput {
+    id: string;
+    sessionId: string;
+    turnIndex: number;
+    promptHead: string;
+    toolCallCount: number;
+    distinctToolCount: number;
+    toolSequence: string[];
+    durationMs: number;
+    at: number;
+    embedding?: number[];
+    /** 回合终态:非正常终态的任务不候选(成功闸①) */
+    ok: boolean;
+}
+export interface CollectResult {
+    accepted: boolean;
+    /** 被本次采集在线否决(疑似被重做)的旧候选 id */
+    rejectedIds: string[];
+    reason?: string;
+}
+/**
+ * 采集一个回合为蒸馏候选。
+ * 在线否决(成功闸②):同 session、距离 ≤REDO_WINDOW 回合内出现高相似新任务,
+ * 视为前一次被重做/纠正 —— 否决旧候选(新候选照常入列,它可能是成功版)。
+ * 跨 session 或距离更远的相似 = 模式重复,恰是蒸馏想要的信号,全部保留。
+ */
+export declare function collectCandidate(store: CandidateStoreFile, input: CollectInput): CollectResult;
+export declare function clusterCandidates(store: CandidateStoreFile): TaskCandidate[][];
+/** 压缩工具序列:去连续重复,保顺序。 */
+export declare function compressToolSequence(seq: readonly string[]): string[];
+export declare function clusterSignature(cluster: readonly TaskCandidate[]): string;
+export declare function renderProcedureFallback(cluster: readonly TaskCandidate[]): string;
+/** reverted = 升格后被撤销(降格) —— 与"暂不"(dismissed)分开计,是降格率仪表的分子。 */
+export type PromotionStatus = "proposed" | "accepted" | "dismissed" | "reverted";
+export interface PromotionProposal {
+    procedureId: string;
+    /** 配方首行(展示用) */
+    title: string;
+    accessCount: number;
+    proposedAt: number;
+    status: PromotionStatus;
+    /** 状态变迁时间(度量面:接受率/响应时长的数据源) */
+    resolvedAt?: number;
+    /** accepted 时记录升格产出的技能名(demote 反查) */
+    skillName?: string;
+    /** V3.3 自动档升格(非用户点击) */
+    auto?: boolean;
+    /** 自动升格的开场确认卡已读(「知道了」) */
+    acknowledgedAt?: number;
+}
+export interface PromotionStoreFile {
+    proposals: PromotionProposal[];
+}
+export declare function promotionStorePath(profileMemoryDir: string): string;
+export declare function readPromotionStore(path: string): PromotionStoreFile;
+export declare function writePromotionStore(path: string, store: PromotionStoreFile): void;
+/** 达标条目 upsert 为提议。dismissed/accepted 是终态,永不复活(拍板②:暂不=不再打扰)。
+ * 已 proposed 的只刷新 accessCount。返回是否新增。 */
+export declare function upsertProposal(store: PromotionStoreFile, input: {
+    procedureId: string;
+    title: string;
+    accessCount: number;
+    now: number;
+}): boolean;
+export declare function resolveProposal(store: PromotionStoreFile, procedureId: string, status: "accepted" | "dismissed", now: number): boolean;
+/** 降格:accepted → reverted(区分"暂不";降格率=reverted/accepted 家族)。 */
+export declare function revertProposal(store: PromotionStoreFile, procedureId: string, now: number): PromotionProposal | null;
+/** 配方文本 → SKILL.md 的确定性降级模板(LLM 格式转换失败时兜底)。 */
+export declare function renderSkillMarkdownFallback(name: string, procedureText: string): string;
+/** 自动档解锁条件(拍板③):样本、接受率、降格率。 */
+export declare const V3_AUTO_MIN_SAMPLES = 10;
+export declare const V3_AUTO_MIN_ACCEPT_RATE = 0.7;
+export declare const V3_AUTO_MAX_REVERT_RATE = 0.1;
+/** 自动档触发严阈值(拍板④,比手动档 3 更严)。 */
+export declare const V3_AUTO_MIN_ACCESS = 5;
+export declare const V3_AUTO_MIN_SESSIONS = 3;
+export interface ProcedureUsage {
+    /** 召回复用过它的 session 集合 */
+    sessions: string[];
+    /** 复用后回合失败次数(零容忍:自动档要求 0) */
+    negativeCount: number;
+}
+export interface ProcedureUsageStoreFile {
+    usage: Record<string, ProcedureUsage>;
+}
+export declare function procedureUsagePath(profileMemoryDir: string): string;
+export declare function readProcedureUsage(path: string): ProcedureUsageStoreFile;
+export declare function writeProcedureUsage(path: string, store: ProcedureUsageStoreFile): void;
+export declare function recordProcedureRecall(store: ProcedureUsageStoreFile, procedureId: string, sessionId: string): void;
+export declare function recordProcedureNegative(store: ProcedureUsageStoreFile, procedureId: string): void;
+export interface PromotionMetrics {
+    samples: number;
+    accepted: number;
+    dismissed: number;
+    reverted: number;
+    acceptRate: number;
+    revertRate: number;
+    autoEnabled: boolean;
+}
+/** 手动阶段仪表(拍板③):接受率=accepted 家族/已决样本;降格率=reverted/accepted 家族。
+ * 任何时刻降格率回升超限即自动退回手动档(autoEnabled 现算,无粘滞)。 */
+export declare function computePromotionMetrics(proposals: readonly PromotionProposal[]): PromotionMetrics;
+/** 自动档严阈值(拍板④):复用 ≥5 + 跨 ≥3 session + 零负反馈。 */
+export declare function qualifiesForAutoPromotion(accessCount: number, usage: ProcedureUsage | undefined): boolean;

package/dist/types/skills/tools/search-tool.d.ts

@@ -105,6 +105,12 @@ export interface SearchToolDeps {
             contextAfter?: string[];
         }>;
         truncated: boolean;
+        /**
+         * Optional incompleteness note from the backend (e.g. the search process was
+         * killed by timeout/output cap). Appended verbatim to the model-visible
+         * content — details alone would be silent to the model.
+         */
+        note?: string;
     }>;
     /** Resolve relative path to absolute. If omitted, cwd is used. */
     resolvePath?(input: string): string;

package/dist/types/skills/tools/shell/task-output.d.ts

@@ -30,6 +30,8 @@ export declare class TaskOutput {
     /** Get captured stderr. In file mode stderr is interleaved with stdout. */
     getStderr(): string;
     get outputFileSize(): number;
+    /** Non-null when the last spill-to-disk attempt failed (output only in memory). */
+    get spillError(): string | null;
     /**
      * Whether the output file content is fully contained in getStdout().
      * If true, the file can be deleted.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.18.2",
+  "version": "2.18.3",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",

package/dist/types/agent/tool-loop/skill-instruction-policy.d.ts

@@ -1,7 +0,0 @@
-import { buildSkillInstruction } from "../../orchestration/index.js";
-export interface SkillInstructionPolicyInput {
-    totalToolCallCount: number;
-    distinctToolNames: ReadonlySet<string>;
-    projectRoot?: string;
-}
-export declare function resolveToolUsageSkillInstruction(input: SkillInstructionPolicyInput): ReturnType<typeof buildSkillInstruction>;

package/dist/types/agent/tool-loop/tool-guardrails.d.ts

@@ -1,24 +0,0 @@
-export type ToolGuardrailLevel = "allow" | "warn" | "block" | "halt";
-export type ToolGuardrailReason = "exact_failure_repeat" | "same_tool_failure_repeat" | "idempotent_no_progress";
-export interface ToolGuardrailDecision {
-    level: ToolGuardrailLevel;
-    reason?: ToolGuardrailReason;
-    message?: string;
-}
-export interface ToolGuardrailConfig {
-    warnAfter?: number;
-    blockAfter?: number;
-    haltAfter?: number;
-}
-export declare class ToolCallGuardrailController {
-    private exact;
-    private sameToolFailures;
-    private readonly config;
-    constructor(config?: ToolGuardrailConfig);
-    record(input: {
-        toolName: string;
-        argumentsJson: string;
-        ok: boolean;
-        message: unknown;
-    }): ToolGuardrailDecision;
-}

package/dist/types/cli/turn-skill-autopersist.d.ts

@@ -1,22 +0,0 @@
-export interface TurnSkillAutoPersistHost {
-    log(message: string): void;
-}
-export type AutoPersistResult = {
-    status: "ignored";
-} | {
-    status: "exists";
-    skillPath: string;
-} | {
-    status: "created";
-    skillPath: string;
-} | {
-    status: "skipped";
-    skillPath: string;
-    reason: string;
-};
-export declare function maybeAutoPersistSkillInstruction(params: {
-    instruction: unknown;
-    eventTurnId: string;
-    projectRoot: string;
-    host: TurnSkillAutoPersistHost;
-}): Promise<AutoPersistResult>;