skyloom 1.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAgCvD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiD3C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAmB7E"}

package/dist/core/router.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Complexity router: classify a user goal into direct / single / orchestrate.
+ *
+ * Rules-first (no LLM), so classification stays under 1ms. The router exists
+ * solely to keep simple goals from triggering Snow's full task-decomposition
+ * LLM call when a single agent could answer in one shot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classify = classify;
+exports.pickAgentForGoal = pickAgentForGoal;
+const MULTI_STEP_TOKENS = [
+    '先', '再', '然后', '接着', '之后', '其次', '最后',
+    '第一步', '第二步', '第三步', '步骤', '顺序', '依次', '首先',
+    'step 1', 'step 2', 'first,', 'then,', 'after that', 'finally',
+];
+const GREETING_TOKENS = [
+    '你好', '您好', 'hi', 'hello', 'hey', '在吗', '嗨',
+    '早上好', '晚安', '谢谢', 'thanks', 'thank you', '再见', 'bye',
+];
+const SINGLE_ACTION_HINTS = [
+    '解释', '什么是', '为什么', '如何', '怎么', '查询', '搜索',
+    '搜一下', '翻译', '总结', 'summarize', 'explain', 'what is', 'why', 'how do',
+];
+const ACTION_VERBS = [
+    '写', '帮我写', '生成', '创建', '实现', '做', '搜', '查',
+    '找', '审查', '审计', '翻译', '重构', '修改', '改', '部署',
+    '运行', '执行',
+    'write', 'create', 'generate', 'implement', 'search', 'find',
+    'review', 'translate', 'deploy', 'run',
+];
+const CODE_BLOCK = /```[\s\S]+?```/;
+const URL_PATTERN = /https?:\/\/\S+/;
+const PATH_PATTERN = /(?:[A-Za-z]:[\\/]|[\\/])[\w\-./\\]+/;
+const NUMBERED_LIST = /(?:^|\n)\s*(?:\d+[.)、]|[-*])\s+/gm;
+const INLINE_ENUMERATED = /\b\d+[.)、]\s*\S/g;
+/**
+ * Decide the execution mode for a user goal.
+ *
+ * direct: short greeting / single factual question, no tools needed.
+ * single: clear single-purpose task, one agent + tools.
+ * orchestrate: multi-step plan worth decomposing into sub-tasks.
+ */
+function classify(goal) {
+    if (!goal || !goal.trim())
+        return 'direct';
+    const text = goal.trim();
+    const lower = text.toLowerCase();
+    const length = text.length;
+    const hasCode = CODE_BLOCK.test(text);
+    const hasUrl = URL_PATTERN.test(text);
+    const hasPath = PATH_PATTERN.test(text);
+    const listMatches = (text.match(NUMBERED_LIST) || []).length;
+    const inlineEnumHits = (text.match(INLINE_ENUMERATED) || []).length;
+    const multiStepHits = MULTI_STEP_TOKENS.filter(t => lower.includes(t)).length;
+    const greetingHits = GREETING_TOKENS.filter(t => lower.includes(t)).length;
+    const singleHits = SINGLE_ACTION_HINTS.filter(t => lower.includes(t)).length;
+    const actionHits = ACTION_VERBS.filter(t => lower.includes(t)).length;
+    if (greetingHits >= 1 && length < 30 && multiStepHits === 0 && actionHits === 0) {
+        return 'direct';
+    }
+    if (multiStepHits >= 2 || listMatches >= 2 || inlineEnumHits >= 3) {
+        return 'orchestrate';
+    }
+    if (length > 200 && multiStepHits >= 1) {
+        return 'orchestrate';
+    }
+    if (hasCode && length > 150) {
+        return 'orchestrate';
+    }
+    // Tool-use signals push toward single, not direct
+    if (hasPath || hasUrl || actionHits >= 1) {
+        return 'single';
+    }
+    if (length < 50 && !hasCode) {
+        if (singleHits >= 1 || text.endsWith('?') || text.endsWith('？')) {
+            return 'direct';
+        }
+        if (multiStepHits === 0) {
+            return 'direct';
+        }
+    }
+    return 'single';
+}
+/**
+ * Pick a single agent for a non-orchestrate goal, by keyword routing.
+ *
+ * Returns an agent name guaranteed to be in available, falling back to
+ * rain (generation generalist) then to any available agent.
+ */
+function pickAgentForGoal(goal, available) {
+    const lower = goal.toLowerCase();
+    // More specific buckets first
+    const buckets = [
+        ['frost', ['审查', 'review', '漏洞', '安全', '审计', 'lint', '重构建议', 'code smell']],
+        ['dew', ['部署', '运行', '执行命令', 'shell', 'deploy', 'ci', 'cd', '环境变量', '运维']],
+        ['fog', ['研究', '调研', '搜一下', '搜索', '查一下', '查资料', 'research', 'search', '调查', '找一下', '找资料']],
+        ['rain', ['写', '生成', '实现', 'create', 'generate', '写一段', '写个', '代码', '函数', '实现一个']],
+        ['fair', ['陪我', '聊天', '心情', '难过', '开心', '孤独', '倾诉', '你好', 'hi', 'hello', '嗨']],
+    ];
+    for (const [agent, hints] of buckets) {
+        if (!available.has(agent))
+            continue;
+        if (hints.some(h => lower.includes(h)))
+            return agent;
+    }
+    if (available.has('rain'))
+        return 'rain';
+    return Array.from(available)[0];
+}
+//# sourceMappingURL=router.js.map

