@mercuryo-ai/magicpay-cli 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @mercuryo-ai/magicpay-cli
+
+Payment-only MagicPay CLI for session, secrets, and protected-form completion.
+
+`magicpay` is the payment-only MagicPay CLI surface for:
+
+- gateway setup and health checks;
+- workflow session lifecycle;
+- secret catalog, request, poll, protected fill, and guarded submit/observe flow;
+- narrow browser attachment and protected-form completion on an already prepared page.
+
+## Install
+
+```bash
+npm i -g @mercuryo-ai/magicpay-cli
+magicpay --help
+```
+
+## Current surface
+
+- `init`
+- `status`
+- `attach`
+- `start-session`
+- `end-session`
+- `find-form`
+- `get-secrets-catalog`
+- `request-secret`
+- `mock-approve-secret`
+- `mock-deny-secret`
+- `poll-secret`
+- `fill-secret`
+- `submit-form`
+
+Browser attach happens over CDP:
+
+- `magicpay attach <cdp-url>`
+
+`magicpay fill-secret` now performs a post-fill refresh, auto-submits when it
+can resolve one live form-bound submit control, and returns a follow-up observe
+result when submission happens. `submit-form` remains available as a manual
+recovery surface.
+
+`magicpay status` stays quiet about CLI updates by default. When a newer npm
+release is available, it includes a short English notice and the suggested
+update command.
+
+## Architecture boundary
+
+- `magicpay` is the operator CLI for workflow sessions, approvals, protected
+  secret handling, and narrow form completion on the current page.
+- `@mercuryo-ai/agentbrowse` owns browser primitives and the reusable browser
+  session store API.
+- `@mercuryo-ai/magicpay-sdk` owns reusable MagicPay API and flow helpers.
+- `@mercuryo-ai/magicpay-cli` owns branded payment CLI orchestration and the
+  payment-safe command UX on top of the shared `~/.magicpay` home.

package/dist/agentbrowse-assistive.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureMagicPayAgentbrowseAssistiveRuntime(): void;
+//# sourceMappingURL=agentbrowse-assistive.d.ts.map

package/dist/agentbrowse-assistive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentbrowse-assistive.d.ts","sourceRoot":"","sources":["../src/agentbrowse-assistive.ts"],"names":[],"mappings":"AAqEA,wBAAgB,yCAAyC,IAAI,IAAI,CAWhE"}

package/dist/agentbrowse-assistive.js

@@ -0,0 +1,66 @@
+import { configureAgentbrowseAssistiveRuntime, configureAgentbrowseDiagnostics, } from '@mercuryo-ai/agentbrowse';
+import { tryResolveMagicPayGatewayConfig } from './gateway.js';
+import { exportRunStepToOtlpHttpJsonBestEffort } from './otel-exporter.js';
+import { appendStepChildSpan, finishRunStep, startRunStep } from './run-store.js';
+import { MagicPayAssistiveLlmClient } from './assistive-llm-client.js';
+const agentbrowseDiagnostics = {
+    startStep(input) {
+        if (!input.runId) {
+            return null;
+        }
+        const step = startRunStep({
+            runId: input.runId,
+            command: input.command,
+            ...(input.input ? { input: input.input } : {}),
+            ...(input.refs ? { refs: input.refs } : {}),
+            ...(input.protectedStep ? { protectedStep: true } : {}),
+        });
+        if (!step) {
+            return null;
+        }
+        return {
+            runId: step.runId,
+            stepId: step.stepId,
+            command: input.command,
+        };
+    },
+    async finishStep(input) {
+        if (!input.step) {
+            return;
+        }
+        finishRunStep({
+            runId: input.step.runId,
+            stepId: input.step.stepId,
+            success: input.success,
+            ...(input.outcomeType ? { outcomeType: input.outcomeType } : {}),
+            ...(input.message ? { message: input.message } : {}),
+            ...(input.reason ? { reason: input.reason } : {}),
+        });
+        await exportRunStepToOtlpHttpJsonBestEffort(input.step.runId, input.step.stepId);
+    },
+    recordChildSpan(input) {
+        if (!input.step) {
+            return;
+        }
+        appendStepChildSpan({
+            runId: input.step.runId,
+            stepId: input.step.stepId,
+            name: input.name,
+            startedAt: input.startedAt,
+            endedAt: input.endedAt,
+            statusCode: input.statusCode,
+            ...(input.kind ? { kind: input.kind } : {}),
+            ...(input.statusMessage ? { statusMessage: input.statusMessage } : {}),
+            ...(input.attributes ? { attributes: input.attributes } : {}),
+        });
+    },
+};
+export function ensureMagicPayAgentbrowseAssistiveRuntime() {
+    const gateway = tryResolveMagicPayGatewayConfig();
+    configureAgentbrowseAssistiveRuntime(gateway
+        ? {
+            createLlmClient: () => new MagicPayAssistiveLlmClient(gateway),
+        }
+        : null);
+    configureAgentbrowseDiagnostics(agentbrowseDiagnostics);
+}

