@pocketcoder/host 0.0.2

package/dist/handlers/command-cancel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Handler for command_cancel messages.
+ *
+ * Kills a running command by its requestId. The original command_exec
+ * handler will send the command_exit event when the process terminates.
+ */
+import type { RequestMessage, Message } from "@pocketcoder/shared";
+export declare function handleCommandCancel(message: RequestMessage, send: (response: Message) => void): Promise<void>;
+//# sourceMappingURL=command-cancel.d.ts.map

package/dist/handlers/command-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-cancel.d.ts","sourceRoot":"","sources":["../../src/handlers/command-cancel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAwB,MAAM,qBAAqB,CAAC;AAMzF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/handlers/command-cancel.js

@@ -0,0 +1,32 @@
+/**
+ * Handler for command_cancel messages.
+ *
+ * Kills a running command by its requestId. The original command_exec
+ * handler will send the command_exit event when the process terminates.
+ */
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { cancelCommand } from "../services/command-runner.js";
+import { logger } from "../utils/logger.js";
+export async function handleCommandCancel(message, send) {
+    const msg = message;
+    const { requestId, payload } = msg;
+    const targetRequestId = payload.requestId;
+    logger.info(`Cancel requested for command: ${targetRequestId}`);
+    const found = cancelCommand(targetRequestId);
+    if (!found) {
+        logger.warn(`Command not found for cancellation: ${targetRequestId}`);
+        send({
+            type: "error",
+            requestId,
+            error: {
+                code: ErrorCode.INVALID_REQUEST,
+                message: `No running command found with requestId: ${targetRequestId}`,
+            },
+        });
+        return;
+    }
+    // Acknowledge the cancellation. The command_exit event will be sent
+    // by the original command_exec handler when the process terminates.
+    logger.info(`Command ${targetRequestId} cancelled successfully`);
+}
+//# sourceMappingURL=command-cancel.js.map

package/dist/handlers/command-cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-cancel.js","sourceRoot":"","sources":["../../src/handlers/command-cancel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuB,EACvB,IAAiC;IAEjC,MAAM,GAAG,GAAG,OAA+B,CAAC;IAC5C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACnC,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAE1C,MAAM,CAAC,IAAI,CAAC,iCAAiC,eAAe,EAAE,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,uCAAuC,eAAe,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,IAAI,EAAE,OAAO;YACb,SAAS;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS,CAAC,eAAe;gBAC/B,OAAO,EAAE,4CAA4C,eAAe,EAAE;aACvE;SACS,CAAC,CAAC;QACd,OAAO;IACT,CAAC;IAED,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,CAAC,IAAI,CAAC,WAAW,eAAe,yBAAyB,CAAC,CAAC;AACnE,CAAC"}

package/dist/handlers/command-exec.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Handler for command_exec messages.
+ *
+ * Executes a shell command in the project directory, streaming
+ * command_output events and sending a final command_exit event.
+ */
+import type { RequestMessage, Message } from "@pocketcoder/shared";
+export declare function handleCommandExec(message: RequestMessage, send: (response: Message) => void): Promise<void>;
+//# sourceMappingURL=command-exec.d.ts.map

package/dist/handlers/command-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-exec.d.ts","sourceRoot":"","sources":["../../src/handlers/command-exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EAIR,MAAM,qBAAqB,CAAC;AAQ7B,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/dist/handlers/command-exec.js

