@aui.io/aui-client 1.2.28 → 1.2.30

package/README.md

@@ -31,6 +31,11 @@ const azureClient = new ApolloClient({
     environment: ApolloEnvironment.Azure,
     networkApiKey: 'API_KEY_YOUR_KEY_HERE'
 });
+
+const awsClient = new ApolloClient({
+    environment: ApolloEnvironment.Aws,
+    networkApiKey: 'API_KEY_YOUR_KEY_HERE'
+});
 ```
 
 
@@ -144,9 +149,7 @@ The `ApolloClient` constructor accepts the following options:
 
 ```typescript
 interface ApolloClient.Options {
-    // Choose ONE of the following:
-    baseUrl?: string;                    // Custom base URL (e.g., staging)
-    environment?: ApolloEnvironment;      // Or use predefined environment
+    environment?: ApolloEnvironment;      // Use predefined environment (Gcp or Azure)
     
     // Authentication (required)
     networkApiKey: string;               // Your API key (x-network-api-key header)
@@ -178,6 +181,12 @@ ApolloEnvironment.Azure = {
     wsUrl: "wss://azure-v2.aui.io"                  // WebSocket
 }
 
+// AWS Environment
+ApolloEnvironment.Aws = {
+    base: "https://aws.aui.io/ia-controller",      // REST API
+    wsUrl: "wss://aws.aui.io"                       // WebSocket
+}
+
 // Default (same as Gcp)
 ApolloEnvironment.Default = {
     base: "https://api.aui.io/ia-controller",
@@ -242,12 +251,34 @@ Submit a new message to an existing task (non-streaming).
 const messageResponse = await client.controllerApi.sendMessage({
     task_id: string,          // Task identifier
     text: string,             // Message text
-    is_external_api?: boolean // Optional: mark as external API call
+    is_external_api?: boolean, // Optional: mark as external API call
+    context?: {               // Optional: additional context
+        url?: string,
+        lead_details?: Record<string, any>,
+        welcome_message?: string
+    },
+    agent_variables?: Record<string, unknown>  // Optional: custom agent variables (NEW in v1.2.28)
 });
 
 // Returns: Message - Complete agent response with optional product cards
 ```
 
+**New in v1.2.28:** The `agent_variables` parameter allows you to pass custom context to the agent:
+
+```typescript
+// Example: Send message with agent variables
+const response = await client.controllerApi.sendMessage({
+    task_id: 'your-task-id',
+    text: 'What products do you recommend?',
+    is_external_api: true,
+    agent_variables: {
+        context: 'User is interested in electric vehicles',
+        user_preference: 'eco-friendly',
+        budget: 'mid-range'
+    }
+});
+```
+
 #### `listUserTasks(request)` - List User Tasks
 Retrieve all tasks for a specific user with pagination.
 
@@ -272,6 +303,58 @@ const metadata = await client.controllerApi.getProductMetadata({
 // Returns: Record<string, any> - Product metadata object
 ```
 
+#### `getAgentContext(request)` - Get Agent Context (NEW in v1.2.28)
+Retrieve the agent's context configuration including parameters, entities, and static context.
+
+```typescript
+const agentContext = await client.controllerApi.getAgentContext({
+    task_id: 'your-task-id',
+    query: 'test context'
+});
+
+// Returns: CreateTopicRequestBody - Agent context with:
+// - title: string
+// - params: TaskParameter[]
+// - entities: TaskTopicEntity[]
+// - static_context: string
+```
+
+**Example:**
+
+```typescript
+// Get agent context to understand available parameters
+const context = await client.controllerApi.getAgentContext({
+    task_id: 'your-task-id',
+    query: 'test context'
+});
+
+console.log('Agent Title:', context.title);
+console.log('Available Parameters:', context.params?.length);
+console.log('Entities:', context.entities?.length);
+console.log('Static Context:', context.static_context);
+```
+
+#### `getDirectFollowupSuggestions(taskId)` - Get Direct Followup Suggestions (NEW in v1.2.28)
+Retrieve AI-generated followup suggestions for a specific task.
+
+```typescript
+const suggestions: string[] = await client.controllerApi.getDirectFollowupSuggestions('your-task-id');
+
+// Returns: string[] - Array of suggested followup questions
+```
+
+**Example:**
+
+```typescript
+// Get followup suggestions for a task
+const suggestions: string[] = await client.controllerApi.getDirectFollowupSuggestions('your-task-id');
+
+console.log('Suggested followups:');
+suggestions.forEach((suggestion, index) => {
+    console.log(`${index + 1}. ${suggestion}`);
+});
+```
+
 ---
 
 ### WebSocket API
@@ -479,6 +562,128 @@ async function fetchProductMetadata(productLink: string) {
 fetchProductMetadata('https://www.example.com/product/12345');
 ```
 
+### Send Message with Agent Variables (NEW in v1.2.28)
+
+```typescript
+import { ApolloClient } from '@aui.io/aui-client';
+
+const client = new ApolloClient({
+    networkApiKey: 'API_KEY_YOUR_KEY_HERE'
+});
+
+async function sendContextualMessage(taskId: string, message: string, userContext: Record<string, unknown>) {
+    try {
+        // Send a message with custom agent variables for contextual responses
+        const response = await client.controllerApi.sendMessage({
+            task_id: taskId,
+            text: message,
+            is_external_api: true,
+            agent_variables: userContext
+        });
+        
+        console.log('Agent Response:', response.text);
+        
+        // The agent will use the provided context to tailor its response
+        if (response.cards && response.cards.length > 0) {
+            console.log('Recommended products:', response.cards.length);
+        }
+        
+        return response;
+    } catch (error) {
+        console.error('Error sending message:', error);
+        throw error;
+    }
+}
+
+// Example usage - provide context about user preferences
+sendContextualMessage('task-123', 'What do you recommend?', {
+    context: 'User is browsing electric vehicles',
+    user_preference: 'eco-friendly',
+    budget_range: '$30,000 - $50,000',
+    location: 'California'
+});
+```
+
+### Get Agent Context (NEW in v1.2.28)
+
+```typescript
+import { ApolloClient } from '@aui.io/aui-client';
+
+const client = new ApolloClient({
+    networkApiKey: 'API_KEY_YOUR_KEY_HERE'
+});
+
+async function exploreAgentCapabilities() {
+    try {
+        // Get the agent's context configuration
+        const context = await client.controllerApi.getAgentContext({
+            task_id: 'your-task-id',
+            query: 'test context'
+        });
+        
+        console.log('Agent Configuration:');
+        console.log('  Title:', context.title);
+        console.log('  Static Context:', context.static_context);
+        
+        // Explore available parameters
+        if (context.params && context.params.length > 0) {
+            console.log('\nAvailable Parameters:');
+            context.params.forEach(param => {
+                console.log(`  - ${param.title}: ${param.param}`);
+            });
+        }
+        
+        // Explore entities
+        if (context.entities && context.entities.length > 0) {
+            console.log('\nConfigured Entities:', context.entities.length);
+        }
+        
+        return context;
+    } catch (error) {
+        console.error('Error getting agent context:', error);
+        throw error;
+    }
+}
+
+exploreAgentCapabilities();
+```
+
+### Get Direct Followup Suggestions (NEW in v1.2.28)
+
+```typescript
+import { ApolloClient } from '@aui.io/aui-client';
+
+const client = new ApolloClient({
+    networkApiKey: 'API_KEY_YOUR_KEY_HERE'
+});
+
+async function getSuggestedQuestions(taskId: string) {
+    try {
+        // Get AI-generated followup suggestions based on conversation context
+        const suggestions = await client.controllerApi.getDirectFollowupSuggestions(taskId);
+        
+        console.log('Suggested followup questions:');
+        suggestions.forEach((suggestion, index) => {
+            console.log(`  ${index + 1}. ${suggestion}`);
+        });
+        
+        // Use these suggestions to guide the user's next interaction
+        return suggestions;
+    } catch (error) {
+        console.error('Error getting suggestions:', error);
+        throw error;
+    }
+}
+
+// Example usage
+getSuggestedQuestions('task-123');
+// Output:
+// Suggested followup questions:
+//   1. "What colors are available?"
+//   2. "Do you offer financing options?"
+//   3. "Can I schedule a test drive?"
+```
+
 ## 🔧 Advanced Configuration
 
 ### Custom Timeout and Retries
@@ -634,7 +839,7 @@ const client = new ApolloClient({
 });
 
 // The key should start with "API_KEY_"
-// Example: API_KEY_01K92N5BD5M7239VRK7YTK4Y6N
+// Example: API_KEY_01K------
 ```
 
 ### CORS Errors (Browser Only)

package/dist/cjs/Client.js

@@ -45,8 +45,8 @@ class ApolloClient {
                 "x-network-api-key": _options === null || _options === void 0 ? void 0 : _options.networkApiKey,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "1.2.28",
-                "User-Agent": "@aui.io/aui-client/1.2.28",
+                "X-Fern-SDK-Version": "1.2.30",
+                "User-Agent": "@aui.io/aui-client/1.2.30",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/controllerApi/client/Client.d.ts

@@ -100,7 +100,7 @@ export declare class ControllerApi {
      * @example
      *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
      */
-    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<string[]>;
+    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
     private __getDirectFollowupSuggestions;
     /**
      * Get metadata for all workflows available for the authenticated network.

package/dist/cjs/api/resources/controllerApi/client/Client.js

@@ -501,7 +501,10 @@ class ControllerApi {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

package/dist/cjs/api/types/DirectFollowupSuggestionsResponse.d.ts

@@ -0,0 +1,4 @@
+export interface DirectFollowupSuggestionsResponse {
+    suggestions?: string[];
+    metadata_id?: string;
+}

package/dist/cjs/api/types/DirectFollowupSuggestionsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ParameterType.d.ts

@@ -7,5 +7,6 @@ export declare const ParameterType: {
     readonly Time: "time";
     readonly Object: "object";
     readonly ListOfObjects: "list_of_objects";
+    readonly Enum: "enum";
 };
 export type ParameterType = (typeof ParameterType)[keyof typeof ParameterType];

package/dist/cjs/api/types/ParameterType.js

@@ -11,4 +11,5 @@ exports.ParameterType = {
     Time: "time",
     Object: "object",
     ListOfObjects: "list_of_objects",
+    Enum: "enum",
 };

package/dist/cjs/api/types/index.d.ts

@@ -4,6 +4,7 @@ export * from "./CardParameter.js";
 export * from "./Context.js";
 export * from "./CreateTaskResponse.js";
 export * from "./CreateTopicRequestBody.js";
+export * from "./DirectFollowupSuggestionsResponse.js";
 export * from "./EntityItemParameter.js";
 export * from "./EntityItemSubEntity.js";
 export * from "./EntityItemSubEntityItem.js";

package/dist/cjs/api/types/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./CardParameter.js"), exports);
 __exportStar(require("./Context.js"), exports);
 __exportStar(require("./CreateTaskResponse.js"), exports);
 __exportStar(require("./CreateTopicRequestBody.js"), exports);
+__exportStar(require("./DirectFollowupSuggestionsResponse.js"), exports);
 __exportStar(require("./EntityItemParameter.js"), exports);
 __exportStar(require("./EntityItemSubEntity.js"), exports);
 __exportStar(require("./EntityItemSubEntityItem.js"), exports);

package/dist/cjs/environments.d.ts

@@ -11,9 +11,13 @@ export declare const ApolloEnvironment: {
         readonly base: "https://azure-v2.aui.io/ia-controller";
         readonly wsUrl: "wss://azure-v2.aui.io";
     };
+    readonly Aws: {
+        readonly base: "https://aws.aui.io/ia-controller";
+        readonly wsUrl: "wss://aws.aui.io";
+    };
     readonly Default: {
         readonly base: "https://api.aui.io/ia-controller";
         readonly wsUrl: "wss://api.aui.io";
     };
 };
-export type ApolloEnvironment = typeof ApolloEnvironment.Default | typeof ApolloEnvironment.Gcp | typeof ApolloEnvironment.Azure;
+export type ApolloEnvironment = typeof ApolloEnvironment.Default | typeof ApolloEnvironment.Gcp | typeof ApolloEnvironment.Azure | typeof ApolloEnvironment.Aws;

package/dist/cjs/environments.js

@@ -12,6 +12,10 @@ exports.ApolloEnvironment = {
         base: "https://azure-v2.aui.io/ia-controller",
         wsUrl: "wss://azure-v2.aui.io",
     },
+    Aws: {
+        base: "https://aws.aui.io/ia-controller",
+        wsUrl: "wss://aws.aui.io",
+    },
     // Default points to Gcp for backwards compatibility
     Default: {
         base: "https://api.aui.io/ia-controller",

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.28";
+export declare const SDK_VERSION = "1.2.30";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.2.28";
+exports.SDK_VERSION = "1.2.30";

package/dist/esm/Client.mjs

@@ -9,8 +9,8 @@ export class ApolloClient {
                 "x-network-api-key": _options === null || _options === void 0 ? void 0 : _options.networkApiKey,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "1.2.28",
-                "User-Agent": "@aui.io/aui-client/1.2.28",
+                "X-Fern-SDK-Version": "1.2.30",
+                "User-Agent": "@aui.io/aui-client/1.2.30",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/controllerApi/client/Client.d.mts

@@ -100,7 +100,7 @@ export declare class ControllerApi {
      * @example
      *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
      */
-    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<string[]>;
+    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
     private __getDirectFollowupSuggestions;
     /**
      * Get metadata for all workflows available for the authenticated network.

package/dist/esm/api/resources/controllerApi/client/Client.mjs

@@ -465,7 +465,10 @@ export class ControllerApi {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

package/dist/esm/api/types/DirectFollowupSuggestionsResponse.d.mts

@@ -0,0 +1,4 @@
+export interface DirectFollowupSuggestionsResponse {
+    suggestions?: string[];
+    metadata_id?: string;
+}

package/dist/esm/api/types/DirectFollowupSuggestionsResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ParameterType.d.mts

@@ -7,5 +7,6 @@ export declare const ParameterType: {
     readonly Time: "time";
     readonly Object: "object";
     readonly ListOfObjects: "list_of_objects";
+    readonly Enum: "enum";
 };
 export type ParameterType = (typeof ParameterType)[keyof typeof ParameterType];

package/dist/esm/api/types/ParameterType.mjs

@@ -8,4 +8,5 @@ export const ParameterType = {
     Time: "time",
     Object: "object",
     ListOfObjects: "list_of_objects",
+    Enum: "enum",
 };

package/dist/esm/api/types/index.d.mts

@@ -4,6 +4,7 @@ export * from "./CardParameter.mjs";
 export * from "./Context.mjs";
 export * from "./CreateTaskResponse.mjs";
 export * from "./CreateTopicRequestBody.mjs";
+export * from "./DirectFollowupSuggestionsResponse.mjs";
 export * from "./EntityItemParameter.mjs";
 export * from "./EntityItemSubEntity.mjs";
 export * from "./EntityItemSubEntityItem.mjs";

package/dist/esm/api/types/index.mjs

@@ -4,6 +4,7 @@ export * from "./CardParameter.mjs";
 export * from "./Context.mjs";
 export * from "./CreateTaskResponse.mjs";
 export * from "./CreateTopicRequestBody.mjs";
+export * from "./DirectFollowupSuggestionsResponse.mjs";
 export * from "./EntityItemParameter.mjs";
 export * from "./EntityItemSubEntity.mjs";
 export * from "./EntityItemSubEntityItem.mjs";

package/dist/esm/environments.d.mts

@@ -11,9 +11,13 @@ export declare const ApolloEnvironment: {
         readonly base: "https://azure-v2.aui.io/ia-controller";
         readonly wsUrl: "wss://azure-v2.aui.io";
     };
+    readonly Aws: {
+        readonly base: "https://aws.aui.io/ia-controller";
+        readonly wsUrl: "wss://aws.aui.io";
+    };
     readonly Default: {
         readonly base: "https://api.aui.io/ia-controller";
         readonly wsUrl: "wss://api.aui.io";
     };
 };
-export type ApolloEnvironment = typeof ApolloEnvironment.Default | typeof ApolloEnvironment.Gcp | typeof ApolloEnvironment.Azure;
+export type ApolloEnvironment = typeof ApolloEnvironment.Default | typeof ApolloEnvironment.Gcp | typeof ApolloEnvironment.Azure | typeof ApolloEnvironment.Aws;

package/dist/esm/environments.mjs

@@ -9,6 +9,10 @@ export const ApolloEnvironment = {
         base: "https://azure-v2.aui.io/ia-controller",
         wsUrl: "wss://azure-v2.aui.io",
     },
+    Aws: {
+        base: "https://aws.aui.io/ia-controller",
+        wsUrl: "wss://aws.aui.io",
+    },
     // Default points to Gcp for backwards compatibility
     Default: {
         base: "https://api.aui.io/ia-controller",

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.28";
+export declare const SDK_VERSION = "1.2.30";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.2.28";
+export const SDK_VERSION = "1.2.30";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@aui.io/aui-client",
-    "version": "1.2.28",
+    "version": "1.2.30",
     "private": false,
     "repository": "github:aui-io/aui-client-typescript",
     "type": "commonjs",

package/reference.md

@@ -309,7 +309,7 @@ await client.controllerApi.getAgentContext({
 </dl>
 </details>
 
-<details><summary><code>client.controllerApi.<a href="/src/api/resources/controllerApi/client/Client.ts">getDirectFollowupSuggestions</a>(taskId) -> string[]</code></summary>
+<details><summary><code>client.controllerApi.<a href="/src/api/resources/controllerApi/client/Client.ts">getDirectFollowupSuggestions</a>(taskId) -> Apollo.DirectFollowupSuggestionsResponse</code></summary>
 <dl>
 <dd>