@archastro/sdk 0.13.0 → 0.15.0

package/dist/types/common.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 469ef0f9bdda
+// Content hash: 4b056560955c
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
 import { configSchema } from "./config.js";
@@ -34,7 +34,7 @@ export const aclSchema = z.object({
 /** Runtime validator for {@link ActivityFeedEntry}. */
 export const activityFeedEntrySchema = z.object({
     /** The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated. */
-    agent: z.union([z.string(), z.object({ acl: z.object({ add: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), grants: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional() }).optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().optional(), description: z.string().optional(), email: z.string().optional(), id: z.string(), identity: z.string().optional(), last_applied_template_config: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_name: z.string().optional(), originator: z.string().optional(), phone_number: z.string().optional(), sandbox: z.string().optional(), source_solution: z.object({ current_solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().optional(), kind: z.string(), latest_solution: z.string().optional(), latest_version: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_logo: z.object({ file: z.string().optional(), height: z.number().int().optional(), media: z.string().optional(), mime_type: z.string().optional(), refresh_url: z.string().optional(), url: z.string().optional(), width: z.number().int().optional() }).optional(), org_name: z.string().optional(), org_slug: z.string().optional(), owners: z.array(z.string()), readme_url: z.string().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().optional(), solution_version: z.string().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().optional(), templates: z.array(z.object({ description: z.string().optional(), details: z.object({ automation_type: z.string().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).optional(), participants: z.array(z.object({ description: z.string().optional(), name: z.string(), required: z.boolean(), type: z.string() })).optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).optional(), type: z.literal("automation") }).optional(), display_name: z.string().optional(), id: z.string().optional(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), readme_url: z.string().optional(), virtual_path: z.string().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().optional() }).optional(), solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().optional(), kind: z.string(), latest_solution: z.string().optional(), latest_version: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_logo: z.object({ file: z.string().optional(), height: z.number().int().optional(), media: z.string().optional(), mime_type: z.string().optional(), refresh_url: z.string().optional(), url: z.string().optional(), width: z.number().int().optional() }).optional(), org_name: z.string().optional(), org_slug: z.string().optional(), owners: z.array(z.string()), readme_url: z.string().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().optional(), solution_version: z.string().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().optional(), templates: z.array(z.object({ description: z.string().optional(), details: z.object({ automation_type: z.string().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).optional(), participants: z.array(z.object({ description: z.string().optional(), name: z.string(), required: z.boolean(), type: z.string() })).optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).optional(), type: z.literal("automation") }).optional(), display_name: z.string().optional(), id: z.string().optional(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), readme_url: z.string().optional(), virtual_path: z.string().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().optional(), display_name: z.string().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), updated_at: z.string().optional(), virtual_path: z.string().optional() }) }).optional(), team: z.string().optional(), template_upgrade_available: z.boolean().optional(), updated_at: z.string().optional(), user: z.string().optional() })]).optional().describe("The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated."),
+    agent: z.union([z.string(), z.object({ acl: z.object({ add: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), grants: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional() }).nullable().optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().nullable().optional(), description: z.string().nullable().optional(), email: z.string().nullable().optional(), id: z.string(), identity: z.string().nullable().optional(), last_applied_template_config: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().nullable().optional(), org_name: z.string().nullable().optional(), originator: z.string().nullable().optional(), phone_number: z.string().nullable().optional(), sandbox: z.string().nullable().optional(), source_solution: z.object({ current_solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().nullable().optional(), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }).optional(), solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().nullable().optional(), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().nullable().optional(), display_name: z.string().nullable().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), updated_at: z.string().optional(), virtual_path: z.string().nullable().optional() }) }).nullable().optional(), team: z.string().nullable().optional(), template_upgrade_available: z.boolean().nullable().optional(), updated_at: z.string().optional(), user: z.string().nullable().optional() })]).optional().describe("The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated."),
     /** ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app. */
     app: z.string().optional().describe("ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app."),
     /** Array of attachment objects associated with this entry. Each attachment has a `type` field (e.g. `"file"`, `"task"`, `"artifact"`) and type-specific additional fields. Empty array when there are no attachments. */
