@descryy/mcp 0.11.5 → 0.11.7

package/dist/tools/browser.js

@@ -0,0 +1,326 @@
+/**
+ * `browser` — the merged action-class browser tool. §4/§7 step 5 of
+ * `documents/plans/mcp-surface-consolidation.md`.
+ *
+ * Absorbs the eight consent-gated browser verbs — `start_session` `click`
+ * `type` `fill` `select` `submit` `save_scenario` `run_scenario` — behind one
+ * `verb` argument. The four stateful-read tools (`snapshot`, `navigate`,
+ * `wait_for`, `close_session`) are a different class and are not touched
+ * here.
+ *
+ * ## This is the surface merge only
+ *
+ * §4 names the real design problem: an element ref is issued per snapshot and
+ * a stale one refuses rather than resolving elsewhere, so a caller cannot
+ * author a multi-step batch up front — step 2's ref does not exist until step
+ * 1 has run. The eventual fix is a server-side step loop that takes its own
+ * snapshot between steps and resolves targets by role + accessible name, so a
+ * ref never leaves the server and an ambiguous target refuses rather than
+ * guessing. That is a design change, not a merge, and it is **not** done
+ * here. This tool still takes one ref, for one step, per call — exactly
+ * today's semantics, including the refusal on a superseded ref — and only
+ * changes how the eight verbs are named and dispatched.
+ *
+ * ## Reuse, not reimplementation
+ *
+ * Every verb's `run` and `describeAction` is the same function object the
+ * standalone tool exported before this file existed — `VERB_TOOLS` below is
+ * a dispatch table over those objects, never a rewrite of what they do. The
+ * one thing genuinely new is `selectVerb`: with eight verbs' properties
+ * unioned into one schema, `additionalProperties: false` can no longer catch
+ * `browser({ verb: "click", text: "hi" })` silently ignoring `text` — that is
+ * exactly the defect `browser_start_session({ profile })` silently reading
+ * `environment` was (UAT phase 5 F12), one level further down. `selectVerb`
+ * re-establishes per-verb argument discrimination at runtime; see
+ * `verb.ts`'s own header for the full reasoning.
+ *
+ * ## Consent
+ *
+ * Only `start_session` mints anything — it is the one call that opens a
+ * browser and grants consent for the rest of the session's life
+ * (`browser-start-session.ts`, DEC-380). The other seven verbs already
+ * declare `describeAction: () => undefined` (nothing left to confirm; a verb
+ * cannot mint its own consent), and that is preserved by delegating to each
+ * verb's own `describeAction` rather than writing a new one — the one
+ * consent sentence this tool produces is `browser_start_session`'s own,
+ * unchanged, so it cannot drift from what `start_session` alone still
+ * enforces.
+ */
+import { browserClickTool } from "./browser-click.js";
+import { browserTypeTool } from "./browser-type.js";
+import { browserFillTool } from "./browser-fill.js";
+import { browserSelectTool } from "./browser-select.js";
+import { browserSubmitTool } from "./browser-submit.js";
+import { browserStartSessionTool } from "./browser-start-session.js";
+import { browserSaveScenarioTool } from "./browser-save-scenario.js";
+import { browserRunScenarioTool } from "./browser-run-scenario.js";
+import { selectVerb } from "./verb.js";
+const VERB_TOOLS = {
+    start_session: browserStartSessionTool,
+    click: browserClickTool,
+    type: browserTypeTool,
+    fill: browserFillTool,
+    select: browserSelectTool,
+    submit: browserSubmitTool,
+    save_scenario: browserSaveScenarioTool,
+    run_scenario: browserRunScenarioTool,
+};
+/** Every verb's own exclusive properties, beyond `verb` and the shared ones below — the table
+ *  `selectVerb` needs to say "that belongs to a different verb" instead of just "unknown". Kept
+ *  as data, next to `VERB_TOOLS`, so the two cannot silently drift apart: a verb added to one
+ *  and not the other fails loudly (`browser-verb-dispatch.test.ts` asserts the two agree). */
+const SPECS = [
+    {
+        verb: "start_session",
+        accepts: [
+            "targetUrl",
+            "headless",
+            "stackParser",
+            "documentRoot",
+            "environment",
+            "storageState",
+            "storageStatePath",
+            "storageStateCredential",
+            "extraHttpHeaders",
+            "saveStorageStateTo",
+        ],
+    },
+    { verb: "click", accepts: ["sessionId", "ref"] },
+    { verb: "type", accepts: ["sessionId", "ref", "text"] },
+    { verb: "fill", accepts: ["sessionId", "ref", "text"] },
+    { verb: "select", accepts: ["sessionId", "ref", "value"] },
+    { verb: "submit", accepts: ["sessionId", "ref"] },
+    { verb: "save_scenario", accepts: ["sessionId", "name", "description", "targetUrl", "steps", "assertions"] },
+    { verb: "run_scenario", accepts: ["sessionId", "name"] },
+];
+/** Accepted by every verb, `start_session` included — the handshake reads it for any
+ *  action-class tool whether or not that verb ever mints. */
+const SHARED = ["confirmToken"];
+function resolveVerb(args) {
+    return selectVerb(args, "verb", SPECS, SHARED);
+}
+async function run(args, ctx) {
+    const verb = resolveVerb(args);
+    // `ToolDefinition` erases its answer's type parameter — it has to, the
+    // registry is one array of many shapes — so the delegated call comes back as
+    // an erased answer type. The verb table is what makes the union true: every
+    // entry's own `run` is declared against one of BrowserData's members, and a verb
+    // added without its shape stops compiling at the union. The assertion
+    // re-applies what the table already guarantees rather than asserting
+    // something unchecked.
+    return (await VERB_TOOLS[verb].run(args, ctx));
+}
+/** Delegates to the resolved verb's own `describeAction` — never writes a new consent sentence.
+ *  Only `start_session`'s returns a string; every other verb's is `() => undefined` today, and
+ *  reading that through the same dispatch table means this tool cannot describe the wrong verb
+ *  without the underlying tool describing it wrong too, which is exactly the bar §7's "one
+ *  describeAction, tested against all eight verbs" sets. */
+async function describeAction(args, ctx) {
+    const verb = resolveVerb(args);
+    return VERB_TOOLS[verb].describeAction?.(args, ctx);
+}
+/** Only `start_session`'s arguments can carry a credential (`storageState`, `extraHttpHeaders`).
+ *  Dispatched on the raw `verb` value rather than through `selectVerb`/`resolveVerb`: this runs
+ *  over whatever was actually recorded, including a call that never validated — a malformed or
+ *  unconfirmed call is exactly the one a redactor must not throw on. */
+function redactArgs(args) {
+    const verb = args["verb"];
+    const tool = typeof verb === "string" ? VERB_TOOLS[verb] : undefined;
+    return tool?.redactArgs?.(args) ?? args;
+}
+const REF_NOTE = "Ref from a browser_read snapshot; stale refs are refused, not re-resolved.";
+const TARGET_SCHEMA = {
+    type: "object",
+    description: "Element by role+name+selector, from a snapshot. All three must match at replay.",
+    properties: {
+        role: { type: "string" },
+        name: { type: "string" },
+        selector: { type: ["string", "null"] },
+    },
+    required: ["role", "name", "selector"],
+    additionalProperties: false,
+};
+const SCHEMA = {
+    type: "object",
+    properties: {
+        verb: {
+            type: "string",
+            enum: ["start_session", "click", "type", "fill", "select", "submit", "save_scenario", "run_scenario"],
+            description: "REQUIRED. Which action to run. Only that verb's own arguments are accepted.",
+        },
+        // --- start_session only ---
+        targetUrl: {
+            type: "string",
+            description: "start_session (REQUIRED): URL to open, consent scope. save_scenario: replay start URL.",
+        },
+        headless: {
+            type: "boolean",
+            description: "Run without a visible window. Default true.",
+        },
+        stackParser: {
+            type: "object",
+            description: "start_session: module parsing stack traces, for a caller edge. Package " +
+                '"@descryy/runtime-adapter-<language>", factory "create<Name>StackTraceParser".',
+            properties: {
+                module: { type: "string", description: "Module specifier." },
+                export: { type: "string", description: "Defaults to the sole factory." },
+            },
+            required: ["module"],
+            additionalProperties: false,
+        },
+        documentRoot: {
+            type: "string",
+            description: "start_session: static file root if not repo root. Default: repo root.",
+        },
+        environment: {
+            type: "object",
+            description: "start_session: environment profile. readOnly blocks mutating verbs (navigate/snapshot ok).",
+            properties: {
+                name: { type: "string", description: "Profile name." },
+                safetyLevel: {
+                    type: "string",
+                    enum: ["readOnly", "write", "destructiveWithApproval"],
+                    description: "readOnly blocks every mutating verb.",
+                },
+            },
+            required: ["name", "safetyLevel"],
+            additionalProperties: true,
+        },
+        storageState: {
+            type: "object",
+            description: "start_session: pre-authenticated state to seed before first navigation.",
+            properties: {
+                cookies: {
+                    type: "array",
+                    description: "Cookies to set before navigating.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            value: { type: "string" },
+                            path: { type: "string", description: 'Default "/".' },
+                            httpOnly: { type: "boolean" },
+                            secure: { type: "boolean" },
+                            sameSite: { type: "string", enum: ["Strict", "Lax", "None"] },
+                        },
+                        required: ["name", "value"],
+                        additionalProperties: false,
+                    },
+                },
+                localStorage: {
+                    type: "object",
+                    description: "localStorage entries (string values).",
+                    additionalProperties: { type: "string" },
+                },
+            },
+            additionalProperties: false,
+        },
+        storageStatePath: {
+            type: "string",
+            description: "start_session: FILE with saved storage state, instead of inline cookies.",
+        },
+        storageStateCredential: {
+            type: "string",
+            description: "start_session: NAME of a stored credential with saved state. Exclusive with storageState/Path.",
+        },
+        extraHttpHeaders: {
+            type: "object",
+            description: "start_session: headers added to requests to the consented origin only.",
+            additionalProperties: { type: "string" },
+        },
+        saveStorageStateTo: {
+            type: "string",
+            description: "start_session: path OUTSIDE the repo to save session state on close (a credential).",
+        },
+        // --- click / type / fill / select / submit / save_scenario / run_scenario ---
+        sessionId: {
+            type: "string",
+            description: "REQUIRED except start_session. From a prior start_session call.",
+        },
+        ref: {
+            type: "string",
+            description: `REQUIRED for click, type, fill, select, submit. ${REF_NOTE}`,
+        },
+        text: {
+            type: "string",
+            description: "REQUIRED for type/fill. type: keystrokes, appends. fill: sets value, replaces, no key events.",
+        },
+        value: {
+            type: "string",
+            description: "REQUIRED for select. Exact value or label; refused with the offered options if unmatched.",
+        },
+        // --- save_scenario / run_scenario ---
+        name: {
+            type: "string",
+            description: "REQUIRED. Name to save as (save_scenario) or replay (run_scenario).",
+        },
+        // --- save_scenario only ---
+        description: { type: "string", description: "Free text note for the file. Optional." },
+        steps: {
+            type: "array",
+            description: "REQUIRED, at least one. Steps to replay; each re-resolved at replay time.",
+            items: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        enum: ["navigate", "click", "type", "fill"],
+                        description: "navigate acts on the page; click/type/fill need a target.",
+                    },
+                    target: TARGET_SCHEMA,
+                    url: { type: "string", description: "Where to go. navigate only." },
+                    text: {
+                        type: "string",
+                        description: "What to enter. type/fill only.",
+                    },
+                },
+                required: ["action"],
+                additionalProperties: false,
+            },
+        },
+        assertions: {
+            type: "array",
+            description: "REQUIRED, may be empty. Empty replays as unverified, never passed.",
+            items: {
+                type: "object",
+                properties: {
+                    kind: {
+                        type: "string",
+                        enum: ["elementVisible", "textEquals", "urlEquals", "noConsoleErrors", "noFailedRequests"],
+                        description: "Which check; textEquals/urlEquals compare against \"expected\".",
+                    },
+                    afterStep: {
+                        type: "integer",
+                        description: "Step index this runs after. Omit for end-of-scenario.",
+                    },
+                    target: TARGET_SCHEMA,
+                    expected: { type: "string", description: "Value to compare against." },
+                },
+                required: ["kind"],
+                additionalProperties: false,
+            },
+        },
+        confirmToken: {
+            type: "string",
+            description: "Only start_session confirms. Arguments frozen when the token was minted; a changed one " +
+                "is discarded and disclosed.",
+        },
+    },
+    required: ["verb"],
+    additionalProperties: false,
+};
+export const browserTool = {
+    name: "browser",
+    title: "Drive a real browser",
+    description: "Drive a real browser, one verb per call. start_session opens it (needs confirmation); " +
+        "click/type/fill/select/submit act on an element ref; save_scenario/run_scenario save and " +
+        "replay a session. Returns page output (console, network), untriaged. Acts on the running app.",
+    class: "action",
+    tier: "evidence",
+    version: "1.0.0",
+    inputSchema: SCHEMA,
+    run,
+    describeAction,
+    redactArgs,
+};
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAiB,MAAM,WAAW,CAAC;AAwCtD,MAAM,UAAU,GAAkD;IAChE,aAAa,EAAE,uBAAuB;IACtC,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,aAAa,EAAE,uBAAuB;IACtC,YAAY,EAAE,sBAAsB;CACrC,CAAC;AAEF;;;8FAG8F;AAC9F,MAAM,KAAK,GAAqC;IAC9C;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;YACP,WAAW;YACX,UAAU;YACV,aAAa;YACb,cAAc;YACd,aAAa;YACb,cAAc;YACd,kBAAkB;YAClB,wBAAwB;YACxB,kBAAkB;YAClB,oBAAoB;SACrB;KACF;IACD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;IAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;IACvD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;IACvD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;IAC1D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;IACjD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;IAC5G,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;CACzD,CAAC;AAEF;6DAC6D;AAC7D,MAAM,MAAM,GAAG,CAAC,cAAc,CAAU,CAAC;AAEzC,SAAS,WAAW,CAAC,IAA6B;IAChD,OAAO,UAAU,CAAc,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,IAA6B,EAAE,GAAgB;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,uEAAuE;IACvE,6EAA6E;IAC7E,4EAA4E;IAC5E,iFAAiF;IACjF,sEAAsE;IACtE,qEAAqE;IACrE,uBAAuB;IACvB,OAAO,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAA4B,CAAC;AAC5E,CAAC;AAED;;;;4DAI4D;AAC5D,KAAK,UAAU,cAAc,CAAC,IAA6B,EAAE,GAAgB;IAC3E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;wEAGwE;AACxE,SAAS,UAAU,CAAC,IAA6B;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,OAAO,IAAI,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,QAAQ,GAAG,4EAA4E,CAAC;AAE9F,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iFAAiF;IAC9F,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;KACvC;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;IACtC,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,CAAC;YACrG,WAAW,EAAE,6EAA6E;SAC3F;QAED,6BAA6B;QAC7B,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wFAAwF;SACtG;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6CAA6C;SAC3D;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yEAAyE;gBACzE,gFAAgF;YAClF,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gBAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uEAAuE;SACrF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4FAA4F;YACzG,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;gBACtD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAC;oBACtD,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;YACjC,oBAAoB,EAAE,IAAI;SAC3B;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yEAAyE;YACtF,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,mCAAmC;oBAChD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;4BACrD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;4BAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;4BAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;yBAC9D;wBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;wBAC3B,oBAAoB,EAAE,KAAK;qBAC5B;iBACF;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;oBACpD,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0EAA0E;SACxF;QACD,sBAAsB,EAAE;YACtB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gGAAgG;SAC9G;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wEAAwE;YACrF,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzC;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qFAAqF;SACnG;QAED,+EAA+E;QAC/E,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;SAC/E;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD,QAAQ,EAAE;SAC3E;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+FAA+F;SAC7G;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2FAA2F;SACzG;QAED,uCAAuC;QACvC,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qEAAqE;SACnF;QAED,6BAA6B;QAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;QACtF,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,2EAA2E;YACxF,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;wBAC3C,WAAW,EAAE,2DAA2D;qBACzE;oBACD,MAAM,EAAE,aAAa;oBACrB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;oBACnE,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gCAAgC;qBAC9C;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,oEAAoE;YACjF,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;wBAC1F,WAAW,EAAE,iEAAiE;qBAC/E;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,uDAAuD;qBACrE;oBACD,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;iBACvE;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;gBAClB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QAED,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yFAAyF;gBACzF,6BAA6B;SAChC;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,wFAAwF;QACxF,2FAA2F;QAC3F,+FAA+F;IACjG,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,MAAM;IACnB,GAAG;IACH,cAAc;IACd,UAAU;CACX,CAAC"}

