@mercuryo-ai/magicpay-home 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# @mercuryo-ai/magicpay-home
+
+Shared local home/config/state runtime contract for the MagicPay product CLIs.
+
+This package is a runtime helper dependency for:
+
+- `@mercuryo-ai/agentbrowse-cli`
+- `@mercuryo-ai/magicpay-cli`
+- `@mercuryo-ai/magicpay-agent-cli`
+
+It owns the shared `~/.magicpay` filesystem contract and exposes typed helpers
+for config paths, persisted browser session state, workflow state, and atomic
+filesystem writes.
+
+This package is not an end-user CLI and is not meant to be installed directly
+for standalone usage. It exists so the public CLI packages can consume one
+shared runtime contract without copying local-home logic into multiple packages.

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+import { getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath } from './paths.js';
+export type MagicPayBrowserWindowMode = 'compact' | 'full';
+export interface MagicPayBrowserProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+}
+export type MagicPayBrowserProxySetting = string | MagicPayBrowserProxyConfig | null;
+export interface MagicPaySharedConfig {
+    gateway?: {
+        apiKey?: string;
+        apiUrl?: string;
+    };
+    browser?: {
+        defaultProfile?: string;
+        headless?: boolean;
+        proxy?: MagicPayBrowserProxySetting;
+        window?: {
+            mode?: MagicPayBrowserWindowMode;
+        };
+    };
+    updates?: {
+        checkForCliUpdates?: boolean;
+    };
+}
+export declare function readMagicPayConfig(): MagicPaySharedConfig;
+export declare function writeMagicPayConfig(config: MagicPaySharedConfig): void;
+export declare function getMagicPayBrowserDefaults(): {
+    profile?: string;
+    headless?: boolean;
+    proxy?: MagicPayBrowserProxySetting;
+    windowMode?: MagicPayBrowserWindowMode;
+};
+export declare function loadGatewayConfig(): {
+    apiKey?: string;
+    apiUrl?: string;
+};
+export { getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,2BAA2B,CAAC;QACpC,MAAM,CAAC,EAAE;YACP,IAAI,CAAC,EAAE,yBAAyB,CAAC;SAClC,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AA4HD,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAEtE;AAED,wBAAgB,0BAA0B,IAAI;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC,CAUA;AAED,wBAAgB,iBAAiB,IAAI;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAMA;AAED,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC3B,CAAC"}

package/dist/config.js

@@ -0,0 +1,119 @@
+import { getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, } from './paths.js';
+import { atomicWriteJson, readJsonFile } from './fs.js';
+function trimOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeProxySetting(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const server = trimOptionalString(Reflect.get(value, 'server'));
+    if (!server) {
+        return undefined;
+    }
+    const username = trimOptionalString(Reflect.get(value, 'username'));
+    const passwordValue = Reflect.get(value, 'password');
+    const password = typeof passwordValue === 'string' ? passwordValue : passwordValue === undefined ? undefined : '';
+    return {
+        server,
+        ...(username ? { username } : {}),
+        ...(password ? { password } : {}),
+    };
+}
+function normalizeConfig(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {};
+    }
+    const gatewaySource = Reflect.get(raw, 'gateway') && typeof Reflect.get(raw, 'gateway') === 'object'
+        ? Reflect.get(raw, 'gateway')
+        : undefined;
+    const legacySource = Reflect.get(raw, 'magicpay') && typeof Reflect.get(raw, 'magicpay') === 'object'
+        ? Reflect.get(raw, 'magicpay')
+        : undefined;
+    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;
+    const gatewayApiKey = trimOptionalString(gatewaySource?.apiKey) ?? trimOptionalString(legacySource?.apiKey);
+    const gatewayApiUrl = trimOptionalString(gatewaySource?.apiUrl) ?? trimOptionalString(legacySource?.apiUrl);
+    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;
+    return {
+        ...(gatewayApiKey || gatewayApiUrl
+            ? {
+                gateway: {
+                    ...(gatewayApiKey ? { apiKey: gatewayApiKey } : {}),
+                    ...(gatewayApiUrl ? { apiUrl: gatewayApiUrl } : {}),
+                },
+            }
+            : {}),
+        ...(browserDefaultProfile !== undefined ||
+            browserHeadless !== undefined ||
+            browserProxy !== undefined ||
+            browserWindowMode !== undefined
+            ? {
+                browser: {
+                    ...(browserDefaultProfile ? { defaultProfile: browserDefaultProfile } : {}),
+                    ...(browserHeadless !== undefined ? { headless: browserHeadless } : {}),
+                    ...(browserProxy !== undefined ? { proxy: browserProxy } : {}),
+                    ...(browserWindowMode ? { window: { mode: browserWindowMode } } : {}),
+                },
+            }
+            : {}),
+        ...(checkForCliUpdates !== undefined
+            ? {
+                updates: {
+                    checkForCliUpdates,
+                },
+            }
+            : {}),
+    };
+}
+export function readMagicPayConfig() {
+    return normalizeConfig(readJsonFile(getMagicPayConfigPath()));
+}
+export function writeMagicPayConfig(config) {
+    atomicWriteJson(getMagicPayConfigPath(), normalizeConfig(config));
+}
+export function getMagicPayBrowserDefaults() {
+    const config = readMagicPayConfig();
+    return {
+        ...(config.browser?.defaultProfile ? { profile: config.browser.defaultProfile } : {}),
+        ...(typeof config.browser?.headless === 'boolean'
+            ? { 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() {
+    const config = readMagicPayConfig();
+    return {
+        ...(config.gateway?.apiKey ? { apiKey: config.gateway.apiKey } : {}),
+        ...(config.gateway?.apiUrl ? { apiUrl: config.gateway.apiUrl } : {}),
+    };
+}
+export { getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, };

package/dist/fs.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureMagicPayHomeDir(): string;
+export declare function ensureParentDir(filePath: string): void;
+export declare function atomicWriteText(filePath: string, contents: string): void;
+export declare function atomicWriteJson(filePath: string, value: unknown): void;
+export declare function readJsonFile<T>(filePath: string): T | null;
+export declare function deleteFileIfExists(filePath: string): void;
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAaA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUxE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEtE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAU1D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIzD"}

package/dist/fs.js

@@ -0,0 +1,42 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { getMagicPayHomeDir } from './paths.js';
+export function ensureMagicPayHomeDir() {
+    const homeDir = getMagicPayHomeDir();
+    mkdirSync(homeDir, { recursive: true });
+    return homeDir;
+}
+export function ensureParentDir(filePath) {
+    mkdirSync(dirname(filePath), { recursive: true });
+}
+export function atomicWriteText(filePath, contents) {
+    ensureParentDir(filePath);
+    const tempPath = `${filePath}.${process.pid}.tmp`;
+    try {
+        writeFileSync(tempPath, contents, 'utf-8');
+        renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        rmSync(tempPath, { force: true });
+        throw error;
+    }
+}
+export function atomicWriteJson(filePath, value) {
+    atomicWriteText(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+export function readJsonFile(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteFileIfExists(filePath) {
+    if (existsSync(filePath)) {
+        unlinkSync(filePath);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type MagicPayBrowserProxyConfig, type MagicPayBrowserProxySetting, type MagicPayBrowserWindowMode, type MagicPaySharedConfig, getMagicPayBrowserDefaults, getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, loadGatewayConfig, 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,oBAAoB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,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"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { getMagicPayBrowserDefaults, getMagicPayConfigPath, getMagicPayHomeDir, getMagicPayProfilesDir, getMagicPayUpdateStatePath, loadGatewayConfig, 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';

package/dist/paths.d.ts

@@ -0,0 +1,19 @@
+export declare const MAGICPAY_HOME_DIRNAME = ".magicpay";
+export declare const MAGICPAY_CONFIG_FILENAME = "config.json";
+export declare const MAGICPAY_BROWSER_SESSION_FILENAME = "browser-session.json";
+export declare const MAGICPAY_WORKFLOW_STATE_FILENAME = "workflow-state.json";
+export declare const MAGICPAY_MOCK_STORED_SECRETS_FILENAME = "mock-stored-secrets.json";
+export declare const MAGICPAY_MOCK_SECRET_REQUESTS_FILENAME = "mock-secret-requests.json";
+export declare const MAGICPAY_UPDATE_STATE_FILENAME = "update-state.json";
+export declare const MAGICPAY_PROFILES_DIRNAME = "profiles";
+export declare const MAGICPAY_RUNS_DIRNAME = "runs";
+export declare function getMagicPayHomeDir(): string;
+export declare function getMagicPayConfigPath(): string;
+export declare function getMagicPayBrowserSessionPath(): string;
+export declare function getMagicPayWorkflowStatePath(): string;
+export declare function getMagicPayMockStoredSecretsPath(): string;
+export declare function getMagicPayMockSecretRequestsPath(): string;
+export declare function getMagicPayUpdateStatePath(): string;
+export declare function getMagicPayProfilesDir(): string;
+export declare function getMagicPayRunsDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,cAAc,CAAC;AACjD,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AACtD,eAAO,MAAM,iCAAiC,yBAAyB,CAAC;AACxE,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AACtE,eAAO,MAAM,qCAAqC,6BAA6B,CAAC;AAChF,eAAO,MAAM,sCAAsC,8BAA8B,CAAC;AAClF,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAClE,eAAO,MAAM,yBAAyB,aAAa,CAAC;AACpD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD;AAED,wBAAgB,iCAAiC,IAAI,MAAM,CAE1D;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/paths.js

@@ -0,0 +1,38 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const MAGICPAY_HOME_DIRNAME = '.magicpay';
+export const MAGICPAY_CONFIG_FILENAME = 'config.json';
+export const MAGICPAY_BROWSER_SESSION_FILENAME = 'browser-session.json';
+export const MAGICPAY_WORKFLOW_STATE_FILENAME = 'workflow-state.json';
+export const MAGICPAY_MOCK_STORED_SECRETS_FILENAME = 'mock-stored-secrets.json';
+export const MAGICPAY_MOCK_SECRET_REQUESTS_FILENAME = 'mock-secret-requests.json';
+export const MAGICPAY_UPDATE_STATE_FILENAME = 'update-state.json';
+export const MAGICPAY_PROFILES_DIRNAME = 'profiles';
+export const MAGICPAY_RUNS_DIRNAME = 'runs';
+export function getMagicPayHomeDir() {
+    return join(homedir(), MAGICPAY_HOME_DIRNAME);
+}
+export function getMagicPayConfigPath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_CONFIG_FILENAME);
+}
+export function getMagicPayBrowserSessionPath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_BROWSER_SESSION_FILENAME);
+}
+export function getMagicPayWorkflowStatePath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_WORKFLOW_STATE_FILENAME);
+}
+export function getMagicPayMockStoredSecretsPath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_MOCK_STORED_SECRETS_FILENAME);
+}
+export function getMagicPayMockSecretRequestsPath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_MOCK_SECRET_REQUESTS_FILENAME);
+}
+export function getMagicPayUpdateStatePath() {
+    return join(getMagicPayHomeDir(), MAGICPAY_UPDATE_STATE_FILENAME);
+}
+export function getMagicPayProfilesDir() {
+    return join(getMagicPayHomeDir(), MAGICPAY_PROFILES_DIRNAME);
+}
+export function getMagicPayRunsDir() {
+    return join(getMagicPayHomeDir(), MAGICPAY_RUNS_DIRNAME);
+}

