qlogicagent 2.18.2 → 2.18.4

package/dist/types/skills/memory/sqlite-memory-schema.d.ts

@@ -1,3 +1,11 @@
 import type { SqliteDatabase } from "./local-store-records.js";
-export declare const MEMORY_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  text TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  source TEXT NOT NULL DEFAULT 'agent',\n  session_id TEXT NOT NULL DEFAULT '',\n  event_date TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  embedding BLOB,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed_at INTEGER NOT NULL DEFAULT 0,\n  is_archived INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);\nCREATE INDEX IF NOT EXISTS idx_memories_user_category ON memories(user_id, category);\nCREATE INDEX IF NOT EXISTS idx_memories_user_importance ON memories(user_id, importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);\n\nCREATE TABLE IF NOT EXISTS memory_observations (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  session_id TEXT NOT NULL DEFAULT '',\n  evidence_type TEXT NOT NULL DEFAULT 'text',\n  payload TEXT NOT NULL DEFAULT '{}',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_observations_user_created ON memory_observations(user_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_memory_observations_source ON memory_observations(user_id, source);\n\nCREATE TABLE IF NOT EXISTS memory_proposals (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  observation_ids TEXT NOT NULL DEFAULT '[]',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  valid_time TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  status TEXT NOT NULL DEFAULT 'pending',\n  related_claim_ids TEXT NOT NULL DEFAULT '[]',\n  idempotency_key TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_user_status ON memory_proposals(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_fact ON memory_proposals(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_claims (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'active',\n  valid_time TEXT NOT NULL DEFAULT '',\n  evidence_ids TEXT NOT NULL DEFAULT '[]',\n  supersedes_claim_id TEXT NOT NULL DEFAULT '',\n  conflict_group_id TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_claims_user_status ON memory_claims(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_memory ON memory_claims(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_fact ON memory_claims(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_conflicts (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  claim_a_id TEXT NOT NULL,\n  claim_b_id TEXT NOT NULL,\n  reason TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'open',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_conflicts_user_status ON memory_conflicts(user_id, status);\n\nCREATE TABLE IF NOT EXISTS memory_attachments (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'file',\n  filename TEXT NOT NULL DEFAULT '',\n  mime_type TEXT NOT NULL DEFAULT '',\n  size INTEGER NOT NULL DEFAULT 0,\n  rel_path TEXT NOT NULL,\n  extracted_text TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_memory ON memory_attachments(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_orphan ON memory_attachments(user_id, memory_id, created_at);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(\n  id UNINDEXED,\n  user_id UNINDEXED,\n  text,\n  category,\n  tags,\n  content=memories,\n  content_rowid=rowid,\n  tokenize='unicode61 remove_diacritics 2'\n);\n\nCREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n";
+export declare const MEMORY_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  text TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  source TEXT NOT NULL DEFAULT 'agent',\n  session_id TEXT NOT NULL DEFAULT '',\n  event_date TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  embedding BLOB,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed_at INTEGER NOT NULL DEFAULT 0,\n  is_archived INTEGER NOT NULL DEFAULT 0,\n  text_seg TEXT NOT NULL DEFAULT '',\n  embedding_model TEXT NOT NULL DEFAULT '',\n  embedding_dims INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);\nCREATE INDEX IF NOT EXISTS idx_memories_user_category ON memories(user_id, category);\nCREATE INDEX IF NOT EXISTS idx_memories_user_importance ON memories(user_id, importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);\n\nCREATE TABLE IF NOT EXISTS memory_observations (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  session_id TEXT NOT NULL DEFAULT '',\n  evidence_type TEXT NOT NULL DEFAULT 'text',\n  payload TEXT NOT NULL DEFAULT '{}',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_observations_user_created ON memory_observations(user_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_memory_observations_source ON memory_observations(user_id, source);\n\nCREATE TABLE IF NOT EXISTS memory_proposals (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  observation_ids TEXT NOT NULL DEFAULT '[]',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  valid_time TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  status TEXT NOT NULL DEFAULT 'pending',\n  related_claim_ids TEXT NOT NULL DEFAULT '[]',\n  idempotency_key TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_user_status ON memory_proposals(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_fact ON memory_proposals(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_claims (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'active',\n  valid_time TEXT NOT NULL DEFAULT '',\n  evidence_ids TEXT NOT NULL DEFAULT '[]',\n  supersedes_claim_id TEXT NOT NULL DEFAULT '',\n  conflict_group_id TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_claims_user_status ON memory_claims(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_memory ON memory_claims(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_fact ON memory_claims(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_conflicts (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  claim_a_id TEXT NOT NULL,\n  claim_b_id TEXT NOT NULL,\n  reason TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'open',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_conflicts_user_status ON memory_conflicts(user_id, status);\n\nCREATE TABLE IF NOT EXISTS memory_attachments (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'file',\n  filename TEXT NOT NULL DEFAULT '',\n  mime_type TEXT NOT NULL DEFAULT '',\n  size INTEGER NOT NULL DEFAULT 0,\n  rel_path TEXT NOT NULL,\n  extracted_text TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_memory ON memory_attachments(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_orphan ON memory_attachments(user_id, memory_id, created_at);\n\n";
+/**
+ * FTS index + sync triggers, kept as a separate DDL block because the CJK
+ * migration below must DROP and re-create exactly this set — a second copy
+ * would drift. The index covers the pre-segmented shadow column `text_seg`
+ * (see fts-segment.ts), NOT raw `text`: unicode61 cannot segment CJK, so raw
+ * Chinese text is unsearchable by keyword.
+ */
+export declare const MEMORY_FTS_SCHEMA_SQL = "\nCREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(\n  id UNINDEXED,\n  user_id UNINDEXED,\n  text_seg,\n  category,\n  tags,\n  content=memories,\n  content_rowid=rowid,\n  tokenize='unicode61 remove_diacritics 2'\n);\n\nCREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN\n  INSERT INTO memories_fts(rowid, id, user_id, text_seg, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text_seg, new.category, new.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text_seg, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text_seg, old.category, old.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text_seg, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text_seg, old.category, old.tags);\n  INSERT INTO memories_fts(rowid, id, user_id, text_seg, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text_seg, new.category, new.tags);\nEND;\n";
 export declare function initializeMemorySchema(db: SqliteDatabase): void;

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.4",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -70,12 +70,13 @@
     "start": "node dist/cli.js",
     "test": "vitest run",
     "test:replay": "vitest run benchmarks/transcript-replay",
-    "check": "pnpm run check:encoding-corruption && pnpm run check:mechanical-rules && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
+    "check": "pnpm run check:encoding-corruption && pnpm run check:mechanical-rules && pnpm run check:windows-hide && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
     "test:watch": "vitest",
     "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
     "lint": "oxlint .",
     "check:encoding-corruption": "node scripts/check-encoding-corruption.mjs",
     "check:mechanical-rules": "node scripts/check-mechanical-rules.mjs",
+    "check:windows-hide": "node scripts/check-windows-hide.mjs src",
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
     "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
     "check:provider-core-release-sync": "node scripts/check-provider-core-release-sync.mjs",

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/tool-bootstrap-community-registration.d.ts

@@ -1,9 +0,0 @@
-import type { PortableTool } from "../skills/portable-tool.js";
-import { type CommunityDiscoveryResult } from "../runtime/community/community-discovery-coordinator.js";
-export interface LocalCommunityToolRegistrationContext {
-    tools: PortableTool<any>[];
-    /** 测试可注入的发现实现;默认从 env consent client 构造协调器。 */
-    discover?: (intent: string) => Promise<CommunityDiscoveryResult>;
-}
-export declare const localCommunityToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<LocalCommunityToolRegistrationContext>;
-export declare function registerLocalCommunityTools(context: LocalCommunityToolRegistrationContext): void;

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>;

package/dist/types/runtime/community/community-discovery-cache.d.ts

@@ -1,24 +0,0 @@
-import type { CommunityRegistryMatchResult } from "./community-consent-client.js";
-export interface CommunityDiscoveryCacheEntry {
-    intentKey: string;
-    resourceId: string;
-    type: string;
-    title: string;
-    summary: string;
-    sourceTier: string;
-    trustStage: string;
-    effectiveRiskTier: string;
-    latestVersion: string | null;
-    cachedAt: string;
-}
-export interface CommunityDiscoveryCacheOptions {
-    ownerUserId?: string;
-    filePath?: string;
-}
-export declare class CommunityDiscoveryCache {
-    private readonly filePath;
-    constructor(options?: CommunityDiscoveryCacheOptions);
-    readAll(): CommunityDiscoveryCacheEntry[];
-    find(intentKey: string): CommunityDiscoveryCacheEntry | undefined;
-    writeMatch(intentKey: string, match: CommunityRegistryMatchResult, now?: Date): CommunityDiscoveryCacheEntry;
-}

package/dist/types/runtime/community/community-discovery-coordinator.d.ts

@@ -1,33 +0,0 @@
-import type { CommunityConsentClient, CommunityRegistryMatchResult } from "./community-consent-client.js";
-import { CommunityDiscoveryCache, type CommunityDiscoveryCacheEntry } from "./community-discovery-cache.js";
-export interface LocalCommunityResourceIndex {
-    findInstalled(intentKey: string): CommunityRegistryMatchResult | undefined;
-}
-export type CommunityDiscoveryStatus = "matched" | "local" | "cached" | "miss" | "disabled" | "unavailable";
-export interface CommunityDiscoveryResult {
-    status: CommunityDiscoveryStatus;
-    intentKey: string;
-    match?: CommunityRegistryMatchResult;
-    cacheEntry?: CommunityDiscoveryCacheEntry;
-    error?: string;
-}
-export interface CommunityDiscoveryCoordinatorOptions {
-    client: Pick<CommunityConsentClient, "matchRegistry"> | null;
-    cache?: CommunityDiscoveryCache;
-    localIndex?: LocalCommunityResourceIndex;
-    topK?: number;
-    now?: () => Date;
-}
-export declare class CommunityDiscoveryCoordinator {
-    private readonly client;
-    private readonly cache;
-    private readonly localIndex?;
-    private readonly topK;
-    private readonly now;
-    private readonly inMemory;
-    constructor(options: CommunityDiscoveryCoordinatorOptions);
-    matchForTurn(intent: string): Promise<CommunityDiscoveryResult>;
-    prefetchIdle(intents: string[]): Promise<CommunityDiscoveryResult[]>;
-    private memo;
-}
-export declare function normalizeDiscoveryIntent(intent: string): string;

package/dist/types/runtime/hooks/community-discovery-hook.d.ts

@@ -1,18 +0,0 @@
-import type { HookRegistry } from "../../contracts/hooks.js";
-import type { CommunityDiscoveryCoordinator } from "../community/community-discovery-coordinator.js";
-export interface CommunityDiscoveryHookDeps {
-    /** Online community discovery coordinator (null disables discovery). */
-    communityDiscovery?: CommunityDiscoveryCoordinator | null;
-    /** Logger. */
-    log: {
-        debug(msg: string): void;
-        warn(msg: string): void;
-    };
-}
-/**
- * Register the community-discovery hook on `memory.before_recall`.
- * Runs at lower priority (60) than QMemory prefetch (50) so it supplements,
- * not replaces, the standard memory recall. When a Hub resource matches the
- * turn, its metadata is injected into recalledMemories as a suggestion.
- */
-export declare function registerCommunityDiscoveryHook(hooks: HookRegistry, deps: CommunityDiscoveryHookDeps): () => void;

package/dist/types/skills/tools/community-seek-tool.d.ts

@@ -1,49 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { CommunityDiscoveryResult, CommunityDiscoveryStatus } from "../../runtime/community/community-discovery-coordinator.js";
-import type { CommunityInstallRiskTier, CommunityInstallSourceTier, CommunityInstallTrustStage, CommunityRegistryMatchResult } from "../../runtime/community/community-consent-client.js";
-export declare const COMMUNITY_SEEK_TOOL_NAME: "community_seek";
-export interface CommunitySeekParams {
-    intent: string;
-}
-export interface CommunitySeekPackageCandidate {
-    kind: "package";
-    id: string;
-    title: string;
-    summary: string;
-    capabilityTags: string[];
-    sourceTier: CommunityInstallSourceTier;
-    trustStage: CommunityInstallTrustStage;
-    effectiveRiskTier: CommunityInstallRiskTier;
-    latestVersion: string | null;
-}
-/** 轻回执:落进对话的可折叠"去社区找了个 X"(展示侧由 UI 渲染)。 */
-export interface CommunitySeekReceipt {
-    intent: string;
-    status: CommunityDiscoveryStatus;
-    packageCount: number;
-    topTitle?: string;
-}
-export interface CommunitySeekResult {
-    status: CommunityDiscoveryStatus;
-    intent: string;
-    packages: CommunitySeekPackageCandidate[];
-}
-export interface CommunitySeekDeps {
-    /** 发现协调器:本地前置 + consent + 缓存 + ≤1 次 O(1) registry_match。 */
-    discover(intent: string): Promise<CommunityDiscoveryResult>;
-    /** 轻回执 sink(对话侧渲染);best-effort,抛错不影响工具结果。 */
-    onReceipt?(receipt: CommunitySeekReceipt): void;
-}
-export declare function toPackageCandidate(match: CommunityRegistryMatchResult): CommunitySeekPackageCandidate;
-export declare function runCommunitySeek(deps: CommunitySeekDeps, params: CommunitySeekParams): Promise<CommunitySeekResult>;
-export declare const COMMUNITY_SEEK_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly intent: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["intent"];
-};
-export declare function createCommunitySeekTool(deps: CommunitySeekDeps): PortableTool<CommunitySeekParams>;