@paperclipai_dld/server 2026.319.0-canary.3

package/dist/services/workspace-operations.d.ts

@@ -0,0 +1,44 @@
+import type { Db } from "@paperclipai_dld/db";
+import { workspaceOperations } from "@paperclipai_dld/db";
+import type { WorkspaceOperation, WorkspaceOperationPhase, WorkspaceOperationStatus } from "@paperclipai_dld/shared";
+type WorkspaceOperationRow = typeof workspaceOperations.$inferSelect;
+declare function toWorkspaceOperation(row: WorkspaceOperationRow): WorkspaceOperation;
+export interface WorkspaceOperationRecorder {
+    attachExecutionWorkspaceId(executionWorkspaceId: string | null): Promise<void>;
+    recordOperation(input: {
+        phase: WorkspaceOperationPhase;
+        command?: string | null;
+        cwd?: string | null;
+        metadata?: Record<string, unknown> | null;
+        run: () => Promise<{
+            status?: WorkspaceOperationStatus;
+            exitCode?: number | null;
+            stdout?: string | null;
+            stderr?: string | null;
+            system?: string | null;
+            metadata?: Record<string, unknown> | null;
+        }>;
+    }): Promise<WorkspaceOperation>;
+}
+export declare function workspaceOperationService(db: Db): {
+    getById: (id: string) => Promise<WorkspaceOperation | null>;
+    createRecorder(input: {
+        companyId: string;
+        heartbeatRunId?: string | null;
+        executionWorkspaceId?: string | null;
+    }): WorkspaceOperationRecorder;
+    listForRun: (runId: string, executionWorkspaceId?: string | null) => Promise<WorkspaceOperation[]>;
+    listForExecutionWorkspace: (executionWorkspaceId: string) => Promise<WorkspaceOperation[]>;
+    readLog: (operationId: string, opts?: {
+        offset?: number;
+        limitBytes?: number;
+    }) => Promise<{
+        content: string;
+        nextOffset?: number;
+        operationId: string;
+        store: string;
+        logRef: string;
+    }>;
+};
+export { toWorkspaceOperation };
+//# sourceMappingURL=workspace-operations.d.ts.map

package/dist/services/workspace-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operations.d.ts","sourceRoot":"","sources":["../../src/services/workspace-operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMrH,KAAK,qBAAqB,GAAG,OAAO,mBAAmB,CAAC,YAAY,CAAC;AAErE,iBAAS,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,kBAAkB,CAwB5E;AAiBD,MAAM,WAAW,0BAA0B;IACzC,0BAA0B,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,eAAe,CAAC,KAAK,EAAE;QACrB,KAAK,EAAE,uBAAuB,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC1C,GAAG,EAAE,MAAM,OAAO,CAAC;YACjB,MAAM,CAAC,EAAE,wBAAwB,CAAC;YAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;SAC3C,CAAC,CAAC;KACJ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,EAAE;kBAGnB,MAAM;0BAYT;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC,GAAG,0BAA0B;wBA4GJ,MAAM,yBAAyB,MAAM,GAAG,IAAI;sDAmBd,MAAM;2BASjC,MAAM,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;EAsBvF;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/services/workspace-operations.js

