@aui.io/aui-client 1.2.36 → 1.2.38

package/README.md

@@ -272,15 +272,16 @@ Submit a new message to an existing task (non-streaming).
 ```typescript
 const messageResponse = await client.controllerApi.sendMessage({
     task_id: string,              // Task identifier
-    text: string,                 // Message text
+    text?: string,                // Message text (optional in v1.2.36+)
     is_external_api?: boolean,    // Optional: mark as external API call
-    include_trace_info?: boolean, // Optional: include trace/debug info in response (NEW)
+    include_trace_info?: boolean, // Optional: include trace/debug info in response (NEW in v1.2.35)
     context?: {                   // Optional: additional context
         url?: string,
         lead_details?: Record<string, any>,
         welcome_message?: string
     },
-    agent_variables?: Record<string, unknown>  // Optional: custom agent variables
+    agent_variables?: Record<string, unknown>,  // Optional: custom agent variables
+    static_context?: Record<string, unknown>    // Optional: static context data (NEW in v1.2.36)
 });
 
 // Returns: Message - Complete agent response with optional product cards
@@ -351,23 +352,33 @@ const traceInfo = await client.controllerApi.getTraceInfo('your-task-id', messag
 console.log('Trace Info:', traceInfo);
 ```
 
-#### `getDirectFollowupSuggestions(taskId)` - Get Direct Followup Suggestions (NEW in v1.2.28)
-Retrieve AI-generated followup suggestions for a specific task.
+#### `getDirectFollowupSuggestions(request?)` - Get Direct Followup Suggestions
+Retrieve AI-generated followup suggestions. Accepts optional `context` and `created_by` parameters.
 
 ```typescript
-const suggestions: string[] = await client.controllerApi.getDirectFollowupSuggestions('your-task-id');
+const response = await client.controllerApi.getDirectFollowupSuggestions({
+    context?: Record<string, unknown>,  // Optional: context data (e.g., { task_id: 'xxx' })
+    created_by?: string                 // Optional: user identifier
+});
 
-// Returns: string[] - Array of suggested followup questions
+// Returns: DirectFollowupSuggestionsResponse
+// {
+//     suggestions?: string[],    // Array of suggested followup questions
+//     metadata_id?: string       // Metadata ID for tracking/analytics
+// }
 ```
 
 **Example:**
 
 ```typescript
-// Get followup suggestions for a task
-const suggestions: string[] = await client.controllerApi.getDirectFollowupSuggestions('your-task-id');
+const response = await client.controllerApi.getDirectFollowupSuggestions({
+    context: { task_id: 'your-task-id' },
+    created_by: 'user123'
+});
 
+console.log('Metadata ID:', response.metadata_id);
 console.log('Suggested followups:');
-suggestions.forEach((suggestion, index) => {
+response.suggestions?.forEach((suggestion, index) => {
     console.log(`${index + 1}. ${suggestion}`);
 });
 ```
