@salesforce/plugin-agent 1.40.5 → 1.42.0

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-agent",
     "description": "Commands to interact with Salesforce agents",
-    "version": "1.40.5",
+    "version": "1.42.0",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
@@ -12,12 +12,12 @@
         "@inquirer/prompts": "^7.10.1",
         "@oclif/core": "^4",
         "@oclif/multi-stage-output": "^0.8.36",
-        "@salesforce/agents": "^1.6.6",
+        "@salesforce/agents": "^1.8.0",
         "@salesforce/core": "^8.28.3",
         "@salesforce/kit": "^3.2.6",
         "@salesforce/sf-plugins-core": "^12.2.6",
         "@salesforce/source-deploy-retrieve": "^12.35.3",
-        "@salesforce/types": "^1.7.1",
+        "@salesforce/types": "1.7.1",
         "ansis": "^3.3.2",
         "fast-xml-parser": "^5.7.1",
         "glob": "^11.0.3",
@@ -94,6 +94,16 @@
                     "validate": {
                         "description": "Command to validate an Agent Script file.",
                         "external": true
+                    },
+                    "adl": {
+                        "description": "Commands to manage Agentforce Data Libraries.",
+                        "external": true,
+                        "subtopics": {
+                            "file": {
+                                "description": "Commands to manage files in an SFDRIVE data library.",
+                                "external": true
+                            }
+                        }
                     }
                 }
             }
@@ -240,7 +250,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.40.5.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.40.5.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.42.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.42.0.sig"
     }
 }

