feat: rename agent layout variant methods and export LayoutVariant type [EXT-7094] (#2427)

feat: rename agent layout variant methods and export LayoutVariant type

- Rename setLayoutVariant to setAgentLayoutVariant
- Rename layoutVariantChanged to agentLayoutVariantChanged
- Rename onLayoutVariantChange to onAgentLayoutVariantChange
- Export LayoutVariant type from types/index.ts
- Add validation to setAgentLayoutVariant method
- Update channel calls to use new names
- Update all tests to use new method names
- Add comprehensive validation error tests

EXT-6962, EXT-7094

Author: tylerwashington888

lib/agent.ts

@@ -15,7 +15,7 @@ export default function createAgent(
 
   const toolbarActionSignal = new Signal<[ToolbarAction]>()
 
-  const layoutVariantChanged = new MemoizedSignal<[LayoutVariant]>('normal')
+  const agentLayoutVariantChanged = new MemoizedSignal<[LayoutVariant]>('normal')
 
   channel.addHandler('contextChanged', (newContext: AgentContext) => {
     contextChanged.dispatch(newContext)
@@ -25,16 +25,19 @@ export default function createAgent(
     toolbarActionSignal.dispatch(action)
   })
 
-  channel.addHandler('layoutVariantChanged', (variant: LayoutVariant) => {
-    layoutVariantChanged.dispatch(variant)
+  channel.addHandler('agentLayoutVariantChanged', (variant: LayoutVariant) => {
+    agentLayoutVariantChanged.dispatch(variant)
   })
 
   return {
     onContextChange: (handler) => contextChanged.attach(handler),
     onToolbarAction: (handler) => toolbarActionSignal.attach(handler),
-    onLayoutVariantChange: (handler) => layoutVariantChanged.attach(handler),
-    setLayoutVariant: (variant: LayoutVariant) => {
-      channel.send('setLayoutVariant', variant)
+    onAgentLayoutVariantChange: (handler) => agentLayoutVariantChanged.attach(handler),
+    setAgentLayoutVariant: (variant: LayoutVariant) => {
+      if (variant !== 'expanded' && variant !== 'normal') {
+        throw new Error(`Invalid layout variant "${variant}". Expected "expanded" or "normal".`)
+      }
+      channel.send('setAgentLayoutVariant', variant)
     },
   }
 }

lib/types/agent.types.ts

@@ -19,6 +19,6 @@ export interface ToolbarAction {
 export interface AgentAPI {
   onContextChange: (handler: (context: AgentContext) => void) => VoidFunction
   onToolbarAction: (handler: (action: ToolbarAction) => void) => VoidFunction
-  onLayoutVariantChange: (handler: (variant: LayoutVariant) => void) => VoidFunction
-  setLayoutVariant: (variant: LayoutVariant) => void
+  onAgentLayoutVariantChange: (handler: (variant: LayoutVariant) => void) => VoidFunction
+  setAgentLayoutVariant: (variant: LayoutVariant) => void
 }

lib/types/index.ts

@@ -37,7 +37,13 @@ export type {
   AgentAppSDK,
 } from './api.types'
 
-export type { AgentAPI, AgentContext, ToolbarAction, ToolbarActionName } from './agent.types'
+export type {
+  AgentAPI,
+  AgentContext,
+  LayoutVariant,
+  ToolbarAction,
+  ToolbarActionName,
+} from './agent.types'
 
 export type {
   AppConfigAPI,