files.com 1.1.705 → 1.1.706

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8ca126a64fdb94a9719ce7e4f6aadc193ef25c896478f27bbbe65550a4fc55f
-  data.tar.gz: 2fa1cf2cbc7fa91d7710209d2a0311584e9bca2ff68047841d0a96da6b8fa918
+  metadata.gz: f657f552b5e245137f2573b816ee01f3a1496a1630f31b5d206b68e7beb34d45
+  data.tar.gz: 9c53f76c80f8b5d38b5925bee8653ce9d283d8cb6a40c003727b927ca05664f5
 SHA512:
-  metadata.gz: 938b9fe2aa351a7e978f851e52eabf7092dce64fac950ecd6c6330e46a8e2efa4f82722746fda43b1277eeb81e29b5e6fda612a1d2b4e17a9ef29140517093bb
-  data.tar.gz: c82855ff3a13b41459d754749e68f22fed27b8dde7b9c61f6aa47c22d5b75fdcf87366d44aa58493108d49fe86563370d9bc4f45af1e1e78217aa2dab4e3ce53
+  metadata.gz: '0846068a7783f8c36108da903316cb518e9e1123504b1765e3f8b7a1379f0a0bc1e16794b22ad82edafde98d60128f923c38cdc30f62168fd1bfbe13cecfb67a'
+  data.tar.gz: 9a347c77d728af71c269f07867439e44310efa5b642da1c49c8b7910b6524f3247d534fe8ce4b1d0699982a646decdbe18a5da2bb32c2f24f8aa774d15b49ea1

data/_VERSION

@@ -1 +1 @@
-1.1.705
+1.1.706

data/docs/agent_node.md

@@ -8,11 +8,27 @@
   "name": "example",
   "hostname": "example",
   "availability_role": "example",
-  "connection_status": "example",
+  "status": "example",
   "is_default": true,
-  "agent_version": "example",
   "direct_transfer_available": true,
