@arbidocs/client 0.3.166 → 0.3.168

package/dist/index.d.cts

@@ -412,6 +412,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/user/sessions/{session_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Patch Session
+         * @description Expire (ttl=0) or reset the remaining TTL of one of the caller's own sessions.
+         *
+         *     Agents (as with /logout) may only touch their own session; principals may target
+         *     any session in their session set, including ones other than the one they're on.
+         */
+        patch: operations['patch_session'];
+        trace?: never;
+    };
     '/v1/user/change_password': {
         parameters: {
             query?: never;
@@ -3666,6 +3689,12 @@ interface components {
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
+            /**
+             * Remote Control Enabled
+             * @description Enable the control_ui tool so the agent can drive the user's frontend with a guided cursor (click/type on their screen), gated by the user's consent. Pushes a remote_control WebSocket message to the user's session. Off by default.
+             * @default false
+             */
+            REMOTE_CONTROL_ENABLED: boolean;
             /**
              * Enabled Skills
              * @description Allowlist of skill slugs this config may invoke via run_skill/list_skills. None = no restriction (every skill the caller can see — back-compat default). A list (including []) restricts to exactly those slugs. Set a list on an agent's config to scope which skills that agent can use.
@@ -3921,6 +3950,12 @@ interface components {
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
+            /**
+             * Remote Control Enabled
+             * @description Enable the control_ui tool so the agent can drive the user's frontend with a guided cursor (click/type on their screen), gated by the user's consent. Pushes a remote_control WebSocket message to the user's session. Off by default.
+             * @default false
+             */
+            REMOTE_CONTROL_ENABLED: boolean;
             /**
              * Enabled Skills
              * @description Allowlist of skill slugs this config may invoke via run_skill/list_skills. None = no restriction (every skill the caller can see — back-compat default). A list (including []) restricts to exactly those slugs. Set a list on an agent's config to scope which skills that agent can use.
@@ -3992,6 +4027,7 @@ interface components {
              *       "SKILLS_ENABLED": false,
              *       "SKILL_CREATION": false,
              *       "WORKSPACE_TOOLS_ENABLED": false,
+             *       "REMOTE_CONTROL_ENABLED": false,
              *       "MEMORY_CREATION": false,
              *       "GOALS_ENABLED": false,
              *       "GOAL_MAX_OUTER_LOOPS": 6,
@@ -8776,6 +8812,55 @@ interface components {
             /** Lead Minutes */
             lead_minutes?: number | null;
         };
+        /**
+         * RemoteControlMessage
+         * @description Ask the user's frontend to run a guided-cursor UI action (remote control).
+         *
+         *     The model emits this via the ``control_ui`` tool to demonstrate or perform
+         *     an action on the user's screen. The frontend gates it behind the user's
+         *     consent, then either replays a registered ``sequence_id`` or the explicit
+         *     ``steps``. Exactly one of ``sequence_id`` / ``steps`` is set.
+         */
+        RemoteControlMessage: {
+            /**
+             * Type
+             * @default remote_control
+             * @constant
+             */
+            type: 'remote_control';
+            /** Agent Name */
+            agent_name: string;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
+            /** Sequence Id */
+            sequence_id?: string | null;
+            /** Steps */
+            steps?: components['schemas']['RemoteControlStep'][] | null;
+        };
+        /**
+         * RemoteControlStep
+         * @description One guided-cursor step the frontend action runner replays.
+         *
+         *     Field names are the ones the frontend's guided-step runner consumes
+         *     verbatim, so ``pauseMs``/``waitMs`` stay camelCase even though the envelope
+         *     around them is snake_case. ``target`` is a ``[data-testid=…]`` selector and
+         *     is required; ``do`` defaults to a click; ``value`` is the text for a
+         *     ``type`` step.
+         */
+        RemoteControlStep: {
+            /** Target */
+            target: string;
+            /** Do */
+            do?: ('click' | 'type') | null;
+            /** Value */
+            value?: string | null;
+            /** Note */
+            note?: string | null;
+            /** Pausems */
+            pauseMs?: number | null;
+            /** Waitms */
+            waitMs?: number | null;
+        };
         /**
          * RemoveWorkspaceUserItem
          * @description A user or agent to remove from a workspace.
@@ -9989,6 +10074,17 @@ interface components {
             /** Ttl */
             ttl: number;
         };
+        /**
+         * SessionTTLPatchRequest
+         * @description Body for PATCH /user/sessions/{session_id}.
+         */
+        SessionTTLPatchRequest: {
+            /**
+             * Ttl
+             * @description New remaining TTL in seconds. 0 expires the session immediately; any other value resets its remaining time (capped at the server's max session TTL).
+             */
+            ttl: number;
+        };
         /**
          * SessionTokenBridge
          * @description Client-decrypted tokens re-sealed to the session public key, posted at login.
@@ -11643,6 +11739,7 @@ interface components {
             response_complete?: components['schemas']['ResponseCompleteMessage'] | null;
             conversation_title_updated?: components['schemas']['ConversationTitleUpdatedMessage'] | null;
             skills_updated?: components['schemas']['SkillsUpdatedMessage'] | null;
+            remote_control?: components['schemas']['RemoteControlMessage'] | null;
             notification?: components['schemas']['NotificationResponse'] | null;
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
@@ -12453,6 +12550,41 @@ interface operations {
             };
         };
     };
+    patch_session: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['SessionTTLPatchRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SessionInfoResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     change_password: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -412,6 +412,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/user/sessions/{session_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Patch Session
+         * @description Expire (ttl=0) or reset the remaining TTL of one of the caller's own sessions.
+         *
+         *     Agents (as with /logout) may only touch their own session; principals may target
+         *     any session in their session set, including ones other than the one they're on.
+         */
+        patch: operations['patch_session'];
+        trace?: never;
+    };
     '/v1/user/change_password': {
         parameters: {
             query?: never;
@@ -3666,6 +3689,12 @@ interface components {
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
+            /**
+             * Remote Control Enabled
+             * @description Enable the control_ui tool so the agent can drive the user's frontend with a guided cursor (click/type on their screen), gated by the user's consent. Pushes a remote_control WebSocket message to the user's session. Off by default.
+             * @default false
+             */
+            REMOTE_CONTROL_ENABLED: boolean;
             /**
              * Enabled Skills
              * @description Allowlist of skill slugs this config may invoke via run_skill/list_skills. None = no restriction (every skill the caller can see — back-compat default). A list (including []) restricts to exactly those slugs. Set a list on an agent's config to scope which skills that agent can use.
@@ -3921,6 +3950,12 @@ interface components {
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
+            /**
+             * Remote Control Enabled
+             * @description Enable the control_ui tool so the agent can drive the user's frontend with a guided cursor (click/type on their screen), gated by the user's consent. Pushes a remote_control WebSocket message to the user's session. Off by default.
+             * @default false
+             */
+            REMOTE_CONTROL_ENABLED: boolean;
             /**
              * Enabled Skills
              * @description Allowlist of skill slugs this config may invoke via run_skill/list_skills. None = no restriction (every skill the caller can see — back-compat default). A list (including []) restricts to exactly those slugs. Set a list on an agent's config to scope which skills that agent can use.
@@ -3992,6 +4027,7 @@ interface components {
              *       "SKILLS_ENABLED": false,
              *       "SKILL_CREATION": false,
              *       "WORKSPACE_TOOLS_ENABLED": false,
+             *       "REMOTE_CONTROL_ENABLED": false,
              *       "MEMORY_CREATION": false,
              *       "GOALS_ENABLED": false,
              *       "GOAL_MAX_OUTER_LOOPS": 6,
@@ -8776,6 +8812,55 @@ interface components {
             /** Lead Minutes */
             lead_minutes?: number | null;
         };
+        /**
+         * RemoteControlMessage
+         * @description Ask the user's frontend to run a guided-cursor UI action (remote control).
+         *
+         *     The model emits this via the ``control_ui`` tool to demonstrate or perform
+         *     an action on the user's screen. The frontend gates it behind the user's
+         *     consent, then either replays a registered ``sequence_id`` or the explicit
+         *     ``steps``. Exactly one of ``sequence_id`` / ``steps`` is set.
+         */
+        RemoteControlMessage: {
+            /**
+             * Type
+             * @default remote_control
+             * @constant
+             */
+            type: 'remote_control';
+            /** Agent Name */
+            agent_name: string;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
+            /** Sequence Id */
+            sequence_id?: string | null;
+            /** Steps */
+            steps?: components['schemas']['RemoteControlStep'][] | null;
+        };
+        /**
+         * RemoteControlStep
+         * @description One guided-cursor step the frontend action runner replays.
+         *
+         *     Field names are the ones the frontend's guided-step runner consumes
+         *     verbatim, so ``pauseMs``/``waitMs`` stay camelCase even though the envelope
+         *     around them is snake_case. ``target`` is a ``[data-testid=…]`` selector and
+         *     is required; ``do`` defaults to a click; ``value`` is the text for a
+         *     ``type`` step.
+         */
+        RemoteControlStep: {
+            /** Target */
+            target: string;
+            /** Do */
+            do?: ('click' | 'type') | null;
+            /** Value */
+            value?: string | null;
+            /** Note */
+            note?: string | null;
+            /** Pausems */
+            pauseMs?: number | null;
+            /** Waitms */
+            waitMs?: number | null;
+        };
         /**
          * RemoveWorkspaceUserItem
          * @description A user or agent to remove from a workspace.
@@ -9989,6 +10074,17 @@ interface components {
             /** Ttl */
             ttl: number;
         };
+        /**
+         * SessionTTLPatchRequest
+         * @description Body for PATCH /user/sessions/{session_id}.
+         */
+        SessionTTLPatchRequest: {
+            /**
+             * Ttl
+             * @description New remaining TTL in seconds. 0 expires the session immediately; any other value resets its remaining time (capped at the server's max session TTL).
+             */
+            ttl: number;
+        };
         /**
          * SessionTokenBridge
          * @description Client-decrypted tokens re-sealed to the session public key, posted at login.
@@ -11643,6 +11739,7 @@ interface components {
             response_complete?: components['schemas']['ResponseCompleteMessage'] | null;
             conversation_title_updated?: components['schemas']['ConversationTitleUpdatedMessage'] | null;
             skills_updated?: components['schemas']['SkillsUpdatedMessage'] | null;
+            remote_control?: components['schemas']['RemoteControlMessage'] | null;
             notification?: components['schemas']['NotificationResponse'] | null;
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
@@ -12453,6 +12550,41 @@ interface operations {
             };
         };
     };
+    patch_session: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['SessionTTLPatchRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SessionInfoResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     change_password: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.3.166",
+  "version": "0.3.168",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "main": "dist/index.cjs",