package/dist/tools/chain.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `chain` — RG-9's five-hop user chain (click → request → endpoint → route →
+ * handler → line) as one MCP call. `impact`/`propagation` each answer one
+ * hop's worth of question; nothing before this walked all five in one call
+ * with a computed completeness verdict, so "chain complete" was a mockup
+ * string rather than a field.
+ *
+ * Two disclosed degradations carried through from `traceUserChain`
+ * (`@descryy/core`): the browser→endpoint hop only exists when the browser
+ * session that produced it was started with a `stackParser`
+ * (`browser_start_session`); and the route→handler hop ships for
+ * express/koa-router/fastify/hono/the Next.js App Router today, TypeScript
+ * only. Neither is a language check here — this tool walks whatever edges
+ * the graph holds and reports what it finds.
+ */
+import { type ChainStageName } from "@descryy/core";
+import { type BriefNode, type NodeCandidates, type ToolDefinition } from "./kit.ts";
+/** One named point in the chain, as reported to a caller. */
+export interface ChainStageReport {
+    readonly name: ChainStageName;
+    readonly present: boolean;
+    /** Omitted, not null, wherever the stage carries no node of its own
+     *  ("request" — no node type for an HTTP request; "line" — a location on
+     *  the handler, not a separate node) or is missing. */
+    readonly node?: BriefNode;
+    /** Set iff `!present`. */
+    readonly reason?: string;
+}
+export interface ChainReport {
+    readonly origin: BriefNode;
+    readonly stages: readonly ChainStageReport[];
+    readonly verdict: "complete" | "partial";
+    readonly missingStage: ChainStageName | null;
+    readonly location: {
+        readonly file: string;
+        readonly startLine: number;
+    } | null;
+}
+export type ChainData = ChainReport | NodeCandidates;
+export declare const chainTool: ToolDefinition;
+//# sourceMappingURL=chain.d.ts.map

