@feralfile/cli 1.1.1

package/dist/src/ai-orchestrator/registry.js

@@ -0,0 +1,96 @@
+/**
+ * In-Memory Registry for Playlists and Items
+ * Reduces AI context usage by storing full objects and passing only IDs
+ */
+// Internal storage
+const itemRegistry = new Map();
+const playlistRegistry = new Map();
+/**
+ * Store a playlist item in the registry
+ *
+ * @param {string} id - Item ID
+ * @param {Object} item - Full DP1 item object
+ */
+function storeItem(id, item) {
+    if (!id) {
+        throw new Error('Item ID is required');
+    }
+    itemRegistry.set(id, item);
+}
+/**
+ * Retrieve a playlist item from the registry
+ *
+ * @param {string} id - Item ID
+ * @returns {Object|undefined} DP1 item object or undefined
+ */
+function getItem(id) {
+    return itemRegistry.get(id);
+}
+/**
+ * Check if an item exists in the registry
+ *
+ * @param {string} id - Item ID
+ * @returns {boolean} True if item exists
+ */
+function hasItem(id) {
+    return itemRegistry.has(id);
+}
+/**
+ * Store a playlist in the registry
+ *
+ * @param {string} id - Playlist ID
+ * @param {Object} playlist - Full DP1 playlist object
+ */
+function storePlaylist(id, playlist) {
+    if (!id) {
+        throw new Error('Playlist ID is required');
+    }
+    playlistRegistry.set(id, playlist);
+}
+/**
+ * Retrieve a playlist from the registry
+ *
+ * @param {string} id - Playlist ID
+ * @returns {Object|undefined} DP1 playlist object or undefined
+ */
+function getPlaylist(id) {
+    return playlistRegistry.get(id);
+}
+/**
+ * Check if a playlist exists in the registry
+ *
+ * @param {string} id - Playlist ID
+ * @returns {boolean} True if playlist exists
+ */
+function hasPlaylist(id) {
+    return playlistRegistry.has(id);
+}
+/**
+ * Clear all registries
+ * Should be called after successful playlist build or on error
+ */
+function clearRegistries() {
+    itemRegistry.clear();
+    playlistRegistry.clear();
+}
+/**
+ * Get registry statistics (for debugging)
+ *
+ * @returns {Object} Registry stats
+ */
+function getStats() {
+    return {
+        itemCount: itemRegistry.size,
+        playlistCount: playlistRegistry.size,
+    };
+}
+module.exports = {
+    storeItem,
+    getItem,
+    hasItem,
+    storePlaylist,
+    getPlaylist,
+    hasPlaylist,
+    clearRegistries,
+    getStats,
+};