@@ -656,7 +667,7 @@ async function debugAgentResponse(taskId: string) {
 debugAgentResponse('task-123');
 ```
 
-### Get Direct Followup Suggestions (NEW in v1.2.28)
+### Get Direct Followup Suggestions
 
 ```typescript
 import { ApolloClient } from '@aui.io/aui-client';
@@ -665,18 +676,21 @@ const client = new ApolloClient({
     networkApiKey: 'API_KEY_YOUR_KEY_HERE'
 });
 
-async function getSuggestedQuestions(taskId: string) {
+async function getSuggestedQuestions(taskId: string, userId: string) {
     try {
-        // Get AI-generated followup suggestions based on conversation context
-        const suggestions = await client.controllerApi.getDirectFollowupSuggestions(taskId);
+        // Get AI-generated followup suggestions with context and user info
+        const response = await client.controllerApi.getDirectFollowupSuggestions({
+            context: { task_id: taskId },
+            created_by: userId
+        });
         
+        console.log('Metadata ID:', response.metadata_id);
         console.log('Suggested followup questions:');
-        suggestions.forEach((suggestion, index) => {
+        response.suggestions?.forEach((suggestion, index) => {
             console.log(`  ${index + 1}. ${suggestion}`);
         });
         
-        // Use these suggestions to guide the user's next interaction
-        return suggestions;
+        return response;
     } catch (error) {
         console.error('Error getting suggestions:', error);
         throw error;
@@ -684,8 +698,9 @@ async function getSuggestedQuestions(taskId: string) {
 }
 
 // Example usage
-getSuggestedQuestions('task-123');
+getSuggestedQuestions('task-123', 'user-456');
 // Output:
+// Metadata ID: 69e4b4d4359671434fdff849
 // Suggested followup questions:
 //   1. "What colors are available?"
 //   2. "Do you offer financing options?"

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.36",
-                "User-Agent": "@aui.io/aui-client/1.2.36",
+                "X-Fern-SDK-Version": "1.2.38",
+                "User-Agent": "@aui.io/aui-client/1.2.38",
                 "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

@@ -103,15 +103,15 @@ export declare class ControllerApi {
     getAgentContext(request: Record<string, unknown>, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.CreateTopicRequestBody>;
     private __getAgentContext;
     /**
-     * @param {string} taskId
+     * @param {Apollo.DirectFollowupSuggestionsRequest} request
      * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.UnprocessableEntityError}
      *
      * @example
-     *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
+     *     await client.controllerApi.getDirectFollowupSuggestions()
      */
-    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
+    getDirectFollowupSuggestions(request?: Apollo.DirectFollowupSuggestionsRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
     private __getDirectFollowupSuggestions;
     /**
      * @param {string} taskId

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

@@ -536,28 +536,31 @@ class ControllerApi {
         });
     }
     /**
-     * @param {string} taskId
+     * @param {Apollo.DirectFollowupSuggestionsRequest} request
      * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.UnprocessableEntityError}
      *
      * @example
-     *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
+     *     await client.controllerApi.getDirectFollowupSuggestions()
      */
-    getDirectFollowupSuggestions(taskId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getDirectFollowupSuggestions(taskId, requestOptions));
+    getDirectFollowupSuggestions(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getDirectFollowupSuggestions(request, requestOptions));
     }
-    __getDirectFollowupSuggestions(taskId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __getDirectFollowupSuggestions() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 "x-network-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.networkApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.networkApiKey,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `api/v1/external/tasks/${core.url.encodePathParam(taskId)}/direct-followup-suggestions`),
-                method: "GET",
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, "api/v1/external/direct-followup-suggestions"),
+                method: "POST",
                 headers: _headers,
+                contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
                 timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
                 maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -590,7 +593,7 @@ class ControllerApi {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling GET /api/v1/external/tasks/{task_id}/direct-followup-suggestions.");
+                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling POST /api/v1/external/direct-followup-suggestions.");
                 case "unknown":
                     throw new errors.ApolloError({
                         message: _response.error.errorMessage,

package/dist/cjs/api/resources/controllerApi/client/requests/DirectFollowupSuggestionsRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface DirectFollowupSuggestionsRequest {
+    context?: Record<string, unknown>;
+    created_by?: string;
+}

package/dist/cjs/api/resources/controllerApi/client/requests/DirectFollowupSuggestionsRequest.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/resources/controllerApi/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { CreateTaskRequest } from "./CreateTaskRequest.js";
+export type { DirectFollowupSuggestionsRequest } from "./DirectFollowupSuggestionsRequest.js";
 export type { ExternalWidgetRenderRequest } from "./ExternalWidgetRenderRequest.js";
 export type { GetProductMetadataRequest } from "./GetProductMetadataRequest.js";
 export type { ListUserTasksRequest } from "./ListUserTasksRequest.js";

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.36";
+export declare const SDK_VERSION = "1.2.38";

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.36";
+exports.SDK_VERSION = "1.2.38";

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.36",
-                "User-Agent": "@aui.io/aui-client/1.2.36",
+                "X-Fern-SDK-Version": "1.2.38",
+                "User-Agent": "@aui.io/aui-client/1.2.38",
                 "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

@@ -103,15 +103,15 @@ export declare class ControllerApi {
     getAgentContext(request: Record<string, unknown>, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.CreateTopicRequestBody>;
     private __getAgentContext;
     /**
-     * @param {string} taskId
+     * @param {Apollo.DirectFollowupSuggestionsRequest} request
      * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.UnprocessableEntityError}
      *
      * @example
-     *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
+     *     await client.controllerApi.getDirectFollowupSuggestions()
      */
-    getDirectFollowupSuggestions(taskId: string, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
+    getDirectFollowupSuggestions(request?: Apollo.DirectFollowupSuggestionsRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.DirectFollowupSuggestionsResponse>;
     private __getDirectFollowupSuggestions;
     /**
      * @param {string} taskId

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

@@ -500,28 +500,31 @@ export class ControllerApi {
         });
     }
     /**
-     * @param {string} taskId
+     * @param {Apollo.DirectFollowupSuggestionsRequest} request
      * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.UnprocessableEntityError}
      *
      * @example
-     *     await client.controllerApi.getDirectFollowupSuggestions("task_id")
+     *     await client.controllerApi.getDirectFollowupSuggestions()
      */
-    getDirectFollowupSuggestions(taskId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getDirectFollowupSuggestions(taskId, requestOptions));
+    getDirectFollowupSuggestions(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getDirectFollowupSuggestions(request, requestOptions));
     }
-    __getDirectFollowupSuggestions(taskId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __getDirectFollowupSuggestions() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
                 "x-network-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.networkApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.networkApiKey,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `api/v1/external/tasks/${core.url.encodePathParam(taskId)}/direct-followup-suggestions`),
-                method: "GET",
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, "api/v1/external/direct-followup-suggestions"),
+                method: "POST",
                 headers: _headers,
+                contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
                 timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
                 maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -554,7 +557,7 @@ export class ControllerApi {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling GET /api/v1/external/tasks/{task_id}/direct-followup-suggestions.");
+                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling POST /api/v1/external/direct-followup-suggestions.");
                 case "unknown":
                     throw new errors.ApolloError({
                         message: _response.error.errorMessage,

package/dist/esm/api/resources/controllerApi/client/requests/DirectFollowupSuggestionsRequest.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface DirectFollowupSuggestionsRequest {
+    context?: Record<string, unknown>;
+    created_by?: string;
+}

package/dist/esm/api/resources/controllerApi/client/requests/DirectFollowupSuggestionsRequest.mjs

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

package/dist/esm/api/resources/controllerApi/client/requests/index.d.mts

@@ -1,4 +1,5 @@
 export type { CreateTaskRequest } from "./CreateTaskRequest.mjs";
+export type { DirectFollowupSuggestionsRequest } from "./DirectFollowupSuggestionsRequest.mjs";
 export type { ExternalWidgetRenderRequest } from "./ExternalWidgetRenderRequest.mjs";
 export type { GetProductMetadataRequest } from "./GetProductMetadataRequest.mjs";
 export type { ListUserTasksRequest } from "./ListUserTasksRequest.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.36";
+export declare const SDK_VERSION = "1.2.38";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.2.36";
+export const SDK_VERSION = "1.2.38";

package/package.json

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

package/reference.md

@@ -358,7 +358,7 @@ await client.controllerApi.getAgentContext({
 </dl>
 </details>
 
-<details><summary><code>client.controllerApi.<a href="/src/api/resources/controllerApi/client/Client.ts">getDirectFollowupSuggestions</a>(taskId) -> Apollo.DirectFollowupSuggestionsResponse</code></summary>
+<details><summary><code>client.controllerApi.<a href="/src/api/resources/controllerApi/client/Client.ts">getDirectFollowupSuggestions</a>({ ...params }) -> Apollo.DirectFollowupSuggestionsResponse</code></summary>
 <dl>
 <dd>
 
@@ -371,7 +371,7 @@ await client.controllerApi.getAgentContext({
 <dd>
 
 ```typescript
-await client.controllerApi.getDirectFollowupSuggestions("task_id");
+await client.controllerApi.getDirectFollowupSuggestions();
 
 ```
 </dd>
@@ -387,7 +387,7 @@ await client.controllerApi.getDirectFollowupSuggestions("task_id");
 <dl>
 <dd>
 
-**taskId:** `string` 
+**request:** `Apollo.DirectFollowupSuggestionsRequest` 
     
 </dd>
 </dl>