@archastro/sdk 0.21.0 → 0.22.0

package/dist/types/common.js

@@ -1,8 +1,9 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: e9c10f6c8b7c
+// Content hash: e322067d3dcd
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
+import { computerRepositorySchema } from "./computers.js";
 import { configSchema } from "./config.js";
 import { imageSourceSchema } from "./image.js";
 import { userSchema } from "./users.js";
@@ -32,15 +33,23 @@ export const aclRemoveTargetSchema = z.object({
 export const aclSchema = z.object({
     /** Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`. */
     add: z.array(aclGrantSchema).optional().describe("Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`."),
+    /** Patch mode: denies to add or merge, replacing any grant for the same principal. */
+    add_denies: z.array(aclGrantSchema).optional().describe("Patch mode: denies to add or merge, replacing any grant for the same principal."),
+    /** Replace mode: the complete deny list. Supplying grants or denies replaces both lists. Requires schema deny support. */
+    denies: z.array(aclGrantSchema).optional().describe("Replace mode: the complete deny list. Supplying grants or denies replaces both lists. Requires schema deny support."),
     /** Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`. */
     grants: z.array(aclGrantSchema).optional().describe("Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`."),
+    /** Retain current server denies atomically in replacement or patch mode; current denies win. */
+    preserve_denies: z.boolean().optional().describe("Retain current server denies atomically in replacement or patch mode; current denies win."),
     /** Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`. */
     remove: z.array(aclRemoveTargetSchema).optional().describe("Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`."),
+    /** Patch mode: principals whose denies should be removed. */
+    remove_denies: z.array(aclRemoveTargetSchema).optional().describe("Patch mode: principals whose denies should be removed."),
 }).describe("An access-control list payload that supports either full replacement or targeted patch operations on a resource's grants.");
 /** 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() }).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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).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."),
+    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(), add_denies: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), denies: 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(), preserve_denies: z.boolean().optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional(), remove_denies: 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).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. */
@@ -144,14 +153,35 @@ export const originSchema = z.object({
     session_id: z.string().nullable().optional(),
     thread_id: z.string().nullable().optional(),
 }).describe("Origin references.");
+/** Runtime validator for {@link SelfUpdateChange}. */
+export const selfUpdateChangeSchema = z.object({
+    action: z.string().optional(),
+    class: z.string().optional(),
+    path: z.string().optional(),
+    tier: z.string().optional(),
+}).describe("Public review fields for one proposed self-update change.");
 /** Runtime validator for {@link Payload}. */
 export const payloadSchema = z.object({
-    question: z.string(),
-}).describe("Question request payload.");
+    changes: z.array(selfUpdateChangeSchema).optional(),
+    from_version: z.string().optional(),
+    instructions_md: z.string().optional(),
+    key: z.string().optional(),
+    overwrite: z.boolean().optional(),
+    prompt: z.string().optional(),
+    proposal_id: z.string().optional(),
+    question: z.string().optional(),
+    rationale: z.string().optional(),
+    to_version: z.string().optional(),
+    validate_script: z.string().optional(),
+}).describe("Kind-safe request payload.");
 /** Runtime validator for {@link Resolution}. */
 export const resolutionSchema = z.object({
     answer: z.string().optional(),
+    key: z.string().optional(),
     reason: z.string().optional(),
+    set: z.boolean().optional(),
+    status: z.string().optional(),
+    to_version: z.string().optional(),
 }).describe("Answer or rejection reason; null before resolution.");
 /** Runtime validator for {@link Summary}. */
 export const summarySchema = z.object({
@@ -607,6 +637,8 @@ export const currentUserSchema = z.object({
     app: z.string().nullable().optional().describe("ID of the token-scoped app (`dap_...`)."),
     /** Display name of the token-scoped app. */
     app_name: z.string().nullable().optional().describe("Display name of the token-scoped app."),
+    /** Stable public URL of the profile picture. Unlike `profile_picture.url` it does not expire, so clients can store it; it stops resolving when the picture is replaced. `null` when the user has no profile picture. */
+    avatar_url: z.string().nullable().optional().describe("Stable public URL of the profile picture. Unlike `profile_picture.url` it does not expire, so clients can store it; it stops resolving when the picture is replaced. `null` when the user has no profile picture."),
     /** Present only when the request supplies one or more `entitlement[]` values. */
     effective_access: effectiveAccessSchema.optional().describe("Present only when the request supplies one or more `entitlement[]` values."),
     /** Email address of the user. */
@@ -1580,6 +1612,8 @@ export const agentComputerSchema = z.object({
     agent: z.string().nullable().optional().describe("ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent."),
     /** ID of the app this computer belongs to (`dap_...`). */
     app: z.string().optional().describe("ID of the app this computer belongs to (`dap_...`)."),
+    /** Bootstrap results, including each repository's status, commit and error. */
+    bootstrap: z.record(z.custom((value) => value !== undefined)).optional().describe("Bootstrap results, including each repository's status, commit and error."),
     /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
     config: z.record(z.custom((value) => value !== undefined)).optional().describe("Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider."),
     /** When the computer was created (ISO 8601). */
@@ -1598,14 +1632,16 @@ export const agentComputerSchema = z.object({
     metadata: z.record(z.custom((value) => value !== undefined)).optional().describe("Arbitrary key-value metadata you attached to the computer. `null` if none was provided."),
     /** Human-readable display name for the computer. `null` if not set. */
     name: z.string().optional().describe("Human-readable display name for the computer. `null` if not set."),
-    /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox) or `"e2b"` (E2B). */
-    provider: z.string().optional().describe("Compute backend powering this computer: `\"sprites\"` (Fly Sprites), `\"vercel\"` (Vercel Sandbox) or `\"e2b\"` (E2B)."),
+    /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox), `"e2b"` (E2B) or `"devbox"` (an ArchAstro devbox owned by the computer's user). */
+    provider: z.string().optional().describe("Compute backend powering this computer: `\"sprites\"` (Fly Sprites), `\"vercel\"` (Vercel Sandbox), `\"e2b\"` (E2B) or `\"devbox\"` (an ArchAstro devbox owned by the computer's user)."),
     /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`, `"e2b"`). */
     region: z.string().nullable().optional().describe("Cloud region where the computer is hosted, e.g. `\"us-east-1\"`. `null` if not yet assigned or when the provider has no region concept (e.g. `\"vercel\"`, `\"e2b\"`)."),
+    /** Ordered GitHub checkouts with repository and nullable ref; the first checkout is primary. */
+    repositories: z.array(computerRepositorySchema).optional().describe("Ordered GitHub checkouts with repository and nullable ref; the first checkout is primary."),
     /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
     sprite_url: z.string().nullable().optional().describe("URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available."),
-    /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`. */
-    status: z.string().nullable().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"error\"`, and `\"terminated\"`."),
+    /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"paused"` (resumes on use), `"error"`, and `"destroyed"`. */
+    status: z.string().nullable().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"paused\"` (resumes on use), `\"error\"`, and `\"destroyed\"`."),
     /** Thread this computer belongs to, or null for a non-thread computer. */
     thread_id: z.string().nullable().optional().describe("Thread this computer belongs to, or null for a non-thread computer."),
     /** When the computer record was last modified (ISO 8601). */
@@ -1743,8 +1779,8 @@ export const agentRequestSchema = z.object({
     kind: z.string().optional().describe("Registered request kind."),
     /** Origin references. */
     origin: originSchema.optional().describe("Origin references."),
-    /** Question request payload. */
-    payload: payloadSchema.optional().describe("Question request payload."),
+    /** Kind-safe request payload. */
+    payload: payloadSchema.optional().describe("Kind-safe request payload."),
     /** Answer or rejection reason; null before resolution. */
     resolution: resolutionSchema.nullable().optional().describe("Answer or rejection reason; null before resolution."),
     /** Resolution time. */
@@ -2085,8 +2121,8 @@ export const agentUpgradeChangeSchema = z.object({
     parent_template_config: upgradeTemplateSummarySchema.describe("Summary of the parent AgentTemplate config (`cfg_...`) being applied in this upgrade."),
     /** Resource-type-specific identity details. Tools: `tool_type`, `builtin_tool_key`, `name_prefix`, `handler_type`, `instruction`. Routines: `handler_type`, `preset_name`, `event_type`, `schedule`, `trigger_context`. Skills: `instruction`. Computers: `region`. Knowledge: `mode`, `knowledge_key`, `extraction_output_ref`. Only populated keys are present; `null` when nothing is known. */
     resource: z.record(z.custom((value) => value !== undefined)).optional().describe("Resource-type-specific identity details. Tools: `tool_type`, `builtin_tool_key`, `name_prefix`, `handler_type`, `instruction`. Routines: `handler_type`, `preset_name`, `event_type`, `schedule`, `trigger_context`. Skills: `instruction`. Computers: `region`. Knowledge: `mode`, `knowledge_key`, `extraction_output_ref`. Only populated keys are present; `null` when nothing is known."),
-    /** Type of the resource being changed. One of `"agent"`, `"tool"`, `"routine"`, `"skill"`, `"computer"`, or `"knowledge"`. */
-    resource_type: z.string().describe("Type of the resource being changed. One of `\"agent\"`, `\"tool\"`, `\"routine\"`, `\"skill\"`, `\"computer\"`, or `\"knowledge\"`."),
+    /** Type of the resource being changed. One of `"agent"`, `"tool"`, `"routine"`, `"skill"`, `"computer"`, `"endpoint"`, or `"knowledge"`. */
+    resource_type: z.string().describe("Type of the resource being changed. One of `\"agent\"`, `\"tool\"`, `\"routine\"`, `\"skill\"`, `\"computer\"`, `\"endpoint\"`, or `\"knowledge\"`."),
     /** Summary of the specific child template config (`cfg_...`) that defines this resource. `null` when no source template is resolvable. */
     source_template_config: upgradeTemplateSummarySchema.optional().describe("Summary of the specific child template config (`cfg_...`) that defines this resource. `null` when no source template is resolvable."),
 }).describe("One child-resource change produced by an agent upgrade, describing the action to be taken on a single resource.");