@mercuryo-ai/magicpay-home 0.1.8 → 0.1.11

package/README.md

@@ -2,28 +2,85 @@
 
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Shared configuration and state management for the MagicPay CLI family.
+Shared home directory and state contract 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
-CLIs:
+This package owns `~/.magicpay/`: the on-disk home directory where
+MagicPay's CLIs keep their config, browser session, workflow state, and
+related files. It is not a CLI of its own — it is consumed as a
+dependency by:
 
 - [`@mercuryo-ai/agentbrowse-cli`](https://www.npmjs.com/package/@mercuryo-ai/agentbrowse-cli) — browser automation
 - [`@mercuryo-ai/magicpay-cli`](https://www.npmjs.com/package/@mercuryo-ai/magicpay-cli) — protected-form fills
 - [`@mercuryo-ai/magicpay-agent-cli`](https://www.npmjs.com/package/@mercuryo-ai/magicpay-agent-cli) — combined browser + payment agent
 
-## Do I need to install this?
+## Do I Need To Install This?
 
-No. This package is pulled in automatically as a dependency of the CLIs above.
-You don't need to install or configure it directly.
+**No.** This package is pulled in automatically as a dependency of the CLIs
+above. You do not need to install or configure it directly.
 
-## What it provides
+## Why This Package Exists
 
-- Typed helpers for `~/.magicpay/config.json` (API key, endpoints, feature
-  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
+The underlying browser library [`@mercuryo-ai/agentbrowse`](https://www.npmjs.com/package/@mercuryo-ai/agentbrowse)
+stores its own state in `~/.agentbrowse/` by default. That default is the
+right behaviour for integrators who embed `@mercuryo-ai/agentbrowse` into
+their own product under their own brand.
+
+MagicPay is one such integrator. To keep configuration, browser state,
+and workflow state together under a single directory, `magicpay-home`:
+
+1. Defines the MagicPay home directory at `~/.magicpay/`.
+2. Overrides the `@mercuryo-ai/agentbrowse` storage hook so the browser
+   library writes into `~/.magicpay/` instead of `~/.agentbrowse/` when
+   any MagicPay CLI is running.
+3. Provides typed helpers for the MagicPay-specific files in that same
+   directory (config, workflow state, update-check state, etc.).
+
+If you build your own product on top of `@mercuryo-ai/agentbrowse`, you
+can apply the same pattern with your own home directory name.
+
+## Directory Layout
+
+All paths are relative to `~/.magicpay/` (or the OS equivalent of
+`homedir() + "/.magicpay/"`).
+
+| Path | Owner | Purpose | Written by |
+| --- | --- | --- | --- |
+| `config.json` | `magicpay-home` | Shared config: gateway (`apiKey`, `apiUrl`), browser defaults (profile, headless, proxy), updates policy. | `init` on any CLI. |
+| `browser-session.json` | `@mercuryo-ai/agentbrowse` (via override) | CDP endpoint and browser session state so `launch` / `attach` persist across processes. | Every CLI that touches the browser — `agentbrowse-cli`, `magicpay-agent-cli`. |
+| `workflow-state.json` | `magicpay-home` | In-flight protected-form workflow state (open-data snapshot, cached transient secrets, current step). | `magicpay-cli` and `magicpay-agent-cli` only. |
+| `update-state.json` | `magicpay-home` | Last CLI update-check timestamp and cached result. | Any CLI that runs the update check. |
+| `mock-stored-secrets.json` | `magicpay-home` | Development-only mock vault items. Not used in production. | Only when the CLI is run in mock mode. |
+| `mock-secret-requests.json` | `magicpay-home` | Development-only mock secret-request log. Not used in production. | Only when the CLI is run in mock mode. |
+| `profiles/` | `@mercuryo-ai/agentbrowse` (via override) | Per-profile browser user-data directories (cookies, localStorage, cache). | `launch` when a named profile is used. |
+| `runs/` | `magicpay-home` | Per-run telemetry and artefacts. | Any CLI run that records run telemetry. |
+
+Rules of thumb when debugging:
+
+- **Safe to delete to reset auth:** `config.json`. The next `init` re-creates it.
+- **Safe to delete to reset the browser session:** `browser-session.json`.
+  Next `launch` / `attach` starts fresh.
+- **Safe to delete to reset an in-flight workflow:** `workflow-state.json`.
+  Any active `magicpay` / `magicpay-agent` session is lost; the next
+  `start-session` begins clean.
+- **Do not hand-edit** any of these files — they are managed by the CLIs
+  and may be rewritten at any moment.
+
+## What The Package Provides
+
+- Typed helpers for reading and writing `config.json`
+  (`readMagicPayConfig`, `writeMagicPayConfig`, `doctorMagicPayConfig`).
+- Path helpers for every file and directory above (`getMagicPayHomeDir`,
+  `getMagicPayConfigPath`, `getMagicPayBrowserSessionPath`, etc.).
+- Workflow-state helpers for the in-flight protected-form session
+  (`loadWorkflowContext`, `saveWorkflowContext`, `clearWorkflowState`).
+- Browser-session helpers (`loadMagicPayBrowserSession`,
+  `saveMagicPayBrowserSession`, `deleteMagicPayBrowserSession`) that also
+  install the `@mercuryo-ai/agentbrowse` storage override so both packages
+  read and write the same file.
+- CLI update-check helper (`checkForPackageUpdate`) with state persisted
+  in `update-state.json`.
+- Safe concurrent writes so several MagicPay CLIs can run in the same
+  process or side-by-side without corrupting shared files.
 
 ## 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 MagicPayBrowserSessionCapabilities, type MagicPayBrowserSessionState, 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, supportsMagicPayCaptchaSolve, withMagicPayCaptchaCapability, } 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,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,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,EACnB,4BAA4B,EAC5B,6BAA6B,GAC9B,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, supportsMagicPayCaptchaSolve, withMagicPayCaptchaCapability, } 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,30 @@ export interface MagicPayWorkflowContext {
     secretCatalogByHost?: Record<string, SecretCatalog>;
     secretRequestSnapshots?: Record<string, SecretRequestSnapshot>;
     transientSecretCache?: Record<string, CachedTransientSecretEntry>;
+    openDataSnapshot?: SessionOpenDataSnapshot;
+}
+export interface MagicPayBrowserSessionCapabilities {
+    captchaSolve?: boolean;
+}
+export interface MagicPayBrowserSessionState extends BrowserSessionState {
+    capabilities?: MagicPayBrowserSessionCapabilities;
 }
-export interface MagicPaySession extends BrowserSessionState, MagicPayWorkflowContext {
+export interface MagicPaySession extends MagicPayBrowserSessionState, MagicPayWorkflowContext {
 }
+export declare function withMagicPayCaptchaCapability<T extends BrowserSessionState>(session: T, captchaSolve?: boolean): T & MagicPayBrowserSessionState;
+export declare function supportsMagicPayCaptchaSolve(session: MagicPayBrowserSessionState | BrowserSessionState | null | undefined): boolean;
+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;
@@ -36,8 +83,8 @@ export declare function clearWorkflowState(session: MagicPaySession): MagicPaySe
 export declare function loadWorkflowContext(): MagicPayWorkflowContext | null;
 export declare function saveWorkflowContext(context: MagicPayWorkflowContext): void;
 export declare function deleteWorkflowContext(): void;
-export declare function saveMagicPayBrowserSession(session: BrowserSessionState): void;
-export declare function loadMagicPayBrowserSession(): BrowserSessionState | null;
+export declare function saveMagicPayBrowserSession(session: MagicPayBrowserSessionState): void;
+export declare function loadMagicPayBrowserSession(): MagicPayBrowserSessionState | null;
 export declare function deleteMagicPayBrowserSession(): void;
 export declare function saveMagicPaySession(session: MagicPaySession): void;
 export declare function loadMagicPaySession(): MagicPaySession | null;

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,kCAAkC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,YAAY,CAAC,EAAE,kCAAkC,CAAC;CACnD;AAED,MAAM,WAAW,eAAgB,SAAQ,2BAA2B,EAAE,uBAAuB;CAAG;AAEhG,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,mBAAmB,EACzE,OAAO,EAAE,CAAC,EACV,YAAY,UAAO,GAClB,CAAC,GAAG,2BAA2B,CASjC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,2BAA2B,GAAG,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC5E,OAAO,CAET;AAwJD,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,2BAA2B,GAAG,IAAI,CAErF;AAED,wBAAgB,0BAA0B,IAAI,2BAA2B,GAAG,IAAI,CAE/E;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,193 @@
 import { createBrowserSessionStore, resolveBrowserSessionId, } from '@mercuryo-ai/agentbrowse';
 import { deleteFileIfExists, atomicWriteJson, readJsonFile } from './fs.js';
 import { MAGICPAY_BROWSER_SESSION_FILENAME, getMagicPayHomeDir, getMagicPayWorkflowStatePath, } from './paths.js';
+export function withMagicPayCaptchaCapability(session, captchaSolve = true) {
+    const currentCapabilities = session.capabilities;
+    return {
+        ...session,
+        capabilities: {
+            ...(currentCapabilities ?? {}),
+            captchaSolve,
+        },
+    };
+}
+export function supportsMagicPayCaptchaSolve(session) {
+    return session?.capabilities?.captchaSolve === true;
+}
+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 +249,8 @@ export function buildWorkflowContextForPersistence(session, resolvedBrowserSessi
             session.intentSessionId ||
             session.currentRequestId ||
             session.lastKnownStatus ||
-            session.transientSecretCache) &&
+            session.transientSecretCache ||
+            session.openDataSnapshot) &&
             resolvedBrowserSessionId
             ? { browserSessionId: resolvedBrowserSessionId }
             : {}),
@@ -76,6 +264,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 +283,7 @@ export function clearWorkflowState(session) {
     delete nextSession.secretCatalogByHost;
     delete nextSession.secretRequestSnapshots;
     delete nextSession.transientSecretCache;
+    delete nextSession.openDataSnapshot;
     return nextSession;
 }
 export function loadWorkflowContext() {
@@ -115,7 +305,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 +318,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.11",
   "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.63",
+    "@mercuryo-ai/magicpay-sdk": "0.1.3"
   },
   "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",