files.com 1.1.661 → 1.1.662

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5d1657cd2960ca08a61d277113bab0c606889dbcd13de1a0f0101f60bce5cf5
-  data.tar.gz: 454cec2c47344387c5ecf6bcb290ec2e23563f4213d98a27143619e0ed5de982
+  metadata.gz: e67bcae8fe31ba697a3571ce860e0e36ecc6ff23ff79ae01dea228808cf6290a
+  data.tar.gz: d1a31219d290878b4555f62d03629a42cea58f6be7fad7c53ff4255074f169bb
 SHA512:
-  metadata.gz: eb6e585c04932db0c0d34aceef06ad83f1f4ef7cd97adf00255e0ff26a9720098ef64b0903d35e9c963f21348bd926eae24f457b86d678b6469894cae21bc94f
-  data.tar.gz: 85eb230534050c522e8f42b21bffa8e505edc489b1a12e4ea6f2f7fdc40c5451371275085c0494b7e23489ac8f2b8da5c145c640f2632b12b1e648c7cc440e5f
+  metadata.gz: 0202ce12d6796ea0b971b888fc8ec04b10461279d9d2618666a647b81487625cd5cede6bfb7daaf8c803a10caf412c4a0940684bcf5334775a022801d1fb71c6
+  data.tar.gz: '0088572e60118954c8deee9eefeba98f1baa8eb050606712320acc3f4c13a008973cbf83a842f2bebafca85fed80d0b6fc952cede8ec91deabf6a4b0886c71f4'

data/README.md

@@ -617,6 +617,7 @@ Files::FolderAdminPermissionRequiredError -> Files::NotAuthorizedError -> Files:
 |`SiteNotFoundError`|  `NotFoundError` |
 |`UserNotFoundError`|  `NotFoundError` |
 |`AgentUnavailableError`|  `ProcessingFailureError` |
+|`AiTaskCannotBeRunManuallyError`|  `ProcessingFailureError` |
 |`AlreadyCompletedError`|  `ProcessingFailureError` |
 |`AutomationCannotBeRunManuallyError`|  `ProcessingFailureError` |
 |`BehaviorNotAllowedOnRemoteServerError`|  `ProcessingFailureError` |

data/_VERSION

@@ -1 +1 @@
-1.1.661
+1.1.662

data/docs/ai_task.md

