@athenaintel/sdk 4.3.2191 → 4.3.2193

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2191",
-        "User-Agent": "@athenaintel/sdk/4.3.2191",
+        "X-Fern-SDK-Version": "4.3.2193",
+        "User-Agent": "@athenaintel/sdk/4.3.2193",
         "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/agents/resources/general/client/Client.d.ts

@@ -17,7 +17,7 @@ export declare class GeneralClient {
      * Call the agent with the messages list, wait for the agent to complete,
      * and return the result.
      *
-     * @param {AthenaIntelligence.agents.GeneralAgentRequest} request
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
@@ -33,6 +33,30 @@ export declare class GeneralClient {
      *             }]
      *     })
      */
-    invoke(request: AthenaIntelligence.agents.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
+    invoke(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
     private __invoke;
+    /**
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     *
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
+     * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.general.invokeAsync({
+     *         config: {
+     *             enabled_tools: ["search"]
+     *         },
+     *         messages: [{
+     *                 content: "Please call the search tool for AAPL news.",
+     *                 role: "user"
+     *             }]
+     *     })
+     */
+    invokeAsync(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentAsyncInvokeResponseOut>;
+    private __invokeAsync;
 }

package/dist/cjs/api/resources/agents/resources/general/client/Client.js

@@ -60,7 +60,7 @@ class GeneralClient {
      * Call the agent with the messages list, wait for the agent to complete,
      * and return the result.
      *
-     * @param {AthenaIntelligence.agents.GeneralAgentRequest} request
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
@@ -138,5 +138,95 @@ class GeneralClient {
             }
         });
     }
