@descryy/mcp 0.11.8 → 0.12.1

package/dist/browser/graph-write.js

@@ -3,9 +3,35 @@
  * R1 string-match `impact`/`propagation` already do. Precision over recall:
  * anything unresolvable (no stack, no endpoint, ambiguous) drops the observation entirely rather than writing a weak edge. Never mints a denial.
  */
+import { applyObservedInteractions } from "@descryy/core";
 import { confirmObservedFrontendCaller, resolveEndpointNode } from "@descryy/runtime-graph-correlator";
 import { isFailedRequest } from "./driver.js";
-export const NO_GRAPH_WRITE = { reached: [], promoted: [], created: [], refused: [], contradictions: [] };
+import { resolveActionIdentityGraphNode } from "./identity-graph-write.js";
+export const NO_GRAPH_WRITE = {
+    reached: [],
+    promoted: [],
+    created: [],
+    refused: [],
+    contradictions: [],
+    interactions: [],
+};
+/** `ObservedAction`'s five element-targeting kinds, mapped to `observed_interactions`'s own
+ *  two-way vocabulary — `chain`'s witnessed-click reader does not need the DOM-level
+ *  distinction between typing, filling, selecting or submitting. `navigate` is excluded: it
+ *  acts on the page, not an element, and carries no identity to resolve. */
+function interactionActionOf(action) {
+    switch (action) {
+        case "click":
+        case "submit":
+            return "click";
+        case "type":
+        case "fill":
+        case "select":
+            return "input";
+        case "navigate":
+            return null;
+    }
+}
 /** Correlates what the page did against the graph, recording only what was genuinely witnessed. Runs over every request, not just failures — a successful call is what proves the arrow. */
 export function writeBrowserObservations(input) {
     const reached = [];
@@ -59,7 +85,34 @@ export function writeBrowserObservations(input) {
         refused.push(...outcome.confirmation.refused.map((r) => r.reason));
         contradictions.push(...outcome.confirmation.contradictions.map((c) => c.detail));
     }
-    return { reached, promoted, created, refused, contradictions };
+    const interactions = [];
+    for (const action of input.actions ?? []) {
+        if (action.identity === null)
+            continue;
+        const kind = interactionActionOf(action.action);
+        if (kind === null)
+            continue;
+        const resolution = resolveActionIdentityGraphNode(input.driver, action.identity, input.repo, { repoRoot: input.repoRoot });
+        if (resolution.outcome !== "resolved") {
+            // `withheld` (no authored file/symbol, e.g. a refused or component-only identity) is
+            // the ordinary case for most clicks and not worth reporting per action — same reasoning
+            // as the endpoint-miss `continue` above. `not-found`/`ambiguous`/`line-mismatch` are a
+            // real graph-join gap and are disclosed.
+            if (resolution.outcome !== "withheld") {
+                refused.push(`${action.action} on ${action.ref ?? "an element"} named component "${action.identity.component ?? "?"}", ` +
+                    `but the graph join ${resolution.outcome}: ${resolution.reason}`);
+            }
+            continue;
+        }
+        interactions.push({ nodeId: resolution.node.nodeId, name: resolution.node.name, type: resolution.node.type, via: { action: kind, ref: action.ref } });
+        const written = applyObservedInteractions(input.driver, {
+            runId: input.runId,
+            commitSha: input.commitSha,
+            observations: [{ nodeId: resolution.node.nodeId, action: kind }],
+        });
+        refused.push(...written.refused.map((r) => r.reason));
+    }
+    return { reached, promoted, created, refused, contradictions, interactions };
 }
 /** What a reply says about a write. Empty when nothing was reached — silence about nothing is not a disclosure gap. */
 export function graphWriteNotes(write, requests) {
@@ -75,6 +128,11 @@ export function graphWriteNotes(write, requests) {
         notes.push(`${write.reached.length} endpoint(s) in the graph were reached by this page, but no caller edge was ` +
             "written — see data.graph.refused for why. The endpoints are named so the gap is visible rather than absent.");
     }
+    if (write.interactions.length > 0) {
+        notes.push(`${write.interactions.length} click/input action(s) resolved to a real graph node (B1 identity ` +
+            `grounding) and were recorded as witnessed — ${write.interactions.map((i) => i.name).join(", ")}. chain's ` +
+            '"click" stage reads this for these exact nodes.');
+    }
     // Always stated, not only when non-empty (F7, UAT Phase 5): `contradictions`
     // covers one narrow thing — an observation disagreeing with an existing R4
     // edge — and an empty array reads as "nothing disagreed" unless the scope is

package/dist/browser/graph-write.js.map

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

package/dist/browser/identity-graph-write.d.ts

@@ -7,11 +7,14 @@
  * `resolveSymbolNode`'s ambiguity refusal, line-mismatch reporting or path translation — it
  * calls it and restates the outcome in this package's own node shape.
  *
- * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS` node an adapter
- * already produced. `descry-core`'s frozen 15/15 vocabulary is untouched.
+ * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS`/`COMPONENT` node an
+ * adapter already produced (`@descryy/runtime-graph-correlator`'s `resolveSymbolNode` accepts
+ * `COMPONENT` alongside `FUNCTION`/`CLASS` as of this session). `descry-core`'s frozen 15/15
+ * vocabulary is untouched.
  */
 import type { SqlDriver } from "@descryy/core";
 import { type ElementIdentity } from "@descryy/runtime-identity-grounding";
+import type { ElementComponentIdentity } from "./driver.ts";
 /** The graph node an identity resolved to — only what a caller needs to name it, never the
  *  full `IRNode` (this package does not depend on `@descryy/ir`'s node shape beyond id/name/type). */
 export interface IdentityGraphNode {
@@ -52,4 +55,25 @@ export declare function resolveIdentityGraphNode(driver: SqlDriver, identity: El
     readonly repoRoot?: string;
     readonly cwd?: string;
 }): IdentityGraphOutcome;
+/**
+ * The same join, for a `click`/`type`/`fill`/`select`/`submit` action's own `ElementComponentIdentity`
+ * (`driver.ts`) rather than the raw `ElementIdentity` a snapshot's grounder call returns.
+ *
+ * A deliberately separate entry point, not a second resolver: the two identity shapes really
+ * are different objects at this point in the pipeline. `ElementIdentity` only ever exists
+ * inside `playwright-driver.ts`, which restates it *structurally* rather than importing
+ * `@descryy/runtime-identity-grounding` (that file's own header explains why — it must stay
+ * buildable with no identity-grounding build present). By the time an action's evidence
+ * reaches this package's tool layer, all it carries is the already-flattened
+ * `ElementComponentIdentity` the port exposes — the same reduction `SnapshotElement.identity`
+ * carries. `symbolLocationForGraph`'s own three checks (grounded, authored, file present) are
+ * restated here against that narrower shape rather than reused, because there is no
+ * `ElementIdentity` value in hand to hand it — `resolveSymbolNode` underneath is the one thing
+ * actually reused, which is where the real graph-join logic (ambiguity, line check, path
+ * translation) lives. See DEC-NEXT-witnessed-click-is-a-node-ledger-not-an-edge.md.
+ */
+export declare function resolveActionIdentityGraphNode(driver: SqlDriver, identity: ElementComponentIdentity, repo: string, options?: {
+    readonly repoRoot?: string;
+    readonly cwd?: string;
+}): IdentityGraphOutcome;
 //# sourceMappingURL=identity-graph-write.d.ts.map

package/dist/browser/identity-graph-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity-graph-write.d.ts","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEnG;sGACsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5D;;;;8EAI8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,oBAAoB,CAsBtB"}
+{"version":3,"file":"identity-graph-write.d.ts","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEnG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D;sGACsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5D;;;;8EAI8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,oBAAoB,CAsBtB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,oBAAoB,CA0BtB"}

package/dist/browser/identity-graph-write.js

@@ -7,8 +7,10 @@
  * `resolveSymbolNode`'s ambiguity refusal, line-mismatch reporting or path translation — it
  * calls it and restates the outcome in this package's own node shape.
  *
- * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS` node an adapter
- * already produced. `descry-core`'s frozen 15/15 vocabulary is untouched.
+ * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS`/`COMPONENT` node an
+ * adapter already produced (`@descryy/runtime-graph-correlator`'s `resolveSymbolNode` accepts
+ * `COMPONENT` alongside `FUNCTION`/`CLASS` as of this session). `descry-core`'s frozen 15/15
+ * vocabulary is untouched.
  */
 import { resolveSymbolNode } from "@descryy/runtime-graph-correlator";
 import { symbolLocationForGraph } from "@descryy/runtime-identity-grounding";
@@ -42,4 +44,44 @@ export function resolveIdentityGraphNode(driver, identity, repo, options = {}) {
 function toGraphNode(node) {
     return { nodeId: node.id, name: node.name, type: node.type };
 }
+/**
+ * The same join, for a `click`/`type`/`fill`/`select`/`submit` action's own `ElementComponentIdentity`
+ * (`driver.ts`) rather than the raw `ElementIdentity` a snapshot's grounder call returns.
+ *
+ * A deliberately separate entry point, not a second resolver: the two identity shapes really
+ * are different objects at this point in the pipeline. `ElementIdentity` only ever exists
+ * inside `playwright-driver.ts`, which restates it *structurally* rather than importing
+ * `@descryy/runtime-identity-grounding` (that file's own header explains why — it must stay
+ * buildable with no identity-grounding build present). By the time an action's evidence
+ * reaches this package's tool layer, all it carries is the already-flattened
+ * `ElementComponentIdentity` the port exposes — the same reduction `SnapshotElement.identity`
+ * carries. `symbolLocationForGraph`'s own three checks (grounded, authored, file present) are
+ * restated here against that narrower shape rather than reused, because there is no
+ * `ElementIdentity` value in hand to hand it — `resolveSymbolNode` underneath is the one thing
+ * actually reused, which is where the real graph-join logic (ambiguity, line check, path
+ * translation) lives. See DEC-NEXT-witnessed-click-is-a-node-ledger-not-an-edge.md.
+ */
+export function resolveActionIdentityGraphNode(driver, identity, repo, options = {}) {
+    if (identity.outcome !== "grounded" || !identity.authoredSource || identity.file === null || identity.component === null) {
+        return {
+            outcome: "withheld",
+            reason: "identity grounding did not produce an authored file, component and symbol for this action's target " +
+                "element — see the element's own identity outcome (grounded/component-only/refused) for why.",
+        };
+    }
+    const location = identity.line === null
+        ? { file: identity.file, symbolName: identity.component }
+        : { file: identity.file, symbolName: identity.component, line: identity.line };
+    const resolution = resolveSymbolNode(driver, location, repo, options);
+    switch (resolution.outcome) {
+        case "resolved":
+            return { outcome: "resolved", node: toGraphNode(resolution.node) };
+        case "line-mismatch":
+            return { outcome: "line-mismatch", node: toGraphNode(resolution.node), reason: resolution.reason };
+        case "not-found":
+            return { outcome: "not-found", reason: resolution.reason };
+        case "ambiguous":
+            return { outcome: "ambiguous", reason: resolution.reason };
+    }
+}
 //# sourceMappingURL=identity-graph-write.js.map

package/dist/browser/identity-graph-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity-graph-write.js","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAwB,MAAM,qCAAqC,CAAC;AAsBnG;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,QAAyB,EACzB,IAAY,EACZ,UAAiE,EAAE;IAEnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EACJ,4FAA4F;gBAC5F,2EAA2E;SAC9E,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,QAAQ,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,KAAK,eAAe;YAClB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACrG,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QAC7D,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAA2E;IAC9F,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"identity-graph-write.js","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"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"}

package/dist/browser/playwright-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-driver.d.ts","sourceRoot":"","sources":["../../src/browser/playwright-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAO7E,oOAAoO;AACpO,UAAU,aAAa;IACrB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;CAC1G;AAED,UAAU,WAAY,SAAQ,aAAa;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;;uGAEmG;IACnG,WAAW,CAAC,IAAI,QAAQ,CAAC;IACzB;yFACqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxG,gGAAgG;IAChG,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;mEAI+D;IAC/D,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IACtE,yFAAyF;IACzF,cAAc,CAAC,IAAI;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,qGAAqG;AACrG,UAAU,QAAS,SAAQ,aAAa;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAED;;4FAE4F;AAC5F,UAAU,eAAe;IACvB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AA2BD,OAAO,KAAK,EACV,aAAa,EASb,kBAAkB,EAKlB,cAAc,EAQd,eAAe,EAGhB,MAAM,aAAa,CAAC;AAoDrB,MAAM,WAAW,uBAAuB;IACtC,4KAA4K;IAC5K,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAChD,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8NAA8N;IAC9N,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,mGAAmG;IACnG,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED,KAAK,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,iBAAiB,CAAC;AAwOhE;;2CAE2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED;;;;4FAI4F;AAC5F,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,gBAAgB,CAqOjE;AAuHD,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,KAAK,EAAE,OAAO;CAO3B;AAED,6NAA6N;AAC7N,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA2CD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED,wBAAsB,6BAA6B,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,aAAa,CAAC,CA+CjH;AAutBD,gNAAgN;AAChN,wBAAgB,OAAO,CACrB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC,kBAAkB,CA+NpB"}
+{"version":3,"file":"playwright-driver.d.ts","sourceRoot":"","sources":["../../src/browser/playwright-driver.ts"],"names":[],"mappings":"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"}

package/dist/browser/playwright-driver.js

@@ -16,7 +16,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 // backend is installed. Currently blocked on a runtime release: @descryy/mcp pins
 // @descryy/runtime-controller at 0.3.5, which predates preflight.ts.
 import { runPreflight, portAnswersCheck } from "@descryy/runtime-controller";
-import { BrowserSessionCrashedError, NoSuchOptionError, NotOperableError, NotSelectableError, NotSubmittableError, UnknownElementRefError, } from "./driver.js";
+import { BrowserSessionCrashedError, NoActiveRecordingError, NoSuchOptionError, NotOperableError, NotSelectableError, NotSubmittableError, RecordingAlreadyActiveError, UnknownElementRefError, recordedSecretCredentialName, recordedSecretPlaceholder, } from "./driver.js";
 import { clampWaitTimeout, describeWaitTarget, isEmptyWaitTarget, matchesWaitTarget, WAIT_POLL_INTERVAL_MS, } from "./wait-target.js";
 import { PROBE_CONSTANTS, probeInPage } from "./page-probe.js";
 /** The module the driver composes. Named once, imported at call time. */
@@ -582,6 +582,32 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
      *  (§B1's `identity: null` distinction — see `driver.ts`). */
     let grounder = null;
     const sessionWarnings = [...launchNotes];
+    // Decided once, at open time, from whether the installed runtime exports the collector at
+    // all — never from anything about the page, the same discipline the fake driver's own
+    // `recordingDisabled` flag follows: a driver either can record or it cannot, and that must
+    // not flicker mid-session. `null` is this build's honest "cannot record" — `startRecording`/
+    // `stopRecording` are added to `api` below only when this is non-null, and are otherwise
+    // simply absent (rule 7).
+    const recordingCollector = typeof runtime.createBrowserRecordingCollector === "function" ? runtime.createBrowserRecordingCollector({ session }) : null;
+    let recordingActive = false;
+    // This session's own running count of secrets redacted so far — ordinal-suffixed even when
+    // an element's name would slug cleanly alone, so two distinct password fields recorded in one
+    // pass never collide onto the same credential name (`recordedSecretCredentialName`'s own doc).
+    let recordingSecretOrdinal = 0;
+    /** `RuntimeRecordedInteraction` -> `PerformedStep`, the one place the two vocabularies join —
+     *  mirrors `mapIdentity` above in spirit. A secret interaction's `text` is never the literal
+     *  value (the collector never sent one); it becomes this session's next credential placeholder. */
+    function mapRecordedInteraction(interaction) {
+        const target = interaction.target === null
+            ? null
+            : { role: interaction.target.role, name: interaction.target.name, selector: interaction.target.selector };
+        let text = interaction.text;
+        if (interaction.secret) {
+            recordingSecretOrdinal += 1;
+            text = recordedSecretPlaceholder(recordedSecretCredentialName(interaction.target?.name ?? "", recordingSecretOrdinal));
+        }
+        return { action: interaction.action, target, url: interaction.url, text, at: interaction.at };
+    }
     const context = {
         executionId: `mcp-browser-${session.sessionId}`,
         configuration: { environmentTier: "tier-2-container", fidelityLevel: 2, timeoutMs: 30_000, services: {} },
@@ -641,8 +667,8 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             throw new UnknownElementRefError(ref);
         return found;
     }
-    function recordAction(action, ref, mode) {
-        actions.push({ action, ref, mode, url: session.page.url(), at: new Date().toISOString() });
+    function recordAction(action, ref, mode, identity = null) {
+        actions.push({ action, ref, mode, url: session.page.url(), at: new Date().toISOString(), identity });
     }
     function recordPerformed(action, target, url, text) {
         performed.push({ action, target, url, text, at: new Date().toISOString() });
@@ -1003,7 +1029,7 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             assertUsable();
             const { element, handle } = resolve(ref);
             await handle.click();
-            recordAction("click", ref, null);
+            recordAction("click", ref, null, element.identity);
             recordPerformed("click", { role: element.role, name: element.name, selector: element.selector }, null, null);
             // requestfinished fires after the page's handler resolves; draining immediately would miss the very request being watched for.
             await settleAfterAction("click", ref);
@@ -1017,7 +1043,7 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
                 await handle.type(text);
             else
                 throw new Error("this Playwright build exposes no keystroke-level typing method");
-            recordAction("type", ref, "append");
+            recordAction("type", ref, "append", element.identity);
             recordPerformed("type", { role: element.role, name: element.name, selector: element.selector }, null, text);
             await settleAfterAction("type", ref);
         },
@@ -1025,7 +1051,7 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             assertUsable();
             const { element, handle } = resolve(ref);
             await handle.fill(text);
-            recordAction("fill", ref, "replace");
+            recordAction("fill", ref, "replace", element.identity);
             recordPerformed("fill", { role: element.role, name: element.name, selector: element.selector }, null, text);
             await settleAfterAction("fill", ref);
         },
@@ -1059,7 +1085,7 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             if (handle.selectOption === undefined)
                 throw new Error("this Playwright build exposes no option-selecting method");
             await handle.selectOption(matched.value);
-            recordAction("select", ref, "replace");
+            recordAction("select", ref, "replace", element.identity);
             recordPerformed("select", { role: element.role, name: element.name, selector: element.selector }, null, matched.value);
             await settleAfterAction("select", ref);
         },
@@ -1083,7 +1109,7 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             });
             if (outcome !== "submitted")
                 throw new NotSubmittableError(ref, outcome);
