// File Transfer tests cover errors plugin behavior.

import { describe, expect, it } from "vitest";

import { classifyFsError, err, throwFromNodePayload } from "./errors.js";

import { err, throwFromNodePayload } from "./errors.js";

describe("err", () => {

it("returns an error envelope without canonicalPath when omitted", () => {

});

});

describe("classifyFsError", () => {

it("maps ENOENT to NOT_FOUND", () => {

expect(classifyFsError({ code: "ENOENT" })).toBe("NOT_FOUND");

});

it("maps EACCES and EPERM to PERMISSION_DENIED", () => {

expect(classifyFsError({ code: "EACCES" })).toBe("PERMISSION_DENIED");

expect(classifyFsError({ code: "EPERM" })).toBe("PERMISSION_DENIED");

});

it("maps EISDIR to IS_DIRECTORY", () => {

expect(classifyFsError({ code: "EISDIR" })).toBe("IS_DIRECTORY");

});

it("falls back to READ_ERROR for unknown / null / non-object input", () => {

expect(classifyFsError({ code: "EUNKNOWN" })).toBe("READ_ERROR");

expect(classifyFsError(null)).toBe("READ_ERROR");

expect(classifyFsError(undefined)).toBe("READ_ERROR");

expect(classifyFsError("nope")).toBe("READ_ERROR");

});

});

describe("throwFromNodePayload", () => {

it("preserves code and message in the thrown Error", () => {

expect(() =>

return { ok: false, code, message, ...(canonicalPath ? { canonicalPath } : {}) };

}

// Translate a node-side fs error to a public error code.

export function classifyFsError(e: unknown): FileTransferErrCode {

const code = (e as { code?: string } | null)?.code;

if (code === "ENOENT") {

return "NOT_FOUND";

}

if (code === "EACCES" || code === "EPERM") {

return "PERMISSION_DENIED";

}

if (code === "EISDIR") {

return "IS_DIRECTORY";

}

return "READ_ERROR";

}

// Convert a node-host error payload to a thrown Error for agent-tool consumption.

// The agent-tool surfaces these as failed tool results uniformly.

export function throwFromNodePayload(operation: string, payload: Record<string, unknown>): never {