@makehq/forman-schema 1.7.0 → 1.8.0

package/dist/index.cjs

@@ -67,7 +67,7 @@ var API_ENDPOINTS = {
   aiagent: "api://ai-agents/v1/agents",
   datastore: "api://data-stores",
   hook: "api://hooks/{{kind}}",
-  device: "api://devices",
+  device: "api://devices/{{kind}}",
   keychain: "api://keys/{{kind}}",
   udt: "api://data-structures",
   scenario: "api://scenario-list"
@@ -310,16 +310,17 @@ function toJSONSchemaInternal(field, context = createDefaultContext()) {
     case "select":
     case "account":
     case "hook":
+    case "device":
     case "keychain":
     case "datastore":
     case "aiagent":
     case "file":
     case "folder":
-      return handleSelectType(normalizedField, result, context);
+      return handleSelectOrPathType(normalizedField, result, context);
     case "filter":
       return handleFilterType(normalizedField, result, context);
     default:
-      return handlePrimitiveType(normalizedField, result);
+      return handlePrimitiveType(normalizedField, result, context);
   }
 }
 function handleCollectionType(field, result, context) {
@@ -435,8 +436,22 @@ function handleFilterType(field, result, context) {
   });
   return result;
 }
-function handleSelectType(field, result, context) {
+function handleSelectOrPathType(field, result, context) {
   const optionsOrGroups = isObject(field.options) ? field.options.store : field.options;
+  if (["file", "folder"].includes(field.type)) {
+    const optionsWrapper = isObject(field.options) ? field.options : void 0;
+    Object.defineProperty(result, "x-path", {
+      configurable: true,
+      enumerable: true,
+      writable: true,
+      value: {
+        type: field.type,
+        showRoot: optionsWrapper?.showRoot ?? true,
+        singleLevel: optionsWrapper?.singleLevel ?? false,
+        ownName: field.name
+      }
+    });
+  }
   const nested = isObject(field.options) ? isObject(field.options.nested) ? field.options.nested.store : field.options.nested : void 0;
   const nestedContainsStrings = Array.isArray(nested) && nested.some((item) => typeof item === "string");
   const domain = isObject(field.options) ? isObject(field.options.nested) && field.options.nested.domain ? field.options.nested.domain : void 0 : void 0;
@@ -545,9 +560,10 @@ function handleSelectType(field, result, context) {
       )
     });
   }
+  if (field.rpc) result = processRpcDirective(field, result, context);
   return result;
 }
-function handlePrimitiveType(field, result) {
+function handlePrimitiveType(field, result, context) {
   if (field.default !== "" && field.default != null) {
     result.default = field.default;
   }
@@ -565,6 +581,21 @@ function handlePrimitiveType(field, result) {
       result.enum = field.validate.enum;
     }
   }
+  if (field.rpc) result = processRpcDirective(field, result, context);
+  return result;
+}
+function processRpcDirective(field, result, context) {
+  if (!field.rpc) return result;
+  Object.defineProperty(result, "x-search", {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    value: {
+      url: appendQueryString(field.rpc.url, context.domain, context.tail),
+      label: field.rpc.label,
+      inputSchema: typeof field.rpc.parameters === "string" ? { $ref: field.rpc.parameters } : toJSONSchemaInternal({ type: "collection", spec: field.rpc.parameters }, context)
+    }
+  });
   return result;
 }
 
