filex-cli 0.1.0

package/dist/src/schema.d.ts

@@ -0,0 +1,224 @@
+import { z } from 'zod';
+/**
+ * Action schema for FileX commands.
+ * AI output must conform to this schema.
+ * One action per run. Unknown fields are rejected.
+ */
+export declare const ConvertImagesOptionsSchema: z.ZodOptional<z.ZodObject<{
+    from: z.ZodOptional<z.ZodEnum<["png", "jpg", "jpeg", "webp", "gif", "tiff", "avif"]>>;
+    to: z.ZodOptional<z.ZodEnum<["webp", "png", "jpg"]>>;
+    format: z.ZodOptional<z.ZodLiteral<"webp">>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+    quality: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+    to?: "png" | "jpg" | "webp" | undefined;
+    quality?: number | undefined;
+    maxWidth?: number | undefined;
+    format?: "webp" | undefined;
+}, {
+    from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+    to?: "png" | "jpg" | "webp" | undefined;
+    quality?: number | undefined;
+    maxWidth?: number | undefined;
+    format?: "webp" | undefined;
+}>>;
+export declare const ResizeImagesOptionsSchema: z.ZodObject<{
+    maxWidth: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    maxWidth: number;
+}, {
+    maxWidth: number;
+}>;
+export declare const MergePdfsOptionsSchema: z.ZodOptional<z.ZodObject<{
+    outputFile: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodEnum<["name", "name-desc", "date", "date-desc", "random"]>>;
+}, "strict", z.ZodTypeAny, {
+    outputFile?: string | undefined;
+    order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+}, {
+    outputFile?: string | undefined;
+    order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+}>>;
+export declare const ConvertImagesActionSchema: z.ZodObject<{
+    action: z.ZodLiteral<"convert_images">;
+    options: z.ZodOptional<z.ZodObject<{
+        from: z.ZodOptional<z.ZodEnum<["png", "jpg", "jpeg", "webp", "gif", "tiff", "avif"]>>;
+        to: z.ZodOptional<z.ZodEnum<["webp", "png", "jpg"]>>;
+        format: z.ZodOptional<z.ZodLiteral<"webp">>;
+        maxWidth: z.ZodOptional<z.ZodNumber>;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    }, {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    action: "convert_images";
+    options?: {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    } | undefined;
+}, {
+    action: "convert_images";
+    options?: {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    } | undefined;
+}>;
+export declare const ResizeImagesActionSchema: z.ZodObject<{
+    action: z.ZodLiteral<"resize_images">;
+    options: z.ZodObject<{
+        maxWidth: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        maxWidth: number;
+    }, {
+        maxWidth: number;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        maxWidth: number;
+    };
+    action: "resize_images";
+}, {
+    options: {
+        maxWidth: number;
+    };
+    action: "resize_images";
+}>;
+export declare const MergePdfsActionSchema: z.ZodObject<{
+    action: z.ZodLiteral<"merge_pdfs">;
+    options: z.ZodOptional<z.ZodObject<{
+        outputFile: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodEnum<["name", "name-desc", "date", "date-desc", "random"]>>;
+    }, "strict", z.ZodTypeAny, {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    }, {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    action: "merge_pdfs";
+    options?: {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    } | undefined;
+}, {
+    action: "merge_pdfs";
+    options?: {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    } | undefined;
+}>;
+export declare const ActionSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<"convert_images">;
+    options: z.ZodOptional<z.ZodObject<{
+        from: z.ZodOptional<z.ZodEnum<["png", "jpg", "jpeg", "webp", "gif", "tiff", "avif"]>>;
+        to: z.ZodOptional<z.ZodEnum<["webp", "png", "jpg"]>>;
+        format: z.ZodOptional<z.ZodLiteral<"webp">>;
+        maxWidth: z.ZodOptional<z.ZodNumber>;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    }, {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    action: "convert_images";
+    options?: {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    } | undefined;
+}, {
+    action: "convert_images";
+    options?: {
+        from?: "png" | "jpg" | "jpeg" | "webp" | "gif" | "tiff" | "avif" | undefined;
+        to?: "png" | "jpg" | "webp" | undefined;
+        quality?: number | undefined;
+        maxWidth?: number | undefined;
+        format?: "webp" | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"resize_images">;
+    options: z.ZodObject<{
+        maxWidth: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        maxWidth: number;
+    }, {
+        maxWidth: number;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        maxWidth: number;
+    };
+    action: "resize_images";
+}, {
+    options: {
+        maxWidth: number;
+    };
+    action: "resize_images";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"merge_pdfs">;
+    options: z.ZodOptional<z.ZodObject<{
+        outputFile: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodEnum<["name", "name-desc", "date", "date-desc", "random"]>>;
+    }, "strict", z.ZodTypeAny, {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    }, {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    action: "merge_pdfs";
+    options?: {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    } | undefined;
+}, {
+    action: "merge_pdfs";
+    options?: {
+        outputFile?: string | undefined;
+        order?: "name" | "name-desc" | "date" | "date-desc" | "random" | undefined;
+    } | undefined;
+}>]>;
+export type Action = z.infer<typeof ActionSchema>;
+export type ConvertImagesAction = z.infer<typeof ConvertImagesActionSchema>;
+export type ResizeImagesAction = z.infer<typeof ResizeImagesActionSchema>;
+export type MergePdfsAction = z.infer<typeof MergePdfsActionSchema>;
+/**
+ * Parse and validate an action from AI output or manual input.
+ * Returns the validated action or throws on invalid input.
+ */
+export declare function parseAction(input: unknown): Action;
+/**
+ * Safely parse an action, returning null on failure instead of throwing.
+ */
+export declare function safeParseAction(input: unknown): Action | null;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;GAMjB,CAAC;AAEvB,eAAO,MAAM,yBAAyB;;;;;;EAE3B,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;GAGb,CAAC;AAEvB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG3B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;EAG1B,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAEZ,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7D"}

package/dist/src/schema.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+/**
+ * Action schema for FileX commands.
+ * AI output must conform to this schema.
+ * One action per run. Unknown fields are rejected.
+ */
+export const ConvertImagesOptionsSchema = z.object({
+    from: z.enum(['png', 'jpg', 'jpeg', 'webp', 'gif', 'tiff', 'avif']).optional(),
+    to: z.enum(['webp', 'png', 'jpg']).optional(),
+    format: z.literal('webp').optional(), // legacy, maps to 'to'
+    maxWidth: z.number().positive().optional(),
+    quality: z.number().min(1).max(100).optional(),
+}).strict().optional();
+export const ResizeImagesOptionsSchema = z.object({
+    maxWidth: z.number().positive(),
+}).strict();
+export const MergePdfsOptionsSchema = z.object({
+    outputFile: z.string().optional(),
+    order: z.enum(['name', 'name-desc', 'date', 'date-desc', 'random']).optional(),
+}).strict().optional();
+export const ConvertImagesActionSchema = z.object({
+    action: z.literal('convert_images'),
+    options: ConvertImagesOptionsSchema,
+}).strict();
+export const ResizeImagesActionSchema = z.object({
+    action: z.literal('resize_images'),
+    options: ResizeImagesOptionsSchema,
+}).strict();
+export const MergePdfsActionSchema = z.object({
+    action: z.literal('merge_pdfs'),
+    options: MergePdfsOptionsSchema,
+}).strict();
+export const ActionSchema = z.discriminatedUnion('action', [
+    ConvertImagesActionSchema,
+    ResizeImagesActionSchema,
+    MergePdfsActionSchema,
+]);
+/**
+ * Parse and validate an action from AI output or manual input.
+ * Returns the validated action or throws on invalid input.
+ */
+export function parseAction(input) {
+    return ActionSchema.parse(input);
+}
+/**
+ * Safely parse an action, returning null on failure instead of throwing.
+ */
+export function safeParseAction(input) {
+    const result = ActionSchema.safeParse(input);
+    return result.success ? result.data : null;
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,uBAAuB;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjF,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACnC,OAAO,EAAE,0BAA0B;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAClC,OAAO,EAAE,yBAAyB;CACrC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC/B,OAAO,EAAE,sBAAsB;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IACvD,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;CACxB,CAAC,CAAC;AAOH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "filex-cli",
+  "version": "0.1.0",
+  "description": "A Terminal CLI agent to modify and talk with your files",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "filex": "./dist/bin/filex.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx bin/filex.ts",
+    "start": "node dist/bin/filex.js"
+  },
+  "keywords": [
+    "cli",
+    "file",
+    "convert",
+    "resize",
+    "pdf",
+    "merge"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^17.2.3",
+    "ora": "^8.0.1",
+    "pdf-lib": "^1.17.1",
+    "sharp": "^0.33.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}