@mercuryo-ai/agentbrowse 0.2.50

package/dist/command-api-tracing.js

@@ -0,0 +1,149 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { recordDiagnosticChildSpanBestEffort } from './diagnostics.js';
+const apiTraceContextStorage = new AsyncLocalStorage();
+function sanitizeTraceUrl(value) {
+    try {
+        const parsed = new URL(value);
+        parsed.username = '';
+        parsed.password = '';
+        parsed.search = '';
+        parsed.hash = '';
+        return parsed.toString();
+    }
+    catch {
+        return value;
+    }
+}
+function resolveMethod(input, init) {
+    const initMethod = init?.method?.trim();
+    if (initMethod) {
+        return initMethod.toUpperCase();
+    }
+    if (typeof Request !== 'undefined' && input instanceof Request) {
+        return input.method.toUpperCase();
+    }
+    return 'GET';
+}
+function resolveUrl(input) {
+    if (input instanceof URL) {
+        return input.toString();
+    }
+    if (typeof input === 'string') {
+        return input;
+    }
+    if (typeof Request !== 'undefined' && input instanceof Request) {
+        return input.url;
+    }
+    return String(input);
+}
+function buildTraceAttributes(context, input, init, extraAttributes) {
+    const url = resolveUrl(input);
+    const method = resolveMethod(input, init);
+    let hostname;
+    let pathname;
+    try {
+        const parsed = new URL(url);
+        hostname = parsed.host;
+        pathname = parsed.pathname;
+    }
+    catch { }
+    return {
+        'agentbrowse.api.command': context.command,
+        'http.request.method': method,
+        'url.full': sanitizeTraceUrl(url),
+        ...(hostname ? { 'server.address': hostname } : {}),
+        ...(pathname ? { 'url.path': pathname } : {}),
+        ...(extraAttributes ?? {}),
+    };
+}
+export async function withApiTraceContext(context, run) {
+    return apiTraceContextStorage.run(context, run);
+}
+export async function tracedStepOperation(run, options) {
+    const context = apiTraceContextStorage.getStore();
+    if (!context?.runId || !context.stepId || !options?.spanName) {
+        return run();
+    }
+    const startedAt = new Date().toISOString();
+    const attributes = {
+        'agentbrowse.api.command': context.command,
+        ...(options.attributes ?? {}),
+    };
+    try {
+        const result = await run();
+        recordDiagnosticChildSpanBestEffort({
+            step: {
+                runId: context.runId,
+                stepId: context.stepId,
+                command: context.command,
+            },
+            name: options.spanName,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            statusCode: 'ok',
+            attributes,
+        });
+        return result;
+    }
+    catch (error) {
+        recordDiagnosticChildSpanBestEffort({
+            step: {
+                runId: context.runId,
+                stepId: context.stepId,
+                command: context.command,
+            },
+            name: options.spanName,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            statusCode: 'error',
+            statusMessage: error instanceof Error ? error.message : String(error),
+            attributes,
+        });
+        throw error;
+    }
+}
+export async function tracedFetch(input, init, options) {
+    const fetchImpl = options?.fetchImpl ?? fetch;
+    const context = apiTraceContextStorage.getStore();
+    if (!context?.runId || !context.stepId || !options?.spanName) {
+        return fetchImpl(input, init);
+    }
+    const startedAt = new Date().toISOString();
+    const attributes = buildTraceAttributes(context, input, init, options.attributes);
+    try {
+        const response = await fetchImpl(input, init);
+        recordDiagnosticChildSpanBestEffort({
+            step: {
+                runId: context.runId,
+                stepId: context.stepId,
+                command: context.command,
+            },
+            name: options.spanName,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            statusCode: response.ok ? 'ok' : 'error',
+            ...(response.ok ? {} : { statusMessage: `http_${response.status}` }),
+            attributes: {
+                ...attributes,
+                'http.response.status_code': response.status,
+            },
+        });
+        return response;
+    }
+    catch (error) {
+        recordDiagnosticChildSpanBestEffort({
+            step: {
+                runId: context.runId,
+                stepId: context.stepId,
+                command: context.command,
+            },
+            name: options.spanName,
+            startedAt,
+            endedAt: new Date().toISOString(),
+            statusCode: 'error',
+            statusMessage: error instanceof Error ? error.message : String(error),
+            attributes,
+        });
+        throw error;
+    }
+}

