@aui.io/aui-client 1.2.34 → 1.2.35

package/README.md

@@ -271,15 +271,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
-    is_external_api?: boolean, // Optional: mark as external API call
-    context?: {               // Optional: additional context
+    task_id: string,              // Task identifier
+    text: string,                 // Message text
+    is_external_api?: boolean,    // Optional: mark as external API call
+    include_trace_info?: boolean, // Optional: include trace/debug info in response (NEW)
+    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)
+    agent_variables?: Record<string, unknown>  // Optional: custom agent variables
 });
 
 // Returns: Message - Complete agent response with optional product cards
@@ -325,35 +326,29 @@ 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.
+#### `getTraceInfo(taskId, messageId)` - Get Trace Info (NEW)
+Retrieve trace/debug information for a specific message. Useful for debugging agent responses and understanding the processing pipeline.
 
 ```typescript
-const agentContext = await client.controllerApi.getAgentContext({
-    task_id: 'your-task-id',
-    query: 'test context'
-});
+const traceInfo = await client.controllerApi.getTraceInfo('your-task-id', 'your-message-id');
 
-// Returns: CreateTopicRequestBody - Agent context with:
-// - title: string
-// - params: TaskParameter[]
-// - entities: TaskTopicEntity[]
-// - static_context: string
+// Returns: Record<string, any> - Trace information object
 ```
 
 **Example:**
 
 ```typescript
-// Get agent context to understand available parameters
-const context = await client.controllerApi.getAgentContext({
+// First, send a message with trace info enabled
+const message = await client.controllerApi.sendMessage({
     task_id: 'your-task-id',
-    query: 'test context'
+    text: 'What products do you recommend?',
+    is_external_api: true,
+    include_trace_info: true
 });
 
-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);
+// Then retrieve the full trace info for that message
+const traceInfo = await client.controllerApi.getTraceInfo('your-task-id', message.id);
+console.log('Trace Info:', traceInfo);
 ```
 
 #### `getDirectFollowupSuggestions(taskId)` - Get Direct Followup Suggestions (NEW in v1.2.28)
@@ -626,7 +621,7 @@ sendContextualMessage('task-123', 'What do you recommend?', {
 });
 ```
 
-### Get Agent Context (NEW in v1.2.28)
+### Get Trace Info (NEW)
 
 ```typescript
 import { ApolloClient } from '@aui.io/aui-client';
@@ -635,39 +630,30 @@ const client = new ApolloClient({
     networkApiKey: 'API_KEY_YOUR_KEY_HERE'
 });
 