-  "last_seen_at": "2000-01-01T01:00:00Z"
+  "last_seen_at": "2000-01-01T01:00:00Z",
+  "instances": [
+    {
+      "instance_id": "example",
+      "process_state": "example",
+      "status": "example",
+      "is_default": true,
+      "agent_version": "example",
+      "last_seen_at": "2000-01-01T01:00:00Z",
+      "connections": [
+        {
+          "mode": "example",
+          "status": "example",
+          "last_seen_at": "2000-01-01T01:00:00Z"
+        }
+      ]
+    }
+  ]
 }
 ```
 
@@ -20,8 +36,8 @@
 * `name` (string): Customer-configured Agent node name
 * `hostname` (string): Hostname reported by the Agent
 * `availability_role` (string): Configured traffic preference
-* `connection_status` (string): Whether this node is currently available for traffic
+* `status` (string): Whether this node currently has an available Agent instance
 * `is_default` (boolean): Whether this node is the current default route for new unscoped work
-* `agent_version` (string): Agent version reported by this node
 * `direct_transfer_available` (boolean): Whether the proxy recently validated a direct connection to this Agent node. False means direct transfers are enabled but not currently available; null means disabled or unsupported.
 * `last_seen_at` (date-time): Most recent successful node observation
+* `instances` (array(object)): Current Agent processes for this node

data/docs/agent_node_connection.md

@@ -0,0 +1,15 @@
+# AgentNodeConnection
+
+## Example AgentNodeConnection Object
+
+```
+{
+  "mode": "example",
+  "status": "example",
+  "last_seen_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `mode` (string): How the Agent process uses this proxy connection
+* `status` (string): Whether this connection was observed recently and has not disconnected
+* `last_seen_at` (date-time): Most recent successful observation for this connection

data/docs/agent_node_instance.md

@@ -0,0 +1,29 @@
+# AgentNodeInstance
+
+## Example AgentNodeInstance Object
+
+```
+{
+  "instance_id": "example",
+  "process_state": "example",
+  "status": "example",
+  "is_default": true,
+  "agent_version": "example",
+  "last_seen_at": "2000-01-01T01:00:00Z",
+  "connections": [
+    {
+      "mode": "example",
+      "status": "example",
+      "last_seen_at": "2000-01-01T01:00:00Z"
+    }
+  ]
+}
+```
+
+* `instance_id` (string): Ephemeral ID for this running Agent process
+* `process_state` (string): Role of this process during an Agent update
+* `status` (string): Whether this process has an available proxy connection
+* `is_default` (boolean): Whether this process receives new unscoped work for its node
+* `agent_version` (string): Agent version reported by this process
+* `last_seen_at` (date-time): Most recent successful observation for this process
+* `connections` (array(object)): Proxy connections observed for this process

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

@@ -29,9 +29,9 @@ module Files
       @attributes[:availability_role]
     end
 
-    # string - Whether this node is currently available for traffic
-    def connection_status
-      @attributes[:connection_status]
+    # string - Whether this node currently has an available Agent instance
+    def status
+      @attributes[:status]
     end
 
     # boolean - Whether this node is the current default route for new unscoped work
@@ -39,11 +39,6 @@ module Files
       @attributes[:is_default]
     end
 
-    # string - Agent version reported by this node
-    def agent_version
-      @attributes[:agent_version]
-    end
-
     # boolean - Whether the proxy recently validated a direct connection to this Agent node. False means direct transfers are enabled but not currently available; null means disabled or unsupported.
     def direct_transfer_available
       @attributes[:direct_transfer_available]
@@ -53,5 +48,10 @@ module Files
     def last_seen_at
       @attributes[:last_seen_at]
     end
+
+    # array(object) - Current Agent processes for this node
+    def instances
+      @attributes[:instances]
+    end
   end
 end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Files
+  class AgentNodeConnection
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - How the Agent process uses this proxy connection
+    def mode
+      @attributes[:mode]
+    end
+
+    # string - Whether this connection was observed recently and has not disconnected
+    def status
+      @attributes[:status]
+    end
+
+    # date-time - Most recent successful observation for this connection
+    def last_seen_at
+      @attributes[:last_seen_at]
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Files
+  class AgentNodeInstance
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - Ephemeral ID for this running Agent process
+    def instance_id
+      @attributes[:instance_id]
+    end
+
+    # string - Role of this process during an Agent update
+    def process_state
+      @attributes[:process_state]
+    end
+
+    # string - Whether this process has an available proxy connection
+    def status
+      @attributes[:status]
+    end
+
+    # boolean - Whether this process receives new unscoped work for its node
+    def is_default
+      @attributes[:is_default]
+    end
+
+    # string - Agent version reported by this process
+    def agent_version
+      @attributes[:agent_version]
+    end
+
+    # date-time - Most recent successful observation for this process
+    def last_seen_at
+      @attributes[:last_seen_at]
+    end
+
+    # array(object) - Proxy connections observed for this process
+    def connections
+      @attributes[:connections]
+    end
+  end
+end

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -38,6 +38,8 @@ 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_node"
+require "files.com/models/agent_node_connection"
+require "files.com/models/agent_node_instance"
 require "files.com/models/agent_push_update"
 require "files.com/models/ai_assistant_personality"
 require "files.com/models/ai_task"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.705
+  version: 1.1.706
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-06 00:00:00.000000000 Z
+date: 2026-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -176,6 +176,8 @@ files:
 - docs/action_notification_export.md
 - docs/action_notification_export_result.md
 - docs/agent_node.md
+- docs/agent_node_connection.md
+- docs/agent_node_instance.md
 - docs/agent_push_update.md
 - docs/ai_assistant_personality.md
 - docs/ai_task.md
@@ -330,6 +332,8 @@ files:
 - lib/files.com/models/action_notification_export.rb
 - lib/files.com/models/action_notification_export_result.rb
 - lib/files.com/models/agent_node.rb
+- lib/files.com/models/agent_node_connection.rb
+- lib/files.com/models/agent_node_instance.rb
 - lib/files.com/models/agent_push_update.rb
 - lib/files.com/models/ai_assistant_personality.rb
 - lib/files.com/models/ai_task.rb