@xopcai/xopc 0.0.251 → 0.0.252

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

@@ -1,116 +0,0 @@
-import { z } from "zod";
-import yaml from "js-yaml";
-//#region src/browser/pipeline/schema.ts
-const BROWSER_RECIPE_API_VERSION = "xopc.ai/browser-recipe/v1";
-const IdSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(100);
-const JsonValueSchema = z.lazy(() => z.union([
-	z.string(),
-	z.number(),
-	z.boolean(),
-	z.null(),
-	z.array(JsonValueSchema),
-	z.record(z.string(), JsonValueSchema)
-]));
-const PipelineArgSchema = z.object({
-	type: z.enum([
-		"string",
-		"number",
-		"integer",
-		"boolean"
-	]),
-	required: z.boolean().optional(),
-	default: JsonValueSchema.optional(),
-	description: z.string().max(500).optional(),
-	choices: z.array(JsonValueSchema).optional()
-}).strict().superRefine((definition, ctx) => {
-	const matchesType = (value) => {
-		if (definition.type === "string") return typeof value === "string";
-		if (definition.type === "boolean") return typeof value === "boolean";
-		if (definition.type === "integer") return typeof value === "number" && Number.isInteger(value);
-		return typeof value === "number" && Number.isFinite(value);
-	};
-	if (definition.default !== void 0 && !matchesType(definition.default)) ctx.addIssue({
-		code: "custom",
-		path: ["default"],
-		message: `Default must match arg type ${definition.type}.`
-	});
-	definition.choices?.forEach((choice, index) => {
-		if (!matchesType(choice)) ctx.addIssue({
-			code: "custom",
-			path: ["choices", index],
-			message: `Choice must match arg type ${definition.type}.`
-		});
-	});
-});
-const DomainSchema = z.string().trim().toLowerCase().regex(/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/, "Domain must be a hostname without scheme, path, port, or wildcard.");
-const StepSchema = z.record(z.string(), z.record(z.string(), z.unknown())).superRefine((step, ctx) => {
-	if (Object.keys(step).length !== 1) ctx.addIssue({
-		code: "custom",
-		message: "Each step must contain exactly one action."
-	});
-});
-const RecipeSchema = z.object({
-	apiVersion: z.literal(BROWSER_RECIPE_API_VERSION),
-	id: IdSchema,
-	name: z.string().trim().min(1).max(200),
-	description: z.string().max(2e3).optional(),
-	risk: z.enum([
-		"read_only",
-		"account_write",
-		"sensitive"
-	]),
-	domains: z.array(DomainSchema).min(1),
-	timeoutSeconds: z.number().int().min(1).max(3600).optional(),
-	args: z.record(z.string(), PipelineArgSchema).default({}),
-	pipeline: z.array(StepSchema).min(1),
-	on_error: z.array(StepSchema).optional()
-}).strict();
-function stepsFromRaw(steps) {
-	return steps.map((step) => {
-		const [action, args] = Object.entries(step)[0];
-		return {
-			action,
-			args
-		};
-	});
-}
-function parseBrowserPipeline(yamlSource) {
-	let raw;
-	try {
-		raw = yaml.load(yamlSource);
-	} catch (error) {
-		return {
-			ok: false,
-			errors: [{
-				path: "",
-				message: `YAML parse error: ${error instanceof Error ? error.message : String(error)}`
-			}]
-		};
-	}
-	const parsed = RecipeSchema.safeParse(raw);
-	if (!parsed.success) return {
-		ok: false,
-		errors: parsed.error.issues.map((issue) => ({
-			path: issue.path.join("."),
-			message: issue.message
-		}))
-	};
-	return {
-		ok: true,
-		document: {
-			apiVersion: parsed.data.apiVersion,
-			id: parsed.data.id,
-			name: parsed.data.name,
-			description: parsed.data.description,
-			risk: parsed.data.risk,
-			domains: parsed.data.domains,
-			timeoutSeconds: parsed.data.timeoutSeconds,
-			args: parsed.data.args,
-			pipeline: stepsFromRaw(parsed.data.pipeline),
-			onError: parsed.data.on_error ? stepsFromRaw(parsed.data.on_error) : void 0
-		},
-		errors: []
-	};
-}
-//#endregion
-export { BROWSER_RECIPE_API_VERSION, parseBrowserPipeline };

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

