@xopcai/xopc 0.0.251 → 0.0.252

package/dist/src/browser/pipeline/output.js

@@ -1,74 +0,0 @@
-//#region src/browser/pipeline/output.ts
-function createPipelineOutput(name) {
-	return {
-		ok: true,
-		name,
-		last: void 0,
-		outputs: [],
-		artifacts: [],
-		diagnostics: { warnings: [] },
-		trace: []
-	};
-}
-function addStepTrace(output, trace, result) {
-	output.trace.push(trace);
-	if (result.artifacts) output.artifacts.push(...result.artifacts);
-	if (!result.ok) {
-		output.ok = false;
-		output.error = {
-			step: trace.index,
-			action: result.action,
-			code: result.error?.code ?? "UNKNOWN",
-			message: result.error?.message ?? "Step failed"
-		};
-	}
-	if (result.diagnostics) {
-		if (result.diagnostics.url) output.diagnostics.url = result.diagnostics.url;
-		if (result.diagnostics.title) output.diagnostics.title = result.diagnostics.title;
-		if (result.diagnostics.snapshot) output.diagnostics.snapshot = result.diagnostics.snapshot;
-		if (result.diagnostics.screenshot) output.diagnostics.screenshot = result.diagnostics.screenshot;
-		if (result.diagnostics.console) output.diagnostics.console = result.diagnostics.console;
-		if (result.diagnostics.network) output.diagnostics.network = result.diagnostics.network;
-		if (result.diagnostics.warnings) {
-			output.diagnostics.warnings ??= [];
-			output.diagnostics.warnings.push(...result.diagnostics.warnings);
-		}
-	}
-}
-function formatPipelineResult(output) {
-	const data = {
-		output: output.outputs.length === 0 ? output.last : output.outputs.length === 1 ? output.outputs[0] : output.outputs,
-		last: output.last,
-		outputs: output.outputs,
-		trace: output.trace
-	};
-	if (output.ok) {
-		const textValue = data.output;
-		return {
-			ok: true,
-			action: "pipeline",
-			text: textValue === void 0 ? `Pipeline "${output.name}" completed (${output.trace.length} steps).` : typeof textValue === "string" ? textValue : JSON.stringify(textValue, null, 2),
-			data,
-			artifacts: output.artifacts.length > 0 ? output.artifacts : void 0,
-			diagnostics: output.diagnostics
-		};
-	}
-	const errText = output.error ? `Pipeline "${output.name}" failed at step ${output.error.step + 1} (${output.error.action}): [${output.error.code}] ${output.error.message}` : `Pipeline "${output.name}" failed.`;
-	return {
-		ok: false,
-		action: "pipeline",
-		text: errText,
-		data,
-		error: output.error ? {
-			code: output.error.code,
-			message: output.error.message
-		} : {
-			code: "PIPELINE_FAILED",
-			message: errText
-		},
-		artifacts: output.artifacts.length > 0 ? output.artifacts : void 0,
-		diagnostics: output.diagnostics
-	};
-}
-//#endregion
-export { addStepTrace, createPipelineOutput, formatPipelineResult };

package/dist/src/browser/pipeline/runner.d.ts

@@ -1,27 +0,0 @@
-/**
- * Pipeline runner: deterministic browser automation DSL execution.
- */
-import type { BrowserActionContext, BrowserActionRegistry, BrowserActionResult } from '../actions/types.js';
-import { type PipelineDocument } from './schema.js';
-export interface ValidateResult {
-    ok: boolean;
-    document?: PipelineDocument;
-    errors: {
-        path: string;
-        message: string;
-    }[];
-}
-export interface RunBrowserPipelineOptions {
-    dryRun?: boolean;
-    onStep?: (event: BrowserRecipeStepEvent) => void;
-}
-export interface BrowserRecipeStepEvent {
-    index: number;
-    scope: string;
-    action: string;
-    status: 'started' | 'completed' | 'failed';
-    elapsedMs?: number;
-    error?: string;
-}
-export declare function validateBrowserPipeline(yamlSource: string, registry?: BrowserActionRegistry): ValidateResult;
-export declare function runBrowserPipeline(yamlSource: string, argOverrides: Record<string, unknown>, ctx: BrowserActionContext, registry: BrowserActionRegistry, options?: RunBrowserPipelineOptions): Promise<BrowserActionResult>;

