@recapt/mcp 0.0.8-beta → 0.0.10-beta

package/dist/api/client.js

@@ -1,7 +1,9 @@
 /**
  * HTTP client for calling external-api query endpoints.
  */
-const API_URL = process.env.EXTERNAL_API_URL || "https://api.recapt.app";
+const API_URL = process.env.RECAPT_API_URL ||
+    process.env.EXTERNAL_API_URL ||
+    "https://api.recapt.app";
 const SECRET_KEY = process.env.RECAPT_SECRET_KEY;
 const REQUEST_TIMEOUT_MS = 120_000;
 export function isApiConfigured() {

package/dist/index.js

@@ -48,30 +48,20 @@ function createApiHandler(method, endpoint, buildParams) {
         }
         const url = typeof endpoint === "function" ? endpoint(args) : endpoint;
         const params = buildParams ? buildParams(args) : args;
-        let result;
-        switch (method) {
-            case "GET":
-                result = await apiGet(url, params);
-                break;
-            case "POST":
-                result = await apiPost(url, params);
-                break;
-            case "PATCH":
-                result = await apiPatch(url, params);
-                break;
-            case "DELETE":
-                result = await apiDelete(url);
-                break;
-        }
-        if (result.error) {
+        const apiCall = {
+            GET: () => apiGet(url, params),
+            POST: () => apiPost(url, params),
+            PATCH: () => apiPatch(url, params),
+            DELETE: () => apiDelete(url),
+        }[method];
+        const { data, error } = await apiCall();
+        if (error) {
             return {
-                content: [
-                    { type: "text", text: JSON.stringify({ error: result.error }) },
-                ],
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
                 isError: true,
             };
         }
-        return { content: [{ type: "text", text: JSON.stringify(result.data) }] };
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
     };
 }
 function registerHiddenTools() {
@@ -132,20 +122,12 @@ function registerHiddenTools() {
                 isError: true,
             };
         }