package/schemas/agent-adl-create.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlCreateResult",
+  "definitions": {
+    "AgentAdlCreateResult": {
+      "$ref": "#/definitions/DataLibraryDetail"
+    },
+    "DataLibraryDetail": {
+      "type": "object",
+      "properties": {
+        "libraryId": {
+          "type": "string"
+        },
+        "masterLabel": {
+          "type": "string"
+        },
+        "developerName": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "sourceType": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "retrieverId": {
+          "type": "string"
+        },
+        "retrieverLabel": {
+          "type": "string"
+        },
+        "dataSpaceScopeId": {
+          "type": "string"
+        },
+        "groundingSource": {
+          "type": "object",
+          "properties": {
+            "groundingSourceType": {
+              "type": "string"
+            },
+            "groundingFileRefs": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/GroundingFileRef"
+              }
+            }
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "additionalProperties": false
+    },
+    "GroundingFileRef": {
+      "type": "object",
+      "properties": {
+        "fileId": {
+          "type": "string"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "filePath": {
+          "type": "string"
+        },
+        "fileSize": {
+          "type": "number"
+        },
+        "createdDate": {
+          "type": "string"
+        },
+        "createdBy": {
+          "type": "string"
+        }
+      },
+      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-delete.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlDeleteResult",
+  "definitions": {
+    "AgentAdlDeleteResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "libraryId": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "libraryId"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-file-add.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlFileAddResult",
+  "definitions": {
+    "AgentAdlFileAddResult": {
+      "$ref": "#/definitions/FileAddResult"
+    },
+    "FileAddResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "libraryId": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "fileName", "libraryId"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-file-delete.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlFileDeleteResult",
+  "definitions": {
+    "AgentAdlFileDeleteResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "fileId": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "fileId"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-file-list.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlFileListResult",
+  "definitions": {
+    "AgentAdlFileListResult": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GroundingFileRef"
+          }
+        }
+      },
+      "required": ["files"],
+      "additionalProperties": false
+    },
+    "GroundingFileRef": {
+      "type": "object",
+      "properties": {
+        "fileId": {
+          "type": "string"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "filePath": {
+          "type": "string"
+        },
+        "fileSize": {
+          "type": "number"
+        },
+        "createdDate": {
+          "type": "string"
+        },
+        "createdBy": {
+          "type": "string"
+        }
+      },
+      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-get.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlGetResult",
+  "definitions": {
+    "AgentAdlGetResult": {
+      "$ref": "#/definitions/DataLibraryDetail"
+    },
+    "DataLibraryDetail": {
+      "type": "object",
+      "properties": {
+        "libraryId": {
+          "type": "string"
+        },
+        "masterLabel": {
+          "type": "string"
+        },
+        "developerName": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "sourceType": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "retrieverId": {
+          "type": "string"
+        },
+        "retrieverLabel": {
+          "type": "string"
+        },
+        "dataSpaceScopeId": {
+          "type": "string"
+        },
+        "groundingSource": {
+          "type": "object",
+          "properties": {
+            "groundingSourceType": {
+              "type": "string"
+            },
+            "groundingFileRefs": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/GroundingFileRef"
+              }
+            }
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "additionalProperties": false
+    },
+    "GroundingFileRef": {
+      "type": "object",
+      "properties": {
+        "fileId": {
+          "type": "string"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "filePath": {
+          "type": "string"
+        },
+        "fileSize": {
+          "type": "number"
+        },
+        "createdDate": {
+          "type": "string"
+        },
+        "createdBy": {
+          "type": "string"
+        }
+      },
+      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-list.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlListResult",
+  "definitions": {
+    "AgentAdlListResult": {
+      "type": "object",
+      "properties": {
+        "libraries": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DataLibrarySummary"
+          }
+        }
+      },
+      "required": ["libraries"],
+      "additionalProperties": false
+    },
+    "DataLibrarySummary": {
+      "type": "object",
+      "properties": {
+        "libraryId": {
+          "type": "string"
+        },
+        "masterLabel": {
+          "type": "string"
+        },
+        "developerName": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "sourceType": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        }
+      },
+      "required": ["libraryId", "masterLabel", "developerName", "sourceType", "status"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-status.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlStatusResult",
+  "definitions": {
+    "AgentAdlStatusResult": {
+      "$ref": "#/definitions/IndexingStatusResponse"
+    },
+    "IndexingStatusResponse": {
+      "type": "object",
+      "properties": {
+        "indexingStatus": {
+          "type": "object",
+          "properties": {
+            "libraryId": {
+              "type": "string"
+            },
+            "status": {
+              "type": "string"
+            },
+            "currentStage": {
+              "type": "string"
+            },
+            "stageDetails": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/StageDetail"
+              }
+            },
+            "lastUpdatedAt": {
+              "type": "number"
+            }
+          },
+          "required": ["libraryId", "status"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["indexingStatus"],
+      "additionalProperties": false
+    },
+    "StageDetail": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "completedAt": {
+          "type": "number"
+        },
+        "startedAt": {
+          "type": "number"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": ["name", "status"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-update.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlUpdateResult",
+  "definitions": {
+    "AgentAdlUpdateResult": {
+      "$ref": "#/definitions/DataLibraryDetail"
+    },
+    "DataLibraryDetail": {
+      "type": "object",
+      "properties": {
+        "libraryId": {
+          "type": "string"
+        },
+        "masterLabel": {
+          "type": "string"
+        },
+        "developerName": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "sourceType": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "retrieverId": {
+          "type": "string"
+        },
+        "retrieverLabel": {
+          "type": "string"
+        },
+        "dataSpaceScopeId": {
+          "type": "string"
+        },
+        "groundingSource": {
+          "type": "object",
+          "properties": {
+            "groundingSourceType": {
+              "type": "string"
+            },
+            "groundingFileRefs": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/GroundingFileRef"
+              }
+            }
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "additionalProperties": false
+    },
+    "GroundingFileRef": {
+      "type": "object",
+      "properties": {
+        "fileId": {
+          "type": "string"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "filePath": {
+          "type": "string"
+        },
+        "fileSize": {
+          "type": "number"
+        },
+        "createdDate": {
+          "type": "string"
+        },
+        "createdBy": {
+          "type": "string"
+        }
+      },
+      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-adl-upload.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AgentAdlUploadResult",
+  "definitions": {
+    "AgentAdlUploadResult": {
+      "$ref": "#/definitions/UploadResult"
+    },
+    "UploadResult": {
+      "type": "object",
+      "properties": {
+        "libraryId": {
+          "type": "string"
+        },
+        "retrieverId": {
+          "type": "string"
+        },
+        "ragFeatureConfigId": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        }
+      },
+      "required": ["libraryId", "status"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/agent-preview-end.json

@@ -32,11 +32,8 @@
           "type": "string"
         }
       },
-      "required": [
-        "sessionId",
-        "tracesPath"
-      ],
+      "required": ["sessionId", "tracesPath"],
       "additionalProperties": false
     }
   }
-}
+}