react-native-mcp-kit 3.0.1 → 4.1.0

package/dist/shared/projection/resolvePath.d.ts

@@ -0,0 +1,45 @@
+/**
+ * JS-style path parser/resolver. Path examples:
+ *   foo.bar          — object key access
+ *   foo[3]           — array index
+ *   foo[1:5]         — array/object slice (Python-style)
+ *   foo[3:]          — slice from 3 to end
+ *   foo[:5]          — slice from start to 5
+ *   foo["key.with.dots"]   — bracket-quoted object key
+ *   foo['k']         — single-quoted also accepted
+ *
+ * Used by `projectValue` to navigate inside a response before applying
+ * shape rendering. After a slice, chained access has special semantics:
+ *   - array slice + `.key` → map (apply to every element)
+ *   - array slice + `[N]`  → pick Nth element of the window
+ *   - object slice + `.key` → take key from sub-object (no map)
+ *   - object slice + `[N]` → Nth key in window (insertion order)
+ */
+export type PathSegment = {
+    kind: 'key';
+    name: string;
+} | {
+    index: number;
+    kind: 'index';
+} | {
+    kind: 'slice';
+    end?: number;
+    start?: number;
+};
+export type PathResult = {
+    ok: true;
+    value: unknown;
+} | {
+    actual: unknown;
+    error: string;
+    ok: false;
+    validUpTo: string;
+};
+export declare const parsePath: (path: string) => PathSegment[];
+/**
+ * Walk a path through a value tree. Slice + chained access has the semantics
+ * documented in this file's header. Returns either the resolved value or a
+ * detailed failure pointing at where the path broke.
+ */
+export declare const resolvePath: (root: unknown, path: string) => PathResult;
+//# sourceMappingURL=resolvePath.d.ts.map

package/dist/shared/projection/resolvePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePath.d.ts","sourceRoot":"","sources":["../../../src/shared/projection/resolvePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,WAAW,EA4BnD,CAAC;AAqDF;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAU,OAAO,QAAQ,MAAM,KAAG,UAgCzD,CAAC"}

