skyloom 1.5.3 → 1.7.0

package/dist/core/estimate.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * 资源估算模块 — Token & time budget estimation for task planning.
+ *
+ * Helps Snow and other planning agents estimate the cost of
+ * proposed sub-tasks before committing to execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateTokens = estimateTokens;
+exports.estimateTaskCost = estimateTaskCost;
+exports.estimateTaskPlan = estimateTaskPlan;
+exports.formatPlanEstimate = formatPlanEstimate;
+/* ═══════════════════════════════════════
+   Token estimation
+   ═══════════════════════════════════════ */
+const CJK_REGEX = /[一-鿿぀-ゟ가-힯㐀-䶿]/g;
+/** Estimate tokens for a given text (CJK ~2 each, ASCII ~4 chars each). */
+function estimateTokens(text) {
+    const cjk = (text.match(CJK_REGEX) || []).length;
+    return cjk * 2 + Math.ceil((text.length - cjk) / 4);
+}
+/* ═══════════════════════════════════════
+   Per-task-type cost estimates
+   ═══════════════════════════════════════ */
+const TASK_TYPE_PATTERNS = [
+    // [pattern, estimated tokens, estimated tools]
+    [/read|read_file|grep|search|查|搜索|list/i, 2000, 2],
+    [/write|write_file|生成|写|create|implement/i, 4000, 5],
+    [/edit|edit_file|改|修改|fix|修复/i, 3000, 3],
+    [/delete|delete_file|删|rm/i, 1500, 2],
+    [/deploy|部署|publish|发布|release/i, 8000, 8],
+    [/review|审查|audit|审计|scan|扫描/i, 5000, 4],
+    [/test|测试|run_test|coverage/i, 3000, 3],
+    [/research|研究|调研|analyze|分析/i, 6000, 4],
+    [/orchestrate|编排|multi-step|多步/i, 12000, 10],
+];
+/** Estimate cost for a single task description. */
+function estimateTaskCost(description) {
+    let tokens = 2000; // base
+    let tools = 2; // base
+    for (const [pattern, t, tc] of TASK_TYPE_PATTERNS) {
+        if (pattern.test(description)) {
+            tokens = Math.max(tokens, t);
+            tools = Math.max(tools, tc);
+        }
+    }
+    // Time estimate: ~0.5s per tool call + 2s per 1k tokens
+    const timeSeconds = (tokens / 1000) * 2 + tools * 0.5 + 2;
+    return { tokens, tools, timeSeconds };
+}
+function estimateTaskPlan(tasks) {
+    const perTask = [];
+    let totalTokens = 500; // system prompt overhead
+    let totalTools = 0;
+    let totalTime = 5; // init overhead
+    const warnings = [];
+    for (const t of tasks) {
+        const est = estimateTaskCost(t.description);
+        perTask.push({ id: t.id, tokens: est.tokens, tools: est.tools, time: est.timeSeconds });
+        totalTokens += est.tokens;
+        totalTools += est.tools;
+        totalTime += est.timeSeconds;
+        if (est.timeSeconds > 60)
+            warnings.push(`Task ${t.id} may take >${Math.round(est.timeSeconds)}s`);
+        if (est.tools > 10)
+            warnings.push(`Task ${t.id} uses many tool calls (${est.tools})`);
+    }
+    if (totalTokens > 64000)
+        warnings.push(`Total token estimate (${totalTokens}) exceeds typical context window`);
+    if (totalTime > 120)
+        warnings.push(`Estimated total time (${Math.round(totalTime)}s) is significant`);
+    if (tasks.length > 6)
+        warnings.push(`Large number of sub-tasks (${tasks.length}) — consider merging simpler ones`);
+    return { totalTokens, totalTools, totalTimeSeconds: Math.round(totalTime), perTask, warnings };
+}
+/* ═══════════════════════════════════════
+   Format estimate for display
+   ═══════════════════════════════════════ */
+function formatPlanEstimate(est) {
+    const lines = [
+        `## Plan Estimate`,
+        `| Task | Tokens | Tools | Time |`,
+        `|------|--------|-------|------|`,
+        ...est.perTask.map(t => `| ${t.id} | ${t.tokens} | ${t.tools} | ${t.time.toFixed(0)}s |`),
+        `| **Total** | **${est.totalTokens}** | **${est.totalTools}** | **${est.totalTimeSeconds}s** |`,
+    ];
+    if (est.warnings.length > 0) {
+        lines.push("", "### Warnings");
+        for (const w of est.warnings)
+            lines.push(`- ⚠ ${w}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=estimate.js.map

package/dist/core/estimate.js.map

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

package/dist/core/filter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 输出过滤模块 — sensitive information sanitization.
+ *
+ * Before agent responses reach the user (or are persisted),
+ * scan for and redact sensitive patterns like API keys,
+ * tokens, passwords, PII, and internal paths.
+ */
+export interface FilterResult {
+    clean: string;
+    redacted: boolean;
+    count: number;
+    details: string[];
+}
+export declare function filterOutput(text: string): FilterResult;
+export declare function needsFiltering(text: string): boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/core/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/core/filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2CH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAgCvD;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASpD"}

package/dist/core/filter.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * 输出过滤模块 — sensitive information sanitization.
+ *
+ * Before agent responses reach the user (or are persisted),
+ * scan for and redact sensitive patterns like API keys,
+ * tokens, passwords, PII, and internal paths.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterOutput = filterOutput;
+exports.needsFiltering = needsFiltering;
+/* ═══════════════════════════════════════
+   Detection patterns — compiled once at module load
+   ═══════════════════════════════════════ */
+const SENSITIVE_PATTERNS = [
+    // API keys & tokens
+    [/sk-[a-zA-Z0-9]{32,}/g, "[REDACTED:API_KEY]"],
+    [/(?:api_key|apikey|secret_key|access_token|auth_token)\s*[:=]\s*["']?[^\s"']{8,}["']?/gi, "$1: [REDACTED]"],
+    [/ghp_[a-zA-Z0-9]{36}/g, "[REDACTED:GITHUB_TOKEN]"],
+    [/gho_[a-zA-Z0-9]{36}/g, "[REDACTED:GITHUB_TOKEN]"],
+    // AWS credentials
+    [/AKIA[0-9A-Z]{16}/g, "[REDACTED:AWS_KEY]"],
+    [/(?:aws_access_key_id|aws_secret_access_key)\s*[:=]\s*["']?[^\s"']+/gi, "$1: [REDACTED]"],
+    // Passwords
+    [/(?:password|passwd|pwd)\s*[:=]\s*["']?[^\s"']{4,}["']?/gi, "$1: [REDACTED]"],
+    [/(?:密码|口令)\s*[:=]\s*["']?[^\s"']{2,}["']?/g, "$1: [已脱敏]"],
+    // Connection strings
+    [/(?:mongodb|postgres|mysql|redis):\/\/[^\s]+/g, "[REDACTED:DB_URI]"],
+    [/(?:jdbc|odbc):[^\s]+/g, "[REDACTED:DB_URI]"],
+    // Private keys
+    [/-----BEGIN (?:RSA |EC |DSA |OPENSSH )?PRIVATE KEY-----[\s\S]*?-----END .*?PRIVATE KEY-----/g, "[REDACTED:PRIVATE_KEY]"],
+    // IP addresses (local only)
+    [/192\.168\.\d{1,3}\.\d{1,3}/g, "[REDACTED:LAN_IP]"],
+    [/10\.\d{1,3}\.\d{1,3}\.\d{1,3}/g, "[REDACTED:LAN_IP]"],
+    [/172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}/g, "[REDACTED:LAN_IP]"],
+    // File paths
+    [/(?:\/etc\/(?:passwd|shadow|hosts|sudoers))/g, "[REDACTED:SYSTEM_PATH]"],
+];
+/* Email masking (function-based, handled separately) */
+const EMAIL_RE = /([a-zA-Z0-9._%+-]{3,})@([a-zA-Z0-9.-]+\.[a-zA-Z]{2,})/g;
+function filterOutput(text) {
+    if (!text)
+        return { clean: "", redacted: false, count: 0, details: [] };
+    let clean = text;
+    let count = 0;
+    const details = [];
+    // Email masking (function-based replacement)
+    let emailCount = 0;
+    clean = clean.replace(EMAIL_RE, (full, user, domain) => {
+        emailCount++;
+        return user.slice(0, 2) + "***@" + domain;
+    });
+    if (emailCount > 0) {
+        count += emailCount;
+        details.push(`Masked ${emailCount}x email addresses`);
+    }
+    for (const [pattern, replacement] of SENSITIVE_PATTERNS) {
+        const matches = clean.match(pattern);
+        if (matches) {
+            count += matches.length;
+            if (typeof replacement === "string") {
+                details.push(`Redacted ${matches.length}x ${pattern.source.slice(0, 30)}`);
+            }
+            else {
+                details.push(`Masked ${matches.length}x email addresses`);
+            }
+            clean = clean.replace(pattern, replacement);
+        }
+    }
+    return { clean, redacted: count > 0, count, details };
+}
+/* ═══════════════════════════════════════
+   Quick check — is filtering needed?
+   ═══════════════════════════════════════ */
+function needsFiltering(text) {
+    if (!text)
+        return false;
+    // Quick scan with the most common patterns
+    if (/sk-[a-zA-Z0-9]{32,}/.test(text))
+        return true;
+    if (/api_key.*[:=]/.test(text))
+        return true;
+    if (/password.*[:=]/.test(text))
+        return true;
+    if (/-----BEGIN.*PRIVATE KEY-----/.test(text))
+        return true;
+    if (EMAIL_RE.test(text))
+        return true;
+    return false;
+}
+//# sourceMappingURL=filter.js.map

package/dist/core/filter.js.map

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

package/dist/core/index.d.ts

@@ -25,5 +25,11 @@ export * from './skill';
 export * from './router';
 export * from './agent';
 export * from './factory';
-export declare const VERSION = "1.4.0";
+export * from './security';
+export * from './learn';
+export * from './longdoc';
+export * from './filter';
+export * from './estimate';
+export * from './arbitrate';
+export declare const VERSION: any;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACzL,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAG1B,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACzL,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAG5B,eAAO,MAAM,OAAO,KAAgG,CAAC"}

package/dist/core/index.js

@@ -49,6 +49,17 @@ __exportStar(require("./skill"), exports);
 __exportStar(require("./router"), exports);
 __exportStar(require("./agent"), exports);
 __exportStar(require("./factory"), exports);
-// Version
-exports.VERSION = '1.4.0';
+__exportStar(require("./security"), exports);
+__exportStar(require("./learn"), exports);
+__exportStar(require("./longdoc"), exports);
+__exportStar(require("./filter"), exports);
+__exportStar(require("./estimate"), exports);
+__exportStar(require("./arbitrate"), exports);
+// Version — read from package.json
+exports.VERSION = (() => { try {
+    return require('../../package.json').version;
+}
+catch {
+    return '1.6.0';
+} })();
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,4CAA0B;AAC1B,2CAAyB;AACzB,2CAAyB;AACzB,yCAAuB;AACvB,oDAAkC;AAClC,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,wCAAsB;AACtB,yCAAyL;AAAhL,0GAAA,aAAa,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,4GAAA,eAAe,OAAA;AACjI,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,8CAA4B;AAC5B,4CAA0B;AAC1B,gDAA8B;AAC9B,kDAAgC;AAChC,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAE1B,UAAU;AACG,QAAA,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,4CAA0B;AAC1B,2CAAyB;AACzB,2CAAyB;AACzB,yCAAuB;AACvB,oDAAkC;AAClC,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,wCAAsB;AACtB,yCAAyL;AAAhL,0GAAA,aAAa,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,4GAAA,eAAe,OAAA;AACjI,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,8CAA4B;AAC5B,4CAA0B;AAC1B,gDAA8B;AAC9B,kDAAgC;AAChC,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB;AACxB,4CAA0B;AAC1B,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAE5B,mCAAmC;AACtB,QAAA,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAAC,OAAO,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,OAAO,CAAC;AAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC"}

package/dist/core/learn.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 持续学习模块 — post-task review + experience recording.
+ *
+ * After each task, the agent writes a structured review.
+ * Failed attempts are indexed for similarity search to avoid repetition.
+ */
+export interface TaskReview {
+    ts: string;
+    agent: string;
+    goal: string;
+    success: boolean;
+    durationMs: number;
+    toolCalls: string[];
+    errorMsg?: string;
+    rootCause?: string;
+    improvement?: string;
+}
+export interface ExperienceEntry {
+    id: string;
+    pattern: string;
+    solution: string;
+    frequency: number;
+    lastSeen: string;
+}
+export declare function recordReview(review: TaskReview): void;
+export declare function recordExperience(errorPattern: string, rootCause: string, solution: string): void;
+export declare function queryExperiences(problem: string, limit?: number): ExperienceEntry[];
+export declare function formatExperiencesForPrompt(problem: string): string;
+export declare function generateReview(agent: string, goal: string, success: boolean, durationMs: number, toolCalls: string[], errorMsg?: string): TaskReview;
+//# sourceMappingURL=learn.d.ts.map

package/dist/core/learn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/core/learn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAWrD;AAiBD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwBhG;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,eAAe,EAAE,CAatF;AAKD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlE;AAKD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EACjE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GACrC,UAAU,CAQZ"}

package/dist/core/learn.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * 持续学习模块 — post-task review + experience recording.
+ *
+ * After each task, the agent writes a structured review.
+ * Failed attempts are indexed for similarity search to avoid repetition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordReview = recordReview;
+exports.recordExperience = recordExperience;
+exports.queryExperiences = queryExperiences;
+exports.formatExperiencesForPrompt = formatExperiencesForPrompt;
+exports.generateReview = generateReview;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+const log = (0, logger_1.getLogger)("learn");
+/* ── Persistence ── */
+const reviewDir = path.join(config_1.USER_CONFIG_DIR, "reviews");
+const expFile = path.join(config_1.USER_CONFIG_DIR, "experiences.json");
+const reviewDir_ = reviewDir; // for closure
+function ensureDir() { if (!fs.existsSync(reviewDir_))
+    fs.mkdirSync(reviewDir_, { recursive: true }); }
+/* ═══════════════════════════════════════
+   Task Review Recording
+   ═══════════════════════════════════════ */
+function recordReview(review) {
+    ensureDir();
+    const file = path.join(reviewDir_, `${review.ts.slice(0, 10)}_${review.agent}.jsonl`);
+    const line = JSON.stringify(review);
+    fs.appendFileSync(file, line + "\n");
+    log.debug("review_recorded", { agent: review.agent, success: review.success });
+    // If failed, also record as experience
+    if (!review.success && review.errorMsg) {
+        recordExperience(review.errorMsg, review.rootCause || "unknown", review.improvement || "no improvement noted");
+    }
+}
+/* ═══════════════════════════════════════
+   Experience Recording (for failure patterns)
+   ═══════════════════════════════════════ */
+function loadExperiences() {
+    try {
+        if (fs.existsSync(expFile))
+            return JSON.parse(fs.readFileSync(expFile, "utf-8"));
+    }
+    catch { /* ignore */ }
+    return [];
+}
+function saveExperiences(entries) {
+    ensureDir();
+    fs.writeFileSync(expFile, JSON.stringify(entries, null, 2), "utf-8");
+}
+function recordExperience(errorPattern, rootCause, solution) {
+    const entries = loadExperiences();
+    const normalized = errorPattern.toLowerCase().slice(0, 200);
+    // Check for existing similar pattern (simple substring match)
+    const existing = entries.find(e => e.pattern.toLowerCase().includes(normalized.slice(0, 50)) || normalized.includes(e.pattern.toLowerCase().slice(0, 50)));
+    if (existing) {
+        existing.frequency++;
+        existing.lastSeen = new Date().toISOString();
+        if (solution && solution !== "no improvement noted")
+            existing.solution = solution;
+    }
+    else {
+        entries.push({
+            id: Math.random().toString(36).slice(2, 10),
+            pattern: errorPattern.slice(0, 200),
+            solution,
+            frequency: 1,
+            lastSeen: new Date().toISOString(),
+        });
+    }
+    // Keep top 100 experiences, sorted by frequency
+    entries.sort((a, b) => b.frequency - a.frequency);
+    if (entries.length > 100)
+        entries.splice(100);
+    saveExperiences(entries);
+}
+/* ═══════════════════════════════════════
+   Query experiences
+   ═══════════════════════════════════════ */
+function queryExperiences(problem, limit = 3) {
+    const entries = loadExperiences();
+    const lower = problem.toLowerCase();
+    return entries
+        .filter(e => {
+        const plow = e.pattern.toLowerCase();
+        // Simple token overlap scoring
+        const tokens = lower.split(/\s+/).filter(t => t.length > 2);
+        const matches = tokens.filter(t => plow.includes(t));
+        return matches.length >= 2;
+    })
+        .sort((a, b) => b.frequency - a.frequency)
+        .slice(0, limit);
+}
+/* ═══════════════════════════════════════
+   Format experiences for system prompt injection
+   ═══════════════════════════════════════ */
+function formatExperiencesForPrompt(problem) {
+    const exps = queryExperiences(problem);
+    if (!exps.length)
+        return "";
+    const lines = ["## 历史教训（从经验库检索）", "以下是与当前任务相关的过往失败案例，请避免重复："];
+    for (const e of exps) {
+        lines.push(`- **模式**: ${e.pattern.slice(0, 120)}`);
+        lines.push(`  **解决**: ${e.solution.slice(0, 200)} (出现 ${e.frequency} 次)`);
+    }
+    return lines.join("\n");
+}
+/* ═══════════════════════════════════════
+   Generate a structured review after task completion
+   ═══════════════════════════════════════ */
+function generateReview(agent, goal, success, durationMs, toolCalls, errorMsg) {
+    return {
+        ts: new Date().toISOString(),
+        agent, goal, success, durationMs, toolCalls,
+        errorMsg,
+        rootCause: errorMsg ? "auto-detected failure" : undefined,
+        improvement: errorMsg ? "review error and adjust approach" : undefined,
+    };
+}
+//# sourceMappingURL=learn.js.map

package/dist/core/learn.js.map

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

package/dist/core/longdoc.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 长文档处理策略 — sliding window + summary chain.
+ *
+ * When an input exceeds the agent's effective context window,
+ * split into overlapping chunks, summarize each, then chain
+ * summaries into a final digest.
+ *
+ * Architecture:
+ *   Input → Chunk(sliding window) → Per-chunk Summary → Chain → Final Digest
+ *
+ * All summaries are generated by the calling agent's LLM, so quality
+ * depends on the model in use. The chunker is pure text processing
+ * and works without any LLM call.
+ */
+import type { BaseAgent } from "./agent";
+export interface ChunkOptions {
+    /** Target chunk size in characters (default 6000) */
+    chunkSize?: number;
+    /** Overlap between consecutive chunks in characters (default 800) */
+    overlap?: number;
+    /** Minimum chunk size before we stop splitting (default 500) */
+    minChunk?: number;
+}
+export declare function chunkText(text: string, opts?: ChunkOptions): string[];
+export interface SummaryOptions {
+    /** Max total chars for the final digest (default 3000) */
+    maxDigestChars?: number;
+    /** Custom summarization prompt for each chunk */
+    chunkPrompt?: string;
+    /** Custom chain prompt for combining summaries */
+    chainPrompt?: string;
+}
+export declare function summarizeLongDoc(agent: BaseAgent, text: string, opts?: SummaryOptions): Promise<string>;
+export declare function parseStructuredInput(input: string): {
+    hasTable: boolean;
+    hasJSON: boolean;
+    hasCSV: boolean;
+    extractedJSON: string | null;
+    extractedTable: string[][] | null;
+};
+//# sourceMappingURL=longdoc.d.ts.map

package/dist/core/longdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"longdoc.d.ts","sourceRoot":"","sources":["../../src/core/longdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzC,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAkCrE;AAKD,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAKD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IACnD,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC;CACjE,CAwBA"}

package/dist/core/longdoc.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * 长文档处理策略 — sliding window + summary chain.
+ *
+ * When an input exceeds the agent's effective context window,
+ * split into overlapping chunks, summarize each, then chain
+ * summaries into a final digest.
+ *
+ * Architecture:
+ *   Input → Chunk(sliding window) → Per-chunk Summary → Chain → Final Digest
+ *
+ * All summaries are generated by the calling agent's LLM, so quality
+ * depends on the model in use. The chunker is pure text processing
+ * and works without any LLM call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkText = chunkText;
+exports.summarizeLongDoc = summarizeLongDoc;
+exports.parseStructuredInput = parseStructuredInput;
+function chunkText(text, opts) {
+    const cs = opts?.chunkSize ?? 6000;
+    const ol = opts?.overlap ?? 800;
+    const min = opts?.minChunk ?? 500;
+    const chunks = [];
+    if (text.length <= cs + min) {
+        chunks.push(text);
+        return chunks;
+    }
+    let start = 0;
+    while (start < text.length) {
+        let end = start + cs;
+        if (end >= text.length) {
+            end = text.length;
+        }
+        else {
+            // Try to break at paragraph boundary
+            const searchEnd = Math.min(end + 400, text.length);
+            const paraBreak = text.lastIndexOf("\n\n", searchEnd);
+            if (paraBreak > start + min)
+                end = paraBreak;
+            else {
+                const lineBreak = text.lastIndexOf("\n", searchEnd);
+                if (lineBreak > start + min)
+                    end = lineBreak;
+                else {
+                    const space = text.lastIndexOf(" ", searchEnd);
+                    if (space > start + min)
+                        end = space;
+                }
+            }
+        }
+        chunks.push(text.slice(start, end).trim());
+        if (end >= text.length)
+            break;
+        start = end - ol;
+        if (start < 0)
+            start = 0;
+    }
+    return chunks;
+}
+const DEFAULT_CHUNK_PROMPT = `Summarize the following text concisely. Keep all key facts, names, numbers, and code snippets. Output the summary directly without preamble. Limit to 300 words.
+
+Text:
+{text}`;
+const DEFAULT_CHAIN_PROMPT = `Combine the following section summaries into a single coherent digest. Preserve all key facts, remove redundancy. Output directly without preamble.
+
+{summaries}`;
+async function summarizeLongDoc(agent, text, opts) {
+    const maxDigest = opts?.maxDigestChars ?? 3000;
+    const chunks = chunkText(text);
+    // Single chunk — no summarization needed
+    if (chunks.length <= 1) {
+        if (text.length <= maxDigest)
+            return text;
+        const prompt = (opts?.chunkPrompt || DEFAULT_CHUNK_PROMPT).replace("{text}", text);
+        return agent.chatOneshot(prompt, { maxTokens: maxDigest });
+    }
+    // Multi-chunk: summarize each, then chain
+    const summaries = [];
+    for (let i = 0; i < chunks.length; i++) {
+        const prompt = (opts?.chunkPrompt || DEFAULT_CHUNK_PROMPT).replace("{text}", chunks[i]);
+        try {
+            const s = await agent.chatOneshot(prompt, { maxTokens: 600 });
+            summaries.push(s);
+        }
+        catch {
+            summaries.push(chunks[i].slice(0, 400) + "...");
+        }
+    }
+    // Chain summaries
+    if (summaries.length === 1)
+        return summaries[0].slice(0, maxDigest);
+    const joined = summaries.map((s, i) => `## Section ${i + 1}\n${s}`).join("\n\n");
+    if (joined.length <= maxDigest)
+        return joined;
+    const chainPrompt = (opts?.chainPrompt || DEFAULT_CHAIN_PROMPT).replace("{summaries}", joined);
+    const final = await agent.chatOneshot(chainPrompt, { maxTokens: maxDigest });
+    return final.slice(0, maxDigest);
+}
+/* ═══════════════════════════════════════
+   Structured data parsing helpers
+   ═══════════════════════════════════════ */
+function parseStructuredInput(input) {
+    const result = { hasTable: false, hasJSON: false, hasCSV: false, extractedJSON: null, extractedTable: null };
+    // Detect JSON
+    const jsonMatch = input.match(/\{[\s\S]*\}|\[[\s\S]*\]/);
+    if (jsonMatch) {
+        try {
+            JSON.parse(jsonMatch[0]);
+            result.hasJSON = true;
+            result.extractedJSON = jsonMatch[0];
+        }
+        catch { /* not valid JSON */ }
+    }
+    // Detect markdown table
+    const tableMatch = input.match(/\|[\s\S]*?\|/);
+    if (tableMatch) {
+        result.hasTable = true;
+        const lines = input.split("\n").filter(l => l.includes("|") && !l.startsWith("|---") && !l.startsWith("| --"));
+        result.extractedTable = lines.map(l => l.split("|").filter(c => c.trim()).map(c => c.trim()));
+    }
+    // Detect CSV
+    if (input.includes(",") && input.split("\n").filter(l => l.includes(",")).length >= 2) {
+        result.hasCSV = true;
+    }
+    return result;
+}
+//# sourceMappingURL=longdoc.js.map