feat(api): add experimental agent time awareness

.castiron.stats.yml

@@ -1,7 +1,7 @@
 schema_version: 1
-generation_id: f129221a-b2b2-4a04-8fb5-bc9ae13a7385
-openapi_spec_hash: 172b67425fa2f92adad8d6ffac9968bd
-openapi_transformed_spec_hash: 65ec527530a65399ed22f0a46cd03cd9
+generation_id: c7d28dc2-cc3d-47a3-9b98-f74f327d7d06
+openapi_spec_hash: c735bf35306196d3be264afacd380ef5
+openapi_transformed_spec_hash: 26fd6dfec1625525dae954f7de5f80c1
 config_hash: 4e0613192a6ffb1791a25180a99a769c
-codegen_sha: 924bd07d3d31b02eab58145f7aea65676e41a32e
-codegen_hash: a82daaf0c7cbb8da5c442b1b5b85d86c5ebd1df1115786926274e8d148747111
+codegen_sha: 8a8a0ff64e79040ac5f29532ff061bdfa567764a
+codegen_hash: b296d6e5af2a21ef64ed15e9b4984854ca700063db8490798bd25ebbf58e3b34

api_reference/openapi.transformed.yml

@@ -84956,6 +84956,9 @@ components:
         compaction:
           $ref: '#/components/schemas/CompactionResource'
           description: The effective context compaction settings.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigResource'
+          description: The effective experimental settings for the agent.
       required:
       - model
       - reasoning
@@ -86398,8 +86401,12 @@ components:
           - $ref: '#/components/schemas/CompactionParam'
           - type: 'null'
           description: Context compaction settings. Omit to keep the current settings. A supplied object replaces the settings; null or an empty object enables background compaction.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigOverridesParam'
+          default: {}
+          description: Experimental settings to merge by key. Omitted settings keep their current values.
       additionalProperties: false
-      description: Agent configuration for a session. Omitted fields inherit from `agent_id` when supplied. Supplied objects and arrays replace the whole field; null resets nullable fields.
+      description: Agent configuration for a session. Omitted fields inherit from `agent_id` when supplied. Supplied objects and arrays replace the whole field, except experimental settings, which merge by key. Null resets nullable fields.
     EnvironmentParamNone:
       type: object
       properties:
@@ -89870,6 +89877,9 @@ components:
         compaction:
           $ref: '#/components/schemas/CompactionResource'
           description: The effective context compaction settings.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigResource'
+          description: The effective experimental settings for the agent.
       required:
       - id
       - object
@@ -90329,6 +90339,11 @@ components:
           - $ref: '#/components/schemas/CompactionParam'
           - type: 'null'
           description: Context compaction settings. Omission or null enables background compaction.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigParam'
+          default:
+            time_awareness: false
+          description: Experimental agent settings. All experimental features default to disabled.
       required:
       - model
       additionalProperties: false
@@ -90404,6 +90419,10 @@ components:
           - $ref: '#/components/schemas/CompactionParam'
           - type: 'null'
           description: Context compaction settings. Omit to keep the current settings. A supplied object replaces the settings; null or an empty object enables background compaction.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigOverridesParam'
+          default: {}
+          description: Experimental settings to merge by key. Omitted settings keep their current values.
       additionalProperties: false
       description: Fields to replace on an existing reusable agent.
     DeletedAgentResource:
@@ -90989,6 +91008,9 @@ components:
         compaction:
           $ref: '#/components/schemas/CompactionResource'
           description: The effective context compaction settings.
+        experimental:
+          $ref: '#/components/schemas/ExperimentalConfigResource'
+          description: The effective experimental settings for the agent.
       required:
       - id
       - name
@@ -111076,6 +111098,33 @@ components:
       type: string
       format: binary
       description: A transparent PNG overlaid on the first image to guide the edit. Must match that image's dimensions after orientation and contain transparent pixels. Supports GPT Image 2.5 and 2.6. Cannot be combined with mask.
+    ExperimentalConfigOverridesParam:
+      type: object
+      properties:
+        time_awareness:
+          type: boolean
+          description: Whether to give the model periodic current-time reminders. Omit to keep the current setting.
+      additionalProperties: false
+      description: Experimental settings to update. Omitted settings keep their current values.
+    ExperimentalConfigParam:
+      type: object
+      properties:
+        time_awareness:
+          type: boolean
+          default: false
+          description: Whether to give the model periodic current-time reminders. Defaults to false.
+      additionalProperties: false
+      description: Experimental agent settings. These features may change.
+    ExperimentalConfigResource:
+      type: object
+      properties:
+        time_awareness:
+          type: boolean
+          description: Whether the model receives periodic current-time reminders.
+      required:
+      - time_awareness
+      additionalProperties: false
+      description: The effective experimental settings for an agent.
     SessionSpendControlResource:
       type: object
       properties: