@farmslot/protocol 0.75.0 → 0.77.0

package/dist/surfaces/view-state.d.ts

@@ -0,0 +1,50 @@
+/** Persistent display choices. Contexts declare fields; platform adapters own navigation. */
+export type ViewStateHistory = 'push' | 'replace';
+export interface ViewStateField<T> {
+    readonly key: string;
+    read(params: URLSearchParams): T;
+    write(params: URLSearchParams, value: T): void;
+}
+export interface ViewStateValues {
+    get<T>(field: ViewStateField<T>): T;
+    set<T>(field: ViewStateField<T>, value: NoInfer<T>): void;
+}
+export interface ViewStateAdapter {
+    read(): URLSearchParams;
+    write(params: URLSearchParams, history: ViewStateHistory): void;
+    subscribe(listener: () => void): () => void;
+}
+export interface ViewStateContext {
+    get<T>(field: ViewStateField<T>): T;
+    set<T>(field: ViewStateField<T>, value: NoInfer<T>, history?: ViewStateHistory): void;
+    update(edit: (values: ViewStateValues) => void, history?: ViewStateHistory): void;
+    snapshot(): string;
+    subscribe(listener: () => void): () => void;
+}
+export declare function viewStateParams(source: URLSearchParams, edit: (values: ViewStateValues) => void): URLSearchParams;
+export declare function createViewStateContext(adapter: ViewStateAdapter): ViewStateContext;
+export declare function viewTextField(key: string, defaultValue?: string): ViewStateField<string>;
+export declare function viewChoiceField<T extends string>(key: string, defaultValue: T, choices: readonly T[]): ViewStateField<T>;
+export declare function viewListField(key: string, defaultValue?: readonly string[], encoding?: 'repeat' | 'csv'): ViewStateField<readonly string[]>;
+/** A compact collection contains only toggles that differ from their context's defaults. */
+export declare function viewToggleField(key: string, id: string, defaultValue: boolean): ViewStateField<boolean>;
+/** Router adapters use the same repeated-value representation as browser query strings. */
+export declare function viewStateSearchParams(values: Readonly<Record<string, string | readonly string[] | undefined>>): URLSearchParams;
+/** Undefined entries remove old route parameters when a configured default is restored. */
+export declare function viewStateRoutePatch(before: URLSearchParams, next: URLSearchParams): Record<string, string | string[] | undefined>;
+export declare function viewNullableTextField(key: string): ViewStateField<string | null>;
+export declare function viewIntegerField(key: string, defaultValue?: number): ViewStateField<number>;
+/** Explicit per-entry overrides, such as opened/closed folds whose default depends on data. */
+export declare function viewToggleMapField(key: string): ViewStateField<Readonly<Record<string, boolean>>>;
+/** A status-derived default may change; an explicit disclosure choice must survive it. */
+export declare function viewToggleOverrideField(key: string, id: string, defaultValue: boolean): ViewStateField<boolean>;
+/** Display parameters carried across sibling workspace tabs; no action or authority inputs. */
+export declare const VIEW_STATE_PARAMETERS: ReadonlySet<string>;
+export declare function selectedViewStateParams(params: Readonly<Record<string, string | readonly string[] | undefined>>): Record<string, string | string[]>;
+/** An explicit new selection has its own index; reloading the same selection keeps it. */
+export declare function viewScopedIntegerField(key: string, scopeKey: string, scope: string, defaultValue?: number): ViewStateField<number>;
+/** Explicit destination selectors win; current display options survive narrowed selections. */
+export declare function mergeViewStateParams<T extends object>(params: Readonly<Record<string, string | readonly string[] | undefined>>, destination: T): {
+    [x: string]: string | string[];
+} & T;
+//# sourceMappingURL=view-state.d.ts.map

package/dist/surfaces/view-state.d.ts.map

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

package/dist/surfaces/view-state.js