@@ -0,0 +1,204 @@
+import { randomUUID } from "node:crypto";
+import { workspaceOperations } from "@paperclipai_dld/db";
+import { asc, desc, eq, inArray, isNull, or, and } from "drizzle-orm";
+import { notFound } from "../errors.js";
+import { redactCurrentUserText, redactCurrentUserValue } from "../log-redaction.js";
+import { getWorkspaceOperationLogStore } from "./workspace-operation-log-store.js";
+function toWorkspaceOperation(row) {
+    return {
+        id: row.id,
+        companyId: row.companyId,
+        executionWorkspaceId: row.executionWorkspaceId ?? null,
+        heartbeatRunId: row.heartbeatRunId ?? null,
+        phase: row.phase,
+        command: row.command ?? null,
+        cwd: row.cwd ?? null,
+        status: row.status,
+        exitCode: row.exitCode ?? null,
+        logStore: row.logStore ?? null,
+        logRef: row.logRef ?? null,
+        logBytes: row.logBytes ?? null,
+        logSha256: row.logSha256 ?? null,
+        logCompressed: row.logCompressed,
+        stdoutExcerpt: row.stdoutExcerpt ?? null,
+        stderrExcerpt: row.stderrExcerpt ?? null,
+        metadata: row.metadata ?? null,
+        startedAt: row.startedAt,
+        finishedAt: row.finishedAt ?? null,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+function appendExcerpt(current, chunk) {
+    return `${current}${chunk}`.slice(-4096);
+}
+function combineMetadata(base, patch) {
+    if (!base && !patch)
+        return null;
+    return {
+        ...(base ?? {}),
+        ...(patch ?? {}),
+    };
+}
+export function workspaceOperationService(db) {
+    const logStore = getWorkspaceOperationLogStore();
+    async function getById(id) {
+        const row = await db
+            .select()
+            .from(workspaceOperations)
+            .where(eq(workspaceOperations.id, id))
+            .then((rows) => rows[0] ?? null);
+        return row ? toWorkspaceOperation(row) : null;
+    }
+    return {
+        getById,
+        createRecorder(input) {
+            let executionWorkspaceId = input.executionWorkspaceId ?? null;
+            const createdIds = [];
+            return {
+                async attachExecutionWorkspaceId(nextExecutionWorkspaceId) {
+                    executionWorkspaceId = nextExecutionWorkspaceId ?? null;
+                    if (!executionWorkspaceId || createdIds.length === 0)
+                        return;
+                    await db
+                        .update(workspaceOperations)
+                        .set({
+                        executionWorkspaceId,
+                        updatedAt: new Date(),
+                    })
+                        .where(inArray(workspaceOperations.id, createdIds));
+                },
+                async recordOperation(recordInput) {
+                    const startedAt = new Date();
+                    const id = randomUUID();
+                    const handle = await logStore.begin({
+                        companyId: input.companyId,
+                        operationId: id,
+                    });
+                    let stdoutExcerpt = "";
+                    let stderrExcerpt = "";
+                    const append = async (stream, chunk) => {
+                        if (!chunk)
+                            return;
+                        const sanitizedChunk = redactCurrentUserText(chunk);
+                        if (stream === "stdout")
+                            stdoutExcerpt = appendExcerpt(stdoutExcerpt, sanitizedChunk);
+                        if (stream === "stderr")
+                            stderrExcerpt = appendExcerpt(stderrExcerpt, sanitizedChunk);
+                        await logStore.append(handle, {
+                            stream,
+                            chunk: sanitizedChunk,
+                            ts: new Date().toISOString(),
+                        });
+                    };
+                    await db.insert(workspaceOperations).values({
+                        id,
+                        companyId: input.companyId,
+                        executionWorkspaceId,
+                        heartbeatRunId: input.heartbeatRunId ?? null,
+                        phase: recordInput.phase,
+                        command: recordInput.command ?? null,
+                        cwd: recordInput.cwd ?? null,
+                        status: "running",
+                        logStore: handle.store,
+                        logRef: handle.logRef,
+                        metadata: redactCurrentUserValue(recordInput.metadata ?? null),
+                        startedAt,
+                    });
+                    createdIds.push(id);
+                    try {
+                        const result = await recordInput.run();
+                        await append("system", result.system ?? null);
+                        await append("stdout", result.stdout ?? null);
+                        await append("stderr", result.stderr ?? null);
+                        const finalized = await logStore.finalize(handle);
+                        const finishedAt = new Date();
+                        const row = await db
+                            .update(workspaceOperations)
+                            .set({
+                            executionWorkspaceId,
+                            status: result.status ?? "succeeded",
+                            exitCode: result.exitCode ?? null,
+                            stdoutExcerpt: stdoutExcerpt || null,
+                            stderrExcerpt: stderrExcerpt || null,
+                            logBytes: finalized.bytes,
+                            logSha256: finalized.sha256,
+                            logCompressed: finalized.compressed,
+                            metadata: redactCurrentUserValue(combineMetadata(recordInput.metadata, result.metadata)),
+                            finishedAt,
+                            updatedAt: finishedAt,
+                        })
+                            .where(eq(workspaceOperations.id, id))
+                            .returning()
+                            .then((rows) => rows[0] ?? null);
+                        if (!row)
+                            throw notFound("Workspace operation not found");
+                        return toWorkspaceOperation(row);
+                    }
+                    catch (error) {
+                        await append("stderr", error instanceof Error ? error.message : String(error));
+                        const finalized = await logStore.finalize(handle).catch(() => null);
+                        const finishedAt = new Date();
+                        await db
+                            .update(workspaceOperations)
+                            .set({
+                            executionWorkspaceId,
+                            status: "failed",
+                            stdoutExcerpt: stdoutExcerpt || null,
+                            stderrExcerpt: stderrExcerpt || null,
+                            logBytes: finalized?.bytes ?? null,
+                            logSha256: finalized?.sha256 ?? null,
+                            logCompressed: finalized?.compressed ?? false,
+                            finishedAt,
+                            updatedAt: finishedAt,
+                        })
+                            .where(eq(workspaceOperations.id, id));
+                        throw error;
+                    }
+                },
+            };
+        },
+        listForRun: async (runId, executionWorkspaceId) => {
+            const conditions = [eq(workspaceOperations.heartbeatRunId, runId)];
+            if (executionWorkspaceId) {
+                const cleanupCondition = and(eq(workspaceOperations.executionWorkspaceId, executionWorkspaceId), isNull(workspaceOperations.heartbeatRunId));
+                if (cleanupCondition)
+                    conditions.push(cleanupCondition);
+            }
+            const rows = await db
+                .select()
+                .from(workspaceOperations)
+                .where(conditions.length === 1 ? conditions[0] : or(...conditions))
+                .orderBy(asc(workspaceOperations.startedAt), asc(workspaceOperations.createdAt), asc(workspaceOperations.id));
+            return rows.map(toWorkspaceOperation);
+        },
+        listForExecutionWorkspace: async (executionWorkspaceId) => {
+            const rows = await db
+                .select()
+                .from(workspaceOperations)
+                .where(eq(workspaceOperations.executionWorkspaceId, executionWorkspaceId))
+                .orderBy(desc(workspaceOperations.startedAt), desc(workspaceOperations.createdAt));
+            return rows.map(toWorkspaceOperation);
+        },
+        readLog: async (operationId, opts) => {
+            const operation = await getById(operationId);
+            if (!operation)
+                throw notFound("Workspace operation not found");
+            if (!operation.logStore || !operation.logRef)
+                throw notFound("Workspace operation log not found");
+            const result = await logStore.read({
+                store: operation.logStore,
+                logRef: operation.logRef,
+            }, opts);
+            return {
+                operationId,
+                store: operation.logStore,
+                logRef: operation.logRef,
+                ...result,
+                content: redactCurrentUserText(result.content),
+            };
+        },
+    };
+}
+export { toWorkspaceOperation };
+//# sourceMappingURL=workspace-operations.js.map

package/dist/services/workspace-operations.js.map

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

package/dist/services/workspace-runtime.d.ts

@@ -0,0 +1,164 @@
+import type { AdapterRuntimeServiceReport } from "@paperclipai_dld/adapter-utils";
+import type { Db } from "@paperclipai_dld/db";
+import type { WorkspaceOperationRecorder } from "./workspace-operations.js";
+export interface ExecutionWorkspaceInput {
+    baseCwd: string;
+    source: "project_primary" | "task_session" | "agent_home";
+    projectId: string | null;
+    workspaceId: string | null;
+    repoUrl: string | null;
+    repoRef: string | null;
+}
+export interface ExecutionWorkspaceIssueRef {
+    id: string;
+    identifier: string | null;
+    title: string | null;
+}
+export interface ExecutionWorkspaceAgentRef {
+    id: string;
+    name: string;
+    companyId: string;
+}
+export interface RealizedExecutionWorkspace extends ExecutionWorkspaceInput {
+    strategy: "project_primary" | "git_worktree";
+    cwd: string;
+    branchName: string | null;
+    worktreePath: string | null;
+    warnings: string[];
+    created: boolean;
+}
+export interface RuntimeServiceRef {
+    id: string;
+    companyId: string;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    issueId: string | null;
+    serviceName: string;
+    status: "starting" | "running" | "stopped" | "failed";
+    lifecycle: "shared" | "ephemeral";
+    scopeType: "project_workspace" | "execution_workspace" | "run" | "agent";
+    scopeId: string | null;
+    reuseKey: string | null;
+    command: string | null;
+    cwd: string | null;
+    port: number | null;
+    url: string | null;
+    provider: "local_process" | "adapter_managed";
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: string;
+    startedAt: string;
+    stoppedAt: string | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: "unknown" | "healthy" | "unhealthy";
+    reused: boolean;
+}
+export declare function sanitizeRuntimeServiceBaseEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function realizeExecutionWorkspace(input: {
+    base: ExecutionWorkspaceInput;
+    config: Record<string, unknown>;
+    issue: ExecutionWorkspaceIssueRef | null;
+    agent: ExecutionWorkspaceAgentRef;
+    recorder?: WorkspaceOperationRecorder | null;
+}): Promise<RealizedExecutionWorkspace>;
+export declare function cleanupExecutionWorkspaceArtifacts(input: {
+    workspace: {
+        id: string;
+        cwd: string | null;
+        providerType: string;
+        providerRef: string | null;
+        branchName: string | null;
+        repoUrl: string | null;
+        baseRef: string | null;
+        projectId: string | null;
+        projectWorkspaceId: string | null;
+        sourceIssueId: string | null;
+        metadata?: Record<string, unknown> | null;
+    };
+    projectWorkspace?: {
+        cwd: string | null;
+        cleanupCommand: string | null;
+    } | null;
+    teardownCommand?: string | null;
+    recorder?: WorkspaceOperationRecorder | null;
+}): Promise<{
+    cleanedPath: string | null;
+    cleaned: boolean;
+    warnings: string[];
+}>;
+export declare function normalizeAdapterManagedRuntimeServices(input: {
+    adapterType: string;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    reports: AdapterRuntimeServiceReport[];
+    now?: Date;
+}): RuntimeServiceRef[];
+export declare function ensureRuntimeServicesForRun(input: {
+    db?: Db;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    config: Record<string, unknown>;
+    adapterEnv: Record<string, string>;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+}): Promise<RuntimeServiceRef[]>;
+export declare function releaseRuntimeServicesForRun(runId: string): Promise<void>;
+export declare function stopRuntimeServicesForExecutionWorkspace(input: {
+    db?: Db;
+    executionWorkspaceId: string;
+    workspaceCwd?: string | null;
+}): Promise<void>;
+export declare function listWorkspaceRuntimeServicesForProjectWorkspaces(db: Db, companyId: string, projectWorkspaceIds: string[]): Promise<Map<string, {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    companyId: string;
+    provider: string;
+    scopeType: string;
+    scopeId: string | null;
+    lastUsedAt: Date;
+    startedAt: Date;
+    ownerAgentId: string | null;
+    projectId: string | null;
+    cwd: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    providerRef: string | null;
+    command: string | null;
+    issueId: string | null;
+    serviceName: string;
+    lifecycle: string;
+    reuseKey: string | null;
+    port: number | null;
+    url: string | null;
+    startedByRunId: string | null;
+    stoppedAt: Date | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: string;
+}[]>>;
+export declare function reconcilePersistedRuntimeServicesOnStartup(db: Db): Promise<{
+    reconciled: number;
+}>;
+export declare function persistAdapterManagedRuntimeServices(input: {
+    db: Db;
+    adapterType: string;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    reports: AdapterRuntimeServiceReport[];
+}): Promise<RuntimeServiceRef[]>;
+export declare function buildWorkspaceReadyComment(input: {
+    workspace: RealizedExecutionWorkspace;
+    runtimeServices: RuntimeServiceRef[];
+}): string;
+//# sourceMappingURL=workspace-runtime.d.ts.map

package/dist/services/workspace-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-runtime.d.ts","sourceRoot":"","sources":["../../src/services/workspace-runtime.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAK9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,YAAY,CAAC;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,QAAQ,EAAE,iBAAiB,GAAG,cAAc,CAAC;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtD,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,SAAS,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,KAAK,GAAG,OAAO,CAAC;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAClD,MAAM,EAAE,OAAO,CAAC;CACjB;AAyBD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAS3F;AAqbD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC9C,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAwItC;AAED,wBAAsB,kCAAkC,CAAC,KAAK,EAAE;IAC9D,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC3C,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,IAAI,CAAC;IACT,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC9C;;;;GAkIA;AAgLD,wBAAgB,sCAAsC,CAAC,KAAK,EAAE;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,0BAA0B,CAAC;IAClC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzC,SAAS,EAAE,0BAA0B,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,iBAAiB,EAAE,CA0DtB;AA6LD,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,0BAA0B,CAAC;IAClC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzC,SAAS,EAAE,0BAA0B,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoE/B;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,MAAM,iBAkB/D;AAED,wBAAsB,wCAAwC,CAAC,KAAK,EAAE;IACpE,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,iBAwBA;AAED,wBAAsB,gDAAgD,CACpE,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAsB9B;AAED,wBAAsB,0CAA0C,CAAC,EAAE,EAAE,EAAE;;GA+BtE;AAED,wBAAsB,oCAAoC,CAAC,KAAK,EAAE;IAChE,EAAE,EAAE,EAAE,CAAC;IACP,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,0BAA0B,CAAC;IAClC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzC,SAAS,EAAE,0BAA0B,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,2BAA2B,EAAE,CAAC;CACxC,gCA6EA;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,SAAS,EAAE,0BAA0B,CAAC;IACtC,eAAe,EAAE,iBAAiB,EAAE,CAAC;CACtC,UAcA"}