@@ -0,0 +1,74 @@
+/**
+ * Handler for command_exec messages.
+ *
+ * Executes a shell command in the project directory, streaming
+ * command_output events and sending a final command_exit event.
+ */
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { getProject } from "../db/repositories/projects.js";
+import { createCommandRun, updateCommandRun } from "../db/repositories/command-runs.js";
+import { executeCommand } from "../services/command-runner.js";
+import { logger } from "../utils/logger.js";
+export async function handleCommandExec(message, send) {
+    const msg = message;
+    const { requestId, sessionId, payload } = msg;
+    const { command } = payload;
+    // Resolve project from sessionId (which is the projectId)
+    const project = getProject(sessionId);
+    if (!project) {
+        send({
+            type: "error",
+            requestId,
+            error: {
+                code: ErrorCode.INVALID_REQUEST,
+                message: `Project not found: ${sessionId}`,
+            },
+        });
+        return;
+    }
+    // Track command in database
+    try {
+        createCommandRun(requestId, sessionId, command);
+    }
+    catch (err) {
+        logger.warn(`Failed to create command run record: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    logger.info(`Executing command in ${project.path}: ${command}`);
+    // Execute command with streaming output
+    const result = await executeCommand(requestId, sessionId, command, project.path, (output) => {
+        const event = {
+            type: "command_output",
+            requestId,
+            payload: {},
+        };
+        if (output.stdoutChunk) {
+            event.payload.stdoutChunk = output.stdoutChunk;
+        }
+        if (output.stderrChunk) {
+            event.payload.stderrChunk = output.stderrChunk;
+        }
+        send(event);
+    });
+    // Update database record
+    try {
+        updateCommandRun(requestId, result.exitCode ?? -1, result.outputPreview || null, result.truncated);
+    }
+    catch (err) {
+        logger.warn(`Failed to update command run record: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Send command_exit event
+    const exitEvent = {
+        type: "command_exit",
+        requestId,
+        payload: {
+            exitCode: result.exitCode,
+            durationMs: result.durationMs,
+        },
+    };
+    if (result.signal) {
+        exitEvent.payload.signal = result.signal;
+    }
+    send(exitEvent);
+    logger.info(`Command completed: requestId=${requestId} exitCode=${result.exitCode} duration=${result.durationMs}ms truncated=${result.truncated}`);
+}
+//# sourceMappingURL=command-exec.js.map

package/dist/handlers/command-exec.js.map

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

package/dist/handlers/fs/__tests__/limits.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=limits.test.d.ts.map

package/dist/handlers/fs/__tests__/limits.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.test.d.ts","sourceRoot":"","sources":["../../../../src/handlers/fs/__tests__/limits.test.ts"],"names":[],"mappings":""}

package/dist/handlers/fs/__tests__/limits.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from "vitest";
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { MAX_FILE_SIZE, MAX_WRITE_SIZE, MAX_FS_ENTRIES, MAX_TREE_DEPTH, MAX_SEARCH_RESULTS, } from "@pocketcoder/shared/constants";
+import { AppError } from "../../../errors/index.js";
+import { validateReadSize, validateWriteSize, truncateListEntries, capTreeDepth, truncateSearchResults, } from "../limits.js";
+describe("filesystem limits validation", () => {
+    describe("validateReadSize", () => {
+        it("should accept files within the 10MB limit", () => {
+            expect(() => validateReadSize(0)).not.toThrow();
+            expect(() => validateReadSize(1024)).not.toThrow();
+            expect(() => validateReadSize(MAX_FILE_SIZE)).not.toThrow();
+        });
+        it("should reject reads exceeding 10MB", () => {
+            expect(() => validateReadSize(MAX_FILE_SIZE + 1)).toThrow(AppError);
+            try {
+                validateReadSize(MAX_FILE_SIZE + 1);
+            }
+            catch (err) {
+                const appErr = err;
+                expect(appErr.code).toBe(ErrorCode.FILE_TOO_LARGE);
+                expect(appErr.message).toContain("10MB");
+                expect(appErr.details).toBeDefined();
+                expect(appErr.details.size).toBe(MAX_FILE_SIZE + 1);
+                expect(appErr.details.maxSize).toBe(MAX_FILE_SIZE);
+            }
+        });
+        it("should include details in error response", () => {
+            const size = 15 * 1024 * 1024; // 15 MB
+            try {
+                validateReadSize(size);
+            }
+            catch (err) {
+                const appErr = err;
+                const msgErr = appErr.toMessageError();
+                expect(msgErr.code).toBe(ErrorCode.FILE_TOO_LARGE);
+                expect(msgErr.details).toEqual({ size, maxSize: MAX_FILE_SIZE });
+            }
+        });
+    });
+    describe("validateWriteSize", () => {
+        it("should accept content within the 1MB limit", () => {
+            expect(() => validateWriteSize(0)).not.toThrow();
+            expect(() => validateWriteSize(512)).not.toThrow();
+            expect(() => validateWriteSize(MAX_WRITE_SIZE)).not.toThrow();
+        });
+        it("should reject writes exceeding 1MB", () => {
+            expect(() => validateWriteSize(MAX_WRITE_SIZE + 1)).toThrow(AppError);
+            try {
+                validateWriteSize(MAX_WRITE_SIZE + 1);
+            }
+            catch (err) {
+                const appErr = err;
+                expect(appErr.code).toBe(ErrorCode.FILE_TOO_LARGE);
+                expect(appErr.message).toContain("1MB");
+                expect(appErr.details).toBeDefined();
+                expect(appErr.details.size).toBe(MAX_WRITE_SIZE + 1);
+                expect(appErr.details.maxSize).toBe(MAX_WRITE_SIZE);
+            }
+        });
+        it("should include details in error response", () => {
+            const size = 2 * 1024 * 1024; // 2 MB
+            try {
+                validateWriteSize(size);
+            }
+            catch (err) {
+                const appErr = err;
+                const msgErr = appErr.toMessageError();
+                expect(msgErr.code).toBe(ErrorCode.FILE_TOO_LARGE);
+                expect(msgErr.details).toEqual({ size, maxSize: MAX_WRITE_SIZE });
+            }
+        });
+    });
+    describe("truncateListEntries", () => {
+        it("should return entries unchanged when under limit", () => {
+            const entries = Array.from({ length: 100 }, (_, i) => `file-${i}`);
+            const result = truncateListEntries(entries);
+            expect(result.entries).toHaveLength(100);
+            expect(result.truncated).toBe(false);
+        });
+        it("should return entries unchanged at exactly the limit", () => {
+            const entries = Array.from({ length: MAX_FS_ENTRIES }, (_, i) => `file-${i}`);
+            const result = truncateListEntries(entries);
+            expect(result.entries).toHaveLength(MAX_FS_ENTRIES);
+            expect(result.truncated).toBe(false);
+        });
+        it("should truncate list results at 10000", () => {
+            const entries = Array.from({ length: MAX_FS_ENTRIES + 500 }, (_, i) => `file-${i}`);
+            const result = truncateListEntries(entries);
+            expect(result.entries).toHaveLength(MAX_FS_ENTRIES);
+            expect(result.truncated).toBe(true);
+            // First and last entries should be preserved in order
+            expect(result.entries[0]).toBe("file-0");
+            expect(result.entries[MAX_FS_ENTRIES - 1]).toBe(`file-${MAX_FS_ENTRIES - 1}`);
+        });
+    });
+    describe("capTreeDepth", () => {
+        it("should allow depths within the limit", () => {
+            expect(capTreeDepth(1)).toBe(1);
+            expect(capTreeDepth(10)).toBe(10);
+            expect(capTreeDepth(MAX_TREE_DEPTH)).toBe(MAX_TREE_DEPTH);
+        });
+        it("should limit tree depth to 20 levels", () => {
+            expect(capTreeDepth(21)).toBe(MAX_TREE_DEPTH);
+            expect(capTreeDepth(100)).toBe(MAX_TREE_DEPTH);
+            expect(capTreeDepth(999)).toBe(MAX_TREE_DEPTH);
+        });
+        it("should clamp negative values to 0", () => {
+            expect(capTreeDepth(-1)).toBe(0);
+            expect(capTreeDepth(-100)).toBe(0);
+        });
+        it("should pass through zero", () => {
+            expect(capTreeDepth(0)).toBe(0);
+        });
+    });
+    describe("truncateSearchResults", () => {
+        it("should return results unchanged when under limit", () => {
+            const results = Array.from({ length: 50 }, (_, i) => ({ line: i, text: `match-${i}` }));
+            const result = truncateSearchResults(results);
+            expect(result.results).toHaveLength(50);
+            expect(result.truncated).toBe(false);
+        });
+        it("should return results unchanged at exactly the limit", () => {
+            const results = Array.from({ length: MAX_SEARCH_RESULTS }, (_, i) => `match-${i}`);
+            const result = truncateSearchResults(results);
+            expect(result.results).toHaveLength(MAX_SEARCH_RESULTS);
+            expect(result.truncated).toBe(false);
+        });
+        it("should limit search to 1000 results", () => {
+            const results = Array.from({ length: MAX_SEARCH_RESULTS + 200 }, (_, i) => `match-${i}`);
+            const result = truncateSearchResults(results);
+            expect(result.results).toHaveLength(MAX_SEARCH_RESULTS);
+            expect(result.truncated).toBe(true);
+            // First and last entries should be preserved in order
+            expect(result.results[0]).toBe("match-0");
+            expect(result.results[MAX_SEARCH_RESULTS - 1]).toBe(`match-${MAX_SEARCH_RESULTS - 1}`);
+        });
+        it("should include details in error response for rejected reads", () => {
+            // Verifying the full error chain: validate -> AppError -> MessageError with details
+            try {
+                validateReadSize(MAX_FILE_SIZE + 1024);
+            }
+            catch (err) {
+                const appErr = err;
+                const msgErr = appErr.toMessageError();
+                expect(msgErr.code).toBe(ErrorCode.FILE_TOO_LARGE);
+                expect(msgErr.message).toBeDefined();
+                expect(msgErr.details).toBeDefined();
+                expect(typeof msgErr.details.size).toBe("number");
+                expect(typeof msgErr.details.maxSize).toBe("number");
+            }
+        });
+    });
+});
+//# sourceMappingURL=limits.test.js.map

package/dist/handlers/fs/__tests__/limits.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.test.js","sourceRoot":"","sources":["../../../../src/handlers/fs/__tests__/limits.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEpE,IAAI,CAAC;gBACH,gBAAgB,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAe,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBACrC,MAAM,CAAC,MAAM,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;gBACrD,MAAM,CAAC,MAAM,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;YACvC,IAAI,CAAC;gBACH,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAe,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEtE,IAAI,CAAC;gBACH,iBAAiB,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAe,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBACrC,MAAM,CAAC,MAAM,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;gBACtD,MAAM,CAAC,MAAM,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;YACrC,IAAI,CAAC;gBACH,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAe,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACnE,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,sDAAsD;YACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,cAAc,GAAG,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9C,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC/C,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxF,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACnF,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACzF,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,sDAAsD;YACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,oFAAoF;YACpF,IAAI,CAAC;gBACH,gBAAgB,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAe,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBACrC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnD,MAAM,CAAC,OAAO,MAAM,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/handlers/fs/limits.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Filesystem operation limits validation.
+ *
+ * Centralizes limit checks for file reads, writes, list entries,
+ * tree depth, and search results. Handlers can call these utilities
+ * to enforce limits and get consistent error responses.
+ */
+import { MAX_FILE_SIZE, MAX_WRITE_SIZE, MAX_FS_ENTRIES, MAX_TREE_DEPTH, MAX_SEARCH_RESULTS } from "@pocketcoder/shared/constants";
+export { MAX_FILE_SIZE, MAX_WRITE_SIZE, MAX_FS_ENTRIES, MAX_TREE_DEPTH, MAX_SEARCH_RESULTS };
+/**
+ * Validate that a file size does not exceed the read limit (10 MB).
+ * Throws AppError with FILE_TOO_LARGE if exceeded.
+ */
+export declare function validateReadSize(size: number): void;
+/**
+ * Validate that content size does not exceed the write limit (1 MB).
+ * Throws AppError with FILE_TOO_LARGE if exceeded.
+ */
+export declare function validateWriteSize(size: number): void;
+/**
+ * Truncate a list of entries to the MAX_FS_ENTRIES limit.
+ * Returns the truncated array and a flag indicating whether truncation occurred.
+ */
+export declare function truncateListEntries<T>(entries: T[]): {
+    entries: T[];
+    truncated: boolean;
+};
+/**
+ * Cap a requested tree depth at the MAX_TREE_DEPTH limit.
+ * Returns the capped value (always <= MAX_TREE_DEPTH).
+ */
+export declare function capTreeDepth(requestedDepth: number): number;
+/**
+ * Truncate search results to the MAX_SEARCH_RESULTS limit.
+ * Returns the truncated array and a flag indicating whether truncation occurred.
+ */
+export declare function truncateSearchResults<T>(results: T[]): {
+    results: T[];
+    truncated: boolean;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/handlers/fs/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/handlers/fs/limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAEnB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG;IACpD,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB,CAKA;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG;IACtD,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB,CAKA"}

package/dist/handlers/fs/limits.js

@@ -0,0 +1,68 @@
+/**
+ * Filesystem operation limits validation.
+ *
+ * Centralizes limit checks for file reads, writes, list entries,
+ * tree depth, and search results. Handlers can call these utilities
+ * to enforce limits and get consistent error responses.
+ */
+import { MAX_FILE_SIZE, MAX_WRITE_SIZE, MAX_FS_ENTRIES, MAX_TREE_DEPTH, MAX_SEARCH_RESULTS, ErrorCode, } from "@pocketcoder/shared/constants";
+import { AppError } from "../../errors/index.js";
+export { MAX_FILE_SIZE, MAX_WRITE_SIZE, MAX_FS_ENTRIES, MAX_TREE_DEPTH, MAX_SEARCH_RESULTS };
+/**
+ * Validate that a file size does not exceed the read limit (10 MB).
+ * Throws AppError with FILE_TOO_LARGE if exceeded.
+ */
+export function validateReadSize(size) {
+    if (size > MAX_FILE_SIZE) {
+        throw new AppError(ErrorCode.FILE_TOO_LARGE, `File exceeds maximum size of ${formatBytes(MAX_FILE_SIZE)}`, { size, maxSize: MAX_FILE_SIZE });
+    }
+}
+/**
+ * Validate that content size does not exceed the write limit (1 MB).
+ * Throws AppError with FILE_TOO_LARGE if exceeded.
+ */
+export function validateWriteSize(size) {
+    if (size > MAX_WRITE_SIZE) {
+        throw new AppError(ErrorCode.FILE_TOO_LARGE, `Content exceeds maximum size of ${formatBytes(MAX_WRITE_SIZE)}`, { size, maxSize: MAX_WRITE_SIZE });
+    }
+}
+/**
+ * Truncate a list of entries to the MAX_FS_ENTRIES limit.
+ * Returns the truncated array and a flag indicating whether truncation occurred.
+ */
+export function truncateListEntries(entries) {
+    if (entries.length <= MAX_FS_ENTRIES) {
+        return { entries, truncated: false };
+    }
+    return { entries: entries.slice(0, MAX_FS_ENTRIES), truncated: true };
+}
+/**
+ * Cap a requested tree depth at the MAX_TREE_DEPTH limit.
+ * Returns the capped value (always <= MAX_TREE_DEPTH).
+ */
+export function capTreeDepth(requestedDepth) {
+    return Math.min(Math.max(requestedDepth, 0), MAX_TREE_DEPTH);
+}
+/**
+ * Truncate search results to the MAX_SEARCH_RESULTS limit.
+ * Returns the truncated array and a flag indicating whether truncation occurred.
+ */
+export function truncateSearchResults(results) {
+    if (results.length <= MAX_SEARCH_RESULTS) {
+        return { results, truncated: false };
+    }
+    return { results: results.slice(0, MAX_SEARCH_RESULTS), truncated: true };
+}
+/**
+ * Format byte count as human-readable string.
+ */
+function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) {
+        return `${bytes / (1024 * 1024)}MB`;
+    }
+    if (bytes >= 1024) {
+        return `${bytes / 1024}KB`;
+    }
+    return `${bytes}B`;
+}
+//# sourceMappingURL=limits.js.map

package/dist/handlers/fs/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/handlers/fs/limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;AAE7F;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,IAAI,GAAG,aAAa,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,gCAAgC,WAAW,CAAC,aAAa,CAAC,EAAE,EAC5D,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CACjC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,IAAI,GAAG,cAAc,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,mCAAmC,WAAW,CAAC,cAAc,CAAC,EAAE,EAChE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAClC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAI,OAAY;IAIjD,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,cAAsB;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAI,OAAY;IAInD,IAAI,OAAO,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC"}

package/dist/handlers/fs-create.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Handler for fs_create messages.
+ * Creates empty files or directories within a project.
+ * Fails if the target already exists.
+ */
+import type { RequestMessage, Message } from "@pocketcoder/shared";
+export declare function handleFsCreate(message: RequestMessage, send: (response: Message) => void): Promise<void>;
+//# sourceMappingURL=fs-create.d.ts.map

package/dist/handlers/fs-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-create.d.ts","sourceRoot":"","sources":["../../src/handlers/fs-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EAGR,MAAM,qBAAqB,CAAC;AAO7B,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CA0Ff"}

package/dist/handlers/fs-create.js

@@ -0,0 +1,98 @@
+/**
+ * Handler for fs_create messages.
+ * Creates empty files or directories within a project.
+ * Fails if the target already exists.
+ */
+import { writeFile, mkdir, stat, realpath, rm } from "node:fs/promises";
+import { dirname } from "node:path";
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { getProject } from "../db/repositories/projects.js";
+import { validateParentWithinProject, PathEscapeError } from "../services/filesystem.js";
+import { logger } from "../utils/logger.js";
+export async function handleFsCreate(message, send) {
+    const msg = message;
+    const { requestId, sessionId, payload } = msg;
+    const { path: relativePath, itemType, createDirs } = payload;
+    const project = getProject(sessionId);
+    if (!project) {
+        send({
+            type: "fs_create_response",
+            requestId,
+            error: {
+                code: ErrorCode.INVALID_REQUEST,
+                message: `Project not found: ${sessionId}`,
+            },
+        });
+        return;
+    }
+    try {
+        const resolvedPath = await validateParentWithinProject(project.path, relativePath);
+        // Check if the target already exists
+        try {
+            await stat(resolvedPath);
+            // If stat succeeds, the path exists
+            send({
+                type: "fs_create_response",
+                requestId,
+                error: {
+                    code: ErrorCode.FILE_EXISTS,
+                    message: `Already exists: ${relativePath}`,
+                },
+            });
+            return;
+        }
+        catch {
+            // ENOENT means it doesn't exist — that's what we want
+        }
+        // Create parent directories if requested (default true)
+        if (createDirs ?? true) {
+            await mkdir(dirname(resolvedPath), { recursive: true });
+        }
+        if (itemType === "directory") {
+            await mkdir(resolvedPath);
+        }
+        else {
+            await writeFile(resolvedPath, "", "utf-8");
+        }
+        // Post-creation realpath check to guard against symlink-based TOCTOU attacks
+        const realResolved = await realpath(resolvedPath);
+        const realProject = await realpath(project.path);
+        if (!realResolved.startsWith(realProject + "/") && realResolved !== realProject) {
+            // Clean up the created file/directory outside the project
+            await rm(resolvedPath, { recursive: true, force: true }).catch(() => { });
+            throw new PathEscapeError("Path escapes project directory");
+        }
+        send({
+            type: "fs_create_response",
+            requestId,
+            payload: {
+                path: relativePath,
+                itemType,
+            },
+        });
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError) {
+            send({
+                type: "fs_create_response",
+                requestId,
+                error: {
+                    code: ErrorCode.OUTSIDE_PROJECT_ROOT,
+                    message: "Path escapes project directory",
+                },
+            });
+            return;
+        }
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        logger.error(`fs_create error: ${errorMessage}`);
+        send({
+            type: "fs_create_response",
+            requestId,
+            error: {
+                code: ErrorCode.UNKNOWN_ERROR,
+                message: errorMessage,
+            },
+        });
+    }
+}
+//# sourceMappingURL=fs-create.js.map

package/dist/handlers/fs-create.js.map

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

package/dist/handlers/fs-delete.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Handler for fs_delete messages.
+ * Deletes files or directories (recursive for directories) within a project.
+ * Returns FILE_NOT_FOUND if the path doesn't exist.
+ */
+import type { RequestMessage, Message } from "@pocketcoder/shared";
+export declare function handleFsDelete(message: RequestMessage, send: (response: Message) => void): Promise<void>;
+//# sourceMappingURL=fs-delete.d.ts.map

package/dist/handlers/fs-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-delete.d.ts","sourceRoot":"","sources":["../../src/handlers/fs-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EAGR,MAAM,qBAAqB,CAAC;AAO7B,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CAwFf"}