package/dist/src/browser/pipeline/runner.js

@@ -1,453 +0,0 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
-import { isTruthyValue, resolveTemplateDeep } from "./template.js";
-import { parseBrowserPipeline } from "./schema.js";
-import { addStepTrace, createPipelineOutput, formatPipelineResult } from "./output.js";
-import { setTimeout } from "node:timers/promises";
-//#region src/browser/pipeline/runner.ts
-/**
-* Pipeline runner: deterministic browser automation DSL execution.
-*/
-init_logger();
-const log = createLogger("PipelineRunner");
-const CONTROL_ACTIONS = new Set([
-	"if",
-	"retry",
-	"sleep",
-	"set_var"
-]);
-const RECIPE_ACTIONS = new Set([
-	...CONTROL_ACTIONS,
-	"navigate",
-	"snapshot",
-	"click",
-	"type",
-	"scroll",
-	"screenshot",
-	"press",
-	"evaluate",
-	"wait",
-	"wait_for_navigation",
-	"wait_for_network_idle",
-	"element_text",
-	"element_attribute",
-	"output",
-	"assert",
-	"select",
-	"map",
-	"filter",
-	"sort",
-	"limit"
-]);
-function validateBrowserPipeline(yamlSource, registry) {
-	const parseResult = parseBrowserPipeline(yamlSource);
-	if (!parseResult.ok || !parseResult.document) return {
-		ok: false,
-		errors: parseResult.errors
-	};
-	const errors = [];
-	validateSteps(parseResult.document.pipeline, "pipeline", registry, errors);
-	validateSteps(parseResult.document.onError ?? [], "on_error", registry, errors);
-	return errors.length > 0 ? {
-		ok: false,
-		document: parseResult.document,
-		errors
-	} : {
-		ok: true,
-		document: parseResult.document,
-		errors: []
-	};
-}
-function validateSteps(steps, path, registry, errors) {
-	if (!registry) return;
-	for (let i = 0; i < steps.length; i++) {
-		const step = steps[i];
-		if (!RECIPE_ACTIONS.has(step.action)) errors.push({
-			path: `${path}[${i}]`,
-			message: `Action is not available in Browser Recipe v1: "${step.action}"`
-		});
-		else if (!CONTROL_ACTIONS.has(step.action) && !registry.has(step.action)) errors.push({
-			path: `${path}[${i}]`,
-			message: `Unknown action: "${step.action}"`
-		});
-		const requiredKey = {
-			navigate: "url",
-			type: "text",
-			press: "key",
-			evaluate: "javascript",
-			element_text: "selector",
-			element_attribute: "selector",
-			set_var: "name"
-		}[step.action];
-		if (requiredKey && !(requiredKey in step.args)) errors.push({
-			path: `${path}[${i}].${step.action}.${requiredKey}`,
-			message: `Required field is missing: ${requiredKey}`
-		});
-		if (step.action === "click" && ![
-			"selector",
-			"text",
-			"role"
-		].some((key) => key in step.args)) errors.push({
-			path: `${path}[${i}].click`,
-			message: "One of selector, text, or role is required"
-		});
-		if (step.action === "type" && !["selector", "label"].some((key) => key in step.args)) errors.push({
-			path: `${path}[${i}].type`,
-			message: "One of selector or label is required"
-		});
-		try {
-			if (step.action === "if") {
-				validateSteps(normalizeNestedPipeline(step.args.then, `${path}[${i}].if.then`), `${path}[${i}].if.then`, registry, errors);
-				validateSteps(normalizeNestedPipeline(step.args.else, `${path}[${i}].if.else`), `${path}[${i}].if.else`, registry, errors);
-			} else if (step.action === "retry") validateSteps(normalizeNestedPipeline(step.args.pipeline, `${path}[${i}].retry.pipeline`), `${path}[${i}].retry.pipeline`, registry, errors);
-		} catch (error) {
-			errors.push({
-				path: `${path}[${i}].${step.action}`,
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-}
-function resolveArgs(doc, overrides) {
-	const resolved = {};
-	for (const key of Object.keys(overrides)) if (!(key in doc.args)) throw new Error(`Unknown pipeline arg: ${key}`);
-	for (const [key, def] of Object.entries(doc.args)) {
-		const value = key in overrides ? overrides[key] : def.default;
-		if (value === void 0) {
-			if (def.required) throw new Error(`Missing required arg: ${key}`);
-			continue;
-		}
-		if (def.choices && !def.choices.some((choice) => Object.is(choice, value))) throw new Error(`Invalid value for arg ${key}: expected one of ${def.choices.map(String).join(", ")}`);
-		if (def.type === "string" && typeof value !== "string") throw new Error(`Arg ${key} must be a string`);
-		if (def.type === "number" && (typeof value !== "number" || !Number.isFinite(value))) throw new Error(`Arg ${key} must be a number`);
-		if (def.type === "integer" && (typeof value !== "number" || !Number.isInteger(value))) throw new Error(`Arg ${key} must be an integer`);
-		if (def.type === "boolean" && typeof value !== "boolean") throw new Error(`Arg ${key} must be a boolean`);
-		resolved[key] = value;
-	}
-	return resolved;
-}
-function templateContext(runtime) {
-	return {
-		args: runtime.args,
-		last: runtime.last,
-		outputs: runtime.outputs,
-		vars: runtime.vars,
-		error: runtime.error
-	};
-}
-function actionArgs(step, runtime) {
-	return resolveTemplateDeep(step.args, templateContext(runtime));
-}
-async function executePipeline(steps, scope, runtime, actionCtx, registry, output, options) {
-	for (let i = 0; i < steps.length; i++) {
-		if (actionCtx.signal?.aborted) throw actionError("ABORTED", "Pipeline aborted");
-		await executeStep(steps[i], i, scope, runtime, actionCtx, registry, output, options);
-	}
-}
-async function executeStep(step, index, scope, runtime, actionCtx, registry, output, options) {
-	const started = Date.now();
-	options.onStep?.({
-		index,
-		scope,
-		action: step.action,
-		status: "started"
-	});
-	let result;
-	try {
-		result = await executeStepOnce(step, index, scope, runtime, actionCtx, registry, output, options);
-	} catch (e) {
-		const error = e instanceof Error ? e : new Error(String(e));
-		result = {
-			ok: false,
-			action: step.action,
-			error: {
-				code: error.code ?? "STEP_FAILED",
-				message: error.message
-			}
-		};
-	}
-	addStepTrace(output, {
-		index,
-		scope,
-		action: step.action,
-		ok: result.ok,
-		elapsedMs: Date.now() - started,
-		text: result.text?.slice(0, 500),
-		data: result.data,
-		error: result.error
-	}, result);
-	options.onStep?.({
-		index,
-		scope,
-		action: step.action,
-		status: result.ok ? "completed" : "failed",
-		elapsedMs: Date.now() - started,
-		error: result.error?.message
-	});
-	if (!result.ok) {
-		runtime.error = result.error;
-		throw actionError(result.error?.code ?? "STEP_FAILED", result.error?.message ?? "Step failed");
-	}
-}
-async function executeStepOnce(step, index, scope, runtime, actionCtx, registry, output, options) {
-	switch (step.action) {
-		case "sleep": {
-			const args = actionArgs(step, runtime);
-			const ms = Number(args.ms ?? 1e3);
-			await setTimeout(Number.isFinite(ms) ? ms : 1e3, void 0, { signal: actionCtx.signal });
-			runtime.last = null;
-			return {
-				ok: true,
-				action: "sleep",
-				text: `Slept ${ms}ms.`,
-				data: null
-			};
-		}
-		case "set_var": {
-			const args = actionArgs(step, runtime);
-			const name = String(args.name ?? "");
-			if (!name) return {
-				ok: false,
-				action: "set_var",
-				error: {
-					code: "INVALID_ARGS",
-					message: "name is required"
-				}
-			};
-			runtime.vars[name] = args.value;
-			runtime.last = args.value;
-			return {
-				ok: true,
-				action: "set_var",
-				text: `Set var: ${name}`,
-				data: args.value
-			};
-		}
-		case "if": {
-			const args = actionArgs(step, runtime);
-			await executePipeline(normalizeNestedPipeline(isTruthyValue(args.condition) ? args.then : args.else, `${scope}.${index}.if`), `${scope}.${index}.if`, runtime, actionCtx, registry, output, options);
-			return {
-				ok: true,
-				action: "if",
-				text: "Conditional branch completed.",
-				data: runtime.last
-			};
-		}
-		case "retry": {
-			const args = actionArgs(step, runtime);
-			const times = Math.max(1, Number(args.times ?? 3));
-			const delayMs = Math.max(0, Number(args.delay_ms ?? 250));
-			const retrySteps = normalizeNestedPipeline(args.pipeline, `${scope}.${index}.retry`);
-			let lastError;
-			for (let attempt = 1; attempt <= times; attempt++) try {
-				await executePipeline(retrySteps, `${scope}.${index}.retry.${attempt}`, runtime, actionCtx, registry, output, options);
-				output.ok = true;
-				output.error = void 0;
-				return {
-					ok: true,
-					action: "retry",
-					text: `Retry block completed on attempt ${attempt}.`,
-					data: runtime.last
-				};
-			} catch (e) {
-				lastError = e;
-				output.ok = true;
-				output.error = void 0;
-				if (attempt < times) await setTimeout(delayMs, void 0, { signal: actionCtx.signal });
-			}
-			return {
-				ok: false,
-				action: "retry",
-				error: {
-					code: "RETRY_FAILED",
-					message: lastError instanceof Error ? lastError.message : String(lastError)
-				}
-			};
-		}
-		default: return executeBrowserAction(step, runtime, actionCtx, registry);
-	}
-}
-async function executeBrowserAction(step, runtime, actionCtx, registry) {
-	const args = actionArgs(step, runtime);
-	if (step.action === "navigate") {
-		let hostname;
-		try {
-			hostname = new URL(String(args.url)).hostname.toLowerCase();
-		} catch {
-			return {
-				ok: false,
-				action: step.action,
-				error: {
-					code: "INVALID_URL",
-					message: "navigate.url must be an absolute URL"
-				}
-			};
-		}
-		if (!runtime.doc.domains.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`))) return {
-			ok: false,
-			action: step.action,
-			error: {
-				code: "DOMAIN_BLOCKED",
-				message: `Domain is not declared by the recipe: ${hostname}`
-			}
-		};
-	}
-	actionCtx.pipeline = {
-		args: runtime.args,
-		last: runtime.last,
-		outputs: runtime.outputs,
-		vars: runtime.vars,
-		error: runtime.error
-	};
-	const result = await registry.execute(step.action, actionCtx, args);
-	if (result.ok && step.action === "navigate") {
-		const finalUrl = result.data?.url;
-		if (typeof finalUrl === "string") {
-			const hostname = new URL(finalUrl).hostname.toLowerCase();
-			if (!runtime.doc.domains.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`))) return {
-				ok: false,
-				action: step.action,
-				error: {
-					code: "DOMAIN_BLOCKED",
-					message: `Redirected to an undeclared domain: ${hostname}`
-				}
-			};
-		}
-	}
-	if (result.ok) {
-		if (step.action === "output") runtime.outputs.push(result.data);
-		if (result.data !== void 0) runtime.last = result.data;
-	}
-	return result;
-}
-function normalizeNestedPipeline(value, path) {
-	return (Array.isArray(value) ? value : value ? [value] : []).map((rawStep, index) => {
-		if (!rawStep || typeof rawStep !== "object" || Array.isArray(rawStep)) throw new Error(`${path}[${index}] must be a YAML object`);
-		const obj = rawStep;
-		const keys = Object.keys(obj);
-		if (keys.length !== 1) throw new Error(`${path}[${index}] must contain exactly one action`);
-		const action = keys[0];
-		const args = obj[action];
-		if (args && typeof args === "object" && !Array.isArray(args)) return {
-			action,
-			args
-		};
-		throw new Error(`${path}[${index}].${action} must be an object`);
-	});
-}
-function actionError(code, message) {
-	const error = new Error(message);
-	error.code = code;
-	return error;
-}
-async function runBrowserPipeline(yamlSource, argOverrides, ctx, registry, options = {}) {
-	let doc;
-	try {
-		const parsed = parseBrowserPipeline(yamlSource);
-		if (!parsed.ok || !parsed.document) throw new Error(parsed.errors.map((error) => `${error.path}: ${error.message}`).join("\n"));
-		doc = parsed.document;
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		return {
-			ok: false,
-			action: "pipeline",
-			error: {
-				code: "VALIDATION_FAILED",
-				message: msg
-			},
-			text: msg
-		};
-	}
-	const validationErrors = [];
-	validateSteps(doc.pipeline, "pipeline", registry, validationErrors);
-	validateSteps(doc.onError ?? [], "on_error", registry, validationErrors);
-	if (validationErrors.length > 0) {
-		const msg = validationErrors.map((e) => `${e.path}: ${e.message}`).join("\n");
-		return {
-			ok: false,
-			action: "pipeline",
-			error: {
-				code: "VALIDATION_FAILED",
-				message: msg
-			},
-			text: msg
-		};
-	}
-	if (options.dryRun) return {
-		ok: true,
-		action: "pipeline",
-		text: `Pipeline "${doc.name}" validated successfully (${doc.pipeline.length} steps).`,
-		data: {
-			name: doc.name,
-			steps: doc.pipeline.length,
-			args: Object.keys(doc.args)
-		}
-	};
-	let args;
-	try {
-		args = resolveArgs(doc, argOverrides);
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		return {
-			ok: false,
-			action: "pipeline",
-			error: {
-				code: "ARG_RESOLUTION_FAILED",
-				message: msg
-			},
-			text: msg
-		};
-	}
-	const output = createPipelineOutput(doc.name);
-	const runtime = {
-		doc,
-		args,
-		last: void 0,
-		outputs: [],
-		vars: {}
-	};
-	log.info({
-		pipeline: doc.name,
-		steps: doc.pipeline.length
-	}, `Running pipeline: ${doc.name}`);
-	try {
-		const timeoutController = new AbortController();
-		const runContext = {
-			...ctx,
-			signal: ctx.signal ? AbortSignal.any([ctx.signal, timeoutController.signal]) : timeoutController.signal
-		};
-		const run = executePipeline(doc.pipeline, "pipeline", runtime, runContext, registry, output, options);
-		if (doc.timeoutSeconds && doc.timeoutSeconds > 0) await Promise.race([run, setTimeout(doc.timeoutSeconds * 1e3, void 0, { signal: ctx.signal }).then(() => {
-			timeoutController.abort();
-			throw actionError("PIPELINE_TIMEOUT", `Pipeline timed out after ${doc.timeoutSeconds} seconds`);
-		})]);
-		else await run;
-	} catch (error) {
-		const failure = error instanceof Error ? error : new Error(String(error));
-		const code = failure.code ?? "PIPELINE_FAILED";
-		runtime.error ??= {
-			code,
-			message: failure.message
-		};
-		output.ok = false;
-		output.error ??= {
-			step: output.trace.length,
-			action: "pipeline",
-			code,
-			message: failure.message
-		};
-	}
-	output.last = runtime.last;
-	output.outputs = runtime.outputs;
-	if (!output.ok && doc.onError && doc.onError.length > 0) {
-		log.info({ pipeline: doc.name }, "Running on_error diagnostics");
-		try {
-			await executePipeline(doc.onError, "on_error", runtime, ctx, registry, output, options);
-		} catch {}
-		output.last = runtime.last;
-		output.outputs = runtime.outputs;
-	}
-	return formatPipelineResult(output);
-}
-//#endregion
-export { runBrowserPipeline, validateBrowserPipeline };

package/dist/src/browser/pipeline/schema.d.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-export declare const BROWSER_RECIPE_API_VERSION: "xopc.ai/browser-recipe/v1";
-declare const PipelineArgSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        string: "string";
-        number: "number";
-        boolean: "boolean";
-        integer: "integer";
-    }>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    default: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-    description: z.ZodOptional<z.ZodString>;
-    choices: z.ZodOptional<z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-}, z.core.$strict>;
-export type PipelineArgDef = z.infer<typeof PipelineArgSchema>;
-export interface PipelineStep {
-    action: string;
-    args: Record<string, unknown>;
-}
-export interface PipelineDocument {
-    apiVersion: typeof BROWSER_RECIPE_API_VERSION;
-    id: string;
-    name: string;
-    description?: string;
-    risk: 'read_only' | 'account_write' | 'sensitive';
-    domains: string[];
-    timeoutSeconds?: number;
-    args: Record<string, PipelineArgDef>;
-    pipeline: PipelineStep[];
-    onError?: PipelineStep[];
-}
-export interface PipelineValidationError {
-    path: string;
-    message: string;
-}
-export interface PipelineParseResult {
-    ok: boolean;
-    document?: PipelineDocument;
-    errors: PipelineValidationError[];
-}
-export declare function parseBrowserPipeline(yamlSource: string): PipelineParseResult;
-export {};