@uipath/agent-tool 1.202.0-preview.164 → 1.202.0-preview.166

package/dist/executor-tool.js

@@ -1,8 +1,8 @@
 import {
   AgentDebugCancelledError,
   AgentDebugService
-} from "./packager-tool-67y78atd.js";
-import"./packager-tool-r46ma7qq.js";
+} from "./packager-tool-wp4bhw70.js";
+import"./packager-tool-b20zvjv7.js";
 import"./packager-tool-b098y4a2.js";
 import"./packager-tool-1yh8g550.js";
 // ../executor/project-executor/src/models/run-status.ts

package/dist/{index-jkdwsj5d.js → index-g54778e4.js}

@@ -10,7 +10,7 @@ import {
   isGuid,
   logger,
   normalizeProjectType
-} from "./packager-tool-r46ma7qq.js";
+} from "./packager-tool-b20zvjv7.js";
 import"./packager-tool-b098y4a2.js";
 import {
   __commonJS,

package/dist/index.js

@@ -2,13 +2,13 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-8m44mvt1.js";
+} from "./packager-tool-exxhb96s.js";
 import"./packager-tool-4mna26cc.js";
 import"./packager-tool-c23zrhj8.js";
-import"./packager-tool-67y78atd.js";
+import"./packager-tool-wp4bhw70.js";
 import {
   Command
-} from "./packager-tool-r46ma7qq.js";
+} from "./packager-tool-b20zvjv7.js";
 import"./packager-tool-mc1499dc.js";
 import"./packager-tool-b098y4a2.js";
 import"./packager-tool-1yh8g550.js";

package/dist/{packager-tool-r46ma7qq.js → packager-tool-b20zvjv7.js}

@@ -6721,6 +6721,22 @@ Command.prototype.trackedAction = function(context, fn, properties) {
     }
   });
 };