package/dist/src/commands/build.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+const main_1 = require("../main");
+exports.buildCommand = new commander_1.Command('build')
+    .description('Build playlist from structured parameters (JSON file or stdin)')
+    .argument('[params-file]', 'Path to JSON parameters file (or use stdin)')
+    .option('-o, --output <filename>', 'Output filename for the playlist', 'playlist.json')
+    .option('-v, --verbose', 'Show detailed output', false)
+    .action(async (paramsFile, options) => {
+    try {
+        let params;
+        if (paramsFile) {
+            const content = await fs_1.promises.readFile(paramsFile, 'utf-8');
+            params = JSON.parse(content);
+        }
+        else {
+            const stdin = await new Promise((resolve, reject) => {
+                let data = '';
+                process.stdin.setEncoding('utf8');
+                process.stdin.on('data', (chunk) => {
+                    data += chunk;
+                });
+                process.stdin.on('end', () => {
+                    resolve(data);
+                });
+                process.stdin.on('error', reject);
+            });
+            if (!stdin.trim()) {
+                console.error(chalk_1.default.red('No parameters provided'));
+                console.log(chalk_1.default.yellow('\nUsage:'));
+                console.log('  ff1 build params.json');
+                console.log('  cat params.json | ff1 build');
+                console.log('  echo \'{"requirements":[...]}\' | ff1 build');
+                process.exit(1);
+            }
+            params = JSON.parse(stdin);
+        }
+        if (options.verbose) {
+            console.log(chalk_1.default.blue('\nParameters:'));
+            console.log(chalk_1.default.dim(JSON.stringify(params, null, 2)));
+            console.log();
+        }
+        console.log(chalk_1.default.blue('\nBuild playlist from parameters\n'));
+        const result = await (0, main_1.buildPlaylistDirect)(params, {
+            verbose: options.verbose,
+            outputPath: options.output,
+        });
+        if (result && result.playlist) {
+            console.log(chalk_1.default.green('\nPlaylist saved'));
+            console.log(chalk_1.default.dim(`  Title: ${result.playlist.title}`));
+            console.log(chalk_1.default.dim(`  Items: ${result.playlist.items?.length || 0}`));
+            console.log(chalk_1.default.dim(`  Output: ${options.output}\n`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('\nError:'), error.message);
+        if (options.verbose) {
+            console.error(chalk_1.default.dim(error.stack));
+        }
+        process.exit(1);
+    }
+});

package/dist/src/commands/chat.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const readline = __importStar(require("readline"));
+const config_1 = require("../config");
+const main_1 = require("../main");
+const playlist_display_1 = require("./helpers/playlist-display");
+// chat keeps an inline readline instance — historySize and the closed-flag
+// lifecycle (Ctrl+C → close → graceful exit) are specific to this command
+// and don't belong in the shared createPrompt() helper.
+exports.chatCommand = new commander_1.Command('chat')
+    .description('Start an interactive chat to build playlists using natural language')
+    .argument('[content]', 'Optional: Direct chat content (non-interactive mode)')
+    .option('-o, --output <filename>', 'Output filename for the playlist', 'playlist.json')
+    .option('-m, --model <name>', 'AI model to use (claude, grok, gpt, gemini) - defaults to config setting')
+    .option('-d, --device <name>', 'Target FF1 device name (defaults to first configured device)')
+    .option('-v, --verbose', 'Show detailed technical output of function calls', false)
+    .action(async (content, options) => {
+    try {
+        const config = (0, config_1.getConfig)();
+        const availableModels = (0, config_1.listAvailableModels)();
+        if (options.model && !availableModels.includes(options.model)) {
+            console.error(chalk_1.default.red(`Invalid model: "${options.model}"`));
+            console.log(chalk_1.default.yellow(`Available models: ${availableModels.join(', ')}`));
+            process.exit(1);
+        }
+        const modelName = options.model || config.defaultModel;
+        const validation = (0, config_1.validateConfig)(modelName);
+        if (!validation.valid) {
+            console.error(chalk_1.default.red('Configuration error:'));
+            validation.errors.forEach((error) => {
+                console.error(chalk_1.default.red(`  • ${error}`));
+            });
+            console.log(chalk_1.default.yellow('\nRun: ff1 setup\n'));
+            process.exit(1);
+        }
+        // Non-interactive mode: content was passed as a positional argument.
+        if (content) {
+            console.log(chalk_1.default.blue('\nFF1 Chat (non-interactive)\n'));
+            console.log(chalk_1.default.dim(`Model: ${modelName}\n`));
+            console.log(chalk_1.default.yellow('Request:'), content);
+            console.log();
+            try {
+                const result = await (0, main_1.buildPlaylist)(content, {
+                    verbose: options.verbose,
+                    outputPath: options.output,
+                    modelName: modelName,
+                    interactive: false,
+                    deviceName: options.device,
+                });
+                if (result && result.playlist) {
+                    console.log(chalk_1.default.green('\nPlaylist saved'));
+                    console.log(chalk_1.default.dim(`  Title: ${result.playlist.title}`));
+                    console.log(chalk_1.default.dim(`  Items: ${result.playlist.items?.length || 0}`));
+                    console.log(chalk_1.default.dim(`  Output: ${options.output}\n`));
+                }
+                process.exit(0);
+            }
+            catch (error) {
+                console.error(chalk_1.default.red('\nError:'), error.message);
+                if (options.verbose) {
+                    console.error(chalk_1.default.dim(error.stack));
+                }
+                process.exit(1);
+            }
+        }
+        // Interactive mode.
+        console.log(chalk_1.default.blue('\nFF1 Chat\n'));
+        console.log(chalk_1.default.dim('Describe the playlist you want. Ctrl+C to exit.'));
+        console.log(chalk_1.default.dim(`Model: ${modelName}\n`));
+        console.log(chalk_1.default.dim('Examples:'));
+        console.log(chalk_1.default.dim('  • Get 3 works from reas.eth'));
+        console.log(chalk_1.default.dim('  • Get 3 works from einstein-rosen.tez'));
+        console.log(chalk_1.default.dim('  • Get tokens 52932,52457 from Ethereum contract 0xb932a70A57673d89f4acfFBE830E8ed7f75Fb9e0'));
+        console.log(chalk_1.default.dim('  • Get 3 from Unsupervised'));
+        console.log(chalk_1.default.dim('  Tip: add -v to see tool calls'));
+        console.log();
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            historySize: 100,
+        });
+        let closed = false;
+        rl.on('close', () => {
+            closed = true;
+        });
+        rl.on('SIGINT', () => {
+            rl.close();
+        });
+        const ask = async () => new Promise((resolve) => {
+            if (closed) {
+                resolve('');
+                return;
+            }
+            rl.question(chalk_1.default.yellow('You: '), (answer) => {
+                resolve(answer.trim());
+            });
+        });
+        while (!closed) {
+            const userInput = await ask();
+            if (closed) {
+                break;
+            }
+            if (!userInput) {
+                continue;
+            }
+            console.log();
+            try {
+                const result = await (0, main_1.buildPlaylist)(userInput, {
+                    verbose: options.verbose,
+                    outputPath: options.output,
+                    modelName: modelName,
+                    deviceName: options.device,
+                });
+                // Skip the playlist summary for send actions: the device send path
+                // already emits its own confirmation, and re-printing here would
+                // imply the playlist was only built (not sent).
+                if (options.verbose) {
+                    console.log(chalk_1.default.dim(`\n[DEBUG] result.sentToDevice: ${result?.sentToDevice}`));
+                    console.log(chalk_1.default.dim(`[DEBUG] result.action: ${result?.action}`));
+                }
+                if (result &&
+                    result.playlist &&
+                    result.action !== 'send_playlist' &&
+                    !result.sentToDevice) {
+                    (0, playlist_display_1.displayPlaylistSummary)(result.playlist, options.output);
+                }
+            }
+            catch (error) {
+                console.error(chalk_1.default.red('Error:'), error.message);
+                if (options.verbose) {
+                    console.error(chalk_1.default.dim(error.stack));
+                }
+                console.log();
+            }
+        }
+        if (closed) {
+            throw new Error('readline was closed');
+        }
+    }
+    catch (error) {
+        if (error.message !== 'readline was closed') {
+            console.error(chalk_1.default.red('\nError:'), error.message);
+            if (process.env.DEBUG) {
+                console.error(chalk_1.default.dim(error.stack));
+            }
+        }
+        console.log(chalk_1.default.blue('\nGoodbye\n'));
+        process.exit(0);
+    }
+});