-        if (session_id && !session_ids) {
-            const { data, error } = await apiGet(`/sessions/${session_id}`);
-            if (error) {
-                return {
-                    content: [{ type: "text", text: JSON.stringify({ error }) }],
-                    isError: true,
-                };
-            }
-            return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        }
-        const ids = session_ids ?? [session_id];
-        const { data, error } = await apiPost("/sessions/details", {
-            session_ids: ids,
-        });
+        const isSingleSession = session_id && !session_ids;
+        const { data, error } = isSingleSession
+            ? await apiGet(`/sessions/${session_id}`)
+            : await apiPost("/sessions/details", {
+                session_ids: session_ids ?? [session_id],
+            });
         if (error) {
             return {
                 content: [{ type: "text", text: JSON.stringify({ error }) }],
@@ -209,10 +191,19 @@ call_tool({ tool_name: "analyze_flow", arguments: { start_page: "/pricing", end_
 
 These tools are always visible (no search needed):
 - **get_domains** — List tracked domains (good starting point)
-- **run_full_diagnostic** — Comprehensive site analysis with prioritized issues
+- **run_full_diagnostic** — Quick site health overview (lightweight, fast)
 - **triage_sessions** — Find sessions needing attention
 - **memory_*** — Store/retrieve intermediate results
 
+## Comprehensive Site Analysis
+
+For a full site analysis, run these tools in sequence:
+1. **run_full_diagnostic** — Get health score, issues, problem pages
+2. **detect_regressions** — Check for recent behavioral regressions (separate call)
+3. **get_ux_health_report** — Detailed per-page breakdown if needed
+
+This split approach is faster and more reliable than a single heavy query.
+
 ## Metric Interpretation
 
 All behavioral scores are 0-1 where higher = more of that signal:
@@ -231,6 +222,14 @@ All behavioral scores are 0-1 where higher = more of that signal:
 - High frustration + low confusion = users know what to do but can't (broken UI)
 - Use \`memory_save\` to store intermediate results when doing multi-step analysis
 
+## Tool Limits
+
+Some tools have built-in limits for performance:
+- **detect_regressions**: Default 50 pages per call, 200 snapshots per page. Use \`offset\` and \`limit\` to paginate. Use \`sort_by='low_traffic'\` to check overlooked pages.
+- **discover_personas**: Max 8 personas
+- **list_pages**: Default 50 pages, configurable
+- **get_session_details**: Max 20 sessions per batch
+
 ## Installable Skills
 
 For guided workflows (self-healing, deep-dive analysis, regression hunting), install recapt skills:

package/dist/tools/catalog/toolCatalog.json

@@ -6484,400 +6484,415 @@
   },
   {
     "name": "detect_regressions",
-    "description": "Detect behavioral regressions by comparing recent data against rolling 7-day baselines. Returns pages where frustration, confusion, or rage click rate have deviated significantly.",
+    "description": "Detect behavioral regressions by comparing recent data against rolling 7-day baselines. By default analyzes top 50 pages by traffic. Use sort_by='low_traffic' to check low-traffic pages that might otherwise be missed. Use offset/limit to paginate through all pages. Returns pages where frustration, confusion, or rage click rate have deviated significantly.",
     "category": "monitoring",
     "parameters": {
       "window_hours": {
         "type": "number",
         "required": false,
         "description": "How many recent hours to compare against baseline (default 24)"
+      },
+      "limit": {
+        "type": "number",
+        "required": false,
+        "description": "Number of pages to check per request (default 50, max 100)"
+      },
+      "offset": {
+        "type": "number",
+        "required": false,
+        "description": "Skip this many pages for pagination (default 0)"
+      },
+      "sort_by": {
+        "type": "string",
+        "required": false,
+        "description": "Sort order: 'traffic' (default, high-traffic first) or 'low_traffic' (check overlooked pages)"
       }
     },
     "embedding": [
-      0.000011,
-      -0.084606,
-      0.001591,
-      0.078133,
-      0.091491,
-      0.003382,
-      -0.03171,
-      -0.030145,
-      -0.040675,
-      -0.019577,
-      0.002829,
-      0.010849,
-      0.010026,
-      0.056925,
-      -0.020273,
-      0.007328,
-      0.002924,
-      -0.004754,
-      0.025738,
-      -0.023942,
-      -0.018301,
-      0.001583,
-      -0.015177,
-      0.022537,
-      -0.025155,
-      0.065546,
-      -0.056236,
-      -0.040427,
-      -0.031485,
-      -0.019129,
-      -0.008007,
-      0.051389,
-      0.041649,
-      0.01401,
-      -0.00668,
-      -0.083701,
-      0.008091,
-      -0.014093,
-      0.053841,
-      -0.011324,
-      -0.052931,
-      -0.105487,
-      0.050694,
-      -0.001094,
-      0.004072,
-      -0.027514,
-      -0.038166,
-      0.013453,
-      -0.084733,
-      0.016732,
-      -0.037371,
-      -0.084957,
-      0.074391,
-      -0.055364,
-      -0.018399,
-      -0.039906,
-      0.044713,
-      0.004805,
-      0.035781,
-      0.066356,
-      0.003914,
-      -0.032175,
-      -0.062067,
-      0.063061,
-      -0.045265,
-      0.128767,
-      -0.048591,
-      -0.035052,
-      0.020813,
-      0.021567,
-      -0.055207,
-      -0.002772,
-      -0.011765,
-      -0.015748,
-      0.089807,
-      -0.07693,
-      -0.008157,
-      0.003664,
-      0.067731,
-      -0.113338,
-      -0.067135,
-      0.016385,
-      0.001775,
-      -0.011202,
-      0.076363,
-      -0.016472,
-      0.023474,
-      0.045758,
-      -0.091523,
-      0.060628,
-      0.047019,
-      -0.036401,
-      -0.028421,
-      0.019263,
-      -0.075914,
-      0.01695,
-      -0.088695,
-      -0.036792,
-      0.024585,
-      0.05091,
-      -0.042816,
-      0.070805,
-      -0.019256,
-      0.034998,
-      0.013947,
-      -0.000311,
-      0.034003,
-      -0.015612,
-      -0.049331,
-      0.005741,
-      -0.103982,
-      0.039591,
-      0.040582,
-      -0.020481,
-      0.031166,
-      -0.061541,
-      -0.06415,
-      -0.006132,
-      0.085319,
-      0.008508,
-      0.166461,
-      0.00143,
-      0.039644,
-      -0.008834,
-      0.050216,
-      0.112576,
-      -0.161324,
+      0.029739,
+      -0.037854,
+      -0.007498,
+      0.050917,
+      0.06084,
+      -0.016029,
+      -0.019992,
+      -0.006213,
+      -0.077974,
+      0.024877,
+      -0.026286,
+      0.046091,
+      0.001876,
+      0.025006,
+      -0.055402,
+      0.024394,
+      -0.00967,
+      0.015183,
+      0.048272,
+      -0.074896,
+      -0.005384,
+      0.062265,
+      -0.00324,
+      0.022973,
+      -0.040664,
+      0.067751,
+      -0.073004,
+      -0.03681,
+      0.002883,
+      -0.022037,
+      -0.004448,
+      0.055557,
+      -0.029818,
+      0.06324,
+      -0.015527,
+      -0.091029,
+      -0.025808,
+      -0.090558,
+      0.0871,
+      0.002504,
+      0.003779,
+      -0.063624,
+      0.006187,
+      0.006841,
+      -0.002103,
+      -0.044959,
+      -0.061788,
+      0.01194,
+      -0.003896,
+      -0.052659,
+      -0.038156,
+      -0.020247,
+      0.052098,
+      -0.035897,
+      -0.035624,
+      -0.064473,
+      0.012612,
+      -0.059332,
+      -0.000848,
+      0.008588,
+      0.004709,
+      -0.043208,
+      -0.010858,
+      0.021742,
+      -0.100977,
+      0.088991,
+      -0.01991,
+      0.043597,
+      0.055709,
+      0.099795,
+      -0.035567,
+      0.023794,
+      -0.040071,
+      -0.013235,
+      0.077832,
+      -0.130459,
+      0.007821,
+      -0.052328,
+      -0.003133,
+      -0.100751,
+      -0.096811,
+      -0.064354,
+      -0.008996,
+      0.022161,
+      0.06765,
+      -0.028383,
+      0.044112,
+      0.021452,
+      -0.078971,
+      0.032096,
+      0.03627,
+      0.011746,
+      -0.027071,
+      0.033822,
+      -0.048214,
+      0.028052,
+      -0.054125,
+      -0.059643,
+      0.035839,
+      0.082955,
+      -0.036822,
+      0.066503,
+      0.01187,
+      0.006232,
+      -0.009584,
+      0.01431,
+      0.094968,
+      -0.016097,
+      -0.088064,
+      0.054678,
+      -0.065112,
+      0.046471,
+      0.033751,
+      -0.026071,
+      0.014287,
+      -0.04657,
+      -0.013398,
+      -0.043076,
+      -0.003179,
+      0.026761,
+      0.137574,
+      0.024168,
+      0.005613,
+      0.036922,
+      0.055716,
+      0.140864,
+      -0.111314,
       0,
-      0.041207,
-      0.031339,
-      -0.029592,
-      -0.041209,
-      -0.059992,
-      0.009539,
-      -0.052576,
-      -0.000639,
-      0.069108,
-      0.045734,
-      -0.055957,
-      0.06485,
-      -0.052147,
-      0.077693,
-      0.042915,
-      0.033694,
-      -0.016117,
-      0.099307,
-      -0.054162,
-      0.010393,
-      0.013537,
-      -0.06288,
-      -0.023222,
-      -0.000762,
-      -0.045244,
-      0.020773,
-      -0.040263,
-      0.034897,
-      -0.057078,
-      0.020128,
-      0.001984,
-      0.003468,
-      -0.067339,
-      -0.010592,
-      0.019514,
-      0.046394,
-      0.037474,
-      0.00658,
-      -0.026385,
-      -0.020456,
-      -0.019172,
-      -0.00229,
-      -0.013537,
-      -0.011342,
-      -0.040101,
-      0.056954,
-      -0.015175,
-      -0.077402,
-      0.011002,
-      0.056746,
-      0.016636,
-      0.024669,
-      0.054436,
-      0.006026,
-      -0.075588,
-      0.061711,
-      -0.039959,
-      -0.072256,
-      -0.0068,
-      -0.022149,
-      0.055915,
-      -0.103902,
-      0.047846,
-      -0.203337,
-      -0.025649,
-      0.06845,
-      0.019189,
-      0.013701,
-      0.000082,
-      0.070318,
-      0.046845,
-      0.075055,
-      -0.020022,
-      -0.107917,
-      0.053563,
-      -0.059377,
-      0.034091,
-      -0.044758,
-      0.004994,
-      -0.094046,
-      0.119542,
-      -0.102817,
-      -0.020345,
-      -0.07705,
-      0.000667,
-      -0.029178,
-      0.013994,
-      -0.06415,
-      -0.10744,
-      0.04325,
-      -0.078293,
-      -0.000961,
-      -0.031229,
-      0.091067,
-      -0.014786,
+      0.041824,
+      0.019412,
+      -0.033757,
+      -0.080961,
+      -0.062727,
+      0.075514,
+      -0.012199,
+      0.004653,
+      0.051502,
+      0.027879,
+      -0.047042,
+      0.063608,
+      -0.060384,
+      0.077243,
+      0.042728,
+      0.02025,
+      -0.000889,
+      0.074956,
+      -0.015263,
+      0.022017,
+      0.026597,
+      -0.072091,
+      -0.068947,
+      0.002572,
+      0.017823,
+      0.028407,
+      -0.062443,
+      0.042962,
+      -0.034435,
+      0.013257,
+      0.001228,
+      0.017691,
+      -0.036305,
+      0.009104,
+      0.011312,
+      0.016391,
+      -0.032245,
+      0.036844,
+      -0.030212,
+      -0.019025,
+      -0.062218,
+      0.01787,
+      -0.035959,
+      -0.07145,
+      -0.082602,
+      0.058847,
+      -0.032067,
+      -0.002645,
+      0.034337,
+      0.072578,
+      0.013094,
+      -0.04352,
+      0.007624,
+      0.065604,
+      -0.094586,
+      -0.015157,
+      -0.043702,
+      -0.036224,
+      0.040929,
+      -0.011489,
+      0.063186,
+      -0.130861,
+      0.040064,
+      -0.152796,
+      0.003327,
+      0.024565,
+      0.020197,
+      0.090647,
+      0.005792,
+      0.072089,
+      0.016977,
+      0.062858,
+      0.040581,
+      -0.046475,
+      0.075046,
+      -0.048003,
+      0.005048,
+      -0.043309,
+      0.007499,
+      -0.045662,
+      0.107233,
+      -0.080935,
+      0.018719,
+      -0.112389,
+      -0.032005,
+      -0.02721,
+      0.034682,
+      -0.003679,
+      -0.090258,
+      -0.003373,
+      -0.111179,
+      0.022778,
+      -0.015117,
+      0.034344,
+      -0.038471,
       0,
-      -0.036133,
-      0.038392,
-      0.038619,
-      0.090789,
-      -0.08728,
-      0.02369,
-      0.059473,
-      0.04821,
-      -0.009456,
-      -0.003994,
-      0.061806,
-      -0.037924,
-      -0.006271,
-      0.072305,
-      0.050815,
-      0.026702,
-      0.001673,
-      -0.05819,
-      0.019152,
-      0.036359,
-      -0.032496,
-      0.051887,
-      -0.037092,
-      -0.053097,
-      -0.02636,
-      -0.009707,
-      -0.017974,
-      0.016462,
-      0.000993,
-      -0.026924,
-      0.013095,
-      0.079399,
-      -0.059147,
-      0.031969,
-      0.027656,
-      0.037213,
-      -0.05038,
-      -0.031062,
-      -0.045464,
-      -0.00484,
-      0.055861,
-      0.066009,
-      -0.051092,
-      -0.033393,
-      0.001737,
-      0.105645,
-      0.018786,
-      0.044871,
-      -0.040624,
-      -0.007657,
-      -0.020113,
-      0.048647,
-      -0.012597,
-      -0.004991,
-      -0.05409,
-      -0.019942,
-      -0.033143,
-      -0.079024,
-      -0.13515,
-      -0.003692,
-      -0.034318,
-      0.052774,
-      -0.103217,
-      0.033086,
-      0.024527,
-      -0.057731,
-      0.036294,
-      -0.029131,
-      0.020744,
-      0.036442,
-      0.003712,
-      -0.017951,
-      -0.009231,
-      -0.045027,
-      -0.019593,
-      0.004364,
-      -0.039851,
-      -0.036465,
-      -0.070976,
-      0.007695,
-      -0.005989,
-      -0.031751,
-      0.081286,
-      -0.01977,
-      -0.117024,
-      0.065602,
-      -0.008891,
-      0.059404,
-      0.023798,
-      -0.010117,
-      -0.001963,
-      0.044821,
-      -0.106961,
-      -0.002225,
-      0.038506,
+      -0.018613,
+      0.060067,
+      0.076554,
+      0.091139,
+      -0.063117,
+      0.002999,
+      0.067232,
+      0.029988,
+      0.023469,
+      0.009471,
+      0.068124,
+      -0.042212,
+      0.033127,
+      0.040537,
+      0.062643,
+      0.028672,
+      0.017383,
+      -0.126003,
+      0.023249,
+      0.039692,
+      -0.080872,
+      0.068036,
+      -0.020448,
+      -0.1032,
+      -0.057613,
+      -0.018752,
+      -0.022018,
+      0.041261,
+      -0.019029,
+      -0.036425,
+      0.012815,
+      0.066957,
+      -0.044481,
+      0.007088,
+      0.004556,
+      0.091268,
+      -0.034935,
+      -0.008851,
+      -0.017086,
+      0.004428,
+      0.067171,
+      0.091273,
+      -0.033939,
+      -0.035174,
+      -0.033943,
+      0.092928,
+      -0.011711,
+      0.036215,
+      -0.047752,
+      -0.03928,
+      -0.033228,
+      0.040336,
+      0.030886,
+      0.008587,
+      -0.050917,
+      0.017539,
+      -0.031221,
+      -0.034651,
+      -0.135003,
+      -0.010527,
+      -0.013776,
+      0.064495,
+      -0.118187,
+      0.043506,
+      0.016505,
+      -0.057416,
+      0.005695,
+      -0.051382,
+      0.014019,
+      0.031513,
+      -0.039971,
+      0.051711,
+      0.033309,
+      -0.005771,
+      -0.034043,
+      -0.007335,
+      -0.060966,
+      -0.008036,
+      0.000716,
+      0.015842,
+      -0.003319,
+      0.022808,
+      0.038986,
+      -0.061263,
+      -0.092411,
+      0.072051,
+      -0.066806,
+      0.018686,
+      0.021136,
+      -0.022717,
+      -0.035412,
+      0.013526,
+      -0.095462,
+      0.008459,
+      0.025815,
       0,
-      -0.03337,
-      -0.033004,
-      0.083005,
-      0.021407,
-      0.012878,
-      0.054637,
-      0.070143,
-      0.070999,
-      -0.079972,
-      -0.046404,
-      0.074651,
-      -0.012591,
-      0.004531,
-      0.007187,
-      -0.013604,
-      0.000272,
-      -0.020952,
-      0.078295,
-      -0.021379,
-      0.019214,
-      0.035589,
-      0.06693,
-      0.04398,
-      -0.06156,
-      -0.016194,
-      -0.017498,
-      -0.075011,
-      0.11856,
-      0.034839,
-      -0.023829,
-      0.0978,
-      0.0626,
-      -0.039829,
-      -0.111578,
-      0.076659,
-      0.057937,
-      0.034415,
-      -0.024282,
-      0.044927,
-      0.054342,
-      -0.034757,
-      0.013514,
-      -0.04463,
-      -0.00035,
-      -0.019053,
-      -0.010321,
-      0.061773,
-      -0.085876,
-      0.059112,
-      -0.024498,
-      0.073528,
-      0.006073,
-      -0.024021,
-      0.080467,
-      0.00316,
-      -0.020915,
-      -0.022035,
-      0.047111,
-      -0.029479,
-      0.034648,
-      0.074681,
-      -0.023871,
-      -0.003548,
-      -0.005969
+      -0.011153,
+      -0.04058,
+      0.121199,
+      0.058841,
+      0.015953,
+      0.016097,
+      0.078313,
+      0.107461,
+      -0.086684,
+      -0.017774,
+      0.072035,
+      -0.011303,
+      -0.025372,
+      0.01933,
+      0.038669,
+      -0.037395,
+      -0.003818,
+      0.020909,
+      -0.066188,
+      -0.00551,
+      -0.01575,
+      0.038126,
+      0.04159,
+      -0.044173,
+      0.032946,
+      0.001453,
+      -0.03071,
+      0.082091,
+      0.030543,
+      -0.071939,
+      0.103283,
+      0.036915,
+      -0.070866,
+      -0.097545,
+      0.078654,
+      0.094637,
+      -0.013259,
+      0.00627,
+      -0.00367,
+      0.021725,
+      -0.057931,
+      0.004171,
+      -0.00183,
+      -0.001362,
+      0.021022,
+      -0.027248,
+      -0.004775,
+      -0.07134,
+      0.099328,
+      -0.054879,
+      0.068009,
+      -0.044679,
+      -0.009519,
+      0.077423,
+      -0.005144,
+      -0.029991,
+      0.004407,
+      0.062962,
+      -0.040132,
+      0.010847,
+      0.045873,
+      -0.042232,
+      -0.018729,
+      0.018884
     ]
   },
   {

package/dist/tools/detectRegressions.js

@@ -8,19 +8,33 @@ import { apiGet, isApiConfigured } from "../api/client.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function registerDetectRegressions(server) {
     server.registerTool("detect_regressions", {
-        description: "Detect behavioral regressions by comparing recent data (last 24h by default) against " +
-            "rolling 7-day baselines. Returns pages where frustration, confusion, or rage click rate " +
-            "have deviated significantly from normal levels, with z-scores indicating severity. " +
-            "Critical (z>3) means an extreme deviation, high (z>2) is notable, medium (z>1.5) is worth monitoring. " +
-            "Use this to catch deployments or changes that degraded user experience.",
+        description: "Detect behavioral regressions by comparing recent data against rolling 7-day baselines. " +
+            "By default analyzes top 50 pages by traffic. Use sort_by='low_traffic' to check low-traffic " +
+            "pages that might otherwise be missed. Use offset/limit to paginate through all pages. " +
+            "Returns pages where frustration, confusion, or rage click rate have deviated significantly.",
         inputSchema: z.object({
             window_hours: z
                 .number()
                 .optional()
                 .default(24)
                 .describe("How many recent hours to compare against baseline (default 24)"),
+            limit: z
+                .number()
+                .optional()
+                .default(50)
+                .describe("Number of pages to check per request (default 50, max 100)"),
+            offset: z
+                .number()
+                .optional()
+                .default(0)
+                .describe("Skip this many pages for pagination (default 0)"),
+            sort_by: z
+                .enum(["traffic", "low_traffic"])
+                .optional()
+                .default("traffic")
+                .describe("Sort order: 'traffic' (default) or 'low_traffic' to check overlooked pages"),
         }),
-    }, async ({ window_hours }) => {
+    }, async ({ window_hours, limit, offset, sort_by, }) => {
         if (!isApiConfigured()) {
             return {
                 content: [
@@ -34,6 +48,9 @@ export function registerDetectRegressions(server) {
         }
         const { data, error } = await apiGet("/regressions", {
             window_hours: window_hours ?? 24,
+            limit: limit ?? 50,
+            offset: offset ?? 0,
+            sort_by: sort_by ?? "traffic",
         });
         if (error) {
             return {

package/dist/tools/diagnostic.js

@@ -8,7 +8,10 @@ import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function registerDiagnosticTools(server) {
     server.registerTool("run_full_diagnostic", {
-        description: "Run a comprehensive site diagnostic. Returns prioritized issues, problem pages, regressions, and recommended investigation order. Use this as the first step in a self-healing workflow.",
+        description: "Get a quick site health overview with prioritized issues and problem pages. " +
+            "This is a lightweight entry point — it does NOT include regression detection. " +
+            "For a complete analysis, call detect_regressions separately after this. " +
+            "Returns: health score, top issues, pages needing attention, and investigation order.",
         inputSchema: z.object({
             days: z
                 .number()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.8-beta",
+  "version": "0.0.10-beta",
   "description": "MCP exposing recapt behavioral intelligence to AI coding agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/cli/skill.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * Recapt Skills CLI
- *
- * Installs recapt workflow skills to .agents/recapt/ and manages AGENTS.md references.
- * Works across all AI IDEs that support the AGENTS.md standard.
- *
- * Usage:
- *   npx @recapt/mcp skill list
- *   npx @recapt/mcp skill install self-healing
- *   npx @recapt/mcp skill install --all
- *   npx @recapt/mcp skill uninstall self-healing
- */
-export {};

package/dist/cli/skill.js

@@ -1,249 +0,0 @@
-#!/usr/bin/env node
-/**
- * Recapt Skills CLI
- *
- * Installs recapt workflow skills to .agents/recapt/ and manages AGENTS.md references.
- * Works across all AI IDEs that support the AGENTS.md standard.
- *
- * Usage:
- *   npx @recapt/mcp skill list
- *   npx @recapt/mcp skill install self-healing
- *   npx @recapt/mcp skill install --all
- *   npx @recapt/mcp skill uninstall self-healing
- */
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const SKILLS_DIR = path.resolve(__dirname, "../../skills");
-const AGENTS_DIR = ".agents/recapt";
-const AGENTS_MD = "AGENTS.md";
-const MARKER_START = "<!-- recapt:skills -->";
-const MARKER_END = "<!-- /recapt:skills -->";
-function getAvailableSkills() {
-    if (!fs.existsSync(SKILLS_DIR)) {
-        console.error(`Skills directory not found: ${SKILLS_DIR}`);
-        process.exit(1);
-    }
-    const files = fs.readdirSync(SKILLS_DIR).filter((f) => f.endsWith(".md"));
-    return files.map((file) => {
-        const content = fs.readFileSync(path.join(SKILLS_DIR, file), "utf-8");
-        const firstLine = content.split("\n")[0];
-        const description = firstLine.startsWith("# ")
-            ? firstLine.slice(2).trim()
-            : file.replace(".md", "");
-        return {
-            name: file.replace(".md", ""),
-            file,
-            description,
-        };
-    });
-}
-function getInstalledSkills(cwd) {
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    if (!fs.existsSync(agentsDir)) {
-        return [];
-    }
-    return fs
-        .readdirSync(agentsDir)
-        .filter((f) => f.endsWith(".md"))
-        .map((f) => f.replace(".md", ""));
-}
-function ensureAgentsDir(cwd) {
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    if (!fs.existsSync(agentsDir)) {
-        fs.mkdirSync(agentsDir, { recursive: true });
-        console.log(`Created ${AGENTS_DIR}/`);
-    }
-}
-function readAgentsMd(cwd) {
-    const agentsMdPath = path.join(cwd, AGENTS_MD);
-    if (!fs.existsSync(agentsMdPath)) {
-        return "";
-    }
-    return fs.readFileSync(agentsMdPath, "utf-8");
-}
-function writeAgentsMd(cwd, content) {
-    const agentsMdPath = path.join(cwd, AGENTS_MD);
-    fs.writeFileSync(agentsMdPath, content);
-}
-function getSkillDisplayName(skillName) {
-    const skills = getAvailableSkills();
-    const skill = skills.find((s) => s.name === skillName);
-    return skill?.description ?? skillName;
-}
-function updateAgentsMdReferences(cwd) {
-    const installed = getInstalledSkills(cwd);
-    let content = readAgentsMd(cwd);
-    if (installed.length === 0) {
-        if (content.includes(MARKER_START)) {
-            const regex = new RegExp(`\\n?${MARKER_START}[\\s\\S]*?${MARKER_END}\\n?`, "g");
-            content = content.replace(regex, "").trim();
-            if (content) {
-                writeAgentsMd(cwd, content + "\n");
-            }
-            else {
-                const agentsMdPath = path.join(cwd, AGENTS_MD);
-                if (fs.existsSync(agentsMdPath)) {
-                    fs.unlinkSync(agentsMdPath);
-                    console.log(`Removed empty ${AGENTS_MD}`);
-                }
-            }
-        }
-        return;
-    }
-    const skillLinks = installed
-        .map((name) => `- [${getSkillDisplayName(name)}](${AGENTS_DIR}/${name}.md)`)
-        .join("\n");
-    const newBlock = `${MARKER_START}
-For recapt behavioral intelligence workflows, see:
-${skillLinks}
-${MARKER_END}`;
-    if (content.includes(MARKER_START)) {
-        const regex = new RegExp(`${MARKER_START}[\\s\\S]*?${MARKER_END}`, "g");
-        content = content.replace(regex, newBlock);
-    }
-    else {
-        if (content.trim()) {
-            content = content.trim() + "\n\n" + newBlock;
-        }
-        else {
-            content = `# Project Agent Instructions\n\n${newBlock}`;
-        }
-    }
-    writeAgentsMd(cwd, content + "\n");
-}
-function installSkill(cwd, skillName) {
-    const skills = getAvailableSkills();
-    const skill = skills.find((s) => s.name === skillName);
-    if (!skill) {
-        console.error(`Unknown skill: ${skillName}`);
-        console.error(`Available skills: ${skills.map((s) => s.name).join(", ")}`);
-        return false;
-    }
-    ensureAgentsDir(cwd);
-    const sourcePath = path.join(SKILLS_DIR, skill.file);
-    const destPath = path.join(cwd, AGENTS_DIR, skill.file);
-    if (fs.existsSync(destPath)) {
-        console.log(`Skill already installed: ${skillName}`);
-        return true;
-    }
-    fs.copyFileSync(sourcePath, destPath);
-    console.log(`Installed: ${skillName} → ${AGENTS_DIR}/${skill.file}`);
-    updateAgentsMdReferences(cwd);
-    return true;
-}
-function uninstallSkill(cwd, skillName) {
-    const skillPath = path.join(cwd, AGENTS_DIR, `${skillName}.md`);
-    if (!fs.existsSync(skillPath)) {
-        console.error(`Skill not installed: ${skillName}`);
-        return false;
-    }
-    fs.unlinkSync(skillPath);
-    console.log(`Uninstalled: ${skillName}`);
-    updateAgentsMdReferences(cwd);
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    const remaining = fs.readdirSync(agentsDir);
-    if (remaining.length === 0) {
-        fs.rmdirSync(agentsDir);
-        const parentDir = path.dirname(agentsDir);
-        if (fs.existsSync(parentDir) &&
-            fs.readdirSync(parentDir).length === 0) {
-            fs.rmdirSync(parentDir);
-        }
-        console.log(`Removed empty ${AGENTS_DIR}/`);
-    }
-    return true;
-}
-function listSkills(cwd) {
-    const available = getAvailableSkills();
-    const installed = new Set(getInstalledSkills(cwd));
-    console.log("\nAvailable recapt skills:\n");
-    for (const skill of available) {
-        const status = installed.has(skill.name) ? "[installed]" : "";
-        console.log(`  ${skill.name.padEnd(20)} ${skill.description} ${status}`);
-    }
-    console.log("\nUsage:");
-    console.log("  npx @recapt/mcp skill install <name>");
-    console.log("  npx @recapt/mcp skill install --all");
-    console.log("  npx @recapt/mcp skill uninstall <name>\n");
-}
-function printHelp() {
-    console.log(`
-Recapt Skills CLI
-
-Installs workflow skills to .agents/recapt/ for use with any AI IDE.
-
-Commands:
-  list                    Show available skills
-  install <name>          Install a skill
-  install --all           Install all skills
-  uninstall <name>        Remove a skill
-
-Examples:
-  npx @recapt/mcp skill list
-  npx @recapt/mcp skill install self-healing
-  npx @recapt/mcp skill install --all
-  npx @recapt/mcp skill uninstall deep-dive
-`);
-}
-function main() {
-    const args = process.argv.slice(2);
-    const cwd = process.cwd();
-    if (args[0] === "skill") {
-        args.shift();
-    }
-    const command = args[0];
-    switch (command) {
-        case "list":
-            listSkills(cwd);
-            break;
-        case "install": {
-            const target = args[1];
-            if (!target) {
-                console.error("Usage: npx @recapt/mcp skill install <name|--all>");
-                process.exit(1);
-            }
-            if (target === "--all") {
-                const skills = getAvailableSkills();
-                let success = true;
-                for (const skill of skills) {
-                    if (!installSkill(cwd, skill.name)) {
-                        success = false;
-                    }
-                }
-                if (success) {
-                    console.log(`\nAll skills installed. See ${AGENTS_MD} for references.`);
-                }
-            }
-            else {
-                if (installSkill(cwd, target)) {
-                    console.log(`\nSkill reference added to ${AGENTS_MD}`);
-                }
-            }
-            break;
-        }
-        case "uninstall": {
-            const target = args[1];
-            if (!target) {
-                console.error("Usage: npx @recapt/mcp skill uninstall <name>");
-                process.exit(1);
-            }
-            uninstallSkill(cwd, target);
-            break;
-        }
-        case "help":
-        case "--help":
-        case "-h":
-            printHelp();
-            break;
-        default:
-            if (command) {
-                console.error(`Unknown command: ${command}`);
-            }
-            printHelp();
-            process.exit(command ? 1 : 0);
-    }
-}
-main();

package/dist/utils/orgContext.d.ts

@@ -1,6 +0,0 @@
-/**
- * Organization context for the MCP server.
- * Reads RECAPT_ORG_ID from environment and validates it.
- */
-export declare function getOrgId(): string;
-export declare function hasOrgId(): boolean;

package/dist/utils/orgContext.js

@@ -1,22 +0,0 @@
-/**
- * Organization context for the MCP server.
- * Reads RECAPT_ORG_ID from environment and validates it.
- */
-let cachedOrgId = null;
-export function getOrgId() {
-    if (cachedOrgId)
-        return cachedOrgId;
-    const orgId = process.env.RECAPT_ORG_ID;
-    if (!orgId) {
-        throw new Error('RECAPT_ORG_ID environment variable is required. ' +
-            'Set it to the MongoDB ObjectId of the organization to query.');
-    }
-    if (!/^[a-f0-9]{24}$/i.test(orgId)) {
-        throw new Error(`RECAPT_ORG_ID must be a valid 24-character MongoDB ObjectId. Got: ${orgId}`);
-    }
-    cachedOrgId = orgId;
-    return orgId;
-}
-export function hasOrgId() {
-    return !!process.env.RECAPT_ORG_ID;
-}