feat: update AI action invocation variable types to sys-nested format

Reference variables now use the standard sys-nested link structure with
type, linkType, id, optional release, and optional entityPaths inside
sys, instead of flat entityId/entityType/entityPath(s) properties.

Extracts AiActionInvocationVariable as a reusable exported type.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: cemreyuksel

lib/common-types.ts

@@ -193,6 +193,7 @@ import type { AiActionProps, AiActionQueryOptions, CreateAiActionProps } from '.
 import type {
   AiActionInvocationProps,
   AiActionInvocationType,
+  AiActionInvocationVariable,
 } from './entities/ai-action-invocation'
 import type { AgentGeneratePayload, AgentProps } from './entities/agent'
 import type {

lib/entities/ai-action-invocation.ts

@@ -49,30 +49,53 @@ export type AiActionInvocationProps = {
   result?: InvocationResult
 }
 
+export type AiActionTextVariable = {
+  id: string
+  value: string
+}
+
+export type AiActionEntityLinkVariable = {
+  id: string
+  value: {
+    sys: {
+      type: 'Link'
+      linkType: 'Entry' | 'Asset' | 'ResourceLink'
+      id: string
+      release?: SysLink
+      entityPaths?: Array<string>
+    }
+  }
+}
+
+/** @deprecated Use `AiActionEntityLinkVariable` with the sys-nested format instead. */
+export type AiActionLegacyEntityPathVariable = {
+  id: string
+  value: {
+    entityPath: string
+    entityType: 'Entry' | 'Asset' | 'ResourceLink'
+    entityId: string
+  }
+}
+
+/** @deprecated Use `AiActionEntityLinkVariable` with the sys-nested format instead. */
+export type AiActionLegacyEntityPathsVariable = {
+  id: string
+  value: {
+    entityPaths: Array<string>
+    entityType: 'Entry'
+    entityId: string
+  }
+}
+
+export type AiActionInvocationVariable =
+  | AiActionTextVariable
+  | AiActionEntityLinkVariable
+  | AiActionLegacyEntityPathVariable
+  | AiActionLegacyEntityPathsVariable
+
 export type AiActionInvocationType = {
   outputFormat?: 'RichText' | 'Markdown' | 'PlainText'
-  variables?: Array<
-    | {
-        value: string
-        id: string
-      }
-    | {
-        value: {
-          entityPath: string
-          entityType: 'Entry' | 'Asset' | 'ResourceLink'
-          entityId: string
-        }
-        id: string
-      }
-    | {
-        value: {
-          entityPaths: Array<string>
-          entityType: 'Entry'
-          entityId: string
-        }
-        id: string
-      }
-  >
+  variables?: Array<AiActionInvocationVariable>
 }
 
 /**

lib/export-types.ts

@@ -13,7 +13,11 @@ export type {
   CreateAppAccessTokenProps,
 } from './entities/app-access-token'
 export type { AiAction, AiActionProps, CreateAiActionProps } from './entities/ai-action'
-export type { AiActionInvocation, AiActionInvocationProps } from './entities/ai-action-invocation'
+export type {
+  AiActionInvocation,
+  AiActionInvocationProps,
+  AiActionInvocationVariable,
+} from './entities/ai-action-invocation'
 export type { Agent, AgentGeneratePayload, AgentProps, AgentToolLink } from './entities/agent'
 export type {
   AgentGenerateResponse,