package/dist/assistive-llm-client.d.ts

@@ -0,0 +1,13 @@
+import { LLMClient } from '@browserbasehq/stagehand';
+import { type AgentbrowseAssistiveChatCompletionRequest, type AgentbrowseAssistiveChatCompletionResult } from '@mercuryo-ai/agentbrowse';
+import type { MagicPayGatewayConfig } from './gateway.js';
+export declare class MagicPayAssistiveLlmClient extends LLMClient {
+    private readonly gateway;
+    type: "magicpay";
+    hasVision: boolean;
+    clientOptions: {};
+    constructor(gateway: MagicPayGatewayConfig);
+    createChatCompletion<T = unknown>(args: unknown): Promise<any>;
+    createAssistiveChatCompletion<T = unknown>(args: AgentbrowseAssistiveChatCompletionRequest): Promise<AgentbrowseAssistiveChatCompletionResult<T>>;
+}
+//# sourceMappingURL=assistive-llm-client.d.ts.map

package/dist/assistive-llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistive-llm-client.d.ts","sourceRoot":"","sources":["../src/assistive-llm-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAEV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,yCAAyC,EAC9C,KAAK,wCAAwC,EAE9C,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAmG1D,qBAAa,0BAA2B,SAAQ,SAAS;IAK3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ3B,IAAI,EAAG,UAAU,CAAU;IAC3B,SAAS,UAAQ;IACjB,aAAa,KAAM;gBAEC,OAAO,EAAE,qBAAqB;IAIrD,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAmG9D,6BAA6B,CAAC,CAAC,GAAG,OAAO,EAC7C,IAAI,EAAE,yCAAyC,GAC9C,OAAO,CAAC,wCAAwC,CAAC,CAAC,CAAC,CAAC;CASxD"}

package/dist/assistive-llm-client.js