package/dist/tools/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/tools/chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAIlB,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;2DAEuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjF;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAiFrD,eAAO,MAAM,SAAS,EAAE,cAYvB,CAAC"}

package/dist/tools/chain.js

@@ -0,0 +1,101 @@
+/**
+ * `chain` — RG-9's five-hop user chain (click → request → endpoint → route →
+ * handler → line) as one MCP call. `impact`/`propagation` each answer one
+ * hop's worth of question; nothing before this walked all five in one call
+ * with a computed completeness verdict, so "chain complete" was a mockup
+ * string rather than a field.
+ *
+ * Two disclosed degradations carried through from `traceUserChain`
+ * (`@descryy/core`): the browser→endpoint hop only exists when the browser
+ * session that produced it was started with a `stackParser`
+ * (`browser_start_session`); and the route→handler hop ships for
+ * express/koa-router/fastify/hono/the Next.js App Router today, TypeScript
+ * only. Neither is a language check here — this tool walks whatever edges
+ * the graph holds and reports what it finds.
+ */
+import { traceUserChain } from "@descryy/core";
+import { briefNode, optionalString, ToolInputError, } from "./kit.js";
+import { resolveOneNode } from "./lookup.js";
+function reportStage(stage) {
+    return {
+        name: stage.name,
+        present: stage.present,
+        ...(stage.node === null ? {} : { node: briefNode(stage.node) }),
+        ...(stage.reason === null ? {} : { reason: stage.reason }),
+    };
+}
+const SCHEMA = {
+    type: "object",
+    properties: {
+        nodeId: { type: "string", description: "Start node — the click's origin." },
+        symbol: {
+            type: "string",
+            description: "Start symbol if no node id. Ambiguous matches are refused, not guessed.",
+        },
+        file: {
+            type: "string",
+            description: "Path, to disambiguate \"symbol\" or start from a file.",
+        },
+    },
+    additionalProperties: false,
+};
+async function run(args, ctx) {
+    const nodeId = optionalString(args, "nodeId");
+    const symbol = optionalString(args, "symbol");
+    const file = optionalString(args, "file");
+    if (nodeId === undefined && symbol === undefined && file === undefined) {
+        throw new ToolInputError('give one of "nodeId", "symbol" or "file"');
+    }
+    const provider = ctx.session.provider();
+    const found = resolveOneNode(ctx.session, { nodeId, symbol, file });
+    if (found.node === null) {
+        const base = provider.baseStamp();
+        return {
+            result: {
+                data: { candidates: found.candidates.map(briefNode) },
+                stamp: { ...base, resolutionFloor: 0 },
+                truncated: false,
+                notes: found.notes,
+            },
+            nameLevel: true,
+            state: "refused",
+            headline: found.headline,
+        };
+    }
+    ctx.progress(`Walking the chain from ${found.node.name}`);
+    const chain = traceUserChain(provider, found.node.id);
+    const notes = [...found.notes, ...chain.notes];
+    return {
+        result: {
+            data: {
+                origin: briefNode(chain.data.origin),
+                stages: chain.data.stages.map(reportStage),
+                verdict: chain.data.verdict,
+                missingStage: chain.data.missingStage,
+                location: chain.data.location,
+            },
+            stamp: chain.stamp,
+            truncated: chain.truncated,
+            notes,
+        },
+        nameLevel: true,
+        ...(chain.data.verdict === "partial" ? { state: "refused" } : {}),
+        headline: chain.data.verdict === "complete"
+            ? `Chain complete: ${found.node.name} reaches ${chain.data.location?.file ?? "its handler"}` +
+                `${chain.data.location === null ? "" : `:${chain.data.location.startLine}`}.`
+            : `Chain incomplete at "${chain.data.missingStage}" — see stages for what is missing and why.`,
+    };
+}
+export const chainTool = {
+    name: "chain",
+    class: "read",
+    tier: "evidence",
+    version: "1.0.0",
+    title: "The click-to-line chain: click, request, endpoint, route, handler, line",
+    description: "Walks click → request → endpoint → route → handler → line in one traversal, and reports " +
+        "complete or partial (naming which hop is missing and why). Needs a stackParser for the " +
+        "browser→endpoint hop and adapter support for route→handler; missing either just shows as a gap.",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=chain.js.map

package/dist/tools/chain.js.map

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

package/dist/tools/change-scope.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `change_scope` — merges `scope` and `pre_push` behind one `verb`
+ * (documents/plans/mcp-surface-consolidation.md §2, group 2). Both are
+ * `read`/`evidence`, so the merge crosses neither boundary.
+ *
+ * Dispatch only. Each verb's own `run()` body is untouched and stays in its
+ * own module (`scope.ts` / `pre-push.ts`) — `pre-push.ts` itself already
+ * composes `scope`, `pr_analysis`, `contracts` and `validate` internally, and
+ * that composition is unaffected by this merge: it still calls `scopeTool.run`
+ * directly, not through this dispatcher.
+ */
+import type { ToolDefinition } from "./kit.ts";
+import type { ScopeData } from "./scope.ts";
+import type { PrePushData } from "./pre-push.ts";
+/**
+ * What this tool answers with: one verb's shape, never a merged one.
+ *
+ * The merge cost this its single concrete output type, and `unknown` would have
+ * silently retired `output-shapes.test.ts`'s check that a declared shape is tied
+ * to the code producing it. A union keeps that tie: a verb added without its
+ * shape here stops compiling.
+ */
+export type ChangeScopeData = ScopeData | PrePushData;
+export declare const changeScopeTool: ToolDefinition;
+//# sourceMappingURL=change-scope.d.ts.map

package/dist/tools/change-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-scope.d.ts","sourceRoot":"","sources":["../../src/tools/change-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,WAAW,CAAC;AAsFhB,eAAO,MAAM,eAAe,EAAE,cAW7B,CAAC"}

package/dist/tools/change-scope.js

@@ -0,0 +1,103 @@
+/**
+ * `change_scope` — merges `scope` and `pre_push` behind one `verb`
+ * (documents/plans/mcp-surface-consolidation.md §2, group 2). Both are
+ * `read`/`evidence`, so the merge crosses neither boundary.
+ *
+ * Dispatch only. Each verb's own `run()` body is untouched and stays in its
+ * own module (`scope.ts` / `pre-push.ts`) — `pre-push.ts` itself already
+ * composes `scope`, `pr_analysis`, `contracts` and `validate` internally, and
+ * that composition is unaffected by this merge: it still calls `scopeTool.run`
+ * directly, not through this dispatcher.
+ */
+import { selectVerb } from "./verb.js";
+import { scopeTool } from "./scope.js";
+import { prePushTool } from "./pre-push.js";
+const VERBS = ["diff", "pre_push"];
+const TRIGGERS = ["pre-push", "pr", "nightly"];
+const WORKING_TREE_SCOPES = ["unstaged", "staged", "all"];
+const VERB_SPECS = [
+    { verb: "diff", accepts: ["files", "nodeIds", "trigger", "budget", "limit"] },
+    { verb: "pre_push", accepts: ["files", "base", "workingTree", "includeUntracked", "perSource"] },
+];
+const SCHEMA = {
+    type: "object",
+    properties: {
+        verb: {
+            type: "string",
+            enum: [...VERBS],
+            description: "diff: blast radius, ranked. pre_push: diff+pr_analysis+contracts+validate, one envelope.",
+        },
+        files: {
+            type: "array",
+            items: { type: "string" },
+            description: "diff: seeds the blast radius. pre_push: REQUIRED, the files about to be pushed.",
+        },
+        nodeIds: {
+            type: "array",
+            items: { type: "string" },
+            description: "diff only. Node ids to seed with, instead of or with files.",
+        },
+        trigger: {
+            type: "string",
+            enum: [...TRIGGERS],
+            description: "diff only. Node budget: pre-push 200, pr 1000, nightly 5000. Default pr.",
+        },
+        budget: {
+            type: "integer",
+            minimum: 1,
+            description: "diff only. Override the trigger's node budget.",
+        },
+        limit: {
+            type: "integer",
+            minimum: 1,
+            description: "diff only. Cap on affected nodes returned. Default 25.",
+        },
+        base: {
+            type: "string",
+            description: "pre_push only. Ref to diff against. Exclusive with workingTree.",
+        },
+        workingTree: {
+            type: "string",
+            enum: [...WORKING_TREE_SCOPES],
+            description: "pre_push only. Working tree instead of a ref range. Exclusive with base.",
+        },
+        includeUntracked: {
+            type: "boolean",
+            description: "pre_push only, with workingTree: include never-seen files. Default true.",
+        },
+        perSource: {
+            type: "integer",
+            minimum: 1,
+            description: "pre_push only. Items per source. Default 3.",
+        },
+    },
+    required: ["verb"],
+    additionalProperties: false,
+};
+const DISPATCH = {
+    diff: scopeTool,
+    pre_push: prePushTool,
+};
+async function run(args, ctx) {
+    const verb = selectVerb(args, "verb", VERB_SPECS);
+    // `ToolDefinition` erases its answer's type parameter — it has to, the
+    // registry is one array of many shapes — so the delegated call comes back as
+    // an erased answer type. The verb table is what makes the union true: every
+    // entry's own `run` is declared against one of ChangeScopeData's members, and a verb
+    // added without its shape stops compiling at the union. The assertion
+    // re-applies what the table already guarantees rather than asserting
+    // something unchecked.
+    return (await DISPATCH[verb].run(args, ctx));
+}
+export const changeScopeTool = {
+    name: "change_scope",
+    class: "read",
+    tier: "evidence",
+    version: "1.0.0",
+    title: "Blast radius of a change, or everything worth knowing before a push",
+    description: "diff: blast radius of given files/symbols, ranked and tiered. pre_push: diff + " +
+        "pr_analysis + contracts + validate together, one envelope.",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=change-scope.js.map

package/dist/tools/change-scope.js.map

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