package/dist/shared/projection/resolvePath.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * JS-style path parser/resolver. Path examples:
+ *   foo.bar          — object key access
+ *   foo[3]           — array index
+ *   foo[1:5]         — array/object slice (Python-style)
+ *   foo[3:]          — slice from 3 to end
+ *   foo[:5]          — slice from start to 5
+ *   foo["key.with.dots"]   — bracket-quoted object key
+ *   foo['k']         — single-quoted also accepted
+ *
+ * Used by `projectValue` to navigate inside a response before applying
+ * shape rendering. After a slice, chained access has special semantics:
+ *   - array slice + `.key` → map (apply to every element)
+ *   - array slice + `[N]`  → pick Nth element of the window
+ *   - object slice + `.key` → take key from sub-object (no map)
+ *   - object slice + `[N]` → Nth key in window (insertion order)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePath = exports.parsePath = void 0;
+const parsePath = (path) => {
+    const out = [];
+    let i = 0;
+    const n = path.length;
+    while (i < n) {
+        const ch = path[i];
+        if (ch === '.') {
+            i += 1;
+            continue;
+        }
+        if (ch === '[') {
+            // bracket form — could be index, slice, or quoted key
+            const closeIdx = findMatchingBracket(path, i);
+            if (closeIdx === -1)
+                throw new Error(`Unbalanced bracket at position ${i}`);
+            const inner = path.slice(i + 1, closeIdx);
+            out.push(parseBracketContents(inner));
+            i = closeIdx + 1;
+            continue;
+        }
+        // bare identifier — read until next `.` or `[`
+        let j = i;
+        while (j < n && path[j] !== '.' && path[j] !== '[')
+            j += 1;
+        const name = path.slice(i, j);
+        if (name === '')
+            throw new Error(`Empty key at position ${i}`);
+        out.push({ kind: 'key', name });
+        i = j;
+    }
+    return out;
+};
+exports.parsePath = parsePath;
+const findMatchingBracket = (path, openIdx) => {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = openIdx + 1; i < path.length; i++) {
+        const c = path[i];
+        if (c === '\\' && i + 1 < path.length) {
+            i += 1;
+            continue;
+        }
+        if (!inDouble && c === "'")
+            inSingle = !inSingle;
+        else if (!inSingle && c === '"')
+            inDouble = !inDouble;
+        else if (!inSingle && !inDouble && c === ']')
+            return i;
+    }
+    return -1;
+};
+const parseBracketContents = (inner) => {
+    const trimmed = inner.trim();
+    // quoted key
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        const raw = trimmed.slice(1, -1);
+        return { kind: 'key', name: unescape(raw) };
+    }
+    // slice — contains ':'
+    if (trimmed.includes(':')) {
+        const parts = trimmed.split(':');
+        const startStr = parts[0] ?? '';
+        const endStr = parts[1] ?? '';
+        const start = startStr.trim() === '' ? undefined : Number(startStr);
+        const end = endStr.trim() === '' ? undefined : Number(endStr);
+        if ((start !== undefined && Number.isNaN(start)) || (end !== undefined && Number.isNaN(end))) {
+            throw new Error(`Invalid slice "${inner}"`);
+        }
+        return { end, kind: 'slice', start };
+    }
+    // numeric index
+    const idx = Number(trimmed);
+    if (Number.isInteger(idx)) {
+        return { index: idx, kind: 'index' };
+    }
+    // bare identifier inside brackets — treat as key
+    return { kind: 'key', name: trimmed };
+};
+const unescape = (s) => {
+    return s.replace(/\\(.)/g, '$1');
+};
+/**
+ * Walk a path through a value tree. Slice + chained access has the semantics
+ * documented in this file's header. Returns either the resolved value or a
+ * detailed failure pointing at where the path broke.
+ */
+const resolvePath = (root, path) => {
+    let segments;
+    try {
+        segments = (0, exports.parsePath)(path);
+    }
+    catch (e) {
+        return {
+            actual: root,
+            error: `Invalid path: ${e.message}`,
+            ok: false,
+            validUpTo: '',
+        };
+    }
+    let current = root;
+    let validPath = '';
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        const stepResult = step(current, seg);
+        if (!stepResult.ok) {
+            return {
+                actual: current,
+                error: stepResult.error,
+                ok: false,
+                validUpTo: validPath,
+            };
+        }
+        current = stepResult.value;
+        validPath =
+            validPath === ''
+                ? segmentToString(seg)
+                : `${validPath}${segmentSeparator(seg)}${segmentToString(seg)}`;
+    }
+    return { ok: true, value: current };
+};
+exports.resolvePath = resolvePath;
+const segmentSeparator = (seg) => {
+    return seg.kind === 'key' ? '.' : '';
+};
+const segmentToString = (seg) => {
+    switch (seg.kind) {
+        case 'key':
+            return /^[a-zA-Z_$][a-zA-Z_$0-9]*$/.test(seg.name) ? seg.name : `["${seg.name}"]`;
+        case 'index':
+            return `[${seg.index}]`;
+        case 'slice':
+            return `[${seg.start ?? ''}:${seg.end ?? ''}]`;
+    }
+};
+const step = (current, seg) => {
+    if (seg.kind === 'key')
+        return stepKey(current, seg.name);
+    if (seg.kind === 'index')
+        return stepIndex(current, seg.index);
+    return stepSlice(current, seg);
+};
+const stepKey = (current, name) => {
+    if (Array.isArray(current)) {
+        // map: apply .key to each element. Each element must be an object.
+        const mapped = current.map((el) => {
+            return el && typeof el === 'object' ? el[name] : undefined;
+        });
+        return { ok: true, value: mapped };
+    }
+    if (current && typeof current === 'object') {
+        const rec = current;
+        if (!(name in rec)) {
+            return { error: `Key "${name}" not found`, ok: false };
+        }
+        return { ok: true, value: rec[name] };
+    }
+    return { error: `Cannot access key "${name}" on non-container`, ok: false };
+};
+const stepIndex = (current, index) => {
+    if (Array.isArray(current)) {
+        const real = index < 0 ? current.length + index : index;
+        if (real < 0 || real >= current.length) {
+            return { error: `Array index ${index} out of bounds (length ${current.length})`, ok: false };
+        }
+        return { ok: true, value: current[real] };
+    }
+    if (current && typeof current === 'object') {
+        // object indexing — Nth key in insertion order
+        const keys = Object.keys(current);
+        const real = index < 0 ? keys.length + index : index;
+        if (real < 0 || real >= keys.length) {
+            return { error: `Object index ${index} out of bounds (${keys.length} keys)`, ok: false };
+        }
+        return { ok: true, value: current[keys[real]] };
+    }
+    return { error: `Cannot index non-container with [${index}]`, ok: false };
+};
+const stepSlice = (current, seg) => {
+    const { end, start } = seg;
+    if (Array.isArray(current)) {
+        return { ok: true, value: current.slice(start, end) };
+    }
+    if (current && typeof current === 'object') {
+        const entries = Object.entries(current);
+        const sliced = entries.slice(start, end);
+        return { ok: true, value: Object.fromEntries(sliced) };
+    }
+    return { error: 'Cannot slice non-container', ok: false };
+};
+//# sourceMappingURL=resolvePath.js.map