@@ -0,0 +1,152 @@
+import { LLMClient, toJsonSchema, } from '@browserbasehq/stagehand';
+import { AssistiveStructuredOutputTruncatedError, } from '@mercuryo-ai/agentbrowse';
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function gatewayBaseUrl(gateway) {
+    return gateway.apiUrl.replace(/\/$/, '');
+}
+function isRetryableStatus(status) {
+    return status === 429 || status === 502 || status === 503 || status === 504 || status >= 500;
+}
+function buildMessages(options) {
+    const messages = [...options.messages];
+    if (!options.image) {
+        return messages;
+    }
+    const content = [];
+    if (options.image.description?.trim()) {
+        content.push({ type: 'text', text: options.image.description.trim() });
+    }
+    content.push({
+        type: 'image_url',
+        image_url: {
+            url: `data:image/jpeg;base64,${options.image.buffer.toString('base64')}`,
+            detail: 'auto',
+        },
+    });
+    messages.push({
+        role: 'user',
+        content,
+    });
+    return messages;
+}
+async function withRetry(fn, retries = 1) {
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const retryable = err instanceof Error &&
+                (err.name === 'RetryableHttpError' || err.name === 'RetryableNetworkError');
+            if (!retryable || attempt >= retries) {
+                throw err;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 2_000 * (attempt + 1)));
+        }
+    }
+}
+export class MagicPayAssistiveLlmClient extends LLMClient {
+    gateway;
+    type = 'magicpay';
+    hasVision = true;
+    clientOptions = {};
+    constructor(gateway) {
+        super('magicpay/backend');
+        this.gateway = gateway;
+    }
+    async createChatCompletion(args) {
+        const request = args;
+        const { options } = request;
+        if (!options?.response_model) {
+            throw new Error('MagicPay assistive client currently requires response_model');
+        }
+        const url = `${gatewayBaseUrl(this.gateway)}/v1/chat/completions`;
+        const body = {
+            model: 'magicpay',
+            messages: buildMessages(options),
+            response_format: {
+                type: 'json_schema',
+                json_schema: {
+                    name: options.response_model.name,
+                    strict: true,
+                    schema: toJsonSchema(options.response_model.schema),
+                },
+            },
+            temperature: options.temperature,
+            max_completion_tokens: options.maxOutputTokens,
+        };
+        const result = await withRetry(async () => {
+            let response;
+            try {
+                response = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Bearer ${this.gateway.apiKey}`,
+                        Accept: 'application/json',
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(body),
+                    signal: AbortSignal.timeout(45_000),
+                });
+            }
+            catch (err) {
+                const error = new Error(`MagicPay assistive runtime network error: ${err instanceof Error ? err.message : String(err)}`);
+                error.name = 'RetryableNetworkError';
+                throw error;
+            }
+            let json;
+            try {
+                json = (await response.json());
+            }
+            catch {
+                const parseError = new Error(`MagicPay assistive runtime returned non-JSON response (${response.status})`);
+                parseError.name = isRetryableStatus(response.status) ? 'RetryableHttpError' : 'HttpError';
+                throw parseError;
+            }
+            if (!response.ok) {
+                const message = typeof json.error === 'string' ? json.error : `HTTP ${response.status}`;
+                const structuredError = json;
+                if (structuredError.error_code === 'structured_output_truncated') {
+                    throw new AssistiveStructuredOutputTruncatedError(`MagicPay assistive runtime error (${response.status}): ${message}`, {
+                        status: response.status,
+                        provider: readString(structuredError.provider),
+                        model: readString(structuredError.model),
+                        finishReason: readString(structuredError.finish_reason),
+                        maxOutputTokens: readNumber(structuredError.max_output_tokens),
+                        completionTokens: readNumber(structuredError.completion_tokens),
+                    });
+                }
+                const error = new Error(`MagicPay assistive runtime error (${response.status}): ${message}`);
+                error.name = isRetryableStatus(response.status) ? 'RetryableHttpError' : 'HttpError';
+                throw error;
+            }
+            return json;
+        });
+        const structuredResult = result;
+        const content = structuredResult.choices?.[0]?.message?.content;
+        if (typeof content !== 'string' || content.trim().length === 0) {
+            throw new Error('MagicPay assistive runtime response missing assistant content');
+        }
+        let data;
+        try {
+            data = JSON.parse(content);
+        }
+        catch {
+            throw new Error('MagicPay assistive runtime returned invalid JSON assistant content');
+        }
+        return {
+            data,
+            usage: structuredResult.usage,
+        };
+    }
+    async createAssistiveChatCompletion(args) {
+        if (!args.options.response_model) {
+            throw new Error('MagicPay assistive client currently requires response_model');
+        }
+        return (await this.createChatCompletion(args));
+    }
+}

package/dist/browser-bridge/act.d.ts

@@ -0,0 +1,5 @@
+import { isBrowseAction, type ActResult, type BrowserSessionState, type BrowseAction } from '@mercuryo-ai/agentbrowse';
+export { isBrowseAction };
+export type { ActResult, BrowseAction };
+export declare function act(session: BrowserSessionState, targetRef: string, action: BrowseAction, value?: string): Promise<ActResult>;
+//# sourceMappingURL=act.d.ts.map

package/dist/browser-bridge/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/browser-bridge/act.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAExC,wBAAsB,GAAG,CACvB,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CAIpB"}

package/dist/browser-bridge/act.js

@@ -0,0 +1,8 @@
+import { act as actPrimitive, isBrowseAction, } from '@mercuryo-ai/agentbrowse';
+import { saveMagicPaySession } from '../workflow-state.js';
+export { isBrowseAction };
+export async function act(session, targetRef, action, value) {
+    const result = await actPrimitive(session, targetRef, action, value);
+    saveMagicPaySession(session);
+    return result;
+}

package/dist/browser-bridge/observe.d.ts

@@ -0,0 +1,5 @@
+import { type BrowserSessionState, type ObserveResult } from '@mercuryo-ai/agentbrowse';
+import { type MagicPaySession } from '../workflow-state.js';
+export type { ObserveResult };
+export declare function observe(session: BrowserSessionState | MagicPaySession, instruction?: string): Promise<ObserveResult>;
+//# sourceMappingURL=observe.d.ts.map

package/dist/browser-bridge/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/browser-bridge/observe.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEjF,YAAY,EAAE,aAAa,EAAE,CAAC;AAmC9B,wBAAsB,OAAO,CAC3B,OAAO,EAAE,mBAAmB,GAAG,eAAe,EAC9C,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAyBxB"}

package/dist/browser-bridge/observe.js

@@ -0,0 +1,53 @@
+import { observe as observePrimitive, } from '@mercuryo-ai/agentbrowse';
+import { enrichObservedFormsForUrl } from '@mercuryo-ai/magicpay-sdk/agentbrowse';
+import { listFillableForms } from '../fillable-form-state.js';
+import { saveMagicPaySession } from '../workflow-state.js';
+async function ensureAssistiveRuntime() {
+    const { ensureMagicPayAgentbrowseAssistiveRuntime } = await import('../agentbrowse-assistive.js');
+    ensureMagicPayAgentbrowseAssistiveRuntime();
+}
+function toObservedFillableForms(forms) {
+    return forms
+        .filter((form) => form.presence !== 'absent')
+        .map((form) => ({
+        fillRef: form.fillRef,
+        scopeRef: form.scopeRef,
+        purpose: form.purpose,
+        presence: form.presence === 'unknown' ? 'unknown' : 'present',
+        fields: form.fields.map((field) => ({
+            fieldKey: field.fieldKey,
+            targetRef: field.targetRef,
+            label: field.label,
+            required: field.required,
+            valueHint: field.valueHint,
+        })),
+        storedSecretCandidates: form.storedSecretCandidates.map((candidate) => ({
+            storedSecretRef: candidate.storedSecretRef,
+            kind: candidate.kind,
+            scope: candidate.scope,
+            displayName: candidate.displayName,
+            matchConfidence: candidate.matchConfidence,
+            intentRequired: candidate.intentRequired,
+        })),
+    }));
+}
+export async function observe(session, instruction) {
+    await ensureAssistiveRuntime();
+    const result = await observePrimitive(session, instruction);
+    if (result.success) {
+        saveMagicPaySession(session);
+    }
+    if (!result.success || !Array.isArray(result.fillableForms) || !result.url) {
+        return result;
+    }
+    try {
+        const runtimeFillableForms = listFillableForms(session);
+        return {
+            ...result,
+            fillableForms: toObservedFillableForms(enrichObservedFormsForUrl(runtimeFillableForms, 'secretCatalogByHost' in session ? session.secretCatalogByHost : undefined, result.url)),
+        };
+    }
+    catch {
+        return result;
+    }
+}

package/dist/browser-home.d.ts

@@ -0,0 +1,7 @@
+import { type LaunchOptions } from '@mercuryo-ai/agentbrowse';
+export declare function configureMagicPayAgentbrowseHome(): void;
+export declare function resolveLaunchOptions(options?: Omit<LaunchOptions, 'compact' | 'profile'> & {
+    compact?: boolean;
+    profile?: string;
+}): LaunchOptions;
+//# sourceMappingURL=browser-home.d.ts.map

package/dist/browser-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-home.d.ts","sourceRoot":"","sources":["../src/browser-home.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAYlC,wBAAgB,gCAAgC,IAAI,IAAI,CAiBvD;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,aAAa,CAUf"}

package/dist/browser-home.js

@@ -0,0 +1,34 @@
+import { getMagicPayBrowserDefaults, getMagicPayHomeDir, } from '@mercuryo-ai/magicpay-home';
+import { setSolverConfigStoreOverride, } from '@mercuryo-ai/agentbrowse';
+function toProxySetting(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    return value;
+}
+export function configureMagicPayAgentbrowseHome() {
+    const override = {
+        rootDir: getMagicPayHomeDir(),
+        readConfig: () => {
+            const defaults = getMagicPayBrowserDefaults();
+            const proxy = toProxySetting(defaults.proxy);
+            return {
+                defaults: {
+                    ...(typeof defaults.headless === 'boolean' ? { headless: defaults.headless } : {}),
+                    ...(proxy ? { proxy } : {}),
+                },
+            };
+        },
+    };
+    setSolverConfigStoreOverride(override);
+}
+export function resolveLaunchOptions(options = {}) {
+    const defaults = getMagicPayBrowserDefaults();
+    return {
+        compact: options.compact ?? (defaults.windowMode === 'full' ? false : true),
+        profile: options.profile ?? defaults.profile,
+        ...(typeof options.headless === 'boolean' ? { headless: options.headless } : {}),
+        ...(typeof options.useProxy === 'boolean' ? { useProxy: options.useProxy } : {}),
+        ...(options.proxy ? { proxy: options.proxy } : {}),
+    };
+}

package/dist/commands/act.d.ts

@@ -0,0 +1,5 @@
+import { isBrowseAction, type ActResult, type BrowserSessionState, type BrowseAction } from '@mercuryo-ai/agentbrowse';
+export { isBrowseAction };
+export type { ActResult, BrowseAction };
+export declare function act(session: BrowserSessionState, targetRef: string, action: BrowseAction, value?: string): Promise<ActResult>;
+//# sourceMappingURL=act.d.ts.map

package/dist/commands/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAExC,wBAAsB,GAAG,CACvB,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CAIpB"}

package/dist/commands/act.js

@@ -0,0 +1,8 @@
+import { act as actPrimitive, isBrowseAction, } from '@mercuryo-ai/agentbrowse';
+import { saveMagicPaySession } from '../workflow-state.js';
+export { isBrowseAction };
+export async function act(session, targetRef, action, value) {
+    const result = await actPrimitive(session, targetRef, action, value);
+    saveMagicPaySession(session);
+    return result;
+}

package/dist/commands/attach.d.ts

@@ -0,0 +1,4 @@
+import { type AttachOptions, type AttachResult } from '@mercuryo-ai/agentbrowse';
+export type { AttachOptions, AttachResult };
+export declare function attach(cdpUrl: string, options?: AttachOptions): Promise<AttachResult>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/commands/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../src/commands/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAQlC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAE5C,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAO3F"}

package/dist/commands/attach.js

@@ -0,0 +1,10 @@
+import { attach as attachBrowser, close as closeBrowser, } from '@mercuryo-ai/agentbrowse';
+import { loadMagicPayBrowserSession, loadMagicPaySession, saveMagicPaySession, } from '../workflow-state.js';
+export async function attach(cdpUrl, options) {
+    await closeBrowser(loadMagicPaySession() ?? loadMagicPayBrowserSession());
+    const result = await attachBrowser(cdpUrl, options);
+    if (result.success) {
+        saveMagicPaySession(result.session);
+    }
+    return result;
+}

package/dist/commands/browser-status.d.ts

@@ -0,0 +1,5 @@
+import { status as readStatus, type BrowserCommandSession } from '@mercuryo-ai/agentbrowse';
+export type BrowserStatusResult = Awaited<ReturnType<typeof readStatus>>;
+export type { BrowserCommandSession };
+export declare function browserStatus(): Promise<BrowserStatusResult>;
+//# sourceMappingURL=browser-status.d.ts.map

package/dist/commands/browser-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-status.d.ts","sourceRoot":"","sources":["../../src/commands/browser-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,UAAU,EACpB,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,wBAAsB,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAElE"}

package/dist/commands/browser-status.js

@@ -0,0 +1,5 @@
+import { status as readStatus, } from '@mercuryo-ai/agentbrowse';
+import { loadMagicPayBrowserSession, loadMagicPaySession } from '../workflow-state.js';
+export async function browserStatus() {
+    return readStatus(loadMagicPaySession() ?? loadMagicPayBrowserSession());
+}

package/dist/commands/close.d.ts

@@ -0,0 +1,4 @@
+import { type CloseResult } from '@mercuryo-ai/agentbrowse';
+export type { CloseResult };
+export declare function close(): Promise<CloseResult>;
+//# sourceMappingURL=close.d.ts.map

package/dist/commands/close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AASlC,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,wBAAsB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAWlD"}

package/dist/commands/close.js

@@ -0,0 +1,11 @@
+import { close as closeBrowser, } from '@mercuryo-ai/agentbrowse';
+import { deleteMagicPayBrowserSession, deleteWorkflowContext, loadMagicPayBrowserSession, loadMagicPaySession, } from '../workflow-state.js';
+export async function close() {
+    const session = (loadMagicPaySession() ?? loadMagicPayBrowserSession());
+    const result = await closeBrowser(session);
+    if (result.success) {
+        deleteMagicPayBrowserSession();
+        deleteWorkflowContext();
+    }
+    return result;
+}

package/dist/commands/end-session.d.ts

@@ -0,0 +1,22 @@
+import { type MagicPaySession } from '../workflow-state.js';
+export type EndSessionSuccessResult = {
+    success: true;
+    runId: string;
+    intentSessionId: string;
+    status: string;
+    lastEventSeq: number;
+    browserSessionId: string | null;
+    completedAt: string;
+    outcomeType: 'workflow_session_completed';
+    message: 'Workflow session completed.';
+};
+export type EndSessionFailureResult = {
+    success: false;
+    error: 'workflow_session_unavailable' | 'workflow_session_already_closed' | 'workflow_run_unavailable' | 'workflow_step_unavailable' | 'backend_session_complete_failed';
+    outcomeType: 'blocked' | 'failed';
+    message: 'Workflow session end failed.';
+    reason: string;
+};
+export type EndSessionResult = EndSessionSuccessResult | EndSessionFailureResult;
+export declare function endSession(session: MagicPaySession): Promise<EndSessionResult>;
+//# sourceMappingURL=end-session.d.ts.map

package/dist/commands/end-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-session.d.ts","sourceRoot":"","sources":["../../src/commands/end-session.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,4BAA4B,CAAC;IAC1C,OAAO,EAAE,6BAA6B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EACD,8BAA8B,GAC9B,iCAAiC,GACjC,0BAA0B,GAC1B,2BAA2B,GAC3B,iCAAiC,CAAC;IACtC,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AA6DjF,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwEpF"}

package/dist/commands/end-session.js

@@ -0,0 +1,104 @@
+import { exportRunStepToOtlpHttpJsonBestEffort } from '../otel-exporter.js';
+import { info } from '../output.js';
+import { finishRunRecord, finishRunStep, startRunStep } from '../run-store.js';
+import { clearWorkflowState, saveMagicPaySession, } from '../workflow-state.js';
+import { completeWorkflowSessionRemote, formatUnknownWorkflowCompletionError, } from '../workflow-session-completion.js';
+async function finalizeEndSessionStepBestEffort(runId, stepId, options) {
+    if (!runId || !stepId) {
+        return;
+    }
+    try {
+        finishRunStep({
+            runId,
+            stepId,
+            ...options,
+        });
+        await exportRunStepToOtlpHttpJsonBestEffort(runId, stepId);
+    }
+    catch (error) {
+        info(`[end-session] failed to finalize local run step ${stepId}: ${formatUnknownWorkflowCompletionError(error)}`);
+    }
+}
+function finalizeRunRecordBestEffort(runId, options) {
+    if (!runId) {
+        return;
+    }
+    try {
+        finishRunRecord(runId, {
+            status: options.status,
+            finalOutcome: {
+                success: options.success,
+                ...(options.outcomeType ? { outcomeType: options.outcomeType } : {}),
+                ...(options.message ? { message: options.message } : {}),
+                ...(options.reason ? { reason: options.reason } : {}),
+            },
+        });
+    }
+    catch (error) {
+        info(`[end-session] failed to finalize local run ${runId}: ${formatUnknownWorkflowCompletionError(error)}`);
+    }
+}
+export async function endSession(session) {
+    const endSessionStep = session.activeRunId
+        ? startRunStep({
+            runId: session.activeRunId,
+            command: 'end-session',
+            input: {
+                hasWorkflowSession: Boolean(session.intentSessionId),
+                currentRequestId: session.currentRequestId ?? null,
+            },
+        })
+        : null;
+    const remoteCompletion = await completeWorkflowSessionRemote({
+        session,
+        stepId: endSessionStep?.stepId,
+        command: 'end-session',
+        terminalStatus: 'completed',
+        runStatus: 'completed',
+        summary: 'Workflow session completed.',
+        outcomeType: 'workflow_session_completed',
+        message: 'Workflow session completed.',
+    });
+    if (!remoteCompletion.success) {
+        const outcomeType = remoteCompletion.error === 'backend_session_complete_failed'
+            ? 'backend_session_complete_failed'
+            : 'blocked';
+        await finalizeEndSessionStepBestEffort(session.activeRunId, endSessionStep?.stepId, {
+            success: false,
+            outcomeType,
+            message: 'Workflow session end failed.',
+            reason: remoteCompletion.reason,
+        });
+        return {
+            success: false,
+            error: remoteCompletion.error,
+            outcomeType: remoteCompletion.error === 'backend_session_complete_failed' ? 'failed' : 'blocked',
+            message: 'Workflow session end failed.',
+            reason: remoteCompletion.reason,
+        };
+    }
+    await finalizeEndSessionStepBestEffort(remoteCompletion.runId, remoteCompletion.stepId ?? undefined, {
+        success: true,
+        outcomeType: 'workflow_session_completed',
+        message: 'Workflow session completed.',
+    });
+    finalizeRunRecordBestEffort(remoteCompletion.runId, {
+        status: 'completed',
+        success: true,
+        outcomeType: 'workflow_session_completed',
+        message: 'Workflow session completed.',
+    });
+    const nextSession = clearWorkflowState(session);
+    saveMagicPaySession(nextSession);
+    return {
+        success: true,
+        runId: remoteCompletion.runId,
+        intentSessionId: remoteCompletion.response.session.id,
+        status: remoteCompletion.response.session.status,
+        lastEventSeq: remoteCompletion.response.session.last_event_seq,
+        browserSessionId: remoteCompletion.response.browser_session_id,
+        completedAt: remoteCompletion.completedAt,
+        outcomeType: 'workflow_session_completed',
+        message: 'Workflow session completed.',
+    };
+}

package/dist/commands/extract.d.ts

@@ -0,0 +1,4 @@
+import { type BrowserSessionState, type ExtractResult, type ExtractSchemaInput } from '@mercuryo-ai/agentbrowse';
+export type { ExtractResult };
+export declare function extract(session: BrowserSessionState, schema: ExtractSchemaInput, scopeRef?: string): Promise<ExtractResult>;
+//# sourceMappingURL=extract.d.ts.map