flow-frame-core 0.1.0

package/dist/services/uiMapService.d.ts

@@ -0,0 +1,26 @@
+export declare class UiMapService {
+    /**
+     * @param {{ dropParamKeys?: string[], includeNoopEdges?: boolean }} [opts]
+     */
+    constructor(opts?: {});
+    /** @returns {{version:"1.0", states: Record<string, any>, edges: Record<string, any>}} */
+    getMap(): any;
+    /** @param {{ steps: Array<any> }} automation */
+    ingestAutomation(automation: any): any;
+    /** @param {Array<any>} steps */
+    ingestSteps(steps: any): any;
+    /** @param {any} step */
+    ingestStep(step: any): void;
+    /** @param {string[]} stack @param {any} step */
+    _resolveState(stack: any, step: any): any;
+    /** @param {any} step */
+    _normalizeActionSignature(step: any): string;
+}
+export declare function generateUIMap(files: any): Promise<any>;
+/** Convert {location, location_2, location_3, ...} into a stack array. */
+export declare function locationsToStack(meta: any): any[];
+/** Build a canonical, readable state id from a stack. */
+export declare function stackToStateId(stack: any): any;
+/** Transition classification using stack relationships. */
+export declare function classifyTransition(fromStack: any, toStack: any): "NOOP" | "BASE_NAV" | "PUSH" | "POP" | "REPLACE_TOP" | "JUMP";
+//# sourceMappingURL=uiMapService.d.ts.map

package/dist/services/uiMapService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiMapService.d.ts","sourceRoot":"","sources":["../../src/services/uiMapService.ts"],"names":[],"mappings":"AAIA,qBAAa,YAAY;IACvB;;OAEG;gBACS,IAAI,KAAK;IAQrB,0FAA0F;IAC1F,MAAM;IAIN,gDAAgD;IAChD,gBAAgB,CAAC,UAAU,KAAA;IAO3B,gCAAgC;IAChC,WAAW,CAAC,KAAK,KAAA;IAKjB,wBAAwB;IACxB,UAAU,CAAC,IAAI,KAAA;IA0If,gDAAgD;IAChD,aAAa,CAAC,KAAK,KAAA,EAAE,IAAI,KAAA;IAwBzB,wBAAwB;IACxB,yBAAyB,CAAC,IAAI,KAAA;CAa/B;AAED,wBAAsB,aAAa,CAAC,KAAK,KAAA,gBAQxC;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,KAAA,SAmBpC;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,KAAA,OAEnC;AAOD,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,SAAS,KAAA,EAAE,OAAO,KAAA,iEAoBpD"}

package/dist/services/uiMapService.js

