@hydradb/sdk 0.0.3 → 2.0.0

package/dist/api/resources/context/client/Client.js

@@ -0,0 +1,587 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextClient = 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 handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const serializers = __importStar(require("../../../../serialization/index.js"));
+const HydraDB = __importStar(require("../../../index.js"));
+class ContextClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * @param {HydraDB.BodyIngestContextIngestPost} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.context.ingest({
+     *         tenantId: "tenant_id"
+     *     })
+     */
+    ingest(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__ingest(request, requestOptions));
+    }
+    async __ingest(request, requestOptions) {
+        const _body = await core.newFormData();
+        if (request.type != null) {
+            _body.append("type", serializers.IngestType.jsonOrThrow(request.type, {
+                unrecognizedObjectKeys: "strip",
+                omitUndefined: true,
+            }));
+        }
+        _body.append("tenant_id", request.tenantId);
+        if (request.subTenantId != null) {
+            _body.append("sub_tenant_id", request.subTenantId);
+        }
+        if (request.upsert != null) {
+            _body.append("upsert", request.upsert?.toString());
+        }
+        if (request.documents != null) {
+            for (const _file of request.documents) {
+                await _body.appendFile("documents", _file);
+            }
+        }
+        if (request.documentMetadata != null) {
+            _body.append("document_metadata", request.documentMetadata);
+        }
+        if (request.appKnowledge != null) {
+            _body.append("app_knowledge", request.appKnowledge);
+        }
+        if (request.memories != null) {
+            _body.append("memories", request.memories);
+        }
+        const _maybeEncodedRequest = await _body.getRequest();
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2",
+            ..._maybeEncodedRequest.headers,
+        }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context/ingest"),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "file",
+            duplex: _maybeEncodedRequest.duplex,
+            body: _maybeEncodedRequest.body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceIngestApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/context/ingest");
+    }
+    /**
+     * @param {HydraDB.StatusContextRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.context.status({
+     *         tenantId: "tenant_1234"
+     *     })
+     */
+    status(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__status(request, requestOptions));
+    }
+    async __status(request = {}, requestOptions) {
+        const { id, ids, tenantId, subTenantId } = request;
+        const _queryParams = {
+            id,
+            ids,
+            tenant_id: tenantId,
+            sub_tenant_id: subTenantId,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context/status"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceStatusApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/context/status");
+    }
+    /**
+     * @param {HydraDB.InspectContextRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.context.inspect({
+     *         id: "HydraDoc1234",
+     *         tenantId: "tenant_1234",
+     *         mode: "<str>"
+     *     })
+     */
+    inspect(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__inspect(request, requestOptions));
+    }
+    async __inspect(request, requestOptions) {
+        const { id, tenantId, subTenantId, mode, expirySeconds } = request;
+        const _queryParams = {
+            id,
+            tenant_id: tenantId,
+            sub_tenant_id: subTenantId,
+            mode,
+            expiry_seconds: expirySeconds,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context/inspect"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceFetchApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/context/inspect");
+    }
+    /**
+     * @param {HydraDB.V2ListContentRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.context.list({
+     *         tenantId: "tenant_1234"
+     *     })
+     */
+    list(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    async __list(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context/list"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.V2ListContentRequest.jsonOrThrow(request, {
+                unrecognizedObjectKeys: "strip",
+                omitUndefined: true,
+            }),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceListApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/context/list");
+    }
+    /**
+     * @param {HydraDB.V2SourceDeleteRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.context.delete({
+     *         tenantId: "tenant_1234",
+     *         ids: ["HydraDoc1234", "HydraDoc4567"]
+     *     })
+     */
+    delete(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(request, requestOptions));
+    }
+    async __delete(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context"),
+            method: "DELETE",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.V2SourceDeleteRequest.jsonOrThrow(request, {
+                unrecognizedObjectKeys: "strip",
+                omitUndefined: true,
+            }),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceDeleteApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/context");
+    }
+    /**
+     * @param {HydraDB.RelationsContextRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.UnauthorizedError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     * @throws {@link HydraDB.InternalServerError}
+     * @throws {@link HydraDB.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.context.relations({
+     *         tenantId: "tenant_1234"
+     *     })
+     */
+    relations(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__relations(request, requestOptions));
+    }
+    async __relations(request, requestOptions) {
+        const { tenantId, id, type: type_, subTenantId, limit, cursor } = request;
+        const _queryParams = {
+            tenant_id: tenantId,
+            id,
+            type: type_ != null
+                ? serializers.IngestType.jsonOrThrow(type_, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                })
+                : undefined,
+            sub_tenant_id: subTenantId,
+            limit,
+            cursor,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.HydradDb, "context/relations"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.SourceRelationsApiResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new HydraDB.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new HydraDB.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new HydraDB.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/context/relations");
+    }
+}
+exports.ContextClient = ContextClient;

