Add SyncClientOptions, Logger util; refactor evals/run.ts to use new Logger; create foundations of CLI

Author: AlePouroullis

.fernignore

@@ -10,8 +10,10 @@ src/humanloop.client.ts
 src/overload.ts
 src/error.ts
 src/context.ts
-src/sync 
+src/cli.ts
 src/cache
+src/sync 
+src/utils
 
 # Tests
 

package.json

@@ -3,54 +3,59 @@
     "version": "0.8.21",
     "private": false,
     "repository": "https://github.com/humanloop/humanloop-node",
-    "main": "./index.js",
-    "types": "./index.d.ts",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
     "scripts": {
         "format": "prettier . --write --ignore-unknown",
         "build": "tsc",
         "prepack": "cp -rv dist/. .",
         "test": "jest"
     },
     "dependencies": {
-        "url-join": "4.0.1",
-        "form-data": "^4.0.0",
-        "formdata-node": "^6.0.3",
-        "node-fetch": "^2.7.0",
-        "qs": "^6.13.1",
-        "readable-stream": "^4.5.2",
-        "form-data-encoder": "^4.0.2",
         "@opentelemetry/api": "<=1.9.0",
         "@opentelemetry/resources": "<=2.0.0",
         "@opentelemetry/sdk-trace-node": "<=2.0.0",
+        "@traceloop/ai-semantic-conventions": ">=0.11.6",
         "@traceloop/instrumentation-anthropic": ">=0.11.1",
         "@traceloop/instrumentation-cohere": ">=0.11.1",
         "@traceloop/instrumentation-openai": ">=0.11.3",
-        "@traceloop/ai-semantic-conventions": ">=0.11.6",
+        "chalk": "^5.4.1",
         "cli-progress": "^3.12.0",
-        "lodash": "^4.17.21"
+        "commander": "^13.1.0",
+        "form-data": "^4.0.0",
+        "form-data-encoder": "^4.0.2",
+        "formdata-node": "^6.0.3",
+        "lodash": "^4.17.21",
+        "node-fetch": "^2.7.0",
+        "qs": "^6.13.1",
+        "readable-stream": "^4.5.2",
+        "url-join": "4.0.1"
     },
     "devDependencies": {
-        "@types/url-join": "4.0.1",
-        "@types/qs": "^6.9.17",
+        "@anthropic-ai/sdk": "^0.32.1",
+        "@trivago/prettier-plugin-sort-imports": "^4.3.0",
+        "@types/cli-progress": "^3.11.6",
+        "@types/jest": "^29.5.14",
+        "@types/lodash": "4.14.74",
+        "@types/node": "^18.19.70",
         "@types/node-fetch": "^2.6.12",
+        "@types/qs": "^6.9.17",
         "@types/readable-stream": "^4.0.18",
-        "webpack": "^5.97.1",
-        "ts-loader": "^9.5.1",
+        "@types/url-join": "4.0.1",
+        "cohere-ai": "^7.15.0",
+        "dotenv": "^16.5.0",
         "jest": "^29.7.0",
-        "@types/jest": "^29.5.14",
-        "ts-jest": "^29.1.1",
         "jest-environment-jsdom": "^29.7.0",
-        "@types/node": "^18.19.70",
+        "jsonschema": "^1.4.1",
+        "openai": "^4.74.0",
         "prettier": "^3.4.2",
+        "ts-jest": "^29.1.1",
+        "ts-loader": "^9.5.1",
         "typescript": "~5.7.2",
-        "openai": "^4.74.0",
-        "@anthropic-ai/sdk": "^0.32.1",
-        "cohere-ai": "^7.15.0",
-        "dotenv": "^16.4.6",
-        "jsonschema": "^1.4.1",
-        "@types/cli-progress": "^3.11.6",
-        "@types/lodash": "4.14.74",
-        "@trivago/prettier-plugin-sort-imports": "^4.3.0"
+        "webpack": "^5.97.1"
+    },
+    "bin": {
+        "humanloop": "dist/cli.js"
     },
     "browser": {
         "fs": false,

src/cli.ts

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import * as dotenv from "dotenv";
+import chalk from "chalk";
+import { Command } from "commander";
+
+import { HumanloopClient } from "./humanloop.client";
+
+const { version } = require("../package.json");
+
+// Load environment variables
+dotenv.config();
+
+const program = new Command();
+program
+    .name("humanloop")
+    .description("Humanloop CLI for managing sync operations")
+    .version(version);
+
+// Common auth options
+const addAuthOptions = (command: Command) =>
+    command
+        .option("--api-key <apiKey>", "Humanloop API key")
+        .option("--env-file <envFile>", "Path to .env file")
+        .option("--base-url <baseUrl>", "Base URL for Humanloop API");
+
+// Helper to get client
+function getClient(options: {
+    envFile?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    baseDir?: string;
+}): HumanloopClient {
+    if (options.envFile) dotenv.config({ path: options.envFile });
+    const apiKey = options.apiKey || process.env.HUMANLOOP_API_KEY;
+    if (!apiKey) {
+        console.error(
+            chalk.red(
+                "No API key found. Set HUMANLOOP_API_KEY in .env file or use --api-key",
+            ),
+        );
+        process.exit(1);
+    }
+    return new HumanloopClient({
+        apiKey,
+        baseUrl: options.baseUrl,
+        sync: { baseDir: options.baseDir },
+    });
+}
+
+// Pull command
+addAuthOptions(
+    program
+        .command("pull")
+        .description("Pull files from Humanloop to local filesystem")
+        .option("-p, --path <path>", "Path to pull (file or directory)")
+        .option("-e, --environment <env>", "Environment to pull from")
+        .option("--base-dir <baseDir>", "Base directory for synced files", "humanloop"),
+).action(async (options) => {
+    try {
+        console.log(chalk.blue("Pulling files from Humanloop..."));
+        const client = getClient(options);
+        const files = await client.pull(options.path, options.environment);
+        console.log(chalk.green(`Successfully synced ${files.length} files`));
+    } catch (error) {
+        console.error(chalk.red(`Error: ${error}`));
+        process.exit(1);
+    }
+});
+
+program.parse(process.argv);