@@ -0,0 +1,275 @@
+// uiMapService.js
+// A UI map builder that uses params.selfLearningMetadata.transition (string) and stacked locations.
+import fs from 'fs';
+export class UiMapService {
+    /**
+     * @param {{ dropParamKeys?: string[], includeNoopEdges?: boolean }} [opts]
+     */
+    constructor(opts = {}) {
+        this.map = { version: "1.0", states: {}, edges: {} };
+        this.opts = {
+            dropParamKeys: opts.dropParamKeys ?? DEFAULT_DROP_KEYS,
+            includeNoopEdges: opts.includeNoopEdges ?? false,
+        };
+    }
+    /** @returns {{version:"1.0", states: Record<string, any>, edges: Record<string, any>}} */
+    getMap() {
+        return this.map;
+    }
+    /** @param {{ steps: Array<any> }} automation */
+    ingestAutomation(automation) {
+        if (automation && Array.isArray(automation.steps)) {
+            this.ingestSteps(automation.steps);
+        }
+        return this.map;
+    }
+    /** @param {Array<any>} steps */
+    ingestSteps(steps) {
+        for (const s of steps)
+            this.ingestStep(s);
+        return this.map;
+    }
+    /** @param {any} step */
+    ingestStep(step) {
+        const meta = step?.selfLearningMetadata || step?.params?.selfLearningMetadata || step?.param?.selfLearningMetadata;
+        // We need at least location info to place the step in a state
+        if (!meta)
+            return;
+        // 1. Derive fromState
+        const fromStack = locationsToStack(meta);
+        const fromState = this._resolveState(fromStack, step);
+        const stepId = step.annotation?.stepId || step.id;
+        if (meta.start === 'true' || meta.start === true) {
+            this.map.startStateId = fromState.id;
+        }
+        // 2. Check for Field
+        if (meta.field) {
+            if (!fromState.fields || !Array.isArray(fromState.fields))
+                fromState.fields = [];
+            const name = meta.name || meta.field;
+            let fieldData = fromState.fields.find(f => f.name === name && f.group === meta.group);
+            if (!fieldData) {
+                fieldData = {
+                    name: name,
+                    field: meta.field,
+                    type: meta.type,
+                    stepId: stepId,
+                    action: step.action,
+                    lastSeenAt: step.timestampms
+                };
+                if (meta.group) {
+                    fieldData.group = meta.group;
+                }
+                fromState.fields.push(fieldData);
+            }
+            else {
+                fieldData.lastSeenAt = step.timestampms;
+            }
+            if (meta.execute) {
+                fieldData.execute = meta.execute;
+            }
+        }
+        else if (step.action === 'file_modal_selection') {
+            const fieldName = step.filePropertyName || step.params?.filePropertyName;
+            if (fieldName) {
+                if (!fromState.fields || !Array.isArray(fromState.fields))
+                    fromState.fields = [];
+                let fieldData = fromState.fields.find(f => f.name === fieldName);
+                if (!fieldData) {
+                    fieldData = {
+                        name: fieldName,
+                        type: 'file_upload',
+                        stepId: stepId,
+                        action: step.action,
+                        lastSeenAt: step.timestampms
+                    };
+                    fromState.fields.push(fieldData);
+                }
+                else {
+                    fieldData.lastSeenAt = step.timestampms;
+                }
+            }
+        }
+        else if (meta.type === 'wait_area') {
+            if (!fromState.fields || !Array.isArray(fromState.fields))
+                fromState.fields = [];
+            const name = meta.name || meta.field;
+            let fieldData = fromState.fields.find(f => f.name === name);
+            if (!fieldData) {
+                fieldData = {
+                    name: name,
+                    type: 'wait_area',
+                    stepId: stepId,
+                    action: step.action,
+                    lastSeenAt: step.timestampms,
+                    description: meta.description,
+                    prompt: step.prompt
+                };
+                fromState.fields.push(fieldData);
+            }
+            else {
+                fieldData.lastSeenAt = step.timestampms;
+                if (meta.description)
+                    fieldData.description = meta.description;
+                if (step.prompt)
+                    fieldData.prompt = step.prompt;
+            }
+        }
+        // 3. Check for Execute
+        if (meta.execute && !meta.field) {
+            if (!fromState.executes)
+                fromState.executes = {};
+            fromState.executes[meta.execute] = {
+                name: meta.execute,
+                stepId: stepId,
+                action: step.action,
+                lastSeenAt: step.timestampms
+            };
+        }
+        // 4. Check transition
+        const transitionStr = meta.transition;
+        if (typeof transitionStr === 'string' && transitionStr.trim().length > 0) {
+            const toStack = transitionStr.split('.').map(s => s.trim()).filter(Boolean);
+            const toState = this._resolveState(toStack, step);
+            const fromId = fromState.id;
+            const toId = toState.id;
+            if (fromId === toId && !this.opts.includeNoopEdges)
+                return;
+            const actionSignature = this._normalizeActionSignature(step);
+            const edgeId = `${fromId}::${actionSignature}::${toId}`;
+            const transitionType = classifyTransition(fromStack, toStack);
+            const ok = step.ok ?? true; // Assume success if not present
+            const now = step.timestampms;
+            const existing = this.map.edges[edgeId];
+            if (existing) {
+                existing.observedCount += 1;
+                existing.successCount += ok ? 1 : 0;
+                existing.lastSeenAt = now ?? existing.lastSeenAt;
+                existing.stepId = stepId;
+                return;
+            }
+            this.map.edges[edgeId] = {
+                id: edgeId,
+                from: fromId,
+                to: toId,
+                action: {
+                    name: step.action,
+                    signature: actionSignature,
+                },
+                transitionType,
+                observedCount: 1,
+                successCount: ok ? 1 : 0,
+                lastSeenAt: now,
+                stepId: stepId,
+            };
+        }
+    }
+    /** @param {string[]} stack @param {any} step */
+    _resolveState(stack, step) {
+        const id = stackToStateId(stack);
+        const now = step?.timestampms;
+        const existing = this.map.states[id];
+        if (existing) {
+            existing.lastSeenAt = now ?? existing.lastSeenAt;
+            return existing;
+        }
+        const state = {
+            id,
+            stack,
+            base: stack[0] ?? null,
+            firstSeenAt: now,
+            lastSeenAt: now,
+            fields: [],
+            executes: {},
+        };
+        this.map.states[id] = state;
+        return state;
+    }
+    /** @param {any} step */
+    _normalizeActionSignature(step) {
+        const action = step.action || "unknown";
+        const params = step.params || {};
+        // signature = `${step.action}:${params.action ?? ""}:${params.output ?? params.areaProperty ?? ""}`
+        const subAction = params.action || "";
+        const discriminator = params.output || params.areaProperty || params.prompt || "";
+        // Clean up
+        const parts = [action, subAction, discriminator].map(s => String(s).trim());
+        return parts.join(":");
+    }
+}
+export async function generateUIMap(files) {
+    const uiMapService = new UiMapService();
+    for (const f of files) {
+        let file = fs.promises.readFile(f, 'utf-8');
+        file = JSON.parse(await file);
+        uiMapService.ingestAutomation(file);
+    }
+    return uiMapService.getMap();
+}
+/** Convert {location, location_2, location_3, ...} into a stack array. */
+export function locationsToStack(meta) {
+    const out = [];
+    const base = normLoc(meta?.location);
+    if (base)
+        out.push(base);
+    const keys = Object.keys(meta ?? {})
+        .filter((k) => /^location_\d+$/.test(k))
+        .sort((a, b) => {
+        const numA = parseInt(a.split("_")[1], 10);
+        const numB = parseInt(b.split("_")[1], 10);
+        return numA - numB;
+    });
+    for (const k of keys) {
+        const v = normLoc(meta[k]);
+        if (v)
+            out.push(v);
+    }
+    return out;
+}
+/** Build a canonical, readable state id from a stack. */
+export function stackToStateId(stack) {
+    return stack.length ? stack.join(" > ") : "UNKNOWN";
+}
+function normLoc(v) {
+    const s = String(v ?? "").trim();
+    return s ? s : null;
+}
+/** Transition classification using stack relationships. */
+export function classifyTransition(fromStack, toStack) {
+    if (joinKey(fromStack) === joinKey(toStack))
+        return "NOOP";
+    const fromBase = fromStack[0];
+    const toBase = toStack[0];
+    const isPrefix = (a, b) => a.length <= b.length && a.every((v, i) => v === b[i]);
+    if (fromBase && toBase && fromBase !== toBase)
+        return "BASE_NAV";
+    if (isPrefix(fromStack, toStack) && toStack.length > fromStack.length)
+        return "PUSH";
+    if (isPrefix(toStack, fromStack) && fromStack.length > toStack.length)
+        return "POP";
+    if (fromStack.length === toStack.length && fromStack.length > 0) {
+        const sameExceptTop = joinKey(fromStack.slice(0, -1)) === joinKey(toStack.slice(0, -1)) &&
+            fromStack[fromStack.length - 1] !== toStack[toStack.length - 1];
+        if (sameExceptTop)
+            return "REPLACE_TOP";
+    }
+    return "JUMP";
+}
+function joinKey(arr) {
+    return (arr ?? []).join("|");
+}
+const DEFAULT_DROP_KEYS = [
+    "timestampms",
+    "time",
+    "ts",
+    "date",
+    "id",
+    "uuid",
+    "guid",
+    "sessionId",
+    "runId",
+    "traceId",
+    "requestId",
+    "selfLearningMetadata",
+];
+//# sourceMappingURL=uiMapService.js.map

