@athenaintel/sdk 4.3.1157 → 4.3.1923

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

@@ -0,0 +1,230 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspacesClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const errors = __importStar(require("../../../../errors/index.js"));
+const AthenaIntelligence = __importStar(require("../../../index.js"));
+class WorkspacesClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Retrieve the configuration for a workspace. Includes disclaimer settings. Requires workspace owner or admin permissions.
+     *
+     * @param {AthenaIntelligence.GetConfigurationWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.getConfiguration({
+     *         workspace_id: "workspace_id"
+     *     })
+     */
+    getConfiguration(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getConfiguration(request, requestOptions));
+    }
+    __getConfiguration(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { workspace_id: workspaceId } = request;
+            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/workspaces/${core.url.encodePathParam(workspaceId)}/configuration`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                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 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 GET /api/v0/workspaces/{workspace_id}/configuration.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Update workspace configuration settings. Currently supports updating the workspace disclaimer. Only the fields provided will be updated; other configuration keys are preserved. Requires workspace owner or admin permissions.
+     *
+     * @param {AthenaIntelligence.UpdateWorkspaceConfigurationRequestIn} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.updateConfiguration({
+     *         workspace_id: "workspace_id"
+     *     })
+     */
+    updateConfiguration(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateConfiguration(request, requestOptions));
+    }
+    __updateConfiguration(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { workspace_id: workspaceId } = request, _body = __rest(request, ["workspace_id"]);
+            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/workspaces/${core.url.encodePathParam(workspaceId)}/configuration`),
+                method: "PUT",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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 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 PUT /api/v0/workspaces/{workspace_id}/configuration.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+}
+exports.WorkspacesClient = WorkspacesClient;

package/dist/cjs/api/resources/workspaces/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/cjs/api/resources/workspaces/client/index.js

@@ -0,0 +1,17 @@
+"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/workspaces/client/requests/GetConfigurationWorkspacesRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_id"
+ *     }
+ */
+export interface GetConfigurationWorkspacesRequest {
+    workspace_id: string;
+}

package/dist/cjs/api/resources/workspaces/client/requests/GetConfigurationWorkspacesRequest.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/workspaces/client/requests/UpdateWorkspaceConfigurationRequestIn.d.ts

@@ -0,0 +1,12 @@
+import type * as AthenaIntelligence from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_id"
+ *     }
+ */
+export interface UpdateWorkspaceConfigurationRequestIn {
+    workspace_id: string;
+    /** Workspace disclaimer settings to update */
+    workspace_disclaimer?: AthenaIntelligence.UpdateWorkspaceDisclaimerIn | null;
+}

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

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

package/dist/cjs/api/resources/workspaces/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1 @@
+export * from "./client/index.js";

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

@@ -0,0 +1,17 @@
+"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("./client/index.js"), exports);

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