package/dist/workflow-state.d.ts

@@ -0,0 +1,44 @@
+import type { SecretCatalog, SecretRequestSnapshot } from '@mercuryo-ai/magicpay-sdk';
+import { type BrowserSessionState } from '@mercuryo-ai/agentbrowse';
+export interface CachedTransientSecretEntry {
+    requestId: string;
+    fillRef: string;
+    storedSecretRef: string;
+    cachedAt: string;
+    approvedAt?: string;
+    expiresAt?: string;
+    values: Record<string, string>;
+}
+export interface MagicPayWorkflowContext {
+    browserSessionId?: string;
+    activeRunId?: string;
+    intentSessionId?: string;
+    currentRequestId?: string;
+    lastKnownStatus?: string;
+    lastEventSeq?: number;
+    secretCatalogByHost?: Record<string, SecretCatalog>;
+    secretRequestSnapshots?: Record<string, SecretRequestSnapshot>;
+    transientSecretCache?: Record<string, CachedTransientSecretEntry>;
+}
+export interface MagicPaySession extends BrowserSessionState, MagicPayWorkflowContext {
+}
+export declare function cleanupTransientSecretCache(session: MagicPayWorkflowContext, options?: {
+    now?: string;
+}): boolean;
+export declare function cacheTransientSecret(session: MagicPayWorkflowContext, entry: CachedTransientSecretEntry): CachedTransientSecretEntry;
+export declare function getCachedTransientSecret(session: MagicPayWorkflowContext, requestId: string, options?: {
+    now?: string;
+}): CachedTransientSecretEntry | null;
+export declare function deleteCachedTransientSecret(session: MagicPayWorkflowContext, requestId: string): boolean;
+export declare function buildWorkflowContextForPersistence(session: MagicPayWorkflowContext, resolvedBrowserSessionId: string): MagicPayWorkflowContext | null;
+export declare function canHydrateWorkflowContext(resolvedBrowserSessionId: string, workflowContext: MagicPayWorkflowContext): boolean;
+export declare function clearWorkflowState(session: MagicPaySession): MagicPaySession;
+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 deleteMagicPayBrowserSession(): void;
+export declare function saveMagicPaySession(session: MagicPaySession): void;
+export declare function loadMagicPaySession(): MagicPaySession | null;
+//# sourceMappingURL=workflow-state.d.ts.map

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