@@ -1,30 +0,0 @@
-/**
- * Pipeline template expression engine.
- *
- * Supports: ${{ args.xxx }}, ${{ last }}, ${{ outputs.0 }}, ${{ vars.name }},
- * ${{ error.message }} and simple pipe filters.
- * Does NOT execute arbitrary JavaScript — only whitelisted expressions.
- */
-export interface TemplateContext {
-    args: Record<string, unknown>;
-    last: unknown;
-    outputs: unknown[];
-    vars: Record<string, unknown>;
-    error?: {
-        code?: string;
-        message?: string;
-    };
-}
-export declare function resolvePath(obj: unknown, path: string): unknown;
-export declare function isTruthyValue(value: unknown): boolean;
-export declare function valueContains(actual: unknown, expected: unknown): boolean;
-export declare function evaluateRawExpression(expr: string, ctx: TemplateContext): unknown;
-/**
- * Resolve all `${{ ... }}` expressions in a string.
- */
-export declare function resolveTemplate(template: string, ctx: TemplateContext): string;
-export declare function resolveTemplateValue(value: string, ctx: TemplateContext): unknown;
-/**
- * Deep-resolve templates in an object/array/string value.
- */
-export declare function resolveTemplateDeep(value: unknown, ctx: TemplateContext): unknown;

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

@@ -1,112 +0,0 @@
-//#region src/browser/pipeline/template.ts
-/**
-* Pipeline template expression engine.
-*
-* Supports: ${{ args.xxx }}, ${{ last }}, ${{ outputs.0 }}, ${{ vars.name }},
-* ${{ error.message }} and simple pipe filters.
-* Does NOT execute arbitrary JavaScript — only whitelisted expressions.
-*/
-const TEMPLATE_RE = /\$\{\{\s*(.+?)\s*\}\}/g;
-function parsePath(path) {
-	return path.replace(/\[(\d+)\]/g, ".$1").split(".").map((part) => part.trim()).filter(Boolean);
-}
-function resolvePath(obj, path) {
-	const parts = parsePath(path);
-	let current = obj;
-	for (const part of parts) {
-		if (current === null || current === void 0) return void 0;
-		if (Array.isArray(current)) {
-			const index = Number(part);
-			if (!Number.isInteger(index)) return void 0;
-			current = current[index];
-		} else if (typeof current === "object") current = current[part];
-		else return;
-	}
-	return current;
-}
-function applyFilter(value, filter) {
-	switch (filter.trim()) {
-		case "json": return JSON.stringify(value, null, 2) ?? "null";
-		case "string": return String(value ?? "");
-		case "number": return String(Number(value));
-		case "boolean": return String(Boolean(value));
-		case "urlencode": return encodeURIComponent(String(value ?? ""));
-		default: return String(value ?? "");
-	}
-}
-function isTruthyValue(value) {
-	if (value === null || value === void 0 || value === false) return false;
-	if (typeof value === "number") return Number.isFinite(value) && value !== 0;
-	if (typeof value === "string") return value.length > 0 && value !== "false" && value !== "0";
-	if (Array.isArray(value)) return value.length > 0;
-	return true;
-}
-function valueContains(actual, expected) {
-	if (typeof actual === "string") return actual.includes(String(expected));
-	if (Array.isArray(actual)) return actual.some((item) => JSON.stringify(item) === JSON.stringify(expected));
-	if (actual && typeof actual === "object") return JSON.stringify(actual).includes(String(expected));
-	return String(actual ?? "").includes(String(expected));
-}
-function evaluateRawExpression(expr, ctx) {
-	const pipeIdx = expr.indexOf("|");
-	let path = expr;
-	let filter;
-	if (pipeIdx > 0) {
-		path = expr.slice(0, pipeIdx).trim();
-		filter = expr.slice(pipeIdx + 1).trim();
-	}
-	let value;
-	if (path === "last") value = ctx.last;
-	else if (path.startsWith("last.")) value = resolvePath(ctx.last, path.slice(5));
-	else if (path.startsWith("args.")) value = resolvePath(ctx.args, path.slice(5));
-	else if (path === "outputs") value = ctx.outputs;
-	else if (path.startsWith("outputs.")) value = resolvePath(ctx.outputs, path.slice(8));
-	else if (path === "vars") value = ctx.vars;
-	else if (path.startsWith("vars.")) value = resolvePath(ctx.vars, path.slice(5));
-	else if (path.startsWith("error.")) value = resolvePath(ctx.error, path.slice(6));
-	else if (path === "error") value = ctx.error?.message ?? "";
-	else {
-		value = resolvePath(ctx.args, path);
-		if (value === void 0) return `\${{ ${expr} }}`;
-	}
-	if (filter) return applyFilter(value, filter);
-	return value;
-}
-function stringifyTemplateValue(value) {
-	if (value === void 0 || value === null) return "";
-	if (typeof value === "string") return value;
-	if (typeof value === "number" || typeof value === "boolean") return String(value);
-	return JSON.stringify(value);
-}
-function evaluateExpression(expr, ctx) {
-	return stringifyTemplateValue(evaluateRawExpression(expr, ctx));
-}
-/**
-* Resolve all `${{ ... }}` expressions in a string.
-*/
-function resolveTemplate(template, ctx) {
-	return template.replace(TEMPLATE_RE, (_match, expr) => {
-		return evaluateExpression(expr.trim(), ctx);
-	});
-}
-function resolveTemplateValue(value, ctx) {
-	const trimmed = value.trim();
-	const match = /^\$\{\{\s*(.+?)\s*\}\}$/.exec(trimmed);
-	if (!match) return resolveTemplate(value, ctx);
-	return evaluateRawExpression(match[1].trim(), ctx);
-}
-/**
-* Deep-resolve templates in an object/array/string value.
-*/
-function resolveTemplateDeep(value, ctx) {
-	if (typeof value === "string") return resolveTemplateValue(value, ctx);
-	if (Array.isArray(value)) return value.map((item) => resolveTemplateDeep(item, ctx));
-	if (value && typeof value === "object") {
-		const result = {};
-		for (const [k, v] of Object.entries(value)) result[resolveTemplate(k, ctx)] = resolveTemplateDeep(v, ctx);
-		return result;
-	}
-	return value;
-}
-//#endregion
-export { evaluateRawExpression, isTruthyValue, resolvePath, resolveTemplate, resolveTemplateDeep, resolveTemplateValue, valueContains };