-            recordAction("submit", ref, null);
+            recordAction("submit", ref, null, element.identity);
             recordPerformed("submit", { role: element.role, name: element.name, selector: element.selector }, null, null);
             await settleAfterAction("submit", ref);
         },
@@ -1143,6 +1169,35 @@ async function openSession(runtime, session, launchOptions, options, launchNotes
             return [...performed];
         },
         storageStateSaveFailure: () => storageStateSaveError,
+        // `startRecording`/`stopRecording` (driver.ts) land here as real methods only when the
+        // installed `@descryy/runtime-browser` exports the collector (`recordingCollector !== null`,
+        // decided once above, at open time). Otherwise the two members are genuinely absent, never
+        // present with a body that silently captures nothing (rule 7): `record_start` reads the
+        // absence and refuses by name. See
+        // `documents/decisions-inbox/DEC-NEXT-browser-recording-primitive.md` for the cross-repo
+        // history and what `@descryy/runtime-browser` had to add for this to light up.
+        ...(recordingCollector === null
+            ? {}
+            : {
+                async startRecording() {
+                    assertUsable();
+                    if (recordingActive)
+                        throw new RecordingAlreadyActiveError(session.sessionId);
+                    await recordingCollector.start();
+                    recordingActive = true;
+                },
+                async stopRecording() {
+                    assertUsable();
+                    if (!recordingActive)
+                        throw new NoActiveRecordingError(session.sessionId);
+                    recordingActive = false;
+                    const interactions = await recordingCollector.stop();
+                    const steps = interactions.map(mapRecordedInteraction);
+                    for (const step of steps)
+                        performed.push(step);
+                    return steps;
+                },
+            }),
         /**
          * §4.2's probe. Reads the page and counts; decides nothing — `estimateReach`
          * is the only thing that turns these counts into a claim, so a change of