@@ -572,6 +603,7 @@ function handlePrimitiveType(field, result) {
 var FORMAN_TYPE_MAP2 = {
   account: "number",
   hook: "number",
+  device: "number",
   keychain: "number",
   datastore: "number",
   aiagent: "string",
@@ -652,7 +684,7 @@ async function validateFormanWithDomainsInternal(domains, options) {
         validateNestedFields: () => {
           throw new Error("Cannot validate nested fields without parent field.");
         },
-        resolveRemote: async (path, context) => {
+        resolveRemote: async (path, context, localData) => {
           if (!options?.resolveRemote) {
             throw new Error("Remote resource not supported when resolver is not provided.");
           }
@@ -663,7 +695,10 @@ async function validateFormanWithDomainsInternal(domains, options) {
             },
             {}
           );
-          return await options.resolveRemote(path, data);
+          return await options.resolveRemote(path, {
+            ...data,
+            ...localData
+          });
         }
       }
     );
@@ -750,9 +785,10 @@ async function validateFormanValue(value, field, context) {
     case "aiagent":
     case "udt":
     case "scenario":
+      return handleSelectType(value, normalizedField, context);
     case "file":
     case "folder":
-      return handleSelectType2(value, normalizedField, context);
+      return handlePathType(value, normalizedField, context);
     case "filter":
       return handleFilterType2(value, normalizedField, context);
     default:
@@ -917,7 +953,152 @@ async function handleFilterType2(value, field, context) {
   };
   return handleArrayType2(value, inlineSchema, context);
 }
-async function handleSelectType2(value, field, context) {
+async function handlePathType(value, field, context) {
+  const errors = [];
+  if (typeof value !== "string") {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Expected type 'string' for path, got type '${typeof value}'.`
+        }
+      ]
+    };
+  }
+  let showRoot = true;
+  let ids = false;
+  let singleLevel = false;
+  let options;
+  if (isObject(field.options)) {
+    if (field.options.showRoot !== void 0) showRoot = field.options.showRoot;
+    if (field.options.ids !== void 0) ids = field.options.ids;
+    if (field.options.singleLevel !== void 0) singleLevel = field.options.singleLevel;
+    options = field.options.store;
+  } else {
+    options = field.options;
+  }
+  if (singleLevel && (!showRoot && value.includes("/") || showRoot && value.lastIndexOf("/") > 0)) {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Single level path cannot contain slashes.`
+        }
+      ]
+    };
+  }
+  let nested = field.nested ? field.nested : isObject(field.options) ? field.options.nested : void 0;
+  const levels = value.split("/");
+  if (levels[0] !== "") levels.unshift("");
+  if (showRoot && value === "/" && field.type === "folder") {
+    return {
+      valid: true,
+      errors: []
+    };
+  }
+  if (levels.length < 2) {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Invalid path "${value}" encountered.`
+        }
+      ]
+    };
+  }
+  const selectedPath = [];
+  let levelOptions = [];
+  for (let levelIndex = 0; levelIndex < levels.length - 1; ++levelIndex) {
+    const isLastLevel = levelIndex === levels.length - 2;
+    const levelSelectedValue = levels[levelIndex + 1];
+    const selectedPathValue = selectedPath.map(({ value: value2 }) => value2).join("/");
+    if (!levelSelectedValue) {
+      return {
+        valid: false,
+        errors: [
+          ...errors,
+          {
+            domain: context.domain,
+            path: context.path.join("."),
+            message: `Invalid selected value of "${value}" encountered.`
+          }
+        ]
+      };
+    }
+    if (typeof options === "string") {
+      try {
+        levelOptions = await context.resolveRemote(options, context, {
+          [field.name]: (showRoot && !selectedPathValue.startsWith("/") ? "/" : "") + selectedPathValue
+        });
+      } catch (error) {
+        return {
+          valid: false,
+          errors: [
+            ...errors,
+            {
+              domain: context.domain,
+              path: context.path.join("."),
+              message: `Failed to resolve remote resource ${options}: ${error}`
+            }
+          ]
+        };
+      }
+    } else if (isLastLevel) {
+      levelOptions = options;
+    }
+    const selectableOptions = levelOptions.flatMap((candidate) => {
+      if (isLastLevel && (field.type === "file" && !candidate.file || field.type === "folder" && candidate.file)) {
+        return [];
+      }
+      if (!isLastLevel && candidate.file) {
+        return [];
+      }
+      return candidate;
+    });
+    const selectedOption = selectableOptions.find((candidate) => candidate.value === levelSelectedValue);
+    if (!selectedOption) {
+      return {
+        valid: false,
+        errors: [
+          ...errors,
+          {
+            domain: context.domain,
+            path: context.path.join("."),
+            message: `Path '${levelSelectedValue}' not found in options.`
+          }
+        ]
+      };
+    }
+    selectedPath.push(selectedOption);
+  }
+  if (ids) {
+    context.roots[context.domain].fieldStates.push({
+      path: context.path,
+      state: {
+        mode: "chose",
+        path: selectedPath.map(({ label, value: value2 }) => label ?? value2)
+      }
+    });
+  }
+  if (nested) {
+    const result = await handleNestedFields(nested, value, field, context);
+    errors.push(...result.errors);
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+async function handleSelectType(value, field, context) {
   const errors = [];
   let optionsOrGroups = isObject(field.options) ? field.options.store : field.options;
   let nested = field.nested ? field.nested : isObject(field.options) ? field.options.nested : void 0;
@@ -1189,6 +1370,19 @@ function toFormanSchema(field) {
       }
       return formanSchema;
     case "string":
+      const pathInfo = Object.getOwnPropertyDescriptor(field, "x-path");
+      if (pathInfo) {
+        return {
+          type: pathInfo.value.type,
+          label: noEmpty(field.title),
+          help: noEmpty(field.description),
+          options: {
+            store: Object.getOwnPropertyDescriptor(field, "x-fetch")?.value,
+            showRoot: pathInfo.value.showRoot,
+            singleLevel: pathInfo.value.singleLevel
+          }
+        };
+      }
       if (field.enum) {
         return {
           type: "select",
@@ -1204,7 +1398,7 @@ function toFormanSchema(field) {
           options: field.oneOf.filter((value) => value).map((value) => ({ value: value.const }))
         };
       }
-      const textField = {
+      let textField = {
         type: "text",
         label: noEmpty(field.title),
         help: noEmpty(field.description),
@@ -1215,9 +1409,12 @@ function toFormanSchema(field) {
         if (field.pattern) textField.validate.pattern = field.pattern;
         if (field.enum) textField.validate.enum = field.enum;
       }
+      if ("x-search" in field) {
+        textField = handleSearchDirective(textField, field["x-search"]);
+      }
       return textField;
     default:
-      const primitiveField = {
+      let primitiveField = {
         type: JSON_PRIMITIVE_TYPE_MAP[field.type] || "any",
         label: noEmpty(field.title),
         help: noEmpty(field.description),
@@ -1228,9 +1425,20 @@ function toFormanSchema(field) {
         if (field.minimum !== void 0) primitiveField.validate.min = field.minimum;
         if (field.maximum !== void 0) primitiveField.validate.max = field.maximum;
       }
+      if ("x-search" in field) {
+        primitiveField = handleSearchDirective(primitiveField, field["x-search"]);
+      }
       return primitiveField;
   }
 }
+function handleSearchDirective(formanField, directive) {
+  formanField.rpc = {
+    url: directive.url,
+    label: directive.label,
+    parameters: typeof directive.inputSchema.$ref === "string" ? directive.inputSchema.$ref : toFormanSchema(directive.inputSchema).spec
+  };
+  return formanField;
+}
 
 // src/index.ts
 function toJSONSchema(field) {

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { JSONSchema7 } from 'json-schema';
 /**
  * Valid Forman Schema field types
  */
-type FormanSchemaFieldType = 'aiagent' | 'account' | 'hook' | 'device' | 'keychain' | 'datastore' | 'udt' | 'scenario' | 'array' | 'collection' | 'text' | 'number' | 'boolean' | 'date' | 'json' | 'buffer' | 'cert' | 'color' | 'email' | 'filename' | 'file' | 'filter' | 'folder' | 'hidden' | 'integer' | 'uinteger' | 'path' | 'pkey' | 'port' | 'select' | 'time' | 'timestamp' | 'timezone' | 'url' | 'uuid' | `account:${string}` | `hook:${string}` | `keychain:${string}` | 'banner' | 'markdown' | 'html' | 'separator' | string;
+type FormanSchemaFieldType = 'aiagent' | 'account' | 'hook' | 'device' | 'keychain' | 'datastore' | 'udt' | 'scenario' | 'array' | 'collection' | 'text' | 'number' | 'boolean' | 'date' | 'json' | 'buffer' | 'cert' | 'color' | 'email' | 'filename' | 'file' | 'filter' | 'folder' | 'hidden' | 'integer' | 'uinteger' | 'path' | 'pkey' | 'port' | 'select' | 'time' | 'timestamp' | 'timezone' | 'url' | 'uuid' | `account:${string}` | `hook:${string}` | `keychain:${string}` | `device:${string}` | 'banner' | 'markdown' | 'html' | 'separator' | string;
 /**
  * Validation configuration for Forman Schema fields
  */
@@ -35,8 +35,8 @@ type FormanSchemaField = {
     required?: boolean;
     /** Default value for the field */
     default?: FormanSchemaValue;
-    /** Available options for select type fields */
-    options?: FormanSchemaOption[] | FormanSchemaOptionGroup[] | FormanSchemaExtendedOptions | string;
+    /** Available options for fields which support them */
+    options?: FormanSchemaOption[] | FormanSchemaOptionGroup[] | FormanSchemaDirectoryOption[] | FormanSchemaPathExtendedOptions | FormanSchemaExtendedOptions | string;
     /** Help text or description for the field */
     help?: string;
     /** Sub-fields specification for collection or array types */
@@ -87,16 +87,42 @@ type FormanSchemaField = {
  */
 type FormanSchemaRPCButton = {
     /** RPC button label */
-    label: string;
+    label?: string;
     /** RPC button URL */
     url: string;
     /** RPC button parameters */
-    parameters: FormanSchemaField[];
+    parameters: FormanSchemaField[] | string;
 };
 /**
  * Valid Forman Schema values
  */
 type FormanSchemaValue = string | number | boolean | null;
+/**
+ * Extended options for file and folder path selector fields
+ */
+type FormanSchemaPathExtendedOptions = {
+    /** Store for the options */
+    store: FormanSchemaDirectoryOption[] | string;
+    /** Nested fields for every option */
+    nested?: FormanSchemaNested;
+    /** When set to true, all paths start with '/' */
+    showRoot?: boolean;
+    /** Used when the directory entries have labels available, and these are different from their actual IDs */
+    ids?: boolean;
+    /** When set to true, only the entries from the root level are shown, without their children */
+    singleLevel?: boolean;
+};
+/**
+ * Directory entry option for file and folder path selectors
+ */
+type FormanSchemaDirectoryOption = {
+    /** Option value */
+    value: FormanSchemaValue;
+    /** Option label */
+    label?: string;
+    /** Set to true when the entry is a file in combined select mode */
+    file?: boolean;
+};
 /**
  * Option for a select field
  */
@@ -171,6 +197,7 @@ type FormanValidationResult = {
 type FormanSchemaFieldState = {
     mode?: 'chose' | 'edit';
     label?: string;
+    path?: Array<string>;
     data?: Record<string, unknown>;
     nested?: Record<string, FormanSchemaFieldState>;
     items?: Record<string, FormanSchemaFieldState>[];
@@ -216,4 +243,4 @@ declare function validateFormanWithDomains(domains: Record<string, {
  */
 declare function validateForman(values: Record<string, unknown>, schema: FormanSchemaField[], options?: FormanValidationOptions): Promise<FormanValidationResult>;
 
-export { type FormanSchemaExtendedNested, type FormanSchemaExtendedOptions, type FormanSchemaField, type FormanSchemaFieldType, type FormanSchemaNested, type FormanSchemaOption, type FormanSchemaOptionGroup, type FormanSchemaRPCButton, type FormanSchemaValue, toFormanSchema, toJSONSchema, validateForman, validateFormanWithDomains };
+export { type FormanSchemaDirectoryOption, type FormanSchemaExtendedNested, type FormanSchemaExtendedOptions, type FormanSchemaField, type FormanSchemaFieldType, type FormanSchemaNested, type FormanSchemaOption, type FormanSchemaOptionGroup, type FormanSchemaPathExtendedOptions, type FormanSchemaRPCButton, type FormanSchemaValue, toFormanSchema, toJSONSchema, validateForman, validateFormanWithDomains };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { JSONSchema7 } from 'json-schema';
 /**
  * Valid Forman Schema field types
  */
-type FormanSchemaFieldType = 'aiagent' | 'account' | 'hook' | 'device' | 'keychain' | 'datastore' | 'udt' | 'scenario' | 'array' | 'collection' | 'text' | 'number' | 'boolean' | 'date' | 'json' | 'buffer' | 'cert' | 'color' | 'email' | 'filename' | 'file' | 'filter' | 'folder' | 'hidden' | 'integer' | 'uinteger' | 'path' | 'pkey' | 'port' | 'select' | 'time' | 'timestamp' | 'timezone' | 'url' | 'uuid' | `account:${string}` | `hook:${string}` | `keychain:${string}` | 'banner' | 'markdown' | 'html' | 'separator' | string;
+type FormanSchemaFieldType = 'aiagent' | 'account' | 'hook' | 'device' | 'keychain' | 'datastore' | 'udt' | 'scenario' | 'array' | 'collection' | 'text' | 'number' | 'boolean' | 'date' | 'json' | 'buffer' | 'cert' | 'color' | 'email' | 'filename' | 'file' | 'filter' | 'folder' | 'hidden' | 'integer' | 'uinteger' | 'path' | 'pkey' | 'port' | 'select' | 'time' | 'timestamp' | 'timezone' | 'url' | 'uuid' | `account:${string}` | `hook:${string}` | `keychain:${string}` | `device:${string}` | 'banner' | 'markdown' | 'html' | 'separator' | string;
 /**
  * Validation configuration for Forman Schema fields
  */
@@ -35,8 +35,8 @@ type FormanSchemaField = {
     required?: boolean;
     /** Default value for the field */
     default?: FormanSchemaValue;
-    /** Available options for select type fields */
-    options?: FormanSchemaOption[] | FormanSchemaOptionGroup[] | FormanSchemaExtendedOptions | string;
+    /** Available options for fields which support them */
+    options?: FormanSchemaOption[] | FormanSchemaOptionGroup[] | FormanSchemaDirectoryOption[] | FormanSchemaPathExtendedOptions | FormanSchemaExtendedOptions | string;
     /** Help text or description for the field */
     help?: string;
     /** Sub-fields specification for collection or array types */
@@ -87,16 +87,42 @@ type FormanSchemaField = {
  */
 type FormanSchemaRPCButton = {
     /** RPC button label */
-    label: string;
+    label?: string;
     /** RPC button URL */
     url: string;
     /** RPC button parameters */
-    parameters: FormanSchemaField[];
+    parameters: FormanSchemaField[] | string;
 };
 /**
  * Valid Forman Schema values
  */
 type FormanSchemaValue = string | number | boolean | null;
+/**
+ * Extended options for file and folder path selector fields
+ */
+type FormanSchemaPathExtendedOptions = {
+    /** Store for the options */
+    store: FormanSchemaDirectoryOption[] | string;
+    /** Nested fields for every option */
+    nested?: FormanSchemaNested;
+    /** When set to true, all paths start with '/' */
+    showRoot?: boolean;
+    /** Used when the directory entries have labels available, and these are different from their actual IDs */
+    ids?: boolean;
+    /** When set to true, only the entries from the root level are shown, without their children */
+    singleLevel?: boolean;
+};
+/**
+ * Directory entry option for file and folder path selectors
+ */
+type FormanSchemaDirectoryOption = {
+    /** Option value */
+    value: FormanSchemaValue;
+    /** Option label */
+    label?: string;
+    /** Set to true when the entry is a file in combined select mode */
+    file?: boolean;
+};
 /**
  * Option for a select field
  */
@@ -171,6 +197,7 @@ type FormanValidationResult = {
 type FormanSchemaFieldState = {
     mode?: 'chose' | 'edit';
     label?: string;
+    path?: Array<string>;
     data?: Record<string, unknown>;
     nested?: Record<string, FormanSchemaFieldState>;
     items?: Record<string, FormanSchemaFieldState>[];
@@ -216,4 +243,4 @@ declare function validateFormanWithDomains(domains: Record<string, {
  */
 declare function validateForman(values: Record<string, unknown>, schema: FormanSchemaField[], options?: FormanValidationOptions): Promise<FormanValidationResult>;
 
-export { type FormanSchemaExtendedNested, type FormanSchemaExtendedOptions, type FormanSchemaField, type FormanSchemaFieldType, type FormanSchemaNested, type FormanSchemaOption, type FormanSchemaOptionGroup, type FormanSchemaRPCButton, type FormanSchemaValue, toFormanSchema, toJSONSchema, validateForman, validateFormanWithDomains };
+export { type FormanSchemaDirectoryOption, type FormanSchemaExtendedNested, type FormanSchemaExtendedOptions, type FormanSchemaField, type FormanSchemaFieldType, type FormanSchemaNested, type FormanSchemaOption, type FormanSchemaOptionGroup, type FormanSchemaPathExtendedOptions, type FormanSchemaRPCButton, type FormanSchemaValue, toFormanSchema, toJSONSchema, validateForman, validateFormanWithDomains };

package/dist/index.js

@@ -38,7 +38,7 @@ var API_ENDPOINTS = {
   aiagent: "api://ai-agents/v1/agents",
   datastore: "api://data-stores",
   hook: "api://hooks/{{kind}}",
-  device: "api://devices",
+  device: "api://devices/{{kind}}",
   keychain: "api://keys/{{kind}}",
   udt: "api://data-structures",
   scenario: "api://scenario-list"
@@ -281,16 +281,17 @@ function toJSONSchemaInternal(field, context = createDefaultContext()) {
     case "select":
     case "account":
     case "hook":
+    case "device":
     case "keychain":
     case "datastore":
     case "aiagent":
     case "file":
     case "folder":
-      return handleSelectType(normalizedField, result, context);
+      return handleSelectOrPathType(normalizedField, result, context);
     case "filter":
       return handleFilterType(normalizedField, result, context);
     default:
-      return handlePrimitiveType(normalizedField, result);
+      return handlePrimitiveType(normalizedField, result, context);
   }
 }
 function handleCollectionType(field, result, context) {
@@ -406,8 +407,22 @@ function handleFilterType(field, result, context) {
   });
   return result;
 }
-function handleSelectType(field, result, context) {
+function handleSelectOrPathType(field, result, context) {
   const optionsOrGroups = isObject(field.options) ? field.options.store : field.options;
+  if (["file", "folder"].includes(field.type)) {
+    const optionsWrapper = isObject(field.options) ? field.options : void 0;
+    Object.defineProperty(result, "x-path", {
+      configurable: true,
+      enumerable: true,
+      writable: true,
+      value: {
+        type: field.type,
+        showRoot: optionsWrapper?.showRoot ?? true,
+        singleLevel: optionsWrapper?.singleLevel ?? false,
+        ownName: field.name
+      }
+    });
+  }
   const nested = isObject(field.options) ? isObject(field.options.nested) ? field.options.nested.store : field.options.nested : void 0;
   const nestedContainsStrings = Array.isArray(nested) && nested.some((item) => typeof item === "string");
   const domain = isObject(field.options) ? isObject(field.options.nested) && field.options.nested.domain ? field.options.nested.domain : void 0 : void 0;
@@ -516,9 +531,10 @@ function handleSelectType(field, result, context) {
       )
     });
   }
+  if (field.rpc) result = processRpcDirective(field, result, context);
   return result;
 }
-function handlePrimitiveType(field, result) {
+function handlePrimitiveType(field, result, context) {
   if (field.default !== "" && field.default != null) {
     result.default = field.default;
   }
@@ -536,6 +552,21 @@ function handlePrimitiveType(field, result) {
       result.enum = field.validate.enum;
     }
   }
+  if (field.rpc) result = processRpcDirective(field, result, context);
+  return result;
+}
+function processRpcDirective(field, result, context) {
+  if (!field.rpc) return result;
+  Object.defineProperty(result, "x-search", {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    value: {
+      url: appendQueryString(field.rpc.url, context.domain, context.tail),
+      label: field.rpc.label,
+      inputSchema: typeof field.rpc.parameters === "string" ? { $ref: field.rpc.parameters } : toJSONSchemaInternal({ type: "collection", spec: field.rpc.parameters }, context)
+    }
+  });
   return result;
 }
 
@@ -543,6 +574,7 @@ function handlePrimitiveType(field, result) {
 var FORMAN_TYPE_MAP2 = {
   account: "number",
   hook: "number",
+  device: "number",
   keychain: "number",
   datastore: "number",
   aiagent: "string",
@@ -623,7 +655,7 @@ async function validateFormanWithDomainsInternal(domains, options) {
         validateNestedFields: () => {
           throw new Error("Cannot validate nested fields without parent field.");
         },
-        resolveRemote: async (path, context) => {
+        resolveRemote: async (path, context, localData) => {
           if (!options?.resolveRemote) {
             throw new Error("Remote resource not supported when resolver is not provided.");
           }
@@ -634,7 +666,10 @@ async function validateFormanWithDomainsInternal(domains, options) {
             },
             {}
           );
-          return await options.resolveRemote(path, data);
+          return await options.resolveRemote(path, {
+            ...data,
+            ...localData
+          });
         }
       }
     );
@@ -721,9 +756,10 @@ async function validateFormanValue(value, field, context) {
     case "aiagent":
     case "udt":
     case "scenario":
+      return handleSelectType(value, normalizedField, context);
     case "file":
     case "folder":
-      return handleSelectType2(value, normalizedField, context);
+      return handlePathType(value, normalizedField, context);
     case "filter":
       return handleFilterType2(value, normalizedField, context);
     default:
@@ -888,7 +924,152 @@ async function handleFilterType2(value, field, context) {
   };
   return handleArrayType2(value, inlineSchema, context);
 }
-async function handleSelectType2(value, field, context) {
+async function handlePathType(value, field, context) {
+  const errors = [];
+  if (typeof value !== "string") {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Expected type 'string' for path, got type '${typeof value}'.`
+        }
+      ]
+    };
+  }
+  let showRoot = true;
+  let ids = false;
+  let singleLevel = false;
+  let options;
+  if (isObject(field.options)) {
+    if (field.options.showRoot !== void 0) showRoot = field.options.showRoot;
+    if (field.options.ids !== void 0) ids = field.options.ids;
+    if (field.options.singleLevel !== void 0) singleLevel = field.options.singleLevel;
+    options = field.options.store;
+  } else {
+    options = field.options;
+  }
+  if (singleLevel && (!showRoot && value.includes("/") || showRoot && value.lastIndexOf("/") > 0)) {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Single level path cannot contain slashes.`
+        }
+      ]
+    };
+  }
+  let nested = field.nested ? field.nested : isObject(field.options) ? field.options.nested : void 0;
+  const levels = value.split("/");
+  if (levels[0] !== "") levels.unshift("");
+  if (showRoot && value === "/" && field.type === "folder") {
+    return {
+      valid: true,
+      errors: []
+    };
+  }
+  if (levels.length < 2) {
+    return {
+      valid: false,
+      errors: [
+        ...errors,
+        {
+          domain: context.domain,
+          path: context.path.join("."),
+          message: `Invalid path "${value}" encountered.`
+        }
+      ]
+    };
+  }
+  const selectedPath = [];
+  let levelOptions = [];
+  for (let levelIndex = 0; levelIndex < levels.length - 1; ++levelIndex) {
+    const isLastLevel = levelIndex === levels.length - 2;
+    const levelSelectedValue = levels[levelIndex + 1];
+    const selectedPathValue = selectedPath.map(({ value: value2 }) => value2).join("/");
+    if (!levelSelectedValue) {
+      return {
+        valid: false,
+        errors: [
+          ...errors,
+          {
+            domain: context.domain,
+            path: context.path.join("."),
+            message: `Invalid selected value of "${value}" encountered.`
+          }
+        ]
+      };
+    }
+    if (typeof options === "string") {
+      try {
+        levelOptions = await context.resolveRemote(options, context, {
+          [field.name]: (showRoot && !selectedPathValue.startsWith("/") ? "/" : "") + selectedPathValue
+        });
+      } catch (error) {
+        return {
+          valid: false,
+          errors: [
+            ...errors,
+            {
+              domain: context.domain,
+              path: context.path.join("."),
+              message: `Failed to resolve remote resource ${options}: ${error}`
+            }
+          ]
+        };
+      }
+    } else if (isLastLevel) {
+      levelOptions = options;
+    }
+    const selectableOptions = levelOptions.flatMap((candidate) => {
+      if (isLastLevel && (field.type === "file" && !candidate.file || field.type === "folder" && candidate.file)) {
+        return [];
+      }
+      if (!isLastLevel && candidate.file) {
+        return [];
+      }
+      return candidate;
+    });
+    const selectedOption = selectableOptions.find((candidate) => candidate.value === levelSelectedValue);
+    if (!selectedOption) {
+      return {
+        valid: false,
+        errors: [
+          ...errors,
+          {
+            domain: context.domain,
+            path: context.path.join("."),
+            message: `Path '${levelSelectedValue}' not found in options.`
+          }
+        ]
+      };
+    }
+    selectedPath.push(selectedOption);
+  }
+  if (ids) {
+    context.roots[context.domain].fieldStates.push({
+      path: context.path,
+      state: {
+        mode: "chose",
+        path: selectedPath.map(({ label, value: value2 }) => label ?? value2)
+      }
+    });
+  }
+  if (nested) {
+    const result = await handleNestedFields(nested, value, field, context);
+    errors.push(...result.errors);
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+async function handleSelectType(value, field, context) {
   const errors = [];
   let optionsOrGroups = isObject(field.options) ? field.options.store : field.options;
   let nested = field.nested ? field.nested : isObject(field.options) ? field.options.nested : void 0;
@@ -1160,6 +1341,19 @@ function toFormanSchema(field) {
       }
       return formanSchema;
     case "string":
+      const pathInfo = Object.getOwnPropertyDescriptor(field, "x-path");
+      if (pathInfo) {
+        return {
+          type: pathInfo.value.type,
+          label: noEmpty(field.title),
+          help: noEmpty(field.description),
+          options: {
+            store: Object.getOwnPropertyDescriptor(field, "x-fetch")?.value,
+            showRoot: pathInfo.value.showRoot,
+            singleLevel: pathInfo.value.singleLevel
+          }
+        };
+      }
       if (field.enum) {
         return {
           type: "select",
@@ -1175,7 +1369,7 @@ function toFormanSchema(field) {
           options: field.oneOf.filter((value) => value).map((value) => ({ value: value.const }))
         };
       }
-      const textField = {
+      let textField = {
         type: "text",
         label: noEmpty(field.title),
         help: noEmpty(field.description),
@@ -1186,9 +1380,12 @@ function toFormanSchema(field) {
         if (field.pattern) textField.validate.pattern = field.pattern;
         if (field.enum) textField.validate.enum = field.enum;
       }
+      if ("x-search" in field) {
+        textField = handleSearchDirective(textField, field["x-search"]);
+      }
       return textField;
     default:
-      const primitiveField = {
+      let primitiveField = {
         type: JSON_PRIMITIVE_TYPE_MAP[field.type] || "any",
         label: noEmpty(field.title),
         help: noEmpty(field.description),
@@ -1199,9 +1396,20 @@ function toFormanSchema(field) {
         if (field.minimum !== void 0) primitiveField.validate.min = field.minimum;
         if (field.maximum !== void 0) primitiveField.validate.max = field.maximum;
       }
+      if ("x-search" in field) {
+        primitiveField = handleSearchDirective(primitiveField, field["x-search"]);
+      }
       return primitiveField;
   }
 }
+function handleSearchDirective(formanField, directive) {
+  formanField.rpc = {
+    url: directive.url,
+    label: directive.label,
+    parameters: typeof directive.inputSchema.$ref === "string" ? directive.inputSchema.$ref : toFormanSchema(directive.inputSchema).spec
+  };
+  return formanField;
+}
 
 // src/index.ts
 function toJSONSchema(field) {

package/package.json

@@ -1,10 +1,13 @@
 {
     "name": "@makehq/forman-schema",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "description": "Forman Schema Tools",
     "license": "MIT",
     "author": "Make",
-    "repository": "github:integromat/forman-schema",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/integromat/make-forman-schema.git"
+    },
     "homepage": "https://www.make.com",
     "type": "module",
     "main": "./dist/index.js",