@@ -0,0 +1,181 @@
+export function viewStateParams(source, edit) {
+    const params = new URLSearchParams(source);
+    edit({
+        get: (field) => field.read(params),
+        set: (field, value) => field.write(params, value),
+    });
+    return params;
+}
+export function createViewStateContext(adapter) {
+    const update = (edit, history = 'push') => {
+        const before = adapter.read();
+        const next = viewStateParams(before, edit);
+        if (before.toString() !== next.toString())
+            adapter.write(next, history);
+    };
+    return {
+        get: (field) => field.read(adapter.read()),
+        set: (field, value, history) => update((values) => values.set(field, value), history),
+        update,
+        snapshot: () => adapter.read().toString(),
+        subscribe: (listener) => adapter.subscribe(listener),
+    };
+}
+export function viewTextField(key, defaultValue = '') {
+    return {
+        key,
+        read: (params) => params.get(key) ?? defaultValue,
+        write: (params, value) => {
+            if (value === defaultValue)
+                params.delete(key);
+            else
+                params.set(key, value);
+        },
+    };
+}
+export function viewChoiceField(key, defaultValue, choices) {
+    return {
+        ...viewTextField(key, defaultValue),
+        read: (params) => choices.find((choice) => choice === params.get(key)) ?? defaultValue,
+    };
+}
+export function viewListField(key, defaultValue = [], encoding = 'repeat') {
+    return {
+        key,
+        read: (params) => {
+            if (!params.has(key))
+                return [...defaultValue];
+            const values = params.getAll(key);
+            return (encoding === 'csv' ? values.flatMap((value) => value.split(',')) : values).filter((value) => value !== '');
+        },
+        write: (params, values) => {
+            params.delete(key);
+            if (values.length === defaultValue.length &&
+                values.every((value, i) => value === defaultValue[i]))
+                return;
+            if (!values.length)
+                params.set(key, '');
+            else if (encoding === 'csv')
+                params.set(key, values.join(','));
+            else
+                for (const value of values)
+                    params.append(key, value);
+        },
+    };
+}
+/** A compact collection contains only toggles that differ from their context's defaults. */
+export function viewToggleField(key, id, defaultValue) {
+    const entries = viewListField(key, [], 'csv');
+    const entryId = id.replaceAll('%', '%25').replaceAll(',', '%2C');
+    return {
+        key,
+        read: (params) => {
+            for (const value of entries.read(params).slice().reverse()) {
+                if (value === entryId)
+                    return true;
+                if (value === `!${entryId}`)
+                    return false;
+            }
+            return defaultValue;
+        },
+        write: (params, value) => {
+            const values = entries
+                .read(params)
+                .filter((entry) => entry !== entryId && entry !== `!${entryId}`);
+            if (value !== defaultValue)
+                values.push(value ? entryId : `!${entryId}`);
+            entries.write(params, [...new Set(values)].sort());
+        },
+    };
+}
+/** Router adapters use the same repeated-value representation as browser query strings. */
+export function viewStateSearchParams(values) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(values)) {
+        if (typeof value === 'string')
+            params.append(key, value);
+        else
+            for (const item of value ?? [])
+                params.append(key, item);
+    }
+    return params;
+}
+/** Undefined entries remove old route parameters when a configured default is restored. */
+export function viewStateRoutePatch(before, next) {
+    const patch = {};
+    for (const key of new Set([...before.keys(), ...next.keys()])) {
+        const values = next.getAll(key);
+        patch[key] = values.length > 1 ? values : values[0];
+    }
+    return patch;
+}
+export function viewNullableTextField(key) {
+    const text = viewTextField(key);
+    return {
+        key,
+        read: (params) => text.read(params) || null,
+        write: (params, value) => text.write(params, value ?? ''),
+    };
+}
+export function viewIntegerField(key, defaultValue = 0) {
+    const text = viewTextField(key, String(defaultValue));
+    return {
+        key,
+        read: (params) => {
+            const value = Number(text.read(params));
+            return Number.isSafeInteger(value) && value >= 0 ? value : defaultValue;
+        },
+        write: (params, value) => text.write(params, String(value)),
+    };
+}
+/** Explicit per-entry overrides, such as opened/closed folds whose default depends on data. */
+export function viewToggleMapField(key) {
+    const list = viewListField(key, [], 'csv');
+    return {
+        key,
+        read: (params) => Object.fromEntries(list
+            .read(params)
+            .map((entry) => entry.startsWith('!')
+            ? [entry.slice(1).replaceAll('%2C', ',').replaceAll('%25', '%'), false]
+            : [entry.replaceAll('%2C', ',').replaceAll('%25', '%'), true])),
+        write: (params, values) => list.write(params, Object.entries(values)
+            .map(([id, value]) => value
+            ? id.replaceAll('%', '%25').replaceAll(',', '%2C')
+            : `!${id.replaceAll('%', '%25').replaceAll(',', '%2C')}`)
+            .sort()),
+    };
+}
+/** A status-derived default may change; an explicit disclosure choice must survive it. */
+export function viewToggleOverrideField(key, id, defaultValue) {
+    const field = viewToggleMapField(key);
+    return {
+        key,
+        read: (params) => field.read(params)[id] ?? defaultValue,
+        write: (params, value) => field.write(params, { ...field.read(params), [id]: value }),
+    };
+}
+/** Display parameters carried across sibling workspace tabs; no action or authority inputs. */
+export const VIEW_STATE_PARAMETERS = new Set('panels round step section runsTab flow lane sort q tag workers treeOpen branchFilesView branchFilesClosed changesView changesClosed problemSource commentFilter commentAuthor commentThread logFilter compareStep workerSession expandedSlot messages turnFiles rawClaims prReviews prMonitors folds terminalView reviewReport stage delivery diffMode devicePanes deviceLayout sidebarWidth diffFilter diffQuery diffPath mobileDiffMode claims evidenceFilter compareIndex mediaIndex mediaSource prFilter subtasks mediaGroups familyCompareIndex assessmentConsumer finetuneProject flowNode nativeFilesTab nativeDirectory nativeFile nativeFileView projects machines'.split(' '));
+export function selectedViewStateParams(params) {
+    return Object.fromEntries(Object.entries(params).flatMap(([key, value]) => VIEW_STATE_PARAMETERS.has(key) && value !== undefined
+        ? [[key, typeof value === 'string' ? value : [...value]]]
+        : []));
+}
+/** An explicit new selection has its own index; reloading the same selection keeps it. */
+export function viewScopedIntegerField(key, scopeKey, scope, defaultValue = 0) {
+    const index = viewIntegerField(key, defaultValue);
+    const owner = viewTextField(scopeKey);
+    return {
+        key,
+        read: (params) => (owner.read(params) === scope ? index.read(params) : defaultValue),
+        write: (params, value) => {
+            index.write(params, value);
+            owner.write(params, value === defaultValue ? '' : scope);
+        },
+    };
+}
+/** Explicit destination selectors win; current display options survive narrowed selections. */
+export function mergeViewStateParams(params, destination) {
+    return { ...selectedViewStateParams(params), ...destination };
+}
+//# sourceMappingURL=view-state.js.map

package/dist/surfaces/view-state.js.map

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

package/dist/transport/gateway-recovery.d.ts

@@ -0,0 +1,39 @@
+/** One retry/liveness policy; platforms supply sockets and lifecycle/network wake events. */
+export type GatewayRecoveryState = 'connecting' | 'connected' | 'disconnected';
+export interface GatewayRecoveryOptions {
+    enabled(): boolean;
+    connect(): void;
+    retire(): void;
+    canProbe(): boolean;
+    ping(): Promise<unknown>;
+    onResponse?(latencyMs: number, completedAt: number): void;
+}
+export declare const GATEWAY_HEARTBEAT_MS = 30000;
+export declare const GATEWAY_CONNECT_DEADLINE_MS = 20000;
+export declare const GATEWAY_PING_DEADLINE_MS = 5000;
+/** Network and RPC timeouts never revoke a saved login or its cached observations. */
+export declare function gatewayAuthenticationRefused(error: unknown): boolean;
+export declare const GATEWAY_OFFLINE_LABEL = "Gateway offline \u00B7 Reconnecting\u2026";
+export declare function gatewayOfflineLabel(state: string, enabled: boolean): string | undefined;
+export declare class GatewayRecovery {
+    private readonly options;
+    private state?;
+    private timer?;
+    private delay;
+    private generation;
+    private probing;
+    private disposed;
+    private lastWake;
+    constructor(options: GatewayRecoveryOptions);
+    update(state: GatewayRecoveryState): void;
+    /** Focus/visibility/network events bypass the wait, sharing one attempt or ping. */
+    wake(): void;
+    reset(): void;
+    dispose(): void;
+    private enabled;
+    private probe;
+    private fail;
+    private schedule;
+    private cancel;
+}
+//# sourceMappingURL=gateway-recovery.d.ts.map