package/dist/api/resources/context/client/requests/BodyIngestContextIngestPost.d.ts

@@ -0,0 +1,26 @@
+import type * as core from "../../../../../core/index.js";
+import type * as HydraDB from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         tenantId: "tenant_id"
+ *     }
+ */
+export interface BodyIngestContextIngestPost {
+    /** Type of content: 'knowledge' or 'memory' */
+    type?: HydraDB.IngestType;
+    /** Unique identifier for the tenant/organization */
+    tenantId: string;
+    /** Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used. */
+    subTenantId?: string;
+    /** If true, update existing sources with the same id. */
+    upsert?: boolean;
+    /** Documents to upload (knowledge only). Omit when ingesting memories. */
+    documents?: core.file.Uploadable[] | undefined;
+    /** JSON array of per-file metadata objects (knowledge only). Each object may include: id (optional), metadata, additional_metadata, infer, and relations. */
+    documentMetadata?: string | null;
+    /** JSON: single source object or array of app-generated sources (knowledge only). */
+    appKnowledge?: string | null;
+    /** JSON array of memory items (memory only). Each item has text, title, infer, metadata. */
+    memories?: string | null;
+}

package/dist/api/resources/context/client/requests/InspectContextRequest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         tenantId: "tenant_1234",
+ *         mode: "<str>"
+ *     }
+ */
+export interface InspectContextRequest {
+    /** Source ID of the document to fetch */
+    id: string;
+    /** Unique identifier for the tenant/organization */
+    tenantId: string;
+    /** Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used. */
+    subTenantId?: string | null;
+    /** Fetch mode: 'content', 'url', or 'both' */
+    mode?: string;
+    /** Presigned URL expiry (seconds) */
+    expirySeconds?: number;
+}

package/dist/api/resources/{fetch/client/requests/GraphRelationsBySourceIdFetchRequest.d.ts → context/client/requests/RelationsContextRequest.d.ts}

@@ -1,20 +1,21 @@
+import type * as HydraDB from "../../../../index.js";
 /**
  * @example
  *     {
- *         tenant_id: "tenant_1234"
+ *         tenantId: "tenant_1234"
  *     }
  */
-export interface GraphRelationsBySourceIdFetchRequest {
-    /** Source ID. If omitted, returns relations across the entire sub-tenant. */
-    source_id?: string | null;
+export interface RelationsContextRequest {
     /** Unique identifier for the tenant/organization */
-    tenant_id?: string;
-    /** Whether to fetch relations for memories */
-    is_memory?: boolean;
+    tenantId: string;
+    /** Source ID. If omitted, returns relations across the entire sub-tenant. */
+    id?: string | null;
+    /** Type of content: 'knowledge' or 'memory' */
+    type?: HydraDB.IngestType;
     /** Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used. */
-    sub_tenant_id?: string | null;
+    subTenantId?: string | null;
     /** Maximum number of relation groups to return */
     limit?: number;
-    /** Pagination cursor. Pass next_cursor from a previous response. */
+    /** Pagination cursor from a previous response. */
     cursor?: number | null;
 }