@@ -72,7 +72,7 @@ export const activityFeedEntrySchema = z.object({
     /** When this activity feed entry was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When this activity feed entry was last modified (ISO 8601)."),
     /** The user who triggered this event. Returns a user ID (`usr_...`) by default, or an expanded user object when the association is loaded. `null` if no user is associated. */
-    user: z.union([z.string(), z.object({ alias: z.string().optional(), app: z.string().optional(), app_name: z.string().optional(), email: z.string().optional(), id: z.string(), is_system_user: z.boolean().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_name: z.string().optional(), org_role: z.string().optional(), org_slug: z.string().optional(), sandbox: z.string().optional(), sandbox_name: z.string().optional() })]).optional().describe("The user who triggered this event. Returns a user ID (`usr_...`) by default, or an expanded user object when the association is loaded. `null` if no user is associated."),
+    user: z.union([z.string(), z.object({ alias: z.string().nullable().optional(), app: z.string().nullable().optional(), app_name: z.string().nullable().optional(), created_by_agent_user: z.string().nullable().optional(), created_by_developer: z.string().nullable().optional(), created_by_org: z.string().nullable().optional(), created_by_team: z.string().nullable().optional(), created_by_user: z.string().nullable().optional(), email: z.string().nullable().optional(), id: z.string(), is_system_user: z.boolean().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_name: z.string().nullable().optional(), org_role: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), sandbox: z.string().nullable().optional(), sandbox_name: z.string().nullable().optional() })]).optional().describe("The user who triggered this event. Returns a user ID (`usr_...`) by default, or an expanded user object when the association is loaded. `null` if no user is associated."),
 }).describe("A single event record in an activity feed, capturing what happened, who caused it, and which resources were involved.");
 /** Runtime validator for {@link ActivityFeedEntryListResponse}. */
 export const activityFeedEntryListResponseSchema = z.object({
@@ -88,34 +88,34 @@ export const activityFeedEntryListResponseSchema = z.object({
 /** Runtime validator for {@link Actor}. */
 export const actorSchema = z.object({
     /** Short handle or alias for the actor, used as an alternate display identifier. `null` if not configured. */
-    alias: z.string().optional().describe("Short handle or alias for the actor, used as an alternate display identifier. `null` if not configured."),
+    alias: z.string().nullable().optional().describe("Short handle or alias for the actor, used as an alternate display identifier. `null` if not configured."),
     /** Composite actor identifier. Format is `"user-<usr_...>"` for human users or `"agent-<agi_...>"` for agents. */
-    id: z.string().optional().describe("Composite actor identifier. Format is `\"user-<usr_...>\"` for human users or `\"agent-<agi_...>\"` for agents."),
+    id: z.string().nullable().optional().describe("Composite actor identifier. Format is `\"user-<usr_...>\"` for human users or `\"agent-<agi_...>\"` for agents."),
     /** Display name of the actor shown in the UI. `null` if no name is set. */
-    name: z.string().optional().describe("Display name of the actor shown in the UI. `null` if no name is set."),
+    name: z.string().nullable().optional().describe("Display name of the actor shown in the UI. `null` if no name is set."),
     /** Profile picture for the actor. `null` if the actor has no profile picture. */
-    profile_picture: imageSourceSchema.optional().describe("Profile picture for the actor. `null` if the actor has no profile picture."),
+    profile_picture: imageSourceSchema.nullable().optional().describe("Profile picture for the actor. `null` if the actor has no profile picture."),
 }).describe("The entity that authored a message, either a human user or an agent.");
 /** Runtime validator for {@link UpgradeTemplateSummary}. */
 export const upgradeTemplateSummarySchema = z.object({
     /** When this template config was created (ISO 8601). */
     created_at: z.string().optional().describe("When this template config was created (ISO 8601)."),
     /** Description of the template from the config body. `null` if the current version has no `description` field. */
-    description: z.string().optional().describe("Description of the template from the config body. `null` if the current version has no `description` field."),
+    description: z.string().nullable().optional().describe("Description of the template from the config body. `null` if the current version has no `description` field."),
     /** Human-readable display name from the config body. `null` if the current version has no `display_name` field. */
-    display_name: z.string().optional().describe("Human-readable display name from the config body. `null` if the current version has no `display_name` field."),
+    display_name: z.string().nullable().optional().describe("Human-readable display name from the config body. `null` if the current version has no `display_name` field."),
     /** Template config ID (`cfg_...`). */
     id: z.string().describe("Template config ID (`cfg_...`)."),
     /** Config kind identifier for this template (e.g. `"agent_tool_template"`). */
     kind: z.string().describe("Config kind identifier for this template (e.g. `\"agent_tool_template\"`)."),
     /** Stable lookup key assigned to this template config. `null` if no lookup key is set. */
-    lookup_key: z.string().optional().describe("Stable lookup key assigned to this template config. `null` if no lookup key is set."),
+    lookup_key: z.string().nullable().optional().describe("Stable lookup key assigned to this template config. `null` if no lookup key is set."),
     /** Template name as stored in the config body. `null` if the current version has no `name` field. */
-    name: z.string().optional().describe("Template name as stored in the config body. `null` if the current version has no `name` field."),
+    name: z.string().nullable().optional().describe("Template name as stored in the config body. `null` if the current version has no `name` field."),
     /** When this template config was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When this template config was last modified (ISO 8601)."),
     /** Virtual filesystem path for this template config. `null` if not set. */
-    virtual_path: z.string().optional().describe("Virtual filesystem path for this template config. `null` if not set."),
+    virtual_path: z.string().nullable().optional().describe("Virtual filesystem path for this template config. `null` if not set."),
 }).describe("Compact summary of an AgentTemplate config referenced by an agent upgrade or source-solution response.");
 /** Runtime validator for {@link InstalledConfigEntry}. */
 export const installedConfigEntrySchema = z.object({
@@ -126,7 +126,7 @@ export const installedConfigEntrySchema = z.object({
     /** Type of config that was created. One of `"Skill"`, `"File"`, `"Script"`, `"AgentTemplate"`, or `"Config"`. */
     kind: z.string().describe("Type of config that was created. One of `\"Skill\"`, `\"File\"`, `\"Script\"`, `\"AgentTemplate\"`, or `\"Config\"`."),
     /** Stored `lookup_key` for this config after any suffix has been applied. `null` for `File` children inside a skill bundle, which are keyed by `(parent_id, relative_path)` rather than by `lookup_key`. */
-    lookup_key: z.string().optional().describe("Stored `lookup_key` for this config after any suffix has been applied. `null` for `File` children inside a skill bundle, which are keyed by `(parent_id, relative_path)` rather than by `lookup_key`."),
+    lookup_key: z.string().nullable().optional().describe("Stored `lookup_key` for this config after any suffix has been applied. `null` for `File` children inside a skill bundle, which are keyed by `(parent_id, relative_path)` rather than by `lookup_key`."),
 }).describe("A slim summary of a single config record created during an agent install transaction. Returned as an entry in `AgentCreateResponse.installed_configs`.");
 /** Runtime validator for {@link MessagePolicy}. */
 export const messagePolicySchema = z.object({
@@ -165,66 +165,66 @@ export const workerStatusSchema = z.object({
 /** Runtime validator for {@link MediaVariant}. */
 export const mediaVariantSchema = z.object({
     /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
-    content_type: z.string().optional().describe("MIME type of this variant's file (e.g., `\"image/jpeg\"`, `\"video/mp4\"`). `null` if the file is not loaded."),
+    content_type: z.string().nullable().optional().describe("MIME type of this variant's file (e.g., `\"image/jpeg\"`, `\"video/mp4\"`). `null` if the file is not loaded."),
     /** When this variant was created (ISO 8601). */
     created_at: z.string().optional().describe("When this variant was created (ISO 8601)."),
     /** ID of the underlying storage file that backs this variant (`fil_...`). */
     file: z.string().optional().describe("ID of the underlying storage file that backs this variant (`fil_...`)."),
     /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
-    filename: z.string().optional().describe("Original filename of the uploaded file for this variant. `null` if the file is not loaded."),
+    filename: z.string().nullable().optional().describe("Original filename of the uploaded file for this variant. `null` if the file is not loaded."),
     /** Height of this variant in pixels. `null` if not recorded. */
-    height: z.number().int().optional().describe("Height of this variant in pixels. `null` if not recorded."),
+    height: z.number().int().nullable().optional().describe("Height of this variant in pixels. `null` if not recorded."),
     /** Media variant ID (`mvr_...`). */
     id: z.string().describe("Media variant ID (`mvr_...`)."),
     /** Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types. */
-    image_source: imageSourceSchema.optional().describe("Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types."),
+    image_source: imageSourceSchema.nullable().optional().describe("Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types."),
     /** When this variant was last updated (ISO 8601). */
     updated_at: z.string().optional().describe("When this variant was last updated (ISO 8601)."),
     /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
-    url: z.string().optional().describe("Signed download URL for this variant, resolved at request time. `null` if the file is unavailable."),
+    url: z.string().nullable().optional().describe("Signed download URL for this variant, resolved at request time. `null` if the file is unavailable."),
     /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
     variant_key: z.string().optional().describe("Identifier for this variant's processing tier. Common values include `\"original\"` (the unmodified upload) and `\"thumbnail\"` (a resized preview)."),
     /** Width of this variant in pixels. `null` if not recorded. */
-    width: z.number().int().optional().describe("Width of this variant in pixels. `null` if not recorded."),
+    width: z.number().int().nullable().optional().describe("Width of this variant in pixels. `null` if not recorded."),
 }).describe("A processed variant of a media item, such as the original upload or a resized thumbnail, including a signed download URL resolved at request time.");
 /** Runtime validator for {@link Attachment}. */
 export const attachmentSchema = z.object({
     /** MIME type of the attached file, e.g. `"image/png"` or `"application/pdf"`. Present on `file`, `artifact`, and `media` types. `null` otherwise. */
-    content_type: z.string().optional().describe("MIME type of the attached file, e.g. `\"image/png\"` or `\"application/pdf\"`. Present on `file`, `artifact`, and `media` types. `null` otherwise."),
+    content_type: z.string().nullable().optional().describe("MIME type of the attached file, e.g. `\"image/png\"` or `\"application/pdf\"`. Present on `file`, `artifact`, and `media` types. `null` otherwise."),
     /** Short description. The page meta-description for `scraped_link`, the artifact description for `artifact`, and the task description for `task` types. `null` on other types. */
-    description: z.string().optional().describe("Short description. The page meta-description for `scraped_link`, the artifact description for `artifact`, and the task description for `task` types. `null` on other types."),
+    description: z.string().nullable().optional().describe("Short description. The page meta-description for `scraped_link`, the artifact description for `artifact`, and the task description for `task` types. `null` on other types."),
     /** Original filename of the attached file, e.g. `"report.pdf"`. Present on `file`, `artifact`, and `media` types. `null` otherwise. */
-    filename: z.string().optional().describe("Original filename of the attached file, e.g. `\"report.pdf\"`. Present on `file`, `artifact`, and `media` types. `null` otherwise."),
+    filename: z.string().nullable().optional().describe("Original filename of the attached file, e.g. `\"report.pdf\"`. Present on `file`, `artifact`, and `media` types. `null` otherwise."),
     /** Height in pixels of the media item. Present on `media` type only. `null` otherwise. */
-    height: z.number().int().optional().describe("Height in pixels of the media item. Present on `media` type only. `null` otherwise."),
+    height: z.number().int().nullable().optional().describe("Height in pixels of the media item. Present on `media` type only. `null` otherwise."),
     /** Unique identifier for this attachment within the message. */
     id: z.string().describe("Unique identifier for this attachment within the message."),
     /** Height in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise. */
-    image_height: z.number().int().optional().describe("Height in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
+    image_height: z.number().int().nullable().optional().describe("Height in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
     /** Image source metadata for inline rendering. Present on `file`, `scraped_link`, `artifact`, and `media` types when the content is an image. `null` otherwise. */
-    image_source: imageSourceSchema.optional().describe("Image source metadata for inline rendering. Present on `file`, `scraped_link`, `artifact`, and `media` types when the content is an image. `null` otherwise."),
+    image_source: imageSourceSchema.nullable().optional().describe("Image source metadata for inline rendering. Present on `file`, `scraped_link`, `artifact`, and `media` types when the content is an image. `null` otherwise."),
     /** URL of the preview image extracted from the scraped page. Present on `scraped_link` type only. `null` otherwise. */
-    image_url: z.string().optional().describe("URL of the preview image extracted from the scraped page. Present on `scraped_link` type only. `null` otherwise."),
+    image_url: z.string().nullable().optional().describe("URL of the preview image extracted from the scraped page. Present on `scraped_link` type only. `null` otherwise."),
     /** Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise. */
-    image_width: z.number().int().optional().describe("Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
-    /** The media category, e.g. `"video"` or `"audio"`. Present on `media` type only. `null` otherwise. */
-    media_type: z.string().optional().describe("The media category, e.g. `\"video\"` or `\"audio\"`. Present on `media` type only. `null` otherwise."),
+    image_width: z.number().int().nullable().optional().describe("Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
+    /** The media category, e.g. `"video"` or `"audio"`. Present on `media` type only; omitted otherwise. */
+    media_type: z.string().optional().describe("The media category, e.g. `\"video\"` or `\"audio\"`. Present on `media` type only; omitted otherwise."),
     /** Display name of the media item. Present on `media` type only. `null` otherwise. */
-    name: z.string().optional().describe("Display name of the media item. Present on `media` type only. `null` otherwise."),
-    /** The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. `null` on other types. */
-    object: z.record(z.unknown()).optional().describe("The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. `null` on other types."),
+    name: z.string().nullable().optional().describe("Display name of the media item. Present on `media` type only. `null` otherwise."),
+    /** The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. Omitted on other types. */
+    object: z.record(z.unknown()).optional().describe("The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. Omitted on other types."),
     /** Display title. The page title for `scraped_link`, the artifact name for `artifact`, and the task title for `task` types. `null` on other types. */
-    title: z.string().optional().describe("Display title. The page title for `scraped_link`, the artifact name for `artifact`, and the task title for `task` types. `null` on other types."),
+    title: z.string().nullable().optional().describe("Display title. The page title for `scraped_link`, the artifact name for `artifact`, and the task title for `task` types. `null` on other types."),
     /** The attachment type. One of `"file"`, `"scraped_link"`, `"artifact"`, `"task"`, `"media"`, `"action"`, or `"chart"`. Determines which additional fields are present. */
     type: z.string().describe("The attachment type. One of `\"file\"`, `\"scraped_link\"`, `\"artifact\"`, `\"task\"`, `\"media\"`, `\"action\"`, or `\"chart\"`. Determines which additional fields are present."),
     /** URL to access the resource. A signed download URL for `file` and `artifact` types; the original URL for `scraped_link`; a media playback URL for `media`. `null` on `task` and `action` types. */
-    url: z.string().optional().describe("URL to access the resource. A signed download URL for `file` and `artifact` types; the original URL for `scraped_link`; a media playback URL for `media`. `null` on `task` and `action` types."),
-    /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only. `null` otherwise. */
-    variants: z.array(mediaVariantSchema).optional().describe("Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only. `null` otherwise."),
+    url: z.string().nullable().optional().describe("URL to access the resource. A signed download URL for `file` and `artifact` types; the original URL for `scraped_link`; a media playback URL for `media`. `null` on `task` and `action` types."),
+    /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only; omitted otherwise. */
+    variants: z.array(mediaVariantSchema).optional().describe("Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only; omitted otherwise."),
     /** Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise. */
-    version: z.number().int().optional().describe("Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise."),
+    version: z.number().int().nullable().optional().describe("Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise."),
     /** Width in pixels of the media item. Present on `media` type only. `null` otherwise. */
-    width: z.number().int().optional().describe("Width in pixels of the media item. Present on `media` type only. `null` otherwise."),
+    width: z.number().int().nullable().optional().describe("Width in pixels of the media item. Present on `media` type only. `null` otherwise."),
 }).describe("A rich attachment associated with a message, such as a file, scraped link, artifact, task, media item, or inline action.");
 /** Runtime validator for {@link AuthTokens}. */
 export const authTokensSchema = z.object({
@@ -296,8 +296,25 @@ export const builtinToolCatalogEntrySchema = z.object({
     /** Array of individual tool definitions included in this category. Each entry describes a single callable tool with its own name and description. */
     tools: z.array(builtinToolSchema).optional().describe("Array of individual tool definitions included in this category. Each entry describes a single callable tool with its own name and description."),
 }).describe("A catalog entry describing a category of platform-provided (builtin) tools that can be enabled for an agent. Each entry groups one or more individual tools under a shared key, label, and configuration schema.");
+/** Runtime validator for {@link Cancelled}. */
+export const cancelledSchema = z.object({
+    call_id: z.string(),
+    reason: z.string(),
+    status: z.literal("cancelled"),
+}).describe("A cancelled local-tool outcome.");
 /** Runtime validator for {@link ChannelAck}. */
 export const channelAckSchema = z.object({}).describe("Empty acknowledgement payload returned by channel message handlers that produce no data. The wire envelope is `{\"status\": \"ok\", \"response\": {}}`.");
+/** Runtime validator for {@link MessageContext}. */
+export const messageContextSchema = z.object({
+    /** Scalar key-value fields describing the context, such as route, repository, or pull-request number. */
+    attributes: z.record(z.unknown()).optional().describe("Scalar key-value fields describing the context, such as route, repository, or pull-request number."),
+    /** Optional context body. The model receives it as escaped XML data, not a system instruction. */
+    content: z.string().nullable().optional().describe("Optional context body. The model receives it as escaped XML data, not a system instruction."),
+    /** Optional human-readable label for this context block. */
+    title: z.string().nullable().optional().describe("Optional human-readable label for this context block."),
+    /** Stable context kind. Must start with a lowercase letter and contain only lowercase letters, numbers, dots, dashes, or underscores. */
+    type: z.string().describe("Stable context kind. Must start with a lowercase letter and contain only lowercase letters, numbers, dots, dashes, or underscores."),
+}).describe("Structured context captured with a chat message and delivered to agents as data.");
 /** Runtime validator for {@link MessageReaction}. */
 export const messageReactionSchema = z.object({
     /** Type-specific reaction data. For `"emoji_reaction"` reactions, contains an `emoji` key with the Unicode emoji string (e.g., `"👍"`). */
@@ -310,19 +327,21 @@ export const messageReactionSchema = z.object({
 /** Runtime validator for {@link Message}. */
 export const messageSchema = z.object({
     /** Access control list for private messages (grants with `read` action). Only returned to resource owners (and privileged/org-admin viewers) via server-side `field_redactions: [acl: :owner]`; `null` for everyone else. */
-    acl: aclSchema.optional().describe("Access control list for private messages (grants with `read` action). Only returned to resource owners (and privileged/org-admin viewers) via server-side `field_redactions: [acl: :owner]`; `null` for everyone else."),
+    acl: aclSchema.nullable().optional().describe("Access control list for private messages (grants with `read` action). Only returned to resource owners (and privileged/org-admin viewers) via server-side `field_redactions: [acl: :owner]`; `null` for everyone else."),
     /** Resolved actor descriptors for the message sender, combining identity and display metadata. Always contains exactly one entry. */
     actors: z.array(actorSchema).optional().describe("Resolved actor descriptors for the message sender, combining identity and display metadata. Always contains exactly one entry."),
     /** ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users. */
-    agent: z.string().optional().describe("ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users."),
+    agent: z.string().nullable().optional().describe("ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users."),
     /** Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path. */
-    agent_mode: z.enum(["cli", "embedded"]).optional().describe("Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path."),
+    agent_mode: z.enum(["cli", "embedded"]).nullable().optional().describe("Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path."),
     /** Files, links, tasks, media, artifacts, and actions attached to this message. Empty array if there are no attachments. */
     attachments: z.array(attachmentSchema).optional().describe("Files, links, tasks, media, artifacts, and actions attached to this message. Empty array if there are no attachments."),
     /** ID of the thread that was branched from this message (`thr_...`). `null` if this message has not spawned a branch thread. */
-    branched_thread: z.string().optional().describe("ID of the thread that was branched from this message (`thr_...`). `null` if this message has not spawned a branch thread."),
+    branched_thread: z.string().nullable().optional().describe("ID of the thread that was branched from this message (`thr_...`). `null` if this message has not spawned a branch thread."),
     /** Text content of the message. `null` for messages that contain only attachments. */
-    content: z.string().optional().describe("Text content of the message. `null` for messages that contain only attachments."),
+    content: z.string().nullable().optional().describe("Text content of the message. `null` for messages that contain only attachments."),
+    /** Immutable structured context captured when the message was posted. Each entry has `type`, optional `title` and `content`, and scalar `attributes`. Always present; defaults to an empty array. Context is delivered to agents as escaped XML data, not as system instructions. */
+    context: z.array(messageContextSchema).optional().describe("Immutable structured context captured when the message was posted. Each entry has `type`, optional `title` and `content`, and scalar `attributes`. Always present; defaults to an empty array. Context is delivered to agents as escaped XML data, not as system instructions."),
     /** When the message was posted (ISO 8601). */
     created_at: z.string().optional().describe("When the message was posted (ISO 8601)."),
     /** Whether this message has at least one reply. Only present when explicitly requested or computed by the server. */
@@ -330,44 +349,57 @@ export const messageSchema = z.object({
     /** Message ID (`msg_...`). */
     id: z.string().describe("Message ID (`msg_...`)."),
     /** Client-supplied idempotency key used to deduplicate message sends. `null` if the sender did not provide one. */
-    idempotency_key: z.string().optional().describe("Client-supplied idempotency key used to deduplicate message sends. `null` if the sender did not provide one."),
+    idempotency_key: z.string().nullable().optional().describe("Client-supplied idempotency key used to deduplicate message sends. `null` if the sender did not provide one."),
     /** Whether this message is a deletion tombstone. `true` only on the `message_updated` broadcast emitted when a message is deleted: the original content is replaced with a placeholder and the message no longer exists on the server. Always `false` for live messages. */
     is_deleted: z.boolean().optional().describe("Whether this message is a deletion tombstone. `true` only on the `message_updated` broadcast emitted when a message is deleted: the original content is replaced with a placeholder and the message no longer exists on the server. Always `false` for live messages."),
     /** Identifier of the legacy chat agent that sent this message, if applicable. `null` for messages sent by users or modern agent users. */
-    legacy_agent: z.string().optional().describe("Identifier of the legacy chat agent that sent this message, if applicable. `null` for messages sent by users or modern agent users."),
+    legacy_agent: z.string().nullable().optional().describe("Identifier of the legacy chat agent that sent this message, if applicable. `null` for messages sent by users or modern agent users."),
     /** Arbitrary key-value metadata attached to the message. Always present; defaults to an empty object when no metadata has been set. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the message. Always present; defaults to an empty object when no metadata has been set."),
     /** ID of the organization that owns this message (`org_...`). */
-    org: z.string().optional().describe("ID of the organization that owns this message (`org_...`)."),
+    org: z.string().nullable().optional().describe("ID of the organization that owns this message (`org_...`)."),
     /** Emoji and other reactions added to this message by users. Empty array if no reactions have been added or the association is not preloaded. */
     reactions: z.array(messageReactionSchema).optional().describe("Emoji and other reactions added to this message by users. Empty array if no reactions have been added or the association is not preloaded."),
     /** Display hint for how the message should be rendered. One of `"reply"`, `"direct"`, or `"inline"`. `null` for user-authored messages, which are always rendered as standard replies. */
-    rendering_mode: z.string().optional().describe("Display hint for how the message should be rendered. One of `\"reply\"`, `\"direct\"`, or `\"inline\"`. `null` for user-authored messages, which are always rendered as standard replies."),
+    rendering_mode: z.string().nullable().optional().describe("Display hint for how the message should be rendered. One of `\"reply\"`, `\"direct\"`, or `\"inline\"`. `null` for user-authored messages, which are always rendered as standard replies."),
     /** Inline array of reply messages, each serialized as a full message object. Only present when the server has preloaded replies for this message. */
     replies: z.array(z.record(z.unknown())).optional().describe("Inline array of reply messages, each serialized as a full message object. Only present when the server has preloaded replies for this message."),
     /** Opaque pagination cursor to fetch replies posted after the current page. Only present when inline replies are included in the response. */
-    replies_after_cursor: z.string().optional().describe("Opaque pagination cursor to fetch replies posted after the current page. Only present when inline replies are included in the response."),
+    replies_after_cursor: z.string().nullable().optional().describe("Opaque pagination cursor to fetch replies posted after the current page. Only present when inline replies are included in the response."),
     /** Opaque pagination cursor to fetch replies posted before the current page. Only present when inline replies are included in the response. */
-    replies_before_cursor: z.string().optional().describe("Opaque pagination cursor to fetch replies posted before the current page. Only present when inline replies are included in the response."),
+    replies_before_cursor: z.string().nullable().optional().describe("Opaque pagination cursor to fetch replies posted before the current page. Only present when inline replies are included in the response."),
     /** Total number of direct replies to this message. Only present when explicitly requested or computed by the server. */
     reply_count: z.number().int().optional().describe("Total number of direct replies to this message. Only present when explicitly requested or computed by the server."),
     /** The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded. */
-    reply_to: z.record(z.unknown()).optional().describe("The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded."),
+    reply_to: z.record(z.unknown()).nullable().optional().describe("The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded."),
     /** ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages. */
     root_message_id: z.string().nullable().optional().describe("ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages."),
     /** ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages. */
-    sandbox: z.string().optional().describe("ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages."),
+    sandbox: z.string().nullable().optional().describe("ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages."),
     /** ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped. */
-    team: z.string().optional().describe("ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped."),
-    /** ID of the thread this message belongs to (`thr_...`). `null` for messages not yet associated with a thread. */
-    thread: z.string().optional().describe("ID of the thread this message belongs to (`thr_...`). `null` for messages not yet associated with a thread."),
+    team: z.string().nullable().optional().describe("ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped."),
+    /** ID of the thread this message belongs to (`thr_...`). */
+    thread: z.string().optional().describe("ID of the thread this message belongs to (`thr_...`)."),
     /** Optional client-defined classification for the message (for example `note` or `status`). Free-form string up to 64 characters. The value `system` is reserved for platform-authored messages and cannot be set by clients. `null` when unset. */
-    type: z.string().optional().describe("Optional client-defined classification for the message (for example `note` or `status`). Free-form string up to 64 characters. The value `system` is reserved for platform-authored messages and cannot be set by clients. `null` when unset."),
+    type: z.string().nullable().optional().describe("Optional client-defined classification for the message (for example `note` or `status`). Free-form string up to 64 characters. The value `system` is reserved for platform-authored messages and cannot be set by clients. `null` when unset."),
     /** The human user who sent this message. Returns a public ID string (`usr_...`) when the association is not preloaded, or an expanded user object when it is. `null` for messages sent by agents. */
-    user: z.string().optional().describe("The human user who sent this message. Returns a public ID string (`usr_...`) when the association is not preloaded, or an expanded user object when it is. `null` for messages sent by agents."),
+    user: z.union([z.string(), z.object({ alias: z.string().nullable().optional(), app: z.string().nullable().optional(), app_name: z.string().nullable().optional(), created_by_agent_user: z.string().nullable().optional(), created_by_developer: z.string().nullable().optional(), created_by_org: z.string().nullable().optional(), created_by_team: z.string().nullable().optional(), created_by_user: z.string().nullable().optional(), email: z.string().nullable().optional(), id: z.string(), is_system_user: z.boolean().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_name: z.string().nullable().optional(), org_role: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), sandbox: z.string().nullable().optional(), sandbox_name: z.string().nullable().optional() })]).nullable().optional().describe("The human user who sent this message. Returns a public ID string (`usr_...`) when the association is not preloaded, or an expanded user object when it is. `null` for messages sent by agents."),
     /** Message-level visibility. `default` is visible to anyone who can see the parent thread. `private` is restricted to the sender and explicit ACL `read` grantees. */
     visibility: z.enum(["default", "private"]).optional().describe("Message-level visibility. `default` is visible to anyone who can see the parent thread. `private` is restricted to the sender and explicit ACL `read` grantees."),
 }).describe("A chat message posted in a thread, including its content, author, attachments, reactions, and optional reply metadata.");
+/** Runtime validator for {@link Ok}. */
+export const okSchema = z.object({
+    call_id: z.string(),
+    content: z.string(),
+    status: z.literal("ok"),
+}).describe("A successful local-tool outcome.");
+/** Runtime validator for {@link Error}. */
+export const errorSchema = z.object({
+    call_id: z.string(),
+    code: z.string(),
+    message: z.string(),
+    status: z.literal("error"),
+}).describe("A failed local-tool outcome.");
 /** Runtime validator for {@link ComputerExecResult}. */
 export const computerExecResultSchema = z.object({
     /** The UNIX exit code returned by the process. `0` indicates success; any non-zero value indicates an error. `null` if the process did not terminate normally. */
@@ -553,6 +585,91 @@ export const deploymentSchema = z.object({
     /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
     release: z.string().nullable().optional().describe("Opaque SHA-256 fingerprint of the image reference, or `null` in local development."),
 }).describe("Deployment metadata.");
+/** Runtime validator for {@link DomainEvent}. */
+export const domainEventSchema = z.object({
+    agent: z.string().optional(),
+    created_at: z.string(),
+    event_name: z.string(),
+    id: z.string(),
+    idempotency_key: z.string().optional(),
+    org: z.string().optional(),
+    /** Opaque event-specific JSON. Use event_name to select the expected payload schema. */
+    payload: z.record(z.unknown()).describe("Opaque event-specific JSON. Use event_name to select the expected payload schema."),
+    sandbox: z.string().optional(),
+    team: z.string().optional(),
+    user: z.string().optional(),
+}).describe("A domain event with stable attribution fields and an event-specific payload.");
+/** Runtime validator for {@link EventSubscription}. */
+export const eventSubscriptionSchema = z.object({
+    agent: z.string().optional(),
+    available_count: z.number().int(),
+    created_at: z.string(),
+    dropped_events_total: z.number().int(),
+    dropped_through_position: z.number().int(),
+    event_names: z.array(z.string()),
+    id: z.string(),
+    last_overflow_at: z.string().optional(),
+    leased_count: z.number().int(),
+    max_pending_events: z.number().int(),
+    name: z.string(),
+    org: z.string().optional(),
+    queue_epoch: z.number().int(),
+    retention_seconds: z.number().int(),
+    sandbox: z.string().optional(),
+    status: z.enum(["active", "paused"]),
+    team: z.string().optional(),
+    updated_at: z.string(),
+    user: z.string().optional(),
+    visibility_timeout_seconds: z.number().int(),
+}).describe("An app-scoped subscription to exact domain-event names.");
+/** Runtime validator for {@link EventSubscriptionDelivery}. */
+export const eventSubscriptionDeliverySchema = z.object({
+    delivery_id: z.string(),
+    event: domainEventSchema,
+    lease_expires_at: z.string(),
+    receipt_handle: z.string(),
+    receive_count: z.number().int(),
+    sequence: z.number().int(),
+}).describe("A domain event leased from a subscription queue.");
+/** Runtime validator for {@link EventSubscriptionClaim}. */
+export const eventSubscriptionClaimSchema = z.object({
+    data: z.array(eventSubscriptionDeliverySchema),
+    dropped_events_total: z.number().int(),
+    dropped_through_position: z.number().int(),
+    has_more: z.boolean(),
+    queue_epoch: z.number().int(),
+}).describe("Result of atomically claiming the head delivery.");
+/** Runtime validator for {@link EventSubscriptionQueueEntry}. */
+export const eventSubscriptionQueueEntrySchema = z.object({
+    delivery_id: z.string(),
+    event: domainEventSchema,
+    lease_expires_at: z.string().optional(),
+    receive_count: z.number().int(),
+    sequence: z.number().int(),
+    state: z.enum(["available", "leased"]),
+}).describe("A non-reserving view of one queued delivery.");
+/** Runtime validator for {@link EventSubscriptionHead}. */
+export const eventSubscriptionHeadSchema = z.object({
+    data: eventSubscriptionQueueEntrySchema.optional(),
+}).describe("A non-reserving view of the queue head.");
+/** Runtime validator for {@link EventSubscriptionPage}. */
+export const eventSubscriptionPageSchema = z.object({
+    data: z.array(eventSubscriptionSchema),
+    page: z.number().int(),
+    per_page: z.number().int(),
+    total_count: z.number().int(),
+    total_pages: z.number().int(),
+}).describe("A page of domain-event subscriptions.");
+/** Runtime validator for {@link EventSubscriptionQueue}. */
+export const eventSubscriptionQueueSchema = z.object({
+    after_cursor: z.string().optional(),
+    before_cursor: z.string().optional(),
+    data: z.array(eventSubscriptionQueueEntrySchema),
+    dropped_events_total: z.number().int(),
+    dropped_through_position: z.number().int(),
+    has_more: z.boolean(),
+    queue_epoch: z.number().int(),
+}).describe("A cursor-paginated non-reserving view of a subscription queue.");
 /** Runtime validator for {@link StorageFile}. */
 export const storageFileSchema = z.object({
     /** ID of the app this file belongs to (`app_...`). */
@@ -868,6 +985,24 @@ export const privateServicePageSchema = z.object({
     total_entries: z.number().int(),
     total_pages: z.number().int(),
 }).describe("A page of private services.");
+/** Runtime validator for {@link ProductKnowledgeReconcileFailure}. */
+export const productKnowledgeReconcileFailureSchema = z.object({
+    /** Stable vendor-defined key for the customer whose agent did not converge. */
+    customer_key: z.string().describe("Stable vendor-defined key for the customer whose agent did not converge."),
+    /** Stable failure reason for operator and vendor feedback. */
+    error: z.string().describe("Stable failure reason for operator and vendor feedback."),
+    /** Whether rerunning the desired-state reconciliation is safe. */
+    retryable: z.boolean().describe("Whether rerunning the desired-state reconciliation is safe."),
+}).describe("One stamped customer whose product-knowledge tool update did not converge.");
+/** Runtime validator for {@link ProductKnowledgeReconcileResponse}. */
+export const productKnowledgeReconcileResponseSchema = z.object({
+    /** True when every stamped customer agent now has the desired source allowlist. */
+    complete: z.boolean().describe("True when every stamped customer agent now has the desired source allowlist."),
+    /** Per-customer failures. Empty when reconciliation is complete. */
+    failures: z.array(productKnowledgeReconcileFailureSchema).describe("Per-customer failures. Empty when reconciliation is complete."),
+    /** Customer keys whose agent tool config is converged. */
+    reconciled_customers: z.array(z.string()).describe("Customer keys whose agent tool config is converged."),
+}).describe("Desired-state reconciliation result for a CM install's stamped agents.");
 /** Runtime validator for {@link RoutinePreset}. */
 export const routinePresetSchema = z.object({
     /** Event types that routines using this preset may be triggered by. `["*"]` means the preset accepts any event type. Routines assigned to this preset will be rejected at creation time if their trigger event is not in this list. */
@@ -939,17 +1074,17 @@ export const sandboxKeySchema = z.object({
     /** When this key was created (ISO 8601). */
     created_at: z.string().optional().describe("When this key was created (ISO 8601)."),
     /** When this key expires and becomes invalid. `null` if the key does not expire. */
-    expires_at: z.string().optional().describe("When this key expires and becomes invalid. `null` if the key does not expire."),
+    expires_at: z.string().nullable().optional().describe("When this key expires and becomes invalid. `null` if the key does not expire."),
     /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
     full_key: z.string().optional().describe("The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals."),
     /** Sandbox key ID (`dsk_...`). */
     id: z.string().describe("Sandbox key ID (`dsk_...`)."),
     /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
-    key_hint: z.string().optional().describe("A short hint showing the last four characters of the key, used for identification. `null` if no hint is available."),
+    key_hint: z.string().nullable().optional().describe("A short hint showing the last four characters of the key, used for identification. `null` if no hint is available."),
     /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
-    key_value: z.string().optional().describe("The full key value for `\"publishable\"` keys. `null` for `\"secret\"` keys; use `full_key` instead, which is returned only at creation time."),
+    key_value: z.string().nullable().optional().describe("The full key value for `\"publishable\"` keys. `null` for `\"secret\"` keys; use `full_key` instead, which is returned only at creation time."),
     /** When this key was last used to authenticate a request. `null` if the key has never been used. */
-    last_used_at: z.string().optional().describe("When this key was last used to authenticate a request. `null` if the key has never been used."),
+    last_used_at: z.string().nullable().optional().describe("When this key was last used to authenticate a request. `null` if the key has never been used."),
     /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
     status: z.string().describe("Current lifecycle status of the key. One of `\"active\"` (usable) or `\"revoked\"` (permanently disabled)."),
     /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
@@ -960,7 +1095,7 @@ export const sandboxSchema = z.object({
     /** When this sandbox was created (ISO 8601). */
     created_at: z.string().optional().describe("When this sandbox was created (ISO 8601)."),
     /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
-    expires_at: z.string().optional().describe("When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes."),
+    expires_at: z.string().nullable().optional().describe("When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes."),
     /** Sandbox ID (`dsb_...`). */
     id: z.string().describe("Sandbox ID (`dsb_...`)."),
     /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
@@ -968,13 +1103,13 @@ export const sandboxSchema = z.object({
     /** Human-readable display name for the sandbox. */
     name: z.string().describe("Human-readable display name for the sandbox."),
     /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
-    org: z.string().optional().describe("Organization ID this sandbox is scoped to, or `null` for an app-level sandbox."),
+    org: z.string().nullable().optional().describe("Organization ID this sandbox is scoped to, or `null` for an app-level sandbox."),
     /** Logo of the owning organization, when present. */
-    org_logo: imageSourceSchema.optional().describe("Logo of the owning organization, when present."),
+    org_logo: imageSourceSchema.nullable().optional().describe("Logo of the owning organization, when present."),
     /** Display name of the owning organization, when org-scoped. */
-    org_name: z.string().optional().describe("Display name of the owning organization, when org-scoped."),
+    org_name: z.string().nullable().optional().describe("Display name of the owning organization, when org-scoped."),
     /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
-    purpose: z.string().optional().describe("Sandbox purpose marker. `\"eval\"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes."),
+    purpose: z.string().nullable().optional().describe("Sandbox purpose marker. `\"eval\"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes."),
     /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
     slug: z.string().describe("URL-safe identifier for the sandbox, unique within the application (e.g. `\"my-sandbox\"`)."),
     /** When this sandbox was last modified (ISO 8601). */
@@ -1052,8 +1187,8 @@ export const slackDeliveryOutcomeSchema = z.object({
     id: z.string().describe("Unique identifier for this delivery outcome."),
     /** ID of the platform message this attempt was carrying. Reading that message still requires access to its thread — this field correlates, it does not grant. */
     message: z.string().optional().describe("ID of the platform message this attempt was carrying. Reading that message still requires access to its thread — this field correlates, it does not grant."),
-    /** Whether the attempt posted a new Slack message or updated an existing one (replacing a thinking placeholder). */
-    operation: z.enum(["post", "update"]).describe("Whether the attempt posted a new Slack message or updated an existing one (replacing a thinking placeholder)."),
+    /** Which Slack call the attempt made. `post` — a new message in the channel, visible to everyone in it. `post_ephemeral` — a message only one named channel member could see; Slack returns no durable timestamp for one, so it has no `thread_ts` to correlate and cannot be found in the channel's history afterwards. `update` — replacing an existing message (typically a thinking placeholder). */
+    operation: z.enum(["post", "post_ephemeral", "update"]).describe("Which Slack call the attempt made. `post` — a new message in the channel, visible to everyone in it. `post_ephemeral` — a message only one named channel member could see; Slack returns no durable timestamp for one, so it has no `thread_ts` to correlate and cannot be found in the channel's history afterwards. `update` — replacing an existing message (typically a thinking placeholder)."),
     /** What happened to the send. `delivered` — Slack accepted the message. `floored` — a deterministic content guard withheld it, so it never left. `judge_refused` — the cross-org judge decided it was not appropriate for this channel's audience. `failed` — Slack rejected the call, or the content floor could not be evaluated and the send failed closed. */
     outcome: z.enum(["delivered", "floored", "judge_refused", "failed"]).describe("What happened to the send. `delivered` — Slack accepted the message. `floored` — a deterministic content guard withheld it, so it never left. `judge_refused` — the cross-org judge decided it was not appropriate for this channel's audience. `failed` — Slack rejected the call, or the content floor could not be evaluated and the send failed closed."),
     /** When the send was attempted. */
@@ -1076,18 +1211,18 @@ export const slackDeliveryOutcomeListResponseSchema = z.object({
 export const trajectorySchema = z.object({
     /** When the trajectory was recorded (ISO 8601). */
     created_at: z.string().optional().describe("When the trajectory was recorded (ISO 8601)."),
-    /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
-    file: z.string().optional().describe("ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file."),
+    /** ID of the storage file that persists the raw trajectory data (`fil_...`). */
+    file: z.string().optional().describe("ID of the storage file that persists the raw trajectory data (`fil_...`)."),
     /** Trajectory ID (`trj_...`). */
     id: z.string().describe("Trajectory ID (`trj_...`)."),
     /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
-    messages: z.record(z.unknown()).optional().describe("Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session."),
+    messages: z.array(z.record(z.unknown())).optional().describe("Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session."),
     /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
-    org: z.string().optional().describe("ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context."),
+    org: z.string().nullable().optional().describe("ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context."),
     /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
-    sandbox: z.string().optional().describe("ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories."),
+    sandbox: z.string().nullable().optional().describe("ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories."),
     /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
-    team: z.string().optional().describe("ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team."),
+    team: z.string().nullable().optional().describe("ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team."),
     /** When the trajectory record was last updated (ISO 8601). */
     updated_at: z.string().optional().describe("When the trajectory record was last updated (ISO 8601)."),
 }).describe("A recorded sequence of AI messages and tool interactions representing a single AI reasoning session. Trajectories are stored as structured message logs and can be replayed or inspected after execution.");
@@ -1187,18 +1322,18 @@ export const workingMemoryEntryListResponseSchema = z.object({
 /** Runtime validator for {@link SolutionAutomationInvokeContract}. */
 export const solutionAutomationInvokeContractSchema = z.object({
     /** JSON Schema validated against the whole invoke payload, from the automation's `input_schema_config`. `null` when none is configured. */
-    input_schema: z.record(z.unknown()).optional().describe("JSON Schema validated against the whole invoke payload, from the automation's `input_schema_config`. `null` when none is configured."),
+    input_schema: z.record(z.unknown()).nullable().optional().describe("JSON Schema validated against the whole invoke payload, from the automation's `input_schema_config`. `null` when none is configured."),
     /** Named participant slots declared by the workflow, sorted by name. `null` when the workflow declares none. Values supplied under the top-level `participants` field are agent IDs. */
-    participants: z.array(automationParticipantSlotSchema).optional().describe("Named participant slots declared by the workflow, sorted by name. `null` when the workflow declares none. Values supplied under the top-level `participants` field are agent IDs."),
+    participants: z.array(automationParticipantSlotSchema).nullable().optional().describe("Named participant slots declared by the workflow, sorted by name. `null` when the workflow declares none. Values supplied under the top-level `participants` field are agent IDs."),
     /** Owner-controlled payload and participant values the platform applies to every invocation. Supplying a conflicting value is rejected. */
     prefills: automationPrefillsSchema.describe("Owner-controlled payload and participant values the platform applies to every invocation. Supplying a conflicting value is rejected."),
 }).describe("The schema-driven values an installer may lock when provisioning an invoked automation template.");
 /** Runtime validator for {@link SolutionAutomationTemplateDetails}. */
 export const solutionAutomationTemplateDetailsSchema = z.object({
-    /** Automation execution type (`invoked`, `scheduled`, or `trigger`). */
-    automation_type: z.string().optional().describe("Automation execution type (`invoked`, `scheduled`, or `trigger`)."),
-    /** Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning. */
-    invoke_contract: solutionAutomationInvokeContractSchema.optional().describe("Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning."),
+    /** Automation execution type (`invoked`, `scheduled`, or `trigger`). `null` when the template body does not declare one. */
+    automation_type: z.string().nullable().optional().describe("Automation execution type (`invoked`, `scheduled`, or `trigger`). `null` when the template body does not declare one."),
+    /** Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning. `null` for non-invoked automation types. */
+    invoke_contract: solutionAutomationInvokeContractSchema.nullable().optional().describe("Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning. `null` for non-invoked automation types."),
     /** Template-details discriminator. Always `automation` for this variant. */
     type: z.literal("automation").describe("Template-details discriminator. Always `automation` for this variant."),
 }).describe("AutomationTemplate-specific details exposed by a Solution template summary.");
@@ -1207,23 +1342,23 @@ export const solutionTemplateDetailsSchema = z.discriminatedUnion("type", [solut
 /** Runtime validator for {@link SolutionTemplateSummary}. */
 export const solutionTemplateSummarySchema = z.object({
     /** Short prose blurb from the template body's `description:` field. `null` when the body doesn't set one. Used as the card subhead in the Library carousel. */
-    description: z.string().optional().describe("Short prose blurb from the template body's `description:` field. `null` when the body doesn't set one. Used as the card subhead in the Library carousel."),
+    description: z.string().nullable().optional().describe("Short prose blurb from the template body's `description:` field. `null` when the body doesn't set one. Used as the card subhead in the Library carousel."),
     /** Template-kind-specific details selected by the `type` discriminator. `null` when this template kind has no additional details. */
-    details: solutionTemplateDetailsSchema.optional().describe("Template-kind-specific details selected by the `type` discriminator. `null` when this template kind has no additional details."),
+    details: solutionTemplateDetailsSchema.nullable().optional().describe("Template-kind-specific details selected by the `type` discriminator. `null` when this template kind has no additional details."),
     /** Human-facing label from the template body's `display_name:` field. `null` when the body doesn't set one. Library carousels use this for the card title, falling back to a humanized `name`. */
-    display_name: z.string().optional().describe("Human-facing label from the template body's `display_name:` field. `null` when the body doesn't set one. Library carousels use this for the card title, falling back to a humanized `name`."),
+    display_name: z.string().nullable().optional().describe("Human-facing label from the template body's `display_name:` field. `null` when the body doesn't set one. Library carousels use this for the card title, falling back to a humanized `name`."),
     /** Template config ID (`cfg_...`). `null` for inline-only templates. */
-    id: z.string().optional().describe("Template config ID (`cfg_...`). `null` for inline-only templates."),
+    id: z.string().nullable().optional().describe("Template config ID (`cfg_...`). `null` for inline-only templates."),
     /** Template config kind, or `SolutionTemplateRef` / `SolutionTemplatePath` when unresolved. */
     kind: z.string().describe("Template config kind, or `SolutionTemplateRef` / `SolutionTemplatePath` when unresolved."),
     /** Lookup key stamped on the template config at import time. `null` when no lookup key was assigned. */
-    lookup_key: z.string().optional().describe("Lookup key stamped on the template config at import time. `null` when no lookup key was assigned."),
+    lookup_key: z.string().nullable().optional().describe("Lookup key stamped on the template config at import time. `null` when no lookup key was assigned."),
     /** Canonical name from the template body. For `AgentTemplate` this doubles as the human-facing label; for `AgentToolTemplate` it's the LLM-facing tool function identifier (snake_case); for `AgentRoutineTemplate` it's the routine identifier (kebab-case). Clients rendering carousels should prefer `display_name` and fall back to humanizing `name`. */
-    name: z.string().optional().describe("Canonical name from the template body. For `AgentTemplate` this doubles as the human-facing label; for `AgentToolTemplate` it's the LLM-facing tool function identifier (snake_case); for `AgentRoutineTemplate` it's the routine identifier (kebab-case). Clients rendering carousels should prefer `display_name` and fall back to humanizing `name`."),
+    name: z.string().nullable().optional().describe("Canonical name from the template body. For `AgentTemplate` this doubles as the human-facing label; for `AgentToolTemplate` it's the LLM-facing tool function identifier (snake_case); for `AgentRoutineTemplate` it's the routine identifier (kebab-case). Clients rendering carousels should prefer `display_name` and fall back to humanizing `name`."),
     /** Relative path to the public README endpoint with a signed token already embedded, scoped to this template's bundled markdown asset. `null` when the Solution body's `templates[].readme_path` is unset for this entry. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`. */
-    readme_url: z.string().optional().describe("Relative path to the public README endpoint with a signed token already embedded, scoped to this template's bundled markdown asset. `null` when the Solution body's `templates[].readme_path` is unset for this entry. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`."),
+    readme_url: z.string().nullable().optional().describe("Relative path to the public README endpoint with a signed token already embedded, scoped to this template's bundled markdown asset. `null` when the Solution body's `templates[].readme_path` is unset for this entry. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`."),
     /** Stable virtual path assigned to the template config. `null` when no virtual path was set. */
-    virtual_path: z.string().optional().describe("Stable virtual path assigned to the template config. `null` when no virtual path was set."),
+    virtual_path: z.string().nullable().optional().describe("Stable virtual path assigned to the template config. `null` when no virtual path was set."),
 }).describe("Identity and display metadata for a single template bundled by a Solution, used to represent each wrapped or sibling template at template granularity.");
 /** Runtime validator for {@link SolutionSummary}. */
 export const solutionSummarySchema = z.object({
@@ -1232,47 +1367,47 @@ export const solutionSummarySchema = z.object({
     /** When the Solution config was first imported (ISO 8601). */
     created_at: z.string().optional().describe("When the Solution config was first imported (ISO 8601)."),
     /** Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. `null` when the Solution body does not set one. */
-    description: z.string().optional().describe("Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. `null` when the Solution body does not set one."),
+    description: z.string().nullable().optional().describe("Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. `null` when the Solution body does not set one."),
     /** Custom analytics events declared in the Solution body's `events:` manifest — a map of event key (snake_case) to its definition (`label`, optional `description`, optional typed `fields`). Dashboards use the `label` as the event's display name. Present as an empty object when the body declares none. */
     events: z.record(z.unknown()).optional().describe("Custom analytics events declared in the Solution body's `events:` manifest — a map of event key (snake_case) to its definition (`label`, optional `description`, optional typed `fields`). Dashboards use the `label` as the event's display name. Present as an empty object when the body declares none."),
     /** Solution config ID (`cfg_...`). */
     id: z.string().describe("Solution config ID (`cfg_...`)."),
     /** Absolute URL of the Solution's cover image — the bundled asset the body's `image:` field names. A stable, non-expiring capability URL (like `org_logo.url`), safe to hold in caches and OpenGraph tags; it 404s if the Solution stops declaring a cover. `null` when the Solution has no cover image, and always `null` for org-scoped rows — the permanent URL is minted for system-scope (catalog) Solutions only. */
-    image_url: z.string().optional().describe("Absolute URL of the Solution's cover image — the bundled asset the body's `image:` field names. A stable, non-expiring capability URL (like `org_logo.url`), safe to hold in caches and OpenGraph tags; it 404s if the Solution stops declaring a cover. `null` when the Solution has no cover image, and always `null` for org-scoped rows — the permanent URL is minted for system-scope (catalog) Solutions only."),
+    image_url: z.string().nullable().optional().describe("Absolute URL of the Solution's cover image — the bundled asset the body's `image:` field names. A stable, non-expiring capability URL (like `org_logo.url`), safe to hold in caches and OpenGraph tags; it 404s if the Solution stops declaring a cover. `null` when the Solution has no cover image, and always `null` for org-scoped rows — the permanent URL is minted for system-scope (catalog) Solutions only."),
     /** Resource type. Always `"Solution"`. */
     kind: z.string().describe("Resource type. Always `\"Solution\"`."),
     /** When `upgrade_available` is `true`, the system-scope Solution config ID (`cfg_...`) that should be used as the upgrade source. `null` otherwise. */
-    latest_solution: z.string().optional().describe("When `upgrade_available` is `true`, the system-scope Solution config ID (`cfg_...`) that should be used as the upgrade source. `null` otherwise."),
+    latest_solution: z.string().nullable().optional().describe("When `upgrade_available` is `true`, the system-scope Solution config ID (`cfg_...`) that should be used as the upgrade source. `null` otherwise."),
     /** When `upgrade_available` is `true`, the higher system-scope `solution_version` available to upgrade to. `null` otherwise. */
-    latest_version: z.string().optional().describe("When `upgrade_available` is `true`, the higher system-scope `solution_version` available to upgrade to. `null` otherwise."),
+    latest_version: z.string().nullable().optional().describe("When `upgrade_available` is `true`, the higher system-scope `solution_version` available to upgrade to. `null` otherwise."),
     /** The lookup key stored on the Solution config, if one was assigned during import. `null` when no lookup key was set. */
-    lookup_key: z.string().optional().describe("The lookup key stored on the Solution config, if one was assigned during import. `null` when no lookup key was set."),
+    lookup_key: z.string().nullable().optional().describe("The lookup key stored on the Solution config, if one was assigned during import. `null` when no lookup key was set."),
     /** Arbitrary key-value metadata declared in the Solution body (e.g. category or display hints). Present as an empty object when the body declares none. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata declared in the Solution body (e.g. category or display hints). Present as an empty object when the body declares none."),
     /** Human-facing display name declared in the Solution body. `null` when the Solution body does not set one. */
-    name: z.string().optional().describe("Human-facing display name declared in the Solution body. `null` when the Solution body does not set one."),
+    name: z.string().nullable().optional().describe("Human-facing display name declared in the Solution body. `null` when the Solution body does not set one."),
     /** Organization ID (`org_...`) that owns this Solution config, when the Solution is scoped to a specific org. `null` for system-scope (app-level) Solutions. */
-    org: z.string().optional().describe("Organization ID (`org_...`) that owns this Solution config, when the Solution is scoped to a specific org. `null` for system-scope (app-level) Solutions."),
+    org: z.string().nullable().optional().describe("Organization ID (`org_...`) that owns this Solution config, when the Solution is scoped to a specific org. `null` for system-scope (app-level) Solutions."),
     /** Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. The `url` is a stable, non-expiring capability URL (`refresh_url` is `null` — there is nothing to refresh). `null` when `org_slug` is `null` or the org has no logo. */
-    org_logo: imageSourceSchema.optional().describe("Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. The `url` is a stable, non-expiring capability URL (`refresh_url` is `null` — there is nothing to refresh). `null` when `org_slug` is `null` or the org has no logo."),
+    org_logo: imageSourceSchema.nullable().optional().describe("Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. The `url` is a stable, non-expiring capability URL (`refresh_url` is `null` — there is nothing to refresh). `null` when `org_slug` is `null` or the org has no logo."),
     /** Display name of the resolved `org`. Pairs with `org_slug` as the principal catalog category's label. `null` when `org_slug` is `null`. */
-    org_name: z.string().optional().describe("Display name of the resolved `org`. Pairs with `org_slug` as the principal catalog category's label. `null` when `org_slug` is `null`."),
+    org_name: z.string().nullable().optional().describe("Display name of the resolved `org`. Pairs with `org_slug` as the principal catalog category's label. `null` when `org_slug` is `null`."),
     /** Resolved slug of the Solution body's `org` (the publishing organization), when set and it resolves to a real org visible to the viewer. When present this is the Solution's principal catalog category key — clients group the Solution under this org ahead of `category_keys`. `null` when the body has no `org` or it doesn't resolve. */
-    org_slug: z.string().optional().describe("Resolved slug of the Solution body's `org` (the publishing organization), when set and it resolves to a real org visible to the viewer. When present this is the Solution's principal catalog category key — clients group the Solution under this org ahead of `category_keys`. `null` when the body has no `org` or it doesn't resolve."),
+    org_slug: z.string().nullable().optional().describe("Resolved slug of the Solution body's `org` (the publishing organization), when set and it resolves to a real org visible to the viewer. When present this is the Solution's principal catalog category key — clients group the Solution under this org ahead of `category_keys`. `null` when the body has no `org` or it doesn't resolve."),
     /** Owner scopes this Solution appears under. Members: `"system"` (app-level system scope) and/or `"org"` (viewer's org scope). */
     owners: z.array(z.string()).describe("Owner scopes this Solution appears under. Members: `\"system\"` (app-level system scope) and/or `\"org\"` (viewer's org scope)."),
     /** Relative path to the public README endpoint with a signed token already embedded. `null` when the Solution has no README. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`. */
-    readme_url: z.string().optional().describe("Relative path to the public README endpoint with a signed token already embedded. `null` when the Solution has no README. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`."),
+    readme_url: z.string().nullable().optional().describe("Relative path to the public README endpoint with a signed token already embedded. `null` when the Solution has no README. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`."),
     /** Absolute URLs of the Solution's gallery screenshots — the bundled assets the body's `screenshots:` field names, in declared order. Each is a stable, non-expiring capability URL with the same cacheability contract as `image_url` (one shared token, a `v` cache key, and a `file` param selecting the screenshot); a URL 404s if the Solution stops declaring its screenshot. An empty array when the Solution declares none, and always empty for org-scoped rows — the permanent URLs are minted for system-scope (catalog) Solutions only. */
     screenshot_urls: z.array(z.string()).optional().describe("Absolute URLs of the Solution's gallery screenshots — the bundled assets the body's `screenshots:` field names, in declared order. Each is a stable, non-expiring capability URL with the same cacheability contract as `image_url` (one shared token, a `v` cache key, and a `file` param selecting the screenshot); a URL 404s if the Solution stops declaring its screenshot. An empty array when the Solution declares none, and always empty for org-scoped rows — the permanent URLs are minted for system-scope (catalog) Solutions only."),
     /** Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. `null` when the body omits it. */
-    solution_id: z.string().optional().describe("Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. `null` when the body omits it."),
+    solution_id: z.string().nullable().optional().describe("Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. `null` when the body omits it."),
     /** Semver string declared in the Solution body (e.g. `"1.2.0"`). `null` when the body does not declare a version. */
-    solution_version: z.string().optional().describe("Semver string declared in the Solution body (e.g. `\"1.2.0\"`). `null` when the body does not declare a version."),
+    solution_version: z.string().nullable().optional().describe("Semver string declared in the Solution body (e.g. `\"1.2.0\"`). `null` when the body does not declare a version."),
     /** Freeform tag keys declared in the Solution body. An empty array when the body declares none. */
     tag_keys: z.array(z.string()).optional().describe("Freeform tag keys declared in the Solution body. An empty array when the body declares none."),
     /** Wrapped template kind — `"AgentTemplate"`, `"AutomationTemplate"`, `"AgentRoutineTemplate"`, `"AgentToolTemplate"`, `"AgentComputerTemplate"`, or `"SolutionTemplateRef"` for ref-mode bundles. */
-    template_kind: z.string().optional().describe("Wrapped template kind — `\"AgentTemplate\"`, `\"AutomationTemplate\"`, `\"AgentRoutineTemplate\"`, `\"AgentToolTemplate\"`, `\"AgentComputerTemplate\"`, or `\"SolutionTemplateRef\"` for ref-mode bundles."),
+    template_kind: z.string().nullable().optional().describe("Wrapped template kind — `\"AgentTemplate\"`, `\"AutomationTemplate\"`, `\"AgentRoutineTemplate\"`, `\"AgentToolTemplate\"`, `\"AgentComputerTemplate\"`, or `\"SolutionTemplateRef\"` for ref-mode bundles."),
     /** Template configs bundled by this Solution, in declaration order — the first entry is the deployable template the Solution wraps; the rest are sibling templates the wrapped template references. */
     templates: z.array(solutionTemplateSummarySchema).describe("Template configs bundled by this Solution, in declaration order — the first entry is the deployable template the Solution wraps; the rest are sibling templates the wrapped template references."),
     /** When the Solution config was last modified (ISO 8601). */
@@ -1280,7 +1415,7 @@ export const solutionSummarySchema = z.object({
     /** `true` when this Solution is installed at the viewer's org scope and the app-level system scope carries a higher `solution_version`. Always `false` for system-only rows. */
     upgrade_available: z.boolean().describe("`true` when this Solution is installed at the viewer's org scope and the app-level system scope carries a higher `solution_version`. Always `false` for system-only rows."),
     /** The stable virtual path assigned to this Solution config, used as the deduplication key when the same Solution appears under multiple owner scopes. `null` when unset. */
-    virtual_path: z.string().optional().describe("The stable virtual path assigned to this Solution config, used as the deduplication key when the same Solution appears under multiple owner scopes. `null` when unset."),
+    virtual_path: z.string().nullable().optional().describe("The stable virtual path assigned to this Solution config, used as the deduplication key when the same Solution appears under multiple owner scopes. `null` when unset."),
 }).describe("A catalog entry for an imported Solution, including its display metadata, bundled templates, owner scopes, and any available upgrade information.");
 /** Runtime validator for {@link AgentSourceSolution}. */
 export const agentSourceSolutionSchema = z.object({
@@ -1294,49 +1429,49 @@ export const agentSourceSolutionSchema = z.object({
 /** Runtime validator for {@link Agent}. */
 export const agentSchema = z.object({
     /** Access control list for the agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the agent is accessible to all members of its scope. */
-    acl: aclSchema.optional().describe("Access control list for the agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the agent is accessible to all members of its scope."),
+    acl: aclSchema.nullable().optional().describe("Access control list for the agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the agent is accessible to all members of its scope."),
     /** ID of the application that owns this agent (`dap_...`). */
     app: z.string().optional().describe("ID of the application that owns this agent (`dap_...`)."),
     /** When the agent was created (ISO 8601). */
     created_at: z.string().optional().describe("When the agent was created (ISO 8601)."),
     /** Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `"claude-3-7-sonnet-latest"`). */
-    default_model: z.string().optional().describe("Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `\"claude-3-7-sonnet-latest\"`)."),
+    default_model: z.string().nullable().optional().describe("Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `\"claude-3-7-sonnet-latest\"`)."),
     /** Human-readable description of what the agent does. `null` if not set. */
-    description: z.string().optional().describe("Human-readable description of what the agent does. `null` if not set."),
+    description: z.string().nullable().optional().describe("Human-readable description of what the agent does. `null` if not set."),
     /** Email address provisioned for this agent. `null` if email delivery is not configured. */
-    email: z.string().optional().describe("Email address provisioned for this agent. `null` if email delivery is not configured."),
+    email: z.string().nullable().optional().describe("Email address provisioned for this agent. `null` if email delivery is not configured."),
     /** Agent ID (`agi_...`). */
     id: z.string().describe("Agent ID (`agi_...`)."),
     /** System-level identity prompt that shapes the agent's persona and behavior. */
-    identity: z.string().optional().describe("System-level identity prompt that shapes the agent's persona and behavior."),
+    identity: z.string().nullable().optional().describe("System-level identity prompt that shapes the agent's persona and behavior."),
     /** ID of the AgentTemplate config (`cfg_...`) this agent was last provisioned or updated from. `null` for manually created agents. */
-    last_applied_template_config: z.string().optional().describe("ID of the AgentTemplate config (`cfg_...`) this agent was last provisioned or updated from. `null` for manually created agents."),
+    last_applied_template_config: z.string().nullable().optional().describe("ID of the AgentTemplate config (`cfg_...`) this agent was last provisioned or updated from. `null` for manually created agents."),
     /** Stable, user-defined identifier for this agent within the application. Unique per app. */
-    lookup_key: z.string().optional().describe("Stable, user-defined identifier for this agent within the application. Unique per app."),
+    lookup_key: z.string().nullable().optional().describe("Stable, user-defined identifier for this agent within the application. Unique per app."),
     /** Arbitrary key-value metadata attached to the agent. Not interpreted by the platform. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the agent. Not interpreted by the platform."),
     /** Human-readable display name for the agent. `null` if not set. */
     name: z.string().optional().describe("Human-readable display name for the agent. `null` if not set."),
     /** ID of the organization this agent belongs to (`org_...`). `null` if the agent is not org-scoped. */
-    org: z.string().optional().describe("ID of the organization this agent belongs to (`org_...`). `null` if the agent is not org-scoped."),
+    org: z.string().nullable().optional().describe("ID of the organization this agent belongs to (`org_...`). `null` if the agent is not org-scoped."),
     /** Display name of the organization this agent belongs to. `null` when the agent is not org-scoped or when the org association was not preloaded. */
-    org_name: z.string().optional().describe("Display name of the organization this agent belongs to. `null` when the agent is not org-scoped or when the org association was not preloaded."),
+    org_name: z.string().nullable().optional().describe("Display name of the organization this agent belongs to. `null` when the agent is not org-scoped or when the org association was not preloaded."),
     /** Free-form label identifying the source or author that created this agent (e.g. a username or pipeline name). */
-    originator: z.string().optional().describe("Free-form label identifying the source or author that created this agent (e.g. a username or pipeline name)."),
+    originator: z.string().nullable().optional().describe("Free-form label identifying the source or author that created this agent (e.g. a username or pipeline name)."),
     /** Phone number provisioned for this agent. `null` if SMS is not configured. */
-    phone_number: z.string().optional().describe("Phone number provisioned for this agent. `null` if SMS is not configured."),
+    phone_number: z.string().nullable().optional().describe("Phone number provisioned for this agent. `null` if SMS is not configured."),
     /** ID of the sandbox environment this agent is scoped to (`dsb_...`). `null` in production deployments. */
-    sandbox: z.string().optional().describe("ID of the sandbox environment this agent is scoped to (`dsb_...`). `null` in production deployments."),
+    sandbox: z.string().nullable().optional().describe("ID of the sandbox environment this agent is scoped to (`dsb_...`). `null` in production deployments."),
     /** Source Solution and AgentTemplate summary for agents provisioned from a Solution. Includes `upgrade_available`, `latest_version`, and `latest_solution` so you can render an upgrade badge without a separate dry-run call. `null` for hand-built agents and agents whose tracked template or parent Solution has been deleted. Populated only on single-agent GET responses, never on list endpoints. */
-    source_solution: agentSourceSolutionSchema.optional().describe("Source Solution and AgentTemplate summary for agents provisioned from a Solution. Includes `upgrade_available`, `latest_version`, and `latest_solution` so you can render an upgrade badge without a separate dry-run call. `null` for hand-built agents and agents whose tracked template or parent Solution has been deleted. Populated only on single-agent GET responses, never on list endpoints."),
+    source_solution: agentSourceSolutionSchema.nullable().optional().describe("Source Solution and AgentTemplate summary for agents provisioned from a Solution. Includes `upgrade_available`, `latest_version`, and `latest_solution` so you can render an upgrade badge without a separate dry-run call. `null` for hand-built agents and agents whose tracked template or parent Solution has been deleted. Populated only on single-agent GET responses, never on list endpoints."),
     /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
-    team: z.string().optional().describe("ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped."),
+    team: z.string().nullable().optional().describe("ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped."),
     /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed on both the list endpoints and single-agent GET. Distinct from `source_solution.upgrade_available`, which compares Solution *versions*: an agent can lag its template (`template_upgrade_available: true`) while the org already holds the latest Solution version (`upgrade_available: false`). */
-    template_upgrade_available: z.boolean().optional().describe("True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed on both the list endpoints and single-agent GET. Distinct from `source_solution.upgrade_available`, which compares Solution *versions*: an agent can lag its template (`template_upgrade_available: true`) while the org already holds the latest Solution version (`upgrade_available: false`)."),
+    template_upgrade_available: z.boolean().nullable().optional().describe("True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed on both the list endpoints and single-agent GET. Distinct from `source_solution.upgrade_available`, which compares Solution *versions*: an agent can lag its template (`template_upgrade_available: true`) while the org already holds the latest Solution version (`upgrade_available: false`)."),
     /** When the agent was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the agent was last modified (ISO 8601)."),
     /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
-    user: z.string().optional().describe("ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped."),
+    user: z.string().nullable().optional().describe("ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped."),
 }).describe("An AI agent that can be configured with tools, routines, and skills, and invoked to handle conversations or tasks.");
 /** Runtime validator for {@link AgentComputer}. */
 export const agentComputerSchema = z.object({
@@ -1379,41 +1514,41 @@ export const agentComputerListResponseSchema = z.object({
 /** Runtime validator for {@link AgentCreateResponse}. */
 export const agentCreateResponseSchema = z.object({
     /** Access control list governing who can interact with this agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied. */
-    acl: aclSchema.optional().describe("Access control list governing who can interact with this agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied."),
+    acl: aclSchema.nullable().optional().describe("Access control list governing who can interact with this agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied."),
     /** ID of the app this agent belongs to (`dap_...`). */
     app: z.string().optional().describe("ID of the app this agent belongs to (`dap_...`)."),
     /** When the agent was created (ISO 8601). */
     created_at: z.string().optional().describe("When the agent was created (ISO 8601)."),
     /** Default AI model the agent uses when no model is specified at runtime, e.g. `"claude-3-5-sonnet-20241022"`. `null` if not configured. */
-    default_model: z.string().optional().describe("Default AI model the agent uses when no model is specified at runtime, e.g. `\"claude-3-5-sonnet-20241022\"`. `null` if not configured."),
+    default_model: z.string().nullable().optional().describe("Default AI model the agent uses when no model is specified at runtime, e.g. `\"claude-3-5-sonnet-20241022\"`. `null` if not configured."),
     /** Email address assigned to this agent for inbound email handling. `null` if not configured. */
-    email: z.string().optional().describe("Email address assigned to this agent for inbound email handling. `null` if not configured."),
+    email: z.string().nullable().optional().describe("Email address assigned to this agent for inbound email handling. `null` if not configured."),
     /** Agent ID (`agi_...`). */
     id: z.string().describe("Agent ID (`agi_...`)."),
     /** System prompt or persona description that shapes the agent's behavior. `null` if not set. */
-    identity: z.string().optional().describe("System prompt or persona description that shapes the agent's behavior. `null` if not set."),
+    identity: z.string().nullable().optional().describe("System prompt or persona description that shapes the agent's behavior. `null` if not set."),
     /** List of config records created as part of this request's `template_bundle` install. One entry per persisted config, sorted by `key`. Omitted entirely when the request did not include a `template_bundle`. */
     installed_configs: z.array(installedConfigEntrySchema).optional().describe("List of config records created as part of this request's `template_bundle` install. One entry per persisted config, sorted by `key`. Omitted entirely when the request did not include a `template_bundle`."),
     /** Unique, stable identifier for the agent within its app. `null` if not set. */
-    lookup_key: z.string().optional().describe("Unique, stable identifier for the agent within its app. `null` if not set."),
+    lookup_key: z.string().nullable().optional().describe("Unique, stable identifier for the agent within its app. `null` if not set."),
     /** Arbitrary key-value metadata attached to the agent. `null` if none was provided. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the agent. `null` if none was provided."),
     /** Human-readable display name for the agent. `null` if not set. */
     name: z.string().optional().describe("Human-readable display name for the agent. `null` if not set."),
     /** ID of the organization this agent belongs to (`org_...`). `null` for agents outside an org. */
-    org: z.string().optional().describe("ID of the organization this agent belongs to (`org_...`). `null` for agents outside an org."),
+    org: z.string().nullable().optional().describe("ID of the organization this agent belongs to (`org_...`). `null` for agents outside an org."),
     /** Free-form label identifying the source or author of the agent, e.g. a username or service name. `null` if not set. */
-    originator: z.string().optional().describe("Free-form label identifying the source or author of the agent, e.g. a username or service name. `null` if not set."),
+    originator: z.string().nullable().optional().describe("Free-form label identifying the source or author of the agent, e.g. a username or service name. `null` if not set."),
     /** Phone number assigned to this agent for inbound SMS or voice handling. `null` if not configured. */
-    phone_number: z.string().optional().describe("Phone number assigned to this agent for inbound SMS or voice handling. `null` if not configured."),
+    phone_number: z.string().nullable().optional().describe("Phone number assigned to this agent for inbound SMS or voice handling. `null` if not configured."),
     /** ID of the sandbox environment this agent is scoped to (`sbx_...`). `null` for agents not scoped to a sandbox. */
-    sandbox: z.string().optional().describe("ID of the sandbox environment this agent is scoped to (`sbx_...`). `null` for agents not scoped to a sandbox."),
+    sandbox: z.string().nullable().optional().describe("ID of the sandbox environment this agent is scoped to (`sbx_...`). `null` for agents not scoped to a sandbox."),
     /** ID of the team that owns this agent (`tea_...`). `null` if owned by a user rather than a team. */
-    team: z.string().optional().describe("ID of the team that owns this agent (`tea_...`). `null` if owned by a user rather than a team."),
+    team: z.string().nullable().optional().describe("ID of the team that owns this agent (`tea_...`). `null` if owned by a user rather than a team."),
     /** When the agent record was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the agent record was last modified (ISO 8601)."),
     /** ID of the user that owns this agent (`usr_...`). `null` if owned by a team. */
-    user: z.string().optional().describe("ID of the user that owns this agent (`usr_...`). `null` if owned by a team."),
+    user: z.string().nullable().optional().describe("ID of the user that owns this agent (`usr_...`). `null` if owned by a team."),
 }).describe("The response returned by `POST /api/v1/agents`. Contains all agent fields plus an optional `installed_configs` array when a `template_bundle` was supplied in the request.");
 /** Runtime validator for {@link AgentEnvVarMasked}. */
 export const agentEnvVarMaskedSchema = z.object({
@@ -1958,15 +2093,15 @@ export const solutionImportWarningSchema = z.object({
 /** Runtime validator for {@link SolutionImportResult}. */
 export const solutionImportResultSchema = z.object({
     /** Machine-readable conflict code present when `status` is `"conflict"`, identifying the specific conflict reason. `null` when `status` is `"ready"`. */
-    code: z.string().optional().describe("Machine-readable conflict code present when `status` is `\"conflict\"`, identifying the specific conflict reason. `null` when `status` is `\"ready\"`."),
+    code: z.string().nullable().optional().describe("Machine-readable conflict code present when `status` is `\"conflict\"`, identifying the specific conflict reason. `null` when `status` is `\"ready\"`."),
     /** Whether this result was produced by a dry-run check. `true` when the import was validated without persisting any changes. */
     dry_run: z.boolean().describe("Whether this result was produced by a dry-run check. `true` when the import was validated without persisting any changes."),
     /** Semver string of the Solution version already present in the library. `null` when no prior version exists. */
-    existing_solution_version: z.string().optional().describe("Semver string of the Solution version already present in the library. `null` when no prior version exists."),
+    existing_solution_version: z.string().nullable().optional().describe("Semver string of the Solution version already present in the library. `null` when no prior version exists."),
     /** Semver string of the Solution version in the bundle being imported. `null` when the bundle does not declare a version. */
-    incoming_solution_version: z.string().optional().describe("Semver string of the Solution version in the bundle being imported. `null` when the bundle does not declare a version."),
+    incoming_solution_version: z.string().nullable().optional().describe("Semver string of the Solution version in the bundle being imported. `null` when the bundle does not declare a version."),
     /** Human-readable description of the import status or conflict reason, suitable for display in a confirmation dialog. `null` when no detail is available. */
-    message: z.string().optional().describe("Human-readable description of the import status or conflict reason, suitable for display in a confirmation dialog. `null` when no detail is available."),
+    message: z.string().nullable().optional().describe("Human-readable description of the import status or conflict reason, suitable for display in a confirmation dialog. `null` when no detail is available."),
     /** Outcome of the import check. `"ready"` means the import can proceed as a normal create or update. `"conflict"` means a version conflict was detected and the upgrade flow must be used instead. */
     status: z.string().describe("Outcome of the import check. `\"ready\"` means the import can proceed as a normal create or update. `\"conflict\"` means a version conflict was detected and the upgrade flow must be used instead."),
     /** Whether the caller must invoke the dedicated upgrade flow to complete the import. Mirrors `status == "conflict"` as a convenience boolean. */
@@ -1987,13 +2122,13 @@ export const solutionImportResponseSchema = z.object({
     /** Resource type. Always `"Solution"`. */
     kind: z.string().describe("Resource type. Always `\"Solution\"`."),
     /** The `lookup_key` stored on the Solution config after the import's suffix normalization. `null` when the Solution was not given a lookup key. */
-    lookup_key: z.string().optional().describe("The `lookup_key` stored on the Solution config after the import's suffix normalization. `null` when the Solution was not given a lookup key."),
+    lookup_key: z.string().nullable().optional().describe("The `lookup_key` stored on the Solution config after the import's suffix normalization. `null` when the Solution was not given a lookup key."),
     /** Full summary of the imported Solution, in the same shape as the individual Solution retrieval endpoint. */
     solution: solutionSummarySchema.describe("Full summary of the imported Solution, in the same shape as the individual Solution retrieval endpoint."),
     /** When the Solution config record was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the Solution config record was last modified (ISO 8601)."),
     /** The `virtual_path` stored on the Solution config, used as the stable dedupe key across owner scopes. `null` when no virtual path was assigned. */
-    virtual_path: z.string().optional().describe("The `virtual_path` stored on the Solution config, used as the stable dedupe key across owner scopes. `null` when no virtual path was assigned."),
+    virtual_path: z.string().nullable().optional().describe("The `virtual_path` stored on the Solution config, used as the stable dedupe key across owner scopes. `null` when no virtual path was assigned."),
 }).describe("The result of importing a Solution bundle into the library, including the Solution config record, a structured import result, and the list of all configs persisted during the transaction.");
 /** Runtime validator for {@link SolutionInstallResponseWebhook}. */
 export const solutionInstallResponseWebhookSchema = z.object({
@@ -2007,7 +2142,7 @@ export const solutionInstallResponseSchema = z.object({
     /** Type of the provisioned resource. One of `"Agent"`, `"Automation"`, `"AgentRoutine"`, `"AgentTool"`, `"AgentSkill"`, or `"AgentComputer"`. */
     kind: z.string().describe("Type of the provisioned resource. One of `\"Agent\"`, `\"Automation\"`, `\"AgentRoutine\"`, `\"AgentTool\"`, `\"AgentSkill\"`, or `\"AgentComputer\"`."),
     /** The `lookup_key` stamped on the provisioned resource. `null` for `AgentSkill`, which is a join record and does not carry a lookup key. */
-    lookup_key: z.string().optional().describe("The `lookup_key` stamped on the provisioned resource. `null` for `AgentSkill`, which is a join record and does not carry a lookup key."),
+    lookup_key: z.string().nullable().optional().describe("The `lookup_key` stamped on the provisioned resource. `null` for `AgentSkill`, which is a join record and does not carry a lookup key."),
     /** Solution config ID (`cfg_...`) that was used as the source for this install. */
     solution: z.string().describe("Solution config ID (`cfg_...`) that was used as the source for this install."),
     /** One-time connection details for a webhook-auth Automation install. */
@@ -2016,25 +2151,25 @@ export const solutionInstallResponseSchema = z.object({
 /** Runtime validator for {@link SolutionInstance}. */
 export const solutionInstanceSchema = z.object({
     /** Materialized agent for this customer (`agi_...`). `null` for a row without an agent. */
-    agent: z.string().optional().describe("Materialized agent for this customer (`agi_...`). `null` for a row without an agent."),
+    agent: z.string().nullable().optional().describe("Materialized agent for this customer (`agi_...`). `null` for a row without an agent."),
     /** Human-readable display name of the materialized agent. `null` when no agent is visible. */
-    agent_name: z.string().optional().describe("Human-readable display name of the materialized agent. `null` when no agent is visible."),
+    agent_name: z.string().nullable().optional().describe("Human-readable display name of the materialized agent. `null` when no agent is visible."),
     /** Opaque tagged reference to the deployment target. Consumers interpret its kind. */
-    attachment_ref: z.record(z.unknown()).optional().describe("Opaque tagged reference to the deployment target. Consumers interpret its kind."),
+    attachment_ref: z.record(z.unknown()).nullable().optional().describe("Opaque tagged reference to the deployment target. Consumers interpret its kind."),
     /** When this instance was stamped. */
     created_at: z.string().describe("When this instance was stamped."),
     /** Stable vendor-defined key for the customer. */
     customer_key: z.string().describe("Stable vendor-defined key for the customer."),
     /** Human-readable customer label. `null` when the vendor did not provide one. */
-    customer_label: z.string().optional().describe("Human-readable customer label. `null` when the vendor did not provide one."),
+    customer_label: z.string().nullable().optional().describe("Human-readable customer label. `null` when the vendor did not provide one."),
     /** Solution instance ID (`sli_...`). */
     id: z.string().describe("Solution instance ID (`sli_...`)."),
     /** Count of local agent edits relative to the pinned template. `null` when unavailable. */
-    local_edit_count: z.number().int().optional().describe("Count of local agent edits relative to the pinned template. `null` when unavailable."),
+    local_edit_count: z.number().int().nullable().optional().describe("Count of local agent edits relative to the pinned template. `null` when unavailable."),
     /** Pinned template version record (`cfv_...`). `null` when no version is pinned. */
-    pinned_template_version: z.string().optional().describe("Pinned template version record (`cfv_...`). `null` when no version is pinned."),
+    pinned_template_version: z.string().nullable().optional().describe("Pinned template version record (`cfv_...`). `null` when no version is pinned."),
     /** Human-readable version number of the pinned template. `null` when unavailable. */
-    pinned_version_number: z.number().int().optional().describe("Human-readable version number of the pinned template. `null` when unavailable."),
+    pinned_version_number: z.number().int().nullable().optional().describe("Human-readable version number of the pinned template. `null` when unavailable."),
     /** Installed solution template config that stamped this instance (`cfg_...`). */
     solution_template_config: z.string().describe("Installed solution template config that stamped this instance (`cfg_...`)."),
     /** Lifecycle status of this stamped instance. */