@paperclipai/server 0.3.1 → 2026.3.17-canary.2

package/dist/services/work-products.js

@@ -0,0 +1,100 @@
+import { and, desc, eq } from "drizzle-orm";
+import { issueWorkProducts } from "@paperclipai/db";
+function toIssueWorkProduct(row) {
+    return {
+        id: row.id,
+        companyId: row.companyId,
+        projectId: row.projectId ?? null,
+        issueId: row.issueId,
+        executionWorkspaceId: row.executionWorkspaceId ?? null,
+        runtimeServiceId: row.runtimeServiceId ?? null,
+        type: row.type,
+        provider: row.provider,
+        externalId: row.externalId ?? null,
+        title: row.title,
+        url: row.url ?? null,
+        status: row.status,
+        reviewState: row.reviewState,
+        isPrimary: row.isPrimary,
+        healthStatus: row.healthStatus,
+        summary: row.summary ?? null,
+        metadata: row.metadata ?? null,
+        createdByRunId: row.createdByRunId ?? null,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+export function workProductService(db) {
+    return {
+        listForIssue: async (issueId) => {
+            const rows = await db
+                .select()
+                .from(issueWorkProducts)
+                .where(eq(issueWorkProducts.issueId, issueId))
+                .orderBy(desc(issueWorkProducts.isPrimary), desc(issueWorkProducts.updatedAt));
+            return rows.map(toIssueWorkProduct);
+        },
+        getById: async (id) => {
+            const row = await db
+                .select()
+                .from(issueWorkProducts)
+                .where(eq(issueWorkProducts.id, id))
+                .then((rows) => rows[0] ?? null);
+            return row ? toIssueWorkProduct(row) : null;
+        },
+        createForIssue: async (issueId, companyId, data) => {
+            const row = await db.transaction(async (tx) => {
+                if (data.isPrimary) {
+                    await tx
+                        .update(issueWorkProducts)
+                        .set({ isPrimary: false, updatedAt: new Date() })
+                        .where(and(eq(issueWorkProducts.companyId, companyId), eq(issueWorkProducts.issueId, issueId), eq(issueWorkProducts.type, data.type)));
+                }
+                return await tx
+                    .insert(issueWorkProducts)
+                    .values({
+                    ...data,
+                    companyId,
+                    issueId,
+                })
+                    .returning()
+                    .then((rows) => rows[0] ?? null);
+            });
+            return row ? toIssueWorkProduct(row) : null;
+        },
+        update: async (id, patch) => {
+            const row = await db.transaction(async (tx) => {
+                const existing = await tx
+                    .select()
+                    .from(issueWorkProducts)
+                    .where(eq(issueWorkProducts.id, id))
+                    .then((rows) => rows[0] ?? null);
+                if (!existing)
+                    return null;
+                if (patch.isPrimary === true) {
+                    await tx
+                        .update(issueWorkProducts)
+                        .set({ isPrimary: false, updatedAt: new Date() })
+                        .where(and(eq(issueWorkProducts.companyId, existing.companyId), eq(issueWorkProducts.issueId, existing.issueId), eq(issueWorkProducts.type, existing.type)));
+                }
+                return await tx
+                    .update(issueWorkProducts)
+                    .set({ ...patch, updatedAt: new Date() })
+                    .where(eq(issueWorkProducts.id, id))
+                    .returning()
+                    .then((rows) => rows[0] ?? null);
+            });
+            return row ? toIssueWorkProduct(row) : null;
+        },
+        remove: async (id) => {
+            const row = await db
+                .delete(issueWorkProducts)
+                .where(eq(issueWorkProducts.id, id))
+                .returning()
+                .then((rows) => rows[0] ?? null);
+            return row ? toIssueWorkProduct(row) : null;
+        },
+    };
+}
+export { toIssueWorkProduct };
+//# sourceMappingURL=work-products.js.map

package/dist/services/work-products.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-products.js","sourceRoot":"","sources":["../../src/services/work-products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKpD,SAAS,kBAAkB,CAAC,GAAwB;IAClD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;QAChC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,IAAI;QACtD,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;QAC9C,IAAI,EAAE,GAAG,CAAC,IAAgC;QAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QAClC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAA8C;QAC/D,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,YAAY,EAAE,GAAG,CAAC,YAAgD;QAClE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,QAAQ,EAAG,GAAG,CAAC,QAA2C,IAAI,IAAI;QAClE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;QAC1C,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAM;IACvC,OAAO;QACL,YAAY,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,MAAM,EAAE;iBAClB,MAAM,EAAE;iBACR,IAAI,CAAC,iBAAiB,CAAC;iBACvB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;iBAC7C,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,EAAE;iBACjB,MAAM,EAAE;iBACR,IAAI,CAAC,iBAAiB,CAAC;iBACvB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;iBACnC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QAED,cAAc,EAAE,KAAK,EAAE,OAAe,EAAE,SAAiB,EAAE,IAA0E,EAAE,EAAE;YACvI,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBAC5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,MAAM,EAAE;yBACL,MAAM,CAAC,iBAAiB,CAAC;yBACzB,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;yBAChD,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,EAC1C,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EACtC,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CACtC,CACF,CAAC;gBACN,CAAC;gBACD,OAAO,MAAM,EAAE;qBACZ,MAAM,CAAC,iBAAiB,CAAC;qBACzB,MAAM,CAAC;oBACN,GAAG,IAAI;oBACP,SAAS;oBACT,OAAO;iBACR,CAAC;qBACD,SAAS,EAAE;qBACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,EAAU,EAAE,KAAqD,EAAE,EAAE;YAClF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBAC5C,MAAM,QAAQ,GAAG,MAAM,EAAE;qBACtB,MAAM,EAAE;qBACR,IAAI,CAAC,iBAAiB,CAAC;qBACvB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;qBACnC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;gBACnC,IAAI,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBAE3B,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;oBAC7B,MAAM,EAAE;yBACL,MAAM,CAAC,iBAAiB,CAAC;yBACzB,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;yBAChD,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EACnD,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC/C,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;gBACN,CAAC;gBAED,OAAO,MAAM,EAAE;qBACZ,MAAM,CAAC,iBAAiB,CAAC;qBACzB,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;qBACxC,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;qBACnC,SAAS,EAAE;qBACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,MAAM,EAAE;iBACjB,MAAM,CAAC,iBAAiB,CAAC;iBACzB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;iBACnC,SAAS,EAAE;iBACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/services/workspace-operation-log-store.d.ts

@@ -0,0 +1,33 @@
+export type WorkspaceOperationLogStoreType = "local_file";
+export interface WorkspaceOperationLogHandle {
+    store: WorkspaceOperationLogStoreType;
+    logRef: string;
+}
+export interface WorkspaceOperationLogReadOptions {
+    offset?: number;
+    limitBytes?: number;
+}
+export interface WorkspaceOperationLogReadResult {
+    content: string;
+    nextOffset?: number;
+}
+export interface WorkspaceOperationLogFinalizeSummary {
+    bytes: number;
+    sha256?: string;
+    compressed: boolean;
+}
+export interface WorkspaceOperationLogStore {
+    begin(input: {
+        companyId: string;
+        operationId: string;
+    }): Promise<WorkspaceOperationLogHandle>;
+    append(handle: WorkspaceOperationLogHandle, event: {
+        stream: "stdout" | "stderr" | "system";
+        chunk: string;
+        ts: string;
+    }): Promise<void>;
+    finalize(handle: WorkspaceOperationLogHandle): Promise<WorkspaceOperationLogFinalizeSummary>;
+    read(handle: WorkspaceOperationLogHandle, opts?: WorkspaceOperationLogReadOptions): Promise<WorkspaceOperationLogReadResult>;
+}
+export declare function getWorkspaceOperationLogStore(): WorkspaceOperationLogStore;
+//# sourceMappingURL=workspace-operation-log-store.d.ts.map

package/dist/services/workspace-operation-log-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation-log-store.d.ts","sourceRoot":"","sources":["../../src/services/workspace-operation-log-store.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAE1D,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,8BAA8B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oCAAoC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC/F,MAAM,CACJ,MAAM,EAAE,2BAA2B,EACnC,KAAK,EAAE;QAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAC3E,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC7F,IAAI,CAAC,MAAM,EAAE,2BAA2B,EAAE,IAAI,CAAC,EAAE,gCAAgC,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;CAC9H;AAgHD,wBAAgB,6BAA6B,+BAM5C"}

package/dist/services/workspace-operation-log-store.js

@@ -0,0 +1,110 @@
+import { createReadStream, promises as fs } from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { notFound } from "../errors.js";
+import { resolvePaperclipInstanceRoot } from "../home-paths.js";
+function safeSegments(...segments) {
+    return segments.map((segment) => segment.replace(/[^a-zA-Z0-9._-]/g, "_"));
+}
+function resolveWithin(basePath, relativePath) {
+    const resolved = path.resolve(basePath, relativePath);
+    const base = path.resolve(basePath) + path.sep;
+    if (!resolved.startsWith(base) && resolved !== path.resolve(basePath)) {
+        throw new Error("Invalid log path");
+    }
+    return resolved;
+}
+function createLocalFileWorkspaceOperationLogStore(basePath) {
+    async function ensureDir(relativeDir) {
+        const dir = resolveWithin(basePath, relativeDir);
+        await fs.mkdir(dir, { recursive: true });
+    }
+    async function readFileRange(filePath, offset, limitBytes) {
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (!stat)
+            throw notFound("Workspace operation log not found");
+        const start = Math.max(0, Math.min(offset, stat.size));
+        const end = Math.max(start, Math.min(start + limitBytes - 1, stat.size - 1));
+        if (start > end) {
+            return { content: "", nextOffset: start };
+        }
+        const chunks = [];
+        await new Promise((resolve, reject) => {
+            const stream = createReadStream(filePath, { start, end });
+            stream.on("data", (chunk) => {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            });
+            stream.on("error", reject);
+            stream.on("end", () => resolve());
+        });
+        const content = Buffer.concat(chunks).toString("utf8");
+        const nextOffset = end + 1 < stat.size ? end + 1 : undefined;
+        return { content, nextOffset };
+    }
+    async function sha256File(filePath) {
+        return new Promise((resolve, reject) => {
+            const hash = createHash("sha256");
+            const stream = createReadStream(filePath);
+            stream.on("data", (chunk) => hash.update(chunk));
+            stream.on("error", reject);
+            stream.on("end", () => resolve(hash.digest("hex")));
+        });
+    }
+    return {
+        async begin(input) {
+            const [companyId] = safeSegments(input.companyId);
+            const operationId = safeSegments(input.operationId)[0];
+            const relDir = companyId;
+            const relPath = path.join(relDir, `${operationId}.ndjson`);
+            await ensureDir(relDir);
+            const absPath = resolveWithin(basePath, relPath);
+            await fs.writeFile(absPath, "", "utf8");
+            return { store: "local_file", logRef: relPath };
+        },
+        async append(handle, event) {
+            if (handle.store !== "local_file")
+                return;
+            const absPath = resolveWithin(basePath, handle.logRef);
+            const line = JSON.stringify({
+                ts: event.ts,
+                stream: event.stream,
+                chunk: event.chunk,
+            });
+            await fs.appendFile(absPath, `${line}\n`, "utf8");
+        },
+        async finalize(handle) {
+            if (handle.store !== "local_file") {
+                return { bytes: 0, compressed: false };
+            }
+            const absPath = resolveWithin(basePath, handle.logRef);
+            const stat = await fs.stat(absPath).catch(() => null);
+            if (!stat)
+                throw notFound("Workspace operation log not found");
+            const hash = await sha256File(absPath);
+            return {
+                bytes: stat.size,
+                sha256: hash,
+                compressed: false,
+            };
+        },
+        async read(handle, opts) {
+            if (handle.store !== "local_file") {
+                throw notFound("Workspace operation log not found");
+            }
+            const absPath = resolveWithin(basePath, handle.logRef);
+            const offset = opts?.offset ?? 0;
+            const limitBytes = opts?.limitBytes ?? 256_000;
+            return readFileRange(absPath, offset, limitBytes);
+        },
+    };
+}
+let cachedStore = null;
+export function getWorkspaceOperationLogStore() {
+    if (cachedStore)
+        return cachedStore;
+    const basePath = process.env.WORKSPACE_OPERATION_LOG_BASE_PATH
+        ?? path.resolve(resolvePaperclipInstanceRoot(), "data", "workspace-operation-logs");
+    cachedStore = createLocalFileWorkspaceOperationLogStore(basePath);
+    return cachedStore;
+}
+//# sourceMappingURL=workspace-operation-log-store.js.map

package/dist/services/workspace-operation-log-store.js.map

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

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

@@ -0,0 +1,44 @@
+import type { Db } from "@paperclipai/db";
+import { workspaceOperations } from "@paperclipai/db";
+import type { WorkspaceOperation, WorkspaceOperationPhase, WorkspaceOperationStatus } from "@paperclipai/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,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAMjH,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/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

@@ -1,5 +1,6 @@
 import type { AdapterRuntimeServiceReport } from "@paperclipai/adapter-utils";
 import type { Db } from "@paperclipai/db";
+import type { WorkspaceOperationRecorder } from "./workspace-operations.js";
 export interface ExecutionWorkspaceInput {
     baseCwd: string;
     source: "project_primary" | "task_session" | "agent_home";
@@ -31,6 +32,7 @@ export interface RuntimeServiceRef {
     companyId: string;
     projectId: string | null;
     projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
     issueId: string | null;
     serviceName: string;
     status: "starting" | "running" | "stopped" | "failed";
@@ -53,18 +55,46 @@ export interface RuntimeServiceRef {
     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[];
@@ -74,34 +104,41 @@ export declare function ensureRuntimeServicesForRun(input: {
     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;
-    scopeType: string;
-    scopeId: string | null;
     serviceName: string;
     lifecycle: string;
     reuseKey: string | null;
-    command: string | null;
     port: number | null;
     url: string | null;
-    provider: string;
-    providerRef: string | null;
     startedByRunId: string | null;
     stoppedAt: Date | null;
     stopPolicy: Record<string, unknown> | null;
@@ -117,6 +154,7 @@ export declare function persistAdapterManagedRuntimeServices(input: {
     agent: ExecutionWorkspaceAgentRef;
     issue: ExecutionWorkspaceIssueRef | null;
     workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
     reports: AdapterRuntimeServiceReport[];
 }): Promise<RuntimeServiceRef[]>;
 export declare function buildWorkspaceReadyComment(input: {