react-native-mcp-kit 3.0.1 → 4.1.0

package/dist/server/metro/tools/events.js

@@ -3,26 +3,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEventsTool = void 0;
 const eventCapture_1 = require("../../../server/metro/eventCapture");
 const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
-const slice_1 = require("../../../shared/slice");
+const projectValue_1 = require("../../../shared/projection/projectValue");
+// Default depth 4 — top-level outer ({metroUrl,connected,events,lastError,total})
+// (1) → events array (2) → event (3) → data (4). Heavy event payloads collapse
+// past depth 4 to markers; drill via path.
+const EVENTS_DEFAULT_DEPTH = 4;
+const PROJECTION_SCHEMA = (0, projectValue_1.makeProjectionSchema)(EVENTS_DEFAULT_DEPTH);
 const getEventsTool = () => {
     return {
         description: `Read recent Metro reporter events from a server-side ring buffer fed by Metro's WebSocket \`/events\` stream.
 
 Metro emits events for the whole bundler lifecycle — \`bundle_build_started\` / \`bundle_build_done\` / \`bundle_build_failed\`, \`bundling_error\`, \`hmr_update\`, \`hmr_client_error\`, \`initial_update_done\`, \`transform_cache_reset\`, \`dep_graph_loading\` / \`dep_graph_loaded\`, \`client_log\`, \`worker_stdout_chunk\` / \`worker_stderr_chunk\`. When an agent edits a file and HMR silently fails (syntax error, broken import), the red box may not appear — but the \`bundling_error\` / \`hmr_client_error\` event already explains why.
 
-The capture is lazy (connects on first call) and auto-reconnects. Buffer holds the last 200 events. Pass \`since: <msEpoch>\` to get only what arrived after a known checkpoint ("events since right before I edited Foo.tsx"). \`type\` filters to one or several event types.
+The capture is lazy (connects on first call) and auto-reconnects. Buffer holds the last 200 events. Pass \`since: <msEpoch>\` to get only what arrived after a known checkpoint. \`type\` filters to one or several event types.
 
-Each event has \`{ id, receivedAt, type, data }\`; \`data\` is the raw Metro payload minus the \`type\` field.`,
+Each event: \`{ id, receivedAt, type, data }\`; \`data\` is the raw Metro payload minus the \`type\` field. Response accepts path / depth / maxBytes (default depth ${EVENTS_DEFAULT_DEPTH}).`,
         handler: async (args, ctx) => {
             const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
             const capture = (0, eventCapture_1.getEventCapture)(metroUrl);
             const type = args.type;
             const since = typeof args.since === 'number' ? args.since : undefined;
-            const slice = (0, slice_1.parseSliceArg)(args.slice) ?? [-50];
-            const result = capture.getEvents({ since, slice, type });
-            return { metroUrl, ...result };
+            const result = capture.getEvents({ since, type });
+            return (0, projectValue_1.applyProjection)({ metroUrl, ...result }, args, projectValue_1.projectAsValue, EVENTS_DEFAULT_DEPTH);
         },
         inputSchema: {
+            ...PROJECTION_SCHEMA,
             clientId: {
                 description: 'Target client ID — used to pick up the Metro URL the app was loaded from (falls back to `metroUrl` or the hardcoded default).',
                 type: 'string',
@@ -35,11 +40,6 @@ Each event has \`{ id, receivedAt, type, data }\`; \`data\` is the raw Metro pay
                 description: 'Only return events with `receivedAt >= since` (ms since epoch).',
                 type: 'number',
             },
-            slice: {
-                description: (0, slice_1.sliceSchemaDescription)('Default [-50] = the newest 50.'),
-                examples: [[-10], [-20, -10], [0]],
-                type: 'array',
-            },
             type: {
                 description: 'Filter by event type. Accepts a single string or an array of types (OR semantics).',
                 examples: ['bundling_error', ['bundling_error', 'hmr_client_error', 'bundle_build_failed']],

package/dist/server/metro/tools/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/events.ts"],"names":[],"mappings":";;;AACA,8DAA8D;AAC9D,oEAAiE;AACjE,0CAAuE;AAEhE,MAAM,aAAa,GAAG,GAAoB,EAAE;IACjD,OAAO;QACL,WAAW,EAAE;;;;;;+GAM8F;QAC3G,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAqC,CAAC;YACxD,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,MAAM,KAAK,GAAG,IAAA,qBAAa,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACjC,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE;gBACR,WAAW,EACT,+HAA+H;gBACjI,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE;gBACR,WAAW,EAAE,wHAAwH;gBACrI,IAAI,EAAE,QAAQ;aACf;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,iEAAiE;gBAC9E,IAAI,EAAE,QAAQ;aACf;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,IAAA,8BAAsB,EAAC,gCAAgC,CAAC;gBACrE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,EAAE,OAAO;aACd;YACD,IAAI,EAAE;gBACJ,WAAW,EACT,oFAAoF;gBACtF,QAAQ,EAAE,CAAC,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;aAC5F;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AA9CW,QAAA,aAAa,iBA8CxB"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/events.ts"],"names":[],"mappings":";;;AACA,8DAA8D;AAC9D,oEAAiE;AACjE,mEAK0C;AAE1C,kFAAkF;AAClF,+EAA+E;AAC/E,2CAA2C;AAC3C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,MAAM,iBAAiB,GAAG,IAAA,mCAAoB,EAAC,oBAAoB,CAAC,CAAC;AAE9D,MAAM,aAAa,GAAG,GAAoB,EAAE;IACjD,OAAO;QACL,WAAW,EAAE;;;;;;sKAMqJ,oBAAoB,IAAI;QAC1L,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAqC,CAAC;YACxD,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtE,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,IAAA,8BAAe,EACpB,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EACvB,IAAsB,EACtB,6BAAc,EACd,oBAAoB,CACrB,CAAC;QACJ,CAAC;QACD,WAAW,EAAE;YACX,GAAG,iBAAiB;YACpB,QAAQ,EAAE;gBACR,WAAW,EACT,+HAA+H;gBACjI,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE;gBACR,WAAW,EAAE,wHAAwH;gBACrI,IAAI,EAAE,QAAQ;aACf;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,iEAAiE;gBAC9E,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,WAAW,EACT,oFAAoF;gBACtF,QAAQ,EAAE,CAAC,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;aAC5F;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AA9CW,QAAA,aAAa,iBA8CxB"}

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

@@ -0,0 +1,90 @@
+import { type RedactPatterns } from './redact';
+/**
+ * Single canonical "render this value into a compact, agent-friendly JSON"
+ * primitive. Replaces the per-module serializers (`fiberTree:serializeValue`,
+ * `console:serializeArg`, `network:captureBody`).
+ *
+ * Behaviour:
+ * - Walks the value to depth `depth` (default 1, max 8).
+ * - Containers expanded inside the depth budget → raw JSON.
+ * - Containers beyond depth, or specials (Date/Error/etc.) → string-keyed
+ *   sentinel marker `{ "${kind}": meta }` (see plan §2 for full table).
+ * - Wide containers are width-capped: 30 keys for objects, 50 items for
+ *   arrays; the cut adds a `${truncated}` sentinel as the FIRST entry of
+ *   the container.
+ * - Long strings (> previewCap) become `{ "${str}": { "len": N, "preview": "..." } }`.
+ * - Cycles → `{ "${cyc}": true }`.
+ * - Pluggable `collapse` rules let modules detect domain-specific shapes
+ *   (fiberTree component refs) and replace them with their own marker.
+ * - Optional `path` — resolves the path inside `input` first; then projects
+ *   the resolved subtree under the same rules. Path slice (`[N:M]`) overrides
+ *   the default container width-cap for that specific level.
+ */
+export declare const DEFAULT_DEPTH = 1;
+export declare const MAX_DEPTH = 8;
+export declare const DEFAULT_OBJECT_CAP = 30;
+export declare const DEFAULT_ARRAY_CAP = 50;
+export declare const DEFAULT_PREVIEW_CAP = 100;
+export declare const DEFAULT_MAX_BYTES = 50000;
+export type CollapseRule = (value: unknown) => Record<string, unknown> | undefined;
+export interface ProjectOptions {
+    collapse?: ReadonlyArray<CollapseRule>;
+    depth?: number;
+    maxBytes?: number;
+    path?: string;
+    previewCap?: number;
+    redact?: RedactPatterns;
+    skipKeys?: ReadonlyArray<string | RegExp>;
+}
+export interface ProjectResult {
+    bytes: number;
+    truncated: boolean;
+    value: unknown;
+}
+/**
+ * Standard `path` / `depth` / `maxBytes` arg shape for any tool that returns
+ * heavy JSON. Modules call `makeProjectionSchema(defaultDepth)` to get a
+ * description string that reflects their per-tool default, and spread the
+ * result into their inputSchema. Args are then funnelled through
+ * `applyProjection` at the handler exit.
+ */
+export declare const makeProjectionSchema: (defaultDepth?: number) => Record<string, {
+    description: string;
+    type: string;
+    examples?: unknown[];
+}>;
+/** Default-depth projection schema — for modules that don't override depth. */
+export declare const PROJECTION_SCHEMA: Record<string, {
+    description: string;
+    type: string;
+    examples?: unknown[];
+}>;
+export interface ProjectionArgs {
+    depth?: number;
+    maxBytes?: number;
+    path?: string;
+}
+/**
+ * A projector function — takes a raw value + options, returns an
+ * agent-friendly projected value. Modules can plug in `projectFiberValue`
+ * (with fiber-aware collapse rules) or call `projectValue` directly.
+ */
+export type Projector = (value: unknown, options: ProjectOptions) => unknown;
+/**
+ * Convenience wrapper around `projectValue` that returns just the projected
+ * value (drops the `{ bytes, truncated }` envelope). Most module handlers
+ * want this form when they don't need byte-cap telemetry.
+ */
+export declare const projectAsValue: Projector;
+/**
+ * Standard handler-exit hook. Call this on the final raw response with the
+ * tool's args; it pulls `path`/`depth`/`maxBytes` and forwards to the given
+ * projector. Modules may override `defaultDepth` per-tool (e.g. fiberTree
+ * uses 2 because its top-level shape is an array of matches and depth 1
+ * would collapse the array itself into a marker).
+ */
+export declare const applyProjection: (result: unknown, args: ProjectionArgs, projector: Projector, defaultDepth?: number) => unknown;
+declare const isMarker: (v: unknown) => boolean;
+export declare const projectValue: (input: unknown, options?: ProjectOptions) => ProjectResult;
+export { isMarker };
+//# sourceMappingURL=projectValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectValue.d.ts","sourceRoot":"","sources":["../../../src/shared/projection/projectValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAG7E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AAIH,eAAO,MAAM,oBAAoB,kBACjB,MAAM,KACnB,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAkB5E,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB;iBArBG,MAAM;UAAQ,MAAM;eAAa,OAAO,EAAE;EAqBpB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAE5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,WAClB,OAAO,QACT,cAAc,aACT,SAAS,iBACN,MAAM,KACnB,OAMF,CAAC;AAQF,QAAA,MAAM,QAAQ,MAAO,OAAO,KAAG,OAI9B,CAAC;AA8IF,eAAO,MAAM,YAAY,UAAW,OAAO,YAAY,cAAc,KAAG,aA8EvE,CAAC;AAiBF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/shared/projection/projectValue.js

@@ -0,0 +1,322 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMarker = exports.projectValue = exports.applyProjection = exports.projectAsValue = exports.PROJECTION_SCHEMA = exports.makeProjectionSchema = exports.DEFAULT_MAX_BYTES = exports.DEFAULT_PREVIEW_CAP = exports.DEFAULT_ARRAY_CAP = exports.DEFAULT_OBJECT_CAP = exports.MAX_DEPTH = exports.DEFAULT_DEPTH = void 0;
+const redact_1 = require("./redact");
+const resolvePath_1 = require("./resolvePath");
+/**
+ * Single canonical "render this value into a compact, agent-friendly JSON"
+ * primitive. Replaces the per-module serializers (`fiberTree:serializeValue`,
+ * `console:serializeArg`, `network:captureBody`).
+ *
+ * Behaviour:
+ * - Walks the value to depth `depth` (default 1, max 8).
+ * - Containers expanded inside the depth budget → raw JSON.
+ * - Containers beyond depth, or specials (Date/Error/etc.) → string-keyed
+ *   sentinel marker `{ "${kind}": meta }` (see plan §2 for full table).
+ * - Wide containers are width-capped: 30 keys for objects, 50 items for
+ *   arrays; the cut adds a `${truncated}` sentinel as the FIRST entry of
+ *   the container.
+ * - Long strings (> previewCap) become `{ "${str}": { "len": N, "preview": "..." } }`.
+ * - Cycles → `{ "${cyc}": true }`.
+ * - Pluggable `collapse` rules let modules detect domain-specific shapes
+ *   (fiberTree component refs) and replace them with their own marker.
+ * - Optional `path` — resolves the path inside `input` first; then projects
+ *   the resolved subtree under the same rules. Path slice (`[N:M]`) overrides
+ *   the default container width-cap for that specific level.
+ */
+exports.DEFAULT_DEPTH = 1;
+exports.MAX_DEPTH = 8;
+exports.DEFAULT_OBJECT_CAP = 30;
+exports.DEFAULT_ARRAY_CAP = 50;
+exports.DEFAULT_PREVIEW_CAP = 100;
+exports.DEFAULT_MAX_BYTES = 50_000;
+/**
+ * Standard `path` / `depth` / `maxBytes` arg shape for any tool that returns
+ * heavy JSON. Modules call `makeProjectionSchema(defaultDepth)` to get a
+ * description string that reflects their per-tool default, and spread the
+ * result into their inputSchema. Args are then funnelled through
+ * `applyProjection` at the handler exit.
+ */
+// Reusable description shared across all tools: full path/depth/maxBytes
+// semantics live in the server BASE_INSTRUCTIONS — schemas just reference it
+// to keep `describe_tool` payloads small.
+const makeProjectionSchema = (defaultDepth = exports.DEFAULT_DEPTH) => {
+    return {
+        depth: {
+            description: `Expansion depth (default ${defaultDepth}, max ${exports.MAX_DEPTH}). See server instructions § Path-based drill.`,
+            examples: [1, 3, 8],
+            type: 'number',
+        },
+        maxBytes: {
+            description: `Soft byte cap (default ${exports.DEFAULT_MAX_BYTES}). See server instructions § Path-based drill.`,
+            type: 'number',
+        },
+        path: {
+            description: 'Path drill into response (`.key`, `[N]`, `[a:b]`). See server instructions § Path-based drill for full syntax.',
+            examples: ['items[0].body', 'items[0:3].id', 'data.user.email'],
+            type: 'string',
+        },
+    };
+};
+exports.makeProjectionSchema = makeProjectionSchema;
+/** Default-depth projection schema — for modules that don't override depth. */
+exports.PROJECTION_SCHEMA = (0, exports.makeProjectionSchema)();
+/**
+ * Convenience wrapper around `projectValue` that returns just the projected
+ * value (drops the `{ bytes, truncated }` envelope). Most module handlers
+ * want this form when they don't need byte-cap telemetry.
+ */
+const projectAsValue = (value, options) => {
+    return (0, exports.projectValue)(value, options).value;
+};
+exports.projectAsValue = projectAsValue;
+/**
+ * Standard handler-exit hook. Call this on the final raw response with the
+ * tool's args; it pulls `path`/`depth`/`maxBytes` and forwards to the given
+ * projector. Modules may override `defaultDepth` per-tool (e.g. fiberTree
+ * uses 2 because its top-level shape is an array of matches and depth 1
+ * would collapse the array itself into a marker).
+ */
+const applyProjection = (result, args, projector, defaultDepth = exports.DEFAULT_DEPTH) => {
+    return projector(result, {
+        depth: args.depth ?? defaultDepth,
+        maxBytes: args.maxBytes,
+        path: args.path,
+    });
+};
+exports.applyProjection = applyProjection;
+const isPlainObject = (v) => {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(v);
+    return proto === Object.prototype || proto === null;
+};
+const isMarker = (v) => {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return false;
+    const keys = Object.keys(v);
+    return keys.length === 1 && keys[0].startsWith('${') && keys[0].endsWith('}');
+};
+exports.isMarker = isMarker;
+const constructorName = (v) => {
+    const proto = Object.getPrototypeOf(v);
+    if (!proto || proto === Object.prototype)
+        return null;
+    const ctor = proto.constructor;
+    return ctor?.name ?? null;
+};
+const projectString = (s, previewCap) => {
+    if (s.length <= previewCap)
+        return s;
+    return { ['${str}']: { len: s.length, preview: s.slice(0, previewCap) } };
+};
+const projectSpecial = (v, collapse) => {
+    // built-ins first
+    if (v instanceof Date)
+        return { ['${Date}']: v.toISOString() };
+    if (v instanceof RegExp)
+        return { ['${RegExp}']: v.toString() };
+    if (v instanceof Error) {
+        return { ['${Err}']: { msg: v.message, name: v.name } };
+    }
+    if (v instanceof Map)
+        return { ['${map}']: v.size };
+    if (v instanceof Set)
+        return { ['${set}']: v.size };
+    if (typeof v === 'function') {
+        const name = v.name;
+        return { ['${fun}']: name && name.length > 0 ? name : '<anon>' };
+    }
+    if (typeof v === 'symbol') {
+        return { ['${sym}']: v.toString() };
+    }
+    // pluggable collapse rules (fiberTree component refs etc.)
+    for (const rule of collapse) {
+        const out = rule(v);
+        if (out !== undefined)
+            return out;
+    }
+    return undefined;
+};
+const collapsedContainer = (v) => {
+    if (Array.isArray(v))
+        return { ['${arr}']: v.length };
+    if (isPlainObject(v))
+        return { ['${obj}']: Object.keys(v).length };
+    if (v && typeof v === 'object') {
+        const cls = constructorName(v);
+        if (cls)
+            return { ['${cls}']: { len: Object.keys(v).length, name: cls } };
+        return { ['${obj}']: Object.keys(v).length };
+    }
+    return undefined;
+};
+const walkContainer = (v, depth, ctx, seen) => {
+    // strings, primitives — handled before this fn is called
+    // specials (Date, Error, ...) — handled before via projectSpecial
+    if (Array.isArray(v)) {
+        return walkArray(v, depth, ctx, seen);
+    }
+    return walkObject(v, depth, ctx, seen);
+};
+const walkArray = (arr, depth, ctx, seen) => {
+    const total = arr.length;
+    const cap = ctx.arrayCap;
+    const sliced = arr.slice(0, cap);
+    const out = [];
+    if (total > cap) {
+        out.push({ ['${truncated}']: { slice: [0, cap], total } });
+    }
+    for (const item of sliced) {
+        out.push(walk(item, depth - 1, ctx, seen));
+    }
+    return out;
+};
+const walkObject = (obj, depth, ctx, seen) => {
+    const allKeys = Object.keys(obj).filter((k) => {
+        return !matchesSkip(k, ctx);
+    });
+    const total = allKeys.length;
+    const cap = ctx.objectCap;
+    const keys = allKeys.slice(0, cap);
+    const out = {};
+    if (total > cap) {
+        out['${truncated}'] = { slice: [0, cap], total };
+    }
+    for (const k of keys) {
+        if ((0, redact_1.matchesRedact)(k, ctx.compiledRedact)) {
+            out[k] = '[redacted]';
+            continue;
+        }
+        out[k] = walk(obj[k], depth - 1, ctx, seen);
+    }
+    return out;
+};
+const matchesSkip = (key, ctx) => {
+    if (ctx.skipExact.has(key))
+        return true;
+    for (const rx of ctx.skipRegex)
+        if (rx.test(key))
+            return true;
+    return false;
+};
+const walk = (v, remainingDepth, ctx, seen) => {
+    // primitives
+    if (v === null || v === undefined)
+        return v;
+    const t = typeof v;
+    if (t === 'number' || t === 'boolean')
+        return v;
+    if (t === 'bigint')
+        return { ['${bigint}']: v.toString() };
+    if (t === 'string')
+        return projectString(v, ctx.previewCap);
+    // specials before container check (Map/Set/Date/etc. typeof === 'object')
+    const special = projectSpecial(v, ctx.collapse);
+    if (special !== undefined)
+        return special;
+    // cycle
+    if (typeof v === 'object' && v !== null) {
+        if (seen.has(v))
+            return { ['${cyc}']: true };
+        seen.add(v);
+    }
+    // depth exhausted — collapse to marker
+    if (remainingDepth <= 0) {
+        const collapsed = collapsedContainer(v);
+        return collapsed ?? v;
+    }
+    // expand container
+    return walkContainer(v, remainingDepth, ctx, seen);
+};
+const projectValue = (input, options) => {
+    const opts = options ?? {};
+    const depth = clampDepth(opts.depth ?? exports.DEFAULT_DEPTH);
+    const objectCap = exports.DEFAULT_OBJECT_CAP;
+    const arrayCap = exports.DEFAULT_ARRAY_CAP;
+    const previewCap = opts.previewCap ?? exports.DEFAULT_PREVIEW_CAP;
+    const maxBytes = opts.maxBytes ?? exports.DEFAULT_MAX_BYTES;
+    const collapse = opts.collapse ?? [];
+    const skipExact = new Set();
+    const skipRegex = [];
+    for (const k of opts.skipKeys ?? []) {
+        if (typeof k === 'string')
+            skipExact.add(k);
+        else
+            skipRegex.push(k);
+    }
+    const compiledRedact = (0, redact_1.compileRedact)(opts.redact);
+    // resolve path first (if any) — applies to the input tree, not the projection
+    let target = input;
+    let pathResolved = false;
+    if (opts.path) {
+        const res = (0, resolvePath_1.resolvePath)(input, opts.path);
+        if (!res.ok) {
+            return {
+                bytes: 0,
+                truncated: false,
+                value: { error: res.error, validUpTo: res.validUpTo },
+            };
+        }
+        target = res.value;
+        pathResolved = true;
+    }
+    // When path explicitly resolves to a string scalar, return the raw string
+    // (truncated only if it would blow the maxBytes cap). The user navigated
+    // to a leaf — they asked for the content, not a preview marker.
+    if (pathResolved && typeof target === 'string') {
+        if (target.length > maxBytes) {
+            return {
+                bytes: target.length,
+                truncated: true,
+                value: { ['${str}']: { len: target.length, preview: target.slice(0, 200) } },
+            };
+        }
+        return { bytes: target.length, truncated: false, value: target };
+    }
+    const ctx = {
+        arrayCap,
+        collapse,
+        compiledRedact,
+        objectCap,
+        previewCap,
+        skipExact,
+        skipRegex,
+    };
+    const seen = new WeakSet();
+    // walk with depth + 1 because the caller's "depth: N" means N levels of
+    // container expansion; our walk decrements before recursing into children.
+    const projected = walk(target, depth, ctx, seen);
+    // soft byte cap — if exceeded, replace with a string-marker that carries
+    // the original size + a short preview
+    const serialized = safeStringify(projected);
+    if (serialized.length > maxBytes) {
+        const preview = serialized.slice(0, Math.min(maxBytes, 200));
+        return {
+            bytes: serialized.length,
+            truncated: true,
+            value: {
+                ['${str}']: {
+                    len: serialized.length,
+                    preview,
+                },
+            },
+        };
+    }
+    return { bytes: serialized.length, truncated: false, value: projected };
+};
+exports.projectValue = projectValue;
+const clampDepth = (d) => {
+    if (!Number.isFinite(d) || d < 0)
+        return exports.DEFAULT_DEPTH;
+    return Math.min(Math.floor(d), exports.MAX_DEPTH);
+};
+const safeStringify = (v) => {
+    try {
+        return JSON.stringify(v) ?? '';
+    }
+    catch {
+        return '';
+    }
+};
+//# sourceMappingURL=projectValue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectValue.js","sourceRoot":"","sources":["../../../src/shared/projection/projectValue.ts"],"names":[],"mappings":";;;AAAA,qCAA6E;AAC7E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEU,QAAA,aAAa,GAAG,CAAC,CAAC;AAClB,QAAA,SAAS,GAAG,CAAC,CAAC;AACd,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,iBAAiB,GAAG,EAAE,CAAC;AACvB,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAC1B,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAoBxC;;;;;;GAMG;AACH,yEAAyE;AACzE,6EAA6E;AAC7E,0CAA0C;AACnC,MAAM,oBAAoB,GAAG,CAClC,eAAuB,qBAAa,EACyC,EAAE;IAC/E,OAAO;QACL,KAAK,EAAE;YACL,WAAW,EAAE,4BAA4B,YAAY,SAAS,iBAAS,gDAAgD;YACvH,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnB,IAAI,EAAE,QAAQ;SACf;QACD,QAAQ,EAAE;YACR,WAAW,EAAE,0BAA0B,yBAAiB,gDAAgD;YACxG,IAAI,EAAE,QAAQ;SACf;QACD,IAAI,EAAE;YACJ,WAAW,EACT,gHAAgH;YAClH,QAAQ,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;YAC/D,IAAI,EAAE,QAAQ;SACf;KACF,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,oBAAoB,wBAoB/B;AAEF,+EAA+E;AAClE,QAAA,iBAAiB,GAAG,IAAA,4BAAoB,GAAE,CAAC;AAexD;;;;GAIG;AACI,MAAM,cAAc,GAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC1D,OAAO,IAAA,oBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEF;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAC7B,MAAe,EACf,IAAoB,EACpB,SAAoB,EACpB,eAAuB,qBAAa,EAC3B,EAAE;IACX,OAAO,SAAS,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC,CAAC;AAXW,QAAA,eAAe,mBAW1B;AAEF,MAAM,aAAa,GAAG,CAAC,CAAU,EAAgC,EAAE;IACjE,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAW,EAAE;IACvC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC,CAAC;AA6OO,4BAAQ;AA3OjB,MAAM,eAAe,GAAG,CAAC,CAAS,EAAiB,EAAE;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAI,KAA6C,CAAC,WAAW,CAAC;IACxE,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,UAAkB,EAAW,EAAE;IAC/D,IAAI,CAAC,CAAC,MAAM,IAAI,UAAU;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAU,EAAE,QAAqC,EAAuB,EAAE;IAChG,kBAAkB;IAClB,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IAC/D,IAAI,CAAC,YAAY,MAAM;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IAChE,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,YAAY,GAAG;QAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,YAAY,GAAG;QAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAI,CAAuB,CAAC,IAAI,CAAC;QAC3C,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtC,CAAC;IACD,2DAA2D;IAC3D,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAU,EAAuC,EAAE;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,IAAI,aAAa,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnE,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,eAAe,CAAC,CAAW,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpF,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAU,EAAE,KAAa,EAAE,GAAY,EAAE,IAAqB,EAAW,EAAE;IAChG,yDAAyD;IACzD,kEAAkE;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC,CAA4B,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,GAAc,EAAE,KAAa,EAAE,GAAY,EAAE,IAAqB,EAAW,EAAE;IAChG,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC;IACzB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CACjB,GAA4B,EAC5B,KAAa,EACb,GAAY,EACZ,IAAqB,EACZ,EAAE;IACX,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5C,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,IAAA,sBAAa,EAAC,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;YACtB,SAAS;QACX,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAYF,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,GAAY,EAAW,EAAE;IACzD,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS;QAAE,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,cAAsB,EAAE,GAAY,EAAE,IAAqB,EAAW,EAAE;IAChG,aAAa;IACb,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAG,CAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;IACvE,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,CAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAEtE,0EAA0E;IAC1E,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAE1C,QAAQ;IACR,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAW,CAAC;YAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC;IACxB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO,SAAS,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,mBAAmB;IACnB,OAAO,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC;AAEK,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,OAAwB,EAAiB,EAAE;IACtF,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,qBAAa,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,0BAAkB,CAAC;IACrC,MAAM,QAAQ,GAAG,yBAAiB,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,2BAAmB,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,yBAAiB,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;YACvC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,cAAc,GAAG,IAAA,sBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAElD,8EAA8E;IAC9E,IAAI,MAAM,GAAY,KAAK,CAAC;IAC5B,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,IAAA,yBAAW,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;aACtD,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;QACnB,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,gEAAgE;IAChE,IAAI,YAAY,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC7B,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE;aAC7E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,GAAG,GAAY;QACnB,QAAQ;QACR,QAAQ;QACR,cAAc;QACd,SAAS;QACT,UAAU;QACV,SAAS;QACT,SAAS;KACV,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,wEAAwE;IACxE,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAEjD,yEAAyE;IACzE,sCAAsC;IACtC,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE;gBACL,CAAC,QAAQ,CAAC,EAAE;oBACV,GAAG,EAAE,UAAU,CAAC,MAAM;oBACtB,OAAO;iBACR;aACF;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC1E,CAAC,CAAC;AA9EW,QAAA,YAAY,gBA8EvB;AAEF,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,qBAAa,CAAC;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,iBAAS,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAU,EAAU,EAAE;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Shared redact utility used by `projectValue` and modules that have their
+ * own redact lists (network headers/body keys). Extracted from `network.ts`
+ * verbatim so behaviour stays identical for existing callers.
+ *
+ * - Pattern list is `Array<string | RegExp>`. Strings are lowercased and
+ *   matched as substring on lowercased keys; regexes are matched verbatim.
+ * - `false` (instead of array) — disables redaction.
+ * - `undefined` — uses provided defaults.
+ */
+export type RedactPatterns = ReadonlyArray<string | RegExp> | false;
+interface CompiledRedact {
+    empty: boolean;
+    exact: Set<string>;
+    regexes: RegExp[];
+}
+export declare const compileRedact: (list: RedactPatterns | undefined, defaults?: ReadonlyArray<string | RegExp>) => CompiledRedact | null;
+export declare const matchesRedact: (key: string, compiled: CompiledRedact | null) => boolean;
+/**
+ * Walk an object/array graph; replace value of any key matching a redact
+ * pattern with `[redacted]`. Preserves shape so caller still sees the field
+ * exists. Used by network for request/response bodies; also re-exported for
+ * `projectValue` which inlines the same matcher in its walk.
+ */
+export declare const redactValue: (value: unknown, compiled: CompiledRedact | null) => unknown;
+/**
+ * Redact a flat headers map (case-insensitive on key names).
+ */
+export declare const redactHeaders: (headers: Record<string, string>, compiled: CompiledRedact | null) => Record<string, string>;
+export {};
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/shared/projection/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;AAEpE,UAAU,cAAc;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,SAClB,cAAc,GAAG,SAAS,aACtB,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,KACvC,cAAc,GAAG,IAUnB,CAAC;AAEF,eAAO,MAAM,aAAa,QAAS,MAAM,YAAY,cAAc,GAAG,IAAI,KAAG,OAQ5E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,UAAW,OAAO,YAAY,cAAc,GAAG,IAAI,KAAG,OAa7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,YACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YACrB,cAAc,GAAG,IAAI,KAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAOvB,CAAC"}

package/dist/shared/projection/redact.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Shared redact utility used by `projectValue` and modules that have their
+ * own redact lists (network headers/body keys). Extracted from `network.ts`
+ * verbatim so behaviour stays identical for existing callers.
+ *
+ * - Pattern list is `Array<string | RegExp>`. Strings are lowercased and
+ *   matched as substring on lowercased keys; regexes are matched verbatim.
+ * - `false` (instead of array) — disables redaction.
+ * - `undefined` — uses provided defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactHeaders = exports.redactValue = exports.matchesRedact = exports.compileRedact = void 0;
+const compileRedact = (list, defaults = []) => {
+    if (list === false)
+        return null;
+    const src = list === undefined ? defaults : list;
+    const exact = new Set();
+    const regexes = [];
+    for (const item of src) {
+        if (typeof item === 'string')
+            exact.add(item.toLowerCase());
+        else
+            regexes.push(item);
+    }
+    return { empty: exact.size === 0 && regexes.length === 0, exact, regexes };
+};
+exports.compileRedact = compileRedact;
+const matchesRedact = (key, compiled) => {
+    if (!compiled || compiled.empty)
+        return false;
+    const lower = key.toLowerCase();
+    if (compiled.exact.has(lower))
+        return true;
+    for (const rx of compiled.regexes) {
+        if (rx.test(key))
+            return true;
+    }
+    return false;
+};
+exports.matchesRedact = matchesRedact;
+/**
+ * Walk an object/array graph; replace value of any key matching a redact
+ * pattern with `[redacted]`. Preserves shape so caller still sees the field
+ * exists. Used by network for request/response bodies; also re-exported for
+ * `projectValue` which inlines the same matcher in its walk.
+ */
+const redactValue = (value, compiled) => {
+    if (!compiled || compiled.empty)
+        return value;
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => {
+            return (0, exports.redactValue)(item, compiled);
+        });
+    }
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+        out[key] = (0, exports.matchesRedact)(key, compiled) ? '[redacted]' : (0, exports.redactValue)(v, compiled);
+    }
+    return out;
+};
+exports.redactValue = redactValue;
+/**
+ * Redact a flat headers map (case-insensitive on key names).
+ */
+const redactHeaders = (headers, compiled) => {
+    if (!compiled || compiled.empty)
+        return headers;
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        out[key] = (0, exports.matchesRedact)(key, compiled) ? '[redacted]' : value;
+    }
+    return out;
+};
+exports.redactHeaders = redactHeaders;
+//# sourceMappingURL=redact.js.map

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

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