@@ -0,0 +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"}

package/dist/workflow-state.js

@@ -0,0 +1,170 @@
+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 getMagicPayBrowserSessionStore() {
+    return createBrowserSessionStore({
+        rootDir: getMagicPayHomeDir(),
+        sessionFileName: MAGICPAY_BROWSER_SESSION_FILENAME,
+    });
+}
+function isExpired(expiresAt, now) {
+    if (!expiresAt) {
+        return false;
+    }
+    return new Date(expiresAt).getTime() <= new Date(now).getTime();
+}
+export function cleanupTransientSecretCache(session, options = {}) {
+    const cache = session.transientSecretCache;
+    if (!cache) {
+        return false;
+    }
+    const now = options.now ?? new Date().toISOString();
+    let changed = false;
+    for (const [requestId, entry] of Object.entries(cache)) {
+        if (isExpired(entry.expiresAt, now)) {
+            delete cache[requestId];
+            changed = true;
+        }
+    }
+    if (Object.keys(cache).length === 0) {
+        delete session.transientSecretCache;
+        changed = true;
+    }
+    return changed;
+}
+export function cacheTransientSecret(session, entry) {
+    cleanupTransientSecretCache(session);
+    const cache = (session.transientSecretCache ??= {});
+    cache[entry.requestId] = {
+        ...entry,
+        values: { ...entry.values },
+    };
+    return cache[entry.requestId];
+}
+export function getCachedTransientSecret(session, requestId, options = {}) {
+    cleanupTransientSecretCache(session, options);
+    return session.transientSecretCache?.[requestId] ?? null;
+}
+export function deleteCachedTransientSecret(session, requestId) {
+    const cache = session.transientSecretCache;
+    if (!cache?.[requestId]) {
+        return false;
+    }
+    delete cache[requestId];
+    if (Object.keys(cache).length === 0) {
+        delete session.transientSecretCache;
+    }
+    return true;
+}
+export function buildWorkflowContextForPersistence(session, resolvedBrowserSessionId) {
+    const workflowContext = {
+        ...((session.activeRunId ||
+            session.intentSessionId ||
+            session.currentRequestId ||
+            session.lastKnownStatus ||
+            session.transientSecretCache) &&
+            resolvedBrowserSessionId
+            ? { browserSessionId: resolvedBrowserSessionId }
+            : {}),
+        ...(session.activeRunId ? { activeRunId: session.activeRunId } : {}),
+        ...(session.intentSessionId ? { intentSessionId: session.intentSessionId } : {}),
+        ...(session.currentRequestId ? { currentRequestId: session.currentRequestId } : {}),
+        ...(session.lastKnownStatus ? { lastKnownStatus: session.lastKnownStatus } : {}),
+        ...(typeof session.lastEventSeq === 'number' ? { lastEventSeq: session.lastEventSeq } : {}),
+        ...(session.secretCatalogByHost ? { secretCatalogByHost: session.secretCatalogByHost } : {}),
+        ...(session.secretRequestSnapshots
+            ? { secretRequestSnapshots: session.secretRequestSnapshots }
+            : {}),
+        ...(session.transientSecretCache ? { transientSecretCache: session.transientSecretCache } : {}),
+    };
+    return Object.keys(workflowContext).length > 0 ? workflowContext : null;
+}
+export function canHydrateWorkflowContext(resolvedBrowserSessionId, workflowContext) {
+    return (!workflowContext.browserSessionId ||
+        workflowContext.browserSessionId === resolvedBrowserSessionId);
+}
+export function clearWorkflowState(session) {
+    const nextSession = { ...session };
+    delete nextSession.browserSessionId;
+    delete nextSession.activeRunId;
+    delete nextSession.intentSessionId;
+    delete nextSession.currentRequestId;
+    delete nextSession.lastKnownStatus;
+    delete nextSession.lastEventSeq;
+    delete nextSession.secretCatalogByHost;
+    delete nextSession.secretRequestSnapshots;
+    delete nextSession.transientSecretCache;
+    return nextSession;
+}
+export function loadWorkflowContext() {
+    return readJsonFile(getMagicPayWorkflowStatePath());
+}
+export function saveWorkflowContext(context) {
+    atomicWriteJson(getMagicPayWorkflowStatePath(), context);
+}
+export function deleteWorkflowContext() {
+    deleteFileIfExists(getMagicPayWorkflowStatePath());
+}
+export function saveMagicPayBrowserSession(session) {
+    getMagicPayBrowserSessionStore().save(session);
+}
+export function loadMagicPayBrowserSession() {
+    return getMagicPayBrowserSessionStore().load();
+}
+export function deleteMagicPayBrowserSession() {
+    getMagicPayBrowserSessionStore().delete();
+}
+function splitSessionForPersistence(session) {
+    const { browserSessionId, activeRunId, intentSessionId, currentRequestId, lastKnownStatus, lastEventSeq, secretCatalogByHost, secretRequestSnapshots, transientSecretCache, ...browserSession } = session;
+    return {
+        browserSession: browserSession,
+        workflowContext: buildWorkflowContextForPersistence({
+            browserSessionId,
+            activeRunId,
+            intentSessionId,
+            currentRequestId,
+            lastKnownStatus,
+            lastEventSeq,
+            secretCatalogByHost,
+            secretRequestSnapshots,
+            transientSecretCache,
+        }, resolveBrowserSessionId(browserSession)),
+    };
+}
+export function saveMagicPaySession(session) {
+    const { browserSession, workflowContext } = splitSessionForPersistence(session);
+    saveMagicPayBrowserSession(browserSession);
+    if (workflowContext) {
+        saveWorkflowContext(workflowContext);
+    }
+    else {
+        deleteWorkflowContext();
+    }
+}
+export function loadMagicPaySession() {
+    const browserSession = loadMagicPayBrowserSession();
+    if (!browserSession) {
+        return null;
+    }
+    try {
+        const workflowContext = loadWorkflowContext();
+        const resolvedBrowserSessionId = resolveBrowserSessionId(browserSession);
+        const session = {
+            ...browserSession,
+            ...(workflowContext && canHydrateWorkflowContext(resolvedBrowserSessionId, workflowContext)
+                ? workflowContext
+                : {}),
+        };
+        if (workflowContext && !canHydrateWorkflowContext(resolvedBrowserSessionId, workflowContext)) {
+            saveMagicPaySession(browserSession);
+        }
+        const changed = cleanupTransientSecretCache(session);
+        if (changed) {
+            saveMagicPaySession(session);
+        }
+        return session;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mercuryo-ai/magicpay-home",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Internal shared local home/config/state contract for MagicPay product CLIs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nuanu-ai/mercuryo-agent-pay.git",
+    "directory": "packages/magicpay-home"
+  },
+  "bugs": {
+    "url": "https://github.com/nuanu-ai/mercuryo-agent-pay/issues"
+  },
+  "homepage": "https://github.com/nuanu-ai/mercuryo-agent-pay/tree/main/packages/magicpay-home",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mercuryo-ai/agentbrowse": "0.2.50",
+    "@mercuryo-ai/magicpay-sdk": "0.1.0-test.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "5.9.2",
+    "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",
+    "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",
+    "test": "npm run test:deps && vitest run",
+    "test:deps": "pnpm --dir ../.. --filter @mercuryo-ai/agentbrowse build && pnpm --dir ../.. --filter @mercuryo-ai/magicpay-sdk build"
+  }
+}