@@ -0,0 +1,277 @@
+# AiTask
+
+## Example AiTask Object
+
+```
+{
+  "id": 1,
+  "workspace_id": 1,
+  "name": "Summarize daily reports",
+  "description": "Summarizes files uploaded by the accounting team.",
+  "prompt": "Summarize the uploaded file and identify follow-up actions.",
+  "path": "incoming/reports",
+  "source": "*.pdf",
+  "disabled": true,
+  "trigger": "daily",
+  "trigger_actions": [
+    "create"
+  ],
+  "interval": "day",
+  "recurring_day": 1,
+  "schedule_days_of_week": [
+    1,
+    3,
+    5
+  ],
+  "schedule_times_of_day": [
+    "06:30"
+  ],
+  "schedule_time_zone": "Eastern Time (US & Canada)",
+  "holiday_region": "us",
+  "human_readable_schedule": "Runs every day at 06:30 AM UTC TZ.",
+  "last_run_at": "2000-01-01T01:00:00Z",
+  "master_admin_user_id": 1,
+  "created_at": "2000-01-01T01:00:00Z",
+  "updated_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `id` (int64): AI Task ID.
+* `workspace_id` (int64): Workspace ID. `0` means the default workspace.
+* `name` (string): AI Task name.
+* `description` (string): AI Task description.
+* `prompt` (string): Prompt sent when this AI Task is invoked.
+* `path` (string): Path scope used for action-triggered AI Tasks. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `source` (string): Source glob used with `path` for action-triggered AI Tasks.
+* `disabled` (boolean): If true, this AI Task will not run.
+* `trigger` (string): How this AI Task is triggered.
+* `trigger_actions` (array(string)): If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+* `interval` (string): If trigger is `daily`, this specifies how often to run the AI Task.
+* `recurring_day` (int64): If trigger is `daily`, this selects the day number inside the chosen interval.
+* `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+* `schedule_times_of_day` (array(string)): Times of day in HH:MM format for scheduled AI Tasks.
+* `schedule_time_zone` (string): Time zone used by the AI Task schedule.
+* `holiday_region` (string): Optional holiday region used by scheduled AI Tasks.
+* `human_readable_schedule` (string): Human-readable schedule description.
+* `last_run_at` (date-time): Most recent successful invocation time.
+* `master_admin_user_id` (int64): Master User ID used for AI Task invocations.
+* `created_at` (date-time): Creation time.
+* `updated_at` (date-time): Last update time.
+
+
+---
+
+## List Ai Tasks
+
+```
+Files::AiTask.list
+```
+
+### Parameters
+
+* `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+* `per_page` (int64): Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `id`, `disabled` or `updated_at`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `disabled`, `trigger` or `workspace_id`. Valid field combinations are `[ workspace_id, disabled ]`.
+
+
+---
+
+## Show Ai Task
+
+```
+Files::AiTask.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+
+
+---
+
+## Create Ai Task
+
+```
+Files::AiTask.create(
+  description: "Summarizes files uploaded by the accounting team.", 
+  disabled: true, 
+  holiday_region: "us", 
+  interval: "day", 
+  name: "Summarize daily reports", 
+  path: "incoming/reports", 
+  prompt: "Summarize the uploaded file and identify follow-up actions.", 
+  recurring_day: 1, 
+  schedule_days_of_week: [1,3,5], 
+  schedule_time_zone: "Eastern Time (US & Canada)", 
+  schedule_times_of_day: ["06:30"], 
+  source: "*.pdf", 
+  trigger: "daily", 
+  trigger_actions: ["create"], 
+  workspace_id: 0
+)
+```
+
+### Parameters
+
+* `description` (string): AI Task description.
+* `disabled` (boolean): If true, this AI Task will not run.
+* `holiday_region` (string): Optional holiday region used by scheduled AI Tasks.
+* `interval` (string): If trigger is `daily`, this specifies how often to run the AI Task.
+* `name` (string): Required - AI Task name.
+* `path` (string): Path scope used for action-triggered AI Tasks.
+* `prompt` (string): Required - Prompt sent when this AI Task is invoked.
+* `recurring_day` (int64): If trigger is `daily`, this selects the day number inside the chosen interval.
+* `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+* `schedule_time_zone` (string): Time zone used by the AI Task schedule.
+* `schedule_times_of_day` (array(string)): Times of day in HH:MM format for scheduled AI Tasks.
+* `source` (string): Source glob used with `path` for action-triggered AI Tasks.
+* `trigger` (string): How this AI Task is triggered.
+* `trigger_actions` (array(string)): If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+* `workspace_id` (int64): Workspace ID. `0` means the default workspace.
+
+
+---
+
+## Manually Run AI Task
+
+```
+Files::AiTask.manual_run(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+
+
+---
+
+## Update Ai Task
+
+```
+Files::AiTask.update(id, 
+  description: "Summarizes files uploaded by the accounting team.", 
+  disabled: true, 
+  holiday_region: "us", 
+  interval: "day", 
+  name: "Summarize daily reports", 
+  path: "incoming/reports", 
+  prompt: "Summarize the uploaded file and identify follow-up actions.", 
+  recurring_day: 1, 
+  schedule_days_of_week: [1,3,5], 
+  schedule_time_zone: "Eastern Time (US & Canada)", 
+  schedule_times_of_day: ["06:30"], 
+  source: "*.pdf", 
+  trigger: "daily", 
+  trigger_actions: ["create"], 
+  workspace_id: 0
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+* `description` (string): AI Task description.
+* `disabled` (boolean): If true, this AI Task will not run.
+* `holiday_region` (string): Optional holiday region used by scheduled AI Tasks.
+* `interval` (string): If trigger is `daily`, this specifies how often to run the AI Task.
+* `name` (string): AI Task name.
+* `path` (string): Path scope used for action-triggered AI Tasks.
+* `prompt` (string): Prompt sent when this AI Task is invoked.
+* `recurring_day` (int64): If trigger is `daily`, this selects the day number inside the chosen interval.
+* `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+* `schedule_time_zone` (string): Time zone used by the AI Task schedule.
+* `schedule_times_of_day` (array(string)): Times of day in HH:MM format for scheduled AI Tasks.
+* `source` (string): Source glob used with `path` for action-triggered AI Tasks.
+* `trigger` (string): How this AI Task is triggered.
+* `trigger_actions` (array(string)): If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+* `workspace_id` (int64): Workspace ID. `0` means the default workspace.
+
+
+---
+
+## Delete Ai Task
+
+```
+Files::AiTask.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+
+
+---
+
+## Manually Run AI Task
+
+```
+ai_task = Files::AiTask.find(id)
+
+ai_task.manual_run
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+
+
+---
+
+## Update Ai Task
+
+```
+ai_task = Files::AiTask.find(id)
+
+ai_task.update(
+  description: "Summarizes files uploaded by the accounting team.",
+  disabled: true,
+  holiday_region: "us",
+  interval: "day",
+  name: "Summarize daily reports",
+  path: "incoming/reports",
+  prompt: "Summarize the uploaded file and identify follow-up actions.",
+  recurring_day: 1,
+  schedule_days_of_week: [1,3,5],
+  schedule_time_zone: "Eastern Time (US & Canada)",
+  schedule_times_of_day: ["06:30"],
+  source: "*.pdf",
+  trigger: "daily",
+  trigger_actions: ["create"],
+  workspace_id: 0
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.
+* `description` (string): AI Task description.
+* `disabled` (boolean): If true, this AI Task will not run.
+* `holiday_region` (string): Optional holiday region used by scheduled AI Tasks.
+* `interval` (string): If trigger is `daily`, this specifies how often to run the AI Task.
+* `name` (string): AI Task name.
+* `path` (string): Path scope used for action-triggered AI Tasks.
+* `prompt` (string): Prompt sent when this AI Task is invoked.
+* `recurring_day` (int64): If trigger is `daily`, this selects the day number inside the chosen interval.
+* `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+* `schedule_time_zone` (string): Time zone used by the AI Task schedule.
+* `schedule_times_of_day` (array(string)): Times of day in HH:MM format for scheduled AI Tasks.
+* `source` (string): Source glob used with `path` for action-triggered AI Tasks.
+* `trigger` (string): How this AI Task is triggered.
+* `trigger_actions` (array(string)): If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+* `workspace_id` (int64): Workspace ID. `0` means the default workspace.
+
+
+---
+
+## Delete Ai Task
+
+```
+ai_task = Files::AiTask.find(id)
+
+ai_task.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Ai Task ID.

data/docs/chat_session.md

@@ -6,6 +6,7 @@
 {
   "id": "example",
   "user_id": 1,
+  "ai_task_id": 1,
   "workspace_id": 1,
   "last_active_at": "2000-01-01T01:00:00Z",
   "created_at": "2000-01-01T01:00:00Z",
@@ -22,6 +23,7 @@
 
 * `id` (string): Chat Session ID.
 * `user_id` (int64): User ID.
+* `ai_task_id` (int64): AI Task ID. Present when the conversation was started by an AI Task.
 * `workspace_id` (int64): Workspace ID. `0` means the default workspace.
 * `last_active_at` (date-time): Most recent chat activity date/time.
 * `created_at` (date-time): Chat session creation date/time.
@@ -40,6 +42,7 @@ Files::ChatSession.list
 
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `ai_task_id`.
 
 
 ---

data/lib/files.com/errors.rb

@@ -182,6 +182,7 @@ module Files
 
   class ProcessingFailureError < APIError; end
   class AgentUnavailableError < ProcessingFailureError; end
+  class AiTaskCannotBeRunManuallyError < ProcessingFailureError; end
   class AlreadyCompletedError < ProcessingFailureError; end
   class AutomationCannotBeRunManuallyError < ProcessingFailureError; end
   class BehaviorNotAllowedOnRemoteServerError < ProcessingFailureError; end

data/lib/files.com/models/ai_task.rb

@@ -0,0 +1,410 @@
+# frozen_string_literal: true
+
+module Files
+  class AiTask
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - AI Task ID.
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # int64 - Workspace ID. `0` means the default workspace.
+    def workspace_id
+      @attributes[:workspace_id]
+    end
+
+    def workspace_id=(value)
+      @attributes[:workspace_id] = value
+    end
+
+    # string - AI Task name.
+    def name
+      @attributes[:name]
+    end
+
+    def name=(value)
+      @attributes[:name] = value
+    end
+
+    # string - AI Task description.
+    def description
+      @attributes[:description]
+    end
+
+    def description=(value)
+      @attributes[:description] = value
+    end
+
+    # string - Prompt sent when this AI Task is invoked.
+    def prompt
+      @attributes[:prompt]
+    end
+
+    def prompt=(value)
+      @attributes[:prompt] = value
+    end
+
+    # string - Path scope used for action-triggered AI Tasks. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    def path=(value)
+      @attributes[:path] = value
+    end
+
+    # string - Source glob used with `path` for action-triggered AI Tasks.
+    def source
+      @attributes[:source]
+    end
+
+    def source=(value)
+      @attributes[:source] = value
+    end
+
+    # boolean - If true, this AI Task will not run.
+    def disabled
+      @attributes[:disabled]
+    end
+
+    def disabled=(value)
+      @attributes[:disabled] = value
+    end
+
+    # string - How this AI Task is triggered.
+    def trigger
+      @attributes[:trigger]
+    end
+
+    def trigger=(value)
+      @attributes[:trigger] = value
+    end
+
+    # array(string) - If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+    def trigger_actions
+      @attributes[:trigger_actions]
+    end
+
+    def trigger_actions=(value)
+      @attributes[:trigger_actions] = value
+    end
+
+    # string - If trigger is `daily`, this specifies how often to run the AI Task.
+    def interval
+      @attributes[:interval]
+    end
+
+    def interval=(value)
+      @attributes[:interval] = value
+    end
+
+    # int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
+    def recurring_day
+      @attributes[:recurring_day]
+    end
+
+    def recurring_day=(value)
+      @attributes[:recurring_day] = value
+    end
+
+    # array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+    def schedule_days_of_week
+      @attributes[:schedule_days_of_week]
+    end
+
+    def schedule_days_of_week=(value)
+      @attributes[:schedule_days_of_week] = value
+    end
+
+    # array(string) - Times of day in HH:MM format for scheduled AI Tasks.
+    def schedule_times_of_day
+      @attributes[:schedule_times_of_day]
+    end
+
+    def schedule_times_of_day=(value)
+      @attributes[:schedule_times_of_day] = value
+    end
+
+    # string - Time zone used by the AI Task schedule.
+    def schedule_time_zone
+      @attributes[:schedule_time_zone]
+    end
+
+    def schedule_time_zone=(value)
+      @attributes[:schedule_time_zone] = value
+    end
+
+    # string - Optional holiday region used by scheduled AI Tasks.
+    def holiday_region
+      @attributes[:holiday_region]
+    end
+
+    def holiday_region=(value)
+      @attributes[:holiday_region] = value
+    end
+
+    # string - Human-readable schedule description.
+    def human_readable_schedule
+      @attributes[:human_readable_schedule]
+    end
+
+    def human_readable_schedule=(value)
+      @attributes[:human_readable_schedule] = value
+    end
+
+    # date-time - Most recent successful invocation time.
+    def last_run_at
+      @attributes[:last_run_at]
+    end
+
+    def last_run_at=(value)
+      @attributes[:last_run_at] = value
+    end
+
+    # int64 - Master User ID used for AI Task invocations.
+    def master_admin_user_id
+      @attributes[:master_admin_user_id]
+    end
+
+    def master_admin_user_id=(value)
+      @attributes[:master_admin_user_id] = value
+    end
+
+    # date-time - Creation time.
+    def created_at
+      @attributes[:created_at]
+    end
+
+    # date-time - Last update time.
+    def updated_at
+      @attributes[:updated_at]
+    end
+
+    # Manually Run AI Task
+    def manual_run(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/ai_tasks/#{@attributes[:id]}/manual_run", :post, params, @options)
+    end
+
+    # Parameters:
+    #   description - string - AI Task description.
+    #   disabled - boolean - If true, this AI Task will not run.
+    #   holiday_region - string - Optional holiday region used by scheduled AI Tasks.
+    #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
+    #   name - string - AI Task name.
+    #   path - string - Path scope used for action-triggered AI Tasks.
+    #   prompt - string - Prompt sent when this AI Task is invoked.
+    #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
+    #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+    #   schedule_time_zone - string - Time zone used by the AI Task schedule.
+    #   schedule_times_of_day - array(string) - Times of day in HH:MM format for scheduled AI Tasks.
+    #   source - string - Source glob used with `path` for action-triggered AI Tasks.
+    #   trigger - string - How this AI Task is triggered.
+    #   trigger_actions - array(string) - If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+    #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    def update(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: interval must be an String") if params[:interval] and !params[:interval].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: prompt must be an String") if params[:prompt] and !params[:prompt].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: recurring_day must be an Integer") if params[:recurring_day] and !params[:recurring_day].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: schedule_days_of_week must be an Array") if params[:schedule_days_of_week] and !params[:schedule_days_of_week].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: schedule_time_zone must be an String") if params[:schedule_time_zone] and !params[:schedule_time_zone].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: schedule_times_of_day must be an Array") if params[:schedule_times_of_day] and !params[:schedule_times_of_day].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: source must be an String") if params[:source] and !params[:source].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger must be an String") if params[:trigger] and !params[:trigger].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger_actions must be an Array") if params[:trigger_actions] and !params[:trigger_actions].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/ai_tasks/#{@attributes[:id]}", :patch, params, @options)
+    end
+
+    def delete(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/ai_tasks/#{@attributes[:id]}", :delete, params, @options)
+    end
+
+    def destroy(params = {})
+      delete(params)
+      nil
+    end
+
+    def save
+      if @attributes[:id]
+        new_obj = update(@attributes)
+      else
+        new_obj = AiTask.create(@attributes, @options)
+      end
+
+      @attributes = new_obj.attributes
+      true
+    end
+
+    # Parameters:
+    #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `id`, `disabled` or `updated_at`.
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `disabled`, `trigger` or `workspace_id`. Valid field combinations are `[ workspace_id, disabled ]`.
+    def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
+      raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
+
+      List.new(AiTask, params) do
+        Api.send_request("/ai_tasks", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - Ai Task ID.
+    def self.find(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/ai_tasks/#{params[:id]}", :get, params, options)
+      AiTask.new(response.data, options)
+    end
+
+    def self.get(id, params = {}, options = {})
+      find(id, params, options)
+    end
+
+    # Parameters:
+    #   description - string - AI Task description.
+    #   disabled - boolean - If true, this AI Task will not run.
+    #   holiday_region - string - Optional holiday region used by scheduled AI Tasks.
+    #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
+    #   name (required) - string - AI Task name.
+    #   path - string - Path scope used for action-triggered AI Tasks.
+    #   prompt (required) - string - Prompt sent when this AI Task is invoked.
+    #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
+    #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+    #   schedule_time_zone - string - Time zone used by the AI Task schedule.
+    #   schedule_times_of_day - array(string) - Times of day in HH:MM format for scheduled AI Tasks.
+    #   source - string - Source glob used with `path` for action-triggered AI Tasks.
+    #   trigger - string - How this AI Task is triggered.
+    #   trigger_actions - array(string) - If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+    #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    def self.create(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: interval must be an String") if params[:interval] and !params[:interval].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: prompt must be an String") if params[:prompt] and !params[:prompt].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: recurring_day must be an Integer") if params[:recurring_day] and !params[:recurring_day].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: schedule_days_of_week must be an Array") if params[:schedule_days_of_week] and !params[:schedule_days_of_week].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: schedule_time_zone must be an String") if params[:schedule_time_zone] and !params[:schedule_time_zone].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: schedule_times_of_day must be an Array") if params[:schedule_times_of_day] and !params[:schedule_times_of_day].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: source must be an String") if params[:source] and !params[:source].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger must be an String") if params[:trigger] and !params[:trigger].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger_actions must be an Array") if params[:trigger_actions] and !params[:trigger_actions].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: name") unless params[:name]
+      raise MissingParameterError.new("Parameter missing: prompt") unless params[:prompt]
+
+      response, options = Api.send_request("/ai_tasks", :post, params, options)
+      AiTask.new(response.data, options)
+    end
+
+    # Manually Run AI Task
+    def self.manual_run(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/ai_tasks/#{params[:id]}/manual_run", :post, params, options)
+      nil
+    end
+
+    # Parameters:
+    #   description - string - AI Task description.
+    #   disabled - boolean - If true, this AI Task will not run.
+    #   holiday_region - string - Optional holiday region used by scheduled AI Tasks.
+    #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
+    #   name - string - AI Task name.
+    #   path - string - Path scope used for action-triggered AI Tasks.
+    #   prompt - string - Prompt sent when this AI Task is invoked.
+    #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
+    #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
+    #   schedule_time_zone - string - Time zone used by the AI Task schedule.
+    #   schedule_times_of_day - array(string) - Times of day in HH:MM format for scheduled AI Tasks.
+    #   source - string - Source glob used with `path` for action-triggered AI Tasks.
+    #   trigger - string - How this AI Task is triggered.
+    #   trigger_actions - array(string) - If trigger is `action`, the file action types that invoke this AI Task. Valid actions are create, copy, move, archived_delete, update, read, destroy.
+    #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    def self.update(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: interval must be an String") if params[:interval] and !params[:interval].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: prompt must be an String") if params[:prompt] and !params[:prompt].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: recurring_day must be an Integer") if params[:recurring_day] and !params[:recurring_day].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: schedule_days_of_week must be an Array") if params[:schedule_days_of_week] and !params[:schedule_days_of_week].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: schedule_time_zone must be an String") if params[:schedule_time_zone] and !params[:schedule_time_zone].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: schedule_times_of_day must be an Array") if params[:schedule_times_of_day] and !params[:schedule_times_of_day].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: source must be an String") if params[:source] and !params[:source].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger must be an String") if params[:trigger] and !params[:trigger].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: trigger_actions must be an Array") if params[:trigger_actions] and !params[:trigger_actions].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/ai_tasks/#{params[:id]}", :patch, params, options)
+      AiTask.new(response.data, options)
+    end
+
+    def self.delete(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/ai_tasks/#{params[:id]}", :delete, params, options)
+      nil
+    end
+
+    def self.destroy(id, params = {}, options = {})
+      delete(id, params, options)
+      nil
+    end
+  end
+end

data/lib/files.com/models/chat_session.rb

@@ -19,6 +19,11 @@ module Files
       @attributes[:user_id]
     end
 
+    # int64 - AI Task ID. Present when the conversation was started by an AI Task.
+    def ai_task_id
+      @attributes[:ai_task_id]
+    end
+
     # int64 - Workspace ID. `0` means the default workspace.
     def workspace_id
       @attributes[:workspace_id]
@@ -42,9 +47,11 @@ module Files
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `ai_task_id`.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
 
       List.new(ChatSession, params) do
         Api.send_request("/chat_sessions", :get, params, options)

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.661"
+  VERSION = "1.1.662"
 end

data/lib/files.com.rb

@@ -38,6 +38,7 @@ require "files.com/models/action_log"
 require "files.com/models/action_notification_export"
 require "files.com/models/action_notification_export_result"
 require "files.com/models/agent_push_update"
+require "files.com/models/ai_task"
 require "files.com/models/api_key"
 require "files.com/models/api_request_log"
 require "files.com/models/app"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.661
+  version: 1.1.662
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-26 00:00:00.000000000 Z
+date: 2026-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -176,6 +176,7 @@ files:
 - docs/action_notification_export.md
 - docs/action_notification_export_result.md
 - docs/agent_push_update.md
+- docs/ai_task.md
 - docs/api_key.md
 - docs/api_request_log.md
 - docs/app.md
@@ -318,6 +319,7 @@ files:
 - lib/files.com/models/action_notification_export.rb
 - lib/files.com/models/action_notification_export_result.rb
 - lib/files.com/models/agent_push_update.rb
+- lib/files.com/models/ai_task.rb
 - lib/files.com/models/api_key.rb
 - lib/files.com/models/api_request_log.rb
 - lib/files.com/models/app.rb