@seamapi/types 1.1081.0 → 1.1083.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/types",
-  "version": "1.1081.0",
+  "version": "1.1083.0",
   "description": "TypeScript types for the Seam API.",
   "type": "module",
   "main": "index.js",

package/src/lib/seam/connect/models/action-attempts/action-attempt.ts

@@ -1,6 +1,7 @@
 import * as z from 'zod/v3'
 
 import { activate_climate_preset_action_attempt } from './activate-climate-preset.js'
+import { activate_weekly_program_action_attempt } from './activate-weekly-program.js'
 import { assign_credential_action_attempt } from './assign-credential.js'
 import { configure_auto_lock_action_attempt } from './configure-auto-lock.js'
 import { deprecated_action_attempts } from './deprecated.js'
@@ -27,6 +28,7 @@ export const action_attempt = z.union([
   ...set_fan_mode_action_attempt.options,
   ...set_hvac_mode_action_attempt.options,
   ...activate_climate_preset_action_attempt.options,
+  ...activate_weekly_program_action_attempt.options,
   ...simulate_keypad_code_entry_action_attempt.options,
   ...simulate_manual_lock_via_keypad_action_attempt.options,
   ...push_thermostat_programs_action_attempt.options,

package/src/lib/seam/connect/models/action-attempts/activate-weekly-program.ts

@@ -0,0 +1,46 @@
+import * as z from 'zod/v3'
+
+import {
+  common_failed_action_attempt,
+  common_pending_action_attempt,
+  common_succeeded_action_attempt,
+} from './common.js'
+
+const action_type = z
+  .literal('ACTIVATE_WEEKLY_PROGRAM')
+  .describe(
+    'Action attempt to track the status of returning a thermostat to its weekly program.',
+  )
+
+const error = z
+  .object({
+    type: z.string().describe('Type of the error.'),
+    message: z
+      .string()
+      .describe(
+        'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+      ),
+  })
+  .describe('Error associated with the action.')
+
+const result = z.object({}).describe('Result of the action.')
+
+export const activate_weekly_program_action_attempt = z.discriminatedUnion(
+  'status',
+  [
+    common_pending_action_attempt
+      .extend({
+        action_type,
+      })
+      .describe('Activating the weekly program is pending.'),
+    common_succeeded_action_attempt
+      .extend({
+        action_type,
+        result,
+      })
+      .describe('Activating the weekly program succeeded.'),
+    common_failed_action_attempt
+      .extend({ action_type, error })
+      .describe('Activating the weekly program failed.'),
+  ],
+)

package/src/lib/seam/connect/models/devices/device.ts

@@ -41,6 +41,11 @@ export const device_capability_flags = z
     can_turn_off_hvac: z
       .boolean()
       .describe('Indicates whether the thermostat can be turned off.'),
+    can_activate_weekly_program: z
+      .boolean()
+      .describe(
+        'Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.',
+      ),
     can_simulate_removal: z
       .boolean()
       .describe(

package/src/lib/seam/connect/models/events/devices.ts

@@ -852,6 +852,12 @@ export const camera_activated_event = device_event.extend({
     .url()
     .optional()
     .describe('URL to a short video clip captured at the time of activation.'),
+  media_status: z
+    .enum(['pending', 'available', 'unavailable', 'failed'])
+    .optional()
+    .describe(
+      'Status of the recorded clip and thumbnail for this activation, when the camera supports event recordings. `pending` while Seam retrieves the recording, `available` once it is stored, `unavailable` if no recording covers the activation, and `failed` if retrieval failed.',
+    ),
 }).describe(`
   ---
   route_path: /devices

package/src/lib/seam/connect/openapi.ts

@@ -10920,6 +10920,119 @@ const openapi: OpenAPISpec = {
             ],
             type: 'object',
           },
+          {
+            description: 'Activating the weekly program is pending.',
+            properties: {
+              action_attempt_id: {
+                description: 'ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+              },
+              action_type: {
+                description:
+                  'Action attempt to track the status of returning a thermostat to its weekly program.',
+                enum: ['ACTIVATE_WEEKLY_PROGRAM'],
+                type: 'string',
+              },
+              error: {
+                description:
+                  'Errors associated with the action attempt. Null for pending action attempts.',
+                nullable: true,
+              },
+              result: {
+                description:
+                  'Result of the action attempt. Null for pending action attempts.',
+                nullable: true,
+              },
+              status: { enum: ['pending'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'result',
+              'error',
+              'action_type',
+            ],
+            type: 'object',
+          },
+          {
+            description: 'Activating the weekly program succeeded.',
+            properties: {
+              action_attempt_id: {
+                description: 'ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+              },
+              action_type: {
+                description:
+                  'Action attempt to track the status of returning a thermostat to its weekly program.',
+                enum: ['ACTIVATE_WEEKLY_PROGRAM'],
+                type: 'string',
+              },
+              error: {
+                description:
+                  'Errors associated with the action attempt. Null for successful action attempts.',
+                nullable: true,
+              },
+              result: {
+                description: 'Result of the action.',
+                properties: {},
+                type: 'object',
+              },
+              status: { enum: ['success'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'error',
+              'action_type',
+              'result',
+            ],
+            type: 'object',
+          },
+          {
+            description: 'Activating the weekly program failed.',
+            properties: {
+              action_attempt_id: {
+                description: 'ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+              },
+              action_type: {
+                description:
+                  'Action attempt to track the status of returning a thermostat to its weekly program.',
+                enum: ['ACTIVATE_WEEKLY_PROGRAM'],
+                type: 'string',
+              },
+              error: {
+                description: 'Error associated with the action.',
+                properties: {
+                  message: {
+                    description:
+                      'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                    type: 'string',
+                  },
+                  type: { description: 'Type of the error.', type: 'string' },
+                },
+                required: ['type', 'message'],
+                type: 'object',
+              },
+              result: {
+                description:
+                  'Result of the action attempt. Null for failed action attempts.',
+                nullable: true,
+              },
+              status: { enum: ['error'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'result',
+              'action_type',
+              'error',
+            ],
+            type: 'object',
+          },
           {
             description: 'Simulating a keypad code entry is pending.',
             properties: {
@@ -13493,6 +13606,11 @@ const openapi: OpenAPISpec = {
         description:
           'Represents a [device](https://www.seam.co/docs/core-concepts/devices) that has been connected to Seam.',
         properties: {
+          can_activate_weekly_program: {
+            description:
+              'Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.',
+            type: 'boolean',
+          },
           can_configure_auto_lock: {
             description:
               'Indicates whether the lock supports configuring automatic locking.',
@@ -18067,6 +18185,11 @@ const openapi: OpenAPISpec = {
       },
       device_provider: {
         properties: {
+          can_activate_weekly_program: {
+            description:
+              'Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.',
+            type: 'boolean',
+          },
           can_configure_auto_lock: {
             description:
               'Indicates whether the lock supports configuring automatic locking.',
@@ -28988,6 +29111,12 @@ const openapi: OpenAPISpec = {
                 format: 'uri',
                 type: 'string',
               },
+              media_status: {
+                description:
+                  'Status of the recorded clip and thumbnail for this activation, when the camera supports event recordings. `pending` while Seam retrieves the recording, `available` once it is stored, `unavailable` if no recording covers the activation, and `failed` if retrieval failed.',
+                enum: ['pending', 'available', 'unavailable', 'failed'],
+                type: 'string',
+              },
               motion_sub_type: {
                 description: 'Sub-type of motion detected, if available.',
                 enum: ['human', 'vehicle', 'package', 'other'],
@@ -36121,6 +36250,11 @@ const openapi: OpenAPISpec = {
         description:
           'Represents an [unmanaged device](https://www.seam.co/docs/core-concepts/devices/managed-and-unmanaged-devices). An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](https://www.seam.co/docs/core-concepts/devices/managed-and-unmanaged-devices#convert-an-unmanaged-device-to-managed).',
         properties: {
+          can_activate_weekly_program: {
+            description:
+              'Indicates whether the thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.',
+            type: 'boolean',
+          },
           can_configure_auto_lock: {
             description:
               'Indicates whether the lock supports configuring automatic locking.',
@@ -51066,6 +51200,7 @@ const openapi: OpenAPISpec = {
                   'can_hvac_cool',
                   'can_hvac_heat_cool',
                   'can_turn_off_hvac',
+                  'can_activate_weekly_program',
                   'can_simulate_removal',
                   'can_simulate_connection',
                   'can_simulate_disconnection',
@@ -51099,6 +51234,7 @@ const openapi: OpenAPISpec = {
                   'can_hvac_cool',
                   'can_hvac_heat_cool',
                   'can_turn_off_hvac',
+                  'can_activate_weekly_program',
                   'can_simulate_removal',
                   'can_simulate_connection',
                   'can_simulate_disconnection',
@@ -53335,6 +53471,7 @@ const openapi: OpenAPISpec = {
                   'can_hvac_cool',
                   'can_hvac_heat_cool',
                   'can_turn_off_hvac',
+                  'can_activate_weekly_program',
                   'can_simulate_removal',
                   'can_simulate_connection',
                   'can_simulate_disconnection',
@@ -53368,6 +53505,7 @@ const openapi: OpenAPISpec = {
                   'can_hvac_cool',
                   'can_hvac_heat_cool',
                   'can_turn_off_hvac',
+                  'can_activate_weekly_program',
                   'can_simulate_removal',
                   'can_simulate_connection',
                   'can_simulate_disconnection',
@@ -66805,6 +66943,71 @@ const openapi: OpenAPISpec = {
         'x-title': 'Activate a Climate Preset',
       },
     },
+    '/thermostats/activate_weekly_program': {
+      post: {
+        description:
+          "Returns a specified [thermostat](https://www.seam.co/docs/capability-guides/thermostats) to its [weekly program](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-programs), the schedule that is configured on the device itself, releasing any hold that Seam has set. Seam stops managing the thermostat's climate until you [activate a climate preset](https://www.seam.co/docs/capability-guides/thermostats/configure-current-climate-settings), make a direct climate setting change, or one of the thermostat's [scheduled](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules) presets reaches its activation time.",
+        operationId: 'thermostatsActivateWeeklyProgramPost',
+        requestBody: {
+          content: {
+            'application/json': {
+              schema: {
+                properties: {
+                  device_id: {
+                    description:
+                      'ID of the thermostat device that you want to return to its weekly program.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                  sync: {
+                    default: false,
+                    type: 'boolean',
+                    'x-undocumented': 'Only used internally.',
+                  },
+                },
+                required: ['device_id'],
+                type: 'object',
+              },
+            },
+          },
+        },
+        responses: {
+          '200': {
+            content: {
+              'application/json': {
+                schema: {
+                  properties: {
+                    action_attempt: {
+                      $ref: '#/components/schemas/action_attempt',
+                    },
+                    ok: { type: 'boolean' },
+                  },
+                  required: ['action_attempt', 'ok'],
+                  type: 'object',
+                },
+              },
+            },
+            description: 'OK',
+          },
+          '400': { description: 'Bad Request' },
+          '401': { description: 'Unauthorized' },
+        },
+        security: [
+          { client_session: [] },
+          { pat_with_workspace: [] },
+          { console_session_with_workspace: [] },
+          { api_key: [] },
+        ],
+        summary: '/thermostats/activate_weekly_program',
+        tags: ['/thermostats'],
+        'x-action-attempt-type': 'ACTIVATE_WEEKLY_PROGRAM',
+        'x-fern-sdk-group-name': ['thermostats'],
+        'x-fern-sdk-method-name': 'activate_weekly_program',
+        'x-fern-sdk-return-value': 'action_attempt',
+        'x-response-key': 'action_attempt',
+        'x-title': 'Activate the Weekly Program',
+      },
+    },
     '/thermostats/cool': {
       post: {
         description: