@mercuryo-ai/magicpay-home 0.1.8 → 0.1.10

package/README.md

@@ -4,8 +4,8 @@
 
 Shared configuration and state management for the MagicPay CLI family.
 
-This package owns the `~/.magicpay` directory contract — configuration files,
-browser session state, and workflow persistence — used by all three MagicPay
+This package owns the `~/.magicpay` directory layout — configuration files,
+browser session state, and workflow persistence — shared by all three MagicPay
 CLIs:
 
 - [`@mercuryo-ai/agentbrowse-cli`](https://www.npmjs.com/package/@mercuryo-ai/agentbrowse-cli) — browser automation
@@ -23,7 +23,7 @@ You don't need to install or configure it directly.
   flags)
 - Browser session persistence across process restarts
 - Workflow state tracking for multi-step protected-form flows
-- Atomic filesystem writes to prevent corruption from concurrent CLI runs
+- Safe concurrent writes when multiple MagicPay CLIs run at once
 
 ## License
 

package/dist/cli-update-check.d.ts

@@ -0,0 +1,17 @@
+export type PackageUpdateCheckOptions = {
+    fetchImpl?: typeof fetch;
+    now?: Date;
+    timeoutMs?: number;
+    ttlMs?: number;
+    statePath?: string;
+};
+export declare function compareVersions(left: string, right: string): number;
+export declare function checkForPackageUpdate<T>(params: {
+    packageName: string;
+    currentVersion: string;
+    buildNotice: (input: {
+        currentVersion: string;
+        latestVersion: string;
+    }) => T;
+} & PackageUpdateCheckOptions): Promise<T | null>;
+//# sourceMappingURL=cli-update-check.d.ts.map

package/dist/cli-update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-update-check.d.ts","sourceRoot":"","sources":["../src/cli-update-check.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8DnE;AAED,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,MAAM,EAAE;IACN,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,KAAK,CAAC,CAAC;CAC9E,GAAG,yBAAyB,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA+BnB"}

package/dist/cli-update-check.js

@@ -0,0 +1,164 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { getMagicPayUpdateStatePath } from './paths.js';
+const DEFAULT_UPDATE_CHECK_TIMEOUT_MS = 1500;
+const DEFAULT_UPDATE_TTL_MS = 12 * 60 * 60 * 1000;
+export function compareVersions(left, right) {
+    const parsedLeft = parseVersion(left);
+    const parsedRight = parseVersion(right);
+    if (!parsedLeft || !parsedRight) {
+        return left.localeCompare(right, undefined, {
+            numeric: true,
+            sensitivity: 'base',
+        });
+    }
+    for (let i = 0; i < 3; i += 1) {
+        const diff = parsedLeft.core[i] - parsedRight.core[i];
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    if (!parsedLeft.prerelease && !parsedRight.prerelease) {
+        return 0;
+    }
+    if (!parsedLeft.prerelease) {
+        return 1;
+    }
+    if (!parsedRight.prerelease) {
+        return -1;
+    }
+    const length = Math.max(parsedLeft.prerelease.length, parsedRight.prerelease.length);
+    for (let i = 0; i < length; i += 1) {
+        const leftPart = parsedLeft.prerelease[i];
+        const rightPart = parsedRight.prerelease[i];
+        if (leftPart === undefined) {
+            return -1;
+        }
+        if (rightPart === undefined) {
+            return 1;
+        }
+        if (typeof leftPart === 'number' && typeof rightPart === 'number') {
+            const diff = leftPart - rightPart;
+            if (diff !== 0) {
+                return diff;
+            }
+            continue;
+        }
+        if (typeof leftPart === 'number') {
+            return -1;
+        }
+        if (typeof rightPart === 'number') {
+            return 1;
+        }
+        const diff = leftPart.localeCompare(rightPart);
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    return 0;
+}
+export async function checkForPackageUpdate(params) {
+    const now = params.now ?? new Date();
+    const ttlMs = params.ttlMs ?? DEFAULT_UPDATE_TTL_MS;
+    const statePath = params.statePath ?? getMagicPayUpdateStatePath();
+    const cachedState = readUpdateState(statePath, params.packageName);
+    const cachedNotice = buildPackageUpdateNotice(params.currentVersion, cachedState?.latestVersion, params.buildNotice);
+    if (cachedState && !isCacheStale(cachedState.lastCheckedAt, now, ttlMs)) {
+        return cachedNotice;
+    }
+    const latestVersion = await fetchLatestVersion(params.packageName, {
+        fetchImpl: params.fetchImpl,
+        timeoutMs: params.timeoutMs ?? DEFAULT_UPDATE_CHECK_TIMEOUT_MS,
+    }).catch(() => null);
+    if (!latestVersion) {
+        return cachedNotice;
+    }
+    writeUpdateState(statePath, {
+        packageName: params.packageName,
+        latestVersion,
+        lastCheckedAt: now.toISOString(),
+    });
+    return buildPackageUpdateNotice(params.currentVersion, latestVersion, params.buildNotice);
+}
+function parseVersion(version) {
+    const match = version
+        .trim()
+        .match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+.*)?$/);
+    if (!match) {
+        return null;
+    }
+    const prerelease = match[4]
+        ? match[4].split('.').map((part) => (/^\d+$/.test(part) ? Number(part) : part))
+        : null;
+    return {
+        core: [Number(match[1]), Number(match[2]), Number(match[3])],
+        prerelease,
+    };
+}
+function buildPackageUpdateNotice(currentVersion, latestVersion, buildNotice) {
+    if (!latestVersion || compareVersions(latestVersion, currentVersion) <= 0) {
+        return null;
+    }
+    return buildNotice({ currentVersion, latestVersion });
+}
+function readUpdateState(statePath, packageName) {
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(statePath, 'utf-8'));
+        if (raw.packageName !== packageName ||
+            typeof raw.latestVersion !== 'string' ||
+            typeof raw.lastCheckedAt !== 'string') {
+            return null;
+        }
+        return {
+            packageName: raw.packageName,
+            latestVersion: raw.latestVersion,
+            lastCheckedAt: raw.lastCheckedAt,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function writeUpdateState(statePath, state) {
+    mkdirSync(dirname(statePath), { recursive: true });
+    writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n', 'utf-8');
+}
+function isCacheStale(lastCheckedAt, now, ttlMs) {
+    const lastCheckedAtMs = new Date(lastCheckedAt).getTime();
+    if (!Number.isFinite(lastCheckedAtMs)) {
+        return true;
+    }
+    return now.getTime() - lastCheckedAtMs >= ttlMs;
+}
+async function fetchLatestVersion(packageName, options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== 'function') {
+        throw new Error('Global fetch is not available.');
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options.timeoutMs);
+    const registryMetadataUrl = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
+    try {
+        const response = await fetchImpl(registryMetadataUrl, {
+            headers: {
+                Accept: 'application/json',
+            },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Registry responded with ${response.status}.`);
+        }
+        const metadata = (await response.json());
+        const latestVersion = metadata['dist-tags']?.latest;
+        if (!latestVersion || typeof latestVersion !== 'string') {
+            throw new Error('Registry metadata does not include dist-tags.latest.');
+        }
+        return latestVersion;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}

package/dist/config.d.ts

@@ -1,5 +1,4 @@
 import { getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath } from './paths.js';
-export type MagicPayBrowserWindowMode = 'compact' | 'full';
 export interface MagicPayBrowserProxyConfig {
     server: string;
     username?: string;
@@ -15,9 +14,6 @@ export interface MagicPaySharedConfig {
         defaultProfile?: string;
         headless?: boolean;
         proxy?: MagicPayBrowserProxySetting;
-        window?: {
-            mode?: MagicPayBrowserWindowMode;
-        };
     };
     updates?: {
         checkForCliUpdates?: boolean;
@@ -65,7 +61,6 @@ export declare function getMagicPayBrowserDefaults(): {
     profile?: string;
     headless?: boolean;
     proxy?: MagicPayBrowserProxySetting;
-    windowMode?: MagicPayBrowserWindowMode;
 };
 export declare function loadGatewayConfig(): {
     apiKey?: string;

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -91,9 +91,6 @@ function normalizeConfig(raw) {
     const browserSource = Reflect.get(raw, 'browser') && typeof Reflect.get(raw, 'browser') === 'object'
         ? Reflect.get(raw, 'browser')
         : undefined;
-    const windowSource = browserSource?.window && typeof browserSource.window === 'object'
-        ? browserSource.window
-        : undefined;
     const updatesSource = Reflect.get(raw, 'updates') && typeof Reflect.get(raw, 'updates') === 'object'
         ? Reflect.get(raw, 'updates')
         : undefined;
@@ -102,9 +99,6 @@ function normalizeConfig(raw) {
     const browserDefaultProfile = trimOptionalString(browserSource?.defaultProfile);
     const browserHeadless = typeof browserSource?.headless === 'boolean' ? browserSource.headless : undefined;
     const browserProxy = normalizeProxySetting(browserSource?.proxy);
-    const browserWindowMode = windowSource?.mode === 'compact' || windowSource?.mode === 'full'
-        ? windowSource.mode
-        : undefined;
     const checkForCliUpdates = typeof updatesSource?.checkForCliUpdates === 'boolean'
         ? updatesSource.checkForCliUpdates
         : undefined;
@@ -119,14 +113,12 @@ function normalizeConfig(raw) {
             : {}),
         ...(browserDefaultProfile !== undefined ||
             browserHeadless !== undefined ||
-            browserProxy !== undefined ||
-            browserWindowMode !== undefined
+            browserProxy !== undefined
             ? {
                 browser: {
                     ...(browserDefaultProfile ? { defaultProfile: browserDefaultProfile } : {}),
                     ...(browserHeadless !== undefined ? { headless: browserHeadless } : {}),
                     ...(browserProxy !== undefined ? { proxy: browserProxy } : {}),
-                    ...(browserWindowMode ? { window: { mode: browserWindowMode } } : {}),
                 },
             }
             : {}),
@@ -317,7 +309,6 @@ export function getMagicPayBrowserDefaults() {
             ? { headless: config.browser.headless }
             : {}),
         ...(config.browser && 'proxy' in config.browser ? { proxy: config.browser.proxy } : {}),
-        ...(config.browser?.window?.mode ? { windowMode: config.browser.window.mode } : {}),
     };
 }
 export function loadGatewayConfig() {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export { type MagicPayBrowserProxyConfig, type MagicPayBrowserProxySetting, type MagicPayBrowserWindowMode, type MagicPayConfigDoctorConfigState, type MagicPayConfigDoctorFailure, type MagicPayConfigDoctorGatewayState, type MagicPayConfigDoctorIssue, type MagicPayConfigDoctorResult, type MagicPayConfigDoctorSuccess, type MagicPaySharedConfig, doctorMagicPayConfig, getMagicPayBrowserDefaults, getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, loadGatewayConfig, normalizeMagicPayApiUrl, readMagicPayConfig, writeMagicPayConfig, } from './config.js';
+export { compareVersions, checkForPackageUpdate, type PackageUpdateCheckOptions, } from './cli-update-check.js';
+export { type MagicPayBrowserProxyConfig, type MagicPayBrowserProxySetting, type MagicPayConfigDoctorConfigState, type MagicPayConfigDoctorFailure, type MagicPayConfigDoctorGatewayState, type MagicPayConfigDoctorIssue, type MagicPayConfigDoctorResult, type MagicPayConfigDoctorSuccess, type MagicPaySharedConfig, doctorMagicPayConfig, getMagicPayBrowserDefaults, getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, loadGatewayConfig, normalizeMagicPayApiUrl, readMagicPayConfig, writeMagicPayConfig, } from './config.js';
 export { deleteFileIfExists, ensureMagicPayHomeDir, ensureParentDir, atomicWriteJson, atomicWriteText, readJsonFile, } from './fs.js';
 export { MAGICPAY_BROWSER_SESSION_FILENAME, MAGICPAY_CONFIG_FILENAME, MAGICPAY_HOME_DIRNAME, MAGICPAY_MOCK_SECRET_REQUESTS_FILENAME, MAGICPAY_MOCK_STORED_SECRETS_FILENAME, MAGICPAY_PROFILES_DIRNAME, MAGICPAY_RUNS_DIRNAME, MAGICPAY_UPDATE_STATE_FILENAME, MAGICPAY_WORKFLOW_STATE_FILENAME, getMagicPayBrowserSessionPath, getMagicPayMockSecretRequestsPath, getMagicPayMockStoredSecretsPath, getMagicPayRunsDir, getMagicPayWorkflowStatePath, } from './paths.js';
-export { type CachedTransientSecretEntry, type MagicPaySession, type MagicPayWorkflowContext, buildWorkflowContextForPersistence, cacheTransientSecret, canHydrateWorkflowContext, cleanupTransientSecretCache, clearWorkflowState, deleteCachedTransientSecret, deleteMagicPayBrowserSession, deleteWorkflowContext, getCachedTransientSecret, loadMagicPayBrowserSession, loadMagicPaySession, loadWorkflowContext, saveMagicPayBrowserSession, saveMagicPaySession, saveWorkflowContext, } from './workflow-state.js';
+export { type CachedTransientSecretEntry, type MagicPaySession, type SessionOpenDataEntry, type SessionOpenDataFreshness, type SessionOpenDataProvenance, type SessionOpenDataSensitivity, type SessionOpenDataSnapshot, type SessionOpenDataSource, type MagicPayWorkflowContext, buildWorkflowContextForPersistence, cacheTransientSecret, canHydrateWorkflowContext, cleanupTransientSecretCache, clearWorkflowState, deleteCachedTransientSecret, deleteMagicPayBrowserSession, deleteWorkflowContext, getCachedTransientSecret, getSessionOpenDataValues, loadProfileFactsIntoOpenDataSnapshot, loadMagicPayBrowserSession, loadMagicPaySession, loadWorkflowContext, mergeSessionOpenDataValues, saveMagicPayBrowserSession, saveMagicPaySession, saveWorkflowContext, } from './workflow-state.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iCAAiC,EACjC,wBAAwB,EACxB,qBAAqB,EACrB,sCAAsC,EACtC,qCAAqC,EACrC,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,gCAAgC,EAChC,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,kCAAkC,EAClC,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iCAAiC,EACjC,wBAAwB,EACxB,qBAAqB,EACrB,sCAAsC,EACtC,qCAAqC,EACrC,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,gCAAgC,EAChC,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,kCAAkC,EAClC,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,oCAAoC,EACpC,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
+export { compareVersions, checkForPackageUpdate, } from './cli-update-check.js';
 export { doctorMagicPayConfig, getMagicPayBrowserDefaults, getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, loadGatewayConfig, normalizeMagicPayApiUrl, readMagicPayConfig, writeMagicPayConfig, } from './config.js';
 export { deleteFileIfExists, ensureMagicPayHomeDir, ensureParentDir, atomicWriteJson, atomicWriteText, readJsonFile, } from './fs.js';
 export { MAGICPAY_BROWSER_SESSION_FILENAME, MAGICPAY_CONFIG_FILENAME, MAGICPAY_HOME_DIRNAME, MAGICPAY_MOCK_SECRET_REQUESTS_FILENAME, MAGICPAY_MOCK_STORED_SECRETS_FILENAME, MAGICPAY_PROFILES_DIRNAME, MAGICPAY_RUNS_DIRNAME, MAGICPAY_UPDATE_STATE_FILENAME, MAGICPAY_WORKFLOW_STATE_FILENAME, getMagicPayBrowserSessionPath, getMagicPayMockSecretRequestsPath, getMagicPayMockStoredSecretsPath, getMagicPayRunsDir, getMagicPayWorkflowStatePath, } from './paths.js';
-export { buildWorkflowContextForPersistence, cacheTransientSecret, canHydrateWorkflowContext, cleanupTransientSecretCache, clearWorkflowState, deleteCachedTransientSecret, deleteMagicPayBrowserSession, deleteWorkflowContext, getCachedTransientSecret, loadMagicPayBrowserSession, loadMagicPaySession, loadWorkflowContext, saveMagicPayBrowserSession, saveMagicPaySession, saveWorkflowContext, } from './workflow-state.js';
+export { buildWorkflowContextForPersistence, cacheTransientSecret, canHydrateWorkflowContext, cleanupTransientSecretCache, clearWorkflowState, deleteCachedTransientSecret, deleteMagicPayBrowserSession, deleteWorkflowContext, getCachedTransientSecret, getSessionOpenDataValues, loadProfileFactsIntoOpenDataSnapshot, loadMagicPayBrowserSession, loadMagicPaySession, loadWorkflowContext, mergeSessionOpenDataValues, saveMagicPayBrowserSession, saveMagicPaySession, saveWorkflowContext, } from './workflow-state.js';

package/dist/workflow-state.d.ts

@@ -1,4 +1,4 @@
-import type { SecretCatalog, SecretRequestSnapshot } from '@mercuryo-ai/magicpay-sdk';
+import type { MagicPayProfileFacts, SecretCatalog, SecretRequestSnapshot } from '@mercuryo-ai/magicpay-sdk';
 import { type BrowserSessionState } from '@mercuryo-ai/agentbrowse';
 export interface CachedTransientSecretEntry {
     requestId: string;
@@ -9,6 +9,32 @@ export interface CachedTransientSecretEntry {
     expiresAt?: string;
     values: Record<string, string>;
 }
+export type SessionOpenDataSource = 'profile_facts' | 'session_open_value';
+export type SessionOpenDataFreshness = 'profile_snapshot' | 'session_learned';
+export type SessionOpenDataSensitivity = 'open' | 'protected';
+export interface SessionOpenDataProvenance {
+    kind: 'profile_facts' | 'data_resolve' | 'data_provide';
+    requestId?: string;
+}
+export interface SessionOpenDataEntry {
+    fieldKey: string;
+    value: string | number;
+    source: SessionOpenDataSource;
+    freshness: SessionOpenDataFreshness;
+    sensitivity: SessionOpenDataSensitivity;
+    applicability: {
+        target: 'global' | 'host';
+        value?: string;
+    };
+    updatedAt: string;
+    factsUpdatedAt?: string;
+    provenance: SessionOpenDataProvenance;
+}
+export interface SessionOpenDataSnapshot {
+    version: 1;
+    updatedAt: string;
+    valuesByField: Record<string, SessionOpenDataEntry[]>;
+}
 export interface MagicPayWorkflowContext {
     browserSessionId?: string;
     activeRunId?: string;
@@ -19,9 +45,22 @@ export interface MagicPayWorkflowContext {
     secretCatalogByHost?: Record<string, SecretCatalog>;
     secretRequestSnapshots?: Record<string, SecretRequestSnapshot>;
     transientSecretCache?: Record<string, CachedTransientSecretEntry>;
+    openDataSnapshot?: SessionOpenDataSnapshot;
 }
 export interface MagicPaySession extends BrowserSessionState, MagicPayWorkflowContext {
 }
+export declare function loadProfileFactsIntoOpenDataSnapshot(session: MagicPayWorkflowContext, profileFacts: MagicPayProfileFacts, options?: {
+    loadedAt?: string;
+}): SessionOpenDataSnapshot;
+export declare function mergeSessionOpenDataValues(session: MagicPayWorkflowContext, values: Record<string, unknown>, options?: {
+    host?: string;
+    updatedAt?: string;
+    provenance?: SessionOpenDataProvenance;
+    sensitivity?: SessionOpenDataSensitivity;
+}): SessionOpenDataSnapshot;
+export declare function getSessionOpenDataValues(session: MagicPayWorkflowContext, fieldKey: string, options?: {
+    host?: string;
+}): SessionOpenDataEntry[];
 export declare function cleanupTransientSecretCache(session: MagicPayWorkflowContext, options?: {
     now?: string;
 }): boolean;

package/dist/workflow-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-state.d.ts","sourceRoot":"","sources":["../src/workflow-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AASlC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB,EAAE,uBAAuB;CAAG;AAiBxF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAqBT;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,0BAA0B,GAChC,0BAA0B,CAQ5B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,0BAA0B,GAAG,IAAI,CAGnC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAYT;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,uBAAuB,EAChC,wBAAwB,EAAE,MAAM,GAC/B,uBAAuB,GAAG,IAAI,CAuBhC;AAED,wBAAgB,yBAAyB,CACvC,wBAAwB,EAAE,MAAM,EAChC,eAAe,EAAE,uBAAuB,GACvC,OAAO,CAKT;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAY5E;AAED,wBAAgB,mBAAmB,IAAI,uBAAuB,GAAG,IAAI,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE1E;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE7E;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,GAAG,IAAI,CAEvE;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAsCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAQlE;AAED,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CA6B5D"}
+{"version":3,"file":"workflow-state.d.ts","sourceRoot":"","sources":["../src/workflow-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AASlC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAC3E,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAC9E,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,wBAAwB,CAAC;IACpC,WAAW,EAAE,0BAA0B,CAAC;IACxC,aAAa,EAAE;QACb,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,yBAAyB,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAClE,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB,EAAE,uBAAuB;CAAG;AAwJxF,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,uBAAuB,EAChC,YAAY,EAAE,oBAAoB,EAClC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,uBAAuB,CAiCzB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,WAAW,CAAC,EAAE,0BAA0B,CAAC;CACrC,GACL,uBAAuB,CAgCzB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,oBAAoB,EAAE,CAexB;AAiBD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAqBT;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,0BAA0B,GAChC,0BAA0B,CAQ5B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,0BAA0B,GAAG,IAAI,CAGnC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAYT;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,uBAAuB,EAChC,wBAAwB,EAAE,MAAM,GAC/B,uBAAuB,GAAG,IAAI,CAyBhC;AAED,wBAAgB,yBAAyB,CACvC,wBAAwB,EAAE,MAAM,EAChC,eAAe,EAAE,uBAAuB,GACvC,OAAO,CAKT;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAa5E;AAED,wBAAgB,mBAAmB,IAAI,uBAAuB,GAAG,IAAI,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE1E;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE7E;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,GAAG,IAAI,CAEvE;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAwCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAQlE;AAED,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CA6B5D"}

package/dist/workflow-state.js

@@ -1,6 +1,180 @@
 import { createBrowserSessionStore, resolveBrowserSessionId, } from '@mercuryo-ai/agentbrowse';
 import { deleteFileIfExists, atomicWriteJson, readJsonFile } from './fs.js';
 import { MAGICPAY_BROWSER_SESSION_FILENAME, getMagicPayHomeDir, getMagicPayWorkflowStatePath, } from './paths.js';
+function isSupportedOpenDataValue(value) {
+    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));
+}
+function cloneOpenDataEntry(entry) {
+    return {
+        ...entry,
+        applicability: { ...entry.applicability },
+        provenance: { ...entry.provenance },
+    };
+}
+function cloneOpenDataSnapshot(snapshot) {
+    return {
+        version: 1,
+        updatedAt: snapshot.updatedAt,
+        valuesByField: Object.fromEntries(Object.entries(snapshot.valuesByField).map(([fieldKey, entries]) => [
+            fieldKey,
+            entries.map((entry) => cloneOpenDataEntry(entry)),
+        ])),
+    };
+}
+function normalizeOpenDataFieldKey(fieldKey) {
+    return fieldKey.trim();
+}
+function normalizeScopeValue(value) {
+    return value?.trim().toLowerCase() ?? '';
+}
+function openDataScopeRank(entry, host) {
+    if (entry.applicability.target === 'host') {
+        return normalizeScopeValue(entry.applicability.value) === normalizeScopeValue(host) ? 4 : 1;
+    }
+    return 2;
+}
+function openDataSourceRank(source) {
+    return source === 'session_open_value' ? 2 : 1;
+}
+function openDataFreshnessRank(freshness) {
+    return freshness === 'session_learned' ? 2 : 1;
+}
+function compareOpenDataEntries(left, right, host) {
+    const scopeRank = openDataScopeRank(right, host) - openDataScopeRank(left, host);
+    if (scopeRank !== 0) {
+        return scopeRank;
+    }
+    const sourceRank = openDataSourceRank(right.source) - openDataSourceRank(left.source);
+    if (sourceRank !== 0) {
+        return sourceRank;
+    }
+    const freshnessRank = openDataFreshnessRank(right.freshness) - openDataFreshnessRank(left.freshness);
+    if (freshnessRank !== 0) {
+        return freshnessRank;
+    }
+    return right.updatedAt.localeCompare(left.updatedAt);
+}
+function openDataEntryIdentity(entry) {
+    return [
+        normalizeOpenDataFieldKey(entry.fieldKey),
+        entry.applicability.target,
+        normalizeScopeValue(entry.applicability.value),
+        entry.value,
+    ].join('::');
+}
+function pruneEmptyOpenDataFields(snapshot) {
+    for (const [fieldKey, entries] of Object.entries(snapshot.valuesByField)) {
+        if (entries.length === 0) {
+            delete snapshot.valuesByField[fieldKey];
+        }
+    }
+}
+function assignOpenDataSnapshot(session, snapshot) {
+    pruneEmptyOpenDataFields(snapshot);
+    if (Object.keys(snapshot.valuesByField).length === 0) {
+        delete session.openDataSnapshot;
+        return {
+            version: 1,
+            updatedAt: snapshot.updatedAt,
+            valuesByField: {},
+        };
+    }
+    session.openDataSnapshot = snapshot;
+    return snapshot;
+}
+function ensureOpenDataSnapshot(session, updatedAt) {
+    const current = session.openDataSnapshot ? cloneOpenDataSnapshot(session.openDataSnapshot) : null;
+    return (current ?? {
+        version: 1,
+        updatedAt,
+        valuesByField: {},
+    });
+}
+function insertOpenDataEntries(snapshot, entries, host) {
+    for (const entry of entries) {
+        const fieldKey = normalizeOpenDataFieldKey(entry.fieldKey);
+        if (!fieldKey) {
+            continue;
+        }
+        const nextEntry = cloneOpenDataEntry({
+            ...entry,
+            fieldKey,
+        });
+        const existingEntries = snapshot.valuesByField[fieldKey] ?? [];
+        const dedupeKey = openDataEntryIdentity(nextEntry);
+        const nextEntries = existingEntries
+            .filter((existing) => openDataEntryIdentity(existing) !== dedupeKey)
+            .concat(nextEntry)
+            .sort((left, right) => compareOpenDataEntries(left, right, host));
+        snapshot.valuesByField[fieldKey] = nextEntries;
+    }
+}
+export function loadProfileFactsIntoOpenDataSnapshot(session, profileFacts, options = {}) {
+    const loadedAt = options.loadedAt ?? new Date().toISOString();
+    const snapshot = ensureOpenDataSnapshot(session, loadedAt);
+    for (const [fieldKey, entries] of Object.entries(snapshot.valuesByField)) {
+        snapshot.valuesByField[fieldKey] = entries.filter((entry) => entry.source !== 'profile_facts');
+    }
+    pruneEmptyOpenDataFields(snapshot);
+    insertOpenDataEntries(snapshot, Object.entries(profileFacts.facts)
+        .filter((entry) => isSupportedOpenDataValue(entry[1]))
+        .map(([fieldKey, value]) => ({
+        fieldKey,
+        value,
+        source: 'profile_facts',
+        freshness: 'profile_snapshot',
+        sensitivity: 'open',
+        applicability: {
+            target: 'global',
+        },
+        updatedAt: loadedAt,
+        factsUpdatedAt: profileFacts.updatedAt,
+        provenance: {
+            kind: 'profile_facts',
+        },
+    })), undefined);
+    snapshot.updatedAt = loadedAt;
+    return assignOpenDataSnapshot(session, snapshot);
+}
+export function mergeSessionOpenDataValues(session, values, options = {}) {
+    const updatedAt = options.updatedAt ?? new Date().toISOString();
+    const snapshot = ensureOpenDataSnapshot(session, updatedAt);
+    insertOpenDataEntries(snapshot, Object.entries(values)
+        .filter((entry) => isSupportedOpenDataValue(entry[1]))
+        .map(([fieldKey, value]) => ({
+        fieldKey,
+        value,
+        source: 'session_open_value',
+        freshness: 'session_learned',
+        sensitivity: options.sensitivity ?? 'open',
+        applicability: options.host
+            ? {
+                target: 'host',
+                value: options.host,
+            }
+            : {
+                target: 'global',
+            },
+        updatedAt,
+        provenance: options.provenance ?? {
+            kind: 'data_resolve',
+        },
+    })), options.host);
+    snapshot.updatedAt = updatedAt;
+    return assignOpenDataSnapshot(session, snapshot);
+}
+export function getSessionOpenDataValues(session, fieldKey, options = {}) {
+    const normalizedFieldKey = normalizeOpenDataFieldKey(fieldKey);
+    if (!normalizedFieldKey) {
+        return [];
+    }
+    const entries = session.openDataSnapshot?.valuesByField[normalizedFieldKey] ?? [];
+    return entries
+        .filter((entry) => entry.applicability.target === 'global' ||
+        normalizeScopeValue(entry.applicability.value) === normalizeScopeValue(options.host))
+        .sort((left, right) => compareOpenDataEntries(left, right, options.host))
+        .map((entry) => cloneOpenDataEntry(entry));
+}
 function getMagicPayBrowserSessionStore() {
     return createBrowserSessionStore({
         rootDir: getMagicPayHomeDir(),
@@ -62,7 +236,8 @@ export function buildWorkflowContextForPersistence(session, resolvedBrowserSessi
             session.intentSessionId ||
             session.currentRequestId ||
             session.lastKnownStatus ||
-            session.transientSecretCache) &&
+            session.transientSecretCache ||
+            session.openDataSnapshot) &&
             resolvedBrowserSessionId
             ? { browserSessionId: resolvedBrowserSessionId }
             : {}),
@@ -76,6 +251,7 @@ export function buildWorkflowContextForPersistence(session, resolvedBrowserSessi
             ? { secretRequestSnapshots: session.secretRequestSnapshots }
             : {}),
         ...(session.transientSecretCache ? { transientSecretCache: session.transientSecretCache } : {}),
+        ...(session.openDataSnapshot ? { openDataSnapshot: session.openDataSnapshot } : {}),
     };
     return Object.keys(workflowContext).length > 0 ? workflowContext : null;
 }
@@ -94,6 +270,7 @@ export function clearWorkflowState(session) {
     delete nextSession.secretCatalogByHost;
     delete nextSession.secretRequestSnapshots;
     delete nextSession.transientSecretCache;
+    delete nextSession.openDataSnapshot;
     return nextSession;
 }
 export function loadWorkflowContext() {
@@ -115,7 +292,7 @@ export function deleteMagicPayBrowserSession() {
     getMagicPayBrowserSessionStore().delete();
 }
 function splitSessionForPersistence(session) {
-    const { browserSessionId, activeRunId, intentSessionId, currentRequestId, lastKnownStatus, lastEventSeq, secretCatalogByHost, secretRequestSnapshots, transientSecretCache, ...browserSession } = session;
+    const { browserSessionId, activeRunId, intentSessionId, currentRequestId, lastKnownStatus, lastEventSeq, secretCatalogByHost, secretRequestSnapshots, transientSecretCache, openDataSnapshot, ...browserSession } = session;
     return {
         browserSession: browserSession,
         workflowContext: buildWorkflowContextForPersistence({
@@ -128,6 +305,7 @@ function splitSessionForPersistence(session) {
             secretCatalogByHost,
             secretRequestSnapshots,
             transientSecretCache,
+            openDataSnapshot,
         }, resolveBrowserSessionId(browserSession)),
     };
 }

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@mercuryo-ai/magicpay-home",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
   "license": "MIT",
   "description": "Internal shared local home/config/state contract for MagicPay product CLIs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
     "dist",
     "README.md"
@@ -14,8 +20,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mercuryo-ai/agentbrowse": "0.2.57",
-    "@mercuryo-ai/magicpay-sdk": "0.1.1"
+    "@mercuryo-ai/agentbrowse": "0.2.60",
+    "@mercuryo-ai/magicpay-sdk": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -23,7 +29,7 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "pnpm --dir ../.. --filter @mercuryo-ai/agentbrowse build && pnpm --dir ../.. --filter @mercuryo-ai/magicpay-sdk build && node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\" && tsc -p tsconfig.build.json",
+    "build": "pnpm --dir ../.. --filter @mercuryo-ai/agentbrowse build && pnpm --dir ../.. --filter @mercuryo-ai/magicpay-sdk build && node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true, maxRetries: 10, retryDelay: 50 })\" && tsc -p tsconfig.build.json",
     "check-types": "pnpm --dir ../.. --filter @mercuryo-ai/agentbrowse build && pnpm --dir ../.. --filter @mercuryo-ai/magicpay-sdk build && tsc --noEmit",
     "pack:verify": "node scripts/verify-pack-artifact.mjs",
     "smoke:pack-install": "node scripts/verify-pack-install-smoke.mjs",