@salesforce/plugin-agent 1.42.1 → 1.44.4

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-agent",
     "description": "Commands to interact with Salesforce agents",
-    "version": "1.42.1",
+    "version": "1.44.4",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
@@ -12,7 +12,7 @@
         "@inquirer/prompts": "^7.10.1",
         "@oclif/core": "^4",
         "@oclif/multi-stage-output": "^0.8.36",
-        "@salesforce/agents": "^1.8.1",
+        "@salesforce/agents": "^1.10.2",
         "@salesforce/core": "^8.28.3",
         "@salesforce/kit": "^3.2.6",
         "@salesforce/sf-plugins-core": "^12.2.6",
@@ -104,6 +104,16 @@
                                 "external": true
                             }
                         }
+                    },
+                    "mcp": {
+                        "description": "Commands to manage MCP server registrations in the API Catalog.",
+                        "external": true,
+                        "subtopics": {
+                            "asset": {
+                                "description": "Commands to manage the asset allowlist of an MCP server.",
+                                "external": true
+                            }
+                        }
                     }
                 }
             }
@@ -250,7 +260,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.42.1.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.42.1.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.44.4.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.44.4.sig"
     }
 }

package/schemas/agent-adl-create.json

@@ -35,6 +35,15 @@
         "dataSpaceScopeId": {
           "type": "string"
         },
+        "retriever": {
+          "$ref": "#/definitions/RetrieverDetail"
+        },
+        "retrieverAction": {
+          "$ref": "#/definitions/RetrieverActionDetail"
+        },
+        "totalFileCount": {
+          "type": "number"
+        },
         "groundingSource": {
           "type": "object",
           "properties": {
@@ -51,7 +60,50 @@
           "additionalProperties": {}
         }
       },
-      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "required": [
+        "libraryId",
+        "masterLabel",
+        "developerName",
+        "sourceType"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverActionDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
       "additionalProperties": false
     },
     "GroundingFileRef": {
@@ -74,10 +126,18 @@
         },
         "createdBy": {
           "type": "string"
+        },
+        "status": {
+          "type": "string"
         }
       },
-      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "required": [
+        "fileId",
+        "fileName",
+        "filePath",
+        "fileSize"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-delete.json

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["success", "libraryId"],
+      "required": [
+        "success",
+        "libraryId"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

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

@@ -24,8 +24,13 @@
           "type": "string"
         }
       },
-      "required": ["success", "fileName", "fileNames", "libraryId"],
+      "required": [
+        "success",
+        "fileName",
+        "fileNames",
+        "libraryId"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

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

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["success", "fileId"],
+      "required": [
+        "success",
+        "fileId"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

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

@@ -3,6 +3,9 @@
   "$ref": "#/definitions/AgentAdlFileListResult",
   "definitions": {
     "AgentAdlFileListResult": {
+      "$ref": "#/definitions/FileListResponse"
+    },
+    "FileListResponse": {
       "type": "object",
       "properties": {
         "files": {
@@ -10,9 +13,21 @@
           "items": {
             "$ref": "#/definitions/GroundingFileRef"
           }
+        },
+        "totalSize": {
+          "type": "number"
+        },
+        "currentPageUrl": {
+          "type": "string"
+        },
+        "nextPageUrl": {
+          "type": "string"
         }
       },
-      "required": ["files"],
+      "required": [
+        "files",
+        "totalSize"
+      ],
       "additionalProperties": false
     },
     "GroundingFileRef": {
@@ -35,10 +50,18 @@
         },
         "createdBy": {
           "type": "string"
+        },
+        "status": {
+          "type": "string"
         }
       },
-      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "required": [
+        "fileId",
+        "fileName",
+        "filePath",
+        "fileSize"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-get.json

@@ -35,6 +35,15 @@
         "dataSpaceScopeId": {
           "type": "string"
         },
+        "retriever": {
+          "$ref": "#/definitions/RetrieverDetail"
+        },
+        "retrieverAction": {
+          "$ref": "#/definitions/RetrieverActionDetail"
+        },
+        "totalFileCount": {
+          "type": "number"
+        },
         "groundingSource": {
           "type": "object",
           "properties": {
@@ -51,7 +60,50 @@
           "additionalProperties": {}
         }
       },
-      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "required": [
+        "libraryId",
+        "masterLabel",
+        "developerName",
+        "sourceType"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverActionDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
       "additionalProperties": false
     },
     "GroundingFileRef": {
@@ -74,10 +126,18 @@
         },
         "createdBy": {
           "type": "string"
+        },
+        "status": {
+          "type": "string"
         }
       },
-      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "required": [
+        "fileId",
+        "fileName",
+        "filePath",
+        "fileSize"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-list.json

@@ -12,7 +12,9 @@
           }
         }
       },