package/dist/transport/gateway-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-recovery.d.ts","sourceRoot":"","sources":["../../src/transport/gateway-recovery.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,OAAO,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,UAAU,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAE9C,sFAAsF;AACtF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQpE;AAED,eAAO,MAAM,qBAAqB,8CAAoC,CAAC;AAEvE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED,qBAAa,eAAe;IASd,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,KAAK,CAAC,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAa;gBAEA,OAAO,EAAE,sBAAsB;IAE5D,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAoBzC,oFAAoF;IACpF,IAAI,IAAI,IAAI;IAYZ,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IA6Bb,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,MAAM;CAMf"}

package/dist/transport/gateway-recovery.js

@@ -0,0 +1,134 @@
+import { hasAuthErrorCode } from '../person-session-client.js';
+export const GATEWAY_HEARTBEAT_MS = 30_000;
+export const GATEWAY_CONNECT_DEADLINE_MS = 20_000;
+export const GATEWAY_PING_DEADLINE_MS = 5_000;
+/** Network and RPC timeouts never revoke a saved login or its cached observations. */
+export function gatewayAuthenticationRefused(error) {
+    return [
+        'AUTH_REQUIRED',
+        'AUTH_FAILED',
+        'AUTH_FORBIDDEN',
+        'AUTH_PERSON_SESSION_REQUIRED',
+        'AUTH_SESSION_ENDED',
+    ].some((code) => hasAuthErrorCode(error, code));
+}
+export const GATEWAY_OFFLINE_LABEL = 'Gateway offline · Reconnecting…';
+export function gatewayOfflineLabel(state, enabled) {
+    return enabled && state !== 'connected' ? GATEWAY_OFFLINE_LABEL : undefined;
+}
+export class GatewayRecovery {
+    constructor(options) {
+        this.options = options;
+        this.delay = 1000;
+        this.generation = 0;
+        this.probing = false;
+        this.disposed = false;
+        this.lastWake = -Infinity;
+    }
+    update(state) {
+        if (!this.enabled()) {
+            this.reset();
+            return;
+        }
+        if (state === this.state)
+            return;
+        this.cancel();
+        this.state = state;
+        if (state === 'connected') {
+            this.delay = 1000;
+            this.schedule(() => this.probe(), GATEWAY_HEARTBEAT_MS);
+        }
+        else if (state === 'connecting') {
+            this.schedule(() => this.fail(), GATEWAY_CONNECT_DEADLINE_MS);
+        }
+        else {
+            const delay = this.delay;
+            this.delay = Math.min(delay * 2, 30_000);
+            this.schedule(() => this.options.connect(), delay);
+        }
+    }
+    /** Focus/visibility/network events bypass the wait, sharing one attempt or ping. */
+    wake() {
+        if (!this.enabled() || this.state === 'connecting' || this.probing)
+            return;
+        if (Date.now() - this.lastWake < 1000)
+            return;
+        this.lastWake = Date.now();
+        if (this.state === 'connected')
+            this.probe();
+        else {
+            this.cancel();
+            this.state = undefined;
+            this.options.connect();
+        }
+    }
+    reset() {
+        this.cancel();
+        this.state = undefined;
+        this.delay = 1000;
+        this.lastWake = -Infinity;
+    }
+    dispose() {
+        this.disposed = true;
+        this.reset();
+    }
+    enabled() {
+        return !this.disposed && this.options.enabled();
+    }
+    probe() {
+        if (!this.enabled() || this.state !== 'connected' || this.probing)
+            return;
+        if (!this.options.canProbe()) {
+            this.schedule(() => this.probe(), GATEWAY_HEARTBEAT_MS);
+            return;
+        }
+        this.cancel();
+        this.probing = true;
+        const startedAt = Date.now();
+        this.lastWake = startedAt;
+        const generation = this.generation;
+        this.schedule(() => this.fail(), GATEWAY_PING_DEADLINE_MS);
+        void this.options.ping().then((reply) => {
+            if (generation !== this.generation || !this.enabled())
+                return;
+            if (!reply || typeof reply !== 'object' || Reflect.get(reply, 'ok') !== true) {
+                this.fail();
+                return;
+            }
+            this.probing = false;
+            this.schedule(() => this.probe(), GATEWAY_HEARTBEAT_MS);
+            this.options.onResponse?.(Date.now() - startedAt, Date.now());
+        }, () => {
+            if (generation === this.generation && this.enabled())
+                this.fail();
+        });
+    }
+    fail() {
+        if (!this.enabled())
+            return;
+        this.cancel();
+        this.state = undefined;
+        this.options.retire();
+    }
+    schedule(callback, delay) {
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        const generation = this.generation;
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            if (generation === this.generation && this.enabled())
+                callback();
+        }, delay);
+        // Passive recovery must not keep a non-browser host alive by itself.
+        if (typeof this.timer === 'object' && 'unref' in this.timer)
+            this.timer.unref();
+    }
+    cancel() {
+        this.generation++;
+        this.probing = false;
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=gateway-recovery.js.map

package/dist/transport/gateway-recovery.js.map

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

package/dist/utf8-byte-length.d.ts

@@ -0,0 +1,2 @@
+export declare function utf8ByteLength(value: string): number;
+//# sourceMappingURL=utf8-byte-length.d.ts.map

package/dist/utf8-byte-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8-byte-length.d.ts","sourceRoot":"","sources":["../src/utf8-byte-length.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBpD"}

package/dist/utf8-byte-length.js

@@ -0,0 +1,22 @@
+export function utf8ByteLength(value) {
+    let bytes = 0;
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x80)
+            bytes++;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code >= 0xd800 &&
+            code <= 0xdbff &&
+            i + 1 < value.length &&
+            value.charCodeAt(i + 1) >= 0xdc00 &&
+            value.charCodeAt(i + 1) <= 0xdfff) {
+            bytes += 4;
+            i++;
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+//# sourceMappingURL=utf8-byte-length.js.map

package/dist/utf8-byte-length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8-byte-length.js","sourceRoot":"","sources":["../src/utf8-byte-length.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,GAAG,IAAI;YAAE,KAAK,EAAE,CAAC;aACpB,IAAI,IAAI,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC7B,IACH,IAAI,IAAI,MAAM;YACd,IAAI,IAAI,MAAM;YACd,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM;YACpB,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM;YACjC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,EACjC,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,CAAC,EAAE,CAAC;QACN,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PROTOCOL_VERSION = "0.75.0";
+export declare const PROTOCOL_VERSION = "0.77.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -3,5 +3,5 @@
 // fleet can be upgraded deliberately; optional method/event fields remain
 // backward-compatible unless a caller requires a new node capability.
 // Format: semver-ish, increment when methods/events/frame format changes.
-export const PROTOCOL_VERSION = '0.75.0';
+export const PROTOCOL_VERSION = '0.77.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/protocol",
-  "version": "0.75.0",
+  "version": "0.77.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -391,6 +391,11 @@
     "./review-approval-policy.cjs": {
       "types": "./scripts/review-approval-policy.d.cts",
       "default": "./scripts/review-approval-policy.cjs"
+    },
+    "./performance": {
+      "types": "./dist/performance/index.d.ts",
+      "import": "./dist/performance/index.js",
+      "default": "./dist/performance/index.js"
     }
   },
   "scripts": {