@@ -0,0 +1,27 @@
+/**
+ * Response model for reading an AOP configuration.
+ */
+export interface AopConfigResponseOut {
+    /** ID of the agent to use for execution */
+    agentId?: string | null;
+    /** Full agent configuration override for this AOP */
+    agent_config?: Record<string, unknown> | null;
+    /** ID of the AOP asset */
+    asset_id: string;
+    /** Human-readable description of what the AOP does */
+    description?: string;
+    /** Icon identifier for UI display */
+    icon?: string;
+    /** The main prompt/instructions for the AOP */
+    prompt?: string;
+    /** Section/category for organization */
+    section?: string;
+    /** Computed structured inputs schema (derived from prompt template placeholders) */
+    structured_inputs?: Record<string, unknown> | null;
+    /** JSON schema for structured output */
+    structured_output?: Record<string, unknown> | null;
+    /** Title/name of the AOP */
+    title?: string | null;
+    /** Per-user notification preferences. Map of user_id -> notification config controlling who receives AOP result notifications */
+    user_notification_configs?: Record<string, Record<string, unknown> | null> | null;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Response model for a successful AOP config overwrite.
+ */
+export interface AopConfigUpdateResponseOut {
+    /** ID of the AOP asset that was updated */
+    asset_id: string;
+    /** Human-readable status message */
+    message?: string;
+    /** Status of the operation */
+    status?: string;
+}

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

@@ -0,0 +1,17 @@
+/**
+ * Response model for a successful AOP creation.
+ */
+export interface AopCreateResponseOut {
+    /** ID of the newly created AOP asset */
+    asset_id: string;
+    /** Human-readable status message */
+    message?: string;
+    /** ID of the parent folder */
+    parent_folder_id?: string | null;
+    /** Status of the operation */
+    status?: string;
+    /** Title of the created AOP */
+    title: string;
+    /** ID of the workspace that owns the created AOP */
+    workspace_id?: string | null;
+}

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

@@ -4,6 +4,8 @@
 export interface AopExecuteRequestIn {
     /** ID of the existing AOP asset to execute */
     asset_id: string;
+    /** Execute the AOP in dry-run mode: the agent runs with its real prompt, config, and read-only tools, but side-effectful tool calls (emails, external writes) are validated and captured instead of executed. The session remains visible and is marked with athena_metadata.is_dry_run for UI badging. */
+    dry_run?: boolean;
     /** Optional user inputs to append to the AOP's prompt as key-value pairs */
-    user_inputs?: Record<string, string | undefined>;
+    user_inputs?: Record<string, string | null> | null;
 }

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

@@ -12,9 +12,9 @@ export interface AopExecuteResponseOut {
     /** Base prompt of the AOP before user inputs were added */
     base_prompt: string;
     /** The conversation result from the AOP execution */
-    conversation?: AthenaIntelligence.ConversationResult;
+    conversation?: AthenaIntelligence.ConversationResult | null;
     /** Error message if execution failed */
-    error?: string;
+    error?: string | null;
     /** Final prompt used for execution including user inputs */
     final_prompt: string;
     /** Status of the execution (e.g., 'submitted') */

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

@@ -0,0 +1,10 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Response model listing read capabilities for every asset type.
+ */
+export interface AssetCapabilitiesResponseOut {
+    /** All anchor type identifiers known to read_asset */
+    anchor_types: string[];
+    /** Read capabilities, one entry per supported asset type */
+    capabilities: AthenaIntelligence.ReadCapabilitiesOut[];
+}

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

@@ -0,0 +1,19 @@
+/**
+ * A single comment within a comment thread on an asset.
+ */
+export interface AssetComment {
+    /** Raw rich-text (TipTap JSON) content of the comment */
+    content_json: string;
+    /** ISO 8601 timestamp when the comment was created */
+    created_at?: string | null;
+    /** Unique identifier for the comment */
+    id: string;
+    /** Reactions keyed by emoji, each with the user IDs who reacted */
+    reactions?: Record<string, string[]>;
+    /** Plain-text content of the comment */
+    text: string;
+    /** ISO 8601 timestamp when the comment was last updated */
+    updated_at?: string | null;
+    /** ID (email) of the comment author */
+    user_id?: string | null;
+}

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

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * A comment thread stored on an asset (document or spreadsheet).
+ */
+export interface AssetCommentThread {
+    /** ISO 8601 timestamp when the thread was archived, or null */
+    archived_at?: string | null;
+    /** Comments in the thread, in creation order. Deleted comments are excluded. */
+    comments?: AthenaIntelligence.AssetComment[];
+    /** ISO 8601 timestamp when the thread was created */
+    created_at?: string | null;
+    /** Thread metadata, including anchor information for anchored threads */
+    data?: Record<string, unknown>;
+    /** Unique identifier for the thread */
+    id: string;
+    /** 'asset' for asset-level threads or 'anchor' for threads anchored to specific content (a text range in a document, a cell range in a spreadsheet) */
+    level?: string;
+    /** ISO 8601 timestamp when the thread was resolved, or null */
+    resolved_at?: string | null;
+    /** ISO 8601 timestamp when the thread was last updated */
+    updated_at?: string | null;
+}

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

@@ -1,7 +1,10 @@
+import type * as AthenaIntelligence from "../index.js";
 /**
  * Response model with asset content.
  */
 export interface AssetContentRequestOut {
+    /** Comment threads on the asset. Only populated when the request sets include_comments=true. An empty list means the asset has no comment threads; null means comments were not requested or the comment data could not be retrieved. */
+    comments?: AthenaIntelligence.AssetCommentThread[] | null;
     /** The content of the asset */
     content: string;
 }

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

@@ -3,7 +3,7 @@ import type * as AthenaIntelligence from "../index.js";
  * Model representing a node in the folder tree.
  */
 export interface AssetNode {
-    children?: Record<string, AthenaIntelligence.AssetNode | undefined>;
+    children?: Record<string, AthenaIntelligence.AssetNode | null> | null;
     id: string;
     media_type: string;
     name: string;

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

@@ -0,0 +1,15 @@
+/**
+ * Teaching error explaining why a read failed and how to recover.
+ */
+export interface AssetReadErrorOut {
+    /** One sentence describing the exact re-query syntax to use */
+    hint?: string | null;
+    /** Machine-readable error category: not_found, out_of_range, invalid_anchor_params, unsupported_anchor, unavailable, transport */
+    kind: string;
+    /** Human-readable description of the failure */
+    message: string;
+    /** Whether retrying the identical request could succeed */
+    retryable?: boolean;
+    /** Concrete valid values to use instead (e.g. available sheet ids) */
+    valid_options?: Record<string, unknown> | null;
+}

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

@@ -0,0 +1,8 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Response model for a parameterized asset read.
+ */
+export interface AssetReadResponseOut {
+    /** One result per requested asset, in request order */
+    results: AthenaIntelligence.AssetReadResult[];
+}

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

@@ -0,0 +1,28 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * The result of reading a single asset.
+ */
+export interface AssetReadResult {
+    /** Supported/preferred anchors, returned after an unsupported anchor */
+    anchor_guidance?: string | null;
+    /** The asset identifier this result is for */
+    asset_id: string;
+    /** The resolved asset type, when known */
+    asset_type?: string | null;
+    /** The asset content. Plain text or a JSON string for structured asset types; base64-encoded image data when format is 'image'. Pagination metadata (truncated/next_offset) is embedded here for windowed reads. */
+    content: string;
+    /** Structured teaching error, populated when is_error is true */
+    error?: AthenaIntelligence.AssetReadErrorOut | null;
+    /** The format the content was delivered in */
+    format: string;
+    /** Supported formats, returned after an unsupported format */
+    format_guidance?: string | null;
+    /** True when the read failed; see the error field */
+    is_error?: boolean;
+    /** What this asset type supports, for precise follow-up reads */
+    read_capabilities?: AthenaIntelligence.ReadCapabilitiesOut | null;
+    /** Structured payload for json-format reads, when available */
+    structured_content?: Record<string, unknown> | null;
+    /** Non-fatal notice, e.g. a page/slide clamp on the requested range */
+    warning?: string | null;
+}

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

@@ -1,9 +1,9 @@
 import type * as AthenaIntelligence from "../index.js";
 export interface BorderModel {
     /** Border color as hex string (e.g., '#FF0000'). Use either color_hex or color_theme, not both. */
-    color_hex?: string;
+    color_hex?: string | null;
     /** Border color as theme reference. Use either color_hex or color_theme, not both. Defaults to theme color 1 if neither is specified. */
-    color_theme?: AthenaIntelligence.ThemeColor;
+    color_theme?: AthenaIntelligence.ThemeColor | null;
     style: AthenaIntelligence.BorderStyle;
     width: number;
 }

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

@@ -20,11 +20,11 @@ import type * as AthenaIntelligence from "../index.js";
  */
 export interface BordersModel {
     /** Bottom border of the cell */
-    bottom?: AthenaIntelligence.BorderModel;
+    bottom?: AthenaIntelligence.BorderModel | null;
     /** Left border of the cell */
-    left?: AthenaIntelligence.BorderModel;
+    left?: AthenaIntelligence.BorderModel | null;
     /** Right border of the cell */
-    right?: AthenaIntelligence.BorderModel;
+    right?: AthenaIntelligence.BorderModel | null;
     /** Top border of the cell */
-    top?: AthenaIntelligence.BorderModel;
+    top?: AthenaIntelligence.BorderModel | null;
 }

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

@@ -1,17 +1,17 @@
 import type * as AthenaIntelligence from "../index.js";
 export interface CellFormat {
     /** Background color as hex string (e.g., '#FF0000'). Use either backgroundColor_hex or backgroundColor_theme, not both. */
-    backgroundColor_hex?: string;
+    backgroundColor_hex?: string | null;
     /** Background color as theme reference. Use either backgroundColor_hex or backgroundColor_theme, not both. */
-    backgroundColor_theme?: AthenaIntelligence.ThemeColor;
-    borders?: AthenaIntelligence.BordersModel;
-    horizontalAlignment?: CellFormat.HorizontalAlignment;
-    indent?: number;
-    numberFormat?: AthenaIntelligence.NumberFormatModel;
-    textFormat?: AthenaIntelligence.TextFormatModel;
-    textRotation?: CellFormat.TextRotation;
-    verticalAlignment?: CellFormat.VerticalAlignment;
-    wrapStrategy?: AthenaIntelligence.WrapStrategy;
+    backgroundColor_theme?: AthenaIntelligence.ThemeColor | null;
+    borders?: AthenaIntelligence.BordersModel | null;
+    horizontalAlignment?: CellFormat.HorizontalAlignment | null;
+    indent?: number | null;
+    numberFormat?: AthenaIntelligence.NumberFormatModel | null;
+    textFormat?: AthenaIntelligence.TextFormatModel | null;
+    textRotation?: CellFormat.TextRotation | null;
+    verticalAlignment?: CellFormat.VerticalAlignment | null;
+    wrapStrategy?: AthenaIntelligence.WrapStrategy | null;
 }
 export declare namespace CellFormat {
     const HorizontalAlignment: {