+    /**
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     *
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
+     * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.general.invokeAsync({
+     *         config: {
+     *             enabled_tools: ["search"]
+     *         },
+     *         messages: [{
+     *                 content: "Please call the search tool for AAPL news.",
+     *                 role: "user"
+     *             }]
+     *     })
+     */
+    invokeAsync(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__invokeAsync(request, requestOptions));
+    }
+    __invokeAsync(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/agents/general/invoke-async"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/agents/general/invoke-async.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.GeneralClient = GeneralClient;

package/dist/cjs/api/resources/agents/resources/general/client/index.d.ts

@@ -1 +1 @@
-export * from "./requests/index.js";
+export {};

package/dist/cjs/api/resources/agents/resources/general/client/index.js

@@ -1,17 +1,2 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/agents/resources/index.d.ts

@@ -1,2 +1 @@
-export * from "./general/client/requests/index.js";
 export * as general from "./general/index.js";

package/dist/cjs/api/resources/agents/resources/index.js

@@ -15,9 +15,6 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 var __importStar = (this && this.__importStar) || (function () {
     var ownKeys = function(o) {
         ownKeys = Object.getOwnPropertyNames || function (o) {
@@ -37,5 +34,4 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.general = void 0;
-__exportStar(require("./general/client/requests/index.js"), exports);
 exports.general = __importStar(require("./general/index.js"));

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

@@ -0,0 +1,11 @@
+/**
+ * Acknowledgement for an asynchronous general-agent invocation.
+ */
+export interface GeneralAgentAsyncInvokeResponseOut {
+    /** Human-readable status message */
+    message: string;
+    /** Status of the invocation (always 'started' for async) */
+    status: string;
+    /** Thread ID of the run. Poll `GET /threads/{thread_id}/status` (`client.threads.get_status`) until `status` is 'completed' or 'failed'; pass `include_messages=true` to read the agent's reply. */
+    thread_id: string;
+}

package/dist/cjs/api/{resources/agents/resources/general/client/requests → types}/GeneralAgentRequest.d.ts

@@ -1,15 +1,6 @@
-import type * as AthenaIntelligence from "../../../../../../index.js";
+import type * as AthenaIntelligence from "../index.js";
 /**
- * @example
- *     {
- *         config: {
- *             enabled_tools: ["search"]
- *         },
- *         messages: [{
- *                 content: "Please call the search tool for AAPL news.",
- *                 role: "user"
- *             }]
- *     }
+ * A chat request for the Athena SDK.
  */
 export interface GeneralAgentRequest {
     /** The channel through which the request is being made. */

package/dist/cjs/api/{resources/agents/resources/general/client/requests/index.js → types/GeneralAgentRequest.js}

@@ -1,2 +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

@@ -69,7 +69,9 @@ export * from "./EmailSearchResponseOut.js";
 export * from "./EmailSearchResultOut.js";
 export * from "./FileTooLargeError.js";
 export * from "./FolderResponse.js";
+export * from "./GeneralAgentAsyncInvokeResponseOut.js";
 export * from "./GeneralAgentConfig.js";
+export * from "./GeneralAgentRequest.js";
 export * from "./GeneralAgentResponse.js";
 export * from "./GeneralAgentResponseMessage.js";
 export * from "./GeneralAgentResponseMessageKwargs.js";

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

@@ -85,7 +85,9 @@ __exportStar(require("./EmailSearchResponseOut.js"), exports);
 __exportStar(require("./EmailSearchResultOut.js"), exports);
 __exportStar(require("./FileTooLargeError.js"), exports);
 __exportStar(require("./FolderResponse.js"), exports);
+__exportStar(require("./GeneralAgentAsyncInvokeResponseOut.js"), exports);
 __exportStar(require("./GeneralAgentConfig.js"), exports);
+__exportStar(require("./GeneralAgentRequest.js"), exports);
 __exportStar(require("./GeneralAgentResponse.js"), exports);
 __exportStar(require("./GeneralAgentResponseMessage.js"), exports);
 __exportStar(require("./GeneralAgentResponseMessageKwargs.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2191";
+export declare const SDK_VERSION = "4.3.2193";

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 = "4.3.2191";
+exports.SDK_VERSION = "4.3.2193";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2191",
-        "User-Agent": "@athenaintel/sdk/4.3.2191",
+        "X-Fern-SDK-Version": "4.3.2193",
+        "User-Agent": "@athenaintel/sdk/4.3.2193",
         "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/agents/resources/general/client/Client.d.mts

@@ -17,7 +17,7 @@ export declare class GeneralClient {
      * Call the agent with the messages list, wait for the agent to complete,
      * and return the result.
      *
-     * @param {AthenaIntelligence.agents.GeneralAgentRequest} request
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
@@ -33,6 +33,30 @@ export declare class GeneralClient {
      *             }]
      *     })
      */
-    invoke(request: AthenaIntelligence.agents.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
+    invoke(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
     private __invoke;
+    /**
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     *
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
+     * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.general.invokeAsync({
+     *         config: {
+     *             enabled_tools: ["search"]
+     *         },
+     *         messages: [{
+     *                 content: "Please call the search tool for AAPL news.",
+     *                 role: "user"
+     *             }]
+     *     })
+     */
+    invokeAsync(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentAsyncInvokeResponseOut>;
+    private __invokeAsync;
 }

package/dist/esm/api/resources/agents/resources/general/client/Client.mjs

@@ -24,7 +24,7 @@ export class GeneralClient {
      * Call the agent with the messages list, wait for the agent to complete,
      * and return the result.
      *
-     * @param {AthenaIntelligence.agents.GeneralAgentRequest} request
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
@@ -102,4 +102,94 @@ export class GeneralClient {
             }
         });
     }
+    /**
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     *
+     * @param {AthenaIntelligence.GeneralAgentRequest} request
+     * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.general.invokeAsync({
+     *         config: {
+     *             enabled_tools: ["search"]
+     *         },
+     *         messages: [{
+     *                 content: "Please call the search tool for AAPL news.",
+     *                 role: "user"
+     *             }]
+     *     })
+     */
+    invokeAsync(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__invokeAsync(request, requestOptions));
+    }
+    __invokeAsync(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/agents/general/invoke-async"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/agents/general/invoke-async.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

package/dist/esm/api/resources/agents/resources/general/client/index.d.mts

@@ -1 +1 @@
-export * from "./requests/index.mjs";
+export {};

package/dist/esm/api/resources/agents/resources/general/client/index.mjs

@@ -1 +1 @@
-export * from "./requests/index.mjs";
+export {};

package/dist/esm/api/resources/agents/resources/index.d.mts

@@ -1,2 +1 @@
-export * from "./general/client/requests/index.mjs";
 export * as general from "./general/index.mjs";

package/dist/esm/api/resources/agents/resources/index.mjs

@@ -1,2 +1 @@
-export * from "./general/client/requests/index.mjs";
 export * as general from "./general/index.mjs";

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

@@ -0,0 +1,11 @@
+/**
+ * Acknowledgement for an asynchronous general-agent invocation.
+ */
+export interface GeneralAgentAsyncInvokeResponseOut {
+    /** Human-readable status message */
+    message: string;
+    /** Status of the invocation (always 'started' for async) */
+    status: string;
+    /** Thread ID of the run. Poll `GET /threads/{thread_id}/status` (`client.threads.get_status`) until `status` is 'completed' or 'failed'; pass `include_messages=true` to read the agent's reply. */
+    thread_id: string;
+}

package/dist/esm/api/{resources/agents/resources/general/client/requests → types}/GeneralAgentRequest.d.mts

@@ -1,15 +1,6 @@
-import type * as AthenaIntelligence from "../../../../../../index.mjs";
+import type * as AthenaIntelligence from "../index.mjs";
 /**
- * @example
- *     {
- *         config: {
- *             enabled_tools: ["search"]
- *         },
- *         messages: [{
- *                 content: "Please call the search tool for AAPL news.",
- *                 role: "user"
- *             }]
- *     }
+ * A chat request for the Athena SDK.
  */
 export interface GeneralAgentRequest {
     /** The channel through which the request is being made. */

package/dist/esm/api/types/GeneralAgentRequest.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

@@ -69,7 +69,9 @@ export * from "./EmailSearchResponseOut.mjs";
 export * from "./EmailSearchResultOut.mjs";
 export * from "./FileTooLargeError.mjs";
 export * from "./FolderResponse.mjs";
+export * from "./GeneralAgentAsyncInvokeResponseOut.mjs";
 export * from "./GeneralAgentConfig.mjs";
+export * from "./GeneralAgentRequest.mjs";
 export * from "./GeneralAgentResponse.mjs";
 export * from "./GeneralAgentResponseMessage.mjs";
 export * from "./GeneralAgentResponseMessageKwargs.mjs";

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

@@ -69,7 +69,9 @@ export * from "./EmailSearchResponseOut.mjs";
 export * from "./EmailSearchResultOut.mjs";
 export * from "./FileTooLargeError.mjs";
 export * from "./FolderResponse.mjs";
+export * from "./GeneralAgentAsyncInvokeResponseOut.mjs";
 export * from "./GeneralAgentConfig.mjs";
+export * from "./GeneralAgentRequest.mjs";
 export * from "./GeneralAgentResponse.mjs";
 export * from "./GeneralAgentResponseMessage.mjs";
 export * from "./GeneralAgentResponseMessageKwargs.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2191";
+export declare const SDK_VERSION = "4.3.2193";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2191";
+export const SDK_VERSION = "4.3.2193";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.2191",
+    "version": "4.3.2193",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -5245,7 +5245,78 @@ await client.agents.general.invoke({
 <dl>
 <dd>
 
-**request:** `AthenaIntelligence.agents.GeneralAgentRequest` 
+**request:** `AthenaIntelligence.GeneralAgentRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `GeneralClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.general.<a href="/src/api/resources/agents/resources/general/client/Client.ts">invokeAsync</a>({ ...params }) -> AthenaIntelligence.GeneralAgentAsyncInvokeResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.general.invokeAsync({
+    config: {
+        enabled_tools: ["search"]
+    },
+    messages: [{
+            content: "Please call the search tool for AAPL news.",
+            role: "user"
+        }]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GeneralAgentRequest` 
     
 </dd>
 </dl>

package/dist/cjs/api/resources/agents/resources/general/client/requests/index.d.ts

@@ -1 +0,0 @@
-export type { GeneralAgentRequest } from "./GeneralAgentRequest.js";

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

@@ -1 +0,0 @@
-export type { GeneralAgentRequest } from "./GeneralAgentRequest.mjs";

package/dist/esm/api/resources/agents/resources/general/client/requests/index.mjs

@@ -1 +0,0 @@
-export {};