package/dist/services/uiMapService.js.map

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

package/dist/services/uiPlanner.d.ts

@@ -0,0 +1,54 @@
+export declare class UiPlanner {
+    /**
+     * @param {Object} uiMap - The UI Map object (states, edges).
+     * @param {UiMapPathFinder} pathFinder - Instance of UiMapPathFinder.
+     * @param {Object} [macroRegistry] - Optional registry for macro fallbacks.
+     * @param {Array<{path: string, content: Object}>} [automationFiles] - List of automation file contents.
+     */
+    constructor(uiMap: any, pathFinder: any, macroRegistry?: {}, automationFiles?: any[]);
+    _buildAutomationIndex(files: any): Map<any, any>;
+    _buildIndexes(uiMap: any): {
+        fieldToStateIds: Map<any, any>;
+    };
+    /**
+     * End-to-end planner: Request -> Goal -> PlanOps -> Executable Steps
+     * @param {string} request - Natural language request
+     * @param {string} startStateId - Current state ID
+     * @param {Object} context - Additional context (e.g. screen text, previous errors)
+     * @param {string} model - The LLM model to use (default: 'gpt-5.2-2025-12-11')
+     * @returns {Promise<Array<Object>>} List of executable steps
+     */
+    plan(request: any, startStateId?: string, context?: {}, model?: string): Promise<{
+        steps: any[];
+    }>;
+    _compileRequestToGoal(request: any, context: any, model: any): Promise<any>;
+    _checkCompleteness(goal: any, request: any, model: any): Promise<any>;
+    _validateGoal(goal: any): any[];
+    _fixGoalWithLLM(goal: any, errors: any, request: any, model: any): Promise<any>;
+    _generatePlanDescription(steps: any, request: any, model: any): Promise<string>;
+    /**
+     * Generates a high-level plan (list of PlanOps) based on a structured goal.
+     * @param {Object} goal - { steps: Array<{ kind, field, value, ... }> }
+     * @param {string} startStateId - The current state of the application.
+     * @returns {Array<Object>} List of PlanOps.
+     */
+    generatePlan(goal: any, startStateId?: string): any[];
+    /**
+     * Compiles a list of PlanOps into executable automation steps.
+     * @param {Array<Object>} planOps
+     * @param {string} startStateId
+     * @returns {Array<Object>} List of executable steps.
+     */
+    compile(planOps: any, startStateId: any): {
+        steps: any[];
+    };
+    _handleMissingPath(steps: any, from: any, to: any): void;
+    _createStepFromEdge(edge: any, op?: {}): {
+        action: string;
+        id: any;
+        params: any;
+        description: string;
+    };
+    _createStepFromField(fieldDef: any, op: any): any;
+}
+//# sourceMappingURL=uiPlanner.d.ts.map

