}

    /**
     * Get a DFS referral for the specified target
     *
     * @param tf the CIFS context
     * @param trans the SMB transport
     * @param target the target path
     * @param targetDomain the target domain
     * @param targetHost the target host
     * @param root the DFS root
     * @param path the DFS path
     * @return the DFS referral data or null if not found

     * value containing a <code>delim</code> separated list of host names and/or
     * ip addresses.
     *
     * @param props the properties to search in
     * @param key the property key to look up
     * @param delim the delimiter to use for splitting the property value
     * @param def the default value to return if key is not found
     * @return an array of InetAddress objects or the default value
     */

 */
public interface StorageClient extends AutoCloseable {

    /**
     * Uploads an object to storage.
     *
     * @param objectName the name/path for the object
     * @param inputStream the input stream of data to upload
     * @param size the size of the data in bytes
     * @param contentType the MIME type of the content
     */
    void uploadObject(String objectName, InputStream inputStream, long size, String contentType);

    }

    /**
     * Common method to delete words by kind.
     *
     * @param index The index name
     * @param freqField The frequency field name
     * @param kindToRemove The kind to remove
     * @param freqSetter The consumer to set frequency to 0
     * @param excludeKinds The kinds to exclude from deletion
     * @return The SuggestDeleteResponse
     */

     * @param query The query string.
     */
    public void setQuery(final String query) {
        this.query = query;
    }

    /**
     * Adds a tag to filter by.
     * @param tag The tag.
     */
    public void addTag(final String tag) {
        tags.add(tag);
    }

    /**
     * Adds a role to filter by.
     * @param role The role.
     */

     *
     * @param tf the CIFS context
     * @param domain the domain name
     * @return connection to the domain controller
     * @throws CIFSException if the connection fails
     */
    SmbTransport getDc(CIFSContext tf, String domain) throws CIFSException;

    /**
     * Resolve the location of a DFS path
     *
     * @param domain the domain for the DFS referral

    /**
     * Adds a message to the request.
     *
     * @param message the message to add
     * @return this request for method chaining
     */
    public LlmChatRequest addMessage(final LlmMessage message) {
        messages.add(message);
        return this;
    }

    /**
     * Adds a system message to the request.
     *
     * @param content the message content
     * @return this request for method chaining

        return cal;
    }

    /**
     * Adds a new interval rule to the rule list.
     *
     * @param from the start time in HH:MM format
     * @param to the end time in HH:MM format
     * @param days comma-separated list of days (1=Sunday, 7=Saturday)
     * @param delay the delay in milliseconds to apply during this interval
     */

    boolean ensureConnected() throws IOException;

    /**
     * Gets DFS referrals for the specified path.
     *
     * @param ctx the CIFS context
     * @param name the DFS path to resolve
     * @param targetHost the target host name
     * @param targetDomain the target domain
     * @param rn the referral number
     * @return dfs referral
     * @throws SmbException if an SMB error occurs

     * Sets the state of the "add default entities" flag.
     *
     * @param addDefaultEntities a addDefaultEntities object.
     */
    public void setAddDefaultEntities(boolean addDefaultEntities) {
        delegate.setAddDefaultEntities(addDefaultEntities);
    }

    /**
     * Method read.
     *
     * @param reader a reader object.
     * @param strict a strict object.
     * @return Metadata