package/dist/command-name.d.ts

@@ -0,0 +1,3 @@
+export declare function browseCommandName(): string;
+export declare function browseCommand(...args: string[]): string;
+//# sourceMappingURL=command-name.d.ts.map

package/dist/command-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-name.d.ts","sourceRoot":"","sources":["../src/command-name.ts"],"names":[],"mappings":"AAOA,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,aAAa,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD"}

package/dist/command-name.js

@@ -0,0 +1,11 @@
+const DEFAULT_BROWSE_COMMAND = 'agentbrowse';
+function normalizeCommandName(value, fallback) {
+    const normalized = value?.trim().replace(/\s+/g, ' ');
+    return normalized && normalized.length > 0 ? normalized : fallback;
+}
+export function browseCommandName() {
+    return normalizeCommandName(process.env.AGENTBROWSE_COMMAND, DEFAULT_BROWSE_COMMAND);
+}
+export function browseCommand(...args) {
+    return [browseCommandName(), ...args].join(' ');
+}

package/dist/commands/act.d.ts

@@ -0,0 +1,43 @@
+/**
+ * browse act <targetRef> <action> [value] — Perform a deterministic action on a stored target.
+ */
+import type { BrowserCommandSession } from '../browser-session-state.js';
+import { type BrowseContractFailure, type BrowseResult } from '../output.js';
+import { BROWSE_ACTIONS, type BrowseAction, isBrowseAction } from './browse-actions.js';
+/** Stable top-level error codes returned by `act(...)`. */
+export declare const ACT_ERROR_CODES: readonly ["act_failed", "action_not_allowed_for_target", "browser_connection_failed", "no_observable_progress", "stale_target", "stale_target_ref", "target_disabled", "target_gated", "target_not_actionable", "target_readonly", "target_surface_inactive", "target_surface_not_live", "target_surface_unavailable", "unknown_target_ref", "validation_blocked"];
+/** Stable outcome categories emitted by `act(...)`. */
+export declare const ACT_OUTCOME_TYPES: readonly ["action_completed", "binding_stale", "blocked", "partial_progress", "unsupported"];
+export type ActErrorCode = (typeof ACT_ERROR_CODES)[number];
+export type ActOutcomeType = (typeof ACT_OUTCOME_TYPES)[number];
+/** Successful deterministic action result. */
+export type ActSuccessResult = BrowseResult & {
+    success: true;
+    targetRef: string;
+    action: BrowseAction;
+};
+/** Contract-time failure raised before a browser action is attempted. */
+export type ActPreflightFailureResult = BrowseContractFailure & {
+    success: false;
+    failureSurface: 'contract';
+    error: ActErrorCode;
+    outcomeType: Extract<ActOutcomeType, 'binding_stale' | 'blocked' | 'unsupported'>;
+    targetRef: string;
+    action: BrowseAction;
+};
+/** Runtime failure raised after AgentBrowse attempted the browser action. */
+export type ActExecutionFailureResult = BrowseResult & {
+    success: false;
+    failureSurface: 'output';
+    error: ActErrorCode;
+    outcomeType: Extract<ActOutcomeType, 'binding_stale' | 'blocked'>;
+    targetRef: string;
+    action: BrowseAction;
+};
+export type ActFailureResult = ActPreflightFailureResult | ActExecutionFailureResult;
+export type ActResult = ActSuccessResult | ActFailureResult;
+export { BROWSE_ACTIONS, isBrowseAction };
+export type { BrowseAction };
+export declare function actBrowser(session: BrowserCommandSession, targetRef: string, action: BrowseAction, value?: string): Promise<ActResult>;
+export declare function act(session: BrowserCommandSession, targetRef: string, action: BrowseAction, value?: string): Promise<void>;
+//# 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;;GAEG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAYzE,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AA6BtB,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4CxF,2DAA2D;AAC3D,eAAO,MAAM,eAAe,oWAgBlB,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,8FAMpB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG;IAC9D,OAAO,EAAE,KAAK,CAAC;IACf,cAAc,EAAE,UAAU,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG;IACrD,OAAO,EAAE,KAAK,CAAC;IACf,cAAc,EAAE,QAAQ,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,GAAG,yBAAyB,CAAC;AAErF,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAmK5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;AA+Q7B,wBAAsB,UAAU,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CAg2BpB;AAED,wBAAsB,GAAG,CACvB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAaf"}