package/dist/shared/projection/resolvePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePath.js","sourceRoot":"","sources":["../../../src/shared/projection/resolvePath.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAWI,MAAM,SAAS,GAAG,CAAC,IAAY,EAAiB,EAAE;IACvD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,sDAAsD;YACtD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9C,IAAI,QAAQ,KAAK,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC;YAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;YACtC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,+CAA+C;QAC/C,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AA5BW,QAAA,SAAS,aA4BpB;AAEF,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE;IACpE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,GAAG;YAAE,QAAQ,GAAG,CAAC,QAAQ,CAAC;aAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,GAAG;YAAE,QAAQ,GAAG,CAAC,QAAQ,CAAC;aACjD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAe,EAAE;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,aAAa;IACb,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAClD,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD,uBAAuB;IACvB,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,gBAAgB;IAChB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;IACD,iDAAiD;IACjD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE;IACrC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,IAAa,EAAE,IAAY,EAAc,EAAE;IACrE,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,iBAAkB,CAAW,CAAC,OAAO,EAAE;YAC9C,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,EAAE,EAAE,KAAK;gBACT,SAAS,EAAE,SAAS;aACrB,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;QAC3B,SAAS;YACP,SAAS,KAAK,EAAE;gBACd,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC;gBACtB,CAAC,CAAC,GAAG,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC,CAAC;AAhCW,QAAA,WAAW,eAgCtB;AAEF,MAAM,gBAAgB,GAAG,CAAC,GAAgB,EAAU,EAAE;IACpD,OAAO,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,GAAgB,EAAU,EAAE;IACnD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC;QACpF,KAAK,OAAO;YACV,OAAO,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC;IACnD,CAAC;AACH,CAAC,CAAC;AAWF,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAE,GAAgB,EAAqB,EAAE;IACrE,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/D,OAAO,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAE,IAAY,EAAqB,EAAE;IACpE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,mEAAmE;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAChC,OAAO,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAE,EAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAkC,CAAC;QAC/C,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,sBAAsB,IAAI,oBAAoB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,KAAa,EAAqB,EAAE;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,KAAK,EAAE,eAAe,KAAK,0BAA0B,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC/F,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3C,+CAA+C;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAiB,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,EAAE,KAAK,EAAE,gBAAgB,KAAK,mBAAmB,IAAI,CAAC,MAAM,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC3F,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAG,OAAmC,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,oCAAoC,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,GAAoC,EAAqB,EAAE;IAC9F,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC,CAAC"}

package/dist/shared/protocol.d.ts

@@ -18,7 +18,7 @@ export declare const DYNAMIC_PREFIX = "__dynamic__";
  * Introduced in package v2.0.0. Older clients/servers don't send or expect a
  * version field; the handshake treats their absence as an incompatibility.
  */