package/dist/src/browser/providers/cloakbrowser.d.ts

@@ -1,83 +0,0 @@
-/**
- * CloakBrowser provider — anti-fingerprint Chromium with stealth capabilities.
- *
- * Manages CloakBrowser binary download, stealth launch, CDP connection,
- * keep-open process reuse, and temporary profile lifecycle.
- *
- * Ported from brocli's cloak.rs to TypeScript, using Playwright's connectOverCDP
- * to produce a standard Browser/BrowserContext pair.
- */
-import { ChildProcess } from 'node:child_process';
-import type { Browser, BrowserContext } from 'playwright-core';
-import type { CloakBrowserConfig } from './types.js';
-interface PlatformInfo {
-    tag: string;
-    chromiumVersion: string;
-    archiveExt: string;
-    executableRelativePath: string;
-    fingerprintPlatform: string;
-    /**
-     * Expected SHA-256 of the downloaded archive (lowercase hex). Empty string =
-     * verification opt-out for this platform; warned but not fatal. To populate:
-     * download the archive once, run `shasum -a 256 <file>`, paste here.
-     */
-    expectedSha256: string;
-}
-/** Test-only: enumerate platform manifests. */
-export declare function listCloakBrowserPlatforms(): PlatformInfo[];
-/** Test-only: resolved download URLs for a platform manifest (proxy first). */
-export declare function cloakBrowserArchiveDownloadUrls(platformInfo: PlatformInfo): string[];
-/** Default CloakBrowser home: ~/.xopc/bin/cloakbrowser (chromium-v*, profiles/, …). */
-export declare function defaultCloakBrowserCacheDir(): string;
-/** Resolve configured or default CloakBrowser cache root. */
-export declare function resolveCloakBrowserCacheDir(configured?: string): string;
-export interface CloakBrowserLaunchResult {
-    browser?: Browser;
-    context?: BrowserContext;
-    childProcess: ChildProcess | null;
-    temporaryProfileDir: string | null;
-    cdpPort: number;
-    userDataDir: string;
-    reused: boolean;
-    pid: number | null;
-}
-/** Resolve the persistent profile directory agents use (not ephemeral temp dirs). */
-export declare function resolveCloakBrowserPersistentProfileDir(config?: CloakBrowserConfig): string;
-export interface CloakBrowserRuntimeStatus {
-    running: boolean;
-    port: number;
-    userDataDir: string;
-    temporaryProfile: boolean;
-}
-/** Probe whether CloakBrowser CDP is listening on the configured keep-open port. */
-export declare function probeCloakBrowserRuntime(config?: CloakBrowserConfig): Promise<CloakBrowserRuntimeStatus>;
-/**
- * Launch or connect to a CloakBrowser instance and return a Playwright Browser + Context.
- */
-export declare function launchCloakBrowser(config?: CloakBrowserConfig): Promise<CloakBrowserLaunchResult>;
-/**
- * Cleanup a CloakBrowser session — kill process and remove temp profile if applicable.
- */
-export declare function cleanupCloakBrowser(childProcess: ChildProcess | null, temporaryProfileDir: string | null): Promise<void>;
-export interface CloakBrowserDoctorResult {
-    installed: boolean;
-    version: string | null;
-    binaryPath: string | null;
-    platform: string;
-    cacheDir: string;
-    expectedSha256: string;
-    /** Primary URL the install flow would fetch from. */
-    downloadUrl: string;
-    /** Fallback URLs (rendered as alternatives in the install confirm dialog). */
-    fallbackUrls: string[];
-    /** True when `binaryPath` was user-supplied (UI should surface a warning). */
-    customBinaryPath: boolean;
-}
-/**
- * Download (if needed), launch headlessly to verify, then return doctor status.
- * Used by gateway install endpoints and CLI.
- */
-export declare function installCloakBrowser(config?: CloakBrowserConfig): Promise<CloakBrowserDoctorResult>;
-/** Check CloakBrowser installation status. */
-export declare function cloakBrowserDoctor(config?: CloakBrowserConfig): Promise<CloakBrowserDoctorResult>;
-export {};