+
+// ../common/src/option-validators.ts
+function parseBoundedInt(raw, optionName, bounds) {
+  const normalized = raw.trim();
+  if (normalized === "") {
+    throw new InvalidArgumentError(`${optionName} requires a value (got empty).`);
+  }
+  if (!/^-?\d+$/.test(normalized)) {
+    throw new InvalidArgumentError(`${optionName} must be an integer, got '${normalized}'.`);
+  }
+  const n = parseInt(normalized, 10);
+  if (n < bounds.min || n > bounds.max) {
+    throw new InvalidArgumentError(`${optionName} must be between ${bounds.min} and ${bounds.max}, got ${n}.`);
+  }
+  return n;
+}
 // ../common/src/classified-failure.ts
 var MAX_QUOTED_BODY_CHARS = 200;
 function summarizePlatformBody(body) {
@@ -9748,6 +9764,6 @@ async function createApiClient(ApiClass, options) {
   const config = await createOrchestratorConfig(options);
   return new ApiClass(config);
 }
-export { getFileSystem, getLoginStatusAsync, getAuthContext, catchError2 as catchError, extractErrorMessage, extractErrorMessageSync, logger, RESULTS, OutputFormatter, summarizePlatformBody, Command, processContext, isGuid, getSdkUserAgentToken, addSdkUserAgentHeader, installSdkUserAgentHeader, normalizeProjectType, readUipxFile, prepareProjectLocation, updateUipxSolutionId, findSolutionFile, updateSolutionFile, tryRegisterProjectInParentSolution, findSolutionFileUpward, PersonalWorkspacesApi, UsersApi, createApiClient };
+export { getFileSystem, getLoginStatusAsync, getAuthContext, catchError2 as catchError, extractErrorMessage, extractErrorMessageSync, logger, RESULTS, OutputFormatter, summarizePlatformBody, Command, processContext, isGuid, parseBoundedInt, getSdkUserAgentToken, addSdkUserAgentHeader, installSdkUserAgentHeader, normalizeProjectType, readUipxFile, prepareProjectLocation, updateUipxSolutionId, findSolutionFile, updateSolutionFile, tryRegisterProjectInParentSolution, findSolutionFileUpward, PersonalWorkspacesApi, UsersApi, createApiClient };
 
-//# debugId=5D42B3DC8CA75EF864756E2164756E21
+//# debugId=9426FBA1C0B28BA764756E2164756E21

package/dist/{packager-tool-8m44mvt1.js → packager-tool-exxhb96s.js}

@@ -13,7 +13,7 @@ import {
   isSolutionUploadHttpError,
   migrateLegacyToolGuardrailPolicies,
   resolveStudioWebConfig
-} from "./packager-tool-67y78atd.js";
+} from "./packager-tool-wp4bhw70.js";
 import {
   OutputFormatter,
   RESULTS,
@@ -27,10 +27,11 @@ import {
   getSdkUserAgentToken,
   installSdkUserAgentHeader,
   logger,
+  parseBoundedInt,
   prepareProjectLocation,
   processContext,
   tryRegisterProjectInParentSolution
-} from "./packager-tool-r46ma7qq.js";
+} from "./packager-tool-b20zvjv7.js";
 import {
   currentAgentStorageSchema,
   currentEvaluationSetStorageSchema,
@@ -6988,7 +6989,7 @@ var require_index_cjs = __commonJS(function(exports, module) {
 var package_default = {
   name: "@uipath/agent-tool",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0-preview.164",
+  version: "1.202.0-preview.166",
   description: "cli plugin for creating and managing UiPath low-code agents",
   private: false,
   repository: {
@@ -7431,7 +7432,7 @@ class VoidApiResponse {
 var package_default2 = {
   name: "@uipath/agent-sdk",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0-preview.164",
+  version: "1.202.0-preview.166",
   description: "SDK for the UiPath Agent Runtime API — evaluation execution and debug sessions.",
   repository: {
     type: "git",
@@ -12792,7 +12793,7 @@ var registerGuardrailCommands = (program) => {
 
 // src/services/project-artifacts.ts
 async function ensureProjectArtifacts(args) {
-  const { addProjectArtifactsToSolutionAsync } = await import("./index-jkdwsj5d.js");
+  const { addProjectArtifactsToSolutionAsync } = await import("./index-g54778e4.js");
   return addProjectArtifactsToSolutionAsync(args);
 }
 
@@ -33284,7 +33285,7 @@ class TextApiResponse {
 var package_default3 = {
   name: "@uipath/integrationservice-sdk",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0-preview.164",
+  version: "1.202.0-preview.166",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -41105,6 +41106,21 @@ var KNOWN_CATEGORIES = [
   "code",
   "general"
 ];
+var GRADES = [
+  "A+",
+  "A",
+  "A-",
+  "B+",
+  "B",
+  "B-",
+  "C+",
+  "C",
+  "C-",
+  "D+",
+  "D",
+  "D-",
+  "F"
+];
 function listCategories() {
   return [...KNOWN_CATEGORIES];
 }
@@ -42959,6 +42975,116 @@ function buildInvalidAgentJsonIssue(loaded) {
     suggestedFix: "Verify agent.json exists and is valid, properly encoded JSON."
   };
 }
+var REVIEW_HISTORY_FILE = "review-history.json";
+var MAX_REVIEW_HISTORY_ENTRIES = 25;
+var isGrade = (value) => typeof value === "string" && GRADES.includes(value);
+var validateEntry = (entry, index) => {
+  if (typeof entry !== "object" || entry === null) {
+    return `[${index}]: expected an object`;
+  }
+  const { grade, runAt, errors: errors3, warnings } = entry;
+  if (!isGrade(grade)) {
+    return `[${index}].grade: expected one of ${GRADES.join(", ")}`;
+  }
+  if (typeof runAt !== "string") {
+    return `[${index}].runAt: expected a string`;
+  }
+  for (const [name, count] of [
+    ["errors", errors3],
+    ["warnings", warnings]
+  ]) {
+    if (count !== undefined && typeof count !== "number") {
+      return `[${index}].${name}: expected a number`;
+    }
+  }
+  return;
+};
+var parseHistory = (raw) => {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err2) {
+    const message = err2 instanceof Error ? err2.message : String(err2);
+    return { success: false, error: `invalid JSON: ${message}` };
+  }
+  if (!Array.isArray(parsed)) {
+    return { success: false, error: "expected a JSON array of entries" };
+  }
+  for (const [index, entry] of parsed.entries()) {
+    const error51 = validateEntry(entry, index);
+    if (error51 !== undefined) {
+      return { success: false, error: error51 };
+    }
+  }
+  return { success: true, data: parsed };
+};
+var parseRunAt = (entry) => {
+  const time3 = Date.parse(entry.runAt);
+  return Number.isNaN(time3) ? Number.NEGATIVE_INFINITY : time3;
+};
+var writeAtomically = async (file2, content, fs7) => {
+  const tempFile = `${file2}.${globalThis.crypto.randomUUID()}.tmp`;
+  try {
+    await fs7.writeFile(tempFile, content);
+    await fs7.rename(tempFile, file2);
+  } catch (err2) {
+    await fs7.rm(tempFile).catch(() => {
+      return;
+    });
+    throw err2;
+  }
+};
+var appendEntry = async (file2, grade, input, fs7) => {
+  let history = [];
+  const raw = await fs7.readFile(file2, "utf-8");
+  if (raw !== null) {
+    const parsed = parseHistory(raw);
+    if (!parsed.success) {
+      return {
+        ok: false,
+        error: "MALFORMED_HISTORY",
+        file: file2,
+        detail: parsed.error
+      };
+    }
+    history = parsed.data;
+  }
+  const entry = {
+    grade,
+    runAt: new Date().toISOString(),
+    ...input.errors !== undefined && { errors: input.errors },
+    ...input.warnings !== undefined && { warnings: input.warnings }
+  };
+  const newTime = Date.parse(entry.runAt);
+  let index = 0;
+  while (index < history.length && parseRunAt(history[index]) > newTime) {
+    index++;
+  }
+  history.splice(index, 0, entry);
+  if (history.length > MAX_REVIEW_HISTORY_ENTRIES) {
+    history.length = MAX_REVIEW_HISTORY_ENTRIES;
+  }
+  await writeAtomically(file2, `${JSON.stringify(history, null, 2)}
+`, fs7);
+  return { ok: true, entry, history };
+};
+var recordReview = async (projectPath, input, fs7) => {
+  const grade = input.grade.toUpperCase();
+  if (!isGrade(grade)) {
+    return { ok: false, error: "INVALID_GRADE", allowed: GRADES };
+  }
+  const stats = await fs7.stat(projectPath);
+  if (!stats?.isDirectory()) {
+    return { ok: false, error: "NOT_A_DIRECTORY", projectPath };
+  }
+  const file2 = fs7.path.join(projectPath, REVIEW_HISTORY_FILE);
+  const release = await fs7.acquireLock(file2);
+  try {
+    return await appendEntry(file2, grade, input, fs7);
+  } finally {
+    await release();
+  }
+};
 
 // src/services/guardrail-catalog-service.ts
 var LLM_AS_JUDGE_VALIDATOR = "llm_as_judge";
@@ -43145,6 +43271,122 @@ var registerReviewCommand = (program) => {
   });
 };
 
+// src/commands/review-history.ts
+var CODES2 = {
+  success: "AgentReviewHistoryAdd",
+  invalidGrade: "AgentReviewHistoryAddInvalidGrade",
+  invalidPath: "AgentReviewHistoryAddInvalidPath",
+  malformedHistory: "AgentReviewHistoryAddMalformedHistory",
+  failed: "AgentReviewHistoryAddFailed"
+};
+var ADD_EXAMPLES = [
+  {
+    Description: "Record a review grade for a project at a specific path",
+    Command: "uip agent review-history add B ./my-agent",
+    Output: {
+      Code: CODES2.success,
+      Data: {
+        ProjectDir: "./my-agent",
+        Grade: "B",
+        RunAt: "2026-09-02T10:00:00.000Z",
+        HistoryCount: 1
+      }
+    }
+  },
+  {
+    Description: "Record a grade with finding counts",
+    Command: "uip agent review-history add C --errors 2 --warnings 5",
+    Output: {
+      Code: CODES2.success,
+      Data: {
+        ProjectDir: ".",
+        Grade: "C",
+        RunAt: "2026-09-02T10:00:00.000Z",
+        Errors: 2,
+        Warnings: 5,
+        HistoryCount: 3
+      }
+    }
+  }
+];
+var COUNT_BOUNDS = { min: 0, max: Number.MAX_SAFE_INTEGER };
+var parseCount = (flag) => (raw) => parseBoundedInt(raw, flag, COUNT_BOUNDS);
+var reportFailure = (rawGrade, outcome) => {
+  switch (outcome.error) {
+    case "INVALID_GRADE":
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Code: CODES2.invalidGrade,
+        ErrorCode: "invalid_argument",
+        Message: `\`${rawGrade}\` is not a recordable grade.`,
+        Instructions: `Pass one of: ${outcome.allowed.join(", ")}.`
+      });
+      return;
+    case "NOT_A_DIRECTORY":
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Code: CODES2.invalidPath,
+        ErrorCode: "invalid_argument",
+        Message: `\`${outcome.projectPath}\` is not an existing directory.`,
+        Instructions: "Pass the agent project directory as [path], or run from inside it."
+      });
+      return;
+    case "MALFORMED_HISTORY":
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Code: CODES2.malformedHistory,
+        ErrorCode: "configuration_error",
+        Message: `\`${outcome.file}\` exists but is not a JSON array of review entries: ${outcome.detail}`,
+        Instructions: "Fix the file so it parses as a JSON array, or delete it to start a fresh history, then rerun."
+      });
+      return;
+  }
+};
+var registerReviewHistoryCommands = (program) => {
+  const reviewHistory = program.command("review-history").description(`Manage the review grades recorded in the project's ${REVIEW_HISTORY_FILE}`);
+  reviewHistory.command("add").description(`Record a review grade in the project's ${REVIEW_HISTORY_FILE}. ` + `Keeps the newest ${MAX_REVIEW_HISTORY_ENTRIES} entries, most recent first. Does not run the review.`).argument("<grade>", "Letter grade to record (A to F)").argument("[path]", "Agent project directory", ".").option("--errors <count>", "Number of error findings to record", parseCount("--errors")).option("--warnings <count>", "Number of warning findings to record", parseCount("--warnings")).examples(ADD_EXAMPLES).trackedAction(processContext, async (grade, targetPath, options) => {
+    const fs7 = getFileSystem();
+    const projectPath = fs7.path.resolve(targetPath);
+    const [err2, outcome] = await catchError(recordReview(projectPath, {
+      grade,
+      errors: options.errors,
+      warnings: options.warnings
+    }, fs7));
+    if (err2) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Code: CODES2.failed,
+        Message: `Recording the review failed: ${extractErrorMessageSync(err2)}`,
+        Instructions: "Verify the project directory is writable. " + "Run `uip agent review-history add --help` for usage."
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (!outcome.ok) {
+      reportFailure(grade, outcome);
+      processContext.exit(1);
+      return;
+    }
+    const { entry, history } = outcome;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: CODES2.success,
+      Data: {
+        ProjectDir: projectPath,
+        Grade: entry.grade,
+        RunAt: entry.runAt,
+        ...entry.errors !== undefined && {
+          Errors: entry.errors
+        },
+        ...entry.warnings !== undefined && {
+          Warnings: entry.warnings
+        },
+        HistoryCount: history.length
+      }
+    });
+  });
+};
+
 // src/commands/tool-list.ts
 var TOOL_LIST_EXAMPLES = [
   {
@@ -43211,6 +43453,7 @@ var registerCommands = async (program) => {
   registerValidateCommand(program);
   registerRefreshCommand(program);
   registerReviewCommand(program);
+  registerReviewHistoryCommands(program);
   registerToolListCommand(program);
   registerMemoryCommands(program);
   registerEvalCommands(program);
@@ -43221,4 +43464,4 @@ var registerCommands = async (program) => {
 
 export { metadata, registerCommands };
 
-//# debugId=4DF03B290A91216D64756E2164756E21
+//# debugId=A17B1EC8CEA891C964756E2164756E21

package/dist/{packager-tool-67y78atd.js → packager-tool-wp4bhw70.js}

@@ -15,7 +15,7 @@ import {
   summarizePlatformBody,
   updateSolutionFile,
   updateUipxSolutionId
-} from "./packager-tool-r46ma7qq.js";
+} from "./packager-tool-b20zvjv7.js";
 import {
   zipSync
 } from "./packager-tool-b098y4a2.js";
@@ -2971,7 +2971,7 @@ function querystringSingleKey2(key, value, keyPrefix = "") {
 var package_default = {
   name: "@uipath/solution-sdk",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0-preview.164",
+  version: "1.202.0-preview.166",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -4238,4 +4238,4 @@ function parseOutput(outputArguments) {
 
 export { StudioWebIncompatibleProjectError, isSolutionUploadHttpError, buildSolutionUploadFailureOutput, migrateLegacyToolGuardrailPolicies, AgentProjectService, resolveStudioWebConfig, AgentLocalWorkspaceEvalPreparer, AgentDebugCancelledError, AgentDebugService };
 
-//# debugId=B270DA760F20059764756E2164756E21
+//# debugId=954E420B48FDDDF864756E2164756E21

package/dist/tool.js

@@ -1,11 +1,11 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-8m44mvt1.js";
+} from "./packager-tool-exxhb96s.js";
 import"./packager-tool-4mna26cc.js";
 import"./packager-tool-c23zrhj8.js";
-import"./packager-tool-67y78atd.js";
-import"./packager-tool-r46ma7qq.js";
+import"./packager-tool-wp4bhw70.js";
+import"./packager-tool-b20zvjv7.js";
 import"./packager-tool-mc1499dc.js";
 import"./packager-tool-b098y4a2.js";
 import"./packager-tool-1yh8g550.js";

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@uipath/agent-tool",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.202.0-preview.164",
+    "version": "1.202.0-preview.166",
     "description": "cli plugin for creating and managing UiPath low-code agents",
     "private": false,
     "repository": {
@@ -28,5 +28,5 @@
     "files": [
         "dist"
     ],
-    "gitHead": "aae1017c05fe1309bcf56a00c942ef3708489446"
+    "gitHead": "3306579525192d21e36edf74e4dbabd0e1c5ad85"
 }