-async function exploreAgentCapabilities() {
+async function debugAgentResponse(taskId: string) {
     try {
-        // Get the agent's context configuration
-        const context = await client.controllerApi.getAgentContext({
-            task_id: 'your-task-id',
-            query: 'test context'
+        // Send a message with trace info enabled
+        const message = await client.controllerApi.sendMessage({
+            task_id: taskId,
+            text: 'What products do you recommend?',
+            is_external_api: true,
+            include_trace_info: true
         });
-        
-        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;
+
+        console.log('Agent Response:', message.text);
+
+        // Retrieve the full trace info for debugging
+        const traceInfo = await client.controllerApi.getTraceInfo(taskId, message.id);
+        console.log('Trace Info:', traceInfo);
+
+        return traceInfo;
     } catch (error) {
-        console.error('Error getting agent context:', error);
+        console.error('Error getting trace info:', error);
         throw error;
     }
 }
 
-exploreAgentCapabilities();
+debugAgentResponse('task-123');
 ```
 
 ### Get Direct Followup Suggestions (NEW in v1.2.28)

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

@@ -156,4 +156,24 @@ export declare class ControllerApi {
      */
     startTextConversation(request: Apollo.TextConversationInitiateRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.TextConversationInitiateResponse>;
     private __startTextConversation;
+    /**
+     * Render a widget card from integration data. Authenticates via network API key.
+     *
+     * @param {Apollo.ExternalWidgetRenderRequest} request
+     * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Apollo.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.controllerApi.renderWidget({
+     *         task_id: "task_id",
+     *         integration_code: "integration_code",
+     *         card_template_code: "card_template_code",
+     *         variables: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    renderWidget(request: Apollo.ExternalWidgetRenderRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.WidgetRenderResponse>;
+    private __renderWidget;
 }

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

@@ -798,5 +798,78 @@ class ControllerApi {
             }
         });
     }
+    /**
+     * Render a widget card from integration data. Authenticates via network API key.
+     *
+     * @param {Apollo.ExternalWidgetRenderRequest} request
+     * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Apollo.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.controllerApi.renderWidget({
+     *         task_id: "task_id",
+     *         integration_code: "integration_code",
+     *         card_template_code: "card_template_code",
+     *         variables: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    renderWidget(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__renderWidget(request, requestOptions));
+    }
+    __renderWidget(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/widgets"),
+                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,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Apollo.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ApolloError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ApolloError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling POST /api/v1/external/widgets.");
+                case "unknown":
+                    throw new errors.ApolloError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.ControllerApi = ControllerApi;

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

@@ -0,0 +1,21 @@
+/**
+ * @example
+ *     {
+ *         task_id: "task_id",
+ *         integration_code: "integration_code",
+ *         card_template_code: "card_template_code",
+ *         variables: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface ExternalWidgetRenderRequest {
+    /** Task ID for looking up stored interaction data */
+    task_id: string;
+    /** Integration name/code (e.g., INVENTORY_SEARCH) */
+    integration_code: string;
+    /** Card template name for direct lookup */
+    card_template_code: string;
+    /** Key-value pairs matching integration settings.variables[].key */
+    variables: Record<string, unknown>;
+}

package/dist/cjs/api/resources/controllerApi/client/requests/ExternalWidgetRenderRequest.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 { ExternalWidgetRenderRequest } from "./ExternalWidgetRenderRequest.js";
 export type { GetProductMetadataRequest } from "./GetProductMetadataRequest.js";
 export type { ListUserTasksRequest } from "./ListUserTasksRequest.js";
 export type { SubmitMessageRequest } from "./SubmitMessageRequest.js";

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

@@ -3,6 +3,9 @@ export interface TraceDecisionParamsCheck {
     type?: Apollo.TraceDecisionType;
     tool: string;
     status: Apollo.TraceParamsCheckStatus;
-    missing_params?: string[];
+    /** Per mandatory (required) group; inner list = unfilled param codes for that group. */
+    required_missing_params_by_group?: string[][];
+    /** Per optional group; inner list = unfilled param codes for that group. */
+    optional_missing_params_by_group?: string[][];
     track_id?: string;
 }

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

@@ -6,5 +6,5 @@ export interface TraceDecisionRuleTriggered {
     track_id?: string;
 }
 export declare namespace TraceDecisionRuleTriggered {
-    type Rule = Apollo.TraceRuleBase | Apollo.TraceRuleParamsMissing;
+    type Rule = Apollo.TraceRuleBase | Apollo.TraceRuleParamsMissing | Apollo.TraceRuleMissingInfo;
 }

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

@@ -7,5 +7,4 @@ export interface TraceDecisionToolTextResponse {
     track_id?: string;
     tone_of_voice?: string;
     brevity?: string;
-    guideline?: string;
 }

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

@@ -1,8 +1,9 @@
-/** Schema: all_filled | missing_required | missing_optional_ask_once. */
+/** Schema: all_filled | missing_required | missing_optional | missing_optional_and_required | missing_optional_ask_once. */
 export declare const TraceParamsCheckStatus: {
     readonly AllFilled: "all_filled";
     readonly MissingRequired: "missing_required";
     readonly MissingOptional: "missing_optional";
     readonly MissingOptionalAskOnce: "missing_optional_ask_once";
+    readonly MissingOptionalAndRequired: "missing_optional_and_required";
 };
 export type TraceParamsCheckStatus = (typeof TraceParamsCheckStatus)[keyof typeof TraceParamsCheckStatus];

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

@@ -2,10 +2,11 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TraceParamsCheckStatus = void 0;
-/** Schema: all_filled | missing_required | missing_optional_ask_once. */
+/** Schema: all_filled | missing_required | missing_optional | missing_optional_and_required | missing_optional_ask_once. */
 exports.TraceParamsCheckStatus = {
     AllFilled: "all_filled",
     MissingRequired: "missing_required",
     MissingOptional: "missing_optional",
     MissingOptionalAskOnce: "missing_optional_ask_once",
+    MissingOptionalAndRequired: "missing_optional_and_required",
 };

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

@@ -3,7 +3,10 @@ export declare const TraceRuleAction: {
     readonly AddRequiredParam: "ADD_REQUIRED_PARAM";
     readonly AskAQuestion: "ASK_A_QUESTION";
     readonly Block: "BLOCK";
+    readonly PartialBlock: "PARTIAL_BLOCK";
     readonly Text: "TEXT";
-    readonly ActivateAnotherTool: "ACTIVATE_ANOTHER_TOOL";
+    readonly BlockAndActivateAnotherTool: "BLOCK_AND_ACTIVATE_ANOTHER_TOOL";
+    readonly ActivateSubTool: "ACTIVATE_SUB_TOOL";
+    readonly Integration: "INTEGRATION";
 };
 export type TraceRuleAction = (typeof TraceRuleAction)[keyof typeof TraceRuleAction];

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

@@ -7,6 +7,9 @@ exports.TraceRuleAction = {
     AddRequiredParam: "ADD_REQUIRED_PARAM",
     AskAQuestion: "ASK_A_QUESTION",
     Block: "BLOCK",
+    PartialBlock: "PARTIAL_BLOCK",
     Text: "TEXT",
-    ActivateAnotherTool: "ACTIVATE_ANOTHER_TOOL",
+    BlockAndActivateAnotherTool: "BLOCK_AND_ACTIVATE_ANOTHER_TOOL",
+    ActivateSubTool: "ACTIVATE_SUB_TOOL",
+    Integration: "INTEGRATION",
 };

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

@@ -0,0 +1,10 @@
+import type * as Apollo from "../index.js";
+export interface TraceRuleMissingInfo {
+    type: Apollo.TraceRuleType;
+    action?: Apollo.TraceRuleAction;
+    reason?: string;
+    params_added?: Record<string, unknown>;
+    excluded_entities?: string[];
+    code?: string;
+    required_missing_params_by_group?: string[][];
+}

package/dist/cjs/api/types/TraceRuleMissingInfo.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/TraceRuleParamsMissing.d.ts

@@ -2,6 +2,11 @@ import type * as Apollo from "../index.js";
 export interface TraceRuleParamsMissing {
     type?: Apollo.TraceRuleType;
     action?: Apollo.TraceRuleAction;
-    missing_params?: string[];
+    status: Apollo.TraceParamsCheckStatus;
+    /** Per mandatory group (workflow order); inner list = unfilled param codes. */
+    required_missing_params_by_group?: string[][];
+    /** Per optional group (workflow order); inner list = unfilled param codes. */
+    optional_missing_params_by_group?: string[][];
     reason?: string;
+    code?: string;
 }

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

@@ -0,0 +1,3 @@
+export interface WidgetRenderResponse {
+    rendered_jsx: string;
+}

package/dist/cjs/api/types/WidgetRenderResponse.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/index.d.ts

@@ -75,6 +75,7 @@ export * from "./TraceResponseType.js";
 export * from "./TraceRestIntegration.js";
 export * from "./TraceRuleAction.js";
 export * from "./TraceRuleBase.js";
+export * from "./TraceRuleMissingInfo.js";
 export * from "./TraceRuleParamsMissing.js";
 export * from "./TraceRuleType.js";
 export * from "./TraceSelfReviewEntity.js";
@@ -87,6 +88,7 @@ export * from "./TracSelfReviewSubEntity.js";
 export * from "./UserMessagePayload.js";
 export * from "./ValidationError.js";
 export * from "./VectorSearchTaskInteractionQaAnswerScoreLabel.js";
+export * from "./WidgetRenderResponse.js";
 export * from "./WorkflowCheckStatus.js";
 export * from "./WorkflowMetadata.js";
 export * from "./WorkflowsMetadataResponse.js";

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

@@ -91,6 +91,7 @@ __exportStar(require("./TraceResponseType.js"), exports);
 __exportStar(require("./TraceRestIntegration.js"), exports);
 __exportStar(require("./TraceRuleAction.js"), exports);
 __exportStar(require("./TraceRuleBase.js"), exports);
+__exportStar(require("./TraceRuleMissingInfo.js"), exports);
 __exportStar(require("./TraceRuleParamsMissing.js"), exports);
 __exportStar(require("./TraceRuleType.js"), exports);
 __exportStar(require("./TraceSelfReviewEntity.js"), exports);
@@ -103,6 +104,7 @@ __exportStar(require("./TracSelfReviewSubEntity.js"), exports);
 __exportStar(require("./UserMessagePayload.js"), exports);
 __exportStar(require("./ValidationError.js"), exports);
 __exportStar(require("./VectorSearchTaskInteractionQaAnswerScoreLabel.js"), exports);
+__exportStar(require("./WidgetRenderResponse.js"), exports);
 __exportStar(require("./WorkflowCheckStatus.js"), exports);
 __exportStar(require("./WorkflowMetadata.js"), exports);
 __exportStar(require("./WorkflowsMetadataResponse.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.34";
+export declare const SDK_VERSION = "1.2.35";

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.34";
+exports.SDK_VERSION = "1.2.35";

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

@@ -156,4 +156,24 @@ export declare class ControllerApi {
      */
     startTextConversation(request: Apollo.TextConversationInitiateRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.TextConversationInitiateResponse>;
     private __startTextConversation;
+    /**
+     * Render a widget card from integration data. Authenticates via network API key.
+     *
+     * @param {Apollo.ExternalWidgetRenderRequest} request
+     * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Apollo.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.controllerApi.renderWidget({
+     *         task_id: "task_id",
+     *         integration_code: "integration_code",
+     *         card_template_code: "card_template_code",
+     *         variables: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    renderWidget(request: Apollo.ExternalWidgetRenderRequest, requestOptions?: ControllerApi.RequestOptions): core.HttpResponsePromise<Apollo.WidgetRenderResponse>;
+    private __renderWidget;
 }

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

@@ -762,4 +762,77 @@ export class ControllerApi {
             }
         });
     }
+    /**
+     * Render a widget card from integration data. Authenticates via network API key.
+     *
+     * @param {Apollo.ExternalWidgetRenderRequest} request
+     * @param {ControllerApi.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Apollo.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.controllerApi.renderWidget({
+     *         task_id: "task_id",
+     *         integration_code: "integration_code",
+     *         card_template_code: "card_template_code",
+     *         variables: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    renderWidget(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__renderWidget(request, requestOptions));
+    }
+    __renderWidget(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/widgets"),
+                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,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Apollo.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ApolloError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ApolloError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ApolloTimeoutError("Timeout exceeded when calling POST /api/v1/external/widgets.");
+                case "unknown":
+                    throw new errors.ApolloError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

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

@@ -0,0 +1,21 @@
+/**
+ * @example
+ *     {
+ *         task_id: "task_id",
+ *         integration_code: "integration_code",
+ *         card_template_code: "card_template_code",
+ *         variables: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface ExternalWidgetRenderRequest {
+    /** Task ID for looking up stored interaction data */
+    task_id: string;
+    /** Integration name/code (e.g., INVENTORY_SEARCH) */
+    integration_code: string;
+    /** Card template name for direct lookup */
+    card_template_code: string;
+    /** Key-value pairs matching integration settings.variables[].key */
+    variables: Record<string, unknown>;
+}

package/dist/esm/api/resources/controllerApi/client/requests/ExternalWidgetRenderRequest.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 { ExternalWidgetRenderRequest } from "./ExternalWidgetRenderRequest.mjs";
 export type { GetProductMetadataRequest } from "./GetProductMetadataRequest.mjs";
 export type { ListUserTasksRequest } from "./ListUserTasksRequest.mjs";
 export type { SubmitMessageRequest } from "./SubmitMessageRequest.mjs";

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

@@ -3,6 +3,9 @@ export interface TraceDecisionParamsCheck {
     type?: Apollo.TraceDecisionType;
     tool: string;
     status: Apollo.TraceParamsCheckStatus;
-    missing_params?: string[];
+    /** Per mandatory (required) group; inner list = unfilled param codes for that group. */
+    required_missing_params_by_group?: string[][];
+    /** Per optional group; inner list = unfilled param codes for that group. */
+    optional_missing_params_by_group?: string[][];
     track_id?: string;
 }

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

@@ -6,5 +6,5 @@ export interface TraceDecisionRuleTriggered {
     track_id?: string;
 }
 export declare namespace TraceDecisionRuleTriggered {
-    type Rule = Apollo.TraceRuleBase | Apollo.TraceRuleParamsMissing;
+    type Rule = Apollo.TraceRuleBase | Apollo.TraceRuleParamsMissing | Apollo.TraceRuleMissingInfo;
 }

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

@@ -7,5 +7,4 @@ export interface TraceDecisionToolTextResponse {
     track_id?: string;
     tone_of_voice?: string;
     brevity?: string;
-    guideline?: string;
 }

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

@@ -1,8 +1,9 @@
-/** Schema: all_filled | missing_required | missing_optional_ask_once. */
+/** Schema: all_filled | missing_required | missing_optional | missing_optional_and_required | missing_optional_ask_once. */
 export declare const TraceParamsCheckStatus: {
     readonly AllFilled: "all_filled";
     readonly MissingRequired: "missing_required";
     readonly MissingOptional: "missing_optional";
     readonly MissingOptionalAskOnce: "missing_optional_ask_once";
+    readonly MissingOptionalAndRequired: "missing_optional_and_required";
 };
 export type TraceParamsCheckStatus = (typeof TraceParamsCheckStatus)[keyof typeof TraceParamsCheckStatus];

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

@@ -1,8 +1,9 @@
 // This file was auto-generated by Fern from our API Definition.
-/** Schema: all_filled | missing_required | missing_optional_ask_once. */
+/** Schema: all_filled | missing_required | missing_optional | missing_optional_and_required | missing_optional_ask_once. */
 export const TraceParamsCheckStatus = {
     AllFilled: "all_filled",
     MissingRequired: "missing_required",
     MissingOptional: "missing_optional",
     MissingOptionalAskOnce: "missing_optional_ask_once",
+    MissingOptionalAndRequired: "missing_optional_and_required",
 };

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

@@ -3,7 +3,10 @@ export declare const TraceRuleAction: {
     readonly AddRequiredParam: "ADD_REQUIRED_PARAM";
     readonly AskAQuestion: "ASK_A_QUESTION";
     readonly Block: "BLOCK";
+    readonly PartialBlock: "PARTIAL_BLOCK";
     readonly Text: "TEXT";
-    readonly ActivateAnotherTool: "ACTIVATE_ANOTHER_TOOL";
+    readonly BlockAndActivateAnotherTool: "BLOCK_AND_ACTIVATE_ANOTHER_TOOL";
+    readonly ActivateSubTool: "ACTIVATE_SUB_TOOL";
+    readonly Integration: "INTEGRATION";
 };
 export type TraceRuleAction = (typeof TraceRuleAction)[keyof typeof TraceRuleAction];

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

@@ -4,6 +4,9 @@ export const TraceRuleAction = {
     AddRequiredParam: "ADD_REQUIRED_PARAM",
     AskAQuestion: "ASK_A_QUESTION",
     Block: "BLOCK",
+    PartialBlock: "PARTIAL_BLOCK",
     Text: "TEXT",
-    ActivateAnotherTool: "ACTIVATE_ANOTHER_TOOL",
+    BlockAndActivateAnotherTool: "BLOCK_AND_ACTIVATE_ANOTHER_TOOL",
+    ActivateSubTool: "ACTIVATE_SUB_TOOL",
+    Integration: "INTEGRATION",
 };

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

@@ -0,0 +1,10 @@
+import type * as Apollo from "../index.mjs";
+export interface TraceRuleMissingInfo {
+    type: Apollo.TraceRuleType;
+    action?: Apollo.TraceRuleAction;
+    reason?: string;
+    params_added?: Record<string, unknown>;
+    excluded_entities?: string[];
+    code?: string;
+    required_missing_params_by_group?: string[][];
+}

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

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

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

@@ -2,6 +2,11 @@ import type * as Apollo from "../index.mjs";
 export interface TraceRuleParamsMissing {
     type?: Apollo.TraceRuleType;
     action?: Apollo.TraceRuleAction;
-    missing_params?: string[];
+    status: Apollo.TraceParamsCheckStatus;
+    /** Per mandatory group (workflow order); inner list = unfilled param codes. */
+    required_missing_params_by_group?: string[][];
+    /** Per optional group (workflow order); inner list = unfilled param codes. */
+    optional_missing_params_by_group?: string[][];
     reason?: string;
+    code?: string;
 }

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

@@ -0,0 +1,3 @@
+export interface WidgetRenderResponse {
+    rendered_jsx: string;
+}

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

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

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

@@ -75,6 +75,7 @@ export * from "./TraceResponseType.mjs";
 export * from "./TraceRestIntegration.mjs";
 export * from "./TraceRuleAction.mjs";
 export * from "./TraceRuleBase.mjs";
+export * from "./TraceRuleMissingInfo.mjs";
 export * from "./TraceRuleParamsMissing.mjs";
 export * from "./TraceRuleType.mjs";
 export * from "./TraceSelfReviewEntity.mjs";
@@ -87,6 +88,7 @@ export * from "./TracSelfReviewSubEntity.mjs";
 export * from "./UserMessagePayload.mjs";
 export * from "./ValidationError.mjs";
 export * from "./VectorSearchTaskInteractionQaAnswerScoreLabel.mjs";
+export * from "./WidgetRenderResponse.mjs";
 export * from "./WorkflowCheckStatus.mjs";
 export * from "./WorkflowMetadata.mjs";
 export * from "./WorkflowsMetadataResponse.mjs";

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

@@ -75,6 +75,7 @@ export * from "./TraceResponseType.mjs";
 export * from "./TraceRestIntegration.mjs";
 export * from "./TraceRuleAction.mjs";
 export * from "./TraceRuleBase.mjs";
+export * from "./TraceRuleMissingInfo.mjs";
 export * from "./TraceRuleParamsMissing.mjs";
 export * from "./TraceRuleType.mjs";
 export * from "./TraceSelfReviewEntity.mjs";
@@ -87,6 +88,7 @@ export * from "./TracSelfReviewSubEntity.mjs";
 export * from "./UserMessagePayload.mjs";
 export * from "./ValidationError.mjs";
 export * from "./VectorSearchTaskInteractionQaAnswerScoreLabel.mjs";
+export * from "./WidgetRenderResponse.mjs";
 export * from "./WorkflowCheckStatus.mjs";
 export * from "./WorkflowMetadata.mjs";
 export * from "./WorkflowsMetadataResponse.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.34";
+export declare const SDK_VERSION = "1.2.35";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.2.34";
+export const SDK_VERSION = "1.2.35";

package/package.json

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

package/reference.md

@@ -584,6 +584,76 @@ await client.controllerApi.startTextConversation({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.controllerApi.<a href="/src/api/resources/controllerApi/client/Client.ts">renderWidget</a>({ ...params }) -> Apollo.WidgetRenderResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Render a widget card from integration data. Authenticates via network API key.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.controllerApi.renderWidget({
+    task_id: "task_id",
+    integration_code: "integration_code",
+    card_template_code: "card_template_code",
+    variables: {
+        "key": "value"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Apollo.ExternalWidgetRenderRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ControllerApi.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>