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,45 @@ export type AiActionInvocationProps = {
   result?: InvocationResult
 }
 
-export type AiActionInvocationType = {
-  outputFormat?: 'RichText' | 'Markdown' | 'PlainText'
-  variables?: Array<
-    | {
-        value: string
-        id: string
-      }
-    | {
-        value: {
-          entityPath: string
-          entityType: 'Entry' | 'Asset' | 'ResourceLink'
-          entityId: string
+export type AiActionInvocationVariable =
+  | {
+      id: string
+      value: string
+    }
+  | {
+      id: string
+      value: {
+        sys: {
+          type: 'Link'
+          linkType: 'Entry' | 'Asset'
+          id: string
+          release?: SysLink
+          entityPaths?: Array<string>
         }
-        id: string
       }
-    | {
-        value: {
-          entityPaths: Array<string>
-          entityType: 'Entry'
-          entityId: string
-        }
-        id: string
+    }
+  | /** @deprecated Use the sys-nested format instead. */
+  {
+      id: string
+      value: {
+        entityPath: string
+        entityType: 'Entry' | 'Asset' | 'ResourceLink'
+        entityId: string
       }
-  >
+    }
+  | /** @deprecated Use the sys-nested format instead. */
+  {
+      id: string
+      value: {
+        entityPaths: Array<string>
+        entityType: 'Entry'
+        entityId: string
+      }
+    }
+
+export type AiActionInvocationType = {
+  outputFormat?: 'RichText' | 'Markdown' | 'PlainText'
+  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,