cbrowser 18.34.1 → 18.35.0

package/dist/mcp-tools/base/site-knowledge-tools.js

@@ -0,0 +1,314 @@
+/**
+ * CBrowser MCP Tools - Site Knowledge Tools
+ * Page understanding, site model learning, and site profile management.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ * @since v18.35.0
+ */
+import { z } from "zod";
+/**
+ * Register site knowledge tools (6 tools: page_understand, site_model_status, site_model_query,
+ * site_profile_list, site_profile_delete, site_profile_status)
+ */
+export function registerSiteKnowledgeTools(server, { getBrowser, getBrowserByToken }) {
+    // ---------------------------------------------------------------------------
+    // Tool 1: page_understand
+    // ---------------------------------------------------------------------------
+    server.tool("page_understand", "Analyze the current page to understand its type, available actions, form structure, and navigation. Returns a rich page model with affordances, structure, and element relationships. Useful before interacting with a page to know what's possible.", {
+        _browserToken: z.string().optional().describe("Browser session token from a previous tool call. Pass this to analyze the same page you navigated to."),
+    }, async ({ _browserToken }) => {
+        try {
+            let b;
+            let token;
+            if (getBrowserByToken) {
+                const result = await getBrowserByToken(_browserToken);
+                b = result.browser;
+                token = result.token;
+            }
+            else {
+                b = await getBrowser();
+            }
+            const page = await b.getPage();
+            const { PageUnderstandingEngine } = await import("../../analysis/page-understanding.js");
+            const engine = new PageUnderstandingEngine();
+            const understanding = await engine.analyze(page);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            url: understanding.url,
+                            type: understanding.type,
+                            affordanceCount: understanding.affordances.length,
+                            formCount: understanding.structure.forms.length,
+                            ctaCount: understanding.structure.ctas.length,
+                            navigationGroups: understanding.structure.navigation.length,
+                            headingDepth: understanding.structure.headingHierarchy.length,
+                            relationshipCount: understanding.relationships.length,
+                            computeTimeMs: understanding.computeTimeMs,
+                            topAffordances: understanding.affordances.slice(0, 20).map((a) => ({
+                                element: a.element,
+                                text: a.elementText,
+                                action: a.action,
+                                expectedOutcome: a.expectedOutcome,
+                                confidence: a.confidence,
+                                reversible: a.reversible,
+                            })),
+                            forms: understanding.structure.forms.map((f) => ({
+                                label: f.label,
+                                fieldCount: f.fields.length,
+                                action: f.action,
+                                method: f.method,
+                                hasSubmitButton: !!f.submitButton,
+                            })),
+                            ctas: understanding.structure.ctas.map((c) => ({
+                                text: c.text,
+                                prominence: c.prominence,
+                                type: c.type,
+                            })),
+                            ...(token ? { _browserToken: token } : {}),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                            hint: "Ensure a page is loaded before calling page_understand. Navigate to a URL first.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Tool 2: site_model_status
+    // ---------------------------------------------------------------------------
+    server.tool("site_model_status", "Show what CBrowser knows about a site from previous interactions. Returns navigation graph stats, element reliability scores, known goal paths, and failure patterns.", {
+        domain: z.string().describe("Domain to check (e.g., 'example.com')"),
+    }, async ({ domain }) => {
+        try {
+            const { SiteModelManager } = await import("../../site-model/manager.js");
+            const manager = SiteModelManager.getInstance();
+            const stats = await manager.getModelStats(domain);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(stats, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            domain,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Tool 3: site_model_query
+    // ---------------------------------------------------------------------------
+    server.tool("site_model_query", "Query the site model for the best known path to achieve a goal type on a domain. Returns the most successful action sequence if one exists.", {
+        domain: z.string().describe("Domain to query (e.g., 'example.com')"),
+        goalType: z.enum([
+            "find_information",
+            "complete_action",
+            "navigate_to",
+            "fill_form",
+            "compare",
+            "explore",
+            "extract_data",
+        ]).describe("Type of goal to find the best path for"),
+    }, async ({ domain, goalType }) => {
+        try {
+            const { SiteModelManager } = await import("../../site-model/manager.js");
+            const manager = SiteModelManager.getInstance();
+            await manager.loadModel(domain);
+            const bestPath = manager.queryBestPath(domain, goalType);
+            if (!bestPath) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                domain,
+                                goalType,
+                                found: false,
+                                message: `No known path for goal type '${goalType}' on ${domain}. The site model will learn paths as you interact with the site.`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            domain,
+                            goalType,
+                            found: true,
+                            path: {
+                                goalDescription: bestPath.goalDescription,
+                                successRate: bestPath.successRate,
+                                attemptCount: bestPath.attemptCount,
+                                averageSteps: bestPath.averageSteps,
+                                lastUsed: new Date(bestPath.lastUsed).toISOString(),
+                                actionSequence: bestPath.actionSequence,
+                                personaPerformance: bestPath.personaPerformance,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            domain,
+                            goalType,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Tool 4: site_profile_list
+    // ---------------------------------------------------------------------------
+    server.tool("site_profile_list", "List all persistent site profiles (saved browser state per domain). Shows which sites have saved cookies, localStorage, and auth state.", {}, async () => {
+        try {
+            const { SiteProfileManager } = await import("../../browser/site-profile-manager.js");
+            const manager = new SiteProfileManager();
+            const profiles = await manager.listProfiles();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            profileCount: profiles.length,
+                            profiles: profiles.map((p) => ({
+                                domain: p.domain,
+                                lastUsed: p.lastUsed,
+                                cookieCount: p.cookieCount,
+                                authStatus: p.authStatus,
+                                sizeBytes: p.sizeBytes,
+                                healthy: p.healthy,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Tool 5: site_profile_delete
+    // ---------------------------------------------------------------------------
+    server.tool("site_profile_delete", "Delete a persistent site profile for a domain. Removes saved cookies, localStorage, and auth state.", {
+        domain: z.string().describe("Domain whose profile to delete (e.g., 'example.com')"),
+    }, async ({ domain }) => {
+        try {
+            const { SiteProfileManager } = await import("../../browser/site-profile-manager.js");
+            const manager = new SiteProfileManager();
+            const deleted = await manager.deleteProfile(domain);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: deleted,
+                            domain,
+                            message: deleted
+                                ? `Profile for '${domain}' deleted successfully`
+                                : `No profile found for '${domain}'`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            domain,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // Tool 6: site_profile_status
+    // ---------------------------------------------------------------------------
+    server.tool("site_profile_status", "Check the health of a site profile. Shows cookie count, expiry status, auth state, and whether the profile is still usable.", {
+        domain: z.string().describe("Domain to check (e.g., 'example.com')"),
+    }, async ({ domain }) => {
+        try {
+            const { SiteProfileManager } = await import("../../browser/site-profile-manager.js");
+            const manager = new SiteProfileManager();
+            const health = await manager.getProfileHealth(domain);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(health, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            domain,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=site-knowledge-tools.js.map

package/dist/mcp-tools/base/site-knowledge-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-knowledge-tools.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/site-knowledge-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,EAAE,UAAU,EAAE,iBAAiB,EAA2B;IAE1D,8EAA8E;IAC9E,0BAA0B;IAC1B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,sPAAsP,EACtP;QACE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uGAAuG,CAAC;KACvJ,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,IAAI,CAAyC,CAAC;YAC9C,IAAI,KAAyB,CAAC;YAC9B,IAAI,iBAAiB,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;gBACtD,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;gBACnB,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,CAAC,GAAG,MAAM,UAAU,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAC;YACzF,MAAM,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;YAC7C,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEjD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,GAAG,EAAE,aAAa,CAAC,GAAG;4BACtB,IAAI,EAAE,aAAa,CAAC,IAAI;4BACxB,eAAe,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM;4BACjD,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM;4BAC/C,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM;4BAC7C,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM;4BAC3D,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM;4BAC7D,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM;4BACrD,aAAa,EAAE,aAAa,CAAC,aAAa;4BAC1C,cAAc,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCACjE,OAAO,EAAE,CAAC,CAAC,OAAO;gCAClB,IAAI,EAAE,CAAC,CAAC,WAAW;gCACnB,MAAM,EAAE,CAAC,CAAC,MAAM;gCAChB,eAAe,EAAE,CAAC,CAAC,eAAe;gCAClC,UAAU,EAAE,CAAC,CAAC,UAAU;gCACxB,UAAU,EAAE,CAAC,CAAC,UAAU;6BACzB,CAAC,CAAC;4BACH,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC/C,KAAK,EAAE,CAAC,CAAC,KAAK;gCACd,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;gCAC3B,MAAM,EAAE,CAAC,CAAC,MAAM;gCAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gCAChB,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;6BAClC,CAAC,CAAC;4BACH,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,UAAU,EAAE,CAAC,CAAC,UAAU;gCACxB,IAAI,EAAE,CAAC,CAAC,IAAI;6BACb,CAAC,CAAC;4BACH,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC3C,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;4BACvD,IAAI,EAAE,kFAAkF;yBACzF,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,4BAA4B;IAC5B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,uKAAuK,EACvK;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACrE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;qBACrC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,MAAM;4BACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,2BAA2B;IAC3B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,6IAA6I,EAC7I;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACpE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;YACf,kBAAkB;YAClB,iBAAiB;YACjB,aAAa;YACb,WAAW;YACX,SAAS;YACT,SAAS;YACT,cAAc;SACf,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;YAC/C,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,MAAM;gCACN,QAAQ;gCACR,KAAK,EAAE,KAAK;gCACZ,OAAO,EAAE,gCAAgC,QAAQ,QAAQ,MAAM,kEAAkE;6BAClI,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,MAAM;4BACN,QAAQ;4BACR,KAAK,EAAE,IAAI;4BACX,IAAI,EAAE;gCACJ,eAAe,EAAE,QAAQ,CAAC,eAAe;gCACzC,WAAW,EAAE,QAAQ,CAAC,WAAW;gCACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gCACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;gCACnC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;gCACnD,cAAc,EAAE,QAAQ,CAAC,cAAc;gCACvC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;6BAChD;yBACF,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,MAAM;4BACN,QAAQ;4BACR,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,4BAA4B;IAC5B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,yIAAyI,EACzI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACrF,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAE9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,YAAY,EAAE,QAAQ,CAAC,MAAM;4BAC7B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC7B,MAAM,EAAE,CAAC,CAAC,MAAM;gCAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gCACpB,WAAW,EAAE,CAAC,CAAC,WAAW;gCAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;gCACxB,SAAS,EAAE,CAAC,CAAC,SAAS;gCACtB,OAAO,EAAE,CAAC,CAAC,OAAO;6BACnB,CAAC,CAAC;yBACJ,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,8BAA8B;IAC9B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,qGAAqG,EACrG;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;KACpF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACrF,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAEpD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,OAAO;4BAChB,MAAM;4BACN,OAAO,EAAE,OAAO;gCACd,CAAC,CAAC,gBAAgB,MAAM,wBAAwB;gCAChD,CAAC,CAAC,yBAAyB,MAAM,GAAG;yBACvC,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,MAAM;4BACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,8BAA8B;IAC9B,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,6HAA6H,EAC7H;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACrE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACrF,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAEtD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,KAAK;4BACd,MAAM;4BACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp-tools/index.d.ts

@@ -6,18 +6,18 @@
  * Tool counts by deployment:
  *
  * LOCAL MCP (npx cbrowser mcp-server):
- * - Base tools: 65 (4 marketing as stubs, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
+ * - Base tools: 78 (4 marketing as stubs, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
  * - Persona creation: 7
  * - Ask user: 1
  * - Enterprise stubs: 18
- * - Total: 91 (68 real + 23 stubs)
+ * - Total: 104 (68 real + 23 stubs)
  *
  * DEMO SERVER (MCP_MODE=demo):
- * - Base tools: 65 (4 marketing real, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
+ * - Base tools: 78 (4 marketing real, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
  * - Persona creation: 7
  * - Ask user: 1
  * - Enterprise stubs: 18
- * - Total: 91 (72 real + 19 stubs)
+ * - Total: 104 (72 real + 19 stubs)
  *
  * ENTERPRISE (MCP_MODE=enterprise):
  * - All 91 tools fully functional
@@ -28,7 +28,7 @@
 export type { McpServer, CBrowser, ToolRegistrationContext } from "./types.js";
 export { setRemoteMode, getRemoteMode, transformResponseForRemote, MAX_RESPONSE_SIZE, } from "./screenshot-utils.js";
 export { registerBaseTools } from "./base/index.js";
-export { registerNavigationTools, registerInteractionTools, registerExtractionTools, registerAssertionTools, registerAnalysisTools, registerSessionTools, registerHealingTools, registerVisualTestingTools, registerTestingTools, registerBugAnalysisTools, registerPersonaComparisonTools, registerCognitiveTools, registerValuesTools, registerPerformanceTools, registerAuditTools, registerBrowserManagementTools, registerSecurityTools, registerMarketingTools, registerRemediationTools, registerLlmsTxtTools, } from "./base/index.js";
+export { registerNavigationTools, registerInteractionTools, registerExtractionTools, registerAssertionTools, registerAnalysisTools, registerSessionTools, registerHealingTools, registerVisualTestingTools, registerTestingTools, registerBugAnalysisTools, registerPersonaComparisonTools, registerCognitiveTools, registerValuesTools, registerPerformanceTools, registerAuditTools, registerBrowserManagementTools, registerSecurityTools, registerMarketingTools, registerRemediationTools, registerLlmsTxtTools, registerSiteKnowledgeTools, } from "./base/index.js";
 export { registerPersonaCreationTools } from "./persona-creation-tools.js";
 export { registerAskUserTool } from "./ask-user-tools.js";
 export { registerEnterpriseStubs } from "./enterprise-stubs.js";
@@ -36,7 +36,7 @@ import type { McpServer, ToolRegistrationContext } from "./types.js";
 /**
  * Register all public npm tools on an MCP server
  *
- * Tool count: 91 tools across all deployments
+ * Tool count: 104 tools across all deployments
  * - LOCAL: 91 tools (68 real + 23 stubs including 4 marketing stubs)
  * - DEMO: 91 tools (72 real + 19 stubs)
  * - ENTERPRISE: 91 tools all functional

package/dist/mcp-tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMrE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAYN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMrE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAYN"}

package/dist/mcp-tools/index.js

@@ -6,18 +6,18 @@
  * Tool counts by deployment:
  *
  * LOCAL MCP (npx cbrowser mcp-server):
- * - Base tools: 65 (4 marketing as stubs, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
+ * - Base tools: 78 (4 marketing as stubs, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
  * - Persona creation: 7
  * - Ask user: 1
  * - Enterprise stubs: 18
- * - Total: 91 (68 real + 23 stubs)
+ * - Total: 104 (68 real + 23 stubs)
  *
  * DEMO SERVER (MCP_MODE=demo):
- * - Base tools: 65 (4 marketing real, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
+ * - Base tools: 78 (4 marketing real, 3 remediation, 1 ai_benchmark, 2 llms.txt, 1 webmcp_ready)
  * - Persona creation: 7
  * - Ask user: 1
  * - Enterprise stubs: 18
- * - Total: 91 (72 real + 19 stubs)
+ * - Total: 104 (72 real + 19 stubs)
  *
  * ENTERPRISE (MCP_MODE=enterprise):
  * - All 91 tools fully functional
@@ -30,7 +30,7 @@ export { setRemoteMode, getRemoteMode, transformResponseForRemote, MAX_RESPONSE_
 // Re-export base tools
 export { registerBaseTools } from "./base/index.js";
 // Re-export individual base tool categories for granular use
-export { registerNavigationTools, registerInteractionTools, registerExtractionTools, registerAssertionTools, registerAnalysisTools, registerSessionTools, registerHealingTools, registerVisualTestingTools, registerTestingTools, registerBugAnalysisTools, registerPersonaComparisonTools, registerCognitiveTools, registerValuesTools, registerPerformanceTools, registerAuditTools, registerBrowserManagementTools, registerSecurityTools, registerMarketingTools, registerRemediationTools, registerLlmsTxtTools, } from "./base/index.js";
+export { registerNavigationTools, registerInteractionTools, registerExtractionTools, registerAssertionTools, registerAnalysisTools, registerSessionTools, registerHealingTools, registerVisualTestingTools, registerTestingTools, registerBugAnalysisTools, registerPersonaComparisonTools, registerCognitiveTools, registerValuesTools, registerPerformanceTools, registerAuditTools, registerBrowserManagementTools, registerSecurityTools, registerMarketingTools, registerRemediationTools, registerLlmsTxtTools, registerSiteKnowledgeTools, } from "./base/index.js";
 // Re-export persona creation tools
 export { registerPersonaCreationTools } from "./persona-creation-tools.js";
 // Re-export ask user tool
@@ -44,13 +44,13 @@ import { registerEnterpriseStubs } from "./enterprise-stubs.js";
 /**
  * Register all public npm tools on an MCP server
  *
- * Tool count: 91 tools across all deployments
+ * Tool count: 104 tools across all deployments
  * - LOCAL: 91 tools (68 real + 23 stubs including 4 marketing stubs)
  * - DEMO: 91 tools (72 real + 19 stubs)
  * - ENTERPRISE: 91 tools all functional
  */
 export function registerAllPublicTools(server, context) {
-    // Base tools (65)
+    // Base tools (78)
     registerBaseTools(server, context);
     // Persona creation tools (7)
     registerPersonaCreationTools(server);

package/dist/mcp-tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,iCAAiC;AACjC,OAAO,EACL,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6DAA6D;AAC7D,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,mCAAmC;AACnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,6BAA6B;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,OAAgC;IAEhC,kBAAkB;IAClB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,6BAA6B;IAC7B,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,oBAAoB;IACpB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,wBAAwB;IACxB,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,iCAAiC;AACjC,OAAO,EACL,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6DAA6D;AAC7D,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,mCAAmC;AACnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,6BAA6B;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,OAAgC;IAEhC,kBAAkB;IAClB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,6BAA6B;IAC7B,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAErC,oBAAoB;IACpB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,wBAAwB;IACxB,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/site-model/manager.d.ts

@@ -0,0 +1,161 @@
+/**
+ * CBrowser - Site Model Manager
+ * Persistent knowledge graph per site with incremental updates,
+ * write-coalescing, data decay, and size-capped storage.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ * @since v18.35.0
+ */
+import type { SiteModel, NavigationEdge, GoalPath, GoalAction, GoalType, FailureType, SiteModelStats, PruneResult } from "./types.js";
+export declare class SiteModelManager {
+    private modelDir;
+    private models;
+    private dirty;
+    private writeTimer;
+    /** Singleton instance for process-wide sharing */
+    private static _instance;
+    /** Get or create the singleton instance */
+    static getInstance(dataDir?: string): SiteModelManager;
+    /** Maximum JSON size per domain model file */
+    private static readonly MAX_MODEL_SIZE;
+    /** Data older than this is subject to decay/pruning */
+    private static readonly DECAY_THRESHOLD_MS;
+    /** Write-coalescing debounce interval */
+    private static readonly WRITE_DEBOUNCE_MS;
+    /** Minimum reliability/confidence before an entry is prunable */
+    private static readonly MIN_CONFIDENCE;
+    /** Maximum goal paths stored per domain */
+    private static readonly MAX_GOAL_PATHS;
+    /** Maximum failure patterns stored per domain */
+    private static readonly MAX_FAILURE_PATTERNS;
+    /** Failure pattern expiry */
+    private static readonly FAILURE_EXPIRY_MS;
+    constructor(dataDir?: string);
+    /**
+     * Lazy-load a site model from disk. If no file exists, creates an empty model.
+     * On load, stale data is pruned automatically.
+     */
+    loadModel(domain: string): Promise<SiteModel>;
+    /**
+     * Get model from cache or create empty one in memory (synchronous).
+     * This ensures record methods work without a prior loadModel() call.
+     */
+    private getOrCreateModel;
+    /**
+     * Record a successful navigation from one page to another via a specific element.
+     */
+    recordNavigation(domain: string, fromUrl: string, toUrl: string, elementSelector: string, elementText: string): void;
+    /**
+     * Record the result (success/failure) of interacting with a specific element.
+     */
+    recordElementResult(domain: string, pageUrl: string, selector: string, success: boolean): void;
+    /**
+     * Record a completed goal path attempt (success or failure).
+     * Matches existing paths by goalType + keyword overlap before creating new entries.
+     */
+    recordGoalPath(domain: string, goalDescription: string, goalType: GoalType, actions: GoalAction[], success: boolean, steps: number, persona?: string): void;
+    /**
+     * Record a failure pattern for a page/element combination.
+     */
+    recordFailure(domain: string, pageUrl: string, selector: string | undefined, failureType: FailureType, conditions: string[]): void;
+    /**
+     * Update or create a page fingerprint for structural change detection.
+     */
+    updateFingerprint(domain: string, urlPattern: string, headingHash: string, formCount: number, navLinkCount: number, ctaCount: number, pageType?: string): void;
+    /**
+     * Find the best known path for a given goal type.
+     * Weights by successRate * attemptCount to favor frequently successful paths.
+     */
+    queryBestPath(domain: string, goalType: GoalType): GoalPath | null;
+    /**
+     * Get the reliability score for a specific selector on a domain.
+     * Returns the success rate multiplied by decay factor. Returns 0 if unknown.
+     */
+    queryElementReliability(domain: string, selector: string): number;
+    /**
+     * Get all known navigation edges departing from a given URL.
+     * Sorted by reliability descending.
+     */
+    queryNavigationTargets(domain: string, fromUrl: string): NavigationEdge[];
+    /**
+     * Prune stale data from a domain's model. Can operate on a provided model
+     * (used during load) or look up the cached model by domain.
+     */
+    pruneStaleData(domain: string, targetModel?: SiteModel): PruneResult;
+    /**
+     * Get comprehensive statistics for a domain's model.
+     */
+    getModelStats(domain: string): Promise<SiteModelStats>;
+    /**
+     * Flush all pending writes and clear the debounce timer.
+     * Call this on process shutdown to avoid data loss.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Mark a domain's model as needing a write to disk.
+     * Starts a debounce timer if one isn't already running.
+     */
+    private markDirty;
+    /**
+     * Write all dirty models to disk. Enforces size cap before writing.
+     */
+    private flushDirty;
+    /**
+     * Enforce the 500KB per-domain model size cap.
+     * Evicts oldest/least-used data until the model fits within the cap.
+     */
+    private enforceModelSizeCap;
+    /**
+     * Create a fresh, empty site model for a domain.
+     */
+    private createEmptyModel;
+    /**
+     * Get a model, loading from disk if necessary.
+     */
+    private getModel;
+    /**
+     * Build the file path for a domain's model JSON.
+     * Sanitizes domain to be filesystem-safe.
+     */
+    private modelFilePath;
+    /**
+     * Normalize a domain string: lowercase, strip protocol, strip trailing slash.
+     */
+    private normalizeDomain;
+    /**
+     * Normalize a URL to just its path for consistent node keys.
+     * Strips query strings, hashes, and trailing slashes.
+     */
+    private normalizeUrl;
+    /**
+     * Find a similar goal path using goalType + keyword overlap in descriptions.
+     * Returns the best match if keyword overlap exceeds 50%.
+     */
+    private findSimilarGoalPath;
+    /**
+     * Extract meaningful keywords from a goal description for fuzzy matching.
+     */
+    private extractKeywords;
+    /**
+     * Evict the least valuable goal paths when over the cap.
+     * Score = successRate * attemptCount * recency_weight
+     */
+    private evictGoalPaths;
+    /**
+     * Evict the least relevant failure patterns when over the cap.
+     * Keeps the most recent and most frequent patterns.
+     */
+    private evictFailurePatterns;
+    /**
+     * When a page's structure changes (fingerprint hash differs),
+     * decay element reliability for selectors associated with that page.
+     */
+    private decayElementsForPage;
+    /**
+     * Remove navigation nodes that have no edges referencing them
+     * and have not been visited recently.
+     */
+    private pruneOrphanedNodes;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/site-model/manager.d.ts.map

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