package/dist/core/router.js.map

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

package/dist/core/schemas.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Lightweight structured output schemas for LLM response validation.
+ *
+ * Why: LLM JSON output is inherently fragile — models emit markdown fences,
+ * trailing commas, unquoted keys, or hallucinated fields. Rather than layering
+ * heuristic repair (which silently passes corrupted data), we define typed
+ * schemas and validate on ingress. Parsing failures surface immediately so the
+ * caller can retry with a corrected prompt instead of propagating garbage.
+ *
+ * Zero external dependencies: uses only JSON and TypeScript types.
+ */
+/**
+ * Error raised when an LLM response fails schema validation.
+ * Carries both a human-readable message and the raw text so callers
+ * can log / retry with full context.
+ */
+export declare class SchemaValidationError extends Error {
+    raw: string;
+    constructor(message: string, raw?: string);
+}
+/**
+ * One step in a task plan (mirrors PipelineStep / Task)
+ */
+export interface TaskStepSchema {
+    id: string | number;
+    description: string;
+    agent?: string;
+    depends_on?: string[];
+    priority?: "low" | "medium" | "high";
+}
+/**
+ * Full task plan output from Snow's orchestrator
+ */
+export interface TaskPlanSchema {
+    goal: string;
+    steps: TaskStepSchema[];
+}
+/**
+ * A single extracted fact for long-term memory
+ */
+export interface FactSchema {
+    key: string;
+    value: string;
+    category?: string;
+}
+/**
+ * Structured fact-extraction output from the LLM
+ */
+export interface ExtractionResultSchema {
+    facts: FactSchema[];
+}
+/**
+ * Tool call schema for LLM responses
+ */
+export interface ToolCallSchema {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Message schema for agent communication
+ */
+export interface MessageSchema {
+    role: "user" | "assistant" | "tool";
+    content: string;
+    tool_calls?: ToolCallSchema[];
+    tool_call_id?: string;
+}
+/**
+ * Parse a raw LLM response string into a typed JSON object.
+ * Handles markdown fences, leading/trailing text, and minor JSON quirks.
+ * Raises SchemaValidationError on failure.
+ */
+export declare function parseSchema<T extends Record<string, unknown>>(raw: string, schemaType?: new () => T): T;
+/**
+ * Validate task plan schema
+ */
+export declare function validateTaskPlan(data: unknown): TaskPlanSchema;
+/**
+ * Validate extraction result schema
+ */
+export declare function validateExtractionResult(data: unknown): ExtractionResultSchema;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,GAAG,EAAE,MAAM,CAAC;gBAEA,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAW;CAK9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuFD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,UAAU,CAAC,GACvB,CAAC,CAuBH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CA4C9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,CA+B9E"}

package/dist/core/schemas.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Lightweight structured output schemas for LLM response validation.
+ *
+ * Why: LLM JSON output is inherently fragile — models emit markdown fences,
+ * trailing commas, unquoted keys, or hallucinated fields. Rather than layering
+ * heuristic repair (which silently passes corrupted data), we define typed
+ * schemas and validate on ingress. Parsing failures surface immediately so the
+ * caller can retry with a corrected prompt instead of propagating garbage.
+ *
+ * Zero external dependencies: uses only JSON and TypeScript types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaValidationError = void 0;
+exports.parseSchema = parseSchema;
+exports.validateTaskPlan = validateTaskPlan;
+exports.validateExtractionResult = validateExtractionResult;
+/**
+ * Error raised when an LLM response fails schema validation.
+ * Carries both a human-readable message and the raw text so callers
+ * can log / retry with full context.
+ */
+class SchemaValidationError extends Error {
+    constructor(message, raw = "") {
+        super(message);
+        this.name = "SchemaValidationError";
+        this.raw = raw;
+    }
+}
+exports.SchemaValidationError = SchemaValidationError;
+/**
+ * Coerce a value to a target type with best-effort conversion
+ */
+function coerceType(value, targetType) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    switch (targetType) {
+        case "string":
+            return String(value);
+        case "number":
+            return Number(value);
+        case "boolean":
+            return Boolean(value);
+        case "array":
+            return Array.isArray(value) ? value : [];
+        case "object":
+            return typeof value === "object" ? value : {};
+        default:
+            return value;
+    }
+}
+/**
+ * Extract JSON object/array from a potentially malformed string
+ */
+function extractJSON(text) {
+    let cleaned = text.trim();
+    // Strip markdown code fences
+    if (cleaned.includes("```")) {
+        for (const fence of ["```json", "```"]) {
+            if (cleaned.includes(fence)) {
+                const after = cleaned.split(fence, 1)[1];
+                if (after && after.includes("```")) {
+                    cleaned = after.split("```")[0].trim();
+                    break;
+                }
+            }
+        }
+    }
+    // Find first JSON object or array
+    let objStart = -1;
+    let depth = 0;
+    for (let i = 0; i < cleaned.length; i++) {
+        const ch = cleaned[i];
+        if (ch === "{") {
+            if (objStart < 0)
+                objStart = i;
+            depth++;
+        }
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0 && objStart >= 0) {
+                return cleaned.substring(objStart, i + 1);
+            }
+        }
+    }
+    // If still not closed, close with extra braces
+    if (objStart >= 0) {
+        return cleaned.substring(objStart) + "}".repeat(depth);
+    }
+    throw new SchemaValidationError("No valid JSON found in response", text);
+}
+/**
+ * Repair common JSON issues (trailing commas, unquoted keys, etc.)
+ */
+function repairJSON(text) {
+    let repaired = text;
+    // Remove trailing commas
+    repaired = repaired.replace(/,\s*([}\]])/g, "$1");
+    // Quote unquoted keys
+    repaired = repaired.replace(/(?<!["\'\w])(\w[\w\d_]*)(\s*:)/g, '"$1"$2');
+    // Normalize quotes
+    repaired = repaired.replace(/'/g, '"').replace(/`/g, '"');
+    return repaired;
+}
+/**
+ * Parse a raw LLM response string into a typed JSON object.
+ * Handles markdown fences, leading/trailing text, and minor JSON quirks.
+ * Raises SchemaValidationError on failure.
+ */
+function parseSchema(raw, schemaType) {
+    if (!raw || !raw.trim()) {
+        throw new SchemaValidationError("empty response", raw);
+    }
+    try {
+        const extracted = extractJSON(raw);
+        let data = JSON.parse(extracted);
+        return data;
+    }
+    catch (error) {
+        if (error instanceof SchemaValidationError)
+            throw error;
+        try {
+            const repaired = repairJSON(raw);
+            const data = JSON.parse(repaired);
+            return data;
+        }
+        catch (repairError) {
+            throw new SchemaValidationError(`JSON parse failed: ${error.message}`, raw);
+        }
+    }
+}
+/**
+ * Validate task plan schema
+ */
+function validateTaskPlan(data) {
+    if (!data || typeof data !== "object") {
+        throw new SchemaValidationError("Invalid task plan: must be an object");
+    }
+    const plan = data;
+    if (typeof plan.goal !== "string") {
+        throw new SchemaValidationError("Invalid task plan: goal must be a string");
+    }
+    if (!Array.isArray(plan.steps)) {
+        throw new SchemaValidationError("Invalid task plan: steps must be an array");
+    }
+    const steps = plan.steps.map((step) => {
+        if (!step || typeof step !== "object") {
+            throw new SchemaValidationError("Invalid task plan: step must be an object");
+        }
+        const s = step;
+        if (typeof s.id !== "string" && typeof s.id !== "number") {
+            throw new SchemaValidationError("Invalid task plan: step.id must be string or number");
+        }
+        if (typeof s.description !== "string") {
+            throw new SchemaValidationError("Invalid task plan: step.description must be a string");
+        }
+        return {
+            id: s.id,
+            description: s.description,
+            agent: typeof s.agent === "string" ? s.agent : "rain",
+            depends_on: Array.isArray(s.depends_on) ? s.depends_on : [],
+            priority: (["low", "medium", "high"].includes(s.priority)
+                ? s.priority
+                : "medium"),
+        };
+    });
+    return {
+        goal: plan.goal,
+        steps,
+    };
+}
+/**
+ * Validate extraction result schema
+ */
+function validateExtractionResult(data) {
+    if (!data || typeof data !== "object") {
+        throw new SchemaValidationError("Invalid extraction result: must be an object");
+    }
+    const result = data;
+    if (!Array.isArray(result.facts)) {
+        throw new SchemaValidationError("Invalid extraction result: facts must be an array");
+    }
+    const facts = result.facts.map((fact) => {
+        if (!fact || typeof fact !== "object") {
+            throw new SchemaValidationError("Invalid extraction result: fact must be an object");
+        }
+        const f = fact;
+        if (typeof f.key !== "string" || typeof f.value !== "string") {
+            throw new SchemaValidationError("Invalid extraction result: fact must have key and value strings");
+        }
+        return {
+            key: f.key,
+            value: f.value,
+            category: typeof f.category === "string" ? f.category : "auto_extracted",
+        };
+    });
+    return { facts };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/core/schemas.js.map

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

package/dist/core/semantic.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Lightweight semantic retrieval — zero external dependencies.
+ *
+ * Why: The existing `recall_for_injection` uses SQL LIKE on tokens, which
+ * misses semantically related facts that share few literal characters (e.g.
+ * query "deploy" vs. stored fact "release_command"). This module provides
+ * a character n-gram Jaccard similarity scorer that catches those cross-
+ * lingual and synonym relationships without adding PyTorch / sentence-transformers.
+ *
+ * Design:
+ * - Character n-grams (size 2-4) naturally handle CJK, mixed-language, and
+ *   code identifiers better than word-level tokenization.
+ * - Jaccard similarity on n-gram sets is fast (< 10 µs per pair) and
+ *   well-correlated with human relevance judgments for short text.
+ * - Zero dependencies beyond stdlib.
+ */
+/**
+ * Represents a candidate item for ranking
+ */
+export interface Candidate {
+    key?: string;
+    value?: string | Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Character n-gram semantic similarity scorer.
+ *
+ * Usage:
+ * ```
+ * const scorer = new SemanticScorer();
+ * const score = scorer.similarity("deploy to prod", "release_command");
+ * // score ≈ 0.15 (low but non-zero — catches partial overlap)
+ *
+ * const ranked = scorer.rank(
+ *   "search query",
+ *   [{value: "candidate A"}, {value: "candidate B"}]
+ * );
+ * // ranked → [[0.85, {value: "candidate A"}], [0.30, {value: "candidate B"}]]
+ * ```
+ */
+export declare class SemanticScorer {
+    private nRange;
+    private cache;
+    private maxCacheSize;
+    /**
+     * Initialize scorer with n-gram range.
+     * @param nRange - Tuple of [minSize, maxSize] for n-grams (default [2, 4])
+     */
+    constructor(nRange?: [number, number]);
+    /**
+     * Generate character n-gram fingerprint (cached).
+     * @param text - Input text to fingerprint
+     * @returns Set of n-grams for the text
+     */
+    private fingerprint;
+    /**
+     * Calculate Jaccard similarity between two texts using character n-grams.
+     * @param a - First text
+     * @param b - Second text
+     * @returns Similarity score between 0 and 1
+     */
+    similarity(a: string, b: string): number;
+    /**
+     * Rank candidates by semantic similarity to the query.
+     *
+     * Each candidate is a dict. The scorer reads `candidate[keyField]`
+     * for text to compare. Also scores the "key" field if present.
+     * Returns `[score, candidate]` tuples sorted descending, filtered by `minScore`.
+     *
+     * @param query - Query string to match against
+     * @param candidates - Array of candidate objects
+     * @param keyField - Field name to extract text from (default "value")
+     * @param topK - Maximum number of results to return (default 3)
+     * @param minScore - Minimum similarity threshold (default 0.02)
+     * @returns Array of [score, candidate] tuples, sorted by score descending
+     */
+    rank(query: string, candidates: Candidate[], keyField?: string, topK?: number, minScore?: number): Array<[number, Candidate]>;
+    /**
+     * Clear the fingerprint cache.
+     */
+    clearCache(): void;
+    /**
+     * Get current cache size.
+     */
+    getCacheSize(): number;
+}
+/**
+ * Get or create the module-level semantic scorer singleton.
+ * @returns SemanticScorer instance
+ */
+export declare function getScorer(): SemanticScorer;
+//# sourceMappingURL=semantic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/core/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAO;IAE3B;;;OAGG;gBACS,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,CAAU;IAK7C;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA2BnB;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IA0BxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,GAAE,MAAgB,EAC1B,IAAI,GAAE,MAAU,EAChB,QAAQ,GAAE,MAAa,GACtB,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAyC7B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAOD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAK1C"}