@jingyi0605/codingns 0.7.4 → 0.8.1

package/dist/server/modules/browser-runtime/browser-runtime-controller.d.ts

@@ -0,0 +1,70 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { BrowserEngine, BrowserProfileMode, BrowserProfileOwnershipScope, OfficeRiskLevel } from "../../types/domain.js";
+import { BrowserRuntimeService } from "./browser-runtime-service.js";
+import type { BrowserExecutionBackend, BrowserSessionRequirement } from "./browser-task-payload.js";
+interface BrowserProfileListQuery {
+    workspaceId?: string;
+}
+interface CreateBrowserProfileBody {
+    workspaceId?: string | null;
+    engine?: BrowserEngine;
+    mode?: BrowserProfileMode;
+    displayName?: string | null;
+    ownershipScope?: BrowserProfileOwnershipScope;
+    cdpEndpoint?: string | null;
+}
+interface UpdateBrowserProfileBody {
+    ownershipScope?: BrowserProfileOwnershipScope;
+}
+interface CreateBrowserTaskBody {
+    workspaceId?: string | null;
+    title?: string;
+    profileId?: string;
+    riskLevel?: OfficeRiskLevel;
+    executionBackend?: BrowserExecutionBackend;
+    sessionRequirement?: BrowserSessionRequirement;
+    input?: unknown;
+}
+interface BrowserTaskParams {
+    taskId: string;
+}
+interface BrowserProfileParams {
+    profileId: string;
+}
+export declare class BrowserRuntimeController {
+    private readonly browserRuntimeService;
+    constructor(browserRuntimeService: BrowserRuntimeService);
+    readonly listProfiles: (request: FastifyRequest<{
+        Querystring: BrowserProfileListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createProfile: (request: FastifyRequest<{
+        Body: CreateBrowserProfileBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createTask: (request: FastifyRequest<{
+        Body: CreateBrowserTaskBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getProfile: (request: FastifyRequest<{
+        Params: BrowserProfileParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateProfile: (request: FastifyRequest<{
+        Params: BrowserProfileParams;
+        Body: UpdateBrowserProfileBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly deleteProfile: (request: FastifyRequest<{
+        Params: BrowserProfileParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly attachCdp: (request: FastifyRequest<{
+        Body: CreateBrowserProfileBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly executeTask: (request: FastifyRequest<{
+        Params: BrowserTaskParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getExecution: (request: FastifyRequest<{
+        Params: BrowserTaskParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getBridgeStatus: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly cancelExecution: (request: FastifyRequest<{
+        Params: BrowserTaskParams;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};

package/dist/server/modules/browser-runtime/browser-runtime-controller.js

@@ -0,0 +1,84 @@
+import { requireUserId } from "../preferences/common.js";
+export class BrowserRuntimeController {
+    browserRuntimeService;
+    constructor(browserRuntimeService) {
+        this.browserRuntimeService = browserRuntimeService;
+    }
+    listProfiles = async (request, reply) => {
+        reply.send({
+            items: this.browserRuntimeService.listProfiles(requireUserId(request), normalizeOptionalText(request.query.workspaceId))
+        });
+    };
+    createProfile = async (request, reply) => {
+        reply.send(this.browserRuntimeService.createProfile({
+            userId: requireUserId(request),
+            workspaceId: normalizeOptionalText(request.body.workspaceId),
+            engine: request.body.engine ?? "chrome",
+            mode: request.body.mode,
+            displayName: request.body.displayName,
+            ownershipScope: request.body.ownershipScope,
+            cdpEndpoint: request.body.cdpEndpoint
+        }));
+    };
+    createTask = async (request, reply) => {
+        reply.send(this.browserRuntimeService.createBrowserTask({
+            userId: requireUserId(request),
+            workspaceId: normalizeOptionalText(request.body.workspaceId),
+            title: request.body.title?.trim() || "浏览器任务",
+            profileId: request.body.profileId?.trim() || "",
+            riskLevel: request.body.riskLevel,
+            executionBackend: request.body.executionBackend,
+            sessionRequirement: request.body.sessionRequirement,
+            input: request.body.input
+        }));
+    };
+    getProfile = async (request, reply) => {
+        reply.send(this.browserRuntimeService.getProfile(request.params.profileId, requireUserId(request)));
+    };
+    updateProfile = async (request, reply) => {
+        reply.send(this.browserRuntimeService.updateProfile({
+            userId: requireUserId(request),
+            profileId: request.params.profileId,
+            ownershipScope: request.body.ownershipScope
+        }));
+    };
+    deleteProfile = async (request, reply) => {
+        reply.send(this.browserRuntimeService.deleteProfile(request.params.profileId, requireUserId(request)));
+    };
+    attachCdp = async (request, reply) => {
+        reply.send(this.browserRuntimeService.attachCdpProfile({
+            userId: requireUserId(request),
+            workspaceId: normalizeOptionalText(request.body.workspaceId),
+            engine: request.body.engine ?? "chrome",
+            mode: "cdp_attached",
+            displayName: request.body.displayName,
+            ownershipScope: request.body.ownershipScope,
+            cdpEndpoint: request.body.cdpEndpoint
+        }));
+    };
+    executeTask = async (request, reply) => {
+        reply.send(await this.browserRuntimeService.executeBrowserTask(request.params.taskId, requireUserId(request)));
+    };
+    getExecution = async (request, reply) => {
+        reply.send({
+            task: this.browserRuntimeService.getExecutionSnapshot(request.params.taskId, requireUserId(request))
+        });
+    };
+    getBridgeStatus = async (_request, reply) => {
+        reply.send(await this.browserRuntimeService.getBridgeStatus());
+    };
+    cancelExecution = async (request, reply) => {
+        reply.send(this.browserRuntimeService.cancelExecution(request.params.taskId, requireUserId(request)));
+    };
+}
+function normalizeOptionalText(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=browser-runtime-controller.js.map

package/dist/server/modules/browser-runtime/browser-runtime-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime-controller.js","sourceRoot":"","sources":["../../../../src/modules/browser-runtime/browser-runtime-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/browser-runtime/browser-runtime-service.d.ts

@@ -0,0 +1,59 @@
+import type { BrowserProfile } from "../../types/domain.js";
+import type { OfficeTaskRepository } from "../../storage/repositories/office-task-repository.js";
+import type { CreateOfficeTaskInput, OfficeService } from "../office/office-service.js";
+import type { TaskManager } from "../tasks/task-manager.js";
+import { type TaskSnapshot } from "../tasks/task-types.js";
+import { BrowserProfileService } from "./browser-profile-service.js";
+import type { BrowserTaskExecutor } from "./browser-task-executor.js";
+import { type BrowserExecutionBackend, type BrowserSessionRequirement } from "./browser-task-payload.js";
+import type { BrowserBridgeStatusDto, OpenCliBrowserBridgeService } from "./opencli-browser-bridge-service.js";
+export interface CreateBrowserTaskInput {
+    userId: string;
+    workspaceId?: string | null;
+    title: string;
+    profileId?: string | null;
+    executionBackend?: BrowserExecutionBackend;
+    sessionRequirement?: BrowserSessionRequirement;
+    input?: unknown;
+    riskLevel?: CreateOfficeTaskInput["riskLevel"];
+}
+export declare class BrowserRuntimeService {
+    private readonly browserProfileService;
+    private readonly officeService;
+    private readonly officeTaskRepository;
+    private readonly openCliBrowserBridgeService;
+    private readonly taskManager;
+    private readonly executorRegistry;
+    constructor(browserProfileService: BrowserProfileService, officeService: OfficeService, officeTaskRepository: OfficeTaskRepository, browserExecutors: BrowserTaskExecutor[], openCliBrowserBridgeService: OpenCliBrowserBridgeService, taskManager: TaskManager);
+    listProfiles(userId: string, workspaceId?: string | null): BrowserProfile[];
+    getProfile(profileId: string, userId: string): BrowserProfile;
+    createProfile(input: Parameters<BrowserProfileService["createProfile"]>[0]): BrowserProfile;
+    updateProfile(input: Parameters<BrowserProfileService["updateProfile"]>[0]): BrowserProfile;
+    deleteProfile(profileId: string, userId: string): {
+        profileId: string;
+        deleted: true;
+    };
+    attachCdpProfile(input: Parameters<BrowserProfileService["createProfile"]>[0]): BrowserProfile;
+    createBrowserTask(input: CreateBrowserTaskInput): {
+        task: import("../../types/domain.js").OfficeTask;
+        requiresApproval: boolean;
+    };
+    private resolveSessionRequirement;
+    private assertSessionRequirementCompatible;
+    private requirePlaywrightProfile;
+    getBridgeStatus(): Promise<BrowserBridgeStatusDto>;
+    executeBrowserTask(taskId: string, userId: string): Promise<{
+        taskId: string;
+        executionTaskId: string;
+        deduped: boolean;
+    }>;
+    getExecutionSnapshot(taskId: string, userId: string): TaskSnapshot | null;
+    cancelExecution(taskId: string, userId: string): {
+        taskId: string;
+        cancelled: boolean;
+    };
+    private registerBackgroundTask;
+    private requireExecutableTask;
+    private requirePlaywrightExecutionProfile;
+    private requireOwnedBrowserTask;
+}

package/dist/server/modules/browser-runtime/browser-runtime-service.js

@@ -0,0 +1,255 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { HOST_TASK_TYPES } from "../tasks/task-types.js";
+import { BrowserTaskExecutorRegistry } from "./browser-task-executor-registry.js";
+import { normalizeBrowserExecutionBackend, normalizeBrowserTaskActions, normalizeBrowserTaskPayloadShape, normalizeOptionalText, parseBrowserTaskPayload } from "./browser-task-payload.js";
+export class BrowserRuntimeService {
+    browserProfileService;
+    officeService;
+    officeTaskRepository;
+    openCliBrowserBridgeService;
+    taskManager;
+    executorRegistry;
+    constructor(browserProfileService, officeService, officeTaskRepository, browserExecutors, openCliBrowserBridgeService, taskManager) {
+        this.browserProfileService = browserProfileService;
+        this.officeService = officeService;
+        this.officeTaskRepository = officeTaskRepository;
+        this.openCliBrowserBridgeService = openCliBrowserBridgeService;
+        this.taskManager = taskManager;
+        this.executorRegistry = new BrowserTaskExecutorRegistry(browserExecutors);
+        this.registerBackgroundTask();
+    }
+    listProfiles(userId, workspaceId) {
+        return this.browserProfileService.listProfiles(userId, workspaceId);
+    }
+    getProfile(profileId, userId) {
+        return this.browserProfileService.getProfile(profileId, userId);
+    }
+    createProfile(input) {
+        return this.browserProfileService.createProfile(input);
+    }
+    updateProfile(input) {
+        return this.browserProfileService.updateProfile(input);
+    }
+    deleteProfile(profileId, userId) {
+        const tasks = this.officeTaskRepository.list({
+            userId,
+            taskType: "browser"
+        }).filter((task) => task.targetRefId === profileId);
+        const blockingTask = tasks.find((task) => task.status === "running"
+            || task.status === "paused"
+            || task.status === "waiting_external");
+        if (blockingTask) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "BROWSER_PROFILE_TASK_IN_USE",
+                detail: "当前浏览器 Profile 仍有关联任务正在执行或等待外部完成，暂时不能删除"
+            });
+        }
+        for (const task of tasks) {
+            if (task.status === "draft" || task.status === "pending_approval" || task.status === "ready") {
+                this.officeService.cancelTask(task.id, userId);
+            }
+        }
+        this.browserProfileService.deleteProfile(profileId, userId);
+        return {
+            profileId,
+            deleted: true
+        };
+    }
+    attachCdpProfile(input) {
+        return this.browserProfileService.createProfile({
+            ...input,
+            mode: "cdp_attached"
+        });
+    }
+    createBrowserTask(input) {
+        const payload = normalizeBrowserTaskPayloadShape(input.input);
+        const sessionRequirement = this.resolveSessionRequirement(input, payload);
+        const executionBackend = normalizeBrowserExecutionBackend(input.executionBackend ?? payload.executionBackend);
+        this.assertSessionRequirementCompatible(sessionRequirement, executionBackend);
+        const taskInput = {
+            ...payload,
+            sessionRequirement,
+            executionBackend,
+            startUrl: normalizeOptionalText(payload.startUrl),
+            actions: normalizeBrowserTaskActions(input.input)
+        };
+        if (executionBackend === "opencli_bridge") {
+            return this.officeService.createTask({
+                userId: input.userId,
+                workspaceId: input.workspaceId ?? null,
+                taskType: "browser",
+                title: input.title,
+                connectorId: "browser.opencli_bridge",
+                targetRefKind: "browser_bridge",
+                targetRefId: null,
+                input: taskInput,
+                riskLevel: input.riskLevel ?? "low"
+            });
+        }
+        const profile = this.requirePlaywrightProfile(input.userId, input.profileId ?? null);
+        return this.officeService.createTask({
+            userId: input.userId,
+            workspaceId: input.workspaceId ?? profile.workspaceId,
+            taskType: "browser",
+            title: input.title,
+            connectorId: "browser.playwright",
+            targetRefKind: "browser_profile",
+            targetRefId: profile.id,
+            input: {
+                profileId: profile.id,
+                engine: profile.engine,
+                mode: profile.mode,
+                ...taskInput
+            },
+            riskLevel: input.riskLevel ?? "low"
+        });
+    }
+    resolveSessionRequirement(input, payload) {
+        if (input.sessionRequirement === "reuse_current_logged_in_browser") {
+            return "reuse_current_logged_in_browser";
+        }
+        if (payload.sessionRequirement === "reuse_current_logged_in_browser") {
+            return "reuse_current_logged_in_browser";
+        }
+        const combinedText = [
+            input.title,
+            normalizeOptionalText(payload.startUrl) ?? "",
+            ...normalizeBrowserTaskActions(input.input).flatMap((action) => [
+                normalizeOptionalText(action.url) ?? "",
+                normalizeOptionalText(action.selector) ?? "",
+                normalizeOptionalText(action.value) ?? "",
+                normalizeOptionalText(action.key) ?? ""
+            ])
+        ]
+            .join("\n")
+            .toLowerCase();
+        if (/(淘宝|京东|订单|购物车|待收货|待付款|个人账户|登录态|已登录|验证码|后台|管理后台|商家后台|edge|chrome)/i.test(combinedText)) {
+            return "reuse_current_logged_in_browser";
+        }
+        return "none";
+    }
+    assertSessionRequirementCompatible(sessionRequirement, executionBackend) {
+        if (sessionRequirement !== "reuse_current_logged_in_browser") {
+            return;
+        }
+        if (executionBackend === "opencli_bridge") {
+            return;
+        }
+        throw new AppError({
+            statusCode: 409,
+            errorCode: "BROWSER_SESSION_REQUIREMENT_CONFLICT",
+            detail: "当前任务要求复用已登录浏览器会话，必须使用 opencli_bridge，不能降级到 playwright"
+        });
+    }
+    requirePlaywrightProfile(userId, requestedProfileId) {
+        const profileId = requestedProfileId?.trim() ?? "";
+        if (profileId.length === 0) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "BROWSER_PROFILE_REQUIRED",
+                detail: "playwright 浏览器任务必须提供 profileId"
+            });
+        }
+        const profile = this.browserProfileService.getProfile(profileId, userId);
+        if (profile.status !== "active") {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "BROWSER_PROFILE_NOT_ACTIVE",
+                detail: "当前浏览器 Profile 不可用"
+            });
+        }
+        return profile;
+    }
+    async getBridgeStatus() {
+        return await this.openCliBrowserBridgeService.getStatus();
+    }
+    async executeBrowserTask(taskId, userId) {
+        const task = this.requireExecutableTask(taskId, userId);
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.officeBrowserTaskExecute, {
+            key: task.id,
+            source: "office.browser_task.execute",
+            input: {
+                taskId: task.id,
+                userId
+            }
+        });
+        void handle.promise.catch(() => undefined);
+        return {
+            taskId: task.id,
+            executionTaskId: handle.taskId,
+            deduped: handle.deduped
+        };
+    }
+    getExecutionSnapshot(taskId, userId) {
+        this.requireOwnedBrowserTask(taskId, userId);
+        return this.taskManager.peek(HOST_TASK_TYPES.officeBrowserTaskExecute, taskId.trim());
+    }
+    cancelExecution(taskId, userId) {
+        const task = this.requireOwnedBrowserTask(taskId, userId);
+        this.taskManager.cancel(HOST_TASK_TYPES.officeBrowserTaskExecute, task.id, "office_browser_task_cancelled");
+        return {
+            taskId: task.id,
+            cancelled: true
+        };
+    }
+    registerBackgroundTask() {
+        if (this.taskManager.has(HOST_TASK_TYPES.officeBrowserTaskExecute)) {
+            return;
+        }
+        this.taskManager.register({
+            taskType: HOST_TASK_TYPES.officeBrowserTaskExecute,
+            executionLane: "host_background",
+            timeoutMs: 180_000,
+            concurrency: 1,
+            run: async (input, context) => {
+                const task = this.requireExecutableTask(input.taskId, input.userId);
+                const payload = parseBrowserTaskPayload(task.inputJson);
+                const executionBackend = normalizeBrowserExecutionBackend(payload.executionBackend);
+                const executor = this.executorRegistry.get(executionBackend);
+                const profile = executionBackend === "playwright"
+                    ? this.requirePlaywrightExecutionProfile(task, input.userId)
+                    : undefined;
+                return await executor.execute({
+                    task,
+                    profile,
+                    runContext: context
+                });
+            }
+        });
+    }
+    requireExecutableTask(taskId, userId) {
+        const task = this.requireOwnedBrowserTask(taskId, userId);
+        if (task.status !== "ready" && task.status !== "failed") {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "BROWSER_TASK_EXECUTION_NOT_ALLOWED",
+                detail: "当前任务状态不允许执行"
+            });
+        }
+        return task;
+    }
+    requirePlaywrightExecutionProfile(task, userId) {
+        const profile = this.browserProfileService.getProfile(task.targetRefId ?? "", userId);
+        if (profile.status !== "active") {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "BROWSER_PROFILE_NOT_ACTIVE",
+                detail: "当前浏览器 Profile 不可用"
+            });
+        }
+        return profile;
+    }
+    requireOwnedBrowserTask(taskId, userId) {
+        const task = this.officeTaskRepository.findById(taskId.trim());
+        if (!task || task.userId !== userId || task.taskType !== "browser") {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "BROWSER_TASK_NOT_FOUND",
+                detail: "未找到对应浏览器任务"
+            });
+        }
+        return task;
+    }
+}
+//# sourceMappingURL=browser-runtime-service.js.map

package/dist/server/modules/browser-runtime/browser-runtime-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime-service.js","sourceRoot":"","sources":["../../../../src/modules/browser-runtime/browser-runtime-service.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/browser-runtime/browser-task-execution-support.d.ts

@@ -0,0 +1,65 @@
+import type { OfficeArtifactRepository } from "../../storage/repositories/office-artifact-repository.js";
+import type { OfficeAuditEventRepository } from "../../storage/repositories/office-audit-event-repository.js";
+import type { OfficeReceiptRepository } from "../../storage/repositories/office-receipt-repository.js";
+import type { OfficeTaskRepository } from "../../storage/repositories/office-task-repository.js";
+import type { OfficeTaskStepRepository } from "../../storage/repositories/office-task-step-repository.js";
+import type { BrowserProfile, OfficeArtifact, OfficeReceipt, OfficeTask, OfficeTaskStep } from "../../types/domain.js";
+import { type TaskRunContext } from "../tasks/task-types.js";
+import type { BrowserStepResult, BrowserTaskArtifactInput, BrowserTaskExecutionReceiptPayload, BrowserTaskStepLifecyclePort } from "./browser-task-executor.js";
+import type { BrowserExecutionBackend, BrowserTaskAction, BrowserTaskPayload } from "./browser-task-payload.js";
+export interface BrowserTaskExecutionPersistenceDeps {
+    databasePath: string;
+    officeTaskRepository: OfficeTaskRepository;
+    officeTaskStepRepository: OfficeTaskStepRepository;
+    officeArtifactRepository: OfficeArtifactRepository;
+    officeReceiptRepository: OfficeReceiptRepository;
+    officeAuditEventRepository: OfficeAuditEventRepository;
+}
+export declare class BrowserTaskExecutionPersistence implements BrowserTaskStepLifecyclePort {
+    private readonly backend;
+    private readonly deps;
+    private readonly artifactRoot;
+    constructor(backend: BrowserExecutionBackend, deps: BrowserTaskExecutionPersistenceDeps);
+    markTaskRunning(task: OfficeTask): OfficeTask;
+    markTaskSucceeded(task: OfficeTask, payload: BrowserTaskExecutionReceiptPayload): {
+        task: OfficeTask;
+        receipt: OfficeReceipt;
+    };
+    markTaskFailed(task: OfficeTask, reason: string): OfficeTask;
+    createStep(task: OfficeTask, stepSeq: number, action: BrowserTaskAction): OfficeTaskStep;
+    startStep(step: OfficeTaskStep): OfficeTaskStep;
+    finishStep(step: OfficeTaskStep, outputJson: string): OfficeTaskStep;
+    failStep(step: OfficeTaskStep, errorMessage: string): OfficeTaskStep;
+    createTextArtifact(task: OfficeTask, step: OfficeTaskStep, input: BrowserTaskArtifactInput & {
+        content: string;
+    }): OfficeArtifact;
+    createBinaryArtifact(task: OfficeTask, step: OfficeTaskStep, input: BrowserTaskArtifactInput & {
+        content: Buffer;
+    }): OfficeArtifact;
+    createFileArtifact(task: OfficeTask, step: OfficeTaskStep, input: BrowserTaskArtifactInput & {
+        sourceFilePath: string;
+        metadata?: Record<string, unknown>;
+    }): OfficeArtifact;
+    private recordArtifactAudit;
+    private ensureArtifactDir;
+}
+export declare function runBrowserTaskActions(input: {
+    task: OfficeTask;
+    payload: BrowserTaskPayload;
+    backend: BrowserExecutionBackend;
+    runContext?: TaskRunContext;
+    lifecycle: BrowserTaskStepLifecyclePort;
+    executeAction: (action: BrowserTaskAction, step: OfficeTaskStep, runContext?: TaskRunContext) => Promise<BrowserStepResult>;
+    getFinalUrl: () => string | null | Promise<string | null>;
+}): Promise<{
+    task: OfficeTask;
+    receipt: OfficeReceipt;
+    stepResults: BrowserStepResult[];
+}>;
+export declare function ensureBrowserExecutablePath(databasePath: string, configPath: string, engine: BrowserProfile["engine"]): string;
+export declare function requireString(value: string | undefined, field: string): string;
+export declare function normalizeStringArray(values: string[] | undefined, singleValue: string | undefined, field: string): string[];
+export declare function normalizeFilePaths(filePaths: string[] | undefined, singleFilePath: string | undefined): string[];
+export declare function normalizeFileName(fileName: string | undefined, fallback: string): string;
+export declare function buildStepTitle(action: BrowserTaskAction): string;
+export declare function ensureNotCancelled(runContext?: TaskRunContext): void;