-      "required": ["libraries"],
+      "required": [
+        "libraries"
+      ],
       "additionalProperties": false
     },
     "DataLibrarySummary": {
@@ -35,10 +37,60 @@
         },
         "status": {
           "type": "string"
+        },
+        "retriever": {
+          "$ref": "#/definitions/RetrieverDetail"
+        },
+        "retrieverAction": {
+          "$ref": "#/definitions/RetrieverActionDetail"
+        }
+      },
+      "required": [
+        "libraryId",
+        "masterLabel",
+        "developerName",
+        "sourceType",
+        "status"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverActionDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
         }
       },
-      "required": ["libraryId", "masterLabel", "developerName", "sourceType", "status"],
+      "required": [
+        "id",
+        "label"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-status.json

@@ -30,11 +30,16 @@
               "type": "number"
             }
           },
-          "required": ["libraryId", "status"],
+          "required": [
+            "libraryId",
+            "status"
+          ],
           "additionalProperties": false
         }
       },
-      "required": ["indexingStatus"],
+      "required": [
+        "indexingStatus"
+      ],
       "additionalProperties": false
     },
     "StageDetail": {
@@ -54,10 +59,45 @@
         },
         "error": {
           "type": "string"
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StageArtifact"
+          }
+        },
+        "errorCode": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "status"
+      ],
+      "additionalProperties": false
+    },
+    "StageArtifact": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        },
+        "assetType": {
+          "type": "string"
         }
       },
-      "required": ["name", "status"],
+      "required": [
+        "id",
+        "label",
+        "assetType"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-update.json

@@ -35,6 +35,15 @@
         "dataSpaceScopeId": {
           "type": "string"
         },
+        "retriever": {
+          "$ref": "#/definitions/RetrieverDetail"
+        },
+        "retrieverAction": {
+          "$ref": "#/definitions/RetrieverActionDetail"
+        },
+        "totalFileCount": {
+          "type": "number"
+        },
         "groundingSource": {
           "type": "object",
           "properties": {
@@ -51,7 +60,50 @@
           "additionalProperties": {}
         }
       },
-      "required": ["libraryId", "masterLabel", "developerName", "sourceType"],
+      "required": [
+        "libraryId",
+        "masterLabel",
+        "developerName",
+        "sourceType"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "RetrieverActionDetail": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "apiName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "label"
+      ],
       "additionalProperties": false
     },
     "GroundingFileRef": {
@@ -74,10 +126,18 @@
         },
         "createdBy": {
           "type": "string"
+        },
+        "status": {
+          "type": "string"
         }
       },
-      "required": ["fileId", "fileName", "filePath", "fileSize"],
+      "required": [
+        "fileId",
+        "fileName",
+        "filePath",
+        "fileSize"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-adl-upload.json

@@ -21,8 +21,11 @@
           "type": "string"
         }
       },
-      "required": ["libraryId", "status"],
+      "required": [
+        "libraryId",
+        "status"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-mcp-asset-list.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ApiCatalogMcpServerAssetListResult",
+  "definitions": {
+    "ApiCatalogMcpServerAssetListResult": {
+      "$ref": "#/definitions/McpServerAssetCollection"
+    },
+    "McpServerAssetCollection": {
+      "type": "object",
+      "properties": {
+        "assets": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/McpServerAssetOutput"
+          }
+        }
+      },
+      "required": [
+        "assets"
+      ],
+      "additionalProperties": false
+    },
+    "McpServerAssetOutput": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "kind": {
+          "$ref": "#/definitions/McpAssetKind"
+        },
+        "active": {
+          "type": "boolean"
+        },
+        "availableAsAgentAction": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "kind",
+        "active"
+      ],
+      "additionalProperties": false
+    },
+    "McpAssetKind": {
+      "type": "string",
+      "enum": [
+        "MCP_TOOL",
+        "MCP_PROMPT",
+        "MCP_RESOURCE"
+      ]
+    }
+  }
+}

package/schemas/agent-mcp-asset-replace.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ApiCatalogMcpServerAssetReplaceResult",
+  "definitions": {
+    "ApiCatalogMcpServerAssetReplaceResult": {
+      "$ref": "#/definitions/McpServerAssetCollection"
+    },
+    "McpServerAssetCollection": {
+      "type": "object",
+      "properties": {
+        "assets": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/McpServerAssetOutput"
+          }
+        }
+      },
+      "required": [
+        "assets"
+      ],
+      "additionalProperties": false
+    },
+    "McpServerAssetOutput": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "kind": {
+          "$ref": "#/definitions/McpAssetKind"
+        },
+        "active": {
+          "type": "boolean"
+        },
+        "availableAsAgentAction": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "kind",
+        "active"
+      ],
+      "additionalProperties": false
+    },
+    "McpAssetKind": {
+      "type": "string",
+      "enum": [
+        "MCP_TOOL",
+        "MCP_PROMPT",
+        "MCP_RESOURCE"
+      ]
+    }
+  }
+}