-export declare const PROTOCOL_VERSION = 1;
+export declare const PROTOCOL_VERSION = 2;
 /** WebSocket close code used when the server refuses the client over protocol mismatch. */
 export declare const WS_CLOSE_PROTOCOL_MISMATCH = 4010;
 export interface ModuleToolDescriptor {
@@ -54,6 +54,7 @@ export interface RegistrationMessage {
     bundleId?: string;
     devServer?: DevServerInfo;
     deviceId?: string;
+    isSimulator?: boolean;
     label?: string;
     platform?: string;
 }

package/dist/shared/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"AAAA;;2DAE2D;AAC3D,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD;;sCAEsC;AACtC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,gBAAkD,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAID,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,WAAW,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"AAAA;;2DAE2D;AAC3D,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD;;sCAEsC;AACtC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,gBAAkD,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAID,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,WAAW,GAAG,sBAAsB,CAAC"}

package/dist/shared/protocol.js

@@ -21,7 +21,7 @@ exports.DYNAMIC_PREFIX = `${exports.MODULE_SEPARATOR}dynamic${exports.MODULE_SEP
  * Introduced in package v2.0.0. Older clients/servers don't send or expect a
  * version field; the handshake treats their absence as an incompatibility.
  */
-exports.PROTOCOL_VERSION = 1;
+exports.PROTOCOL_VERSION = 2;
 /** WebSocket close code used when the server refuses the client over protocol mismatch. */
 exports.WS_CLOSE_PROTOCOL_MISMATCH = 4010;
 //# sourceMappingURL=protocol.js.map

package/dist/shared/rn/core.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `react-native` is a peer dependency of this library — when running inside
+ * an RN app it's always present, but tests / docs / SDK-level code may load
+ * modules without RN around. Centralise the `require('react-native')` here
+ * so consumers don't each grow their own try / catch.
+ *
+ * Two entry points:
+ *   - `getRN()` — bare require. Use from modules that are only ever invoked
+ *     in-app (alert, device, logBox, fiberTree). Throws if the package is
+ *     missing.
+ *   - `loadRN()` — try-wrapped + memoised. Returns `null` when RN can't be
+ *     resolved (e.g. handshake code running before bundle / in server
+ *     tooling). Use from code paths that need to tolerate the absence.
+ *
+ * Plus `loadRNInternal(path)` for private RN modules that may move between
+ * RN versions (LogBox internals, getDevServer, ...). Same try-wrap + cache
+ * shape so the call-site doesn't need its own boilerplate.
+ */
+type AnyRN = any;
+/**
+ * Bare `require('react-native')`. Throws if the package isn't installed —
+ * suitable for module factories that already assume an RN environment.
+ */
+export declare const getRN: () => AnyRN;
+/**
+ * Try-wrapped `require('react-native')` with cached negative result. Returns
+ * `null` when RN can't be resolved. Use this in handshake / SDK-level code
+ * that wants to keep working in non-RN contexts.
+ */
+export declare const loadRN: () => AnyRN | null;
+/**
+ * Known RN private sub-module paths. Add a new entry to RN_INTERNAL_LOADERS
+ * alongside any new path — keeps Metro's static analyser happy.
+ */
+export type RNInternalPath = 'Libraries/Core/Devtools/getDevServer' | 'Libraries/LogBox/Data/LogBoxData';
+/**
+ * Try-load a private RN sub-module by path. RN doesn't promise these paths
+ * are stable across versions, so consumers must tolerate `null`. Result is
+ * memoised per-path so repeated calls don't re-require.
+ *
+ * Add new paths to `RN_INTERNAL_LOADERS` above — Metro requires literal
+ * `require('react-native/...')` strings to bundle the dependency.
+ */
+export declare const loadRNInternal: (subPath: RNInternalPath) => unknown;
+/** Test-only: drop memoised modules so the next call re-requires. */
+export declare const __resetRNCache: () => void;
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/shared/rn/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/shared/rn/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,KAAK,KAAK,GAAG,GAAG,CAAC;AAKjB;;;GAGG;AACH,eAAO,MAAM,KAAK,QAAO,KAGxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,KAAK,GAAG,IAUjC,CAAC;AAkBF;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,sCAAsC,GACtC,kCAAkC,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,YAAa,cAAc,KAAG,OAgBxD,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,cAAc,QAAO,IAGjC,CAAC"}

package/dist/shared/rn/core.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * `react-native` is a peer dependency of this library — when running inside
+ * an RN app it's always present, but tests / docs / SDK-level code may load
+ * modules without RN around. Centralise the `require('react-native')` here
+ * so consumers don't each grow their own try / catch.
+ *
+ * Two entry points:
+ *   - `getRN()` — bare require. Use from modules that are only ever invoked
+ *     in-app (alert, device, logBox, fiberTree). Throws if the package is
+ *     missing.
+ *   - `loadRN()` — try-wrapped + memoised. Returns `null` when RN can't be
+ *     resolved (e.g. handshake code running before bundle / in server
+ *     tooling). Use from code paths that need to tolerate the absence.
+ *
+ * Plus `loadRNInternal(path)` for private RN modules that may move between
+ * RN versions (LogBox internals, getDevServer, ...). Same try-wrap + cache
+ * shape so the call-site doesn't need its own boilerplate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__resetRNCache = exports.loadRNInternal = exports.loadRN = exports.getRN = void 0;
+let cachedRN;
+const cachedInternals = new Map();
+/**
+ * Bare `require('react-native')`. Throws if the package isn't installed —
+ * suitable for module factories that already assume an RN environment.
+ */
+const getRN = () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    return require('react-native');
+};
+exports.getRN = getRN;
+/**
+ * Try-wrapped `require('react-native')` with cached negative result. Returns
+ * `null` when RN can't be resolved. Use this in handshake / SDK-level code
+ * that wants to keep working in non-RN contexts.
+ */
+const loadRN = () => {
+    if (cachedRN !== undefined)
+        return cachedRN;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+        const rn = require('react-native');
+        cachedRN = rn.default ?? rn;
+    }
+    catch {
+        cachedRN = null;
+    }
+    return cachedRN;
+};
+exports.loadRN = loadRN;
+// Metro can't statically resolve `require(`react-native/${subPath}`)` —
+// dynamic template-literal requires are silently dropped at bundle time and
+// throw `Invalid call at ...`. RN private API paths must therefore be wired
+// up as literal `require(...)` calls. Each entry is a thunk so the actual
+// require fires on demand (and lazy-fails when the path moved in a newer RN).
+/* eslint-disable @typescript-eslint/no-require-imports */
+const RN_INTERNAL_LOADERS = {
+    'Libraries/Core/Devtools/getDevServer': () => {
+        return require('react-native/Libraries/Core/Devtools/getDevServer');
+    },
+    'Libraries/LogBox/Data/LogBoxData': () => {
+        return require('react-native/Libraries/LogBox/Data/LogBoxData');
+    },
+};
+/**
+ * Try-load a private RN sub-module by path. RN doesn't promise these paths
+ * are stable across versions, so consumers must tolerate `null`. Result is
+ * memoised per-path so repeated calls don't re-require.
+ *
+ * Add new paths to `RN_INTERNAL_LOADERS` above — Metro requires literal
+ * `require('react-native/...')` strings to bundle the dependency.
+ */
+const loadRNInternal = (subPath) => {
+    if (cachedInternals.has(subPath))
+        return cachedInternals.get(subPath) ?? null;
+    const loader = RN_INTERNAL_LOADERS[subPath];
+    if (!loader) {
+        cachedInternals.set(subPath, null);
+        return null;
+    }
+    try {
+        const mod = loader();
+        const unwrapped = mod?.default ?? mod ?? null;
+        cachedInternals.set(subPath, unwrapped);
+        return unwrapped;
+    }
+    catch {
+        cachedInternals.set(subPath, null);
+        return null;
+    }
+};
+exports.loadRNInternal = loadRNInternal;
+/** Test-only: drop memoised modules so the next call re-requires. */
+const __resetRNCache = () => {
+    cachedRN = undefined;
+    cachedInternals.clear();
+};
+exports.__resetRNCache = __resetRNCache;
+//# sourceMappingURL=core.js.map

package/dist/shared/rn/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/shared/rn/core.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAKH,IAAI,QAAkC,CAAC;AACvC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEnD;;;GAGG;AACI,MAAM,KAAK,GAAG,GAAU,EAAE;IAC/B,qGAAqG;IACrG,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC,CAAC;AAHW,QAAA,KAAK,SAGhB;AAEF;;;;GAIG;AACI,MAAM,MAAM,GAAG,GAAiB,EAAE;IACvC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,CAAC;QACH,qGAAqG;QACrG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QACnC,QAAQ,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAVW,QAAA,MAAM,UAUjB;AAEF,wEAAwE;AACxE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,mBAAmB,GAA0C;IACjE,sCAAsC,EAAE,GAAG,EAAE;QAC3C,OAAO,OAAO,CAAC,mDAAmD,CAAC,CAAC;IACtE,CAAC;IACD,kCAAkC,EAAE,GAAG,EAAE;QACvC,OAAO,OAAO,CAAC,+CAA+C,CAAC,CAAC;IAClE,CAAC;CACF,CAAC;AAWF;;;;;;;GAOG;AACI,MAAM,cAAc,GAAG,CAAC,OAAuB,EAAW,EAAE;IACjE,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC9E,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAuC,CAAC;QAC1D,MAAM,SAAS,GAAG,GAAG,EAAE,OAAO,IAAI,GAAG,IAAI,IAAI,CAAC;QAC9C,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,cAAc,kBAgBzB;AAEF,qEAAqE;AAC9D,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,QAAQ,GAAG,SAAS,CAAC;IACrB,eAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC;AAHW,QAAA,cAAc,kBAGzB"}

package/dist/shared/rn/deviceInfo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `react-native-device-info` is treated as an OPTIONAL peer dependency
+ * everywhere in this library — the handshake (`McpClient.autoDetectIdentity`),
+ * the `device.info` aggregate read, and any future consumers all reach for
+ * the package the same way: lazy `require`, swallow ENOENT-style failures,
+ * fall back to `null` when it's not installed.
+ *
+ * This module centralises that pattern so the require lives in exactly one
+ * place. Consumers either call `loadDeviceInfo()` and check for null, or use
+ * the safe-call helpers below to invoke single fields without each site
+ * re-implementing the try/catch.
+ */
+type AnyDI = any;
+/**
+ * Load `react-native-device-info` once and cache the result (including the
+ * negative case — repeated calls don't re-require when the package is
+ * absent). Returns the unwrapped module (`.default` or namespace) or `null`
+ * when the package isn't installed / fails to resolve.
+ */
+export declare const loadDeviceInfo: () => AnyDI | null;
+/** Test-only: drop the memoised module so the next call re-requires. */
+export declare const __resetDeviceInfoCache: () => void;
+/**
+ * Call a sync method on the DI module if it exists. Returns `fallback`
+ * (default `null`) when the function is missing or throws. Useful for
+ * older device-info versions where individual getters may be absent.
+ */
+export declare const callDI: <T>(fn: unknown, fallback?: T | null) => T | null;
+/** Async variant of `callDI` for DI methods that return Promises. */
+export declare const callDIAsync: <T>(fn: unknown, fallback?: T | null) => Promise<T | null>;
+/**
+ * Standard "package not available" payload used by both the device module
+ * and any other consumer that wants to surface the absence consistently.
+ */
+export declare const DEVICE_INFO_UNAVAILABLE: {
+    readonly reason: "react-native-device-info is not installed. Add it as a dependency to expose battery / memory / disk / extended identity fields.";
+    readonly unavailable: true;
+};
+export {};
+//# sourceMappingURL=deviceInfo.d.ts.map

package/dist/shared/rn/deviceInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../../../src/shared/rn/deviceInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,KAAK,KAAK,GAAG,GAAG,CAAC;AAIjB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAO,KAAK,GAAG,IAUzC,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,QAAO,IAEzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,MAAM,OAAO,aAAY,CAAC,GAAG,IAAI,KAAU,CAAC,GAAG,IAOtE,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,WAAW,GAAU,CAAC,MAAM,OAAO,aAAY,CAAC,GAAG,IAAI,KAAU,OAAO,CAAC,CAAC,GAAG,IAAI,CAO7F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;CAI1B,CAAC"}

package/dist/shared/rn/deviceInfo.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * `react-native-device-info` is treated as an OPTIONAL peer dependency
+ * everywhere in this library — the handshake (`McpClient.autoDetectIdentity`),
+ * the `device.info` aggregate read, and any future consumers all reach for
+ * the package the same way: lazy `require`, swallow ENOENT-style failures,
+ * fall back to `null` when it's not installed.
+ *
+ * This module centralises that pattern so the require lives in exactly one
+ * place. Consumers either call `loadDeviceInfo()` and check for null, or use
+ * the safe-call helpers below to invoke single fields without each site
+ * re-implementing the try/catch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVICE_INFO_UNAVAILABLE = exports.callDIAsync = exports.callDI = exports.__resetDeviceInfoCache = exports.loadDeviceInfo = void 0;
+let cachedDI;
+/**
+ * Load `react-native-device-info` once and cache the result (including the
+ * negative case — repeated calls don't re-require when the package is
+ * absent). Returns the unwrapped module (`.default` or namespace) or `null`
+ * when the package isn't installed / fails to resolve.
+ */
+const loadDeviceInfo = () => {
+    if (cachedDI !== undefined)
+        return cachedDI;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+        const di = require('react-native-device-info');
+        cachedDI = di.default ?? di;
+    }
+    catch {
+        cachedDI = null;
+    }
+    return cachedDI;
+};
+exports.loadDeviceInfo = loadDeviceInfo;
+/** Test-only: drop the memoised module so the next call re-requires. */
+const __resetDeviceInfoCache = () => {
+    cachedDI = undefined;
+};
+exports.__resetDeviceInfoCache = __resetDeviceInfoCache;
+/**
+ * Call a sync method on the DI module if it exists. Returns `fallback`
+ * (default `null`) when the function is missing or throws. Useful for
+ * older device-info versions where individual getters may be absent.
+ */
+const callDI = (fn, fallback = null) => {
+    if (typeof fn !== 'function')
+        return fallback;
+    try {
+        return fn();
+    }
+    catch {
+        return fallback;
+    }
+};
+exports.callDI = callDI;
+/** Async variant of `callDI` for DI methods that return Promises. */
+const callDIAsync = async (fn, fallback = null) => {
+    if (typeof fn !== 'function')
+        return fallback;
+    try {
+        return (await fn());
+    }
+    catch {
+        return fallback;
+    }
+};
+exports.callDIAsync = callDIAsync;
+/**
+ * Standard "package not available" payload used by both the device module
+ * and any other consumer that wants to surface the absence consistently.
+ */
+exports.DEVICE_INFO_UNAVAILABLE = {
+    reason: 'react-native-device-info is not installed. Add it as a dependency to expose battery / memory / disk / extended identity fields.',
+    unavailable: true,
+};
+//# sourceMappingURL=deviceInfo.js.map

package/dist/shared/rn/deviceInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.js","sourceRoot":"","sources":["../../../src/shared/rn/deviceInfo.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAKH,IAAI,QAAkC,CAAC;AAEvC;;;;;GAKG;AACI,MAAM,cAAc,GAAG,GAAiB,EAAE;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,CAAC;QACH,qGAAqG;QACrG,MAAM,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAC/C,QAAQ,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB;AAEF,wEAAwE;AACjE,MAAM,sBAAsB,GAAG,GAAS,EAAE;IAC/C,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC,CAAC;AAFW,QAAA,sBAAsB,0BAEjC;AAEF;;;;GAIG;AACI,MAAM,MAAM,GAAG,CAAI,EAAW,EAAE,WAAqB,IAAI,EAAY,EAAE;IAC5E,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,EAAE,EAAO,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,MAAM,UAOjB;AAEF,qEAAqE;AAC9D,MAAM,WAAW,GAAG,KAAK,EAAK,EAAW,EAAE,WAAqB,IAAI,EAAqB,EAAE;IAChG,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAM,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,WAAW,eAOtB;AAEF;;;GAGG;AACU,QAAA,uBAAuB,GAAG;IACrC,MAAM,EACJ,iIAAiI;IACnI,WAAW,EAAE,IAAI;CACT,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mcp-kit",
-  "version": "3.0.1",
+  "version": "4.1.0",
   "description": "MCP server for React Native — drive, inspect, and debug running RN apps from AI agents via the real OS gesture pipeline",
   "license": "MIT",
   "author": "Aliaksei Pranko",
@@ -62,7 +62,7 @@
     "./server": "./dist/server/index.js"
   },
   "scripts": {
-    "build": "tsc && tsc-alias && ./scripts/build-ios-hid.sh",
+    "build": "rm -rf dist && tsc && tsc-alias && ./scripts/build-ios-hid.sh",
     "dev": "tsc --watch",
     "lint": "eslint --ext .ts --ext .tsx ./src",
     "lint:fix": "eslint --ext .ts --ext .tsx ./src --fix",
@@ -98,6 +98,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "bplist-creator": "^0.1.1",
+    "bplist-parser": "^0.3.2",
     "sharp": "^0.34.5",
     "ws": "^8.20.0",
     "zod": "^4.3.6"

package/dist/client/hooks/useMcpState.d.ts

@@ -1,3 +0,0 @@
-import { type DependencyList } from 'react';
-export declare const useMcpState: (key: string, factory: () => unknown, deps: DependencyList) => void;
-//# sourceMappingURL=useMcpState.d.ts.map

package/dist/client/hooks/useMcpState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useMcpState.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useMcpState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAI5E,eAAO,MAAM,WAAW,QAAS,MAAM,WAAW,MAAM,OAAO,QAAQ,cAAc,KAAG,IAYvF,CAAC"}