package/dist/src/commands/config.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../config");
+// `config` is a single command with an action argument rather than a
+// commander subcommand group. Kept this way to preserve the existing
+// CLI surface (`ff1 config init|show|validate`) used in scripts.
+exports.configCommand = new commander_1.Command('config')
+    .description('Manage configuration')
+    .argument('<action>', 'Action: init, show, or validate')
+    .action(async (action) => {
+    try {
+        if (action === 'init') {
+            console.log(chalk_1.default.blue('\nCreate config.json\n'));
+            const { userPath } = (0, config_1.getConfigPaths)();
+            const configPath = await (0, config_1.createSampleConfig)(userPath);
+            console.log(chalk_1.default.green(`Created ${configPath}`));
+            console.log(chalk_1.default.yellow('\nNext: ff1 setup\n'));
+        }
+        else if (action === 'show') {
+            const config = (0, config_1.getConfig)();
+            console.log(chalk_1.default.blue('\nCurrent configuration\n'));
+            console.log(chalk_1.default.bold('Default model:'), chalk_1.default.white(config.defaultModel));
+            console.log(chalk_1.default.bold('Default duration:'), chalk_1.default.white(config.defaultDuration + 's'));
+            console.log(chalk_1.default.bold('\nAvailable models:\n'));
+            const models = (0, config_1.listAvailableModels)();
+            models.forEach((modelName) => {
+                const modelConfig = config.models[modelName];
+                const isCurrent = modelName === config.defaultModel;
+                console.log(`  ${isCurrent ? chalk_1.default.green('→') : ' '} ${chalk_1.default.bold(modelName)}`);
+                console.log(`    API key: ${modelConfig.apiKey && modelConfig.apiKey !== 'your_api_key_here' ? chalk_1.default.green('Set') : chalk_1.default.red('Missing')}`);
+                console.log(`    Base URL: ${chalk_1.default.dim(modelConfig.baseURL)}`);
+                console.log(`    Model: ${chalk_1.default.dim(modelConfig.model)}`);
+                console.log(`    Function calling: ${modelConfig.supportsFunctionCalling ? chalk_1.default.green('Supported') : chalk_1.default.red('Not supported')}`);
+                console.log();
+            });
+        }
+        else if (action === 'validate') {
+            const validation = (0, config_1.validateConfig)();
+            console.log(chalk_1.default.blue('\nValidate configuration\n'));
+            if (validation.valid) {
+                console.log(chalk_1.default.green('Configuration is valid\n'));
+            }
+            else {
+                console.log(chalk_1.default.red('Configuration has errors:\n'));
+                validation.errors.forEach((error) => {
+                    console.log(chalk_1.default.red(`  • ${error}`));
+                });
+                console.log();
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(chalk_1.default.red(`\nUnknown action: ${action}`));
+            console.log(chalk_1.default.yellow('Available actions: init, show, validate\n'));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('\nError:'), error.message);
+        process.exit(1);
+    }
+});