package/dist/services/uiPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiPlanner.d.ts","sourceRoot":"","sources":["../../src/services/uiPlanner.ts"],"names":[],"mappings":"AAGA,qBAAa,SAAS;IACpB;;;;;OAKG;gBACS,KAAK,KAAA,EAAE,UAAU,KAAA,EAAE,aAAa,KAAK,EAAE,eAAe,QAAK;IASvE,qBAAqB,CAAC,KAAK,KAAA;IAkB3B,aAAa,CAAC,KAAK,KAAA;;;IAsBnB;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,KAAA,EAAE,YAAY,SAAS,EAAE,OAAO,KAAK,EAAE,KAAK,SAAuB;;;IAiC/E,qBAAqB,CAAC,OAAO,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,KAAA;IA2F7C,kBAAkB,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,KAAA;IA0B7C,aAAa,CAAC,IAAI,KAAA;IA0BZ,eAAe,CAAC,IAAI,KAAA,EAAE,MAAM,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,KAAA;IA2B5C,wBAAwB,CAAC,KAAK,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,KAAA;IAmBpD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,KAAA,EAAE,YAAY,SAAS;IAuCxC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,KAAA,EAAE,YAAY,KAAA;;;IAqJ7B,kBAAkB,CAAC,KAAK,KAAA,EAAE,IAAI,KAAA,EAAE,EAAE,KAAA;IAclC,mBAAmB,CAAC,IAAI,KAAA,EAAE,EAAE,KAAK;;;;;;IAcjC,oBAAoB,CAAC,QAAQ,KAAA,EAAE,EAAE,KAAA;CA+FlC"}