flow-frame-core 0.1.0

package/dist/services/self-learning/recognize.js

@@ -0,0 +1,116 @@
+import "dotenv/config";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadAllSignatures } from "./registry.js";
+import { cropToDataUrl } from "./image.js";
+import { aHashHex, dHashHex, hammingHex, preScoreFromDistances } from "./phash.js";
+import { callJsonSchema } from "./openai.js";
+import { AnchorAnswerSchema } from "./schema.js";
+import { expectedMatchScore } from "./matcher.js";
+function envNum(name, def) {
+    const v = process.env[name];
+    return v ? Number(v) : def;
+}
+async function verifyAnchorCrop({ cropDataUrl, verifyPrompt }) {
+    const system = `
+You are an Anchor Verifier.
+Return ONLY JSON that matches the schema.
+If unsure, keep the answer short and lower confidence.
+`.trim();
+    return callJsonSchema({
+        system,
+        userText: verifyPrompt,
+        imageDataUrl: cropDataUrl,
+        jsonSchema: AnchorAnswerSchema
+    });
+}
+async function scoreCandidate(sig, imagePath) {
+    const anchors = sig.anchors || [];
+    if (!anchors.length)
+        return 0;
+    let sum = 0;
+    for (const a of anchors) {
+        const crop = await cropToDataUrl({ imagePath, bbox: a.bbox });
+        const { answer, confidence } = await verifyAnchorCrop({ cropDataUrl: crop, verifyPrompt: a.verifyPrompt });
+        const match = expectedMatchScore(a.expected, answer);
+        sum += match * confidence;
+    }
+    return sum / anchors.length;
+}
+export async function recognizeScreen(imagePath, options = {}) {
+    if (!imagePath) {
+        throw new Error("imagePath is required");
+    }
+    const TOPK = options.topK || envNum("TOPK", 5);
+    const UNKNOWN_THRESHOLD = options.unknownThreshold || envNum("UNKNOWN_THRESHOLD", 0.4);
+    const sigs = loadAllSignatures().filter(s => s.prototype && s.anchors?.length);
+    if (!sigs.length) {
+        throw new Error("No signatures found. Run: npm run learn -- <screenshot.png>");
+    }
+    const ahash = await aHashHex(imagePath);
+    const dhash = await dHashHex(imagePath);
+    // Cheap preselect by perceptual hash distances
+    const pres = sigs
+        .map(s => {
+        const aDist = hammingHex(ahash, s.prototype.ahash);
+        const dDist = hammingHex(dhash, s.prototype.dhash);
+        const preScore = preScoreFromDistances(aDist, dDist);
+        return { sig: s, preScore };
+    })
+        .sort((a, b) => b.preScore - a.preScore);
+    const top = pres.slice(0, TOPK);
+    const candidates = [];
+    for (const c of top) {
+        const verifyScore = await scoreCandidate(c.sig, imagePath);
+        candidates.push({ screenId: c.sig.screenId, preScore: c.preScore, verifyScore });
+    }
+    candidates.sort((a, b) => b.verifyScore - a.verifyScore);
+    const best = candidates[0];
+    const second = candidates[1];
+    const bestScore = best?.verifyScore ?? 0;
+    const secondBestScore = second?.verifyScore ?? 0;
+    const result = bestScore >= UNKNOWN_THRESHOLD
+        ? {
+            screenId: best.screenId,
+            confidence: bestScore,
+            bestScore,
+            secondBestScore,
+            candidates
+        }
+        : {
+            screenId: "unknown",
+            confidence: bestScore,
+            bestScore,
+            secondBestScore,
+            candidates,
+            reason: `bestScore < UNKNOWN_THRESHOLD (${UNKNOWN_THRESHOLD})`
+        };
+    return result;
+}
+// CLI
+async function main() {
+    const imagePath = process.argv[2];
+    if (!imagePath) {
+        console.error("Usage: npm run recognize -- <screenshot.png>");
+        process.exit(1);
+    }
+    try {
+        const result = await recognizeScreen(imagePath);
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exit(1);
+    }
+}
+const isDirectRun = (() => {
+    const __filename = fileURLToPath(import.meta.url);
+    return process.argv[1] && path.resolve(process.argv[1]) === path.resolve(__filename);
+})();
+if (isDirectRun) {
+    main().catch((e) => {
+        console.error(e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=recognize.js.map

package/dist/services/self-learning/recognize.js.map

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

package/dist/services/self-learning/record_transition.d.ts

@@ -0,0 +1,8 @@
+export declare function recordTransition({ takeScreenshot, recognizeScreen, performAction, action, meta }: {
+    takeScreenshot: any;
+    recognizeScreen: any;
+    performAction: any;
+    action: any;
+    meta?: {};
+}): Promise<any>;
+//# sourceMappingURL=record_transition.d.ts.map

package/dist/services/self-learning/record_transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_transition.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/record_transition.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CAAC,EACrC,cAAc,EACd,eAAe,EACf,aAAa,EACb,MAAM,EACN,IAAS,EACV;;;;;;CAAA,gBAqBA"}

package/dist/services/self-learning/record_transition.js

@@ -0,0 +1,20 @@
+import { appendEvent } from "./transition_log.js";
+export async function recordTransition({ takeScreenshot, recognizeScreen, performAction, action, meta = {} }) {
+    const beforePath = await takeScreenshot();
+    const before = await recognizeScreen(beforePath);
+    await performAction(action);
+    const afterPath = await takeScreenshot();
+    const after = await recognizeScreen(afterPath);
+    const ok = before.screenId !== "unknown" && after.screenId !== "unknown"
+        ? (after.screenId !== before.screenId) // basic success signal; refine later
+        : true; // if unknowns, still log
+    return appendEvent({
+        type: "transition",
+        before: { ...before, screenshot: beforePath },
+        action,
+        after: { ...after, screenshot: afterPath },
+        ok,
+        meta
+    });
+}
+//# sourceMappingURL=record_transition.js.map

package/dist/services/self-learning/record_transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_transition.js","sourceRoot":"","sources":["../../../src/services/self-learning/record_transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,cAAc,EACd,eAAe,EACf,aAAa,EACb,MAAM,EACN,IAAI,GAAG,EAAE,EACV;IACC,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAEjD,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/C,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QACtE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,qCAAqC;QAC5E,CAAC,CAAC,IAAI,CAAC,CAAC,yBAAyB;IAEnC,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE;QAC7C,MAAM;QACN,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE;QAC1C,EAAE;QACF,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/dist/services/self-learning/registry.d.ts

@@ -0,0 +1,4 @@
+export declare function signaturesDir(): string;
+export declare function loadAllSignatures(): any[];
+export declare function saveSignature(sig: any): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/services/self-learning/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/registry.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,WAI5B;AAED,wBAAgB,iBAAiB,UAIhC;AAED,wBAAgB,aAAa,CAAC,GAAG,KAAA,QAIhC"}

package/dist/services/self-learning/registry.js

@@ -0,0 +1,19 @@
+import fs from "node:fs";
+import path from "node:path";
+import { dataDir, ensureDir } from "./util.js";
+export function signaturesDir() {
+    const dir = path.join(dataDir(), "screens", "signatures");
+    ensureDir(dir);
+    return dir;
+}
+export function loadAllSignatures() {
+    const dir = signaturesDir();
+    const files = fs.readdirSync(dir).filter(f => f.endsWith(".json"));
+    return files.map(f => JSON.parse(fs.readFileSync(path.join(dir, f), "utf8")));
+}
+export function saveSignature(sig) {
+    const dir = signaturesDir();
+    const fp = path.join(dir, `${sig.screenId}.json`);
+    fs.writeFileSync(fp, JSON.stringify(sig, null, 2), "utf8");
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/self-learning/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/services/self-learning/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,SAAS,CAAC,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAG;IAC/B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,OAAO,CAAC,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/services/self-learning/schema.d.ts

@@ -0,0 +1,114 @@
+export declare const ScreenSignatureSchema: {
+    name: string;
+    strict: boolean;
+    schema: {
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            screenId: {
+                type: string;
+                minLength: number;
+            };
+            friendlyName: {
+                type: string;
+            };
+            anchors: {
+                type: string;
+                minItems: number;
+                maxItems: number;
+                items: {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        name: {
+                            type: string;
+                            minLength: number;
+                        };
+                        bbox: {
+                            type: string;
+                            minItems: number;
+                            maxItems: number;
+                            items: {
+                                type: string;
+                                minimum: number;
+                                maximum: number;
+                            };
+                        };
+                        verifyPrompt: {
+                            type: string;
+                            minLength: number;
+                        };
+                        expected: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                type: {
+                                    type: string;
+                                    enum: string[];
+                                };
+                                values: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                };
+                                patterns: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                };
+                                value: {
+                                    type: string;
+                                    enum: string[];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            notes: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    stable: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    variable: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export declare const AnchorAnswerSchema: {
+    name: string;
+    strict: boolean;
+    schema: {
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            answer: {
+                type: string;
+            };
+            confidence: {
+                type: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/services/self-learning/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDjC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;CAY9B,CAAC"}

package/dist/services/self-learning/schema.js

@@ -0,0 +1,70 @@
+export const ScreenSignatureSchema = {
+    name: "screen_signature",
+    strict: true,
+    schema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["screenId", "friendlyName", "anchors", "notes"],
+        properties: {
+            screenId: { type: "string", minLength: 1 },
+            friendlyName: { type: "string" },
+            anchors: {
+                type: "array",
+                minItems: 3,
+                maxItems: 12,
+                items: {
+                    type: "object",
+                    additionalProperties: false,
+                    required: ["name", "bbox", "verifyPrompt", "expected"],
+                    properties: {
+                        name: { type: "string", minLength: 1 },
+                        bbox: {
+                            type: "array",
+                            minItems: 4,
+                            maxItems: 4,
+                            items: { type: "number", minimum: 0, maximum: 1 }
+                        },
+                        verifyPrompt: { type: "string", minLength: 5 },
+                        expected: {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["type", "values", "patterns", "value"],
+                            properties: {
+                                type: {
+                                    type: "string",
+                                    enum: ["equals_any", "contains_any", "regex_any", "yes_no"]
+                                },
+                                values: { type: "array", items: { type: "string" } },
+                                patterns: { type: "array", items: { type: "string" } },
+                                value: { type: "string", enum: ["", "yes", "no"] }
+                            }
+                        }
+                    }
+                }
+            },
+            notes: {
+                type: "object",
+                additionalProperties: false,
+                required: ["stable", "variable"],
+                properties: {
+                    stable: { type: "array", items: { type: "string" } },
+                    variable: { type: "array", items: { type: "string" } }
+                }
+            }
+        }
+    }
+};
+export const AnchorAnswerSchema = {
+    name: "anchor_answer",
+    strict: true,
+    schema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["answer", "confidence"],
+        properties: {
+            answer: { type: "string" },
+            confidence: { type: "number", minimum: 0, maximum: 1 }
+        }
+    }
+};
+//# sourceMappingURL=schema.js.map

package/dist/services/self-learning/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/services/self-learning/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;QAC1D,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;YAC1C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,KAAK;oBAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC;oBACtD,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBACtC,IAAI,EAAE;4BACJ,IAAI,EAAE,OAAO;4BACb,QAAQ,EAAE,CAAC;4BACX,QAAQ,EAAE,CAAC;4BACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;yBAClD;wBACD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;wBAC9C,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,KAAK;4BAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;4BACjD,UAAU,EAAE;gCACV,IAAI,EAAE;oCACJ,IAAI,EAAE,QAAQ;oCACd,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,CAAC;iCAC5D;gCACD,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gCACpD,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gCACtD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;6BACnD;yBACF;qBACF;iBACF;aACF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAChC,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACpD,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;iBACvD;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;QAClC,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;SACvD;KACF;CACF,CAAC"}

package/dist/services/self-learning/schemaStrictify.d.ts

@@ -0,0 +1,2 @@
+export declare function strictifyJsonSchema(schema: any): any;
+//# sourceMappingURL=schemaStrictify.d.ts.map

package/dist/services/self-learning/schemaStrictify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaStrictify.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/schemaStrictify.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,MAAM,KAAA,OAkCzC"}

package/dist/services/self-learning/schemaStrictify.js

@@ -0,0 +1,34 @@
+export function strictifyJsonSchema(schema) {
+    const cloned = deepClone(schema);
+    visit(cloned);
+    return cloned;
+    function visit(node) {
+        if (!node || typeof node !== "object")
+            return;
+        if (node.oneOf) {
+            throw new Error("Structured Outputs: 'oneOf' is not permitted. Use 'anyOf' or redesign.");
+        }
+        // Recurse into anyOf variants
+        if (Array.isArray(node.anyOf))
+            node.anyOf.forEach(visit);
+        // Recurse into arrays
+        if (node.type === "array" && node.items)
+            visit(node.items);
+        // Recurse into objects
+        if (node.type === "object" && node.properties && typeof node.properties === "object") {
+            node.additionalProperties = false;
+            node.required = Object.keys(node.properties); // <-- key fix
+            for (const k of Object.keys(node.properties))
+                visit(node.properties[k]);
+        }
+        // Recurse into nested schemas if present
+        if (node.properties) {
+            for (const k of Object.keys(node.properties))
+                visit(node.properties[k]);
+        }
+    }
+    function deepClone(x) {
+        return JSON.parse(JSON.stringify(x));
+    }
+}
+//# sourceMappingURL=schemaStrictify.js.map

package/dist/services/self-learning/schemaStrictify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaStrictify.js","sourceRoot":"","sources":["../../../src/services/self-learning/schemaStrictify.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,MAAM;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,MAAM,CAAC,CAAC;IACd,OAAO,MAAM,CAAC;IAEd,SAAS,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO;QAE9C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC9F,CAAC;QAED,8BAA8B;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEzD,sBAAsB;QACtB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE3D,uBAAuB;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnF,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;YAClC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc;YAC5D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,yCAAyC;QACzC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;IACL,CAAC;IAED,SAAS,SAAS,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;AACL,CAAC"}

package/dist/services/self-learning/transition_graph.d.ts

@@ -0,0 +1,6 @@
+export declare function buildTransitionGraph(): {
+    nodes: any[];
+    edges: any[];
+};
+export declare function findPath(graph: any, start: any, goal: any): any[];
+//# sourceMappingURL=transition_graph.d.ts.map

package/dist/services/self-learning/transition_graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition_graph.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/transition_graph.ts"],"names":[],"mappings":"AAgBA,wBAAgB,oBAAoB;;;EA8BnC;AAGD,wBAAgB,QAAQ,CAAC,KAAK,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,SAqC1C"}

package/dist/services/self-learning/transition_graph.js

@@ -0,0 +1,83 @@
+import { readEvents } from "./transition_log.js";
+function actionSig(a) {
+    // Normalize actions so the graph doesn’t explode.
+    // You can improve this later (elementId, label, etc.)
+    if (!a)
+        return "unknown";
+    if (a.kind === "click")
+        return `click@${round2(a.x)}_${round2(a.y)}`;
+    if (a.kind === "type")
+        return `type:${(a.text || "").slice(0, 16)}`;
+    if (a.kind === "keys")
+        return `keys:${(a.keys || []).join("+")}`;
+    return a.kind || "unknown";
+}
+function round2(n) {
+    return Math.round(Number(n) * 100) / 100;
+}
+export function buildTransitionGraph() {
+    const events = readEvents();
+    // Expect paired events like:
+    // { type:"transition", before:{screenId,...}, action:{...}, after:{screenId,...}, ok:true/false }
+    const edges = new Map(); // key = `${from}||${sig}||${to}`
+    for (const e of events) {
+        if (e.type !== "transition")
+            continue;
+        const from = e.before?.screenId || "unknown";
+        const to = e.after?.screenId || "unknown";
+        const sig = actionSig(e.action);
+        const key = `${from}||${sig}||${to}`;
+        const cur = edges.get(key) || { from, to, sig, count: 0, ok: 0, lastTs: "" };
+        cur.count += 1;
+        if (e.ok)
+            cur.ok += 1;
+        cur.lastTs = e.ts;
+        edges.set(key, cur);
+    }
+    return {
+        nodes: Array.from(new Set(Array.from(edges.values()).flatMap(e => [e.from, e.to]))),
+        edges: Array.from(edges.values()).map(e => ({
+            ...e,
+            successRate: e.count ? e.ok / e.count : 0
+        }))
+    };
+}
+// Simple BFS path (you can upgrade to probability-weighted later)
+export function findPath(graph, start, goal) {
+    if (start === goal)
+        return [];
+    const adj = new Map();
+    for (const e of graph.edges) {
+        if (!adj.has(e.from))
+            adj.set(e.from, []);
+        adj.get(e.from).push(e);
+    }
+    const q = [start];
+    const prev = new Map(); // node -> { node, edge }
+    prev.set(start, null);
+    while (q.length) {
+        const cur = q.shift();
+        const outs = adj.get(cur) || [];
+        for (const edge of outs) {
+            const nxt = edge.to;
+            if (prev.has(nxt))
+                continue;
+            prev.set(nxt, { node: cur, edge });
+            if (nxt === goal) {
+                // reconstruct
+                const path = [];
+                let t = goal;
+                while (t !== start) {
+                    const p = prev.get(t);
+                    path.push(p.edge);
+                    t = p.node;
+                }
+                path.reverse();
+                return path;
+            }
+            q.push(nxt);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=transition_graph.js.map

package/dist/services/self-learning/transition_graph.js.map

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

package/dist/services/self-learning/transition_log.d.ts

@@ -0,0 +1,3 @@
+export declare function appendEvent(event: any): any;
+export declare function readEvents(): any[];
+//# sourceMappingURL=transition_log.d.ts.map

package/dist/services/self-learning/transition_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition_log.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/transition_log.ts"],"names":[],"mappings":"AAuBA,wBAAgB,WAAW,CAAC,KAAK,KAAA,OAIhC;AAED,wBAAgB,UAAU,UAWzB"}

package/dist/services/self-learning/transition_log.js

@@ -0,0 +1,42 @@
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { dataDir, ensureDir } from "./util.js";
+function logsDir() {
+    const dir = path.join(dataDir(), "nav_logs");
+    ensureDir(dir);
+    return dir;
+}
+function logPath() {
+    return path.join(logsDir(), "events.jsonl");
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function id() {
+    return `${Date.now()}_${crypto.randomBytes(4).toString("hex")}`;
+}
+export function appendEvent(event) {
+    const e = { id: id(), ts: nowIso(), ...event };
+    fs.appendFileSync(logPath(), JSON.stringify(e) + "\n", "utf8");
+    return e;
+}
+export function readEvents() {
+    if (!fs.existsSync(logPath()))
+        return [];
+    return fs
+        .readFileSync(logPath(), "utf8")
+        .split("\n")
+        .map(s => s.trim())
+        .filter(Boolean)
+        .map(line => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter(Boolean);
+}
+//# sourceMappingURL=transition_log.js.map

package/dist/services/self-learning/transition_log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition_log.js","sourceRoot":"","sources":["../../../src/services/self-learning/transition_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO;IACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,EAAE;IACT,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAK;IAC/B,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/C,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,OAAO,EAAE;SACN,YAAY,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC;SAC/B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,IAAI,CAAC,EAAE;QACV,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACzD,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/dist/services/self-learning/util.d.ts

@@ -0,0 +1,3 @@
+export declare function dataDir(): string;
+export declare function ensureDir(p: any): void;
+//# sourceMappingURL=util.d.ts.map

package/dist/services/self-learning/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/services/self-learning/util.ts"],"names":[],"mappings":"AAKA,wBAAgB,OAAO,WAEtB;AAED,wBAAgB,SAAS,CAAC,CAAC,KAAA,QAE1B"}

package/dist/services/self-learning/util.js

@@ -0,0 +1,11 @@
+import { KEYS } from "../../constants.js";
+import { get } from "../../utils.js";
+import path from 'path';
+import fs from 'fs';
+export function dataDir() {
+    return path.join(process.env.DATA_DIR || get(KEYS.learning_dir) || "./data", get(KEYS.learning_context) || 'default');
+}
+export function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+//# sourceMappingURL=util.js.map

package/dist/services/self-learning/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/services/self-learning/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,CAAC;AACxH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAC;IACzB,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC"}